dsh-sansheng-liubu/CHANGELOG.md

220 lines
24 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.

# Changelog
> 版本号以 `package.json` 为准(当前 0.11.0)。更早的 0.6.x 条目沿用旧编号,保留作历史。
## 0.11.0 — 退役老预设线,只留工作台
按现行方案(`docs/v0.1-实施方案.md`:十席独立会话、身份由项目+席位绑定注入)执行退役。旧方案的 Team/子 agent 模型整体移除:
- **删除**:`preset.patch.yml`、朝堂侧栏 `panel/`(含其客户端与测试)、`scripts/mode.mjs`、`scripts/preview.mjs`、`locale/`、`test/policy.test.js`。
- **根 `index.js` 重写为极简入口**:只在应用根上启动工作台宿主(`createWorkbenchHost`),卸载时停掉;不注册预设、不读 Team 成员身份、不注入角色提示词、不做工具守卫、不提供 /dept-model 命令。
- **随老线退役的能力**:基于成员身份的角色判定、丞相组队流程、工具守卫(含未分类工具拦截)、预设内按部门改模型。工作台的账本、席位绑定、派工对账与分层记忆不受影响——它们本来就走独立会话模型。
- **包名保持 `dsh-sansheng-liubu-mode` 不变**,仅为让既有 bundle 登记继续有效;它不再提供任何模式。升级时请删掉 profile `cordis.patch.yml` 里旧的上朝预设段。
- 单测随之减少:删除的 policy/panel 测试共 55 项,余下全部为工作台测试。
## 0.10.0 — 三省六部有记忆了:长期记忆 + 项目记忆
- 新增分层记忆(设计见 `docs/记忆设计.md`,思路借鉴 DS Bot 的分层记忆,落在原生账本之外):长期记忆一份(跨项目,记用户偏好与长期经验),项目记忆一项目一份(记这个项目发生过什么、结论是什么),都是侧车目录 `memory/` 下的 Markdown 文件,用户可以直接打开看、打开改。
- 隔离按本项目的规矩:项目记忆只认项目 ID、项目之间互不可见,不学 DS Bot 上游「主 Bot 可读全部记忆」的弱隔离。
- 派发时自动注入:dispatchTask 把项目记忆(上限 3000 字)与长期记忆(上限 2000 字)的摘录并进上下文包的 excerpts,部门开工前就能看到;记忆读失败不拦派发。
- 成果自动记账:新成果汇报落账后,往项目记忆追加一行(哪个部门、做了什么),重复汇报不重复记;写失败不影响成果本身。
- 新增三条路由(共 16 条):POST /memory/get、/memory/put、/memory/append;服务层未启用记忆时明确报 INVALID_STATE,不假装。
- 测试新增 6 项(记忆存储、隔离与上限、服务 API、派发注入、自动记账去重),全量 226 项通过;preflight 路由数同步为 16。
## 0.9.2 — 模型设置这次真的会落到部门身上
- 面板原来从 `ctx.remote.commands` 取指令接口,新宿主把服务挂成 `remote.commands`(要写进 inject,用 `ctx.get` 取),所以一直报「没有直接执行指令的接口」;现在按官方挂法取,并在 inject 里声明 `remote.session` / `remote.subagents` / `remote.commands`。
- 宿主返回的是 `{ ok, value: { commandId, result } }`,面板现在先解包再判断 `result.kind`,同步兼容旧的裸返回。
- 保存失败时也会把 busy 放掉:以前宿主一拒绝,两个下拉框就永久变灰点不动。
- 测试 55 项(新增「指令接口挂在 `ctx.get` 上也能静默执行」)。
## 0.9.1 — 三省与六部之间真的空开了
- 上一版只加了三省、六部**组内**卡片的间距;「三省」整组到「六部」整组之间还是贴着的。
- 这次给六部这块加 `margin-top: 16px`,任何侧栏宽度下都留出空隙,不再靠那条细连接线撑门面。
## 0.9.0 — 你也可以直接给部门派活,模型不再绕丞相
- 席位详情里新增「直接派活」:写清要办的事,点「派给礼部」,消息直接进该部门自己的会话——丞相收不到、也不参与。丞相照旧可以自己派活,两条路互不干扰。
- 派活走宿主 `subagents.prompt`(`{ requestId, parentSessionId, childSessionId, mode: "continuable", delivery: "queue" }`),每次带独立 requestId;宿主拒绝时把原因原样显示。
- 改模型不再借丞相的会话:先在部门自己的会话里执行 `/dept-model`,那个会话冷着就退到任一已登记会话——指令只写全局路由表,依然不产生对话消息、不唤醒模型。
- 测试新增 4 项(派活投递、非子会话报错、模型优先用部门会话、失败回退且不发消息),全量 54 项通过。
## 0.8.0 — 换完即存,不再惊动智能体
- 模型和推理等级改成**选完就保存**,去掉「保存模型设置」按钮;脚注直接显示「自动保存 · 当前:…」。
- 保存改走宿主 `commands/execute` 直接执行 `/dept-model`:不投递提示词、不在对话里留消息、不触发模型轮次,丞相不会因此进入大段推理。
- 宿主没有这个接口或指令尚未加载时,只在前端报错(「宿主没有执行这条指令」),不会退化成一条普通消息发给智能体。
- 测试新增两项:确认改模型时**不**调用 `session.prompt`、以及缺接口时的报错;全量 50 项通过。
## 0.7.2 — 三省与六部之间松一点
- 三省(`.sl-grid-3`)与六部(`.sl-grid-6`)的卡片间距从 8–10px 统一到 12px,三个容器断点(含 ≤620px 的两列布局)一起调,窄侧栏下也不再挤在一起。
## 0.7.1 — 十个席位都有模型设置,没召见的也能先选好
- 面板「模型设置」原来只在 `seat.present` 时渲染,没召见的部门连入口都没有。现在绑定的是席位本身:未召见的部门也能选模型,保存时同样下发 `/dept-model <角色> <provider> <model> [推理等级]`,并注明「召见后生效」。
- 未召见的席位读清单时不再传会话 id:直接读全局清单,当前值取面板里固定过的那条;保存后脚注写「该部门还没召见;保存后在召见时生效」。
- 顺带修掉一个由缺席席位暴露的 bug:`activeSeat` 在 `activeChildId` 为空时会撞上「没有会话 id 的缺席席位」(`undefined === undefined`),把标题写成「正在与吏部对话」。现在只有存在子会话时才去找席位。
- 预览脚本新增 `--absent=<角色,...>`,可以直接截「未召见的部门」这一态;演示数据补上全局清单的 `default` 字段,缺席席位才有默认可选模型。
- 测试新增「还没召见的部门也能先选好模型,保存走 /dept-model」;`node --test` 49 项全过。
## 0.7.0 — 每个部门可以单独固定模型
- 部门是子会话(`origin: "subagent"`),宿主的 `session.selectModel` 对它们一律拒绝(`session/agent-busy`,建议走 subagent delivery),所以「在这里选好就生效」原来根本做不到。现在面板改为下发 `/dept-model <部门> <provider> <model> [推理等级]` 指令,由模式插件按角色把模型写进运行时路由表并落盘 `routes.json`,`agent/request` 钩子在下一轮开工时生效。
- 模式插件新增 `parseDeptModelCommand` / `describeDeptRoutes` / `readStoredRoutes` / `writeStoredRoutes`:支持 set、`list`、`clear [部门]`,未知部门与参数不足各自给出可读原因;路由文件按 `DSH_HOME`(缺省 `~/.dsh`)下的 `sansheng-liubu/routes.json` 读写,读不到就当没固定过。
- 面板「模型设置」对部门显示「按部门固定」,选好保存即固定,脚注显示「该部门固定使用此模型」;每个部门的固定值用 `localStorage` 记在面板侧(`sansheng-liubu.route.<角色>`),用于显示当前模型。
- 预览脚本新增 `--seat=<角色>`,可以直接截某个部门的详情;演示数据补了 `localStorage` 与部门子会话地址,工部示例固定为 DeepSeek V4。
- 测试:客户端新增「改模型改由丞相会话下发 /dept-model」「固定路由从面板记录读出来当当前模型」两项;策略侧新增指令解析与路由文件往返用例。`node --test` 48 项全过。
## 0.6.0 — 模型选择真的能用了
- 部门设置里的模型清单原来靠 `modelDirectories.directoryFor(sessionId)` 取该会话的目录,而这个方法只认「本页登记过的会话」,于是每个还没在面板里打开过的部门都读不到模型。现在清单改从宿主的全局目录 `modelDirectories.catalog` 读(`catalog.load()` 一份,所有部门共用),不再依赖会话登记。
- 保存模型改成真正的 RPC:有 `ModelDirectory` 时走 `directory.select(...)`,没有时直接 `remote.session.selectModel({ sessionId, provider, model, reasoningEffort })`。**没在本页打开过的部门也能改模型**,保存后立即生效。
- 「当前模型」读不到该部门自己的选择时,退回全局默认并标明「跟随默认」,不再冒充成别人的选择;界面脚注会说明「该部门会话未在本页打开,选好保存后直接生效」。
- 错误分级:服务缺失 →「当前宿主没有全局模型清单(modelDirectories.catalog)」;清单读取失败 →「读取模型清单失败:<原文>」;6 秒超时 →「读取模型清单超时(显示已知缓存)」;宿主拒绝保存 → 「<code>:<message>」。
- 测试从 4 项模型用例重写为 6 项:服务缺失、清单来自全局且不依赖登记、未登记时保存走 RPC、宿主拒绝原文、清单读取失败保留缓存、正常路径;`node --test` 客户端 35 项全过。
## 0.5.7 — 模型目录读不到时说清是哪一步断了
- 部门设置里的「当前宿主未提供模型目录」不再是一句万能提示。原来 `modelDirectoryOf` 把三种情况都吞成 `undefined`:取不到 `modelDirectories` 服务、`directoryFor` 方法不存在、`directoryFor(sessionId)` 抛异常。现在分别返回 `{ service: false }`、`{ error }`、`{ directory }`。
- 宿主的 `ModelDirectoryResolver.directoryFor` 在该会话没登记时抛 `ui-model-selection: session "<id>" resolved no scope / no binding`。这种情况不再报「宿主未提供模型目录」,而是**借另一个已登记会话的目录把全局模型清单列出来**:列表照常可选看,`current` 留空不冒充别人的选择,保存按钮禁用并写明「进入该部门会话后才能改模型」。其它异常(服务崩溃、超时、快照读取失败)原样带出原文,同时用 `[三省六部]` 前缀在控制台留下会话 id 与原始错误。
- 新增 `sessionsOtherThan`(最近活跃会话 → 任意已登记会话)做兜底;`loadCatalog` 的投影收敛成一个 `project()`,成功/超时/兜底三条路径共用,`unresolved` 随结果返回给界面。
- 新增 4 项测试:服务缺失、会话未登记时兜底且不冒充当前选择(含 `selectModel` 拒绝)、其它异常原样带出、正常路径。`node --test` 43 项、`node --check`、`git diff --check`、`check-install` 全过。
## 0.5.6 — 左栏那一行改名「上朝」并置顶
- 按用户要求把左侧栏导航行的标签从「三省六部」改成「上朝」,`order` 从 10 改为 −100,排在「插件」以外所有插件行之前(`插件` 恒列首行,是宿主写死的)。
- 只改呈现,不动行为:点击仍然是停靠右侧栏的 `main` 重定向桩。
- 39 项测试(含新增的「标签是上朝、order 为负」断言)、`node --check`、`git diff --check`、`check-install` 全过。
## 0.5.5 — 左栏只留一处入口
- 撤掉 0.5.3 的左侧栏底部入口(`sidebar.footer.action`)与它的 `SanshengRailAction` 组件、8 条 `.sl-rail-*` 样式(`.sl-rail-mark` 保留,重定向桩还在用)。0.5.4 之后左栏同时有导航行和底部一行,是同一功能的两个入口,按用户要求收敛成一个。
- 左栏现在只有「插件 / 定时任务 / 任务看板 / MCP 连接器」那一列里的「三省六部」一行;会话头部的「三省」开关仍是另一处入口(两处都只做停靠,不是两套面板)。
- 删掉 2 条只服务于底部入口的测试,槽位断言回到五个;39 项测试、`node --check`、`git diff --check`、`check-install` 全过。
## 0.5.4 — 入口搬进左侧栏导航列
- 用户要的不是底部那一条,而是「插件 / 定时任务 / 任务看板 / MCP 连接器」那一列;那一列只认 `sidebar.panellist`,于是注册一行导航:`id: sansheng-liubu`、`order: 10`、`label: 三省六部`,图标是插件画的 18px 细线「三」字样标(`SanshengNavGlyph`,激活时线宽 1.6)。
- 那一列的点击行为由宿主写死为 `selectPanel(id)`,一定要 `main` 槽,所以同时注册 `main`(`key: sansheng-liubu`)作为**重定向桩**:`SanshengDockRedirect` 挂载后立刻调 `dockToSidebarTab(host)`,停靠右侧栏、清掉旧提示、`selectPanel(null)` 退回原会话;没有会话时只在页面中央写明原因(`.sl-dock-stub`)。它不渲染朝堂、不承载聊天,这是对 0.5.0「两个槽一律不注册」的收敛式修订。
- 底部入口(`sidebar.footer.action`)保留:两处入口等价,共用同一条提示存储。
- 新增 2 条测试:导航行与 `main` 桩的注册(含 `label()` 与 `key`)、`dockToSidebarTab` 成功/失败两条路径(失败时不得 `selectPanel`)。另修了断言写法:`h("svg", props, [children])` 在测试替身里是单层嵌套,要先 `.flat()`。
- 41 项测试、`node --check`、`git diff --check`、`check-install` 全部通过。
## 0.5.3 — 左侧栏也有三省六部入口
- 在左侧栏底部(`sidebar.footer.action`,`id: sansheng-liubu:rail`)加了一个常驻入口:只做「把朝堂停靠到当前会话的右侧栏」,与会话头开关共用同一条提示存储,不切整页面板、不新增聊天存储。
- 折叠侧栏时只剩「三省」字标;展开时补上「三省六部 / 收起朝堂」文字,失败原因显示在文字下方(`role="status"`,最多两行,完整文本在 `title` 里),字标转红作为折叠状态下的可见信号。
- 不再用 `sidebar.panellist`:那个槽的点击会走 `selectPanel` 去要 `main` 槽,而 0.5.0 起不再注册 `main`,点进去只会得到空面板。
- 修掉会话头开关的一个连带问题:失败时原来会回退到 `host.togglePanel()`,同样指向不存在的整页面板;现在只写提示。
- 新增 3 条测试:左栏入口的注册与两种宽度下的渲染、无会话时的可见原因、以及「失败时不得 `selectPanel` 到无 `main` 槽的面板」。
- 39 项测试、`node --check`、`git diff --check`、`check-install` 全部通过。
## 0.5.2 — 断点跟随侧栏容器,窄栏不再挤压状态说明
- 响应式断点从浏览器视口改为面板容器:`.sl-root` 声明 `container-type:inline-size;container-name:slpanel`,11 处 `@media (max-width: …)` 全部换成 `@container slpanel (max-width: …)`。真实宿主窗口最大化时侧栏仍只有 371px,旧的视口断点一个都不会触发,等于窄栏样式从来没生效过。
- 删掉 `.sl-compact .sl-grid-3,.sl-compact .sl-grid-6` 的强制两列:它优先级高于容器断点,会把单列规则压死。现在列数完全由容器宽度决定。
- 单列阈值落在 330px 容器宽(约 348px 侧栏):360px 及以上保持两列,320px 降为单列。
- 部门配置里的「最近活动」独占一行、最多两行后省略,不再和状态文字挤在同一行被裁断;`panel/lib/client.js:891` 的 `shortText(…, 46)` 保持不变。
- `scripts/preview.mjs` 新增 `--viewport=<像素>`:窗口可比侧栏宽,用来复现「大窗口 + 窄侧栏」的真实宿主形态;新增 371px、320px 两张入库预览图。
- 新增两条回归测试:禁止视口 `@media` 断点且必须保留容器断点;`.sl-detail-status small` 必须独占一行且不得 `white-space:nowrap`。
- 36 项测试、`node --check`、`git diff --check`、`check-install` 全部通过。
## 0.5.1 — 清掉侧栏化残留,会话头开关不再静默
- 删除侧栏化后不再渲染的旧样式:独立聊天栏、整页面板壳、`sl-left-nav`、`sl-task-jump` 等 46 个类共约 117 行规则;CSS 由 374 行收到 257 行。
- 删除无调用点的 `SanshengPinRow`、`DockButton`,以及已经没有外部消费方的 `SidebarIcon` 导出;`panel/lib/client.js` 由 1890 行收到 1758 行。
- 会话头部开关在拿不到会话、或宿主没有右侧栏服务时,把失败原因直接显示在开关旁(`role="status"`,完整文本放在 `title`),不再静默回退成整页面板。
- 新增两条回归测试:开关失败提示的渲染与清除;`className` 里出现的每个 `sl-*` 类都必须有对应 CSS 规则,防止样式与组件再次脱节。
- 去掉 `sl-side-pane`、`sl-control-model`、`sl-control-effort` 三个「有类名、无规则」的幽灵类名。
- 34 项测试、`node --check`、`git diff --check`、`check-install` 全部通过。
## 0.5.0 — 收进右侧栏,聊天回归 DSH 原生
- 移除整页「三省六部」面板、丞相主对话摘要卡和第二套聊天入口;聊天统一使用 DSH 原生输入框与消息流。
- 朝堂编制与任务流转收进会话右侧栏:顶部「朝堂 / 任务」页签、四张统计卡、组织图与选中部门配置在同一侧栏内滚动。
- 在原生输入框输入 `@` 选择部门后进入其子会话;右侧栏自动选中对应部门,返回丞相时恢复丞相选中。
- 移除 `main`、`sidebar.panellist` 和 `sidebar.panellist.actions` 注册,只在会话头部与右侧栏注入入口,不再占用工作区主视图。
- 侧栏顶部改为紧凑状态行:协作状态、`输入 @ 选择部门` 提示与子会话返回按钮;统计卡可点击切换朝堂/任务。
- 移除 Agent 预设编辑与重复「下旨」输入;部门设置只保留固定职责、模型/推理等级和会话入口。
- 策略插件与面板版本推进到 0.5.0;侧栏结构、槽位注册、@ 导航和自动选中均有回归测试。
## 0.4.2 — 原生 @ 部门成员
- 在 DSH 原生会话输入框注册 `@` 来源,候选为已建立的九个子 Agent 会话;主对话仍使用宿主原有输入框,不新增第二套聊天。
- 选择 `@中书省`、`@工部` 等部门后进入该成员的现有子会话,随后直接在原生输入框发送任务;不会把消息静默转发或改写接收人。
- 进入子会话时右侧朝堂图自动选中对应部门,部门配置同步切换;返回丞相主会话时恢复选中丞相,不再出现“人在工部、面板还选着丞相”的错位。
- 面板主对话区提示改为「输入 @ 可直接找部门成员」;未设官、没有会话的部门不出现在候选中。
- 新增 @ 候选与会话导航回归测试;32 项策略和客户端测试通过。
## 0.4.1 — 重设计朝堂面板
- 按 DSH 原生主题变量重构面板:品牌与朝班状态头、丞相主对话卡、独立任务流转区、右侧统计与部门配置。
- 部门改为边界清楚的实体卡片:蓝灰描边、字徽、名称与中文状态;选中态使用蓝边、浅蓝底和勾选标记。
- 朝堂图固定为「丞相 → 三省 → 六部」:丞相连接三省,尚书省连接整个六部分组;六部两排三列,明确同属一级。
- 左侧增加「主对话 / 任务流转」切换;点击「在办任务」统计卡或对话区入口,可直接切到任务流转。
- 点击「在朝成员」统计卡进入全宽朝堂编制:收起左栏与统计,组织图和部门配置铺满面板;顶栏或地图头部均可返回协作台。
- 设置区移除 Agent 预设输入与重复的「下旨」文本框,只保留固定职责、模型/推理等级和「与某部对话」。
- 新增子 Agent 会话入口:选中部门后直接打开其 DSH 子会话;顶部可返回丞相主会话,不再另造聊天存储。
- 统计保持两列两行;右侧栏、窄屏和紧凑侧栏分别减少列数,卡片状态行不再塞入任务计数。
- 修复空闲状态显示为英文 `idle` 的问题;深色与明亮模式共用结构,颜色均由 DSH 主题变量派生。
- 策略插件与面板版本推进到 0.4.1;当时 31 项策略和客户端测试通过。
## 0.4.0 — 补齐六部
- 角色由七席扩为十席:丞相 + 三省 + 吏、户、礼、兵、刑、工六部;新增 `COURT_ROLES` 作为唯一编制来源。
- 新增 `libu`(吏部)、`hubu`(户部)、`xingbu`(刑部)角色提示词;`libu` 由「礼部」改为「吏部」,礼部改用 `lipu`,避免与吏部拼音重名。
- 按职责重划写入边界:吏部/户部只有 write、edit;礼部、刑部另有命令行;兵部另含远程与 MCP 通道;工部独有 Image-gen 生图。
- 尚书省提示词改为按吏户礼兵刑工分工、只召集真正用到的部门;丞相提示词同步十席组织。
- 面板朝堂图改为「丞相 → 三省 → 六部」三排结构,六部同排直隶尚书省;座位计数与测试同步到十席。
- 版本推进:策略插件 0.4.0,面板 0.4.0。
## 0.3.7 — 上朝改为手动启用
- 包自带的 `cordis.patch.yml` 改为空层(`[]`):装包不再往模式选择器里注册「上朝」,也不再能成为新会话的默认模式。
- 新增 `preset.patch.yml`:想上朝时把它的 `- insert:` 段合并进 profile 的 `cordis.patch.yml`,重启后才会出现该选项。
- 新增 `scripts/mode.mjs`(`npm run mode -- on|off|status`):带标记地写入/撤回那段 insert,可逆且幂等,不会替你选中模式。
- `scripts/check-install.mjs` 改为校验「装包不等于开模式」:包内 patch 必须不含预设行,`preset.patch.yml` 必须能复现同一 preset id,并报告当前是否已启用。
- README 补「启用方式」与 Git 回滚,删除已失效的 backup 目录回滚说明。
## 0.6.2 — 默认进入丞相
- 将尚未加入 Agent Team 的新会话主 Agent 直接映射为丞相(Lead)。
- 使用“上朝”模式后可立即与丞相对话,不再需要手动切换默认 Agent。
- 已加入团队的中书、门下、尚书、工部、礼部和兵部角色映射保持不变。
## 0.6.1 — 交由 dsh-image-gen 执行
- 上朝不再重复注册 `generate_image`,避免与 `dsh-image-gen` 工具冲突。
- 工部获准使用 Image-gen 的 `generate_image`、`generate_images` 和 `edit_image`。
- Provider、凭据、模型、计费与图片保存全部交由 Image-gen 管理。
- 上朝仅保留角色职责、任务准奏和工具权限边界。
## 0.6.0 — 普通百炼生图
- 工部恢复 `generate_image`,使用普通百炼 `/images/generations` 接口。
- 通过 DSH 凭据服务读取 `BAILIAN_API_KEY`,源码不保存密钥。
- 默认 dry-run,真实调用必须显式 `live=true`。
- 固定三模型白名单,无其他图片渠道 fallback。
- 保留其他图片生成和编辑工具的拒绝策略。
## 0.5.1 — 移除上朝生图能力
- 删除 `generate_image` 工具注册、请求构造、参数矩阵、付费开关及网络调用实现。
- 删除 `sansheng-liubu:imagegen` 提示词块和相关可选能力探测。
- 工部恢复为识图、OCR、截图与视觉分析,不提供生图或图片编辑。
- 策略明确拒绝所有图片生成和编辑工具。
- 保留工具审核开放制、执行部门文件工具、管理型工具审批与审计逻辑。
- 删除生图使用文档;mode id 和 preset id 保持不变。
## 0.5.0 — 工具审核开放、六部配笔与千问生图
### 变更范围
- 将管理型工具的一刀切禁令改为审发分离:丞相可调用并记录审计日志;部门须持门下省准奏记录;兵部负责装配、发放、回收、登记和销账,只发不批。
- 兵部、礼部、工部获得 `read`、`write`、`edit`、`bash`、`grep`、`glob` 等执行工具;中书、门下、尚书维持只读工具集。
- 该版本曾向工部加入可选生图能力,已在 0.5.1 移除。
### 历史缺陷防复发
- `sansheng-liubu:role` 使用共享安装引用计数保护,不重复注册。
- 未引入 `sanshengLiubuGeneration` preset service;模式沿用 agent 原生 scope。
- preset 只保留 `sansheng-liubu-policy` 单一引用,未接入 v2、v3 或 v031 陈旧链。