🏢 dsh-office

Office workspace & session dashboard plugin for DeepSeek Harness (DSH). 给 DeepSeek Harness (DSH) 的「办公室」工作区 / 会话 / 子代理可视化插件。

---

What is dsh-office? / 这是什么

dsh-office is a floating office panel for DeepSeek Harness. It turns your workspaces, sessions, token usage and subagents into a 6-column sprite office, so you can see what every agent is doing at a glance — without opening each session.

dsh-office 是 DeepSeek Harness 的一个悬浮「办公室」面板，把工作区、会话、 token 用量、子代理变成一屏 6 列精灵办公室，一眼看清每个 agent 在忙什么， 不用逐个点开会话。

• Workspace / 工作区：6 列布局，一眼总览。
• Session / 会话：活跃 / 待确认 / 已完成状态，彩色边框区分。
• Token / token 用量：单次输入 vs 累计，活跃会话实时、历史会话冷读。
• Subagent / 子代理：自动过滤子代理会话，父会话聚合显示「有子代理在跑」。

Features / 特性

• 🏢 6-column sprite office / 6 列精灵办公室
• 🔵 悬浮入口 + 一键开关 / floating FAB + toggle
• 🧠 MBTI 角色 + 个性化气泡 / MBTI characters + idle bubble texts
• 🔢 token 单次 vs 累计口径 / per-input vs cumulative token
• 🤖 子代理识别与过滤 / subagent detection & filtering

Install / 安装

从 npm 安装 / Install from npm

dsh plugin --profile web add dsh-office

本地开发安装 / Local (file:) install

pnpm add dsh-office@file:<path/to/dsh-office>
# 然后在 profile 的 bundles 里加 "dsh-office"

即：在 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 数组中加入 "dsh-office"，然后重启 dsh web。

数据目录：~/.dsh/office/（office-config.json、token-usage.json）。

Usage / 使用

1. 右下角点 🏢 办公室 FAB。
2. 打开 6 列面板，看到工作区 / 会话 / token / 子代理。
3. 点会话卡片跳转；面板随侧边栏切换自动收起。

Why dsh-office? / 解决什么问题

• Before / 之前：工作区多、会话散、token 不可见、子代理混在主列表里。
• After / 之后：一屏总览所有 agent 状态与资源占用。

FAQ / 常见问题

Q: 它和 dsh-polling 有什么区别？ A: dsh-polling 管定时任务；dsh-office 管可视化总览。两者可共存。

Q: token 的「单次输入」和「累计」是什么口径？ A: 单次输入 = 最近一次请求的输入 token；累计 = 该会话历史输入 + 输出 + 缓存读写之和。活跃会话显示单次，空闲会话显示累计。

Q: 子代理会话为什么看不到？ A: 子代理会话默认从列表 / 徽标 / 悬浮里过滤（避免噪声），但 token 仍计入父会话。

Ecosystem / 生态

• DeepSeek Harness — the harness this plugin runs on
• dsh-plugin topic — more DSH plugins
• awesome-deepseek-harness — curated DSH ecosystem

License

MIT