dsh-mate — 电脑端桥插件

DSH Mate（求索伴侣）的电脑端：运行在 DSH web profile 内的 Cordis 插件，为鸿蒙 App 提供配对、移动 REST API 与事件推送。

架构速览

src/
├── index.ts          # 插件入口（装配 + 终端二维码）
├── config.ts         # 配置归一化与安全校验
├── server/           # 桥 HTTP(:3082) + WebSocket 事件推送 + 信任层
├── pairing/          # QR/HMAC 配对 + 设备注册表 + 二维码渲染
├── bridge/           # 宿主服务封装（会话/交互/作业/goal/设备 + 事件订阅）
├── push/             # 可选推送中继（v1.1）
└── tools.ts          # 会话内工具 mate_qr / mate_devices

开发

npm install        # 或 pnpm install
npm run build      # tsc → lib/
npm run typecheck

状态（骨架阶段）

• ✅ 可编译骨架：配置、配对服务（HMAC 已实现）、设备注册表、HTTP/WS 服务器、路由分发、工具定义
• ⏳ 待实现（代码内有 TODO(impl) 标记）：
  • bridge/sessions.ts：会话列表/快照/发送消息（需先以 DSH 运行时 cordis_inspect_list / Service.listService 清单确认宿主服务名）
  • bridge/events.ts：宿主事件白名单核对（Event.listEvents）与载荷投影脱敏
  • bridge/questions.ts：userQuestions 提供方 + approval waterfall 应答者
  • bridge/jobs.ts / goals.ts：jobs/goal 订阅
  • push/relay.ts：Push Kit / webhook 中继（v1.1）

实现原则（docs/02 §8）：只使用 DSH 公开服务/事件面；不硬编码未经验证的接口名；写操作与官方 Web 同一宿主路径。

安装到 DSH

见仓库根 README 与 docs/05-内网穿透与部署.md 第 6 节。