dsh-onebot-qq 0.9.6

dsh-onebot-qq 0.9.6

本版亮点

• 工具脚本修复随本版收口：scripts/link-host.sh 的依赖清单修正——移出 rc.2/rc.3 宿主 node_modules/@deepseek-ai/ 下均不存在的 dsh-invariants（插件零引用，原缺包分支 exit 1 会让完整 build.sh 在首个 link-host 阶段中止），补齐 tests/session-v4-persistence.spec.ts:268 直接 import 的 6 个 dsh-session-format* 包；末尾的 schemastery/cosmokit 硬链改为「宿主顶层优先、@deepseek-ai/ 兜底」，消除每轮重链必产的 2 条悬空链接（两处都缺仍硬失败，缺包语义不变）。scripts/verify-injected-context.mjs:87 改为把 dsh-session-persistence-jsonl 以整模块命名空间传入（该模块是 cordis 插件模块，无 default 导出，旧写法 ctx.plugin(undefined) 抛 invalid plugin 并 exit 1，rc.2 同样失败，非 rc.3 回归）。实现见 commit ac5c80a（已随 main 推送）。
• DSH 0.2.1-rc.3 适配验证结论 = 兼容：link-host.sh 对 rc.3 exit 0（20 链接全指向 rc.3，find node_modules -xtype l 悬空 0）；verify-injected-context.mjs 对 rc.3 与 rc.2 均 7/7 PASS（S1–S6 + 清理）；verify-lan-management.mjs 对 rc.3 12/12 PASS（回归）。插件在 rc.3 宿主上无需运行时改动。
• 本版无运行时代码变更：src/ 与 lib/ 零改动，npm 发布物与 0.9.5 逐字节同内容（仅 package.json / dsh.plugin.json 版本号、tests/commands.spec.ts 版本断言、DEVLOG 变更）。scripts/ 不在 files 白名单内，不随 npm 包分发——版本号 bump 是该脚本修复与 rc.3 适配验证的收口标记。

兼容性说明

• 宿主版本线：engines.dsh 为 >=0.1.5-rc.1 <0.1.6-0 || >=0.1.6-alpha.1 <0.1.7-0 || >=0.1.7-alpha.1 <0.2.0-0 || >=0.2.0-rc.1 <0.3.0-0 || >=0.2.1-0 <0.3.0-0（两份 manifest 逐字一致，与 0.9.3 起相同，本版未改）。
• Node.js：>=22。
• 本版无功能变化；已安装用户随宿主下次重启加载，行为与 0.9.5 一致。
• 发布面补记：本版同时补建历史缺失的 v0.9.4、v0.9.5 GitHub Release（既有 tag 未改动）。

安装

dsh plugin --profile web add dsh-onebot-qq

dsh-onebot-qq 0.9.5

dsh-onebot-qq 0.9.5

补建发布记录（2026-10-24 补齐历史缺失的 GitHub Release；tag v0.9.5 与 npm 包内容未改动）

本版亮点

• 设置页可视化重设计三批实施：本发版零代码改动，出版本号以标记设置页可视化重设计三批实施的落地——token 视觉基线 + 暗色适配 + 交互逻辑（脏状态 / 确认 / 折叠 / mode 联动 / 重试）+ 冲突合并保留 + 数字行内校验。实现见 feat commit aebbe7f（代码 956+/52−，已部署真机）与设计文档 commit 0f787af（三份设计文档），均已入库。

兼容性说明

• 宿主版本线：engines.dsh 为 >=0.1.5-rc.1 <0.1.6-0 || >=0.1.6-alpha.1 <0.1.7-0 || >=0.1.7-alpha.1 <0.2.0-0 || >=0.2.0-rc.1 <0.3.0-0 || >=0.2.1-0 <0.3.0-0（两份 manifest 逐字一致，与 0.9.3/0.9.4 相同）。
• Node.js：>=22。
• 本版无功能变化；已安装用户随宿主下次重启加载生效。

发版当日验证记录

• npx tsc -p tsconfig.json --noEmit 零错误；全量 vitest 全绿（38 文件 / 550 用例）。
• 部署目录 /vol2/@appshare/Harness/dsh-plugins/dsh-onebot 已同步版本号（lib 代码已在真机，未动其他文件）。
• 清单同步：package.json 0.9.4→0.9.5；dsh.plugin.json 同步 0.9.5；tests/commands.spec.ts 版本断言随版；lib 产物零改动；package-lock.json 沿用惯例不动。
• 发布链：commit → tag v0.9.5 → push → npm publish 同批完成。

安装

dsh plugin --profile web add dsh-onebot-qq

dsh-onebot-qq 0.9.4

dsh-onebot-qq 0.9.4

补建发布记录（2026-10-24 补齐历史缺失的 GitHub Release；tag v0.9.4 与 npm 包内容未改动）

本版亮点

• 设置页入口迁至「插件」选项卡：client 侧设置页入口由 settings.section 改为 plugins.bundle.config（在组合包详情页渲染 OnebotSettingsPanel），并清理 settings.section 挂载时代遗留的 settings.nav 死键（导航 locale 键）。实现见 feat commit 029b5a1（lib/client.js + docs/settings-page-design.md，已随该 commit 入库），本发版不含 lib 改动。

兼容性说明

• 宿主版本线：engines.dsh 为 >=0.1.5-rc.1 <0.1.6-0 || >=0.1.6-alpha.1 <0.1.7-0 || >=0.1.7-alpha.1 <0.2.0-0 || >=0.2.0-rc.1 <0.3.0-0 || >=0.2.1-0 <0.3.0-0（两份 manifest 逐字一致，与 0.9.3 相同）。
• Node.js：>=22。
• 设置页入口位置变化：配置面板现从「插件 → dsh-onebot 组合包详情」进入，原 settings.section 入口不再渲染。

