@modelzen/feishu-codex-bridge 0.3.2 → 0.3.4

package/README.md

@@ -30,10 +30,11 @@
 - **流式卡片**：推理 / 命令 / 文件改动 / 结果实时刷新到一张可折叠卡片。
 - **免 @ 对话**：项目群话题内可直接说话、不必每次 @（可逐群开关）。
 - **文档评论回复（可选）**：在飞书云文档（doc/docx/sheet/file，含知识库 wiki）的评论里 **@机器人**，它会读评论、跑 Codex、把答案回到同一条评论线程里；每篇文档一条连续会话。需额外开通文档评论权限并订阅评论事件（见下方配置）。
-- **私聊控制台**：私聊机器人弹交互菜单 —— 新建项目、项目列表、设置、诊断、重连。
+- **私聊控制台**：私聊机器人弹交互菜单 —— 新建项目、项目列表、设置、用量、诊断、重连。
+- **📊 Codex 用量**：5 小时 / 7 天限额进度（剩余 % + 重置时间）、lifetime tokens、连续使用天数、GitHub 风格每日用量热力图；一键生成**战绩分享卡**，可原生转发给任何人或群（数据来自 Codex 个人资料页同款接口，需 ChatGPT 登录）。
 - **稳定隔离**：每会话独立 app-server 进程；卡死有 watchdog（默认 120s）→ 终止 → 回收，异常不波及其他群。
 - **本地加密密钥库**：飞书应用密钥用 AES-256-GCM 存在 `~/.feishu-codex-bridge/`，不入仓库、不进环境变量。
