@vibe-lark/larkpal 0.1.28 → 0.1.29

package/dist/cli.mjs

@@ -0,0 +1,87 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+//#region src/cli.ts
+/**
+* LarkPal CLI 入口 — 子命令路由
+*
+* 用法:
+*   larkpal            启动服务（凭证未配置时自动进入初始化流程）
+*   larkpal init       交互式初始化向导
+*   larkpal --help     显示帮助信息
+*   larkpal --version  显示版本号
+*
+* 不依赖 commander / yargs 等外部包，仅使用 process.argv 解析。
+*/
+const CYAN = "\x1B[36m";
+const DIM = "\x1B[2m";
+const BOLD = "\x1B[1m";
+const YELLOW = "\x1B[33m";
+const RESET = "\x1B[0m";
+function getVersion() {
+	try {
+		const pkgPath = join(dirname(fileURLToPath(import.meta.url)), "..", "package.json");
+		return JSON.parse(readFileSync(pkgPath, "utf-8")).version ?? "unknown";
+	} catch {
+		return "unknown";
+	}
+}
+function printHelp() {
+	const version = getVersion();
+	console.log(`
+${BOLD}LarkPal${RESET} ${DIM}v${version}${RESET} — 飞书 AI Bot 服务
+
+${BOLD}用法:${RESET}
+  larkpal              启动服务
+  larkpal init         交互式初始化向导
+  larkpal --help       显示帮助信息
+  larkpal --version    显示版本号
+
+${BOLD}环境变量:${RESET}
+  LARK_APP_ID          飞书应用 App ID（可选，覆盖 lark-cli 配置）
+  LARK_APP_SECRET      飞书应用 App Secret（可选，覆盖 lark-cli 配置）
+  LARKPAL_WORKSPACE    工作目录根路径（默认 /workspace）
+  CLAUDE_MODEL         Claude 模型名称（如 ark-code-latest）
+
+${DIM}首次使用？运行 ${CYAN}larkpal init${DIM} 开始配置。${RESET}
+`);
+}
+async function cli() {
+	const command = process.argv.slice(2)[0];
+	if (command === "--version" || command === "-v") {
+		console.log(getVersion());
+		return;
+	}
+	if (command === "--help" || command === "-h") {
+		printHelp();
+		return;
+	}
+	if (command === "init") {
+		const { runInteractiveInit } = await import("./interactive-init-BYF2-otj.mjs");
+		const exitCode = await runInteractiveInit();
+		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);
+		if (!LarkCliCredentialProvider.isConfigured()) {
+			console.log(`\n${YELLOW}⚠️  飞书应用凭证未配置${RESET}\n`);
+			console.log(`  LarkPal 需要飞书应用凭证才能启动。正在进入初始化向导...\n`);
+			const { runInteractiveInit } = await import("./interactive-init-BYF2-otj.mjs");
+			const exitCode = await runInteractiveInit();
+			if (exitCode !== 0) process.exit(exitCode);
+			console.log(`${DIM}凭证配置完成，正在启动服务...${RESET}\n`);
+		}
+	}
+	await import("./main.mjs");
+}
+cli().catch((err) => {
+	console.error("LarkPal CLI 启动失败:", err);
+	process.exit(1);
+});
+//#endregion
+export {};

package/dist/interactive-init-BYF2-otj.mjs

