Skip to content

dsh-approval-reason-dock

Verified

dsh-approval-reason-dock · v0.1.2 · MIT · Web UI

Adds an optional rejection reason to DeepSeek Harness approval prompts: the text is steered into the running turn before the rejection is answered.

Install

dsh plugin add dsh-approval-reason-dock

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

dsh-approval-reason-dock

CI npm License: MIT Listed on dsh-plugin.org

给 DeepSeek Harness Web 端加一层审批拒绝理由:审批卡出现时可以填一句理由,插件会先把理由作为 steering 用户消息送进当前对话,再把审批答成「拒绝」。这样模型下一步就能读到理由,而不是只收到一句"用户拒绝了工具 X"、只能靠猜。

English

预览

审批拒绝理由浮层叠加在内置审批卡上

为什么做这个

Harness 的审批卡只有「允许一次 / 拒绝」两个动作,拒绝结果是封闭的枚举值,协议里没有携带理由的字段。于是拒绝理由要么丢失,要么得等下一轮再说。当拒绝本身有上下文("网络不稳"、"先别动那个文件")时,它应该立刻进入对话。

这个插件在宿主 UI 之上加一个小浮层,不替换内置审批卡、不修改审批协议与审计事件;渲染失败时静默隐藏,内置卡照常工作(fail-soft)。

行为

  • 当前会话存在可作答的审批时,右上角出现浮层(注册在 shell.overlay 槽)。
  • 浮层跟随主视图当前会话:只提供该会话的审批;其他会话的审批保持安静,切过去才会出现。标题下方显示会话名。
  • 浮层默认展开,可折叠成半透明的「待审核」小按钮以免挡住正文,点击小按钮重新展开;每个新审批默认展开。
  • 理由草稿按审批分别保留:多个会话同时挂审批时,来回切换不会清掉另一个会话已输入的文字。
  • 填理由并点「拒绝并说明」:
    1. 以 remote.session.prompt(mode: "steer")把 (审批拒绝理由)<文本> 作为 steering 用户消息送进当前轮;
    2. 如果当前轮已不再接受 steering,则自动降级为 mode: "queue" 排队;
    3. 最后把审批答成 rejected。
  • 拒绝成功后浮层立即收起;只有理由发送失败时保留错误码提示(可手动关闭)。
  • 「只拒绝」= 不带理由,等价于内置卡的「拒绝」。

安装

要求 DSH 0.2.2-rc.1 或同系列更高的 0.2.x(见 engines.dsh)。

版本匹配:

DSH 版本 插件版本 状态
0.2.1-rc.2 0.1.0 已验证稳定;0.1.1 不支持该版本线
0.2.2-rc.1 0.1.1+ 已验证(0.1.1 的全部真机测试都跑在这个版本)

在 DSH 0.2.1-rc.2 上请显式安装已验证的旧版本线:

dsh plugin --profile web add [email protected]

0.1.1 不声明支持 0.2.1 的原因:它需要客户端侧 uiSession 服务注入(exports.inject),而该服务在 0.2.1 的客户端 runner 中是否存在未验证。DSH 插件管理器会按 engines.dsh 做兼容性评估,0.1.1 在 0.2.1 上可能被标记为不兼容;固定安装 @0.1.0 可以不依赖那次校验。

0.1.2 是文档/市场素材同步版:运行时行为与 0.1.1 完全一致,但 tagged release 现在包含市场素材(dsh-plugin.org 收录徽章、CLI 安装命令、中英文预览图与 screenshots.json)。

用 DSH CLI 安装(npm 包):

dsh plugin --profile web add dsh-approval-reason-dock

推荐:在 DSH 的插件管理页用 npm 包名或 GitHub spec 安装 bundle:

dsh-approval-reason-dock
github:FzqxDedafeiyu/dsh-approval-reason-dock

或者从 GitHub 源码用 CLI 安装:

dsh plugin --profile web add github:FzqxDedafeiyu/dsh-approval-reason-dock

手工管理 profile 的话:把 bundle 加入 dsh.profile.bundles,让它自带的 patch 插入行:

- insert:
    - id: approval-reason-dock
      name: dsh-approval-reason-dock

包内包含 cordis.patch.yml、index.js(空宿主半)、client.js(浏览器半)、locale/*.json、icon.svg。

兼容性与风险

  • 浏览器半依赖 DSH 客户端内部接口:shell.overlay 槽、uiSession 的会话状态交互、remote.session.prompt。这些不是稳定的公开契约,Harness 升级后可能需要更新插件。
  • 内部接口缺失时浮层保持隐藏,审批仍可通过内置卡正常完成(fail-soft)。
  • 插件不发起网络请求,除待处理审批的元数据外不读取会话内容。

隐私

你输入的理由会成为会话日志与模型上下文里的普通用户消息(限 500 字、纯文本、不渲染 HTML),不会发往任何其他位置。

卸载

从 dsh.profile.bundles 移除 dsh-approval-reason-dock(或在插件管理页卸载),重启 DSH 即可。

开发

node test/harness.mjs

harness 会校验清单/打包形态、加载真实的 client.js factory,并在假的 React/Cordis/槽环境里驱动完整拒绝流程(理由投递、steer→queue 降级、失败提示、审批已被处理)。npm run pack:check 校验实际发布文件清单。

仓库结构:

client.js           浏览器半(window.__ModuleLoader__ bundle)
index.js            宿主半(空 apply)
cordis.patch.yml    Loader 行
locale/{en,zh}.json 展示元数据
icon.svg            插件图标
test/harness.mjs    沙箱测试
.github/workflows/  CI

维护

发布流程、本机安装/回退、升级冒烟与排障见交付与维护手册。

许可证

MIT,见 LICENSE。