Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ Versions follow the merge of a `*_release-v*` branch; CI publishes to npm on tag
- **系统架构文档体系落地(owner 指令 2026-11-08):`docs/architecture/` 成为实时维护的架构枢纽**:新增 `docs/architecture.md` / `docs/architecture.zh-CN.md` 总枢纽(整体架构图中英双版转正 + 8 模块总表),首个样板模块页 `docs/architecture/storage.{md,zh-CN.md}`(统一存储:职责/原理/工作机制/硬不变量,配模块图中英双版)。文件级地图 `reference/architecture.md` 补齐 125 个缺失条目(新存储层 / marker / fastpath / lanes 等全部新模块)并升级为 CI 强制全量覆盖。新增 CI 车道 `architecture-docs`(`tools/check-architecture-docs.mjs`):地图覆盖全 `src/` 文件、总表↔页面成对、图 svg 优先 + png 备选齐备、SVG 基础良构(未转义 `&` 曾让英文图线上破图)。AGENTS.md「Documentation Layout」新增实时维护规则:改结构 ⇒ 同 PR 更新页 + 图 + 总表。其余 7 个模块页(pipeline / lanes / kernel / identity / fastpaths / webui / update)同一 PR 全部补齐——总表 8 行全 ✅(每页 = 中英双版文档 + 中英双版图)。

