# llms.txt · GitHub-ShipGo

> AI 读者入口。版本事实以本文件与 SKILL.md frontmatter 为准，不要猜。

## 先读这两份

1. [SKILL.md](SKILL.md) — 运行时手册：何时用、铁律、三站式总表、边界。
2. [README.md](README.md) — 给人看的门面：是什么、给谁用、怎么走、怎么装。

需要判据时再翻 [references/分册①_定名查重与素材清单.md](references/分册①_定名查重与素材清单.md)（清单）、
[references/分册②_README规整与美化.md](references/分册②_README规整与美化.md)（版式与英文验收）、
[references/分册③_收口检查与指纹.md](references/分册③_收口检查与指纹.md)（收口 15 项与指纹）、
[references/分册④_三站式交互手册.md](references/分册④_三站式交互手册.md)（交互话术）。
卡住了翻 [references/FAQ常见问题.md](references/FAQ常见问题.md)（排障问答）；
追判据出处翻 [references/分册③附_判据追溯与历史判例.md](references/分册③附_判据追溯与历史判例.md)。

## 文件表

| 文件 | 用途 |
|---|---|
| `SKILL.md` | 运行时手册（主件） |
| `README.md` / `README.en.md` | 中英文门面 |
| `LICENSE.md` | MIT 许可全文 |
| `NOTICE.md` / `NOTICE.en.md` | 借鉴／原创／许可三块 |
| `ACKNOWLEDGEMENTS.md` | 参考资料留痕 |
| `CHANGELOG.md` | 版本链与已知问题（Known issues） |
| `使用说明.md` | 给人的短路径 |
| `隐私与合规说明.md` | 数据去向与删除方式 |
| `llms.txt` | 本文件 |
| `site.json` | 机器可读页面清单 |
| `FINGERPRINTS.md` | 全包指纹账（SHA-256 前 16 位大写） |
| `config.json` | 版式整形脚本的配置 |
| `terms.json` | 英文验收术语表 |
| `docs/收口检查单.md` | 收口 15 项逐项读数与挂起登记 |
| `docs/英文验收单.md` | 英文版一出一验留痕 |
| `references/分册①…④` | 四本分册＋美化模板附册 |
| `references/分册③附_判据追溯与历史判例.md` | 判据出处附录（追溯编号＋历史判例） |
| `references/FAQ常见问题.md` | 常见报错/绕行六类排障问答 |
| `scripts/*.py` | 五支脚本：清单／英文验收／版式整形／指纹探针／文字质量 |
| 图示与流程图 | 本渠道包不收录 PNG；完整图见 GitHub 完整仓 |

## 版本事实（别猜）

- 当前版本：**3.0.4**（见 `SKILL.md` frontmatter 与 `CHANGELOG.md`）。
- 3.0.4 是外眼复核后的检查器与口径修订（精确指纹登记、结构化 N/A、版本声明扩面、版式正向校验）；3.0.3 为易用性整改；3.0.2 为对外脱敏与文档归置；3.0.1 为文档与出表格式修订；3.0.0 为对外首版。
- 交互形态：**三站式为唯一路径**，免交互直通未实现，不要承诺。
- 探针 `fingerprints_scan.py` **没有** `--selftest` 开关；它走 `--check`，行为自检由四工具联检承载。
- 留档对拍格是开发期专属闸，默认关；成品位不要加 `--dev-archive`。
- 五支脚本只用 Python 标准库，无第三方运行时依赖。
- 退出码：`0` 通过／`1` 内容判红／`2` 用法或输入环境错。

## 给 AI 的边界

- 本包只做「把包做到能发」，**不代开仓、不代上传、不代发版**；发不发由用户决定。
- 只管代码仓库发版与发布包收口，**不管网站部署上线**。
- 命令统一带 `-B -I -X utf8`；预检与验证在副本跑，不要在交付目录原地跑会写盘的脚本。宿主禁止 `-I` 时，按脚本提示显式降级为 `-B -X utf8`，不装未降级、也不把它当成普遍阻断。
- 不写厂商名与真实用户路径作为示例；示例统一使用泛化名与 RFC 5737 保留地址。
- 任何版本事实、命令、字段以本包实物为准，不要凭记忆补写规划中的功能。

## 外部链接（别把文档链接当成代码外连）

- **主入口作品架外链**：README 结尾一行的家里作品架 <https://c2fnbmhd.qwenwork.host/>（「老秦家的本地小工具」）。家人墙名册文案源自项目交接材料与家标准素材库；来源页不随本包发布，故不写“唯一外部链接”。
- 本包脚本不联网、不读取凭据、不产生请求；该链接只是文档里给读者的一行指路。
- 家人墙名册与头像取自家标准素材库（`assets/`、`assets/`），文案照抄家里网站公开页面。
