@pm_zhousl/xinyun-ai-init 1.0.2 → 1.1.1

package/README.md

@@ -24,6 +24,17 @@ npx --yes @pm_zhousl/xinyun-ai-init@latest --force
 
 完整执行要求已经内置在 `xinyun-ai-init/README.md`、`rules/` 和 `templates/` 中。后续不需要复制长提示词，只需要让 AI 读取本地释放出来的 `xinyun-ai-init/README.md`。
 
+CLI 执行时会显示当前版本，并尽量检测 npm 线上最新版本；检测失败不会阻塞初始化。
+
+用户发送 Codex 一句话入口后，AI 可按初始化包规则创建或补齐最小 `xinyun-ai/`；这不代表授权修改业务代码。
+
+可选参数：
+
+```bash
+--no-version-check
+--strict-version
+```
+
 ## 维护者发布
 
 发布新版时，在本包目录执行：

package/bin/xinyun-ai-init.js

@@ -1,13 +1,21 @@
 #!/usr/bin/env node
 
 const fs = require("fs");
+const https = require("https");
 const path = require("path");
 
+const packageJson = require("../package.json");
+
 const args = new Set(process.argv.slice(2));
 const force = args.has("--force") || args.has("-f");
+const noVersionCheck = args.has("--no-version-check");
+const strictVersion = args.has("--strict-version");
 const cwd = process.cwd();
 const source = path.resolve(__dirname, "..", "init", "xinyun-ai-init");
 const target = path.join(cwd, "xinyun-ai-init");
+const packageName = packageJson.name;
+const currentVersion = packageJson.version;
+const registryMetadataUrl = "https://registry.npmjs.org/@pm_zhousl%2Fxinyun-ai-init";
 
 function copyDir(src, dest) {
   fs.mkdirSync(dest, { recursive: true });
@@ -22,16 +30,106 @@ function copyDir(src, dest) {
   }
 }
 
