团队仪表盘 dadgrand/dsh-agent-teams-dashboard

dsh-agent-teams-dashboard

一个 DSH Web 插件，在侧边栏加入 Teams 分区（«Команды»），并为每个 AgentTeams 聊天提供一个仪表盘：最近三天内活跃的运行和已完成的团队、带时间范围控件的 token 消耗、以 USD 和 RUB 计的费用、总工作时间与合并工作时间、带 orca 阵容和任务路线图的团队卡片，以及更早团队的归档。

插件分两半：宿主端（index.js + lib/host/）以只读方式读取 DSH 和 AgentTeams 状态，并提供两条回环 JSON 路由；浏览器端（lib/client.js）在 DSH 外壳内渲染面板。面板从不与外界通信：它只调用自己同源的这条路由。

桌面视口下的 Teams 仪表盘

390 px 移动宽度下的 Teams 仪表盘

两张截图都来自离线预览工具，用的是合成演示数据；本仓库任何地方都没有使用所有者数据。

功能

- 侧边栏分区 «Команды»（面板 id agent-teams-dashboard，顺序 10），团队工作时显示一个实时圆点。
- 时间范围：今天、7 天（默认）、30 天、全部时间，以及自定义时段选择器。
- 三张主卡片：token（缓存 / 输入 / 输出，按天堆叠）、费用（USD 为主，RUB 始终可见，CBR 汇率带日期和过期/覆盖标记）、时间（总工作时间加上合并后的「在线」时间）。
- 团队网格：标题从 13 → 12 → 11 px 逐级缩小并截断为两行，彩色状态圆点配文字（active、waiting、halted、stalled、completed、unknown），队长和成员的 orca 图案，缺图时用字母组合兜底，按依赖排序的任务路线图配分段进度条，以及一行指标页脚。
- 归档视图，支持按标题搜索、按结束日期、标题或花费排序；更早的团队也能从底部固定按钮进入。
- 点击卡片或归档行，通过外壳导航打开团队聊天（队长会话）；会话不存在时弹出提示，而不是跳转。
- 骨架、空、范围内为空、错误、过期和部分加载状态；单个损坏的 team.json 绝不会让仪表盘变空白——它会变成一条警告条，其余内容照常显示。
- 深色和浅色主题由 DSH token 驱动，支持键盘焦点、礼貌的实时区域、减少动效，以及 RU/EN 词典。

安装

要求：支持客户端插件的 DSH Web（dsh.engines.dsh >= 0.2.0-rc.2），以及提供数据本身的 AgentTeams 插件（@nanmicoder/dsh-agent-teams）。

从 git 安装（推荐）

dsh plugin --profile <profile> add --save-exact git+https://github.com/dadgrand/dsh-agent-teams-dashboard.git#v0.1.0

把 <profile> 换成你的 DSH 配置档名称（桌面应用默认配置档通常是 desktop）。命令结束后重启宿主；加载器会自动挂载插件的 cordis.patch.yml 行。

从桌面插件管理器安装

打开 Settings → Plugins，选择「Install from Git URL」，粘贴：

git+https://github.com/dadgrand/dsh-agent-teams-dashboard.git#v0.1.0

确认安装，然后重启宿主。插件会出现在侧边栏，名称为「Команды」。

手动安装到配置档

把依赖加到 <DSH_HOME>/profiles/<profile>/package.json：

{
"dependencies": {
"dsh-agent-teams-dashboard": "git+https://github.com/dadgrand/dsh-agent-teams-dashboard.git#v0.1.0"
}
}

再把包名加到同一文件的 dsh.profile.bundles：

{
"dsh": {
"profile": {
"bundles": ["...", "dsh-agent-teams-dashboard"]
}
}
}

然后安装并重启：

cd <DSH_HOME>/profiles/<profile>
pnpm install

<DSH_HOME> 在 Windows 上默认是 %USERPROFILE%\\.dsh，在 macOS/Linux 上默认是 ~/.dsh。

配置

