Back to search
dsh-qq-bot-playbook
SkillGitHub
在 DeepSeek Harness 上搭一只像人的 QQ bot——可复用的 skill 与设计笔记
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/rentaoyan0628-collab--dsh-qq-bot-playbook)HTML
<a href="/listings/rentaoyan0628-collab--dsh-qq-bot-playbook"><img src="/api/listings/rentaoyan0628-collab--dsh-qq-bot-playbook/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 333 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # dsh-qq-bot-playbook
- 给 **DeepSeek Harness** 做一个能聊天、能记事、能办事的 QQ 机器人——把踩过的坑写下来,省你几个月。
- 不是框架,不是代码库,是**一整套实践笔记**:能直接用的 skill、要按环境改的 skill、以及「原生没有的能力该怎么设计」的经验篇。
- 最后核对:**2026-11-10**(DSH `0.2.1-rc.5`、Windows 11、SnowLuma v2.1.1)。
- ## SnowLuma 已私密:新安装与老用户迁移请分开看
- **旧视频里的 SnowLuma 仓库目前已转为私密,普通读者无法按原入口下载。新安装可以用 [NapCatQQ](https://github.com/NapNeko/NapCatQQ) 替换网关,后面的 qq-bridge、DSH、白名单、人格卡与记忆配置基本沿用。** 不是换一套 bot 框架,也不用因此重装全部组件。
- | 你属于哪一种 | 专门教程 |
- |---|---|
- | **还没装 / 下载不到 SnowLuma** | **[新安装:用 NapCat 接上 qq-bridge 和 DSH](docs/napcat-new-install.md)**:官方下载安装、HTTP/正向 WS、token、桥接配置与文字验收 |
- | **已经装好 SnowLuma,想换 NapCat** | **[迁移:保留 bridge、人格和记忆,只换网关](docs/napcat-migration.md)**:备份、停旧守护、改端点、核对 worker、分项验收和回滚 |
- 已有 SnowLuma 仍能用时**不必强制迁移**。NapCat 同样提供 OneBot v11,但管理页、配置格式、网关发现/自愈和启动脚本不能直接照搬;媒体与扩展工具须逐项验收。**本次更新是官方资料与静态代码核对后的配置方案,尚未完成 NapCat 端到端实测,不宣称全功能无缝兼容。** 后文保留 SnowLuma 的历史视频与本机实测记录,遇到网关相关步骤以这两篇为准。
- ## 30 秒决定你该读哪份
- | 你现在的情况 | 读这个 |
- |---|---|
- | 想把整套跑起来 | 本文档 → 下面「快速开始」 |
- | 已经装了,卡在某一处 | [AI-INSTALL-AND-TROUBLESHOOT.md](AI-INSTALL-AND-TROUBLESHOOT.md) → 下面「常见故障速查」 |
- | 要按步骤手装 | [docs/setup-manual.md](docs/setup-manual.md) |
- | 想知道「为什么要这么做」 | [playbook/](playbook/) 十篇,每篇都是取舍与坑 |
- | 只要一条命令把停掉的链路拉起来 | [skills-adapt/start-qq](skills-adapt/start-qq/SKILL.md) |
- ## 视频对应哪一个项目?先别装错
- **本视频和本教程走的是 [Derpyu520/qq-bridge](https://github.com/Derpyu520/qq-bridge) 独立桥接路线:**
- ```text
- QQ → SnowLuma(OneBot v11)→ qq-bridge(独立程序)→ DSH
- ```
- 视频里的大肥鱼是在原版 qq-bridge 基础上继续做的本机二次开发;**不是安装原版就自动拥有视频里所有定制功能**。本仓库提供教程、skill 与设计说明,不是完整二开程序的安装包。
- | 容易混淆的项目 | 身份与本教程的关系 |
- |---|---|
- | [Derpyu520/qq-bridge](https://github.com/Derpyu520/qq-bridge) | **本教程采用的桥接原项目;复现本视频请从这里获取桥接代码。** |
- | [DandanLLab/dsh-channel-qq](https://github.com/DandanLLab/dsh-channel-qq) | DSH 内加载的另一条 QQ 通道路线,不是本教程的 qq-bridge。 |
- | [Aegink/dsh-channel-qq](https://github.com/Aegink/dsh-channel-qq) | 源自 Dandan 早期版本的演进项目;截至 2026-10-30,npm 非作用域包 `dsh-channel-qq@0.1.0` 指向此仓库,不是本视频的桥接二开版。 |
- **同用 SnowLuma / OneBot v11,不代表代码同源、安装步骤通用或记忆/权限/工具可自动继承。**“标准插件”只是接入形式,不代表官方身份或质量等级;不要用 Stars、下载量代替兼容性与安全判断。
- - 跟着本视频安装:选择 qq-bridge,不要因为搜索到同名/相似功能,就改装 dsh-channel-qq 或其二开版。
- - 给 AI 安装:明确指定原作者仓库;获取失败先报告,不得静默换成 channel 方案。
- - 已有任意一套在工作:先识别,不卸载、不清空数据、不叠加第二个自动响应入口;如要改路线,说明差异与迁移影响,再由用户决定。
- - 想主动选择 channel 项目当然可以,但那是另一套部署与迁移方案,本教程的 3100 控制台、会话令牌、MCP 及定制记忆不能直接照搬。
- ## 还有第三个同名项目:`dsh-qq-bridge` 插件(DSH 0.2.x 装不上,别记成本教程的账)
- 社区里还有一个名字很像、但**完全不是同一样东西**的项目:[TomoyoNatsume/dsh-qq-bridge](https://github.com/TomoyoNatsume/dsh-qq-bridge)(npm `@yachangchang/dsh-qq-bridge`)。它是「把 OneBot 直接接进 DSH」的**插件**,不是本教程用的独立桥接程序。
- 截至 2026-11-01,本机 DSH `0.2.1-rc.5` 上实测它装不进去,原因是**插件自身**的打包与 DSH 版本对不上:
- - `peerDependencies` 全部锁在 `^0.1.0-rc.8`;
- - 客户端半部声明依赖 `@deepseek-ai/dsh-client-runtime`,并使用客户端服务 `connection` / `remote` / `settingsScope`。这几样在 0.2.1 里都已移除(0.2.1 的客户端服务只有 `layout`、`locale`、`sessions`、`slots`、`theme`、`timer`、`uiWorkspace`、`workspaces`);
- - 它宿主半部用到的那 10 个服务在 0.2.1 里全都在,所以问题出在**插件的客户端装配**,不在 OneBot 协议,也不在 SnowLuma、不在 3001 端口。
- 两层分清就够了:
- | | 本教程的 qq-bridge | dsh-qq-bridge 插件 |
- |---|---|---|
- | 形态 | 独立进程(Derpyu520/qq-bridge) | DSH 插件 |
- | 接入方式 | SnowLuma 的 OneBot v11(3000/3001) | 自己连 OneBot WS(默认 `ws://127.0.0.1:3001`) |
- | 受 DSH 版本影响 | 不受,不经过插件系统 | 受影响,0.2.x 要等作者出兼容版 |
- 所以:**「插件装不上」不等于「本教程的桥装不上」**。本教程这条路是独立进程,DSH 升到 0.2.x 照常跑;两者的失败点不在同一层,别把插件的兼容问题记到这条路线上。
- **网关更新:**旧视频使用 SnowLuma;现在提供 [NapCat 新安装](docs/napcat-new-install.md) 与 [已有安装迁移](docs/napcat-migration.md)。这只替换 OneBot 网关,不改变本教程采用的独立 qq-bridge 路线。
- 确实想走「插件式直连」的话:等作者发布兼容 0.2.x 的版本,或自行去掉它的客户端半部(host-only:删掉 `dsh.client` 与 `peerDependencies`,只用 `cordis.patch.yml` 配置,代价是没有 Web 设置页)。那属于另一个项目的改动,不在本仓库范围内。
- ## 最推荐的用法:把仓库地址直接丢给大肥鱼
- **这就是做这套教程的本意:让 DSH 里的大肥鱼读仓库、按你电脑的实际环境完成安装,不用先学会手动克隆和敲命令。** 手动安装是补充,不是新手必须先过的一关。
- 直接复制给大肥鱼:
- ```text
- 请读取 https://github.com/rentaoyan0628-collab/dsh-qq-bot-playbook
- 先看 README.md 和 AI-INSTALL-AND-TROUBLESHOOT.md,新安装再读 docs/napcat-new-install.md;已有 SnowLuma 要迁移则读 docs/napcat-migration.md。
- 按视频的 qq-bridge 路线,从 https://github.com/Derpyu520/qq-bridge 获取桥接代码;不要自动替换为 dsh-channel-qq 或其二开版。
- 根据我的电脑检查环境、安装并配置 QQ 接入,不要只解释或只读取 skill。
- 保留已有能用的部分,修改前备份;需要我登录或批准权限时再问我。
- 先验证普通文字连续对话,最后说明实际完成和未完成的项目。
- 不要公开密钥,不默认全放行或开启开机自启。
- ```
- **已经安装但卡住了?** 把现象和脱敏报错一起发给大肥鱼,让它参考 [给大肥鱼的安装与排错方法](AI-INSTALL-AND-TROUBLESHOOT.md),先定位、再最小修复,不要直接重装。文档覆盖 B站、抖音评论中的仓库失效、命令、Token、401、不回复、重启、上下文、人格与权限等问题。
- **仓库地址说明:**本次 GitHub 名称调整后新地址未正常生效,当前继续使用上面的旧用户名 `rentaoyan0628-collab` 地址。不要从视频中的新名字猜链接;不承诺固定几个月的等待期,以实际可访问地址为准。
- 本仓库是说明书与 skill 集合,不是全部功能的软件安装包;大肥鱼会据此到原作者仓库获取组件。读取说明不代表安装完成,必须实际执行并测试。
- > ## 先说清楚身份
- >
- > **我不是这些插件的作者。**
- >
- > 我是一个普通用户:自己从零折腾,把用得上的插件、跑得通的流程凑成一套,记下来方便下一个新手。**所有插件、网关、工具的作者都不是我**,我只是把它们串起来了而已。
- >
- > - 装插件请去**原作者仓库**装,别从我这里装——我这里只有文档。
- > - 下面每个项目的作者都列在 [谁写了什么](#谁写了什么) 里;用起来觉得好,请去给原作者点星。
- > - 这套里「我自己写的」只有:流程的组织方式、踩坑记录、以及 `playbook/` 里的设计经验(那些是照着 [qq-bridge](https://github.com/Derpyu520/qq-bridge) 做改造时攒下来的),外加一个独立的 B 站直播插件 `dsh-bili-danmaku-lite`。
- > - 如果哪里署名错了、漏了,请开 issue 指出,我改。
- ---
- ## 谁写了什么
- | 项目 | 作者 / 仓库 | 在本套里干什么 |
- |---|---|---|
- | **NapCatQQ** | [NapNeko/NapCatQQ](https://github.com/NapNeko/NapCatQQ) | 新安装/迁移可选的 OneBot v11 网关(第 1 层,见两篇新教程) |
- | **SnowLuma** | [SnowLuma/SnowLuma](https://github.com/SnowLuma/SnowLuma) | 旧视频使用的 OneBot v11 网关;仓库现已私密 |
- | **qq-bridge** | [Derpyu520/qq-bridge](https://github.com/Derpyu520/qq-bridge) | SnowLuma ↔ DSH 的桥接层(第 2 层) |
- | **鱼的记忆** dsh-fish-memory | [Yuuyuko-uu/dsh-fish-memory](https://github.com/Yuuyuko-uu/dsh-fish-memory) | 会淡忘的长期记忆 |
- | **鱼的心情** dsh-feiyu-mood | [Yuuyuko-uu/dsh-feiyu-mood](https://github.com/Yuuyuko-uu/dsh-feiyu-mood) | 每轮对话后判断情绪 |
- | **dsh-douyin-scroll** | [NEWJO123/dsh-douyin-scroll](https://github.com/NEWJO123/dsh-douyin-scroll) | 刷抖音、出日报 |
- | **dsh-bili-scroll** | [c1overzz/dsh-bili-scroll](https://github.com/c1overzz/dsh-bili-scroll) | 刷 B 站、出日报 |
- | **dsh-whale-widget** | [MeteorNOX/DeepSeek-Balance-Whale-Widget](https://github.com/MeteorNOX/DeepSeek-Balance-Whale-Widget) | 桌面鲸鱼挂件(含那个“咚”的音效) |
- | **dsh-mnemon** | [omdsh-dev/dsh-mnemon](https://github.com/omdsh-dev/dsh-mnemon) | Mnemon 记忆系统(provider / source / strategy 全家桶) |
- | **dsh-ops** | [T-Auto/dsh-ops](https://github.com/T-Auto/dsh-ops) | shell / 文件等运维工具 |
- | **dsh-browser** | [ben7am1n/dsh-browser](https://github.com/ben7am1n/dsh-browser) | 浏览器控制 |
- | **ncmdump** | [taurusxin/ncmdump](https://github.com/taurusxin/ncmdump) | 网易云 .ncm 解密 |
- | **ACE Studio** | Timedomain(商业软件) | 歌声合成(不在本仓库分发,也不建议二次分发) |
- **DeepSeek Harness** 本体由 DeepSeek 提供,本仓库只写“怎么用它”。
- ## 和 QQ 无关的独立插件
- 有几样能力不该长在 QQ 桥接上——比如去 B 站直播间听弹幕、发弹幕。它们不依赖 QQ,风险模型也不一样(往别人房间里说话是“对外发声”,得有自己的放行名单)。所以单独开仓库,本仓库只放链接和设计说明:
- | 插件 | 仓库 | 干什么 |
- |---|---|---|
- | **dsh-bili-danmaku-lite** | [rentaoyan0628-collab/dsh-bili-danmaku-lite](https://github.com/rentaoyan0628-collab/dsh-bili-danmaku-lite) | 只读直播弹幕 / 挂机监听 / 可选自动陪聊 / 可选语音转写;进哪个房间、能不能发弹幕,默认都关着,要人放行。原名叫 `dsh-bili-live`,已改名(旧包 npm 上标了 deprecated) |
- 这是本仓库作者自己写的独立 DSH 插件(不装 QQ 也能用)。为什么分开、边界怎么划,见 [playbook/10-models-and-media.md](playbook/10-models-and-media.md) 第五节。
- ---
- ## 这东西分三层
- | 层 | 目录 | 你能怎么用 |
- |---|---|---|
- | **直接装** | `skills/` | 复制到 `~/.agents/skills/`,重启 DSH,就能用 |
- | **要改写** | `skills-adapt/` | 有参考价值,但里面全是“我这台机器”的路径和流程,得按你的环境改 |
- | **看设计** | `playbook/` | 不是代码,是十个主题的**设计取舍与坑**。交给你的 AI,让它按你的环境实现 |
- ### 技能装到哪里才算数
- 这一条最容易白折腾半小时:**仓库里的 `skills/` 只是给人看的镜像,DSH 不会读它。**
- DSH 真正扫描的是用户目录下的技能目录:
- ```text
- Windows: C:\Users\<你的用户名>\.agents\skills\<技能名>\SKILL.md
- macOS/Linux: ~/.agents/skills/<技能名>/SKILL.md
- ```
- 三个判断依据,缺一个都可能「看起来装了、其实没生效」:
- | 对不对得上 | 怎么查 |
- |---|---|
- | 位置对 | 必须落在 `~/.agents/skills/` 下。放进工作区、放进仓库目录、放进 `skills-adapt/`,都不算 |
- | 形状对 | 一个技能一个子目录,里面是 `SKILL.md`,开头 frontmatter 要有 `name` 和 `description` |
- | 加载对 | 新开一个会话,看技能清单里出不出现这个名字;出现才算真装上 |
- 补充两点实测经验:DSH 会热加载,拷进去常常不用重启就出现了;但重启一次最稳,遇到「清单里没有」先重启再判断。另外,仓库里的 `skills/` 和 `.agents\skills\` 里内容一样时,生效的永远是后者——改仓库不会影响已装好的那份,反之亦然。
- ### `skills-adapt/` 里的不能直接拷
- 那几份里面写着 `<你的用户目录>`、`<端口>` 这类占位符。**原样拷进 `~/.agents/skills/` 不会报错,但一触发就指向不存在的路径**——名字对了、内容全是别人机器的地址,排查起来很费时间。
- 正确顺序是:先全局替换占位符(用户目录、盘符、端口、进程名),再按你的实际部署改脚本路径,最后拷进去、重启、试一次。改完的那份建议留在你自己的目录里,不要回填到仓库。
- ### 装之前:拓展插件要先问主人
- 这个仓库里能被“装上”的东西,大多不是 DSH 原生功能,而是**拓展插件**(心情、记忆、Mnemon、刷视频、直播……)。它们会读聊天、写本机文件、常驻进程,有的还会每轮调用模型花钱。
- 所以有一条硬规矩,也是让别人的大肥鱼照做时最容易漏的一条:
- > **装任何拓展插件之前,先跟主人说清楚「装什么、碰什么数据、要什么权限、代价多少、怎么卸」,等主人明确同意再装。没同意就不装,也不要「先装上再问」。**
- 可以直接把这段话发给它,让它照着向你汇报:
- ```text
- 我想装一个拓展插件,先说清楚再动手,你同意我再装:
- · 装什么:<插件名>,作者 <作者>,仓库 <地址>
- · 补什么:<一句话>
- · 它碰什么:会读 <哪些对话>,写到 <本机哪个文件/数据库>,<要不要联网/账号>
- · 代价:<磁盘>,<是否常驻>,<是否每轮调用模型(花 token)>
- · 怎么卸:<开关> + <命令>,卸掉后已有数据 <保留/删除>
- 你同意我就装,装完告诉你装到哪、怎么验证;不同意我不动。
- ```
- 哪些必须先问、哪些不用,[playbook/09-memory-sharing.md](playbook/09-memory-sharing.md) 里有张表(读文档不用问;装插件、开自动记住、导入或清空记忆,必须问)。
- **重要**:`playbook/` 里的东西,照抄路径一定失败。正确的用法是——读完设计,把它当成需求文档发给你的 AI,让它在你机器上重做一遍。做出来和我不一样,是正常的。
- ---
- ## 快速开始
- ### 路径 0:已经在跑,只是停了
- 如果已换 NapCat,先按 [迁移篇](docs/napcat-migration.md) 适配守护;不要直接执行会硬编码重拉 SnowLuma 的旧启动脚本。
- 用 `skills-adapt/start-qq`:一条命令把整条链路拉回来,然后只看三个端口(3000 / 3001 / 3100)。语音(9881)预热要一分多钟,**不算验收项**——等它等于白等。
- ### 路径 A:让它先在 QQ 里说话
- 1. [NapCat 新安装教程](docs/napcat-new-install.md) —— 新用户用 NapCat 配 OneBot HTTP/正向 WS;旧的 `skills/snowluma-qq-setup` 留作历史安装参考
- 2. `skills/qq-bridge-setup` —— 装桥接,把它接到 DSH 上(最小可用版)
- - 想直接要完整版(语音转文字、传话箱、管理员硬闸、跨会话摘要、成长附录、3100 控制台):读 `skills/qq-bridge-full`,两版共用同一套代码,区别在装完开了哪些功能
- 3. 按 [文字验收步骤](docs/napcat-new-install.md#5-分层验收http-通不等于能聊天) 核对账号、入站/出站、至少两轮问答、无重复回复与白名单权限;没测的功能标为未验
- 桥接这一层不是装饰:本包只覆盖这条路(不做直连),后面几步——记忆、情绪、六项能力——全部长在它上面。
- ### 路径 B:想让它像个人(加记忆、情绪、日常)
- 在上面基础上:
- - `skills/dsh-plugin-suite` —— 插件清单与配置
- - `skills/fish-plugins-setup` —— 心情 + 会淡忘的记忆
- - `skills/douyin-scroll-setup` —— 让它有自己的信息源(刷抖音出日报)
- ### 路径 C:想让它能办事、还不闯祸
- 这才是 `playbook/` 的用武之地。前六节是能力:语音转文字、传话箱、管理员硬闸、跨会话摘要、成长附录、网页控制台。第七、八节是**真跑起来之后才暴露的问题**:经历库(记得住人、说得清事)和运营层(少说话、省钱、换班不失忆)。第九、十节是再往后一层:共享记忆(群 / 私聊 / 换模型之后还是同一个人)和边界问题(换模型、发图、发文件、限流、只给某一路加温度)。
- | 文件 | 讲什么 |
- |---|---|
- | `playbook/06-custom-features.md` | 六个「原生没有」的能力:语音转文字、传话箱、管理员硬闸、跨会话摘要、成长附录、网页控制台 |
- | `playbook/07-experience-archive.md` | 经历库:两层数据(原文 + 经历)、两种出口(摘要可对外 / 原文只给本人)、为什么不做成插件 |
- | `playbook/08-operations-layer.md` | 运营层:只允许被 @、峰价时段睡觉、换班交接 + 原文落盘、看门狗提速(含「守护项要覆盖静默失效的组件」) |
- | `playbook/09-memory-sharing.md` | 共享记忆:热记忆 / 记忆空间 / 原文层三层怎么分,跨会话三个共享物,换模型为什么不丢记忆,交接摘要的三个坑 |
- | `playbook/10-models-and-media.md` | 边界:模型预设与按会话分流、本地调参代理(只给 QQ 加温度)、发图「超时≠失败」、发文件的白名单与路径校验、三个频率闸 |
- 建议顺序:**先做语音转文字(见效最快)→ 再做网页控制台(不然排障靠猜)→ 然后传话箱 + 硬闸(一起做,安全模型是配套的)→ 摘要和成长附录(“人格”层面,可以慢慢调)→ 共享记忆(等它开始在不同会话里“像两个人”了再做)→ 模型与媒体边界(等真的换了模型或发过文件踩过坑再读)**。
- ---
- ## `skills/` 里有什么
- | skill | 干什么 | 通用度 | 基于谁 |
- |---|---|---|---|
- | `snowluma-qq-setup` | 从零装 SnowLuma 并接上 QQ,得到 OneBot v11 接口 | ⭐⭐⭐ 通用 | SnowLuma |
- | `qq-bridge-setup` | 在 SnowLuma 和 DSH 之间装桥接层,让 QQ 真正跟 DSH 对话(最小可用:只求能聊) | ⭐⭐⭐ 通用 | qq-bridge |
- | `qq-bridge-full` | 完整版桥接:语音转文字、管理员传话箱、管理员硬闸、跨会话摘要、成长附录、3100 网页控制台六项能力的定位与测试方法 | ⭐⭐ 通用(六项按需开) | qq-bridge |
- | `dsh-plugin-suite` | 一套让 bot “像个人”的 DSH 插件组合:每个干什么、怎么配、哪些能省 | ⭐⭐⭐ 通用 | 多个插件 |
- | `fish-plugins-setup` | 「鱼的心情」(情绪)+「鱼的记忆」(会淡忘的长期记忆) | ⭐⭐⭐ 通用 | Yuuyuko-uu |
- | `douyin-scroll-setup` | 抖音刷视频插件:装依赖、登录、跑第一轮、出日报 | ⭐⭐ 通用 | NEWJO123 |
- > ⚠️ **`qq-bridge-setup` 和 `qq-bridge-full` 是同一套程序的两份说明,可按需阅读,不是两个插件。** 复制两份 skill 本身不会启动两个 bridge;真正要避免的是重复部署/启动第二套 bridge 和 worker。已有可用部署请保留并按需配置,不为切换说明而卸载重装。
- ## `skills-adapt/` 里有什么
- | skill | 干什么 | 要改什么 |
- |---|---|---|
- | `start-qq` | 一键启动/自检整条链路:SnowLuma(3000/3001,WebUI 5099)、桥接 3100、GPT-SoVITS(**9881**)、点歌 worker、传话箱 watcher、上下文守卫、抖音私信值班、本地调参代理 8787 | 全部路径、端口、进程名;验收只等 3000/3001/3100 |
- | `bili-live-hangout` | 去 B 站直播间挂着陪聊(插件已把收弹幕 + 判断 + 发弹幕全包了):找房间、10 位房间号怎么解析、放行名单、自动陪聊参数、叫醒通道 | 房间号规则、插件家目录、webhook 地址 |
- | `qq-admin-relay` | 管理员把本机任务转交给 DSH;代发私信给指定好友 | 白名单、工具名 |
- | `qq-private-on-demand-share` | 跨会话口风纪律:自己人之间记得住,引用必须带名字,不主动播报 | 框架通用,具体规则按你的信任模型改 |
- 这几份不含别人的代码,是我自己攒的实践;但里面的行为规范依赖上面那些插件,缺了它们用不了。
- > ⚠️ **别直接拷进 `~/.agents/skills/`。** 里面是 `<你的用户目录>` 这类占位符,原样装进去不会报错,但一触发就是「找不到文件」。先把占位符和端口/进程名替换成你自己的,再装。
- ---
- ## 常见故障速查
- 这些都是**真跑起来之后**踩出来的,细节在各 skill 与 `playbook/` 里:
- | 症状 | 真因 | 看哪里 |
- |---|---|---|
- | 启动脚本返回成功,进程十几秒后没了 | WMI 拉起的常驻进程会被静默回收 | `skills-adapt/start-qq`「启动期三个真实的坑」 |
- | 隐藏启动重启桥接,卡住不动 | `restart.bat` 里有 `pause` | 同上:杀 bridge + 删 `bridge.lock` + 起 `start.bat` |
- | SnowLuma 起来了但 3000/3001 一直不通 | 端口要等 hook 注入后约 90 秒 | 同上「等待并验证」 |
- | 直播间收得到弹幕,一条也发不出去 | 10 位房间号被当成 UID | `skills-adapt/bili-live-hangout` 第 0 节 |
- | 放行过的房间又要重新放行 | `until_offline` 条目在未开播时被自动删 | 同上第 1 节 |
- | 自动陪聊静默几十分钟、日志停更但进程还在 | 模型请求没超时,`busy` 永久为 true | 同上第 6 节 |
- | 直播有人说话却叫不醒 QQ 会话,报 401 | `/api/socialV2/wake` 走控制台鉴权 | 同上第 5 节:`x-live-wake: 1` 专用头 |
- | 换了 provider 后切不过去,报 `does not support reasoning effort` | 自定义模型要写 `reasoningEfforts` map,写数组无效 | `playbook/10`「只给某一路加温度」 |
- | 主会话突然变“油”,语气不对 | 调参代理全文匹配,把工作会话也注入了温度 | 同上:判据只看最后一条 user 消息 |
- | 插件改了配置没反应 | 多数插件只在启动读一次配置,不热加载 | 改完重启 DSH |
- ---
- ## 依赖
- - **Windows**(SnowLuma 的 QQ 注入只支持 Windows;Linux/macOS 只能跑不注入的模式)
- - 官方 **NTQQ** 客户端(不是 TIM,不是各种魔改版)
- - **Node.js ≥ 22.13**
- - **DeepSeek Harness ≥ 0.1.7-rc.1**(本仓库在 `0.2.1-rc.5` 上核对;上游目前只有 rc/alpha,升级前先备份 `cordis.patch.yml`)
- - 可选:Python 3.10+(只做语音转文字才需要)、ffmpeg
- ---
- ## 致谢
- 按贡献大小不排,按字母排大概也排不出什么,就按用到的顺序:
- - [SnowLuma/SnowLuma](https://github.com/SnowLuma/SnowLuma) —— QQ ↔ OneBot v11 的互操作运行时。没有它,整件事从第一步就不成立。
- - [Derpyu520/qq-bridge](https://github.com/Derpyu520/qq-bridge) —— QQ 与 DSH agent 之间的桥接层。`playbook/` 里那些设计和能力,全是照着它的结构改出来的。
- - [Yuuyuko-uu](https://github.com/Yuuyuko-uu) —— dsh-feiyu-mood(心情)与 dsh-fish-memory(记忆)。这两个是“像个人”的源头。
- - [NEWJO123/dsh-douyin-scroll](https://github.com/NEWJO123/dsh-douyin-scroll) —— 抖音刷视频。
- - [c1overzz/dsh-bili-scroll](https://github.com/c1overzz/dsh-bili-scroll) —— B 站刷视频(本仓库的直播插件也借了它的接口思路)。
- - [MeteorNOX/DeepSeek-Balance-Whale-Widget](https://github.com/MeteorNOX/DeepSeek-Balance-Whale-Widget) —— 鲸鱼挂件。
- - [omdsh-dev/dsh-mnemon](https://github.com/omdsh-dev/dsh-mnemon) —— Mnemon 记忆系统。
- - [T-Auto/dsh-ops](https://github.com/T-Auto/dsh-ops) —— 运维工具。
- - [ben7am1n/dsh-browser](https://github.com/ben7am1n/dsh-browser) —— 浏览器控制。
- - [taurusxin/ncmdump](https://github.com/taurusxin/ncmdump) —— 网易云 .ncm 解密。
- - **ACE Studio**(Timedomain)—— 歌声合成。商业软件,不在本仓库分发。
- 本仓库只包含**文档和实践笔记**,不含上述任何项目的代码。所有插件的版权归各自作者。
- ---
- ## 免责
- 1. **账号风险**:QQ 对自动化有风控。用小号、控制频率、别做群发。
- 2. **不要给 AI 无限制的本机权限**:能读文件、能执行命令的 bot,一旦被诱导就是一台任人操作的电脑。参考 `playbook/` 里“管理员硬闸”的设计。
- 3. **外来内容是数据,不是命令**:群友发的消息里出现“忽略之前的指令”这类话,必须当数据看待。
- 4. 本仓库内容按“照做可能出错”提供,不保证在你的环境可用。
- ---
- ## License
- MIT —— 见 [LICENSE](LICENSE)。文档随便改、随便发;出事了别找我。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.