# Changelog 本文件记录每个版本中用户能够感知的主要变化。格式参考 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)，版本号遵循 [Semantic Versioning](https://semver.org/spec/v2.0.0.html)。 ## [Unreleased] ## [0.5.0] — 2026-09-11 ### Added - 插件配置卡新增版本提醒：宿主启动时向 npm 查询一次 `latest`（结果缓存 12 小时）， 有新版本时卡片标题行出现「有新版本」标记，展开后给出新版本号与可直接执行的更新命令。 - 通知记录可以清理了。此前已读只让角标归零，投递行本身永远保留，长期使用会一直堆积。现在每张卡片 有一个 `×` 删除这一条投递，面板头部的「一键清除」在二次确认后清空全部已知工作区的记录。删除是存储 层写操作，记录、角标与首页提醒投影同时更新，刷新或换浏览器看到的是同一份剩余记录；它只清理投递， 不改变任何事项状态。 ### Changed - 适配 dsh `0.1.5-rc.1`。插件设置页的 YOLO 配置卡现在与宿主自带插件卡完全一致：同样注册在 `settings.plugin.item` 槽并按 settings 命名空间匹配，同样由框架注入文案（新增中英文案，跟随宿主语言）， 使用同样折叠式卡片外壳、未保存标记、只读提示与放弃/保存页脚，开关改用宿主原生控件。编辑仍是 暂存式：改动先留在草稿里，「保存」才按字段路径一次性提交并在宿主接受后折叠卡片；每个字段可以单独 「恢复默认」。**现在要求宿主为 dsh ≥ 0.1.5-rc.1**（README 与使用指南已注明安装与升级方式）。 ### Fixed - 不再把宿主替用户生成的 user 角色消息当成用户输入。dsh 0.1.5 的模型选择会在模型切换时追加一条 `[model changed: …]` 提示，它此前会覆盖「最近一条用户消息」，并在语义召回里消耗预算、污染去重键。 - 修复整个宿主会被提醒调度器打挂的问题：扫描目标（工作区目录）的读取在数据库被占用时会抛出 `database is locked`，而该调用位于 `setInterval` 回调内、又在逐工作区的错误处理之外，于是成为 未捕获异常并终止宿主进程。现在提醒与早晚报两个定时任务都整体兜底并记日志，一次读取失败不再影响 后续轮次；工作区目录的读取也不再「每次轮询都顺手写一遍状态」——无变化就不写，写失败也不抛出 （该标注不值得让一次后台轮询失败），并让目录库等待并发写入者而不是立即报错。 ## [0.5.0-rc.1] — 2026-09-10 ### Changed - 适配 dsh `0.1.2-rc.1`：跟随上游移除 `@deepseek-ai/dsh-client-runtime`（客户端类型改由 `@deepseek-ai/dsh-api-session-controller/client`、`@deepseek-ai/dsh-client-ui-settings/client` 等 所属域包提供），设置命名空间改为编译期字面量（上游 `settingsNamespace()` 已删除）， `installSettingsSection` 迁移为 SettingsProvider 的 `installSection` 方法； 开发依赖与类型全部对齐 `0.1.2-rc.1`。**现在要求宿主为 dsh ≥ 0.1.2-rc.1** （README 与使用指南已注明安装与升级方式）。 ### Fixed - e2e runner 在非默认端口下没有把宿主地址传给用例，可能误连其它正在运行的宿主； 现在 runner 显式导出 `YOLO_E2E_HOST`，并捕获 dsh 0.1.2 的 `dsh web:` 启动令牌 URL （`YOLO_E2E_BOOT_URL`）供浏览器用例完成认证，完整宿主输出记录到 `output/e2e-host.log`。 - e2e runner 支持 `DSH_HOME` / `YOLO_E2E_WORKSPACE` 隔离的严格干净模式： 从隔离 profile 拉起宿主、默认工作区指向临时目录、夹具清扫只触碰隔离目录， 真实工作区数据不再干扰看板类用例（详见 docs/testing-e2e.md）。 ## [0.5.0-beta.3] — 2026-09-01 ### Added - 新增目标管理闭环：目标可关联多个支持事项和里程碑，并记录完成标准、目标日期、当前下一步、下次回顾和最近进展。 - 计划 → 目标页面现在展示目标推进上下文，并支持推进目标、暂停、恢复、达成和放弃；目标推进进入独立讨论，不打扰普通工作会话。 - 长期结果的自动识别增加“待确认 / 进行中”准入，模糊愿望不会直接成为主动跟进目标。 ### Changed - “更多”菜单中的按日期批量入口改名为“按日期删除事项”，更准确地说明它只负责按截止日期或创建日期批量取消、删除事项。 - 目标进度不再因为达到 100% 自动宣布达成；只有用户明确确认后才进入“已达成”。事项完成后只会清除目标的下一步引用。 - 历史页面支持按本地自然日查看和切换日期，避免跨时区时把变化归到错误的一天。 - 对话输入框支持多行内容并随文本增长，长消息和窄面板下的输入体验更稳定。 ### Fixed - 历史页面在宿主尚未重启、接口未加载或返回异常内容时，会给出可操作的中文提示，不再显示浏览器的 JSON 解析错误。 - 修复事项进行中状态的视觉层级和侧栏 YOLO 文案比例，避免状态控件与品牌文字显得拥挤或失衡。 ## [0.5.0-beta.2] — 2026-08-31 ### Added - 新增默认关闭的“高置信事项自动关联”实验能力：只有系统非常确定当前话指向唯一一条未完成事项时，才会自动关联或修改明确的截止时间；不会改标题、状态、优先级、备注、重复规则或子步骤。 - 事项详情新增自动关联说明与纠错：展示用户原话、置信度和处理结果，可反馈“不是同一事项 / 不该修改时间 / 其他原因”；错误关联不再用于后续推荐，未被后来编辑覆盖的自动改期可以恢复。 - 新增默认关闭的“重复事项合并建议”：结合对话含义和标题中的核心动作、对象，展示推荐理由与置信度；用户可标记“不是重复事项”，或先比较两项内容、选择保留项后确认合并。 - 重复事项合并支持撤销：相关提醒和来源记录会跟随保留项；撤销后恢复合并前的关系和状态，同时保护合并后用户所做的新修改。 ### Changed - 改进事项关联能力的模型评测；语义相似结果只能向用户提出建议，不能绕过高置信自动关联的限制。 ## [0.5.0-beta.1] — 2026-08-30 ### Added - 新增跨工作区、可分页的通知记录；提醒与早晚报按到达时间完整保留，并可从通知打开关联事项。 - 历史新增“按时间 / 按事项”双视图：支持跨工作区分页、状态筛选、事项搜索、单事项演进展开和来源追溯。 - 历史记录现在能持续跟踪同一事项；事项改名后记录不会断开，同名事项和不同工作区的事项也不会混在一起。 - 新增“按日期删除事项”入口：可按截止日期或创建日期预览并批量取消，也可在强确认后永久删除范围内事项及其相关数据。 - README 新增真实宿主看板、历史时间线和对话到提醒流程图，并补充 GitHub 社交预览与私密安全报告入口。 ### Changed - 发布闭环现在要求每个 npm 版本和不可变 Git 标签都对应一个经过核验的 GitHub Release；预发布会明确标记为 prerelease。 - 升级内部数据结构，在保持现有配置和历史数据兼容的同时，提高跨工作区操作和失败恢复的稳定性。 - YOLO 标识回归并精炼为“关注圆心 + 下一项进入焦点”的原始构图，底色对齐 dsh 的 DeepSeek 品牌蓝，并统一侧栏、助手看板、设置、README、原型和社交预览中的品牌来源。 - 顶部「和助手聊聊」现在每次打开都会创建新的独立会话，不再复用上一轮助手对话历史；事项讨论继续按事项隔离。 - 顶部通知数字改为尚未查看的新投递数；打开通知记录只更新已读状态，首页继续负责完成、推迟、讨论和提醒处理。 - “已结束”从历史展示模式调整为按事项的状态筛选；早期变化如果无法确认属于哪件事项，只在时间线展示，不会错误归类。 - 取消会保留变化记录并支持重新打开；永久删除与取消明确分离，且不改写原始宿主会话或既有时间线。 ### Fixed - 修复角标统计全部通知、页面却只加载最新 12 条，导致旧通知无法完整查看的问题。 ## [0.4.0-rc5] — 2026-08-29 ### Added - 一个事项现在可以保留多个相关会话、用户原话、助手操作和看板操作，详情中可以查看主要来源和完整来源列表。 - 补充事项关联与去重的后续计划，继续完善相似事项判断、合并撤销、重复安排和跨工作区关联。 ### Changed - 合并重复事项时会保留两项原来的状态、历史和来源；已被合并的副本不会重新出现在列表、搜索、提醒或看板中。 - `develop` 推送现在执行 Linux、Windows 与 coverage CI，匹配本地功能分支合入 `develop` 后仅推送该长期分支的流程。 ### Fixed - 修复助手调用或看板操作重试时可能重复创建事项、来源或变化记录的问题。 - 修复同一事项在不同会话被再次提及或改期时只能保留一个来源的问题；现在会保留每次相关会话，并持续更新同一事项。 - 修复已完成或已取消事项无法参与重复项合并，以及合并后的副本可能重新进入提醒、搜索或“重新打开”流程的问题。 ## [0.4.0-rc4] — 2026-08-29 ### Fixed - 修复助手对话面板底部输入栏占用过多高度、Enter 图标过小、消息长文本不换行，以及对话生成新待办后看板不自动刷新的问题。 ## [0.4.0-rc3] — 2026-08-28 ### Changed - YOLO 侧栏与助手面板统一使用新版亲和的聊天气泡 Logo，保持同一品牌识别。 - 助手面板标题改为五句亲切提示轮换显示，每次重新打开都会自然换一句。 ### Fixed - 补齐干净浏览器环境下宿主首次声明、API Key 引导层的 E2E 启动处理，并收紧主题、响应式场景的真实按钮定位。 ## [0.4.0-rc2] — 2026-08-27 ### Changed - 助手看板前端按照已评审原型收敛为带工作台外框的首页 / 计划 / 历史布局，统一顶部导航、日期结论、快速记录、首要判断、分组事项和最近变化的阅读层级。 - 宽面板使用原型定义的 840px 内容列与单一 340px 上下文区；窄面板继续进入紧凑模式，不改变事项操作、来源预览和对话状态。 - 安装文档与原型设计记录同步到本次实现和 `v0.4.0-rc2`。 ### Fixed - 修复原型视觉与宿主看板之间的外框、间距、Tab 图标/计数和强调色不一致问题。 - 补充宽版原型外框、完整日期文案和来源前缀的自动化契约，并更新响应式前景测试以覆盖带边框工作台。 ## [0.4.0-rc1] — 2026-08-27 ### Added - 安装文档增加从固定标签克隆、构建并链接到 dsh `web` profile 的源码安装方式。 ### Changed - 中文产品口号更新为“交代一次，持续跟进。”；英文口号保持 “Say it once. Keep it on track.”。 - 助手看板重构为“首页 / 计划 / 历史”：首页只承接当前关注，计划组织今天、接下来、目标与全部，历史保存终态和低噪最近变化；“进展”和尚未交付的“Agent 任务”不再作为一级入口。 - 事项详情、来源预览、事项讨论和整体助手对话改为单一上下文状态；宽度足够时为主面加一个 340px 上下文区，否则上下文替换主面，不再使用固定 960px 的侧栏/全屏契约。 - 新提取事项保存有界的直接用户输入摘录、来源轮次和记录时间；来源先预览，成功后再打开原会话，手动、工具和旧记录明确降级。 ### Fixed - 面板关闭重开、宽窄切换和来源往返会保留页面、事项、讨论 episode、草稿与等待中的请求；不同事项讨论和整体助手对话保持隔离。 - 修复主 Agent 即时写入与后台语义抽取可能为同一句话创建两条标题略异的事项、重复记录相同改期，或在辅助模型返回 empty 时丢失来源证据的问题；同轮 provisional 写入现在按 session 与时间窗口升级并保持单条审计轨迹。 - 修复首页把同一事项同时显示为助手判断和提醒卡的问题；提醒折叠进事项但 badge 仍精确计数，“知道了”只处理通知且保留事项与提醒正文。 ## [0.3.1-rc.3] — 2026-08-26 ### Fixed - 修复在事项“更多处理”面板中点击“和助手讨论”后，旧编辑面板仍覆盖右侧锚定聊天、导致聊天无法交互的问题；现在会先退出事项面板，再把焦点交给聊天输入框。 - 修复 Goal 模式每个自动推进 round 都可能被当成新的用户输入并重复触发承诺抽取、进而把内部执行步骤写成多个事项的问题；现在只有本轮真实用户消息可以启动抽取，Goal 期间的真人 steering 仍会单独处理。 ## [0.3.1-rc.2] — 2026-08-26 ### Fixed - 修复用户在午夜前说“今天/明天”、后台语义抽取在午夜后才启动时，相对日期可能漂移到下一天的问题； 现在以宿主接受本轮输入时的本地时钟为准。 - 修复“只是告诉你安排、不要现在执行”等话术可能让模型保留待办却丢失原句明确日期的问题；暂缓执行 不再被误解为取消截止时间。 ## [0.3.1-rc.1] — 2026-08-26 ### Changed - 对话整理改为在宿主接受本轮输入时捕获直接用户消息，轮次完成并空闲后由独立后台任务抽取；不再依赖主 agent 主动调用写入工具，也不从整段裁剪历史反推本轮承诺。 - 快速连续轮次按会话串行延后抽取，不再因 30 秒间隔直接丢弃；抽取审计保留原始输出、模型路由、结束原因和用量。 - 默认提醒扫描间隔从 5 分钟缩短为 30 秒；设置允许的最小间隔为 10 秒。 - “今日台账”收敛为低噪“今日进展”：展示新增、完成、推迟、取消、合并和目标变化，提醒扫描、简报生成、已读与反馈仍保留在数据库审计中。 - 全新无数据环境增加克制的品牌空态和“和助手聊聊”入口；真实事项、提醒或关键进展出现后立即让位。 ### Fixed - 修复“今天我需要完成……”等明确承诺可能因宿主生命周期接缝不稳定而没有进入看板的问题。 - 修复“今天/明天”等日期粒度表达被规范为当天午夜、刚写入就被误判逾期并触发提醒的问题；“1 分钟后”等时长表达继续保留带时区的精确时间。 - 修复聚合看板按工作区重复生成早报和晚报的问题；现在所有已知工作区每天各聚合一张早报和晚报。 - 修复短时提醒可能要等待最长 5 分钟，导致右下角提示和侧边栏角标看似未触发的问题。 ## [0.3.0-rc.4] — 2026-08-25 ### Changed - 工作区身份统一为规范化目录，不再按 Git 分支拆分计划；Git、非 Git 与 detached HEAD 会话在同一目录下共享一份连续记录。 - 首次升级会幂等合并同一工作区遗留的 default/main/feature 数据库，保留旧库用于恢复；不同工作区仍保持隔离。 - Today 截止时间改为本地可读日期，摘要明确区分“今天需回应”“全部挂起”和“今天到期”，提醒快捷动作统一显示“推迟 1 天”。 - 事项独立对话改用更自然的开场提问，引导用户说明进展和需要调整的安排。 ### Fixed - 修复 Windows 下同一目录因大小写、分隔符、尾斜杠或 `..` 写法不同而重复登记工作区的问题。 - 修复新消息提示出现时可能重建输入区域、让用户正在输入的对话失去焦点的问题。 - 修复同名工作区标签难以区分的问题；聚合看板会追加最短且稳定的父目录提示。 - 修复 E2E 成功、失败或中断后仍可能留下测试事项、提醒、全文索引和审计记录的问题。 ## [0.3.0-rc.3] — 2026-08-25 ### Fixed - 修复 Today“需要关注”行重复显示同一条理由，以及窄面板长依据可能溢出的问题。 - 修复精确 datetime 已过期却未标为逾期，以及快速记录的 date-only 截止日在当天立即触发提醒的问题。 - 修复全屏对话滚动错误容器，以及用户上翻长历史后被轮询或新回复强制拉回底部的问题。 - 修复插件设置页只有静态说明的问题；现在可编辑并持久化提取、提醒、早晚报与快照配置。 - 修复“每 10 轮工作对话”快照节奏仍额外生成每日快照的问题。 - 修复 Today tab 数字只统计互斥日期桶、与页面实际承接事项不一致的问题。 - 修复慢回复时收起或切换对话形态会丢失等待状态、并可能让用户重复发送的问题；同一宿主运行期内会保守显示已提交/等待较久/已完成状态并保证请求幂等。 - 修复中窄面板全屏对话仍显示“侧栏”但点击无效的问题；现在会返回看板并保留焦点、草稿和等待请求，宽面板仍可真实切回并列侧栏。 ### Known limitations - 对话请求状态尚未持久化为跨宿主重启账本；重启前未进入会话记录的等待项可能无法恢复，临时事项对话整页刷新后不会恢复原临时线程。 ## [0.3.0-rc.2] — 2026-08-25 ### Changed - SQLite 存储迁移到 Node.js 内置的 `node:sqlite`，与 dsh 官方 SQLite 实现保持一致。 ### Fixed - npm 安装不再依赖 `better-sqlite3` 的原生构建脚本，无需手动运行 `approve-builds`。 ## [0.3.0-rc.1] — 2026-08-24 首个助手看板候选版本，重点是跨会话计划管理、低打扰提醒和更稳定的日常交互。 ### Added - 新增助手看板，可集中查看今天、即将、已完成、目标与里程碑和今日台账。 - 对话中的明确待办、目标、里程碑和跟进规则可整理为有状态计划，并在后续对话或看板中更新。 - 到期提醒同时保留在侧栏和看板；页面打开后到达的新提醒会显示右下角轻提示，约 10 秒后自动收起，点击可直接回到看板。 - 新增 YOLO 专属对话和事项独立对话。专属对话用于整体安排，事项对话每次使用新的上下文。 - 看板聚合所有已知工作区，并在每一行标明归属；跨工作区操作会更新对应工作区的数据。 - 新增安静时段、提醒提前量、再次提醒和早晚简报设置。 - 新增语义召回，在用户换一种说法或跨语言表达时仍可找到相关计划；模型不可用时回退到本地搜索。 - 新增本地 SQLite 计划存储和 Markdown 快照，按工作区与 Git 分支隔离。 ### Changed - 助手只保留与承诺、计划、提醒和跟进规则有关的信息，不再把一般偏好、人物画像或通用知识作为长期记录。 - “今天”页面最多突出一个有证据的助手判断，并说明为什么现在需要关注；没有足够依据时不强行给出判断。 - 完成、推迟、取消、重新打开、编辑和再次提醒使用一致的状态与审计记录；完成后提供短暂撤销入口。 - 看板打开时不持续刷新整页；只有动作、手动刷新或新提醒需要定位时更新，减少界面跳动。 - 中英文 README 和使用指南改为面向使用者，开发、测试和发布流程转入维护者文档。 - 安装方式与 dsh 官方插件管理保持一致，发布包提供预构建产物，也支持固定 GitHub 标签安装。 ### Fixed - 修复长标题编辑、目标与里程碑菜单、台账操作等界面的弹层遮挡和内容堆叠。 - 修复判断依据展开后无法收起，以及侧栏与全屏对话切换时内容闪动或丢失的问题。 - 修复提醒只扫描最近工作区、未处理数量不准确，以及跨工作区动作可能写入错误作用域的问题。 - 修复看板打开时无法直接切换宿主会话、事项讨论混入专属对话历史、发送失败残留临时消息等问题。 - 修复暗色主题、文字对比度、键盘操作、窄宽度布局和 reduced-motion 下的可用性问题。 - 修复离线恢复、安静时段、时区、到期日推迟和语义能力降级等提醒可靠性问题。 ## [0.2.0-alpha.1] — 2026-08-21 ### Added - 提供首个 npm 预发布包和基础持续集成。 - 增加项目文档、问题模板和贡献入口。 ### Changed - 依赖改为从 npm registry 安装，不再要求本地 deepseek-harness 源码检出。 - 补齐 npm 包清单、仓库信息和公共包配置。 ### Fixed - 修复时区比较、已完成里程碑搜索、事件 id 和模型输出校验等基础问题。 ## [0.1.0] — 2026-08-21 ### Added - 建立插件、SQLite 存储、对话内容整理、计划召回、提醒和初版看板的完整链路。 - 提供待办、目标、里程碑、跟进规则和事件记录。 - 提供工作区与 Git 分支隔离、全文搜索和 Markdown 快照。 [Unreleased]: https://github.com/hanshanyike/dsh-yolo/compare/v0.5.0...HEAD [0.5.0]: https://github.com/hanshanyike/dsh-yolo/compare/v0.5.0-rc.1...v0.5.0 [0.5.0-rc.1]: https://github.com/hanshanyike/dsh-yolo/compare/v0.5.0-beta.3...v0.5.0-rc.1 [0.5.0-beta.3]: https://github.com/hanshanyike/dsh-yolo/compare/v0.5.0-beta.2...v0.5.0-beta.3 [0.5.0-beta.2]: https://github.com/hanshanyike/dsh-yolo/compare/v0.5.0-beta.1...v0.5.0-beta.2 [0.5.0-beta.1]: https://github.com/hanshanyike/dsh-yolo/compare/v0.4.0-rc5...v0.5.0-beta.1 [0.4.0-rc5]: https://github.com/hanshanyike/dsh-yolo/compare/v0.4.0-rc4...v0.4.0-rc5 [0.4.0-rc4]: https://github.com/hanshanyike/dsh-yolo/compare/v0.4.0-rc3...v0.4.0-rc4 [0.4.0-rc3]: https://github.com/hanshanyike/dsh-yolo/compare/v0.4.0-rc2...v0.4.0-rc3 [0.4.0-rc2]: https://github.com/hanshanyike/dsh-yolo/compare/v0.4.0-rc1...v0.4.0-rc2 [0.4.0-rc1]: https://github.com/hanshanyike/dsh-yolo/compare/v0.3.1-rc.3...v0.4.0-rc1 [0.3.1-rc.3]: https://github.com/hanshanyike/dsh-yolo/compare/v0.3.1-rc.2...v0.3.1-rc.3 [0.3.1-rc.2]: https://github.com/hanshanyike/dsh-yolo/compare/v0.3.1-rc.1...v0.3.1-rc.2 [0.3.1-rc.1]: https://github.com/hanshanyike/dsh-yolo/compare/v0.3.0-rc.4...v0.3.1-rc.1 [0.3.0-rc.4]: https://github.com/hanshanyike/dsh-yolo/compare/v0.3.0-rc.3...v0.3.0-rc.4 [0.3.0-rc.3]: https://github.com/hanshanyike/dsh-yolo/compare/v0.3.0-rc.2...v0.3.0-rc.3 [0.3.0-rc.2]: https://github.com/hanshanyike/dsh-yolo/compare/v0.3.0-rc.1...v0.3.0-rc.2 [0.3.0-rc.1]: https://github.com/hanshanyike/dsh-yolo/compare/v0.2.0-alpha.1...v0.3.0-rc.1 [0.2.0-alpha.1]: https://github.com/hanshanyike/dsh-yolo/compare/v0.1.0...v0.2.0-alpha.1 [0.1.0]: https://github.com/hanshanyike/dsh-yolo/releases/tag/v0.1.0