@modelzen/feishu-codex-bridge 0.1.7 → 0.2.0

package/README.md

@@ -121,6 +121,8 @@ feishu-codex-bridge bot rm <名>     # 移除一个机器人配置
 
 > 「**文档评论回复**」功能另需 `docs:document.comment:read`、`docs:document.comment:create`、`wiki:wiki:readonly` 三项（见 `COMMENT_SCOPES`）。它们**已预勾选进同一个开通链接**，但**不属于** `REQUIRED_SCOPES` —— 不开通也不会卡住后台服务安装，只是该功能静默关闭。
 
+> 「**把我加进已有群**」功能另需 `im:chat:readonly`（读群名）、`im:chat.members:write_only`（解绑时机器人退群）两项（见 `JOIN_GROUP_SCOPES`）。同样**已预勾选进同一个开通链接**、**不属于** `REQUIRED_SCOPES`，不开通只是该功能静默关闭。
+
 ### 2）订阅事件 + 回调（长连接模式）
 
 `run` / `start` 初始化到这步会**自动打开**「**事件与回调**」页（`https://open.feishu.cn/app/<app_id>/event`）。这页顶部有「**事件配置**」「**回调配置**」两个独立标签，要分别配（飞书对事件/回调**既无开通 API、也无预选深链、连查询订阅状态的接口都没有**，只能手点）：
@@ -130,6 +132,8 @@ feishu-codex-bridge bot rm <名>     # 移除一个机器人配置
 - `im.message.receive_v1` —— 收群/私聊消息
 - `application.bot.menu_v6` —— 机器人菜单点击
 - `drive.notice.comment_add_v1` —— 云文档新增评论（**仅「文档评论回复」功能需要**；不加则该功能静默关闭，其余照常）
+- `im.chat.member.bot.added_v1` —— 机器人被加入群（**仅「把我加进已有群」功能需要**；触发私聊推送绑定卡，不加则拉我进群没反应）
+- `im.chat.member.bot.deleted_v1` —— 机器人被移出群（同上；触发自动解绑项目，不加则被踢后项目不会自动清理）
 
 **「回调配置」标签** → 「订阅方式」改**长连接** → 点「添加回调」：
 
@@ -267,9 +271,7 @@ src/
 - 🐛 **反馈 / 贡献**：<https://github.com/modelzen/feishu-codex-bridge/issues>
 - 👥 **交流群**：扫码加入「Vonvon 灵感研究所」👇
 
-<p align="center"><img src="docs/assets/vonvon-group-qr.png" alt="Vonvon 灵感研究所 群二维码" width="260"></p>
-
-> 该群二维码永久有效，扫码即可加入。
+<p align="center"><img src="docs/assets/vonvon-group-qr.png" alt="Vonvon 灵感研究所 群二维码" width="300"></p>
 
 ---
 

package/dist/cli.js

