@pm_zhousl/xinyun-ai-init 1.1.1 → 1.1.2

package/init/xinyun-ai-init/README.md

@@ -25,11 +25,12 @@ AI 读取本文件后，必须按以下方式执行：
 1. 如果当前项目没有 `xinyun-ai/`，进入极速初始化模式。
 2. 如果当前项目已有 `xinyun-ai/`，进入升级检查模式。
 3. 用户发送 Codex 一句话入口后，视为已授权 AI 按本初始化包创建或补齐最小 `xinyun-ai/` 与极简 `AGENTS.md`。
-4. 代码整改前必须先输出修改方案，等待用户明确确认后才能执行。
+4. 代码整改前必须先输出改动计划，等待用户明确确认后才能执行。
 5. 涉及 SQL / 数据库改动时，必须单独输出 SQL 执行提醒。
 6. 非项目开发内容不要沉淀。
-7. 首次初始化不执行语言级语法检查、lint、typecheck、测试或构建命令；本机缺少运行时只记录为待确认，不展开长解释。
-8. 完成后用中文输出初始化或升级结果、项目导读、待确认问题和后续短指令。
+7. 如果当前项目已有旧 AI 沉淀或历史规则痕迹，先梳理清单并分类接管，能合并的内容归入 `xinyun-ai/`，不能确认的内容标记为 `待确认`，不要直接当作正式事实。
+8. 首次初始化不执行语言级语法检查、lint、typecheck、测试或构建命令；本机缺少运行时只记录为待确认，不展开长解释。
+9. 完成后用中文输出初始化或升级结果、项目导读、待确认问题和后续短指令。
 
 ## 初始化授权边界
 
@@ -39,24 +40,62 @@ CLI 只负责生成 `xinyun-ai-init/`，不创建 `xinyun-ai/`，也不修改业
 
 该授权只覆盖 AI 工作区初始化，不代表授权修改业务代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程。
 
-## 代码修改强制确认
+## 改动计划与执行确认
 
 用户提出“帮我改”“修复”“处理一下”“优化一下”只代表提出需求，不代表授权执行。
 
 未确认前，只允许读取、分析、定位问题、输出方案；禁止 `apply_patch`、重写文件、格式化、自动修复、migration、seed、SQL、配置修改和任何会产生文件变化或业务副作用的命令。
 
-修改方案至少包含：
+涉及代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程的改动，必须先输出改动计划。
 
-1. 修改目标
-2. 影响范围
-3. 预计修改文件
-4. 是否影响数据库 / API / UI / 配置
-5. SQL 改动与执行提醒
-6. 验证方式
-7. 风险点
+标准改动计划：
+
+```md
+# 改动计划
+
+## 1. 修改目标
+
+## 2. 需求理解
+
+## 3. 影响范围
+- 影响端：
+- 影响模块：
+- 是否影响数据库：
+- 是否影响 API：
+- 是否影响 UI：
+- 是否影响配置：
+- 前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及
+
+## 4. 预计修改文件
+
+## 5. 数据库 / SQL / 测试数据
+
+## 6. 执行步骤
+
+## 7. 验证方式
+
+## 8. 风险点
+
+## 9. 等待确认
+请确认是否按此计划执行。
+```
+
+简单小改可以合并字段，但不得省略影响范围、预计修改文件、数据库 / API / UI / 配置影响、验证方式和风险点。
 
 只有用户明确回复“确认执行”“可以修改”“按方案改”“同意”等类似内容后，才允许在确认范围内执行。
 
+## 轻量需求与 UI 理解
+
+涉及功能、业务流程、API、数据库、页面、组件、交互或样式时，出计划前先做轻量需求理解。
+
+信息不足时，最多问 1-3 个关键问题。
+
+UI 类需求至少判断前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及。
+
+样式微调应优先局部修改，不重写页面结构；新页面或页面重写必须先说明页面结构方案，且不得顺手修改无关页面。
+
+普通聊天、临时咨询、无长期价值排查不沉淀。
+
 ## 统一入口与旧规则失效
 
 当前项目 AI 规则以 `xinyun-ai/` 为准，`AGENTS.md` 只作为入口文件，指向 `xinyun-ai/`。
