第13章 附录
第 13 节 / 共 13 节
课程:DeepSeek Harness 实战课
课程附录:命令速查、提示词模板、故障排查、术语表、官方链接和版本说明。
这一章是工具页:命令、模板、排错、术语、官方链接和版本说明,适合在用的时候回来查。
附录 A 命令速查
npm install -g @deepseek-ai/dsh
npm update -g @deepseek-ai/dsh
dsh web
dsh tui
dsh headless "任务描述"
dsh --version
dsh --help
dsh plugin --profile web add <package>
dsh --dump-config
附录 B 提示词模板
B1 只读调研
先不要修改任何文件。
目标:<...>
范围:@<目录/文件>
请输出:
1) 目录/模块结构;
2) 关键入口与调用链;
3) 3 个风险点(附路径:行号);
4) 你还不确定的地方。
B2 代码修改
目标:<...>
上下文:@<文件>
约束:
- 只改 <范围>;
- 不改依赖/数据库;
- 最小改动;
- 先给计划,确认后执行。
验收:<测试/指标>
交付:diff + 测试输出 + 回滚命令。
B3 审查
你是挑剔的代码审查者。请审查 @<diff/文件>:
- 正确性;
- 边界条件;
- 安全;
- 性能;
- 可维护性。
每条给出证据与修改建议;不要改代码,只出报告。
B4 交接
请根据当前会话与 NOTES.md,写一份交接文档:
目标/已完成/未完成/关键文件/决策/风险/下一步/复现命令。
附录 C 故障排查
| 现象 | 优先检查 |
|---|---|
| 401/403 | Key、余额、权限、端点 |
| 模型不可用 | 模型名、provider 配置、目录 |
| 工具调用失败 | 命令是否存在、路径、权限 |
| 输出跑偏 | 上下文是否冲突、约束是否明确 |
| 循环重试 | 加停止条件、换方案、人工介入 |
| 上下文溢出 | 压缩、拆任务、只给必要文件 |
| 定时任务不跑 | 宿主是否运行、时区、日志 |
| 文件被改坏 | git diff、备份、回滚 |
附录 D 术语表
- API:调用模型的接口,按 token 计费。
- Token:模型处理文本的基本单位。
- Agent:模型 + 循环 + 工具 + 上下文 + 约束。
- Harness:Agent 的运行外壳。
- Profile:DSH 的插件组合方案。
- MCP:连接外部工具/数据的协议。
- Subagent:由主 Agent 委派的子代理。
- Context Window:模型一次能看到的上下文长度。
- Prompt Injection:外部内容伪装成指令,诱导越权。
- Headless:无界面的一次性运行模式。
附录 E 官方链接
- DSH 文档:https://deepseek-harness.github.io/deepseek-harness/
- 快速开始:https://deepseek-harness.github.io/deepseek-harness/guide/quickstart
- 模型配置:https://deepseek-harness.github.io/deepseek-harness/guide/providers
- Python SDK:https://deepseek-harness.github.io/deepseek-harness/guide/python-sdk
- 插件市场:https://deepseek-harness.github.io/deepseek-harness/guide/plugin-market
- Releases:https://github.com/deepseek-ai/deepseek-harness/releases
- npm:https://www.npmjs.com/package/@deepseek-ai/dsh
- DeepSeek API 文档:https://api-docs.deepseek.com/zh-cn/
- API Key:https://platform.deepseek.com/
附录 F 版本说明
本课基于 2026 年 11 月的 DSH 0.2.x 与 DeepSeek API 文档编写。技术预览版迭代较快,最容易变化的是:命令与参数(以 dsh --help 为准);模型名称与价格(以官网为准);插件/MCP 配置字段(以官方配置目录为准);桌面端安装包格式;权限与审批策略。
遇到不一致时,优先相信:你本机的 --help + 官方文档 + 实际运行结果,而不是任何二手教程。
结语
学完这门课,你不需要成为“提示词大师”,也不需要背一堆命令。你真正要建立的,是一种工作方式:
先把目标说清楚,再把上下文给对,再把边界划出来,然后让 Agent 去跑,最后用证据验收。
Agent 越强,这套方式越重要。因为当“动手”变得便宜,“定义正确”和“承担结果”就变得更贵。
祝你把重复劳动交出去,把判断力留给自己。
《DeepSeek Harness 实战课》课程目录
面向应用者的 DeepSeek Harness 实战课:讲清 API、Agent、Harness 三者关系,带你安装 DSH、写出可验收任务、让 Agent 读文件改代码跑测试、接 MCP/插件、做定时任务,并划清安全边界