《DeepSeek Harness 操作手册》对应 DeepSeek Harness 0.1.0-rc.6(@deepseek-ai/dsh 系列包),是官方面向桌面端用户的完整操作指南:Windows 桌面端(dsh-desktop.exe)+ 本地 Web 界面(默认 http://127.0.0.1:3080)。全册 49 页、14 章,从安装到深度定制一条线讲完。
手册结构(14 章)
- 第 1-3 章:认识 Harness(特性/架构/安装)、快速上手第一次会话、会话与交互管理 —— 新手必读
- 第 4-5 章:文件与沙箱权限模型、常用工具详解(文件 / Shell / 浏览器等)
- 第 6-7 章:任务处理进阶(多目标、计划模式、Ralph 模式)、Skills 系统(安装/使用/编写)
- 第 8-9 章:Agent Preset 预设系统结构与自定义、模型提供商配置
- 第 10-12 章:深度定制(Cordis 概念 / patch / CLI)、动态 Cordis 配置、数据持久化与隐私
- 第 13-14 章:疑难排错 FAQ、附录(目录结构 / 配置参数 / 命令行)
阅读建议:第一次使用按 1-3 章即可安全上手;4-7 章在了解具体功能时查阅;8-11 章适合希望深度定制 Harness 的用户;13-14 章在遇到问题时翻查。
核心概念速览
- Profile:一种「运行模式」,每个 profile 在 $DSH_HOME/profiles/<name> 下有独立目录与配置
- Bundle:npm 包形式的安装单元(如 @deepseek-ai/dsh-base),可搭配 cordis.patch.yml 注册插件
- Patch:对配置做增量修改(insert / 替换等),与用户配置合并生效
- Plugin / Row:插件行 { id, name, config, disabled, inject },提供 Service、注册 Tool、监听 Event
- 沙箱:Agent 的文件系统影响通过「权限模式 + 确认」双重约束控制风险
下载(本站托管,登录后下载)
先读 1-3 章把 Harness 跑起来,再按需精读工具、Skills 与 Preset;官方手册配橙皮书导读一起看,理解更深。