KT Auto Code

面向 CAA / MSVC C++ 的开发效率工具：核心在 src/，通过 CLI 或 VS Code / Cursor 插件 使用。本仓库只产出基础插件 KT Auto Code；可选 CAD 能力由并列仓库 kt-auto-cad 独立构建和发布，安装后仍接入同一个 Activity Bar、Ribbon 与 Block 容器。

源码仓库：Gitee · GitHub。

需要同时配置两个远端时，macOS/Linux 运行 ./addRemote.sh，PowerShell 运行 .\addRemote.ps1。脚本可重复执行且默认保留已有 origin；仅显式使用 --remove-origin 或 -RemoveOrigin 时才删除它。

当前插件提供 头文件编码修正、文件转码、Ignore 设置、工作区搜索替换、C++ 成员排序、UUID 替换、CAA UI、工程环境管理与 Codegen 参数表原型。成员排序、UUID、CAA 扫描和 Codegen 预检可共用 .phoenix/worksets.json；搜索替换当前使用独立目录选择，工作集入口待产品交互明确后再评估。工程环境 Block 直接维护操作系统用户环境变量，不使用 VS Code Settings 伪装系统值；其他插件配置仍使用 VS Code Settings。写盘前会检查冲突和文件快照，结果统一显示在单 Block 中；Codegen Apply 会自动预检、重验源码指纹并保持 UTF-8/BOM/GBK 原编码，批量写入失败时尝试回滚。

Code 与 CAD 功能关系

快速开始

pnpm install

# 完整联调：要求 ../phoenix-wing 与 ../kt-auto-cad
pnpm dev

# npm Registry 精确版本对照
pnpm dev:registry

pnpm test
pnpm ext:typecheck
pnpm ext:build
pnpm scan-encoding --headers --ascii tests/fixtures/multiChar   # 预检
pnpm fix-headers tests/fixtures/multiChar                         # 修复（慎用）

基础插件：pnpm ext:watch → 本仓库 F5 → Host 窗口打开 CAA 工程 → Side Bar KT Auto Code。

开发环境使用 Node.js 22 LTS 与 pnpm 10。pnpm dev 是默认跨仓双插件联调入口，强制消费并列本地 Wing，并分别在 Auto 与 CAD 所属仓库构建扩展；pnpm ext:dev:code 只构建基础插件。完成来源门禁后，启动器把两个仓库的扩展复制到独立临时快照并启动全新 Host 窗口。正式 Auto Registry 对照与发布不要求 CAD 仓库存在，使用 pnpm dev:registry 或 pnpm ext:release-candidate。详见本地 Wing 并列开发、可选模块接入契约与 KT Auto CAD 仓库。

发布

正式 VSIX 建议从 ../.worktrees/kt-auto-code-release 的 detached worktree 构建，切到明确 tag 或 commit 后执行 pnpm install --frozen-lockfile && pnpm verify:ci；不要把 pnpm dev 的本地 Wing 联调产物用于发布。Auto 的完整 worktree 更新、制品位置、人工安装与 Marketplace 点检见VS Code 插件发布；CAD 发布由 KT Auto CAD 仓库独立维护。

文档

常用命令

仓库结构

package.json          # 扩展 manifest、版本与开发/验证/发布入口
src/                  # Extension Host、Webview 与工具适配
src/core/             # Auto 专属 Host-neutral 模型、工作流和算法（无 vscode 依赖）
media/                # Marketplace、Activity Bar 与工具图标
resources/            # 随 VSIX 发布的只读 runner
scripts/              # CLI + 开发、构建、测试、打包与发布门禁
tests/fixtures/       # 核心、CLI 与 Extension Host 代表夹具
tests/webview/        # 浏览器/Webview 结构夹具
docs/                  # 当前中文文档、专项计划与历史归档
dist/                 # 扩展运行 bundle（Git ignored）
dist/vsix/            # Git ignored 的 VSIX 与 SHA-256

仓库根现在就是唯一的 VS Code 扩展包根，不再保留只有一个成员的 extension/ workspace。原 Host-neutral 逻辑集中在 src/core/，继续由架构门禁限制其不得依赖 vscode；实施记录见仓库结构与扁平化迁移计划。KT Auto CAD 已是同样的根包结构，但因规模较小无需照搬 Auto 的全部内部分层。

版权、技术来源与许可证

KT Auto Code 由上海锟钛开发，面向 CAA / MSVC C++ 工作流提供编码治理、Ignore 配置和工作区搜索替换能力。

名称替换与关联替换算法源自上海锟钛于 2024 年开发的 Windows 应用程序（采用 C++、Qt 与 .NET 技术），并针对 VS Code 插件场景进行了重新设计和实现。

• 软件著作权登记号：2024SR1374380
• Copyright © 2024–2026 上海锟钛。
• 本项目使用 Apache License 2.0 开源。

完整的中英文版权声明及 Marketplace 发布信息见 VS Code 插件发布文档。