CodeTrail 0.3.2 · Windows x64 Preview

简约运行记录：默认只看验证目标、输入、预期、实际结果和最多5个关键中间值，过程与代码按需展开。

• Agent 可通过 agent validate 的可选 record 配置，在实际执行检查命令后生成验证记录。业务变量须显式采集，不推演、不补造结果。
• 保留旧运行记录；缺少预期时如实提示，执行结束不等于符合预期。保留现有功能关联、人工批注和阅读确认隔离。
• 请同步使用本发行版的桌面应用、reader-cli 和 Python SDK；旧严格读取器可能拒绝新摘要字段。

下载 CodeTrail_0.3.2_windows_x64_setup.exe；Agent 配套工具下载 CodeTrail-tools-0.3.2-windows-x64.zip。普通阅读无需 Rust、npm、Python 或 API Key。缺少 WebView2 时安装器需联网安装。更新保留项目 .reader/ 与应用私有数据；建议先备份。

验证已通过：122项 Rust、21项前端、3项 SDK 测试。Windows Server 2022 x64 云构建机的 Rust、前端、SDK、Clippy、功能关联/概览与统一交付校验，以及最终 CLI 真实验证记录、NSIS 静默安装、精确二进制比对、许可资源和原生窗口渲染检查。详见附件报告和 本次工作流。

仅 x64 Preview，无代码签名。Windows 10/11 物理设备人工验收、Windows ARM、32位和两台物理电脑联机未完成；不要关闭安全保护。

自有代码：PolyForm Noncommercial 1.0.0；商业销售或服务另行授权，见仓库商业许可说明。第三方保留各自许可。附件不包含用户运行数据、批注、活动记录或真实项目。

源码提交：aba2bfc137a31a45707fc2209809078fa5ef6f89。

CodeTrail 0.3.2 · Mac Apple Silicon Preview

简约运行记录：默认只看验证目标、输入、预期、实际结果和最多5个关键中间值，过程与代码按需展开。

• Agent 可通过 agent validate 的可选 record 配置，在实际执行检查命令后生成验证记录。业务变量须显式采集，不推演、不补造结果。
• 保留旧运行记录；缺少预期时如实提示，执行结束不等于符合预期。保留现有功能关联、人工批注和阅读确认隔离。
• 请同步使用本发行版的桌面应用、reader-cli 和 Python SDK；旧严格读取器可能拒绝新摘要字段。

下载 CodeTrail_0.3.2_aarch64.dmg；Agent 配套工具下载 CodeTrail-tools-0.3.2-macos-arm64.tar.gz。普通阅读无需 Rust、npm、Python 或 API Key。更新前退出旧应用，替换应用程序，不删除项目 .reader/ 或应用私有数据；建议先备份。

验证：Apple Silicon / macOS 27，126项 Rust、21项前端、3项 SDK 测试、Clippy、生产构建、功能关联/概览与统一交付校验通过；最终 CLI 验证实际命令生成摘要和旧格式读取；生产桌面实际检查真实隔离运行摘要（150 → 120），详情默认收起。附件含验证摘要与 SHA-256。

仅 Apple Silicon Preview；Intel Mac、旧 macOS、两台物理设备局域网互联未逐一验收。应用仅本地临时签名，无 Developer ID 和公证；请核对来源与 SHA-256，按系统正常提示处理，不关闭安全保护。

自有代码：PolyForm Noncommercial 1.0.0；商业销售或服务另行授权，见仓库商业许可说明。第三方保留各自许可。附件不包含用户运行数据、批注、活动记录或真实项目。

源码提交：aba2bfc137a31a45707fc2209809078fa5ef6f89。

CodeTrail v0.3.1 · Windows x64 Preview

Windows x64 0.3.1 预览版：代码搜索与 C/C++ 符号阅读，并保留局域网共读能力。

下载与更新

• 普通用户下载 CodeTrail_0.3.1_windows_x64_setup.exe，运行安装向导。
• Agent 同步更新 CodeTrail-tools-0.3.1-windows-x64.zip 中的 reader-cli.exe、SDK 与协议；旧 0.3.0 CLI 不含新解析器。
• 核对 SHA256SUMS-windows.txt；验证报告与原生窗口截图随附。
• 更新前退出旧版并备份项目；项目 .reader/ 的批注、运行与阅读状态继续保留。

新增与改进

• 原搜索框增加函数定义、变量及代码文字匹配，点击结果跳到文件和行。文字结果跳转核对源码摘要，显示搜索范围限制，隔离旧查询结果。
• C/C++ 函数定义/声明、命名空间、类/结构体、类型别名、宏、常见模板、重载、构造/析构与运算符方法可建立功能关联。
• 共享 .h 可尝试 C++ 解析；CLI inspect/deliver/check/draft 与桌面使用相同核心。

