1569126506-sudo/dsh-team-cost

dsh-team-cost · 团队成本管家

DeepSeek Harness 团队级 AI 用量与成本计量插件：按成员、按项目精确记录每一次模型调用的 token 与费用（子代理一并计入），内置成员预算、阈值告警、Webhook 通知、可选超支拦截，以及一个可以随时向 AI 查询的报表工具。

DeepSeek Harness (dsh) 正在被团队共用一台主机地使用，但生态里现存的 100+ 个用量插件几乎全是单人自用仪表盘：它们盯着自己会话的余额，回答不了团队最关心的问题——

- 这个月每个人花了多少钱？
- 子代理（subagent / Agent Teams 队友）的用量去哪了？（官方论坛已有团队反馈汇总口径少算 2.3×）
- 谁超预算了？超了要不要拦？

dsh-team-cost 只做这一件事，把它做完整。

功能

- 全量计量：监听 session/event，从每条 assistant/message 读取官方 TokenUsage（未命中输入 / 输出 / 缓存命中 / 缓存写入 / 推理分列）。子代理会话照常上报，全部计入。
- 成员归因：按工作空间路径前缀规则把会话归属到成员（members=workspace 规则，最长前缀优先）；配 dsh-login 每用户工作空间时每人只需一行规则。未匹配的会话归入可配置的默认成员。
- 计价：内置 DeepSeek 2026-09 官方价目表（峰/谷价 × 人民币/美元），其他模型通过 price-overrides.json 配置；未配置的模型照常计 token，费用记 0。
- 成员预算：每个成员独立的日/月费用与 token 预算，编辑 /members.json 一分钟内生效，无需重启。
- 告警：越过 80%/100% 阈值时触发一次通知（去重），可推送 Webhook（企微/钉钉/飞书机器人直接可用）；同时派发 dsh-team-cost/quota-exceeded 事件给其他插件。
- 超支拦截（可选）：enforce: 'total' 超过团队日预算后拦截新模型请求；enforce: 'members' 尝试按成员拦截（尽力而为，见配置注释）。默认只监控不拦截。
- 报表工具：AI 工具 team_cost_report——问一句“出一下本月团队成本报表”即可按成员/模型/天分组统计，支持导出 CSV。

安装

从 GitHub 仓库安装
dsh plugin --profile web add https://github.com/1569126506-sudo/dsh-team-cost

或克隆到本地后从路径安装
git clone https://github.com/1569126506-sudo/dsh-team-cost.git
dsh plugin --profile web add ./dsh-team-cost

npm 渠道（dsh plugin --profile web add dsh-team-cost）待账号注册开放后启用。

配置

插件配置（cordis 设置页 / patch）：

| 键 | 默认 | 说明 |
| --- | --- | --- |
| dataDir | ~/.dsh/.dsh-team-cost | 数据目录（JSONL 账本、rollups、members.json、导出文件） |
| enabled | true | 总开关 |
| currency | CNY | 内置价目表币种：CNY / USD |
| deepseekPeakPricing | false | DeepSeek 使用峰价而非谷价 |
| enforce | off | off / total / members，见上文 |
| totalDailyCost | 0 | 团队日预算（enforce: total 时生效） |
| alertThresholds | ["80","100"] | 告警阈值（百分比） |
| alertWebhook | 空 | 告警 Webhook POST 地址 |
| attributionRules | [] | 成员归因规则 "成员=工作空间路径前缀" |
| defaultMember | unassigned | 未匹配会话的归属成员 |
| flushIntervalSec | 15 | 聚合落盘间隔 |

成员预算示例（~/.dsh/.dsh-team-cost/members.json）：

{
"members": [
{ "name": "alice", "dailyCost": 20, "monthlyCost": 400 },
{ "name": "bob",   "dailyCost": 20, "dailyTokens": 50000000 }
]
}

价格覆盖示例（price-overrides.json，单位：每百万 token）：

{ "kimi-k3": { "cr": 0.5, "in": 4, "out": 16 } }

报表

对 AI 说：

用 team_cost_report 出一下本月的团队成本报表，按成员分组，并导出 CSV

或直接调用工具参数：range: today|month|all，groupBy: member|model|day，csv: "true"。

验证真实账本

跑几轮真实会话后,校验账本完整性并把费用按内置价目重算对账:

数据与隐私

账本是纯本地 JSONL（usage-YYYY-MM.jsonl），聚合缓存在 rollups.json。不外发任何会话内容——计量只读取 token 计数、模型名与工作目录。

看板

设置 → 团队成本:

团队成本看板

路线图

- [x] v0.2：Web 设置页成本看板（客户端面板,Typert RPC）
- [ ] dsh-login 原生身份桥接（免配置按登录名归因）
- [ ] 更多厂商内置价目与自动价格同步
- [ ] sqlite 存储后端与更长周期报表
- [ ] 团队配额与企业 SSO（商业版）

License

MIT

English
面向 DeepSeek Harness 的团队范围 AI 使用与成本计量。每一次模型调用——包括子代理——都从官方 session/event 事件流（assistant/message 携带该步骤的 TokenUsage）进行计量，通过工作区前缀规则归属到团队成员，依据内置的 DeepSeek 2026-09 目录（高峰/非高峰，人民币/美元）或用户覆盖进行定价，并追加到本地月度 JSONL 账本。

按成员的每日/每月预算存放在 /members.json 中（热重载）；跨越 80%/100% 阈值会触发去重告警和可选 webhook。enforce: 'total' | 'members' 可以阻止超出预算的新模型请求（默认关闭）。team_cost_report 工具可按成员、模型或日期回答“团队这个月花了多少钱？”，并支持 CSV 导出。

对话内容永远不会离开本机：计量仅读取 token 计数、模型 id 和会话工作目录。