TomoyoNatsume/dsh-qq-bridge

README 摘要

dsh-qq-bridge 从 clone 到 QQ 遥控 DSH 的最短流程。目标是: 推荐先用 一个 QQ 号 登录 NapCat，然后从手机 QQ 给“我的电脑”或自己发送 /dsh ... 。这样不需要准备机器人小号和主号两个账号。 项目背景和架构说明见 docs/project-overview.md 。 0. 准备 - Node.js 20+ 和 npm。 - 一个 QQ 号，用手机扫码登录 NapCat。 - 已安装好的 DSH / DeepSeek Harness，且知道它的项目目录。 - DeepSeek API Key 已按 DSH 自身方式配置好。 您可以将本项目（本文件）交给agent，让Ta帮您完成大部分配置工作。您只需完成扫码登陆QQ、配置Napcat WebUI等工作，根据您的agent引导即可。 1. clone 并构建插件 2. 安装并登录 NapCat Linux / WSL2 推荐: 启动并查看登录日志: 用手机 QQ 扫日志里的二维码完成登录。 注意:不要运行 nc 。在 Debian / Ubuntu 上， nc 通常是 OpenBSD netcat，不是 NapCat。 3. 进入 NapCat WebUI WebUI 默认地址通常是: 如果打不开，以 NapCat 日志里打印的地址为准: 日志里一般会出现类似: 这里的 token 是 WebUI 登录 token ，只用于打开 WebUI，不是后面插件用的 OneBot token。 4. 开启 OneBot 正向 WebSocket 在 NapCat WebUI 里开启: 保存后保持 NapCat 运行。 5. 配置 DSH web profile 把插件写入 DSH 的 web profile。默认配置文件是: 如果这个文件目前只有 [] ，可以替换成下面内容；如果已经有别的配置，就把 insert 这一段合并进去: 需要改的地方: - name :改成你 clone 后的真实插件入口路径，例如 /home/me/dsh-qq-bridge/dist/index.js 。 - adminQq :填你的 QQ 号。 - logPath :填你的 NapCat 日志路径。 - model :按你的 DSH 模型配置调整。 如果你不用“我的电脑/自己给自己发消息”，而是主号发给机器人小号，可以删除 selfLogInput 这一段，并把 adminQq 填主号 QQ。 6. 启动 DSH 需要重启DSH服务。 切到 DSH / DeepSeek Harness 项目目录执行: DSH QQ TOKEN 填 WebUI 里正向 WebSocket 的 access token，不是 WebUI 登录链接里的 token。 DSH PERMISSION MODE=da…

分类