更新日志

本站随上游仓库 deepseek-ai/deepseek-harness 的更新持续维护。这里按时间倒序记录每次教程内容的变更，方便读者快速了解本书有哪些新内容。

本栏目由每日自动化任务维护。每天检查上游仓库是否有新提交，若有更新则同步修订对应章节，并在此记录。

2026-09-29

• 上游 master 由 477b4f4205（0.1.7-rc.2）推进至 4878cdabd8，共 261 个新提交，发布 0.2.0-rc.1（tag 指向当前 master）。版本号从 0.1.x 跨入 0.2.x：官方口径从「面向 Harness 开发者内测」转为「面向所有用户的预览版」，首次启动弹窗随之从内测声明更名为预览版说明，文案改为「0.2 版本仍处于预览阶段……新的桌面端开箱即用，进阶功能仍可在开发者模式中使用」。09-28 自动化未运行，本次一并覆盖。
• 重写 4.11 定时提醒的启用方式：0.2.0-rc.1 起发布的 Web 组合不再携带 time-context / schedule / ui-schedule 三行（此前是携带但禁用），改为随安装附带 @deepseek-ai/dsh-experimental-schedule-bundle 可选组合包——插件页官方分组里的自动化任务（默认关闭、带实验性标签），开关一打即启用三件套；组合包声明行随包整体开关（dsh.bundle.rowSwitches: false），三行没有各自的开关。FAQ 与小结同步；三行 patch 方式保留为 0.1.7 时代的历史说明。
• 修订 3.2 看懂工具调用树：
  • 工作步骤展示默认档变更：0.2.0-rc.1 起网页端新会话默认从标准改为详细（ui-chat.transcriptView 默认值变更，桌面端保持标准），四档表格的默认标注更新；升级前存过的旧偏好（normal / expanded）一律读为详细。
  • 新增运行状态行说明（0.2.0-rc.1 完整形态）：运行中轮次下方出现细分隔线 + 鲸鱼尾巴轮廓动画（原生 SVG，3 秒摆尾循环，尊重系统减弱动态偏好）+ 微光文字「深度求索中，用时 xx」（实时跳动的等宽数字）。
• 修订 6.1 常规设置：设置表新增上传 Session Log 行（全名在使用官方模型 API 时上传 Session Log，0.2.0-rc.1 起 #5337），默认开启，关闭立即生效无需重启，重新开启会补传关闭期间积攒的未上传部分；说明段同步。
• 修订 6.2 插件：官方分组可选组合包补自动化任务（0.2.0-rc.1 起）；新增 tip 说明部分组合包行上没有开关（行随组合包整体启停，详情页标为只读）。
• 未进正文的变更记入备注：首次启动弹窗更名预览版说明（教程未写过该弹窗正文，无需改）；账号菜单问卷入口统一为意见反馈（未登录此前叫联系我们）；反馈问卷在桌面端预填账号、版本与设备信息；进程行 shimmer 动画统一；Office / PDF 文本选择在浅深两主题下可见；Windows 对话框与全屏的标题栏间隙修复、macOS 签名构建麦克风权限修复（桌面端）；pty 尾部宽限与提示符等待修复；深色模式下关闭态与禁用态开关视觉区分；中文工具文案 Agent 统一译为智能体；docs/persistence-schema.json 大幅精简（内部文档，约 -7.5 万行）。
• 备注：本次经 SSH 拉取上游；核对了 welcome notice 文案源码（ui-settings-models/locales.ts 与 web scaffold）、Schedule optional bundle 决策记录与官方用户指南 schedule.zh.md 的对应 diff、chat-settings.ts 前后两版的默认档定义（0.1.7-rc.2 默认 standard → 0.2.0-rc.1 默认 detailed），确认无回退干扰。

2026-09-27

• 上游 master 仍位于 477b4f4205（2026-09-25 同步的 0.1.7-rc.2），相对上次基线 477b4f4205..FETCH_HEAD 为 0 个新提交。上游最新 tag dsh-v0.1.7-rc.2 仍指向同一提交，无新增变更。

2026-09-26

• 上游 master 仍位于 477b4f4205（2026-09-25 同步的 0.1.7-rc.2），相对上次基线 477b4f4205..FETCH_HEAD 为 0 个新提交。上游最新 tag dsh-v0.1.7-rc.2 仍指向同一提交，无新增变更。

2026-09-25

• 上游 master 由 a60af51e80（0.1.7-rc.1）推进至 477b4f4205，共 347 个新提交，发布 0.1.7-rc.2（tag 指向当前 master）。本批以快捷键系统回归、开发者工具更名代码工作工具、Schedule 全量升级三条主线为代表。
• 修订 6.1 常规设置（对照设置面板 ARIA 金标精确 diff）：
  • 开发者工具更名代码工作工具（0.1.7-rc.2 起，#5149），描述改为「开启后显示轨迹、本轮代码差异、新对话中的 Agent 预设切换」。
  • 新增快捷键行与说明段：0.1.7-rc.2 起快捷键系统回归（#4886 回退后重落地，revert 提交 91423ea1b4），点编辑快捷键打开对话框，可搜索、可修改十余项应用操作快捷键、可恢复全部默认；偏好按设备保存（Web 走浏览器存储，桌面走 userData/keybindings.json），不跨设备同步；Ctrl/Cmd + / 随时唤起快捷键速查。
• 修订 4.10 轨迹视图：新增 warning——轨迹 / Session log 入口受代码工作工具开关控制（关闭后只剩对话视图；3.2 节改动文件卡片同受其管）。
• 修订 6.3 Agent 预设：「选择器可关」tip 更新——新任务模式选择0.1.7-rc.2 起由代码工作工具开关统一控制（原「新任务可选择模式」独立开关取消）。
• 修订 5.1 会话列表与历史：归档筛选升级为隐藏 / 全部 / 仅归档三选一菜单（0.1.7-rc.2 起，#4854），恢复入口、FAQ、小结同步。
• 重写 4.11 定时提醒（Schedule 本周期大改）：
  • 启用方式变更：官方 overlay 示例 apps/cli/config/examples/schedule/ 已删除，改为自带三行 patch（schedule / ui-schedule / time-context 各 disabled: false）启用；默认组合仍不含 Schedule（本周期曾默认随 Web 发布，rc.2 又改回默认关闭）。
  • 时间设定从三种扩到六种：相对秒数、绝对时间、固定间隔（下限从 300 秒放宽到 60 秒）、每日、每周、Cron（标准五字段表达式）。
  • 工具从三个扩到四个：新增 schedule_update（改名、改指令、改时间，保留 id 与投递记录）；创建时任务名必填（≤120 字符）。
  • 新增自动化任务页面一节：全局任务管理页（搜索、状态筛选、规则 / 任务运行记录双页签、月历时钟时区选择器、关联会话跳转、确认删除）+ 会话身上的三处提示（页头时钟按钮与弹层、侧栏闹钟标记、创建任务卡片）。
  • 行为细节更新：删除是硬删除（连带投递记录不可恢复），投递记录保留上限默认 30 天 / 200 条。
