lark-relay 0.3.0 → 0.4.0

package/README.md

@@ -73,20 +73,29 @@ chats: [oc_xxx]
 dirs: [/path/to/repo]            # 首个 = 主工作目录
 instructions: ./instructions.md  # 职责/边界,--append-system-prompt-file 注入
 filter: '.mentions[]?.id == "ou_xxx"'   # 可选
-# mode: work        默认;work | chat(见下)
+# mode: work        默认;work | chat | agent(见下)
 # model: <名称>      默认走终端同一套默认路由
 ```
 
-`mode` 就两个场景 —— 一个键定死全部行为,不用拼组合:
-
-| | `work`(默认) | `chat` |
-|---|---|---|
-| 用途 | 处理工作 | 日常闲聊 |
-| 回复位置 | 话题内(首问开话题) | 直接发群里 |
-| 过程展示 | COT 消息(实时流式) | 无 |
-| 结论 | 卡片(markdown 渲染) | 纯文本 |
-| session 隔离 | 按 `thread_id`(话题即边界,不滚动) | 按 (群, epoch),空闲超 `idle_gap` 开新世代 |
-| 防抖 | 1s(一问一答要跟手) | 15s(等人打完多行) |
+`mode` 三个场景 —— 一个键定死全部行为,不用拼组合:
+
+| | `work`(默认) | `chat` | `agent` |
+|---|---|---|---|
+| 用途 | 处理工作 | 简单问答 | 群运营 |
+| 回复位置 | 话题内(首问开话题) | 直接发群里 | **模型自己决定** |
+| 过程展示 | COT 消息(实时流式) | 无 | 无 |
+| 结论投递 | 引擎发卡片 | 引擎发纯文本 | **引擎不发** |
+| session 隔离 | 按 `thread_id` | 按 (群, epoch) | 按 (群, epoch) |
+| 防抖 | 1s | 15s | 15s |
+
+`agent` 是给「**多数轮该沉默**」的场景准备的:群运营里绝大多数消息不需要回应,
+而 `work`/`chat` 的提示词都承诺「你的最终回复会被发回群」,等于逼模型每轮说话。
+`agent` 模式下引擎只负责拉起模型、传消息批次、记台账 —— 发不发、回哪条、
+用哪个 bot 身份、发文字还是表情回应,全由模型按 `instructions` 决定(它有
+Bash + lark-cli)。沉默的轮也会进台账,便于事后看它到底判了多少次。
+
+这与「引擎不做权限管控」是同一条思路:**引擎不做回复决策,边界靠 instructions
+到达模型侧**。
 
 `work` 的过程与结论是**两条消息** —— COT 消息只承载过程(接口的设计前提),
 结论另发一条卡片。卡片发送失败会自动降级纯文本,保证结论必达。

package/lib/claude.js

@@ -46,12 +46,34 @@ function sessionEpoch(stateDir, task, chatId, idleGap) {
   return epoch
 }
 
-const PROMPT_TEMPLATE = (batch) =>
-  `下面是飞书群里最新一批消息。请把它们当作针对本仓库(当前工作目录)的任务来处理:定位/分析/修复/测试。处理完后,你的最终回复会被原样发回该群,请直接面向群里的人简洁说明你做了什么、发现了什么、需要什么确认。
+// 提示词按 mode 分流 —— 两类场景对模型的要求根本不同。
+// work/chat:模型产出一段结论,由 dispatch 发回群(模型不碰发送)。
+// agent:模型自己决定发不发、发给谁、用谁的身份、发文字还是表情 ——
+//   引擎不做回复决策,和「引擎不做权限管控」是同一条思路:边界靠 instructions 到达模型侧。
+const PROMPTS = {
+  task: (batch) =>
+    `下面是飞书群里最新一批消息。请把它们当作针对本仓库(当前工作目录)的任务来处理:定位/分析/修复/测试。处理完后,你的最终回复会被原样发回该群,请直接面向群里的人简洁说明你做了什么、发现了什么、需要什么确认。
 
 ===== 群消息 =====
 ${batch}
-===== 结束 =====`
+===== 结束 =====`,
+
+  agent: (batch) =>
+    `下面是飞书群里最新一批消息。
+
+**本轮的发送完全由你负责** —— 没有任何东西会被自动发回群。按你的职责文档判断:
+该不该回应、回应哪一条、用哪个身份、发文字还是表情回应、要不要执行既定任务。
+需要发送时自己用 lark-cli 完成。
+
+**多数情况下正确的选择是什么都不做** —— 不要为了有所动作而发言。
+
+处理完请用一句话说明你做了什么(如「用可莉回复了接梗」「无 @ 我方,沉默」),
+这句话只进台账供事后回溯,不会发到群里。
+
+===== 群消息 =====
+${batch}
+===== 结束 =====`,
+}
 
 /**
  * 起一轮 headless claude。
@@ -206,4 +228,4 @@ function shellQuote(s) {
   return `'${String(s).replace(/'/g, `'\\''`)}'`
 }
 
