@vibe-lark/larkpal 0.1.84 → 0.1.85

package/dist/main.mjs

@@ -2566,13 +2566,13 @@ async function fetchFromApplicationApi(token) {
 		const data = await (await fetch("https://open.feishu.cn/open-apis/application/v6/applications/me?lang=zh_cn", { headers: { Authorization: `Bearer ${token}` } })).json();
 		log$29.info("application/v6 API 响应", {
 			code: data.code,
-			msg: data.msg,
+			msg: redactAppInfoSyncDiagnostic(data.msg),
 			hasApp: !!data.data?.app
 		});
 		if (data.code !== 0 || !data.data?.app) {
 			log$29.warn("application/v6 API 返回非零或无数据，将 fallback", {
 				code: data.code,
-				msg: data.msg
+				msg: redactAppInfoSyncDiagnostic(data.msg)
 			});
 			return null;
 		}
@@ -2595,13 +2595,13 @@ async function fetchFromBotApi(token) {
 		const data = await (await fetch("https://open.feishu.cn/open-apis/bot/v3/info", { headers: { Authorization: `Bearer ${token}` } })).json();
 		log$29.info("bot/v3/info API 响应", {
 			code: data.code,
-			msg: data.msg,
+			msg: redactAppInfoSyncDiagnostic(data.msg),
 			hasBot: !!data.bot
 		});
 		if (data.code !== 0 || !data.bot) {
 			log$29.error("bot/v3/info API 失败", {
 				code: data.code,
-				msg: data.msg
+				msg: redactAppInfoSyncDiagnostic(data.msg)
 			});
 			return null;
 		}
@@ -2628,7 +2628,7 @@ async function getTenantAccessToken(appId, appSecret) {
 		if (data.code !== 0 || !data.tenant_access_token) {
 			log$29.error("获取 tenant_access_token 失败", {
 				code: data.code,
-				msg: data.msg
+				msg: redactAppInfoSyncDiagnostic(data.msg)
 			});
 			return null;
 		}
@@ -2638,100 +2638,9 @@ async function getTenantAccessToken(appId, appSecret) {
 		return null;
 	}
 }
-/**
-* 从飞书云文档 URL 中解析文档 token
-*
-* 支持的 URL 格式：
-* - https://xxx.feishu.cn/docx/{token}
-* - https://xxx.feishu.cn/wiki/{token}
-* - https://xxx.larksuite.com/docx/{token}
-*/
-function parseDocTokenFromUrl(url) {
-	try {
-		const parts = new URL(url).pathname.split("/").filter(Boolean);
-		for (let i = 0; i < parts.length; i++) {
-			if (parts[i] === "docx" && parts[i + 1]) return {
-				token: parts[i + 1],
-				type: "docx"
-			};
-			if (parts[i] === "wiki" && parts[i + 1]) return {
-				token: parts[i + 1],
-				type: "wiki"
-			};
-		}
-		return null;
-	} catch {
-		return null;
-	}
-}
-/**
-* 从飞书云文档读取纯文本内容（作为人设文档）
-*
-* 对于 wiki 类型，先通过 wiki API 获取实际的 doc token，再读取内容。
-*/
-async function fetchDocContent(docUrl, accessToken) {
-	const parsed = parseDocTokenFromUrl(docUrl);
-	if (!parsed) {
-		log$29.warn("无法从 URL 中解析文档 token", { url: docUrl });
-		return null;
-	}
-	log$29.info("开始读取人设文档", {
-		url: docUrl,
-		type: parsed.type,
-		token: parsed.token
-	});
-	let docToken = parsed.token;
-	if (parsed.type === "wiki") {
-		const realToken = await resolveWikiNodeToDocToken(parsed.token, accessToken);
-		if (!realToken) log$29.warn("wiki 节点解析失败，尝试直接使用 token 读取");
-		else docToken = realToken;
-	}
-	try {
-		const data = await (await fetch(`https://open.feishu.cn/open-apis/docx/v1/documents/${docToken}/raw_content`, { headers: { Authorization: `Bearer ${accessToken}` } })).json();
-		log$29.info("文档 raw_content API 响应", {
-			code: data.code,
-			msg: data.msg,
-			contentLength: data.data?.content?.length
-		});
-		if (data.code !== 0 || !data.data?.content) {
-			log$29.warn("读取文档内容失败", {
-				code: data.code,
-				msg: data.msg,
-				docToken
-			});
-			return null;
-		}
-		return data.data.content.trim();
-	} catch (err) {
-		log$29.error("读取文档内容异常", {
-			error: err instanceof Error ? err.message : String(err),
-			docToken
-		});
-		return null;
-	}
-}
-/** 将 wiki 节点 token 解析为实际的文档 token */
-async function resolveWikiNodeToDocToken(wikiToken, accessToken) {
-	try {
-		const data = await (await fetch(`https://open.feishu.cn/open-apis/wiki/v2/spaces/get_node?token=${wikiToken}`, { headers: { Authorization: `Bearer ${accessToken}` } })).json();
-		log$29.info("wiki get_node API 响应", {
-			code: data.code,
-			msg: data.msg,
-			objType: data.data?.node?.obj_type
-		});
-		if (data.code !== 0 || !data.data?.node?.obj_token) return null;
-		return data.data.node.obj_token;
-	} catch (err) {
-		log$29.warn("wiki get_node 请求异常", { error: err instanceof Error ? err.message : String(err) });
-		return null;
-	}
-}
 /** CLAUDE.md 中的应用信息区块标记 */
 const APP_INFO_START = "<!-- APP_INFO_START -->";
 const APP_INFO_END = "<!-- APP_INFO_END -->";
-/** CLAUDE.md 中的人设文档区块标记 */
-const PERSONA_DOC_START = "<!-- PERSONA_DOC_START -->";
-const PERSONA_DOC_END = "<!-- PERSONA_DOC_END -->";
 /** AGENTS.md 中的全局人设镜像区块标记（Codex 读取 AGENTS.md，不读取 CLAUDE.md） */
 const CODEX_GLOBAL_PERSONA_START = "<!-- LARKPAL_CODEX_GLOBAL_PERSONA_START -->";
 const CODEX_GLOBAL_PERSONA_END = "<!-- LARKPAL_CODEX_GLOBAL_PERSONA_END -->";
@@ -2767,39 +2676,6 @@ async function syncAppInfoToClaudeMd(appInfo) {
 	});
 }
 /**
-* 将人设文档内容同步到 ~/.claude/CLAUDE.md
-*
-* 在文件中维护一个 PERSONA_DOC 标记区块，内容来源于飞书云文档。
-* 如果文件中已有标记区块则替换，否则追加到文件末尾。
-*/
-async function syncPersonaDocToClaudeMd(personaContent) {
-	const claudeMdPath = join(homedir(), ".claude", "CLAUDE.md");
-	if (!existsSync(claudeMdPath)) {
-		log$29.warn("CLAUDE.md 不存在，无法同步人设文档（需先同步应用信息）");
-		return;
-	}
-	let content = await readFile(claudeMdPath, "utf-8");
-	const personaBlock = [
-		PERSONA_DOC_START,
-		"## 人设与行为规范",
-		"",
-		"> 以下内容来自飞书人设文档，是你的核心身份定义和行为准则。",
-		"",
-		personaContent,
-		PERSONA_DOC_END
-	].join("\n");
-	const startIdx = content.indexOf(PERSONA_DOC_START);
-	const endIdx = content.indexOf(PERSONA_DOC_END);
-	if (startIdx !== -1 && endIdx !== -1) {
-		const before = content.substring(0, startIdx);
-		const after = content.substring(endIdx + 24);
-		content = before + personaBlock + after;
-	} else content = content.trimEnd() + "\n\n" + personaBlock + "\n";
-	await writeFile(claudeMdPath, content, "utf-8");
-	await syncClaudeMdToCodexAgentsMd();
-	log$29.info("CLAUDE.md 人设文档已同步", { contentLength: personaContent.length });
-}
-/**
 * 将全局 Claude 人设镜像到 workspace/AGENTS.md。
 *
 * Claude Code 的全局入口是 ~/.claude/CLAUDE.md；Codex 的项目指令入口是
@@ -2958,20 +2834,11 @@ async function syncAppInfo(credentials) {
 	}
 	await syncAppInfoToClaudeMd(appInfo);
 	await syncClaudeMdToCodexAgentsMd();
-	if (appInfo.helpDocUrl) {
-		log$29.info("检测到帮助文档 URL，尝试同步人设文档", { helpDocUrl: appInfo.helpDocUrl });
-		const token = await getTenantAccessToken(credentials.appId, credentials.appSecret);
-		if (token) {
-			const personaContent = await fetchDocContent(appInfo.helpDocUrl, token);
-			if (personaContent) await syncPersonaDocToClaudeMd(personaContent);
-			else log$29.warn("人设文档内容为空或读取失败，跳过同步");
-		}
-	}
 	await installSyncSkill();
 	log$29.info("应用信息同步完成", {
 		appName: appInfo.appName,
 		description: appInfo.description?.substring(0, 50),
-		hasPersonaDoc: !!appInfo.helpDocUrl
+		hasPersonaSourceCandidate: !!appInfo.helpDocUrl
 	});
 	return appInfo;
 }
@@ -2985,6 +2852,10 @@ function replaceManagedBlock(current, block, startMarker, endMarker) {
 	}
 	return current.trimEnd() ? `${current.trimEnd()}\n\n${block}\n` : `${block}\n`;
 }
+function redactAppInfoSyncDiagnostic(value) {
+	if (!value) return value;
+	return value.replace(/\bwss:\/\/\S+/gi, "[redacted-wss-url]").replace(/\bBearer\s+[A-Za-z0-9._~+/=-]+/gi, "Bearer [redacted]").replace(/\b(token|secret|authorization|api[_-]?key|access[_-]?token|refresh[_-]?token|password)\s*[:=]\s*[^\s,;]+/gi, "$1=[redacted]");
+}
 const SYNC_SKILL_PATH = join(homedir(), ".claude", "commands", "sync-app-info.md");
 const SYNC_SKILL_VERSION = "v0.1.0";
 /**
@@ -13972,6 +13843,83 @@ function isAskUserToolName(toolName) {
 	return normalized === "ask_user" || normalized.endsWith("__ask_user") || normalized.endsWith("/ask_user") || normalized.endsWith(".ask_user") || normalized.endsWith(":ask_user");
 }
 //#endregion
+//#region src/persona/source-card.ts
+function buildPersonaSourceCandidateCard(params) {
+	const helpDocUrl = params.appInfo.helpDocUrl?.trim();
+	if (!helpDocUrl) throw new Error("Persona source candidate card requires appInfo.helpDocUrl");
+	return {
+		schema: "2.0",
+		config: {
+			wide_screen_mode: true,
+			update_multi: true,
+			summary: { content: "人设文档候选待确认" }
+		},
+		header: {
+			title: {
+				tag: "plain_text",
+				content: "人设文档候选"
+			},
+			template: "blue"
+		},
+		body: { elements: [{
+			tag: "markdown",
+			content: [
+				`检测到应用「${params.appInfo.appName}」配置了帮助文档。`,
+				"",
+				"这个链接可以作为 agent 人设文档来源，但不会自动绑定，避免误把业务帮助文档当成人设。",
+				"",
+				`候选文档：${helpDocUrl}`
+			].join("\n")
+		}, {
+			tag: "action",
+			actions: [
+				{
+					tag: "button",
+					text: {
+						tag: "plain_text",
+						content: "绑定为人设文档"
+					},
+					type: "primary",
+					value: {
+						action: "persona_source_bind_candidate",
+						accountId: params.accountId,
+						appName: params.appInfo.appName,
+						helpDocUrl
+					}
+				},
+				{
+					tag: "button",
+					text: {
+						tag: "plain_text",
+						content: "创建新人设文档"
+					},
+					type: "default",
+					value: {
+						action: "persona_source_create_new",
+						accountId: params.accountId,
+						appName: params.appInfo.appName,
+						helpDocUrl
+					}
+				},
+				{
+					tag: "button",
+					text: {
+						tag: "plain_text",
+						content: "暂不配置"
+					},
+					type: "text",
+					value: {
+						action: "persona_source_defer",
+						accountId: params.accountId,
+						appName: params.appInfo.appName,
+						helpDocUrl
+					}
+				}
+			]
+		}] }
+	};
+}
+//#endregion
 //#region src/messaging/inbound/dispatch-sync-app-info.ts
 /**
 * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
@@ -14007,8 +13955,19 @@ async function dispatchSyncAppInfoCommand(dc, replyToMessageId) {
 		await sendSyncAppInfoReply(dc, ["应用信息同步完成。", ...[
 			`应用名称：${appInfo.appName}`,
 			appInfo.description ? `应用描述：${appInfo.description}` : void 0,
-			appInfo.helpDocUrl ? "人设文档：已同步" : void 0
+			appInfo.helpDocUrl ? "人设文档候选：待确认" : void 0
 		].filter((line) => Boolean(line))].join("\n"), replyToMessageId);
+		if (appInfo.helpDocUrl) await sendCardFeishu({
+			cfg: dc.accountScopedCfg,
+			to: dc.ctx.chatId,
+			card: buildPersonaSourceCandidateCard({
+				appInfo,
+				accountId: dc.account.accountId
+			}),
+			replyToMessageId: replyToMessageId ?? dc.ctx.messageId,
+			accountId: dc.account.accountId,
+			replyInThread: dc.isThread
+		});
 	} catch (err) {
 		const errMsg = err instanceof Error ? err.message : String(err);
 		dc.error(`feishu[${dc.account.accountId}]: sync-app-info failed: ${errMsg}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-lark/larkpal",
-  "version": "0.1.84",
+  "version": "0.1.85",
   "description": "LarkPal - Lark/Feishu bot service",
   "type": "module",
   "main": "./dist/main.mjs",