• 修订 6.2 插件：官方分组更新为智能体团队、自动授权审查、语音输入（实验性标签）+ 终端 / Agent 循环 / 子智能体 / 网页搜索四个配置页插件；原「Auto 审批评评（Beta）」名称与标签同步上游中文文案。
• 未进正文的变更记入备注：审批卡片说明文案本地化（4.4 表述已兼容）；模型选择 pending 时显示加载态；web fetch 折叠摘要里的 URL 可点击；代码高亮语言表统一并扩展；语音输入未就绪时引导去插件页安装；会话列表空状态图标与归档筛选视觉打磨；动态工具更新的紧凑通知（代码工作工具开启时）；账号体系继续完善（登出确认、未登录侧栏菜单、桌面端余额与赠送通知）；桌面端关窗默认隐藏到后台 + 可中断退出二次确认；Playwright MCP / Chrome DevTools MCP / Cua Driver 三个可选 bundle 因体积被裁撤；定时用户提问（timed waits）仍为 proposed 未落地，教程未写入。
• 备注：本次经 SSH 拉取上游（HTTPS 直连仍不可用）；核对了设置面板 / 快捷键 / 插件管理页 ARIA 金标、web-app bundle patch 最终状态与 Schedule 包 README，确认快捷键与 Schedule 相关 feat 在 rc.2 的最终存活形态（本周期 schedule 曾短暂默认启用后又被 #5175 禁用）。

2026-09-24

• 上游 master 由 ddefc45fbc 推进至 a60af51e80（0.1.5-rc.3 历史合并 + 0.1.7 开发周期），共 1617 个新提交，发布 0.1.7-alpha.1、0.1.7-alpha.2、0.1.7-rc.1 三个版本（当前 master 位于 0.1.7-rc.1）。本批以「过程分组与四档工作步骤展示」「会话头部任务列表重做」「Excel 浏览器直览」「模型添加统一入口」四条主线为代表。
• 重写 3.2 看懂工具调用树（过程展示是本批最大变化）：
  • 新增「0.1.7 起过程按组折叠，整轮一键收起」一节：相邻同类步骤自动收进过程组，组头显示类别摘要（已读取文件 / 已搜索代码 / 修改了文件 / 执行了命令 / 运行了代码，运行中对应「正在……」）；整轮折叠默认收起已结束轮次的全部过程，运行中的轮次保持展开；运行时钟从轮次一开始就整秒跳动；已完成轮次页脚收尾；非人工触发的轮次有独立提示行；历史分页锚定阅读位置不跳动。
  • 新增「四档展示：想看多少细节自己定」小节：设置 → 通用设置 → 工作步骤展示，0.1.7-rc.1 起四档（简洁 / 标准（默认）/ 详细 / 完全展开），旧偏好自动映射，切档不打散分组与手动展开。
  • 统计段补充：0.1.7-alpha.1 起新增性能与用量偏好（简洁 / 详细两档，默认详细），控制统计药丸、上下文圆环与轮次用量的显示密度。
  • 改动文件卡片补充：0.1.7-alpha.1 起悬停文件行可就地浮出 diff 预览。
  • 新增「回答里的图片链接也能直接看」一节：0.1.7-rc.1 起图片链接悬停浮出预览、可内联展开。
• 修订 4.8 后台任务：界面一节重写为 0.1.7 任务列表形态——运行中任务两行式（标签 + 类型徽章/状态 + 跳动时长），点开行看内嵌终端样式的实时流式输出面板（收起即停流）；已完成任务折叠在已完成分组下可清空；两击式停止（首击武装、三秒内确认，防误停，停止后 detail 标明已由用户取消，owner agent 收到明确通知）；FAQ 与小结同步。
• 修订 5.1 会话列表与历史：
  • 新增会话置顶（0.1.7-alpha.1 起）：重要会话钉在列表最上方，最近置顶优先，与归档互斥；操作表加行。
  • 重写「归档的会话去哪了、怎么找回来」：0.1.7-alpha.1 起设置里的已归档会话页移除，恢复入口搬到侧边栏视图选项的归档筛选；归档时出现可撤销 toast；归档运行中的会话会先停掉其正在运行的工作；视图选项一节补充归档开关；FAQ 与小结同步。
• 重写 6.1 常规设置：设置导航为四 tab（通用设置 / 模型 / 内置插件 / Agent 预设），页脚显示当前版本；通用设置表格从 5 项扩到 10 项，逐项补充字号大小（0.1.7-alpha.1 起，默认 14px）、工作步骤展示、性能与用量、对话中网页链接的打开位置（0.1.7-alpha.1 起，应用内侧边栏 / 默认浏览器，仅装了内置浏览器的部署显示）、开发者工具（0.1.7-alpha.1 起）。
• 修订 2.3 右侧边栏与文件预览：
  • 预览类型表更新：Office 行拆为「Word、PowerPoint 转 PDF 预览」与「Excel / CSV / TSV 浏览器直览（0.1.7-alpha.1 起）」。
  • 新增「Excel 表格直接在浏览器里看」小节：工作表标签、单元格选择复制、只读公式栏（显示已保存结果不重算，缺结果留空并提示）、样式尽量还原（字体/填充/边框/数字格式/合并/冻结标题）、图表等画不了的内容列清单建议系统应用打开、CSV/TSV 可切纯文本且值按字面字符串处理（前导零保留）、只读、默认单文件 16 MiB 上限。
  • 新增「统一的缩放控件」小节：PDF 与图片共用浮动缩放控件（适应宽度默认，25%–400% 每 25% 一档，触控板捏合），Word/PPT 转 PDF 后同样适用。
  • 新增 tip：0.1.7-alpha.1 起正在预览的文件可在默认应用打开（菜单含在文件管理器里显示），预览不了的格式空状态页直接提供打开按钮；小结同步。
• 修订 1.2 多模型与自定义端点：0.1.7-alpha.1 起模型页两个添加按钮合并为一个添加模型提供商，卡内分段开关选第三方模型提供商（内置目录）或自定义模型 API（中转 / 自托管 / 任意 OpenAI、Anthropic 兼容端点），两模式草稿互不丢失；协议下拉显示产品名；全章「提供方」统一为上游界面用词「提供商」；实战步骤与小结同步。
• 修订 6.2 插件：安装流程补充安装源选择（0.1.7-alpha.2 起）——默认安装源 / 中国大陆镜像源（registry.npmmirror.com，大陆网络出口默认选中）/ 自定义地址（凭据放 ~/.npmrc）；GitHub 类安装失败提供镜像重试；多注册表轮流询问、记住先响应者。
• 修订 6.3 Agent 预设：切换一节补充每个内置预设的模式指南（查看配置按钮：介绍、场景、可拷贝用法示例）与设为新任务默认；「选择器可关」tip 更新为界面文案新任务可选择模式；创建自定义预设补充 0.1.7-alpha.1 起的让 Agent 帮我创建预设模式入口。
• 修订 0.3 启动与界面总览：设置面板 tab 表更新为内置插件（只读清单）并补充通用设置新条目提示。
• 未进正文的变更记入备注：快捷键系统曾在本周期合入后整体回退（0.1.7-rc.1 不含可配置快捷键，教程未写入）；DeepSeek 账号登录（仅桌面端：浏览器 OAuth 授权登录、Platform 账户页、头像、余额与奖励钱包展示、原生欢迎窗口；Web 客户端维持 API Key 引导）；本地语音听写（experimental 语音输入组合包，默认关闭，SenseVoice 本地推理不上云，显式准备才下载模型）；会话格式 V4 兼容基线与一次性迁移命令（dsh 侧，用户无感）；桌面端主窗口默认 1280×820 / 最小尺寸调整、F12 打开 DevTools、Windows 卸载可选清除数据、崩溃报告；CLI 导出 Cordis 配置 JSON Schema、dsh.bundle.patch 支持有序补丁列表；团队（Agent Teams）Web 面板与投影驱动；0.1.5-rc.3 历史分支合并。
• 备注：本次经 SSH 拉取上游（HTTPS 直连仍不可用）；核对了设置面板 ARIA 金标与 ui-jobs / ui-agent-preset / ui-sidebar-documentpreview / ui-settings-account 的 README，确保正文与 0.1.7-rc.1 实际形态一致；工作区干净，仅含本次修订文件。

