aai-lark-bridge 0.1.9 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -47,6 +47,10 @@ lark-cli --version # 见下方说明
47
47
  会话;不要通过删历史、改会话元数据或自动另开会话处理兼容问题。
48
48
  - 启动失败会显示 stderr 的最后 500 字符,避免真正的终止错误被前面的插件警告盖住。
49
49
 
50
+ ### SDLC 文档评论确认(可选)
51
+
52
+ `preferences.sdlcConfirmationWorkspace` 可设为 SDLC 工作区绝对路径,默认关闭。普通文档评论先保存最小线索,再唤醒固定只读核验;事件正文不作为授权。需同时安装并启用 SDLC 评论核验,部署后实测事件覆盖;配置与暂停方式见仓库 `plugins/aai-sdlc/agent/README.md`。
53
+
50
54
  ### 第 2 步:安装
51
55
 
52
56
  ```bash
@@ -162,6 +166,34 @@ aai-lark-bridge ps
162
166
  | `status` | 查看 pid、上次退出、日志路径 |
163
167
  | `unregister` | 移除服务注册 |
164
168
 
169
+ ### 飞书任务说明
170
+
171
+ 通过 bridge 新建或实质性校准飞书任务时,agent 会被要求把任务目标、业务规则、改动逻辑
172
+ 与范围、验收标准、待确认事项和来源依据写进任务描述,并在写入后读回核验。
173
+ 会议来源优先核对逐字稿;未确认的信息标为待确认。仅修改日期、负责人或状态时,
174
+ 保留原有正文。这是 Claude/Codex 共用的运行约定,会议自动建任务的执行实现由
175
+ `aai-meeting-digest` 插件提供。
176
+
177
+ ### 会议智能体(独立入会)
178
+
179
+ bot 以应用身份作为真实参会者入会,不依赖某个人在会。飞书侧仍是早鸟灰度,
180
+ Lark 国际版租户是否开放以灰度群答复为准。
181
+
182
+ 飞书侧准备(应用身份):
183
+
184
+ - 权限:`vc:meeting.bot.join:write`(入会 / 离会)、`vc:meeting.meetingevent:read`
185
+ (会中事件)、`vc:meeting.message:write`(会中发消息;缺它能入会但回答发不出去,
186
+ 官方接入手册没列)
187
+ - 事件(长连接):`vc.bot.meeting_invited_v1`、`vc.bot.meeting_activity_v1`、
188
+ `vc.bot.meeting_ended_v1`,改完发布版本
189
+ - 每场会议 owner 在安全设置里开「允许智能体入会」(找不到先开 AI 总结)
190
+
191
+ bridge 侧:profile 配置 `meeting.enabled: true`(按需开 `autoJoinOnInvite`、
192
+ `summaryOnEnd`),然后 `/reconnect` 重建连接才会挂上会议事件;日志出现
193
+ `meeting / push-hooked` 即生效。会中聊天以 `@bot` 或 `@<bot 名>` 开头才触发 agent,
194
+ 字幕只作上下文。IM 侧用 `/meeting join <9 位会议号>`、`leave`、`transcript`、
195
+ `notes`、`ask`、`stop`。
196
+
165
197
  ### Profile
166
198
 
167
199
  支持多套配置(不同应用 / 不同工作目录 / 不同权限)。
package/dist/cli.js CHANGED
@@ -4,7 +4,7 @@ import { Command } from "commander";
4
4
  // package.json
5
5
  var package_default = {
6
6
  name: "aai-lark-bridge",
7
- version: "0.1.9",
7
+ version: "0.2.1",
8
8
  description: "Lark AI Native Bridge - Lark\u57FA\u7840\u8BBE\u65BD\u5C42\u548CCLI\u96C6\u6210",
9
9
  type: "module",
10
10
  main: "./dist/index.js",
@@ -6069,6 +6069,14 @@ bridge \u4F1A\u7ED9\u4F60\u7684\u5B50\u8FDB\u7A0B\u6CE8\u5165\u5F53\u524D\u8FD0\
6069
6069
 
6070
6070
  \u914D\u7F6E\u6587\u4EF6\u53EF\u80FD\u662F\u591A profile \u7ED3\u6784,\u4E0D\u8981\u5047\u8BBE\u6839\u5C42\u4E00\u5B9A\u6709\u65E7\u7248\u5355 profile \u7684 \`accounts.app\`;\u786E\u5B9E\u9700\u8981\u8BFB\u53D6\u914D\u7F6E\u65F6\u6309\u5F53\u524D profile \u53D6\u503C,\u4E14\u4E0D\u8981\u8F93\u51FA\u5BC6\u94A5\u3002
6071
6071
 
6072
+ ## \u98DE\u4E66\u4EFB\u52A1\u7684\u76EE\u6807\u4E0E\u6267\u884C\u8BF4\u660E
6073
+
6074
+ - \u65B0\u5EFA\u98DE\u4E66\u4EFB\u52A1\u6216\u5B9E\u8D28\u6027\u6821\u51C6\u4EFB\u52A1\u65F6\uFF0C\u5148\u8BFB lark-task skill\u3002\u6807\u9898\u6982\u62EC\u4EA4\u4ED8\u7ED3\u679C\uFF0Cdescription \u5FC5\u987B\u5199\u5165\u53EF\u72EC\u7ACB\u9605\u8BFB\u7684\u6267\u884C\u8BF4\u660E\uFF0C\u4E0D\u80FD\u53EA\u91CD\u590D\u6807\u9898\u6216\u8D34\u4F1A\u8BAE\u94FE\u63A5\u3002
6075
+ - \u63CF\u8FF0\u5305\u542B\uFF1A\u4EFB\u52A1\u76EE\u6807\uFF08\u89E3\u51B3\u4EC0\u4E48\u95EE\u9898\u3001\u9884\u671F\u7ED3\u679C\uFF09\u3001\u4E1A\u52A1\u89C4\u5219\uFF08\u6761\u4EF6\u3001\u4F18\u5148\u7EA7\u3001\u7F3A\u5931/\u5F02\u5E38\u503C\u53CA\u8FB9\u754C\uFF09\u3001\u6539\u52A8\u903B\u8F91\u4E0E\u8303\u56F4\uFF08\u5F53\u524D\u884C\u4E3A\u2192\u76EE\u6807\u884C\u4E3A\u3001\u6D89\u53CA\u7684\u6D41\u7A0B/\u7CFB\u7EDF\u548C\u4E00\u81F4\u6027\u8981\u6C42\uFF09\u3001\u9A8C\u6536\u6807\u51C6\uFF08\u53EF\u9A8C\u8BC1\u7ED3\u679C\u548C\u5FC5\u8981\u793A\u4F8B\uFF09\u3001\u5F85\u786E\u8BA4\u4E8B\u9879\u3001\u6765\u6E90\u4F9D\u636E\uFF08\u7528\u6237\u786E\u8BA4\u3001\u6587\u6863/\u6D88\u606F/\u4F1A\u8BAE\u94FE\u63A5\u53CA\u53EF\u7528\u7684\u53D1\u8A00\u65F6\u95F4\u70B9\uFF09\u3002\u975E\u5F00\u53D1\u4EFB\u52A1\u628A\u6539\u52A8\u903B\u8F91\u5199\u6210\u6267\u884C\u6B65\u9AA4\u4E0E\u4EA4\u4ED8\u7269\uFF0C\u4E0D\u5F3A\u586B\u4EE3\u7801\u7EC6\u8282\u3002
6076
+ - \u7528\u6237\u672C\u8F6E\u660E\u786E\u7684\u6821\u51C6\u4F18\u5148\u4E8E\u65E7\u4EFB\u52A1\u6216\u81EA\u52A8\u6458\u8981\u3002\u4F1A\u8BAE\u4EFB\u52A1\u6838\u5BF9\u9010\u5B57\u7A3F\uFF1B\u65E0\u6CD5\u83B7\u53D6\u65F6\u5982\u5B9E\u6807\u660E\u4EC5\u4F9D\u636E\u6458\u8981\u3002\u533A\u5206\u5DF2\u786E\u8BA4\u51B3\u7B56\u3001\u5EFA\u8BAE\u548C\u5F85\u8BA8\u8BBA\u65B9\u6848\uFF0C\u4E0D\u5C06\u591A\u4E2A\u72EC\u7ACB\u9700\u6C42\u6DF7\u6210\u4E00\u6761\uFF0C\u4E0D\u4E3A\u8865\u9F50\u680F\u76EE\u7F16\u9020\u4E1A\u52A1\u89C4\u5219\u3001\u4ED3\u5E93/\u5B57\u6BB5\u540D\u3001\u8D1F\u8D23\u4EBA\u6216\u622A\u6B62\u65E5\u671F\u3002\u4FE1\u606F\u7F3A\u5931\u5199\u201C\u5F85\u786E\u8BA4\u201D\u53CA\u5176\u5F71\u54CD\uFF0C\u5DF2\u6709\u4FE1\u606F\u4ECD\u5B8C\u6574\u5199\u5165\u3002
6077
+ - \u201C\u6240\u6709\u540C\u7C7B\u903B\u8F91\u540C\u6B65\u201D\u8981\u5217\u660E\u53D7\u5F71\u54CD\u7684\u5C55\u793A\u3001\u8BA1\u7B97\u3001\u6C47\u603B\u3001\u5BFC\u51FA\u6216\u5176\u4ED6\u6D88\u8D39\u5165\u53E3\uFF1B\u4EC5\u5217\u6709\u4F9D\u636E\u7684\u8303\u56F4\u3002\u5199\u5165/\u540C\u6B65\u89C4\u5219\u4E0E\u8BFB\u53D6/\u6D88\u8D39\u89C4\u5219\u5206\u522B\u8BF4\u660E\uFF0C\u907F\u514D\u628A\u201C\u4E0D\u66F4\u65B0\u5B57\u6BB5\u201D\u8BEF\u89E3\u6210\u201C\u7EE7\u7EED\u7528\u65E7\u503C\u201D\u6216\u201C\u7F3A\u5931\u8865\u96F6\u201D\u3002
6078
+ - \u6309\u7528\u6237\u5DF2\u6388\u6743\u7684\u8303\u56F4\u6267\u884C\uFF1B\u53EA\u6539\u622A\u6B62\u65E5\u671F\u3001\u8D1F\u8D23\u4EBA\u6216\u72B6\u6001\u65F6\uFF0C\u4E0D\u987A\u5E26\u91CD\u5199\u5DF2\u6709\u63CF\u8FF0\u3002\u66F4\u65B0\u524D\u8BFB\u53D6\u539F\u4EFB\u52A1\u5E76\u4FDD\u7559\u6709\u6548\u4E0A\u4E0B\u6587\uFF1B\u521B\u5EFA/\u66F4\u65B0\u540E\u8BFB\u56DE\u6807\u9898\u4E0E\u63CF\u8FF0\u6838\u9A8C\uFF0C\u8FD4\u56DE\u98DE\u4E66\u4EFB\u52A1\u94FE\u63A5\u3002
6079
+
6072
6080
  ## \u6545\u969C\u8BCA\u65AD\u4E0E\u5B8C\u6210\u72B6\u6001
6073
6081
 
6074
6082
  - \u7528\u6237\u4ECE\u98DE\u4E66\u9605\u8BFB\u7B54\u590D\uFF0C\u65E0\u6CD5\u6253\u5F00\u672C\u673A\u7EDD\u5BF9\u8DEF\u5F84\u3001file:// \u6216\u672C\u673A\u7F16\u8F91\u5668\u94FE\u63A5\u3002\u4EE3\u7801\u4EA4\u4ED8\u63D0\u4F9B\u5DF2\u521B\u5EFA\u5E76\u6838\u5B9E\u7684 MR URL\uFF1B\u9700\u8981\u4EA4\u4ED8\u6587\u4EF6\u65F6\u6309\u4EFB\u52A1\u6388\u6743\u4E0A\u4F20\u5230\u98DE\u4E66\u5E76\u6838\u9A8C\u8FD4\u56DE\u94FE\u63A5\u6216\u9644\u4EF6\u3002\u53EA\u5199\u5165\u672C\u673A\u65F6\u660E\u786E\u201C\u4EC5\u4FDD\u5B58\u5728\u672C\u673A\uFF0C\u5C1A\u672A\u4E0A\u4F20\u201D\uFF0C\u53EF\u7528\u7EAF\u6587\u672C\u8DEF\u5F84\u4F9B\u5B9A\u4F4D\uFF0C\u4F46\u4E0D\u80FD\u5305\u88C5\u6210\u5DF2\u4EA4\u4ED8\u7684\u53EF\u70B9\u51FB\u94FE\u63A5\u3002\u51C6\u5907\u597D MR \u63CF\u8FF0\u4E0D\u7B49\u4E8E\u5DF2\u63D0\u4EA4 MR\u3002
@@ -6987,7 +6995,7 @@ function isWindowsCommandNotFoundLine2(line) {
6987
6995
 
6988
6996
  // src/bridge/bot/channel.ts
6989
6997
  import { createLarkChannel } from "@larksuite/channel";
6990
- import { dirname as dirname18, join as join23 } from "path";
6998
+ import { dirname as dirname18, join as join24 } from "path";
6991
6999
 
6992
7000
  // src/bridge/agent/capability.ts
6993
7001
  function claudeCapability(profile2) {
@@ -13388,6 +13396,46 @@ function preview(text) {
13388
13396
  return text.length > 80 ? `${text.slice(0, 80)}\u2026` : text;
13389
13397
  }
13390
13398
 
13399
+ // src/bridge/bot/doc-confirmation.ts
13400
+ import { createHash as createHash6 } from "crypto";
13401
+ import { mkdirSync as mkdirSync4, realpathSync, renameSync as renameSync3, writeFileSync as writeFileSync4 } from "fs";
13402
+ import { isAbsolute as isAbsolute4, join as join23, sep as sep2 } from "path";
13403
+ import { spawn } from "child_process";
13404
+ var waking = /* @__PURE__ */ new Set();
13405
+ function enqueueDocConfirmation(workspace, event, { selfReply = false } = {}) {
13406
+ if (!workspace || selfReply) return false;
13407
+ if (!isAbsolute4(workspace)) throw new Error("SDLC \u5DE5\u4F5C\u533A\u5FC5\u987B\u662F\u7EDD\u5BF9\u8DEF\u5F84");
13408
+ if (event.fileType !== "docx") return false;
13409
+ if (![event.fileToken, event.commentId, event.replyId ?? "none"].every((x) => /^[\w:-]{1,128}$/.test(x))) return false;
13410
+ const root = realpathSync(workspace);
13411
+ const script = realpathSync(join23(root, ".sdlc-intake/intake.mjs"));
13412
+ if (!script.startsWith(root + sep2)) throw new Error("SDLC \u6838\u9A8C\u5165\u53E3\u8D85\u51FA\u5DE5\u4F5C\u533A");
13413
+ const inbox = join23(root, ".sdlc-intake/state/confirmation-inbox");
13414
+ mkdirSync4(inbox, { recursive: true });
13415
+ if (!realpathSync(inbox).startsWith(root + sep2)) throw new Error("SDLC \u6536\u4EF6\u76EE\u5F55\u8D85\u51FA\u5DE5\u4F5C\u533A");
13416
+ const { fileToken: fileId, commentId: comment_id } = event;
13417
+ const hint = { file_token: fileId, comment_id, reply_id: event.replyId ?? null, received_at: (/* @__PURE__ */ new Date()).toISOString() };
13418
+ const key = createHash6("sha256").update(JSON.stringify([hint.file_token, hint.comment_id, hint.reply_id])).digest("hex");
13419
+ const target = join23(inbox, key + ".json");
13420
+ const tmp = target + `.new-${process.pid}`;
13421
+ writeFileSync4(tmp, JSON.stringify(hint), { mode: 384 });
13422
+ renameSync3(tmp, target);
13423
+ if (!waking.has(root)) {
13424
+ waking.add(root);
13425
+ try {
13426
+ const env = Object.fromEntries(Object.entries(process.env).filter(([key2]) => !key2.startsWith("LARK_CHANNEL") && !key2.startsWith("LARKSUITE_CLI_")));
13427
+ const child = spawn(process.execPath, [script, "reconcile-confirmations"], { cwd: root, env, stdio: "ignore", timeout: 7e4 });
13428
+ child.once("error", () => waking.delete(root));
13429
+ child.once("exit", () => waking.delete(root));
13430
+ child.unref();
13431
+ } catch (err) {
13432
+ waking.delete(root);
13433
+ throw err;
13434
+ }
13435
+ }
13436
+ return true;
13437
+ }
13438
+
13391
13439
  // src/bridge/bot/inbound-mark.ts
13392
13440
  import { readFile as readFile14 } from "fs/promises";
13393
13441
  function inboundGapFields(prev, now) {
@@ -14304,7 +14352,7 @@ async function startChannel(deps) {
14304
14352
  const pool = new ProcessPool(() => getMaxConcurrentRuns(controls.cfg));
14305
14353
  const executor = new RunExecutor({ agent, pool, activeRuns });
14306
14354
  const appSecret = await resolveAppSecret(cfg, deps.appPaths);
14307
- const callbackNonceStore = deps.appPaths?.mediaDir ? new CallbackNonceStore(join23(dirname18(deps.appPaths.mediaDir), "callback-nonces.json")) : void 0;
14355
+ const callbackNonceStore = deps.appPaths?.mediaDir ? new CallbackNonceStore(join24(dirname18(deps.appPaths.mediaDir), "callback-nonces.json")) : void 0;
14308
14356
  await callbackNonceStore?.load();
14309
14357
  const callbackAuth = callbackNonceStore ? new CallbackAuth({
14310
14358
  keys: [{ version: 1, secret: appSecret }],
@@ -14472,6 +14520,11 @@ async function startChannel(deps) {
14472
14520
  },
14473
14521
  comment: async (evt) => {
14474
14522
  markInbound("comment");
14523
+ try {
14524
+ enqueueDocConfirmation(controls.profileConfig.preferences.sdlcConfirmationWorkspace, evt, { selfReply: isBridgeSelfReply(channel, evt) });
14525
+ } catch (err) {
14526
+ log.fail("doc-confirmation", err);
14527
+ }
14475
14528
  await withTrace({ chatId: "comment" }, async () => {
14476
14529
  await handleCommentMention({
14477
14530
  channel,
@@ -15977,7 +16030,7 @@ function cliError(r, prefix) {
15977
16030
  }
15978
16031
 
15979
16032
  // src/bridge/meeting/preflight.ts
15980
- var MEETING_BETA_CHAT_URL = "https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd";
16033
+ var MEETING_BETA_CHAT_URL = "https://go.larkoffice.com/join-chat/aa2r8184-557e-4ab6-963f-bad28f7725d9";
15981
16034
  var MEETING_REQUIRED_SCOPES = [
15982
16035
  { scope: "vc:meeting.bot.join:write", purpose: "\u8BA9 bot \u5165\u4F1A / \u79BB\u4F1A" },
15983
16036
  { scope: "vc:meeting.message:write", purpose: "\u5728\u4F1A\u4E2D\u53D1\u6D88\u606F\uFF08\u56DE\u7B54\u4F1A\u53D1\u4E0D\u51FA\u53BB\uFF09" },