团队用量面板 guooo1380/dsh-team-panel

dsh-team-panel

一个用来核算「团队各项目 Token 用量」的 DSH 插件。

团队里每个人在自己的 DSH 上选定一个要监测的项目，插件只统计那个项目的真实用量，汇总到一台自建的团队服务器上。面板常驻侧栏底部：折叠时显示团队正在做的项目与全队总 Token，展开后逐人显示他选了哪个项目、消耗了多少 Token、最后一次消耗是什么时候。
左下角的「峰 / 谷」圆标标出 DeepSeek 当前的计费时段。

CI
License: MIT
Node
Dependencies

它解决什么问题

多人在同一个项目上并行用 AI 写代码时，"这个项目到底烧了多少 Token、谁烧的" 通常是一笔糊涂账：

- DeepSeek 后台只给你账号级的用量，看不到按项目拆分；
- 各人各机器，用量散在每个人自己那边；
- 想知道"这个月这个项目花了多少"，只能靠人工报数。

这个插件的做法是：每台机器只盯住一个项目，把该项目的用量实时汇总到团队服务器，于是所有人打开 DSH 就能看到同一份账 —— 谁在做什么项目、各自花了多少。

特性

- 先选项目，再统计 —— 使用前必须选定一个 DSH 项目；没选之前一个 token 都不统计。
选定后只统计该项目（含子目录）下会话的用量，你在别的项目里干活不会被计入、也不会被上报。
- 团队可见 —— 每个成员选了哪个项目，全队在面板上都能看到（悬停看完整本地路径）。
- 峰 / 谷实时圆标 —— 按 DeepSeek 官方峰谷计费规则判定，含周末与法定节假日，显示距下次切换的倒计时。
- 面板在你顺手的位置 —— 左侧边栏「设置」行正上方，不与右下角悬浮挂件抢位置；侧栏收起时自动隐藏。
- 零依赖团队服务器 —— 只用 Node 内置模块，邀请码加入、成员令牌鉴权、网页管理台，一条命令起服务。
- 开机自启 + 崩溃自动重启 —— 一条脚本装成 SYSTEM 后台任务，重启机器后队友无感。
- 只上报计数，不上报内容 —— 除成员名 / 项目名 / 用量数字外，其余一概不出本机。详见 SECURITY.md。
- 内置联网自检 —— 连通性、延迟、传输安全、端到端往返一次测完，直接告诉你卡在哪一步。

界面

折叠态（默认）—— 团队正在做的项目 + 全队总 Token：

折叠态

展开态 —— ① 选择要监测的项目（含完整路径）→ 逐人用量与各自所选项目：

展开态

在侧栏中的位置 —— 常驻「工作区」列表下方、「设置」行上方：

上面的截图是本机单独使用（还没加入团队）的状态，所以顶上是「未加入团队」、「总 Token」为 0 —— 那是全队合计，没有团队时自然是 0；你自己监测到的量显示在右下角的「本机」。
加入团队后这里会变成全队合计，并多出「在线 n/m」。

展开后自上而下三块：

1. ① 选择要监测的 DSH 项目 —— 状态标签、项目下拉框、完整路径、开始监测 / 取消监测 / 清零
2. 成员列表 —— 每人两行：名字 + 消耗 Token；他监测的项目 · 最后消耗时间 · 花费
3. ② 加入团队 —— 我的 DSH 名字 / 服务器地址 / 邀请码

还没选项目时面板会换成琥珀色虚线边框并自动展开，提示你去选。
想看真实效果不用装插件：npm run preview 或直接用浏览器打开 scripts/preview.html。

快速开始

1. 装插件

要求 Node.js >= 20（DSH Desktop 自带 pnpm，不需要额外装依赖）。

当前 GUI（DSH Desktop 界面）属于 desktop profile
dsh plugin --profile desktop add link:

独立 dsh web 服务器（可选）
dsh plugin --profile web add link:

验证以产物为准，别只看命令回显：

dsh --profile desktop --dump-config | Select-String dsh-team-panel

然后重启 DSH Desktop（宿主端不会热加载），再按 Ctrl+F5 刷新界面。

link: 安装后不要移动本仓库目录；真要移动，先 remove 再重新 add link:。

2. 选一个要监测的项目

面板会因为「还没选项目」自动展开 → 下拉框选一个项目 → 开始监测。

这一步不做，就不会统计任何用量。

3. 组队

服务器那台（常开机器）：

装成开机自启 + 崩溃自动重启（需管理员） scripts\install-autostart.cmd 7801 放行入站端口（需管理员） scripts\allow-firewall.cmd 7801 查邀请码和给队友的地址
node scripts\hub-info.mjs

队友：DSH 面板 → ⊕ 展开 → 「设置」→ 填「服务器地址 + 邀请码」→ 加入团队。

两台机器的逐步教程（含自检与验收） → docs/two-devices.md

只有一台电脑也能先跑通：双击 scripts\start-hub-public.cmd 起服务器 → 面板「设置」里填 http://127.0.0.1:7801 + 邀请码；想看「两台设备」的样子再双击 scripts\demo-teammate.cmd（模拟队友，数字是造的）。详见该文档 A 部分。

队友连不上时，在队友那台机器上跑
node scripts\netcheck.mjs http://服务器地址:7801

联网方案怎么选