2026-09-22

• 上游 master 仍位于 ddefc45fbc（2026-09-18 同步的 0.1.6-alpha.2 周期提交），相对上次基线 ddefc45fbc..upstream/master 为 0 个新提交。上游最新 tag dsh-v0.1.6-alpha.2 仍指向同一提交，无新增变更。
• 例行复核：侧栏浏览器、侧栏插件管理页、本轮改动文件卡片、常驻计划卡片、子代理委派限制、侧栏终端、DeepSeek 默认 Messages 协议、归档会话恢复、headless 机器可读输出、上下文占用圆环、模型图片输入设置、profile 命令简写、启动诊断、工作区父文件夹分组、引用侧栏预览、/ 技能模糊匹配与 chip、通用文件附件、Composer 菜单、反馈对话框、会话统计双药丸、轨迹视图、本地应用打开工作区、模型切换播报、子代理人工 inbox、轮次轨道、定时提醒、计划与目标等已覆盖功能的关键事实未变，无需改动。
• 备注：本次经 SSH 拉取上游（HTTPS 直连仍被重置），仅在本更新日志新增"上游无更新"条目。

2026-09-21

• 上游 master 仍位于 ddefc45fbc（2026-09-18 同步的 0.1.6-alpha.2 周期提交），相对上次基线 ddefc45fbc..upstream/master 为 0 个新提交。上游最新 tag dsh-v0.1.6-alpha.2 仍指向同一提交，无新增变更。
• 例行复核：侧栏浏览器、侧栏插件管理页、本轮改动文件卡片、常驻计划卡片、子代理委派限制、侧栏终端、DeepSeek 默认 Messages 协议、归档会话恢复、headless 机器可读输出、上下文占用圆环、模型图片输入设置、profile 命令简写、启动诊断、工作区父文件夹分组、引用侧栏预览、/ 技能模糊匹配与 chip、通用文件附件、Composer 菜单、反馈对话框、会话统计双药丸、轨迹视图、本地应用打开工作区、模型切换播报、子代理人工 inbox、轮次轨道、定时提醒、计划与目标等已覆盖功能的关键事实未变，无需改动。
• 备注：本次经 SSH 拉取上游（HTTPS 直连仍被重置），仅在本更新日志新增"上游无更新"条目。

2026-09-20

• 上游 master 仍位于 ddefc45fbc（2026-09-18 同步的 0.1.6-alpha.2 周期提交），相对上次基线 ddefc45fbc..upstream/master 与 ddefc45fbc..origin/master 均为 0 个新提交。上游 tag dsh-v0.1.6-alpha.2 仍指向同一提交，无新增变更。
• 例行复核：侧栏浏览器、侧栏插件管理页、本轮改动文件卡片、常驻计划卡片、子代理委派限制、侧栏终端、DeepSeek 默认 Messages 协议、归档会话恢复、headless 机器可读输出、改动文件卡片、上下文占用圆环、模型图片输入设置、profile 命令简写、启动诊断、工作区父文件夹分组、会话标题悬停滚动、引用侧栏预览、/ 技能模糊匹配与 chip、通用文件附件、Composer 菜单、反馈对话框、会话统计双药丸、轨迹视图、本地应用打开工作区、模型切换播报、子代理人工 inbox、轮次轨道、定时提醒、计划与目标等已覆盖功能的关键事实未变，无需改动。
• 备注：本次未触动工作区里其他会话遗留文件，仅在本更新日志新增"上游无更新"条目。

2026-09-19

• 上游 master 仍位于 ddefc45fbc（2026-09-18 同步的 0.1.6-alpha.2 周期提交），相对上次基线 ddefc45fbc..upstream/master 与 ddefc45fbc..origin/master 均为 0 个新提交。上游已推送 tag dsh-v0.1.6-alpha.2，指向同一提交，无新增变更。
• 例行复核：侧栏浏览器、侧栏插件管理页、本轮改动文件卡片、常驻计划卡片、子代理委派限制、侧栏终端、DeepSeek 默认 Messages 协议、归档会话恢复、headless 机器可读输出、改动文件卡片、上下文占用圆环、模型图片输入设置、profile 命令简写、启动诊断、工作区父文件夹分组、会话标题悬停滚动、引用侧栏预览、/ 技能模糊匹配与 chip、通用文件附件、Composer 菜单、反馈对话框、会话统计双药丸、轨迹视图、本地应用打开工作区、模型切换播报、子代理人工 inbox、轮次轨道、定时提醒、计划与目标等已覆盖功能的关键事实未变，无需改动。
• 备注：本次未触动工作区里其他会话遗留文件，仅在本更新日志新增"上游无更新"条目。

2026-09-18

• 上游 master 由 0d1f50007f 推进至 ddefc45fbc（0.1.6-alpha.2 开发周期），共 882 个新提交，本批以「侧栏浏览器」「侧栏插件管理页」「本轮改动文件卡片」「常驻计划卡片」「子代理委派限制可编辑」五条主线为代表。
• 修订 2.3 右侧边栏与文件预览：
  • 新增「侧栏浏览器：会话旁边开个网页」一节：0.1.6-alpha.2 起右侧边栏新增浏览器标签页，从引导页或点击回答里的 HTTP(S) 链接打开（每次新开一个标签）；不带协议的地址自动补 HTTPS；工具栏含后退/前进/刷新/前往/在系统浏览器中打开，标签标题显示主机名；网页跑在 iframe 沙箱里，每个标签有临时的沙箱开关（关闭带警告、不持久化）；回环地址（本地 dev server）与公网地址同一套规则；file: 地址被拒绝，本地文件仍归文件预览管。
  • 新增「回答里的文件链接也能点」一节：0.1.6-alpha.2 起 agent 被引导把现有源码文件提及写成链接，支持绝对/工作区相对路径，app.ts:24 或 app.ts:24–30 形式的行号可直达起始行；行内代码、命令、代码块不会被强行变成链接。
  • 标签页导航表加浏览器一行；小结同步。
