dsh-feishu-bot

一、飞书开放平台：创建并配置机器人

以下步骤在 飞书开放平台（国际版 Lark） 开发者后台完成，全程无需服务器公网地址。

1. 创建企业自建应用 「开发者后台」→「创建企业自建应用」，填写名称等信息。
2. 获取凭证 「凭证与基础信息」→ 复制 App ID（cli_xxx）与 App Secret。
3. 开启机器人能力 「添加应用能力」→ 勾选 机器人。
4. 添加权限（「权限管理」→ 开通以下权限，保存后需发布版本生效）：

   权限	用途
   im:message:send_as_bot	以机器人身份发送/回复消息
   im:message（含 p2p_msg / group_msg / group_at_msg 子权限）	接收用户消息事件
   im:chat:readonly（可选）	查询会话详情/列表

5. 订阅事件（「事件与回调」→「事件配置」→「添加事件」）： 添加 接收消息 im.message.receive_v1。

   使用长连接时不需要配置回调请求地址（Request URL 留空即可）， 事件会通过 WebSocket 长连接直接推给插件。

6. 发布版本（「版本管理与发布」→ 创建版本 → 申请发布/审核通过）。 自建应用只有发布后才能被用户搜到并使用。

三、配置项

配置项	类型	默认	说明
appId	string，必填	—	飞书自建应用 App ID（cli_xxx），支持 env:VAR
appSecret	string，必填	—	飞书自建应用 App Secret，支持 env:VAR
domain	feishu | lark	feishu	开放平台域名（国际版选 lark）
loggerLevel	fatal~trace	info	SDK 日志级别
dmMode	open | allowlist | pair | disabled	open	私聊策略：开放/白名单/仅双向/关闭
dmAllowlist	string[]	[]	allowlist/pair 模式下的用户 open_id 白名单
groupAllowlist	string[]	[]	群聊 chat_id 白名单（空 = 不限群）
requireMention	boolean	true	群聊中必须 @机器人 才回复
respondToMentionAll	boolean	false	是否响应 @所有人
mode	echo | llm | agent	llm	入站回复模式
systemPrompt	string	默认提示词	llm 模式的系统提示词
provider	string	—	llm 模式的 provider 路由（如 deepseek-official）
model	string	—	llm 模式的模型 id（如 deepseek-v4-flash）
maxHistory	number	20	llm 模式每会话保留的对话轮数（0 = 无记忆）
agentId	string	—	agent 模式：目标 DSH agent 会话 id（不配置则自动创建）
agentPreset	string	跟随默认	自动创建会话使用的 agent preset（如 standard / liangshen）；不配置跟随 GUI 默认预设
workspace	string	process.cwd()	agent 模式自动创建会话时的工作目录
commands	boolean	true	是否启用飞书会话管理命令（/new /sessions /attach /detach）
resetCommands	string[]	['/new', '/reset']	重置上下文命令列表
attachHistory	number	5	/attach 接手后发送最近几条对话历史（0 = 不发）
tools	boolean	true	是否注册 feishu_* 模型工具