前言¶
在 DeepSeek Harness（DSH）裏同時開着多個 workspace 和 session 時，側邊欄列表能跳轉，但很難一眼看出「哪一層在工作、哪一間辦公室對應哪支智能體團隊」。列表越長高，心智負擔越大。
Pixel Office 把宿主已有的 workspace / session 快照畫成一座固定像素的辦公樓：一座塔對應全部 workspace，一層樓一個 workspace，一層裏的玻璃隔間對應 session；亮燈表示該 session 的 running 爲真。下面介紹插件定位、能力與安裝用法，信息均來自倉庫 README 與 package.json。
這是什麼¶
- 倉庫： Thunderunruly/agent-office（社區目錄頁：skillhub 條目）
- npm 包名：
dsh-pixel-office（當前版本 0.1.0） - 維護者： Thunderunruly
- 許可： MIT
- 分類：趣味換裝（像素風 UI 可視化，不改變會話執行邏輯）
一句話：在 DSH Web UI 側邊欄增加「辦公樓」視圖，只讀展示並支持點進 session，不代替會話列表做權限或發消息。
核心功能¶
三層縮放與導航¶
- All view：整棟塔，每層一個 workspace；該層有進行中的 session 時樓層狀態條會亮。
- Workspace view：單層平面圖，每個玻璃辦公室一個 session（領隊大桌 + 隊員工位）。
- Session room：單間剖面，右側私人辦公室給主 session，開放辦公區給隊友與子 agent。
麪包屑與 Esc 可逐級返回；點擊樓層 → 進入 workspace，點擊辦公室 → 進入房間，點擊角色 → 打開對應 session。
實時數據，無需手動刷新¶
客戶端訂閱宿主提供的 sessions.list / workspaces.list 快照，標題、運行狀態、團隊規模、todo 進度與近期工作會在界面上就地更新。
燈光與晝夜¶
窗口、檯燈、樓層狀態條跟隨各 session 的 running 標誌。默認按本地時間 07:00–19:00 爲白天，也可在界面頂部切換晝夜；偏好寫入 localStorage 鍵 dsh.pixel-office.display.v1。
Agent Teams 與會話圖¶
若存在 agentTeam 投影則直接使用；否則從 session 圖（parentId 子節點）推導 roster，便於日後其他編排器下的 worker 也顯示爲職員。主 session 佔私人辦公室，隊友與子 agent 坐在開放辦公區（開放區最多展示 6 個工位，超出顯示 “more members” 芯片）。
固定像素世界¶
對象尺寸恆定（例如塔寬約 420px、辦公室約 210×150、房間核心約 760×488）。拉大窗口只是多露出像素畫面，不拉伸變形；一頁放不下時，電梯井上的 pixel pager 翻頁。
隱私與邊界¶
僅讀取宿主已向 Client 插件開放的 session 元數據（標題、運行態、更新時間、cwd、父 session、團隊投影、緊湊的 work/todo 投影等）；不讀 session 日誌、不寫日誌、不髮網絡請求、無遙測。插件爲只讀可視化：不能在房間內批准權限或發消息。
安裝與啓用¶
環境要求：DSH 0.2.1-rc.3 或更新版本，且具備 Web UI 與插件支持（package.json 中 engines.dsh 爲 >=0.2.1-rc.3 <0.3.0-0）。
推薦：從 npm 安裝
dsh plugin --profile desktop add dsh-pixel-office
或從 DSH 插件市場：在 DSH 中打開 Plugins → Discover，搜索 Pixel Office 安裝；目錄頁爲 awesome-dsh-plugin.com/p/Thunderunruly/agent-office/。
安裝完成後刷新一次 DSH 窗口，讓 client bundle 進入啓動圖；之後 client 熱更新可在不重啓整窗的情況下生效。
說明：插件以當前 DSH 進程權限運行，安裝前請自行查看源碼與 MIT 許可證；社區插件目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
典型用法¶
- 在左側邊欄點擊像素塔圖標，打開辦公樓頁面。
- 在 All view 中查看各 workspace 樓層；有亮燈辦公室表示該層有進行中的 session，點擊樓層進入。
- 在 workspace view 中點擊某個玻璃辦公室，進入該 session 的房間視圖。
- 在 session room 中點擊任意角色，跳轉到對應 session。
- 需要切換晝夜時使用頂部開關，或在 Settings → General → Pixel office display 中配置；視圖超出單頁時用滾輪 / 方向鍵或電梯井上的 pager 翻頁。
架構要點（便於排錯）¶
Bundle 分 Host 與 Client：index.js 保持 bundle 結構供後續 Super-agent 適配；client.js 訂閱快照、摺疊爲 OfficeModel 後在 canvas 上繪製三檔場景；cordis.patch.yml 向宿主注入插件行。頁面 chrome 儘量複用宿主 Button、SegmentedControl 等組件（不可用時有自包含 fallback）。
已知限制（README）：寬約 700 邏輯像素以下時房間核心會對稱裁切外牆裝飾；插件不提供獨立預覽頁，視覺驗證需在運行中的 DSH 頁面進行。
結尾¶
若你希望在 DSH 裏用一層「辦公樓」總覽多 workspace、多 session 的運行態，並點按進入具體會話，Pixel Office 是面向趣味換裝分類的只讀可視化插件。安裝以 dsh plugin --profile desktop add dsh-pixel-office 爲準；細節與截圖見 GitHub README 與 社區目錄頁。
