dsh-qiyu-stack 0.0.0-stage → 0.15.1

package/docs/deployment.md

@@ -0,0 +1,216 @@
+# 部署：把 QQ 这条路一次修对
+
+这份文档只讲一件事：**怎么让一个智能体稳定地收发 QQ 消息**。
+读完能省掉我们今天踩过的三个坑。
+
+---
+
+## 结论先说
+
+**用 Docker 里的 Linux QQ + NapCat，不要用 Windows 版 NapCat。**
+
+Windows 上装 NapCat（OneKey / Shell / 注入 / LiteLoader）全部会失败，原因见下一节。
+Linux QQ 没有那个限制。
+
+---
+
+## 一、为什么 Windows 版一定失败
+
+**QQ 新版启动时会校验 `package.json`。**
+
+实测（Windows QQ 9.9.36）：只往 `resources\app\package.json` 末尾加一个换行（4 字节，内容语义完全不变），QQ 一启动就弹：
+
+```
+退出
+文件已损坏, 请重新安装QQ。
+```
+
+还原原版，QQ 又能正常启动。
+
+而 NapCat 在 Windows 上的所有形态，本质都是「让 QQ 的入口指向 NapCat」：
+
+| 形态 | 做法 | 结果 |
+|---|---|---|
+| Shell（OneKey / 手动） | 改 `package.json` 的 `main` | QQ 报「文件已损坏」，崩在 `QQNT.dll`（`0x80000003`） |
+| Shell（注入） | 运行时改内存 | 盘上文件没动也秒退（校验发生在加载后） |
+| Framework（LiteLoader） | 同样要改入口 | 按机制推断同样被拦 |
+
+> NapCat 补丁包里写的 `9.9.22-40990` 不是随便写的 —— 那是这道校验还没出现的 QQ 版本。
+
+**Linux QQ 没有这道校验。**
+
+---
+
+## 一·五、前提：Docker（没装就卡在这）
+
+NapCat 必须跑在 **Docker 里的 Linux QQ** 上。这不是偏好，是唯一可行的路——Windows 版那条被上面的校验堵死了。
+
+**没装 Docker 的话：**
+
+1. 下载 <https://www.docker.com/products/docker-desktop/>
+2. 安装时勾上 **WSL2** 组件（Windows 需要 WSL2；没有就管理员开 PowerShell 跑 `wsl --install`）
+3. 装完**重启这台电脑**（不是重启 DSH、也不是重启 Docker）
+4. 打开 Docker Desktop，等左下角显示引擎已启动
+5. 回来跑 `qiyu deploy`
+
+命令行装法：`winget install -e --id Docker.DockerDesktop`
+
+**占用**：Docker 本体 + 镜像大概 3–5 GB，之后数据慢慢长。
+这些默认都在 **C 盘的 Docker 磁盘镜像**里（`Settings → Resources → Disk image location` 可以挪）。
+`qiyu deploy --dir` 管的是宿主机上的配置/登录态/插件，**管不到 Docker 那份**——两处都要留意。
+
+> `qiyu deploy` 会先分辨「没装」和「装了没开」，两种情况的提示不一样。
+
+---
+
+## 二、起一个容器（三分钟）
+
+### 最省事：一条命令
+
+```bash
+npx dsh-qiyu-stack deploy --qq 你的QQ号
+```
+
+它会依次做：查 Docker → 查 3000/3001/6099 有没有被占 → 建 `./napcat/{config,qq,plugins}`
+→ 写 OneBot + WebUI 配置（令牌随机生成）→ 拉镜像 → 跑容器 → 等 WebUI → **直接把二维码弹到你屏幕上**。
+跑完令牌和容器名会写进 `qiyu.config.json`，接着 `qiyu doctor` 就能用了。
+
+加 `--dry-run` 只打印它准备执行的 docker 命令，什么都不动。
+
+### 手动版（想自己控制参数时）
+
+```powershell
+docker pull mlikiowa/napcat-docker:latest
+
+docker run -d --name napcat-qq --restart unless-stopped `
+  -p 127.0.0.1:3000:3000 -p 127.0.0.1:3001:3001 -p 127.0.0.1:6099:6099 `
+  -e MODE=ws -e ACCOUNT=<你的QQ号> -e WEBUI_TOKEN=<自己定一个> -e TZ=Asia/Shanghai `
+  -v "D:\qiyu\napcat\config:/app/napcat/config" `
+  -v "D:\qiyu\napcat\qq:/app/.config/QQ" `
+  -v "D:\qiyu\napcat\plugins:/app/napcat/plugins" `
+  mlikiowa/napcat-docker:latest
+```
+
+**三个挂载点必须挂**，否则重启就丢：
+
+| 容器里 | 放什么 |
+|---|---|
+| `/app/napcat/config` | OneBot 配置（`onebot11_<QQ号>.json`）、WebUI 配置 |
+| `/app/.config/QQ` | QQ 登录态、消息数据库 |
+| `/app/napcat/plugins` | 插件（不用可空）
+
+### OneBot 配置
+
+写进 `napcat/config/onebot11_<QQ号>.json`（或模板 `onebot11.json`）：
+
+```json
+{
+  "network": {
+    "httpServers": [
+      { "name": "http-default", "enable": true, "host": "0.0.0.0", "port": 3000,
+        "enableCors": true, "messagePostFormat": "array", "token": "你的HTTP令牌" }
+    ],
+    "websocketServers": [
+      { "name": "ws-default", "enable": true, "host": "0.0.0.0", "port": 3001,
+        "messagePostFormat": "array", "token": "你的WS令牌", "heartInterval": 30000 }
+    ],
+    "httpClients": [], "websocketClients": [], "httpSseServers": [], "plugins": []
+  },
+  "musicSignUrl": "",
+  "enableLocalFile2Url": false,
+  "parseMultMsg": false
+}
+```
+
+> 同时提供 **HTTP 服务端**（谁来调都行）和 **正向 WS 服务端**（事件流），
+> 上层框架按 OneBot 11 接就行，接口跟 SnowLuma 那种实现是通用的。
+
+---
+
+## 三、登录：二维码，以及一个必须勾的框
+
+1. 跑 `qiyu qr` —— 二维码会**直接在你屏幕上打开**（同时终端里会说它几秒前生成的、大概什么时候失效）
+   - 已经登录了它会直接告诉你「不用扫」，不会拿一张过期的码糊弄你
+   - 也可以手动开 `http://127.0.0.1:6099/webui?token=<你定的 WEBUI_TOKEN>`，页面里是实时码
+2. 用**目标账号**的手机 QQ 扫
+3. ⚠️ **手机上确认时，勾「下次登录无需确认」**
+
+第 3 步是关键。不勾的话每次容器重启都会要求「手Q验证」，等于每次都要人工点一下；
+勾了之后 `docker restart` 能自动快速登录，免扫码：
+
+```
+09:24:11  正在快速登录 <你的QQ号>
+09:24:42  ✅ 已上线（coreReady=true）
+```
+
+**别用 `docker rm -f` 再 `docker run`** —— 换容器等于换设备，登录态失效，要重扫。
+要重启**容器**用 `docker restart <容器名>`（不用重启电脑）。
+
+---
+
+## 四、要它自己起来，但别让用户看见
+
+2026-10-23 改过一次：**不再开机自启，改成「用的时候才起来，起来也不弹窗」**。
+
+### 为什么不要开机自启
+
+用户根本不知道 Docker 是什么。开机时冒出一个窗口、任务栏多一个图标，只会让人困惑。
+而且开机自启会把 Docker 常驻在后台，白占内存。
+
+### 现在的做法
+
+| 时机 | 谁来做 |
+|---|---|
+| 打开 DSH / qiyu | **QQ 桥在启动 5 秒后检查**：引擎不在就静默拉起（无窗口、无任务栏按钮），容器靠 `--restart unless-stopped` 自己回来 |
+| `qiyu deploy` | 同样先查再拉，已经在跑就立刻跳过 |
+| 电脑开机 | **什么都不做**（启动文件夹里的 `启动-NapCat.vbs` 已停用，Docker 的 `AutoStart` 也关着） |
+
+### 关键的一条（这是弹窗的真正原因）
+
+> **`Docker Desktop.exe` 在引擎已经在跑的时候再执行一次，会 `signaling show-dashboard`**
+> —— 也就是用户看到一个莫名其妙弹出来的窗口。实测日志：`backend already running, signaling show-dashboard`。
+
+所以代码里**必须先查引擎，再决定要不要碰那个 exe**。这一步已经写进：
+- `runtime/bridge/lib/host.js` 的 `后台服务在线()` / `拉起后台服务()`
+- `src/docker.mjs` 的 `确保引擎()`
+
+### 剩下的唯一痕迹
+
+Docker Desktop 启动后会在**右下角托盘**留一个小鲸鱼图标。这是它的固有行为，**没有关闭选项**。
+但它不占任务栏、不弹窗口——用户平时看不见它。
+
+想让启动更安静，设置里这两项要这样：
+
+```json
+// %APPDATA%\Docker\settings-store.json
+"AutoStart": false,              // 不开机自启
+"OpenUIOnStartupDisabled": true  // 启动时不弹面板
+```
+
+`qiyu` 每次拉起引擎前会顺手把 `OpenUIOnStartupDisabled` 写一遍（写不进也不影响启动）。
+
+> 容器起来的那 20~30 秒里，QQ 是收不到消息的；桥会在引擎好后自动重连，不用手动做任何事。
+
+---
+
+## 五、端口和冲突
+
+| 端口 | 用途 |
+|---|---|
+| 3000 | OneBot HTTP |
+| 3001 | OneBot 正向 WS |
+| 6099 | NapCat WebUI |
+
+**同一个号只能在一个地方登录**。如果机器上还有别的 QQ 机器人（比如 SnowLuma），先停掉，
+否则两边抢 3000/3001，或者互相把对方挤下线。
+
+---
+
+## 六、自查
+
+```powershell
+qiyu doctor
+```
+
+会逐项检查：Docker、容器、三个端口、OneBot 身份、事件流、DSH 桥，
+每项失败都带一句「怎么修」。

