← Back to home@caozeal

dsh-plugins

DeepSeek Harness 插件集:右侧边栏 Git 管理(分支切换 / AI 提交 / 提交图 / diff)

Stars
0
Language
JavaScript
Created
Oct 22, 2026
Updated
Oct 26, 2026

Introduction

dsh-plugins — DeepSeek Harness 插件集

DSH(DeepSeek Harness)插件集合。每个子目录是一个独立插件,自带 README、配置模板和 测试,可按需装进 DSH Web profile 或某次会话的动态插件。

目录

插件目录状态说明
Git 管理dsh-next-git/✅ 可用Web 右侧边栏 Git 面板:分支切换、暂存/提交/推送/拉取、AI 提交信息、提交图与 diff(32 单测 + 27 项 RPC smoke + 真机全链路验证)

快速开始:Git 管理

仓库地址:https://github.com/caozeal/dsh-plugins

安装(Web profile)

本地插件以 bundle 形式安装(DSH 0.2.x,profile ~/.dsh/profiles/web):

  • Web GUI → 插件 → 安装 bundle,选择本目录下的 dsh-next-git/;或
  • 用 plugin_manager 工具安装,target=/path/to/dsh-plugins/dsh-next-git。
  • 已发布到 npm(https://www.npmjs.com/package/@caozeal/dsh-next-git),可直接安装:dsh plugin --profile web add @caozeal/dsh-next-git。

装好后刷新页面,在任意会话头部点 Git 图标,或从右侧栏的「+ → 开始」指南里选 「Git 管理」即可打开面板。面板跟随当前会话的 cwd,切换会话即切换仓库。

详细功能、Host RPC 协议与设计说明见 dsh-next-git/README.md 和 dsh-next-git/PROTOCOL.md。

发布(维护者)

@caozeal/dsh-next-git 通过 npm Trusted Publishing(OIDC) 自动发布,不需要 npm token:

  1. 修改 dsh-next-git/package.json 的 version(如 0.1.1)
  2. 提交后打同名 tag 并推送:
git tag v0.1.1
git push origin main --tags

GitHub Actions(.github/workflows/publish.yml)会校验 tag 与版本号一致、跑单测、执行 npm publish --access public,并由 npm 自动生成 provenance。

首次使用需在 npm 包设置页配好 trusted publisher(GitHub Actions / caozeal / dsh-plugins / publish.yml,勾选 Allow npm publish)。

约定

  • 插件源码用纯 ESM JavaScript + JSDoc(零构建、可直接内联进动态插件; 提升为 harness 包时再移植成 TypeScript)。
  • 运行期配置走 Web GUI 插件配置页(settings 服务,持久化到 settings.yaml); 各插件目录的 config.json 仅作旧版/开发兜底。
  • 每个插件至少带自测(test/);涉及 UI 的插件附真机验证清单与证据 (如 dsh-next-git/test/live/)。

插件从「独立目录」提升为「harness 包」的路径

独立目录便于快速迭代;一旦要持久挂在 Host 组合里,标准做法是把它移植进 deepseek-harness 的 packages/ workspace 成为 @deepseek-ai/dsh-* 包, 再在组合里加一行(参考 dsh-lab/ui-schedule-integration.patch 的做法: 新增包 + cordis.patch.yml 加行 + package.json/tsconfig/pnpm-lock 同步)。