• 重写 6.2 插件：0.1.6-alpha.2 起插件管理集中到侧栏插件页（全局页面，不属会话），分「官方」与「已安装」两组，前者含安装随附、默认关闭的官方组合包（如 Agent Teams、Auto 审批评审，带 Beta 标签，可启用不可卸载）和开放配置页的官方插件，后者为 profile 持有的组合包（启停、卸载需确认）；组合包详情页有逐行开关，写 cordis.patch.yml，HMR 部署即时重组，行被依赖时先确认；新增「安装一个新插件」流程（包名/Git 地址/压缩包/本地路径，先检查后安装，pnpm 输出可折叠查看，可取消，失败分类说明，pnpm 拦下构建脚本时可授权并重试）；设置里的插件分区改为只读的内置插件清单；原「插件配置区」（终端、Agent 循环、网页搜索卡片）以配置页形式移入插件页，新增 Subagent 配置页，编辑为草稿制（保存才写入、离开丢弃）。
• 修订 4.7 子代理：界面上子代理可在右侧边栏打开（0.1.6-alpha.2 起，优先独立分栏，主对话与子代理对话并排）；「能对子代理做什么」新增调委派限制——侧栏插件页 Subagent 卡片可改最大递归深度（默认 1 层）与 Subagent 并行数量上限（统计所有递归层级中存活的可续接子代理，不含一次性运行与外部提供方），同页可管子代理模型选择（权限开关 + 允许的模型路由）；小结同步。
• 修订 4.6 计划模式：新增「计划卡片：提交过的计划随时回看」一节——0.1.6-alpha.2 起 agent 每次提交计划，回合末尾产物区出现计划卡片（Markdown 图标 + 标题 + 打开操作）；审批批准/拒绝/关闭后卡片保留，刷新不丢；待审批卡片带状态、两行纯文本摘要、查看全文链接与要求修改/同意执行按钮，全文自动在侧栏打开；卡片不代表批准或执行成功，重开历史计划不恢复已结束的审批。
• 修订 3.2 看懂工具调用树：新增「轮次结束看「改动文件」卡片」一节——0.1.6-alpha.2 起 Host 用 git 工作树快照（轮次开始/结束各一次，走 Session 临时对象目录，不动用户仓库）对比得出改动文件列表，shell 命令改的文件也计入；卡片标题带文件数与增删行数合计，折叠露三行；点文件在侧栏打开本轮 review 标签页看逐行 diff，Host 有桌面时可用默认应用打开；边界：不在 git 仓库（或无 git）时只列文件工具的编辑，卡片内容不跨 Host 重启保留。统计段补充：上下文占用圆环和百分比移到输入卡片下方、统计药丸右侧（0.1.6-alpha.2 起），点开看 token 构成。
• 修订 1.2 多模型与自定义端点：「让自定义模型支持图片」一节补充 0.1.6-alpha.2 起可在设置界面配置——模型编辑表单的「模型选项」下新增图片输入三档（支持/不支持/默认），自定义模型继承已安装目录或提供方默认值；DeepSeek 选不支持后其图片请求限制会被清掉，重开需重配。
• 修订 7.1 CLI 模式：命令表下补充 profile 命令简写（0.1.6-alpha.2 起 dsh headless "任务" 等价 dsh --profile headless "任务"，dsh 后第一个非选项非 plugin 参数展开为 --profile，plugin 保持命令优先）；新增「启动失败时看哪里」一节——启动诊断完整落盘 $DSH_HOME 日志目录，终端按出错/等待中的服务分组报错。
• 修订 5.1 会话列表与历史：自动标题段补充悬停被截断标题自动滚动到末尾（0.1.6-alpha.2 起）。
• 修订 2.2 添加选择与创建：新增 tip「工作区多了可以按父文件夹归堆」——0.1.6-alpha.2 起侧边栏工作区列表支持按父文件夹分组（浏览器本地查看状态，拖拽限同父兄弟）。
• 修订 9.1 插件市场：开头新增 tip 分清两个入口（侧栏插件页管已有的，dsh-market 管发现新的）；「装了第三方插件，去哪配置它」FAQ 答案改指侧栏插件页。
• 例行复核：模型选择器、添加附件（图片 + 通用文件 + v41 估算）、Composer 菜单（添加/指令分组）、引用侧栏预览、侧栏终端、归档会话恢复、headless 机器可读输出、Agent 预设、权限预设、反馈对话框、会话统计双药丸、本地应用打开工作区、模型切换播报、子代理人工 inbox、轮次轨道、定时提醒、计划与目标等已覆盖功能的关键事实未变，无需改动。
• 备注：本批其余变更以内部、开发者向或桌面端为主——右侧边栏浏览器布局记忆与无人终端回收、侧栏布局恢复、Thinking 紧凑 Markdown 渲染与表格折叠、已知站点链接前缀站点图标（simple-icons）、会话在依赖行上移除前的确认、插件包按 pack/插件分组与静默行状态、可选中组合包 ship 时默认关闭、deliverables review 双栏横滚、桌面端（macOS 毛玻璃侧栏与原生 About 菜单、Windows 原生安装器界面、失败页换原生恢复对话框、独立 Office 技能、更新 ASAR 校验）、CLI 启动诊断分组、Office 预览转 office-to-pdf 统一转换与 PDF 文字层旋转修复、Workspace Files 有界读取、session-controller 世代所有权重构等，对当前教程正文的用户操作描述暂无直接影响，后续版本如有界面化再跟进。

2026-09-16

• 上游发布 0.1.6-alpha.1（master 由 c291e7961a 推进至 0d1f50007f，共 666 个新提交）。本批以「交互式侧栏终端」「DeepSeek 默认 Messages 协议」「归档会话可恢复」「headless 机器可读运行接口」四条主线为代表。
• 修订 2.3 右侧边栏与文件预览：
  • 新增「侧栏终端：工作区旁开一个人工 shell」一节：0.1.6-alpha.1 起右侧边栏新增终端标签页，人工终端与 agent 持久终端分开；主按钮打开上次选择的 shell，菜单可选 zsh/bash/fish/pwsh/powershell/cmd（执行环境默认 shell 排第一），选择记录在浏览器 localStorage；配色跟随应用主题；折叠、切换标签页或会话、全屏、断线均保留进程，刷新恢复 Host 保留的终端（布局不持久化，Host 重启不恢复）；双击标签重命名；最新连接可写、其他连接只读；每会话上限 8 个；shell 退出后标签保留不自动重启；改沙箱模式前需关闭保留终端。
  • 文件树补充：文件树与预览标签之间切换时滚动位置保留。
  • 标签页导航表与小结同步加终端一行。
