前言¶
在 DeepSeek Harness(DSH)里用 dsh-git-manager 做提交、推送、开 PR、写 issue 等写操作时,每个工具都会单独弹出审批卡。工具名包括 git_commit、git_push、github_pr_create、github_pr_merge、github_issue_create、github_issue_comment、github_pr_comment、github_pr_review。偶尔点几次还能接受,一天下来往往是几十次重复确认。更麻烦的是,git-manager 的预批准表是纯内存 Map,DSH 重启后八个工具的免审批状态会全部清零,看起来像「明明设过,怎么又要一个个点」。
下面介绍社区插件 dsh-codex-panel(维护者 qianai05233,分类:客户端)。它在 Web 界面提供悬浮控制面板:总开关或分工具开关 git / GitHub 写操作的预批准,并把选择持久化到磁盘,启动后自动回灌;同时可读 cost-meter 账本显示余额与今日花费。
这是什么¶
dsh-codex-panel 是面向 DSH Codex 式工作流的悬浮控制面板:一次点击(或分开关)管理 git-manager 对上述八个写工具的预批准,并展示 live balance。插件以 MIT 许可发布,当前 package 版本为 1.0.0;GitHub 仓库星标为 0(以目录页信息为准)。它不改变 DSH 核心,只桥接 git-manager 的预批准接口并补充持久化,解决「逐个弹审批」和「重启丢状态」两类问题。
核心功能¶
一键同意与分工具开关¶
悬浮胶囊会显示类似 Codex 8/8 的计数,表示当前有多少写工具处于免审批。展开后可对八个工具逐个切换;另有总开关,可一次性全开或全关。
重启后自动恢复¶
这是 README 强调的主要存在理由。dsh-git-manager 的预批准表在内存中(README 引用 lib/index.js:2438 处的 preApprovals Map),零持久化,每次 DSH 重启状态清零。
本插件把选择写入:
$DSH_HOME/storages/dsh-codex-panel/preapproved.json
宿主在启动后约 3 秒再回灌(避开 git-manager 的路由注册)。首次运行没有意愿文件时静默跳过,不会擅自替你放行。
余额显示¶
面板从 cost-meter 账本读取当前余额与今日花费,便于在 Web 端一眼看到消耗情况。
安全边界(插件自述)¶
- 预批准只作用于 git-manager 的写操作,不涉及文件系统或 shell。
- 面板只回掩码数据,不暴露 token。
- 可随时在面板里一键全关,恢复逐个审批。
安装与启用¶
前置要求:
- DSH
>= 0.1.7-rc.1 - 需要 dsh-git-manager(面板会读它的预批准状态;没有时面板仍可显示,开关无效)
安装命令(来自官方 README):
dsh plugin --profile web add github:qianai05233/dsh-codex-panel
安装后重启 dsh web。界面右上角应出现 Codex 胶囊。
典型用法¶
- 打开 DSH Web,确认右上角
Codex胶囊可见。 - 点击胶囊查看八个写工具开关与总开关;按需全开或只开部分工具(例如只预批准
git_commit与git_push)。 - 让智能体执行 git / GitHub 写操作时,已预批准的工具不再逐个弹审批卡。
- 重启 DSH 后等待约数秒,面板会根据
preapproved.json自动恢复上次的开关状态(若此前已保存过)。 - 需要恢复严格审批时,在面板使用总开关全关。
宿主与浏览器的大致交互(README 图示):浏览器通过 fetch('/dsh-codex-panel/api/snapshot') 拉取 git-manager 预批准状态与 cost-meter 账本;总开关则 POST .../toggleAll {approved:true},宿主再对 git-manager 发起多次 POST /gitm/preapprove。
写插件时可参考 README 中的两点:桥接 API 不要放在 DSH 的 /api 下(会被 client-connection 的准入与 POST JSON 约定拦截);npm 包形态的 Web 客户端不能依赖动态包的 host / styles 注入,与宿主通信需走 HTTP。
适用场景与注意¶
适合谁: 经常在 DSH Web 里用智能体批量做 git 提交、推送、PR / issue 操作,且希望减少重复点审批、并在重启后保留预批准设置的开发者。
注意:
- 插件在当前 dsh 进程权限下运行;安装前建议阅读 GitHub 源码 与 MIT 许可证,确认预批准范围符合你的安全策略。
- 预批准仅覆盖上述八个 git-manager 写工具,不能替代你对仓库与 GitHub 权限的整体管控。
- 社区插件目录 SkillHub 上的 dsh-codex-panel 页 与 GitHub 为独立信息源,与 DeepSeek / 幻方无官方从属关系;DSH 生态理念是「一切皆插件」,目录站是社区聚合,不是官方应用商店。
维护者还提供了配套插件:dsh-codex-preset(Codex 式五阶段工作流 agent preset)、dsh-freeapi-panel(多家正规免费 LLM provider 聚合),可按需一并了解。
结尾¶
经过上面的步骤,你可以在 Web 端用 dsh-codex-panel 把八个 git / GitHub 写工具的审批收成一块总开关,并把选择落到 $DSH_HOME/storages/dsh-codex-panel/preapproved.json,减轻重启后重复配置的负担。
- 目录页:https://www.skillhub.cn/plugins/qianai05233/dsh-codex-panel
- GitHub:https://github.com/qianai05233/dsh-codex-panel