@vibe-lark/larkpal 0.1.11 → 0.1.13

package/dist/main.mjs

@@ -1029,18 +1029,28 @@ var SessionProcessManager = class {
 			processEnv.LARKPAL_USER_NAME = userContext.userName;
 			processEnv.LARKPAL_CREDENTIAL_DIR = userContext.credentialDir;
 			processEnv.LARKPAL_IS_TENANT = userContext.isTenantIdentity ? "1" : "0";
+			const disableUserAuth = process.env.LARKPAL_DISABLE_USER_AUTH === "1" || process.env.LARKPAL_DISABLE_USER_AUTH === "true";
 			if (!userContext.isTenantIdentity) try {
 				const vault = new CredentialVault(userContext.credentialDir);
 				await vault.load();
 				const credentialEnvVars = await vault.getAllCredentialsAsEnv();
 				Object.assign(processEnv, credentialEnvVars);
-				const larkCred = await vault.getCredential("lark");
-				if (larkCred?.user_access_token && typeof larkCred.user_access_token === "string") processEnv.LARK_USER_ACCESS_TOKEN = larkCred.user_access_token;
+				if (!disableUserAuth) {
+					const larkCred = await vault.getCredential("lark");
+					if (larkCred?.user_access_token && typeof larkCred.user_access_token === "string") processEnv.LARK_USER_ACCESS_TOKEN = larkCred.user_access_token;
+				} else {
+					delete processEnv.LARK_USER_ACCESS_TOKEN;
+					log$25.info("LARKPAL_DISABLE_USER_AUTH 已启用，跳过飞书 user_access_token 注入", {
+						sessionId,
+						userId: userContext.userId
+					});
+				}
 				log$25.info("用户凭证已注入到 CC 进程环境", {
 					sessionId,
 					userId: userContext.userId,
 					credentialCount: Object.keys(credentialEnvVars).length,
-					hasLarkUserToken: !!processEnv.LARK_USER_ACCESS_TOKEN
+					hasLarkUserToken: !!processEnv.LARK_USER_ACCESS_TOKEN,
+					disableUserAuth
 				});
 			} catch (err) {
 				log$25.warn("用户凭证加载失败，CC 进程将使用默认环境", {
@@ -2870,7 +2880,8 @@ async function fetchFromApplicationApi(token) {
 		return {
 			appName: zhInfo?.name || app.app_name || "",
 			avatarUrl: app.avatar_url,
-			description: zhInfo?.description || app.description
+			description: zhInfo?.description || app.description,
+			helpDocUrl: zhInfo?.help_use
 		};
 	} catch (err) {
 		log$22.warn("application/v6 API 请求异常", { error: err instanceof Error ? err.message : String(err) });
@@ -2926,9 +2937,100 @@ 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$22.warn("无法从 URL 中解析文档 token", { url: docUrl });
+		return null;
+	}
+	log$22.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$22.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$22.info("文档 raw_content API 响应", {
+			code: data.code,
+			msg: data.msg,
+			contentLength: data.data?.content?.length
+		});
+		if (data.code !== 0 || !data.data?.content) {
+			log$22.warn("读取文档内容失败", {
+				code: data.code,
+				msg: data.msg,
+				docToken
+			});
+			return null;
+		}
+		return data.data.content.trim();
+	} catch (err) {
+		log$22.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$22.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$22.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 -->";
 /**
 * 将应用信息同步到 ~/.claude/CLAUDE.md
 *
@@ -2959,6 +3061,38 @@ async function syncAppInfoToClaudeMd(appInfo) {
 		hasAvatar: !!appInfo.avatarUrl
 	});
 }
+/**
+* 将人设文档内容同步到 ~/.claude/CLAUDE.md
+*
+* 在文件中维护一个 PERSONA_DOC 标记区块，内容来源于飞书云文档。
+* 如果文件中已有标记区块则替换，否则追加到文件末尾。
+*/
+async function syncPersonaDocToClaudeMd(personaContent) {
+	const claudeMdPath = join$1(homedir$1(), ".claude", "CLAUDE.md");
+	if (!existsSync$1(claudeMdPath)) {
+		log$22.warn("CLAUDE.md 不存在，无法同步人设文档（需先同步应用信息）");
+		return;
+	}
+	let content = await readFile$1(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$1(claudeMdPath, content, "utf-8");
+	log$22.info("CLAUDE.md 人设文档已同步", { contentLength: personaContent.length });
+}
 /** 构建应用信息标记区块 */
 function buildAppInfoBlock(appInfo) {
 	const lines = [
@@ -3002,10 +3136,20 @@ async function syncAppInfo(credentials) {
 		return null;
 	}
 	await syncAppInfoToClaudeMd(appInfo);
+	if (appInfo.helpDocUrl) {
+		log$22.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$22.warn("人设文档内容为空或读取失败，跳过同步");
+		}
+	}
 	await installSyncSkill();
 	log$22.info("应用信息同步完成", {
 		appName: appInfo.appName,
-		description: appInfo.description?.substring(0, 50)
+		description: appInfo.description?.substring(0, 50),
+		hasPersonaDoc: !!appInfo.helpDocUrl
 	});
 	return appInfo;
 }

package/package.json

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