• 修订 1.1 配置第一个模型：DeepSeek 编辑表单的默认 API 地址更新为 https://api.deepseek.com/anthropic（0.1.6-alpha.1 起默认走 Anthropic Messages 协议），默认模型目录改为 DeepSeek-V41-Flash + V4 系列 3 个，验证段落模型名示例改为 Messages Flash。
• 修订 1.2 多模型与自定义端点：「Chat Completions 默认切到 V41 Flash」改写为 0.1.6-alpha.1 起 DeepSeek 默认走 Messages 协议的说明，补充密钥复用（同一个 DEEPSEEK_API_KEY）与 settings.yaml 里 llm-deepseek.protocol: chat-completions 切回方法。
• 修订 5.1 会话列表与历史：
  • 新增「归档的会话去哪了、怎么找回来」一节：0.1.6-alpha.1 起设置面板新增已归档会话页（导航与通用/模型/插件并列），按归档时间由新到旧列出、标明原属工作区与最近活动时间、支持标题或工作区名过滤、每行一键取消归档；只列出可恢复的条目，写入被拒绝时行保留可重试。
  • 「视图选项」的手动排序补充：0.1.6-alpha.1 起手动顺序仅当前浏览器生效，且手动模式下暂停最近更新自动上浮。
  • FAQ「归档的会话还能找回吗」答案反转；操作表、小结同步更新。
• 修订 6.1 常规设置：设置面板段落补充第五个导航入口「已归档会话」。
• 修订 4.10 轨迹视图：新增「长字符串和 PTC 程序也能舒服地看」一节——长 JSON 字符串可展开为原始文本并记住换行偏好、详情标题带轮次与步骤序号、PTC run_code 调用带源码高亮检查器（可复制、可切原始 JSON、保留打印输出与返回值）、轨迹内思考默认展开（与对话视图默认折叠互不影响）。
• 修订 7.1 CLI 模式：新增「机器可读输出：给脚本和监督进程用」一节与最小示例——--json 逐行 JSON 事件流（session/status/text/thinking/tool_call/tool_result/final，推理不再刷 stderr）、--session-id <id> 只采用既有持久化会话以支持多轮连续自动化、位置参数 - 或缺省时任务从 stdin 读取；小结同步。
• 修订 4.1 切换模型 / 3.1 新建会话：模型名示例更新为 Messages Flash；顺手删除 4.1 里重复的「建议」tip。
• 例行复核：添加附件（图片 + 通用文件）、Composer 菜单、引用侧栏预览、turn 小时档、Agent 预设（modeSelectionEnabled）、反馈对话框、会话统计双药丸、本地应用打开工作区、模型切换播报、子代理人工 inbox、轮次轨道、定时提醒、插件分组、权限预设、计划与目标等已覆盖功能的关键事实未变，无需改动。
• 备注：本批其余变更以内部或开发者向为主——压缩摘要请求的图片按 V4.1 token 网格投影与图片卸载（durable image offload）、DeepSeek Files 生命周期在 Messages/Chat Completions 两协议间对齐（128MiB 上传、32MiB 单图、7 天有效期语义按协议区分）、桌面端 asar 运行时、boot profile 解析模式重构、E2B 远程执行提供方退役、新增 SSH 能力包、computer use（Cua Driver）与 browser-use 每 Session 实验性后端、MCP scoped resources 与服务器指令、Ralph 在默认组合中禁用、agent-team 默认队友上限提升至 16、文档站 Mermaid 全屏查看器等，对当前教程正文的用户操作描述暂无直接影响，后续版本如有界面化再跟进。

2026-09-14

• 上游 master 仍位于 c291e7961a（2026-09-11 同步的 0.1.5-rc.2 提交），相对上次基线 c291e7961a..upstream/master 与 c291e7961a..origin/master 均为 0 个新提交，未发布新 tag。
• 例行复核：模型选择器、添加附件（图片 + 通用文件 + v41 估算）、右侧边栏（可扩展全局面板 / 富媒体预览 / 引用侧栏预览）、Composer 菜单（添加 / 指令分组）、引用侧栏预览、turn 小时档、Agent 预设（modeSelectionEnabled 门控）、反馈对话框、会话统计双药丸、轨迹视图 Session log 入口、本地应用打开工作区、模型切换播报、子代理人工 inbox 连续控制、轮次轨道、定时提醒、插件分组、权限预设、计划与目标等已覆盖功能的关键事实未变，无需改动。
• 备注：本次未触动工作区里 10 章实战案例重构与零散 dsh_shots 脚本——它们属于另一次会话遗留，待该会话另行处理。

2026-09-13

• 上游 master 仍位于 c291e7961a（2026-09-11 同步的 0.1.5-rc.2 提交），相对上次基线 c291e7961a..upstream/master 与 c291e7961a..origin/master 均为 0 个新提交，未发布新 tag。
• 例行复核：模型选择器、添加附件（图片 + 通用文件 + v41 估算）、右侧边栏（可扩展全局面板 / 富媒体预览 / 引用侧栏预览）、Composer 菜单（添加 / 指令分组）、引用侧栏预览、turn 小时档、Agent 预设（modeSelectionEnabled 门控）、反馈对话框、会话统计双药丸、轨迹视图 Session log 入口、本地应用打开工作区、模型切换播报、子代理人工 inbox 连续控制、轮次轨道、定时提醒、插件分组、权限预设、计划与目标等已覆盖功能的关键事实未变，无需改动。
• 备注：本次未触动工作区里 10 章实战案例重构与零散 dsh_shots 脚本——它们属于另一次会话遗留，待该会话另行处理。

2026-09-11

• 上游发布 0.1.5-rc.2（master 由 2377c272a8 推进至 c291e7961a，共 136 个新提交）。
• 修订 4.3 命令与引用：
  • 「斜杠命令」段重写：把原来「敲 / 弹出按注册顺序的命令列表」改为「0.1.5-rc.2 起菜单按使用频次分两组（添加：文件 / 目标 / 计划 / 反馈；指令：压缩 / 权限 / 模型 / 导出），每行带图标 + 本地化标题与说明，必要时把英文命令名作为尾随别名显示」。文件入口已合并到 + 菜单第一行，单独的「回形针」按钮被移除，+ 按钮的无障碍名/提示读「添加文件或运行命令」。
  • 模糊搜索 tip 续写：本地化命令的中文短名（「目标」「计划」「压缩」「权限」等）也走同一条共享 ranker，空格或回车之后发送时被翻译回目录里的英文命令名执行；因此 目标 能定位到 /goal、计划 定位到 /plan。
  • 新增 tip「添加文件现在走菜单」：分点说明文件入口从回形针迁到 + 菜单的行为。
  • 新增段落「引用侧栏预览：看着选再发出去」：0.1.5-rc.2 起@ 引用的文件、/技能 引用的技能候选，会在右侧边栏就地预览，加载中或待挂载的预览也支持；节末「小结」表格同步加一行。
