dsh-team-panel
一个用来核算「团队各项目 Token 用量」的 DSH 插件。
团队里每个人在自己的 DSH 上选定一个要监测的项目，插件只统计那个项目的真实用量，
汇总到一台自建的团队服务器上。面板常驻侧栏底部：折叠时显示团队正在做的项目与全队总 Token，
展开后逐人显示他选了哪个项目、消耗了多少 Token、最后一次消耗是什么时候。
左下角的「峰 / 谷」圆标标出 DeepSeek 当前的计费时段。
它解决什么问题
多人在同一个项目上并行用 AI 写代码时，"这个项目到底烧了多少 Token、谁烧的" 通常是一笔糊涂账：
- DeepSeek 后台只给你账号级的用量，看不到按项目拆分；
- 各人各机器，用量散在每个人自己那边；
- 想知道"这个月这个项目花了多少"，只能靠人工报数。
这个插件的做法是：每台机器只盯住一个项目，把该项目的用量实时汇总到团队服务器，
于是所有人打开 DSH 就能看到同一份账 —— 谁在做什么项目、各自花了多少。
特性
- 先选项目，再统计 —— 使用前必须选定一个 DSH 项目；没选之前一个 token 都不统计。
选定后只统计该项目（含子目录）下会话的用量，你在别的项目里干活不会被计入、也不会被上报。
- 团队可见 —— 每个成员选了哪个项目，全队在面板上都能看到（悬停看完整本地路径）。
- 峰 / 谷实时圆标 —— 按 DeepSeek 官方峰谷计费规则判定，含周末与法定节假日，显示距下次切换的倒计时。
- 面板在你顺手的位置 —— 左侧边栏「设置」行正上方，不与右下角悬浮挂件抢位置；侧栏收起时自动隐藏。
- 零依赖团队服务器 —— 只用 Node 内置模块，邀请码加入、成员令牌鉴权、网页管理台，一条命令起服务。
- 开机自启 + 崩溃自动重启 —— 一条脚本装成 SYSTEM 后台任务，重启机器后队友无感。
- 只上报计数，不上报内容 —— 除成员名 / 项目名 / 用量数字外，其余一概不出本机。详见 SECURITY.md。
- 内置联网自检 —— 连通性、延迟、传输安全、端到端往返一次测完，直接告诉你卡在哪一步。
界面
折叠态（默认）—— 团队正在做的项目 + 全队总 Token：
折叠态
展开态 —— ① 选择要监测的项目（含完整路径）→ 逐人用量与各自所选项目：
展开态
在侧栏中的位置 —— 常驻「工作区」列表下方、「设置」行上方：
在侧栏中的位置
上面的截图是本机单独使用（还没加入团队）的状态，所以顶上是「未加入团队」、
「总 Token」为 0 —— 那是全队合计，没有团队时自然是 0；
你自己监测到的量显示在右下角的「本机」。
加入团队后这里会变成全队合计，并多出「在线 n/m」。
展开后自上而下三块：
- ① 选择要监测的 DSH 项目 —— 状态标签、项目下拉框、完整路径、开始监测 / 取消监测 / 清零
- 成员列表 —— 每人两行：名字 + 消耗 Token；他监测的项目 · 最后消耗时间 · 花费
- ② 加入团队 —— 我的 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
文档
自检
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
