# AGENTS.md — /home/zyclaw/dl 产物投递目录

> 本文件专门写给 AI 助手阅读。人类用户请看 README.txt。

## 这个目录是干嘛的

这是 DSH 助手向用户交付生成文件的**对外投递点**。助手每次生产出用户需要的文件
（报告、脚本、数据包等），应使用 `~/.local/bin/dl <文件>` 命令将其拷入本目录，
然后把输出的公网直链发给用户。

## 链接结构

```
https://dshdl.yufengduxing.cn/<文件名>   ← 公网永久直链(有30天有效期,见下)
http://192.168.1.5:8890/                 ← 局域网备用入口(同样有30天规则)
```

链路：本目录 → python http.server(:8890, systemd 用户服务 `dsh-dl.service`)
→ frp 隧道(`dsh-dl-frpc.service`, 本机8890→VPS:18083)
→ VPS Caddy(`dshdl.yufengduxing.cn` 块, /etc/caddy/Caddyfile)。

## 有效期规则（重要）

- 每个文件的公开链接自放入本目录起 **30 天有效**。
- 到期后由 systemd 用户定时器 `dsh-dl-expire.timer`（每日 03:30 执行
  `~/.local/bin/dl-expire`）自动把过期文件**移动**到 `/home/zyclaw/dl-archive/`，
  公网链接随之失效（404），**文件本身不会被删除**。
- 例外：`AGENTS.md` 与 `README.txt` 是元文件，永不过期，永不被移动。

## 过期文件去哪找

- 归档位置：`/home/zyclaw/dl-archive/<发布年-月>/原文件名`
  （按文件放入本目录的月份归档，见 dl-archive/AGENTS.md）。
- 用户询问"之前那个文件呢"时：先在本目录找，再到 dl-archive 对应月份找，
  归档时间线可查 `/home/zyclaw/dl-archive/expiry.log`。
- 用户若要重新获取：把归档文件再跑一次 `dl` 命令即可重新发布（新的30天）。

## 给助手的操作约定

1. 交付文件一律用 `~/.local/bin/dl <文件>`，并把直链原样发给用户。
2. 不要在本目录放敏感/私密文件——链接是**公开的**，知道网址即可下载。
   确需投递敏感文件时，与用户确认，或给文件名加随机后缀。
3. 不要手动修改 `expiry.log`；它是 dl-expire 脚本自动追加的流水。
4. 不要把整目录打包再投回本目录（会套娃）。
5. 本目录与 `~/dl-archive` 的规则若需变更，先与用户确认再改本文件。