agent-loft 0.2.33 → 0.2.34

package/README.md

@@ -54,6 +54,7 @@ Logo 就是这个意思：一大两小几颗星（多个 agent）站在同一张
   - 侧栏按页加载：「最近」先显示 10 条、每个项目目录先显示 5 条，点「展开显示」每次再拉 10 条。
   - 侧栏底部显示 Claude / Codex 的订阅额度（5 小时 / 7 天窗口，以及多久后重置）；关了额度查询就整块不显示。
   - 右上角「更多」最下面显示当前会话累计消耗的 token 分布（输入 / 缓存写入 / 缓存读取 / 输出，Claude 还有按 API 价格估算的费用）。设置也在「更多」里。在桌面端里，这个菜单并进桌面端顶栏的「更多」，排在最上面。
+  - 设置 → 用量：按日 / 月 / 年（默认按月）统计 token 和金额，有每天（每月）的柱状图，按 agent、模型、用户（管理员才有）分开看；成员只看到自己的。金额都是按 API 价格算的参考值：Claude 用它自己报的费用，Codex 不报费用，按模型单价（LiteLLM 公开价格表，内置一份快照、联网时每天更新）× token 估算。从 0.2.34 开始记录，之前的用量没有日期，不计入。
   - 「添加到主屏幕」后当 App 用；切到后台再回来会自动重连，补上错过的内容。
 - **系统通知**：Web 会话回复完成、出错、需要授权或提问时推送到手机 / 电脑（设置 → 通知 → 「在此设备开启通知」，可以发测试通知）。飞书会话由飞书提醒，正在前台看着的会话不推。需要 HTTPS 访问，iPhone 需 iOS 16.4+ 且从主屏幕图标打开。
 - **跨渠道同步**：飞书里的会话在 Web 上也能打开接着聊。同一个授权请求同时出现在飞书卡片和网页上，哪边先点算哪边，另一边自动变成「已处理」。
@@ -94,6 +95,7 @@ agent-loft service install        # 注册为开机自启服务（systemd / laun
 
 - 同时连多台服务器，顶部标签栏切换、拖动排序；每台各自登录，切走了也在后台连着，回复完成、需要授权时弹系统通知，程序坞图标显示未读数。
 - 菜单栏图标：悬停看各服务器的 Claude / Codex 额度、待处理和运行中的会话；双击打开主窗口。同一个账号的额度只查一次。（Windows 上点托盘图标弹出；Linux 上在托盘菜单里点「额度和待处理」。）
+- 菜单栏图标可以换成 5 小时额度读数（像「17% Claude | 76% Codex」）：桌面端设置 →「菜单栏显示 5 小时额度」，选所有服务器合起来（取最高），或者按服务器分别选 Claude / Codex（小字带服务器名）；都不选就只显示图标。只有 macOS 有，Windows / Linux 的托盘图标放不下字。
 - 支持前面挡着 Cloudflare Access 的服务器：验证页直接在窗口里完成，过期会提醒；也可以配 Service Token 免验证。
 - 首次打开可以选「这台 Mac 也作为服务端」：一键在终端里安装 agent-loft（没有 Node.js 会先用 Homebrew 装）并开机自启，装好自动连上。Linux 上一样（需要先装好 Node.js 22+，开机自启用 systemd 用户服务）；Windows 上服务端还没有开机自启，可以在 WSL 里装，桌面端会自动检测到 `127.0.0.1` 上的它。可选开启「本机有会话在跑时不休眠」。
 - 设置（`⌘,`）的服务器列表里展开某台服务器，能看它的 Agent 环境和版本，有新版本时点「升级服务端」；桌面端自己的更新在同一页的「更新」里点「更新并重启」。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-loft",