发版当日验证记录

• 全量 vitest 全绿（38 文件 / 534 用例）；首轮 tests/inject.spec.ts「dry-run=false lets injected rounds really send」在并行负载下偶发失败（既有环境 flake，0.9.0 已记录口径），隔离单跑 11/11 绿后全量复跑全过。
• 清单同步：package.json 0.9.3→0.9.4；dsh.plugin.json 同步 0.9.4；tests/commands.spec.ts 版本断言随版；lib 产物零改动；package-lock.json 沿用惯例不动。
• 发布链：commit → tag v0.9.4 → push → npm publish 同批完成。

安装

dsh plugin --profile web add dsh-onebot-qq

dsh-onebot-qq 0.9.3

dsh-onebot-qq 0.9.3

本版亮点

• engines.dsh 声明补齐 DSH 0.2.1 线：双 manifest（package.json 与 dsh.plugin.json）的 engines.dsh 在原 >=0.2.0-rc.1 <0.3.0-0 之后追加 || >=0.2.1-0 <0.3.0-0。根因是 node-semver 的预发布匹配规则：带预发布 tag 的版本只与比较子中同 [major,minor,patch] tuple 的条目比较，原范围的比较子仅含 0.2.0 与 0.3.0 两个 tuple，DSH 0.2.1-rc.1（0.2.1 tuple）因此被排除。经 semver 实测：satisfies('0.2.1-rc.1', 旧范围)=false → 新范围 true；0.2.0/0.2.0-rc.1 仍匹配、0.3.0/0.3.0-rc.1 仍被上界排除，原有边界不变。
• 影响面：仅声明性缺口。DSH 宿主不强制校验 engines，插件在 DSH 0.2.1-rc.1 宿主上的运行时行为此前一直正常；本修复使声明与实际兼容面重新一致，并消除会读取 engines 的工具链（npm/pnpm 引擎校验等）在 0.2.1 预发布宿主上的不匹配误报。
• 随版同步：tests/commands.spec.ts 版本断言随版 0.9.2→0.9.3（仓库发版惯例，同 0.9.2 commit 4055bc7），DEVLOG 补发版记录。本版无任何功能变化，改动仅限声明字段与文档。

兼容性说明

• 宿主版本线：engines.dsh 现为 >=0.1.5-rc.1 <0.1.6-0 || >=0.1.6-alpha.1 <0.1.7-0 || >=0.1.7-alpha.1 <0.2.0-0 || >=0.2.0-rc.1 <0.3.0-0 || >=0.2.1-0 <0.3.0-0（两份 manifest 逐字一致）。0.2.0-rc.1 起、0.2.1-0 起两个预发布段，以及 <0.3.0-0 内的全部正式版均匹配；受上述 semver 预发布规则约束，未来新 tuple 的预发布（如 0.2.2-rc.1）仍不在声明内，届时随版补对应比较子（本次边界复验 0.2.2-rc.1=false，与修复前口径一致，非回归）。
• Node.js：>=22。
• 本版无功能变化；npm dsh-onebot-qq@0.9.3 已发布，已安装用户随宿主下次重启加载生效。

安装

dsh plugin --profile web add dsh-onebot-qq

dsh-onebot-qq 0.9.2

dsh-onebot-qq 0.9.2

本版亮点

• /healthcheck 更名为 /doctor，保留等价别名 /healthcheck：命令表主条目更名为 doctor，CommandDefinition 新增可选 aliases 字段（aliases: ['healthcheck']），路由兼容别名——/doctor 与 /healthcheck 走同一 handler，行为逐字一致（无参摘要 / export [参考号] 诊断包 / 非法参考号提示均不变）。/help 只列 /doctor；相近命令建议把别名候选归一到主名（拼错 /helthcheck 也会提示 /doctor）。实现与内部标识符零改动，双语 README 命令表同步更新。

0.9.0 主体特性（W1–W3 五特性批次）

• Session v4 producer kind 收口与回归：会话 v4 持久化中 producer-owned source kind（plugin:dsh-onebot）回归测试收口与审计（新增 tests/session-v4-persistence.spec.ts 与 docs/v4-source-audit.md）。
• 排队/插话策略：新增 newMessagePolicy 排队/插话策略、/steer 命令与 autoSteerPolicy 配置，默认值 admin——自动插话仅管理员消息具备资格，默认行为面收敛。
• 超时后结果补发（deferred delivery）：模型回合超时后结果补发；只补文字结果、不重放审批请求，避免审批流程在无人值守场景被二次触发。
• 诊断参考号体系：仅故障场景发号——QQ-CONN- 连接类 / MF- 消息类，正常路径零开销零噪音，便于用户报障时对照排查。
• 两套真实宿主集成验证脚本：scripts/verify-injected-context.mjs 与 scripts/verify-lan-management.mjs（npm verify:*），仿 dsh-im 的宿主集成验证，可在真实宿主环境实测注入上下文与局域网管理路径。

0.9.1 修复

• /ver ESM __dirname 修复：0.9.0 生产 npm 包实证 /ver 恒显示 v?——ESM 产物下裸 __dirname 未定义，ReferenceError 被静默吞掉。改为 ESM 安全等价 dirname(dirname(fileURLToPath(import.meta.url)))，版本与 commit 后缀恢复正常；仅影响 /ver 展示，不影响消息收发与会话逻辑。

兼容性说明

• 宿主版本线：engines.dsh 含 >=0.2.0-rc.1 <0.3.0-0（0.2.0 线），以及 0.1.5/0.1.6/0.1.7 各 rc/alpha 区间。
• Node.js：>=22。

安装

dsh plugin --profile web add dsh-onebot-qq