所有设置都是可选的；不写 config 块时，插件按下面的默认值挂载。在配置档的 cordis.patch.yml 里覆盖它们：

- id: teams-dashboard
name: 'dsh-agent-teams-dashboard'
config:
archiveDays: 5
fxEnabled: true

| 键 | 默认值 | 允许值 | 含义 |
| stateDir | .agent-teams | 非空字符串 | 每个工作区内的 AgentTeams 状态目录。 |
| timeZone | 空 | IANA 时区 | 用于日期键的时区；空表示宿主时区。 |
| defaultRange | today | today、7d、30d、all、custom | 请求未带范围时使用的范围（面板总是自带范围，其默认是 7 天）。 |
| defaultCurrency | usd | usd、rub | 请求未带币种时的主币种。 |
| archiveDays | 3 | 整数 1…365 | 活跃团队多少天无活动后移入归档（面板请求的是 3）。 |
| idleGapMs | 300000 | 整数 1000…86400000 | 事件之间超过这个间隔就结束一个活动区间。 |
| activeWindowMs | 120000 | 整数 1000…86400000 | 成员算作工作中的时间窗口。 |
| snapshotTtlMs | 15000 | 整数 0…3600000 | 快照缓存存活时间。 |
| concurrency | 8 | 整数 1…32 | 构建快照时并行读取文件的数量。 |
| maxLogBytes | 67108864 | 整数 65536…1073741824 | 超过这个大小的日志从尾部读取。 |
| fxEnabled | true | 布尔 | 允许抓取 CBR 汇率；false 时用最后的缓存或内置汇率。 |
| fxTtlMs | 86400000 | 整数 60000…2592000000 | 汇率缓存存活时间（24 小时）。 |
| fxFirstWaitMs | 3500 | 整数 0…60000 | 首次请求等待汇率多久后改用兜底值。 |
| usdRub | 未设置 | 正数 | 手动指定 RUB 兑 USD 汇率；优先于任何抓取到的值。 |
| cnyRub | 未设置 | 正数 | 手动指定 RUB 兑 CNY 汇率；优先于任何抓取到的值。 |

汇率也可以通过环境变量 DSH_TEAMS_DASHBOARD_USD_RUB 和 DSH_TEAMS_DASHBOARD_CNY_RUB 提供；手动汇率会把快照标记为覆盖值。

隐私

插件对你的 DSH home 和工作区只读，涉及这些位置：

- <DSH_HOME>/storages/workspace.json — 工作区和会话注册表；
- <DSH_HOME>/storages/session_projcache/sessions/.json — 会话投影（标题、token 分桶、每日成本、最近活动）；
- <DSH_HOME>/sessions/<project>/<session>/session.v4.jsonl.zstd — 会话日志（活动区间和兜底时间源）；
- <workspace>/.agent-teams/<team>/team.json 和 <workspace>/.agent-teams/archive/<team>/team.json — 成员名单、任务、状态标记。

它从不读取消息内容，从不读取 AgentTeams 邮箱（inbox/.jsonl 不在范围内），不发遥测，只写一个文件：汇率缓存，位于 <DSH_HOME>/cache/dsh-teams-dashboard/fx.json。这个文件可以放心删除。

唯一的对外请求是访问两个 CBR 端点：

- https://www.cbr.ru/scripts/XML_daily.asp（主）；
- https://www.cbr-xml-daily.ru/daily_json.js（兜底）。

用 fxEnabled: false 关掉它们；之后插件会使用最后一次缓存的汇率或内置汇率，并把快照标记为过期。两个面板路由只在回环地址
（127.0.0.1 / ::1）上响应：远程调用方会收到 403 forbidden:
loopback-only。除此之外不向任何地方发送数据。

公开仓库及其 fixtures/截图只包含合成的演示数据。
scripts/check-public.mjs 在每次发布前强制检查这一点。

兼容性

