# Changelog > 中文 · [English](CHANGELOG.md) 本项目版本遵循 [Semantic Versioning](https://semver.org/lang/zh-CN/)。 仅记录用户可见的功能性改动（不记录文档、代码重构、构建/工具链调整）。 **记录规则**： - 分类固定为 **Breaking（破坏式变更）→ Added（新功能）→ Fixed（修复）** 三种，按此顺序排列； 记录时若该改动归属的分类不存在，则**添加分类**；若某分类下没有任何记录，则**删除分类**。 - 某个功能在当前版本加入时，只在 **Added** 记录一次；**同一版本内**对该功能的修复 **不再记入**（那是构建该功能的一部分，不是对已发布行为的修复）。 - **Fixed** 只记录对**历史版本**已有功能的修复。 - **dsh 版本适配**：升级适配某个 deepseek-harness 版本时，在对应版本的 **Added** 加一条 「适配 deepseek-harness `<版本>`」，说明迁移内容（依赖 / 符号 / API 变更）。它表达 「该插件版本已验证支持该 dsh 版本」，与[兼容性对照表](docs/compatibility.zh.md)互补—— 表记「哪个插件版本 ↔ 哪个 dsh 版本」的组合，CHANGELOG 记「这次适配改了什么」。 - **不写操作介绍**——一条改动只写功能说明，并链接到[使用文档](docs/usage.zh.md)对应章节 （链接精确到标题）。用法说明放在使用文档里，不放进 CHANGELOG；若文档还没有该功能， 先补进文档，再引用。 - 未发布的改动写入顶部 **`## NEXT_VERSION`** 块；发版时执行 `npm run changelog:release -- <版本号>`——脚本会把 `NEXT_VERSION` 改名为 `[<版本号>] - <日期>`， **不新增** `NEXT_VERSION`（开发空窗期不留空块）。写入改动时先检查是否存在 `NEXT_VERSION` 块——没有就先添加一个，再在块下记录新改动。 ## [0.13.0] - 2026-09-11 ### Breaking - **升级 dsh ≥ `0.1.5-alpha.1` 后，旧 dsh 上用过 `@` 笔记引用的历史会话无法打开**：dsh `0.1.5-alpha.1` 把会话日志格式升到 V3，加载 V2 旧日志时迁移层对消息 `source.kind` 做 白名单校验，而旧版插件注入的上下文使用自定义 kind `'md-notes'`（不在白名单内）—— 含这类事件的日志**整体被拒绝读取**（报 `cannot safely transform unclassified message source`）。根因是 dsh 侧的格式迁移策略，**插件无法修复已写入的历史日志**（日志文件 归 dsh 管理，插件只产出事件、不触碰存储）。缓解：升级 dsh 前导出/归档用 `@` 引用过 笔记的会话，或等 dsh 上游把 `'md-notes'` 加入迁移白名单（[docs/TODO.md](docs/TODO.md) 顶部兼容条目跟进中）。本版本起注入已改用官方 source 形态，**新会话不受影响**，且 新版插件在旧 dsh（V2 日志）上写入的会话也能平滑迁移。设置面板现提供 **「历史会话修复」**一键改写（见下 Added），可就地恢复受影响的旧会话。 ### Added - **设置面板新增「历史会话修复」**：一键扫描全部本地会话日志，把旧版本插件写入的 `md-notes` 消息来源改写为官方 `plugin` **最小形态**（按 v0→v1 迁移的精确键集去掉 `path` 等额外成员；可重复执行、二次清理），使被 dsh 0.1.5+ 拒绝打开的历史会话恢复 可读。原文件逐个在同目录备份（`*.dsh-md-notes-repair.bak`）、原子替换、无需重启；结果 内联回报（扫描/修复数、失败数、以及 dsh 自身历史来源类型导致的仍不可读提示）。见 [docs/usage.zh.md §6](docs/usage.zh.md#6-设置面板)。 - **dsh 版本对齐规则（只对齐稳定版）**：插件此后只对齐 dsh 的 `rc` 与（将来的）`final` 版本——dsh 的 npm `latest` 指向的就是 rc，即用户实际安装的版本；`alpha` 不再逐版做 兼容性校验（一条 minor 线的 alpha 由该线 rc 的一次校验整体覆盖，仅「使用其新能力」 或「追认破坏性变更」时定点检查）。规则详见 [README 兼容性章节](README.zh.md#兼容性compatibility) 与 [docs/compatibility.zh.md](docs/compatibility.zh.md)。 - **@ 笔记 chip 点击预览**：发送前点击输入框里已插入的笔记 chip，在右侧栏笔记查看器中 打开该笔记（dsh 0.1.5+ 的引用预览手势）；无右侧 Sidebar 的构建上点击行为不变。见 [docs/usage.zh.md §4.1](docs/usage.zh.md#41-选择笔记)。 - **@ 候选菜单行首图标换插件 logo**：与 chip 上的 logo 呼应（此前为通用文件图标）。 - **搜索结果「在侧栏查看」**：笔记管理器搜索结果里，每篇笔记行尾新增面板图标——在 右侧栏笔记查看器中打开该笔记（绝对文件地址经 `openResource` 路由，同笔记复用同一 tab）并收起全屏管理器。需要 dsh 0.1.5+ 的右侧 Sidebar；旧版本按钮自动隐藏。见 [docs/usage.zh.md §9](docs/usage.zh.md#9-在右侧栏快速查看笔记dsh-015)。 - **预览本地图片渲染**：笔记中的本地路径图片（`![](img.png)`、`../shot.png`、绝对 路径）在管理器预览与侧栏查看器中直接显示——经 `MarkdownText.pathImages` 词汇表 改写为同源认证的 `/api/file` URL（目标相对笔记所在目录解析）。dsh < 0.1.5 或非 HTTP 载体（Electron `file://`）不启用，退回 alt 文本。见 [docs/usage.zh.md §9](docs/usage.zh.md#9-在右侧栏快速查看笔记dsh-015)。 - **右侧 Sidebar 笔记查看器**：dsh 0.1.5+ 的右侧停靠面板里，笔记文件（`/.dsh-notes/…/*.md` 地址）以 markdown 渲染打开（`extension` 优先级接管内置纯文本预览）——对话文件链接、 文件树点选即达；正文互链（`` `名` `` / `[[名]]`）点击在侧栏开新 tab；头部含标题、 工作区与手动刷新；只读（编辑仍在管理器）。旧版 dsh 上自动停用。见 [docs/usage.zh.md §9](docs/usage.zh.md#9-在右侧栏快速查看笔记dsh-015)。 - **适配 deepseek-harness `0.1.5-alpha.1`**：注入上下文的 source 迁移到官方 `plugin` 变体（`{ kind: 'plugin', plugin: 'md-notes', path }`），满足 V2→V3 日志迁移的 source 白名单——`@` 引用注入、注入上下文行渲染（标签仍显示 `md-notes`）与跨步去重行为 不变。背景与选型依据见 [docs/context.md §3.7](docs/context.md#37-模型可靠性host-端内容注入已实现)。 ### Fixed - **预览互链新增 markdown 路径链接解析**：注入约定教模型用 `[标题](路径)` 引用笔记， 这类链接随回答「记入笔记」后原样留在笔记里，预览却只认 `` `名` `` / `[[名]]`` 两种 写法——现在 `[任意文字](.dsh-notes/…)`（含 `../<工作区>/…` 跨工作区与深度不严格匹配的 模型笔误形式）也会改写成可点互链；图片链接与未知目标保持原样。管理器预览与侧栏 查看器同步生效。 - **点击跨工作区笔记 chip 崩溃（查看器不弹、引用删不掉）**：跨工作区引用的预览地址带 `..` 段，而侧栏 tab 路由的 picomatch `**` 不匹配 `..`——没有任何类型认领，`claim` 抛错并穿透进 Lexical 命令处理，把编辑器状态打坏（后续一串 #20 报错、chip 无法删除）。 现在跨工作区引用经工作区快照解析为**绝对地址**（纯内存导航参数，不进草稿/消息/笔记/ 日志，无隐私面）；快照未就绪或任何打开失败都安全拒绝（点击无副作用），绝不再向 编辑器抛异常。 - **启动后首页 `@` 菜单无笔记（需刷新才恢复）**：`dsh web` 刚启动时自动打开的页面上， 草稿会话尚未在 host 侧物化，`@` 的会话级笔记列表把这次「暂时为空」的结果**永久缓存**， 导致无论等多久菜单都没有笔记、只有刷新页面才恢复。现在区分「暂时空」（下次打开 `@` 自动重试）与「确实没有工作区」（照旧缓存）。 - **冲突解决后的 `.conflicts` 残留**：sidecar 清理此前只挂在 AI 推送工具一条路径上—— 经管理器推送或「合并远端并重试」完成解决后，`.dsh-notes/.conflicts/` 目录会残留。 现在清理移到 `gitPush` 成功出口统一执行（所有推送路径共用，AI 流程不变）。 - **@ 引用不再携带绝对路径**：极小概率（会话工作区列表尚未就绪时选中笔记）引用会在 消息里序列化出包含本机主目录的绝对路径，并可能随「记入笔记」进入 git 同步的仓库。 现在这种情况改为不插入引用（重新选择即可）；旧版本已插入的绝对路径 chip 在发送时 也会改写为「工作区名/.dsh-notes/笔记名」形式——引用从此只含相对路径。 - **记入笔记失败提示的英文泄漏**：写入失败时界面会把 host 侧原始英文错误串（如 `assistant message not found`）直接拼进本地化文案。现在空回答拒绝改为错误码 （`empty-answer`）并新增对应文案，所有带错误码的失败按码走本地化，仅无码的传输 错误才回退原文。 ## [0.12.0] - 2026-09-06 ### Added - **AI 解决 Git 冲突**：推送拦截与更新冲突的确认弹窗新增「AI 解决」按钮——在冲突工作区 新建对话，把冲突笔记的本地版/基线/远端版提交给 AI 做语义合并（无法确定的合并点会向 你提问）；完成后 AI 经 dsh 原生审批面板请求推送，确认后才覆盖远端。详见 [docs/ai-conflict.md](docs/ai-conflict.md)。 - **笔记搜索**：笔记管理器顶部栏新增搜索框——跨全部工作区的全文搜索（标题 + 正文、 大小写不敏感；空格分隔多关键词，AND 组合）。结果按工作区分组，展示命中行片段与 关键词高亮；点命中行在编辑器中打开笔记并定位到该行、关键词处于选中态。见 [docs/usage.zh.md §2「搜索笔记」](docs/usage.zh.md#搜索笔记)。 - 设置面板的 Git 模式下拉改为 dsh 官方风格自定义菜单（portal 弹层、勾选行、 外点/Esc 关闭），替代 OS 原生 select 弹出；文本输入框边框与聚焦样式对齐 harness 设置表单。见 [docs/usage.zh.md §6](docs/usage.zh.md#6-设置面板)。 ### Fixed - 修复网络较慢时「保存笔记卡十多秒」：打开管理器时各工作区的 Git 状态请求原为并发 （共享仓库下服务端本就串行，并发只是空占连接），加上自动拉取，网慢时占满浏览器同源 连接池，保存请求被迫排队。现改为逐个串行获取状态，保存不再被 Git 请求阻塞。 - 修复「合并远端并重试」合并冲突后 Git 仓库克隆永久卡死的问题（MERGE_HEAD 未清理导致 后续所有同步报错）；现在会自动中止残留合并并恢复可用。 ## [0.11.0] - 2026-09-04 ### Breaking（破坏式变更） - 移除从未被使用的 `gitSuggest` API 方法（及其 client 封装）：插件内无任何 调用方，且它向任意调用者暴露工作区路径。 - 移除 `route` 配置项。HTTP API 前缀在前后端都固定为常量 `/plugins/md-notes`： 前端本就硬编码该值，覆盖后端前缀只会断开前后端链接。 已有配置里的 `route` 键不会导致加载失败（schemastery 放行未知键，值被忽略）。 ### Added（新功能） - 新增 `checkUpdate` 配置（默认 `true`）：设为 `false` 后 host 不再访问 registry.npmjs.org——离线/受管部署下，此前的版本检查是无条件外呼。 ### Fixed - 修复 Git 新设备（或新 clone + 空笔记目录）首次同步两条缺陷：① 拉取不生效——「本地 缺失」被误判为「本地已改」而跳过复制，自动拉取还被「远端无新提交」短路，远端笔记 拉不下来；② 此时推送会在**无确认**的情况下镜像清空远端全部笔记。现在首次同步前 基线视为空（同步标记持久化在 clone 的 `.git/` 内，不入库）：首次拉取把远端笔记全部 带下来，首次推送以「远端有更新」拦截并要求确认。 - 修复侧边栏底部多个入口互相挤压/溢出（[#2]）：dsh 的 `.footerActions` 把 `width:100%` 的子项（默认自带的 cordis 入口与笔记入口）排在同一不换行行内。 插件现以 `[data-slot]` 锚点规则改为纵向堆叠——只加一条自己持有、卸载自动 移除的 `