@@ -67,6 +106,14 @@ CLI 只负责生成 `xinyun-ai-init/`，不创建 `xinyun-ai/`，也不修改业
 
 如旧规则与 `xinyun-ai/` 冲突，以 `xinyun-ai/` 为准。
 
+## 旧沉淀接管
+
+如果项目里已经存在旧 AI 沉淀，如旧 `AGENTS.md`、`docs/`、`CLAUDE.md`、`.cursor/`、旧提示词、旧规则文件或旧工作台记录，AI 应先做接管梳理，再决定是否纳入 `xinyun-ai/`。
+
+接管时只整合长期有价值的内容，包括项目导读、规则入口、需求沉淀、问题记录、框架线索、当前任务线索和可复用经验候选。
+
+临时聊天、无关内容、明显过期内容和无法确认的内容不进入正式沉淀；不存在的旧路径必须标注为 `当前项目未发现`。
+
 ## 欣芸技术开发 Agent 流
 
 这是一套面向 AI 编程工具的本地项目接手、按需理解、受控开发和持续沉淀方法论。
@@ -79,6 +126,7 @@ CLI 只负责生成 `xinyun-ai-init/`，不创建 `xinyun-ai/`，也不修改业
 4. 方案确认：改代码前先输出方案，等待用户确认。
 5. 受控整改：只在确认范围内修改，不顺手重构。
 6. 技术沉淀：会话结束前筛选有价值内容，沉淀到 `xinyun-ai/`；经验先候选，确认后升级。
+7. 旧沉淀接管：如果项目已有旧 AI 规则或历史沉淀，先分类整合再进入日常工作台。
 
 ## 轻量框架适配
 
@@ -133,7 +181,7 @@ xinyun-ai/index/project-index.json
 
 - 首次初始化只做极速接手，不做全量深度扫描，不追完整调用链。
 - 不修改业务代码、配置、数据库、依赖、构建脚本、测试逻辑或格式化结果。
-- 代码整改前必须先输出修改方案，等待用户明确确认后才能执行。
+- 代码整改前必须先输出改动计划，等待用户明确确认后才能执行。
 - 不运行 install、build、format、自动修复、migration、seed、写数据库、生成业务文件等副作用命令。
 - 首次初始化不执行语言级语法检查、lint、typecheck、测试或构建命令，只记录是否发现相关命令。
 - 如果本机缺少 `php`、`node`、`python`、`java`、`go` 等运行时，不作为错误，只记录为 `本地运行时未确认` 或 `当前环境不可用`。

package/init/xinyun-ai-init/rules/frameworks/README.md

@@ -20,5 +20,10 @@ frameworks/frontend/<framework>.md
 - 框架适配只用于帮助 AI 定位入口、配置、页面 / 路由、请求封装线索。
 - 不做深度扫描。
 - 不默认创建大量框架说明文件。
+- 框架识别应结合关键配置、入口文件、目录结构、依赖或代码特征交叉判断。
+- 只发现单一线索时，标注为 `推断` 或 `待确认`，不得直接当作已确认框架。
+- 首次初始化只查关键文件、配置文件、入口文件和少量抽样文件。
+- 不为确认框架做全量 grep 或追完整调用链。
+- 如需进一步确认，放到后续任务按需补齐。
 - 未识别到对应框架时，不强行套用该框架规则。
 - 多端项目应分别说明每个端口的框架、入口、启动线索和请求链路线索。

package/init/xinyun-ai-init/rules/frameworks/backend/php/thinkphp.md

@@ -6,7 +6,7 @@
 - 存在 `public/index.php` 或 `think`
 - 存在 `app/`、`config/`、`route/`
 - 存在 `app/*/controller`、`app/*/model`、`app/*/service`
-- 代码中出现 `think\facade`、`think\Request`、`think\Response`
+- 关键文件或少量抽样文件中出现 `think\facade`、`think\Request`、`think\Response`
 
 ## 接手重点
 
