配置与运行
- NapCat 添加反向 WebSocket 客户端：
在 NapCat WebUI（默认
http://127.0.0.1:6099/webui）的网络配置中新增反向 WebSocket 客户端：
- URL：
ws://127.0.0.1:8080/（需与插件 ws_port 对齐）
- Token：与插件
ws_token 保持一致（若留空则此处留空）
- 心跳周期：
30000 ms，重连间隔：3000 ms
- 启动 DSH：
dsh --profile web
- DSH WebUI 配置核心参数：
访问 DSH Web UI（默认
http://127.0.0.1:3080/），进入 dsh-napcat-bridge 设置卡片：
bot_qq（必填项）：填写机器人的 QQ 号，用于过滤自身消息防死循环，并作为群聊识别 @机器人的基准。admins：填写管理员 QQ 号，授权执行斜杠命令。- 其他可选参数（人设、主动回复、记忆预算、表情包开关等）按需调整，保存即时热更新生效。
⚙️ 运行时配置 (30 项)
配置卡片在 WebUI 中分为 6 个 Tab：
1. 连接身份 (Connection)
| 参数 | 类型 | 默认值 | 说明 |
|---|
ws_port | number | 8080 | WebSocket 监听端口（NapCat 连接目标，变更时服务热重启） |
ws_token | string | "" | 连接鉴权 Token（留空不鉴权） |
bot_qq | string | "" | 机器人自身 QQ 号（核心必填项，自循环防护与识别锚点） |
admins | string[] | [] | 管理员 QQ 号白名单（斜杠命令授权） |
aliases | string[] | [] | 助手点名别名（群聊点名唤醒） |
image_ttl_days | number | 7 | 外来图片与多媒体缓存本地保留天数（过期定时清理） |
2. 人格与准则 (Persona & Behavior)
| 参数 | 类型 | 默认值 | 说明 |
|---|
persona | string | (内置) | 助手的人格设定（注入 System Prompt 动态段） |
behavior | string | (内置) | 行为约束准则（注入 System Prompt 动态段） |
3. 回复配置 (Proactive)
| 参数 | 类型 | 默认值 | 说明 |
|---|
proactive_reply_enabled | boolean | false | 启用群聊主动回复功能总开关 |
proactive_interval_mins | number | 3 | 主动回复轮询窗口期（分钟，期间有新消息才唤醒） |
proactive_buffer_size | number | 10 | 主动回复滑动窗口消息保留条数 |
proactive_random_enabled | boolean | false | 启用群聊普通消息随机概率唤醒 |
proactive_random_probability | number | 0.05 | 普通消息随机唤醒概率（0~1，0.05 即 5%） |
proactive_cooldown_mins | number | 10 | 主动回复冷却时间（分钟，防止频繁插话） |
proactive_only_text | boolean | false | 仅回复纯文本内容（多模态媒体消息不主动触发） |
proactive_idle_enabled | boolean | false | 启用潜水超时主动唤醒（冷场破冰冒泡） |
proactive_idle_timeout_mins | number | 120 | 潜水超时阈值（分钟） |
proactive_night_dnd | boolean | true | 夜间免打扰 (每日 23:00~08:00 暂停主动回复) |
4. 记忆 (Memory)
| 参数 | 类型 | 默认值 | 说明 |
|---|
memory_storage_dir | string | ".dsh/napcat/napcat_memory" | 记忆 Markdown 文件根存储目录 |
user_profile_budget_chars | number | 2200 | 单个用户画像文件的写入上限（跨群聊/私聊通用） |
session_memory_budget_chars | number | 2200 | 单个 Session 规则文件的写入上限（群聊/私聊统一） |
group_memory_total_budget_chars | number | 8000 | 群聊注入时所有活跃群友画像合计的字符预算；Session 规则不计入 |
5. 表情包 (Face)
| 参数 | 类型 | 默认值 | 说明 |
|---|
face_enabled | boolean | false | 控制新建会话是否在预设中装载表情包工具集（保存对后续新会话生效） |
face_store_max | number | 100 | 本地表情库存储容量上限（张） |
face_store_dir | string | ".dsh/napcat/faces" | 本地表情库文件存储目录 |
face_sub_type | number | 1 | OneBot 11 发送表情使用的 sub_type 字段值 |
face_evict_policy | string | "evict_lru" | 库容满额淘汰策略 (reject 拒绝 / evict_lru 淘汰最久未用) |
6. 黑话学习 (Slang)
| 参数 | 类型 | 默认值 | 说明 |
|---|
slang_enabled | boolean | true | 控制新建会话是否装载黑话工具集与注入黑话上下文（保存对后续新会话生效） |
slang_budget_chars | number | 5000 | 黑话知识库字符预算上限 |
slang_storage_path | string | ".dsh/napcat/slang/slang.md" | 黑话 Markdown 文档保存路径 |
配置下线说明：群聊强制引用/艾特死配置（group_reply_quote、group_reply_at）及空回复行为面板已下线。出站回复遵循「用户侧静默原则」，是否引用与艾特统一由大模型通过 send_qq_message 工具参数（reply_to、at_user）自主决策。独立后台 Agent 参数也已清退下线。
3. 回复配置 (Proactive)
| 参数 | 类型 | 默认值 | 说明 |
|---|
proactive_reply_enabled | boolean | false | 启用群聊主动回复功能总开关 |
proactive_interval_mins | number | 3 | 主动回复轮询窗口期（分钟，期间有新消息才唤醒） |
proactive_buffer_size | number | 10 | 主动回复滑动窗口消息保留条数 |
proactive_random_enabled | boolean | false | 启用群聊普通消息随机概率唤醒 |
proactive_random_probability | number | 0.05 | 普通消息随机唤醒概率（0~1，0.05 即 5%） |
proactive_cooldown_mins | number | 10 | 主动回复冷却时间（分钟，防止频繁插话） |
proactive_only_text | boolean | false | 仅回复纯文本内容（多模态媒体消息不主动触发） |
proactive_idle_enabled | boolean | false | 启用潜水超时主动唤醒（冷场破冰冒泡） |
proactive_idle_timeout_mins | number | 120 | 潜水超时阈值（分钟） |
proactive_night_dnd | boolean | true | 夜间免打扰 (每日 23:00~08:00 暂停主动回复) |