본문으로 건너뛰기
T

dsh-gitall

t-mkt/dsh-gitall

让 DSH 的变更请求面板支持 GitLab、Gitea 与 Gitee及其命令行操作。Brings GitLab, Gitea, and Gitee repos to the DSH change request panel.

설치

dsh plugin --profile web add github:t-mkt/dsh-gitall

README

dsh-gitall

简体中文 | English

让 DeepSeek Harness 的变更请求面板支持 GitLab、Gitea/Forgejo 与 Gitee。这是一个 单包、host-only 插件:向 ctx.forge 注册 gitlab、gitea、gitee 三个 provider,分别通过各平台官方 CLI(glab、gt、gitee)读取数据。凭据保留在 CLI 自己的配置里,插件不会接触 token。

环境要求

  • DeepSeek Harness 0.2.2-rc.3。
  • Node.js 24.9 或更新版本。
  • 为要使用的平台准备已登录的 CLI:
    • GitLab:glab
    • Gitea 28+ / 提供相同 API 的 Forgejo:gt
    • Gitee:gitee

CLI 未安装不会导致插件启动失败:对应 provider 在 readiness 中报告 unavailable,面板会显示无法读取仓库的原因。

安装

通过 Github 安装

dsh plugin --profile <name> add github:T-MKT/dsh-gitall

仓库里已经带了编译产物 lib/,安装后即可直接启用(原因见开发)。

配置

在 profile 的 cordis.patch.yml 中添加(或修改插入的)条目:

- id: gitall
  name: dsh-gitall
  config:
    # 可选:自建实例必须显式列出,否则其仓库不会被服务。
    gitlab:
      command: glab
      hosts:
        - gitlab.com
        - gitlab.example.org
    gitea:
      command: gt
      hosts:
        - gitea.example.org
    gitee:
      command: gitee
      hosts:
        - gitee.com
    timeoutMs: 30000
    maxOutputBytes: 8388608
    binding: true
键默认值含义
gitlab.commandglabGitLab CLI 可执行文件名或绝对路径
gitlab.hosts['gitlab.com']GitLab provider 服务的 host,自建实例需显式列出
gitea.commandgtGitea CLI 可执行文件名或绝对路径
gitea.hosts[]Gitea provider 服务的 host;为空表示不服务任何仓库
gitee.commandgiteeGitee CLI 可执行文件名或绝对路径
gitee.hosts['gitee.com']Gitee provider 服务的 host
timeoutMs30000单次 CLI 调用的超时
maxOutputBytes8388608每条输出流的最大捕获字节数
bindingtrue把 agent 执行 CLI 时输出的变更请求 URL 绑定到 Session

host 匹配不区分大小写。host 可带端口(git.example.org:8443):HTTP(S) 远端的 端口属于 host 身份,SSH 远端的端口会被忽略。

能力对照

能力GitLabGitea/ForgejoGitee
从 Git remote 识别仓库支持支持支持
状态卡片(标题、状态、草稿、作者、分支、增删行数、可合并性)支持支持支持
检查(checks)head pipelinecommit statuses无(Gitee v5 没有对外的 CI 接口)
diff 补丁支持支持支持
读取某提交的文件文本支持支持支持
按确认的 head 合并支持(glab --sha)支持(head_commit_id)支持(先读 head 再合并)
面板提供的合并方式merge、squash、rebasemerge、squash、rebasemerge、squash
标记草稿为就绪支持无草稿状态,返回 failed支持
按分支查找打开的变更请求支持支持支持
把 CLI 输出中的变更请求 URL 绑定到 Session支持支持支持
评审线程、评论、批准未实现未实现未实现
提交列表 / 提交间比较未实现未实现未实现
已读文件、重跑检查、请求评审、更新分支未实现未实现未实现

未实现的都是 provider 的可选能力,缺省即降级,面板会隐藏对应控件。

登录

插件以「清洗过的环境」启动 CLI:名字包含 KEY、PASSWORD、SECRET、TOKEN 的变量不会传给子进程。请用各自的 CLI 登录:

glab auth login --hostname gitlab.example.org
gt auth login --host https://gitea.example.org
gitee auth login

host 未登录时,readiness 返回 unauthenticated 并带上 CLI 自己的提示;面板会 渲染这条消息,非 GitHub forge 的登录引导就靠它传达上述命令。

数据来源

平台快照diff文件文本合并就绪探测
GitLabglab api --hostname <host> projects/<URL 编码路径>/merge_requests/<iid>…/merge_requests/<iid>/diffs,按 +/- 行统计…/repository/files/<URL 编码路径>/raw?ref=<sha>glab mr merge <iid> --sha <sha> --yes --auto-merge=falseglab auth status --hostname <host>
Giteagt api repos/<owner>/<repo>/pulls/<n> --host <host> --no-input先确认 head,再读 …/pulls/<n>.diff…/raw/<path>?ref=<sha>gt api -X POST …/pulls/<n>/merge -f Do=<method> -f head_commit_id=<sha>gt auth status --host <host>
Giteegitee api /repos/<owner>/<repo>/pulls/<n> --hostname <host> --no-tui…/pulls/<n>/files 合成为统一补丁…/contents/<path>?ref=<sha>(base64 解码)先确认 head,再 gitee api -X PUT …/pulls/<n>/merge -f merge_method=<method>gitee auth status --json --hostname <host> --no-tui

与 GitHub 的已知差异

  • 不做评审读写、提交列表、已读标记、检查重跑、请求评审、更新分支;对应 provider 方法直接缺省。
  • Gitee 不支持 checks:快照恒为 checks: []、checksRollup: 'none'。
  • Gitea 没有草稿 PR:markReady 恒返回 failed 并说明该限制。
  • Gitee 的合并接口无法指定「确认过的 head 提交」。provider 先读 head,发现已变化 就返回 stale;但在读与合并之间瞬间发生的推送无法检测。Gitee 在此只提供 merge 与 squash,rebase 请求会被拒绝。
  • binding 只从 glab、gt、gitee 命令的输出中提取 URL;glab mr view 42 这种只给编号的形式不会再去查询。
  • 自建 Gitea/Forgejo 必须写进 gitea.hosts,不支持通配。
  • Gitea 需要 28 或更新版本(gt 的要求)。
  • 未做真机验证:本机没有安装这些 CLI,测试用返回录制 JSON 的假 glab/gt/gitee 可执行文件,端到端跑通 provider 逻辑。

开发

pnpm install
pnpm build      # tsc -p tsconfig.build.json → lib/
pnpm typecheck  # tsc -p tsconfig.json
pnpm test       # vitest run

lib/ 是编译产物,与源码一起提交:插件经 github: 安装,而 pnpm 默认不执行 git 依赖的构建脚本,仓库里缺 lib/ 时 DSH 无法 import 插件。改动 src/ 后运行 pnpm build 并把 lib/ 一并提交;CI 会校验两者是否一致。

目录:src/core 放 CLI runner、JSON 助手、快照默认值与补丁合成; src/providers/<forge> 放 URL 解析、读取、写入与 provider 类;src/binding 把 CLI 输出转成 Session 绑定记录;test/integration 用假 CLI 跑完整 provider 流程。

관련 플러그인