feat(knowledge): 支持模块级技术画像与双读

2026-09-03 17:13:14 +08:00
parent 018bc2e914
commit 5e465faa7b
7 changed files with 26 additions and 11 deletions
@@ -15,6 +15,16 @@
 - `guidance` 指向 `.craftkit/` 内的索引入口。
 - `initialization.references` 记录参考项目名称、用途、允许提炼范围和可共享的相对位置。

+## Schema 兼容
+
+- Schema 1 没有顶层 `modules` 时，将顶层技术栈和 `code` 边界作为根模块候选，不自动改写文件。
+- Schema 2 保留顶层 `technology` 原有字段类型，增加 `modules[].technology` 表达模块级精确信息。
+- `modules[].technology.preferredProfiles` 是项目确认的偏好，不表示当前机器已安装对应插件。
+- 插件发现、匹配状态和本机路径属于运行时信息，只存在于任务上下文或 `.craftkit/local/`。
+- 所有读取方完成 Schema 1/2 双读后，`init` 才能在用户确认差异后写入 Schema 2。
+
+模块根使用项目相对正斜线路径。目标路径命中多个模块时采用最长根；同长度重复根视为配置冲突。
+
 ## 文档目录

 | 字段 | 默认值 | 用途 |