前言¶
DeepSeek Harness（DSH）把模型、工具与会话收进桌面进程；Clanker 则是同一维护者生态下的手机端客户端。若只在手机上配置模型 API，对话仍局限在端侧能力，无法复用你在 Harness 里已经配好的文件工具、终端与 agent 流程。要在手机上发起「带认证、可流式、可控制、可传文件」的远程 agent 会话，需要一条稳定的桥接层，并自动跟上 Harness 本地端口与启动 token 的变化。
下面介绍社区插件 dsh-clanker-bridge（维护者 DANIE4588E，分类：客户端）。它在 Harness Desktop 内启动认证桥接，让 Clanker 把本机 Harness 当作 remote backend；手机侧不执行远程 agent 的工具事件，工具权限与执行仍由桌面 Harness 负责。
这是什么¶
dsh-clanker-bridge 的定位是：在 Harness Desktop 的 Node 运行时里运行桥接服务，连接 Clanker 手机端与 Harness，处理配对、会话映射与文件工作区，并通过 version-1 远程 agent API 暴露能力列表、模型、会话、流式事件、Stop、审批/提问与附件传输。
上游客户端与合约与 Harness Desktop 0.2.1-rc.5 对齐（package.json 中 engines.dsh 为 0.2.1-rc.5）。README 写明 Windows 为已验证平台；其他桌面发行版与操作系统未做 live 验证。
核心功能¶
依据仓库 README，插件在桥接层侧提供或透传的能力包括：
- 认证桥接：本地
pairing.html展示 Wi-Fi/以太网地址与 bridge token；Harness 每次启动时在内存中注入当前 API 凭证，bridge token 与设备身份持久化，旧聊天可挂回同一设备映射。 - 流式与推理：文本与 reasoning 流式输出；支持按模型选择 effort；工具进度、审批/提问、取消。
- 统计（需在 Clanker 侧开启）：Context meter、Decode speed、Cache hits；未知项不展示；Context 反映 Harness 当前压力/容量，而非 lifetime token 合计。
- 控制与会话语义：后续消息在 active turn 结束前排队；禁用 regeneration，避免重复 agent 动作。
- 文件：附件按原始字节传输，单文件上限 20 MB；每个聊天在 PC 上对应 workspace，Harness 工具需能访问该文件系统；新改文件可随回复附带，下载保留不可变版本；路径与符号链接校验不越出 workspace 边界。Workspace 组织文件，不对 agent 做沙箱；权限、历史、压缩与 memory 仍由 Harness 管理。
- 安全边界：
connection.json与pairing.html含稳定 bridge token，需保密；配对通过本地文件而非未认证 HTTP 路由；上游 Harness 启动 token 不写入磁盘、不发给手机。
插件默认监听端口 8788（可在配置中修改）。
安装与启用¶
环境前提（README 原文）：
- 官方 Harness Desktop 0.2.1-rc.5。
- Clanker 需带 Settings → Backends 的构建；仅配置模型 endpoint 的旧版 Clanker 无法使用 agent bridge。
- 先在 Harness 中配置好模型以及 file/terminal 等工具。
在另一台 Windows PC 上安装步骤如下。
- 在 Harness 中打开 Plugins → Add plugin。
- 安装本仓库（安装命令以 README 为准）：
github:DANIE4588E/dsh-clanker-bridge
也可从 GitHub latest release 安装预构建归档。
- 若 Harness 提示重启，从 Windows 托盘菜单完全退出后再用平常快捷方式重新打开。
- 在本机浏览器打开私有本地配对页（默认路径；若设置
DSH_HOME或自定义存储目录，路径以插件日志为准，插件只记录路径、不记录 token）：
%USERPROFILE%\.dsh\integrations\clanker-bridge\desktop\pairing.html
- 在 Clanker 中选择 Settings → Backends → Add remote backend，从该页复制 PC 的局域网地址与 bridge token，点 Test connection，选模型后 Save。
- 新建聊天并选择已保存的 backend。
README 说明：无需在另一台 PC 上 checkout Clanker 源码、单独装 Node、控制台启动或手工复制 Harness token；插件运行在 Harness 的 Node 运行时内。
配置项¶
插件配置（README 表格）：
| Setting | Default | Meaning |
|---|---|---|
port |
8788 |
手机连接的端口。 |
listenAddress |
0.0.0.0 |
在 LAN/VPN 网卡监听；设为 127.0.0.1 则仅本机。 |
dataDirectory |
Harness home 下 integrations/clanker-bridge/desktop |
持久化配对、桥状态、版本化文件对象与工作区。 |
日常使用：正常打开 Harness 即可；关闭桌面窗口时 Harness 仍可保持运行，完全退出则桥接停止，需重新打开 Harness 再连。若端口已被其他 bridge 占用，本插件不会踢掉对方——需改端口或停用另一 bridge 后重启。升级时保留 dataDirectory；删除会生成新身份，旧聊天无法在对换设备后继续恢复。
网络：需在私有 Windows 网络上放行默认 8788；手机须与 PC 同 LAN 或经私有 VPN 可达；经公网访问应通过反向代理走 HTTPS。在 Clanker 里保存备用地址不会自动建立路由。
典型用法¶
配对完成后，手机 Clanker 的新会话走已保存的 remote backend，对话与附件经桥接进入 Harness agent 管线。要在 Clanker 里看到用量相关 UI，需开启 Context meter、Decode speed、Cache hits。
若你曾使用 Clanker checkout 里的开发插件 clanker-harness-desktop-bridge，README 建议迁移前自行备份旧 bridge token、状态与 workspace 路径；用本插件默认全新安装会得到独立 backend 身份，不会自动导入旧连接。共用同一端口前应先禁用旧插件。
适用场景与注意¶
适合：已在 Windows 上运行 Harness 0.2.1-rc.5，并在 Clanker 中使用 Backends；希望手机端只做远程 UI 与控制，agent 工具在桌面执行的场景。
注意：
- 插件在 Harness 插件体系内运行，以当前 DSH 进程权限访问本机文件与网络；安装前请阅读 源码 与 MIT 许可证。
- 在手机上删除聊天仅清除手机侧本地数据；主机上的 session 与文件需在本 PC 上显式清理。
- DSH 生态强调「一切皆插件」；社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-clanker-bridge 把 Clanker 手机端与 Harness Desktop 的远程 agent 接口接在一起：认证配对、流式与控制、附件与工作区映射，并锁定与 Harness 0.2.1-rc.5 一致的客户端合约。需要安装命令、配置字段与配对路径时，以 GitHub README 为准。
- 目录页：https://www.skillhub.cn/plugins/DANIE4588E/dsh-clanker-bridge
- 仓库：https://github.com/DANIE4588E/dsh-clanker-bridge
