前言¶
DeepSeek Harness (DSH) 插件化生态强调按需扩展。在开发智能体或执行复杂任务时，本地环境擅长取证、代码修改和测试，但高成本的推理任务往往需要调用外部模型。dsh-reasoning-bridge 插件解决这个分割问题：它把高成本推理交给网页版 AI（默认 ChatGPT 网页版，目标可切换；当前内置 chatgpt 与 arena），把取证、采纳、修改、测试全部留在 dsh 本地。插件基于契约化 Context Packet / Reasoning Result 交接、版本化风险授权门、可执行的浏览器传输驱动和 SHA-256 运行回执。
核心功能¶
插件主要提供以下能力：
1. 推理与执行的分离：将高成本推理交给网页版 AI，本地负责证据收集、方案采纳、代码修改和测试验证。
2. 契约化交接：通过 Context Packet 和 Reasoning Result 进行结构化交接。
3. 版本化风险授权：首次运行前展示风险声明，用户显式同意后写入授权文件，非 READY 状态下传输层会拦截操作。
4. 可执行的浏览器传输驱动：支持通过浏览器传输驱动与网页 AI 交互，支持多目标（chatgpt, arena）。
5. SHA-256 运行回执：生成包含脱敏元数据、产物哈希和隐私审查字段的回执。
安装与启用¶
该插件依赖 DeepSeek Harness (dsh) 环境。安装命令如下：
dsh plugin --profile web add dsh-reasoning-bridge
安装完成后，重启 dsh web 服务，技能目录中会出现 reasoning-bridge。
典型用法¶
在 dsh 会话中直接发起任务，插件会自动处理推理请求与本地执行的交接：
$reasoning-bridge 从第一性原理诊断这个性能回退，验证修复后交付。
$reasoning-bridge 审查这个架构决策，基于本地证据选定方案并完成实现。
约束与边界¶
插件在代码层面和流程层面设置了不同的约束，开发者需明确区分：
代码机制（强制执行）¶
- 发送前拒绝未授权：
consent非READY时，open/probe/send/fetch/launch直接失败。 - 只接受已支持目标：
--site必须是chatgpt或arena之一，否则报错。 - 发送前拒绝疑似凭据：
send读取 request 文件后进行凭据形状扫描，命中即拒发（可用--allow-unscanned显式放行）。 complete闸门复扫：不信任隐私审查的自述布尔，重新扫描 packet/result/evidence 内容。- 拒绝编码绕过：非 UTF-8 的 request 文件先解码再扫描。
- 不读敏感 API：页面表达式禁触 Cookie、Storage 等敏感 API。
工作流纪律（非代码机制）¶
- 采纳门：网页建议必须本地重开文件/符号取证后分类为 accepted/rejected/deferred。插件无法拦截模型对
pwsh/edit/write的调用，最终是否遵守取决于模型是否照做。 - 语义隐私审查：正则扫描之外需人工判断业务秘密，插件无法理解业务语义。
- 凭据扫描局限性：仅基于形状启发式（如 PEM、JWT、API Key 形式），无法拦截被拆行、编码或隐藏在散文中的业务秘密。
环境注意事项¶
- Windows 兜底启动：dsh 内置
browser_launch仅支持 macOS。Windows 用户需使用transport.mjs launch启动专用独立 profile，或手动配置 Chrome 调试端口。 - 版本号差异：资料中 README 封面显示版本 0.4.0，package.json 显示 0.5.0，安装时请以实际环境为准。
