@modelzen/feishu-codex-bridge 0.6.3 → 0.6.4

package/README.md

@@ -50,7 +50,7 @@ feishu-codex-bridge web                  # 2. 打开本机网页控制台
 - **免 @ + 自主目标**：话题 / 单会话群里可直接说话不必每次 @；`/goal <目标>` 让它自主多轮干到完成。
 - **多模态**：消息里直接发图片（读图）、发文件附件（下载到本地交给 agent 打开分析）。
 - **☕ 咖啡一下（反向桥）**：离开电脑时，把你本机正在跑的 Claude Code / Codex CLI 的「需要审批 / 提问 / 任务完成」接管到飞书私聊 —— 在手机上点确认 / 回答它就继续，机器保持不睡。
-- **文档评论回复**：在飞书云文档（doc / docx / sheet / file，含 wiki）的评论里 @ 机器人，它读评论、跑 agent、把答案回到同一条评论线程。
+- **文档评论回复**：在飞书云文档（doc / docx / sheet / bitable 多维表格，含 wiki）的评论里 @ 机器人，它读评论、跑 agent、把答案回到同一条评论线程。
 - **双控制台**：私聊机器人弹交互菜单（新建项目 / 设置 / 用量 / 诊断 / 重连）；网页控制台还能管后台服务、看实时日志、扫码加机器人。
 - **多飞书机器人**：一台机器注册多个机器人、可同时连接，各自项目 / 会话独立。
 - **三档权限沙箱**：每个项目可设「只读 / 读写 / 完全访问」，由 OS 沙箱强制（macOS / 原生 Windows）。

package/dist/cli.js