package/docs/settings-tabs.md

@@ -0,0 +1,114 @@
+# 把插件设置合并成一个页面 + 页签
+
+装了几个插件之后，DSH 设置左侧栏会变成这样：
+
+```
+账号与余额
+通用设置
+模型
+内置插件
+Agent 预设
+刷 B 站        ← 每个插件各占一项
+鱼的心情
+鱼的记忆
+主动搭话
+通到 QQ
+```
+
+想要的是：**只有「内置插件」一项，点进去是页签**：
+
+```
+内置插件
+ ├─ 全部
+ ├─ 刷 B 站
+ ├─ 鱼的心情
+ ├─ 鱼的记忆
+ ├─ 主动搭话
+ └─ 通到 QQ
+```
+
+## 结论：DSH 本来就有这个槽位，不用自己造
+
+在 DSH 的插件契约里（`dsh-cordis-client-runner`，slot 定义 `settings.plugins.tab`）：
+
+> One page inside the Plugins settings section.
+> The section owner renders localized entry labels as tabs
+> and mounts each contribution inside its corresponding tab panel.
+> Options: `id`（页签 key）、`order`（顺序）、`label`（显示名）。
+
+所以插件只要把注册目标从 `settings.section` 换成 `settings.plugins.tab`，
+就会从左侧栏消失、变成插件页里的一个页签。**不改组件、不改样式、不写新面板。**
+
+## 改法
+
+一个插件只需要动两处字符串（都在它自己的 `client.js` 里）：
+
+```js
+// 改前
+slots.inject('settings.section', () =>
+  slots.register(
+    { name: 'settings.section', id: 'qq-bridge', order: 54, label: () => '通到 QQ' },
+    Section,
+  ),
+)
+
+// 改后
+slots.inject('settings.plugins.tab', () =>
+  slots.register(
+    { name: 'settings.plugins.tab', id: 'qq-bridge', order: 54, label: () => '通到 QQ' },
+    Section,
+  ),
+)
+```
+
+`order` 决定页签顺序（小的在前）。
+
+## 用脚本批量做
+
+栖语栈里带了一个脚本：
+
+```bash
+# 先看看有哪些插件会被改
+node tools/merge-settings-tabs.mjs --dry-run
+
+# 真改（每个文件自动备份成 client.js.bak-tab-<时间戳>）
+node tools/merge-settings-tabs.mjs
+
+# 想还原
+node tools/merge-settings-tabs.mjs --restore
+```
+
+默认目录是 `~/.dsh/profiles/desktop/node_modules`，换 profile 用 `--dir`。
+
+## 生效方式
+
+**刷新页面就行（Ctrl+R）**，不用重启 DSH。
+
+原因：DSH 给客户端 bundle 的 URL 带了 `rev`，而 `rev` 是按**文件 mtime** 算的
+（见 `dsh-client-modules` 的 `String(baseline.mtimeMs)`），所以文件一改、版本号就变，
+页面刷新会拉到新包。
+
+如果刷新没变化，再试 `Ctrl+Shift+R` 硬刷新；仍然不行才需要重启 DSH。
+
+## 踩过的坑
+
+1. **注释里也有 `settings.section`** —— 批量替换会把注释一起换掉，无害，但看到别奇怪。
+2. **跨行写法** —— 有的插件是
+   ```js
+   {
+     name: 'settings.section',
+     id: 'memory',
+     ...
+   }
+   ```
+   所以别按「整行」去替换，要替换**引号里的字面量**。脚本就是这么做的。
+3. **改完先 `node --check`** —— 这些 client.js 是打包好的字符串，替换坏了会整个设置页白屏。
+4. **每个插件都要备份** —— 出问题能一条命令还原（脚本的 `--restore`）。
+
+## 适用边界
+
+- 这些插件得是**独立的 client bundle**（有自己的 `client.js`）。宿主内置的 section
+  （账号、通用、模型）不该动。
+- 如果你是插件作者，新插件**一开始就注册到 `settings.plugins.tab`**，别占左侧栏。
+- 想做「一个『栖语』页 + 自己的页签容器」也可以，但要新写一个 section 插件当容器，
+  再把各组件的注册目标指过去 —— 工作量大得多，收益只是名字和位置更整齐。

