v0.1.30：统一 v3 压缩目录树与配置导航

更新内容

• VS Code / TRAE 与 JetBrains 统一使用 v3 配置，以 / 压缩没有自身备注、且实际只含一个子目录的目录链。
• 新增、修改、删除备注以及实际目录分支增删、路径移动时，自动拆分或重新合并目录链；保留样式、扩展字段和失联备注。
• 配置存在未保存编辑时，不自动覆盖用户内容；保存后补做延迟的结构维护。
• JetBrains 原生 Ctrl / Command 悬浮与点击导航适配压缩路径，在 Project 树中选中或展开目标，不打开源文件。
• VS Code 新增配置路径悬浮链接与资源管理器定位，使用当前文档内容解析完整路径。
• 补充共享协议、目录压缩维护、未保存配置保护和真实 IDE 导航回归测试。

兼容性提示

本版只支持 v3 配置，不再读取或迁移 v1/v2。 升级前请备份旧配置，并按 v3 协议规范 准备配置。未来版本（高于 v3）的配置仍受只读保护。

发布前验证

• 共享 Schema：1 个示例、11 份 fixture、82 个 case 验证通过。
• VS Code：127 项测试及 TypeScript 类型检查通过。
• VS Code 1.107.1 真实扩展宿主：首次运行中途退出（退出码 1，未完成全部用例）；重新运行后 10 项集成测试全部通过。
• JetBrains：强制重新执行全部 151 项测试，失败、错误和跳过均为 0。
• JetBrains 插件构建及结构检查通过。
• 双端正式安装包的版本与嵌入配置协议已核对。
• JetBrains Marketplace 的多版本兼容性验证和人工审核由平台处理，本地结构检查不代表商店审核已通过。

插件商店状态

上传后核实的状态：

• JetBrains Marketplace：0.1.30 已提交稳定渠道，状态为 Under review（审核中），更新 ID：1212346。审核通过后公开发布。
• VS Code Marketplace：0.1.30 已上传，状态为 Verifying（平台验证中）。验证通过后可从商店更新。

提交成功不等于审核或验证已完成；等待期间可从下方安装包手动安装。

安装包

• codebase-notes-jetbrains-0.1.30.zip：JetBrains IDE，最低 IntelliJ Platform 2025.3（build 253）。
• codebase-notes-vscode-0.1.30.vsix：VS Code / TRAE，最低 VS Code 1.107.0。

SHA-256：

49ab56fc5b025ba6ac904255f22e11c2741dbbd01c82f1df380e26cd461e7fad  codebase-notes-jetbrains-0.1.30.zip
2f5d389beb591ef13a030755db19e0c83ce9c5afa6f7656269aa3bc8a37e0f12  codebase-notes-vscode-0.1.30.vsix

v0.1.29：支持从备注配置定位项目路径

更新内容

• JetBrains 支持在项目根目录的 .codebase-notes.json 中，通过 Command（macOS）或 Ctrl（Windows/Linux）+ 鼠标左键点击路径属性名，在 Project 项目树中定位目标。
• 文件仅选中，不打开编辑器；目录选中并展开。按住快捷键悬浮时显示 IDE 原生跳转提示，遵循当前 Keymap 的声明跳转快捷键。
• 兼容 v1 平铺路径及 v2 树形路径，支持父级路径组合和下划线转义；备注文字、元数据、无效或不存在的路径不会触发导航。
• JSON 插件为可选依赖；此导航功能需要启用 IDE 自带的 JSON 插件。
• 同步双端版本、更新说明和下载链接；本次新增功能位于 JetBrains 端，VS Code / TRAE 随统一版本发布。

发布前验证

• 共享 Schema：1 个示例、11 份 fixture、62 个 case 验证通过。
• VS Code：97 项测试通过。
• VS Code 1.107.1 真实扩展宿主：9 项集成测试通过。
• JetBrains：强制重新执行全部 123 项测试，失败、错误和跳过均为 0；包含 15 项配置路径导航测试。
• JetBrains 构建及插件结构检查通过；双端正式安装包已生成。
• JetBrains Marketplace 的多版本兼容性验证和发布审核仍由平台处理，不代表已经完成商店审核。

