@pm_zhousl/xinyun-ai-init 1.1.0 → 1.1.2

package/README.md

@@ -26,6 +26,8 @@ npx --yes @pm_zhousl/xinyun-ai-init@latest --force
 
 CLI 执行时会显示当前版本，并尽量检测 npm 线上最新版本；检测失败不会阻塞初始化。
 
+用户发送 Codex 一句话入口后，AI 可按初始化包规则创建或补齐最小 `xinyun-ai/`；这不代表授权修改业务代码。
+
 可选参数：
 
 ```bash

package/bin/xinyun-ai-init.js

@@ -122,6 +122,7 @@ async function main() {
 
   if (!fs.existsSync(source)) {
     console.error("[xinyun-ai-init] Init package missing:", source);
+    console.error("[xinyun-ai-init] Please reinstall or run with @latest.");
     process.exit(1);
   }
 
@@ -137,7 +138,8 @@ async function main() {
   }
 
   copyDir(source, target);
-  console.log("[xinyun-ai-init] Created:", target);
+  console.log("[xinyun-ai-init] Created init package:", target);
+  console.log("[xinyun-ai-init] This CLI only creates xinyun-ai-init/. It does not create xinyun-ai/ or modify business code.");
   console.log("");
   printNextStep();
 }
@@ -148,6 +150,7 @@ function printNextStep() {
   console.log("请执行 `npx --yes @pm_zhousl/xinyun-ai-init@latest --force`，然后读取 `xinyun-ai-init/README.md`，按其中规则初始化或升级当前项目。");
   console.log("");
   console.log("The full workflow is in xinyun-ai-init/README.md. No long prompt is needed.");
+  console.log("After this message, the AI may create or update the minimal xinyun-ai/ workspace, but must not modify business code without confirmation.");
   console.log("");
 }
 

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

@@ -24,31 +24,96 @@ AI 读取本文件后，必须按以下方式执行：
 
 1. 如果当前项目没有 `xinyun-ai/`，进入极速初始化模式。
 2. 如果当前项目已有 `xinyun-ai/`，进入升级检查模式。
-3. 未获用户确认前，不得修改业务代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程。
-4. 代码整改前必须先输出修改方案，等待用户明确确认后才能执行。
+3. 用户发送 Codex 一句话入口后，视为已授权 AI 按本初始化包创建或补齐最小 `xinyun-ai/` 与极简 `AGENTS.md`。
+4. 代码整改前必须先输出改动计划，等待用户明确确认后才能执行。
 5. 涉及 SQL / 数据库改动时，必须单独输出 SQL 执行提醒。
 6. 非项目开发内容不要沉淀。
-7. 首次初始化不执行语言级语法检查、lint、typecheck、测试或构建命令；本机缺少运行时只记录为待确认，不展开长解释。
-8. 完成后用中文输出初始化或升级结果、项目导读、待确认问题和后续短指令。
+7. 如果当前项目已有旧 AI 沉淀或历史规则痕迹，先梳理清单并分类接管，能合并的内容归入 `xinyun-ai/`，不能确认的内容标记为 `待确认`，不要直接当作正式事实。
+8. 首次初始化不执行语言级语法检查、lint、typecheck、测试或构建命令；本机缺少运行时只记录为待确认，不展开长解释。
+9. 完成后用中文输出初始化或升级结果、项目导读、待确认问题和后续短指令。
 
-## 代码修改强制确认
+## 初始化授权边界
+
+CLI 只负责生成 `xinyun-ai-init/`，不创建 `xinyun-ai/`，也不修改业务代码。
+
+用户发送一句话入口后，AI 可以按本 README 和 `templates/` 创建或补齐首次最小落盘清单。
+
+该授权只覆盖 AI 工作区初始化，不代表授权修改业务代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程。
+
+## 改动计划与执行确认
 
 用户提出“帮我改”“修复”“处理一下”“优化一下”只代表提出需求，不代表授权执行。
 
 未确认前，只允许读取、分析、定位问题、输出方案；禁止 `apply_patch`、重写文件、格式化、自动修复、migration、seed、SQL、配置修改和任何会产生文件变化或业务副作用的命令。
 
-修改方案至少包含：
+涉及代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程的改动，必须先输出改动计划。
+
+标准改动计划：
+
+```md
+# 改动计划
+
+## 1. 修改目标
+
+## 2. 需求理解
+
+## 3. 影响范围
+- 影响端：
+- 影响模块：
+- 是否影响数据库：
+- 是否影响 API：
+- 是否影响 UI：
+- 是否影响配置：
+- 前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及
 
