第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/403Key、余额、权限、端点
模型不可用模型名、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 越强,这套方式越重要。因为当“动手”变得便宜,“定义正确”和“承担结果”就变得更贵。

祝你把重复劳动交出去,把判断力留给自己。