@vibe-lark/larkpal 0.1.83 → 0.1.85

package/README.md

@@ -1,7 +1,59 @@
+# LarkPal
+
+LarkPal connects Lark/Feishu conversations to agent runtimes. The first setup path is now organized around Feishu's Agent integration layers:
+
+1. **凭据层**：用飞书官方扫码创建应用能力获取 App ID 和 App Secret。
+2. **交互层**：LarkPal 的 Feishu channel 接收消息、评论、卡片交互并流式回复。
+3. **执行层**：飞书 CLI 作为 Agent 操作文档、日历、表格、邮件、任务等业务对象的工具来源。
+
+> Agent 协作入口：先读 [AGENTS.md](./AGENTS.md)，再按 [agent-workspace/INDEX.md](./agent-workspace/INDEX.md) 选择相关领域文档。
+
+## 快速开始
+
+### 1. 安装依赖
+
+```bash
+pnpm install
+pnpm -s build
+```
+
+运行服务时仍需要一个 agent runtime：
+
+```bash
+npm install -g @anthropic-ai/claude-code
+```
+
+如果使用 Codex app-server runtime，请安装并配置 Codex CLI，并设置 `LARKPAL_RUNTIME=codex-app-server`。
+
+### 2. 连接飞书
+
+```bash
+pnpm start -- init
+```
+
+初始化向导默认使用飞书官方一键创建应用能力。用户打开或扫码向导中的链接后，LarkPal 会收到并保存 App ID 和 App Secret；不需要去飞书开发者后台手动复制 App Secret。
+
+也可以选择手动输入 App ID/App Secret，或使用旧的 `lark-cli config init` 兼容流程。
+
+### 3. 按需授权执行层
+
+基础飞书 bot 会话只需要应用凭据。只有当 Agent 需要以用户身份访问个人日历、私信、云文档、邮箱等数据时，才需要飞书 CLI 用户授权：
+
+```bash
+npx @larksuite/cli@latest install
+lark-cli auth login
+```
+
+这一步属于执行层，不是应用凭据配置的一部分。
+
+---
+
 # LarkPal 外部接入规范
 
 本文档描述外部业务方接入 LarkPal 平台时需遵循的协议和配置规范。
 
+> Agent 协作入口：先读 [AGENTS.md](./AGENTS.md)，再按 [agent-workspace/INDEX.md](./agent-workspace/INDEX.md) 选择相关领域文档。
+
 ---
 
 ## 目录
@@ -225,6 +277,12 @@ interface RuntimeAdapter {
   // 查询会话进程信息
   getProcessInfo(sessionId: string): RuntimeProcessInfo | undefined;
   getAllProcessInfo(): RuntimeProcessInfo[];
+
+  // 可选能力契约：上层通过能力判断是否展示交互入口
+  getCapabilities?(): RuntimeCapabilities;
+  getLastUserMessageId?(sessionId: string): string | undefined;
+  previewRewind?(params: RuntimeRewindParams): Promise<RuntimeRewindPreview>;
+  confirmRewind?(params: RuntimeRewindParams): Promise<RuntimeRewindResult>;
 }
 ```
 
@@ -263,9 +321,18 @@ interface RuntimeStreamCallbacks {
 
 ```bash
 LARKPAL_RUNTIME=claude-code      # 默认，使用 Claude Code 子进程
+LARKPAL_RUNTIME=codex-app-server # 使用 OpenAI Codex app-server
 LARKPAL_RUNTIME=larkpal-agent    # 使用 larkpal-agent 引擎（火山方舟 LLM）
 ```
 
+Runtime 能力矩阵：
+
+| Runtime | 流式回复 | 多模态输入 | 停止当前任务 | 交互卡片续跑 | 文件撤销 |
+|---------|----------|------------|--------------|--------------|----------|
+| `claude-code` | 支持 | 支持 | 支持 | 支持 | 支持 |
+| `codex-app-server` | 支持 | 支持 | 支持 | 支持 | 支持 |
+| `larkpal-agent` | 支持 | 由 agent/provider 决定 | 支持 | 支持 | 暂不支持 |
+
 使用 `larkpal-agent` 时的完整配置示例：
 
 ```bash
