跳转至

仓库布局与源码迁移

语言源码按职责归类。Go 模块与 pkg/... 导入路径、各语言包名、规范 wire 契约、 既有发布标签均保持不变。本次是源码树调整,不是一次新的框架发布。

位置 职责
pkg/、internal/、cmd/ Go 参考实现与桥接 CLI
language/<language>/ 独立语言实现
bindings/shell/、bindings/powershell/ 运行时桥接
examples/javascript/、examples/kotlin/、examples/scala/、examples/groovy/、examples/clojure/、examples/fsharp/、examples/opencl/ 复用 TypeScript、Java、.NET 或 C 的示例
adapters/ 可选集成
spec/ 规范契约、共享向量与 parity 清单

使用方需要更新的路径

上一版的 sdk/<language>/ 源码路径现已调整为 language/<language>/。 使用源码的消费者、CI 脚本、包路径和编辑器配置都需要同步更新;不保留 sdk/ 兼容占位目录。

原根目录的 Python、TypeScript、Java、Rust、C、C++、C#、PHP、Ruby、Perl、Lua、 Dart、Swift、Julia、R、D、Zig、COBOL 和 Fortran 实现统一迁入 language/。 Shell 与 PowerShell 迁入 bindings/;JavaScript、Kotlin、Scala、Groovy、Clojure 迁入 examples/,F# 和 OpenCL 示例分别位于 examples/fsharp/ 和 examples/opencl/。Visual Basic 示例继续位于 C# Core 实现的 language/csharp/samples/VbSample/。

更新本地脚本、CI 工作目录、源码依赖、编辑器配置中的路径。仓库根目录示例:

pip install ./language/python
cmake -S language/c -B build/c
swift build --package-path language/swift

Swift 与 C 的源码消费者需要明确选择新目录。普通 Swift Git 包依赖不能仅通过 URL 选择嵌套 manifest,应使用本地包路径或合适的分发包装。本次不新增根 Swift 包。

旧标签保留历史布局,新 checkout 使用新路径,不提供旧根目录的兼容占位。 CMake 应使用全新构建目录,不要复用绑定旧源码位置的缓存。

包名、代码导入和既有标签前缀不随目录变更。源码标签仍不等于已发布到包管理器。 请在新位置执行语言 README 中的一致性、API 与测试命令,功能限制见 Core 支持政策。