@delthin/dsh-feishu-notify

3. 状态查询、配置与测试工具（feishu_notify）

feishu_notify 工具供模型或宿主执行辅助操作：

• 状态查询（status）：读取当前启用状态、配置摘要与最近发送结果，不发送飞书消息。
• 非密钥配置（configure）：更新除密钥外的配置字段（模型无法通过任何工具读取或修改 App Secret）。
• 固定测试消息：发送真实固定测试文案以验证飞书通道连通性。测试消息使用已保存的配置，忽略总开关（enabled）和免打扰时段（quietHours）。

配置说明

在 DSH Web 界面进入「设置 → 飞书提醒」，填写配置并保存后启用。配置保存在当前运行 profile 的 feishu-notify.json 文件中。

字段名	类型	说明	示例（占位符）
appId	string	飞书企业自建应用的 App ID	cli_a1b2c3d4e5f6g7h8
App Secret	string	飞书自建应用的密钥。仅限在设置 UI 中填写，已保存时界面仅显示 ***，留空或不修改该掩码会保留原密钥	********************
receive_id	string	接收方标识：ou_ 开头按用户 open_id 发送私聊；oc_ 开头按群聊 chat_id 发送（也可复用已有的会话 ID）	ou_xxxxxxxxxxxxxxxx 或 oc_xxxxxxxxxxxxxxxx
enabled	boolean	通知总开关。关闭后跳过常规通知与长任务收尾摘要，但不影响手动点击「发送测试消息」	true
quietHours.start	string	免打扰开始时间（HH:mm）	23:00
quietHours.end	string	免打扰结束时间（HH:mm）。支持跨午夜时段；当 start == end 时表示全天免打扰	08:00
quietHours.timeZone	string	免打扰计算的 IANA 时区名称	Asia/Shanghai

飞书后台权限核对

启用前请对照飞书开放平台官方后台核对自建应用配置：

• 应用已启用机器人能力，并已开通发送消息所需权限。
• 使用 ou_（open_id）时，目标用户需在应用可见范围内；使用 oc_（chat_id）时，需确保机器人已加入目标群聊或对应会话。
• 设置页存在未保存修改时，请先点击保存再执行「发送测试消息」。界面仅在飞书接口返回成功后才提示成功，失败时会直接展示飞书返回的错误码与错误说明。