AI投研工具研究之三：探索未至之境-DeepSeekHarness使用手册

目 录一、为什么有了网版还需要DeepSeekHarness 5二、DSH的安装与使用 5（一）装法 5（二）DSH用节 71、作区 72、Agent预：份能力 73、迹（Trajectory）：黑盒白盒 84、理位用本质量 95、件态一皆件 96、CLI模：端一只手 107、Headless模：性任务 8、Skill：操手的件化 9、AGENTS.md：则入与产兼容 1310、完的区持馈渠道 13、生热与件现状 13（三）何解切件 13三、DSH+华创金工MCP实战 151、动作式 152、造式构建 17四、DSH插件推荐 191、dsh-web-ui 192、dsh-better-sidebar 193、dsh-TUI 204、deepseek-harness-desktop 205、dsh-agent-teams 206、sh-context-doctor 20五、总结 20六、风险提示 21图表目录图表1 DSH安方法 6图表2 置型 7图表3 种Agent官预设 8图表4 8图表5 理位 9图表6 10图表7 CLI模式 图表8 skill应方法 12图表9 定研式 18图表10 侧栏式 19一、为什么有了网页版，还需要DeepSeekHarness网页版DeepSeek与DeepSeekHarness（下面简称为：DSH）属于两类产品形态。而DeepSeekHarnessDSHDeepSeekSaaS信息获取、概念解释和初步分析等场景“对话”DSH——ShellDSH“”，而是JSONPythonPython形成从“”到更深层次的差异体现在权限管理与信任模型上——DSHDSH型理解偏差或恶意指令注入而引发意外后果。本质上是在向用户警示：两者虽同名“DeepSeek”，但安全假设和操作边界截然不同，不可混为一谈。DSHCursorDSH的差异化在于其Agent化程度更高它不仅补全APIDeepSeekDSH“”与”“动手”DSH二、DSH的安装与使用（一）安装方法DSH图表1 DSH安装方法安装方式适用人群核心步骤优点桌面安装包(Desktop)令行的用户下载.exe安装包双击运行，按提示完成安装无需安装Node.js等环即可使用。npm快速启动用户1.安装Node.js(v22.19.0+)2.在终端执行：npx@deepseek-ai/dshweb行，适合初次尝鲜。源码安装进行二次开发的用户Node.jsv22.19.0+)pnpm克隆源码：gitclone/deepseek-ai/deepseek-harness.git安装依赖并构建：pnpminstall&&pnpmrunbuild启动：pnpmdshweb修改和贡献。SH哪怕是已经正常安装，也需要注意下面的问题：dsh:30803080次日重新执行相同命令即可，不会重复下载342MB依赖。历史会话保存~/.dsh/sessions/~/.dsh/sessions/Key~/.dsh/.credentials.yaml初次安装的时候，进入到网页中会要求填写DeepSeek的APIKEY，可以先在/sign_in中申请APIKEY。如果后期需要修改切换不同的大模型，可以在网页左下方设置中重新设置大模型。图表2 设置模型SH（二）DSH使用细节1、工作区初次使用DSH时，很多人遇到的第一个困惑就是工作区的概念。它与我们熟悉的终端——在ClaudeCodeDSH并不会触动磁盘上的实际文件；被删除工作区下的会话会全部归入“未分组”在实际操作中，界面上两个下拉选项的先后顺序并非无关紧要。实测发现，PTC注意：工作区路径设置或存在Windows（2、Agent预设：身份即能力DSH/Agent（Preset）Agent——”官方内置四种预设：图表3 四种Agent官方预设预设定位适用场景标准模式（standard）功能完整的编码Agent，涵盖文件编辑、Shell、文件与网页检索、Skills、计划模式、目标追踪、子代理和工作流等全部能力日常投研：写代码、修Bug、分析项目，默认首选PTC模式CodeModeTypeScript程序来组合多步操作自动化处理极简模式（minimal）仅保留bash和str_replace_editor两个工具，用于基准测试和最小化复现最小Agent测试、简单修改、快速验证创造模式（cordis）在标准能力之上，额外提供运行时检查、插件实验和preset创作指导开发新的Agent预设或插件SHPTC这是DSHAgentDSH——它不是Chat观定位“”token/对投研而言，这一功能的价值在于可审计性：策略回测中Agent改了什么参数、跑了什么命令、基于什么判断，都能回溯验证，避免“说不清改了什么”的合规风险。图表4 轨迹SH4、推理档位：用成本换质量DSH支持三档推理强度（ReasoningLevel）配置，可在会话侧边栏直接调整：图表5 推理档位档位说明投研适用场景Off无额外推理简单问答、快速确认High中等推理深度日常编码、脚本修改Max最高推理深度复杂策略设计、架构决策、多步任务规划Low低推理深度简单推理工作SHDeepSeek对V4——Max5、插件生态：一切皆插件DSH”（everythingisaplugin）如何在DSH中安装插件：方式一：通过WebUI设置面板，在插件管理中添加插件ID。方式二：在终端执行dshplugin--profilewebadd<plugin-id>。插件的权限边界：插件与模型共享同一安全沙箱，遵循工作区权限预设。投研环境中安装社区插件前，建议先审查其源码（MIT许可），确认不会外传数据或执行越权操作。图表6 插件SH6、CLI除UIdsh-cli-modeAgentCodex——CLI安装与使用：npminstallgdsh-cli-mode #dsh-cli #地址dsh-cli--resumeid] #dsh-cliattach<id> #LiveCLI（SSH）DSH与shell/CIAgent执行（@注意：CLI模式目前为社区插件，非官方核心功能，安装前建议审阅源码（MIT许可，dsh-cli-modenpm）CLIAPIKeyUI图表7 CLI模式SH7、Headless模式：一次性任务DSH提供HeadlessUI使用方式：dsh--profileheadless"任务描述"8、Skill：操作手册的插件化DSH将Skill定义为一种特殊形态的插件——如果说模型是大脑、工具是软件和权限，那么Skill就是一份“操作手册”，告诉模型遇到某类任务时具体应该怎么做。Skill（）：dsh-code-review：按本仓库规范审查PR代码，检查肉眼不易发现的问题dsh-find-simplifications：识别可简化的代码块，并将简化想法写成AgentNotedsh-doc-standards：文档层级、区分教程与参考、砍“文档废话”dsh-prose-standard：全仓库文字品控（Markdown、JSDoc、代码注释、提示词等）Skill/SkillUIdshplugin图表8 skill应用方法创证券DSH安装Skill有三种主要方式。由于Skill本质上就是放在特定目录下的Markdown文件（每个Skill文件夹里有一个SKILL.md）。方法一：命令安装（推荐，最常用）安装后需要重启DSH（重新运行dshweb并刷新浏览器），Skill才会出现在会话的技能dsh--profileweb--dump-configSkill方法二：让Agent如果觉得敲命令麻烦，直接告诉DSH的Agent来帮你安装即可。在Web界面的对话输入框中，直接发送类似下面的指令：“帮我安装这个链接里边的插件：/LayneChai/superpowers-dsh”或者更简单：“dsh-mattpocock-skills”Agent会自动读取相关说明，并执行dshpluginadd命令，完成安装和配置。方法三：手动安装（最底层）这是最直接、也最“朴素”的方式，因为Skill本身就是纯文本的Markdown文件。可以手动将Skill文件夹复制到DSH的扫描目录下，它就能被识别。~/.dsh/skills/Skill<>/.dsh/skills/9、AGENTS.md：规则注入与跨产品兼容DSH支持读取项目根目录的AGENTS.md文件——该文件可写入永久性规则（如“禁止修改生产配置文件”“禁止读取.env”），内容会自动注入每个会话的系统提示。ClaudeCodeDSH投研应用：可在工作区根目录的AGENTS.md中写入投研红线规则，例如“禁止修改外部数据库连接串”“禁止删除回测原始数据”，作为模型行为的一道硬约束。10、完善的社区支持与反馈渠道DSH于2026年8月13以MIT续完成三次版本更新：v0.1.0-rc.7、v0.1.0-rc.8，以及v0.1.1-rc.1子代理协作、跨平台兼容和日常使用体验展开，同时修复了社区反馈的一系列问题。DeepSeekDeepSeek-V4-Flash-Vision-Exp11、生态热度与插件治理现状DSH上线后热度爆发，截至2026年8月27日，GitHub仓库已获超19万Star，Fork近2.3dsh-plugin12000个。风险提示：官方治理在插件生态中相对缺位，大量标签仓库存在蹭热度、低质量乃至广告类项目。投研场景下安装社区插件前，建议审查源码（MIT许可），确认无数据外传或越权风险，优先选择社区精选列表中的高星项目。（三）如何理解一切皆插件DSHAgent第一层：架构事实——没有特权组件DSHCordis插件元框架构建——一个只负责插件加载、卸载与依赖关系管在CordisDSHUI……ctx.llmctx.toolsctx.agentLoop这一设计的直接结果是：任何组件都可以被替换，且无需修改源码。要更换模型fsseam的providerBashLSPCordis”——kill后状态僵尸状态”。第二层：产品形态——预设是一组插件组合DSH（/PTC/极简创造DSHProfile（web、headless）BundleBundledsh-basedsh-web-appUIcordis.patch.ymlpatchdsh--profileweb--dump-configpatchAgentfork第三层：能力边界——MCP/Skill/Subagent全部归入同一套插件机制DSH的Cordis插件不好直接类比MCP或Skill。它的特点在于——把ClaudeCode的Hooks、MCP、Subagents和内部核心Loop全部统一成一种插件机制。具体来说：工具ctx.tools（SystemPrompt）Agent（AgentLoop）（Subagent）这意味着可以在不修改DSH源码的情况下，替换Agent最核心的执行逻辑——这在传统Harness中几乎不可能做到，因为主循环通常是被框架写死的。但我们也必须辩证的看待：一切皆插件是有反面的：SkilldshREADME.mddshGitHub238814476但标签下并非都是DSHMCPskillMCP层，三、DSH+华创金工MCP实战MCP23种AI——”“。MCPAI”AIAI投研的深度和效率将被提升到一个前所未有的水平。无论是买方、卖方的专业研究员，AIMCP“”。DSH的更新使得MCP服务有了更多的AI对话工具。将DSH与SeekAlphaMCPPreset（预设）来实现一键加载投研工具集。Preset“DSHSeekAlpha的MCP1、手动操作方式操作步骤如下：.dsh/agents/文件seek-alpha-investment.yml.yml.mpt（）yaml文件可以这样写：#预设名称，会在DSH界面中显示name:seek-alpha-investment#预设描述，说明其用途description:"一个集成了SeekAlphaMCP投研工具集的投研助手预设"#导入基础预设（通常为标准模式），在此基础上进行扩展extends:standard#系统提示词，定义这个预设的角色、能力和行为准则prompt:|你是一位专业的证券投研助理，专为中国资本市场研究设计。##核心能力你拥有完整的SeekAlphaMCP工具包，可以调用以下类型的工具：##工作准则**SeekAlpha工具来获取数据，而不是依赖你自己的知识库猜测。**数据准确性**：在回答中引用数据时，务必清晰说明数据的来源（如“根据SeekAlpha数据...”），（）****（****#启用并配置MCP插件plugins:#dsh-mcpid:dsh-mcpenabled:#如果MCP配置文件不在默认路径，可以在这里指定#config:# mcpConfigPath:"/path/to/your/mcp/config.json"#还可以在这里指定此预设默认使用的模型、推理档位等#model:deepseek-v4#reasoningLevel:high在DSH中加载并使用：DSH(dshweb)。在DSH的Web界面中，创建一个新会话（或切换现有会话）。在会话的设置或模式选择区域，应该能在预设列表中看到新创建的seek-alpha-investment。DSHAgentSeekAlpha2、创造模式下构建前文涉及的全部操作可以在“创造模式”下创建，正是官方推荐的标准工作流。“创造模式”（Cordis）本身就是为这个目的设计的——它不是用来完成日常编码任务的，而是让你在运行时动态检查、试验和组合插件，然后把验证有效的配置“固化”成一个新的Preset。整个过程更像一个“实验室”工作流，而非简单的“点一下生成”。开启对话：在DSH中新建会话，选择预设为“创造模式”。Presetseek-alpha-investmentstandarddsh-mcp[......]让Agent动手并验证：在“创造模式”下，Agent拥有检查和修改部分运行时的能力。它会尝试通过一系列操作来满足你的要求，例如：Preset在用户配置目录（如~/.dsh/.agent-presets/）下创建新预设所需的preset.yml和agent.cordis.yml文件。尝试在当前会话中挂载这个新组合进行实时验证，检查工具列表和提示词是否符合预期。为什么推荐用“创造模式”省去手写配置的繁琐：不需要手动去研究agent.cordis.yml的准确语法和插件ID。通过描述，让Agent帮忙生成和拼装配置文件，极大降低了门槛。SeekAlphaAgentDSH→利用AgentDSHAgentAgent重要提醒PresetUIAgent能UIseek-alpha-investment预设动态创建vs固化保存：“创造模式”下创建的Preset会写入你的本地用户配置目录DSH基础起点：如果完全从零开始描述，Agent可能缺乏基础。建议在请求时明确“基于standardAgentAgent图表9 设定投研模式SH做到目前，只是把MCP能力封装成Preset。还可以通过插件dsh-better-sidebar扩展成侧边栏模式。图表10 侧边栏模式SH这完全归功于DSH“”UISeekAlpha的MCP“”AgentUI）四、DSH插件推荐下面插件都可以通过DSH对话框直接安装。1、dsh-web-ui它“从毛坯到精装，一站式全家桶”，是一套整体的ui插件。如果想装一个插件，dsh-web-ui是首选。默认的dshweb界面相当于纯聊天框，较为朴素。GitUI、宠物、实时2、dsh-better-sidebar它把WebUI变成Codex风格的工作台。如果习惯用Codex或ClaudeCode的界面风格，可选择dsh-better-sidebar。Harness