dsh-qq-moony 0.0.0-stage → 0.4.0

package/CHANGELOG.md

@@ -0,0 +1,47 @@
+# CHANGELOG
+
+## 0.4.0 — 2026-10-25
+
+群聊从"只回 @"变成"会参与聊天"。
+
+**新增**
+- 群聊「参与聊天」：每群记最近 30 条现场，隔 8–20 分钟给一次插话机会；冷场 5 分钟不开口
+- 群聊拆成两个开关：接消息（只回 @）/ 参与聊天（会自己插话）
+- 群聊参数全部可在设置页调：窗口条数、机会间隔、冷场窗口、同群冷却、日额、群号白名单
+- 设置页对「参与聊天」标注 token 成本警告
+- README 增加「群聊的额外一条」：放进熟人群之前的判断
+
+**修复**
+- 群聊白名单为空时不再误判为"已开启"
+
+## 0.3.0 — 2026-10-25
+
+这一版把"能发能收"变成"能自己活着"。
+
+**新增**
+- 收消息自检：90 秒没有任何帧（NapCat 每 30 秒心跳）就主动重连；连接/断开/触发都写日志
+- 群聊接话（默认关）：白名单 + 只接被 @ 的 + 同群冷却 10 分钟 + 全群日额 20
+- 主动说话：随机间隔（区间内抽），到点给它一次"想说就说"的机会
+- QQ 空间自动发说说：开关 + 自由提示词 + 随机间隔
+- 打开 DSH 自动拉起 NapCat（`-q` 快速登录，免扫码）
+- 设置页：连接状态、四个开关、间隔与额度、空间提示词，带「保存更改」
+
+**修复**
+- 配置文件带 BOM 时整份配置被忽略（读取时剥 BOM，写入改用无 BOM）
+- webServer 未就绪导致接口挂不上（改 `ctx.inject` 等它出现）
+- 15 秒轮询会覆盖正在输入的数字（改草稿态 + 显式保存）
+- 图片消息先只记 `[image]`，现在会下载到本地并记路径
+
+## 0.2.0 — 2026-10-25
+
+- `qq_send` 支持图片（`file:///` + 正斜杠）
+- `qq_stickers` 列出攒下来的图
+- 收消息内置 WebSocket，不再需要外部监听脚本
+- 自动回复改走 `sessionController.prompt`（不再用 agent 内部方法）
+- 自动回复附记忆片段（MEMORY.md 末尾 + 当天日记）
+
+## 0.1.0 — 2026-10-25
+
+- 第一个能跑起来的版本：`qq_status` / `qq_send` / `qq_read` / `qq_qzone`
+- 限速防封（随机 2–7 秒、20/时、60/天）
+- 配置走 `<DSH_HOME>/qq-moony/config.json`

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Seventy-JJ
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,210 @@
-# Temporary Holding Version
+# dsh-qq-moony
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+把 QQ 小号接进 DeepSeek Harness。
+
+装完之后，Harness 里的 Agent 就有了第二个出口：发消息、收消息、发表情包、发 QQ 空间说说，还能自己主动找人。**它只当手，不当腿**——QQ 客户端和 NapCat 得你自己先备好。
+
+```bash
+dsh plugin add dsh-qq-moony
+```
+
+当前版本：**0.3.0**。
+
+---
+
+## 一、它能干什么
+
+| 工具 | 干什么 |
+|---|---|
+| `qq_status` | 小号在不在线、登录的是谁、今天发了多少、还剩多少额度 |
+| `qq_send` | 发消息。私聊写 QQ 号，群聊写 `group:群号`；`image` 可以只发图或图文一起 |
+| `qq_read` | 读最近收到的消息 |
+| `qq_stickers` | 列出攒下来的图（别人发来的表情包都自动存本地） |
+| `qq_qzone` | 发一条 QQ 空间说说 |
+
+除工具之外，还有几件自动的事：
+
+**收消息不用外部脚本。** 插件启动时自己连 NapCat 的 WebSocket（默认 `ws://127.0.0.1:3001`），收到的消息进内存缓冲并写盘。
+
+**断线自检。** NapCat 每 30 秒发一次心跳；超过 90 秒没有任何帧，插件主动断开重连。连接、断开、自检触发都写进日志——不会再出现"线断了没人知道"。
+
+**图片会真的取下来。** 别人发图，下载到 `<DSH_HOME>/qq-moony/media/`，记录里留本地路径，Agent 可以直接打开看。
+
+**自动回复（可选）。** 收到私聊，随机等 2–7 秒，把来信投进一个专用会话，那边的 Agent 用 `qq_send` 回过去。投递时自动附一段记忆（`memory/MEMORY.md` 末尾 + 当天日记，约 2000 字）。
+
+**主动说话（可选）。** 每隔一段随机时间，给它一次"想说什么就说，也可以不说"的机会。
+
+**QQ 空间自动发说说（可选）。** 你写一段要求（内容、语气、频率都行），到点把这段原话交给它判断发不发。
+
+**群聊（可选，两个开关分开）。**
+- *接消息*：白名单里的群，被 @ 才应。
+- *参与聊天*：每群记着最近三十条，隔 8–20 分钟给一次"要不要插一句"的机会，把这现场交给它判断，接不住就什么都不发。冷场（五分钟没人说话）不开口；同群冷却十分钟；群里一天最多二十条。
+
+**打开 DSH 就自带 NapCat。** 启动时探一下 3000 端口，没通就用 `-q` 快速登录把 NapCat 拉起来——免扫码，几秒上线。
+
+---
+
+## 二、装之前必须先有
+
+1. **QQ NT**（9.9.x）。老版 QQ 9.7 注不进去，这是死条件。
+2. **[NapCat](https://github.com/NapNeko/NapCatQQ)** Shell 版。Windows 上用 `launcher-user.bat` 启动。
+3. **OneBot 服务开着**：HTTP 默认 `http://127.0.0.1:3000`，WebSocket 默认 `ws://127.0.0.1:3001`，两处都要设 token。
+
+### ⚠️ 一定要用小号
+
+**不要拿常用号、更不要拿主号。**
+
+NapCat 是接管整个 QQ 客户端的行为——消息收发、登录态、空间说说，全都在它的手里。QQ 那边对"非官方客户端"的判定不透明，封号也不讲道理。用主号意味着：**你的好友、群、聊天记录、空间，一起陪绑。**
+
+小号出事的代价是"再注册一个"，主号出事的代价是你没法估。
+
+另外：小号也别绑钱包、别实名做要紧的事、别进你非去不可的群。
+
+---
+
+## 三、设置页（名字叫「QQ嗦嗨嗨」）
+
+装完重启 DSH，设置里会多一项 **QQ嗦嗨嗨**：
+
+- **连接状态**：在线没有、登录的是谁、今天发了多少、上限多少
+- **主动说话**：开关（点一下即时保存）
+- **自动回复**：开关
+- **主动间隔**：最短 / 最长（分钟），每次从区间里随机抽
+- **每小时上限 / 每天上限**：数字，1–200 / 1–1000
+- **群聊**：两个开关（接消息 / 参与聊天）+ 群号白名单 + 六个可调的数
+- **QQ 空间自动发说说**：开关 + 一段提示词 + 随机间隔
+
+开关即时生效；数字和提示词走草稿，改完点右下角**保存更改**。
+
+⚠️ **群聊"参与聊天"很费 token**：每给一次机会都等于跑一整轮会话，哪怕它最后决定不说话。间隔别设太短。
+
+---
+
+## 四、配置
+
+优先级：**本地配置文件 > bundle patch 里的 config > 代码默认值**。
+
+```
+<DSH_HOME>/qq-moony/config.json
+```
+
+```json
+{
+  "baseUrl": "http://127.0.0.1:3000",
+  "token": "你的 OneBot token",
+  "uin": 123456789,
+
+  "wsUrl": "ws://127.0.0.1:3001",
+  "listen": true,
+  "staleTimeoutMs": 90000,
+
+  "napCatDir": "C:\\path\\to\\napcat",
+  "qqUin": 123456789,
+  "autoStartNapCat": true,
+
+  "perHour": 20,
+  "perDay": 60,
+
+  "autoReply": false,
+  "replyTo": [],
+  "replyDelayMinMs": 2000,
+  "replyDelayMaxMs": 7000,
+  "sessionId": "qq-moony-auto",
+  "cwd": "",
+  "autoContext": true,
+  "maxContextChars": 2000,
+
+  "groupReply": false,
+  "groupChat": false,
+  "groupWhitelist": [],
+  "groupContextSize": 30,
+  "groupChatEveryMinMin": 8,
+  "groupChatEveryMinMax": 20,
+  "groupActiveWindowMin": 5,
+  "groupCooldownMin": 10,
+  "groupPerDay": 20,
+
+  "proactive": false,
+  "proactiveEveryMinMin": 45,
+  "proactiveEveryMinMax": 90,
+
+  "qzoneAuto": false,
+  "qzonePrompt": "",
+  "qzoneEveryMinMin": 120,
+  "qzoneEveryMinMax": 240
+}
+```
+
+几个关键项：
+
+- `token`：写错会报 `token verify failed`，这是第一道坎。
+- `replyTo`：自动回复的私聊白名单；空数组表示谁发都回。
+- `groupWhitelist`：群白名单；空数组等于群聊没开。
+- `cwd`：自动回复会话的工作目录。指到你的工作区，它才会带上你的人设文件和记忆。
+- `maxContextChars`：每条自动回复附多少字记忆。调小省钱，调大记得住。
+- `staleTimeoutMs`：多久没收到帧就重连。
+
+⚠️ **配置文件不要带 BOM。** PowerShell 的 `Set-Content` 写 UTF-8 会带 BOM，Node 的 `JSON.parse` 会抛错，整份配置被当成不存在。用这个写：
+
+```powershell
+[System.IO.File]::WriteAllText("路径", $json, [System.Text.UTF8Encoding]::new($false))
+```
+
+（插件读的时候已经会剥 BOM，但写文件那边的坑还是留着。）
+
+---
+
+## 五、防封
+
+写在代码里，不靠自觉：
+
+- 每条消息发出前**随机等 2–7 秒**
+- **一小时 / 一天上限**，到顶直接拒发（不是提醒，是拒绝）
+- 群里默认不接；开了也只接白名单 + 被 @ 的，且同群冷却 10 分钟、全群日额 20
+- 额度记账在 `<DSH_HOME>/qq-moony/sent.log`，跨会话累计
+
+真正决定会不会被封的是拿它做什么。插件只能保证不让你手滑：
+
+**只回不主动、不群发、不刷屏、不加好友、不发链接。**
+
+### 群聊的额外一条
+
+放进熟人群之前想清楚：那儿的人未必认识这个号。一个陌生头像突然接话，第一反应是"这谁"。要是正赶上聊私事（家人、成绩、室友之间的事），插一句就不只是尴尬。
+
+建议：先只开"接消息"，让别人 `@` 一次看看反应；觉得合适再开"参与聊天"。
+
+---
+
+## 六、已知限制
+
+- **不装 NapCat、不注入 QQ。** 那部分在客户端侧，插件碰不到。
+- **不是官方机器人。** 走客户端协议端，有封号风险，别拿主号试。
+- **不支持语音、文件。** 目前只处理文字和图片。
+- **主动、空间、自动回复、群聊共用一个会话**（`qq-moony-auto`），理论上会互相排队。
+- **自动回复是"另一个我"**：同工作区、共享记忆和文件，但不共享你正在聊的那个窗口的上下文。
+
+---
+
+## 七、出问题先看这里
+
+```
+<DSH_HOME>/qq-moony/debug.log
+```
+
+常见症状按顺序排查：
+
+1. **`token verify failed`** → token 写错，或 NapCat 那边没设。
+2. **能发不能收** → 看 debug.log 有没有 `WebSocket 已连上`；没有就查 3001 端口和 NapCat 的 `websocketServers`。
+3. **收到消息但不回** → 看有没有"自动回复检查"那行；有检查没投递，多半是白名单或 `autoReply` 没开；投递了没回应，看 `sessionId` 对应的会话起没起来。
+4. **页面报 `SyntaxError: ... not valid JSON`** → 接口没挂上，重启一次 DSH。
+5. **设置页改了没生效** → 检查是不是带 BOM；数字项要点"保存更改"。
+
+---
+
+## 八、版本
+
+见 [CHANGELOG.md](./CHANGELOG.md)。
+
+## License
+
+MIT