dsh-reasoning-bridge

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-<id>.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_id>/ | 建议存放 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