@@ -22,5 +22,8 @@
 ## 边界
 
 - 只做轻量识别，不追完整调用链。
+- 识别时应结合依赖、入口文件、目录结构和代码特征交叉判断。
+- 只发现单一线索时，标注为 `推断` 或 `待确认`，不得直接当作已确认 ThinkPHP 项目。
+- 首次初始化不为确认 ThinkPHP 做全量 grep。
 - 不把 ThinkPHP 规则套到其他 PHP 框架。
 - 不默认生成大量 ThinkPHP 说明文件。

package/init/xinyun-ai-init/rules/frameworks/frontend/uni-app.md

@@ -25,4 +25,7 @@
 ## 边界
 
 - 只做轻量识别，不默认创建大量框架说明文件。
+- 识别时应结合 `pages.json`、`manifest.json`、入口文件、目录结构和依赖交叉判断。
+- 只发现单一线索时，标注为 `推断` 或 `待确认`，不得直接当作已确认 uni-app 项目。
+- 首次初始化不为确认 uni-app 做全量 grep。
 - 不把 uni-app 规则套到原生微信小程序。

package/init/xinyun-ai-init/rules/frameworks/frontend/wechat-miniprogram.md

@@ -5,7 +5,7 @@
 - `app.json`
 - `app.js` / `app.ts`
 - `app.wxss`
-- 页面包含 `.wxml`、`.wxss`、`.js` / `.ts`、`.json`
+- 关键页面或少量抽样页面包含 `.wxml`、`.wxss`、`.js` / `.ts`、`.json`
 - `project.config.json`
 - `sitemap.json`
 
@@ -25,4 +25,7 @@
 ## 边界
 
 - 只做轻量识别，不默认创建大量框架说明文件。
+- 识别时应结合 `app.json`、入口文件、页面结构、项目配置和目录结构交叉判断。
+- 只发现单一线索时，标注为 `推断` 或 `待确认`，不得直接当作已确认微信小程序项目。
+- 首次初始化不为确认微信小程序做全量 grep。
 - 不把微信小程序规则套到 uni-app。

package/init/xinyun-ai-init/rules/init-rules.md

@@ -8,3 +8,4 @@
 - 首次初始化必须把“代码修改强制确认规则”写入 `AGENTS.md` 和 `xinyun-ai/rules/core-rules.md`。
 - 用户发送一句话入口后，视为已授权创建或补齐最小 `xinyun-ai/` 与极简 `AGENTS.md`。
 - 初始化授权不包含业务代码、配置、数据库、API、UI 或业务流程修改。
+- 如果项目里已有旧 AI 沉淀，首次应先做清单化梳理，再决定哪些内容接管到 `xinyun-ai/`。

package/init/xinyun-ai-init/rules/self-learning-rules.md