安装包

• codebase-notes-jetbrains-0.1.29.zip：JetBrains IDE，最低 IntelliJ Platform 2025.3（build 253）。
• codebase-notes-vscode-0.1.29.vsix：VS Code / TRAE，最低 VS Code 1.107.0。

SHA-256：

79a63de6e566893d8339887153b8f551aa08f92effc33f984a61040b84de8422  codebase-notes-jetbrains-0.1.29.zip
c4cd238ff3824f723d8821ecaf78e45aee7b3cc2c801d6a0d9c260e8b7cb23b9  codebase-notes-vscode-0.1.29.vsix

插件商店状态

• JetBrains Marketplace：0.1.29 已上传至稳定渠道，状态为 Under review（审核中），更新 ID 为 1211329。审核通过后公开发布；提交审核不等于自动更新已生效。
• VS Code Marketplace：CLI 令牌校验失败后，已通过登录的发布后台成功上传 0.1.29，目前处于 Verifying（平台验证中）。可先使用本 Release 的 VSIX 手动安装。

v0.1.28

更新内容

• 优化 .codebase-notes.json 写回排版：叶子备注整体单行，同一节点的 _text 与简单 _meta 放在一起；只有下级路径和复杂嵌套数据展开。
• 保留目录层级、稳定字段排序、两空格缩进和末尾换行，不因文字长度自动折行。
• 同步 VS Code / TRAE 和 JetBrains 序列化规则；保持 v2 协议与备注、样式、扩展属性内容不变。
• 更新配置示例、协议说明和双端一致性、重复序列化及真实扩展宿主回归测试。

升级说明

• 不需要迁移配置或修改协议版本。
• 打开项目本身不会改写配置；下次成功保存备注时应用紧凑排版，首次保存会产生格式差异。
• 通用 JSON 格式化器可能重新展开内容，不影响插件读取。

发布前验证

• VS Code：97 项单元及契约测试通过。
• JetBrains：108 项测试通过。
• VS Code 1.107.1 真实扩展宿主：9 项集成测试通过，包括紧凑排版、重新读取、重复保存、旧配置迁移与路径重命名。
• 双端正式安装包构建通过。

安装包

• codebase-notes-vscode-0.1.28.vsix：VS Code / TRAE
• codebase-notes-jetbrains-0.1.28.zip：JetBrains IDE

发布后验证

• 从 GitHub Release 重新下载双端安装包，SHA-256 均与本地正式产物一致。
• 将 GitHub 线上 VSIX 安装到独立扩展目录，在真实 VS Code 1.107.1 中验证版本为 0.1.28，9 项集成测试全部通过。
• VS Code Marketplace 验证完成并公开上线后，再从商店直接安装 joeljhou.codebase-notes-vscode@0.1.28 到另一独立环境，9 项真实扩展宿主集成测试再次全部通过。
• 通过实际命令面板编辑备注并打开生成的 JSON，确认文字与样式保留、叶子节点单行、分支 _text / _meta 同行，界面截图核验通过。
• 使用线上 JetBrains ZIP 中的实际 JAR 验证 8 个序列化契约及完整项目配置，两端字节输出一致；这不是 JetBrains IDE 图形界面安装验收。

插件商店

• VS Code Marketplace：0.1.28 已完成验证并公开上线（Public），已直接从商店安装并通过真实扩展宿主测试。
• JetBrains Marketplace：0.1.28 已上传，审核中（Under review），更新 ID 为 1205503。
• 商店审核由平台完成，在审核结束前可使用本 Release 安装包；提交审核不等于商店自动更新已经生效。

v0.1.27

更新内容

