DeepSeek Harness (dsh) 结构泄露分析

来源：dsh-vision-fix（dsh-external/dsh-vision 的残留 fork，上游已经私有化）

背景

DeepSeek 目前（2026.8.12）还没有发布的 @deepseek-ai/dsh（目前还是 npm 私有 scope）。官方插件组织 dsh-external 全部仓库已私有化。

从代码目录的角度来看的结构

monorepo 结构（scripts/build.sh 泄露）：

packages/core/tools         → @deepseek-ai/dsh-tools

packages/core/session       → @deepseek-ai/dsh-session

packages/core/scope         → @deepseek-ai/dsh-scope

packages/core/system-prompt → @deepseek-ai/dsh-system-prompt

packages/llm/llm            → @deepseek-ai/dsh-llm

packages/util/brand         → @deepseek-ai/dsh-brand

vendor/{cordis,cosmokit,schemastery}   ← dsh 主程序 vendored 依赖

插件体系：dsh 的插件系统很可能基于 cordis 4（Koishi 底层引擎）。叠甲：这里只是根据包结构进行的猜测。

插件标准形态

export function apply(ctx, config) + inject 声明依赖，加载方式 ctx.plugin()，工具注册走 ctx.tools.register(defineTool({name, description, parameters, execute}))（dsh-vision 插件的 view_image 就是这个模式，故进行合理推测）。

插件清单

每个插件带清单 dsh.plugin.json：声明 engines.dsh（兼容版本）、contributes.tools / contributes.skills（提供哪些工具和技能）。

插件的安装方式

1. 
   

   命令行安装（命令式）——dshx install/verify，dshx 是 dsh 配套的扩展管理命令。README 里的用法：

   
   

   dshx install dsh-vision XXX/ dsh-external/dsh-vision && dshx verify dsh-vision
   
   

   
   

   另有 dsh registry install/enable 可装可启用；第三方插件管理器 Marisa 也是官方通道之一，但 README 提到其 issue #2 有个 bug——“修复前，装完仍需手工链接宿主依赖”，可以说明当时还不完善。

   
   


2. 
   

   配置文件声明式挂载——在 ~/.dsh/config.yaml 里直接声明要挂载的插件，dsh 启动时读配置自动加载，无需执行命令：

   
   

   - insert:
   
       - id: dsh-vision
   
         name: '$HOME/dsh-plugins/dsh-vision/lib/index.js'
   
   

   
   

产品形态

dsh（command -v dsh，npm 全局安装的 Node CLI）。

多入口：web（浏览器访问本地 UI）、TUI（终端界面）、远程通道

（README 原话"dsh 的所有入口（web、TUI、远程通道）"）。