运行条件与验证范围

基本阅读无需 Rust、npm、模型或 API Key；Git 差异需要 Git，可选 Pyright 增强需要 Node.js 22.12+。缺少 WebView2 时安装器会联网从微软下载。

Windows Server 2022 x64 云端执行 Rust、前端、SDK、真实 Pyright、Clippy、关联与概览及统一 validate；最终发布 CLI 另执行隔离 C/C++ inspect/deliver/check。安装器经隔离安装，核对最终二进制、架构、许可、WebView2 原生演示界面与新搜索入口。

C/C++ 是语法阅读，不展开宏或提供完整调用关系。文字搜索可能匹配注释，且有范围上限。Windows 10/11 物理设备人工验收与两台物理电脑联机仍待完成；不将云端测试等同于这些验证。

本版未做 Windows 代码签名，可能显示未知发布者提示；请核对来源与摘要，不关闭系统安全保护。局域网明文 HTTP 仅适用可信网络。

自有代码采用 PolyForm Noncommercial 1.0.0，商业授权见 COMMERCIAL-LICENSE.md，第三方保留原许可。

Source commit: 7db14e3eea166d6996968e5ee9e9a9ce5c358b68.

Source and usage

Windows build and validation

本次实际结果：118 项 Windows Rust 测试、18 项前端测试、3 项 SDK 测试通过；最终 CLI 的 C/C++ 交付、安装后二进制匹配、架构、许可和原生搜索入口检查通过。

CodeTrail v0.3.1 · Apple Silicon Mac Preview

Apple Silicon Mac 0.3.1 预览版：代码搜索与 C/C++ 符号阅读，并保留局域网共读能力。

下载与更新

• 下载 CodeTrail_0.3.1_aarch64.dmg，将 CodeTrail 拖入“应用程序”。更新前退出旧版并备份项目；替换应用不会清理项目 .reader/ 或应用私有数据。
• Agent 使用 CodeTrail-tools-0.3.1-macos-arm64.tar.gz 中同版本 reader-cli。旧 0.3.0 CLI 不含 C/C++ 解析器，请同步更新。
• 核对 SHA256SUMS-mac.txt，验收摘要见 CodeTrail-Mac-validation.json。

新增与改进

• 左侧原搜索框同时查找函数定义、变量及代码中的文字，结果带文件和行号，点击定位。支持防抖、旧请求隔离、搜索范围提示及文字结果源码摘要校验。
• C/C++ 函数定义/声明、命名空间、类/结构体、类型别名、宏、常见模板、重载、构造/析构与运算符方法可用于功能关联。
• 共享 .h 头文件按需要尝试 C++ 解析；C 文件使用相应高亮。
• CLI 的 inspect/deliver/check/draft 可处理 C/C++ 符号，协议保持兼容。

验证与边界

Apple Silicon / macOS 27：122 项 Rust、18 项前端、3 项 SDK 测试及 Clippy、功能关联、项目概览、统一 validate 通过。干净源码生产构建、最终 CLI 的隔离 C/C++ 交付、337 项依赖声明、DMG 完整性核验通过。直接从 DMG 启动，验证 C/C++ 关联阅读、函数与变量搜索跳转、20 项功能概览与新增搜索步骤定位。

C/C++ 是语法阅读，不展开宏、不加载编译数据库，也不提供完整调用关系；文字搜索可能命中注释。搜索有文件/字节/结果上限，未命中不证明不存在。

本版无 Apple Developer ID 签名或公证，只有本地完整性签名。遇到系统提示请核对来源与摘要并按 macOS 正常提示处理，不关闭系统安全保护。未验收 Intel Mac、旧版 macOS 或两台物理设备联机。局域网仅适用可信网络，明文 HTTP，主持电脑需保持在线。

自有代码采用 PolyForm Noncommercial 1.0.0；商业授权见 COMMERCIAL-LICENSE.md，第三方保留原许可。

Source commit: 7db14e3eea166d6996968e5ee9e9a9ce5c358b68.

Source and usage

CodeTrail v0.3.0 · Apple Silicon Mac Preview

Apple Silicon Mac 0.3 预览版，与 Windows 0.3 提供同一套阅读、局域网共读和加载优化能力。

下载与安装

