wzwei1990/dsh-napcat ↗★ 0

dsh-napcat

通过 NapCat/OneBot 11 将应用接入 QQ 机器人 适合想将 AI 接入 QQ 群或私聊、实现智能客服或群聊助手的用户。

套件
dsh-napcat
相容性
待驗證
Harness 依賴範圍
>=0.2.1-0 <0.3.0-0
Cordis 依賴範圍
^4.0.2
版本
0.1.0
授權
MIT
最近更新
2026年10月20日

安裝

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:wzwei1990/dsh-napcat

3. 配置

Web UI 设置页里改(推荐),或者给 profile 的 cordis.patch.yml 里 dsh-napcat 行加 config: 覆盖:

- insert:
  - id: dsh-napcat
    name: 'dsh-napcat'
    config:
      mode: forward
      url: 'ws://81.70.163.182:3001'
      accessToken: '你的 token'
      adminUsers: ['你的QQ号']
      groupPolicy: allowlist
      groupAllowFrom: ['你的群号']

最少要配三样:mode+url(或 reverse 的 port)、accessToken、adminUsers(否则私聊没人能触发)。

配置项

键默认说明
modeforwardforward=连 NapCat;reverse=监听等 NapCat 拨入
urlws://127.0.0.1:3001forward 目标(NapCat 在云上就写云的公网 IP)
accessToken空OneBot token;forward 作为 Bearer 发出,reverse 校验来者
host / port127.0.0.1 / 8643reverse 监听;NapCat 在别的机器上必须 host: 0.0.0.0
botQQ空机器人自己的 QQ;留空自动学习(影响 @ 门控)
adminUsers[]管理员 QQ
dmPolicyadmin私聊:admin 仅管理员 / open 任何人 / disabled
allowFrom[]dmPolicy=open 时的额外白名单(空=不限)
groupPolicyallowlist群聊:open / allowlist / disabled
groupAllowFrom[]白名单群号
requireMentiontrue群聊必须 @机器人(或回复它上一条消息)
ignoreSelftrue忽略机器人自己的消息
replyAsQuotefalse回复时引用原消息
splitMaxChars1200单条消息最大字数,超出自动分段;0=不分段
reconnectMaxAttempts50forward 连续失败多少次后放弃;0=无限
workspacePath空QQ 会话挂载的工作区;空=宿主 cwd
agentPreset空挂载的 agent preset
provider / model空覆盖模型(空=宿主默认)
logLevelinfodebug / info / warn