@@ -538,7 +538,7 @@ async function spawnExecProvider(pc, ref) {
   const timeoutMs = pc.noOutputTimeoutMs ?? DEFAULT_EXEC_TIMEOUT_MS;
   const maxOutput = pc.maxOutputBytes ?? DEFAULT_EXEC_MAX_OUTPUT;
   const providerName = ref.provider ?? DEFAULT_PROVIDER;
-  return new Promise((resolve5, reject) => {
+  return new Promise((resolve6, reject) => {
     const env = {};
     if (pc.passEnv) for (const k of pc.passEnv) {
       const v = process.env[k];
@@ -583,7 +583,7 @@ async function spawnExecProvider(pc, ref) {
       try {
         const parsed = JSON.parse(stdout);
         const value = parsed.values?.[ref.id];
-        if (typeof value === "string") return resolve5(value);
+        if (typeof value === "string") return resolve6(value);
         const err = parsed.errors?.[ref.id]?.message;
         reject(new Error(`exec provider did not return secret for ${ref.id}${err ? `: ${err}` : ""}`));
       } catch (err) {
@@ -679,7 +679,37 @@ var COMMENT_SCOPES = [
   "docs:document.comment:create",
   "wiki:wiki:readonly"
 ];
-var GRANT_SCOPES = [...REQUIRED_SCOPES, ...COMMENT_SCOPES];
+var JOIN_GROUP_SCOPES = [
+  "im:chat:readonly",
+  "im:chat.members:write_only"
+];
+var GRANT_SCOPES = [...REQUIRED_SCOPES, ...COMMENT_SCOPES, ...JOIN_GROUP_SCOPES];
+var SCOPE_LABELS = {
+  "im:message.group_at_msg:readonly": "\u63A5\u6536\u7FA4\u91CC @\u673A\u5668\u4EBA \u7684\u6D88\u606F",
+  "im:message.group_msg": "\u63A5\u6536\u7FA4\u5185\u6240\u6709\u6D88\u606F\uFF08\u514D@\uFF09",
+  "im:message.p2p_msg:readonly": "\u63A5\u6536\u79C1\u804A\u6D88\u606F\uFF08\u7BA1\u7406\u53F0\uFF09",
+  "im:message:send_as_bot": "\u53D1\u9001\u6D88\u606F / \u5361\u7247",
+  "im:message.pins:write_only": "\u7F6E\u9876\u6D88\u606F\u5230\u7FA4 Pin",
+  "im:message.reactions:write_only": "\u6D88\u606F\u8868\u60C5\u56DE\u590D\uFF08\u8FD0\u884C\u72B6\u6001\uFF09",
+  "im:resource": "\u56FE\u7247 / \u6587\u4EF6\u4E0A\u4F20\u4E0E\u4E0B\u8F7D",
+  "im:chat:create": "\u521B\u5EFA\u9879\u76EE\u7FA4",
+  "im:chat:update": "\u8F6C\u79FB\u7FA4\u4E3B\uFF08\u89E3\u7ED1\u65F6\uFF09",
+  "im:chat.managers:write_only": "\u8BBE\u7F6E\u7FA4\u7BA1\u7406\u5458",
+  "im:chat.announcement:read": "\u8BFB\u53D6\u7FA4\u516C\u544A",
+  "im:chat.announcement:write_only": "\u7F16\u8F91\u7FA4\u516C\u544A",
+  "im:chat.top_notice:write_only": "\u7F6E\u9876\u7FA4\u516C\u544A\u6A2A\u5E45",
+  "im:chat.tabs:write_only": "\u6DFB\u52A0\u7FA4\u6807\u7B7E\u9875",
+  "im:chat:readonly": "\u8BFB\u53D6\u7FA4\u4FE1\u606F\uFF08\u7FA4\u540D/\u7FA4\u4E3B\uFF0C\u52A0\u5165\u5B58\u91CF\u7FA4\u7528\uFF09",
+  "im:chat.members:write_only": "\u7FA4\u6210\u5458\u589E\u51CF\uFF08\u7ED1\u5B9A\u7684\u5B58\u91CF\u7FA4\u89E3\u7ED1\u65F6\u673A\u5668\u4EBA\u9000\u7FA4\uFF09",
+  "cardkit:card:write": "\u4EA4\u4E92\u6309\u94AE\u5361\u7247",
+  "docs:document.comment:read": "\u8BFB\u53D6\u6587\u6863\u8BC4\u8BBA",
+  "docs:document.comment:create": "\u53D1\u8868\u6587\u6863\u8BC4\u8BBA\u56DE\u590D",
+  "wiki:wiki:readonly": "\u8BFB\u53D6\u77E5\u8BC6\u5E93\u8282\u70B9"
+};
+function labelScope(scope) {
+  const label = SCOPE_LABELS[scope];
+  return label ? `${label}\uFF08${scope}\uFF09` : scope;
+}
 var HOSTS = {
   feishu: "open.feishu.cn",
   lark: "open.larksuite.com"
@@ -722,8 +752,15 @@ async function validateAppCredentials(appId, appSecret, tenant) {
   }
   const token = data.tenant_access_token;
   const info = await fetchBotInfo(base, token).catch(() => void 0);
-  const missingScopes = await fetchMissingScopes(base, token).catch(() => void 0);
-  return { ok: true, botName: info?.bot?.app_name, botOpenId: info?.bot?.open_id, missingScopes };
+  const granted = await fetchGrantedScopes(base, token).catch(() => void 0);
+  const missing = (list) => granted ? list.filter((s) => !granted.has(s)) : void 0;
+  return {
+    ok: true,
+    botName: info?.bot?.app_name,
+    botOpenId: info?.bot?.open_id,
+    missingScopes: missing(REQUIRED_SCOPES),
+    missingJoinScopes: missing(JOIN_GROUP_SCOPES)
+  };
 }
 async function fetchBotInfo(base, token) {
   const resp = await fetch(`${base}/open-apis/bot/v3/info`, {
@@ -732,15 +769,14 @@ async function fetchBotInfo(base, token) {
   if (!resp.ok) return void 0;
   return await resp.json();
 }
-async function fetchMissingScopes(base, token) {
+async function fetchGrantedScopes(base, token) {
   const resp = await fetch(`${base}/open-apis/application/v6/scopes`, {
     headers: { Authorization: `Bearer ${token}` }
   });
   if (!resp.ok) return void 0;
   const body = await resp.json();
   if (!body.data?.scopes) return void 0;
-  const granted = new Set(body.data.scopes.filter((s) => s.grant_status === 1).map((s) => s.scope_name));
-  return REQUIRED_SCOPES.filter((s) => !granted.has(s));
+  return new Set(body.data.scopes.filter((s) => s.grant_status === 1).map((s) => s.scope_name));
 }
 
 // src/utils/open-url.ts
@@ -1047,6 +1083,10 @@ async function confirmReadyForDaemon(result) {
   console.log("       \u2022 \uFF08\u53EF\u9009\uFF09\u60F3\u8981\u300C\u5728\u98DE\u4E66\u6587\u6863\u8BC4\u8BBA\u91CC @\u673A\u5668\u4EBA\u5C31\u81EA\u52A8\u56DE\u590D\u300D\uFF0C\u518D\u52A0\u8FD9\u4E00\u4E2A\u4E8B\u4EF6\uFF1A");
   console.log("           drive.notice.comment_add_v1\uFF08\u4E91\u6587\u6863\u65B0\u589E\u8BC4\u8BBA\uFF09");
   console.log("           \u5B83\u4F9D\u8D56\u300C\u6587\u6863\u8BC4\u8BBA\u300D\u6743\u9650\uFF08docs:document.comment:read / :create\uFF0C\u6388\u6743\u94FE\u63A5\u5DF2\u9884\u52FE\u9009\uFF09\uFF1B\u4E0D\u52A0\u5219\u8BE5\u529F\u80FD\u9759\u9ED8\u5173\u95ED\u3002");
+  console.log("       \u2022 \uFF08\u53EF\u9009\uFF09\u60F3\u8981\u300C\u628A\u6211\u52A0\u8FDB\u5DF2\u6709\u7FA4\u5C31\u80FD\u7ED1\u5B9A\u6210\u9879\u76EE\u300D\uFF0C\u518D\u52A0\u8FD9\u4E24\u4E2A\u4E8B\u4EF6\uFF1A");
+  console.log("           im.chat.member.bot.added_v1\uFF08\u673A\u5668\u4EBA\u88AB\u52A0\u5165\u7FA4 \u2192 \u79C1\u804A\u63A8\u9001\u7ED1\u5B9A\u5361\uFF09");
+  console.log("           im.chat.member.bot.deleted_v1\uFF08\u673A\u5668\u4EBA\u88AB\u79FB\u51FA\u7FA4 \u2192 \u81EA\u52A8\u89E3\u7ED1\u9879\u76EE\uFF09");
+  console.log("           \u5B83\u4EEC\u4F9D\u8D56\u300C\u7FA4\u4FE1\u606F/\u7FA4\u6210\u5458\u300D\u6743\u9650\uFF08im:chat:readonly / im:chat.members:write_only\uFF0C\u5DF2\u9884\u52FE\u9009\uFF09\uFF1B\u4E0D\u52A0\u5219\u8BE5\u529F\u80FD\u9759\u9ED8\u5173\u95ED\u3002");
   console.log("       \u2022 \u5207\u5230\u300C\u56DE\u8C03\u914D\u7F6E\u300D\u6807\u7B7E \u2192 \u300C\u8BA2\u9605\u65B9\u5F0F\u300D\u6539\u300C\u957F\u8FDE\u63A5\u300D\u2192 \u70B9\u300C\u6DFB\u52A0\u56DE\u8C03\u300D\u52FE\u9009\uFF1A");
   console.log("           card.action.trigger\uFF08\u5361\u7247\u56DE\u4F20\u4EA4\u4E92\uFF09");
   console.log("           \u26A0\uFE0F \u5B83\u662F\u300C\u56DE\u8C03\u300D\u4E0D\u662F\u300C\u4E8B\u4EF6\u300D\u2014\u2014\u5728\u4E0A\u9762\u300C\u6DFB\u52A0\u4E8B\u4EF6\u300D\u91CC\u641C\u4E0D\u5230\uFF0C\u5FC5\u987B\u5207\u5230\u300C\u56DE\u8C03\u914D\u7F6E\u300D\u8FD9\u4E2A\u6807\u7B7E\u3002");
@@ -1112,7 +1152,7 @@ var AsyncQueue = class {
         continue;
       }
       if (this.closed) return;
-      const next = await new Promise((resolve5) => this.waiters.push(resolve5));
+      const next = await new Promise((resolve6) => this.waiters.push(resolve6));
       if (next.done) return;
       yield next.value;
     }
@@ -1163,8 +1203,8 @@ var AppServerClient = class {
     const id = ++this.nextId;
     const payload = `${JSON.stringify({ jsonrpc: "2.0", id, method, params: params ?? {} })}
 `;
-    return new Promise((resolve5, reject) => {
-      this.pending.set(id, { resolve: resolve5, reject });
+    return new Promise((resolve6, reject) => {
+      this.pending.set(id, { resolve: resolve6, reject });
       this.child.stdin.write(payload, (err) => {
         if (err) {
           this.pending.delete(id);
@@ -1188,14 +1228,14 @@ var AppServerClient = class {
     const child = this.child;
     if (!child || child.exitCode !== null) return;
     child.kill("SIGTERM");
-    await new Promise((resolve5) => {
+    await new Promise((resolve6) => {
       const t = setTimeout(() => {
         if (child.exitCode === null) child.kill("SIGKILL");
-        resolve5();
+        resolve6();
       }, graceMs);
       child.once("exit", () => {
         clearTimeout(t);
-        resolve5();
+        resolve6();
       });
     });
   }
@@ -1312,14 +1352,28 @@ function mapItemComplete(item) {
 // src/agent/codex-appserver/backend.ts
 var APPROVAL_POLICY = "never";
 var SANDBOX = "danger-full-access";
+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",
+  "",
+  "1) \u56FE\u7247\uFF1A\u8981\u914D\u56FE\u65F6\uFF0C\u7528\u6807\u51C6 Markdown \u56FE\u7247\u8BED\u6CD5 ![\u8BF4\u660E](\u8DEF\u5F84) \u5F15\u7528\u4E00\u4E2A\u3010\u771F\u5B9E\u5B58\u5728\u3011\u7684\u56FE\u7247\uFF0C",
+  "\u98DE\u4E66\u6865\u4F1A\u81EA\u52A8\u4E0A\u4F20\u5E76\u5728\u98DE\u4E66\u91CC\u6E32\u67D3\u3002\u8DEF\u5F84\u53EF\u4EE5\u662F\u76F8\u5BF9\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55\u7684\u76F8\u5BF9\u8DEF\u5F84\u3001\u5DE5\u4F5C\u76EE\u5F55\u5185\u7684\u7EDD\u5BF9\u8DEF\u5F84\uFF0C",
+  "\u6216\u4E00\u4E2A http(s) \u56FE\u7247 URL\u3002\u7EDD\u4E0D\u8981\u7F16\u9020\u4E0D\u5B58\u5728\u7684\u56FE\u7247\u5360\u4F4D\uFF08\u4F8B\u5982\u5199 ![\u7BA1\u7406\u53F0\u622A\u56FE] \u5374\u6CA1\u6709\u5BF9\u5E94\u6587\u4EF6\uFF09\u2014\u2014",
+  "\u6CA1\u6709\u771F\u5B9E\u56FE\u7247\u5C31\u4E0D\u8981\u5199\u56FE\u7247\u8BED\u6CD5\u3002",
+  "",
+  "2) \u5361\u7247\uFF1A\u4EC5\u5F53\u7528\u6237\u660E\u786E\u8981\u6C42\u300C\u7528\u5361\u7247\u56DE\u590D / \u505A\u6210\u98DE\u4E66\u5361\u7247 / \u5361\u7247\u5F62\u5F0F\u5C55\u793A / changelog \u5361\u7247\u300D\u4E4B\u7C7B\u65F6\uFF0C",
+  "\u628A\u8981\u5C55\u793A\u7684\u5185\u5BB9\u5305\u8FDB\u4E00\u4E2A ```feishu-card \u4EE3\u7801\u5757\uFF0C\u5757\u5185\u7528 Markdown \u4E66\u5199\uFF1A",
+  "\u9996\u884C\u7528 `# \u6807\u9898` \u4F5C\u4E3A\u5361\u7247\u6807\u9898\u680F\uFF1B\u7528 `---` \u4F5C\u5206\u9694\u7EBF\uFF1B\u7528 `> \u6587\u5B57` \u4F5C\u7070\u8272\u6CE8\u811A\uFF1B",
+  "`**\u7C97\u4F53**`\u3001\u5217\u8868\u3001\u94FE\u63A5\u7167\u5E38\u4F7F\u7528\uFF1B\u914D\u56FE\u540C\u6837\u7528 ![\u8BF4\u660E](\u771F\u5B9E\u8DEF\u5F84)\u3002",
+  "\u4E0D\u8981\u624B\u5199\u98DE\u4E66\u5361\u7247\u7684 JSON\u3002\u666E\u901A\u95EE\u7B54\u6B63\u5E38\u56DE\u590D\u5373\u53EF\uFF0C\u53EA\u6709\u7528\u6237\u8981\u5361\u7247\u65F6\u624D\u7528 ```feishu-card \u4EE3\u7801\u5757\u3002"
+].join("\n");
 var READ_HISTORY_TIMEOUT_MS = 2e4;
 function withDeadline(p, ms, label) {
-  return new Promise((resolve5, reject) => {
+  return new Promise((resolve6, reject) => {
     const t = setTimeout(() => reject(new Error(`${label} timed out after ${ms}ms`)), ms);
     p.then(
       (v) => {
         clearTimeout(t);
-        resolve5(v);
+        resolve6(v);
       },
       (e) => {
         clearTimeout(t);
@@ -1359,11 +1413,11 @@ var CodexThread = class {
       if (self.model) params.model = self.model;
       if (self.effort) params.effort = self.effort;
       let startError;
-      const startFailed = new Promise((resolve5) => {
+      const startFailed = new Promise((resolve6) => {
         self.client.request("turn/start", params).then(void 0, (err) => {
           startError = err instanceof Error ? err : new Error(String(err));
           log.fail("agent", startError, { phase: "turn/start" });
-          resolve5("start-failed");
+          resolve6("start-failed");
         });
       });
       const stream2 = self.client.stream()[Symbol.asyncIterator]();
@@ -1487,6 +1541,7 @@ var CodexAppServerBackend = class {
       cwd: opts.cwd,
       approvalPolicy: APPROVAL_POLICY,
       sandbox: SANDBOX,
+      developerInstructions: BRIDGE_DEVELOPER_INSTRUCTIONS,
       ...opts.model ? { model: opts.model } : {}
     });
     return new CodexThread(client, res.thread.id, opts.model, opts.effort);
@@ -1498,6 +1553,7 @@ var CodexAppServerBackend = class {
       cwd: opts.cwd,
       approvalPolicy: APPROVAL_POLICY,
       sandbox: SANDBOX,
+      developerInstructions: BRIDGE_DEVELOPER_INSTRUCTIONS,
       ...opts.model ? { model: opts.model } : {}
     });
     return new CodexThread(client, res.thread.id, opts.model, opts.effort);
@@ -1667,7 +1723,7 @@ function stampRenderToken(card2) {
   };
   visit(card2);
 }
-async function sendManagedCard(channel, chatId, card2, replyTo, replyInThread = false) {
+async function sendManagedCard(channel, to, card2, replyTo, replyInThread = false, receiveIdType = "chat_id") {
   stampRenderToken(card2);
   const created = await channel.rawClient.cardkit.v1.card.create({
     data: { type: "card_json", data: JSON.stringify(card2) }
@@ -1686,8 +1742,8 @@ async function sendManagedCard(channel, chatId, card2, replyTo, replyInThread =
     messageId = sent.data?.message_id;
   } else {
     const sent = await channel.rawClient.im.v1.message.create({
-      params: { receive_id_type: "chat_id" },
-      data: { receive_id: chatId, msg_type: "interactive", content }
+      params: { receive_id_type: receiveIdType },
+      data: { receive_id: to, msg_type: "interactive", content }
     });
     messageId = sent.data?.message_id;
   }
@@ -1928,6 +1984,15 @@ function card(elements, opts = {}) {
 function md(content) {
   return { tag: "markdown", content };
 }
+function image(imgKey, alt = "") {
+  return {
+    tag: "img",
+    img_key: imgKey,
+    alt: { tag: "plain_text", content: alt },
+    mode: "fit_horizontal",
+    preview: true
+  };
+}
 function note(content) {
   return { tag: "div", text: { tag: "lark_md", content, text_size: "notation", text_color: "grey" } };
 }
@@ -2134,14 +2199,20 @@ function pickerTime(unixSeconds) {
   const md2 = `${p2(d.getMonth() + 1)}-${p2(d.getDate())}`;
   return d.getFullYear() === now.getFullYear() ? `${md2} ${hm}` : `${d.getFullYear()}-${md2} ${hm}`;
 }
-function buildHelpCard(scope) {
+function talkLine(noMention, tail) {
+  return noMention ? `\xB7 \u76F4\u63A5\u53D1\u6D88\u606F\uFF08\u514D@\uFF09\u2192 ${tail}` : `\xB7 **@\u6211 + \u5185\u5BB9** \u2192 ${tail}\uFF08\u672C\u7FA4\u9ED8\u8BA4\u9700 @\uFF1B\`/settings\` \u53EF\u5F00\u542F\u514D@\uFF09`;
+}
+function buildHelpCard(scope, noMention = true) {
   const elements = [];
   if (scope === "single") {
     elements.push(
       md("\u{1F4AC} **\u5355\u4F1A\u8BDD\u7FA4** \u2014 \u6574\u7FA4\u5C31\u662F\u4E00\u4E2A\u4F1A\u8BDD\uFF0C\u4E0A\u4E0B\u6587\u8FDE\u7EED\u3002"),
       hr(),
       md(
-        "\xB7 \u76F4\u63A5\u53D1\u6D88\u606F\uFF08\u514D@\uFF09\u2192 \u4EA4\u7ED9\u6211\u5904\u7406\n\xB7 `/model` \u2192 \u5207\u6362\u6A21\u578B / \u63A8\u7406\u5F3A\u5EA6\n\xB7 `/settings` \u2192 \u7FA4\u8BBE\u7F6E\uFF08\u514D@ \u5F00\u5173\uFF09\n\xB7 `/help` \u2192 \u8FD9\u5F20\u901F\u67E5\u5361"
+        `${talkLine(noMention, "\u4EA4\u7ED9\u6211\u5904\u7406")}
+\xB7 \`/model\` \u2192 \u5207\u6362\u6A21\u578B / \u63A8\u7406\u5F3A\u5EA6
+\xB7 \`/settings\` \u2192 \u7FA4\u8BBE\u7F6E\uFF08\u514D@ \u5F00\u5173\uFF09
+\xB7 \`/help\` \u2192 \u8FD9\u5F20\u901F\u67E5\u5361`
       )
     );
   } else if (scope === "topic") {
@@ -2149,7 +2220,9 @@ function buildHelpCard(scope) {
       md("\u{1F9F5} **\u8BDD\u9898\u5185** \u2014 \u6BCF\u4E2A\u8BDD\u9898\u662F\u4E00\u4E2A\u72EC\u7ACB\u4F1A\u8BDD\u3002"),
       hr(),
       md(
-        "\xB7 \u76F4\u63A5\u53D1\u6D88\u606F\uFF08\u514D@\uFF09\u2192 \u7EE7\u7EED\u5F53\u524D\u4F1A\u8BDD\n\xB7 `/model` \u2192 \u5207\u6362\u6A21\u578B / \u63A8\u7406\u5F3A\u5EA6\n\xB7 `/help` \u2192 \u8FD9\u5F20\u901F\u67E5\u5361"
+        `${talkLine(noMention, "\u7EE7\u7EED\u5F53\u524D\u4F1A\u8BDD")}
+\xB7 \`/model\` \u2192 \u5207\u6362\u6A21\u578B / \u63A8\u7406\u5F3A\u5EA6
+\xB7 \`/help\` \u2192 \u8FD9\u5F20\u901F\u67E5\u5361`
       ),
       note("\u5F00\u65B0\u8BDD\u9898\uFF1A\u56DE\u5230\u4E3B\u7FA4\u533A @\u6211 + \u5185\u5BB9\u3002")
     );
@@ -2164,7 +2237,7 @@ function buildHelpCard(scope) {
   }
   return card(elements, { header: { title: "\u{1F916} \u53EF\u7528\u547D\u4EE4", template: "blue" }, summary: "\u53EF\u7528\u547D\u4EE4" });
 }
-function buildWelcomeCard(kind, docUrl) {
+function buildWelcomeCard(kind, docUrl, noMention = true) {
   const elements = [
     md("\u{1F44B} **\u6B22\u8FCE\u4F7F\u7528 Codex Bridge** \u2014 \u672C\u7FA4\u5DF2\u7ED1\u5B9A\u4E00\u4E2A\u9879\u76EE\u76EE\u5F55\uFF0C\u5728\u7FA4\u91CC\u5C31\u80FD\u9A71\u52A8\u672C\u673A Codex \u5E72\u6D3B\u3002"),
     hr()
@@ -2173,7 +2246,10 @@ function buildWelcomeCard(kind, docUrl) {
     elements.push(
       md("\u{1F4AC} **\u5355\u4F1A\u8BDD\u7FA4**\uFF08\u6574\u7FA4\u4E00\u4E2A\u4F1A\u8BDD\uFF0C\u4E0A\u4E0B\u6587\u8FDE\u7EED\uFF09"),
       md(
-        "\xB7 \u76F4\u63A5\u53D1\u6D88\u606F\uFF08\u514D@\uFF09\u2192 \u4EA4\u7ED9\u6211\u5904\u7406\n\xB7 `/model` \u2192 \u5207\u6362\u6A21\u578B / \u63A8\u7406\u5F3A\u5EA6\n\xB7 `/settings` \u2192 \u7FA4\u8BBE\u7F6E\uFF08\u514D@ \u5F00\u5173\uFF09\n\xB7 `/help` \u2192 \u547D\u4EE4\u901F\u67E5\u5361"
+        `${talkLine(noMention, "\u4EA4\u7ED9\u6211\u5904\u7406")}
+\xB7 \`/model\` \u2192 \u5207\u6362\u6A21\u578B / \u63A8\u7406\u5F3A\u5EA6
+\xB7 \`/settings\` \u2192 \u7FA4\u8BBE\u7F6E\uFF08\u514D@ \u5F00\u5173\uFF09
+\xB7 \`/help\` \u2192 \u547D\u4EE4\u901F\u67E5\u5361`
       )
     );
   } else {
@@ -2337,6 +2413,92 @@ function truncateTail(s, n) {
   return t.length > n ? `\u2026${t.slice(t.length - n)}` : t;
 }
 
+// src/card/markdown-render.ts
+var NO_IMAGES = /* @__PURE__ */ new Map();
+var IMG_RE = /!\[([^\]]*)\]\(\s*(<[^>]+>|[^)\s]+)(?:\s+(?:"[^"]*"|'[^']*'))?\s*\)/g;
+var FENCE_RE = /```feishu-card[^\n]*\n([\s\S]*?)```/g;
+function cleanSrc(raw) {
+  let s = raw.trim();
+  if (s.startsWith("<") && s.endsWith(">")) s = s.slice(1, -1).trim();
+  return s;
+}
+function extractCardFences(text) {
+  const fences = [];
+  const re = new RegExp(FENCE_RE.source, "g");
+  const stripped = text.replace(re, (_full, inner) => {
+    fences.push(inner.trim());
+    return "";
+  });
+  return { fences, stripped };
+}
+function renderRichText(text, images = NO_IMAGES) {
+  const body = extractCardFences(text).stripped;
+  if (!body.includes("![")) {
+    const t = body.trim();
+    return t ? [md(t)] : [];
+  }
+  const els = [];
+  let buf = "";
+  const flush = () => {
+    const t = buf.trim();
+    if (t) els.push(md(t));
+    buf = "";
+  };
+  const re = new RegExp(IMG_RE.source, "g");
+  let last = 0;
+  let m;
+  while ((m = re.exec(body)) !== null) {
+    buf += body.slice(last, m.index);
+    const alt = m[1] ?? "";
+    const src = cleanSrc(m[2] ?? "");
+    const key = images.get(src);
+    if (key) {
+      flush();
+      els.push(image(key, alt));
+    } else {
+      buf += m[0];
+    }
+    last = m.index + m[0].length;
+  }
+  buf += body.slice(last);
+  flush();
+  return els;
+}
+function buildCleanCard(fenceMarkdown, images = NO_IMAGES, template = "blue") {
+  const lines = fenceMarkdown.split("\n");
+  let start = 0;
+  while (start < lines.length && lines[start]?.trim() === "") start++;
+  const headingMatch = lines[start]?.match(/^#{1,6}\s+(.+?)\s*$/);
+  const title = headingMatch ? headingMatch[1] : "";
+  if (headingMatch) start++;
+  const bodyMarkdown = lines.slice(start).join("\n").trim();
+  const elements = renderCleanBody(bodyMarkdown, images);
+  const body = elements.length > 0 ? elements : [md(title || "\xAD")];
+  return card(body, {
+    ...title ? { header: { title, template } } : {},
+    summary: title || "\u5361\u7247"
+  });
+}
+function renderCleanBody(bodyMarkdown, images) {
+  const out = [];
+  for (const raw of bodyMarkdown.split(/\n{2,}/)) {
+    const block = raw.trim();
+    if (!block) continue;
+    if (/^(-{3,}|\*{3,}|_{3,})$/.test(block)) {
+      out.push(hr());
+      continue;
+    }
+    const blockLines = block.split("\n");
+    if (blockLines.every((l) => l.trim() === "" || /^\s*>\s?/.test(l))) {
+      const noteText = blockLines.map((l) => l.replace(/^\s*>\s?/, "")).join("\n").trim();
+      if (noteText) out.push(note(noteText));
+      continue;
+    }
+    out.push(...renderRichText(block, images));
+  }
+  return out;
+}
+
 // src/card/tool-render.ts
 var HEADER_TITLE_MAX = 80;
 var OUTPUT_MAX = 1200;
@@ -2415,7 +2577,7 @@ function renderTerminal(state, rc) {
       })
     );
   }
-  if (answer) elements.push(md(answer));
+  if (answer) elements.push(...renderRichText(answer, rc.images));
   if (state.terminal === "interrupted") {
     elements.push(noteMd("_\u23F9 \u5DF2\u88AB\u4E2D\u65AD_"));
   } else if (state.terminal === "idle_timeout") {
@@ -2624,6 +2786,207 @@ var RunCardStream = class {
   }
 };
 
+// src/card/outbound-images.ts
+import { readFile as readFile5, stat as stat2 } from "fs/promises";
+import { extname, isAbsolute, resolve as resolve2, sep } from "path";
+var MAX_IMAGES = 9;
+var MAX_BYTES = 10 * 1024 * 1024;
+var DOWNLOAD_TIMEOUT_MS = 1e4;
+var ALLOWED_EXT = /* @__PURE__ */ new Set(["png", "jpg", "jpeg", "webp", "gif", "tif", "tiff", "bmp", "ico"]);
+var cache = /* @__PURE__ */ new Map();
+var IMG_RE2 = /!\[([^\]]*)\]\(\s*(<[^>]+>|[^)\s]+)(?:\s+(?:"[^"]*"|'[^']*'))?\s*\)/g;
+function cleanSrc2(raw) {
+  let s = raw.trim();
+  if (s.startsWith("<") && s.endsWith(">")) s = s.slice(1, -1).trim();
+  return s;
+}
+function imageSources(text) {
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  const re = new RegExp(IMG_RE2.source, "g");
+  let m;
+  while ((m = re.exec(text)) !== null) {
+    const src = cleanSrc2(m[2] ?? "");
+    if (src && !seen.has(src)) {
+      seen.add(src);
+      out.push(src);
+    }
+  }
+  return out;
+}
+async function uploadOutboundImages(channel, sources, cwd) {
+  const picked = sources.slice(0, MAX_IMAGES);
+  if (sources.length > picked.length) {
+    log.warn("outbound", "image-cap", { skipped: sources.length - picked.length });
+  }
+  const results = await Promise.all(
+    picked.map(async (src) => {
+      try {
+        return [src, await resolveAndUpload(channel, src, cwd)];
+      } catch (err) {
+        log.warn("outbound", "image-failed", { src: src.slice(0, 80), err: String(err) });
+        return [src, void 0];
+      }
+    })
+  );
+  const out = /* @__PURE__ */ new Map();
+  for (const [src, key] of results) if (key) out.set(src, key);
+  if (out.size > 0) log.info("outbound", "images", { want: sources.length, uploaded: out.size });
+  return out;
+}
+async function resolveAndUpload(channel, src, cwd) {
+  const { buffer, cacheKey } = await loadSource(src, cwd);
+  if (!buffer) return void 0;
+  const hit = cache.get(cacheKey);
+  if (hit) return hit;
+  const key = await uploadBuffer(channel, buffer);
+  if (key) cache.set(cacheKey, key);
+  return key;
+}
+async function loadSource(src, cwd) {
+  if (/^https?:\/\//i.test(src)) return loadRemote(src);
+  return loadLocal(src, cwd);
+}
+async function loadLocal(src, cwd) {
+  const cwdAbs = resolve2(cwd);
+  const abs = isAbsolute(src) ? resolve2(src) : resolve2(cwdAbs, src);
+  if (abs !== cwdAbs && !abs.startsWith(cwdAbs + sep)) {
+    log.warn("outbound", "image-outside-cwd", { src: src.slice(0, 80) });
+    return { cacheKey: `local:${abs}` };
+  }
+  const ext = extname(abs).slice(1).toLowerCase();
+  if (!ALLOWED_EXT.has(ext)) {
+    log.warn("outbound", "image-ext", { ext, src: src.slice(0, 80) });
+    return { cacheKey: `local:${abs}` };
+  }
+  let size;
+  let mtimeMs;
+  try {
+    const st = await stat2(abs);
+    if (!st.isFile()) throw new Error("not a file");
+    size = st.size;
+    mtimeMs = st.mtimeMs;
+  } catch {
+    log.warn("outbound", "image-missing", { src: src.slice(0, 80) });
+    return { cacheKey: `local:${abs}` };
+  }
+  if (size === 0 || size > MAX_BYTES) {
+    log.warn("outbound", "image-size", { size, src: src.slice(0, 80) });
+    return { cacheKey: `local:${abs}:${size}` };
+  }
+  const buffer = await readFile5(abs);
+  return { buffer, cacheKey: `local:${abs}:${mtimeMs}:${size}` };
+}
+async function loadRemote(url) {
+  const cacheKey = `url:${url}`;
+  const ctrl = new AbortController();
+  const timer = setTimeout(() => ctrl.abort(), DOWNLOAD_TIMEOUT_MS);
+  try {
+    const res = await fetch(url, { signal: ctrl.signal, redirect: "follow" });
+    if (!res.ok) {
+      log.warn("outbound", "image-http", { url: url.slice(0, 80), status: res.status });
+      return { cacheKey };
+    }
+    const ct = (res.headers.get("content-type") ?? "").split(";")[0]?.trim().toLowerCase();
+    if (ct && !ct.startsWith("image/")) {
+      log.warn("outbound", "image-ctype", { ct, url: url.slice(0, 80) });
+      return { cacheKey };
+    }
+    const declared = Number(res.headers.get("content-length") ?? 0);
+    if (declared > MAX_BYTES) {
+      log.warn("outbound", "image-size", { declared, url: url.slice(0, 80) });
+      return { cacheKey };
+    }
+    const ab = await res.arrayBuffer();
+    if (ab.byteLength === 0 || ab.byteLength > MAX_BYTES) {
+      log.warn("outbound", "image-size", { size: ab.byteLength, url: url.slice(0, 80) });
+      return { cacheKey };
+    }
+    return { buffer: Buffer.from(ab), cacheKey };
+  } catch (err) {
+    log.warn("outbound", "image-fetch", { url: url.slice(0, 80), err: String(err) });
+    return { cacheKey };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function uploadBuffer(channel, buffer) {
+  const res = await channel.rawClient.im.v1.image.create({
+    data: { image_type: "message", image: buffer }
+  });
+  const key = res?.image_key ?? res?.data?.image_key;
+  if (!key) {
+    log.warn("outbound", "image-no-key", { res: JSON.stringify(res).slice(0, 120) });
+    return void 0;
+  }
+  return key;
+}
+
+// src/project/registry.ts
+import { mkdir as mkdir4, readFile as readFile6, rename as rename4, writeFile as writeFile4 } from "fs/promises";
+import { dirname as dirname5 } from "path";
+function defaultNoMention(p) {
+  return !((p.origin ?? "created") === "joined" && (p.kind ?? "multi") === "single");
+}
+var FILE_VERSION2 = 1;
+async function read() {
+  try {
+    const text = await readFile6(paths.projectsFile, "utf8");
+    const parsed = JSON.parse(text);
+    return Array.isArray(parsed.projects) ? parsed.projects : [];
+  } catch (err) {
+    if (err.code === "ENOENT") return [];
+    throw err;
+  }
+}
+async function write(projects) {
+  await mkdir4(dirname5(paths.projectsFile), { recursive: true });
+  const tmp = `${paths.projectsFile}.tmp-${process.pid}`;
+  const body = { version: FILE_VERSION2, projects };
+  await writeFile4(tmp, `${JSON.stringify(body, null, 2)}
+`, "utf8");
+  await rename4(tmp, paths.projectsFile);
+}
+async function listProjects() {
+  return read();
+}
+async function getProjectByChatId(chatId) {
+  return (await read()).find((p) => p.chatId === chatId);
+}
+async function getProjectByName(name) {
+  return (await read()).find((p) => p.name === name);
+}
+async function addProject(p) {
+  const projects = await read();
+  if (projects.some((x) => x.name === p.name)) {
+    throw new Error(`\u9879\u76EE\u540D\u300C${p.name}\u300D\u5DF2\u5B58\u5728`);
+  }
+  if (p.chatId) {
+    const bound = projects.find((x) => x.chatId === p.chatId);
+    if (bound) throw new Error(`\u8BE5\u7FA4\u5DF2\u7ED1\u5B9A\u4E3A\u9879\u76EE\u300C${bound.name}\u300D`);
+  }
+  projects.push(p);
+  await write(projects);
+}
+async function updateProject(name, patch) {
+  const projects = await read();
+  const p = projects.find((x) => x.name === name);
+  if (!p) return;
+  const target = p;
+  for (const [k, v] of Object.entries(patch)) {
+    if (v !== void 0) target[k] = v;
+  }
+  await write(projects);
+}
+async function removeProject(name) {
+  const projects = await read();
+  const idx = projects.findIndex((p) => p.name === name);
+  if (idx === -1) return void 0;
+  const [removed] = projects.splice(idx, 1);
+  await write(projects);
+  return removed;
+}
+
 // src/card/dm-cards.ts
 function openChatUrl(chatId) {
   return `https://applink.feishu.cn/client/chat/open?openChatId=${encodeURIComponent(chatId)}`;
@@ -2633,6 +2996,7 @@ var DM = {
   menu: "dm.menu",
   newProject: "dm.newProject",
   newProjectSubmit: "dm.newProject.submit",
+  joinGroupSubmit: "dm.joinGroup.submit",
   projects: "dm.projects",
   settings: "dm.settings",
   doctor: "dm.doctor",
@@ -2780,11 +3144,33 @@ function scopeDiagnosis(i) {
     return [md("- \u98DE\u4E66\u6743\u9650\uFF1A\u2705 \u5FC5\u9700\u6743\u9650\u5DF2\u5168\u90E8\u5F00\u901A")];
   }
   return [
-    md(`- \u98DE\u4E66\u6743\u9650\uFF1A\u274C \u7F3A ${i.missingScopes.length} \u9879 \u2014\u2014 \u5F00\u901A\u524D\u76F8\u5173\u529F\u80FD\uFF08\u6536\u53D1\u6D88\u606F / \u5361\u7247 / \u5EFA\u7FA4\u7B49\uFF09\u4E0D\u53EF\u7528`),
-    note(`\u5F85\u5F00\u901A\uFF1A${i.missingScopes.join("\u3000")}`),
+    md(`- \u98DE\u4E66\u6743\u9650\uFF1A\u274C \u7F3A ${i.missingScopes.length} \u9879 \u2014\u2014 \u5F00\u901A\u524D\u76F8\u5173\u529F\u80FD\uFF08\u6536\u53D1\u6D88\u606F / \u5361\u7247 / \u56FE\u7247 / \u5EFA\u7FA4\u7B49\uFF09\u4E0D\u53EF\u7528`),
+    note(`\u5F85\u5F00\u901A\uFF1A
+${i.missingScopes.map((s) => `\xB7 ${labelScope(s)}`).join("\n")}`),
     actions([linkButton("\u{1F511} \u4E00\u952E\u53BB\u5F00\u901A\u8FD9\u4E9B\u6743\u9650", i.scopeGrantUrl)])
   ];
 }
+function joinFeatureDiagnosis(i) {
+  const out = [md("**\u52A0\u5165\u5B58\u91CF\u7FA4\uFF08\u53EF\u9009\uFF09**")];
+  if (i.missingJoinScopes === void 0) {
+    out.push(md("- \u6743\u9650\uFF1A\u26A0\uFE0F \u672A\u80FD\u81EA\u52A8\u68C0\u67E5\uFF08\u51ED\u636E\u5931\u6548\u6216\u7F51\u7EDC\u4E0D\u901A\uFF09"), actions([linkButton("\u{1F511} \u53BB\u5F00\u901A", i.joinScopeGrantUrl)]));
+  } else if (i.missingJoinScopes.length === 0) {
+    out.push(md("- \u6743\u9650\uFF1A\u2705 \u5DF2\u5F00\u901A\uFF08`im:chat:readonly` / `im:chat.members:write_only`\uFF09"));
+  } else {
+    out.push(
+      md(`- \u6743\u9650\uFF1A\u274C \u7F3A ${i.missingJoinScopes.length} \u9879 \u2014\u2014 \u5F00\u901A\u540E\u624D\u80FD\u628A\u6211\u52A0\u8FDB\u5DF2\u6709\u7FA4\uFF08\u7ED1\u5B9A / \u9000\u7FA4\uFF09`),
+      note(`\u5F85\u5F00\u901A\uFF1A
+${i.missingJoinScopes.map((s) => `\xB7 ${labelScope(s)}`).join("\n")}`),
+      actions([linkButton("\u{1F511} \u4E00\u952E\u5F00\u901A\u8FD9\u4E24\u9879\u6743\u9650", i.joinScopeGrantUrl)])
+    );
+  }
+  out.push(
+    note(
+      "\u26A0\uFE0F \u8FD8\u9700\u5728\u540E\u53F0\u300C\u4E8B\u4EF6\u4E0E\u56DE\u8C03\u300D\u624B\u52A8\u8BA2\u9605 `im.chat.member.bot.added_v1`\uFF08\u88AB\u62C9\u8FDB\u7FA4\u2192\u63A8\u9001\u7ED1\u5B9A\u5361\uFF09\u548C `im.chat.member.bot.deleted_v1`\uFF08\u88AB\u79FB\u51FA\u7FA4\u2192\u81EA\u52A8\u89E3\u7ED1\uFF09\u2014\u2014 \u98DE\u4E66\u65E0\u67E5\u8BE2\u63A5\u53E3\uFF0C\u8FD9\u91CC\u65E0\u6CD5\u81EA\u52A8\u68C0\u6D4B\u3002"
+    )
+  );
+  return out;
+}
 function codexDiagnosePrompt(i) {
   return [
     "\u6211\u5728\u7528 feishu-codex-bridge\uFF08\u98DE\u4E66 \u2194 \u672C\u5730 Codex \u6865\u63A5\uFF09\u9047\u5230\u95EE\u9898\uFF0C\u8BF7\u5E2E\u6211\u5B9A\u4F4D\u539F\u56E0\u5E76\u7ED9\u51FA\u4FEE\u590D\u6B65\u9AA4\u3002",
@@ -2827,6 +3213,8 @@ function buildDoctorCard(i) {
       ...scopeDiagnosis(i),
       note(`bridge v${i.bridgeVer}\u3000\xB7\u3000Node ${i.node}\u3000\xB7\u3000${i.platform}`),
       hr(),
+      ...joinFeatureDiagnosis(i),
+      hr(),
       md("**\u65E5\u5FD7\u8DEF\u5F84**"),
       note(`\u540E\u53F0\u5B88\u62A4\u8F93\u51FA\uFF1A\`${i.logStdout}\``),
       note(`\u540E\u53F0\u5B88\u62A4\u9519\u8BEF\uFF1A\`${i.logStderr}\``),
@@ -2860,14 +3248,35 @@ function buildNewProjectFormCard(opts = {}) {
   );
   return card(elements, { header: { title: "\u2795 \u65B0\u5EFA\u9879\u76EE", template: "turquoise" } });
 }
+function buildJoinGroupFormCard(opts) {
+  const elements = [];
+  if (opts.error) elements.push(md(`\u274C **\u7ED1\u5B9A\u5931\u8D25**\uFF1A${opts.error}`));
+  elements.push(
+    md("\u6211\u5DF2\u88AB\u52A0\u5165\u8FD9\u4E2A\u7FA4\u3002\u586B\u4E00\u4E0B\u8981\u7ED1\u5B9A\u7684\u9879\u76EE\u4FE1\u606F\u5373\u53EF\u5F00\u59CB\u7528\u3002"),
+    md("\u9879\u76EE\u540D\u9ED8\u8BA4\u7528\u7FA4\u540D\uFF0C\u53EF\u6539\u3002**\u6587\u4EF6\u5939\u8DEF\u5F84\u7559\u7A7A** = \u81EA\u52A8\u65B0\u5EFA\u7A7A\u767D\u9879\u76EE\uFF1B**\u586B\u7EDD\u5BF9\u8DEF\u5F84** = \u7528\u7535\u8111\u4E0A\u5DF2\u6709\u7684\u6587\u4EF6\u5939\u3002"),
+    form("join_group", [
+      input({ name: "name", label: "\u9879\u76EE\u540D", placeholder: "my-app", value: opts.name, required: true }),
+      input({ name: "cwd", label: "\u6587\u4EF6\u5939\u8DEF\u5F84\uFF08\u9009\u586B\uFF0C\u7559\u7A7A\u81EA\u52A8\u65B0\u5EFA\uFF09", placeholder: "/Users/you/code/my-app", value: opts.cwd }),
+      note("\u9009\u7FA4\u7C7B\u578B(\u76F4\u63A5\u70B9\u5BF9\u5E94\u6309\u94AE\u521B\u5EFA)\uFF1A\u{1F465} \u591A\u8BDD\u9898\u7FA4 = @\u6211\u5F00\u8BDD\u9898\u3001\u6BCF\u8BDD\u9898\u72EC\u7ACB\u4F1A\u8BDD\uFF1B\u{1F4AC} \u5355\u4F1A\u8BDD\u7FA4 = \u6574\u7FA4\u4E00\u4E2A\u4F1A\u8BDD\u3001\u8FDE\u7EED\u4E0A\u4E0B\u6587\uFF08\u9ED8\u8BA4\u4E0D\u514D@\uFF09\u3002"),
+      actions([
+        submitButton("\u{1F465} \u7ED1\u5B9A\xB7\u591A\u8BDD\u9898\u7FA4", { a: DM.joinGroupSubmit, kind: "multi", chatId: opts.chatId }, "primary", "submit_multi"),
+        submitButton("\u{1F4AC} \u7ED1\u5B9A\xB7\u5355\u4F1A\u8BDD\u7FA4", { a: DM.joinGroupSubmit, kind: "single", chatId: opts.chatId }, "primary", "submit_single")
+      ])
+    ])
+  );
+  return card(elements, { header: { title: "\u{1F517} \u7ED1\u5B9A\u5DF2\u6709\u7FA4", template: "turquoise" } });
+}
 function buildNewProjectDoneCard(p) {
+  const joined = (p.origin ?? "created") === "joined";
+  const verb = joined ? "\u5DF2\u7ED1\u5B9A\u7FA4" : "\u5DF2\u521B\u5EFA\u9879\u76EE";
+  const title = joined ? "\u{1F517} \u7ED1\u5B9A\u5DF2\u6709\u7FA4" : "\u2795 \u65B0\u5EFA\u9879\u76EE";
   const elements = [
-    md(`\u2705 \u5DF2\u521B\u5EFA\u9879\u76EE **${p.name}**${p.blank ? " _(\u7A7A\u767D\u9879\u76EE)_" : ""}`),
+    md(`\u2705 ${verb} **${p.name}**${p.blank ? " _(\u7A7A\u767D\u9879\u76EE)_" : ""}`),
     note(`\u{1F4C2} \`${p.cwd}\`   \xB7   ${kindLabel(p.kind)}`),
-    md(p.chatId ? "\u7FA4\u5DF2\u5EFA\u597D \u{1F449} \u53BB\u9879\u76EE\u7FA4\u91CC **@\u6211** \u5E72\u6D3B\u3002" : "\u53D1\u6211\u4EFB\u610F\u6D88\u606F\u53EF\u518D\u6B21\u6253\u5F00\u7BA1\u7406\u53F0\u3002")
+    md(p.chatId ? "\u{1F449} \u53BB\u7FA4\u91CC **@\u6211** \u5E72\u6D3B\u3002" : "\u53D1\u6211\u4EFB\u610F\u6D88\u606F\u53EF\u518D\u6B21\u6253\u5F00\u7BA1\u7406\u53F0\u3002")
   ];
   if (p.chatId) elements.push(actions([linkButton("\u{1F4AC} \u6253\u5F00\u7FA4\u804A", openChatUrl(p.chatId), "primary")]));
-  return card(elements, { header: { title: "\u2795 \u65B0\u5EFA\u9879\u76EE", template: "green" } });
+  return card(elements, { header: { title, template: "green" } });
 }
 function buildProjectListCard(projects, sessionsByChat = /* @__PURE__ */ new Map()) {
   if (projects.length === 0) {
@@ -2882,7 +3291,7 @@ function buildProjectListCard(projects, sessionsByChat = /* @__PURE__ */ new Map
     elements.push(note(`\u{1F4C2} \`${p.cwd}\`${p.branch && p.branch !== "\u2014" ? `   \u{1F33F} ${p.branch}` : ""}`));
     elements.push(
       note(
-        p.chatId ? `\u{1F4AC} \u7FA4\uFF1A**${p.name}**   \xB7   ${kindLabel(p.kind)}   \xB7   \u514D@\uFF1A${p.noMention ?? true ? "\u5F00" : "\u5173"}` : "\u26A0\uFE0F \u672A\u7ED1\u5B9A\u7FA4"
+        p.chatId ? `\u{1F4AC} \u7FA4\uFF1A**${p.name}**   \xB7   ${kindLabel(p.kind)}${(p.origin ?? "created") === "joined" ? " \xB7 \u{1F517}\u5DF2\u52A0\u5165" : ""}   \xB7   \u514D@\uFF1A${p.noMention ?? defaultNoMention(p) ? "\u5F00" : "\u5173"}` : "\u26A0\uFE0F \u672A\u7ED1\u5B9A\u7FA4"
       )
     );
     const sessions = (p.chatId ? sessionsByChat.get(p.chatId) : void 0) ?? [];
@@ -2905,11 +3314,12 @@ function buildProjectListCard(projects, sessionsByChat = /* @__PURE__ */ new Map
   elements.push(actions([button("\u2B05\uFE0F \u83DC\u5355", { a: DM.menu })]));
   return card(elements, { header: { title: "\u{1F4C1} \u9879\u76EE\u5217\u8868", template: "wathet" } });
 }
-function buildRmConfirmCard(name) {
+function buildRmConfirmCard(name, origin) {
+  const note_ = (origin ?? "created") === "joined" ? "\u4EC5\u89E3\u7ED1\uFF08\u79FB\u9664\u6CE8\u518C\uFF09\uFF0C**\u4E0D\u5220\u4EE3\u7801\u76EE\u5F55**\u3002\u786E\u8BA4\u540E**\u6211\u4F1A\u9000\u51FA\u8BE5\u7FA4**\uFF08\u7FA4\u662F\u4F60\u4EEC\u7684\uFF0C\u4E0D\u4F1A\u89E3\u6563\uFF09\u3002" : "\u4EC5\u89E3\u7ED1\uFF08\u79FB\u9664\u6CE8\u518C + \u64A4\u9500\u7F6E\u9876\u6A2A\u5E45\uFF09\uFF0C**\u4E0D\u5220\u4EE3\u7801\u76EE\u5F55**\u3002\u7FA4\u4E3B\u4F1A\u8F6C\u7ED9\u4F60\uFF0C\u518D\u7531\u4F60\u81EA\u884C\u5728\u98DE\u4E66\u89E3\u6563\u7FA4\u3002";
   return card(
     [
       md(`\u786E\u5B9A\u5220\u9664\u9879\u76EE **${name}**\uFF1F`),
-      note("\u4EC5\u89E3\u7ED1\uFF08\u79FB\u9664\u6CE8\u518C + \u64A4\u9500\u7F6E\u9876\u6A2A\u5E45\uFF09\uFF0C**\u4E0D\u5220\u4EE3\u7801\u76EE\u5F55**\u3002\u7FA4\u4E3B\u4F1A\u8F6C\u7ED9\u4F60\uFF0C\u518D\u7531\u4F60\u81EA\u884C\u5728\u98DE\u4E66\u89E3\u6563\u7FA4\u3002"),
+      note(note_),
       actions([
         button("\u2705 \u786E\u8BA4\u5220\u9664", { a: DM.rmDo, n: name }, "danger"),
         button("\u53D6\u6D88", { a: DM.rmCancel })
@@ -2957,7 +3367,7 @@ function buildSettingsCard(cfg) {
 }
 function buildGroupSettingsCard(project) {
   const kind = project.kind ?? "multi";
-  const noMention = project.noMention ?? true;
+  const noMention = project.noMention ?? defaultNoMention(project);
   const scopeNote = kind === "single" ? "\u5F00\u542F\u540E\uFF1A\u672C\u7FA4\u6240\u6709\u6D88\u606F(\u4E0D\u7528 @)\u90FD\u4EA4\u7ED9\u6211\u5904\u7406\u3002" : "\u5F00\u542F\u540E\uFF1A\u8BDD\u9898\u5185\u7684\u6D88\u606F(\u4E0D\u7528 @)\u90FD\u4EA4\u7ED9\u6211\u5904\u7406\uFF1B**\u5F00\u65B0\u8BDD\u9898\u4ECD\u9700 @\u6211**\u3002";
   return card(
     [
@@ -2977,16 +3387,16 @@ function buildGroupSettingsCard(project) {
 // src/service/update.ts
 import { execFile, spawn as spawn5 } from "child_process";
 import { existsSync as existsSync5, readFileSync as readFileSync2 } from "fs";
-import { dirname as dirname6, join as join8, resolve as resolve3 } from "path";
+import { dirname as dirname7, join as join8, resolve as resolve4 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import { promisify } from "util";
 
 // src/service/launchd.ts
 import { spawn as spawn4, spawnSync } from "child_process";
 import { existsSync as existsSync4 } from "fs";
-import { appendFile, mkdir as mkdir4, rm as rm2, writeFile as writeFile4 } from "fs/promises";
+import { appendFile, mkdir as mkdir5, rm as rm2, writeFile as writeFile5 } from "fs/promises";
 import { homedir as homedir3, userInfo as userInfo2 } from "os";
-import { dirname as dirname5, join as join7, resolve as resolve2 } from "path";
+import { dirname as dirname6, join as join7, resolve as resolve3 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 var LAUNCHD_LABEL = "ai.feishu-codex-bridge.bot";
 function launchAgentPlistPath() {
@@ -2999,8 +3409,8 @@ function serviceStderrPath() {
   return join7(paths.appDir, "service.err.log");
 }
 function resolveCliBinPath() {
-  const distDir = dirname5(fileURLToPath2(import.meta.url));
-  return resolve2(distDir, "..", "bin", "feishu-codex-bridge.mjs");
+  const distDir = dirname6(fileURLToPath2(import.meta.url));
+  return resolve3(distDir, "..", "bin", "feishu-codex-bridge.mjs");
 }
 function escapeXml(value) {
   return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
@@ -3040,9 +3450,9 @@ function buildPlist() {
 }
 async function installLaunchd() {
   const plistPath = launchAgentPlistPath();
-  await mkdir4(dirname5(plistPath), { recursive: true });
+  await mkdir5(dirname6(plistPath), { recursive: true });
   await ensureLogFiles();
-  await writeFile4(plistPath, buildPlist(), "utf8");
+  await writeFile5(plistPath, buildPlist(), "utf8");
   if (isLoaded()) {
     const bootout = runLaunchctl(["bootout", serviceTarget()]);
     if (!bootout.ok) throw launchctlError("launchctl bootout", bootout);
@@ -3124,7 +3534,7 @@ async function waitUntilUnloaded(timeoutMs = 5e3) {
   throw new Error(`launchd service \u672A\u5728 ${timeoutMs}ms \u5185\u5378\u8F7D\u5B8C\u6210`);
 }
 async function ensureLogFiles() {
-  await mkdir4(paths.appDir, { recursive: true });
+  await mkdir5(paths.appDir, { recursive: true });
   await appendFile(serviceStdoutPath(), "");
   await appendFile(serviceStderrPath(), "");
 }
@@ -3166,7 +3576,7 @@ function getServiceAdapter() {
 var execFileP = promisify(execFile);
 var NPM = process.platform === "win32" ? "npm.cmd" : "npm";
 function pkgRoot() {
-  return resolve3(dirname6(fileURLToPath3(import.meta.url)), "..");
+  return resolve4(dirname7(fileURLToPath3(import.meta.url)), "..");
 }
 function pkgJson() {
   try {
@@ -3231,68 +3641,10 @@ async function restartDaemon() {
   await getServiceAdapter().restart();
 }
 
-// src/project/registry.ts
-import { mkdir as mkdir5, readFile as readFile5, rename as rename4, writeFile as writeFile5 } from "fs/promises";
-import { dirname as dirname7 } from "path";
-var FILE_VERSION2 = 1;
-async function read() {
-  try {
-    const text = await readFile5(paths.projectsFile, "utf8");
-    const parsed = JSON.parse(text);
-    return Array.isArray(parsed.projects) ? parsed.projects : [];
-  } catch (err) {
-    if (err.code === "ENOENT") return [];
-    throw err;
-  }
-}
-async function write(projects) {
-  await mkdir5(dirname7(paths.projectsFile), { recursive: true });
-  const tmp = `${paths.projectsFile}.tmp-${process.pid}`;
-  const body = { version: FILE_VERSION2, projects };
-  await writeFile5(tmp, `${JSON.stringify(body, null, 2)}
-`, "utf8");
-  await rename4(tmp, paths.projectsFile);
-}
-async function listProjects() {
-  return read();
-}
-async function getProjectByChatId(chatId) {
-  return (await read()).find((p) => p.chatId === chatId);
-}
-async function getProjectByName(name) {
-  return (await read()).find((p) => p.name === name);
-}
-async function addProject(p) {
-  const projects = await read();
-  if (projects.some((x) => x.name === p.name)) {
-    throw new Error(`\u9879\u76EE\u540D\u300C${p.name}\u300D\u5DF2\u5B58\u5728`);
-  }
-  projects.push(p);
-  await write(projects);
-}
-async function updateProject(name, patch) {
-  const projects = await read();
-  const p = projects.find((x) => x.name === name);
-  if (!p) return;
-  const target = p;
-  for (const [k, v] of Object.entries(patch)) {
-    if (v !== void 0) target[k] = v;
-  }
-  await write(projects);
-}
-async function removeProject(name) {
-  const projects = await read();
-  const idx = projects.findIndex((p) => p.name === name);
-  if (idx === -1) return void 0;
-  const [removed] = projects.splice(idx, 1);
-  await write(projects);
-  return removed;
-}
-
 // src/project/lifecycle.ts
 import { mkdir as mkdir6 } from "fs/promises";
 import { existsSync as existsSync6 } from "fs";
-import { isAbsolute, join as join9, resolve as resolve4 } from "path";
+import { isAbsolute as isAbsolute2, join as join9, resolve as resolve5 } from "path";
 
 // src/project/git-info.ts
 import { execFile as execFile2 } from "child_process";
@@ -3393,21 +3745,23 @@ var HELP_DOC_URL = "https://my.feishu.cn/wiki/PZ23wGr7JiKK5RkIG4rcZXzGn5g";
 async function onboardGroup(channel, project) {
   const kind = project.kind ?? "multi";
   const chatId = project.chatId;
+  const decorate = (project.origin ?? "created") !== "joined";
   try {
-    const content = JSON.stringify(buildWelcomeCard(kind, HELP_DOC_URL || void 0));
+    const noMention = project.noMention ?? defaultNoMention(project);
+    const content = JSON.stringify(buildWelcomeCard(kind, HELP_DOC_URL || void 0, noMention));
     const sent = await channel.rawClient.im.v1.message.create({
       params: { receive_id_type: "chat_id" },
       data: { receive_id: chatId, msg_type: "interactive", content }
     });
     const messageId = sent.data?.message_id;
-    if (messageId) {
+    if (messageId && decorate) {
       await channel.rawClient.im.v1.pin.create({ data: { message_id: messageId } });
       log.info("project", "onboard-pin", { name: project.name });
     }
   } catch (err) {
     log.fail("project", err, { phase: "onboard-welcome" });
   }
-  if (HELP_DOC_URL) {
+  if (decorate && HELP_DOC_URL) {
     try {
       await channel.rawClient.im.v1.chatTab.create({
         path: { chat_id: chatId },
@@ -3423,21 +3777,21 @@ async function onboardGroup(channel, project) {
 }
 
 // src/project/lifecycle.ts
+async function resolveCwd(name, existingPath) {
+  if (existingPath) {
+    const cwd2 = isAbsolute2(existingPath) ? existingPath : resolve5(existingPath);
+    if (!existsSync6(cwd2)) throw new Error(`\u6587\u4EF6\u5939\u4E0D\u5B58\u5728\uFF1A${cwd2}`);
+    return { cwd: cwd2, blank: false };
+  }
+  const cwd = join9(paths.projectsRootDir, name);
+  await mkdir6(cwd, { recursive: true });
+  return { cwd, blank: true };
+}
 async function createProject(channel, input2) {
   const name = input2.name.trim();
   if (!name) throw new Error("\u9879\u76EE\u540D\u4E0D\u80FD\u4E3A\u7A7A");
   if (await getProjectByName(name)) throw new Error(`\u9879\u76EE\u540D\u300C${name}\u300D\u5DF2\u5B58\u5728\uFF0C\u6362\u4E2A\u540D\u6216\u7528 /projects \u770B\u5DF2\u6709\u7684`);
-  let cwd;
-  let blank;
-  if (input2.existingPath) {
-    cwd = isAbsolute(input2.existingPath) ? input2.existingPath : resolve4(input2.existingPath);
-    if (!existsSync6(cwd)) throw new Error(`\u6587\u4EF6\u5939\u4E0D\u5B58\u5728\uFF1A${cwd}`);
-    blank = false;
-  } else {
-    cwd = join9(paths.projectsRootDir, name);
-    await mkdir6(cwd, { recursive: true });
-    blank = true;
-  }
+  const { cwd, blank } = await resolveCwd(name, input2.existingPath);
   const res = await channel.rawClient.im.v1.chat.create({
     params: { user_id_type: "open_id" },
     data: { name, user_id_list: [input2.ownerOpenId] }
@@ -3449,13 +3803,35 @@ 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" };
+  const project = { name, chatId, cwd, blank, createdAt: Date.now(), kind: input2.kind ?? "multi", origin: "created" };
   await addProject(project);
   log.info("project", "create", { name, chatId, cwd, blank });
   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;
 }
+async function joinExistingGroup(channel, input2) {
+  const name = input2.name.trim();
+  if (!name) throw new Error("\u9879\u76EE\u540D\u4E0D\u80FD\u4E3A\u7A7A");
+  if (await getProjectByName(name)) throw new Error(`\u9879\u76EE\u540D\u300C${name}\u300D\u5DF2\u5B58\u5728\uFF0C\u6362\u4E2A\u540D\u6216\u7528 /projects \u770B\u5DF2\u6709\u7684`);
+  const bound = await getProjectByChatId(input2.chatId);
+  if (bound) throw new Error(`\u8BE5\u7FA4\u5DF2\u7ED1\u5B9A\u4E3A\u9879\u76EE\u300C${bound.name}\u300D`);
+  const { cwd, blank } = await resolveCwd(name, input2.existingPath);
+  const project = {
+    name,
+    chatId: input2.chatId,
+    cwd,
+    blank,
+    createdAt: Date.now(),
+    kind: input2.kind ?? "multi",
+    origin: "joined",
+    addedBy: input2.addedBy
+  };
+  await addProject(project);
+  log.info("project", "join", { name, chatId: input2.chatId, cwd, blank, kind: project.kind });
+  await onboardGroup(channel, project).catch((err) => log.fail("project", err, { phase: "onboard-join" }));
+  return project;
+}
 
 // src/project/group-ops.ts
 async function transferOwnership(channel, chatId, toOpenId) {
@@ -3466,14 +3842,21 @@ async function transferOwnership(channel, chatId, toOpenId) {
   });
   log.info("project", "owner-transfer", { chatId: chatId.slice(-6), to: toOpenId.slice(-6) });
 }
+async function leaveChat(channel, chatId) {
+  await channel.rawClient.request({
+    method: "PATCH",
+    url: `/open-apis/im/v1/chats/${encodeURIComponent(chatId)}/members/me_leave`
+  });
+  log.info("project", "leave-chat", { chatId: chatId.slice(-6) });
+}
 
 // src/bot/session-store.ts
-import { mkdir as mkdir7, readFile as readFile6, rename as rename5, writeFile as writeFile6 } from "fs/promises";
+import { mkdir as mkdir7, readFile as readFile7, rename as rename5, writeFile as writeFile6 } from "fs/promises";
 import { dirname as dirname8 } from "path";
 var FILE_VERSION3 = 1;
 async function read2() {
   try {
-    const text = await readFile6(paths.sessionsFile, "utf8");
+    const text = await readFile7(paths.sessionsFile, "utf8");
     const parsed = JSON.parse(text);
     return Array.isArray(parsed.sessions) ? parsed.sessions : [];
   } catch (err) {
@@ -3529,9 +3912,9 @@ async function handleDmConsole(channel, cfg, msg) {
 }
 
 // src/bot/media.ts
-import { mkdir as mkdir8, readdir as readdir2, rm as rm3, stat as stat2 } from "fs/promises";
+import { mkdir as mkdir8, readdir as readdir2, rm as rm3, stat as stat3 } from "fs/promises";
 import { join as join10 } from "path";
-var MAX_IMAGES = 9;
+var MAX_IMAGES2 = 9;
 var MEDIA_TTL_MS = 60 * 6e4;
 var EXT_BY_CONTENT_TYPE = {
   "image/png": "png",
@@ -3564,7 +3947,7 @@ async function collectInboundImages(channel, msg) {
   }
   const out = [];
   let index = 0;
-  for (const ref of refs.slice(0, MAX_IMAGES)) {
+  for (const ref of refs.slice(0, MAX_IMAGES2)) {
     const path = await downloadOne(channel, ref, index++);
     if (path) out.push(path);
   }
@@ -3671,7 +4054,7 @@ async function pruneOldMedia() {
   for (const name of entries) {
     const file = join10(paths.mediaDir, name);
     try {
-      const st = await stat2(file);
+      const st = await stat3(file);
       if (st.mtimeMs < cutoff) await rm3(file, { force: true });
     } catch {
     }
@@ -3996,11 +4379,22 @@ function createOrchestrator(channel, cfg, fallbackCwd) {
       log.info("intake", "reject", { reason: "not_allowed", chatId: msg.chatId.slice(-6) });
       return;
     }
+    if (!project) {
+      log.info("intake", "unbound-group", { chatId: msg.chatId.slice(-6), atBot: msg.mentionedBot });
+      if (msg.mentionedBot) {
+        await channel.send(
+          msg.chatId,
+          { markdown: "\u672C\u7FA4\u8FD8\u6CA1\u7ED1\u5B9A\u4E3A\u9879\u76EE\u3002\u8BF7**\u628A\u6211\u62C9\u8FDB\u7FA4\u7684\u7BA1\u7406\u5458**\u5728\u4E0E\u6211\u7684\u79C1\u804A\u91CC\u5B8C\u6210\u7ED1\u5B9A\u540E\u518D @\u6211\u3002" },
+          { replyTo: msg.messageId }
+        ).catch(() => void 0);
+      }
+      return;
+    }
     const text = msg.content.trim();
     const cmd = parseCommand(text);
     if ((project?.kind ?? "multi") === "single") {
       if (cmd === "help") {
-        await postHelpCard(msg, "single");
+        await postHelpCard(msg, "single", false, project);
         return;
       }
       if (cmd === "settings") {
@@ -4016,7 +4410,7 @@ function createOrchestrator(channel, cfg, fallbackCwd) {
     }
     if (msg.threadId) {
       if (cmd === "help") {
-        await postHelpCard(msg, "topic", true);
+        await postHelpCard(msg, "topic", true, project);
         return;
       }
       if (cmd === "model") {
@@ -4027,7 +4421,7 @@ function createOrchestrator(channel, cfg, fallbackCwd) {
       return;
     }
     if (cmd === "help") {
-      await postHelpCard(msg, "main");
+      await postHelpCard(msg, "main", false, project);
       return;
     }
     if (cmd === "resume") {
@@ -4050,7 +4444,7 @@ function createOrchestrator(channel, cfg, fallbackCwd) {
     return name === "resume" || name === "model" || name === "settings" || name === "help" ? name : null;
   }
   function shouldRespondWithoutMention(project, msg) {
-    if (!(project.noMention ?? true)) return false;
+    if (!(project.noMention ?? defaultNoMention(project))) return false;
     if (msg.mentionAll || msg.mentions.some((m) => !m.isBot)) return false;
     if ((project.kind ?? "multi") === "single") return true;
     return Boolean(msg.threadId) || parseCommand(msg.content.trim()) !== null;
@@ -4247,9 +4641,10 @@ function createOrchestrator(channel, cfg, fallbackCwd) {
       log.info("card", "model", { threadId: sessionKey, model: state.model, effort: state.effort });
     });
   }
-  async function postHelpCard(msg, scope, inThread = false) {
+  async function postHelpCard(msg, scope, inThread = false, project) {
+    const noMention = project ? project.noMention ?? defaultNoMention(project) : true;
     await withTrace({ chatId: msg.chatId, msgId: msg.messageId }, async () => {
-      await sendManagedCard(channel, msg.chatId, buildHelpCard(scope), msg.messageId, inThread).catch(
+      await sendManagedCard(channel, msg.chatId, buildHelpCard(scope, noMention), msg.messageId, inThread).catch(
         (err) => log.fail("card", err, { cmd: "help", scope })
       );
       log.info("card", "help", { scope });
@@ -4387,6 +4782,32 @@ function createOrchestrator(channel, cfg, fallbackCwd) {
         (e) => log.fail("console", e, { phase: "new-project-result" })
       );
     })();
+  }).on(DM.joinGroupSubmit, ({ evt, formValue, value }) => {
+    const op = evt.operator?.openId;
+    if (!dmAdmin(op)) return;
+    const name = String(formValue?.name ?? "").trim();
+    const cwdIn = String(formValue?.cwd ?? "").trim();
+    const chatId = typeof value.chatId === "string" ? value.chatId : "";
+    const kind = value.kind === "single" ? "single" : "multi";
+    void (async () => {
+      let result;
+      if (!chatId)
+        result = buildJoinGroupFormCard({ chatId: "", name, cwd: cwdIn, error: "\u7F3A\u5C11\u7FA4\u6807\u8BC6\uFF0C\u8BF7\u91CD\u65B0\u4ECE\u8FDB\u7FA4\u901A\u77E5\u91CC\u6253\u5F00\u7ED1\u5B9A\u5361" });
+      else if (!name) result = buildJoinGroupFormCard({ chatId, cwd: cwdIn, error: "\u9879\u76EE\u540D\u4E0D\u80FD\u4E3A\u7A7A" });
+      else if (!op) result = buildJoinGroupFormCard({ chatId, name, cwd: cwdIn, error: "\u65E0\u6CD5\u8BC6\u522B\u64CD\u4F5C\u8005\u8EAB\u4EFD" });
+      else {
+        try {
+          const p = await joinExistingGroup(channel, { name, chatId, addedBy: op, existingPath: cwdIn || void 0, kind });
+          log.info("console", "join-group", { name: p.name, blank: p.blank });
+          result = buildNewProjectDoneCard(p);
+        } catch (err) {
+          result = buildJoinGroupFormCard({ chatId, name, cwd: cwdIn, error: err instanceof Error ? err.message : String(err) });
+        }
+      }
+      await sendManagedCard(channel, evt.chatId, result).catch(
+        (e) => log.fail("console", e, { phase: "join-group-result" })
+      );
+    })();
   }).on(DM.projects, ({ evt }) => {
     if (!dmAdmin(evt.operator?.openId)) return;
     patch(evt, renderProjectList);
@@ -4399,6 +4820,7 @@ function createOrchestrator(channel, cfg, fallbackCwd) {
     const secret = await getSecret(secretKeyForApp(app.id)).catch(() => void 0);
     const scopeCheck = secret ? await validateAppCredentials(app.id, secret, app.tenant).catch(() => void 0) : void 0;
     const missingScopes = scopeCheck?.missingScopes;
+    const missingJoinScopes = scopeCheck?.missingJoinScopes;
     const info = {
       codexOk: await backend.isAvailable().catch(() => false),
       codexVer: codexBin ? codexVersion(codexBin) : null,
@@ -4415,7 +4837,10 @@ function createOrchestrator(channel, cfg, fallbackCwd) {
         app.id,
         app.tenant,
         missingScopes && missingScopes.length ? missingScopes : void 0
-      )
+      ),
+      missingJoinScopes,
+      // 「加入存量群」按钮恒预选这两项 opt-in scope（它们不在必需清单里）。
+      joinScopeGrantUrl: buildScopeGrantUrl(app.id, app.tenant, JOIN_GROUP_SCOPES)
     };
     await sendManagedCard(channel, evt.chatId, buildDoctorCard(info), evt.messageId).catch(
       (err) => log.fail("console", err, { cmd: "doctor" })
@@ -4476,7 +4901,8 @@ SDK \u4F1A\u81EA\u52A8\u91CD\u8FDE\uFF1B\u82E5\u957F\u671F\u65AD\u5F00\uFF0C\u8B
   }).on(DM.rmConfirm, async ({ evt, value }) => {
     const name = typeof value.n === "string" ? value.n : void 0;
     if (!dmAdmin(evt.operator?.openId) || !name) return;
-    await patch(evt, buildRmConfirmCard(name));
+    const proj = (await listProjects()).find((p) => p.name === name);
+    await patch(evt, buildRmConfirmCard(name, proj?.origin));
   }).on(DM.rmCancel, ({ evt }) => {
     if (!dmAdmin(evt.operator?.openId)) return;
     patch(evt, renderProjectList);
@@ -4486,15 +4912,25 @@ SDK \u4F1A\u81EA\u52A8\u91CD\u8FDE\uFF1B\u82E5\u957F\u671F\u65AD\u5F00\uFF0C\u8B
     if (!dmAdmin(op) || !name) return;
     patch(evt, async () => {
       const removed = await removeProject(name);
-      let transferred = false;
-      if (removed?.chatId && op) {
-        transferred = await transferOwnership(channel, removed.chatId, op).then(() => true).catch((err) => {
-          log.fail("console", err, { phase: "owner-transfer" });
+      let tail;
+      if (removed && (removed.origin ?? "created") === "joined") {
+        const left = removed.chatId ? await leaveChat(channel, removed.chatId).then(() => true).catch((err) => {
+          log.fail("console", err, { phase: "leave-chat" });
           return false;
-        });
+        }) : false;
+        log.info("console", "rm", { name, origin: "joined", left });
+        tail = left ? "\u6211\u5DF2\u9000\u51FA\u8BE5\u7FA4\uFF08\u7FA4\u662F\u4F60\u4EEC\u7684\uFF0C\u4E0D\u4F1A\u89E3\u6563\uFF09\u3002" : "\u26A0\uFE0F \u6211\u9000\u7FA4\u5931\u8D25\uFF08\u53EF\u80FD\u6743\u9650\u4E0D\u8DB3\uFF09\uFF0C\u53EF\u5728\u7FA4\u91CC\u624B\u52A8\u628A\u6211\u79FB\u9664\u3002";
+      } else {
+        let transferred = false;
+        if (removed?.chatId && op) {
+          transferred = await transferOwnership(channel, removed.chatId, op).then(() => true).catch((err) => {
+            log.fail("console", err, { phase: "owner-transfer" });
+            return false;
+          });
+        }
+        log.info("console", "rm", { name, origin: "created", transferred });
+        tail = transferred ? "\u7FA4\u4E3B\u5DF2\u8F6C\u7ED9\u4F60 \u2192 \u8BF7\u5728\u98DE\u4E66\u91CC**\u81EA\u884C\u89E3\u6563\u8BE5\u7FA4**\uFF08\u673A\u5668\u4EBA\u4E0D\u4E3B\u52A8\u89E3\u6563\uFF09\u3002" : "\u26A0\uFE0F \u7FA4\u4E3B\u8F6C\u8BA9\u5931\u8D25\uFF08\u53EF\u80FD bot \u975E\u7FA4\u4E3B\uFF09\uFF0C\u8BF7\u7528\u300C\u{1F6AA} \u7FA4\u7BA1\u7406\u300D\u624B\u52A8\u8F6C\u8BA9\u540E\u89E3\u6563\u3002";
       }
-      log.info("console", "rm", { name, transferred });
-      const tail = transferred ? "\u7FA4\u4E3B\u5DF2\u8F6C\u7ED9\u4F60 \u2192 \u8BF7\u5728\u98DE\u4E66\u91CC**\u81EA\u884C\u89E3\u6563\u8BE5\u7FA4**\uFF08\u673A\u5668\u4EBA\u4E0D\u4E3B\u52A8\u89E3\u6563\uFF09\u3002" : "\u26A0\uFE0F \u7FA4\u4E3B\u8F6C\u8BA9\u5931\u8D25\uFF08\u53EF\u80FD bot \u975E\u7FA4\u4E3B\uFF09\uFF0C\u8BF7\u7528\u300C\u{1F6AA} \u7FA4\u7BA1\u7406\u300D\u624B\u52A8\u8F6C\u8BA9\u540E\u89E3\u6563\u3002";
       await channel.send(evt.chatId, { markdown: `\u2705 \u5DF2\u5220\u9664\u9879\u76EE\u300C${name}\u300D\uFF08\u89E3\u7ED1\uFF0C\u672A\u5220\u4EE3\u7801\u76EE\u5F55\uFF09\u3002
 ${tail}` }, { replyTo: evt.messageId }).catch(() => void 0);
       return renderProjectList();
@@ -4686,9 +5122,22 @@ ${tail}` }, { replyTo: evt.messageId }).catch(() => void 0);
         const finalMsgId = cardMsgId;
         await adoptThreadId(finalMsgId);
         rc.cardKey = finalMsgId;
+        const answerText = finalMessageText(rc.rs);
+        const { fences } = extractCardFences(answerText);
+        const imgSources = imageSources(answerText);
+        if (imgSources.length > 0) {
+          rc.images = await uploadOutboundImages(channel, imgSources, opts.cwd ?? fallbackCwd);
+        }
         await stream2.updateCard(channel, buildRunCard(rc));
         runsByCard.delete(cardMsgId);
         promoteCard(finalMsgId, rc);
+        for (const fence of fences) {
+          try {
+            await sendManagedCard(channel, opts.chatId, buildCleanCard(fence, rc.images), finalMsgId, !opts.flat);
+          } catch (err) {
+            log.fail("card", err, { phase: "clean-card" });
+          }
+        }
         if (topicThreadId) await patchSession(topicThreadId, { updatedAt: Date.now() });
         replyTo = finalMsgId;
         replyInThread = !opts.flat;
@@ -4817,13 +5266,57 @@ ${tail}` }, { replyTo: evt.messageId }).catch(() => void 0);
     });
     return fresh;
   }
+  async function onBotAddedToChat(evt) {
+    await withTrace({ chatId: evt.chatId }, async () => {
+      const op = evt.operator?.openId;
+      if (await getProjectByChatId(evt.chatId)) {
+        log.info("intake", "bot-added-bound", { chatId: evt.chatId.slice(-6) });
+        return;
+      }
+      if (!op || !isAdmin(cfg, op)) {
+        log.info("intake", "bot-added-nonadmin", { chatId: evt.chatId.slice(-6), op: op?.slice(-6) });
+        return;
+      }
+      const info = await channel.getChatInfo(evt.chatId).catch((err) => {
+        log.fail("intake", err, { phase: "bot-added-chatinfo" });
+        return void 0;
+      });
+      const name = (info?.name ?? "").trim();
+      await sendManagedCard(
+        channel,
+        op,
+        buildJoinGroupFormCard({ chatId: evt.chatId, name }),
+        void 0,
+        false,
+        "open_id"
+      ).catch((err) => log.fail("intake", err, { phase: "bot-added-bindcard" }));
+      log.info("intake", "bot-added", { chatId: evt.chatId.slice(-6), op: op.slice(-6), named: Boolean(name) });
+    }).catch((err) => log.fail("intake", err, { phase: "bot-added" }));
+  }
+  async function onBotRemovedFromChat(chatId) {
+    const project = await getProjectByChatId(chatId);
+    if (!project) return;
+    const removed = await removeProject(project.name);
+    if (!removed) return;
+    log.info("intake", "bot-removed-unbind", { name: removed.name, chatId: chatId.slice(-6) });
+    if (removed.addedBy) {
+      await channel.rawClient.im.v1.message.create({
+        params: { receive_id_type: "open_id" },
+        data: {
+          receive_id: removed.addedBy,
+          msg_type: "text",
+          content: JSON.stringify({ text: `\u2139\uFE0F \u6211\u5DF2\u88AB\u79FB\u51FA\u7FA4\u300C${removed.name}\u300D\uFF0C\u5BF9\u5E94\u9879\u76EE\u5DF2\u81EA\u52A8\u89E3\u7ED1\u3002` })
+        }
+      }).catch(() => void 0);
+    }
+  }
   async function shutdown() {
     const live = [...sessions.values()];
     sessions.clear();
     await Promise.allSettled(live.map((t) => t.close()));
     log.info("bridge", "shutdown", { closed: live.length });
   }
-  return { onMessage, onComment, dispatcher, shutdown };
+  return { onMessage, onComment, onBotAddedToChat, onBotRemovedFromChat, dispatcher, shutdown };
 }
 async function getThreadId(channel, messageId) {
   try {
@@ -4861,6 +5354,24 @@ async function startBridge(opts) {
   channel.on("message", orchestrator.onMessage);
   channel.on("cardAction", orchestrator.dispatcher.handle);
   channel.on("comment", orchestrator.onComment);
+  channel.on("botAdded", orchestrator.onBotAddedToChat);
+  try {
+    const tap = channel.dispatcher;
+    if (tap?.register) {
+      tap.register({
+        "im.chat.member.bot.deleted_v1": (raw) => {
+          const ev = raw;
+          const chatId = ev?.chat_id ?? ev?.event?.chat_id;
+          if (chatId) void orchestrator.onBotRemovedFromChat(chatId);
+        }
+      });
+      log.info("ws", "bot-removed-tap");
+    } else {
+      log.info("ws", "bot-removed-tap-unavailable");
+    }
+  } catch (err) {
+    log.fail("ws", err, { phase: "bot-removed-tap" });
+  }
   channel.on("reject", (evt) => log.info("intake", "reject", { reason: evt.reason, msgId: evt.messageId }));
   channel.on("error", (err) => log.fail("ws", err));
   channel.on("reconnecting", () => log.info("ws", "reconnecting"));
@@ -5072,6 +5583,7 @@ async function runBotInit(name) {
   }
   console.log("\n\u4E0B\u4E00\u6B65\uFF08\u98DE\u4E66\u5F00\u653E\u5E73\u53F0\u540E\u53F0\uFF0C\u9700\u624B\u52A8\u4E00\u6B21 https://open.feishu.cn/app \uFF09\uFF1A");
   console.log("  1) \u4E8B\u4EF6\u4E0E\u56DE\u8C03 \u2192 \u957F\u8FDE\u63A5 \u2192 \u8BA2\u9605\uFF1Aim.message.receive_v1 / card.action.trigger / application.bot.menu_v6");
+  console.log("     \uFF08\u53EF\u9009\uFF09\u300C\u52A0\u8FDB\u5DF2\u6709\u7FA4\u300D\u529F\u80FD\u518D\u8BA2\u9605\uFF1Aim.chat.member.bot.added_v1 / im.chat.member.bot.deleted_v1");
   console.log("  2) \u521B\u5EFA\u5E76\u53D1\u5E03\u5E94\u7528\u7248\u672C");
   console.log("\n`bot list` \u67E5\u770B\u5168\u90E8\uFF1B`bot use <\u540D>` \u5207\u6362\u5F53\u524D\uFF1B`run` \u524D\u53F0\u8DD1 / `start` \u540E\u53F0\u5E38\u9A7B\u3002\n");
 }
@@ -5171,15 +5683,15 @@ async function secretsRemove(id) {
   console.log(ok ? `\u2713 \u5DF2\u5220\u9664: ${id}` : `\u672A\u627E\u5230: ${id}`);
 }
 function readStdin() {
-  return new Promise((resolve5) => {
+  return new Promise((resolve6) => {
     let data = "";
     if (process.stdin.isTTY) {
-      resolve5("");
+      resolve6("");
       return;
     }
     process.stdin.setEncoding("utf8");
     process.stdin.on("data", (c) => data += c);
-    process.stdin.on("end", () => resolve5(data));
+    process.stdin.on("end", () => resolve6(data));
   });
 }
 

package/package.json

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