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 +32 -0
- package/dist/cli.js +57 -4
- package/dist/cli.js.map +1 -1
- package/dist/index.js +8 -0
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
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
|
|
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
|
|
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(
|
|
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/
|
|
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" },
|