• 下载 CodeTrail_0.3.0_aarch64.dmg，打开后将 CodeTrail 拖入“应用程序”。
• Agent 配套工具：CodeTrail-tools-0.3.0-macos-arm64.tar.gz，包含同版本 CLI、Python SDK、协议与第三方许可。
• 核对 SHA256SUMS-mac.txt；验收范围见 CodeTrail-Mac-validation.json。
• 已安装用户先退出旧版再替换应用。项目 .reader/ 与应用私有数据保留，建议先备份项目。

本版变化

• 可信 IPv4 局域网共同阅读同一版本代码，无需独立服务器。
• 共享批注、任务整合、耦合与依赖检查、按负责人导出 Markdown。
• 真实网卡邀请地址识别，不再依赖代理默认路由。
• Git 批量读取复用进程，降低项目加载与改动读取等待。

验证与边界

Apple Silicon / macOS 27：114 项 Rust/CLI、17 项前端、3 项 Python SDK、Clippy、功能关联及概览、统一 validate 通过；干净源码生产应用与 CLI 构建通过。第三方许可按 Mac 依赖重新收集。DMG 校验和通过，已直接从 DMG 启动，验证演示界面、19 项功能、项目概览及源码跳转；应用与 CLI 均为 ARM64。

未对 Intel Mac、旧版 macOS、两台物理设备联机作兼容性承诺。局域网使用明文 HTTP，仅用于可信网络，主持电脑需保持应用运行。

本版只有本地完整性签名，没有 Apple Developer ID 签名或公证。系统可能拦截首次启动；请核对来源与摘要并按 macOS 正常提示处理，不关闭系统安全保护。基本阅读无需 Rust、npm、模型或 API Key；Git 差异需要 Git，可选 Pyright 增强需要 Node.js 22.12+。

自有代码采用 PolyForm Noncommercial 1.0.0，商业授权见 COMMERCIAL-LICENSE.md；第三方组件保留原许可。

源码提交：d9efbc04bdfe71c2561310891db34f71d921ab8f。

Windows 0.3 下载 · 使用指南

CodeTrail v0.3.0 · Windows x64 Preview

Windows x64 0.3 预览版，包含局域网共读及项目加载优化。

下载与安装

• 普通用户：下载 CodeTrail_0.3.0_windows_x64_setup.exe，运行安装向导。
• Agent 工具：CodeTrail-tools-0.3.0-windows-x64.zip，包含同版本 CLI、Python SDK、协议及许可材料。
• SHA256SUMS-windows.txt 用于核对安装包和工具包。
• 更新安装保留项目 .reader/ 内的功能关联、批注、运行记录与人工阅读状态；建议先备份项目。

本版变化

• 无需独立服务器，在可信 IPv4 局域网内共同阅读同一版本项目。
• 明确共享批注，整合任务、检查作用域重叠及依赖，按负责人导出 Markdown。
• 通过真实网卡生成邀请地址，修复代理默认路由导致的地址识别问题。
• Git 比较复用批量对象读取进程，避免逐文件反复启动 Git。
• 后台 Git 和 Node 使用 Windows 隐藏控制台启动设置。

运行条件与验证范围

• Windows x64；基本阅读无需 Rust、npm、模型或 API Key。
• Git 差异需要 Git；可选 Pyright 语义增强需要 Node.js 22.12+。
• 缺少 WebView2 时，安装器会从微软下载运行时，需要联网。
• Windows Server 2022 x64 云构建执行源码/功能关联、Rust/CLI、Clippy、前端、SDK、真实 Pyright、桌面构建及安装后原生渲染检查。随附验证报告和实际窗口截图。
• 未完成 Windows 10/11 物理设备人工验收及两台物理电脑局域网互联验收；不将云端自动测试等同于这些验证。
• 局域网使用明文 HTTP，仅适用于可信网络；主持电脑需要保持应用运行。不提供公网穿透。
• 当前无 Windows 代码签名证书，可能显示未知发布者提示；不要关闭系统安全保护。

自有代码采用 PolyForm Noncommercial 1.0.0，商业授权见仓库 COMMERCIAL-LICENSE.md。第三方组件保留原许可证。

源码提交：428cfb784d02bdb38fc876a7c8b966590d84f041。

Windows 构建与验证记录 · 使用指南

CodeTrail v0.2.0 · Windows x64 Preview

CodeTrail 首个 Windows x64 预览版。Mac 版本继续在原 Mac Release 中提供。

下载

• CodeTrail_0.2.0_windows_x64_setup.exe：Windows x64 安装器，为当前用户安装。
• CodeTrail-tools-0.2.0-windows-x64.zip：同版本 reader-cli.exe、Python 采集 SDK、协议文档及第三方许可和源码。
• CodeTrail-Windows-validation.zip：云端校验报告、构建来源和原生窗口截图。
• SHA256SUMS-windows.txt：核验上述下载文件。

