前言¶
在 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 与 社区目录页。