- DSH Web >= 0.2.0-rc.2，需支持客户端插件（dsh.client bundle 入口和 sidebar.panellist / main 插槽）。
- 测试套件、检查和离线预览 harness 需要 Node.js 24 或更新版本；插件本身没有运行时依赖。
- AgentTeams（@nanmicoder/dsh-agent-teams）可选挂载，但数据必需：没有它仪表盘就是空的，鲸鱼插画会退回字母徽章。
- Windows、macOS 和 Linux。Windows 路径用 path.join/resolve 处理，长路径编码与 DSH 一致。

故障排查

「Команды」这一行不出现。 检查插件是否在 dsh.profile.bundles 里，git spec 是否解析成功（到插件管理器里找安装错误），宿主是否重启过，以及加载器输出里是否有行 id teams-dashboard。

面板能打开，但没有团队。 可能没装 AgentTeams 插件，或者当前工作区还没有 .agent-teams 目录。在聊天里用 /agent-teams 创建一个团队。团队只在已注册的工作区下查找。

远程浏览器收到 403。 路由按设计只允许回环访问。请在与宿主同一台机器上使用仪表盘。

卢布显示「—」或汇率过期。 CBR 请求失败且没有缓存（或者你关掉了 FX）。手动设置 usdRub/cnyRub，或者让宿主保持在线。

头像是字母徽章。 在 /plugins/dsh-agent-teams/assets/ 没找到已安装的 AgentTeams 插件；这是设计好的兜底。
首次加载需要几秒。 冷快照要读取 18 条团队记录、会话缓存和日志；之后的请求会命中 15 秒的快照缓存。热请求只需毫秒级。

检查在本地跑。 在仓库根目录用 Node 24 运行：node --test、node scripts/check-package.mjs、check-bundle、check-preview 和 check-public。预览和截图脚本需要 preview/vendor/ 里随包附带的资源。

限制

- token 和费用按天统计：DSH 的 contextActivity 只存按天的桶，所以「今天」只有一根柱子，拿不到一天内的费用。
- 费用是按 DeepSeek 公布的人民币价格和 CBR 当日汇率估算的，不是服务商账单。未知的服务商/模型会计 token，但费用留空（「—」，绝不为 0）。
- RUB 取决于汇率；离线且没有缓存时，用内置汇率并标记为过期。
- 路由只监听回环地址；远程 Web UI 会收到 403。
- 只在已注册的工作区路径下发现团队；游离的 .agent-teams 目录会计数，但不渲染。
- 已移除的成员保留在历史和归属里，但从不计入活跃成员。
- 长归档不做虚拟化；content-visibility: auto 是唯一的缓解手段。
- 插画来自已安装的 AgentTeams 插件；图片缺失时降级为字母组合。
- 预览 harness 在模拟外壳里挂载真实 bundle；它不跑真实外壳的导航服务、焦点环或槽位几何。

开发

node --test # unit and smoke tests
node scripts/check-package.mjs # manifest, exports, patch row, README
node scripts/check-bundle.mjs # browser bundle and dictionaries
node scripts/check-preview.mjs # offline fixtures and harness wiring
node scripts/check-public.mjs # public-release privacy gate

preview/ 里的离线 harness 通过 window.__ModuleLoader__ 桩加载真实的 lib/client.js，配的是随包附带的 React 18.3.1 UMD 和合成测试数据。直接打开 preview/index.html，或运行 node scripts/screenshot-preview.mjs 无头截取 preview/screenshot-desktop.png（1440×900）和 preview/screenshot-mobile.png（390×844）。docs/screenshots/ 里的公开副本取自同一份合成测试数据。

许可证

MIT —— 见 LICENSE。Copyright (c) 2026 dadgrand。

团队卡片上的鲸鱼插画来自 @nanmicoder/dsh-agent-teams（MIT，Copyright (c) 2026 程序员阿江 (Relakkes)），运行时从已安装的 AgentTeams 插件加载；preview/vendor/agent-teams/ 下的副本只供离线 harness 使用。React 18.3.1 UMD（MIT，Copyright (c) Facebook, Inc. and its affiliates）随包附带，供预览 harness 使用，不属于插件本身。版本和 SHA-256 摘要见 preview/vendor/README.md。