### Fixed
- **dsh 桌面副本自动更新尊重宿主 pnpm minimumReleaseAge 成熟度窗口(#7139)**:DSH 桌面 profile 是 pnpm 管的(可配严格 `minimumReleaseAge`,如 1440 分钟),而 bili 桌面副本自动更新(`refreshDshDesktopCopy`)直接抓新版 tarball 安装,从不查宿主成熟度策略——新版没过窗口也照装,manifest/lockfile 随之收敛到新版,pnpm store sections 却只有旧版 resolution:profile 上任何无关的 pnpm 操作随后报 `ERR_PNPM_LOCKFILE_MISSING_DEPENDENCY` / `ERR_PNPM_RESOLUTION_POLICY_VIOLATIONS_UNHANDLED`,严格 lock-only 修复要等版本成熟才成功。现在自动更新路径在安装前做成熟度门:策略按 pnpm 自身优先级逐键解析(env `pnpm_config_*` > 项目 `pnpm-workspace.yaml` > 项目 `.npmrc` > 用户 `~/.npmrc` > 全局 `$XDG_CONFIG_HOME/pnpm/config.yaml` > `$PREFIX/etc/npmrc`,首个定义者胜),`minimumReleaseAgeExclude` 按 pnpm version-policy 语法匹配(裸名/无版本通配名 = 整包豁免,`name@v1 || v2` 精确版本并集,名字支持 `*`/`?` glob);发布时间取 registry 完整 packument 的 `time` 字段(缓存进 bili cache 目录,同版本不重复抓取,进程内 memo 兜底)。判定:无策略 / 被豁免 / 已成熟 → 照常进行;未成熟 → 本轮推迟(不记 strike,下轮重试,命中缓存时零流量);发布时间或策略无法确立(registry 失败/无 time 字段/值畸形/配置不可读)→ **fail closed**(记 strike + warn,副本/manifest/lockfile 一律不动,绝不绕过宿主策略)。**旧行为→新行为**:桌面副本自动更新路径此前无条件安装,现在未成熟版本被推迟(方向 = 尊重宿主显式策略);advisory 强制安装 / 面板安装路径不在本门范围(它们面向已成熟的旧版本)。不引入新 bili 配置键——读的是宿主 pnpm 配置。回归:tests/release-maturity.test.ts(19 例:策略优先级/各来源形态/畸形值 fail-closed/exclude 语法全集/门判定/时间缓存)、tests/update-desktop-inplace.test.ts(新增 7 例:未成熟推迟且副本+manifest+lockfile 字节级不变 / 整包豁免放行 / 他版本豁免不解除门 / 已成熟照常收敛 / 无 time fail-closed / 网络失败 fail-closed / 畸形策略在流量前 fail-closed)。
- **纯 SQLite 姿态下证实损坏不再静默降级 JSON,改为响亮拒启(owner 策略 2026-11-21,#7156 生产事故)**:quick_check 证实 index.db 损坏(含「首个 post-open 写入」撞损坏的大库/缓存判决分支,#7156 FIX4)且进程有效姿态是**纯 SQLite**(有效 mode full + sqlite 后端 + 无加密 + jsonWriter off = 2026-11-13 缺省翻转后的缺省,或显式 off)时,旧契约(响亮告警 + 不挂索引照常启动、JSON 信封服务)在这里会服务一个近乎为空的非持久视图,其后每一轮都只落在非持久副本里——静默丢持久历史,比损坏本身更糟(实测现场:0.1.216 的 3.2GB index.db 损坏后自动「降级 JSON」,面板显示 requests:2/上下文 0,而真实 1563 请求/124k 上下文/$12.41 成本全在索引里)。现在该姿态 REFUSES TO START:文件原样不动(不搬不拷不重建),日志与诊断面只给可操作的手工修复(备份 index.db/-wal/-shm → 手工移开 → 再启动,从双写期信封重建);`BILI_STORAGE_ALLOW_LEGACY_DEGRADE=1` 可有意识地恢复旧降级路径(永不缺省、不被任何配置值隐含)。其余姿态(显式双写 full、shadow、legacy、网络后端、加密)信封仍是真恢复来源,旧契约逐字节保持。姿态判定是纯函数(与 persist 的 jsonWriterOff 同一公式,两开关永不分歧);拒启被记录进诊断面(`/__bili/status` 与 diagnostics 可见「REFUSING TO START (pure-sqlite stance)」前缀)且每次启动都重新生效(latch 只短路进程内重扫)。回归:tests/issue7156-pure-sqlite-refusal.test.ts(姿态真值表 + 两种纯 sqlite 拼法与 file 层的损坏拒启/逃生阀/重复拒启 + 字节不变断言 + 双写姿态保留降级契约)、tests/issue4816-integrity-throw-quarantine.test.ts、tests/acp-status-storage-degraded.test.ts、tests/web-storage-banner.test.ts、tests/storage-durability.test.ts 与 storage 全量套件绿。
- **信封导入不再顶掉 index 已有的压缩块谱系与生命周期统计(#7156 事故第二现场,2026-11-21)**:#7156 的生产现场里,降级窗口(不挂索引、纯信封服务)内的一次会话保存把信封里的 32 个粗块结构写进了 `importRecord`——它把信封当成权威谱系:按 incoming 集合先删后插,index 里 103 个更细的压缩块(及其 summary/content 引用链)被整批删除,生命周期统计也从 requests:1563/124k 上下文/$12.41 成本回退成 requests:2/0。之后每一轮 preflight 都在 32 粗块的地基上折叠,上下文装不进模型窗口、会话不可用。现在 `ingestSession` 新增 `envelopeImport` 标记(仅 `UnifiedShadow.importRecord`/`importRecordAsync` 两个导入入口传):存储侧已有块谱系时**只采纳信封里 seq 更高的新消息**,块谱系与 stale 清理一律跳过(index 无块的真正首开导入不变,仍整体采纳信封结构);stats_json 同带单调守卫——envelopeImport 下已存 requests ≥ 传入 requests 时保留已存值(仅导入路径生效,organic 保存仍是权威且零额外开销)。回归:tests/envelope-import-block-lineage.test.ts(细块保留 + stats 只升不降 + 首开导入采纳 + organic 权威语义不变 + importRecord wiring 五用例)、tests/storage-ingest-watermark.test.ts。
- **dsh 运行时注册的 preset 继承压缩完全禁止(#7190,关 #7178 / #7062 / #7169)**:dsh 的 preset 注册表 `AgentPresetRegistry.register(definition)` 是**启动后才出生**的 preset 行唯一的出生点,它把嵌套行直接挂进内存 PresetTree(其 `commit()` 为空实现),从不经过 loader 的 `internal/config` 变换——bili 的 #4147 结构性 disable 重写(`bili-compaction-gate`,#3354/#3662)永远碰不到这些行。于是运行时注册 preset 的压缩引擎是全副武装的(每步压力触发 + 模型切换前置压缩 + 溢出恢复三条触发器都在 dsh 的 surface 计量上点火),而 bili 侧 wire guard 拒绝每一次压缩调用:#7062 的逐步 422 风暴、#7178 的模型切换死局(`MODEL_SWITCH_COMPACTION_FAILED` 永不满足前提)、#7169 的 landed-checkpoint 触发 rebase 抹掉 bili 自己的折叠块再 DIGEST DRIFT 冻结信封,全是这台引擎在开火。修法与 boot-time 行同一判决、同一机制:gate 入口(always-on,bili-native 关着也活着)现在包一层 `agentPresets.register`——定义里的 compaction-basic / command-compact 行在挂入前就地改写为 `disabled: true`。判决按每次注册调用检查(bili-native 没宣告持线 = 定义原样通过,dsh 原生压缩照常);无 compaction 行 / 畸形定义按身份原样通过(注册表自己的校验看到字节级相同的输入);Symbol-for 标记保证重 apply 不双重包裹;宿主没有该注册表 = 无运行时 preset 可注册,静默不包裹。遥测新增 `runtime` / `runtimeWrapped` 维度,#6770 覆盖一行据此报告「register() 已覆盖——尚无运行时注册」或「N 个运行时注册被改写」,wrap 未知时不报假缺口。**非模型可见文本改动**(只动 dsh 侧 web banner 的覆盖一行与日志)。dsh 源码依据(deepseek-ai/deepseek-harness @ 2e39e70,与现场 0.2.2-rc.3 逐点核验一致):`packages/preset/agent-preset-registry/src/index.ts:96`(register 立即激活、重复 id 抛错)、`mount.ts:22-23`(PresetTree 空 commit)、per-fiber `internal/config` waterfall(`vendor/cordis/src/fiber.ts:691-700`)——preset 作用域 fiber 在自己的上下文里解析配置,根上注册的 global hook 不触发。回归:tests/issue7190-dsh-runtime-preset-coverage.test.ts(新增 10 条行驱动正反用例:改写/身份保持/判决关/重包裹/`this` 转发/无注册表降级/get 回退/遥测去重 + 覆盖文案四形态)、tests/issue3354-dsh-compaction-disable.test.ts、tests/issue6770-compaction-coverage-text.test.ts、tests/issue4147-dsh-overlay-structural.test.ts 全绿。
Expand Down
4 changes: 3 additions & 1 deletion docs/architecture/update.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,8 @@ Get every copy of bili on a machine to the newest version without bricking anyth

**Ledger convergence.** The desktop dsh profile is the one copy bili owns outright; its self-heal swaps `node_modules/billion-context` directly, so `convergeDshLedger` (`src/dsh-ledger.ts`) also moves the profile manifest's declared spec AND the lockfile's recorded resolution in the same operation (#3496) — a writer that moves only the copy manufactures the drift #3224 detects. Pre-existing drift converges on explicit demand only: `bili doctor --fix`. `plugin-install.ts` only drives the host's own channel (`dsh plugin add`), never installs a second copy beside it (#966).

**Maturity gate.** Before the desktop self-heal installs a new version, `release-maturity.ts` checks the host's pnpm `minimumReleaseAge` policy — resolved per key in pnpm's own precedence (env `pnpm_config_*` > project `pnpm-workspace.yaml`/`.npmrc` > user `~/.npmrc` > global config), with `minimumReleaseAgeExclude` matched by the pnpm version-policy grammar. An immature release is deferred to the next cycle (no strike); if the publish time or the policy cannot be established, the refresh fails closed (strike, copy/manifest/lockfile untouched) — the updater never bypasses the host's maturity policy (#7139).

**Advisory & restart.** `advisory.ts` watches for critical defects and files an advisory (#1481 — a human acts, the machine never rolls back on its own); `update-notes.ts` carries tiered release notes (severe-only by default, #1870); `restart.ts` offers opt-in self-restart once newer code is on disk (#811).

## Hard rules
Expand All @@ -31,7 +33,7 @@ Human-review tier (§7.4) — no auto-merge; changing `update.ts` requires a NO-

## Key entries

`src/update.ts` (updater — load-bearing) · `src/advisory.ts` · `src/restart.ts` · `src/plugin-install.ts` · `src/dsh-ledger.ts` · `src/dsh-channel.ts` · `src/pi-channel.ts` · `src/launcher.ts`
`src/update.ts` (updater — load-bearing) · `src/release-maturity.ts` (pnpm maturity gate for the desktop lane, #7139) · `src/advisory.ts` · `src/restart.ts` · `src/plugin-install.ts` · `src/dsh-ledger.ts` · `src/dsh-channel.ts` · `src/pi-channel.ts` · `src/launcher.ts`

## Related

Expand Down
4 changes: 3 additions & 1 deletion docs/architecture/update.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,8 @@

**三账收敛。** 桌面 dsh profile 是 bili 唯一完全自有的拷贝;它的自愈直接换 `node_modules/billion-context`,所以 `convergeDshLedger`(`src/dsh-ledger.ts`)同一操作里还要挪 profile manifest 的声明 spec 与 lockfile 的记录(#3496)——只挪拷贝的写者会亲手造出 #3224 检测的那种漂移。既有漂移只在显式要求时收敛:`bili doctor --fix`。`plugin-install.ts` 只驱动宿主自己的通道(`dsh plugin add`),绝不在旁边装第二份(#966)。

**成熟度门。** 桌面自愈安装新版本前,`release-maturity.ts` 先查宿主的 pnpm `minimumReleaseAge` 策略——按 pnpm 自身优先级逐键解析(env `pnpm_config_*` > 项目 `pnpm-workspace.yaml`/`.npmrc` > 用户 `~/.npmrc` > 全局 config),`minimumReleaseAgeExclude` 按 pnpm version-policy 语法匹配。未成熟版本推迟到下轮(不记 strike);发布时间或策略无法确立时 fail closed(记 strike、副本/manifest/lockfile 一律不动)——更新器绝不绕过宿主的成熟度策略(#7139)。

**通告与重启。** `advisory.ts` 观察严重缺陷并开 advisory(#1481——人来处置,机器永不自行回滚);`update-notes.ts` 承载分级 release notes(默认只 severe,#1870);`restart.ts` 在新代码落盘后提供可选自重启(#811)。

## 硬规则
Expand All @@ -31,7 +33,7 @@

## 关键入口

`src/update.ts`(更新器——承重件) · `src/advisory.ts` · `src/restart.ts` · `src/plugin-install.ts` · `src/dsh-ledger.ts` · `src/dsh-channel.ts` · `src/pi-channel.ts` · `src/launcher.ts`
`src/update.ts`(更新器——承重件) · `src/release-maturity.ts`(桌面车道 pnpm 成熟度门,#7139) · `src/advisory.ts` · `src/restart.ts` · `src/plugin-install.ts` · `src/dsh-ledger.ts` · `src/dsh-channel.ts` · `src/pi-channel.ts` · `src/launcher.ts`

## 相关

Expand Down
1 change: 1 addition & 0 deletions reference/architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -171,6 +171,7 @@ billion-context/
│ ├── external-summary-surface.ts # Tool/schema and client-facing summary contract
│ ├── external-summary-marker.ts # Zero-import marker contract for externally summarized blocks
│ ├── update.ts # Self-updater (load-bearing — no-op release protocol) + install lanes
│ ├── release-maturity.ts # pnpm minimumReleaseAge gate for the dsh desktop auto-refresh: host policy resolution (env > project > user > global), exclude matching, registry publish-time fetch + cache, fail-closed verdicts (#7139)
│ ├── advisory.ts # Critical-defect advisory watcher (#1481)
│ ├── plugin-advisory.ts # dsh cost-advisory detection + TTL cache (#2462)
│ ├── host-plugin-notice.ts # Known host-side metering plugin notice + dismiss state (#2861)
Expand Down
Loading
Loading