package/examples/README.md

@@ -0,0 +1,18 @@
+# examples/
+
+样板角色放这里，**默认不安装**，只是让人看看「能长成什么样」。
+
+暂时是空的。
+
+以后会把「云千语」那套整理一份放进来——去掉所有隐私（聊天记录、令牌、那封私人信件），
+只保留结构和写法，比如：
+
+```
+examples/qianyu/
+├── AGENTS.md          人格长什么样（行为 + 性格都写满的那种）
+├── schedule.json      三个时段怎么排
+├── letters/           写给她的信（示例，内容换成假的）
+└── README.md          为什么这么写
+```
+
+在它出现之前，先用 `templates/blank` 起步，性格那几行自己填。

package/package.json

@@ -1,6 +1,45 @@
-{
-  "name": "dsh-qiyu-stack",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+{
+    "name":  "dsh-qiyu-stack",
+    "version":  "0.15.1",
+    "description":  "栖语栈：让一个智能体住进 QQ —— QQ 双向桥、长期记忆、心情、语音、作息，以及把 NapCat 部署这件事一次做对",
+    "type":  "module",
+    "bin":  {
+                "qiyu":  "./bin/qiyu.mjs"
+            },
+    "engines":  {
+                    "node":  "\u003e=20"
+                },
+    "scripts":  {
+                    "doctor":  "node bin/qiyu.mjs doctor",
+                    "init":  "node bin/qiyu.mjs init"
+                },
+    "license":  "MIT",
+    "files":  [
+                  "bin",
+                  "src",
+                  "templates",
+                  "docs",
+                  "examples",
+                  "qiyu.config.example.json",
+                  "tools",
+                  "runtime"
+              ],
+    "repository":  {
+                       "type":  "git",
+                       "url":  "git+https://github.com/aesfls/dsh-qiyu-stack.git"
+                   },
+    "homepage":  "https://github.com/aesfls/dsh-qiyu-stack#readme",
+    "bugs":  {
+                 "url":  "https://github.com/aesfls/dsh-qiyu-stack/issues"
+             },
+    "keywords":  [
+                     "qq",
+                     "qqbot",
+                     "napcat",
+                     "dsh",
+                     "deepseek-harness",
+                     "agent",
+                     "persona",
+                     "onebot"
+                 ]
+}

package/qiyu.config.example.json

@@ -0,0 +1,14 @@
+{
+  "napcat": {
+    "container": "napcat-qq",
+    "http": "http://127.0.0.1:3000",
+    "ws": "ws://127.0.0.1:3001/",
+    "webui": "http://127.0.0.1:6099",
+    "token": "",
+    "wsToken": ""
+  },
+  "dsh": {
+    "port": 55861
+  },
+  "character": "characters"
+}

package/runtime/README.md

@@ -0,0 +1,84 @@
+# runtime/ —— 运行时五块
+
+这里放「一个角色真正活着需要的代码」：QQ 桥、记忆、心情、语音、作息。
+
+**来源**：全部是从一台真在跑的机器上（`~/.dsh/profiles/desktop/node_modules/`）原样搬过来的，
+不是照文档重写的。搬完做了「去个性化」：私人路径、角色名、QQ 号、令牌，一个不留。
+
+| 块 | 来源插件 | 体积 | 状态 |
+|---|---|---|---|
+| `bridge/` | dsh-qq-bridge 0.2.0 | 155 KB | ✅ 已搬 + 去个性化 |
+| `memory/` | dsh-fish-memory | 1.8 MB | ✅ 已搬（含 1 MB 中文词典，分词用） |
+| `mood/` | dsh-feiyu-mood | 500 KB | ✅ 已搬（含五张表情图） |
+| `rhythm/` | dsh-speak-up 0.2.0 | 119 KB | ✅ 已搬 |
+| `voice/` | 语音转写.py + `bridge/lib/voice.mjs` | 3.4 KB + 4 KB | ✅ 说/听都抽出来了 |
+
+---
+
+## 各块现在是什么状态
+
+### bridge/（QQ 双向）
+
+已经做成**全配置驱动**的了（今天改的）：
+
+| 原来写死 | 现在 |
+|---|---|
+| `uid === 10001` | `配置.自己QQ`（0 = 自己问 NapCat 要） |
+| `备注.startsWith('爸爸')` | `配置.身份表`（备注前缀 → 称呼，随便加人换叫法） |
+| 出事找 `爸爸` | `配置.主人` |
+| `转写脚本: 'W:\...\语音转写.py'` | `配置.转写脚本`（空 = 不转） |
+| `PYTHONPATH: 'W:\...\pylibs'` | `配置.转写依赖路径` |
+| 表情包/收件箱路径 | `~/.qiyu/表情包`、`~/.qiyu/收件箱`（可用环境变量覆盖） |
+| 音色默认 `zh-CN-XiaoyiNeural` | `zh-CN-XiaoxiaoNeural`（中性） |
+
+还留着 `爸爸`/`妈妈` 这两个词的地方，是**默认身份表**和工具说明里的举例
+（"给通讯录里的人发消息，比如爸爸、妈妈"）。它们是通用亲属称谓、不是某个人的名字，
+而且真认人走的是 `身份表` 配置，改一行就换。
+
+### voice/（说 + 听）
+
+语音原来是贴在 bridge 里的，现在拆成两块：
+
+| 半 | 在哪 | 干什么 |
+|---|---|---|
+| **说**（TTS） | `bridge/lib/voice.mjs` 的 `合成语音()` | edge-tts（联网、自然）或 Windows SAPI（离线、机械） |
+| **听**（ASR） | `bridge/lib/voice.mjs` 的 `转写音频()` + `voice/语音转写.py` | 本地脚本收 wav、往 stdout 打文字（SenseVoice 之类） |
+| **网络那半** | 还在 bridge 里 | 向 NapCat 要 `get_record`（base64 wav），再交给上面两个 |
+
+边界是这样切的：**voice 只管本地能力（本机的 python、本机的模型），bridge 只管网络和消息。**
+所以 `转写语音()` 现在只剩「取 → 存 → 转」三行调用。
+
+`qiyu install` 会顺手把 `语音转写.py` 放到 `~/.qiyu/语音转写.py`，
+那正是 `voice.mjs` 的默认路径 —— 不配也能用。
+
+实测：用抽出来的 `合成语音()` 单独跑一次，成功生成了 21 KB 的 mp3。
+
+### memory/ 和 mood/、rhythm/
+
+搬过来是干净的，也**没改过一行代码**。它们原本就没有私人值。
+
+`memory` 那 1 MB 的 `词典.txt` 是分词用的，别删。
+
+---
+
+## 还没做的
+
+- [x] ~~`qiyu install`~~ —— **做好了**：拷 node_modules + 写 profile package.json + 写 bundles，
+      默认只列清单，`--yes` 才动手，冲突跳过，改 package.json 前必留 `.bak`
+- [x] ~~依赖路径悬空~~ —— `file:` 不指向 qiyu 包本身，而是先落一份稳定副本到
+      `~/.dsh/qiyu/runtime/`；npx 缓存清掉也不影响
+- [x] ~~voice 的胶水~~ —— 抽成 `bridge/lib/voice.mjs`（说/听），网络那半留在桥里
+- [x] ~~配置收敛~~ —— `install --character` 把角色包拷到 `~/.dsh/qiyu/`，bridge 读身份的顺序是
+      `character.json` > `qq-bridge-config.json` > 默认值（memory/mood/rhythm 还没接）
+- [x] ~~`memory` / `mood` / `rhythm` 也改读活动角色~~ —— 三块都接上了：
+      `rhythm` 读 `schedule.json` 的时段、`mood` 读 `名字`/`称呼.主人`、`memory` 的名字兜底读 `名字`
+- [x] ~~端到端~~ —— **在一个全新 profile 上真跑过**（2026-10-23 11:38）：
+      空白 profile → `qiyu install` → 起独立 DSH → 桥接上备号 → 事件流连上
+      → 往群里发了一条 ✅ → 群里 @ 她，桥把话转进了会话 ✅
+      （最后「她回话」那一步没验证：测试 profile 没配默认模型，那一轮跑不起来）
+
+## 为什么先搬到这儿、先不装
+
+因为**装**是有副作用的动作（改 profile、可能撞上已经装着的同名插件）。
+先把源码收进来、把私人值洗干净，是这一阶段能确定做完的事；
+装的部分单独做 `qiyu install`，带 `--dry-run` 和备份，才有资格碰别人的 profile。

package/runtime/bridge/CHANGELOG.md

@@ -0,0 +1,70 @@
+# 改动记录
+
+> **版本号规矩**：每改一次 **+0.0.1**；末位满 10 **进位**（`0.1.9` → `0.2.0`）。
+> 版本号只写一处真源：`package.json`；提交信息也以版本号开头。
+
+## 0.1.5
+
+**修：目标会话清单里混着「已归档」的会话；README 补上 QQ 后端怎么装**
+
+- 🐛 归档只是把会话藏起来，`sessions.list()` 里**还在**；原来只调 list()，
+  于是设置页里把已归档的也列出来了（这台机器上有 40 个），选了也没用。
+- ✅ `inject` 加 `workspaceRegistry`，从 `archivedSessionIds` 取归档名单（照朗读桥的写法），清单里直接过滤。
+- ✅ 发送时也检查：盯的会话如果已经归档，这轮不转，日志写明。
+- 📄 README：新增「装哪个 QQ 后端」——**NapCat（已验证）/ SnowLuma（同接口，未实测）**，
+  列出插件实际用到的 6 个 OneBot 11 接口，换后端时照着核对。
+- 📄 修掉 package.json 和设置页里"先只做了 DSH → QQ 这半"的旧说法（两半都做完了）。
+
+## 0.1.4
+
+**`QQ → DSH` 这半彻底搬进插件，不再赖 BOT**
+
+- 插件每 4 秒轮询 NapCat 的 HTTP 历史接口（`get_friend_msg_history` / `get_group_msg_history`），
+  发现她新发的私聊/群消息 → 直接 `followup` 进目标会话。
+- 只认 `私聊QQ` 这个人发的；自己的回话（self 消息）不会自我繁殖成死循环。
+- 靠 `message_id` + 时间戳去重，同一条不重复转；总开关关 / 没选会话时只推进时间、不处理旧消息。
+- 结论：**这台桌面只要 NapCat + 这个插件，BOT 可以完全不要了。**
+
+## 0.1.3
+
+**QQ→DSH 这半的 BOT 半场也接上了**（改在 Estrella 那边，不在本仓库）
+
+- Estrella（BOT）加了 `custom.qqBridge` 开关（**默认关**）：打开后，私聊/群里**她本人**说的话
+  由 BOT 转发到本插件的 `/receive`，然后 BOT **闭嘴不回**，全交给 DSH 里那位伙伴。
+- 兜底：转成功 → BOT 不回；转失败（DSH 没开 / 连不上）→ BOT **照常回**（桥断 ≠ 鱼哑）。
+- 本仓库只是把这件事写进 README（见「怎么把 BOT 接上」）；运行入口仍是 0.1.2 的 `/receive`。
+
+## 0.1.2
+
+**加了「QQ → DSH」这半的入口**（`/receive` 路由）
+
+- BOT 把她说的话 POST 到 `/dsh-qq-bridge/receive`，这里用 `agent.followup(手搓 user 消息)` 走 DSH 自己的回合。
+- 消息 `source.kind = 'qq'`（不冒充她亲手在 DSH 里打的）。
+- 闸门：没选目标会话 / 总开关关 / 会话没活着 / 空 text 都拒绝，并回一句人话。
+- BOT 那边（Estrella 改动）要在这半之后再接上。
+
+## 0.1.1
+
+**加了设置页（网页半边）**
+
+- 设置 → 「通到 QQ」：总开关 / 试运行 / 目标会话（**下拉选，不手填**）/ 私聊 QQ 号 / 群号 /
+  转私聊 / 转群 / 「测试一句」/ 保存设置，外加一份最近记录。
+- 页面顶上显示「连着的 QQ 是哪个号、昵称」（走 NapCat `/get_login_info` 探活）。
+- 有改动时，底下照样浮出「⚠ 有改动还没保存 + 保存设置」条（照「主动搭话」那套）。
+
+## 0.1.0
+
+**上半场：DSH → QQ（宿主）**
+
+- 盯「目标会话」，伙伴**一整轮最后一句**说完，自动发到 QQ 私聊/群。
+- 走 NapCat OneBot HTTP（`127.0.0.1:3000`），**不经过 Estrella（BOT鱼）**。
+- 安全默认：总开关关、试运行开。
+- 多步只发最后一步；`interrupted` / `reason != completed` 不转发；只认目标会话。
+- 附带 `/state` `/save` `/test-send` 三条路由 + 宿主半边冒烟测试。## 0.1.7
+
+**文案通用化：不再出现作者自己的称呼；两个 QQ 后端都标为已测**
+
+- 说明和设置页里的「大肥鱼 × 小鱿鱼」全部改成「你自己要的那一间」——别人装了看得懂。
+- 后端表更正：**SnowLuma 和 NapCat 都是测过的**（之前把 NapCat 写成"未实测"，是写错了）。
+- 设置页文案里误留的 markdown 星号（`**一整轮**`）去掉，免得原样显示成星号。
+

package/runtime/bridge/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yuuyuko-uu
+
+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.