消息中心与 AI 助手

消息中心负责触达用户，AI 助手通过受控工具读取或操作业务。两者都复用平台当前的权限与扩展状态。

消息与通道

站内消息落库后可在消息中心读取。邮件与群机器人 webhook 通过后台队列发送；站内可见不等于外部通道已经发送成功。

在通知管理中配置所需通道、模板和路由，并查看发送日志。外部通道需要实际配置与启用，模板存在不会自动接通第三方服务。

模板按以下顺序解析：对应通道的数据库模板、通用数据库模板、当前可用扩展声明的代码默认模板。数据库模板用于运营覆盖，不会被代码默认模板反复改写。

用户可维护通道绑定和按消息类型、通道设置的接收偏好；系统类型的站内通知强制接收。偏好只影响消息触达，不影响审批任务本身。

AI 助手默认行为

新安装默认使用本地 Fake Provider，用于确定性的开发与验证。要接入真实模型，需要维护者配置并启用相应 Provider 和模型，再按当前平台的模型选择入口使用。

Fake 的回复和工具场景用于验证应用行为，不能据此判断真实模型的质量、延迟或费用。

读取与写入

Agent 工具由服务端声明参数、功能权限、数据范围和策略。模型给出的参数不能覆盖当前用户身份、角色或 DataScope。

需要确认的操作会生成不可变提案并等待用户确认。执行时服务端仍会重新授权，并使用幂等回执防止重复执行。取消或超时也应以当前运行状态和回执确认结果。

应用可通过 bootstrap.Options.Resources 接入业务资源描述，并通过 FakeScenarios 提供自己的测试场景。商品样板演示了这条路径。

排查顺序

• 消息未到达：先查看站内记录，再查看外部通道日志、配置及队列。
• 助手一直排队：检查 AGENT_WORKER_ENABLED、Redis 和 worker 日志。
• 工具不可用：检查功能权限、数据范围、资源注册及扩展状态。
• 等待确认：在当前提案中确认或取消，普通聊天回复不会替代操作确认。

开发新的业务能力，继续阅读后端业务开发。