短周期（2–6 周，用完就散）直接用 Tailscale。
短周期下判断标准不是月费，而是“中途会不会被打断”—— Tailscale 免费版（最多 6 用户、设备不限）地址永久固定，而 Cloudflare 快速隧道的 URL 每次重启都变、官方也不给可用性保证。
中途换一次地址的代价，比开局每人多花 10 分钟安装大得多。

| 场景 | 推荐 |
| 队友在同一间办公室 | scripts\start-hub-public.cmd，把横幅里 👉 队友填： 那行抄给队友 |
| 异地、短期（≤6 周） | Tailscale：每人装一次客户端，地址永久固定，免费 |
| 异地、长期 / 人多 | 公网 VPS + Caddy 自动 HTTPS（国内服务器注意 ICP 备案） |
| 临时试用、队友零安装 | Cloudflare 快速隧道（地址会变，别用于长期） |
| 已有域名 | Cloudflare 命名隧道 + Access（队友零安装、地址固定、真邮箱鉴权） |

完整步骤、逐条命令、排查顺序、中国大陆特有的坑 → docs/networking.md

文档

| 文档 | 内容 |
| docs/two-devices.md | 两台设备用插件互连：从装插件、起服务器、加入、验收到排错的完整步骤 |
| docs/networking.md | 联网方案详解：三条路线、Tailscale 逐步操作、排查顺序、国内注意事项 |
| docs/architecture.md | 工作原理：部件、数据流、统计口径、面板挂载点、自检体系 |
| docs/troubleshooting.md | 常见问题：看不到面板、Token 为 0、连不上、乱码…… |
| CONTRIBUTING.md | 开发环境、自检方式、本项目特有的硬约束 |
| SECURITY.md | 信任模型、凭据说明、部署加固清单、漏洞报告方式 |
| CHANGELOG.md | 版本变更记录 |

自检

132 项断言 / 7 个套件，零依赖，克隆下来直接跑：

node scripts\ci.mjs # 全套（会自己起一个临时 hub 做联调）
node scripts\ci.mjs --offline # 只跑不需要 hub 的部分

单独跑某一块：

| 脚本 | 手法 | 项数 |
| scripts/entrycheck.mjs | 真的 import 一次各模块 | 17 |
| scripts/mounttest.mjs | 仿 DOM 跑真实 panel.js，验证锚点与窄栏隐藏 | 16 |
| scripts/selftest.mjs | 峰谷边界 / 周末 / 法定节假日 + hub 全部接口与鉴权 | 38 |
| scripts/plugintest.mjs | mock ctx 拉起真实 lib/index.js + 真 hub 联调 | 61 |

插件还提供一个运行时自检接口：http://127.0.0.1:43120/dsh-team/ping。

隐私

上报的只有计数：成员名、机器名、项目名与路径、Token 数、估算花费、最后消耗时间。

绝不上报：提示词、模型回复、文件内容、会话标题、代码、任何凭据。

本机状态落在 %DSH_HOME%/team-panel/state.json —— 该文件含成员令牌（等同密码），不要提交或分享。

详见 SECURITY.md。

目录结构

dsh-team-panel/
├─ lib/
│ ├─ index.js 宿主端插件：token 采集、/dsh-team/* 路由、团队同步、界面注入 │ ├─ panel.js 注入浏览器的面板脚本（纯 JS，零依赖，无需构建） │ ├─ peak.mjs 峰谷时段判定（唯一真源，含法定节假日表） │ ├─ net-addresses.mjs 本机 IPv4 分类（局域网 / Tailscale / 其它，剔除虚拟网卡） │ └─ team-hub.mjs 团队服务器（零依赖） ├─ scripts/ │ ├─ ci.mjs 全量自检入口（本地与 CI 共用） │ ├─ entrycheck.mjs 入口冒烟测试 │ ├─ mounttest.mjs 挂载逻辑自检（仿 DOM） │ ├─ selftest.mjs 峰谷 + hub API 自检 │ ├─ plugintest.mjs 宿主端插件自检 │ ├─ hub-info.mjs 服务器信息速查（邀请码 / 管理密钥 / 推荐地址） │ ├─ netcheck.mjs 联网连通性自检 │ ├─ fake-device.mjs 模拟「第二台设备」（单机验证连接与显示，数字是造的） │ ├─ set-repo.mjs 回填仓库地址（替换 OWNER 占位符） │ ├─ serve-preview.mjs 本地静态预览服务 │ ├─ preview.html 离线预览页 │ ├─ start-hub.cmd 启动 hub：本机模式 │ ├─ start-hub-public.cmd 启动 hub：对外监听 │ ├─ demo-teammate.cmd 双击即用的模拟队友（内部调用 fake-device.mjs） │ ├─ install-autostart.cmd 装成开机自启（需管理员） │ ├─ uninstall-autostart.cmd 卸载自启 │ └─ allow-firewall.cmd 放行入站端口（需管理员） ├─ docs/ 联网方案 / 工作原理 / 常见问题 ├─ cordis.patch.yml bundle patch：把插件挂进 profile 配置树 └─ package.json

.cmd 脚本一律纯 ASCII + CRLF —— 这不是风格偏好，是踩过的坑： cmd.exe 按控制台代码页解析批处理，UTF-8 中文会让整行命令读崩。
中文提示统一由 Node 输出。详见 CONTRIBUTING.md。

许可

MIT