CodeTrail 0.5.0

CodeTrail 0.5.0

本地、可离线运行的代码导览与 Agent 改动审查工具：Rust 静态分析核心 + 自包含 HTML 工作台 + VS Code 扩展 + Agent Skill。本次新增 C / C++ 语言支持，并准备 VS Code Marketplace 分发。

新增

• C / C++ 语法索引：C（.c、.h）与 C++（.cpp、.cc、.cxx、.c++、.hpp、.hh、.hxx、.h++）。.h 默认按 C++ 解析，失败时回退到 C。只把函数定义建为节点（原型不是节点），支持自由函数、方法、构造/析构函数、运算符重载与 lambda。
• C 静态关系解析：同文件词法调用、本地引号 #include 文件，以及被包含头文件对应的同目录实现文件；这些跨文件静态候选边标记为 c-include-static。
• C++ 静态关系解析：在 C 基础上额外解析 this->method()、同一类内的非限定兄弟方法与唯一的 Class::method 候选。
• VS Code Marketplace 发布准备（publisher wwwh7）：扩展元数据、CHANGELOG 与受确认门控的发布脚本；本轮 Marketplace 发布按计划暂缓，当前使用本 Release 中的 VSIX。

改进

• 图标优化为 256×256（51.6 KB），VSIX 体积由 4.29 MB 降至 3.81 MB。
• Skill/Source zip 文件名由 Cargo.toml 版本号动态生成，不再硬编码版本。
• README/SKILL/扩展 README 增加 C/C++ 支持范围与解析边界说明。

验证

• Rust 测试 56 通过（36 单元 + 4 CLI + 16 workflows），0 警告。
• C/C++ 回归：13 个单元 + 2 个集成测试；examples/cpp-service 扫描 5 文件 / 5 函数 / 3 条 c-include-static 边 / 1 处外部调用未解析 / 0 诊断；增量缓存保留 include 边。
• VS Code Extension Host 10 组集成场景通过；浏览器回归 15 组、JS 错误 0；VSIX 独立目录安装成功。
• 详细结果与边界见仓库 VERIFICATION.md。

资产

文件	字节数	SHA-256
code-trail-0.5.0-win32-x64.vsix	3,996,160	538F09BD2C169214756B507ED97ED9C145272E9587ADA76B2B857FE59E2DECF0
code-trail-0.5.0-skill.zip	3,995,258	950619913CD372587BBA91C7245117D1A682ED56214FD9F379332DEA7FEBDA0D
code-trail-0.5.0-source.zip	8,366,535	A6661BE501125909DB1D45D934C1F2C175BE6AAD99638CEF1AF7E2C90E498F95

平台与边界

• 预编译产物仅 Windows x64；其他平台从源码构建（cargo build --release --locked）。
• C/C++ 是静态语法索引，没有集成 clang/类型检查器：对象/指针上的成员调用、函数指针调用、重载解析与宏需要人工复核，会以明确原因保持未解析（属静态缺口，不是源码错误）。系统头文件视为外部依赖。
• 未发布 VS Code Marketplace；Marketplace 发布后可用 https://marketplace.visualstudio.com/items?itemName=wwwh7.code-trail 安装。

CodeTrail 0.4.0

CodeTrail 0.4.0

本地、可离线运行的代码导览与 Agent 改动审查工具：Rust 静态分析核心 + 自包含 HTML 工作台 + VS Code 扩展 + Agent Skill。

本版重点

• 修复 TypeScript abstract 属性误报（P0）：interface X { abstract?: string }、abstract(): void、类字段等在 tree-sitter-typescript 0.23.2 下会被误报为未支持语法。现在通过等长掩码重试解析，名称/签名/哈希仍来自原始源码；验证项目文件诊断由 7 条降为 1 条（仅超 2 MB 文件），索引快照与函数/边数量不变。
• 分析边界可见（P0）：统计区和顶部新增“分析边界”入口，展示文件诊断、未纳入图调用按原因聚合（12 类）和下一步建议；诊断文本带 path:line:col:。
• 审核队列降噪（P0）：Git 修改审查中的匿名回调 <callback@…> 默认折叠，具名函数变更优先展示，展开状态保留。
• 无说明函数更诚实（P0）：不再统一显示“处理函数数据”，未知名称回退真实函数名，检查器明确标注“未生成职责说明”。
• 扁平仓库模块兜底（P1）：单一目录分组时按文件分组展示。
• CLI 帮助完善（P1）：全部 24 个子命令/操作补齐中文说明。
• 分发与仓库清理：预编译产物改由 GitHub Releases 分发；仓库不再跟踪 bin/、extension/bin/、extension/LICENSE 等生成文件（跟踪体积约 24 MB → 2.9 MB）；README 增加截图、5 分钟上手与平台限制。

资产

文件	内容	SHA-256
code-trail-0.4.0-win32-x64.vsix	Windows x64 VS Code 扩展（VS Code ^1.100.0），内含原生二进制	CCA75DB0C66295DAA05CCA8FCC497288C94AC3DFD6A2A103844EB234FD79A5DA
code-trail-0.4.0-skill.zip	可直接放入 Agent skills/code-trail 的 Skill，含 Windows x64 原生二进制与文档	FD1FA3111C557C86BBF2E06C5F7A4681A1C1DCDA84013293BD9DDDFD82459E7C
code-trail-0.4.0-source.zip	源码与构建脚本，其他平台可自行 cargo build --release --locked	637381B695932CAFA085AFA639A310394D376B87315F20963823EA7306AE3099

平台与边界

• 预编译产物仅 Windows x64；其他平台从源码构建。
• 未发布 VS Code Marketplace。静态分析结果只表示潜在静态可达性，不证明运行时行为变化；数量不是缺陷率。已知边界与未覆盖验证见仓库 VERIFICATION.md。