READMESource: main@5de2aea9
dsh-plugins
DeepSeek Harness Web 插件集合。每个插件一个目录,通过 profile 的
dsh.profile.bundles 挂载到 dsh 进程。
插件列表
| 插件 | 说明 | 文档 |
|---|---|---|
dsh-d2-diagram |
把 d2_render 工具生成的 D2 图表内联显示在对话中,支持缩放、平移、源码查看与下载 |
中文 · English |
dsh-gpt-image |
注册 gpt_image 工具调用 OpenAI gpt-image-1 生成图片,自带 dsh-gpt-image skill 生图指导,并在对话中内联显示生成图片,支持下载与打开 |
中文 · English |
dsh-mermaid-diagram |
注册 mermaid_render 工具,把 Mermaid 源码渲染为 SVG 并在对话中显示,支持缩放、平移、源码查看与下载 |
中文 · English |
dsh-workspace-categories |
给左侧工作区文件夹加上自定义分类树:视图选项里新增「按分类」分组与「管理工作区分类」,把工作区拖到分类下完成归类,用分类树代替长长的默认工作区列表 | 中文 · English |
dsh-usage-stats |
侧边栏新增「用量与成本」页面:从真实会话日志统计总 token、会话数量,按 token 单价估算成本并对照预算,展示 token 消耗时间线、各会话用量与成本,并实时监测 CPU 与进程运行状态 | 中文 · English |
目录约定
- 每个插件一个目录,例如
dsh-d2-diagram/; package.json声明dsh.client(Web 客户端入口,exports["./client"]指向 bundle) 与dsh.bundle.patch(profile bundle 的 patch 层);cordis.patch.yml是 bundle 的 patch 层:纯显示插件通常为空数组,需要宿主行时 在其中插入;lib/client.js由 harness 的 client-modules 服务直接以/plugins/<id>/client.js提供,无需构建步骤;- 每个插件提供
README.md(默认中文)与README.en.md(英文)两份文档。
挂载方式
在目标 profile(如 ~/.dsh/profiles/web)中声明 link 依赖并把插件加入
dsh.profile.bundles:
// ~/.dsh/profiles/web/package.json
{
"dependencies": {
"dsh-d2-diagram": "link:/path/to/dsh-plugins/dsh-d2-diagram"
},
"dsh": {
"profile": {
"bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-d2-diagram"]
}
}
}
发布
每个插件的发布流程(换名、登录、npm publish、私有 registry、排错、检查清单)见
PUBLISHING.md。
开发与验证
- 修改
lib/client.js后刷新页面即可生效(bundle 以no-cache提供); - 重启
dsh进程后,boot 清单中的 rev 会重新哈希; - 运行中的进程按启动时记录的路径读取 bundle,文件重建后无需重启即可被服务。
No comments yet. Be the first to write one.