# KtdAutoCodeModules

**Repository Path**: PhoenixWing321/KtdAutoCodeModules

## Basic Information

- **Project Name**: KtdAutoCodeModules
- **Description**: Kt自动代码的主库，代码在子库里面
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-22
- **Last Updated**: 2026-07-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# KtdAutoCodeModules

`KtdAutoCodeModules` 聚合两个与自动代码生成、配置和替换相关的 C++ / .NET 子库：

- [`KtAutoCode`](KtAutoCode/README.md)：代码替换模型、CLI 桥接及历史 .NET 工具。
- [`KtdAutoCode`](KtdAutoCode/README.md)：Qt 自动代码界面、配置和运行时集成模块。

本仓库中由上海锟钛自主开发的内容以 [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0) 发布；第三方组件、源文件和再分发材料继续适用各自原有许可证。详细范围、依赖和发布步骤见 [开源迁移计划](doc/OPEN_SOURCE_AUDIT.md)。

## 当前状态

- `KtAutoCode` 和 `KtdAutoCode` 均为 Git 子模块，应在各自仓库中独立提交变更，再更新本仓库的子模块指针。
- 项目自有内容整体采用 Apache-2.0；第三方内容保留原版权与许可证。
- `KtCore`、`KtViewer`、`KtdBase`、`KtwWidgets` 与 `KtdMainUI` 不在本次开源范围，当前也不以它们是否可公开或可构建作为发布前置条件。
- 当前工程尚不能作为独立开源构建直接使用：除 Qt5 外，它还需要一组未随仓库发布的内部基础设施。完整清单和处置方式在迁移计划中维护。

## 开源前的构建边界

当前 CMake 工程使用 Qt5，并引用 `KtCore`、`KtViewer`、`KtdBase`、`KtwWidgets` 和 `KtdMainUI`。这五个库属于同一套内部基础设施，均不在本次开源范围，将在后续单独处理；当前发布不以其开源或可构建为前置条件。

`spdlog`、`nlohmann/json`、GoogleTest、MSTest、Newtonsoft.Json 与 System.Text.Json 是第三方依赖；已知版本、许可证和发布核对项见 [第三方声明](THIRD_PARTY_NOTICES.md)。

## 仓库初始化

```bash
git clone --recurse-submodules <repository-url>
```

如果已经克隆仓库：

```bash
git submodule update --init --recursive
```

在开源迁移完成前，请不要把当前 CMake 结果视为可独立发布的构建包。

## 参与和安全

- [贡献指南](CONTRIBUTING.md)：包含提交范围、编码和许可证要求。
- [安全策略](SECURITY.md)：安全问题请勿通过公开 Issue 披露。
- [变更记录](CHANGELOG.md)：记录开源准备阶段的显著变更。
- [后续 TODO](doc/OPEN_SOURCE_TODO.md)：记录内部路径解耦和独立构建等已决定延期的事项。

## 自动代码迁移资料

- [CAA/QT 自动代码现状探测](doc/CAA_QT自动代码现状探测.md)：梳理 VB.NET、C++/CLI、C++/Qt 之间的真实调用链、配置模型和标记块协议。
- [CAA/QT 自动代码迁移计划](doc/CAA_QT自动代码迁移计划.md)：定义旧仓库保留边界、`phoenix-wing` 核心、`kt-auto-code`/`phoenix-desk-tools` 宿主集成和验收标准。
- [KtCodegen TypeScript 原型](KtAutoCode/kt-codegen/README.md)：提供纯 MVC-C 数据类、CSV/v4 JSON 适配、类图、fixtures/tests 和 renderer 框架。