华创证券 AI投研工具研究之三：探索未至之境 DeepSeek Harness使用手册

摘要

华创证券金融工程团队发布 AI 投研工具系列第三篇，系统讲解 DeepSeek 于 2026 年 8 月开源的本地部署型智能代理 DeepSeek Harness（DSH）的安装、使用与投研实战。 报告核心判断是：网页版 DeepSeek 仅为云端 SaaS 问答服务，而 DSH 具备文件读写、脚本修改与命令执行权限，实现从“理解意图”到“执行动作”的完整闭环，信任边界从输入框扩展至整个本地开发环境。 架构上，DSH 基于 Cordis 微内核实现“一切皆插件”，模型适配器、工具注册表、Agent 主循环乃至 UI 均可在配置层替换而无需修改源码，官方内置一百多个插件、社区精选列表收录超千个。 报告提供桌面安装包、npm 快速启动（npx @deepseek-ai/dsh web，需 Node.js v22.19.0+）与源码安装三条路径，强调“先选工作区再选模式”的硬性顺序，并支持 CLI 与 Headless 模式适配远程服务器与一次性任务。 投研实战方面，DSH 可通过 MCP 协议接入华创金工 Seek Alpha 服务的 23 种专业工具，在创造模式下用自然语言让 Agent 自行生成并验证配置，固化为永久保存的专属“投研助手”Preset。 生态方面，DSH 于 2026 年 8 月 13 日开放测试（首发 v0.1.0-rc.6，MIT 协议），截至 8 月 27 日 GitHub 已获超 19 万 Star、Fork 近 2.3 万、dsh-plugin 标签公开仓库约 12000 个，但官方治理相对缺位，安装社区插件前需审查源码。 总评认为 DSH 代表 AI Agent 从“对话”到“行动”的能力跃迁，是将大模型能力转化为生产力的高潜力工具，但插件层学习曲线陡峭、版本兼容性风险尚存，能否在 Agent 基础设施层建立长期壁垒值得持续关注。

主要观点

• 核心定位：网页版 DeepSeek 是云端 SaaS 对话服务，能力被锁定在“问答”单一维度，无法感知本地文件结构、无法读写代码与数据资产；DSH 则是本地部署型智能代理，具备文件读写、脚本修改及命令执行权限，可直接触发本地 Python 解释器重跑回测，两者共享基础模型能力，差别在于 DSH 多了一层操作执行层。

• 信任模型差异：网页版信任边界止于输入框，DSH 扩展至整个本地开发环境，须配备操作前二次确认、敏感目录黑名单、命令执行沙箱等细粒度安全管控；相比 Cursor 等本地代码工具，DSH 的 Agent 化程度更高——不仅补全代码还能主动执行命令、串联多步骤任务，且按 API 调用量计费、不设订阅额度上限，对高频使用更具成本弹性。

• 安装有三条路径：桌面安装包（.exe 双击安装、免装 Node.js）、npm 快速启动（终端执行 npx @deepseek-ai/dsh web，需 Node.js v22.19.0+，最快捷）、源码安装（git clone 后 pnpm install && pnpm run build，适合二次开发）；次日重新执行相同命令不会重复下载 342MB 依赖，API Key 明文存于 ~/.dsh/.credentials.yaml，权限必须仅本人可读。

• 工作区须在系统内部登记簿中显式注册才会被识别加载，删除工作区仅移除记录、不动磁盘文件；实测发现的硬性规则是务必先选定工作区再选模式——先选 PTC 模式再添加工作区，返回时模式会被无声重置为标准模式且界面无任何提示；Windows 下工作区路径存在中文截断问题，建议项目放在纯英文、无空格短路径下。

• 四种官方 Agent 预设（标准/PTC/极简/创造）本质是同一套插件树的不同组装方案：标准模式涵盖文件编辑、Shell、检索、计划模式、子代理等全部能力，为日常首选；PTC 额外提供 Code Mode SDK，适合大批量搜索与多步骤自动化；极简模式仅保留 bash 和 str_replace_editor 两个工具，存在认知漂移风险，投研生产环境不建议使用；创造模式专用于开发新预设或插件。