-  "version": "0.2.33",
+  "version": "0.2.34",
   "type": "module",
   "description": "多个 agent 的工作台：把本机 Claude Code / Codex 放到一处统一管理，用飞书和 Web 页面随时驱动——会话、审批、模型切换都共用",
   "keywords": [

package/src/channels/web/api.ts

@@ -17,6 +17,7 @@ import {
   isAdmin,
   legacyOwnerId,
   listUsers,
+  ownedBy,
   removeUser,
   verifyLogin,
   verifyPassword,
@@ -24,6 +25,7 @@ import {
   type User,
 } from "../../core/users.js";
 import type { SavedAttachment } from "../../core/types.js";
+import { dailyUsage } from "../../core/usage.js";
 import {
   addMemoryItem,
   clearMemory,
@@ -855,6 +857,20 @@ export async function handleApi(req: IncomingMessage, res: ServerResponse, url:
     sendJson(res, 200, { agents: await agentHealth(url.searchParams.get("refresh") === "1") });
     return;
   }
+  if (p === "/api/usage" && method === "GET") {
+    // 按天的 token / 费用账（设置 →「用量」）。?from=&to= 是 YYYY-MM-DD（含两头）。
+    // 管理员看所有人的（只有数字，看不到内容），成员只看自己对话的
+    const day = /^\d{4}-\d{2}-\d{2}$/;
+    const from = url.searchParams.get("from") ?? "";
+    const to = url.searchParams.get("to") ?? "";
+    if (!day.test(from) || !day.test(to)) throw new HttpError(400, "from / to 要是 YYYY-MM-DD");
+    const admin = isAdmin(user);
+    const rows = dailyUsage(from, to, admin ? undefined : (owner) => ownedBy(user, owner));
+    const names: Record<string, string> = {};
+    for (const r of rows) if (r.owner && !(r.owner in names)) names[r.owner] = getUser(r.owner)?.name ?? "已删除的用户";
+    sendJson(res, 200, { rows, users: names, admin });
+    return;
+  }
   if (p === "/api/quota" && method === "GET") {
     // ?agent=claude,codex：只问这几个。桌面端连着多台同账号的服务器时，同一个账号只在一台上问
     // 设置里关了查额度：不去问任何 agent

package/src/core/hub.ts

@@ -649,7 +649,13 @@ class Hub extends EventEmitter<{ event: [EventEnvelope]; task: [TaskTurnEnd] }>
           if (prev?.used !== ctx.used || prev?.window !== ctx.window) this.emitEvent(key, { type: "meta" });
         },
         // 不用另发 meta：一轮结束的 result / error 会把会话信息（含用量）推给页面
-        onUsage: (usage, cumulative) => alive() && recordUsage(holder.session?.sessionId, usage, cumulative),
+        onUsage: (usage, cumulative) => {
+          if (!alive()) return;
+          // 模型用来按单价估算没报费用的 agent（Codex）的金额
+          const current = getConversation(key);
+          const model = current ? this.displayRuntime(current, agentBinding(current, agent)).model : undefined;
+          recordUsage(holder.session?.sessionId, usage, cumulative, { owner: current?.owner, agent, model });
+        },
         onDropped: (n) => {
           if (!alive() || n <= 0) return;
           // 丢的是排在最后、还没开始的那 n 条（Codex 先报正在跑的那轮出错、再报丢弃，那时队头已经取走了）

package/src/core/model-prices.json

@@ -0,0 +1,103 @@
+{
+  "chat-latest": [5,0.5,30],
+  "computer-use-preview": [3,null,12],
+  "computer-use-preview-2025-03-11": [3,null,12],
+  "daybreak-blue-latest": [4,0.4,20],
+  "daybreak-red-latest": [12.5,1.25,75],
+  "ft:gpt-3.5-turbo": [3,null,6],
+  "ft:gpt-3.5-turbo-0125": [3,null,6],
+  "ft:gpt-3.5-turbo-0613": [3,null,6],
+  "ft:gpt-3.5-turbo-1106": [3,null,6],
+  "ft:gpt-4-0613": [30,null,60],
+  "ft:gpt-4.1-2025-04-14": [3,0.75,12],
+  "ft:gpt-4.1-mini-2025-04-14": [0.8,0.2,3.2],
+  "ft:gpt-4.1-nano-2025-04-14": [0.2,0.05,0.8],
+  "ft:gpt-4o-2024-08-06": [3.75,1.875,15],
+  "ft:gpt-4o-2024-11-20": [3.75,null,15],
+  "ft:gpt-4o-mini-2024-07-18": [0.3,0.15,1.2],
+  "ft:o4-mini-2025-04-16": [4,1,16],
+  "gpt-3.5-turbo": [0.5,null,1.5],
+  "gpt-3.5-turbo-0125": [0.5,null,1.5],
+  "gpt-3.5-turbo-1106": [1,null,2],
+  "gpt-3.5-turbo-16k": [3,null,4],
+  "gpt-4": [30,null,60],
+  "gpt-4-0613": [30,null,60],
+  "gpt-4-1106-preview": [10,null,30],
+  "gpt-4-turbo": [10,null,30],
+  "gpt-4-turbo-2024-04-09": [10,null,30],
+  "gpt-4.1": [2,0.5,8],
+  "gpt-4.1-2025-04-14": [2,0.5,8],
+  "gpt-4.1-mini": [0.4,0.1,1.6],
+  "gpt-4.1-mini-2025-04-14": [0.4,0.1,1.6],
+  "gpt-4.1-nano": [0.1,0.025,0.4],
+  "gpt-4.1-nano-2025-04-14": [0.1,0.025,0.4],
+  "gpt-4o": [2.5,1.25,10],
+  "gpt-4o-2024-05-13": [5,null,15],
+  "gpt-4o-2024-08-06": [2.5,1.25,10],
+  "gpt-4o-2024-11-20": [2.5,1.25,10],
+  "gpt-4o-mini": [0.15,0.075,0.6],
+  "gpt-4o-mini-2024-07-18": [0.15,0.075,0.6],
+  "gpt-5": [1.25,0.125,10],
+  "gpt-5-2025-08-07": [1.25,0.125,10],
+  "gpt-5-chat": [1.25,0.125,10],
+  "gpt-5-chat-latest": [1.25,0.125,10],
+  "gpt-5-codex": [1.25,0.125,10],
+  "gpt-5-mini": [0.25,0.025,2],
+  "gpt-5-mini-2025-08-07": [0.25,0.025,2],
+  "gpt-5-nano": [0.05,0.005,0.4],
+  "gpt-5-nano-2025-08-07": [0.05,0.005,0.4],
+  "gpt-5-pro": [15,null,120],
+  "gpt-5-pro-2025-10-06": [15,null,120],
+  "gpt-5.1": [1.25,0.125,10],
+  "gpt-5.1-2025-11-13": [1.25,0.125,10],
+  "gpt-5.1-chat-latest": [1.25,0.125,10],
+  "gpt-5.1-codex": [1.25,0.125,10],
+  "gpt-5.1-codex-max": [1.25,0.125,10],
+  "gpt-5.1-codex-mini": [0.25,0.025,2],
+  "gpt-5.2": [1.75,0.175,14],
+  "gpt-5.2-2025-12-11": [1.75,0.175,14],
+  "gpt-5.2-chat-latest": [1.75,0.175,14],
+  "gpt-5.2-codex": [1.75,0.175,14],
+  "gpt-5.2-pro": [21,null,168],
+  "gpt-5.2-pro-2025-12-11": [21,null,168],
+  "gpt-5.3-chat-latest": [1.75,0.175,14],
+  "gpt-5.3-codex": [1.75,0.175,14],
+  "gpt-5.4": [2.5,0.25,15],
+  "gpt-5.4-2026-03-05": [2.5,0.25,15],
+  "gpt-5.4-mini": [0.75,0.075,4.5],
+  "gpt-5.4-mini-2026-03-17": [0.75,0.075,4.5],
+  "gpt-5.4-nano": [0.2,0.02,1.25],
+  "gpt-5.4-nano-2026-03-17": [0.2,0.02,1.25],
+  "gpt-5.4-pro": [30,null,180],
+  "gpt-5.4-pro-2026-03-05": [30,null,180],
+  "gpt-5.5": [5,0.5,30],
+  "gpt-5.5-2026-04-23": [5,0.5,30],
+  "gpt-5.5-cyber": [12.5,1.25,75],
+  "gpt-5.5-cyber-preview": [12.5,1.25,75],
+  "gpt-5.5-pro": [30,null,180],
+  "gpt-5.5-pro-2026-04-23": [30,null,180],
+  "gpt-5.6": [4,0.4,20],
+  "gpt-5.6-cyber": [12.5,1.25,75],
+  "gpt-5.6-luna": [0.2,0.02,1.2],
+  "gpt-5.6-sol": [4,0.4,20],
+  "gpt-5.6-terra": [2,0.2,12],
+  "gpt-6-astra": [10,1,50],
+  "gpt-6-luna": [0.1,0.01,0.5],
+  "gpt-6-sol": [2,0.2,10],
+  "gpt-6.1-sol": [2,0.1,10],
+  "gpt-daybreak-blue-latest": [4,0.4,20],
+  "gpt-daybreak-red-latest": [12.5,1.25,75],
+  "gpt-rosalind-discovery": [5,0.5,25],
+  "o1": [15,7.5,60],
+  "o1-2024-12-17": [15,7.5,60],
+  "o1-pro": [150,null,600],
+  "o1-pro-2025-03-19": [150,null,600],
+  "o3": [2,0.5,8],
+  "o3-2025-04-16": [2,0.5,8],
+  "o3-mini": [1.1,0.55,4.4],
+  "o3-mini-2025-01-31": [1.1,0.55,4.4],
+  "o3-pro": [20,null,80],
+  "o3-pro-2025-06-10": [20,null,80],
+  "o4-mini": [1.1,0.275,4.4],
+  "o4-mini-2025-04-16": [1.1,0.275,4.4]
+}

package/src/core/pricing.ts

@@ -0,0 +1,93 @@
+// 按单价估算没报费用的 agent（Codex）的金额：Token × 单价。
+//
+// 单价来自 LiteLLM 公开维护的价格表（model_prices_and_context_window.json），只取 OpenAI 的对话模型。
+// 内置一份快照（model-prices.json，[输入, 缓存读取, 输出]，美元 / 百万 token），连得上 GitHub 时
+// 每天更新一次存到 data/model-prices.json，连不上就一直用快照。
+// 只按基础单价算：长上下文加价、priority / flex 档位都不管，所以是估算。
+import fs from "node:fs";
+import path from "node:path";
+import { dataDir, readJson, writeJsonAtomic } from "../home.js";
+import type { TokenUsage } from "./types.js";
+
+/** [输入, 缓存读取（null 表示按输入算）, 输出]，美元 / 百万 token */
+type Price = [number, number | null, number];
+type Table = Record<string, Price>;
+type Cache = { at: number; prices: Table };
+
+const SOURCE = "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json";
+const CACHE_FILE = () => path.join(dataDir, "model-prices.json");
+const MAX_AGE = 24 * 3600_000;
+/** 拉失败了隔多久再试 */
+const RETRY = 3600_000;
+
+const snapshot: Table = JSON.parse(fs.readFileSync(new URL("./model-prices.json", import.meta.url), "utf8"));
+let cache: Cache | null = null;
+let fetching = false;
+let lastTry = 0;
+
+function loadCache(): Cache {
+  return (cache ??= readJson<Cache>(CACHE_FILE(), { at: 0, prices: {} }));
+}
+
+/** 从 LiteLLM 的整张表里挑出 OpenAI 对话模型，换成每百万 token 的价格 */
+export function pickOpenAiPrices(raw: Record<string, unknown>): Table {
+  const perM = (v: unknown): number | null =>
+    typeof v === "number" && Number.isFinite(v) && v >= 0 ? Math.round(v * 1e12) / 1e6 : null;
+  const out: Table = {};
+  for (const [name, entry] of Object.entries(raw)) {
+    if (!entry || typeof entry !== "object") continue;
+    const e = entry as Record<string, unknown>;
+    if (e.litellm_provider !== "openai" || (e.mode !== "chat" && e.mode !== "responses")) continue;
+    const input = perM(e.input_cost_per_token);
+    const output = perM(e.output_cost_per_token);
+    if (input === null || output === null) continue;
+    out[name] = [input, perM(e.cache_read_input_token_cost), output];
+  }
+  return out;
+}
+
+async function refresh(): Promise<void> {
+  fetching = true;
+  lastTry = Date.now();
+  try {
+    const res = await fetch(SOURCE, { signal: AbortSignal.timeout(30_000) });
+    if (!res.ok) throw new Error(`HTTP ${res.status}`);
+    const prices = pickOpenAiPrices((await res.json()) as Record<string, unknown>);
+    if (Object.keys(prices).length === 0) throw new Error("价格表里没有 OpenAI 模型");
+    cache = { at: Date.now(), prices };
+    writeJsonAtomic(CACHE_FILE(), cache);
+  } catch (err) {
+    console.warn("[pricing] 更新模型单价失败，先用内置的:", err instanceof Error ? err.message : err);
+  } finally {
+    fetching = false;
+  }
+}
+
+/** 过期了就在后台更新一次（不等它，这次先用手上的） */
+function refreshIfStale(): void {
+  // 跑测试时不联网
+  if (process.env.NODE_TEST_CONTEXT) return;
+  if (fetching || Date.now() - loadCache().at < MAX_AGE || Date.now() - lastTry < RETRY) return;
+  void refresh();
+}
+
+/** 模型的单价。认不出来返回 undefined。名字带 openai/ 前缀、日期后缀（-2026-03-05）的也认 */
+export function priceOf(model: string | undefined): Price | undefined {
+  if (!model) return undefined;
+  refreshIfStale();
+  const table = loadCache().prices;
+  const base = model.replace(/^openai\//, "");
+  for (const name of [base, base.replace(/-\d{4}-\d{2}-\d{2}$/, "")]) {
+    const p = table[name] ?? snapshot[name];
+    if (p) return p;
+  }
+  return undefined;
+}
+
+/** 按单价估算的金额（美元）。output 已经含推理，不再单算 reasoning；认不出模型返回 undefined */
+export function estimateCost(model: string | undefined, usage: TokenUsage): number | undefined {
+  const p = priceOf(model);
+  if (!p) return undefined;
+  const [input, cacheRead, output] = p;
+  return (usage.input * input + usage.cacheRead * (cacheRead ?? input) + usage.cacheWrite * input + usage.output * output) / 1e6;
+}

package/src/core/usage.ts

@@ -4,29 +4,59 @@
 // 都按会话 id 记在这里：页面重新加载、服务重启后还在。
 // 按 agent 会话算，不按对话：/new、恢复旧会话、切 agent 之后显示的都是现在这个会话的。
 // Codex 升级前跑过的轮次没有记录，从升级后开始算。
+//
+// 另外按天记一本账（usage-daily.json，设置 →「用量」按日 / 月 / 年统计）：每次报上来的增量记到当天、
+// 按「谁的对话 + 哪个 agent + 什么模型」分开。只从有这本账开始算，之前的用量没有日期，不补。
+// 没报费用的（Codex）查的时候按模型单价估一个（见 pricing.ts）。
 import path from "node:path";
 import { dataDir, readJson, writeJsonAtomic } from "../home.js";
+import { estimateCost } from "./pricing.js";
 import type { TokenUsage } from "./types.js";
 
 export type UsageTotals = Required<Omit<TokenUsage, "costUsd">> & { costUsd?: number; at: number };
 type Store = Record<string, UsageTotals>;
 
+/** 一天里某个人用某个 agent 的合计 */
+export type DailyTotals = Required<Omit<TokenUsage, "costUsd">> & { costUsd?: number };
+/** 按天的账：日期（服务器本地时间 YYYY-MM-DD）→「owner\tagent\tmodel」→ 合计。没有主人、不知道模型的是空串 */
+type Ledger = Record<string, Record<string, DailyTotals>>;
+/** 查询结果的一行。estimated：costUsd 是按单价估的，不是 agent 报的 */
+export type DailyRow = DailyTotals & { day: string; owner?: string; agent: string; model?: string; estimated?: true };
+
 const FILE = () => path.join(dataDir, "usage.json");
+const DAILY_FILE = () => path.join(dataDir, "usage-daily.json");
 const MAX_SESSIONS = 1000;
+/** 按天的账留多久（天） */
+const MAX_DAYS = 3 * 366;
 
 let store: Store | null = null;
+let ledger: Ledger | null = null;
 let timer: NodeJS.Timeout | null = null;
 
 function load(): Store {
   return (store ??= readJson<Store>(FILE(), {}));
 }
 
+function loadLedger(): Ledger {
+  return (ledger ??= readJson<Ledger>(DAILY_FILE(), {}));
+}
+
 function write(): void {
   const s = load();
   // 只留最近用过的会话
   const keys = Object.keys(s).sort((a, b) => s[b]!.at - s[a]!.at);
   for (const k of keys.slice(MAX_SESSIONS)) delete s[k];
   writeJsonAtomic(FILE(), s);
+  const l = loadLedger();
+  const days = Object.keys(l).sort();
+  for (const d of days.slice(0, Math.max(0, days.length - MAX_DAYS))) delete l[d];
+  writeJsonAtomic(DAILY_FILE(), l);
+}
+
+/** 本地时间的 YYYY-MM-DD */
+export function dayOf(ms: number): string {
+  const d = new Date(ms);
+  return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
 }
 
 function persistSoon(): void {
@@ -52,19 +82,63 @@ const FIELDS = ["input", "cacheRead", "cacheWrite", "output", "reasoning"] as co
 
 /**
  * cumulative：报的是累计值，每项取较大的（累计值只增不减；恢复的会话万一没从原来的总数接着算，
- * 宁可先少算，也不把之前的再加一遍）。否则是增量，加上去
+ * 宁可先少算，也不把之前的再加一遍）。否则是增量，加上去。
+ * by：这次用量算谁的、哪个 agent 的（记进按天的账；不给就只记会话的）
  */
-export function recordUsage(sessionId: string | undefined, usage: TokenUsage, cumulative = false): void {
+export function recordUsage(
+  sessionId: string | undefined,
+  usage: TokenUsage,
+  cumulative = false,
+  by?: { owner?: string; agent: string; model?: string },
+): void {
   if (!sessionId) return;
   const s = load();
   const t = (s[sessionId] ??= { input: 0, cacheRead: 0, cacheWrite: 0, output: 0, reasoning: 0, at: 0 });
-  for (const f of FIELDS) t[f] = cumulative ? Math.max(t[f], num(usage[f])) : t[f] + num(usage[f]);
+  const delta: DailyTotals = { input: 0, cacheRead: 0, cacheWrite: 0, output: 0, reasoning: 0 };
+  for (const f of FIELDS) {
+    const next = cumulative ? Math.max(t[f], num(usage[f])) : t[f] + num(usage[f]);
+    delta[f] = next - t[f];
+    t[f] = next;
+  }
   const cost = num(usage.costUsd);
-  if (cost) t.costUsd = cumulative ? Math.max(t.costUsd ?? 0, cost) : (t.costUsd ?? 0) + cost;
+  if (cost) {
+    const next = cumulative ? Math.max(t.costUsd ?? 0, cost) : (t.costUsd ?? 0) + cost;
+    if (next > (t.costUsd ?? 0)) delta.costUsd = next - (t.costUsd ?? 0);
+    t.costUsd = next;
+  }
   t.at = Date.now();
+  if (by) addDaily(t.at, by, delta);
   persistSoon();
 }
 
+function addDaily(at: number, by: { owner?: string; agent: string; model?: string }, delta: DailyTotals): void {
+  if (!FIELDS.some((f) => delta[f] > 0) && !delta.costUsd) return;
+  const day = (loadLedger()[dayOf(at)] ??= {});
+  const d = (day[`${by.owner ?? ""}\t${by.agent}\t${by.model ?? ""}`] ??= { input: 0, cacheRead: 0, cacheWrite: 0, output: 0, reasoning: 0 });
+  for (const f of FIELDS) d[f] += delta[f];
+  if (delta.costUsd) d.costUsd = (d.costUsd ?? 0) + delta.costUsd;
+}
+
+/** 按天的账里 from ~ to（含两头，YYYY-MM-DD）的行；visible 按主人过滤 */
+export function dailyUsage(from: string, to: string, visible?: (owner: string | undefined) => boolean): DailyRow[] {
+  const rows: DailyRow[] = [];
+  for (const [day, buckets] of Object.entries(loadLedger())) {
+    if (day < from || day > to) continue;
+    for (const [k, v] of Object.entries(buckets)) {
+      const [o = "", agent = "", model = ""] = k.split("\t");
+      const owner = o || undefined;
+      if (visible && !visible(owner)) continue;
+      const row: DailyRow = { day, ...(owner ? { owner } : {}), agent, ...(model ? { model } : {}), ...v };
+      if (!row.costUsd) {
+        const est = estimateCost(model, row);
+        if (est) Object.assign(row, { costUsd: est, estimated: true });
+      }
+      rows.push(row);
+    }
+  }
+  return rows.sort((a, b) => a.day.localeCompare(b.day));
+}
+
 export function usageOf(sessionId: string | undefined): UsageTotals | undefined {
   return sessionId ? load()[sessionId] : undefined;
 }

package/web/css/settings.css

@@ -333,3 +333,197 @@
   background: var(--code-bg);
   font-size: 12px;
 }
+
+/* ---------- 用量（按日 / 月 / 年统计 Token 和费用） ---------- */
+
+.usage-stats h5 {
+  margin: 4px 0 -4px;
+  font-size: 13px;
+  font-weight: 600;
+  color: var(--fg-soft);
+}
+
+.us-head {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+
+.us-head h4 {
+  flex: 1;
+}
+
+.us-head .seg {
+  display: inline-flex;
+  padding: 3px;
+  border-radius: 10px;
+  background: var(--bg-soft);
+}
+
+.us-head .seg button {
+  padding: 5px 12px;
+  border-radius: 8px;
+  font-size: 13px;
+  color: var(--fg-soft);
+}
+
+.us-head .seg button.on {
+  background: var(--bg);
+  color: var(--fg);
+  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.08);
+}
+
+.us-nav {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+}
+
+.us-title {
+  min-width: 7.5em;
+  text-align: center;
+  font-size: 14px;
+  font-weight: 600;
+  font-variant-numeric: tabular-nums;
+}
+
+.us-empty {
+  padding: 24px 0;
+  text-align: center;
+}
+
+.us-tiles {
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 8px;
+}
+
+.us-tile {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 10px 12px;
+  border-radius: 10px;
+  background: var(--bg-soft);
+}
+
+.us-tile span {
+  font-size: 12px;
+  color: var(--fg-soft);
+}
+
+.us-tile b {
+  font-size: 20px;
+  font-weight: 600;
+  font-variant-numeric: tabular-nums;
+}
+
+/* 趋势：单一系列，用主题前景色；没用量的格子留空，悬停看数字 */
+.us-trend {
+  position: relative;
+  padding-top: 16px;
+}
+
+.us-bars {
+  display: grid;
+  gap: 2px;
+  height: 120px;
+  align-items: end;
+  border-bottom: 1px solid var(--border);
+}
+
+.us-col {
+  height: 100%;
+  display: flex;
+  align-items: flex-end;
+  border-radius: 4px 4px 0 0;
+}
+
+.us-col:hover {
+  background: var(--bg-soft);
+}
+
+.us-col i {
+  width: 100%;
+  background: var(--fg);
+  opacity: 0.78;
+  border-radius: 4px 4px 0 0;
+}
+
+.us-col:hover i {
+  opacity: 1;
+}
+
+.us-axis {
+  display: grid;
+  gap: 2px;
+  margin-top: 4px;
+  font-size: 11px;
+  color: var(--fg-faint);
+  text-align: center;
+  font-variant-numeric: tabular-nums;
+}
+
+.us-max {
+  position: absolute;
+  top: 0;
+  right: 0;
+  font-size: 11px;
+  color: var(--fg-faint);
+}
+
+.usage-stats .usage {
+  padding: 0;
+  font-size: 13px;
+}
+
+.us-list {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+
+.us-item {
+  display: grid;
+  grid-template-columns: minmax(5em, 9em) 1fr 4.5em 4.5em;
+  align-items: center;
+  gap: 10px;
+  font-size: 13px;
+  font-variant-numeric: tabular-nums;
+}
+
+.us-name {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.us-meter {
+  height: 6px;
+  border-radius: 3px;
+  background: var(--bg-soft);
+  overflow: hidden;
+}
+
+.us-meter i {
+  display: block;
+  height: 100%;
+  background: var(--fg-soft);
+  border-radius: 3px;
+}
+
+.us-num,
+.us-cost {
+  text-align: right;
+}
+
+.us-cost {
+  color: var(--fg-soft);
+}
+
+@media (max-width: 640px) {
+  .us-tiles {
+    grid-template-columns: 1fr 1fr;
+  }
+}

package/web/settings/index.js

@@ -10,6 +10,7 @@ import { feishuTab } from "./feishu.js";
 import { authTab, securityTab } from "./security.js";
 import { memoryTab } from "./memory.js";
 import { skillsTab } from "./skills.js";
+import { usageTab } from "./usage.js";
 import { systemTab, usersTab } from "./users.js";
 
 // ---------- 设置 ----------
@@ -20,11 +21,12 @@ export async function openSettings(tab) {
   const panel = h("div", { class: "settings-body" });
   // 设置弹窗高度固定，切标签页时不跟着内容一伸一缩
   modal({ title: "设置", wide: true, tall: true, body: h("div", { class: "settings" }, nav, panel) });
-  // 普通成员只能管自己的通知、密码和登录设备；其余设置都是管理员的
+  // 普通成员只能管自己的记忆、技能、用量、通知、密码和登录设备；其余设置都是管理员的
   if (!isAdmin()) {
     const tabs = [
       ["记忆", () => memoryTab(panel)],
       ["技能", () => skillsTab(panel)],
+      ["用量", () => usageTab(panel)],
       ["通知", () => notifyTab(panel)],
       ["账号", () => securityTab(panel)],
     ];
@@ -52,6 +54,7 @@ export async function openSettings(tab) {
     ["飞书机器人", () => feishuTab(cfg, panel)],
     ["授权", () => authTab(panel)],
     ["记忆", () => memoryTab(panel)],
+    ["用量", () => usageTab(panel)],
     ["通知", () => notifyTab(panel)],
     ["账号", () => securityTab(panel)],
     ["用户", () => usersTab(panel)],

package/web/settings/usage.js

@@ -0,0 +1,272 @@
+import { fill, h } from "../lib/dom.js";
+import { api } from "../lib/api.js";
+import { S } from "../state.js";
+
+// ---------- 用量：按日 / 月 / 年统计 token 和费用（数据见 src/core/usage.ts 按天的账） ----------
+
+/** 各项的顺序和颜色跟「更多」菜单里本会话的用量一致 */
+const PARTS = [
+  { key: "input", label: "输入", cls: "u-input" },
+  { key: "cacheWrite", label: "缓存写入", cls: "u-cwrite" },
+  { key: "cacheRead", label: "缓存读取", cls: "u-cread" },
+  { key: "output", label: "输出", cls: "u-output" },
+];
+
+const UNITS = [
+  ["day", "按日"],
+  ["month", "按月"],
+  ["year", "按年"],
+];
+
+const pad = (n) => String(n).padStart(2, "0");
+const ymd = (d) => `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
+
+/** 1234 → 1.2k，1234567 → 1.23M */
+function fmtCount(n) {
+  if (n >= 1e9) return `${(n / 1e9).toFixed(2)}B`;
+  if (n >= 1e6) return `${(n / 1e6).toFixed(n >= 1e8 ? 0 : n >= 1e7 ? 1 : 2)}M`;
+  if (n >= 1e3) return `${(n / 1e3).toFixed(n >= 1e5 ? 0 : 1)}k`;
+  return String(n);
+}
+const exact = (n) => n.toLocaleString("en-US");
+const fmtCost = (n) => `$${n >= 100 ? n.toFixed(0) : n.toFixed(2)}`;
+const tokensOf = (r) => r.input + r.cacheRead + r.cacheWrite + r.output;
+
+/** 某个周期的起止（含两头）、标题、趋势图的格子 */
+function periodOf(unit, anchor) {
+  const y = anchor.getFullYear();
+  const m = anchor.getMonth();
+  if (unit === "day") {
+    const d = ymd(anchor);
+    return { from: d, to: d, title: `${y}年${m + 1}月${anchor.getDate()}日`, buckets: null };
+  }
+  if (unit === "year") {
+    const buckets = Array.from({ length: 12 }, (_, i) => ({ key: `${y}-${pad(i + 1)}`, label: `${i + 1}月` }));
+    return { from: `${y}-01-01`, to: `${y}-12-31`, title: `${y}年`, buckets, slice: 7 };
+  }
+  const days = new Date(y, m + 1, 0).getDate();
+  const buckets = Array.from({ length: days }, (_, i) => ({ key: `${y}-${pad(m + 1)}-${pad(i + 1)}`, label: `${m + 1}月${i + 1}日` }));
+  return { from: buckets[0].key, to: buckets[days - 1].key, title: `${y}年${m + 1}月`, buckets, slice: 10 };
+}
+
+function shift(unit, anchor, step) {
+  const d = new Date(anchor);
+  if (unit === "day") d.setDate(d.getDate() + step);
+  else if (unit === "month") d.setMonth(d.getMonth() + step, 1);
+  else d.setFullYear(d.getFullYear() + step, 0, 1);
+  return d;
+}
+
+function sum(rows) {
+  const t = { input: 0, cacheRead: 0, cacheWrite: 0, output: 0, reasoning: 0, costUsd: 0 };
+  for (const r of rows) {
+    for (const k of Object.keys(t)) t[k] += r[k] ?? 0;
+  }
+  return t;
+}
+
+/** 按 keyOf 分组合计，Token 多的在前 */
+function groupBy(rows, keyOf) {
+  const m = new Map();
+  for (const r of rows) {
+    const k = keyOf(r);
+    if (!m.has(k)) m.set(k, []);
+    m.get(k).push(r);
+  }
+  return [...m].map(([k, list]) => ({ key: k, ...sum(list) })).sort((a, b) => tokensOf(b) - tokensOf(a));
+}
+
+export async function usageTab(panel) {
+  let unit = "month";
+  let anchor = new Date();
+  const box = h("div", { class: "section usage-stats" });
+  fill(panel, box);
+
+  const render = async () => {
+    const period = periodOf(unit, anchor);
+    const isCurrent = period.to >= ymd(new Date());
+    const seg = h(
+      "div",
+      { class: "seg" },
+      UNITS.map(([u, label]) =>
+        h(
+          "button",
+          {
+            class: u === unit ? "on" : "",
+            onclick: () => {
+              if (u === unit) return;
+              unit = u;
+              anchor = new Date();
+              void render();
+            },
+          },
+          label,
+        ),
+      ),
+    );
+    const nav = h(
+      "div",
+      { class: "us-nav" },
+      h("button", { class: "btn small", "aria-label": "上一个", onclick: () => ((anchor = shift(unit, anchor, -1)), void render()) }, "‹"),
+      h("span", { class: "us-title" }, period.title),
+      h(
+        "button",
+        { class: "btn small", "aria-label": "下一个", disabled: isCurrent, onclick: () => ((anchor = shift(unit, anchor, 1)), void render()) },
+        "›",
+      ),
+      isCurrent ? null : h("button", { class: "btn small", onclick: () => ((anchor = new Date()), void render()) }, unit === "day" ? "今天" : unit === "month" ? "本月" : "今年"),
+    );
+    const head = h("div", { class: "us-head" }, h("h4", {}, "Token 与费用"), seg, nav);
+    fill(box, head, h("span", { class: "spinner" }));
+
+    let data;
+    try {
+      data = await api(`/api/usage?from=${period.from}&to=${period.to}`);
+    } catch (err) {
+      fill(box, head, h("div", { class: "error-text" }, err.message));
+      return;
+    }
+    const rows = data.rows;
+    const total = sum(rows);
+    const tokens = tokensOf(total);
+    // 估算的金额、没能算金额的 Token（认不出模型，或者是升级前没记模型的 Codex 用量）
+    const estimated = rows.reduce((n, r) => n + (r.estimated ? r.costUsd : 0), 0);
+    const unpriced = rows.reduce((n, r) => n + (r.costUsd ? 0 : tokensOf(r)), 0);
+    const note = h(
+      "div",
+      { class: "muted" },
+      "金额都是按 API 价格算的参考值，订阅用户实际不按这个扣费：Claude 用它自己报的费用；Codex 不报费用，按模型单价（LiteLLM 公开价格表，每天更新）× Token 估算，不含长上下文加价。从这个版本开始记录，之前的用量没有日期，不计入。",
+      unpriced ? ` 有 ${fmtCount(unpriced)} Token 认不出模型单价，没算进金额。` : "",
+    );
+    if (!tokens) {
+      fill(box, head, h("div", { class: "muted us-empty" }, `${period.title}没有用量记录`), note);
+      return;
+    }
+
+    const days = unit === "day" ? 1 : new Set(rows.map((r) => r.day)).size;
+    const tiles = h(
+      "div",
+      { class: "us-tiles" },
+      tile("Token 合计", fmtCount(tokens), `${exact(tokens)} tokens`),
+      tile(
+        "费用（约）",
+        total.costUsd ? fmtCost(total.costUsd) : "—",
+        total.costUsd
+          ? `$${total.costUsd.toFixed(4)}${estimated ? `，其中按单价估算 $${estimated.toFixed(4)}` : ""}`
+          : "这段时间没有能算金额的用量",
+      ),
+      unit === "day"
+        ? tile("输出", fmtCount(total.output), `${exact(total.output)} tokens`)
+        : tile("日均 Token", fmtCount(Math.round(tokens / days)), `有用量的 ${days} 天平均`),
+    );
+
+    const parts = PARTS.map((p) => ({ ...p, n: total[p.key] })).filter((p) => p.n > 0);
+    const composition = h(
+      "div",
+      { class: "usage" },
+      h("div", { class: "usage-bar", "aria-hidden": "true" }, parts.map((p) => h("i", { class: p.cls, style: `flex-grow:${p.n}` }))),
+      parts.map((p) =>
+        h(
+          "div",
+          { class: "usage-row", title: `${exact(p.n)} tokens` },
+          h("span", { class: `usage-dot ${p.cls}` }),
+          h("span", { class: "usage-name" }, p.label, p.key === "output" && total.reasoning ? h("small", {}, `含推理 ${fmtCount(total.reasoning)}`) : null),
+          h("span", { class: "usage-num" }, fmtCount(p.n)),
+          h("span", { class: "usage-pct" }, pct(p.n, tokens)),
+        ),
+      ),
+    );
+
+    const agentName = (id) => S.agents.find((a) => a.id === id)?.label ?? id;
+    const byAgent = groupBy(rows, (r) => r.agent).map((g) => ({ ...g, label: agentName(g.key) }));
+    const byModel = groupBy(rows, (r) => r.model ?? "").map((g) => ({ ...g, label: g.key || "未记录模型" }));
+    const byUser = data.admin
+      ? groupBy(rows, (r) => r.owner ?? "").map((g) => ({ ...g, label: g.key ? data.users[g.key] : "未归属（飞书等）" }))
+      : [];
+
+    fill(
+      box,
+      head,
+      tiles,
+      period.buckets ? trend(period, rows) : null,
+      h("h5", {}, "构成"),
+      composition,
+      h("h5", {}, "按 Agent"),
+      breakdown(byAgent, tokens),
+      h("h5", {}, "按模型"),
+      breakdown(byModel, tokens),
+      byUser.length > 1 || (byUser.length === 1 && byUser[0].key) ? [h("h5", {}, "按用户"), breakdown(byUser, tokens)] : null,
+      note,
+    );
+  };
+  await render();
+}
+
+function tile(label, value, title) {
+  return h("div", { class: "us-tile", title }, h("span", {}, label), h("b", {}, value));
+}
+
+function pct(n, total) {
+  const p = (n / total) * 100;
+  return p > 0 && p < 1 ? "<1%" : `${Math.round(p)}%`;
+}
+
+/** 趋势：月视图每天一根，年视图每月一根。悬停看具体数字 */
+function trend(period, rows) {
+  const byKey = new Map();
+  for (const r of rows) {
+    const k = r.day.slice(0, period.slice);
+    const t = byKey.get(k) ?? { tokens: 0, cost: 0 };
+    t.tokens += tokensOf(r);
+    t.cost += r.costUsd ?? 0;
+    byKey.set(k, t);
+  }
+  const max = Math.max(...[...byKey.values()].map((t) => t.tokens), 1);
+  const today = ymd(new Date()).slice(0, period.slice);
+  const n = period.buckets.length;
+  return h(
+    "div",
+    { class: "us-trend", role: "img", "aria-label": `${period.title}每${period.slice === 7 ? "月" : "天"}的 Token 用量` },
+    h(
+      "div",
+      { class: "us-bars", style: `grid-template-columns:repeat(${n},1fr)` },
+      period.buckets.map((b) => {
+        const t = byKey.get(b.key);
+        const tip = t ? `${b.label}　${exact(t.tokens)} tokens${t.cost ? `　约 ${fmtCost(t.cost)}` : ""}` : `${b.label}　没有用量`;
+        return h(
+          "div",
+          { class: `us-col${b.key > today ? " future" : ""}`, title: tip },
+          t ? h("i", { style: `height:${Math.max(2, (t.tokens / max) * 100)}%` }) : null,
+        );
+      }),
+    ),
+    h(
+      "div",
+      { class: "us-axis", style: `grid-template-columns:repeat(${n},1fr)` },
+      period.buckets.map((b, i) => {
+        // 月视图只标 1、5、10…号，免得挤
+        const show = period.slice === 7 || i === 0 || (i + 1) % 5 === 0;
+        return h("span", {}, show ? String(i + 1) : "");
+      }),
+    ),
+    h("div", { class: "us-max" }, `最高 ${fmtCount(max)}`),
+  );
+}
+
+function breakdown(groups, tokens) {
+  return h(
+    "div",
+    { class: "us-list" },
+    groups.map((g) => {
+      const n = tokensOf(g);
+      return h(
+        "div",
+        { class: "us-item", title: `${exact(n)} tokens` },
+        h("span", { class: "us-name" }, g.label),
+        h("span", { class: "us-meter", "aria-hidden": "true" }, h("i", { style: `width:${(n / tokens) * 100}%` })),
+        h("span", { class: "us-num" }, fmtCount(n)),
+        h("span", { class: "us-cost" }, g.costUsd ? fmtCost(g.costUsd) : "—"),
+      );
+    }),
+  );
+}

package/web/views/topbar.js

@@ -46,7 +46,7 @@ function topMenuItems() {
     const c = S.current ? S.convs.get(S.current) : null;
     const chat = (c ? (c.mode ?? "work") : S.draftMode) === "chat";
     items.push({ id: "mode", label: "聊天模式", icon: "chat", checked: chat, onclick: () => void toggleMode() });
-    items.push({ id: "schedule", label: "定时发送…", icon: "clock", onclick: () => openSchedule() });
+    items.push({ id: "schedule", label: "定时发送", icon: "clock", onclick: () => openSchedule() });
   }
   if (!desktopSettings) {
     if (items.length) items.push("sep");