• 修订 2.3 右侧边栏与文件预览：新增段落「引用侧栏预览：选之前先看清」，描述 0.1.5-rc.2 起 @ 与 /技能 的引用候选统一走右侧边栏的同一套预览样式（文件 / Markdown / 产物卡片 / 原生文件操作），与原有产物预览的承接关系。
• 修订 4.2 添加附件：新增 tip「v41 估算更准」，点出 0.1.5-rc.2 起 DeepSeek 提供方的图片 token 估算改用官方 v41 计算器（544×544 放大下限、约 1300×1300 缩小目标、单图 1024 token 上限），Turn usage 上的输入/输出数字由「最坏情况上界」变为「精确值」，便于横向对比多图消息的 token 成本。
• 修订 4.10 轨迹视图：「界面上的几个术语」段的 duration 解释末尾补一句，明确 0.1.5-rc.2 起 turn 计时升级小时档——运行时钟、底部 "Ran-for" 摘要、turn 时长详情对话框共用 formatRunDuration，一小时起显示 1小时05分03秒 / 1h 05m 03s，在单位边界自动进位。
• 同步在 3.2 看懂工具调用树加一个对偶 tip「运行中轮次的小时档」：把上面这段小时档语义反映在「会话统计」/ Turn usage 这个常驻位置，避免在长 task 里被一小时上限遮蔽。
• 修订 6.3 Agent 预设：「怎么切换预设」段末新增 tip「选择器可关」，给出 0.1.5-rc.2 引入的 agent-presets.modeSelectionEnabled 开关——默认开启，关闭后未指定的新会话临时回到部署默认值（用户保存的 default 不动），再次打开恢复；运行中与历史会话保持只读标签不参与切换。
• 例行复核：模型选择器、附加文件配额、权限预设、本地应用打开工作区、子代理人工 inbox 连续控制、轮次轨道、后台任务、定时提醒、轨迹视图 Session log 入口、插件分组、计划与目标、模型切换播报等已覆盖功能的关键事实未变，无需改动。
• 备注：本次上游还包含 Blacksmith CI hosted-image / Linux coverage teardown 预算调整、fix(subprocess): settle a Linux scope left active with no processes、feat(home-paths): add dshCachePath（请求图片共享缓存目录，详见 4.2 的 v41 tip）、feat(manifest): declare plugin format, tags, and host compatibility、fix(desktop): tighten parallel notarization checks、feat(remote-mock): expose typed native mocks and controlled streams、test(test-support): assemble real clients with native test fixtures、fix(scripts): enumerate repo files with a dirent walker instead of node fs.glob 等内部或开发者向变更，对当前教程的用户操作描述暂无直接影响；浏览器图标库 ui-primitives 新增 plan/compact/shield 三个 SVG 图标已合并到 composer 菜单说明，本批不再单列。

2026-09-10

