Appearance
配置项参考
本页汇总常用配置项及其作用。更完整的场景说明请结合功能页一起阅读。
主要配置项
| 选项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
enabled | boolean | true | 是否启用插件 |
clientId | string | 必填 | 钉钉 AppKey |
clientSecret | string | 必填 | 钉钉 AppSecret |
robotCode | string | - | 机器人代码 |
corpId | string | - | 企业 ID |
agentId | string | - | 应用 ID |
dmPolicy | string | open | 私聊策略 |
groupPolicy | string | open | 群聊策略 |
allowFrom | string[] | [] | 私聊白名单 |
groupAllowFrom | string[] | - | 群聊发送者白名单 |
groups | object | - | 群级配置 |
displayNameResolution | string | disabled | 是否允许基于本地目录做显示名解析 |
bypassProxyForSend | boolean | false | 发送链路是否绕过全局代理 |
learningEnabled | boolean | false | 是否开启学习信号采集 |
learningAutoApply | boolean | false | 是否自动注入学习结果 |
learningNoteTtlMs | number | 21600000 | 会话级学习笔记 TTL |
mediaUrlAllowlist | string[] | [] | 允许下载的远程媒体目标 |
journalTTLDays | number | 7 | 引用回溯日志保留天数 |
ackReaction | string | - | 原生处理中表情反馈 |
messageType | string | markdown | 回复模式：markdown 或 card |
cardTemplateId | string | - | AI 卡片模板 ID |
cardTemplateKey | string | content | 卡片内容字段名 |
cardRealTimeStream | boolean | false | 是否启用真流式卡片更新 |
aicardDegradeMs | number | 1800000 | 卡片连续失败后的降级时间 |
debug | boolean | false | 是否输出调试日志 |
mediaMaxMb | number | - | 入站媒体大小上限 |
maxConnectionAttempts | number | 10 | 最大连接重试次数 |
initialReconnectDelay | number | 1000 | 初始重连延迟 |
maxReconnectDelay | number | 60000 | 最大重连延迟 |
reconnectJitter | number | 0.3 | 重连抖动因子 |
关于 displayNameResolution
disabled：默认值，只允许显式 IDall：允许本地学习目录参与群名和显示名解析
启用后要注意两类风险：
- 误投风险：重名、改名、旧目录数据都可能导致误解析
- 权限扩散风险：当前没有 owner-only 粒度
对敏感通知和不可撤回消息，建议优先使用显式 ID。
关于 ackReaction
启用后，插件会在处理开始时对用户原消息添加原生文本表情反馈，处理结束后自动撤回。
常见配置：
""：关闭"🤔思考中"：固定“思考中”"emoji"：使用固定 emoji 模式"kaomoji"：按输入语气选择颜文字
关于连接参数
连接相关配置用于提升 Stream 连接鲁棒性：
- 最大尝试次数
- 指数退避延迟
- 随机抖动
- 发送链路代理绕过