• 轨迹视图是 DSH 区别于同类产品的关键设计：提供原始事件级记录而非润色后的对话摘要，可随时回放、查看会话内部每个步骤并核算各环节的 token/费用消耗；对投研的价值在于可审计性——策略回测中 Agent 改了什么参数、跑了什么命令、基于什么判断都能回溯验证，避免“说不清改了什么”的合规风险。

• 推理档位提供 Off/High/Max/Low 配置，可在会话侧边栏直接调整，同时影响成本与输出质量；DeepSeek 对 V4 系列推理档位有明确定价梯度（缓存命中率不同时差异显著），建议日常用 High、复杂任务临时切 Max、Off 基本不用，Max 档在复杂投研任务中能减少“来回拉扯”的回合数。

• “一切皆插件”是架构事实而非口号：DSH 基于 Cordis 微内核构建，微内核只负责插件加载、卸载与依赖管理，模型适配器、工具注册表、会话日志、Agent 主循环、系统提示词组装乃至 UI 界面全部是可替换插件，改模型后端、沙箱策略、Agent 行为均在配置层完成、无需 fork 源码；Cordis 的“时间可组合性”保证插件卸载时能力被完整安全逆转、不留“僵尸状态”；官方已内置一百多个插件，社区精选列表收录超千个。

• Skill 是“操作手册”式特殊插件，可通过命令安装（装后需重启并用 dsh --profile web --dump-config 验证）、让 Agent 自行安装或手动复制三种方式部署，用户级目录 ~/.dsh/skills/ 对所有工作区生效；AGENTS.md 机制支持写入“禁止修改生产配置文件”“禁止删除回测原始数据”等永久性投研红线规则并自动注入每个会话系统提示，且兼容读取 Claude Code 的 CLAUDE.md，团队迁移无需重写规则。

• 报告辩证指出插件层三大局限：一是学习曲线陡峭，写一个 dsh 插件需懂依赖注入、副作用模型、事件链语义等底层概念，官方为此配了一份入门读物、四课教程、五篇接口文档、三层九篇开发指南；二是版本更新未必兼容，README 重点标注“未来将出现破坏兼容性的变更”；三是生态尚未建立，无市场、无搜索、无安装量，调研时仅 238 个项目带标签、8 月 14 日凌晨增至 476 个且含蹭热度空项目，官方明确给出的第三方插件案例只有一个。

• 投研实战：通过华创金工 MCP 服务，研究员在一个对话入口即可调用 23 种专业能力，覆盖基本面与财务分析、技术面与形态学信号、机构调研与持仓数据、产业链查询、舆情监测、龙虎榜、券商金股等；既可手动在 .dsh/agents/ 下编写 seek-alpha-investment.yml 预设（extends standard 并启用 dsh-mcp 插件），也可在创造模式下用自然语言描述需求，由 Agent 在 ~/.dsh/.agent-presets/ 下生成配置并实时挂载验证，固化保存后重启依然存在，形成开箱即用的专属投研工具链。

• 生态热度与治理风险：DSH 于 2026 年 8 月 13 日正式向全球开发者开放测试（首发 v0.1.0-rc.6，MIT 协议开源），截至 8 月 27 日 GitHub 仓库已获超 19 万 Star、Fork 近 2.3 万、挂载 dsh-plugin 标签的公开仓库约 12000 个，插件方向涵盖视觉能力、浏览器调用、文件管理、Token 费用管理与长期记忆；但官方治理相对缺位，大量标签仓库存在蹭热度、低质量乃至广告类项目，投研场景安装社区插件前建议审查源码并优先选择精选列表高星项目；报告另推荐 dsh-web-ui、dsh-better-sidebar、dsh-TUI、deepseek-harness-desktop、dsh-agent-teams、sh-context-doctor 六个插件。

