@hwj123weijian/pi-feishu 0.9.0 → 0.10.0

package/README.md

@@ -16,7 +16,7 @@
 - 消息需要排队时发送“排队中（第 N 位）”提示，轮到处理时自动撤回；队列变化时提示自动改写为新位数
 - Owner 在排队中的消息上点 ❌（`CrossMark`）表情即可取消该消息
 - 未绑定的群里被 @ 时，bot 会回复绑定引导而不是沉默；非授权成员的普通群消息完全不会触发回复
-- Bot 被拉进新群时，会私聊 Owner 发送绑定引导和群聊权限体检结果
+- Bot 被拉进新群时，会私聊 Owner 发送绑定引导和群聊权限体检结果；启动成功后也会私聊 Owner 发送欢迎语和权限体检
 - Assistant 文本通过 Pi 的 `message_update` 增量渲染到同一张飞书卡片
 - 工具执行时仅显示安全的状态摘要，不展示参数、命令、文件内容或工具输出
 - SDK 以 500ms / 120 字符节流卡片更新；完成、失败、中止都会收尾卡片，失败原因（脱敏后）会写进回复

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@hwj123weijian/pi-feishu",
-	"version": "0.9.0",
+	"version": "0.10.0",
 	"description": "Feishu private-chat and managed-group bridge for Pi",
 	"type": "module",
 	"license": "MIT",

package/src/controller.ts

@@ -25,7 +25,12 @@ import { MessageDeduplicator } from "./message-deduplicator.js";
 import { SerialMessageQueue } from "./message-queue.js";
 import { OwnerBinding } from "./owner-binding.js";
 import { executeRemoteCommand, type ParsedRemoteCommand, parseRemoteCommand } from "./remote-commands.js";
-import { buildBotAddedGuidance, buildGroupPermissionReminder } from "./scopes.js";
+import {
+	buildBotAddedGuidance,
+	buildGroupPermissionReminder,
+	buildScopeHealthSection,
+	buildStartupWelcome,
+} from "./scopes.js";
 
 // 与 easycodeclient 的飞书集成一致：THINKING 表情兼作"已读 + 处理中"回执。
 const READ_REACTION_EMOJI = "THINKING";
@@ -136,6 +141,8 @@ export class FeishuController {
 						...(existing.ownerOpenId ? { ownerOpenId: existing.ownerOpenId } : {}),
 						...(existing.managedGroupIds ? { managedGroupIds: existing.managedGroupIds } : {}),
 						...(existing.groupSessions ? { groupSessions: existing.groupSessions } : {}),
+						...(existing.allowlist ? { allowlist: existing.allowlist } : {}),
+						...(existing.allowlistNames ? { allowlistNames: existing.allowlistNames } : {}),
 					}
 				: credentials;
 		await this.store.save(next);
@@ -175,10 +182,26 @@ export class FeishuController {
 		gateway.onReaction((event) => this.handleReaction(event));
 		this.botAddedUnsubscribe = gateway.onBotAdded?.((event) => void this.handleBotAdded(event));
 
+		// 对齐 easycodeclient：网关启动后私聊 Owner 发欢迎语 + 权限体检。
+		// 主动 await 保证欢迎语先于任何消息回复送达；probe/发送失败都不阻塞启动。
+		if (credentials.ownerOpenId) await this.sendStartupWelcome(gateway, credentials);
+
 		const bindingCode = binding.getOrCreateCode();
 		return bindingCode ? { alreadyRunning: false, bindingCode } : { alreadyRunning: false };
 	}
 