@@ -57,6 +57,18 @@ var init_paths = __esm({
       get processesFile() {
         return join(currentBotDir, "processes.json");
       },
+      /** 云文档评论 @bot 的可编辑提示词 master 文件（当前 bot）。用户直接编辑这一份，
+       * 桥在每条评论运行前把它同步进该文档的评论工作目录（AGENTS.md / CLAUDE.md）。
+       * 首次缺失时由 bot/comments.ts 用内置默认模板自动落地。 */
+      get commentInstructionsFile() {
+        return join(currentBotDir, "comment-instructions.md");
+      },
+      /** 评论工作目录根（**当前 bot**）：每个被评论文档一个 `comment-<type>-<token>` 子目录，
+       * 放同步进去的 AGENTS.md / CLAUDE.md。放 per-bot 目录下，与其它 bot 隔离——否则
+       * 编辑提示词时的「全量同步」会越界改到别的 bot 的评论目录。 */
+      get commentsRootDir() {
+        return join(currentBotDir, "comments");
+      },
       /**
        * Local CLI hook IPC endpoint for the current bot. macOS/Linux use a Unix
        * domain socket file; Windows has none, so Node maps a `\\.\pipe\…` path to a
@@ -218,6 +230,9 @@ function resolveCliBridgeTarget(cfg) {
 function canEnableCliBridge(cfg) {
   return resolveCliBridgeTarget(cfg) ? { ok: true } : { ok: false, reason: "missing_owner" };
 }
+function getCommentsConfig(cfg) {
+  return cfg.preferences?.comments ?? {};
+}
 var RUN_IDLE_TIMEOUT_MIN_SEC, RUN_IDLE_TIMEOUT_MAX_SEC;
 var init_schema = __esm({
   "src/config/schema.ts"() {
@@ -630,6 +645,7 @@ var init_logger = __esm({
 function card(elements, opts = {}) {
   const config = { update_multi: true };
   if (opts.forward === false) config.enable_forward = false;
+  if (opts.widthMode) config.width_mode = opts.widthMode;
   if (opts.streaming) {
     config.streaming_mode = true;
     config.streaming_config = {
@@ -772,9 +788,13 @@ function input(opts) {
   return {
     tag: "input",
     name: opts.name,
+    ...opts.inputType ? { input_type: opts.inputType } : {},
+    ...opts.rows ? { rows: opts.rows, auto_resize: true } : {},
+    ...opts.width !== void 0 ? { width: opts.width } : {},
     ...opts.label ? { label: { tag: "plain_text", content: opts.label } } : {},
     ...opts.placeholder ? { placeholder: { tag: "plain_text", content: opts.placeholder } } : {},
     ...opts.value ? { default_value: opts.value } : {},
+    ...opts.maxLength ? { max_length: opts.maxLength } : {},
     required: Boolean(opts.required)
   };
 }
@@ -1995,13 +2015,13 @@ __export(cli_bridge_exports, {
   selectCliBridgeHookBot: () => selectCliBridgeHookBot,
   shouldStartCliBridge: () => shouldStartCliBridge
 });
-import { join as join19 } from "path";
+import { join as join20 } from "path";
 async function selectCliBridgeHookBot(reg, opts = {}) {
   const requested = opts.requested?.trim();
   if (requested) {
     return findBot(reg, requested) ?? { name: requested, appId: requested, tenant: "feishu", createdAt: 0 };
   }
-  const loadConfigForBot = opts.loadConfigForBot ?? ((appId) => loadConfig(join19(botDir(appId), "config.json")));
+  const loadConfigForBot = opts.loadConfigForBot ?? ((appId) => loadConfig(join20(botDir(appId), "config.json")));
   const current = currentBot(reg);
   const active = activeBots(reg);
   const candidates = active.length > 0 ? active : current ? [current] : reg.bots;
@@ -4166,6 +4186,8 @@ var ClaudeAgentThread = class {
       ...toSdkEffort(cfg.effort) ? { effort: toSdkEffort(cfg.effort) } : {},
       ...cfg.resume ? { resume: cfg.sessionId } : { sessionId: cfg.sessionId },
       ...cfg.systemPromptAppend ? { systemPrompt: { type: "preset", preset: "claude_code", append: cfg.systemPromptAppend } } : {},
+      ...cfg.settingSources ? { settingSources: cfg.settingSources } : {},
+      ...cfg.env ? { env: cfg.env } : {},
       // permission tier (permissionMode / sandbox / canUseTool / disallowedTools)
       ...cfg.permission,
       stderr: (d) => {
@@ -4449,6 +4471,13 @@ var ClaudeAgentThread = class {
 
 // src/agent/claude-agent/backend.ts
 var SDK_PKG = "@anthropic-ai/claude-agent-sdk";
+var BRIDGE_SETTING_SOURCES = ["user", "project"];
+function bridgeClaudeEnv() {
+  const base = {};
+  for (const [k2, v] of Object.entries(process.env)) if (typeof v === "string") base[k2] = v;
+  base.FEISHU_CODEX_BRIDGE = "1";
+  return base;
+}
 var sdkPromise;
 function loadSdk() {
   sdkPromise ??= loadBackendDep(SDK_PKG);
@@ -4531,6 +4560,8 @@ var ClaudeAgentBackend = class {
       effort: opts.effort,
       permission: permissionOptions(opts.mode, opts.network, opts.cwd),
       systemPromptAppend: BRIDGE_DEVELOPER_INSTRUCTIONS,
+      settingSources: BRIDGE_SETTING_SOURCES,
+      env: bridgeClaudeEnv(),
       query: sdk.query
     });
   }
@@ -4544,6 +4575,8 @@ var ClaudeAgentBackend = class {
       effort: opts.effort,
       permission: permissionOptions(opts.mode, opts.network, opts.cwd),
       systemPromptAppend: BRIDGE_DEVELOPER_INSTRUCTIONS,
+      settingSources: BRIDGE_SETTING_SOURCES,
+      env: bridgeClaudeEnv(),
       query: sdk.query
     });
   }
@@ -5633,6 +5666,8 @@ var DM = {
   joinGroupSubmit: "dm.joinGroup.submit",
   projects: "dm.projects",
   settings: "dm.settings",
+  // ☕ 咖啡一下（离开接管）：从全局设置卡进入的二级卡片（仿云文档评论那样的子卡入口）
+  coffeeSettings: "dm.coffee.settings",
   doctor: "dm.doctor",
   reconnect: "dm.reconnect",
   update: "dm.update",
@@ -5675,9 +5710,16 @@ var DM = {
   modelDefaultSubmit: "dm.proj.modelDefault.submit",
   // 🔐 权限：codex 沙箱档位（管理员档 + 普通用户档）+ 联网，做成下拉表单（选+提交）
   permission: "dm.proj.perm",
-  permissionSubmit: "dm.proj.perm.submit"
+  permissionSubmit: "dm.proj.perm.submit",
   // 🧠 后端 backend/backendSubmit 已移除：后端改为「创建时选定、运行时固定、不支持切换」，
   // 新建卡选后端见 newProjectSubmit；项目设置卡只读展示。
+  // 📝 云文档评论 @bot 全局设置：后端按钮(级联)→模型/强度下拉表单提交；提示词在卡内编辑。
+  commentSettings: "dm.comment.settings",
+  commentSetBackend: "dm.comment.setBackend",
+  commentSubmit: "dm.comment.submit",
+  commentEditPrompt: "dm.comment.editPrompt",
+  commentPromptSubmit: "dm.comment.promptSubmit",
+  commentResetPrompt: "dm.comment.resetPrompt"
 };
 var GS = {
   setNoMention: "gs.noMention",
@@ -6149,7 +6191,7 @@ function settingItem(name, desc, actionId, current, opts) {
     actions(opts.map((o) => button(o.label, { a: actionId, v: o.value }, o.value === current ? "primary" : "default")))
   ];
 }
-function buildSettingsCard(cfg, localAgents = []) {
+function buildSettingsCard(cfg) {
   const watchdogSec = cfg.preferences?.runIdleTimeoutSeconds ?? 120;
   return card(
     [
@@ -6207,13 +6249,169 @@ function buildSettingsCard(cfg, localAgents = []) {
           { label: "20", value: "20" }
         ]
       ),
-      ...localAgents,
+      hr(),
+      settingSection("\u2615 \u5496\u5561\u4E00\u4E0B"),
+      note("\u53BB\u5012\u676F\u5496\u5561\u7684\u5DE5\u592B\uFF0C\u6211\u66FF\u4F60\u76EF\u7740\u672C\u673A\u7684 Claude Code / Codex\u2014\u2014\u5B83\u8981\u5BA1\u6279\u3001\u8981\u95EE\u4F60\u3001\u6216\u8DD1\u5B8C\u4E86\uFF0C\u90FD\u63A8\u5230\u8FD9\u4E2A\u79C1\u804A\u3002\u542B\u901A\u77E5\u8303\u56F4\u3001\u8F6C\u53D1\u540E\u7AEF\u3001\u79BB\u5F00\u4FDD\u6D3B\u3001hooks \u4FEE\u590D\u3002"),
+      actions([button("\u8BBE\u7F6E\u5496\u5561\u4E00\u4E0B / \u901A\u77E5 / \u4FDD\u6D3B / hooks", { a: DM.coffeeSettings }, "primary")]),
+      hr(),
+      settingSection("\u{1F4DD} \u4E91\u6587\u6863\u8BC4\u8BBA"),
+      note("\u5728\u98DE\u4E66\u4E91\u6587\u6863\uFF08\u6587\u6863 / \u8868\u683C / \u591A\u7EF4\u8868\u683C\uFF0C\u542B wiki\uFF09\u7684\u8BC4\u8BBA\u91CC @\u6211\uFF0C\u6211\u8BFB\u8BC4\u8BBA\u3001\u8DD1 agent\u3001\u628A\u7B54\u6848\u8D34\u56DE\u8BC4\u8BBA\u3002\u53EF\u8BBE\u7F6E\u8BC4\u8BBA\u54CD\u5E94\u7528\u7684\u540E\u7AEF agent / \u6A21\u578B / \u63A8\u7406\u5F3A\u5EA6\uFF0C\u4EE5\u53CA\u81EA\u5B9A\u4E49\u63D0\u793A\u8BCD\uFF08\u5168\u5C40\uFF0C\u4E0D\u5206\u9879\u76EE\uFF1B\u4EC5\u7BA1\u7406\u5458\u53EF @\uFF09\u3002"),
+      actions([button("\u8BBE\u7F6E\u540E\u7AEF / \u6A21\u578B / \u5F3A\u5EA6 / \u63D0\u793A\u8BCD", { a: DM.commentSettings }, "primary")]),
       hr(),
       actions([button("\u{1F46E} \u7BA1\u7406\u5458", { a: DM.admins }), button("\u2B05\uFE0F \u83DC\u5355", { a: DM.menu })])
     ],
     { header: { title: "\u2699\uFE0F \u5168\u5C40\u8BBE\u7F6E", template: "blue" } }
   );
 }
+function buildCoffeeSettingsCard(section) {
+  return card(
+    [
+      ...section.slice(1),
+      // 去掉为「内联进主卡」而加的开头 hr()
+      hr(),
+      actions([button("\u2B05\uFE0F \u8FD4\u56DE\u8BBE\u7F6E", { a: DM.settings })])
+    ],
+    { header: { title: "\u2615 \u5496\u5561\u4E00\u4E0B", template: "blue" } }
+  );
+}
+var LARK_CLI_DOC_URL = "https://bytedance.larkoffice.com/wiki/ILuTww7Xcimb6GkhH0mcK2f4nS7";
+function buildCommentSettingsCard(cfg, backendOptions, models, notice) {
+  const comments = cfg.preferences?.comments ?? {};
+  const visible = models.filter((m) => !m.hidden);
+  const curBackend = comments.backend && backendOptions.some((b) => b.id === comments.backend) ? comments.backend : backendOptions.find((b) => b.id === DEFAULT_BACKEND_ID)?.id ?? backendOptions[0]?.id ?? DEFAULT_BACKEND_ID;
+  const explicit = comments.model ? visible.find((m) => m.id === comments.model) : void 0;
+  const curModel = explicit ?? visible.find((m) => m.isDefault) ?? visible[0];
+  const unionEfforts = EFFORT_ORDER.filter((e) => visible.some((m) => (m.supportedEfforts ?? []).includes(e)));
+  const curEffort = comments.effort && (curModel?.supportedEfforts ?? []).includes(comments.effort) ? comments.effort : curModel?.defaultEffort;
+  const canPickModel = visible.length > 1;
+  const canPickEffort = unionEfforts.length > 0;
+  const els = [
+    ...notice ? [md(notice)] : [],
+    md("**\u{1F4DD} \u4E91\u6587\u6863\u8BC4\u8BBA @bot**"),
+    note("\u8BC4\u8BBA\u91CC @\u6211\u65F6\u7528\u7684\u540E\u7AEF / \u6A21\u578B / \u63A8\u7406\u5F3A\u5EA6\u3002\u53EA\u5F71\u54CD\u4E4B\u540E\u65B0\u5EFA\u7684\u8BC4\u8BBA\u3002"),
+    hr()
+  ];
+  if (backendOptions.length > 1) {
+    els.push(
+      md("\u{1F9E0} **\u540E\u7AEF**"),
+      actions(
+        backendOptions.map(
+          (b) => button(b.label, { a: DM.commentSetBackend, v: b.id }, b.id === curBackend ? "primary" : "default")
+        )
+      )
+    );
+  } else {
+    els.push(md(`\u{1F9E0} **\u540E\u7AEF**\uFF1A${backendOptions[0]?.label ?? curBackend}`));
+  }
+  if (canPickModel || canPickEffort) {
+    const formEls = [];
+    if (canPickModel) {
+      formEls.push(
+        md("\u{1F916} **\u6A21\u578B**"),
+        selectMenu({
+          name: "model",
+          placeholder: "\u9009\u62E9\u6A21\u578B",
+          options: visible.map((m) => ({ label: m.displayName, value: m.id })),
+          initial: curModel?.id
+        })
+      );
+    } else {
+      formEls.push(md(`\u{1F916} **\u6A21\u578B**\uFF1A${curModel?.displayName ?? "\u540E\u7AEF\u9ED8\u8BA4"}\uFF08\u8BE5\u540E\u7AEF\u4EC5\u4E00\u4E2A\u6A21\u578B\uFF09`));
+    }
+    if (canPickEffort) {
+      formEls.push(
+        md("\u{1F39A} **\u63A8\u7406\u5F3A\u5EA6**"),
+        selectMenu({
+          name: "effort",
+          placeholder: "\u9009\u62E9\u63A8\u7406\u5F3A\u5EA6",
+          options: unionEfforts.map((e) => ({ label: EFFORT_LABEL[e], value: e })),
+          initial: curEffort
+        })
+      );
+    }
+    formEls.push(actions([submitButton("\u2705 \u4FDD\u5B58\u6A21\u578B / \u5F3A\u5EA6", { a: DM.commentSubmit }, "primary", "submit_comment")]));
+    els.push(form("comment_model_effort", formEls));
+  } else {
+    els.push(note("\u8BE5\u540E\u7AEF\u53EA\u6709\u4E00\u4E2A\u6A21\u578B\u4E14\u4E0D\u8C03\u63A8\u7406\u5F3A\u5EA6\uFF0C\u65E0\u9700\u8BBE\u7F6E\u3002"));
+  }
+  els.push(
+    hr(),
+    md("\u270D\uFE0F **\u63D0\u793A\u8BCD**"),
+    note("\u8BC4\u8BBA @\u6211 \u65F6\u6211\u7684\u89D2\u8272\u4E0E\u56DE\u590D\u89C4\u5219\uFF08\u542B\u600E\u4E48\u8BFB / \u6539\u6587\u6863\uFF09\u3002\u70B9\u5F00\u53EF\u76F4\u63A5\u5728\u5361\u91CC\u7F16\u8F91\u3002"),
+    actions([button("\u7F16\u8F91\u63D0\u793A\u8BCD", { a: DM.commentEditPrompt }, "primary")]),
+    hr(),
+    md("\u{1F4CE} **\u914D\u5408\u98DE\u4E66 CLI**"),
+    note(
+      `\u8BC4\u8BBA\u91CC\u8981**\u8BFB / \u6539\u6587\u6863**\uFF0C\u9760\u98DE\u4E66 CLI\uFF08lark-cli\uFF09\uFF1A\u88C5\u597D\u5E76\u767B\u5F55\u540E\u5373\u53EF\uFF08\u7528\u4F60\u81EA\u5DF1\u7684\u8EAB\u4EFD\u8BFB\u5199\u3001\u5BF9\u81EA\u5DF1\u7684\u6587\u6863\u6709\u6743\u9650\uFF09\u3002Tips\uFF1A\u98DE\u4E66 CLI \u53EF\u4E0E\u672C\u673A\u5668\u4EBA\u590D\u7528\u540C\u4E00\u4E2A App\u3002\u5B89\u88C5\u4E0E\u7528\u6CD5\u89C1 [\u98DE\u4E66 CLI \u6587\u6863](${LARK_CLI_DOC_URL})\u3002`
+    ),
+    hr(),
+    actions([button("\u2B05\uFE0F \u8FD4\u56DE\u8BBE\u7F6E", { a: DM.settings })])
+  );
+  return card(els, { header: { title: "\u{1F4DD} \u6587\u6863\u8BC4\u8BBA\u8BBE\u7F6E", template: "blue" } });
+}
+function buildCommentPromptCard(currentPrompt, notice, masterFile) {
+  return card(
+    [
+      ...notice ? [md(notice)] : [],
+      md("**\u270D\uFE0F \u8BC4\u8BBA\u63D0\u793A\u8BCD**"),
+      note("\u8BC4\u8BBA @\u6211 \u65F6\u6211\u7684\u56FA\u5B9A\u4EBA\u8BBE\u4E0E\u56DE\u590D\u89C4\u5219\u2014\u2014\u4FDD\u5B58\u540E\u4F1A\u540C\u6B65\u5230\u6240\u6709\u6587\u6863\uFF08\u542B\u5386\u53F2\uFF09\uFF0C\u4E0B\u4E00\u6761\u8BC4\u8BBA\u751F\u6548\u3002"),
+      md(
+        [
+          "**\u53EF\u7528\u53D8\u91CF**\uFF08\u540C\u6B65\u5230\u6BCF\u7BC7\u6587\u6863\u65F6\u81EA\u52A8\u66FF\u6362\u6210\u8BE5\u6587\u6863\u81EA\u5DF1\u7684\u503C\uFF09\uFF1A",
+          "- `{docUrl}` \u6587\u6863\u94FE\u63A5",
+          "- `{fileToken}` \u6587\u6863 token\uFF08\u94FE\u63A5\u91CC\u7C7B\u578B\u540E\u90A3\u6BB5\uFF09",
+          "- `{fileType}` \u6587\u6863\u7C7B\u578B\uFF0C\u53D6\u503C\uFF1A",
+          "    - `doc`/`docx`\uFF08\u98DE\u4E66\u4E91\u6587\u6863\uFF09",
+          "    - `sheet`\uFF08\u98DE\u4E66\u8868\u683C\uFF09",
+          "    - `bitable`\uFF08\u591A\u7EF4\u8868\u683C\uFF09"
+        ].join("\n")
+      ),
+      note("\u8BC4\u8BBA\u7684\u9009\u4E2D\u539F\u6587\u3001\u7528\u6237\u95EE\u9898\u6BCF\u8F6E\u4F1A\u81EA\u52A8\u7ED9\u6211\uFF0C\u65E0\u9700\u5199\u8FDB\u63D0\u793A\u8BCD\u3002"),
+      form("comment_prompt", [
+        input({
+          name: "prompt",
+          label: "\u63D0\u793A\u8BCD\u5185\u5BB9",
+          value: currentPrompt,
+          required: true,
+          inputType: "multiline_text",
+          rows: 12,
+          width: "fill",
+          maxLength: 1e3
+          // Feishu input hard cap (range 1–1000); longer prompts → edit master file
+        }),
+        // 两个都是 form 提交按钮（普通 button 在 form 内不保证触发）：保存读输入框内容落盘；
+        // 重置忽略输入框、直接把内置默认写回 master 并同步（handler 端处理）。
+        actions([
+          submitButton("\u2705 \u4FDD\u5B58\u63D0\u793A\u8BCD", { a: DM.commentPromptSubmit }, "primary", "submit_prompt"),
+          submitButton("\u21A9\uFE0F \u91CD\u7F6E\u4E3A\u9ED8\u8BA4", { a: DM.commentResetPrompt }, "default", "reset_prompt")
+        ])
+      ]),
+      hr(),
+      md("**\u{1F4E8} \u6BCF\u8F6E\u8BC4\u8BBA @\u6211\uFF0C\u6211\u4F1A\u6536\u5230\u4E0B\u9762\u6D88\u606F\uFF1A**"),
+      md(
+        [
+          "\u6211\u5728\u98DE\u4E66\u4E91\u6587\u6863\u7684\u8BC4\u8BBA\u91CC @\u4E86\u4F60\u3002\u6587\u6863\u4FE1\u606F\uFF1A",
+          "- \u94FE\u63A5\uFF1A{docUrl}",
+          "- file_token\uFF1A{fileToken}",
+          "- \u7C7B\u578B\uFF1A{fileType}",
+          "- \u8BC4\u8BBA\u8303\u56F4\uFF1A\u884C\u5185\u8BC4\u8BBA\uFF08\u9488\u5BF9\u9009\u4E2D\u6587\u5B57\uFF09 / \u5168\u6587\u8BC4\u8BBA\uFF08\u9488\u5BF9\u6574\u7BC7\uFF09",
+          "",
+          // 空行结束列表，否则下一行被并进「评论范围」那个 bullet
+          "\u7528\u6237\u9009\u4E2D\u7684\u539F\u6587\uFF1A\uFF08\u4EC5\u884C\u5185\u8BC4\u8BBA\u65F6\u9644\u4E0A\uFF09",
+          "> \u2026\u2026\u88AB\u8BC4\u8BBA\u7684\u90A3\u6BB5\u6587\u5B57\u2026\u2026",
+          "",
+          // 空行结束引用，否则「用户的问题」被并进引用块
+          "\u7528\u6237\u7684\u95EE\u9898\uFF1A\u2026\u2026\u8BC4\u8BBA\u6B63\u6587\u2026\u2026"
+        ].join("\n")
+      ),
+      note(
+        masterFile ? `\u63D0\u793A\u8BCD\u4E5F\u53EF\u76F4\u63A5\u7F16\u8F91 ${masterFile}\uFF08\u6539\u6587\u4EF6\u540E\u65B0\u5185\u5BB9\u5728\u6BCF\u7BC7\u6587\u6863\u7684\u4E0B\u4E00\u6761\u8BC4\u8BBA\u65F6\u751F\u6548\uFF09\u3002` : "\u63D0\u793A\u8BCD\u4E5F\u53EF\u76F4\u63A5\u7F16\u8F91 bot \u76EE\u5F55\u4E0B\u7684 comment-instructions.md\u3002"
+      ),
+      actions([button("\u2B05\uFE0F \u8FD4\u56DE", { a: DM.commentSettings })])
+    ],
+    { header: { title: "\u270D\uFE0F \u7F16\u8F91\u63D0\u793A\u8BCD", template: "blue" }, widthMode: "fill" }
+  );
+}
 function buildWatchdogCustomCard(cfg) {
   const cur = cfg.preferences?.runIdleTimeoutSeconds ?? 120;
   return card(
@@ -10409,7 +10607,9 @@ function weaveSender(text, sender) {
 
 // src/bot/comments.ts
 init_logger();
-var SUPPORTED_FILE_TYPES = /* @__PURE__ */ new Set(["doc", "docx", "sheet", "file"]);
+import { mkdir as mkdir14, readdir as readdir4, readFile as readFile12, writeFile as writeFile11 } from "fs/promises";
+import { dirname as dirname12, join as join19 } from "path";
+var SUPPORTED_FILE_TYPES = /* @__PURE__ */ new Set(["doc", "docx", "sheet", "bitable"]);
 var REPLY_MAX_CHARS = 2e3;
 function apiErrCode(err) {
   return err?.response?.data?.code;
@@ -10504,10 +10704,80 @@ var DOC_HOSTS = {
   feishu: "feishu.cn",
   lark: "larksuite.com"
 };
+var DOC_URL_PATH = {
+  doc: "docs",
+  docx: "docx",
+  sheet: "sheets",
+  bitable: "base"
+};
+function buildDocUrl(tenant, fileType, fileToken) {
+  const seg = DOC_URL_PATH[fileType] ?? fileType;
+  return `https://${DOC_HOSTS[tenant]}/${seg}/${fileToken}`;
+}
+var DEFAULT_COMMENT_INSTRUCTIONS = `# \u98DE\u4E66\u4E91\u6587\u6863\u8BC4\u8BBA\u52A9\u624B
+
+\u4F60\u88AB @ \u5728\u4E00\u7BC7\u98DE\u4E66\u4E91\u6587\u6863\uFF08{docUrl}\uFF0C\u7C7B\u578B {fileType}\uFF0Cfile_token\uFF1A{fileToken}\uFF09\u7684\u8BC4\u8BBA\u91CC\u3002\u7CFB\u7EDF\u4F1A\u628A\u4F60\u8FD9\u4E00\u8F6E\u7684\u6700\u7EC8\u56DE\u590D\u81EA\u52A8\u8D34\u56DE\u8FD9\u6761\u8BC4\u8BBA\u3002\u6BCF\u8F6E\u8FD8\u4F1A\u7ED9\u4F60\u8BC4\u8BBA\u8303\u56F4\u548C\uFF08\u884C\u5185\u8BC4\u8BBA\u65F6\uFF09\u9009\u4E2D\u7684\u539F\u6587\u3002
+
+## \u600E\u4E48\u505A
+- \u9700\u8981\u770B\u6B63\u6587\uFF0C\u6216\u7528\u6237\u8981\u6C42"\u5E2E\u6211\u6539 / \u4F18\u5316 / \u91CD\u5199 / \u7EC6\u5316\u8FD9\u6BB5"\u65F6\uFF0C\u7528 lark-cli \u8BFB / \u6539\u8FD9\u7BC7\u6587\u6863\uFF08{fileToken}\uFF09\u3002
+- \u6539\u6587\u6863\u65F6\u7EDD\u4E0D\u8981\u5220\u9664\u6216\u6574\u6BB5\u66FF\u6362"\u88AB\u8BC4\u8BBA\u7684\u539F\u6587"\uFF08\u672C\u8F6E\u7ED9\u4F60\u7684\u9009\u4E2D\u539F\u6587\uFF09\u2014\u2014\u98DE\u4E66\u8BC4\u8BBA\u951A\u5B9A\u5728\u8FD9\u6BB5\u6587\u5B57\u4E0A\uFF0C\u5220\u4E86\u5B83\u8BC4\u8BBA\u4F1A\u53D8\u6210"\u539F\u6587\u5DF2\u88AB\u5220\u9664"\u3001\u79FB\u8FDB\u5386\u53F2\u8BC4\u8BBA\uFF0C\u6B63\u6587\u5C31\u770B\u4E0D\u5230\u4E86\u3002\u8981\u4FDD\u7559\u8FD9\u6BB5\u539F\u6587\uFF0C\u5728\u5B83\u4E4B\u540E\u6216\u5468\u56F4\u589E\u6539\uFF0C\u53EA\u52A8\u8FD9\u4E00\u5904\u3002
+- \u6539\u5B8C\u53EA\u56DE\u4E00\u53E5\u7B80\u77ED\u8BF4\u660E\uFF1B\u7528\u6237\u53EA\u662F\u63D0\u95EE\u5C31\u76F4\u63A5\u7B54\uFF0C\u4E0D\u6539\u4EFB\u4F55\u4E1C\u897F\u3002
+
+## \u5FC5\u987B\u9075\u5B88
+1. \u4E0D\u8981\u81EA\u5DF1\u53D1\u8868 / \u56DE\u590D / \u89E3\u51B3 / \u5220\u9664\u4EFB\u4F55\u98DE\u4E66\u8BC4\u8BBA\u2014\u2014\u7CFB\u7EDF\u4F1A\u81EA\u52A8\u628A\u4F60\u7684\u6700\u7EC8\u56DE\u590D\u8D34\u4E0A\u53BB\u3002
+2. \u53EA\u8F93\u51FA\u6700\u7EC8\u7B54\u6848\u672C\u8EAB\uFF0C\u4E0D\u8981\u590D\u8FF0\u5206\u6790\u8FC7\u7A0B\u6216"\u6211\u73B0\u5728\u53BB\u2026"\u3002
+3. \u5168\u7A0B\u7EAF\u6587\u672C\uFF1A\u4E0D\u8981\u4EFB\u4F55 markdown \u6807\u8BB0\uFF08** __ # - * > \u53CD\u5F15\u53F7 \u4E4B\u7C7B\uFF09\u3001\u4E0D\u8981\u4EE3\u7801\u5757\u3001\u4E0D\u8981\u8868\u683C\u2014\u2014\u8BC4\u8BBA\u6846\u4E0D\u6E32\u67D3\uFF0C\u4F1A\u539F\u6837\u663E\u793A\u8FD9\u4E9B\u7B26\u53F7\u3002\u8BED\u6C14\u7B80\u6D01\u76F4\u63A5\u3002
+`;
+function commentSessionKey(fileToken, commentId) {
+  return `doc:${fileToken}:${commentId}`;
+}
+function commentCwd(projectsRoot, fileType, fileToken) {
+  return join19(projectsRoot, `comment-${fileType}-${fileToken}`);
+}
+async function loadCommentInstructions(masterFile) {
+  try {
+    const existing = await readFile12(masterFile, "utf8");
+    return existing.trim() ? existing : DEFAULT_COMMENT_INSTRUCTIONS;
+  } catch {
+  }
+  await mkdir14(dirname12(masterFile), { recursive: true }).catch(() => void 0);
+  await writeFile11(masterFile, DEFAULT_COMMENT_INSTRUCTIONS, "utf8").catch(() => void 0);
+  return DEFAULT_COMMENT_INSTRUCTIONS;
+}
+async function syncCommentInstructions(cwd, instructions) {
+  await mkdir14(cwd, { recursive: true });
+  await Promise.all([
+    writeFile11(join19(cwd, "AGENTS.md"), instructions, "utf8"),
+    writeFile11(join19(cwd, "CLAUDE.md"), instructions, "utf8")
+  ]);
+}
+async function saveCommentInstructions(masterFile, content) {
+  await mkdir14(dirname12(masterFile), { recursive: true });
+  await writeFile11(masterFile, content, "utf8");
+}
+function renderCommentInstructions(template, tenant, fileType, fileToken) {
+  const docUrl = buildDocUrl(tenant, fileType, fileToken);
+  return template.replace(/\{fileType\}/g, fileType).replace(/\{fileToken\}/g, fileToken).replace(/\{docUrl\}/g, docUrl);
+}
+async function syncAllCommentInstructions(projectsRoot, rawTemplate, tenant) {
+  const entries = await readdir4(projectsRoot, { withFileTypes: true }).catch(() => []);
+  let synced = 0;
+  for (const e of entries) {
+    if (!e.isDirectory() || !e.name.startsWith("comment-")) continue;
+    const m = /^comment-([a-z]+)-(.+)$/.exec(e.name);
+    const fileType = m?.[1];
+    const fileToken = m?.[2];
+    if (!fileType || !fileToken) continue;
+    const rendered = renderCommentInstructions(rawTemplate, tenant, fileType, fileToken);
+    await syncCommentInstructions(join19(projectsRoot, e.name), rendered).catch(() => void 0);
+    synced++;
+  }
+  return synced;
+}
 function buildCommentPrompt(target, ctx, tenant) {
-  const docUrl = `https://${DOC_HOSTS[tenant]}/${target.fileType}/${target.fileToken}`;
+  const docUrl = buildDocUrl(tenant, target.fileType, target.fileToken);
   const parts = [];
-  parts.push("\u6211\u5728\u98DE\u4E66\u4E91\u6587\u6863\u7684\u8BC4\u8BBA\u91CC\u88AB @\u4E86\uFF0C\u9700\u8981\u4F60\u56DE\u7B54\u8BC4\u8BBA\u4E2D\u7684\u95EE\u9898\u3002\u6587\u6863\u4FE1\u606F\uFF1A");
+  parts.push("\u6211\u5728\u98DE\u4E66\u4E91\u6587\u6863\u7684\u8BC4\u8BBA\u91CC @\u4E86\u4F60\u3002\u6587\u6863\u4FE1\u606F\uFF1A");
   parts.push(`- \u94FE\u63A5\uFF1A${docUrl}`);
   parts.push(`- file_token\uFF1A${target.fileToken}`);
   parts.push(`- \u7C7B\u578B\uFF1A${target.fileType}`);
@@ -10519,20 +10789,6 @@ function buildCommentPrompt(target, ctx, tenant) {
   }
   parts.push("");
   parts.push(`\u7528\u6237\u7684\u95EE\u9898\uFF1A${ctx.question}`);
-  parts.push("");
-  parts.push(
-    `\u5982\u679C\u56DE\u7B54\u9700\u8981\u6587\u6863\u6B63\u6587\u5185\u5BB9\uFF0C\u53EF\u7528 lark-cli \u53EA\u8BFB\u5730\u83B7\u53D6\uFF08\u4EC5\u7528\u4E8E\u8BFB\u53D6\uFF0C\u4E0D\u8981\u7528\u5B83\u5199\u4EFB\u4F55\u4E1C\u897F\uFF09\uFF1A
-  lark-cli docs +fetch --doc ${target.fileToken} --api-version v2`
-  );
-  parts.push("");
-  parts.push("\u3010\u975E\u5E38\u91CD\u8981\uFF0C\u52A1\u5FC5\u9075\u5B88\u3011");
-  parts.push(
-    "1. \u4E0D\u8981\u81EA\u5DF1\u53BB\u53D1\u8868 / \u56DE\u590D / \u4FEE\u6539\u4EFB\u4F55\u98DE\u4E66\u8BC4\u8BBA\u6216\u6587\u6863\uFF08\u4E5F\u4E0D\u8981\u7528 lark-cli \u6216\u4EFB\u4F55\u5DE5\u5177\u53BB\u53D1\u8BC4\u8BBA\uFF09\u2014\u2014\u7CFB\u7EDF\u4F1A\u81EA\u52A8\u628A\u4F60\u4E0B\u9762\u7ED9\u51FA\u7684\u6700\u7EC8\u56DE\u590D\u53D1\u5230\u8FD9\u6761\u8BC4\u8BBA\u91CC\uFF0C\u4F60\u53EA\u7BA1\u628A\u7B54\u6848\u5199\u51FA\u6765\u3002"
-  );
-  parts.push("2. \u53EA\u8F93\u51FA\u8981\u53D1\u7ED9\u7528\u6237\u7684\u300C\u6700\u7EC8\u7B54\u6848\u300D\u672C\u8EAB\uFF0C\u4E0D\u8981\u590D\u8FF0\u5206\u6790\u8FC7\u7A0B\u3001\u6B65\u9AA4\u3001\u6216\u300C\u6211\u73B0\u5728\u53BB\u2026\u300D\u8FD9\u7C7B\u8BF4\u660E\u3002");
-  parts.push(
-    "3. \u7528\u7EAF\u6587\u672C\uFF0C\u4E0D\u8981\u7528 markdown \u6807\u8BB0\uFF08\u4E0D\u8981 ** __ # - * > ` \u4E4B\u7C7B\uFF09\uFF0C\u4E0D\u8981\u4EE3\u7801\u5757\uFF1B\u8BC4\u8BBA\u6846\u4E0D\u6E32\u67D3 markdown\uFF0C\u4F1A\u539F\u6837\u663E\u793A\u8FD9\u4E9B\u7B26\u53F7\u3002\u56DE\u7B54\u7B80\u6D01\u76F4\u63A5\u3002"
-  );
   return parts.join("\n");
 }
 function stripMarkdown(s) {
@@ -10912,6 +11168,7 @@ function createOrchestrator(channel, cfg, fallbackCwd, cliBridge) {
   }
   const active = /* @__PURE__ */ new Map();
   const docLocks = /* @__PURE__ */ new Map();
+  const commentInstrUsed = /* @__PURE__ */ new Map();
   const sema = new Semaphore(getMaxConcurrentRuns(cfg));
   const currentIdleMs = () => getRunIdleTimeoutMs(cfg) ?? 0;
   const resumePending = /* @__PURE__ */ new Map();
@@ -11760,10 +12017,13 @@ function createOrchestrator(channel, cfg, fallbackCwd, cliBridge) {
     if (opts?.render !== false) void patch(evt, renderSettings);
   }
   let cliHookStatuses;
-  async function renderSettings(refreshHooks = false) {
+  function renderSettings() {
+    return buildSettingsCard(cfg);
+  }
+  async function renderCoffeeSettings(refreshHooks = false) {
     if (refreshHooks || !cliHookStatuses) cliHookStatuses = await inspectCliBridgeHooks();
     const cliPrefs = getCliBridgePreferences(cfg);
-    const localAgents = cliBridgeSettingsSection({
+    const section = cliBridgeSettingsSection({
       enabled: cliPrefs.enabled,
       statuses: cliHookStatuses,
       canEnable: canEnableCliBridge(cfg),
@@ -11771,7 +12031,25 @@ function createOrchestrator(channel, cfg, fallbackCwd, cliBridge) {
       agents: cliPrefs.agents,
       keepAwake: cliPrefs.keepAwake.enabled
     });
-    return buildSettingsCard(cfg, localAgents);
+    return buildCoffeeSettingsCard(section);
+  }
+  function commentBackendOptions() {
+    return visibleCatalog().filter((e) => e.id === DEFAULT_BACKEND_ID || isBackendEntryInstalled(e)).map((e) => ({ id: e.id, label: e.displayName }));
+  }
+  async function renderCommentSettings(notice) {
+    const comments = getCommentsConfig(cfg);
+    const models = await listModels(backendFor(comments.backend)).catch(() => []);
+    return buildCommentSettingsCard(cfg, commentBackendOptions(), models, notice);
+  }
+  function applyCommentsPref(evt, mut) {
+    if (!dmAdmin(evt.operator?.openId)) return;
+    const prefs = { ...cfg.preferences ?? {} };
+    const comments = { ...prefs.comments ?? {} };
+    mut(comments);
+    prefs.comments = comments;
+    cfg.preferences = prefs;
+    void saveConfig(cfg).catch((err) => log.fail("console", err, { phase: "save-config" }));
+    void patch(evt, () => renderCommentSettings());
   }
   const freshMenu = (evt) => {
     patch(evt, buildDmMenuCard({ webConsoleUrl: webConsoleUrl(), version: bridgeVersion() }));
@@ -11920,7 +12198,9 @@ function createOrchestrator(channel, cfg, fallbackCwd, cliBridge) {
     const page = typeof value.p === "number" ? value.p : Number(value.p) || 0;
     patch(evt, () => renderProjectList(page));
   }).on(DM.settings, async ({ evt }) => {
-    if (dmAdmin(evt.operator?.openId)) await patch(evt, () => renderSettings(true));
+    if (dmAdmin(evt.operator?.openId)) await patch(evt, renderSettings);
+  }).on(DM.coffeeSettings, async ({ evt }) => {
+    if (dmAdmin(evt.operator?.openId)) await patch(evt, () => renderCoffeeSettings(true));
   }).on(CLI.toggleEnabled, async ({ evt, value }) => {
     if (!dmAdmin(evt.operator?.openId)) return;
     const enabled = value.v === "on";
@@ -11940,7 +12220,7 @@ function createOrchestrator(channel, cfg, fallbackCwd, cliBridge) {
     } catch (err) {
       log.fail("cli-bridge", err, { phase: enabled ? "enable" : "disable" });
     }
-    void patch(evt, renderSettings);
+    void patch(evt, renderCoffeeSettings);
   }).on(CLI.repairHooks, async ({ evt }) => {
     if (!dmAdmin(evt.operator?.openId)) return;
     try {
@@ -11951,13 +12231,14 @@ function createOrchestrator(channel, cfg, fallbackCwd, cliBridge) {
     } catch (err) {
       log.fail("cli-bridge", err, { phase: "repair-hooks" });
     }
-    await patch(evt, () => renderSettings(true));
+    await patch(evt, () => renderCoffeeSettings(true));
   }).on(CLI.setNotifyScope, ({ evt, value }) => {
     if (!dmAdmin(evt.operator?.openId)) return;
     const scope = value.v === "bound_projects" || value.v === "none" ? value.v : "all";
     applyPref(evt, (p) => {
       p.cliBridge = { ...p.cliBridge ?? {}, notifyScope: scope };
-    });
+    }, { render: false });
+    void patch(evt, renderCoffeeSettings);
   }).on(CLI.toggleAgent, ({ evt, value }) => {
     if (!dmAdmin(evt.operator?.openId)) return;
     const agent = value.agent === "codex" ? "codex" : "claude";
@@ -11965,14 +12246,16 @@ function createOrchestrator(channel, cfg, fallbackCwd, cliBridge) {
     applyPref(evt, (p) => {
       const cur = p.cliBridge ?? {};
       p.cliBridge = { ...cur, agents: { ...cur.agents ?? {}, [agent]: on } };
-    });
+    }, { render: false });
+    void patch(evt, renderCoffeeSettings);
   }).on(CLI.toggleKeepAwake, ({ evt, value }) => {
     if (!dmAdmin(evt.operator?.openId)) return;
     const on = value.v === "on";
     applyPref(evt, (p) => {
       const cur = p.cliBridge ?? {};
       p.cliBridge = { ...cur, keepAwake: { ...cur.keepAwake ?? {}, enabled: on } };
-    });
+    }, { render: false });
+    void patch(evt, renderCoffeeSettings);
   }).on(DM.doctor, async ({ evt }) => {
     if (!dmAdmin(evt.operator?.openId)) return;
     await sendManagedCard(channel, evt.chatId, buildDoctorCard(await buildDoctorInfo()), evt.messageId).catch(
@@ -12114,6 +12397,78 @@ ${tail}` }, { replyTo: evt.messageId }).catch(() => void 0);
   }).on(DM.setConcurrency, ({ evt, value }) => {
     const n = Number(value.v);
     if (Number.isFinite(n)) applyPref(evt, (p) => p.maxConcurrentRuns = n);
+  }).on(DM.commentSettings, ({ evt }) => {
+    if (!dmAdmin(evt.operator?.openId)) return;
+    void patch(evt, () => renderCommentSettings());
+  }).on(DM.commentSetBackend, ({ evt, value }) => {
+    const v = typeof value.v === "string" ? value.v : void 0;
+    applyCommentsPref(evt, (c) => {
+      c.backend = v && backendIds().includes(v) ? v : void 0;
+      c.model = void 0;
+      c.effort = void 0;
+    });
+  }).on(DM.commentSubmit, ({ evt, formValue }) => {
+    if (!dmAdmin(evt.operator?.openId)) return;
+    const modelId = selectValue(formValue, "model");
+    const effort = asEffort(selectValue(formValue, "effort"));
+    applyCommentsPref(evt, (c) => {
+      if (modelId) c.model = modelId;
+      if (effort) c.effort = effort;
+    });
+  }).on(DM.commentEditPrompt, ({ evt }) => {
+    if (!dmAdmin(evt.operator?.openId)) return;
+    void patch(
+      evt,
+      async () => buildCommentPromptCard(
+        await loadCommentInstructions(paths.commentInstructionsFile),
+        void 0,
+        paths.commentInstructionsFile
+      )
+    );
+  }).on(DM.commentPromptSubmit, ({ evt, formValue }) => {
+    if (!dmAdmin(evt.operator?.openId)) return;
+    const content = typeof formValue?.prompt === "string" ? formValue.prompt : "";
+    void (async () => {
+      if (!content.trim()) {
+        const cur = await loadCommentInstructions(paths.commentInstructionsFile);
+        await patch(evt, buildCommentPromptCard(cur, "\u26A0\uFE0F \u63D0\u793A\u8BCD\u4E0D\u80FD\u4E3A\u7A7A\uFF0C\u672A\u4FDD\u5B58\u3002", paths.commentInstructionsFile));
+        return;
+      }
+      await saveCommentInstructions(paths.commentInstructionsFile, content).catch(
+        (err) => log.fail("console", err, { phase: "save-comment-prompt" })
+      );
+      const n = await syncAllCommentInstructions(paths.commentsRootDir, content, cfg.accounts.app.tenant).catch(
+        () => 0
+      );
+      await patch(
+        evt,
+        () => buildCommentPromptCard(
+          content,
+          `\u2705 \u63D0\u793A\u8BCD\u5DF2\u4FDD\u5B58\uFF0C\u5DF2\u540C\u6B65\u5230 ${n} \u4E2A\u6587\u6863\uFF08\u542B\u5386\u53F2\uFF09\uFF0C\u4E0B\u4E00\u6761\u8BC4\u8BBA\u751F\u6548\u3002`,
+          paths.commentInstructionsFile
+        )
+      );
+    })();
+  }).on(DM.commentResetPrompt, ({ evt }) => {
+    if (!dmAdmin(evt.operator?.openId)) return;
+    void (async () => {
+      await saveCommentInstructions(paths.commentInstructionsFile, DEFAULT_COMMENT_INSTRUCTIONS).catch(
+        (err) => log.fail("console", err, { phase: "reset-comment-prompt" })
+      );
+      const n = await syncAllCommentInstructions(
+        paths.commentsRootDir,
+        DEFAULT_COMMENT_INSTRUCTIONS,
+        cfg.accounts.app.tenant
+      ).catch(() => 0);
+      await patch(
+        evt,
+        () => buildCommentPromptCard(
+          DEFAULT_COMMENT_INSTRUCTIONS,
+          `\u21A9\uFE0F \u5DF2\u91CD\u7F6E\u4E3A\u9ED8\u8BA4\u63D0\u793A\u8BCD\uFF0C\u5DF2\u540C\u6B65\u5230 ${n} \u4E2A\u6587\u6863\uFF08\u542B\u5386\u53F2\uFF09\uFF0C\u4E0B\u4E00\u6761\u8BC4\u8BBA\u751F\u6548\u3002`,
+          paths.commentInstructionsFile
+        )
+      );
+    })();
   }).on(GS.setNoMention, ({ evt, value }) => {
     if (!isAdmin(cfg, evt.operator?.openId ?? "")) return;
     const on = value.v === "on";
@@ -12932,18 +13287,39 @@ ${tail}` }, { replyTo: evt.messageId }).catch(() => void 0);
       if (!evt.mentionedBot) return log.info("comment", "skip", { reason: "not-mentioned" });
       if (!SUPPORTED_FILE_TYPES.has(evt.fileType))
         return log.info("comment", "skip", { reason: "unsupported-fileType", fileType: evt.fileType });
+      const operatorId = evt.operator?.openId ?? "";
+      if (!isAdmin(cfg, operatorId))
+        return log.info("comment", "skip", { reason: "not-admin", sender: operatorId.slice(-6) || "(unknown)" });
       const resolved = await resolveComment(channel, evt);
       if (!resolved) return log.info("comment", "skip", { reason: "no-target-or-empty" });
       const { target, ctx } = resolved;
       log.info("comment", "parsed", { isWhole: ctx.isWhole, hasQuote: Boolean(ctx.quote) });
-      const prompt = buildCommentPrompt(target, ctx, cfg.accounts.app.tenant);
-      const sessionKey = `doc:${evt.fileToken}`;
+      const sessionKey = commentSessionKey(target.fileToken, evt.commentId);
+      const cwd = commentCwd(paths.commentsRootDir, target.fileType, target.fileToken);
+      const rawInstructions = await loadCommentInstructions(paths.commentInstructionsFile);
+      const instructions = renderCommentInstructions(
+        rawInstructions,
+        cfg.accounts.app.tenant,
+        target.fileType,
+        target.fileToken
+      );
+      let synced = true;
+      await syncCommentInstructions(cwd, instructions).catch((err) => {
+        synced = false;
+        log.warn("comment", "sync-instructions-failed", { err: err instanceof Error ? err.message : String(err) });
+      });
+      const facts = buildCommentPrompt(target, ctx, cfg.accounts.app.tenant);
+      const prompt = synced ? facts : `${instructions}
+
+---
+
+${facts}`;
       const reacted = ctx.targetReplyId ? await addCommentReaction(channel, target, ctx.targetReplyId) : false;
       try {
         await withDocLock(sessionKey, async () => {
           const release2 = await sema.acquire();
           try {
-            const thread = await resolveDocThread(sessionKey, ctx.question);
+            const thread = await resolveDocThread(sessionKey, cwd, instructions, ctx.question);
             const rec = await getSession(sessionKey);
             const run = thread.runStreamed({ text: prompt }, { model: rec?.model, effort: rec?.effort });
             let state = initialState;
@@ -12957,6 +13333,7 @@ ${tail}` }, { replyTo: evt.messageId }).catch(() => void 0);
               if (tid) void thread.abort(tid).catch(() => void 0);
               void thread.close().catch(() => void 0);
               sessions.delete(sessionKey);
+              commentInstrUsed.delete(sessionKey);
             } else {
               touchSession(sessionKey);
               await patchSession(sessionKey, { updatedAt: Date.now() });
@@ -12994,12 +13371,15 @@ ${tail}` }, { replyTo: evt.messageId }).catch(() => void 0);
     });
     return run;
   }
-  async function resolveDocThread(sessionKey, question) {
+  async function resolveDocThread(sessionKey, cwd, instructions, question) {
     const live = sessions.get(sessionKey);
     if (live) {
-      if (live.isAlive()) return live;
+      const alive = live.isAlive();
+      if (alive && commentInstrUsed.get(sessionKey) === instructions) return live;
+      if (alive && commentInstrUsed.get(sessionKey) !== instructions) void live.close().catch(() => void 0);
       sessions.delete(sessionKey);
-      log.info("agent", "dead-thread-evict", { sessionKey });
+      commentInstrUsed.delete(sessionKey);
+      log.info("agent", alive ? "comment-instr-changed-evict" : "dead-thread-evict", { sessionKey });
     }
     const rec = await getSession(sessionKey);
     if (rec) {
@@ -13011,20 +13391,27 @@ ${tail}` }, { replyTo: evt.messageId }).catch(() => void 0);
           effort: rec.effort
         });
         trackSession(sessionKey, resumed);
+        commentInstrUsed.set(sessionKey, instructions);
         return resumed;
       } catch (err) {
         log.fail("agent", err, { phase: "comment-resume", sessionKey });
       }
     }
-    const { model, effort } = pickDefault(await listModels());
-    const fresh = await backend.startThread({ cwd: fallbackCwd, model, effort });
+    const comments = getCommentsConfig(cfg);
+    const be = backendFor(comments.backend);
+    const { model, effort } = pickDefault(await listModels(be), {
+      model: comments.model,
+      effort: comments.effort
+    });
+    const fresh = await be.startThread({ cwd, model, effort });
     trackSession(sessionKey, fresh);
+    commentInstrUsed.set(sessionKey, instructions);
     await upsertSession({
       threadId: sessionKey,
       chatId: sessionKey,
-      cwd: fallbackCwd,
+      cwd,
       sessionId: fresh.sessionId,
-      backend: backend.id,
+      backend: be.id,
       model,
       effort,
       summary: question.slice(0, 80),
@@ -13426,7 +13813,7 @@ function createAdminIpcResponder(execute, send) {
 // src/admin/service.ts
 init_bots();
 init_paths();
-import { readFile as readFile12, rm as rm7 } from "fs/promises";
+import { readFile as readFile13, rm as rm7 } from "fs/promises";
 init_schema();
 init_store();
 init_schema();
@@ -13498,8 +13885,8 @@ init_logger();
 
 // src/admin/host.ts
 init_paths();
-import { readdir as readdir4, stat as stat4 } from "fs/promises";
-import { dirname as dirname12, join as join20, resolve as resolve8 } from "path";
+import { readdir as readdir5, stat as stat4 } from "fs/promises";
+import { dirname as dirname13, join as join21, resolve as resolve8 } from "path";
 import { fileURLToPath as fileURLToPath5 } from "url";
 import { arch, platform as platform2, release } from "os";
 function toDaemonStatus(opts) {
@@ -13523,12 +13910,12 @@ async function dirBytes(dir) {
   let total = 0;
   let entries;
   try {
-    entries = await readdir4(dir);
+    entries = await readdir5(dir);
   } catch {
     return 0;
   }
   for (const name of entries) {
-    const full = join20(dir, name);
+    const full = join21(dir, name);
     try {
       const st = await stat4(full);
       if (st.isDirectory()) total += await dirBytes(full);
@@ -13538,7 +13925,7 @@ async function dirBytes(dir) {
   }
   return total;
 }
-async function collectHostDoctor(logsDir2 = join20(paths.appDir, "logs")) {
+async function collectHostDoctor(logsDir2 = join21(paths.appDir, "logs")) {
   return {
     node: process.version,
     platform: platform2(),
@@ -13551,7 +13938,7 @@ async function collectHostDoctor(logsDir2 = join20(paths.appDir, "logs")) {
   };
 }
 function resolveCliBinPath3() {
-  const distDir = dirname12(fileURLToPath5(import.meta.url));
+  const distDir = dirname13(fileURLToPath5(import.meta.url));
   return resolve8(distDir, "..", "bin", "feishu-codex-bridge.mjs");
 }
 function buildDaemonControlCommand(action, binPath = resolveCliBinPath3(), nodePath = process.execPath) {
@@ -13599,7 +13986,7 @@ function createAdminService(deps = {}) {
   }
   async function lockFileRunState(botId) {
     try {
-      const raw = await readFile12(botPaths(botId).processesFile, "utf8");
+      const raw = await readFile13(botPaths(botId).processesFile, "utf8");
       const rec = JSON.parse(raw);
       if (typeof rec.pid === "number" && isAlive2(rec.pid)) {
         return { running: true, pid: rec.pid, startedAt: rec.startedAt };
@@ -14127,7 +14514,7 @@ import { createServer } from "http";
 import { randomUUID as randomUUID7, timingSafeEqual } from "crypto";
 import { mkdirSync as mkdirSync3, watch } from "fs";
 import { open as open2, stat as stat5 } from "fs/promises";
-import { join as join21 } from "path";
+import { join as join22 } from "path";
 
 // src/web/ui.ts
 var UI_PURE_JS = `
@@ -16802,7 +17189,7 @@ var SSE_INITIAL_TAIL_BYTES = 16 * 1024;
 function createWebServer(opts) {
   const token = opts.token ?? randomUUID7();
   const html = opts.html ?? UI_HTML;
-  const logDir = opts.logDir ?? join21(paths.appDir, "logs");
+  const logDir = opts.logDir ?? join22(paths.appDir, "logs");
   const sseCleanups = /* @__PURE__ */ new Set();
   const installJobs = /* @__PURE__ */ new Map();
   let qrSession = null;
@@ -17440,7 +17827,7 @@ function isLoopbackOrigin(origin) {
   }
 }
 function todayLogFile(dir) {
-  return join21(dir, `${(/* @__PURE__ */ new Date()).toISOString().slice(0, 10)}.log`);
+  return join22(dir, `${(/* @__PURE__ */ new Date()).toISOString().slice(0, 10)}.log`);
 }
 function clampInt(raw, min, max, fallback) {
   const n = Number(raw);
@@ -17643,7 +18030,7 @@ async function runSupervisor(bots) {
 // src/core/single-instance.ts
 init_paths();
 import { mkdirSync as mkdirSync4, readFileSync as readFileSync6, statSync as statSync3, unlinkSync as unlinkSync2, writeFileSync as writeFileSync3 } from "fs";
-import { dirname as dirname13 } from "path";
+import { dirname as dirname14 } from "path";
 var CLAIM_ATTEMPTS = 5;
 var PID_REUSE_SLACK_MS = 15e3;
 var EMPTY_LOCK_STALE_MS = 2e3;
@@ -17689,7 +18076,7 @@ function isLiveHolder(rec, appId) {
   return true;
 }
 function acquireSingleInstanceLock(appId, file = paths.processesFile) {
-  mkdirSync4(dirname13(file), { recursive: true });
+  mkdirSync4(dirname14(file), { recursive: true });
   const record = { pid: process.pid, appId, startedAt: Date.now() };
   for (let attempt = 0; attempt < CLAIM_ATTEMPTS; attempt++) {
     try {

package/dist/index.d.ts

@@ -26,6 +26,14 @@ declare const paths: {
     readonly projectsFile: string;
     /** 在跑的 start 进程注册中心（同 App 冲突检测；当前 bot） */
     readonly processesFile: string;
+    /** 云文档评论 @bot 的可编辑提示词 master 文件（当前 bot）。用户直接编辑这一份，
+     * 桥在每条评论运行前把它同步进该文档的评论工作目录（AGENTS.md / CLAUDE.md）。
+     * 首次缺失时由 bot/comments.ts 用内置默认模板自动落地。 */
+    readonly commentInstructionsFile: string;
+    /** 评论工作目录根（**当前 bot**）：每个被评论文档一个 `comment-<type>-<token>` 子目录，
+     * 放同步进去的 AGENTS.md / CLAUDE.md。放 per-bot 目录下，与其它 bot 隔离——否则
+     * 编辑提示词时的「全量同步」会越界改到别的 bot 的评论目录。 */
+    readonly commentsRootDir: string;
     /**
      * Local CLI hook IPC endpoint for the current bot. macOS/Linux use a Unix
      * domain socket file; Windows has none, so Node maps a `\\.\pipe\…` path to a

package/dist/index.js

@@ -34,6 +34,18 @@ var paths = {
   get processesFile() {
     return join(currentBotDir, "processes.json");
   },
+  /** 云文档评论 @bot 的可编辑提示词 master 文件（当前 bot）。用户直接编辑这一份，
+   * 桥在每条评论运行前把它同步进该文档的评论工作目录（AGENTS.md / CLAUDE.md）。
+   * 首次缺失时由 bot/comments.ts 用内置默认模板自动落地。 */
+  get commentInstructionsFile() {
+    return join(currentBotDir, "comment-instructions.md");
+  },
+  /** 评论工作目录根（**当前 bot**）：每个被评论文档一个 `comment-<type>-<token>` 子目录，
+   * 放同步进去的 AGENTS.md / CLAUDE.md。放 per-bot 目录下，与其它 bot 隔离——否则
+   * 编辑提示词时的「全量同步」会越界改到别的 bot 的评论目录。 */
+  get commentsRootDir() {
+    return join(currentBotDir, "comments");
+  },
   /**
    * Local CLI hook IPC endpoint for the current bot. macOS/Linux use a Unix
    * domain socket file; Windows has none, so Node maps a `\\.\pipe\…` path to a

package/package.json

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