2026-09-15 文档同步

上游变更概览

本次同步覆盖上游提交范围 c291e7961a51..0d1f50007f9b，主要包含以下重要变更：

1. Profile 解析模式引入（PR #4104）：新增三种 profile 包解析模式（link/dual/runtime），重构 profile 模块解析机制，支持运行时直接解析与双模式验证
2. Web 客户端 UI 改进：钉住式可折叠标题（Think/compaction header sticky）、compaction 摘要代码横幅定位修复、客户端 combo 装配延迟优化、草稿编辑器隔离重构
3. 原生缓存管理重构：boot 链路使用 addon 管理的原生缓存，移除 profile-resolution 服务中的私有缓存生命周期
4. dsh 0.1.6-alpha.1 发布：包含 builtin loader 升级到 0.1.6、profile 解析边缘情况修复、Windows 路径规范化等

文档更新详情

part3-core/ch8-boot-chain.md

• 新增 8.8 节"Profile 解析模式"：说明 ProfileResolutionMode = 'link' | 'dual' | 'runtime' 三种解析模式的工作机制

  • link 模式（默认）：物化 .dsh-module-fallback/ 目录下的符号链接，保持向后兼容
  • runtime 模式：通过 Node 的 ESM 与 CommonJS 解析器直接安装 generation，不创建磁盘链接
  • dual 模式：物化链接表并与 Node 的磁盘结果对比验证
  • 说明 ctx.pluginPackages 服务暴露同一代的包元数据
  • 说明 Worker 构建横幅导入 profile-resolution-bootstrap 并在 isolate 中安装 generation

• 更新 8.9 节小结：新增 Profile 解析三模式说明，强调默认 link 模式保持向后兼容

part3-core/ch9-profile-bundle.md

• 新增 9.9 节"原生缓存与 Worker 隔离"：说明 0.1.6-alpha.1 的原生缓存管理变更

  • 原生缓存生命周期由 addon 管理而非 profile-resolution 服务自行管理
  • Windows 平台上 Worker 环境暂时提供私有的缓存目录（dsh-profile-resolution-native-*）
  • Worker 构建横幅导入 @deepseek-ai/dsh-app-boot/worker/profile-resolution-bootstrap
  • 每个 Worker 在自己的 isolate 中安装结构化克隆的 generation

• 更新 9.10 节小结：新增原生缓存管理与 Worker 隔离说明

part4-web/ch17-web-client.md

• 新增 17.27 节"Sticky Headers 与 Compaction Banner 改进"：说明 0.1.6-alpha.1 的长对话滚动体验改进

  • feat(web): pin Think and compaction headers sticky while scrolling：Think 与 compaction 的 section header 钉在滚动视口顶部
  • fix(web): hold a compaction summary's code banner below the pinned header：修复 compaction 摘要中 fenced code block 的 Copy 横幅与钉住 header 重叠的问题
  • 横幅停在 header band 下方，钉住 header 的边角改为方形（border-radius: 0）
  • 说明该修复与 17.16 中的 perf(ui-chat): contain collapsed reasoning layout 配合优化长推理链可读性

• 更新 17.28 节设计亮点小结：新增第 21 项"Sticky Headers 与 compaction code banner 位置修复"

未影响文档的变更

以下上游变更未触发文档更新：

• perf(web): defer client combo assembly：内部性能优化，将 combo 脚本装配延迟到首次 GET 请求，不改变外部行为
• refactor(web): isolate draft editor implementation without behavior changes：草稿编辑器实现隔离重构，明确标注"无行为变更"
• perf(typert): materialize generated schemas on first use：typert 内部性能优化，不影响用户可见的 schema 生成行为
• perf(runtime): defer optional native dependencies：运行时启动性能优化，不改变用户可见的启动链路行为
• feat(util): add caller-relative lazy require：内部工具函数，未在用户文档中描述
• Desktop 相关变更：feat(desktop): run runtime host from asar、fix(pkg): restore VFS Dirent reads 等，本书不涉及 Desktop 应用章节
• 测试基础设施改进：test(boot)、test(desktop) 等测试相关变更不影响用户文档
• 内部重构和代码清理：多个 fix(boot) 提交属于 profile 解析边缘情况修复，已在 8.8 节概述中涵盖