@@ -12,4 +12,5 @@ AI 可以沉淀项目经验，但不能自己升级正式规则。
 → 用户确认后再合并进 core-rules 或后续独立 rules 文件
 ```
 
-候选经验必须标注来源、适用范围、可信度、状态和最后验证时间。
+候选经验必须标注来源、适用范围、可信度、状态和最后验证时间。
+旧 AI 沉淀中可复用的历史内容也按候选经验处理，不直接升级为正式规则。

package/init/xinyun-ai-init/rules/session-workbench.md

@@ -11,5 +11,6 @@ xinyun-ai/index/session-current.md
 - `session-current.md` 只记录本轮临时线索，不是项目事实源。
 - 不记录非项目内容、闲聊、敏感值。
 - 不记录完整搜索流水账，只记录关键文件、关键发现、待确认点、候选沉淀。
+- 如果发现旧 AI 沉淀，只记录来源路径、分类结果和是否可接管，不直接把旧内容写成事实。
 - 会话结束前必须筛选：长期有价值的沉淀到正式目录；仅本轮有价值的写入 `sessions/`；无价值、误判、非项目内容不沉淀。
-- 筛选完成后更新 `index/project-index.json`。
+- 筛选完成后更新 `index/project-index.json`。

package/init/xinyun-ai-init/rules/upgrade-rules.md

@@ -7,10 +7,11 @@
 1. 读取 `xinyun-ai/manifest.json`、`README.md`、`rules/core-rules.md`、`index/project-index.json`。
 2. 读取 `xinyun-ai-init/version.json`。
 3. 对比版本和缺失能力。
-4. 输出升级方案。
-5. 等用户确认后，只更新 `xinyun-ai/` 内相关文件。
-6. 不修改业务代码、配置、数据库、依赖、构建脚本、测试逻辑。
-7. 升级完成后按需写入 `xinyun-ai/upgrade-log.md`。
+4. 检查项目里是否已经存在旧 AI 沉淀，并先做清单化梳理。
+5. 输出升级方案。
+6. 等用户确认后，只更新 `xinyun-ai/` 内相关文件；可整合的旧沉淀优先归入 `xinyun-ai/`。
+7. 不修改业务代码、配置、数据库、依赖、构建脚本、测试逻辑。
+8. 升级完成后按需写入 `xinyun-ai/upgrade-log.md`。
 
 升级检查时必须重点检查：
 
@@ -18,6 +19,7 @@
 - `xinyun-ai/rules/core-rules.md` 是否包含代码修改强制确认规则。
 - `AGENTS.md` 是否明确 `xinyun-ai/` 为当前项目 AI 规则入口。
 - 旧 AI 规则路径不存在时，是否标注为 `当前项目未发现`，并停止引用旧会话内容。
+- 旧 AI 沉淀是否需要接管、分类和整合进 `xinyun-ai/`。
 - 是否需要补充轻量框架适配识别规则。
 - 当前 `xinyun-ai/manifest.json` 的版本是否低于初始化包版本。
 

package/init/xinyun-ai-init/templates/AGENTS.template.md

@@ -6,14 +6,26 @@
 
 如果旧规则路径在当前文件系统中不存在，必须标注为 `当前项目未发现`，不得引用历史会话中的旧内容。如旧规则与 `xinyun-ai/` 冲突，以 `xinyun-ai/` 为准。
 
-## 代码修改强制确认规则
+## 旧沉淀接管
 
-任何代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程修改前，AI 必须先输出修改方案，并等待用户明确确认。
+如果项目中已经存在旧 AI 沉淀，如旧 `AGENTS.md`、`docs/`、`CLAUDE.md`、`.cursor/`、旧提示词、旧规则文件或旧工作台记录，AI 应先梳理这些内容，再把有长期价值的部分整合进 `xinyun-ai/`。
+
+只整合项目导读、规则入口、需求沉淀、问题记录、框架线索、当前任务线索和可复用经验候选。
+
+临时聊天、无关内容、明显过期内容和无法确认的内容不进入正式沉淀；不存在的旧路径必须标注为 `当前项目未发现`。
+
+## 改动计划与执行确认
+
+任何代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程修改前，AI 必须先输出改动计划，并等待用户明确确认。
 
 用户提出“帮我改”“修复”“处理一下”“优化一下”只代表提出需求，不代表授权执行。
 
 未确认前，只允许读取、分析、定位问题、输出方案；禁止 `apply_patch`、重写文件、格式化、自动修复、migration、seed、SQL、配置修改和任何会产生文件变化或业务副作用的命令。
 
+改动计划至少说明：修改目标、需求理解、影响范围、预计修改文件、数据库 / SQL / 测试数据、执行步骤、验证方式、风险点和等待确认。
+
+简单小改可以合并字段，但不得省略影响范围、预计修改文件、数据库 / API / UI / 配置影响、验证方式和风险点。
+
 只有用户明确回复“确认执行”“可以修改”“按方案改”“同意”等类似内容后，才允许在确认范围内执行。
 
 说明：用户发送 `xinyun-ai-init` 一句话入口后，视为已授权 AI 创建或补齐最小 `xinyun-ai/` 与本入口文件；该授权不包含业务代码、配置、数据库、API、UI 或业务流程修改。

package/init/xinyun-ai-init/templates/README.template.md

@@ -9,6 +9,7 @@
 - 业务代码、配置、数据库、API、UI、业务流程修改前必须先出计划并等待确认。
 - 用户提出“帮我改”“修复”“处理一下”“优化一下”只代表提出需求，不代表授权执行。
 - 当前项目 AI 规则以 `xinyun-ai/` 为准，旧 AI 规则只作为历史线索。
+- 如果项目中已经存在旧 AI 沉淀，先梳理清单并分类接管，再决定是否纳入 `xinyun-ai/`。
 - 检索时先按端和当前任务收敛范围，不做无关全量扫描。
 - 后续识别到新端、模块或能力时，只在 `xinyun-ai/` 内按需补齐对应目录和说明文件。
 

package/init/xinyun-ai-init/templates/core-rules.template.md

@@ -8,27 +8,69 @@
 - 如果旧规则路径在当前文件系统中不存在，必须标注为 `当前项目未发现`，不得引用历史会话中的旧内容。
 - 如旧规则与 `xinyun-ai/` 冲突，以 `xinyun-ai/` 为准。
 
+## 旧沉淀接管
+
+- 如果项目里已经存在旧 AI 沉淀，如旧 `AGENTS.md`、`docs/`、`CLAUDE.md`、`.cursor/`、旧提示词、旧规则文件或旧工作台记录，先梳理再接管。
+- 只整合项目导读、规则入口、需求沉淀、问题记录、框架线索、当前任务线索和可复用经验候选。
+- 临时聊天、无关内容、明显过期内容和无法确认的内容不进入正式沉淀。
+- 不存在的旧路径必须标注为 `当前项目未发现`。
+- 旧沉淀接管完成后，仍以 `xinyun-ai/` 为唯一正式入口。
+
 ## 初始化授权边界
 
 - 用户发送 `xinyun-ai-init` 一句话入口后，视为已授权 AI 创建或补齐最小 `xinyun-ai/` 与极简 `AGENTS.md`。
 - 该授权不包含业务代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程修改。
 
-## 代码修改确认
+## 改动计划与执行确认
 
-- 代码整改前必须先给修改方案，待用户明确确认后才能执行。
+- 涉及代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程的改动，必须先输出改动计划。
 - 用户提出“帮我改”“修复”“处理一下”“优化一下”只代表提出需求，不代表授权执行。
 - 未确认前，只允许读取、分析、定位问题、输出方案；禁止 `apply_patch`、重写文件、格式化、自动修复、migration、seed、SQL、配置修改和任何会产生文件变化或业务副作用的命令。
+- 用户确认计划后，AI 才能在计划范围内执行。
 - 确认后只改确认范围内的文件，不顺手重构、不顺手格式化无关文件。
 
-修改方案至少包含：
+标准改动计划：
+
+```md
+# 改动计划
+
+## 1. 修改目标
+
+## 2. 需求理解
+
+## 3. 影响范围
+- 影响端：
+- 影响模块：
+- 是否影响数据库：
+- 是否影响 API：
+- 是否影响 UI：
+- 是否影响配置：
+- 前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及
+
+## 4. 预计修改文件
+
+## 5. 数据库 / SQL / 测试数据
+
+## 6. 执行步骤
+
+## 7. 验证方式
+
+## 8. 风险点
+
+## 9. 等待确认
+请确认是否按此计划执行。
+```
+
+简单小改可以合并字段，但不得省略影响范围、预计修改文件、数据库 / API / UI / 配置影响、验证方式和风险点。
+
+## 轻量需求与 UI 理解
 
-1. 修改目标
-2. 影响范围
-3. 预计修改文件
-4. 是否影响数据库 / API / UI / 配置
-5. SQL 改动与执行提醒
-6. 验证方式
-7. 风险点
+- 涉及功能、业务流程、API、数据库、页面、组件、交互或样式时，出计划前先做轻量需求理解。
+- 信息不足时，最多问 1-3 个关键问题。
+- UI 类需求至少判断前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及。
+- 样式微调应优先局部修改，不重写页面结构。
+- 新页面或页面重写必须先说明页面结构方案，且不得顺手修改无关页面。
+- 普通聊天、临时咨询、无长期价值排查不沉淀。
 
 ## 检索与回复
 
@@ -43,7 +85,11 @@
 
 - 框架适配规则位于 `xinyun-ai-init/rules/frameworks/`。
 - 首期只支持 ThinkPHP、uni-app、微信小程序的轻量识别。
-- 框架适配只帮助定位入口、配置、页面 / 路由、请求封装线索，不做深度扫描。
+- 框架识别应结合关键配置、入口文件、目录结构、依赖或代码特征交叉判断。
+- 只发现单一线索时，标注为 `推断` 或 `待确认`，不得直接当作已确认框架。
+- 首次初始化只查关键文件、配置文件、入口文件和少量抽样文件。
+- 不为确认框架做全量 grep 或追完整调用链。
+- 如需进一步确认，放到后续任务按需补齐。
 - 未识别到对应框架时，不强行套用该框架规则。
 
 ## 理解深度状态

package/init/xinyun-ai-init/templates/current-task.template.md

@@ -6,7 +6,8 @@
 - 影响端：
 - 是否影响数据库 / API / UI / 配置：
 - 待确认问题：
-- 修改方案摘要：
+- 改动计划摘要：
 - SQL 执行提醒：
 - 验证结果：
+- 旧沉淀接管：
 - 本轮沉淀位置：

package/init/xinyun-ai-init/templates/manifest.template.json

@@ -1,6 +1,6 @@
 {
   "projectName": "",
-  "xinyunAiVersion": "1.1.1",
+  "xinyunAiVersion": "1.1.2",
   "scriptVersion": "2026.07.14",
   "schemaVersion": "1",
   "initializationMode": "fast",

package/init/xinyun-ai-init/templates/project-check.template.md

@@ -15,6 +15,9 @@
 - 配置线索：待填写
 - 测试体系线索：待填写
 - 已有 AI 痕迹：待填写
+- 旧 AI 沉淀来源：待填写
+- 可接管内容：待填写
+- 不接管内容：待填写
 - 轻量框架识别：待填写
 
 ## 待确认问题

package/init/xinyun-ai-init/templates/project-guide.template.md

@@ -14,11 +14,22 @@
 
 ## 已有 AI 接手痕迹与历史沉淀审计
 
-待填写。
+- 旧 AI 沉淀来源：待填写。
+  - 是否存在旧 `AGENTS.md`：待填写。
+  - 是否存在旧 `docs/`：待填写。
+  - 是否存在旧 `CLAUDE.md`：待填写。
+  - 是否存在 `.cursor/`：待填写。
+  - 是否存在旧提示词 / 旧规则文件：待填写。
+- 可接管内容：待填写。
+- 不接管内容：待填写。
+- 不存在的旧路径：待填写。
 
 ## 旧规则失效判定
 
-待填写。
+- 当前项目 AI 规则以 `xinyun-ai/` 为准。
+- 旧 AI 文档、旧 docs、旧提示词、旧规则文件只作为历史线索，不作为执行依据。
+- 如果旧规则路径在当前文件系统中不存在，必须标注为 `当前项目未发现`。
+- 如旧规则与 `xinyun-ai/` 冲突，以 `xinyun-ai/` 为准。
 
 ## 端、模块、技术栈与本地启动方式
 
@@ -34,7 +45,10 @@
 
 ## xinyun-ai 初始化结果
 
-待填写。
+- 初始化模式：待填写。
+- 已创建或更新文件：待填写。
+- 是否接管旧沉淀：待填写。
+- 是否有待确认项：待填写。
 
 ## CodeGraph 与索引状态
 

package/init/xinyun-ai-init/version.json

@@ -1,7 +1,7 @@
 {
   "packageName": "xinyun-ai-init",
   "displayName": "欣芸技术开发 Agent 流初始化包",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "scriptVersion": "2026.07.14",
   "schemaVersion": "1",
   "defaultMode": "fast-init",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pm_zhousl/xinyun-ai-init",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "欣芸技术开发 Agent 流初始化包",
   "bin": {
     "xinyun-ai-init": "bin/xinyun-ai-init.js"