-1. 修改目标
-2. 影响范围
-3. 预计修改文件
-4. 是否影响数据库 / API / UI / 配置
-5. SQL 改动与执行提醒
-6. 验证方式
-7. 风险点
+## 4. 预计修改文件
+
+## 5. 数据库 / SQL / 测试数据
+
+## 6. 执行步骤
+
+## 7. 验证方式
+
+## 8. 风险点
+
+## 9. 等待确认
+请确认是否按此计划执行。
+```
+
+简单小改可以合并字段，但不得省略影响范围、预计修改文件、数据库 / API / UI / 配置影响、验证方式和风险点。
 
 只有用户明确回复“确认执行”“可以修改”“按方案改”“同意”等类似内容后，才允许在确认范围内执行。
 
+## 轻量需求与 UI 理解
+
+涉及功能、业务流程、API、数据库、页面、组件、交互或样式时，出计划前先做轻量需求理解。
+
+信息不足时，最多问 1-3 个关键问题。
+
+UI 类需求至少判断前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及。
+
+样式微调应优先局部修改，不重写页面结构；新页面或页面重写必须先说明页面结构方案，且不得顺手修改无关页面。
+
+普通聊天、临时咨询、无长期价值排查不沉淀。
+
+## 统一入口与旧规则失效
+
+当前项目 AI 规则以 `xinyun-ai/` 为准，`AGENTS.md` 只作为入口文件，指向 `xinyun-ai/`。
+
+旧 AI 文档、旧 docs、旧提示词、旧规则文件只作为历史线索，不作为执行依据。
+
+如果旧规则路径在当前文件系统中不存在，必须标注为 `当前项目未发现`，不得引用历史会话中的旧内容。
+
+如旧规则与 `xinyun-ai/` 冲突，以 `xinyun-ai/` 为准。
+
+## 旧沉淀接管
+
+如果项目里已经存在旧 AI 沉淀，如旧 `AGENTS.md`、`docs/`、`CLAUDE.md`、`.cursor/`、旧提示词、旧规则文件或旧工作台记录，AI 应先做接管梳理，再决定是否纳入 `xinyun-ai/`。
+
+接管时只整合长期有价值的内容，包括项目导读、规则入口、需求沉淀、问题记录、框架线索、当前任务线索和可复用经验候选。
+
+临时聊天、无关内容、明显过期内容和无法确认的内容不进入正式沉淀；不存在的旧路径必须标注为 `当前项目未发现`。
+
 ## 欣芸技术开发 Agent 流
 
 这是一套面向 AI 编程工具的本地项目接手、按需理解、受控开发和持续沉淀方法论。
@@ -61,22 +126,21 @@ AI 读取本文件后，必须按以下方式执行：
 4. 方案确认：改代码前先输出方案，等待用户确认。
 5. 受控整改：只在确认范围内修改，不顺手重构。
 6. 技术沉淀：会话结束前筛选有价值内容，沉淀到 `xinyun-ai/`；经验先候选，确认后升级。
+7. 旧沉淀接管：如果项目已有旧 AI 规则或历史沉淀，先分类整合再进入日常工作台。
 
-## 需求与 UI 理解
-
-涉及功能开发、业务流程、API、数据库、页面、组件、交互或样式时，AI 在输出修改方案前，必须先完成轻量需求理解。
-
-如果当前 AI 工具有需求分析、原型、UI 交互、截图风格识别等 Skill，优先调用对应 Skill；如果没有，则按 `rules/requirement-ui-understanding.md` 的清单兜底。
-
-信息不足时，只问 1-3 个关键问题，不展开长问卷。
+## 轻量框架适配
 
-## 需求沉淀
+首期只提供 ThinkPHP、uni-app、微信小程序的轻量识别规则，位置：
 
-确认是开发需求时，后续可按需创建 `xinyun-ai/requirements/`，并使用 `REQ-YYYYMMDD-001` 格式编号。
+```md
+rules/frameworks/backend/php/thinkphp.md
+rules/frameworks/frontend/uni-app.md
+rules/frameworks/frontend/wechat-miniprogram.md
+```
 
-需求记录应包含原始需求、需求理解、涉及端、数据库 / API / UI / 配置影响、方案摘要、验收标准、实际改动文件、SQL 执行提醒和验证结果。
+框架适配只帮助 AI 定位入口、配置、页面 / 路由、请求封装线索，不做深度扫描，不默认创建大量框架说明文件。
 
-普通聊天、工具使用咨询、无长期价值的临时排查、用户明确说不需要记录、与当前项目无关的内容，不沉淀。
+未识别到对应框架时，不强行套用该框架规则。
 
 ## 执行模式
 
@@ -117,7 +181,7 @@ xinyun-ai/index/project-index.json
 
 - 首次初始化只做极速接手，不做全量深度扫描，不追完整调用链。
 - 不修改业务代码、配置、数据库、依赖、构建脚本、测试逻辑或格式化结果。
-- 代码整改前必须先输出修改方案，等待用户明确确认后才能执行。
+- 代码整改前必须先输出改动计划，等待用户明确确认后才能执行。
 - 不运行 install、build、format、自动修复、migration、seed、写数据库、生成业务文件等副作用命令。
 - 首次初始化不执行语言级语法检查、lint、typecheck、测试或构建命令，只记录是否发现相关命令。
 - 如果本机缺少 `php`、`node`、`python`、`java`、`go` 等运行时，不作为错误，只记录为 `本地运行时未确认` 或 `当前环境不可用`。
@@ -132,6 +196,15 @@ xinyun-ai/index/project-index.json
 - 不读取大目录和生成物：`node_modules`、`vendor`、`dist`、`build`、`.git`、`.codegraph`、`storage`、`runtime`、`unpackage`、`coverage`、`.next`、`.nuxt`。
 - 不确定的信息标注：`推断`、`待确认`、`未在项目中发现`。
 
+## 检索与回复规则
+
+- 先读 `AGENTS.md`、`xinyun-ai/manifest.json`、`xinyun-ai/index/project-index.json`、`xinyun-ai/current-task.md`。
+- 有 CodeGraph 时，结构性问题优先使用 CodeGraph。
+- 先判断影响端，再读取对应 `workstreams/<端>/` 和相关文件。
+- 输出中区分 `已确认`、`推断`、`待确认`、`未在项目中发现`。
+- 回复先给结论，再给依据路径，再给待确认问题。
+- 不沿用用户已经纠正或否定的旧方向。
+
 ## 按需补齐
 
 后续识别到新端、模块或能力时，只在 `xinyun-ai/` 内补齐对应目录和说明文件。
@@ -192,10 +265,11 @@ npx --yes @pm_zhousl/xinyun-ai-init@latest --force
 初始化或升级完成后，输出：
 
 1. 当前执行模式：初始化 / 升级检查 / 部分完成 / 阻塞。
-2. 已创建或已更新的 `xinyun-ai/` 文件。
-3. 项目一句话概览。
-4. 识别到的端、模块、技术栈、本地启动线索。
-5. 数据库、API、测试体系发现情况。
-6. CodeGraph 与索引状态。
-7. 待确认问题。
-8. 后续日常开发和问题排查短指令。
+2. 当前版本、目标版本、是否影响业务代码。
+3. 已创建或已更新的 `xinyun-ai/` 文件。
+4. 项目一句话概览。
+5. 识别到的端、模块、技术栈、本地启动线索。
+6. 数据库、API、测试体系发现情况。
+7. CodeGraph 与索引状态。
+8. 待确认问题。
+9. 后续日常开发和问题排查短指令。

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

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

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

@@ -0,0 +1,29 @@
+# ThinkPHP 轻量识别规则
+
+## 识别线索
+
+- `composer.json` 中存在 `topthink/framework`
+- 存在 `public/index.php` 或 `think`
+- 存在 `app/`、`config/`、`route/`
+- 存在 `app/*/controller`、`app/*/model`、`app/*/service`
+- 关键文件或少量抽样文件中出现 `think\facade`、`think\Request`、`think\Response`
+
+## 接手重点
+
+1. 应用入口：`public/index.php`、`think`
+2. 路由位置：`route/`、`config/route.php`、注解路由线索
+3. 模块结构：`app/<module>/controller`、`model`、`service`、`validate`、`middleware`
+4. 配置位置：`config/`、`.env`
+5. 公共前置逻辑：`middleware`、控制器基类、公共调用位置
+6. 命令任务：`app/command`、`config/console.php`
+7. 异常处理：`app/ExceptionHandle.php` 或项目自定义异常处理
+8. 返回结构：控制器统一响应方法、JSON 返回规范
+
+## 边界
+
+- 只做轻量识别，不追完整调用链。
+- 识别时应结合依赖、入口文件、目录结构和代码特征交叉判断。
+- 只发现单一线索时，标注为 `推断` 或 `待确认`，不得直接当作已确认 ThinkPHP 项目。
+- 首次初始化不为确认 ThinkPHP 做全量 grep。
+- 不把 ThinkPHP 规则套到其他 PHP 框架。
+- 不默认生成大量 ThinkPHP 说明文件。

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

@@ -0,0 +1,31 @@
+# uni-app 轻量识别规则
+
+## 识别线索
+
+- `pages.json`
+- `manifest.json`
+- `App.vue`
+- `main.js` / `main.ts`
+- `pages/`、`components/`、`static/`
+- `package.json` 中出现 `@dcloudio`、`uni-app`、`vite-plugin-uni`
+
+## 接手重点
+
+1. 应用入口：`main.js` / `main.ts`、`App.vue`
+2. 页面配置：`pages.json`
+3. 平台配置：`manifest.json`
+4. 页面目录：`pages/`
+5. 分包配置：`subPackages`
+6. 组件目录：`components/`
+7. 静态资源：`static/`
+8. 请求封装：常见 `utils/request`、`common/request`、`api/`
+9. 登录态与缓存：`uni.getStorageSync`、`uni.setStorageSync`
+10. 条件编译：`#ifdef`、`#ifndef`
+
+## 边界
+
+- 只做轻量识别，不默认创建大量框架说明文件。
+- 识别时应结合 `pages.json`、`manifest.json`、入口文件、目录结构和依赖交叉判断。
+- 只发现单一线索时，标注为 `推断` 或 `待确认`，不得直接当作已确认 uni-app 项目。
+- 首次初始化不为确认 uni-app 做全量 grep。
+- 不把 uni-app 规则套到原生微信小程序。

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

@@ -0,0 +1,31 @@
+# 微信小程序轻量识别规则
+
+## 识别线索
+
+- `app.json`
+- `app.js` / `app.ts`
+- `app.wxss`
+- 关键页面或少量抽样页面包含 `.wxml`、`.wxss`、`.js` / `.ts`、`.json`
+- `project.config.json`
+- `sitemap.json`
+
+## 接手重点
+
+1. 应用入口：`app.js` / `app.ts`
+2. 全局配置：`app.json`
+3. 页面路径：`pages`
+4. 分包配置：`subpackages` / `subPackages`
+5. 页面结构：`.wxml`
+6. 页面样式：`.wxss`
+7. 页面逻辑：`.js` / `.ts`
+8. 组件：`components/`
+9. 请求封装：`wx.request` 或项目封装
+10. 登录流程：`wx.login`、用户信息获取、token 缓存
+
+## 边界
+
+- 只做轻量识别，不默认创建大量框架说明文件。
+- 识别时应结合 `app.json`、入口文件、页面结构、项目配置和目录结构交叉判断。
+- 只发现单一线索时，标注为 `推断` 或 `待确认`，不得直接当作已确认微信小程序项目。
+- 首次初始化不为确认微信小程序做全量 grep。
+- 不把微信小程序规则套到 uni-app。

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

@@ -6,4 +6,6 @@
 - 每个端最多读取 3-5 个关键文件。
 - 不确定的信息标注：`推断`、`待确认`、`未在项目中发现`。
 - 首次初始化必须把“代码修改强制确认规则”写入 `AGENTS.md` 和 `xinyun-ai/rules/core-rules.md`。
-- 首次初始化只预留需求入口，不主动创建大量需求目录；后续确认是开发需求时再按需创建 `xinyun-ai/requirements/`。
+- 用户发送一句话入口后，视为已授权创建或补齐最小 `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,17 +7,20 @@
 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`。
 
 升级检查时必须重点检查：
 
 - `AGENTS.md` 是否包含代码修改强制确认规则。
 - `xinyun-ai/rules/core-rules.md` 是否包含代码修改强制确认规则。
-- 是否已有需求沉淀入口和 `current-task.md` 字段。
-- 是否需要补充需求与 UI 理解规则。
+- `AGENTS.md` 是否明确 `xinyun-ai/` 为当前项目 AI 规则入口。
+- 旧 AI 规则路径不存在时，是否标注为 `当前项目未发现`，并停止引用旧会话内容。
+- 旧 AI 沉淀是否需要接管、分类和整合进 `xinyun-ai/`。
+- 是否需要补充轻量框架适配识别规则。
 - 当前 `xinyun-ai/manifest.json` 的版本是否低于初始化包版本。
 
-涉及正式规则、目录结构、索引结构或历史沉淀迁移时，必须先确认。
+涉及正式规则、目录结构、索引结构或旧规则合并时，必须先确认。

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

@@ -2,16 +2,34 @@
 
 本项目使用 `xinyun-ai/` 管理 AI 协作规则。
 
-## 代码修改强制确认规则
+当前项目 AI 规则以 `xinyun-ai/` 为准。旧 AI 文档、旧 docs、旧提示词、旧规则文件只作为历史线索，不作为执行依据。
 
-任何代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程修改前，AI 必须先输出修改方案，并等待用户明确确认。
+如果旧规则路径在当前文件系统中不存在，必须标注为 `当前项目未发现`，不得引用历史会话中的旧内容。如旧规则与 `xinyun-ai/` 冲突，以 `xinyun-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 或业务流程修改。
+
 AI 接手本项目时，请先读取：
 
 - `xinyun-ai/README.md`

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

@@ -8,8 +8,9 @@
 - 后续 AI 会话优先读取 `manifest.json`、`current-task.md`、`rules/core-rules.md`、`index/project-index.json`。
 - 业务代码、配置、数据库、API、UI、业务流程修改前必须先出计划并等待确认。
 - 用户提出“帮我改”“修复”“处理一下”“优化一下”只代表提出需求，不代表授权执行。
-- 开发类任务在修改方案前应先完成需求理解；涉及页面、组件、交互或样式时应先完成 UI 理解。
-- 确认是开发需求时，可按需沉淀到 `requirements/`；普通聊天、工具咨询和无长期价值内容不沉淀。
+- 当前项目 AI 规则以 `xinyun-ai/` 为准，旧 AI 规则只作为历史线索。
+- 如果项目中已经存在旧 AI 沉淀，先梳理清单并分类接管，再决定是否纳入 `xinyun-ai/`。
+- 检索时先按端和当前任务收敛范围，不做无关全量扫描。
 - 后续识别到新端、模块或能力时，只在 `xinyun-ai/` 内按需补齐对应目录和说明文件。
 
 ## 核心流程

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

@@ -1,53 +1,96 @@
-# xinyun-ai 核心规则
+# xinyun-ai 核心规则
 
-## 硬约束
+## 统一入口
 
-- 只读优先，禁止副作用命令。
-- 代码整改前必须先给修改方案，待用户确认后才能执行。
+- 当前项目 AI 规则以 `xinyun-ai/` 为准。
+- `AGENTS.md` 只作为入口文件，指向 `xinyun-ai/`。
+- 旧 AI 文档、旧 docs、旧提示词、旧规则文件只作为历史线索，不作为执行依据。
+- 如果旧规则路径在当前文件系统中不存在，必须标注为 `当前项目未发现`，不得引用历史会话中的旧内容。
+- 如旧规则与 `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、配置修改和任何会产生文件变化或业务副作用的命令。
-- SQL / 数据库改动必须重点提醒。
-- 非项目内容不沉淀。
-- 多端项目按 `workstreams/<端名称>/` 分开说明。
-- 旧 AI 记录只审计，不默认相信、不覆盖。
-- CodeGraph 不可擅自初始化。
-- 敏感信息不泄露。
-- 自我学习只沉淀候选经验，不自动改正式规则。
-- 目录自完善只补 `xinyun-ai/` 文档和索引，不修改业务代码。
+- 用户确认计划后，AI 才能在计划范围内执行。
+- 确认后只改确认范围内的文件，不顺手重构、不顺手格式化无关文件。
+
+标准改动计划：
+
+```md
+# 改动计划
+
+## 1. 修改目标
+
+## 2. 需求理解
 
-## 修改方案要求
+## 3. 影响范围
+- 影响端：
+- 影响模块：
+- 是否影响数据库：
+- 是否影响 API：
+- 是否影响 UI：
+- 是否影响配置：
+- 前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及
 
-代码整改前的修改方案至少包含：
+## 4. 预计修改文件
 
-1. 修改目标
-2. 影响范围
-3. 预计修改文件
-4. 是否影响数据库 / API / UI / 配置
-5. SQL 改动与执行提醒
-6. 验证方式
-7. 风险点
+## 5. 数据库 / SQL / 测试数据
 
-## 需求与 UI 理解
+## 6. 执行步骤
 
-涉及功能、业务流程、API、数据库、页面、组件、交互或样式时，输出修改方案前必须先完成简版需求理解。
+## 7. 验证方式
 
-如果当前 AI 工具有需求分析、原型、UI 交互、截图风格识别等 Skill，优先使用对应 Skill；没有 Skill 时，按内置清单兜底，不阻塞任务。
+## 8. 风险点
 
-需求理解至少确认：用户要解决的问题、预期结果、涉及端、涉及数据、验收标准和不明确点。
+## 9. 等待确认
+请确认是否按此计划执行。
+```
 
-UI 理解至少确认：页面位置、现有风格、用户操作路径、默认 / 加载 / 空数据 / 错误 / 成功状态、多端适配影响和是否需要参考截图。
+简单小改可以合并字段，但不得省略影响范围、预计修改文件、数据库 / API / UI / 配置影响、验证方式和风险点。
 
-信息不足时，最多提出 1-3 个关键问题，不展开长问卷。
+## 轻量需求与 UI 理解
 
-## 需求沉淀
+- 涉及功能、业务流程、API、数据库、页面、组件、交互或样式时，出计划前先做轻量需求理解。
+- 信息不足时，最多问 1-3 个关键问题。
+- UI 类需求至少判断前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及。
+- 样式微调应优先局部修改，不重写页面结构。
+- 新页面或页面重写必须先说明页面结构方案，且不得顺手修改无关页面。
+- 普通聊天、临时咨询、无长期价值排查不沉淀。
 
-确认是开发需求时，可按需创建 `xinyun-ai/requirements/` 并使用 `REQ-YYYYMMDD-001` 格式编号。
+## 检索与回复
 
-需求状态建议：`draft`、`confirmed`、`planned`、`in_progress`、`done`、`cancelled`。
+- 先读 `AGENTS.md`、`xinyun-ai/manifest.json`、`xinyun-ai/index/project-index.json`、`xinyun-ai/current-task.md`。
+- 有 CodeGraph 时，结构性问题优先使用 CodeGraph。
+- 先判断影响端，再读取对应 `workstreams/<端>/` 和相关文件。
+- 输出中区分 `已确认`、`推断`、`待确认`、`未在项目中发现`。
+- 回复先给结论，再给依据路径，再给待确认问题。
+- 不沿用用户已经纠正或否定的旧方向。
 
-需求记录应关联原始需求、需求理解、涉及端、数据库 / API / UI / 配置影响、方案摘要、验收标准、实际改动文件、SQL 提醒和验证结果。
+## 框架适配
 
-普通聊天、工具咨询、临时排查且无长期价值、用户明确说不需要记录、与当前项目无关的内容，不沉淀。
+- 框架适配规则位于 `xinyun-ai-init/rules/frameworks/`。
+- 首期只支持 ThinkPHP、uni-app、微信小程序的轻量识别。
+- 框架识别应结合关键配置、入口文件、目录结构、依赖或代码特征交叉判断。
+- 只发现单一线索时，标注为 `推断` 或 `待确认`，不得直接当作已确认框架。
+- 首次初始化只查关键文件、配置文件、入口文件和少量抽样文件。
+- 不为确认框架做全量 grep 或追完整调用链。
+- 如需进一步确认，放到后续任务按需补齐。
+- 未识别到对应框架时，不强行套用该框架规则。
 
 ## 理解深度状态
 
@@ -63,4 +106,4 @@ UI 理解至少确认：页面位置、现有风格、用户操作路径、默
 
 ## 自我学习
 
-发现可复用经验时，先记录为候选经验。候选经验必须标注来源、适用范围、可信度、状态和最后验证时间。用户确认后，才能合并进正式规则。
+发现可复用经验时，先记录为候选经验。候选经验必须标注来源、适用范围、可信度、状态和最后验证时间。用户确认后，才能合并进正式规则。

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

@@ -2,13 +2,12 @@
 
 - 状态：初始化
 - 用户原始需求：
-- 需求编号：
-- 需求理解：
+- 当前任务理解：
 - 影响端：
 - 是否影响数据库 / API / UI / 配置：
-- 验收标准：
 - 待确认问题：
-- 修改方案摘要：
+- 改动计划摘要：
 - SQL 执行提醒：
 - 验证结果：
+- 旧沉淀接管：
 - 本轮沉淀位置：

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

@@ -1,7 +1,7 @@
 {
   "projectName": "",
-  "xinyunAiVersion": "1.1.0",
-  "scriptVersion": "2026.07.11",
+  "xinyunAiVersion": "1.1.2",
+  "scriptVersion": "2026.07.14",
   "schemaVersion": "1",
   "initializationMode": "fast",
   "expansionMode": "triggered",
@@ -10,15 +10,14 @@
     "overall": "quick",
     "workstreams": {},
     "database": "unknown",
-    "api": "unknown",
-    "requirements": "unknown"
+    "api": "unknown"
   },
   "codegraph": { "enabled": false, "status": "unknown" },
   "index": { "primary": "json_markdown", "sqlite": "optional" },
   "capabilities": {
     "confirmationGate": true,
-    "requirementUnderstanding": true,
-    "uiUnderstanding": true,
-    "requirementTracking": true
+    "legacyRuleHandoff": true,
+    "lightFrameworkDetection": true,
+    "focusedSearchResponse": true
   }
 }

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

@@ -14,8 +14,11 @@
 - API 相关线索：待填写
 - 配置线索：待填写
 - 测试体系线索：待填写
-- 权限与安全线索：待填写
 - 已有 AI 痕迹：待填写
+- 旧 AI 沉淀来源：待填写
+- 可接管内容：待填写
+- 不接管内容：待填写
+- 轻量框架识别：待填写
 
 ## 待确认问题
 

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

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

package/init/xinyun-ai-init/templates/project-index.template.json

@@ -4,12 +4,10 @@
     "overall": "quick",
     "workstreams": {},
     "database": "unknown",
-    "api": "unknown",
-    "requirements": "unknown"
+    "api": "unknown"
   },
   "database": "unknown",
   "api": "unknown",
-  "requirements": "unknown",
   "tests": "unknown",
   "lastUpdatedAt": ""
 }

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

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

package/package.json

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

package/init/xinyun-ai-init/rules/requirement-ui-understanding.md

@@ -1,35 +0,0 @@
-# 需求与 UI 理解规则
-
-开发类任务在输出修改方案前，必须先判断是否需要需求理解或 UI 理解。
-
-## Skill 适配
-
-如果当前 AI 工具有以下类型 Skill，应优先使用：
-
-- 需求理解类：`requirements-analyst`、PRD analyst、product requirements、user story、acceptance criteria
-- 原型流程类：`prototype-designer`、product flow、screen map、information architecture
-- UI 交互类：`ui-interaction-designer`、UI/UX designer、design reviewer
-- 截图风格类：`ui-screenshot-style-coder`、screenshot style、视觉还原
-- 全流程编排类：`product-build-orchestrator`、PRD to task、PRD to RFC
-
-如果没有对应 Skill，使用本规则内置清单兜底，不阻塞任务。
-
-## 需求理解清单
-
-1. 用户要解决的问题
-2. 预期结果
-3. 涉及端：server / admin / app / pc / 其他
-4. 涉及数据：数据库 / API / 配置 / 文件
-5. 验收标准
-6. 不明确点
-
-## UI 理解清单
-
-1. 页面位置
-2. 现有 UI 风格
-3. 用户操作路径
-4. 页面状态：默认 / 加载 / 空数据 / 错误 / 成功
-5. 是否影响移动端、多端适配或权限状态
-6. 是否需要参考截图、原型或现有页面
-
-信息不足时，只问 1-3 个关键问题。

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

@@ -1,43 +0,0 @@
-# 需求沉淀与任务追踪规则
-
-需求沉淀只服务于项目开发，不记录普通聊天、工具咨询、与当前项目无关的内容。
-
-## 触发场景
-
-- 新功能开发
-- 业务规则调整
-- 页面 / 交互 / 样式修改
-- API 行为变化
-- 数据库 / SQL 改动
-- 问题修复中产生可复用需求结论
-
-## 不沉淀场景
-
-- 普通聊天
-- 工具使用咨询
-- 临时排查但无长期项目价值
-- 用户明确说“不需要记录”
-- 与当前项目无关的内容
-
-## 编号与状态
-
-需求编号格式：
-
-```md
-REQ-YYYYMMDD-001
-```
-
-需求状态：
-
-- `draft`：草稿 / 待确认
-- `confirmed`：已确认
-- `planned`：已有方案
-- `in_progress`：执行中
-- `done`：已完成
-- `cancelled`：已取消
-
-## 记录要求
-
-需求记录至少包含：原始需求、需求理解、涉及端、数据库 / API / UI / 配置影响、待确认问题、方案摘要、验收标准、实际改动文件、SQL 执行提醒、验证结果和最后更新时间。
-
-运行到具体项目时，按需创建 `xinyun-ai/requirements/`，首次初始化不主动创建大量需求目录。

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

@@ -1,33 +0,0 @@
-# 需求记录
-
-- 需求编号：REQ-YYYYMMDD-001
-- 状态：draft
-- 创建时间：
-- 最后更新时间：
-
-## 用户原始需求
-
-
-## 需求理解
-
-- 要解决的问题：
-- 预期结果：
-- 涉及端：
-- 涉及数据库 / API / UI / 配置：
-- 不明确点：
-
-## 验收标准
-
-1.
-
-## 修改方案摘要
-
-
-## 实际改动
-
-- 改动文件：
-- SQL 执行提醒：
-- 验证结果：
-
-## 备注
-