# Continue CLI 教程：从暂存区diff生成可审校的中文发布说明

本次实际运行：Python标准库参考程序、业务边界检查与HTML渲染。未安装或运行Continue，未调用模型、创建真实自动化、发送消息、建第三方PR或部署。人工基准和错误样稿均明确标注。

## 文件

input.json：原创输入；node-fields.json：字段教材，不能直接当平台导出文件导入；prompt.md：任务约束；schema.json：规范化观察结构；reference.py：本站手写参考；reference-output.json：实际本地输出；reference.html：参考产物；review-template.json：读者填写目标工具结果。

## 本地运行

```bash
python3 reference.py
python3 verify.py
```

用浏览器打开reference.html。不依赖模型或第三方账户。

## 真实平台步骤

1. 确认暂存和未暂存的不同范围
运行reference.py，它在临时Git练习仓库真实暂存筛选/导出变化，再写一条未暂存邮件实验。staged.diff与unstaged.diff都保留为文件，先读懂这两个范围。

2. 安装CLI并记录真实版本
按Continue CLI官方安装页安装后执行cn --version。npm发布包的CLI1.5.47与GitHub的VS Code扩展2.0不是同一版本，正文不混用。首次启动按当前入口登录。

3. 验证只读headless入口
先用不含私有代码的短文本测试cn -p，使用自己的配置。--readonly仅允许只读工具；headless下原本ask的写工具会被排除，不会弹窗一直等待。

4. 把暂存diff作为标准输入
执行node-fields.json中展示的管道，提示词只依据diff，正文写给产品用户。输出重定向到新的release-notes.md；这一步才是目标模型请求，教材没有执行。

5. 检查发布说明的用户可见事实
新增筛选和导出修复可写；内部函数重命名归内部维护，不能说成新产品能力。确认从未暂存的“自动邮件”没有进入结果，也不要把本地变更写成已经上线。

6. 复查仓库没有被模型改动
在调用前后保存git status --short与git diff摘要，确认源码与暂存区不变。包内实际Git范围演示和人工发布说明可在reference.html查看，不能替代cn stdout证据。

7. 人工审校后交给发布流程
把实际模型ID、cn版本、原diff和输出一起归档。需要编辑说明时另存审校版；本题不执行git commit、push、自动发布或真实消息发送。

## 版本与许可

CLI1.5.47为本次npm快照；制作前真实记录`cn --version`。不得混写VS Code2.0版本。此题不需要`--auto`或`--allow "*"`；Continue认证入口与旧IDE自定义API能力须分开验证。

## 来源

- https://docs.continue.dev/cli/headless-mode
- https://docs.continue.dev/cli/tool-permissions
- https://docs.continue.dev/cli/quickstart
- https://www.npmjs.com/package/@continuedev/cli

## 验收边界

把练习仓库的一组staged diff通过stdin传入`cn -p`，stdout保存`release-notes.md`。变化含新增筛选、修复导出、内部重命名，另有未暂存修改作为反例；验收发布说明只描述暂存变化、不写未上线功能、不把内部改名夸为用户功能、Git diff前后一致。产物为Markdown和diff范围核对表。

目标产品实跑时保存原生输出，不得把本包人工/手写参考改名冒充模型返回。所有人物、订单与规则均为虚构练习数据。

渲染说明：input.html、operation.html、reference.html和figures是随当前原创输入冻结的实际浏览器预览；修改输入后重新运行会更新reference-output.json，静态HTML不会自动重绘。目标软件原生结果请另存。