论述逻辑

• 起点：网页版 DeepSeek 遵循 SaaS 交付，模型能力与本地环境严格隔离，在依赖本地代码库、历史回测数据和实时行情接口的量化策略研发场景几乎无能为力，暴露出 AI 从“对话”到“执行”的关键缺口。

• DSH 以本地部署型智能代理形态补上操作执行层：通过系统接口获得文件系统、进程管理和 Shell 命令调用权限，所有交互在命令行上下文中自然衔接，形成从“理解意图”到“执行动作”的完整闭环。

• 架构层面，DSH 基于 Cordis 微内核实现“一切皆插件”，模型、工具、技能、会话、沙箱、存储、循环、调度、UI 全部为独立插件、可插拔替换且无需修改源码，赋予极强扩展性。

• 产品机制层面，Agent 预设以“岗位说明书”方式定义会话能力边界，轨迹视图把黑盒变白盒实现全流程可审计，推理档位用成本换质量，Skill 与 AGENTS.md 提供可复用的规则注入。

• 落地层面，MCP 协议使 DSH 无缝接入华创金工 Seek Alpha 的 23 种专业金融数据工具，在创造模式下由 Agent 自行组装并验证配置、固化为专属 Preset，将技术架构转化为可落地的投研生产力。

• 生态层面，开源后社区驱动的插件体系快速繁荣、持续降低使用门槛，但官方治理缺位要求投研场景安装插件前审查源码，构成使用侧的硬约束。

• 结论：随着 Agent 能力成为 AI 应用的核心竞争点，DSH 有望成为量化投研、自动化开发等专业场景的基础设施级工具；但学习曲线陡峭、版本兼容性与生态空缺意味着长期壁垒仍待观察。

关键展望

• 报告总评：DSH 代表 AI Agent 从“对话”到“行动”的能力跃迁，对专业工作者而言是将大模型能力转化为生产力的高潜力工具，但能否在 Agent 基础设施层建立长期壁垒，值得持续关注。

• 版本兼容性是明确的未来变量：README 重点标注“未来将出现破坏兼容性的变更”，现在编写的 dsh 插件随时面临后续版本不兼容的风险。

• 官方迭代方向：自开发者预览版以来已连续完成 v0.1.0-rc.7、v0.1.0-rc.8、v0.1.1-rc.1 三次版本更新，主要围绕多模态能力、子代理协作、跨平台兼容和日常使用体验展开，模型适配器已新增 DeepSeek-V4-Flash-Vision-Exp 多模态模型选项。

• 生态治理展望：官方治理在插件生态中相对缺位，大量标签仓库存在蹭热度、低质量乃至广告类项目；投研场景下安装社区插件前建议审查源码，确认无数据外传或越权风险，优先选择社区精选列表中的高星项目。

• 风险提示：报告所述所有工具、数据、报告及 AI 生成内容均仅供参考与研究使用，不构成任何形式的投资建议、买卖推荐或操作指令；报告未给出任何证券评级、目标价或行情时间窗口。

推荐标的

• 报告未明确给出推荐标的。本文为 AI 投研工具评测类专题报告，无覆盖公司、评级、目标价或买卖建议，风险提示明确声明不构成任何形式的投资建议。

• 报告第四章给出六个 DSH 插件推荐（均非证券标的）：dsh-web-ui 为“从毛坯到精装”的一站式 UI 全家桶，“如果想装一个插件”时首选；dsh-better-sidebar 将 WebUI 变成 Codex 风格工作台；dsh-TUI 把 Harness 搬回终端、是最火插件之一；deepseek-harness-desktop 打包为 Electron 桌面应用、双击即用免装 Node.js；dsh-agent-teams 一句自然语言即可驱动多智能体团队协作；sh-context-doctor 逐项量化指令链/技能目录/工具 schema 的 Token 成本并给出裁剪建议。