@@ -278,7 +345,7 @@ LARKPAL_AGENT_MAX_TURNS=25
 
 **工具发现**：由 larkpal-agent 自身的 MCP Client 负责。larkpal-agent 启动时自动连接配置的 MCP Server，发现并注册外部工具。larkpal 平台层不涉及工具层。
 
-**systemPrompt 来源**：读取 `~/.claude/CLAUDE.md` 文件内容。可通过修改此文件自定义 Agent 人设。
+**人设 / system instructions 来源**：LarkPal 以飞书应用信息和人设文档为唯一来源，同步到 runtime 各自能读取的指令文件。Claude Code 读取 `~/.claude/CLAUDE.md` 和会话目录 `CLAUDE.md`；Codex 读取 workspace / 会话目录中的 `AGENTS.md`，内容由 LarkPal 从同一份人设自动镜像生成。
 
 ---
 

package/dist/cli.mjs

@@ -34,12 +34,22 @@ ${BOLD}LarkPal${RESET} ${DIM}v${version}${RESET} — 飞书 AI Bot 服务
 ${BOLD}用法:${RESET}
   larkpal              启动服务
   larkpal init         交互式初始化向导
+  larkpal meeting-live-smoke --meeting-number <number>
+                       实验：固定文本进入飞书会议语音链路
+                       可加 --listen-ms <ms> --raw-output <path> --summary-output <path>
+  larkpal meeting-live-teammate --meeting-number <number> --owner-user-id <id>
+                       实验：实时听会转写后用 teammate 策略语音参与
+                       可加 --summary-output <path> 留存脱敏运行摘要
+  larkpal meeting-live-check
+                       实验：检查会议语音链路 TTS/ASR 配置，不入会
+                       可加 --summary-output <path> 留存脱敏检查结果
   larkpal --help       显示帮助信息
   larkpal --version    显示版本号
 
 ${BOLD}环境变量:${RESET}
   LARK_APP_ID          飞书应用 App ID（可选，覆盖 lark-cli 配置）
   LARK_APP_SECRET      飞书应用 App Secret（可选，覆盖 lark-cli 配置）
+  LARK_USER_ACCESS_TOKEN 飞书用户访问令牌（会议实验能力需要）
   LARKPAL_WORKSPACE    工作目录根路径（默认 ~/.larkpal/workspace）
   CLAUDE_MODEL         Claude 模型名称（如 ark-code-latest）
 
