推理桥接器shangdi178/dsh-reasoning-bridge

dsh-reasoning-bridge

CI
Version
License: MIT

DeepSeek Harness（dsh）推理桥接插件：把高成本推理交给网页版 AI（默认 ChatGPT 网页版，
目标可切换），把取证、采纳、修改、测试全部留在 dsh 本地。基于契约化
Context Packet / Reasoning Result 交接、版本化风险授权门和 SHA-256 运行回执，
每条来自网页的建议都必须先通过本地采纳门才能执行。

$reasoning-bridge 诊断这个复杂 Bug，完成修复并在本地验证。

理解项目 → 本地取证 → 压缩为 1–3K token 的脱敏 Packet
→ 经 dsh 内置浏览器一次性发给网页 AI → 校验结构化 Result
→ 本地采纳门（accepted / rejected / deferred + 本地证据）
→ dsh 自己改代码、跑测试 → 写运行回执 → complete 闸门后才宣布完成

网页 AI 提方案，dsh 负责验证与执行。

功能

- 一句话调用：复杂任务中点名 reasoning-bridge 技能即可，无需 setup 命令、无需 API Key、不跑后台服务
- Doctor 自检：Node 运行时、技能文件完整性、包身份、授权状态一次校验（doctor.mjs --json）
- 版本化风险授权：首次交接前展示不弱化的风险声明，用户显式同意后写入
~/.dsh/dsh-reasoning-bridge/consent.json；拒绝即禁用，随时可撤销（consent.mjs status|enable|disable）
- 多目标传输层：目标站点经 target.mjs get|set|list 切换，默认 chatgpt；
每个目标一份 references/transport-.md 适配器，定义登录探测、模型校验、一次性发送与可见取回
- 契约化交接：Packet（目标/验收/仓库状态/证据/约束/问题）与 Result（结论/假设/所用证据/
建议修改/测试/风险/未知项）有精确的标记与章节校验，packet_id 绑定请求与回答
- 确定性校验器：validate.mjs 零依赖校验 packet / result / pair / receipt / complete，
含凭据模式扫描、3K token 上限、SHA-256 产物绑定
- 本地采纳门：网页输出的命令、补丁、路径、测试串永远不直接进工具调用；
每条建议必须本地重开文件/符号取证后分类为 accepted / rejected / deferred
- 运行回执：脱敏元数据 + 产物哈希 + 模型可见性证据 + 隐私审查字段；
只有确定性 complete 闸门全过才能宣布完成

安装

需要 dsh ≥ 0.1.0。三种方式任选其一：

方式一：npm 包（发布后）
dsh plugin --profile web add dsh-reasoning-bridge

方式二：从源码目录
dsh plugin --profile web add ./dsh-reasoning-bridge

方式三：离线 tarball
npm pack
dsh plugin --profile web add ./dsh-reasoning-bridge-0.1.0.tgz

装完重启 dsh web，技能目录里会出现 reasoning-bridge。

使用

在 dsh 会话中直接发起真实任务：

$reasoning-bridge 从第一性原理诊断这个性能回退，验证修复后交付。

$reasoning-bridge 审查这个架构决策，基于本地证据选定方案并完成实现。

适合桥接的任务：根因不明确、存在多个可行方案、需要高成本技术判断。
机械修改、简单查询和已定方案请留在本地直接完成。

首次运行

用户不需要单独 setup。技能工作流依次执行：

| 状态 | 含义 | 恢复方式 |
|---|---|---|
| NEEDS_AUTOMATION_CONSENT | 尚无有效的浏览器自动化风险决策 | 阅读风险声明并显式启用或拒绝 |
| AUTOMATION_DISABLED | 用户已拒绝或撤销全自动桥接 | 保持本地执行，或稍后显式重新启用 |
| READY | 授权就绪 | 进入浏览器预检或开始桥接 |
| MISSING_RUNTIME | Node.js 18+ 不可用 | 安装 Node.js 18+ 后重试 |
| INVALID_INSTALLATION | 技能文件缺失或包名不符 | 重新安装插件目录 |
| NEEDS_BROWSER | dsh 浏览器工具不可用 | 更新 dsh 后重试 |
| NEEDS_LOGIN | 目标站点未登录 | 用户接管页面完成登录，原任务保留待续 |
| NEEDS_MODEL_SELECTION | 要求的模型不可见或未选中 | 选择目标模型；技能不会替换成其他模型 |
| NEEDS_SITE_PERMISSION | 目标站点无法加载或控件不可确认 | 按提示处理；状态不确定立即停止 |

登录、验证码、双因素、权限和模型选择始终是用户接管步骤；密码、验证码、Cookie、恢复码不能交给 Agent。

可随时撤销全自动桥接：

node skills/reasoning-bridge/scripts/consent.mjs disable --json

隐私与安全

- 授权后，技能通过 dsh 内置浏览器的可见控件把一个最小化 Packet 发送到目标站点；
不调用私有接口，不读取 Cookie / 浏览器存储 / 隐藏认证信息，不需要 API Key，
不运行托管服务，不收集遥测。
- 设计上不会主动发送：密码、Token、API Key、私钥、Cookie、验证码；.env 或原始凭据文件；
完整私有仓库或完整未提交 diff；与任务无关的源文件。
- 正则扫描无法理解所有业务秘密，发送前还必须做语义隐私审查。
- 网页输出在 dsh 本地重新验证之前始终是不可信数据。
- 本插件不绕过任何平台的套餐、模型权限、登录、工作区策略、限额或站点安全机制。
自动提交与结果获取仍受适用服务条款解释或滥用防护系统影响；风险声明只能知情，不能消除风险。

Unofficial Experimental（非官方实验功能）：自动控制网页版 AI 存在非零账号风险，
可能触发安全机制、临时限制或账号处置。本插件与任何平台无关联、未获其认可或授权；
用户明确接受风险前，全自动桥接默认关闭。

HTTP / 状态文件

无环回路由（纯技能 + 确定性脚本，零依赖）。状态文件：

| 文件 | 说明 |
| --- | --- |
| ~/.dsh/dsh-reasoning-bridge/consent.json | 版本化风险授权决策（可用 $DSH_REASONING_BRIDGE_HOME 覆盖） |
| ~/.dsh/dsh-reasoning-bridge/state.json | 当前目标（target.mjs set） |
| ~/.dsh/dsh-reasoning-bridge/runs// | 建议存放 packet / result / evidence / receipt 的运行目录 |

开发

零依赖、零构建：lib/ 与 skills/ 即产物，直接可跑。

npm test        # 22 个 node:test：契约校验、授权状态机、目标状态、插件注册
npm run doctor  # 安装自检

- 服务端（lib/index.js）：cordis 插件，inject: ['skills', 'systemPrompt']，
经 ctx.skills.register 注册运行时技能（resourceBase 指向技能目录），
并注入一段 systemPrompt 说明何时使用
- 技能（skills/reasoning-bridge/SKILL.md）：唯一工作流入口，references/ 按需加载契约，
scripts/ 是确定性校验器
- 设计溯源与移植说明见 DESIGN.md

License

MIT