@modelzen/feishu-codex-bridge 0.1.8 → 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

@@ -679,7 +679,11 @@ 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",
@@ -695,6 +699,8 @@ var SCOPE_LABELS = {
   "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",
@@ -746,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`, {
@@ -756,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
@@ -1071,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");
@@ -1707,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) }
@@ -1726,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;
   }
@@ -2183,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") {
@@ -2198,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")
     );
@@ -2213,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()
@@ -2222,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 {
@@ -2895,6 +2922,71 @@ async function uploadBuffer(channel, buffer) {
   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)}`;
@@ -2904,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",
@@ -3057,6 +3150,27 @@ ${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",
@@ -3099,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}\``),
@@ -3132,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) {
@@ -3154,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) ?? [];
@@ -3177,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 })
@@ -3229,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(
     [
@@ -3249,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 resolve4 } 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 resolve3 } 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() {
@@ -3271,7 +3409,7 @@ function serviceStderrPath() {
   return join7(paths.appDir, "service.err.log");
 }
 function resolveCliBinPath() {
-  const distDir = dirname5(fileURLToPath2(import.meta.url));
+  const distDir = dirname6(fileURLToPath2(import.meta.url));
   return resolve3(distDir, "..", "bin", "feishu-codex-bridge.mjs");
 }
 function escapeXml(value) {
@@ -3312,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);
@@ -3396,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(), "");
 }
@@ -3438,7 +3576,7 @@ function getServiceAdapter() {
 var execFileP = promisify(execFile);
 var NPM = process.platform === "win32" ? "npm.cmd" : "npm";
 function pkgRoot() {
-  return resolve4(dirname6(fileURLToPath3(import.meta.url)), "..");
+  return resolve4(dirname7(fileURLToPath3(import.meta.url)), "..");
 }
 function pkgJson() {
   try {
@@ -3503,64 +3641,6 @@ async function restartDaemon() {
   await getServiceAdapter().restart();
 }
 
-// src/project/registry.ts
-import { mkdir as mkdir5, readFile as readFile6, 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 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 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";
@@ -3665,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 },
@@ -3695,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 = isAbsolute2(input2.existingPath) ? input2.existingPath : resolve5(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] }
@@ -3721,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) {
@@ -3738,6 +3842,13 @@ 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 readFile7, rename as rename5, writeFile as writeFile6 } from "fs/promises";
@@ -4268,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") {
@@ -4288,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") {
@@ -4299,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") {
@@ -4322,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;
@@ -4519,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 });
@@ -4659,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);
@@ -4671,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,
@@ -4687,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" })
@@ -4748,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);
@@ -4758,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();
@@ -5102,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 {
@@ -5146,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"));
@@ -5357,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");
 }

package/package.json

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