@@ -47,7 +57,8 @@ ${DIM}首次使用？运行 ${CYAN}larkpal init${DIM} 开始配置。${RESET}
 `);
 }
 async function cli() {
-	const command = process.argv.slice(2)[0];
+	const args = process.argv.slice(2);
+	const command = args[0];
 	if (command === "--version" || command === "-v") {
 		console.log(getVersion());
 		return;
@@ -57,21 +68,36 @@ async function cli() {
 		return;
 	}
 	if (command === "init") {
-		const { runInteractiveInit } = await import("./interactive-init-BYF2-otj.mjs");
+		const { runInteractiveInit } = await import("./interactive-init-B6j8j_Ap.mjs");
 		const exitCode = await runInteractiveInit();
 		process.exit(exitCode);
 	}
+	if (command === "meeting-live-smoke") {
+		const { runMeetingLiveSmokeCli } = await import("./live-smoke-nvTUPtrv.mjs").then((n) => n.t);
+		await runMeetingLiveSmokeCli(args.slice(1));
+		return;
+	}
+	if (command === "meeting-live-teammate") {
+		const { runMeetingLiveTeammateCli } = await import("./live-smoke-nvTUPtrv.mjs").then((n) => n.t);
+		await runMeetingLiveTeammateCli(args.slice(1));
+		return;
+	}
+	if (command === "meeting-live-check") {
+		const { runMeetingLiveCheckCli } = await import("./live-smoke-nvTUPtrv.mjs").then((n) => n.t);
+		const exitCode = await runMeetingLiveCheckCli(args.slice(1));
+		process.exit(exitCode);
+	}
 	if (command && !command.startsWith("-")) {
 		console.log(`${YELLOW}未知命令: ${command}${RESET}\n`);
 		printHelp();
 		process.exit(1);
 	}
 	if (!(process.env.LARKPAL_HEADLESS === "1" || process.env.LARKPAL_HEADLESS === "true")) {
-		const { LarkCliCredentialProvider } = await import("./lark-cli-provider-CdgwmqSz.mjs").then((n) => n.n);
+		const { LarkCliCredentialProvider } = await import("./lark-cli-provider-7LvtOIF_.mjs").then((n) => n.n);
 		if (!LarkCliCredentialProvider.isConfigured()) {
 			console.log(`\n${YELLOW}⚠️  飞书应用凭证未配置${RESET}\n`);
 			console.log(`  LarkPal 需要飞书应用凭证才能启动。正在进入初始化向导...\n`);
-			const { runInteractiveInit } = await import("./interactive-init-BYF2-otj.mjs");
+			const { runInteractiveInit } = await import("./interactive-init-B6j8j_Ap.mjs");
 			const exitCode = await runInteractiveInit();
 			if (exitCode !== 0) process.exit(exitCode);
 			console.log(`${DIM}凭证配置完成，正在启动服务...${RESET}\n`);

package/dist/{interactive-init-BYF2-otj.mjs → interactive-init-B6j8j_Ap.mjs}

@@ -4,6 +4,124 @@ import { join } from "node:path";
 import { homedir } from "node:os";
 import { execSync, spawn } from "node:child_process";
 import { createInterface } from "node:readline";
+import * as Lark from "@larksuiteoapi/node-sdk";
+import qrcodeTerminal from "qrcode-terminal";
+//#region src/credentials/app-registration.ts
+async function registerFeishuAppCredentials(options) {
+	const result = await (options.registerApp ?? defaultRegisterApp)({
+		source: options.source ?? "larkpal",
+		signal: options.signal,
+		onQRCodeReady: options.onQRCodeReady,
+		onStatusChange: options.onStatusChange
+	});
+	if (!result.client_id || !result.client_secret) throw new Error("飞书应用创建完成但未返回 App ID 或 App Secret");
+	await options.saveCredentials({
+		appId: result.client_id,
+		appSecret: result.client_secret
+	});
+	return {
+		appId: result.client_id,
+		appSecret: result.client_secret,
+		creatorOpenId: result.user_info?.open_id,
+		tenantBrand: result.user_info?.tenant_brand
+	};
+}
+async function defaultRegisterApp(options) {
+	return Lark.registerApp(options);
+}
+//#endregion
+//#region src/init/landing-presentation.ts
+function renderFeishuAppCreationQRCode(input) {
+	return [
+		"  请扫码创建飞书智能体应用，或打开下面的链接：",
+		"",
+		renderQRCodeOrFallback(input.url, input.createQRCode ?? createQRCode),
+		`  ${input.url}`,
+		`  链接有效期 ${input.expireIn} 秒。`
+	].join("\n");
+}
+function formatRuntimeSelectionSummary(runtimeName) {
+	switch (runtimeName) {
+		case "codex-app-server": return [
+			"已选择 Codex app-server 作为 agent runtime。",
+			"启动前请确保 Codex CLI 可用：codex",
+			"启动配置：LARKPAL_RUNTIME=codex-app-server"
+		].join("\n");
+		case "larkpal-agent": return [
+			"已选择 larkpal-agent 作为 agent runtime。",
+			"启动前请配置 larkpal-agent 所需的 LLM 和 scenario provider 环境变量。",
+			"启动配置：LARKPAL_RUNTIME=larkpal-agent"
+		].join("\n");
+		case "claude-code": return [
+			"已选择 Claude Code 作为 agent runtime。",
+			"启动前请确保 Claude Code CLI 可用：claude",
+			"启动配置：LARKPAL_RUNTIME=claude-code"
+		].join("\n");
+	}
+}
+function renderRuntimeSelectionPrompt(currentRuntime) {
+	return [
+		"Agent runtime 选择",
+		"",
+		`  [1] Claude Code (claude-code)${currentRuntime === "claude-code" ? "（当前）" : ""}`,
+		`  [2] Codex app-server (codex-app-server)${currentRuntime === "codex-app-server" ? "（当前）" : ""}`,
+		`  [3] larkpal-agent${currentRuntime === "larkpal-agent" ? "（当前）" : ""}`
+	].join("\n");
+}
+function resolveRuntimeSelection(choice, currentRuntime) {
+	const normalized = choice.trim().toLowerCase();
+	if (!normalized) return currentRuntime;
+	if (normalized === "1" || normalized === "claude" || normalized === "claude-code") return "claude-code";
+	if (normalized === "2" || normalized === "codex" || normalized === "codex-app-server") return "codex-app-server";
+	if (normalized === "3" || normalized === "larkpal-agent") return "larkpal-agent";
+	return currentRuntime;
+}
+function createQRCode(url) {
+	let qrCode = "";
+	qrcodeTerminal.setErrorLevel("L");
+	qrcodeTerminal.generate(url, { small: true }, (code) => {
+		qrCode = code;
+	});
+	return qrCode.trimEnd();
+}
+function renderQRCodeOrFallback(url, renderer) {
+	try {
+		return renderer(url).trimEnd() || "  [二维码渲染失败，请使用下方链接]";
+	} catch {
+		return "  [二维码渲染失败，请使用下方链接]";
+	}
+}
+//#endregion
+//#region src/init/prerequisites.ts
+function assessInitPrerequisites(deps) {
+	const larkCli = deps.detectCli("lark-cli");
+	const runtimeCliName = resolveRuntimeCliName(deps.runtimeName);
+	const runtimeCli = runtimeCliName ? deps.detectCli(runtimeCliName) : { installed: true };
+	const warnings = [];
+	if (runtimeCliName && !runtimeCli.installed) warnings.push(runtimeCliName === "codex" ? "OpenAI Codex CLI is not installed. Feishu app credentials can still be configured now, but service startup with LARKPAL_RUNTIME=codex-app-server will require codex later." : "Claude Code is not installed. Feishu app credentials can still be configured now, but service startup with the default runtime will require Claude Code later.");
+	if (!larkCli.installed) warnings.push("lark-cli is not installed. Basic Feishu bot chat can be configured with app credentials, but execution-layer tools for documents, calendars, mail, tasks, and personal data will require lark-cli later.");
+	return {
+		canConfigureFeishuCredentials: true,
+		larkCli: {
+			...larkCli,
+			ready: larkCli.installed,
+			requiredForBasicChat: false
+		},
+		runtime: {
+			...runtimeCli,
+			ready: runtimeCli.installed,
+			name: deps.runtimeName,
+			cliName: runtimeCliName ?? deps.runtimeName
+		},
+		warnings
+	};
+}
+function resolveRuntimeCliName(runtimeName) {
+	if (runtimeName === "codex-app-server") return "codex";
+	if (runtimeName === "larkpal-agent") return void 0;
+	return "claude";
+}
+//#endregion
 //#region src/init/interactive-init.ts
 /**
 * 交互式初始化流程
@@ -88,6 +206,9 @@ function writeCredentials(appId, appSecret) {
 		return false;
 	}
 }
+async function saveCredentialsOrThrow(credentials) {
+	if (!writeCredentials(credentials.appId, credentials.appSecret)) throw new Error("凭证保存失败");
+}
 /** 检查 LarkPal 凭证文件是否已有有效凭证 */
 function hasLarkPalCredentials() {
 	if (!existsSync(LARKPAL_CREDENTIALS_PATH)) return null;
@@ -101,30 +222,29 @@ function hasLarkPalCredentials() {
 	} catch {}
 	return null;
 }
-function checkPrerequisites() {
+function checkPrerequisites(runtimeName) {
 	console.log(`\n${BOLD}🔍 检查前置依赖${RESET}\n`);
-	if (isCliInstalled("claude")) console.log(`  ${GREEN}✅ claude 已安装${RESET}`);
-	else {
-		console.log(`  ${RED}❌ claude 未安装${RESET}`);
-		console.log(`\n  Claude Code 是 LarkPal 的 AI 推理引擎，必须安装。`);
-		console.log(`  ${DIM}安装命令:${RESET} npm install -g @anthropic-ai/claude-code`);
-		console.log(`  ${DIM}文档:${RESET} https://docs.anthropic.com/en/docs/claude-code\n`);
-		log.error("前置依赖检查失败: claude 未安装");
-		return false;
-	}
-	if (isCliInstalled("lark-cli")) console.log(`  ${GREEN}✅ lark-cli 已安装${RESET}`);
-	else {
-		console.log(`  ${RED}❌ lark-cli 未安装${RESET}`);
-		console.log(`\n  lark-cli 提供飞书原生能力和凭证管理，必须安装。`);
-		console.log(`  ${DIM}安装命令:${RESET}`);
-		console.log(`    npm install -g @larksuite/cli`);
-		console.log(`    npx skills add larksuite/cli -y -g`);
-		console.log(`  ${DIM}文档:${RESET} https://github.com/larksuite/cli\n`);
-		log.error("前置依赖检查失败: lark-cli 未安装");
-		return false;
-	}
+	const assessment = assessInitPrerequisites({
+		runtimeName,
+		detectCli: (name) => ({ installed: isCliInstalled(name) })
+	});
+	if (assessment.runtime.ready) console.log(`  ${GREEN}✅ ${assessment.runtime.cliName} 已安装${RESET}`);
+	else console.log(`  ${YELLOW}⚠️  ${assessment.runtime.cliName} 未安装${RESET}`);
+	if (assessment.larkCli.ready) console.log(`  ${GREEN}✅ lark-cli 已安装${RESET}`);
+	else console.log(`  ${YELLOW}⚠️  lark-cli 未安装（基础飞书连接不阻塞）${RESET}`);
+	for (const warning of assessment.warnings) console.log(`  ${DIM}${warning}${RESET}`);
 	console.log();