• VS Code / TRAE 与 JetBrains 统一支持 v2 嵌套目录树配置：普通备注直接使用字符串，目录自身备注使用 _text，样式和扩展字段按需存入 _meta。
• 兼容读取 v1 扁平配置，在下一次成功保存时自动无损迁移；仅打开项目不会改写文件。迁移保留原有文本、样式、扩展字段、根备注及缺失路径备注。
• 完善特殊文件名转义、父备注删除保留子备注、目录移动与并发合并；增加双端共享一致性与迁移回归测试。
• 同步 JSON Schema、示例及配置协议文档。

升级提示

• 建议升级前备份 .codebase-notes.json。
• 以 _ 开头的真实文件名在配置中额外加一个 _，如 _text 文件写为 __text。
• 旧版插件会将 v2 配置作为未来版本只读处理，团队应同步升级两端插件。

验证

• VS Code：91 项单元及契约测试通过。
• JetBrains：102 项测试通过。
• TypeScript 类型检查及双端构建通过。
• VS Code 独立迁移扩展宿主用例通过；完整集成套件因扩展宿主途中提前退出，未取得完整结果。
• 用户已在 IntelliJ IDEA 手动安装并确认功能正常。

安装包

• codebase-notes-vscode-0.1.27.vsix：VS Code / TRAE
• codebase-notes-jetbrains-0.1.27.zip：JetBrains IDE

v0.1.26

更新内容

• 修复 JetBrains Project 视图中 Kotlin 单类文件等 PSI 替代节点不显示备注的问题，并对所有物理文件类型使用统一解析规则。
• JetBrains 编辑备注时，确认空输入会直接清除已有备注，与 VS Code / TRAE 保持一致。
• 修复清除备注后旧文字可能因异步刷新竞态继续显示的问题，并增加刷新异常恢复保护。
• JetBrains Marketplace 的 “What’s New” 现在会从共享 CHANGELOG 自动生成，避免版本号和更新说明不同步。

验证

• VS Code：56 个测试全部通过。
• JetBrains：68 个测试全部通过。
• JetBrains Plugin Verifier：IDEA 2025.3.4（build 253）与 2026.1.4（build 261）均为 Compatible。

安装包

• codebase-notes-vscode-0.1.26.vsix：VS Code / TRAE
• codebase-notes-jetbrains-0.1.26.zip：JetBrains IDE

v0.1.25

更新内容

• 完善 JetBrains Marketplace 插件介绍、使用说明、功能列表和官方链接。
• 更新项目首页中的 VS Code 与 JetBrains Marketplace 官方入口。

安装包

• codebase-notes-vscode-0.1.25.vsix：VS Code / TRAE
• codebase-notes-jetbrains-0.1.25.zip：JetBrains IDE

v0.1.23

更新内容

• 取消代码备注树与系统资源管理器之间的目录展开单向同步，两棵树各自维护展开状态，避免造成双向同步的错误预期。
• 保留活动文件在代码备注树中的自动展开与选中。

v0.1.22

• “代码备注”资源树跟随活动编辑器，自动展开并选中当前文件。
• 手动展开“代码备注”目录时，单向在系统资源管理器中定位该目录。
• 移除冗余的 N badge，保留备注主题色和完整 tooltip。

SHA-256：

• codebase-notes-vscode-0.1.22.vsix: 3b7ae8c49a4f432926d3fdf20e4f6a12b6e91e9ae8daa9ac7ec4aad3dc017a67
• codebase-notes-jetbrains-0.1.22.zip: 4b23a6c2cfc8f323c35ed8645eb15f4f1ab4ac545441161f3362034372b4588c

v0.1.21

• JetBrains 恢复 Shift+Option+R / Shift+Alt+R 设置备注样式默认快捷键。
• 若与“重新运行测试”等 IDE 操作冲突，可在 Keymap 中自行删除或修改其中一个快捷键。
• 保留 VS Code 样式预览只刷新当前节点的性能优化。

v0.1.20

• VS Code 样式实时预览改为只更新当前节点，不再刷新整棵代码备注资源树。
• JetBrains 移除与“重新运行测试”冲突的默认样式快捷键；可在 Keymap 中自行绑定。
• 编辑文字备注继续保留 Alt/Option+R 默认快捷键。