@@ -0,0 +1,292 @@
+import { t as larkLogger } from "./lark-logger-D7_pEVQc.mjs";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { execSync, spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+//#region src/init/interactive-init.ts
+/**
+* 交互式初始化流程
+*
+* 引导用户完成 LarkPal 首次配置：
+*   Step 1: 检查前置依赖（claude、lark-cli）
+*   Step 2: 配置飞书应用凭证（lark-cli config init + 补充 App Secret）
+*   Step 3: 打印成功信息
+*
+* 仅使用 Node.js 内置模块，不依赖第三方包。
+*/
+const log = larkLogger("init");
+const CYAN = "\x1B[36m";
+const GREEN = "\x1B[32m";
+const YELLOW = "\x1B[33m";
+const RED = "\x1B[31m";
+const BOLD = "\x1B[1m";
+const DIM = "\x1B[2m";
+const RESET = "\x1B[0m";
+/** LarkPal 自身配置目录 */
+const LARKPAL_CONFIG_DIR = join(homedir(), ".larkpal");
+/** LarkPal 凭证文件（存储 appId + appSecret） */
+const LARKPAL_CREDENTIALS_PATH = join(LARKPAL_CONFIG_DIR, "credentials.json");
+/** readline 问答封装 */
+function ask(rl, question) {
+	return new Promise((resolve) => {
+		rl.question(question, (answer) => resolve(answer.trim()));
+	});
+}
+/** 检测 CLI 工具是否已安装 */
+function isCliInstalled(name) {
+	try {
+		return !!execSync(`which ${name}`, {
+			encoding: "utf-8",
+			timeout: 5e3
+		}).trim();
+	} catch {
+		return false;
+	}
+}
+/** 通过 lark-cli config show 获取当前配置的 appId */
+function getAppIdFromLarkCli() {
+	try {
+		const jsonMatch = execSync("lark-cli config show", {
+			encoding: "utf-8",
+			timeout: 1e4,
+			stdio: [
+				"pipe",
+				"pipe",
+				"pipe"
+			]
+		}).match(/\{[\s\S]*\}/);
+		if (jsonMatch) return JSON.parse(jsonMatch[0]).appId || null;
+	} catch {}
+	return null;
+}
+/** 写入凭证到 LarkPal 配置文件 */
+function writeCredentials(appId, appSecret) {
+	try {
+		if (!existsSync(LARKPAL_CONFIG_DIR)) {
+			mkdirSync(LARKPAL_CONFIG_DIR, { recursive: true });
+			log.info("创建 LarkPal 配置目录", { path: LARKPAL_CONFIG_DIR });
+		}
+		writeFileSync(LARKPAL_CREDENTIALS_PATH, JSON.stringify({
+			app_id: appId,
+			app_secret: appSecret
+		}, null, 2) + "\n", {
+			encoding: "utf-8",
+			mode: 384
+		});
+		log.info("凭证已写入", {
+			path: LARKPAL_CREDENTIALS_PATH,
+			appId
+		});
+		return true;
+	} catch (err) {
+		const msg = err instanceof Error ? err.message : String(err);
+		log.error("写入凭证文件失败", {
+			path: LARKPAL_CREDENTIALS_PATH,
+			error: msg
+		});
+		return false;
+	}
+}
+/** 检查 LarkPal 凭证文件是否已有有效凭证 */
+function hasLarkPalCredentials() {
+	if (!existsSync(LARKPAL_CREDENTIALS_PATH)) return null;
+	try {
+		const raw = readFileSync(LARKPAL_CREDENTIALS_PATH, "utf-8");
+		const creds = JSON.parse(raw);
+		if (creds.app_id && creds.app_secret) return {
+			appId: creds.app_id,
+			appSecret: creds.app_secret
+		};
+	} catch {}
+	return null;
+}
+function checkPrerequisites() {
+	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;
+	}
+	console.log();
+	return true;
+}
+/**
+* 通过 lark-cli config init 子进程配置凭证。
+* 返回解析到的 appId（成功）或 null（失败）。
+*/
+function runLarkCliConfigInit() {
+	return new Promise((resolve) => {
+		console.log(`\n${DIM}正在启动 lark-cli config init ...${RESET}\n`);
+		log.info("启动子进程: lark-cli config init");
+		let capturedOutput = "";
+		const child = spawn("lark-cli", ["config", "init"], { stdio: [
+			"inherit",
+			"pipe",
+			"pipe"
+		] });
+		child.stdout?.on("data", (chunk) => {
+			const text = chunk.toString();
+			capturedOutput += text;
+			process.stdout.write(text);
+		});
+		child.stderr?.on("data", (chunk) => {
+			const text = chunk.toString();
+			capturedOutput += text;
+			process.stderr.write(text);
+		});
+		child.on("error", (err) => {
+			log.error("lark-cli config init 启动失败", { error: err.message });
+			console.log(`\n${RED}启动 lark-cli config init 失败: ${err.message}${RESET}`);
+			resolve(null);
+		});
+		child.on("close", (code) => {
+			log.info("lark-cli config init 执行完毕", {
+				exitCode: code,
+				output: capturedOutput.substring(0, 500)
+			});
+			if (code === 0) {
+				let appId = capturedOutput.match(/App\s*ID:\s*(\S+)/i)?.[1] || null;
+				if (!appId) appId = getAppIdFromLarkCli();
+				if (appId) {
+					log.info("lark-cli config init 成功", { appId });
+					console.log(`\n${GREEN}✅ 飞书应用创建成功${RESET} ${DIM}(App ID: ${appId})${RESET}`);
+				} else console.log(`\n${GREEN}✅ lark-cli config init 完成${RESET}`);
+				resolve(appId);
+			} else {
+				console.log(`\n${YELLOW}⚠️  lark-cli config init 退出码: ${code}${RESET}`);
+				resolve(null);
+			}
+		});
+	});
+}
+/**
+* 提示用户输入 App Secret 并保存到 LarkPal 凭证文件。
+*
+* lark-cli 新版使用 master key 加密存储 secret，LarkPal 无法直接读取。
+* 需要用户从飞书开放平台复制 App Secret 并输入。
+*/
+async function promptAppSecret(rl, appId) {
+	console.log(`\n${BOLD}🔑 输入 App Secret${RESET}\n`);
+	console.log(`  ${DIM}lark-cli 已完成应用配置，但 LarkPal 还需要 App Secret 来启动服务。${RESET}`);
+	console.log(`  ${DIM}请在飞书开放平台的应用管理页面（凭证与基础信息）中复制 App Secret：${RESET}\n`);
+	console.log(`    ${CYAN}https://open.feishu.cn/app/${appId}${RESET}\n`);
+	const appSecret = await ask(rl, `  App Secret: `);
+	if (!appSecret) {
+		console.log(`\n${RED}App Secret 不能为空${RESET}`);
+		return false;
+	}
+	if (writeCredentials(appId, appSecret)) {
+		console.log(`\n${GREEN}✅ 凭证已保存${RESET} ${DIM}(${LARKPAL_CREDENTIALS_PATH})${RESET}`);
+		return true;
+	}
+	console.log(`\n${RED}凭证保存失败${RESET}`);
+	return false;
+}
+/** 手动输入完整凭证（App ID + App Secret） */
+async function manualCredentialInput(rl) {
+	console.log(`\n${BOLD}📝 手动输入飞书应用凭证${RESET}\n`);
+	console.log(`  ${DIM}你可以在飞书开放平台 (https://open.feishu.cn) 的应用管理页面找到这些信息。${RESET}\n`);
+	const appId = await ask(rl, `  App ID: `);
+	if (!appId) {
+		console.log(`\n${RED}App ID 不能为空${RESET}`);
+		return false;
+	}
+	const appSecret = await ask(rl, `  App Secret: `);
+	if (!appSecret) {
+		console.log(`\n${RED}App Secret 不能为空${RESET}`);
+		return false;
+	}
+	if (writeCredentials(appId, appSecret)) {
+		console.log(`\n${GREEN}✅ 凭证已保存${RESET} ${DIM}(${LARKPAL_CREDENTIALS_PATH})${RESET}`);
+		return true;
+	}
+	console.log(`\n${RED}凭证保存失败${RESET}`);
+	return false;
+}
+async function configureCredentials(rl) {
+	if (process.env.LARK_APP_ID && process.env.LARK_APP_SECRET) {
+		console.log(`${GREEN}✅ 飞书应用凭证已通过环境变量配置${RESET}`);
+		log.info("凭证已通过环境变量配置");
+		return true;
+	}
+	const existing = hasLarkPalCredentials();
+	if (existing) {
+		console.log(`${GREEN}✅ 飞书应用凭证已配置${RESET} ${DIM}(App ID: ${existing.appId})${RESET}`);
+		log.info("LarkPal 凭证文件已存在", { appId: existing.appId });
+		return true;
+	}
+	const existingAppId = getAppIdFromLarkCli();
+	if (existingAppId) {
+		console.log(`${GREEN}✅ 飞书应用已配置${RESET} ${DIM}(App ID: ${existingAppId})${RESET}`);
+		console.log(`\n  ${YELLOW}但 LarkPal 还需要 App Secret 才能启动。${RESET}`);
+		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;
+	log.info("用户选择凭证配置方式", { option });
+	if (option === 1) {
+		const appId = await runLarkCliConfigInit();
+		if (appId) return promptAppSecret(rl, appId);
+		console.log(`\n  ${YELLOW}lark-cli 配置未成功，是否手动输入凭证？${RESET}`);
+		if ((await ask(rl, `  手动输入？ [y/N]: `)).toLowerCase() === "y") return manualCredentialInput(rl);
+		return false;
+	}
+	return manualCredentialInput(rl);
+}
+/**
+* 执行交互式初始化流程。
+*
+* @returns 0 成功，1 失败
+*/
+async function runInteractiveInit() {
+	console.log(`\n${BOLD}${CYAN}╔══════════════════════════════════════╗${RESET}`);
+	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;
+	try {
+		credentialsOk = await configureCredentials(rl);
+	} finally {
+		rl.close();
+	}
+	if (!credentialsOk) {
+		console.log(`\n${RED}凭证配置未完成。你可以稍后运行 ${CYAN}larkpal init${RED} 重新配置。${RESET}\n`);
+		return 1;
+	}
+	console.log(`\n${BOLD}${GREEN}🎉 初始化完成！${RESET}\n`);
+	console.log(`  ${DIM}下一步:${RESET}`);
+	console.log(`    运行 ${CYAN}larkpal${RESET} 启动服务\n`);
+	log.info("交互式初始化流程完成");
+	return 0;
+}
+//#endregion
+export { runInteractiveInit };