-	return true;
+}
+async function configureRuntime(rl) {
+	const currentRuntime = resolveConfiguredRuntime(process.env.LARKPAL_RUNTIME);
+	console.log(`\n${BOLD}🤖 Agent runtime 配置${RESET}\n`);
+	console.log(renderRuntimeSelectionPrompt(currentRuntime));
+	console.log();
+	const selectedRuntime = resolveRuntimeSelection(await ask(rl, `  请选择 [1/2/3]（默认当前）: `), currentRuntime);
+	process.env.LARKPAL_RUNTIME = selectedRuntime;
+	console.log(`\n${formatRuntimeSelectionSummary(selectedRuntime)}\n`);
+	log.info("用户选择 agent runtime", { runtimeName: selectedRuntime });
+	return selectedRuntime;
 }
 /**
 * 通过 lark-cli config init 子进程配置凭证。
@@ -219,6 +339,34 @@ async function manualCredentialInput(rl) {
 	console.log(`\n${RED}凭证保存失败${RESET}`);
 	return false;
 }
+async function scanCreateAppCredentials() {
+	console.log(`\n${BOLD}📱 扫码创建飞书智能体应用${RESET}\n`);
+	console.log(`  LarkPal 会通过飞书官方一键创建应用能力获取 App ID 和 App Secret。`);
+	console.log(`  ${DIM}这一步只配置应用凭据；个人日历、文档、邮件等能力后续通过 lark-cli auth login 授权。${RESET}\n`);
+	try {
+		const result = await registerFeishuAppCredentials({
+			saveCredentials: saveCredentialsOrThrow,
+			onQRCodeReady: ({ url, expireIn }) => {
+				console.log(renderFeishuAppCreationQRCode({
+					url,
+					expireIn
+				}));
+				console.log();
+			},
+			onStatusChange: ({ status }) => {
+				if (status === "polling") console.log(`  ${DIM}等待飞书确认中...${RESET}`);
+				else if (status === "slow_down") console.log(`  ${DIM}飞书要求降低轮询频率，继续等待...${RESET}`);
+				else if (status === "domain_switched") console.log(`  ${DIM}已根据租户切换认证域名，继续等待...${RESET}`);
+			},
+			source: "larkpal-init"
+		});
+		console.log(`\n${GREEN}✅ 飞书应用创建并保存成功${RESET} ${DIM}(App ID: ${result.appId})${RESET}`);
+		return true;
+	} catch (err) {
+		console.log(`\n${RED}扫码创建飞书应用失败: ${err instanceof Error ? err.message : String(err)}${RESET}`);
+		return false;
+	}
+}
 async function configureCredentials(rl) {
 	if (process.env.LARK_APP_ID && process.env.LARK_APP_SECRET) {
 		console.log(`${GREEN}✅ 飞书应用凭证已通过环境变量配置${RESET}`);
@@ -238,14 +386,20 @@ async function configureCredentials(rl) {
 		return promptAppSecret(rl, existingAppId);
 	}
 	console.log(`${BOLD}📋 飞书应用配置${RESET}\n`);
-	console.log(`  LarkPal 需要飞书应用凭证才能运行。推荐通过 lark-cli 一键配置：\n`);
-	console.log(`    ${CYAN}👉 运行: lark-cli config init${RESET}\n`);
-	console.log(`  这会打开浏览器，引导你在飞书开放平台完成应用配置。\n`);
-	console.log(`  ${DIM}[1] 运行 lark-cli config init（推荐）${RESET}`);
-	console.log(`  ${DIM}[2] 手动输入 App ID 和 App Secret${RESET}\n`);
-	const option = await ask(rl, `  请选择 [1/2]（默认 1）: `) === "2" ? 2 : 1;
+	console.log(`  LarkPal 需要飞书应用凭据才能进入飞书会话。推荐使用飞书官方扫码创建应用能力：\n`);
+	console.log(`  ${DIM}[1] 扫码创建飞书智能体应用（推荐）${RESET}`);
+	console.log(`  ${DIM}[2] 手动输入 App ID 和 App Secret${RESET}`);
+	console.log(`  ${DIM}[3] 使用 lark-cli config init（兼容旧流程）${RESET}\n`);
+	const choice = await ask(rl, `  请选择 [1/2/3]（默认 1）: `);
+	const option = choice === "2" ? 2 : choice === "3" ? 3 : 1;
 	log.info("用户选择凭证配置方式", { option });
 	if (option === 1) {
+		if (await scanCreateAppCredentials()) return true;
+		console.log(`\n  ${YELLOW}扫码创建未完成，是否手动输入凭证？${RESET}`);
+		if ((await ask(rl, `  手动输入？ [y/N]: `)).toLowerCase() === "y") return manualCredentialInput(rl);
+		return false;
+	}
+	if (option === 3) {
 		const appId = await runLarkCliConfigInit();
 		if (appId) return promptAppSecret(rl, appId);
 		console.log(`\n  ${YELLOW}lark-cli 配置未成功，是否手动输入凭证？${RESET}`);
@@ -264,16 +418,15 @@ async function runInteractiveInit() {
 	console.log(`${BOLD}${CYAN}║         LarkPal 初始化向导           ║${RESET}`);
 	console.log(`${BOLD}${CYAN}╚══════════════════════════════════════╝${RESET}\n`);
 	log.info("开始交互式初始化流程");
-	if (!checkPrerequisites()) {
-		console.log(`${RED}请安装缺失的依赖后重新运行 ${CYAN}larkpal init${RESET}\n`);
-		return 1;
-	}
 	const rl = createInterface({
 		input: process.stdin,
 		output: process.stdout
 	});
-	let credentialsOk = false;
+	let credentialsOk;
+	let selectedRuntime;
 	try {
+		selectedRuntime = await configureRuntime(rl);
+		checkPrerequisites(selectedRuntime);
 		credentialsOk = await configureCredentials(rl);
 	} finally {
 		rl.close();
@@ -284,9 +437,14 @@ async function runInteractiveInit() {
 	}
 	console.log(`\n${BOLD}${GREEN}🎉 初始化完成！${RESET}\n`);
 	console.log(`  ${DIM}下一步:${RESET}`);
+	console.log(`    ${formatRuntimeSelectionSummary(selectedRuntime)}`);
 	console.log(`    运行 ${CYAN}larkpal${RESET} 启动服务\n`);
 	log.info("交互式初始化流程完成");
 	return 0;
 }
+function resolveConfiguredRuntime(value) {
+	if (value === "codex-app-server" || value === "larkpal-agent" || value === "claude-code") return value;
+	return "claude-code";
+}
 //#endregion
 export { runInteractiveInit };

package/dist/{lark-cli-provider-CdgwmqSz.mjs → lark-cli-provider-7LvtOIF_.mjs}

@@ -1,21 +1,10 @@
+import { t as __exportAll } from "./rolldown-runtime-wcPFST8Q.mjs";
 import { t as larkLogger } from "./lark-logger-D7_pEVQc.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { homedir } from "node:os";
 import { execSync } from "node:child_process";
 import { createHash } from "node:crypto";
-//#region \0rolldown/runtime.js
-var __defProp = Object.defineProperty;
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
-};
-//#endregion
 //#region src/credentials/lark-cli-provider.ts
 /**
 * 飞书应用凭证提供者
@@ -121,18 +110,21 @@ var LarkCliCredentialProvider = class LarkCliCredentialProvider {
 		else log.warn("未找到 lark-cli（应由 preflight 检查保证安装）");
 		const envAppId = process.env.LARK_APP_ID;
 		const envAppSecret = process.env.LARK_APP_SECRET;
+		const envUserAccessToken = process.env.LARK_USER_ACCESS_TOKEN;
 		let cliConfig = {};
-		const larkpalCreds = this.loadFromLarkPalCredentials();
-		if (larkpalCreds?.appId && larkpalCreds?.appSecret) cliConfig = larkpalCreds;
-		else if (this.larkCliPath) try {
-			cliConfig = this.loadFromCli();
-		} catch (err) {
-			log.warn("从 lark-cli 读取配置失败，将使用环境变量", { error: err instanceof Error ? err.message : String(err) });
+		if (!envAppId || !envAppSecret) {
+			const larkpalCreds = this.loadFromLarkPalCredentials();
+			if (larkpalCreds?.appId && larkpalCreds?.appSecret) cliConfig = larkpalCreds;
+			else if (this.larkCliPath) try {
+				cliConfig = this.loadFromCli();
+			} catch (err) {
+				log.warn("从 lark-cli 读取配置失败，将使用环境变量", { error: err instanceof Error ? err.message : String(err) });
+			}
 		}
 		this.appId = envAppId ?? cliConfig.appId ?? "";
 		this.appSecret = envAppSecret ?? cliConfig.appSecret ?? "";
 		this.tenantAccessToken = cliConfig.tenant_access_token ?? "";
-		this.userAccessToken = cliConfig.user_access_token ?? "";
+		this.userAccessToken = envUserAccessToken ?? cliConfig.user_access_token ?? "";
 		if (!this.appId) {
 			const msg = [
 				"无法获取飞书应用凭证 (app_id)",