基本阅读不需要 Rust、npm、GPU、模型或 API Key。Git 改动比较需要 Git；可选 Pyright 需要 Node.js 22.12+。首次安装若缺少 Microsoft WebView2，安装器需要联网从微软安装该运行时。

验证范围

发布前在 GitHub Windows Server 2022 x64 构建机完成源码测试、统一交付校验、目标平台第三方许可收集、安装包与工具构建，以及隔离安装和原生窗口检查。实际通过：96 项 Rust 测试、15 项前端测试、3 项 Python SDK 测试；Clippy、前端生产构建、桌面编译、功能关联与概览及统一交付校验均通过。正式 CLI 启动、NSIS 静默安装、程序内容核验、许可资源与 x64 架构检查、原生窗口界面检查也通过。已收集 276 项目标依赖声明，报告及截图见验证 ZIP。

这不等于 Windows 10/11 实机人工验收；Windows ARM、32 位及离线运行时安装暂未提供。

此预览版没有 Windows 代码签名。 系统可能显示未知发布者或安全提示，请核对来源及 SHA-256；不要关闭系统安全保护，受管理设备请按组织要求处理。

许可

采用 PolyForm Noncommercial 1.0.0，非商业使用按原许可免费，商业用途需另行书面授权。详见仓库 COMMERCIAL-LICENSE.md。第三方组件遵循各自许可。

可选 Pyright 语义增强目前支持本地磁盘路径，暂不支持 UNC 网络共享路径。

原始项目、用户批注、阅读确认和运行数据均不包含在发行包中。Agent 交付、批注、运行记录的数据格式保持兼容。

构建来源与关联

• 本次基线：6b95aaa0a2e59f9ced63765fb1afa686c653e4dc。
• 发布源码：2f31c7d529532d66f4da346779261b917bcbcb2c。
• 功能关联：codetrail-delivery-workflow（Windows 发布）、codetrail-git-diff（Git 权限兼容）、codetrail-python-relations（快照校验）、codetrail-pyright（路径及权限兼容）、codetrail-runtime-records（Windows SDK 测试入口）。
• 文档、构建配置及共享代码的遗漏关联说明按文件及变更摘要绑定在统一校验报告中；人工审阅状态保持独立。
• Windows 构建和验证工作流。

CodeTrail v0.2.0 · Apple Silicon Mac Preview

CodeTrail 首个 Apple Silicon Mac 预览版。

从项目概览和运行路径进入真实源码；查看当前加载项目的 Agent 修改动态；记录批注并导出 Markdown；回看显式采集的运行结果。

下载

• CodeTrail_0.2.0_aarch64.dmg：Apple Silicon Mac 桌面安装包，打开后拖到“应用程序”。
• CodeTrail-tools-0.2.0-macos-arm64.tar.gz：同版本 reader-cli、Python 采集 SDK、文档、许可与第三方源码。CLI 无需安装 Rust 即可运行。
• SHA256SUMS.txt：核验下载文件。

平台和安装限制

本次在 Apple Silicon / macOS 27 构建并实际打开生产版，确认内置演示、真实项目加载、项目概览和步骤到代码跳转正常。Intel Mac、Windows 和旧版 macOS 未验收。

没有 Apple Developer ID 签名和公证。 macOS 可能阻止首次启动；请核对来源和 SHA-256，再按 Apple 官方“隐私与安全性”允许打开应用的流程处理。不要关闭系统安全机制。企业受管设备可能不允许运行。尚未完成全新机器的隔离安装验收。

基本桌面阅读不需要 Rust、npm、GPU、模型或 API Key。Git 比较需要 Git；可选 Pyright 需要 Node.js 22.12+；Python 运行采集需要 Python 和配套 CLI，须显式接入，普通运行不会自动记录。

许可

PolyForm Noncommercial 1.0.0，非商业用途按许可原文免费；商业用途另行书面授权。商业授权申请见 COMMERCIAL-LICENSE.md。教育、科研等许可范围以原文为准；第三方组件保留自己的许可。源码可见，不宣称 OSI 开源。

验证

99 项 Rust/CLI、15 项前端、3 项 Python SDK 测试通过；Clippy、前端生产构建、桌面检查及生产 app/DMG 构建通过。15 个功能关联和三条概览路径校验通过，统一交付 validate 通过。保持人工阅读确认独立。

公开仓库使用干净工作区快照，不包含原开发历史、真实项目、私人批注、运行数据或开发动态。本次只准备发行和许可，没有新增界面功能。