前言¶
DSH 生態強調“一切皆插件”。當 DeepSeek Harness Web 主窗口需要加入工作角色頁籤、對話區像素辦公室浮層，但不想改 dsh 源碼時，可以用 dsh-ui-agents-pixe。它由 EternalNight996 維護，許可證爲 MIT。
下面介紹這個插件的核心功能、安裝方式，以及可復現的典型用法。
這是什麼¶
dsh-ui-agents-pixe 是一個面向 DSH Web 主窗口的持久客戶端插件。它把「工作角色」頁籤和「像素辦公室」浮層加到主窗口中：內置 508 張完整角色卡（The Agency en 255 + agency-agents-zh zh 253），讓 agent 可按角色名取回完整角色卡，也可以進行團隊編排。
package.json 聲明 engines 要求 node >=22，許可證爲 MIT。
核心功能¶
工作角色頁籤¶
- 內置 508 張完整角色卡：
The Agency en 255+agency-agents-zh zh 253 - 支持搜索、中英切換、分部分類選人
像素辦公室浮層¶
- 使用
Canvas 2D程序化像素小人，可站立、打字、踱步 - 浮層可拖動、摺疊、縮放
- 選人即入列
- 左鍵點擊任一像素人可查看完整角色卡
agents_pixe_roles 工具¶
agents_pixe_roles 由宿主半邊註冊，agent 可按角色名取回完整角色卡。
默認情況下，agents_pixe_roles / agents_pixe_team 工具與提示段不註冊；關閉角色工具和 AI 閒聊時爲純本地零 token 消耗。
agents_pixe_team 團隊編排¶
agents_pixe_team 用於團隊編排：領袖拆解任務，成員開獨立子代理並行執行，最後由領袖彙總。
成員上限默認 4、最大 6。
AI 聊天¶
像素辦公室的臺詞可接入 AI，支持內置 AI 或外部接口。
開啓後可生成 20 字內中文閒聊；失敗或返回空時回退。AI 開啓後受預算限制：每小時最多 60 次真實調用、估算 token 上限 60K，超出回退罐頭臺詞。
設置與 token 控制¶
在「設置 → 像素辦公室」分區中，可管控：
- 角色工具
- AI 聊天開關
- 臺詞頻率
- 思考模式
- 取卡粒度：完整卡 / 僅規則 / 僅交付物
該插件還包含 token 即時顯示與預算控制，用於顯示會話用量並限制 AI 調用。
安裝與啓用¶
先運行安裝命令：
dsh plugin --profile web add dsh-ui-agents-pixe
再重啓 dsh web 使首次安裝生效。
README 明確提醒：統一使用 dsh plugin 命令，不要使用 npx @deepseek-ai/dsh 安裝。
經過上面的步驟，聊天頁出現「工作角色」頁籤，對話區出現可摺疊的像素辦公室浮層。它聲明爲持久客戶端插件，使用 npm 雙面包和 cordis 組合補丁層（dsh.bundle.patch），自掛載，安裝即生效，重啓不丟。
如需安裝可視化插件市場，可運行：
dsh plugin --profile web add dshmarket
典型用法¶
開啓角色工具或 AI 閒聊¶
在「設置 → 像素辦公室」中開啓角色工具或 AI 閒聊，並選擇取卡粒度：
- 完整卡
- 僅規則
- 僅交付物
查看完整角色卡¶
左鍵點擊任一像素人，即可打開完整角色卡。
接入外部 AI 聊天¶
在頁面中賦值一個異步函數，即可接管臺詞：
window.__AGENTS_PIXE_CHAT__ = async (req) => '你好，人類'
編程式控制 AI 聊天¶
window.__AGENTS_PIXE_CHAT_API__.setEnabled(true)
window.__AGENTS_PIXE_CHAT_API__.setProvider(async (req) => '…')
window.__AGENTS_PIXE_CHAT_API__.isOn()
使用團隊編排¶
使用 agents_pixe_team 時，由領袖拆解任務，成員開獨立子代理並行執行，最後由領袖彙總。成員上限默認 4、最大 6。
適用場景與注意¶
適合以下用法：
- 需要在 DSH Web 主窗口瀏覽、搜索和選擇內置角色卡
- 需要把已選角色以像素辦公室形式展示
- 需要
agent按角色名取回完整角色卡 - 需要默認零 token、按需開啓角色工具、AI 閒聊或團隊編排
注意：
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼與許可證 - README 中關於智子內核的說法存在衝突：一處稱
v1.0.9新增system prompt注入，另一處稱本插件不自帶智子內核、不注入system prompt。本文不把內核注入作爲確定功能 - 手動保存的自定義團隊保存在本機
localStorage - AI 生成的自定義角色保存在
~/.dsh/agents-pixe/custom-roles.json
鏈接¶
GitHub：https://github.com/EternalNight996/dsh-ui-agents-pixe
