配置

完整配置项见 src/index.ts 的 Config schema（schemastery 校验，均有默认值）。常用：

键	默认	说明
`mode`	`reverse`	`reverse`/`forward`
`host` / `port`	`127.0.0.1` / `8643`	reverse 监听；跨机部署（NapCat 从其他机器拨入）需显式改为 `0.0.0.0`
`url`	`ws://127.0.0.1:3001`	forward 目标
`reconnectMaxAttempts`	`100`	自动重连放弃上限：连续失败达到该次数后停止重连，日志输出上限值与恢复指引；`0` = 无限重连（退避封顶 60s）
`accessToken`	空	OneBot token；reverse 模式必填，留空插件拒绝启动（fail-closed）；forward 可为空
`botQQ`	空	机器人 QQ（空=自动学习）
`ignoreSelf`	`true`	忽略机器人自己发出的消息（防自循环）
`requireMention`	`true`	群聊需 @ 或回复机器人的消息才响应（回复他人消息不触发；被回复消息无法判定时回落视为提及，fail-open）
`rateLimitPerMinute`	`30`	每会话每分钟普通消息上限（60s 滑动窗口）：超限跳过处理并限流提示（每窗口至多一条），命令不受限；`0` = 禁用
`dedupWindowSeconds`	`300`	入站消息去重窗口（秒，W2-②）：同一会话内相同 message_id 在该窗口内重投（断线重连重放等）只处理第一条，后续静默跳过并记 debug；仅对会触发回复处理的消息事件生效（notice/meta 类不经过此闸）；`0` = 禁用去重
`actionRatePerMinute`	`20`	主动写操作每分钟全桥合计上限（W2-③）：约束 qq_send_image/voice/video/file/segments 与 qq_send_forward 等工具发起的主动发送（回合内的被动回复/interim/通知不受此闸，由 rateLimitPerMinute 与离线队列上限约束）；超限拒发并记 warn 与审计；`0` = 禁用分钟限额
`actionRatePerDay`	`500`	主动写操作每日（本地自然日）全桥合计上限（W2-③）：口径同 `actionRatePerMinute`；超限拒发并记 warn 与审计，次日自动恢复；`0` = 禁用日限额
`actionAuditEnabled`	`true`	主动写审计（W2-③）：每次主动写（成功/失败）与拒发事件追加写一行 JSON 到 `mediaDir/qq-actions.log`（含 ts/chatId/action/ok/reason）；写失败仅 warn 不影响发送
`traceEnabled`	`false`	链路追踪（W1）：为每条入站消息生成 traceId 并贯穿入站→模型回合→出站，决策事件（含限流/去重/白名单/@ 门控/闸门拒发与每个静默丢弃分支的中文 reason）逐行 JSON 落盘 `mediaDir/qq-trace.jsonl`（4MiB 改名轮转，保留 `qq-trace.1/2.jsonl`；同一原因 5 分钟限频；异步队列写不阻塞管线）；默认关闭——关闭时不生成 traceId、不落盘、决策行为与 0.6.0 完全一致
`traceLevel`	`debug`	追踪事件级别（W1）：`debug` 记录全部决策事件；`warn` 仅记录 ok:false（被拒/失败/丢弃）事件
`logLevel`	`info`	控制台日志级别门槛（debug 该值渲染为文字图卡片。渲染失败、PNG 超 `outboundImageMaxBytes` 或 `/media/onebot`
`tempTtlHours`	`6`	入站临时媒体文件保留时长（小时），到期自动清理
`inboundImageMaxPx`	`2048`	入站图片长边上限（px）：超过则等比压缩后交给视觉模型（透明 PNG 保留、GIF 不压）；`⚠️ BREAKING（M0 安全加固）：reverse 模式下`accessToken `留空会拒绝启动（fail-closed）；`host`默认从`0.0.0.0`改为`127.0.0.1`（仅本机监听），跨机部署需显式配置` host: 0.0.0.0`。

环境变量：ONEBOT_ALLOWED_USERS（逗号分隔管理员）、ONEBOT_ALLOW_ALL_USERS=true（开发用）。

dsh-onebot-paopao

安裝

說明文件

配置