CAtlas Hub 1.0.0 正式版

发布定位

CAtlas Hub 1.0.0 是面向 VS Code 日常项目管理与代码浏览的首个正式版本，提供项目切换、已打开文件组织、增强函数大纲和个人 TODO 标记功能。

主要变化

• 使用项目集合与别名切换项目，在侧栏配置功能，通过导入导出迁移配置。
• 按目录查看已打开文件，将工作区外文件与其他非项目标签归到后方。
• 提供增强函数大纲、条件编译分组与源码跳转提示。
• 提供个人 TODO 标记、任务描述分组与源码定位，默认不展示项目已有标记。
• 使用本地缓存与增量校验更新标记，改善大型工程扫描、取消操作和部分非 UTF-8 源文件的读取。

安装方式

在 VS Code 扩展视图搜索 CAtlas Hub，确认发布者为 scnable，或打开 插件市场页面 安装。

也可下载本页的 catlas-hub-1.0.0.vsix，通过“从 VSIX 安装”安装，随后按提示重载窗口。已使用 scnable.catlas-hub 的用户可直接升级。

仍使用 local-development.project-butler 的用户，不要直接卸载旧扩展。需先使用旧身份过渡包 project-butler-0.10.0-preview-test-r21.vsix 导出迁移文件，停用旧版并重载，再安装正式版、导入迁移文件并按提示重载。本次发布只附正式包，尚未附带该过渡包；没有过渡包的旧版用户请先通过 Issues 反馈迁移需求。不要同时启用新旧扩展，也不要公开包含本地路径的迁移文件。

兼容范围与注意事项

• 要求 VS Code 1.88.0 及以上；主要验证环境为 Windows，其他操作系统与真实远程、虚拟工作区尚未完成验证。
• 原生视图控制及 AI 设置受 VS Code 版本限制，不可用时按插件提示手动操作。
• TODO 默认只显示个人标记；开启项目已有标记后，大型工程可能产生较多结果及额外扫描开销。
• 超过 2 MiB 的源码默认跳过；编码兼容读取不保证覆盖所有历史编码。
• TODO 标记仍保存在源码中，提交源码会包含标记，当前没有提交前自动剥离功能。
• 如遇内存持续增长、扫描结果异常或升级问题，请暂停受影响功能并反馈，不要附带私密源码或认证信息。

0.10.0 预览测试版

0.10.0 预览测试版

发布定位

这是持续更新的预览测试版本，用于提前体验与验证代码 TODO、配置迁移兼容和大型工作区扫描等能力；不代表 1.0.0 正式版发布承诺。

主要变化

• 代码 TODO 的总开关、关键词和 Markdown 未完成项支持当前集合覆盖；逐字段优先级统一为工作区显式值、当前集合、全局个人值和插件默认值。
• 内部集合存储和导出快照升级到 v3，并兼容读取旧格式；无效 TODO 字段独立回退，不影响其他有效配置。
• 配置视图显示 TODO 字段的实际来源；集合设置修改后立即重新扫描并刷新可见编辑器高亮。
• 扫描失败时恢复上一份有效索引，只展示安全错误类别并标记结果可能过期；视图区分未扫描、扫描中、无结果、筛选无结果、部分结果、取消和失败。
• 新增“清除代码 TODO 筛选”操作，筛选无结果时可以一键恢复全部结果。
• 抽取正式扫描器共用的八路并发引擎，统一取消、跳过、结果提交和 5,000 条安全上限。
• 非 file: 当前文档可通过 VS Code 文档 API 扫描；远程样式工作区不会调用本地 Git/rg，自动使用平台兼容路径。

安装方式

1. 下载本 Release 中的 project-butler-0.10.0-preview-test.vsix。
2. 在 VS Code 扩展视图右上角菜单选择“从 VSIX 安装...”。
3. 选择下载的文件，并按 VS Code 提示重新加载窗口（如有）。

也可以使用命令：

code --install-extension project-butler-0.10.0-preview-test.vsix

兼容范围与注意事项

• 需要 VS Code ^1.88.0。
• 此版本通过 GitHub Release 提供预览测试包，尚未发布到 VS Code Marketplace。
• 远程或虚拟工作区会使用平台兼容扫描路径，本地 Git/rg 快速后端仅适用于相应本地环境。

0.7.5 预览测试版

0.7.5 预览测试版

发布定位

这是持续更新的预览测试版本，用于提前体验项目管理、代码浏览、标签组织与开发环境设置能力；不代表 1.0.0 功能冻结或正式发布承诺。

主要变化

• 在资源管理器新增“已打开文件目录”，按编辑器组、工作区和文件夹展示当前标签，不扫描项目文件。
• 工作区外文件统一进入尾部分组；项目内标签保持用户顺序，不再按文件夹重排或着色。
• 修复外部文件整理后的活动标签竞态，前台打开时保持焦点，用户主动切换后不再抢回。
• 新增目录树与 VS Code 原生“打开的编辑器”互斥选择，并在公开 API 受限时给出明确降级说明。
• 配置栏合并重复入口，直接显示当前实际生效值及来源。
• 集合功能支持“跟随个人默认”，迁移快照升级到 v2，并兼容旧 v1 数据。
• 完善统一图标资源、函数大纲条件编译与 C 结构体识别，以及 VS Code 能力检测。

安装方式

1. 下载本 Release 中的 project-butler-0.7.5-preview-test-r16.vsix。
2. 在 VS Code 扩展视图右上角菜单选择“从 VSIX 安装...”。
3. 选择下载的文件，并按 VS Code 提示重新加载窗口（如有）。

也可以使用命令：

code --install-extension project-butler-0.7.5-preview-test-r16.vsix

兼容范围与注意事项

• 需要 VS Code ^1.88.0。
• 隐藏或恢复原生“打开的编辑器”依赖当前 VS Code 提供的视图命令；命令不可用时会降级为手动操作说明。
• 此版本通过 GitHub Release 提供预览测试包，尚未发布到 VS Code Marketplace。
• 当前仍以“项目管家”作为产品显示名称，正式命名将在后续版本统一处理。