-module.exports = { runClaude, deriveUuid, sessionEpoch, PROMPT_TEMPLATE }
+module.exports = { runClaude, deriveUuid, sessionEpoch, PROMPTS }

package/lib/dispatch.js

@@ -122,7 +122,7 @@ async function handleGroup(t, group, opts = {}) {
 
     const res = await claude.runClaude({
       cwd,
-      prompt: claude.PROMPT_TEMPLATE(batch),
+      prompt: claude.PROMPTS[mode.prompt](batch),
       uuid,
       instructions: insPath,
       addDirs,
@@ -139,14 +139,19 @@ async function handleGroup(t, group, opts = {}) {
         : null,
     })
 
+    // 兜底文案分两套:要发回群的(deliver != none)面向群里的人写,
+    // agent 模式的 final 只进台账,不该出现「稍后重试或换个说法」这种对人说的话
     let final = (res.final || '').trim()
     if (!final) {
-      final =
-        res.rc === 0
-          ? '(完成,但没拿到最终结论)'
-          : `⚠️ 处理超时或异常(rc=${res.rc})。稍后重试或换个说法。\n\n错误:${String(res.err)
-              .replace(/\n/g, ' ')
-              .slice(-300)}`
+      const errTail = String(res.err).replace(/\n/g, ' ').slice(-300)
+      if (mode.deliver === 'none') {
+        final = res.rc === 0 ? '(本轮无自述)' : `(异常 rc=${res.rc}) ${errTail}`
+      } else {
+        final =
+          res.rc === 0
+            ? '(完成,但没拿到最终结论)'
+            : `⚠️ 处理超时或异常(rc=${res.rc})。稍后重试或换个说法。\n\n错误:${errTail}`
+      }
     }
 
     // 收尾必须包 try/catch:handleGroup 外层只有 try/finally(无 catch),
@@ -161,12 +166,15 @@ async function handleGroup(t, group, opts = {}) {
       }
     }
 
-    // 结论**总是单独一条**:work 发卡片(markdown 渲染、不受 3500 字符分片限制),
-    // chat 发纯文本。卡片失败降级纯文本 —— 保证结论必达
-    const sent = mode.card
-      ? await sendCard(final, { profile, chatId, replyTo: lastMsg, inThread: mode.thread })
-      : false
-    if (!sent) await reply(profile, chatId, lastMsg, final, { inThread: mode.thread })
+    // 结论投递:card = 卡片(markdown 渲染、不受 3500 字符分片限制),失败降级纯文本;
+    // text = 纯文本;none = **引擎不发**,agent 模式下模型已自己发过了,
+    // final 只是它的一句自述(进台账供回溯)
+    if (mode.deliver !== 'none') {
+      const sent = mode.deliver === 'card'
+        ? await sendCard(final, { profile, chatId, replyTo: lastMsg, inThread: mode.thread })
+        : false
+      if (!sent) await reply(profile, chatId, lastMsg, final, { inThread: mode.thread })
+    }
 
     ledgerAppend(task, chatId, epoch, batch, final)
     process.stderr.write(

package/lib/help.js

@@ -89,16 +89,20 @@ dispatch.yaml（4 必填 + 3 可选）
   dirs: [/path/to/repo]            # 首个 = 主工作目录
   instructions: ./instructions.md  # 职责/边界,--append-system-prompt-file 注入
   filter: '.mentions[]?.id == "ou_xxx"'   # 可选
-  # mode: work        默认;work | chat（见下）
+  # mode: work        默认;work | chat | agent（见下）
   # model: <名称>      默认走终端同一套默认路由
 
-mode 两个场景（一个键定死全部行为,不用拼组合）
+mode 三个场景（一个键定死全部行为,不用拼组合）
   work   处理工作:话题内回复 + 过程挂 COT 消息 + 结论发卡片
          + 按 thread_id 隔离 session + 防抖 1s（一问一答要跟手）
          COT 要求客户端 PC ≥ 7.70 / 移动 ≥ 7.74;老客户端那条过程消息显示为
          「Completed」（不崩）,结论卡片不受影响
-  chat   日常闲聊:直发群里 + 纯文本 + 按（群, epoch）隔离 session
+  chat   简单问答:直发群里 + 纯文本 + 按（群, epoch）隔离 session
          + 防抖 15s（等人打完多行）
+  agent  模型自己当运营者:引擎只拉起它 + 传消息 + 记台账,**一条消息都不发**。
+         发不发 / 回哪条 / 用哪个 bot 身份 / 文字还是表情,全由模型按
+         instructions 决定（它有 Bash + lark-cli）。适合「多数轮该沉默」的
+         群运营 —— work/chat 会逼模型每轮都产出一段发回群的话
 
 最佳实践
   · 边界写 instructions,别指望 --add-dir 目录的 CLAUDE.md（启动不加载）

package/lib/tasks.js

@@ -106,14 +106,17 @@ function scalar(s) {
 
 const REQUIRED = ['app', 'chats', 'dirs', 'instructions']
 
-// 两个场景,不是几个正交开关的组合 —— 一个 mode 键定死全部行为。
-// 此前是 session(thread|idle) × display(card|cot|final) 交叉出 6 种组合,
-// 而 session 一个键实际控制三件事(隔离方式、是否开话题、防抖默认值)。
+// 三个场景,不是几个正交开关的组合 —— 一个 mode 键定死全部行为。
+// deliver 决定「结论由谁发」:card/text = 引擎发,none = 模型自己发。
 const MODES = {
   // 日常闲聊:群里直接对话,不开话题
-  chat: { thread: false, cot: false, card: false, debounce: 15 },
+  chat: { thread: false, cot: false, deliver: 'text', prompt: 'task', debounce: 15 },
   // 处理工作:话题内一问一答,过程挂 COT,结论发卡片
-  work: { thread: true, cot: true, card: true, debounce: 1 },
+  work: { thread: true, cot: true, deliver: 'card', prompt: 'task', debounce: 1 },
+  // 模型自己当运营者:引擎只拉起它 + 传消息 + 记台账,**不发任何消息**。
+  // 发不发、回哪条、用谁的身份、文字还是表情,全由模型按 instructions 决定
+  // (它有 Bash + lark-cli)。多数轮的正解是沉默 —— 引擎不该逼它每轮都说话
+  agent: { thread: false, cot: false, deliver: 'none', prompt: 'agent', debounce: 15 },
 }
 
 function validate(name, cfg, taskDir) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lark-relay",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Lark event relay: collect events to disk, take a batch when you need it, or dispatch work to an AI agent.",
   "keywords": [
     "lark",