dsh-sansheng-liubu/vendor/ds-bot/PATCHES.md

42 lines
1.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 上游补丁记录
上游:`Fei2411/DS-Bot`,固定基线 `84c3cb86b997aec53281b842fd162f3f6b4ee7be`(= npm `ds-bot@0.3.2`)。
本目录是 npm 发布内容(`files` 白名单)加下述补丁,另附仓库根 `NOTICE`。
## M-01:向伴侣插件暴露运行时
```diff
export function apply(ctx, config = {}) {
- createRuntime(ctx, config)
+ const rt = createRuntime(ctx, config)
+ // sansheng M-01: expose the runtime so a companion plugin can create Bots, bind
+ // model settings, and read authoritative goal state. See PATCHES.md.
+ ctx.provide('dsbot-runtime', rt)
}
```
原因:`createRuntime` 的返回值原本直接丢弃,第三方插件无法创建 Bot、设置模型或
读取 `room.goal` 的权威状态。`ctx.provide` 是宿主 cordis 的公开服务注册 API
(`@deepseek-ai/cordis` `ctx.provide(name, value)`),不修改任何业务逻辑。
伴侣插件用法:
```js
const rt = ctx.get('dsbot-runtime', false) // 未安装打过补丁的 ds-bot 时为 undefined
```
影响面:只新增一个服务名 `dsbot-runtime`;不与上游已有服务冲突(全仓无同名)。
行为、工具、页面、状态文件均未改动。
## 升级步骤
1. 取新版本 npm tarball,解压覆盖本目录(保留本文件与 `NOTICE`)。
2. 重放 M-01;若上游已自行暴露运行时(例如 `ctx.set('dsbot', rt)`),删除本补丁
并同步修改 `sansheng/src/runtime.js` 的取用名。
3. 跑 `sansheng` 的单元测试与安装冒烟(见 `docs/install.md`)。
## 回退
删除本目录、改装 npm `ds-bot@0.3.2` 即可;三省六部在拿不到运行时句柄时仍可
`bind` 已存在的 Bot,只是不能自动建 Bot / 改模型(工具会返回明确错误)。