ManoloRemiddi/augmentor-dsh-extension-plugin

Augmentor，由 DSH 驱动

Augmentor 可将任意 DeepSeek Harness (DSH) Web 会话转变为浏览器
操作员：Chrome 侧边面板与你的 DSH 应用聊天，而智能体驱动你的真实浏览器——实时无障碍快照、点击、输入、标签页切换——
用户可在实际页面上看到每个操作脉冲。聊天是专用目录中的真实
DSH 会话，而 Save 会将当前聊天附加到 DSH 工作区。

┌─ Chromium (MV3 扩展) ─────────────────┐   ┌─ 你的机器 ─────────────────────────────────────────────┐
│ 侧边面板：聊天 UI（真实 DSH 会话）    │   │ pipe.mjs — 原生消息传递主机（Node，回环）          │
│ sw.js：原生端口 + 浏览器执行器 +    │   │  ├─[POST /api//]──────────────▶ 运行中的 DSH 应用      │
│  工作标签页注入（页面遮罩、覆盖层）  │   │  ├─[WS /api/remote.mux]◀───────── 下行帧      │
└──────────────┬─────────────────────────────┘   │  └─[WS ]──────▶ dsh-augmentor 插件│
│ 原生消息传递（令牌门控）  │        /api 握手 + 管道通道 + 浏览器工具 +     │
└────────────────────────────────▶│        聊天生命周期（保存到工作区）                 │
└────────────────────────────────────────────────────────────┘

没有 sidecar 运行时，没有第二个 DSH 进程：扩展通过其自带的 /api 接口与正在运行的
DSH 应用通信（管道是浏览器的回环替代客户端，因为扩展的 Origin 被 DSH 信任围栏拒绝——这是有意为之）。

组件

| 路径 | 说明 |
| --- | --- |
| extension/ | MV3 Chrome 扩展：侧边面板聊天、Service Worker（原生端口 + 浏览器执行器）、页面遮罩、工作标签页覆盖层、主题令牌 |
| pipe.mjs | 原生消息传递主机：到 DSH 应用 /api 接口的回环桥接、下行链路、插件通道 |
| plugin/ | dsh-augmentor DSH 插件（npm 包 + git 捆绑包）：/api/augmentor 握手、管道 WS 通道、browser_ 工具、聊天生命周期 |
| wire.mjs | 三个运行时共用的共享线路原语（帧编解码器 + 待处理表）——一份实现，三个消费者 |
| install-native-host.sh | 安装 Chromium 原生消息传递主机清单 + 每台机器的通道令牌 |
| test/ | 端到端测试套件（m3、sw、panel、chrome、m2、tools）+ install-proof.mjs（确定性的全新用户安装证明）+ plugin/tests/boot/ |
| PROPOSAL-plugin-architecture.md | 架构记录：里程碑 M1–M4、审计发现 S/D/F、决策 |

DSH 兼容性

Augmentor 0.1.32 面向 DSH 0.1.5-rc.1 及其经过身份验证的 Typert API。
请同时升级插件、原生主机和扩展。Augmentor 0.1.31
而更早的版本无法与此 DSH 发行版配合使用：它们的 SDK 依赖、HTTP 方法名、身份验证和事件流都早于新 API。

要在安装此发行版后更新现有安装：

npm install -g @deepseek-ai/dsh@0.1.5-rc.1
./install-native-host.sh
dsh plugin --profile web add /plugin

重启 DSH 并在 chrome://extensions 重新加载 Augmentor。对于 npm 插件路径，请从 npm 使用 dsh plugin --profile web add dsh-augmentor@0.1.32。安装程序会协调依赖关系，在缺失时安装 Augmentor 预设，并在将其 persona 的 text 设置重命名为 prefix 之前备份旧版预设。自定义的 DSH_HOME 对于 DSH、安装程序和浏览器/原生主机必须保持一致。

桥接通过一个受 Augmentor 现有 action-channel 密钥保护的本地端点来交换 DSH 的启动令牌。其会话 cookie 保留在原生主机内部。无需扩展 cookie 权限，也无需禁用 DSH 身份验证。

安装

已在 Linux 搭配 Chromium、Node.js 22.19+ 或 24+，以及 DSH 0.1.5-rc.1 上测试通过。

1. 安装/更新 DSH：npm install -g @deepseek-ai/dsh@0.1.5-rc.1。
2. 下载 Augmentor 0.1.32 ZIP 并将整个
augmentor-0.1.32 文件夹解压到一个永久位置。它包含插件、
扩展、原生主机和预设。请将所有文件放在一起。
源码替代方案：git clone --branch v0.1.32 https://github.com/ManoloRemiddi/augmentor-dsh-extension-plugin.git。
3. 打开 chrome://extensions，启用 开发者模式，选择 加载已解压的扩展程序，
选择解压后文件夹中的 extension/ 并复制扩展 ID。
4. 在解压后的文件夹中，使用该 ID 运行 sh install-native-host.sh EXTENSION_ID "$HOME/.config/chromium"。
第二个参数是浏览器用户数据根目录，而不是 Default。
其他 Linux 默认路径：Chrome ~/.config/google-chrome、Edge ~/.config/microsoft-edge、
Brave ~/.config/BraveSoftware/Brave-Browser。其他平台未经验证；
这些 shell 命令不是 Windows 安装程序。
5. 在同一文件夹中，运行 dsh plugin --profile web add "$PWD/plugin"。
或者安装 dsh plugin --profile web add dsh-augmentor@0.1.32。
选择一种方法，如果你的应用实际配置文件与 web 不同，请使用实际配置文件。
固定 npm 版本可避免因发布年龄过滤而选中较旧的发行版。
6. 重启现有的 DSH 进程/服务，或使用 dsh web 启动一个新实例。
打开 DSH 打印的完整本地 URL，包括身份验证令牌。
仅使用 http://127.0.0.1:3080/ 可能会显示“dsh web authentication required”。
这会在你自己的电脑上将浏览器验证到 DSH；它不需要
DeepSeek 账户或审批。重启 Chromium，打开侧边栏并测试
一个带有已配置模型的提示词。/api/augmentor 应报告 0.1.32 和 pipes: 1。

对于从 0.1.31 或更早版本的升级，如果旧面板无法连接，请使用以下手动步骤。备份旧文件夹，更新全部三个组件并重新运行安装程序。更新现有的已链接插件目录，而不是添加重复项。保持任何自定义 DSH_HOME 在 DSH、安装程序以及浏览器/原生宿主之间一致。安装程序会保留自定义预设，并在迁移前备份旧版设置。

DSH 和已配置的本地模型在安装后可以离线工作。云端模型需要其提供商的凭据和互联网。访问在线页面也需要互联网。

可选：Model Picker Augmented

Model Picker Augmented 1.1.2
支持 DSH 0.1.5-rc.1，并修复了未定义的 settings 加载器错误。它添加了
搜索、固定和可见性控制；Augmentor 共享其模型策展。安装 GitHub 包（此配套组件未发布在 npm 上）：

dsh plugin --profile web add https://github.com/ManoloRemiddi/dsh-model-picker-augmented/releases/download/v1.1.2/dsh-model-picker-augmented-1.1.2.tgz

重启 DSH 并重新加载其页面。对于现有的已链接 Git 检出，请将该检出更新到标签 v1.1.2，而不是添加另一个插件条目。

安全态势

- DSH 信任围栏正是管道存在的原因——它并未被绕过。 DSH 应用的 /api 会拒绝来自外部浏览器来源的请求（按设计，包括扩展的 chrome-extension:// 来源）。pipe.mjs 是一个回环替代客户端：它以用户身份在本地运行，并通过 127.0.0.1 与应用通信，而这正是围栏所允许的。
- 没有新的远程暴露面。 每一跳都是回环（扩展 ↔ 管道通过原生消息传递，管道 ↔ 应用通过 127.0.0.1）；此技术栈添加的任何内容都无法从其他主机访问。信任边界是本地操作系统用户：任何已经能够读取你主目录的内容都不会被此技术栈阻止（而且本来就可以直接对应用执行相同的操作）。
- 操作通道受密钥门控。 browser_ 命令通过一个 WS 通道传输，插件使用每台机器的令牌（$DSH_HOME/augmentor-ws-token，0600，由安装程序或首次启动时创建；已配置的 actionToken 优先）对该通道进行身份验证。管道在 WS 握手头中出示该令牌，插件以恒定时间进行比较；没有该文件的本地进程无法驱动你的浏览器。
- 面板内的“信任围栏探测”（≣ Sessions → Probe）是一种诊断工具，用于显示围栏按设计正常工作（扩展来源的请求被拒绝，回环请求被接受）。它进行探测；它不会绕过。

开发

full e2e battery (six suites) — run from the repo root:
cd test && node m3-e2e.mjs && node sw-e2e.mjs && node panel-e2e.mjs \
&& node chrome-e2e.mjs && node m2-e2e.mjs && node tools-e2e.mjs
插件启动测试：
sh plugin/tests/boot/run.sh

这些测试套件是封闭隔离的：每个套件都会创建自己的标记会话（并在清理时将其归档），绝不触碰用户会话，而实时浏览器套件（m3、chrome、m2）则针对真实的本地 DSH 应用 + 真实的 Chrome 配置文件运行。

确定性安装验证——完整记录的流程，端到端，在全新的
DSH 主目录 + 全新的 Chromium 配置文件上（绝不触碰你真实的 ~/.dsh）：
node test/install-proof.mjs                 # 克隆 → 启动 → 插件 → 扩展 → NMH → pipes:1
PROOF_LLM=1 node test/install-proof.mjs     # + 真实 agent 驱动无头浏览器
PROOF_SOURCE=npm PROOF_LLM=1 node test/install-proof.mjs   # npm 插件路径（发布后可用）
可调参数：PROOF_REPO、CHROME_BIN、PROOF_PORT、PROOF_KEEP=1 —— 参见脚本头部。

许可证

MIT。

共享提示词库（本地开发更新）

点击设置齿轮打开 DSH。选择 设置 → 提示词库 来创建、编辑、重命名或删除可复用的提示词。在编辑器中输入 / 可按快捷名称筛选。方向键选择，Enter/Tab 插入到草稿中，Escape 关闭。插入绝不会自动发送。

在 DSH Web 配置文件中安装独立的 dsh-prompt-library 插件。原生管道的 augmentor/prompts 方法仅通过现有的 DSH API 读取其 prompt-library 设置命名空间。两个 Augmentor 界面都使用该目录；DSH 拥有本地存储和编辑器。如果存在之前的本地 JSON 库，该插件会导入一次。扩展不再使用单独的 Python 提示词存储。在此开发更新后，请重新加载一次未打包的扩展。