-function main() {
+function compareVersions(a, b) {
+  const pa = String(a).split(".").map((part) => Number.parseInt(part, 10) || 0);
+  const pb = String(b).split(".").map((part) => Number.parseInt(part, 10) || 0);
+  const length = Math.max(pa.length, pb.length);
+
+  for (let index = 0; index < length; index += 1) {
+    const av = pa[index] || 0;
+    const bv = pb[index] || 0;
+    if (av > bv) return 1;
+    if (av < bv) return -1;
+  }
+
+  return 0;
+}
+
+function fetchLatestVersion(timeoutMs = 1500) {
+  return new Promise((resolve) => {
+    const request = https.get(
+      registryMetadataUrl,
+      { headers: { Accept: "application/json", "User-Agent": "xinyun-ai-init" } },
+      (response) => {
+        let body = "";
+
+        response.setEncoding("utf8");
+        response.on("data", (chunk) => {
+          body += chunk;
+        });
+        response.on("end", () => {
+          if (response.statusCode < 200 || response.statusCode >= 300) {
+            resolve(null);
+            return;
+          }
+
+          try {
+            const data = JSON.parse(body);
+            resolve(data && data["dist-tags"] ? data["dist-tags"].latest : null);
+          } catch (error) {
+            resolve(null);
+          }
+        });
+      }
+    );
+
+    request.setTimeout(timeoutMs, () => {
+      request.destroy();
+      resolve(null);
+    });
+
+    request.on("error", () => {
+      resolve(null);
+    });
+  });
+}
+
+async function checkVersion() {
+  console.log(`[xinyun-ai-init] Current version: ${currentVersion}`);
+
+  if (noVersionCheck) {
+    console.log("[xinyun-ai-init] Version check skipped.");
+    return true;
+  }
+
+  const latestVersion = await fetchLatestVersion();
+
+  if (!latestVersion) {
+    console.log("[xinyun-ai-init] Could not check latest npm version. Continue with local version.");
+    return true;
+  }
+
+  console.log(`[xinyun-ai-init] Latest version: ${latestVersion}`);
+
+  if (compareVersions(currentVersion, latestVersion) < 0) {
+    console.log("[xinyun-ai-init] A newer version is available. Recommended command:");
+    console.log(`npx --yes ${packageName}@latest --force`);
+
+    if (strictVersion) {
+      console.error("[xinyun-ai-init] Strict version mode is enabled. Stop because local version is outdated.");
+      return false;
+    }
+  }
+
+  return true;
+}
+
+async function main() {
+  const canContinue = await checkVersion();
+  if (!canContinue) {
+    process.exit(1);
+  }
+
   if (!fs.existsSync(source)) {
-    console.error("[xinyun-ai-init] 初始化包缺失：", source);
+    console.error("[xinyun-ai-init] Init package missing:", source);
+    console.error("[xinyun-ai-init] Please reinstall or run with @latest.");
     process.exit(1);
   }
 
   if (fs.existsSync(target)) {
     if (!force) {
-      console.log("[xinyun-ai-init] 当前目录已存在 xinyun-ai-init/，未覆盖。");
-      console.log("[xinyun-ai-init] 如需覆盖，请执行：npx @pm_zhousl/xinyun-ai-init --force");
+      console.log("[xinyun-ai-init] xinyun-ai-init/ already exists. Skip overwrite.");
+      console.log(`[xinyun-ai-init] To overwrite, run: npx --yes ${packageName}@latest --force`);
       console.log("");
       printNextStep();
       return;
@@ -40,18 +138,23 @@ function main() {
   }
 
   copyDir(source, target);
-  console.log("[xinyun-ai-init] 已生成：", 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();
 }
 
 function printNextStep() {
-  console.log("下一步：把下面这句话发给 Codex / Cursor / Claude Code：");
+  console.log("Next step: send this message to Codex / Cursor / Claude Code:");
   console.log("");
   console.log("请执行 `npx --yes @pm_zhousl/xinyun-ai-init@latest --force`，然后读取 `xinyun-ai-init/README.md`，按其中规则初始化或升级当前项目。");
   console.log("");
-  console.log("完整执行要求已经在 xinyun-ai-init/README.md 内，不需要再粘贴长提示词。");
+  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("");
 }
 
-main();
+main().catch((error) => {
+  console.error("[xinyun-ai-init] Unexpected error:", error && error.message ? error.message : error);
+  process.exit(1);
+});

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

@@ -24,13 +24,49 @@ AI 读取本文件后，必须按以下方式执行：
 
 1. 如果当前项目没有 `xinyun-ai/`，进入极速初始化模式。
 2. 如果当前项目已有 `xinyun-ai/`，进入升级检查模式。
-3. 未获用户确认前，不得修改业务代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程。
+3. 用户发送 Codex 一句话入口后，视为已授权 AI 按本初始化包创建或补齐最小 `xinyun-ai/` 与极简 `AGENTS.md`。
 4. 代码整改前必须先输出修改方案，等待用户明确确认后才能执行。
 5. 涉及 SQL / 数据库改动时，必须单独输出 SQL 执行提醒。
 6. 非项目开发内容不要沉淀。
 7. 首次初始化不执行语言级语法检查、lint、typecheck、测试或构建命令；本机缺少运行时只记录为待确认，不展开长解释。
 8. 完成后用中文输出初始化或升级结果、项目导读、待确认问题和后续短指令。
 
+## 初始化授权边界
+
+CLI 只负责生成 `xinyun-ai-init/`，不创建 `xinyun-ai/`，也不修改业务代码。
+
+用户发送一句话入口后，AI 可以按本 README 和 `templates/` 创建或补齐首次最小落盘清单。
+
+该授权只覆盖 AI 工作区初始化，不代表授权修改业务代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程。
+
+## 代码修改强制确认
+
+用户提出“帮我改”“修复”“处理一下”“优化一下”只代表提出需求，不代表授权执行。
+
+未确认前，只允许读取、分析、定位问题、输出方案；禁止 `apply_patch`、重写文件、格式化、自动修复、migration、seed、SQL、配置修改和任何会产生文件变化或业务副作用的命令。
+
+修改方案至少包含：
+
+1. 修改目标
+2. 影响范围
+3. 预计修改文件
+4. 是否影响数据库 / API / UI / 配置
+5. SQL 改动与执行提醒
+6. 验证方式
+7. 风险点
+
+只有用户明确回复“确认执行”“可以修改”“按方案改”“同意”等类似内容后，才允许在确认范围内执行。
+
+## 统一入口与旧规则失效
+
+当前项目 AI 规则以 `xinyun-ai/` 为准，`AGENTS.md` 只作为入口文件，指向 `xinyun-ai/`。
+
+旧 AI 文档、旧 docs、旧提示词、旧规则文件只作为历史线索，不作为执行依据。
+
+如果旧规则路径在当前文件系统中不存在，必须标注为 `当前项目未发现`，不得引用历史会话中的旧内容。
+
+如旧规则与 `xinyun-ai/` 冲突，以 `xinyun-ai/` 为准。
+
 ## 欣芸技术开发 Agent 流
 
 这是一套面向 AI 编程工具的本地项目接手、按需理解、受控开发和持续沉淀方法论。
@@ -44,6 +80,20 @@ AI 读取本文件后，必须按以下方式执行：
 5. 受控整改：只在确认范围内修改，不顺手重构。
 6. 技术沉淀：会话结束前筛选有价值内容，沉淀到 `xinyun-ai/`；经验先候选，确认后升级。
 
+## 轻量框架适配
+
+首期只提供 ThinkPHP、uni-app、微信小程序的轻量识别规则，位置：
+
+```md
+rules/frameworks/backend/php/thinkphp.md
+rules/frameworks/frontend/uni-app.md
+rules/frameworks/frontend/wechat-miniprogram.md
+```
+
+框架适配只帮助 AI 定位入口、配置、页面 / 路由、请求封装线索，不做深度扫描，不默认创建大量框架说明文件。
+
+未识别到对应框架时，不强行套用该框架规则。
+
 ## 执行模式
 
 如果项目没有 `xinyun-ai/`：
@@ -98,6 +148,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/` 内补齐对应目录和说明文件。
@@ -141,15 +200,28 @@ AI 可以沉淀项目经验，但不能自己升级正式规则。
 - 创建或修改 `xinyun-ai/` 内 Markdown 文件后，只做基础格式检查：标题、列表、代码块是否闭合。
 - 不运行项目业务 lint、build、test、typecheck。
 
+## 版本检测
+
+CLI 执行时会尽量检测当前包版本和 npm 线上最新版本。
+
+如果检测到本地版本低于线上版本，应提示用户使用：
+
+```md
+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,24 @@
+# 框架适配规则
+
+本目录用于按端和框架存放轻量识别规则。
+
+## 目录约定
+
+```md
+frameworks/backend/<language>/<framework>.md
+frameworks/frontend/<framework>.md
+```
+
+首期只集成：
+
+- `backend/php/thinkphp.md`
+- `frontend/uni-app.md`
+- `frontend/wechat-miniprogram.md`
+
+## 执行边界
+
+- 框架适配只用于帮助 AI 定位入口、配置、页面 / 路由、请求封装线索。
+- 不做深度扫描。
+- 不默认创建大量框架说明文件。
+- 未识别到对应框架时，不强行套用该框架规则。
+- 多端项目应分别说明每个端口的框架、入口、启动线索和请求链路线索。

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

@@ -0,0 +1,26 @@
+# 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 规则套到其他 PHP 框架。
+- 不默认生成大量 ThinkPHP 说明文件。

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

@@ -0,0 +1,28 @@
+# 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`
+
+## 边界
+
+- 只做轻量识别，不默认创建大量框架说明文件。
+- 不把 uni-app 规则套到原生微信小程序。

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

@@ -0,0 +1,28 @@
+# 微信小程序轻量识别规则
+
+## 识别线索
+
+- `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 缓存
+
+## 边界
+
+- 只做轻量识别，不默认创建大量框架说明文件。
+- 不把微信小程序规则套到 uni-app。

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

@@ -4,4 +4,7 @@
 - 首次不创建大量规则、模板、脚本和业务沉淀目录。
 - 首次不执行语言级语法检查、lint、typecheck、测试或构建命令。
 - 每个端最多读取 3-5 个关键文件。
-- 不确定的信息标注：`推断`、`待确认`、`未在项目中发现`。
+- 不确定的信息标注：`推断`、`待确认`、`未在项目中发现`。
+- 首次初始化必须把“代码修改强制确认规则”写入 `AGENTS.md` 和 `xinyun-ai/rules/core-rules.md`。
+- 用户发送一句话入口后，视为已授权创建或补齐最小 `xinyun-ai/` 与极简 `AGENTS.md`。
+- 初始化授权不包含业务代码、配置、数据库、API、UI 或业务流程修改。

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

@@ -12,4 +12,13 @@
 6. 不修改业务代码、配置、数据库、依赖、构建脚本、测试逻辑。
 7. 升级完成后按需写入 `xinyun-ai/upgrade-log.md`。
 
-涉及正式规则、目录结构、索引结构或历史沉淀迁移时，必须先确认。
+升级检查时必须重点检查：
+
+- `AGENTS.md` 是否包含代码修改强制确认规则。
+- `xinyun-ai/rules/core-rules.md` 是否包含代码修改强制确认规则。
+- `AGENTS.md` 是否明确 `xinyun-ai/` 为当前项目 AI 规则入口。
+- 旧 AI 规则路径不存在时，是否标注为 `当前项目未发现`，并停止引用旧会话内容。
+- 是否需要补充轻量框架适配识别规则。
+- 当前 `xinyun-ai/manifest.json` 的版本是否低于初始化包版本。
+
+涉及正式规则、目录结构、索引结构或旧规则合并时，必须先确认。

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

@@ -2,6 +2,22 @@
 
 本项目使用 `xinyun-ai/` 管理 AI 协作规则。
 
+当前项目 AI 规则以 `xinyun-ai/` 为准。旧 AI 文档、旧 docs、旧提示词、旧规则文件只作为历史线索，不作为执行依据。
+
+如果旧规则路径在当前文件系统中不存在，必须标注为 `当前项目未发现`，不得引用历史会话中的旧内容。如旧规则与 `xinyun-ai/` 冲突，以 `xinyun-ai/` 为准。
+
+## 代码修改强制确认规则
+
+任何代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程修改前，AI 必须先输出修改方案，并等待用户明确确认。
+
+用户提出“帮我改”“修复”“处理一下”“优化一下”只代表提出需求，不代表授权执行。
+
+未确认前，只允许读取、分析、定位问题、输出方案；禁止 `apply_patch`、重写文件、格式化、自动修复、migration、seed、SQL、配置修改和任何会产生文件变化或业务副作用的命令。
+
+只有用户明确回复“确认执行”“可以修改”“按方案改”“同意”等类似内容后，才允许在确认范围内执行。
+
+说明：用户发送 `xinyun-ai-init` 一句话入口后，视为已授权 AI 创建或补齐最小 `xinyun-ai/` 与本入口文件；该授权不包含业务代码、配置、数据库、API、UI 或业务流程修改。
+
 AI 接手本项目时，请先读取：
 
 - `xinyun-ai/README.md`

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

@@ -7,6 +7,9 @@
 - 首次初始化为极速模式，后续能力按需补齐。
 - 后续 AI 会话优先读取 `manifest.json`、`current-task.md`、`rules/core-rules.md`、`index/project-index.json`。
 - 业务代码、配置、数据库、API、UI、业务流程修改前必须先出计划并等待确认。
+- 用户提出“帮我改”“修复”“处理一下”“优化一下”只代表提出需求，不代表授权执行。
+- 当前项目 AI 规则以 `xinyun-ai/` 为准，旧 AI 规则只作为历史线索。
+- 检索时先按端和当前任务收敛范围，不做无关全量扫描。
 - 后续识别到新端、模块或能力时，只在 `xinyun-ai/` 内按需补齐对应目录和说明文件。
 
 ## 核心流程

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

@@ -1,17 +1,50 @@
-# xinyun-ai 核心规则
+# xinyun-ai 核心规则
 
-## 硬约束
+## 统一入口
 
-- 只读优先，禁止副作用命令。
-- 代码整改前必须先给修改方案，待用户确认后才能执行。
-- SQL / 数据库改动必须重点提醒。
-- 非项目内容不沉淀。
-- 多端项目按 `workstreams/<端名称>/` 分开说明。
-- 旧 AI 记录只审计，不默认相信、不覆盖。
-- CodeGraph 不可擅自初始化。
-- 敏感信息不泄露。
-- 自我学习只沉淀候选经验，不自动改正式规则。
-- 目录自完善只补 `xinyun-ai/` 文档和索引，不修改业务代码。
+- 当前项目 AI 规则以 `xinyun-ai/` 为准。
+- `AGENTS.md` 只作为入口文件，指向 `xinyun-ai/`。
+- 旧 AI 文档、旧 docs、旧提示词、旧规则文件只作为历史线索，不作为执行依据。
+- 如果旧规则路径在当前文件系统中不存在，必须标注为 `当前项目未发现`，不得引用历史会话中的旧内容。
+- 如旧规则与 `xinyun-ai/` 冲突，以 `xinyun-ai/` 为准。
+
+## 初始化授权边界
+
+- 用户发送 `xinyun-ai-init` 一句话入口后，视为已授权 AI 创建或补齐最小 `xinyun-ai/` 与极简 `AGENTS.md`。
+- 该授权不包含业务代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程修改。
+
+## 代码修改确认
+
+- 代码整改前必须先给修改方案，待用户明确确认后才能执行。
+- 用户提出“帮我改”“修复”“处理一下”“优化一下”只代表提出需求，不代表授权执行。
+- 未确认前，只允许读取、分析、定位问题、输出方案；禁止 `apply_patch`、重写文件、格式化、自动修复、migration、seed、SQL、配置修改和任何会产生文件变化或业务副作用的命令。
+- 确认后只改确认范围内的文件，不顺手重构、不顺手格式化无关文件。
+
+修改方案至少包含：
+
+1. 修改目标
+2. 影响范围
+3. 预计修改文件
+4. 是否影响数据库 / API / UI / 配置
+5. SQL 改动与执行提醒
+6. 验证方式
+7. 风险点
+
+## 检索与回复
+
+- 先读 `AGENTS.md`、`xinyun-ai/manifest.json`、`xinyun-ai/index/project-index.json`、`xinyun-ai/current-task.md`。
+- 有 CodeGraph 时，结构性问题优先使用 CodeGraph。
+- 先判断影响端，再读取对应 `workstreams/<端>/` 和相关文件。
+- 输出中区分 `已确认`、`推断`、`待确认`、`未在项目中发现`。
+- 回复先给结论，再给依据路径，再给待确认问题。
+- 不沿用用户已经纠正或否定的旧方向。
+
+## 框架适配
+
+- 框架适配规则位于 `xinyun-ai-init/rules/frameworks/`。
+- 首期只支持 ThinkPHP、uni-app、微信小程序的轻量识别。
+- 框架适配只帮助定位入口、配置、页面 / 路由、请求封装线索，不做深度扫描。
+- 未识别到对应框架时，不强行套用该框架规则。
 
 ## 理解深度状态
 
@@ -27,4 +60,4 @@
 
 ## 自我学习
 
-发现可复用经验时，先记录为候选经验。候选经验必须标注来源、适用范围、可信度、状态和最后验证时间。用户确认后，才能合并进正式规则。
+发现可复用经验时，先记录为候选经验。候选经验必须标注来源、适用范围、可信度、状态和最后验证时间。用户确认后，才能合并进正式规则。

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

@@ -1,7 +1,12 @@
-# 当前任务
+# 当前任务
 
 - 状态：初始化
 - 用户原始需求：
+- 当前任务理解：
 - 影响端：
+- 是否影响数据库 / API / UI / 配置：
 - 待确认问题：
-- 本轮沉淀位置：
+- 修改方案摘要：
+- SQL 执行提醒：
+- 验证结果：
+- 本轮沉淀位置：

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

@@ -1,7 +1,7 @@
 {
   "projectName": "",
-  "xinyunAiVersion": "1.0.0",
-  "scriptVersion": "2026.07.10",
+  "xinyunAiVersion": "1.1.1",
+  "scriptVersion": "2026.07.14",
   "schemaVersion": "1",
   "initializationMode": "fast",
   "expansionMode": "triggered",
@@ -13,5 +13,11 @@
     "api": "unknown"
   },
   "codegraph": { "enabled": false, "status": "unknown" },
-  "index": { "primary": "json_markdown", "sqlite": "optional" }
-}
+  "index": { "primary": "json_markdown", "sqlite": "optional" },
+  "capabilities": {
+    "confirmationGate": true,
+    "legacyRuleHandoff": true,
+    "lightFrameworkDetection": true,
+    "focusedSearchResponse": true
+  }
+}

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

@@ -14,8 +14,8 @@
 - API 相关线索：待填写
 - 配置线索：待填写
 - 测试体系线索：待填写
-- 权限与安全线索：待填写
 - 已有 AI 痕迹：待填写
+- 轻量框架识别：待填写
 
 ## 待确认问题
 

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

@@ -16,10 +16,18 @@
 
 待填写。
 
+## 旧规则失效判定
+
+待填写。
+
 ## 端、模块、技术栈与本地启动方式
 
 待填写。
 
+## 轻量框架识别结果
+
+待填写。
+
 ## 数据库、API、测试体系发现情况
 
 待填写。

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

@@ -10,4 +10,4 @@
   "api": "unknown",
   "tests": "unknown",
   "lastUpdatedAt": ""
-}
+}

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

@@ -1,8 +1,8 @@
 {
   "packageName": "xinyun-ai-init",
   "displayName": "欣芸技术开发 Agent 流初始化包",
-  "version": "1.0.2",
-  "scriptVersion": "2026.07.10",
+  "version": "1.1.1",
+  "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.0.2",
+  "version": "1.1.1",
   "description": "欣芸技术开发 Agent 流初始化包",
   "bin": {
     "xinyun-ai-init": "bin/xinyun-ai-init.js"