DeepSeek Harness（DSH）遵循“一切皆插件”的理念，允许开发者通过独立 bundle 扩展功能。guoxinshan/dsh-yzj 是一个将云之家集成到 DSH 的插件 bundle。它提供 yzj-cli 桥接、41 个模型面工具以及一个带有拖拽和 @ 引用芯片的浮动 workspace 面板。
核心功能¶
桥接与模型面工具¶
插件通过 yzj-cli 桥接与云之家系统通信，提供六域模型面工具（含写入确认流）。
IM 壳（产品法 v3.0）¶
这是插件的核心交互层。根据产品法 v3.0：
* 助手定义：助手是用户定义的 1..N 条特殊单聊（出厂“助手”），不是一群一机器人。
* 默认表面：默认表面是 IM（“消息”），不是牢房。侧栏常驻“消息 / 会话”页签。
* 会话态：会话态回到官方本地工作台（文件夹树 / 会话列表 / Chat + InputBar / 轨迹 / Session 日志）。
* 消息态：消息态用户看不见 workspace / 文件夹树 / New Session / DSH session id。IM 只渲染模型 present 出的气泡和既有 yzj 写确认卡。
群聊交互¶
在群聊中，@助手 不会发云之家，而是锚在被回复的 msgId 下（只你可见）。
安装与启用¶
安装命令如下：
pnpm dsh plugin --profile web add -w link:<本仓库路径>
dsh plugin --profile web add github:GuoxinShan/dsh-yzj#v0.1.0
安装后重启 GUI。默认侧栏 workspaces 区域是 IM 收件箱（“消息”），顶部可切到“会话”恢复官方 DSH。
典型用法¶
- 发给助手：发给助手后，隐藏 session 串行 followup，显示
present气泡 + 写确认卡。 - 群消息发送：
home-send以本人身份发群（无确认卡）。 - 回复 @助手：回复 +
@助手= 本地线程，不发云之家。
包结构与注意事项¶
插件包含独立 bundle，经 dsh plugin --profile <name> add 安装，不修改 harness 本体。
包结构如下：
* packages/bridge：@dsh-yzj/bridge → ctx.yzjBridge，有界子进程通道。
* packages/tool-yzj：@dsh-yzj/tool-yzj，六域 yzj_* 工具 + present。
* packages/ui-yzj：@dsh-yzj/ui-yzj，浏览器 IM 壳。
* packages/model-yzj：@dsh-yzj/model-yzj，插件级默认模型路由。
注意事项：
* 待办与 AI推进已从本公开仓撤出。
* yzj-cli 0.1.6 返回 {success, identity, data}，不要假定顶层 openId。
* 改 UI 后重建 bundle（须 copy 到根 lib/client.js，见 pitfall-051）并重启 GUI。
