SisyphusSQ/dsh-plugins--packages-dsh-agent-plugins0

dsh-agent-plugins

Agent Plugins 1.0.0 adapter for DeepSeek Harness: discovers skills/ and mcp.json from agent-plugin stores, registers skills and MCP servers, and manages them through a CLI and the settings panel.

AI 분석

核心用途是让 DSH 兼容消费标准的 Agent Plugins 插件包。适合需要引入外部丰富技能和 MCP 工具生态的开发者。提供设置面板和 CLI 管理工具。

패키지
dsh-agent-plugins
버전
0.1.0
라이선스
MIT
최근 업데이트
2026. 8. 14.

설치

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:SisyphusSQ/dsh-plugins#0ee6b6081fca6f4ed36d2208eef0f965775dcb36&path:packages/dsh-agent-plugins

dsh-agent-plugins

Agent Plugins 1.0.0 适配插件:让 DeepSeek Harness (DSH) 直接消费 Agent Plugins 标准插件包(plugin.json + skills/ + mcp.json)。

状态:实验性(M0–M5 全部完成,待真实 profile 装机验收)。 一个 npm 包三合一:host 半(bundle patch)+ client 半(设置面板 tab)+ CLI(agent-plugins)。

已验证环境

  • @deepseek-ai/dsh@0.1.0-rc.6(本机 sqmc04,web profile)
  • 挂载点:设置 → 插件分区的 settings.plugins.tab slot
  • 数据通道:host 半 TypertRemoteService + @Remote;client 半 connection.rpc.call('/api', 'agentPlugins/', { args })
  • 热重载:launcher 无条件提供 HMR 服务并监听 $DSH_HOME/cordis.patch.yml(机制已核实,E2E 见 M3)

里程碑状态

阶段状态
M0 挂载点 + 数据通道 + 热重载机制核实
M1 CLI + store + 台账 + manifest/mcp.json 校验✅(规范 fixture 39/39 通过)
M2 skills provider(含组件级启停)计划中
M3 MCP 映射 + patch 同步 + 热重载 E2E✅(真实 stdio server 注册/启停/卸载全通)
M4 护栏 / doctor / 文档计划中
M5 client 面板(列表 + 两级 toggle + MCP 同列)✅(设计稿对齐 + 侧栏入口:sidebar.footer.action "插件"按钮 + 浮层面板,照 cordis-panel 模式;浏览器实测全通)

设计文档见 docs/design/dsh-agent-plugins.md

CLI(M1 已实现)

agent-plugins install    # 校验通过才入 store;同 name 替换(PLUGIN_DATA 保留)
agent-plugins uninstall             # 删文件与台账,PLUGIN_DATA 保留
agent-plugins update [name...|--all]      # 按台账来源重取(git/dir/zip)
agent-plugins enable|disable        # 插件级启停
agent-plugins enable|disable  --skill  | --mcp    # 组件级启停(--mcp 用限定名 
__,list 可查)
agent-plugins list [--json]
agent-plugins doctor

store 位于 $DSH_HOME/agent-plugins/,台账 installed.json(插件级 enabled + 组件级 skills.*.enabled / mcp.*.enabled,两级均默认 true)。CLI 与 host adapter / 面板共享同一 lib 函数。

开发

pnpm install                 # workspace 依赖
pnpm --filter dsh-agent-plugins build     # tsc host 半 + esbuild client 半

安装进本机 profile(开发期 file: 链接):

dsh plugin --profile web add file:../packages/dsh-agent-plugins

隔离 E2E(不碰线上 profile):

rm -rf /tmp/dsh-ap-test && mkdir -p /tmp/dsh-ap-test
cp -R ~/.dsh/profiles /tmp/dsh-ap-test/profiles
DSH_HOME=/tmp/dsh-ap-test dsh plugin --profile web add file:/abs/path/packages/dsh-agent-plugins
DSH_HOME=/tmp/dsh-ap-test dsh --profile web --port 3090

不做的事

不重写 MCP 客户端、不做插件进程沙箱、不实现 sse、不做 extensions 目录、不做 per-tool allow/deny(不接核心审批)、面板不做安装/卸载/更新(CLI 专属)、一期无市场无发现 tab。