-- **跨平台常驻**：macOS / Windows / Linux·WSL 均可注册成后台服务、开机或登录自启（分别走 launchd / 登录自启免管理员 / systemd）。
+- **跨平台常驻**：macOS / Windows / Linux·WSL 均可注册成后台服务、开机或登录自启（分别走 launchd / 登录自启免管理员 / systemd）。注：跨平台指进程运行与后台自启；「项目内只读/读写」隐私沙箱仅 macOS / 原生 Windows 可强制（见[安全须知](#-安全须知)）。
 
 ---
 
@@ -41,7 +42,7 @@
 
 | 依赖 | 说明 | 获取方式 |
 |------|------|----------|
-| **操作系统** | **macOS / Windows** 均支持；Linux·WSL 为 best-effort（已实现 systemd，未广泛实测） | — |
+| **操作系统** | 运行/后台常驻：**macOS / Windows** 均支持，Linux·WSL 为 best-effort（已实现 systemd，未广泛实测）。注意：「项目内只读 / 读写」隐私档的沙箱强制仅 **macOS / 原生 Windows**，Linux·WSL 上这两档会 fail-closed 拒绝启动（见下方[安全须知](#-安全须知)） | — |
 | **Node.js ≥ 20** | 运行时 | <https://nodejs.org> 或 `nvm install 20` |
 | **Codex CLI** | 后端，bridge 会 spawn `codex app-server` | `npm i -g @openai/codex`，或装 Codex.app，或用 `CODEX_BIN` 指向已有二进制 |
 | **Codex 已登录** | app-server 需要 `~/.codex/auth.json` | `codex login` |
@@ -166,7 +167,8 @@ feishu-codex-bridge bot rm <名>     # 移除一个机器人配置
 - **话题 = 会话**：对某条消息开话题后，话题内可**免 @** 连续对话，是一条连贯的 Codex 会话。
 - **文档评论 @机器人**：在飞书文档评论里 @ 它就回（前提：已开通文档评论权限 + 订阅 `drive.notice.comment_add_v1`，且机器人对该文档有访问权限）。只支持 doc/docx/sheet/file；评论框不渲染 markdown，回复为纯文本，超长会截断。
 - **终止**：卡片上的 **⏹** 随时终止当前轮；卡死超过 watchdog 阈值（默认 120s）自动中止并回收进程。
-- **私聊控制台**：项目列表、设置（模型 / 推理强度 / 免 @ / watchdog / 管理员）、诊断、重连，全在私聊菜单里。
+- **私聊控制台**：项目列表、设置（模型 / 推理强度 / 免 @ / watchdog / 管理员）、用量、诊断、重连，全在私聊菜单里。
+- **📊 用量**：点「用量」看 5h/7d 限额（剩余 % + 重置时间）与 Codex 个人统计（lifetime tokens / streak / 每日热力图）；点「📤 生成分享卡」得到一张可转发的战绩卡——长按（手机）或右键（电脑）即可转发，数据定格在生成时刻。
 
 ---
 
@@ -241,17 +243,24 @@ src/
 
 ## ⚠️ 安全须知
 
-本机器人调用 Codex 时固定使用 **`approvalPolicy: "never"` + `sandbox: "danger-full-access"`** —— 即 **无任何人工审批、对磁盘完全访问**。这意味着：
+机器人调用 Codex 始终是 **`approvalPolicy: "never"`**（无人工逐条审批），**沙箱就是唯一的安全闸门**。每个项目有一档**权限**，在私聊控制台「📁 项目列表 → ⚙️ 设置 → 🔐 权限」里用下拉框选择后提交：
 
-> **任何能在项目群里给机器人发消息的人，都能在你这台机器上、以你的身份、在该项目目录里执行任意命令（读写文件、联网、运行脚本）。**
+| 档位 | 能读 | 能写 | 适用 |
+|------|------|------|------|
+| 🔒 **项目内只读** | 仅项目文件夹 | ✗ | 外部群 / 不可信场景的问答机器人 |
+| ✏️ **项目内读写** | 仅项目文件夹 | 仅项目文件夹 | 自己的编码项目，但禁止它碰机器其余部分 |
+| ⚠️ **完全访问** | 整台电脑 | 整台电脑 | 完全信任、你自己掌控的机器 |
 
-因此：
-
-- 只把**你信任的人**拉进项目群；
-- 在**你自己掌控的机器/账号**上运行，最好是隔离的开发机或容器；
-- 绑定的项目目录里不要放你不愿被读写的敏感数据；
+- **管理员 / 普通用户可分设**：🔐 权限里有「管理员档」和「普通用户档」两个下拉。两档**不同**时，管理员与群里其他人**各用独立的 Codex 线程**（互不串沙箱、也互不串对话历史）——典型：外部群里管理员 `完全访问`、其他人 `项目内只读`。两档**相同** = 所有人一致（默认）。
+- **默认值**：你自己新建的项目群 = `完全访问`（与历史行为一致）；**别人把机器人拉进的存量/外部群** = `项目内只读`；普通用户档默认**同管理员档**（不分档）。**升级前没有 `mode` 字段的老项目按 `完全访问` 处理**，行为不变。
+- 🔒/✏️ 靠 Codex 的自定义 permissions 档把读写都**锁死在项目文件夹内**（读不到 `~/.ssh`、`/etc` 等），由操作系统沙箱强制：**macOS（Seatbelt）与原生 Windows（restricted token）可强制**，其中 Windows 需 Codex 以 elevated 沙箱运行、否则它会**拒绝执行**（仍不泄漏）。**Linux / WSL 无法强制读限定**（沙箱只挡写、不限读，Landlock 读限制尚未实现，WSL 等同 Linux）——在这些平台选 🔒/✏️ 会被**直接拒绝启动（fail-closed），绝不静默降级为完全访问**；要在 Linux/WSL 用，请把 Codex 跑在容器/隔离环境里。
+  > Windows 上的强制是 Codex 自己做的，请先在真机自测一次（让机器人读项目文件夹外的文件，应被拒）再用于真实外部群。
+- ⚠️ `完全访问` 档意味着：**任何能给机器人发消息的人，都能在你这台机器上、以你的身份执行任意命令（读写文件、联网、跑脚本）**。这一档只把**你信任的人**拉进群，在**你自己掌控的隔离机器**上跑，目录里别放不愿被读写的敏感数据。
+- 「联网」是档位之外的独立开关，只影响它执行的 shell 命令能否上网，不影响模型本身和 Codex 自带的联网搜索。
 - 它不是多租户托管服务，是给你（和你信任的小团队）自用的桥。
 
+> 把机器人拉进**外部群**做只读问答前，先在飞书开发者后台开启应用的「可被添加到外部群 / 外部可用范围」，再由群里的真人手动把机器人加进群（机器人无法自行加入）。
+
 ---
 
 ## ❓ 故障排查

package/dist/cli.js

@@ -1442,7 +1442,28 @@ function mapItemComplete(item) {
 
 // src/agent/codex-appserver/backend.ts
 var APPROVAL_POLICY = "never";
-var SANDBOX = "danger-full-access";
+function sandboxParams(mode, network) {
+  if ((mode ?? "full") === "full") return { sandbox: "danger-full-access" };
+  if (process.platform !== "darwin" && process.platform !== "win32") {
+    throw new Error(
+      "\u300C\u9879\u76EE\u5185\u53EA\u8BFB / \u9879\u76EE\u5185\u8BFB\u5199\u300D\u9760\u64CD\u4F5C\u7CFB\u7EDF\u6C99\u7BB1\u628A\u8BFB\u5199\u9501\u8FDB\u9879\u76EE\u6587\u4EF6\u5939\uFF0C\u76EE\u524D\u53EA\u6709 macOS \u4E0E\u539F\u751F Windows \u80FD\u5F3A\u5236\u6267\u884C\u3002\u5F53\u524D\u5E73\u53F0\uFF08Linux / WSL \u53EA\u6321\u5199\u3001\u4E0D\u9650\u5236\u8BFB\u53D6\uFF0C\u65E0\u6CD5\u4FDD\u8BC1\u4E0D\u6CC4\u9732\u9690\u79C1\uFF09\u5DF2\u62D2\u7EDD\u542F\u52A8\uFF08\u7EDD\u4E0D\u964D\u7EA7\u4E3A\u5B8C\u5168\u8BBF\u95EE\uFF09\u3002\u8BF7\u6539\u7528\u300C\u5B8C\u5168\u8BBF\u95EE\u300D\u3001\u628A Codex \u8DD1\u8FDB\u5BB9\u5668/\u9694\u79BB\u73AF\u5883\uFF0C\u6216\u5728 macOS / Windows \u4E0A\u8FD0\u884C\u3002"
+    );
+  }
+  return {
+    config: {
+      default_permissions: "feishu",
+      permissions: {
+        feishu: {
+          filesystem: {
+            ":minimal": "read",
+            ":workspace_roots": { ".": mode === "write" ? "write" : "read" }
+          },
+          network: { enabled: Boolean(network) }
+        }
+      }
+    }
+  };
+}
 var BRIDGE_DEVELOPER_INSTRUCTIONS = [
   "\u4F60\u73B0\u5728\u901A\u8FC7\u300C\u98DE\u4E66\u6865\u300D\u4E0E\u7528\u6237\u5BF9\u8BDD\uFF1A\u4F60\u7684\u56DE\u590D\u4F1A\u88AB\u6E32\u67D3\u6210\u98DE\u4E66\u6D88\u606F\u3002\u8BF7\u9075\u5B88\u4E24\u6761\u8F93\u51FA\u7EA6\u5B9A\u3002",
   "",
@@ -1627,23 +1648,25 @@ var CodexAppServerBackend = class {
     }
   }
   async startThread(opts) {
+    const sandbox = sandboxParams(opts.mode, opts.network);
     const client = await this.spawn(opts.cwd);
     const res = await client.request("thread/start", {
       cwd: opts.cwd,
       approvalPolicy: APPROVAL_POLICY,
-      sandbox: SANDBOX,
+      ...sandbox,
       developerInstructions: BRIDGE_DEVELOPER_INSTRUCTIONS,
       ...opts.model ? { model: opts.model } : {}
     });
     return new CodexThread(client, res.thread.id, opts.model, opts.effort);
   }
   async resumeThread(opts) {
+    const sandbox = sandboxParams(opts.mode, opts.network);
     const client = await this.spawn(opts.cwd);
     const res = await client.request("thread/resume", {
       threadId: opts.codexThreadId,
       cwd: opts.cwd,
       approvalPolicy: APPROVAL_POLICY,
-      sandbox: SANDBOX,
+      ...sandbox,
       developerInstructions: BRIDGE_DEVELOPER_INSTRUCTIONS,
       ...opts.model ? { model: opts.model } : {}
     });
@@ -2049,6 +2072,7 @@ var RunRender = class {
 // src/card/cards.ts
 function card(elements, opts = {}) {
   const config = { update_multi: true };
+  if (opts.forward === false) config.enable_forward = false;
   if (opts.streaming) {
     config.streaming_mode = true;
     config.streaming_config = {
@@ -2194,6 +2218,7 @@ function selectMenu(opts) {
     tag: "select_static",
     name: opts.name,
     placeholder: { tag: "plain_text", content: opts.placeholder },
+    ...opts.initial ? { initial_option: opts.initial } : {},
     options: opts.options.map((o) => ({ text: { tag: "plain_text", content: o.label }, value: o.value }))
   };
 }
@@ -3138,6 +3163,21 @@ import { dirname as dirname5 } from "path";
 function defaultNoMention(p) {
   return !((p.origin ?? "created") === "joined" && (p.kind ?? "multi") === "single");
 }
+function effectiveMode(p) {
+  return p.mode ?? "full";
+}
+function effectiveGuestMode(p) {
+  return p.guestMode ?? effectiveMode(p);
+}
+function turnTier(p, isAdminSender) {
+  const adminTier = effectiveMode(p);
+  const guestTier = effectiveGuestMode(p);
+  return {
+    mode: isAdminSender ? adminTier : guestTier,
+    role: isAdminSender ? "admin" : "guest",
+    split: guestTier !== adminTier
+  };
+}
 var FILE_VERSION2 = 1;
 async function read() {
   try {
@@ -3229,6 +3269,12 @@ var DM = {
   reconnect: "dm.reconnect",
   update: "dm.update",
   updateDo: "dm.update.do",
+  // 📊 Codex 用量（限额 + 个人资料统计 + 热力图）；share 打开内容选择卡，
+  // shareDo 按所选区块生成可转发的分享卡
+  usage: "dm.usage",
+  usageRefresh: "dm.usage.refresh",
+  usageShare: "dm.usage.share",
+  usageShareDo: "dm.usage.share.do",
   rmConfirm: "dm.rmConfirm",
   rmDo: "dm.rmDo",
   rmCancel: "dm.rmCancel",
@@ -3247,7 +3293,10 @@ var DM = {
   rmAllowed: "dm.allow.rm",
   // 项目设置容器（项目列表 / 建项目完成卡 进入），以后的项目级设置项往这里加
   projectSettings: "dm.projectSettings",
-  setNoMentionDm: "dm.proj.noMention"
+  setNoMentionDm: "dm.proj.noMention",
+  // 🔐 权限：codex 沙箱档位（管理员档 + 普通用户档）+ 联网，做成下拉表单（选+提交）
+  permission: "dm.proj.perm",
+  permissionSubmit: "dm.proj.perm.submit"
 };
 var GS = {
   setNoMention: "gs.noMention"
@@ -3266,6 +3315,7 @@ function buildDmMenuCard() {
         button("\u2699\uFE0F \u8BBE\u7F6E", { a: DM.settings })
       ]),
       actions([
+        button("\u{1F4CA} \u7528\u91CF", { a: DM.usage }),
         button("\u{1FA7A} \u8BCA\u65AD", { a: DM.doctor }),
         button("\u{1F504} \u91CD\u8FDE", { a: DM.reconnect }),
         button("\u2B06\uFE0F \u7248\u672C\u66F4\u65B0", { a: DM.update })
@@ -3689,6 +3739,56 @@ function buildAddAdminCard(members) {
     { header: { title: "\u2795 \u6DFB\u52A0\u7BA1\u7406\u5458", template: "blue" } }
   );
 }
+var MODE_OPTS = [
+  { value: "qa", label: "\u{1F512} \u9879\u76EE\u5185\u53EA\u8BFB", desc: "\u53EA\u80FD\u67E5\u770B\u9879\u76EE\u6587\u4EF6\u5939\u91CC\u7684\u5185\u5BB9\uFF0C\u4E0D\u4F1A\u6539\u4EFB\u4F55\u6587\u4EF6" },
+  { value: "write", label: "\u270F\uFE0F \u9879\u76EE\u5185\u8BFB\u5199", desc: "\u80FD\u67E5\u770B\u5E76\u4FEE\u6539\u9879\u76EE\u6587\u4EF6\u5939\u91CC\u7684\u6587\u4EF6\uFF0C\u4F46\u78B0\u4E0D\u5230\u6587\u4EF6\u5939\u5916" },
+  { value: "full", label: "\u26A0\uFE0F \u5B8C\u5168\u8BBF\u95EE", desc: "\u80FD\u8BFB\u5199\u6574\u53F0\u7535\u8111\u4E0A\u7684\u4EFB\u4F55\u6587\u4EF6" }
+];
+function tierLabel(m) {
+  return MODE_OPTS.find((o) => o.value === m)?.label ?? m;
+}
+var TIER_SELECT_OPTS = MODE_OPTS.map((o) => ({ label: `${o.label} \u2014 ${o.desc}`, value: o.value }));
+function permissionSummary(p) {
+  const admin = effectiveMode(p);
+  const guest = effectiveGuestMode(p);
+  return admin === guest ? `\u6240\u6709\u4EBA\uFF1A${tierLabel(admin)}` : `\u7BA1\u7406\u5458\uFF1A${tierLabel(admin)}\u3000\xB7\u3000\u5176\u4ED6\u4EBA\uFF1A${tierLabel(guest)}`;
+}
+function buildPermissionCard(p) {
+  const network = p.network ?? false;
+  return card(
+    [
+      md(`**\u{1F510} \u6743\u9650** \xB7 ${p.name}`),
+      note(
+        "codex \u6C99\u7BB1\u7684\u8BBF\u95EE\u8303\u56F4\u3002\u300C\u7BA1\u7406\u5458\u6863\u300D\u7ED9 owner / \u7BA1\u7406\u5458\uFF0C\u300C\u666E\u901A\u7528\u6237\u6863\u300D\u7ED9\u7FA4\u91CC\u5176\u4ED6\u4EBA\u3002\u4E24\u6863**\u4E0D\u540C**\u65F6\uFF0C\u4E24\u7C7B\u4EBA\u5404\u7528\u72EC\u7ACB\u7EBF\u7A0B\uFF08\u4E92\u4E0D\u4E32\u6C99\u7BB1\u4E0E\u5BF9\u8BDD\u5386\u53F2\uFF09\uFF1B**\u76F8\u540C**\u5219\u6240\u6709\u4EBA\u4E00\u81F4\u3002"
+      ),
+      form("perm", [
+        md("\u{1F451} **\u7BA1\u7406\u5458\u6863**"),
+        selectMenu({ name: "mode", placeholder: "\u9009\u62E9\u7BA1\u7406\u5458\u6743\u9650\u6863", options: TIER_SELECT_OPTS, initial: effectiveMode(p) }),
+        md("\u{1F465} **\u666E\u901A\u7528\u6237\u6863**"),
+        selectMenu({
+          name: "guestMode",
+          placeholder: "\u9009\u62E9\u666E\u901A\u7528\u6237\u6743\u9650\u6863",
+          options: TIER_SELECT_OPTS,
+          initial: effectiveGuestMode(p)
+        }),
+        md("\u{1F310} **\u8054\u7F51**\uFF08\u53EA\u5BF9\u53EA\u8BFB / \u8BFB\u5199\u6863\u6709\u610F\u4E49\uFF1B\u5B8C\u5168\u8BBF\u95EE\u6052\u8054\u7F51\uFF09"),
+        selectMenu({
+          name: "network",
+          placeholder: "\u8054\u7F51\u5F00\u5173",
+          options: [
+            { label: "\u5173\uFF08\u9ED8\u8BA4\uFF0C\u66F4\u5B89\u5168\uFF09", value: "off" },
+            { label: "\u5F00", value: "on" }
+          ],
+          initial: network ? "on" : "off"
+        }),
+        actions([submitButton("\u2705 \u4FDD\u5B58\u6743\u9650", { a: DM.permissionSubmit, n: p.name }, "primary", "submit_perm")])
+      ]),
+      note("\u4FDD\u5B58\u4F1A\u65AD\u5F00\u672C\u9879\u76EE\u6B63\u5728\u8FDB\u884C\u7684\u4F1A\u8BDD\uFF0C\u8BA9\u65B0\u6863\u4F4D\u7ACB\u5373\u751F\u6548\u3002"),
+      actions([button("\u2B05\uFE0F \u8FD4\u56DE\u8BBE\u7F6E", { a: DM.projectSettings, n: p.name })])
+    ],
+    { header: { title: "\u{1F510} \u6743\u9650", template: "blue" } }
+  );
+}
 function buildProjectSettingsCard(project) {
   const kind = project.kind ?? "multi";
   const noMention = project.noMention ?? defaultNoMention(project);
@@ -3697,6 +3797,9 @@ function buildProjectSettingsCard(project) {
       md(`**\u9879\u76EE\u8BBE\u7F6E** \xB7 ${project.name}`),
       note(`${kindLabel(kind)}${project.cwd ? `   \xB7   \u{1F4C2} \`${project.cwd}\`` : ""}`),
       hr(),
+      actions([button("\u{1F510} \u6743\u9650", { a: DM.permission, n: project.name }, "primary")]),
+      note(`\u5F53\u524D ${permissionSummary(project)}\u3000\xB7\u3000codex \u6C99\u7BB1\u53EF\u8BBF\u95EE\u7684\u8303\u56F4\uFF08\u7BA1\u7406\u5458 / \u666E\u901A\u7528\u6237\u53EF\u5206\u8BBE\uFF09\u3002`),
+      hr(),
       md("\u270B \u514D@\uFF08\u4E0D\u7528 @ \u4E5F\u56DE\u590D\uFF09"),
       actions([
         button("\u5F00", { a: DM.setNoMentionDm, v: "on", n: project.name }, noMention ? "primary" : "default"),
@@ -4382,10 +4485,615 @@ async function restartDaemon() {
   await getServiceAdapter().restart();
 }
 
+// src/agent/codex-appserver/usage.ts
+import { readFile as readFile8 } from "fs/promises";
+import { homedir as homedir5 } from "os";
+import { join as join12 } from "path";
+var DEFAULT_BASE_URL = "https://chatgpt.com/backend-api";
+var HTTP_TIMEOUT_MS = 15e3;
+var REFRESH_TIMEOUT_MS = 2e4;
+var EXP_SKEW_MS = 6e4;
+var PROFILE_CACHE_MS = 5 * 6e4;
+var USAGE_CACHE_MS = 3e4;
+var UsageError = class extends Error {
+  constructor(kind, message) {
+    super(message);
+    this.kind = kind;
+    this.name = "UsageError";
+  }
+  kind;
+};
+function resolveCodexHome() {
+  return process.env.CODEX_HOME ?? join12(homedir5(), ".codex");
+}
+async function readCodexAuth() {
+  const file = join12(resolveCodexHome(), "auth.json");
+  let lastErr;
+  for (let i = 0; i < 3; i++) {
+    let raw;
+    try {
+      raw = await readFile8(file, "utf8");
+    } catch (err) {
+      throw new UsageError("no-auth", `\u8BFB\u4E0D\u5230 ${file}\uFF1A${err instanceof Error ? err.message : String(err)}`);
+    }
+    try {
+      const j = JSON.parse(raw);
+      const accessToken = j.tokens?.access_token;
+      if (!accessToken) throw new UsageError("api-key-mode", "auth.json \u6CA1\u6709 ChatGPT access_token\uFF08API-key \u767B\u5F55\u6A21\u5F0F\uFF09");
+      return { accessToken, accountId: j.tokens?.account_id, lastRefresh: j.last_refresh };
+    } catch (err) {
+      if (err instanceof UsageError) throw err;
+      lastErr = err;
+      await new Promise((r) => setTimeout(r, 100));
+    }
+  }
+  throw new UsageError("no-auth", `auth.json \u53CD\u590D\u89E3\u6790\u5931\u8D25\uFF1A${lastErr instanceof Error ? lastErr.message : String(lastErr)}`);
+}
+function jwtExpMs(token) {
+  const part = token.split(".")[1];
+  if (!part) return void 0;
+  try {
+    const payload = JSON.parse(Buffer.from(part, "base64url").toString("utf8"));
+    return typeof payload.exp === "number" ? payload.exp * 1e3 : void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function chatgptBaseUrl() {
+  try {
+    const raw = await readFile8(join12(resolveCodexHome(), "config.toml"), "utf8");
+    for (const line of raw.split("\n")) {
+      const t = line.trim();
+      if (t.startsWith("[")) break;
+      const m = /^chatgpt_base_url\s*=\s*"([^"]+)"/.exec(t);
+      if (m?.[1]) return m[1].replace(/\/+$/, "");
+    }
+  } catch {
+  }
+  return DEFAULT_BASE_URL;
+}
+var refreshInFlight = null;
+async function refreshViaAppServer() {
+  if (refreshInFlight) return refreshInFlight;
+  refreshInFlight = (async () => {
+    const before = await readCodexAuth().catch(() => void 0);
+    const bin = resolveCodexBin();
+    if (!bin) return null;
+    const client = new AppServerClient({ bin, cwd: process.cwd(), clientName: "feishu-codex-bridge-usage" });
+    let account = void 0;
+    try {
+      await withDeadline2(client.connect(), REFRESH_TIMEOUT_MS, "usage-refresh connect");
+      const res = await withDeadline2(
+        client.request("account/read", { refreshToken: true }),
+        REFRESH_TIMEOUT_MS,
+        "account/read refresh"
+      );
+      account = res?.account;
+    } catch (err) {
+      log.fail("usage", err, { phase: "refresh" });
+      return null;
+    } finally {
+      await client.close().catch(() => void 0);
+    }
+    const after = await readCodexAuth().catch(() => void 0);
+    if (after && after.accessToken !== before?.accessToken) return after;
+    if (account === null) return "permanent-failure";
+    return null;
+  })();
+  try {
+    return await refreshInFlight;
+  } finally {
+    refreshInFlight = null;
+  }
+}
+function withDeadline2(p, ms, label) {
+  return new Promise((resolve7, reject) => {
+    const t = setTimeout(() => reject(new Error(`${label} timed out after ${ms}ms`)), ms);
+    p.then(
+      (v) => {
+        clearTimeout(t);
+        resolve7(v);
+      },
+      (e) => {
+        clearTimeout(t);
+        reject(e);
+      }
+    );
+  });
+}
+async function fetchWham(base, path, auth) {
+  const ctl = new AbortController();
+  const t = setTimeout(() => ctl.abort(), HTTP_TIMEOUT_MS);
+  try {
+    const resp = await fetch(`${base}${path}`, {
+      headers: {
+        Authorization: `Bearer ${auth.accessToken}`,
+        ...auth.accountId ? { "ChatGPT-Account-Id": auth.accountId } : {},
+        "User-Agent": "codex-cli"
+      },
+      signal: ctl.signal
+    });
+    if (!resp.ok) return { status: resp.status };
+    return { status: resp.status, json: await resp.json() };
+  } finally {
+    clearTimeout(t);
+  }
+}
+async function whamGet(path) {
+  let auth = await readCodexAuth();
+  const exp = jwtExpMs(auth.accessToken);
+  if (exp !== void 0 && exp <= Date.now() + EXP_SKEW_MS) {
+    const refreshed = await refreshViaAppServer();
+    if (refreshed === "permanent-failure") throw new UsageError("need-relogin", "Codex \u767B\u5F55\u6001\u5DF2\u5931\u6548");
+    if (refreshed) auth = refreshed;
+    else throw new UsageError("transient", "\u767B\u5F55\u6001\u4E34\u671F\u4E14\u6682\u65F6\u65E0\u6CD5\u5237\u65B0");
+  }
+  const base = await chatgptBaseUrl();
+  const attempt = async (a) => {
+    try {
+      return await fetchWham(base, path, a);
+    } catch (err) {
+      throw new UsageError("transient", `\u8BF7\u6C42\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}`);
+    }
+  };
+  let res = await attempt(auth);
+  if (res.status === 401) {
+    const fresh = await readCodexAuth();
+    if (fresh.accessToken !== auth.accessToken) {
+      auth = fresh;
+      res = await attempt(auth).catch(() => res);
+    }
+  }
+  if (res.status === 401) {
+    const refreshed = await refreshViaAppServer();
+    if (refreshed === "permanent-failure" || refreshed === null) {
+      throw refreshed === null ? new UsageError("transient", "\u6682\u65F6\u65E0\u6CD5\u5237\u65B0 Codex \u767B\u5F55\u6001") : new UsageError("need-relogin", "Codex \u767B\u5F55\u6001\u5DF2\u5931\u6548");
+    }
+    res = await attempt(refreshed);
+    if (res.status === 401) throw new UsageError("need-relogin", "\u5237\u65B0\u540E\u4ECD 401\uFF0C\u8D26\u53F7\u4FA7\u5DF2\u62D2\u7EDD");
+  }
+  if (res.json === void 0) throw new UsageError("transient", `HTTP ${res.status} (${path})`);
+  return res.json;
+}
+function mapWindow(w) {
+  if (!w || typeof w.used_percent !== "number") return void 0;
+  return {
+    usedPercent: Math.min(100, Math.max(0, w.used_percent)),
+    windowSeconds: w.limit_window_seconds,
+    resetAt: w.reset_at
+  };
+}
+function mapUsageResponse(raw, fetchedAt) {
+  const mapBucket = (rl, name) => ({
+    ...name ? { name } : {},
+    primary: mapWindow(rl?.primary_window),
+    secondary: mapWindow(rl?.secondary_window)
+  });
+  return {
+    planType: raw.plan_type,
+    main: mapBucket(raw.rate_limit),
+    extras: (raw.additional_rate_limits ?? []).filter((x) => x?.rate_limit).map((x) => mapBucket(x.rate_limit, x.limit_name)),
+    fetchedAt
+  };
+}
+function mapProfileResponse(raw) {
+  const s = raw.stats ?? {};
+  return {
+    // 只用 display_name，绝不兜底 username——后者是邮箱 local part，会随可转发的
+    // 分享卡泄出去；display_name 缺失时卡片侧降级「我的」。
+    displayName: raw.profile?.display_name || void 0,
+    lifetimeTokens: s.lifetime_tokens,
+    peakDailyTokens: s.peak_daily_tokens,
+    currentStreakDays: s.current_streak_days,
+    longestStreakDays: s.longest_streak_days,
+    longestTurnSec: s.longest_running_turn_sec,
+    totalThreads: s.total_threads,
+    fastModePct: s.fast_mode_usage_percentage,
+    totalSkillsUsed: s.total_skills_used,
+    uniqueSkillsUsed: s.unique_skills_used,
+    mostUsedEffort: s.most_used_reasoning_effort,
+    mostUsedEffortPct: s.most_used_reasoning_effort_percentage,
+    topInvocations: (s.top_invocations ?? []).map((t) => ({
+      name: t.plugin_name ?? t.skill_name ?? "",
+      count: t.usage_count ?? 0,
+      kind: t.plugin_name ? "plugin" : "skill"
+    })).filter((t) => t.name),
+    dailyBuckets: (s.daily_usage_buckets ?? []).filter((b) => typeof b.start_date === "string").map((b) => ({ date: b.start_date, tokens: b.tokens ?? 0 })),
+    statsAsOf: raw.metadata?.stats_as_of
+  };
+}
+var profileCache = null;
+var usageCache = null;
+async function fetchProfileStats(force = false) {
+  if (!force && profileCache && Date.now() - profileCache.at < PROFILE_CACHE_MS) return profileCache.data;
+  const raw = await whamGet("/wham/profiles/me");
+  const data = mapProfileResponse(raw);
+  profileCache = { at: Date.now(), data };
+  return data;
+}
+async function fetchUsageSnapshot(force = false) {
+  if (!force && usageCache && Date.now() - usageCache.at < USAGE_CACHE_MS) return usageCache.data;
+  const raw = await whamGet("/wham/usage");
+  const data = mapUsageResponse(raw, Date.now());
+  usageCache = { at: Date.now(), data };
+  return data;
+}
+async function fetchUsageBundle(force = false) {
+  const [profile, usage] = await Promise.all([fetchProfileStats(force), fetchUsageSnapshot(force)]);
+  return { profile, usage };
+}
+
+// src/card/usage-cards.ts
+function formatTokensZh(n) {
+  if (n === void 0 || n === null || Number.isNaN(n)) return "\u2014";
+  const fmt = (v) => {
+    const s = v.toFixed(1);
+    return s.endsWith(".0") ? s.slice(0, -2) : s;
+  };
+  if (n >= 1e8) return `${fmt(n / 1e8)}\u4EBF`;
+  if (n >= 1e4) {
+    const s = fmt(n / 1e4);
+    return s === "10000" ? "1\u4EBF" : `${s}\u4E07`;
+  }
+  return n.toLocaleString("en-US");
+}
+function windowLabel(seconds) {
+  if (!seconds) return "\u9650\u989D";
+  if (seconds === 18e3) return "5 \u5C0F\u65F6";
+  if (seconds === 604800) return "7 \u5929";
+  return seconds < 86400 ? `${Math.round(seconds / 3600)} \u5C0F\u65F6` : `${Math.round(seconds / 86400)} \u5929`;
+}
+function resetLabel(resetAtSec, nowMs2 = Date.now()) {
+  const d = new Date(resetAtSec * 1e3);
+  const hm = `${String(d.getHours()).padStart(2, "0")}:${String(d.getMinutes()).padStart(2, "0")}`;
+  const dayKey = (x) => `${x.getFullYear()}-${x.getMonth()}-${x.getDate()}`;
+  const now = new Date(nowMs2);
+  if (dayKey(d) === dayKey(now)) return `\u4ECA\u5929 ${hm}`;
+  const tomorrow = new Date(nowMs2 + 864e5);
+  if (dayKey(d) === dayKey(tomorrow)) return `\u660E\u5929 ${hm}`;
+  return `${d.getMonth() + 1}\u6708${d.getDate()}\u65E5 ${hm}`;
+}
+function localDateStr(d = /* @__PURE__ */ new Date()) {
+  return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+}
+function toEpochDay(date) {
+  const [y = 1970, m = 1, d = 1] = date.split("-").map(Number);
+  return Date.UTC(y, m - 1, d) / 864e5;
+}
+function fromEpochDay(day) {
+  const d = new Date(day * 864e5);
+  return `${d.getUTCFullYear()}-${String(d.getUTCMonth() + 1).padStart(2, "0")}-${String(d.getUTCDate()).padStart(2, "0")}`;
+}
+function mondayOf(day) {
+  const dow = new Date(day * 864e5).getUTCDay();
+  return day - (dow + 6) % 7;
+}
+var DAY_LABELS = ["\u4E00", "\u4E8C", "\u4E09", "\u56DB", "\u4E94", "\u516D", "\u65E5"];
+function heatmapCells(buckets, today = localDateStr(), weeks = 14) {
+  const todayDay = toEpochDay(today);
+  const tokensByDay = /* @__PURE__ */ new Map();
+  for (const b of buckets) tokensByDay.set(toEpochDay(b.date), b.tokens);
+  const startMonday = mondayOf(todayDay) - (weeks - 1) * 7;
+  const weekLabel = (c) => {
+    const d = new Date((startMonday + c * 7) * 864e5);
+    return `${d.getUTCMonth() + 1}/${d.getUTCDate()}`;
+  };
+  const values = [];
+  for (let c = 0; c < weeks; c++) {
+    for (let r = 0; r < 7; r++) {
+      const day = startMonday + c * 7 + r;
+      if (day > todayDay) continue;
+      const v = tokensByDay.get(day) ?? 0;
+      const d = new Date(day * 864e5);
+      const date = `${d.getUTCMonth() + 1}\u6708${d.getUTCDate()}\u65E5`;
+      const label = v > 0 ? `${date} \u4F7F\u7528\u4E86 ${formatTokensZh(v)} Token` : `${date} \u65E0\u7528\u91CF`;
+      values.push({ week: weekLabel(c), day: DAY_LABELS[r] ?? "", value: v, label });
+    }
+  }
+  return { values, startDate: fromEpochDay(startMonday), endDate: today, weeks };
+}
+var HEAT_RANGE = ["#ebedf0", "#bbdefb", "#64b5f6", "#1e88e5", "#0d47a1"];
+var ROUNDED_CELL = "M -0.5 -0.25 Q -0.5 -0.5 -0.25 -0.5 L 0.25 -0.5 Q 0.5 -0.5 0.5 -0.25 L 0.5 0.25 Q 0.5 0.5 0.25 0.5 L -0.25 0.5 Q -0.5 0.5 -0.5 0.25 Z";
+function heatmapChartEl(buckets, today) {
+  const h = heatmapCells(buckets, today);
+  return {
+    tag: "chart",
+    aspect_ratio: "2:1",
+    chart_spec: {
+      type: "common",
+      padding: 4,
+      data: [{ id: "usage", values: h.values }],
+      series: [
+        {
+          type: "heatmap",
+          xField: "week",
+          yField: "day",
+          valueField: "label",
+          cell: { style: { fill: { field: "value", scale: "color" }, shape: ROUNDED_CELL } }
+        }
+      ],
+      color: { type: "linear", domain: [{ dataId: "usage", fields: ["value"] }], range: HEAT_RANGE },
+      axes: [
+        {
+          orient: "bottom",
+          type: "band",
+          bandPadding: 0.25,
+          domainLine: { visible: false },
+          tick: { visible: false }
+        },
+        {
+          orient: "left",
+          type: "band",
+          bandPadding: 0.25,
+          domainLine: { visible: false },
+          tick: { visible: false },
+          label: { visible: false }
+        }
+      ],
+      legends: { visible: false },
+      tooltip: { visible: true, mark: { title: { visible: false } } }
+    }
+  };
+}
+function planLabel(plan) {
+  if (!plan) return void 0;
+  const m = {
+    free: "Free",
+    go: "Go",
+    plus: "Plus",
+    pro: "Pro",
+    prolite: "Pro Lite",
+    team: "Team",
+    business: "Business",
+    enterprise: "Enterprise",
+    edu: "Edu",
+    education: "Edu"
+  };
+  return m[plan] ?? plan.charAt(0).toUpperCase() + plan.slice(1);
+}
+function formatDurationZh(seconds) {
+  if (seconds === void 0 || seconds === null || Number.isNaN(seconds) || seconds < 0) return "\u2014";
+  const mins = Math.round(seconds / 60);
+  if (mins < 60) return `${mins} \u5206`;
+  const h = Math.floor(mins / 60);
+  const rem = mins % 60;
+  return rem ? `${h} \u5C0F\u65F6 ${rem} \u5206` : `${h} \u5C0F\u65F6`;
+}
+var remainingPct = (w) => Math.max(0, 100 - w.usedPercent);
+function progressChartEl(w) {
+  const label = `${windowLabel(w.windowSeconds)}\u5269\u4F59`;
+  return {
+    tag: "chart",
+    height: "40px",
+    chart_spec: {
+      type: "linearProgress",
+      data: [{ id: "p", values: [{ type: label, value: remainingPct(w) / 100 }] }],
+      xField: "value",
+      yField: "type",
+      cornerRadius: 8,
+      bandWidth: 12,
+      axes: [
+        { orient: "left", type: "band", visible: false },
+        { orient: "bottom", type: "linear", visible: false }
+      ],
+      tooltip: {
+        visible: true,
+        mark: { title: { visible: false }, content: [{ key: label, value: `${remainingPct(w)}%` }] }
+      }
+    }
+  };
+}
+function rateLimitElements(bucket, nowMs2) {
+  const out = [];
+  const icons = ["\u26A1", "\u{1F4C5}"];
+  [bucket.primary, bucket.secondary].forEach((w, i) => {
+    if (!w) return;
+    const reset = w.resetAt ? `\u3000<font color='grey'>${resetLabel(w.resetAt, nowMs2)} \u91CD\u7F6E</font>` : "";
+    out.push(md(`${icons[i]} **${windowLabel(w.windowSeconds)}\u9650\u989D**\u3000\u5269\u4F59 ${remainingPct(w)}%${reset}`));
+    out.push(progressChartEl(w));
+  });
+  if (!out.length) return [note("\u6682\u65E0\u9650\u989D\u6570\u636E")];
+  return out;
+}
+function statColumns(items) {
+  return {
+    tag: "column_set",
+    flex_mode: "flow",
+    horizontal_spacing: "large",
+    columns: items.map((it) => ({
+      tag: "column",
+      width: "auto",
+      elements: [
+        { tag: "markdown", content: `**${it.value}**`, text_size: "heading" },
+        noteMd(it.label)
+      ]
+    }))
+  };
+}
+function profileStatItems(p) {
+  return [
+    { value: formatTokensZh(p.lifetimeTokens), label: "\u7D2F\u8BA1 Token \u6570" },
+    { value: formatTokensZh(p.peakDailyTokens), label: "\u5CF0\u503C Token \u6570" },
+    { value: formatDurationZh(p.longestTurnSec), label: "\u6700\u957F\u4EFB\u52A1\u65F6\u957F" },
+    { value: p.currentStreakDays !== void 0 ? `${p.currentStreakDays} \u5929` : "\u2014", label: "\u5F53\u524D\u8FDE\u7EED\u5929\u6570" },
+    { value: p.longestStreakDays !== void 0 ? `${p.longestStreakDays} \u5929` : "\u2014", label: "\u6700\u957F\u8FDE\u7EED\u5929\u6570" }
+  ];
+}
+function heatmapElements(p, today) {
+  return [md("\u{1F4C8} **\u6BCF\u65E5 Token \u7528\u91CF**"), heatmapChartEl(p.dailyBuckets, today)];
+}
+function effortLabel(effort) {
+  const m = { minimal: "\u6781\u4F4E", low: "\u4F4E", medium: "\u4E2D", high: "\u9AD8", xhigh: "\u8D85\u9AD8" };
+  return m[effort] ?? effort;
+}
+function insightsElements(p) {
+  const left = [];
+  if (p.fastModePct !== void 0) left.push(`Fast Mode\u3000**${Math.round(p.fastModePct)}%**`);
+  if (p.mostUsedEffort) {
+    const pct = p.mostUsedEffortPct !== void 0 ? ` \xB7 ${Math.round(p.mostUsedEffortPct)}%` : "";
+    left.push(`\u6700\u5E38\u7528\u63A8\u7406\u3000**${effortLabel(p.mostUsedEffort)}${pct}**`);
+  }
+  if (p.uniqueSkillsUsed !== void 0) left.push(`\u4F7F\u7528\u8FC7\u7684\u6280\u80FD\u3000**${p.uniqueSkillsUsed}**`);
+  if (p.totalSkillsUsed !== void 0) left.push(`\u6280\u80FD\u8C03\u7528\u603B\u6570\u3000**${p.totalSkillsUsed.toLocaleString("en-US")}**`);
+  if (p.totalThreads !== void 0) left.push(`\u4F1A\u8BDD\u603B\u6570\u3000**${p.totalThreads.toLocaleString("en-US")}**`);
+  const right = p.topInvocations.slice(0, 5).map((t) => `${t.kind === "plugin" ? "@" : "$"}${t.name}\u3000**\xD7${t.count}**`);
+  const col = (title, lines) => ({
+    tag: "column",
+    width: "weighted",
+    weight: 1,
+    elements: [md(`**${title}**`), noteMd(lines.join("\n"))]
+  });
+  const columns = [];
+  if (left.length) columns.push(col("\u6D3B\u52A8\u6D1E\u5BDF", left));
+  if (right.length) columns.push(col("\u5E38\u7528\u63D2\u4EF6 / \u6280\u80FD", right));
+  if (!columns.length) return [];
+  return [
+    { tag: "column_set", flex_mode: columns.length === 2 ? "bisect" : "stretch", horizontal_spacing: "large", columns }
+  ];
+}
+function joinWithHr(blocks) {
+  const present = blocks.filter((b) => b.length);
+  const out = [];
+  present.forEach((b, i) => {
+    if (i) out.push(hr());
+    out.push(...b);
+  });
+  return out;
+}
+var usageButtons = () => actions([
+  button("\u{1F504} \u5237\u65B0", { a: DM.usageRefresh }),
+  button("\u{1F4E4} \u751F\u6210\u5206\u4EAB\u5361", { a: DM.usageShare }, "primary"),
+  button("\u2B05\uFE0F \u83DC\u5355", { a: DM.menu })
+]);
+var ERROR_COPY = {
+  "no-auth": {
+    title: "\u672A\u627E\u5230 Codex \u767B\u5F55\u6001",
+    hint: "\u672C\u673A\u6CA1\u6709\u53EF\u8BFB\u7684 `~/.codex/auth.json`\uFF0C\u8BF7\u5728\u5BBF\u4E3B\u673A\u7EC8\u7AEF\u8FD0\u884C `codex login` \u540E\u91CD\u8BD5\u3002"
+  },
+  "api-key-mode": {
+    title: "\u5F53\u524D\u662F API-key \u767B\u5F55\u6A21\u5F0F",
+    hint: "\u7528\u91CF\u7EDF\u8BA1\u4E0E\u9650\u989D\u6570\u636E\u4EC5 **ChatGPT \u767B\u5F55**\uFF08`codex login`\uFF09\u53EF\u7528\uFF0CAPI-key \u6A21\u5F0F\u6CA1\u6709\u8FD9\u4EFD\u6570\u636E\u3002"
+  },
+  "need-relogin": {
+    title: "Codex \u767B\u5F55\u6001\u5DF2\u5931\u6548",
+    hint: "\u4EE4\u724C\u5DF2\u65E0\u6CD5\u5237\u65B0\uFF08\u8FC7\u671F/\u88AB\u64A4\u9500\uFF09\uFF0C\u8BF7\u5728\u5BBF\u4E3B\u673A\u7EC8\u7AEF\u91CD\u65B0\u8FD0\u884C `codex login`\u3002"
+  },
+  transient: {
+    title: "\u6682\u65F6\u62C9\u4E0D\u5230\u6570\u636E",
+    hint: "\u7F51\u7EDC\u6216 ChatGPT \u670D\u52A1\u6CE2\u52A8\uFF0C\u7A0D\u540E\u70B9\u300C\u{1F504} \u5237\u65B0\u300D\u91CD\u8BD5\u3002"
+  }
+};
+function buildUsageCard(state) {
+  if (state.phase === "loading") {
+    return card([md("\u23F3 \u6B63\u5728\u62C9\u53D6 Codex \u7528\u91CF\u6570\u636E\u2026"), note("\u67E5\u8BE2 ChatGPT \u540E\u7AEF\uFF0C\u901A\u5E38 1~3 \u79D2\u3002")], {
+      header: { title: "\u{1F4CA} Codex \u7528\u91CF", template: "wathet" },
+      forward: false
+    });
+  }
+  if (state.phase === "error") {
+    const copy = ERROR_COPY[state.kind];
+    return card(
+      [
+        md(`\u26A0\uFE0F **${copy.title}**`),
+        md(copy.hint),
+        ...state.kind === "transient" ? [note(state.message)] : [],
+        usageButtons()
+      ],
+      { header: { title: "\u{1F4CA} Codex \u7528\u91CF", template: "orange" }, forward: false }
+    );
+  }
+  const { profile, usage } = state.data;
+  const nowMs2 = state.now ?? Date.now();
+  const elements = joinWithHr([
+    rateLimitElements(usage.main, nowMs2),
+    [statColumns(profileStatItems(profile))],
+    heatmapElements(profile, state.today),
+    insightsElements(profile)
+  ]);
+  const plan = planLabel(usage.planType);
+  elements.push(
+    note(`\u7EDF\u8BA1\u622A\u81F3 ${profile.statsAsOf ?? "\u2014"}${plan ? ` \xB7 ${plan} \u5957\u9910` : ""} \xB7 \u6570\u636E\u6765\u81EA Codex \u4E2A\u4EBA\u8D44\u6599`),
+    usageButtons()
+  );
+  return card(elements, {
+    header: {
+      title: "\u{1F4CA} Codex \u7528\u91CF",
+      template: "wathet",
+      ...profile.displayName ? { subtitle: profile.displayName } : {}
+    },
+    forward: false
+  });
+}
+var SHARE_SECTIONS = [
+  { key: "stats", label: "\u6838\u5FC3\u7EDF\u8BA1\uFF08\u7D2F\u8BA1 / \u5CF0\u503C / \u8FDE\u7EED\u5929\u6570\uFF09" },
+  { key: "heatmap", label: "\u6BCF\u65E5\u7528\u91CF\u70ED\u529B\u56FE" },
+  { key: "insights", label: "\u6D3B\u52A8\u6D1E\u5BDF\u4E0E\u5E38\u7528\u6280\u80FD" },
+  { key: "limits", label: "\u9650\u989D\u8FDB\u5EA6\uFF085 \u5C0F\u65F6 / 7 \u5929\uFF09" },
+  { key: "plan", label: "\u5957\u9910\u4FE1\u606F" }
+];
+function parseShareSections(v) {
+  const all = SHARE_SECTIONS.map((s) => s.key);
+  const raw = Array.isArray(v) ? v : typeof v === "string" && v ? v.split(",") : [];
+  const picked = raw.filter((x) => all.includes(String(x)));
+  return new Set(picked.length ? picked : all);
+}
+function buildShareConfigCard(done = false) {
+  return card(
+    [
+      md("\u9009\u62E9\u8981\u653E\u8FDB\u5206\u4EAB\u5361\u7684\u5185\u5BB9\uFF08**\u4E0D\u9009 = \u5168\u90E8\u5C55\u793A**\uFF09\uFF0C\u751F\u6210\u540E\u957F\u6309 / \u53F3\u952E\u5373\u53EF\u8F6C\u53D1\uFF1A"),
+      {
+        tag: "form",
+        name: "shareCfg",
+        elements: [
+          {
+            tag: "multi_select_static",
+            name: "secs",
+            placeholder: { tag: "plain_text", content: "\u9ED8\u8BA4\u5168\u90E8\u5C55\u793A\uFF0C\u53EF\u53EA\u6311\u90E8\u5206\u533A\u5757" },
+            options: SHARE_SECTIONS.map((s) => ({ text: { tag: "plain_text", content: s.label }, value: s.key }))
+          },
+          submitButton("\u{1F4E4} \u751F\u6210\u5206\u4EAB\u5361", { a: DM.usageShareDo })
+        ]
+      },
+      ...done ? [note("\u2705 \u5206\u4EAB\u5361\u5DF2\u751F\u6210\uFF08\u89C1\u4E0B\u65B9\u65B0\u5361\u7247\uFF09\u3002\u6362\u4E2A\u7EC4\u5408\u53EF\u518D\u6B21\u751F\u6210\u3002")] : [],
+      actions([button("\u2B05\uFE0F \u8FD4\u56DE\u7528\u91CF", { a: DM.usage }), button("\u{1F3E0} \u83DC\u5355", { a: DM.menu })])
+    ],
+    { header: { title: "\u{1F4E4} \u5206\u4EAB\u5185\u5BB9\u9009\u62E9", template: "blue" }, forward: false }
+  );
+}
+function buildUsageShareCard(data, opts = {}) {
+  const { profile, usage } = data;
+  const nowMs2 = opts.now ?? Date.now();
+  const sec = opts.sections ?? new Set(SHARE_SECTIONS.map((s) => s.key));
+  const who = profile.displayName ? `${profile.displayName} \u7684` : "\u6211\u7684";
+  const plan = planLabel(usage.planType);
+  const elements = joinWithHr([
+    sec.has("stats") ? [statColumns(profileStatItems(profile))] : [],
+    sec.has("heatmap") ? heatmapElements(profile, opts.today) : [],
+    sec.has("insights") ? insightsElements(profile) : [],
+    sec.has("limits") ? rateLimitElements(usage.main, nowMs2) : [],
+    sec.has("plan") && plan ? [md(`\u{1F48E} **\u5957\u9910**\u3000${plan}`)] : []
+  ]);
+  const stamp = new Date(nowMs2);
+  const stampStr = `${stamp.getMonth() + 1}\u6708${stamp.getDate()}\u65E5 ${String(stamp.getHours()).padStart(2, "0")}:${String(stamp.getMinutes()).padStart(2, "0")}`;
+  elements.push({
+    tag: "markdown",
+    content: `<font color='grey'>\u{1F916} \u7531 </font>[feishu-codex-bridge](https://my.feishu.cn/docx/AFKNdf4QaooL5OxSR8bc5H7vn7b)<font color='grey'> \u4E8E ${stampStr} \u751F\u6210</font>`,
+    text_size: "notation",
+    text_align: "right"
+  });
+  return card(elements, {
+    header: {
+      title: `\u{1F4CA} ${who} Codex \u7528\u91CF`,
+      template: "blue",
+      ...profile.statsAsOf ? { subtitle: `\u7EDF\u8BA1\u622A\u81F3 ${profile.statsAsOf}` } : {}
+    }
+  });
+}
+
 // src/project/lifecycle.ts
 import { mkdir as mkdir9 } from "fs/promises";
 import { existsSync as existsSync7 } from "fs";
-import { isAbsolute as isAbsolute2, join as join12, resolve as resolve6 } from "path";
+import { isAbsolute as isAbsolute2, join as join13, resolve as resolve6 } from "path";
 
 // src/project/git-info.ts
 import { execFile } from "child_process";
@@ -4527,7 +5235,7 @@ async function resolveCwd(name, existingPath) {
     if (!existsSync7(cwd2)) throw new Error(`\u6587\u4EF6\u5939\u4E0D\u5B58\u5728\uFF1A${cwd2}`);
     return { cwd: cwd2, blank: false };
   }
-  const cwd = join12(paths.projectsRootDir, name);
+  const cwd = join13(paths.projectsRootDir, name);
   await mkdir9(cwd, { recursive: true });
   return { cwd, blank: true };
 }
@@ -4547,9 +5255,19 @@ async function createProject(channel, input2) {
     params: { member_id_type: "open_id" },
     data: { manager_ids: [input2.ownerOpenId] }
   }).catch((err) => log.fail("project", err, { phase: "add-manager" }));
-  const project = { name, chatId, cwd, blank, createdAt: Date.now(), kind: input2.kind ?? "multi", origin: "created" };
+  const project = {
+    name,
+    chatId,
+    cwd,
+    blank,
+    createdAt: Date.now(),
+    kind: input2.kind ?? "multi",
+    origin: "created",
+    mode: input2.mode ?? "full",
+    network: input2.network ?? false
+  };
   await addProject(project);
-  log.info("project", "create", { name, chatId, cwd, blank });
+  log.info("project", "create", { name, chatId, cwd, blank, mode: project.mode });
   await setAnnouncement(channel, project).catch((err) => log.fail("project", err, { phase: "announcement" }));
   await onboardGroup(channel, project).catch((err) => log.fail("project", err, { phase: "onboard" }));
   return project;
@@ -4569,10 +5287,12 @@ async function joinExistingGroup(channel, input2) {
     createdAt: Date.now(),
     kind: input2.kind ?? "multi",
     origin: "joined",
-    addedBy: input2.addedBy
+    addedBy: input2.addedBy,
+    mode: input2.mode ?? "qa",
+    network: input2.network ?? false
   };
   await addProject(project);
-  log.info("project", "join", { name, chatId: input2.chatId, cwd, blank, kind: project.kind });
+  log.info("project", "join", { name, chatId: input2.chatId, cwd, blank, kind: project.kind, mode: project.mode });
   await onboardGroup(channel, project).catch((err) => log.fail("project", err, { phase: "onboard-join" }));
   return project;
 }
@@ -4595,12 +5315,12 @@ async function leaveChat(channel, chatId) {
 }
 
 // src/bot/session-store.ts
-import { mkdir as mkdir10, readFile as readFile8, rename as rename5, writeFile as writeFile8 } from "fs/promises";
+import { mkdir as mkdir10, readFile as readFile9, rename as rename5, writeFile as writeFile8 } from "fs/promises";
 import { dirname as dirname10 } from "path";
 var FILE_VERSION3 = 1;
 async function read2() {
   try {
-    const text = await readFile8(paths.sessionsFile, "utf8");
+    const text = await readFile9(paths.sessionsFile, "utf8");
     const parsed = JSON.parse(text);
     return Array.isArray(parsed.sessions) ? parsed.sessions : [];
   } catch (err) {
@@ -4657,7 +5377,7 @@ async function handleDmConsole(channel, cfg, msg) {
 
 // src/bot/media.ts
 import { mkdir as mkdir11, readdir as readdir2, rm as rm4, stat as stat3 } from "fs/promises";
-import { join as join13 } from "path";
+import { join as join14 } from "path";
 var MAX_IMAGES2 = 9;
 var MEDIA_TTL_MS = 60 * 6e4;
 var EXT_BY_CONTENT_TYPE = {
@@ -4762,7 +5482,7 @@ async function downloadOne(channel, ref, index) {
       params: { type: "image" }
     });
     const ext = extFromHeaders(res.headers);
-    const file = join13(paths.mediaDir, `${safeName(ref.fileKey)}-${index}.${ext}`);
+    const file = join14(paths.mediaDir, `${safeName(ref.fileKey)}-${index}.${ext}`);
     await res.writeFile(file);
     return file;
   } catch (err) {
@@ -4796,7 +5516,7 @@ async function pruneOldMedia() {
   }
   const cutoff = Date.now() - MEDIA_TTL_MS;
   for (const name of entries) {
-    const file = join13(paths.mediaDir, name);
+    const file = join14(paths.mediaDir, name);
     try {
       const st = await stat3(file);
       if (st.mtimeMs < cutoff) await rm4(file, { force: true });
@@ -5095,6 +5815,21 @@ function pickOpenId(formValue) {
   }
   return void 0;
 }
+function selectValue(formValue, name) {
+  const c = (() => {
+    const raw = formValue?.[name];
+    return Array.isArray(raw) ? raw[0] : raw;
+  })();
+  if (typeof c === "string") return c;
+  if (c && typeof c === "object") {
+    const o = c;
+    for (const v of [o.value, o.id]) if (typeof v === "string") return v;
+  }
+  return void 0;
+}
+function asTier(v) {
+  return v === "qa" || v === "write" || v === "full" ? v : void 0;
+}
 function createOrchestrator(channel, cfg, fallbackCwd) {
   const backend = createBackend();
   const sessions = /* @__PURE__ */ new Map();
@@ -5198,11 +5933,12 @@ function createOrchestrator(channel, cfg, fallbackCwd) {
         await postGroupSettings(msg, project);
         return;
       }
+      const ts = turnSession(msg.chatId, project, msg.senderId);
       if (cmd === "model") {
-        await postModelCard(msg, msg.chatId);
+        await postModelCard(msg, ts.sessionKey);
         return;
       }
-      handleTurn(msg, text, msg.chatId, true, project);
+      handleTurn(msg, text, ts.sessionKey, true, project, ts);
       return;
     }
     if (msg.threadId) {
@@ -5210,11 +5946,12 @@ function createOrchestrator(channel, cfg, fallbackCwd) {
         await postHelpCard(msg, "topic", true, project);
         return;
       }
+      const ts = turnSession(msg.threadId, project, msg.senderId);
       if (cmd === "model") {
-        await postModelCard(msg, msg.threadId);
+        await postModelCard(msg, ts.sessionKey);
         return;
       }
-      handleTurn(msg, text, msg.threadId, false, project);
+      handleTurn(msg, text, ts.sessionKey, false, project, ts);
       return;
     }
     if (cmd === "help") {
@@ -5264,13 +6001,22 @@ function createOrchestrator(channel, cfg, fallbackCwd) {
       log.info("card", "group-settings", { project: project.name });
     });
   }
-  async function handleTurn(msg, text, sessionKey, flat, project) {
+  function turnPerm(project, senderId) {
+    if (!project) return {};
+    const t = turnTier(project, isAdmin(cfg, senderId));
+    return { mode: t.mode, network: project.network, roleSuffix: t.split ? t.role : void 0 };
+  }
+  function turnSession(baseKey, project, senderId) {
+    const perm = turnPerm(project, senderId);
+    return { sessionKey: perm.roleSuffix ? `${baseKey}#${perm.roleSuffix}` : baseKey, ...perm };
+  }
+  async function handleTurn(msg, text, sessionKey, flat, project, perm) {
     const existing = active.get(sessionKey);
     if (existing) {
       const images = messageHasImages(msg) ? await collectInboundImages(channel, msg) : void 0;
       const cur = active.get(sessionKey);
       if (!cur) {
-        startReservedRun(msg, text, sessionKey, flat, project, images);
+        startReservedRun(msg, text, sessionKey, flat, project, perm, images);
         return;
       }
       if (getPendingPolicy(cfg) === "steer" && cur.run && cur.thread) {
@@ -5289,9 +6035,9 @@ function createOrchestrator(channel, cfg, fallbackCwd) {
       log.info("intake", "queued", { depth: cur.queue.length });
       return;
     }
-    startReservedRun(msg, text, sessionKey, flat, project);
+    startReservedRun(msg, text, sessionKey, flat, project, perm);
   }
-  function startReservedRun(msg, text, sessionKey, flat, project, preloadedImages) {
+  function startReservedRun(msg, text, sessionKey, flat, project, perm, preloadedImages) {
     const existing = active.get(sessionKey);
     if (existing) {
       existing.queue.push({ text, images: preloadedImages });
@@ -5304,10 +6050,10 @@ function createOrchestrator(channel, cfg, fallbackCwd) {
       const reaction = runReaction(msg.messageId, !sema.hasFree());
       try {
         const images = preloadedImages ?? (messageHasImages(msg) ? await collectInboundImages(channel, msg) : void 0);
-        let thread = await resolveThread(sessionKey, msg.chatId);
+        let thread = await resolveThread(sessionKey, msg.chatId, { mode: perm.mode, network: perm.network });
         if (!thread) {
           const cwd = project?.cwd ?? fallbackCwd;
-          thread = await backend.startThread({ cwd });
+          thread = await backend.startThread({ cwd, mode: perm.mode, network: perm.network });
           sessions.set(sessionKey, thread);
           await upsertSession({
             threadId: sessionKey,
@@ -5342,7 +6088,7 @@ function createOrchestrator(channel, cfg, fallbackCwd) {
       }
     });
   }
-  async function resolveThread(threadId, chatId) {
+  async function resolveThread(threadId, chatId, perm) {
     const live = sessions.get(threadId);
     if (live) return live;
     const rec = await getSession(threadId);
@@ -5352,7 +6098,9 @@ function createOrchestrator(channel, cfg, fallbackCwd) {
         cwd: rec.cwd,
         codexThreadId: rec.codexThreadId,
         model: rec.model,
-        effort: rec.effort
+        effort: rec.effort,
+        mode: perm?.mode,
+        network: perm?.network
       });
       sessions.set(threadId, resumed);
       return resumed;
@@ -5360,20 +6108,39 @@ function createOrchestrator(channel, cfg, fallbackCwd) {
       log.fail("agent", err, { phase: "resume-on-turn", threadId });
       const project = await getProjectByChatId(chatId);
       const cwd = project?.cwd ?? rec.cwd ?? fallbackCwd;
-      const fresh = await backend.startThread({ cwd, model: rec.model, effort: rec.effort });
+      const fresh = await backend.startThread({
+        cwd,
+        model: rec.model,
+        effort: rec.effort,
+        mode: perm?.mode ?? project?.mode,
+        network: perm?.network ?? project?.network
+      });
       sessions.set(threadId, fresh);
       return fresh;
     }
   }
+  async function evictLiveSessionsForChat(chatId) {
+    let closed = 0;
+    for (const rec of await listSessions()) {
+      if (rec.chatId !== chatId) continue;
+      const live = sessions.get(rec.threadId);
+      if (!live) continue;
+      sessions.delete(rec.threadId);
+      void live.close().catch(() => void 0);
+      closed++;
+    }
+    if (closed) log.info("console", "tier-evict", { chatId, closed });
+  }
   function startTopicDirectly(msg, text, project) {
     void withTrace({ chatId: msg.chatId, msgId: msg.messageId }, async () => {
       const reaction = runReaction(msg.messageId, !sema.hasFree());
       const cwd = project?.cwd ?? fallbackCwd;
+      const perm = turnPerm(project, msg.senderId);
       if (project) void refreshBranch(channel, project).catch(() => void 0);
       const { model, effort } = pickDefault(await listModels());
       let thread;
       try {
-        thread = await backend.startThread({ cwd, model, effort });
+        thread = await backend.startThread({ cwd, model, effort, mode: perm.mode, network: perm.network });
       } catch (err) {
         reaction.done();
         log.fail("card", err, { phase: "start-topic" });
@@ -5395,7 +6162,8 @@ function createOrchestrator(channel, cfg, fallbackCwd) {
           effort,
           cwd,
           summary: text.slice(0, 80) || "(\u7A7A)",
-          requesterOpenId: msg.senderId
+          requesterOpenId: msg.senderId,
+          roleSuffix: perm.roleSuffix
         },
         reaction,
         () => reaction.done()
@@ -5559,6 +6327,46 @@ function createOrchestrator(channel, cfg, fallbackCwd) {
   const freshMenu = (evt) => {
     patch(evt, buildDmMenuCard());
   };
+  const runUsage = (evt, force) => {
+    if (!dmAdmin(evt.operator?.openId)) return;
+    void (async () => {
+      await new Promise((r) => setTimeout(r, CARD_SETTLE_MS));
+      let msgId = evt.messageId;
+      const okLoading = await updateManagedCard(channel, msgId, buildUsageCard({ phase: "loading" })).catch(
+        () => false
+      );
+      if (!okLoading) {
+        const sent = await sendManagedCard(channel, evt.chatId, buildUsageCard({ phase: "loading" })).catch(
+          (e) => {
+            log.fail("console", e, { phase: "usage-loading" });
+            return void 0;
+          }
+        );
+        if (!sent) return;
+        msgId = sent.messageId;
+      }
+      let state;
+      try {
+        state = { phase: "ready", data: await fetchUsageBundle(force) };
+      } catch (err) {
+        log.fail("console", err, { phase: "usage" });
+        state = {
+          phase: "error",
+          kind: err instanceof UsageError ? err.kind : "transient",
+          message: err instanceof Error ? err.message : String(err)
+        };
+      }
+      const ok = await updateManagedCard(channel, msgId, buildUsageCard(state)).catch((e) => {
+        log.fail("console", e, { phase: "usage-render" });
+        return false;
+      });
+      if (!ok) {
+        await sendManagedCard(channel, evt.chatId, buildUsageCard(state)).catch(
+          (e) => log.fail("console", e, { phase: "usage-fallback" })
+        );
+      }
+    })();
+  };
   const renderProjectList = async () => {
     const [projects, sessions2] = await Promise.all([listProjects(), listSessions()]);
     const byChat = /* @__PURE__ */ new Map();
@@ -5712,6 +6520,25 @@ SDK \u4F1A\u81EA\u52A8\u91CD\u8FDE\uFF1B\u82E5\u957F\u671F\u65AD\u5F00\uFF0C\u8B
         await restartDaemon().catch((e) => log.fail("console", e, { phase: "update-restart" }));
       }
     })();
+  }).on(DM.usage, ({ evt }) => runUsage(evt, false)).on(DM.usageRefresh, ({ evt }) => runUsage(evt, true)).on(DM.usageShare, ({ evt }) => {
+    if (!dmAdmin(evt.operator?.openId)) return;
+    patch(evt, buildShareConfigCard());
+  }).on(DM.usageShareDo, ({ evt, formValue }) => {
+    if (!dmAdmin(evt.operator?.openId)) return;
+    const sections = parseShareSections(formValue?.secs);
+    void (async () => {
+      await new Promise((r) => setTimeout(r, CARD_SETTLE_MS));
+      try {
+        const data = await fetchUsageBundle();
+        await sendManagedCard(channel, evt.chatId, buildUsageShareCard(data, { sections }), evt.messageId);
+        log.info("console", "usage-share", { sections: [...sections].join(",") });
+        await updateManagedCard(channel, evt.messageId, buildShareConfigCard(true)).catch(() => void 0);
+      } catch (err) {
+        log.fail("console", err, { phase: "usage-share" });
+        const reason = err instanceof UsageError ? err.message : "\u62C9\u53D6\u7528\u91CF\u6570\u636E\u5931\u8D25";
+        await channel.send(evt.chatId, { markdown: `\u26A0\uFE0F \u751F\u6210\u5206\u4EAB\u5361\u5931\u8D25\uFF1A${reason}` }, { replyTo: evt.messageId }).catch(() => void 0);
+      }
+    })();
   }).on(DM.rmConfirm, async ({ evt, value }) => {
     const name = typeof value.n === "string" ? value.n : void 0;
     if (!dmAdmin(evt.operator?.openId) || !name) return;
@@ -5872,6 +6699,31 @@ ${tail}` }, { replyTo: evt.messageId }).catch(() => void 0);
       await updateProject(name, { noMention: on });
       return buildProjectSettingsCard({ ...p, noMention: on });
     });
+  }).on(DM.permission, ({ evt, value }) => {
+    if (!dmAdmin(evt.operator?.openId)) return;
+    const name = typeof value.n === "string" ? value.n : "";
+    patch(evt, async () => {
+      const p = await getProjectByName(name);
+      return p ? buildPermissionCard(p) : buildDmMenuCard();
+    });
+  }).on(DM.permissionSubmit, ({ evt, value, formValue }) => {
+    if (!dmAdmin(evt.operator?.openId)) return;
+    const name = typeof value.n === "string" ? value.n : "";
+    const mode = asTier(selectValue(formValue, "mode"));
+    const guestMode = asTier(selectValue(formValue, "guestMode"));
+    const network = selectValue(formValue, "network") === "on";
+    void (async () => {
+      const p = await getProjectByName(name);
+      if (!p) return;
+      await updateProject(name, { ...mode ? { mode } : {}, ...guestMode ? { guestMode } : {}, network });
+      await evictLiveSessionsForChat(p.chatId);
+      log.info("console", "permission", { project: name, mode, guestMode, network });
+      const fresh = await getProjectByName(name);
+      if (!fresh) return;
+      await sendManagedCard(channel, evt.chatId, buildProjectSettingsCard(fresh)).catch(
+        (e) => log.fail("console", e, { phase: "permission-result" })
+      );
+    })();
   });
   async function resumeFromCard(evt, state, codexThreadId) {
     try {
@@ -5973,13 +6825,14 @@ ${tail}` }, { replyTo: evt.messageId }).catch(() => void 0);
           if (activeKey.startsWith("pending:")) {
             const tid = await getThreadId(channel, messageId);
             if (tid) {
+              const key = opts.roleSuffix ? `${tid}#${opts.roleSuffix}` : tid;
               active.delete(activeKey);
-              active.set(tid, state);
-              sessions.set(tid, opts.thread);
-              activeKey = tid;
-              topicThreadId = tid;
-              rc.threadId = tid;
-              await persist(tid);
+              active.set(key, state);
+              sessions.set(key, opts.thread);
+              activeKey = key;
+              topicThreadId = key;
+              rc.threadId = key;
+              await persist(key);
             }
           } else {
             topicThreadId = activeKey;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelzen/feishu-codex-bridge",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Bridge Feishu/Lark messenger with local Codex via app-server (project=group, thread=session)",
   "type": "module",
   "bin": {