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。
