lark-connect-setup

飞书连接配置

使用这个技能把本机准备好，之后智能体会话才能绑定到飞书群。

流程

1. 检查包命令是否可用：

npx -y curiosea-lark-connect@latest --help

后续示例都使用同一个发布包命令，除非用户已经明确全局安装了可用版本。

2. 如果缺少凭据，先输出配置引导：

npx -y curiosea-lark-connect@latest setup

用户提供应用 ID 和应用密钥后，保存到本地配置：

npx -y curiosea-lark-connect@latest setup --app-id cli_xxx --app-secret <secret>

不要在 setup 阶段要求或保存群聊 ID。群聊 ID 属于会话绑定参数。

3. 提醒用户确认飞书后台前置条件：

• 机器人已经加入目标群。
• 应用已经开通接收消息事件需要的权限和事件订阅。
• 如果后续需要发送消息、添加 reaction、下载资源，相应权限也要在飞书后台开通。

4. 凭据保存后运行真实连通性检查：

npx -y curiosea-lark-connect@latest doctor --live

5. 当模型上下文协议工具返回 DAEMON_NOT_RUNNING 时，启动守护进程：

npx -y curiosea-lark-connect@latest daemon start

然后检查状态：

npx -y curiosea-lark-connect@latest daemon status

规则

• 不要把应用密钥回显给用户。
• 优先使用 setup 创建的本地配置文件；不要把密钥写入插件清单或模型上下文协议配置。
• 守护进程在 1 小时内没有飞书事件或本地智能体调用后会自动退出。后续调用再次返回 DAEMON_NOT_RUNNING 时，重新启动守护进程。
• 如果在智能体对话里执行配置，只在缺少凭据时说明用户需要打开的飞书应用后台页面。