• 上游发布 0.1.5-alpha.1、0.1.5-alpha.2、0.1.5-rc.1（master 由 c389f96bf3 推进至 2377c272a8，共 716 个新提交）。本批是 0.1.3-alpha.2 以来幅度最大的一次更新，以「右侧边栏升级为可扩展全局面板、富媒体预览全面落地、产物下载卡与原生文件操作」、「会话统计改双药丸 + 弹窗」、「统一反馈对话框」三条主线为代表。
• 重写 2.3 右侧边栏与文件预览：
  • 0.1.5-alpha.2 起右侧边栏升级为可挂载全局面板的容器，默认标签依然是文件树 + 文本预览，但插件可通过扩展点注册新面板。
  • 0.1.5-alpha.2 起预览类型统一改用可扩展文档预览框架：除文本外，默认还支持图片、PDF、Markdown，插件可挂载新类型（如 Office）。
  • 0.1.5-alpha.2 起消息流里出现的 Mermaid（```mermaid）、Graphviz（```dot / ```graphviz）、SVG（```svg）、HTML（```html）围栏会就地渲染成预览而不是显示源码，配色跟随应用主题，亮色主题看亮底图、暗色主题看暗底图。
  • 0.1.5-alpha.2 起不可变产物单独以下载卡呈现，附原生文件动作：在默认应用打开（用系统对应程序打开文件）、在文件管理器里显示（跳到所在目录），路径以当前工作区为相对基准。下载和打开都复用会话作用域的访问权限，跨视图也不丢。
  • 0.1.5-alpha.2 起文本预览体验打磨：标签实时标题带文件类型图标和去歧义路径；只剩一个标签时折叠为方块展开钮，让出顶部空间；单标签关闭规则变成「引导 tab 永远常驻、其余单标签与最后一列一并收起」。
• 修订 0.3 启动与界面总览：在「文件从哪里打开」之后新增 tip，点出 0.1.5-alpha.2 起预览还含图片、PDF、以及对话流里的 Mermaid / Graphviz / SVG / HTML。
• 修订 1.2 多模型与自定义端点：
  • 内置提供方列表后续说明处补一行：「0.1.5-rc.1 起 Chat Completions 默认切到 DeepSeek V41 Flash，旧 V4 系列（含 V4 Flash Vision Exp）一并保留」。
  • 自定义提供方字段表后补一句：「0.1.5-alpha.2 起 API 地址会先校验协议（必须 http:// 或 https://）并自动归一化尾斜杠，填错立即报错，不用等服务返回 404」。
• 修订 4.3 命令与引用：
  • /feedback 命令描述从「记录对当前会话的反馈」改为「打开当前会话的反馈对话框」。
  • 新增「反馈：给会话打分」一节：解释 /feedback 与 assistant 消息的 Dislike 现在打开的是同一个对话框，含 7 个固定类目（回答正确 / 错误使用工具 / 无意义重复 / 不该拒绝 / 跑题 / 表述不当 / 其他）、选填描述、提交后弹 toast，Like 即时记录，已记录的评分按钮会变成实心标记。
• 修订 4.10 轨迹视图：「怎么切换」末新增 tip，0.1.5-alpha.2 起切换到 Session log 的入口搬进对话头部右侧的更多操作菜单，不再占独立按钮位。
• 修订 03-第一次会话/02 看懂工具调用树：消息流底部的统计信息整节改写。原来的"1 轮 · 4 步 | LLM 14.9s · 工具调用 45.5s | 缓存命中 71% | 输入 76K tok · 输出 1.6K tok"一长串字，0.1.5-alpha.1 起被拆成两个图标药丸：计数字符点开会话统计（轮次、步数、LLM 耗时、TPS、缓存命中），数据库字符点开 Token 用量（Uncached input / Cached input / Output / Total）。文字体积变小，可点性更高；统计语义和 Turn usage 的拆解保持不变。
• 修订 6.3 Agent 预设：极简模式说明改为「只保留一个工具：持久 bash，0.1.5-alpha.1 起不再包含 str_replace_editor，避免和当前的"读后再写"两步流重复」，对齐 0.1.5-alpha.1 上游对 minimal profile 的瘦身。
• 例行复核：模型选择器、添加附件（图片 + 通用文件）、Agent 预设四个内置档、权限预设、本地应用打开工作区、模型切换播报、子代理人工 inbox 连续控制、计划模式、目标、轮次轨道、插件分组、定时提醒等已覆盖功能的关键事实未变，无需改动。
• 备注：本次上游还包含 CLI 模板建 profile、Playwright 录屏 GIF 化、agent-loop 在支持的路由追加 system prompt 变更、session format V2→V3 迁移与 identity 写入骨架、加权 PR 审批与按改动 LOC 排序 reviewer、视觉器 dormant Host capability、原生 Node-API flock、子代理父属子目录录制等内部或开发者向变更，对当前教程的用户操作描述暂无直接影响，后续若有用户可见变化再补充。

2026-09-08

• 上游发布 0.1.3-alpha.2（master 由 d347e70390 推进至 c389f96bf3，共 449 个新提交）。本批以「右侧边栏 / 工作区文件树重构」、「模型切换播报」、「在本地应用打开工作区」、「子代理人工 inbox 连续控制」四条主线为代表。
• 新增 2.3 右侧边栏与文件预览：介绍 0.1.3-alpha.2 引入的右侧边栏。选中工作区后，右侧出现带标签页的面板，默认含文件树和文本预览两页；文件树懒加载、可展开折叠，点击文件在预览页以分页标签打开；预览支持阅读位置记忆和全屏展开；agent 产物文件统一走右侧边栏打开，不再在对话区弹独立详情卡片。
• 修订 0.3 启动与界面总览：补充右侧边栏区域说明，放在对话区之后，提前让读者知道文件树与预览面板的存在，并指引到 2.3 节。
• 修订 2.2 添加选择与创建：补充「选中工作区后右侧边栏自动加载文件树」的提示；新增「在本地应用打开工作区」小节，介绍会话头部右侧的入口，支持 macOS / Windows / Linux 按已安装应用列表打开当前工作区目录，并记住上次选择。
• 修订 4.1 切换模型：补充 0.1.3-alpha.2 起模型切换会被显式播报，消息流里出现系统提示说明从哪个模型切到哪个模型及推理等级，方便回看时定位。
• 修订 4.7 子代理：补充 0.1.3-alpha.2 起对连续子代理的人工 inbox 控制，子代理停下来等人确认时，可直接回复、继续或取消，体验与主会话一致。
• 例行复核：通用文件附件、/ 命令 chip、可点击链接样式、模型选择器、Agent 预设、权限审批、工作流、轮次轨道等已覆盖功能的关键事实未变，无需改动。
• 备注：本次上游还包含 session format v2 流式迁移、session-persistence 只读/恢复优化、OTel 显式反馈默认上传、系统提示词环境事实顺序调整、子进程原生隔离、E2B / 本地文件系统字节窗口、feedback 记录与投递等内部或开发者向优化，对当前教程的用户操作描述暂无直接影响，后续若有用户可见变化再补充。

2026-09-06

• 上游发布 0.1.3-alpha.1（master 由 76fda72 推进至 d347e70390，共 229 个新提交）。本批以「通用文件附件」、「/ 技能模糊匹配与气泡 chip」、「可点击链接视觉统一」三条主线为代表。
• 修订 4.2 添加附件：dsh 的附件不再限于图片，0.1.3-alpha.1 起任意文件都能拖进来上传。图片（PNG、JPEG、WebP、GIF）仍走预览卡，被多模态模型直接看；非图片文件统一走新增的 文件卡片（240×64 像素圆角卡，显示文件名、扩展名标签和大小）。卡片有三态——上传中显示转圈与底部进度条、成功后变成扩展名 + 大小、失败时描边变红、卡片整体可点击重试，悬停或聚焦右上角出现 × 删除按钮。文件以内容寻址（sha256）原样存进后端，agent 收到的是文件引用而不是字节，调用文件工具按需在工作区里读。
• 修订 4.3 命令与引用：
  • 模糊搜索 tip 改为精确描述：候选按命令与技能共享的子序列 ranker 排序，输入按空白切成 token，每个 token 在前缀和分段边界（-、_、空格等）拿到额外权重。/compimg 能同时命中 compress-images、compress-image-pdf、img-compress 这类名字。
  • 新增 tip：对话流里看到的 /compress-images 这种样子其实是内嵌 chip 而不是普通文本，0.1.3-alpha.1 起对话里实际触发过的命令或技能会被装饰成 chip。chip 悬停显示技能/命令全名，点击跳到输入框并预填该命令；跨会话回放也会自动还原 chip，不会因会话历史而丢样式。chip 只装饰一个 leading goal token，避免空白后再展开。
• 同步修订 1.2 多模型与自定义端点（含之前漏同步的细节）：内置提供方一律由已安装目录作答、即使 API 地址指向网关也不变；要查看网关实际提供的模型，请走自定义提供方探测。OAuth-only 提供方（如 Codex）在列表中被自动 withhold，暂不支持表单直接配；获取可用模型 走表单当前的 API 地址/协议/密钥（已保存的提供方用已存储的密钥），拉取成功会弹可搜索选择框。新增「给自定义模型加推理等级」小节：reasoningEfforts 字典按键（菜单提供项）/值（线缆发送写法）的对应声明等级，只 off 可留空，路由级 reasoning 是默认起始等级。
• 例行复核：模型选择器、Agent 预设、工作流、轮次轨道、插件分组、权限审批、侧边栏会话行操作等已覆盖功能的关键事实未变，无需改动。
• 备注：本次上游还包含 session-persistence JSONL 跨进程 write-lease、session format v2 嵌入 assistant streams 迁移、attachment service prompt admission 整合、tool-call loadImage 回调、fix(web): address session reveal review 工作区树自动定位搜索会话、可点击链接样式统一（共享 --dsw-alias-link 颜色 + LinkIcon 分类图标）、子进程 Windows child-window 隐藏与跨盘根路径保留、Python SDK macOS x64 运行时支持、attachment 主题约束修正等内部或开发者向优化，对当前教程的用户操作描述暂无直接影响，后续若有用户可见变化再补充。

2026-09-04

• 上游发布 0.1.2-rc.1（master 由 4e84901 推进至 76fda72，共 107 个新提交）。
• 修订 1.2 多模型与自定义端点：补全「获取可用模型」的协议覆盖。0.1.2-rc.1 起，model discovery 在 OpenAI 兼容协议之外也支持 Anthropic Messages 协议（用 GET /v1/models + x-api-key + anthropic-version），官方 Claude 接口、AWS Bedrock 这类 Anthropic 兼容网关点一下就能拉下模型列表；Azure、Codex 等走非 Bearer 认证的协议仍需手动填模型 ID。
• 复核 1.1 模型选择器、6.3 Agent 预设、4.9 工作流、4.10 轮次轨道、6.2 插件分组等已覆盖功能的关键事实未变，无需改动。
• 备注：本次上游还包含 agent-team mailbox 顺序在冷启动恢复时的修复、session-projection-cache 跨域版本只读兼容、feat(session, agent, web): support same-session message editing 提交后又回退、tool-call 树新增 loadImage 回调等内部/实验性变更，对当前教程的 UI 操作描述无用户可见影响，后续若有用户可见变化再补充。

2026-09-02

• 上游发布 0.1.2-alpha.4（master 由 dd6322d 推进至 4e84901，共约 117 个新提交）。
• 修订 6.3 Agent 预设：PTC 模式不再宣称"标准模式的全部能力"，改为"与标准模式几乎相同，但默认不提供 工作流把多步任务编排成脚本，可自动启动子代理，一次跑完整个流程。Workflow/ˈwɜːrkfloʊ/ 工具"，避免读者误以为 PTC 也能直接跑工作流。
• 修订 4.9 工作流：新增提示，明确 PTC 模式默认禁用通用工作流工具，想使用工作流需切到标准模式或自定义预设。
• 例行复核：模型配置、自定义提供方、推理等级、子代理 Profile 包、插件列表分组、连接状态指示器、轮次轨道等已覆盖功能的关键事实未变，无需改动。
• 备注：本次上游还包含 UI 圆角/海拔描边视觉调整、流式更新帧率优化、会话事件 seq 与 log offset 区分、SDK 默认暴露 web fetch 等内部或开发者向优化，对当前教程的 UI 操作描述无影响，后续如有用户可见变化再补充。

2026-09-01

• 上游发布 0.1.2-alpha.3（master 由 0a53fb5 推进至 dd6322d，共 117 个新提交）。
• 新增 4.10 轨迹视图「轮次轨道」小节：介绍对话区右侧的轮次导航轨道，悬停预览、点击跳转，方便在多轮会话中快速定位历史消息。
• 修订 6.3 Agent 预设：同步权限预设中文标签变更，Workspace Write 在中文界面下由「工作区写入」改为「工作区内修改」，使语义更准确。
• 例行复核：模型配置、推理等级、子代理 Profile 包、插件机制等已覆盖功能的关键事实未变，无需改动。
• 备注：本次上游还包含会话持久化后端切换为 JSONL（移除 SQLite 后端）、流式代码围栏增量渲染、无扩展名图片附件路径读取等内部优化，对当前教程的 UI 操作描述无影响，后续如有用户可见变化再补充。

2026-08-31

• 上游发布 0.1.2-alpha.2（master 由 cd5ef81 推进至 0a53fb5，共 234 个新提交、1604 文件变更、约 +13.8 万行）。
• 修订 6.2 插件：插件列表按作用域分组——预设组优先（默认展开，含纯展示的预设切换器）、全局组（默认折叠、失败项置顶），全局禁用但某预设启用的插件标记为「预设提供」并注明来源；搜索跨两组高亮。
• 修订 0.3 启动与界面总览：新增「侧边栏的连接状态」小节，介绍连接指示器在 Disconnected / Connecting / Connected 三态下的表现与手动重连机制（指数退避自动重试、浏览器离线中止）。
• 修订 3.2 看懂工具调用树：补充每个 assistant 回复尾部的 Turn usage 折叠项，可展开查看该轮 Provider/model 与输入、缓存、输出、总 Token 明细。
• 修订 4.11 定时提醒：补充活动提醒在对话 header 只读目录与侧边栏闹钟标记上的呈现（均只读，不提供增删改）。
• 修订 6.3 Agent 预设：新增提示，内置预设名称与权限预设标签会随界面语言本地化，自定义预设元数据不翻译。
• 例行复核：本批提交以内部重构、依赖治理、连接韧性为主，模型配置、推理等级、子代理 Profile 包等用户可见功能的关键事实未变，无需改动。

2026-08-30

• 上游发布 0.1.2-alpha.1（master 由 b150a55 推进至 cd5ef81，跨越 0.1.1 开发线，共 1079 个新提交、6421 文件变更、约 +32 万行）。这是本教程运行以来幅度最大的一次更新。
• 修正 4.2 添加附件：图片归一化描述更准确。原「长边默认缩到 2048 像素」改为「缩进 2048×2048 像素的归一化预算，长边上限 8192 像素」——2048 是总像素预算的边长，长边硬上限其实是 8192 像素；其余配额（单条 20 张/200MiB、单张 20MiB/6400 万像素/8192px、EXIF 摆正）经核对仍准确。
• 新增 4.11 定时提醒：介绍 Schedule 会话内提醒能力。默认不开启，用 dsh web --patch apps/cli/config/examples/schedule/cordis.yml 启用；通过 schedule_create / schedule_list / schedule_delete 三种时间设定（相对秒数、绝对时间、固定间隔至少 300 秒）让 agent 在稍后提醒你，提醒以同会话普通消息到达，无外部通知。
• 复核已覆盖功能在 0.1.2-alpha.1 下仍准确：模型配置（V4-Flash / V4-Pro / V4-Flash-Vision-Exp 模型 ID、supportsDeveloperRole / maxTokensField 开关、@deepseek-ai/dsh-llm-pi-ai 包名）、推理等级 off/low/high/max、子代理接 Codex / Claude Code 官方 Profile 包均未变化，无需改动。
• 本次大版本还带来多个用户可见新方向（mcp-memory 记忆、code-mode / PTC 预设、skill 技能系统、dynamic workflows 动态工作流、hook 桥接、MCP 客户端插件、沙箱等），相关章节将在后续每日自动化中随源码核验逐步补全。

2026-08-26

• 上游发布 0.1.0-rc.8、0.1.1-rc.1、0.1.1-rc.2（master 由 99f6f02 推进至 b150a55，共 743 个新提交、3319 文件变更）。
• 修订 0.2 环境准备：dsh web 本机启动会自动用默认浏览器打开界面，新增 --no-open 关闭自动打开；远程/SSH 启动只打印地址。
• 修订 1.1 配置第一个模型：模型列表补充多模态模型 V4-Flash-Vision-Exp；新增密钥存储说明（只写、存于 $DSH_HOME/.credentials.yaml，设置仅保留凭据引用）。
• 修订 1.2 多模型与自定义端点：新增「让自定义模型支持图片」（settings.yaml 声明 input: [text, image]）与「网关兼容性」（pi-ai compat 开关 supportsDeveloperRole / maxTokensField）。
• 修订 4.2 添加附件：补充图片配额与归一化限制（单条 20 张/200MiB、单张 20MiB/64Mpx/8192px、长边归一 2048px、EXIF 摆正）及看图模型说明。
• 修订 4.7 子代理：新增用 Codex / Claude Code 官方可选 Profile 包当子代理的安装与授权说明。
• 修订 6.2 插件、9.1 插件市场：补充「官方可选 Profile 包」说明，与市场插件互补。

2026-08-18

• 修订 9.1 插件市场：补充 FAQ"装了第三方插件去哪配置"，衔接 0.1.0-rc.7 的插件配置开放能力（注册设置项的插件自动出现在设置 → 插件配置区）。
• 复核 Part 9 其余内容：安装命令（dsh plugin --profile web add）与市场机制在 rc.6/rc.7 中无变化，无需改动。

2026-08-17

• 上游发布 0.1.0-rc.6、0.1.0-rc.7（master 推进至 99f6f02，共 111 个新提交）。
• 修订 4.1 切换模型：推理等级档位更新为 DeepSeek 实际档位 off/low/high/max（默认 high），并补充切换后的生效说明。
• 修订 4.4 权限与审批：补充审批卡片支持最小化折叠，折叠后 agent 依然等待、不取消询问。
• 修订 6.2 插件：插件配置区不再限于三个核心插件，注册了设置命名空间的第三方插件也会自动出现卡片。
• 例行检查确认 PTC 预设命名（上游 code preset 更名 PTC Mode）与教程一致，无需改动。

2026-08-15

• 新增 Part 9 插件生态：介绍社区插件市场 dsh-market（9.1）与插件搜索 dsh-find-plugin（9.2）的安装和使用。
• 新增本更新日志栏目，用于记录教程随上游更新而发生的变更。
• 例行检查上游仓库：当前 master 指向 47f9438（对应 2026-08-13 发布的 0.1.0-rc.5），无新增提交，各章节内容无需改动。