# 通用安装提示词 · remote-download-link

把下面整段（从「【任务：安装…】」到「【最小可用正文】结束」）复制粘贴给**任何** agent，
它就能把这条强制交付规则装到自己身上并自检：Hermes / DSH / Codex / Claude Code / opencode / 以后接的任何工具。

适用前提：能读到本机（NAS）的 `/vol1/ai/**`。若换到没有现成实现的机器，第 0 步会失败并自动走文末的最小可用正文。

---

【任务：安装并启用「远程下载链接」技能（强制交付规范）】

你现在的任务是把这条规则装到自己身上，装完立刻生效。按顺序做，别跳步。

═══ 第 0 步 · 探测（30 秒，别重造轮子）═══

```bash
ls -l /vol1/ai/_scripts/deliver-link /vol1/ai/deliverables/publish.py
```

- 两个都在 → 实现已就绪，**跳到第 2 步**。
- 不在 → 做第 1 步把实现落盘。

═══ 第 1 步 · 落盘技能文件（实现已存在时跳过）═══

把技能正文写成 `SKILL.md`，放进你所在工具的技能目录：

| 工具 | 技能文件位置 |
|---|---|
| Hermes | `<HERMES_HOME>/skills/productivity/remote-download-link/SKILL.md` |
| DSH | `~/.dsh/skills/remote-download-link/SKILL.md` |
| Codex | `$CODEX_HOME/skills/remote-download-link/SKILL.md` |
| Claude Code / 其它 | 没有技能目录就跳过本步，直接做第 2 步 |

技能正文按优先级取（三份内容同源）：

1. `/vol1/ai/agents/hermes/skills/productivity/remote-download-link/SKILL.md`
2. `/vol1/ai/home/.dsh/skills/remote-download-link/SKILL.md`
3. `/vol1/ai/agents/codex/skills/remote-download-link/SKILL.md`
4. 以上都不存在（换了机器）→ 用本提示词文末的【最小可用正文】，并自己把 `deliver-link` 实现出来

═══ 第 2 步 · 写强制规则（决定「强制执行性」，最关键）═══

把下面这段追加到你**每次会话都会自动加载**的全局指令文件末尾——这一步不做，技能就只是"建议"，不叫强制：

| 工具 | 全局指令文件 |
|---|---|
| Hermes | 长期记忆 / 技能索引（技能描述必须以「必须使用」开头） |
| DSH | `~/.dsh/AGENTS.md` |
| Codex | `$CODEX_HOME/AGENTS.md` |
| Claude Code | `~/.claude/CLAUDE.md` |
| 其它 | 该工具的 system prompt / 全局指令文件 |

--- 追加内容 · 开始 ---

## 强制交付：成果必须发远程下载链接

只要本轮产出了**任何实体成果文件**（软件/安装包/文档/图片/视频/音频/压缩包/代码/网页/脚本/报告……），
**在交付给用户之前必须**执行：

```bash
/vol1/ai/_scripts/deliver-link <文件绝对路径> "<标题>" "<说明>" ["<分类>"]
```

然后把 **完整绝对路径** 和 **DOWNLOAD 链接**（`https://files.hynixing.cn/dl/<id>`，强制下载）
一起交给用户；需要浏览器内预览再补 `/raw/<id>`。

- 完整规则见技能 `remote-download-link`。
- 按 sha256 去重，重复调用不会重复占盘，可以放心每次都调。
- 沙箱会话（workspace-write）写不了成果库目录 → 脚本**自动转队列**，输出 `QUEUED:` / `RESULT:`，
  等约 1 分钟读那个 `.result.json` 拿链接。
- 大文件（>200MB）加 `--link`（软链），**此时源文件不能删、不能移**。
- **禁止**：跳过（除非用户明确说不用给链接）、自己编造链接、发布密钥/凭据/隐私/临时文件。
- 脚本非 0 退出 = 失败，**照实报错**，绝不许拼一个假链接糊弄。

--- 追加内容 · 结束 ---

═══ 第 3 步 · 自检（必须真跑，把原始输出贴出来）═══

```bash
/vol1/ai/_scripts/deliver-link /vol1/ai/deliverables/README-zh.md "装配自检" "验证远程下载链接是否可用" 文档
curl -sI http://127.0.0.1:8086/dl/<上一步输出的 id> | head -3
```

期望：stdout 出现 `DOWNLOAD: https://files.hynixing.cn/dl/<id>`；
`curl` 返回 `200 OK` + `Content-Disposition: attachment`。
（公网直连会先 `302` 到 Cloudflare Access 登录页，属正常——登录后跳回文件。）

═══ 收尾 ═══

回一句「已装配」，并给出：① 自检的真实输出；② 你落地/修改了哪几个文件（绝对路径）。

═══ 附 · 最小可用正文（仅当换到没有现成实现的机器时用）═══

```markdown
---
name: remote-download-link
description: 必须使用：产出任何成果文件后，交付前必须发远程下载链接。
---

# 远程下载链接（强制交付规范）

## 触发
只要本轮产出任何实体成果文件（文档/图片/视频/音频/压缩包/安装包/代码/网页/脚本/报告…），
交付给用户前**必须**发布并给出下载链接。唯一例外：用户明确说"不用给链接"。

## 命令
```bash
/vol1/ai/_scripts/deliver-link <文件绝对路径> "<标题>" "<说明>" [分类]
```
stdout 末两行固定：`DOWNLOAD: https://files.hynixing.cn/dl/<id>` / `PREVIEW : .../raw/<id>`

## 交付格式
必须同时给：① 完整绝对路径 ② `https://files.hynixing.cn/dl/<id>`

## 硬规则
- 按 sha256 去重，可放心重复调用；>200MB 加 `--link`（源文件不能删/移）
- 沙箱写不了成果库目录会自动转队列（QUEUED/RESULT，约 1 分钟后读 .result.json 取链接）
- 失败照实报错，**绝不许编造链接**；密钥/凭据/隐私/临时文件一律不发
- 成果库是 Cloudflare Access 保护（邮箱验证码 24h），不是公开分享

## 实现契约（要自己造 deliver-link 时照这个来）
- 输入：文件绝对路径 + 标题 + 说明 + 分类（可选）+ `--link`（软链不复制）
- 行为：按 sha256 查重 → 复制/软链进 `files/<id>/<原名>` → 写清单 → 打印 DOWNLOAD/PREVIEW 两行
- 退出码：0 成功；非 0 失败（文件不存在/空文件/传了目录），失败时不得输出链接
- 本机真身在 `/vol1/ai/deliverables/publish.py`（子命令 `add/scan/list/rm/verify/serve-info`）
```