+	/** Bot 上线后私聊 Owner 的欢迎语；probe 失败时只发正文，不猜权限状态。 */
+	private async sendStartupWelcome(gateway: FeishuGateway, credentials: FeishuCredentials): Promise<void> {
+		const ownerOpenId = credentials.ownerOpenId;
+		if (!ownerOpenId) return;
+		const probe = await this.probeScopes();
+		const welcome = buildStartupWelcome({
+			cwd: process.cwd(),
+			healthSection: buildScopeHealthSection(credentials.appId, probe.grantedScopes),
+		});
+		await gateway.sendText(ownerOpenId, welcome).catch(() => undefined);
+	}
+
 	async createGroupChat(name: string): Promise<string> {
 		const gateway = this.gateway;
 		const ownerOpenId = this.credentials?.ownerOpenId;

package/src/extension.ts

@@ -10,6 +10,7 @@ import {
 	buildEventSubUrl,
 	buildPermissionPageUrl,
 	buildScopeApplyUrl,
+	buildScopeHealthSection,
 	hasScope,
 	missingScopes,
 	REQUIRED_APP_SCOPES,
@@ -336,24 +337,9 @@ export async function appendScopeHealthHint(
 	dashboard: string,
 	grantedScopes?: string[],
 ): Promise<string> {
-	if (!grantedScopes) return dashboard;
-	const missing = missingScopes(grantedScopes, REQUIRED_APP_SCOPES);
-	const hasGroupMsg = hasScope(grantedScopes, SENSITIVE_GROUP_MSG_SCOPE);
-	if (missing.length === 0 && hasGroupMsg) {
-		return `${dashboard}\n\n✅ 应用权限配置完整，所有功能均可正常使用。`;
-	}
-	const lines = ["", "⚠️ 以下应用权限尚未开通，对应功能会受限："];
-	if (missing.length > 0) {
-		lines.push(`📋 缺失 ${missing.length} 项基础权限，点击一键申请：`);
-		lines.push(`👉 ${buildScopeApplyUrl({ appId, scopes: missing })}`);
-	}
-	if (!hasGroupMsg) {
-		lines.push("💬 「免 @ 响应」权限未开：群内需 @机器人 才能触发，点击开通：");
-		lines.push(`👉 ${buildScopeApplyUrl({ appId, scopes: [SENSITIVE_GROUP_MSG_SCOPE] })}`);
-	}
-	lines.push("🔄 权限生效（需发布应用版本）：");
-	lines.push(`👉 ${buildPermissionPageUrl(appId)}`);
-	return `${dashboard}\n${lines.join("\n")}`;
+	const section = buildScopeHealthSection(appId, grantedScopes);
+	if (!section) return dashboard;
+	return `${dashboard}\n\n${section}`;
 }
 
 export function renderFeishuStatus(status: FeishuStatus, scopeHealth?: string[]): string {

package/src/gateway.ts

@@ -407,8 +407,9 @@ class SdkFeishuReply implements FeishuReply {
 	}
 
 	async fail(reason?: string): Promise<void> {
-		const suffix = reason ? `：${reason}` : "，请稍后再试。";
-		await this.finish({ text: this.snapshot.text || "处理消息失败", status: "处理失败" }, `处理消息失败${suffix}`);
+		const detail = reason ? `处理消息失败：${reason}` : "处理消息失败，请稍后再试。";
+		const text = this.snapshot.text ? `${this.snapshot.text}\n\n⚠️ ${detail}` : detail;
+		await this.finish({ text, status: "处理失败" }, detail);
 	}
 
 	async cancel(): Promise<void> {

package/src/scopes.ts

@@ -164,3 +164,51 @@ export function buildBotAddedGuidance(params: {
 	lines.push(`🔄 权限变更后需发布新版本生效：${buildPermissionPageUrl(params.appId)}`);
 	return lines.join("\n");
 }
+
+/**
+ * 权限体检段落：grantedScopes 未知时返回 null（不猜）；
+ * 全部就绪时返回 ✅ 段落，否则返回缺失清单 + 一键申请链接。
+ */
+export function buildScopeHealthSection(appId: string, grantedScopes?: readonly string[]): string | null {
+	if (!grantedScopes) return null;
+	const missing = missingScopes(grantedScopes, REQUIRED_APP_SCOPES);
+	const hasGroupMsg = hasScope(grantedScopes, SENSITIVE_GROUP_MSG_SCOPE);
+	if (missing.length === 0 && hasGroupMsg) {
+		return "✅ 应用权限配置完整，所有功能均可正常使用。";
+	}
+	const lines = ["⚠️ 以下应用权限尚未开通，对应功能会受限："];
+	if (missing.length > 0) {
+		lines.push(`📋 缺失 ${missing.length} 项基础权限，点击一键申请：`);
+		lines.push(`👉 ${buildScopeApplyUrl({ appId, scopes: missing })}`);
+	}
+	if (!hasGroupMsg) {
+		lines.push("💬 「免 @ 响应」权限未开：群内需 @机器人 才能触发，点击开通：");
+		lines.push(`👉 ${buildScopeApplyUrl({ appId, scopes: [SENSITIVE_GROUP_MSG_SCOPE] })}`);
+	}
+	lines.push("🔄 权限生效（需发布应用版本）：");
+	lines.push(`👉 ${buildPermissionPageUrl(appId)}`);
+	return lines.join("\n");
+}
+
+/**
+ * 对齐 easycodeclient：Bot 上线后私聊 Owner 的欢迎语，
+ * 包含工作目录、使用提示和权限体检结果。
+ */
+export function buildStartupWelcome(params: { cwd?: string; healthSection?: string | null }): string {
+	const lines = ["👋 Pi 飞书 Bot 已上线，随时待命。"];
+	if (params.cwd) {
+		lines.push("", "**📂 主会话工作目录**", `\`${params.cwd}\``);
+	}
+	lines.push(
+		"",
+		"**💡 使用提示**",
+		"- 私聊直接发送问题即可",
+		"- Owner 在群里发送 /bind 可把群绑定到独立 Pi 会话",
+		"",
+		"**❓ 需要帮助**：发送 /help 查看所有可用命令",
+	);
+	if (params.healthSection) {
+		lines.push("", "---", "", params.healthSection);
+	}
+	return lines.join("\n");
+}