opencode-feishu-plugin 0.2.12 → 0.2.14

package/README.en.md

@@ -22,6 +22,7 @@ Connect [OpenCode](https://opencode.ai) to Feishu/Lark: **one Feishu topic = one
 | 📊 **Real-time visible** | "Thinking" receipt → live tool-call cards → streaming text updates; footer shows the current model |
 | ⏹ **Controllable** | Every reply card has a "force stop" button; a watchdog auto-interrupts stuck sessions; native queue with `/steer` `/now` to cut in |
 | 📎 **Images / files** | Images and files sent in Feishu are downloaded and attached to the session, so vision/file-capable models can see and read them |
+| 🧭 **One-sentence session** | Send a task in the main chat — the AI judges intent, finds the right working directory, and creates + starts the session in one tap |
 | 🖱 **Main-window menu** | Two fixed quick buttons above the chat input — "New session" and "Session list" (bot custom menu) — one tap to fire them |
 | 🚫 **No ports** | Full long-connection; no inbound port needed on the server |
 
@@ -127,6 +128,22 @@ After configuring the menu (setup step 6), two quick buttons stay pinned **above
 - After changing the menu, **re-publish the app version** (per the console: takes effect within ~5 minutes after publishing);
 - Message the bot at least once before using the menu (the plugin remembers the p2p chat from messages; any normal usage satisfies this).
 
+### One-sentence session creation (AI finds the directory)
+
+When you send plain text in the main chat, the AI first judges the **intent** and picks the best-matching working directory from candidates (recent dirs + local session dirs), then replies with a proposal card:
+
+```
+You: fix the zlib download bug
+→ 🆕 Suggested new session
+   Task: fix download bug | Dir: `/Users/code/zlib`
+   [✅ Create & send]  [❌ Cancel]
+```
+
+"Create & send" = create the session + auto-open a topic + send your original message in to start working (permission defaults to "Editable"; adjust later with `/perm`).
+
+- Chat/unrecognized/dir-not-in-candidates → falls back to the console hint card, **never creates a wrong session**; the model's path must match a candidate (anti-hallucination);
+- Proposal cards are valid for 1 hour; set `quickNew: false` to go back to the console-only mode.
+
 ### Inside a topic (work)
 
 A topic = a session; sending plain text is giving the AI a command.
@@ -174,6 +191,7 @@ When the agent asks via `question` or other form tools, the form becomes a Feish
 | `logFile` | string \| boolean | — | `true` = write `<configDir>/plugins/feishu.log`; recommended in server mode |
 | `approvalTtlMs` | number | `600000` | Approval token / card validity |
 | `staleExecutionMs` | number | `300000` | Watchdog threshold (0–60 min; **0 = disabled**; sessions waiting on a form / pending approval are never killed) |
+| `quickNew` | boolean | `true` | Main-chat "one-sentence session": AI judges intent + finds the directory, proposal card creates in one tap; `false` = console-only mode |
 | `gatewayLocation` | string | — | Only start the gateway at this location (or its subdirectories); empty = any location |
 
 Full config (including `cardMaxTables`, `topicStatus*`, `resumeSummary*`, `keepalive*`, `gatewayMatchGraceMs`) → [docs/advanced.en.md](./docs/advanced.en.md#full-configuration).

package/README.md

@@ -22,6 +22,7 @@
 | 📊 **实时可见** | 「思考中」回执 → 工具调用实时上卡 → 文本流式更新，页脚显示当前模型 |
 | ⏹ **可控可停** | 每张回复卡带「强制停止」；看门狗自动中断卡死会话；忙时原生排队，`/steer` `/now` 可插队 |
 | 📎 **图片 / 文件** | 飞书里的图片 / 文件自动下载并挂进会话，支持视觉 / 文件的模型直接看图、读文件 |
+| 🧭 **一句话建会话** | 主聊天流发任务文本，AI 自动判断意图、找好工作目录，一键建会话并开始处理 |
 | 🖱 **主窗口菜单** | 机器人输入框上固定「新建会话」「会话列表」快捷按钮（机器人自定义菜单），一点即用 |
 | 🚫 **无端口** | 全程长连接，服务器无需开放任何入站端口 |
 
@@ -127,6 +128,22 @@ tail -f ~/.config/opencode/plugins/feishu.log   # 应看到「飞书长连接已
 - 菜单配置修改后需**重新发布版本**（官方说明：发版成功后约 5 分钟内生效）；
 - 首次使用菜单前，先给机器人发过至少一条消息（插件据消息记住单聊会话；正常使用必然满足）。
 
+### 一句话建会话（AI 找目录）
+
+主聊天流发普通文本时，AI 会先判断**意图**，并从候选目录（最近使用 + 本机会话目录）里挑出最匹配的工作目录，回一张建议卡：
+
+```
+你：帮我修一下 zlib 的下载 bug
+→ 🆕 建议新建会话
+   任务：修下载 bug ｜ 目录：`/Users/code/zlib`
+   [✅ 创建并发送]  [❌ 取消]
+```
+
+点「创建并发送」= 建会话 + 自动开话题 + 把原消息发进去开始处理（权限默认「可编辑」，进话题后可用 `/perm` 调整）。
+
+- 闲聊 / 无法识别 / 目录不在候选中 → 回退为管理台提示卡，**不会误建会话**；模型给出的路径必须命中候选清单（防幻觉）；
+- 建议卡有效期 1 小时；不想要此功能可设 `quickNew: false` 回到纯管理台模式。
+
 ### 话题内（干活）
 
 一个话题 = 一个会话，发普通文本就是给 AI 下指令。
@@ -174,6 +191,7 @@ agent 反问时表单会变成飞书卡片，**点按钮或在话题里直接发
 | `logFile` | string \| boolean | — | `true` = 写 `<configDir>/plugins/feishu.log`，服务模式建议开启 |
 | `approvalTtlMs` | number | `600000` | 审批 token / 卡片有效期 |
 | `staleExecutionMs` | number | `300000` | 看门狗阈值（0–60 分钟；**0 = 关闭看门狗**；待答表单 / 未决审批期间不判卡死） |
+| `quickNew` | boolean | `true` | 主聊天流「一句话建会话」：AI 判断意图 + 找目录，建议卡一键创建；`false` = 回到纯管理台模式 |
 | `gatewayLocation` | string | — | 只在该 location（及其子目录）启动网关；留空 = 任意 location 生效 |
 
 完整配置（含 `cardMaxTables`、`topicStatus*`、`resumeSummary*`、`keepalive*`、`gatewayMatchGraceMs` 等进阶项）见 [docs/advanced.md](./docs/advanced.md#完整配置项)。

package/dist/index.js

@@ -144037,6 +144037,7 @@ function resolveConfig2(raw, env = process.env, deps = {}) {
   );
   const attachmentTimeoutMs = clamp4(asNumber(merged.attachmentTimeoutMs, 3e4), 5e3, 12e4);
   const attachmentsDirRaw = asString(merged.attachmentsDir).trim();
+  const quickNew = asBoolean(merged.quickNew, true);
   const keepaliveIntervalMs = clamp4(
     asNumber(merged.keepaliveIntervalMs, 20 * 60 * 1e3),
     5 * 60 * 1e3,
@@ -144101,7 +144102,8 @@ function resolveConfig2(raw, env = process.env, deps = {}) {
     acceptAttachments,
     attachmentMaxBytes,
     attachmentTimeoutMs,
-    ...attachmentsDirRaw ? { attachmentsDir: attachmentsDirRaw } : {}
+    ...attachmentsDirRaw ? { attachmentsDir: attachmentsDirRaw } : {},
+    quickNew
   };
 }
 function loadConfigFile(env, deps, warnings) {
@@ -146078,6 +146080,14 @@ function withAssistantID(state, assistantMessageID) {
   if (!assistantMessageID || assistantMessageID === state.assistantMessageID) return state;
   return { ...state, assistantMessageID };
 }
+function lastPrefixTextIndex(blocks, text) {
+  for (let i = blocks.length - 1; i >= 0; i -= 1) {
+    const block = blocks[i];
+    if (block.kind !== "text") continue;
+    if (block.content && text.startsWith(block.content)) return i;
+  }
+  return -1;
+}
 function patchTool(state, id2, update2) {
   let found = false;
   const blocks = state.blocks.map((b) => {
@@ -146118,21 +146128,62 @@ function reduce6(state, event) {
       if (!event.delta) return state;
       const base2 = stepTransition(state, event.assistantMessageID);
       const last = base2[base2.length - 1];
-      const blocks = last && last.kind === "text" && last.streaming ? [...base2.slice(0, -1), { ...last, content: last.content + event.delta }] : [...base2, { kind: "text", content: event.delta, streaming: true }];
+      const blocks = last && last.kind === "text" && last.streaming ? [...base2.slice(0, -1), { ...last, content: last.content + event.delta, ...event.assistantMessageID ? { msg: event.assistantMessageID } : {} }] : [...base2, { kind: "text", content: event.delta, streaming: true, ...event.assistantMessageID ? { msg: event.assistantMessageID } : {} }];
       const next = withAssistantID(state, event.assistantMessageID);
       return { ...next, blocks, footer: "streaming", terminal: "running" };
     }
     case "text.ended": {
       const blocks = state.blocks;
-      const last = blocks[blocks.length - 1];
-      let nextBlocks;
-      if (last && last.kind === "text" && last.streaming) {
-        nextBlocks = [...blocks.slice(0, -1), { ...last, content: event.text ?? last.content, streaming: false }];
-      } else if (event.text) {
-        nextBlocks = [...closeStreamingText(blocks), { kind: "text", content: event.text, streaming: false }];
-      } else {
-        nextBlocks = closeStreamingText(blocks);
+      const endedText = event.text;
+      const endedMsg = event.assistantMessageID;
+      if (!endedMsg) {
+        const last = blocks[blocks.length - 1];
+        let nextBlocks2;
+        if (last && last.kind === "text" && last.streaming) {
+          nextBlocks2 = [...blocks.slice(0, -1), { ...last, content: endedText ?? last.content, streaming: false }];
+        } else if (endedText) {
+          const idx = lastPrefixTextIndex(blocks, endedText);
+          nextBlocks2 = idx >= 0 ? blocks.map((b, i) => i === idx && b.kind === "text" ? { ...b, content: endedText, streaming: false } : b) : [...closeStreamingText(blocks), { kind: "text", content: endedText, streaming: false }];
+        } else {
+          nextBlocks2 = closeStreamingText(blocks);
+        }
+        return { ...state, blocks: nextBlocks2, footer: "streaming" };
       }
+      let targetIdx = -1;
+      for (let i = blocks.length - 1; i >= 0; i -= 1) {
+        const b = blocks[i];
+        if (b.kind === "text" && b.msg === endedMsg) {
+          targetIdx = i;
+          break;
+        }
+      }
+      const tail = blocks[blocks.length - 1];
+      if (targetIdx < 0 && tail && tail.kind === "text" && tail.streaming) targetIdx = blocks.length - 1;
+      if (targetIdx < 0) {
+        if (!endedText) return { ...state, blocks: closeStreamingText(blocks), footer: "streaming" };
+        return {
+          ...state,
+          blocks: [
+            ...closeStreamingText(blocks),
+            { kind: "text", content: endedText, streaming: false, msg: endedMsg }
+          ],
+          footer: "streaming"
+        };
+      }
+      const target = blocks[targetIdx];
+      let earlierLen = 0;
+      for (let i = 0; i < targetIdx; i += 1) {
+        const b = blocks[i];
+        if (b.kind === "text" && b.msg === endedMsg) earlierLen += b.content.length;
+      }
+      let content = target.kind === "text" ? target.content : "";
+      if (endedText !== void 0 && endedText.length >= earlierLen) {
+        const suffix = endedText.slice(earlierLen);
+        if (suffix.length >= content.length) content = suffix;
+      }
+      const nextBlocks = blocks.map(
+        (b, i) => i === targetIdx && b.kind === "text" ? { ...b, content, streaming: false } : b
+      );
       return { ...state, blocks: nextBlocks, footer: "streaming" };
     }
     case "tool.input.started": {
@@ -146625,13 +146676,49 @@ function trailingText(blocks) {
   }
   return parts.join("\n\n").trim();
 }
+function isActivityEvent(type) {
+  return type === "text.started" || type === "text.delta" || type === "text.ended" || type === "tool.input.started" || type === "tool.input.ended" || type === "tool.success" || type === "tool.error";
+}
+var QUEUED_DRAIN_GRACE_MS = 3e3;
 function createRunController(deps) {
   const sessions = /* @__PURE__ */ new Map();
   const throttlers = /* @__PURE__ */ new Map();
   const sessionModels = /* @__PURE__ */ new Map();
   const notifiedQueued = /* @__PURE__ */ new Set();
+  const drainTimers = /* @__PURE__ */ new Map();
   const throttleMs = Math.max(400, deps.throttleMs);
   let disposed = false;
+  const cancelDrain = (sessionID) => {
+    const timer = drainTimers.get(sessionID);
+    if (timer) {
+      clearTimeout(timer);
+      drainTimers.delete(sessionID);
+    }
+  };
+  const scheduleDrain = (sessionID, runs) => {
+    if (runs.queued.length === 0) {
+      cancelDrain(sessionID);
+      return;
+    }
+    cancelDrain(sessionID);
+    const timer = setTimeout(() => {
+      drainTimers.delete(sessionID);
+      if (disposed) return;
+      const live = sessions.get(sessionID);
+      if (!live || live.queued.length === 0) return;
+      deps.log.info("\u6392\u961F\u5361\u6309\u300C\u5DF2\u968F\u672C\u8F6E\u5904\u7406\u300D\u6536\u5C3E\uFF08\u961F\u5217\u6D88\u606F\u5728\u5F53\u524D\u6267\u884C\u5185\u88AB\u6D88\u8D39\uFF09", {
+        sessionID,
+        count: live.queued.length
+      });
+      for (const card of live.queued) {
+        card.state = reduce6(card.state, { type: "execution.succeeded" });
+        finalize2(card);
+      }
+      live.queued.length = 0;
+    }, QUEUED_DRAIN_GRACE_MS);
+    timer.unref?.();
+    drainTimers.set(sessionID, timer);
+  };
   const sessionRuns = (sessionID) => {
     let runs = sessions.get(sessionID);
     if (!runs) {
@@ -146739,6 +146826,7 @@ function createRunController(deps) {
       if (!runs) return;
       if (event.type === "execution.started") {
         notifiedQueued.delete(sessionID);
+        cancelDrain(sessionID);
         if (runs.active) {
           update2(runs.active, event, true);
           return;
@@ -146746,41 +146834,62 @@ function createRunController(deps) {
         const next = runs.queued.shift();
         if (next) {
           runs.active = next;
+          deps.log.debug("\u6392\u961F\u5361\u664B\u5347\u4E3A\u8FD0\u884C\u5361", { sessionID, runID: next.runID });
           update2(next, event, true);
         }
+        if (runs.queued.length > 0) scheduleDrain(sessionID, runs);
         return;
       }
+      if (!runs.active && runs.queued.length > 0 && isActivityEvent(event.type)) {
+        const next = runs.queued.shift();
+        runs.active = next;
+        deps.log.info("\u6536\u5230\u6D3B\u52A8\u4E8B\u4EF6\u4F46\u65E0\u8FD0\u884C\u5361\uFF1A\u664B\u5347\u961F\u9996\u6392\u961F\u5361", {
+          sessionID,
+          runID: next.runID,
+          event: event.type
+        });
+        next.state = reduce6(next.state, { type: "execution.started" });
+      }
       const card = runs.active;
-      if (!card) return;
-      if (event.type === "execution.succeeded") {
-        const text = trailingText(card.state.blocks);
-        const long = deps.sendFinalAnswer !== void 0 && deps.finalAnswer !== void 0 && text.length >= deps.finalAnswer.minChars;
-        if (long) {
-          card.state = reduce6(reduce6(card.state, { type: "final.separated" }), event);
+      if (event.type === "execution.succeeded" || event.type === "execution.failed") {
+        if (card) {
+          if (event.type === "execution.succeeded") {
+            const text = trailingText(card.state.blocks);
+            const long = deps.sendFinalAnswer !== void 0 && deps.finalAnswer !== void 0 && text.length >= deps.finalAnswer.minChars;
+            if (long) {
+              card.state = reduce6(reduce6(card.state, { type: "final.separated" }), event);
+              finalize2(card);
+              runs.active = void 0;
+              void deps.sendFinalAnswer({
+                sessionID,
+                chatId: card.chatId,
+                ...card.replyToMessageId ? { replyToMessageId: card.replyToMessageId } : {},
+                text
+              }).catch((err2) => {
+                deps.log.warn("\u6700\u7EC8\u7B54\u6848\u53D1\u9001\u5931\u8D25", { sessionID, error: errorMessage(err2) });
+              });
+              scheduleDrain(sessionID, runs);
+              return;
+            }
+          }
+          update2(card, event, true);
           finalize2(card);
           runs.active = void 0;
-          void deps.sendFinalAnswer({
-            sessionID,
-            chatId: card.chatId,
-            ...card.replyToMessageId ? { replyToMessageId: card.replyToMessageId } : {},
-            text
-          }).catch((err2) => {
-            deps.log.warn("\u6700\u7EC8\u7B54\u6848\u53D1\u9001\u5931\u8D25", { sessionID, error: errorMessage(err2) });
-          });
-          return;
         }
-        update2(card, event, true);
-        finalize2(card);
-        runs.active = void 0;
-        return;
-      }
-      if (event.type === "execution.failed") {
-        update2(card, event, true);
-        finalize2(card);
-        runs.active = void 0;
+        scheduleDrain(sessionID, runs);
         return;
       }
+      if (!card) return;
       update2(card, event, false);
+      if (isActivityEvent(event.type)) {
+        deps.log.debug("\u8FD0\u884C\u5361\u5757\u7ED3\u6784", {
+          sessionID,
+          event: event.type,
+          blocks: card.state.blocks.map(
+            (b) => b.kind === "text" ? `T${b.streaming ? "*" : ""}${b.content.length}` : `tool:${b.tool.name}`
+          )
+        });
+      }
     },
     hasActive(sessionID) {
       return sessions.get(sessionID)?.active !== void 0;
@@ -146818,6 +146927,8 @@ function createRunController(deps) {
       disposed = true;
       sessionModels.clear();
       notifiedQueued.clear();
+      for (const timer of drainTimers.values()) clearTimeout(timer);
+      drainTimers.clear();
       for (const throttler of throttlers.values()) throttler.cancel();
       throttlers.clear();
       for (const runs of sessions.values()) {
@@ -148451,6 +148562,128 @@ function parsePage(value3) {
   const parsed = typeof value3 === "number" ? value3 : typeof value3 === "string" ? Number.parseInt(value3, 10) : Number.NaN;
   return Number.isFinite(parsed) && parsed > 0 ? Math.floor(parsed) : 0;
 }
+
+// src/feishu/quick-new-cards.ts
+function button3(text, type, value3) {
+  return {
+    tag: "button",
+    text: { tag: "plain_text", content: text },
+    type,
+    behaviors: [{ type: "callback", value: value3 }]
+  };
+}
+function buildQuickNewThinkingCard() {
+  return {
+    schema: "2.0",
+    config: { update_multi: true },
+    header: { title: { tag: "plain_text", content: "\u{1F914} \u6B63\u5728\u8BC6\u522B\u610F\u56FE\u4E0E\u76EE\u5F55\u2026" }, template: "blue" },
+    body: {
+      elements: [
+        { tag: "markdown", content: "\u6B63\u5728\u5224\u65AD\u8FD9\u6761\u6D88\u606F\u662F\u5426\u9700\u8981\u65B0\u5EFA\u4F1A\u8BDD\uFF0C\u4EE5\u53CA\u6700\u5408\u9002\u7684\u5DE5\u4F5C\u76EE\u5F55\u2026" }
+      ]
+    }
+  };
+}
+function buildQuickNewProposalCard(input) {
+  const preview = input.textPreview.trim().replace(/\n+/g, " ").slice(0, 120);
+  const lines = [
+    `**\u4EFB\u52A1**\uFF1A${input.title}`,
+    `**\u76EE\u5F55**\uFF1A\`${input.directory}\``,
+    ...input.reason ? [`**\u4F9D\u636E**\uFF1A${input.reason}`] : [],
+    "",
+    `\u539F\u6D88\u606F\uFF1A${preview}`
+  ];
+  const elements = [
+    { tag: "markdown", content: truncateCardContent(lines.join("\n")) },
+    {
+      tag: "markdown",
+      content: "\u70B9\u300C\u521B\u5EFA\u5E76\u53D1\u9001\u300D= \u5EFA\u4F1A\u8BDD + \u81EA\u52A8\u5F00\u8BDD\u9898 + \u628A\u539F\u6D88\u606F\u53D1\u8FDB\u53BB\u5F00\u59CB\u5904\u7406\u3002",
+      text_size: "notation"
+    },
+    button3("\u2705 \u521B\u5EFA\u5E76\u53D1\u9001", "primary", { cmd: "quicknew", op: "create", id: input.id }),
+    button3("\u274C \u53D6\u6D88", "default", { cmd: "quicknew", op: "cancel", id: input.id })
+  ];
+  return {
+    schema: "2.0",
+    config: { update_multi: true },
+    header: { title: { tag: "plain_text", content: "\u{1F195} \u5EFA\u8BAE\u65B0\u5EFA\u4F1A\u8BDD" }, template: "turquoise" },
+    body: { elements }
+  };
+}
+function buildQuickNewResolvedCard(title, note2, template2 = "grey") {
+  return {
+    schema: "2.0",
+    config: { update_multi: true },
+    header: { title: { tag: "plain_text", content: title }, template: template2 },
+    body: { elements: [{ tag: "markdown", content: truncateCardContent(note2) }] }
+  };
+}
+function parseQuickNewActionValue(raw) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) return void 0;
+  const value3 = raw;
+  if (value3.cmd !== "quicknew") return void 0;
+  const op = value3.op === "create" || value3.op === "cancel" ? value3.op : void 0;
+  const id2 = typeof value3.id === "string" ? value3.id.trim() : "";
+  if (!op || !id2) return void 0;
+  return { op, id: id2 };
+}
+
+// src/session/quick-new.ts
+var QUICK_NEW_INSTRUCTION = [
+  "\u4F60\u662F\u98DE\u4E66 AI \u52A9\u624B\u300C\u7BA1\u7406\u53F0\u300D\u7684\u610F\u56FE\u8BC6\u522B\u5668\u3002\u7528\u6237\u5728\u7BA1\u7406\u53F0\uFF08\u8FD8\u6CA1\u6709\u4F1A\u8BDD\uFF09\u53D1\u6765\u4E00\u6761\u6D88\u606F\u3002",
+  "\u8BF7\u5224\u65AD\u5B83\u662F\u4E0D\u662F\u4E00\u4E2A\u9700\u8981\u65B0\u5EFA\u4F1A\u8BDD\u53BB\u6267\u884C\u7684\u5F00\u53D1/\u64CD\u4F5C\u4EFB\u52A1\uFF0C\u5E76\u4ECE\u5019\u9009\u76EE\u5F55\u4E2D\u9009\u51FA\u6700\u5408\u9002\u7684\u5DE5\u4F5C\u76EE\u5F55\u3002",
+  "\u53EA\u8F93\u51FA\u4E00\u4E2A JSON \u5BF9\u8C61\uFF0C\u4E0D\u8981\u4EFB\u4F55\u5176\u4ED6\u6587\u5B57\uFF1A",
+  '{"intent":"task|chat","dir":"<\u7EDD\u5BF9\u8DEF\u5F84\u6216\u7A7A\u5B57\u7B26\u4E32>","title":"<\u4E0D\u8D85\u8FC720\u5B57\u7684\u4F1A\u8BDD\u6807\u9898>","reason":"<\u4E00\u53E5\u8BDD\u7406\u7531>"}',
+  "\u89C4\u5219\uFF1A",
+  "- \u95F2\u804A\u3001\u95EE\u5019\u3001\u8BE2\u95EE\u7528\u6CD5 \u2192 intent=chat\uFF0Cdir \u7559\u7A7A\u3002",
+  "- \u660E\u786E\u7684\u5F00\u53D1/\u64CD\u4F5C\u4EFB\u52A1\uFF08\u6539 bug\u3001\u5199\u4EE3\u7801\u3001\u6574\u7406\u6587\u4EF6\u3001\u8DD1\u811A\u672C\u7B49\uFF09\u2192 intent=task\u3002",
+  "- dir \u53EA\u80FD\u4ECE\u5019\u9009\u76EE\u5F55\u4E2D\u9009\u62E9\uFF08\u8BED\u4E49\u6700\u5339\u914D\u7684\u90A3\u4E2A\uFF09\uFF1B\u627E\u4E0D\u5230\u5408\u9002\u7684\u5C31\u7559\u7A7A\u5B57\u7B26\u4E32\u3002"
+].join("\n");
+function buildQuickNewPrompt(text, candidates) {
+  const list = candidates.slice(0, 40).map((c) => `- ${c.path}${c.label ? `\uFF08${c.label}\uFF09` : ""}`).join("\n");
+  return [
+    QUICK_NEW_INSTRUCTION,
+    "",
+    "\u5019\u9009\u76EE\u5F55\uFF1A",
+    list || "\uFF08\u65E0\uFF09",
+    "",
+    "\u7528\u6237\u6D88\u606F\uFF1A",
+    text.slice(0, 2e3)
+  ].join("\n");
+}
+function parseQuickNewDecision(raw) {
+  if (!raw) return void 0;
+  const text = raw.trim();
+  const start2 = text.indexOf("{");
+  const end = text.lastIndexOf("}");
+  if (start2 < 0 || end <= start2) return void 0;
+  let parsed;
+  try {
+    parsed = JSON.parse(text.slice(start2, end + 1));
+  } catch {
+    return void 0;
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) return void 0;
+  const obj = parsed;
+  const intent = obj.intent === "task" ? "task" : obj.intent === "chat" ? "chat" : void 0;
+  if (!intent) return void 0;
+  const dir = typeof obj.dir === "string" ? obj.dir.trim() : typeof obj.directory === "string" ? obj.directory.trim() : "";
+  const title = typeof obj.title === "string" ? obj.title.trim().slice(0, 30) : "";
+  const reason = typeof obj.reason === "string" ? obj.reason.trim().slice(0, 200) : "";
+  return {
+    intent,
+    ...dir ? { directory: dir } : {},
+    ...title ? { title } : {},
+    ...reason ? { reason } : {}
+  };
+}
+function matchCandidateDirectory(directory, candidates) {
+  if (!directory) return void 0;
+  const normalize2 = (p) => p.length > 1 && p.endsWith("/") ? p.slice(0, -1) : p;
+  const target = normalize2(directory);
+  const hit = candidates.find((c) => normalize2(c.path) === target);
+  return hit?.path;
+}
 var SYSTEM_DIRS = [
   "/etc",
   "/usr",
@@ -149202,7 +149435,7 @@ var SETUP_FORM_FIELDS = {
 var SETUP_FORM_MAX_MODELS = 15;
 var SETUP_FORM_DEFAULT_PERM = "edit";
 var SETUP_FORM_DIR_CUSTOM = "__custom__";
-function button3(text, type, value3) {
+function button4(text, type, value3) {
   return {
     tag: "button",
     text: { tag: "plain_text", content: text },
@@ -149245,28 +149478,28 @@ function buildModelCard(input) {
   if (input.page <= 0 && recent.length > 0) {
     for (const model of recent) {
       const isCurrent = input.current && refKey(input.current) === refKey(model);
-      elements.push(button3(`\u{1F9E0} ${shorten(modelLabel(model), 30)}`, isCurrent ? "primary" : "default", modelValue(model, input.sid)));
+      elements.push(button4(`\u{1F9E0} ${shorten(modelLabel(model), 30)}`, isCurrent ? "primary" : "default", modelValue(model, input.sid)));
     }
     if (input.models.length > recent.length) {
-      elements.push(button3("\u66F4\u591A \u25B8", "default", moreValue(1, input.sid)));
+      elements.push(button4("\u66F4\u591A \u25B8", "default", moreValue(1, input.sid)));
     }
   } else {
     const pageNum = input.page <= 0 ? 1 : input.page;
     const slice = input.models.slice((pageNum - 1) * pageSize, pageNum * pageSize);
     if (slice.length === 0 && recent.length > 0) {
       for (const model of recent) {
-        elements.push(button3(`\u{1F9E0} ${shorten(modelLabel(model), 30)}`, "default", modelValue(model, input.sid)));
+        elements.push(button4(`\u{1F9E0} ${shorten(modelLabel(model), 30)}`, "default", modelValue(model, input.sid)));
       }
     } else {
       for (const model of slice) {
         const isCurrent = input.current && refKey(input.current) === refKey(model);
         elements.push(
-          button3(`\u{1F9E0} ${shorten(modelLabel(model), 30)}`, isCurrent ? "primary" : "default", modelValue(model, input.sid))
+          button4(`\u{1F9E0} ${shorten(modelLabel(model), 30)}`, isCurrent ? "primary" : "default", modelValue(model, input.sid))
         );
       }
-      if (pageNum > 1) elements.push(button3("\u25C2 \u4E0A\u4E00\u9875", "default", moreValue(pageNum - 1, input.sid)));
+      if (pageNum > 1) elements.push(button4("\u25C2 \u4E0A\u4E00\u9875", "default", moreValue(pageNum - 1, input.sid)));
       if (pageNum * pageSize < input.models.length) {
-        elements.push(button3("\u4E0B\u4E00\u9875 \u25B8", "default", moreValue(pageNum + 1, input.sid)));
+        elements.push(button4("\u4E0B\u4E00\u9875 \u25B8", "default", moreValue(pageNum + 1, input.sid)));
       }
     }
   }
@@ -149280,7 +149513,7 @@ function buildPermCard(input) {
   }
   const elements = [{ tag: "markdown", content: truncateCardContent(lines.join("\n")) }];
   for (const info of PERMISSION_PRESETS) {
-    elements.push(button3(presetLabel(info.id), input.current === info.id ? "primary" : "default", permValue(info.id, input.sid)));
+    elements.push(button4(presetLabel(info.id), input.current === info.id ? "primary" : "default", permValue(info.id, input.sid)));
   }
   return headerCard("\u{1F510} \u9009\u62E9\u6743\u9650\u6863\u4F4D", "orange", elements);
 }
@@ -149296,8 +149529,8 @@ function buildConfirmCard(input) {
   ];
   return headerCard("\u2705 \u786E\u8BA4\u521B\u5EFA\u4F1A\u8BDD", "green", [
     { tag: "markdown", content: truncateCardContent(lines.join("\n")) },
-    button3("\u2705 \u521B\u5EFA", "primary", { wizard: "confirm" }),
-    button3("\u2716\uFE0F \u53D6\u6D88", "default", { wizard: "cancel" })
+    button4("\u2705 \u521B\u5EFA", "primary", { wizard: "confirm" }),
+    button4("\u2716\uFE0F \u53D6\u6D88", "default", { wizard: "cancel" })
   ]);
 }
 function buildSetupDoneCard(title, lines, template2 = "grey") {
@@ -150857,6 +151090,7 @@ async function routeEvent(event, deps) {
       break;
     case "session.text.started": {
       const data = event.data;
+      deps.log.debug("text.started", { sessionID: data.sessionID, msg: data.assistantMessageID });
       deps.applyRun(data.sessionID, {
         type: "text.started",
         ...data.assistantMessageID ? { assistantMessageID: data.assistantMessageID } : {}
@@ -150865,6 +151099,11 @@ async function routeEvent(event, deps) {
     }
     case "session.text.delta": {
       const data = event.data;
+      deps.log.debug("text.delta", {
+        sessionID: data.sessionID,
+        msg: data.assistantMessageID,
+        len: typeof data.delta === "string" ? data.delta.length : 0
+      });
       deps.applyRun(data.sessionID, {
         type: "text.delta",
         delta: data.delta,
@@ -150874,6 +151113,12 @@ async function routeEvent(event, deps) {
     }
     case "session.text.ended": {
       const data = event.data;
+      deps.log.debug("text.ended", {
+        sessionID: data.sessionID,
+        msg: data.assistantMessageID,
+        len: typeof data.text === "string" ? data.text.length : -1,
+        hasText: typeof data.text === "string"
+      });
       deps.applyRun(data.sessionID, {
         type: "text.ended",
         ...data.text ? { text: data.text } : {},
@@ -150916,18 +151161,21 @@ async function routeEvent(event, deps) {
     }
     case "session.execution.started": {
       const data = event.data;
+      deps.log.debug("execution.started", { sessionID: data.sessionID });
       deps.markStarted(data.sessionID);
       deps.applyRun(data.sessionID, { type: "execution.started" });
       break;
     }
     case "session.execution.succeeded": {
       const data = event.data;
+      deps.log.debug("execution.succeeded", { sessionID: data.sessionID });
       deps.markEnded(data.sessionID);
       deps.applyRun(data.sessionID, { type: "execution.succeeded" });
       break;
     }
     case "session.execution.failed": {
       const data = event.data;
+      deps.log.debug("execution.failed", { sessionID: data.sessionID });
       deps.markEnded(data.sessionID);
       deps.applyRun(data.sessionID, { type: "execution.failed", error: extractErrorText(data.error) });
       void deps.notifyFailure(data.sessionID, data.error);
@@ -150935,6 +151183,7 @@ async function routeEvent(event, deps) {
     }
     case "session.execution.interrupted": {
       const data = event.data;
+      deps.log.debug("execution.interrupted", { sessionID: data.sessionID, reason: data.reason });
       deps.markEnded(data.sessionID);
       deps.applyRun(data.sessionID, { type: "execution.failed", error: `\u5DF2\u4E2D\u65AD\uFF08${data.reason ?? "unknown"}\uFF09` });
       break;
@@ -150942,6 +151191,7 @@ async function routeEvent(event, deps) {
     case "session.status": {
       const data = event.data;
       const statusType = data.status?.type;
+      deps.log.debug("session.status", { sessionID: data.sessionID, status: statusType });
       if (statusType === "idle") {
         deps.markEnded(data.sessionID);
         deps.applyRun(data.sessionID, { type: "execution.succeeded" });
@@ -150952,6 +151202,7 @@ async function routeEvent(event, deps) {
     }
     case "session.idle": {
       const data = event.data;
+      deps.log.debug("session.idle", { sessionID: data.sessionID });
       deps.markEnded(data.sessionID);
       deps.applyRun(data.sessionID, { type: "execution.succeeded" });
       break;
@@ -151269,7 +151520,8 @@ function routeCardAction(action, deps) {
     return deps.handleCompact(action);
   }
   const hasForm = action.formValue !== void 0;
-  const routed = hasForm || isSetupFormAction(value3) || Boolean(parseSessionCardValue(value3)) || Boolean(parseSetupCardValue(value3));
+  const routed = hasForm || isSetupFormAction(value3) || Boolean(parseSessionCardValue(value3)) || Boolean(parseSetupCardValue(value3)) || // 「一句话建会话」建议卡按钮（issue #2）。
+  Boolean(parseQuickNewActionValue(value3));
   deps.log.debug("\u5361\u7247\u56DE\u8C03\u8DEF\u7531", {
     hasForm,
     hasValue: value3 !== void 0,
@@ -152031,6 +152283,10 @@ async function start(ctx, config, log2, logSink) {
       rootKnown: Boolean(rootLink)
     });
     if (decision.kind === "main-hint") {
+      if (config.quickNew) {
+        await handleQuickNew(message);
+        return;
+      }
       const res = await sender.sendCard(message.chatId, buildConsoleHintCard());
       if (!res.ok) log2.warn("\u7BA1\u7406\u53F0\u63D0\u793A\u5361\u53D1\u9001\u5931\u8D25", { error: res.error ?? "unknown" });
       return;
@@ -152126,6 +152382,242 @@ async function start(ctx, config, log2, logSink) {
     log2.info("\u673A\u5668\u4EBA\u83DC\u5355\u70B9\u51FB \u2192 \u6267\u884C\u547D\u4EE4", { eventKey: click.eventKey, cmd: entry.cmd, label: entry.label });
     await handleMessage(synthetic);
   }
+  const QUICK_NEW_KEY_PREFIX = "feishu:v2:quicknew:";
+  const QUICK_NEW_TTL_MS = 60 * 60 * 1e3;
+  function parseQuickNewEntry(raw) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) return void 0;
+    const v = raw;
+    const text = typeof v.text === "string" ? v.text : "";
+    const dir = typeof v.dir === "string" ? v.dir : "";
+    const chatId = typeof v.chatId === "string" ? v.chatId : "";
+    const openId = typeof v.openId === "string" ? v.openId : "";
+    const anchorMessageId = typeof v.anchorMessageId === "string" ? v.anchorMessageId : "";
+    if (!text || !dir || !chatId || !openId || !anchorMessageId) return void 0;
+    return {
+      text,
+      title: typeof v.title === "string" ? v.title : "",
+      dir,
+      chatId,
+      openId,
+      anchorMessageId,
+      createdAt: typeof v.createdAt === "number" ? v.createdAt : 0
+    };
+  }
+  async function handleQuickNew(message) {
+    const hint = async () => {
+      const res = await sender.sendCard(message.chatId, buildConsoleHintCard());
+      if (!res.ok) log2.warn("\u7BA1\u7406\u53F0\u63D0\u793A\u5361\u53D1\u9001\u5931\u8D25", { error: res.error ?? "unknown" });
+    };
+    try {
+      const candidates = [];
+      const seen = /* @__PURE__ */ new Set();
+      for (const dir2 of await recent.listDirs()) {
+        if (!seen.has(dir2)) {
+          seen.add(dir2);
+          candidates.push({ path: dir2 });
+        }
+      }
+      let entries3 = [];
+      try {
+        const raw = await listAllSessionsRaw() ?? await listSessionsOverHttp({}, { log: log2 });
+        entries3 = normalizeSessionList(raw) ?? [];
+      } catch (err2) {
+        log2.debug("quick-new \u4F1A\u8BDD\u5217\u8868\u8BFB\u53D6\u5931\u8D25", { error: errorMessage(err2) });
+      }
+      for (const entry2 of entries3) {
+        if (entry2.directory && !seen.has(entry2.directory)) {
+          seen.add(entry2.directory);
+          candidates.push({ path: entry2.directory, ...entry2.title ? { label: entry2.title } : {} });
+        }
+      }
+      const routingSessionID = entries3[0]?.sessionID;
+      if (candidates.length === 0 || !routingSessionID) {
+        log2.debug("quick-new \u65E0\u5019\u9009\u76EE\u5F55\u6216\u4F1A\u8BDD\uFF0C\u56DE\u9000\u63D0\u793A\u5361", {
+          candidates: candidates.length,
+          hasRouting: Boolean(routingSessionID)
+        });
+        await hint();
+        return;
+      }
+      const ack = await sender.sendCard(message.chatId, buildQuickNewThinkingCard());
+      if (!ack.ok || !ack.messageId) {
+        await hint();
+        return;
+      }
+      const generateText = async (prompt, requestOptions) => {
+        const api = ctx.generate.text;
+        if (typeof api !== "function") throw new Error("generate.text unavailable");
+        return api({ prompt }, requestOptions);
+      };
+      const outcome = await quickGenerateWithSession(
+        { log: log2, generateText },
+        { prompt: buildQuickNewPrompt(message.text, candidates), sessionID: routingSessionID }
+      );
+      const decision = parseQuickNewDecision(extractGeneratedText(outcome.result));
+      const dir = decision?.intent === "task" ? matchCandidateDirectory(decision.directory, candidates) : void 0;
+      const validation = dir ? validateDir(dir) : void 0;
+      if (!decision || decision.intent !== "task" || !dir || !validation?.ok) {
+        log2.debug("quick-new \u5224\u5B9A\u4E3A\u975E\u4EFB\u52A1\u6216\u672A\u5339\u914D\u5230\u76EE\u5F55", {
+          intent: decision?.intent,
+          dir: decision?.directory,
+          reason: decision?.reason
+        });
+        await sender.patchCard(ack.messageId, buildConsoleHintCard());
+        return;
+      }
+      const id2 = `qn_${message.messageId}`;
+      const title = decision.title || topicTitle(message.text);
+      const entry = {
+        text: message.text,
+        title,
+        dir: validation.path,
+        chatId: message.chatId,
+        openId: message.senderOpenId,
+        anchorMessageId: message.messageId,
+        createdAt: Date.now()
+      };
+      await ctx.storage.set(
+        QUICK_NEW_KEY_PREFIX + id2,
+        entry
+      );
+      await sender.patchCard(
+        ack.messageId,
+        buildQuickNewProposalCard({
+          id: id2,
+          title,
+          directory: validation.path,
+          textPreview: message.text,
+          ...decision.reason ? { reason: decision.reason } : {}
+        })
+      );
+      log2.info("quick-new \u5EFA\u8BAE\u5361\u5DF2\u53D1\u9001", { dir: validation.path, title, reason: decision.reason });
+    } catch (err2) {
+      log2.warn("quick-new \u5904\u7406\u5931\u8D25\uFF0C\u56DE\u9000\u7BA1\u7406\u53F0\u63D0\u793A", { error: errorMessage(err2) });
+      await hint();
+    }
+  }
+  async function handleQuickNewCardAction(action, value3) {
+    if (!owner.isAllowed(action.operatorOpenId)) {
+      return { toast: { type: "error", content: "\u65E0\u64CD\u4F5C\u6743\u9650" } };
+    }
+    const key = QUICK_NEW_KEY_PREFIX + value3.id;
+    let raw;
+    try {
+      raw = await ctx.storage.get(key);
+    } catch {
+      raw = void 0;
+    }
+    const entry = parseQuickNewEntry(raw);
+    if (!entry || Date.now() - entry.createdAt > QUICK_NEW_TTL_MS) {
+      try {
+        await ctx.storage.remove(key);
+      } catch {
+      }
+      if (action.messageId) {
+        await sender.patchCard(
+          action.messageId,
+          buildQuickNewResolvedCard("\u231B\uFE0F \u5EFA\u8BAE\u5DF2\u8FC7\u671F", "\u8BF7\u91CD\u65B0\u53D1\u9001\u6D88\u606F\u3002", "orange")
+        );
+      }
+      return { toast: { type: "warning", content: "\u5DF2\u8FC7\u671F\uFF0C\u8BF7\u91CD\u53D1\u6D88\u606F" } };
+    }
+    if (value3.op === "cancel") {
+      try {
+        await ctx.storage.remove(key);
+      } catch {
+      }
+      if (action.messageId) {
+        await sender.patchCard(action.messageId, buildQuickNewResolvedCard("\u274C \u5DF2\u53D6\u6D88", "\u672A\u521B\u5EFA\u4F1A\u8BDD\u3002"));
+      }
+      return { toast: { type: "info", content: "\u5DF2\u53D6\u6D88" } };
+    }
+    const validation = validateDir(entry.dir);
+    if (!validation.ok) {
+      if (action.messageId) {
+        await sender.patchCard(
+          action.messageId,
+          buildQuickNewResolvedCard("\u26A0\uFE0F \u76EE\u5F55\u4E0D\u53EF\u7528", `${entry.dir}\uFF1A${validation.message}`, "red")
+        );
+      }
+      return { toast: { type: "error", content: "\u76EE\u5F55\u4E0D\u53EF\u7528" } };
+    }
+    try {
+      await ctx.storage.remove(key);
+    } catch {
+    }
+    const perm = "edit";
+    const title = entry.title || topicTitle(entry.text);
+    void (async () => {
+      const created = await createSessionInternal({
+        title,
+        chatId: entry.chatId,
+        openId: entry.openId,
+        setActive: false,
+        directory: validation.path,
+        permissions: presetToRuleset(perm),
+        perm,
+        gateMode: presetGateMode(perm)
+      });
+      await recent.addDir(validation.path);
+      const readyCard = buildSessionReadyCard({
+        title,
+        sessionID: created.id,
+        dir: validation.path,
+        perm: presetLabel(perm)
+      });
+      const res = await sender.replyCard(entry.anchorMessageId, readyCard, { replyInThread: true });
+      if (res.ok && res.messageId) {
+        await sessionMap.bindRoot(entry.anchorMessageId, created.id);
+        const meta = res.threadId ? void 0 : await sender.getMessageMeta(res.messageId);
+        const threadId = res.threadId ?? meta?.threadId;
+        if (threadId) {
+          await sessionMap.bindThread(threadId, created.id, entry.chatId, entry.openId, entry.anchorMessageId);
+        } else {
+          log2.warn("quick-new \u5F00\u8BDD\u9898\u540E\u672A\u8BFB\u5230 thread_id", { sessionID: created.id });
+        }
+        await sessionMap.setRootCard(created.id, {
+          style: "created",
+          sessionID: created.id,
+          title,
+          dir: validation.path,
+          perm: presetLabel(perm)
+        });
+      } else {
+        log2.warn("quick-new \u5F00\u8BDD\u9898\u5931\u8D25", { sessionID: created.id, error: res.error ?? "unknown" });
+      }
+      await runInSession(
+        {
+          eventId: `quicknew_${value3.id}`,
+          messageId: entry.anchorMessageId,
+          chatId: entry.chatId,
+          text: entry.text,
+          senderOpenId: entry.openId
+        },
+        created.id,
+        entry.anchorMessageId
+      );
+      if (action.messageId) {
+        await sender.patchCard(
+          action.messageId,
+          buildQuickNewResolvedCard(
+            "\u2705 \u5DF2\u521B\u5EFA",
+            `\u76EE\u5F55\uFF1A\`${validation.path}\`
+\u5DF2\u5F00\u8BDD\u9898\u5E76\u5F00\u59CB\u5904\u7406\u4F60\u7684\u6D88\u606F\u3002`,
+            "green"
+          )
+        );
+      }
+    })().catch((err2) => {
+      log2.warn("quick-new \u5EFA\u4F1A\u8BDD\u5931\u8D25", { error: errorMessage(err2) });
+      if (action.messageId) {
+        void sender.patchCard(
+          action.messageId,
+          buildQuickNewResolvedCard("\u26A0\uFE0F \u521B\u5EFA\u5931\u8D25", errorMessage(err2).slice(0, 160), "red")
+        );
+      }
+    });
+    return { toast: { type: "success", content: "\u5DF2\u521B\u5EFA\uFF0C\u6B63\u5728\u6253\u5F00\u8BDD\u9898\u2026" } };
+  }
   async function runInActiveSession(message) {
     let active = await sessionMap.getActive(message.chatId);
     if (!active) {
@@ -152200,7 +152692,11 @@ ${downloadedAttachmentPrompt(message.attachment, outcome)}`;
       handleForm: (a) => formRelay.handleCardAction(a),
       handleStop: (a) => stop.handleCardAction(a),
       handleCompact: (a) => compact2.handleCardAction(a),
-      handleCommands: (a) => commands.handleCardAction(a),
+      handleCommands: (a) => {
+        const quick = parseQuickNewActionValue(a.rawValue);
+        if (quick) return handleQuickNewCardAction(a, quick);
+        return commands.handleCardAction(a);
+      },
       handleApprovals: (a) => approvals.handleCardAction(a)
     })
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-feishu-plugin",
-  "version": "0.2.12",
+  "version": "0.2.14",
   "description": "Feishu/Lark plugin for OpenCode V2 — single-user topics as sessions, in-card permission approvals, streaming cards. Minimal permissions, no public endpoint.",
   "type": "module",
   "main": "index.js",