@suj1e/dsh-remote
DeepSeek Harness 的移动远程访问：适用于配对 iOS 客户端的局域网 HTTP+WebSocket 桥接
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @suj1e/dsh-remote@0.1.1Remote 以 @suj1e/dsh-remote 发布，当前版本为 0.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
让 iPhone App 通过局域网远程使用 Mac 上运行的 DeepSeek Harness（DSH）。
DSH 插件（Cordis bundle），在 Host 进程内开启一个独立的 HTTP+WebSocket 服务，把 DSH 的 Remote API——与桌面 Web GUI 完全相同的 typertGateway 调用面——代理给配对后的手机设备。手机端 iOS App 在独立仓库开发，对接契约见 PROTOCOL.md。
api-session/* 事件）、实时消息流（session/follow）、发送消息（session/prompt，幂等）、取消（session/cancel）$events 流转发审批与用户提问（waterfall），手机作答经 $events/result 回传，与桌面端先答先得要求 DSH ≥ 0.1.7-rc.2（peer 版本精确对齐，安装器会校验）。
# 从 npm 安装（推荐）
dsh plugin install @suj1e/dsh-remote
# 或在 Web GUI：设置 → 插件 → 安装外部插件，填包名
# 本地路径安装（开发）
dsh plugin install /path/to/dsh-remote
首次安装后需重启一次 DSH：client 半边（设置页/侧栏按钮）的包元数据在进程内有缓存；重启后即出现。
GitHub Actions 两条流水线：
.github/workflows/ci.yml）：push/PR 时在 ubuntu + macOS 上 install → build → test → npm pack --dry-run 校验产物.github/workflows/release.yml）：推送 v* tag 时校验 tag 与 package.json 版本一致 → 测试 → 构建 → npm publish --access public --provenance发布步骤：
# 一次性准备
# 1. npmjs.com 确认账号（scope 必须与 npm 用户名一致，即 @suj1e）
# 2. 生成 Automation 类型的 Access Token，配置到仓库 Settings → Secrets → NPM_TOKEN
# 每次发版
npm version patch # 或 minor / major
git push --follow-tags
# CI 自动发布，DSH 侧更新：dsh plugin install @suj1e/dsh-remote
入口 dsh-remote（cordis.patch.yml / 插件页可改）：
| 字段 | 默认 | 说明 |
|---|---|---|
enabled | true | 是否启动监听 |
port | 8747 | 监听端口（0 = 系统分配） |
bind | 0.0.0.0 | 监听地址 |
allowedEndpoints | ['session/*', '$events/*'] | 手机可调用的 Remote 端点白名单 |
状态与设备数据持久化在 $DSH_HOME/mobile-remote/devices.json。
/v1/pair（配对码 + 限速）外全部要求 Bearer 令牌；令牌只存哈希pnpm install
pnpm run build # tsdown: lib/index.js (Host) + lib/client.js (浏览器)
pnpm test # node:test：配对/鉴权/白名单/WS 帧代理/桩网关端到端
源码结构：
src/index.ts Host 插件入口（inject typertGateway，拉起服务器）
src/config.ts Schemastery 配置
src/server/devices.ts 设备注册表 + 配对码（$DSH_HOME/mobile-remote/）
src/server/auth.ts Bearer 解析、回环判定、配对限速
src/server/http.ts HTTP 服务器：配对页 / REST / 管理动作 / WS 升级
src/server/rpc.ts dispatchRpc 代理 + 端点白名单
src/server/ws.ts WS 逻辑流多路复用（stream-protocol 帧格式）
src/server/events.ts api-session/* 事件 → notify 推送
src/server/pair-page.ts 自托管配对页（QR 由 qrcode 生成）
src/client/index.tsx 浏览器半边：设置页 + 侧栏入口
架构要点：一元调用走 ctx.typertGateway.dispatchRpc，流走 ctx.typertGateway.wireStream.open，帧校验复用 @deepseek-ai/dsh-api-gateway/stream-protocol——即手机端与桌面浏览器消费同一条类型化调用链（严格描述符、参数校验、agent 解析全部由网关完成）。
MIT