@pm_zhousl/xinyun-ai-init 1.1.3 → 1.1.5

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

@@ -65,6 +65,8 @@ CLI 只负责生成 `xinyun-ai-init/`，不创建 `xinyun-ai/`，也不修改业
 - 是否影响 UI：
 - 是否影响配置：
 - 前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及
+- Git 模式：单仓库 / 多仓库 / 混合仓库 / 未发现
+- Git 影响范围：
 
 ## 4. 预计修改文件
 
@@ -98,6 +100,31 @@ UI 类需求至少判断前端改动模式：样式微调 / 新页面 / 页面
 
 普通聊天、临时咨询、无长期价值排查不沉淀。
 
+## 前端官方组件与 API 优先
+
+前端组件调用、框架 API 和交互能力优先使用官方组件、官方 API、官方推荐写法或项目已有封装。
+
+- 微信小程序：优先使用官方基础组件、官方 API、页面配置和项目已有封装。
+- uni-app：优先使用 uni-app 官方组件、`uni.*` API、官方生命周期和项目已有封装。
+- Vue2 / Vue3：优先使用 Vue 官方组件组织方式、官方响应式 / 生命周期 / 组合式或选项式 API，以及项目已有组件体系。
+- React：优先使用 React 官方组件模式、Hooks、受控组件等官方推荐方式，以及项目已有组件体系。
+- 确需第三方库、自定义组件或自造工具时，必须在改动计划中说明原因、影响范围和替代方案。
+
+## 商业逻辑与变现流程理解
+
+当需求涉及金额、订单、权益、结算、优惠、积分、分润、提现、会员等级、支付状态或退款等商业逻辑时，AI 必须先做触发式业务理解。
+
+触发后先梳理：
+
+- 业务目标
+- 关键角色
+- 资金 / 权益 / 状态流转
+- 数据库、API、UI 和测试数据影响
+- 风险点
+- 验收标准
+
+该规则只在相关需求触发时启用，不默认创建 `xinyun-ai/business/`，也不在首次初始化阶段生成大量商业分析文档。
+
 ## 统一入口与旧规则失效
 
 当前项目 AI 规则以 `xinyun-ai/` 为准，`AGENTS.md` 只作为入口文件，指向 `xinyun-ai/`。
@@ -207,6 +234,29 @@ xinyun-ai/index/project-index.json
 - 回复先给结论，再给依据路径，再给待确认问题。
 - 不沿用用户已经纠正或否定的旧方向。
 
+## Git 工作区与危险操作门禁
+
+如果项目使用 Git，AI 必须先识别 Git 托管模式：
+
+- 单仓库：根目录一个 `.git`，所有端在同一仓库中。
+- 多仓库：各端口目录各自有 `.git`，例如 `server/`、`admin/`、`app/` 分别托管。
+- 混合仓库：根目录有 `.git`，部分子端口也有独立 `.git`。
+- 无 Git：当前项目未发现 Git，标注 `未在项目中发现`，不强行初始化。
+
+涉及代码、配置、数据库、依赖、构建脚本、测试逻辑、API、UI 或业务流程改动时，改动计划必须说明：
+
+- Git 模式
+- 涉及仓库
+- 当前分支
+- 工作区是否干净
+- 是否需要新分支
+- 是否建议拆分 commit
+- 是否涉及 tag / 发布
+
+AI 可以读取 Git 状态、总结 diff、建议 commit message 和 tag；未获用户明确确认前，不得自动执行 `commit`、`tag`、`push`、`pull`、`merge`、`rebase`、`reset`、`checkout` 回滚或切分支。
+
+多端多仓库改动后，应按仓库分别输出交付摘要和建议 commit message，不要混成一个提交建议。
+
 ## 按需补齐
 
 后续识别到新端、模块或能力时，只在 `xinyun-ai/` 内补齐对应目录和说明文件。
@@ -219,9 +269,36 @@ xinyun-ai/index/project-index.json
 - 问题排查：`xinyun-ai/problems/`
 - 需求：`xinyun-ai/requirements/`
 - 技术经验：`xinyun-ai/rules-candidates/`
+- 全局影响审视：`xinyun-ai/global-review/`
 
 新目录创建后必须更新 `xinyun-ai/manifest.json` 和 `xinyun-ai/index/project-index.json`。
 
+## 通用项目全局视角
+
+新增功能、大改、重构、跨端改动、目录 / 规则 / 索引调整时，AI 必须先做全局影响审视。
+
+小改可以只在改动计划中简写全局影响；新功能、大改、重构、跨端改动、目录 / 规则 / 索引调整，应按需创建或更新：
+
+```md
+xinyun-ai/global-review/
+```
+
+全局审视不代替改动计划，它是改动计划前的影响检查。
+
+建议审视层：
+
+- 入口层
+- 目录层
+- 索引层
+- 任务层
+- 规则层
+- 多端层
+- 数据层
+- API 层
+- UI 层
+- 验证层
+- 交接层
+
 ## 会话工作台
 
 首次初始化不创建会话工作台。复杂任务中可按需创建：
@@ -273,5 +350,6 @@ npx --yes @pm_zhousl/xinyun-ai-init@latest --force
 5. 识别到的端、模块、技术栈、本地启动线索。
 6. 数据库、API、测试体系发现情况。
 7. CodeGraph 与索引状态。
-8. 待确认问题。
-9. 后续日常开发和问题排查短指令。
+8. Git 模式、涉及仓库、当前分支和工作区状态。
+9. 待确认问题。
+10. 后续日常开发和问题排查短指令。

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

@@ -30,6 +30,16 @@
 
 说明：用户发送 `xinyun-ai-init` 一句话入口后，视为已授权 AI 创建或补齐最小 `xinyun-ai/` 与本入口文件；该授权不包含业务代码、配置、数据库、API、UI 或业务流程修改。
 
+## 前端与 Git 安全边界
+
+前端组件调用、框架 API 和交互能力优先使用官方组件、官方 API、官方推荐写法或项目已有封装。微信小程序、uni-app、Vue2、Vue3、React 等框架中，能用官方能力解决的，不优先引入第三方组件或自造工具。
+
+确需第三方库、自定义组件或自造工具时，必须先说明原因、影响范围和替代方案，并等待用户确认。
+
+如果项目使用 Git，AI 必须识别单仓库 / 多仓库 / 混合仓库 / 无 Git 模式，并在改动计划中说明涉及仓库、当前分支、工作区是否干净、是否建议新分支、是否建议拆分 commit、是否涉及 tag / 发布。
+
+未获用户明确确认前，AI 不得自动执行 `commit`、`tag`、`push`、`pull`、`merge`、`rebase`、`reset`、`checkout` 回滚或切分支。
+
 AI 接手本项目时，请先读取：
 
 - `xinyun-ai/README.md`

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

@@ -46,6 +46,8 @@
 - 是否影响 UI：
 - 是否影响配置：
 - 前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及
+- Git 模式：单仓库 / 多仓库 / 混合仓库 / 未发现
+- Git 影响范围：
 
 ## 4. 预计修改文件
 
@@ -73,6 +75,21 @@
 - 新页面或页面重写必须先说明页面结构方案，且不得顺手修改无关页面。
 - 普通聊天、临时咨询、无长期价值排查不沉淀。
 
+## 前端官方组件与 API 优先
+
+- 前端组件调用、框架 API 和交互能力优先使用官方组件、官方 API、官方推荐写法或项目已有封装。
+- 微信小程序优先使用官方基础组件、官方 API、页面配置和项目已有封装。
+- uni-app 优先使用 uni-app 官方组件、`uni.*` API、官方生命周期和项目已有封装。
+- Vue2 / Vue3 优先使用 Vue 官方组件组织方式、官方响应式 / 生命周期 / 组合式或选项式 API，以及项目已有组件体系。
+- React 优先使用 React 官方组件模式、Hooks、受控组件等官方推荐方式，以及项目已有组件体系。
+- 确需第三方库、自定义组件或自造工具时，必须在改动计划中说明原因、影响范围和替代方案。
+
+## 商业逻辑与变现流程理解
+
+- 当需求涉及金额、订单、权益、结算、优惠、积分、分润、提现、会员等级、支付状态或退款等商业逻辑时，先做触发式业务理解。
+- 触发后先梳理业务目标、关键角色、资金 / 权益 / 状态流转、数据库 / API / UI / 测试数据影响、风险点和验收标准。
+- 该规则只在相关需求触发时启用，不默认创建 `xinyun-ai/business/`。
+
 ## 检索与回复
 
 - 先读 `AGENTS.md`、`xinyun-ai/manifest.json`、`xinyun-ai/index/project-index.json`、`xinyun-ai/current-task.md`。
@@ -82,6 +99,15 @@
 - 回复先给结论，再给依据路径，再给待确认问题。
 - 不沿用用户已经纠正或否定的旧方向。
 
+## Git 工作区与危险操作门禁
+
+- 如果项目使用 Git，先识别 Git 模式：单仓库 / 多仓库 / 混合仓库 / 无 Git。
+- 无 Git 时标注 `未在项目中发现`，不强行初始化。
+- 涉及代码、配置、数据库、依赖、构建脚本、测试逻辑、API、UI 或业务流程改动时，改动计划必须说明涉及仓库、当前分支、工作区是否干净、是否需要新分支、是否建议拆分 commit、是否涉及 tag / 发布。
+- AI 可以读取 Git 状态、总结 diff、建议 commit message 和 tag。
+- 未获用户明确确认前，不得自动执行 `commit`、`tag`、`push`、`pull`、`merge`、`rebase`、`reset`、`checkout` 回滚或切分支。
+- 多端多仓库改动后，应按仓库分别输出交付摘要和建议 commit message。
+
 ## 框架适配
 
 - 框架适配规则位于 `xinyun-ai-init/rules/frameworks/`。
@@ -105,6 +131,14 @@
 
 复杂任务可按需创建 `xinyun-ai/index/session-current.md`。该文件只记录本轮临时线索，不是项目事实源。
 
+## 通用项目全局视角
+
+- 新增功能、大改、重构、跨端改动、目录 / 规则 / 索引调整时，先做全局影响审视。
+- 小改可以只在改动计划中简写全局影响。
+- 需要落盘时按需创建或更新 `xinyun-ai/global-review/`。
+- 全局审视不代替改动计划，它是改动计划前的影响检查。
+- 建议审视入口层、目录层、索引层、任务层、规则层、多端层、数据层、API 层、UI 层、验证层和交接层。
+
 ## 自我学习
 
 发现可复用经验时，先记录为候选经验。候选经验必须标注来源、适用范围、可信度、状态和最后验证时间。用户确认后，才能合并进正式规则。

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

@@ -8,6 +8,10 @@
 - 待确认问题：
 - 改动计划摘要：
 - SQL 执行提醒：
+- 商业逻辑 / 变现流程提醒：
+- 全局影响审视：
+- Git 模式与仓库影响：
+- 前端官方组件 / API 选型：
 - 验证结果：
 - 旧沉淀接管：
 - 本轮沉淀位置：

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

@@ -1,7 +1,7 @@
 {
   "projectName": "",
-  "xinyunAiVersion": "1.1.3",
-  "scriptVersion": "2026.07.14",
+  "xinyunAiVersion": "1.1.5",
+  "scriptVersion": "2026.07.15",
   "schemaVersion": "1",
   "initializationMode": "fast",
   "expansionMode": "triggered",
@@ -10,7 +10,8 @@
     "overall": "quick",
     "workstreams": {},
     "database": "unknown",
-    "api": "unknown"
+    "api": "unknown",
+    "git": "unknown"
   },
   "codegraph": { "enabled": false, "status": "unknown" },
   "index": { "primary": "json_markdown", "sqlite": "optional" },

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

@@ -14,6 +14,7 @@
 - API 相关线索：待填写
 - 配置线索：待填写
 - 测试体系线索：待填写
+- Git 模式与仓库线索：待填写
 - 已有 AI 痕迹：待填写
 - 旧 AI 沉淀来源：待填写
 - 可接管内容：待填写

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

@@ -35,6 +35,10 @@
 
 待填写。
 
+## Git 模式与仓库管理
+
+待填写。
+
 ## 轻量框架识别结果
 
 待填写。

package/init/xinyun-ai-init/templates/workstreams-readme.template.md

@@ -14,4 +14,8 @@
 
 ## 已识别端
 
-待填写。
+待填写。
+
+## 端口 Git 仓库
+
+待填写。

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pm_zhousl/xinyun-ai-init",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "description": "欣芸技术开发 Agent 流初始化包",
   "bin": {
     "xinyun-ai-init": "bin/xinyun-ai-init.js"
@@ -12,6 +12,7 @@
     "README.md"
   ],
   "scripts": {
+    "verify:init": "node ./scripts/verify-init-package.js",
     "publish:token": "powershell -ExecutionPolicy Bypass -File ./scripts/publish-with-token.ps1",
     "publish:token:dry": "powershell -ExecutionPolicy Bypass -File ./scripts/publish-with-token.ps1 -DryRun"
   },

package/scripts/verify-init-package.js

@@ -0,0 +1,226 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+
+const root = path.resolve(__dirname, "..");
+const initRoot = path.join(root, "init", "xinyun-ai-init");
+
+const checks = [];
+
+function rel(filePath) {
+  return path.relative(root, filePath).replace(/\\/g, "/");
+}
+
+function readText(relativePath) {
+  const filePath = path.join(root, relativePath);
+  return fs.readFileSync(filePath, "utf8");
+}
+
+function addCheck(name, ok, detail) {
+  checks.push({ name, ok, detail });
+}
+
+function requireFile(relativePath) {
+  const filePath = path.join(root, relativePath);
+  addCheck(`文件存在：${relativePath}`, fs.existsSync(filePath), "缺少必需文件");
+}
+
+function requireIncludes(relativePath, snippets) {
+  const content = readText(relativePath);
+  for (const snippet of snippets) {
+    addCheck(
+      `${relativePath} 包含：${snippet}`,
+      content.includes(snippet),
+      `未找到关键文本：${snippet}`
+    );
+  }
+}
+
+function requireJson(relativePath) {
+  try {
+    JSON.parse(readText(relativePath));
+    addCheck(`JSON 可解析：${relativePath}`, true);
+  } catch (error) {
+    addCheck(`JSON 可解析：${relativePath}`, false, error.message);
+  }
+}
+
+function requireMarkdownBalanced(relativePath) {
+  const content = readText(relativePath);
+  const fenceCount = (content.match(/```/g) || []).length;
+  addCheck(
+    `Markdown 代码块闭合：${relativePath}`,
+    fenceCount % 2 === 0,
+    `代码块围栏数量为 ${fenceCount}`
+  );
+}
+
+function walkFiles(dirPath) {
+  const result = [];
+  for (const entry of fs.readdirSync(dirPath, { withFileTypes: true })) {
+    const entryPath = path.join(dirPath, entry.name);
+    if (entry.isDirectory()) {
+      result.push(...walkFiles(entryPath));
+    } else {
+      result.push(entryPath);
+    }
+  }
+  return result;
+}
+
+function verifyPackageFiles() {
+  const packageJson = JSON.parse(readText("package.json"));
+  const expectedFiles = ["bin/", "init/", "scripts/", "README.md"];
+
+  for (const expected of expectedFiles) {
+    addCheck(
+      `package.json files 包含：${expected}`,
+      Array.isArray(packageJson.files) && packageJson.files.includes(expected),
+      "发布文件白名单缺少该路径"
+    );
+  }
+
+  addCheck(
+    "package.json scripts 包含 verify:init",
+    packageJson.scripts && packageJson.scripts["verify:init"] === "node ./scripts/verify-init-package.js",
+    "缺少发布前校验命令"
+  );
+}
+
+function verifyCliBoundary() {
+  const cli = readText("bin/xinyun-ai-init.js");
+
+  requireIncludes("bin/xinyun-ai-init.js", [
+    "This CLI only creates xinyun-ai-init/",
+    "It does not create xinyun-ai/ or modify business code",
+    "printNextStep",
+  ]);
+
+  addCheck(
+    "CLI 目标目录仅为 xinyun-ai-init",
+    cli.includes('const target = path.join(cwd, "xinyun-ai-init");'),
+    "CLI 不应直接创建 xinyun-ai/"
+  );
+}
+
+function verifyInitRules() {
+  requireIncludes("init/xinyun-ai-init/README.md", [
+    "用户发送一句话入口后，AI 可以按本 README 和 `templates/` 创建或补齐首次最小落盘清单。",
+    "该授权只覆盖 AI 工作区初始化，不代表授权修改业务代码",
+    "标准改动计划",
+    "前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及",
+    "当前项目 AI 规则以 `xinyun-ai/` 为准",
+    "旧 AI 文档、旧 docs、旧提示词、旧规则文件只作为历史线索，不作为执行依据",
+    "ThinkPHP、uni-app、微信小程序",
+    "涉及 SQL / 数据库改动时，必须单独输出 SQL 执行提醒",
+    "商业逻辑",
+    "xinyun-ai/global-review/",
+    "Git 工作区与危险操作门禁",
+    "单仓库",
+    "多仓库",
+    "混合仓库",
+    "commit",
+    "push",
+    "rebase",
+    "前端官方组件与 API 优先",
+    "微信小程序",
+    "uni.*",
+    "Vue2 / Vue3",
+    "React",
+    "第三方库",
+  ]);
+
+  requireIncludes("init/xinyun-ai-init/templates/AGENTS.template.md", [
+    "当前项目 AI 规则以 `xinyun-ai/` 为准",
+    "任何代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程修改前",
+    "只有用户明确回复“确认执行”“可以修改”“按方案改”“同意”等类似内容后",
+    "前端组件调用、框架 API 和交互能力优先使用官方组件",
+    "单仓库 / 多仓库 / 混合仓库 / 无 Git",
+    "不得自动执行 `commit`、`tag`、`push`、`pull`、`merge`、`rebase`、`reset`、`checkout` 回滚或切分支",
+  ]);
+
+  requireIncludes("init/xinyun-ai-init/templates/core-rules.template.md", [
+    "标准改动计划",
+    "前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及",
+    "有 CodeGraph 时，结构性问题优先使用 CodeGraph",
+    "发现可复用经验时，先记录为候选经验",
+    "前端官方组件与 API 优先",
+    "uni.*",
+    "Vue2 / Vue3",
+    "React 官方组件模式",
+    "Git 工作区与危险操作门禁",
+    "单仓库 / 多仓库 / 混合仓库 / 无 Git",
+    "不得自动执行 `commit`、`tag`、`push`、`pull`、`merge`、`rebase`、`reset`、`checkout` 回滚或切分支",
+  ]);
+}
+
+function verifyFrameworkRules() {
+  const required = [
+    "init/xinyun-ai-init/rules/frameworks/README.md",
+    "init/xinyun-ai-init/rules/frameworks/backend/php/thinkphp.md",
+    "init/xinyun-ai-init/rules/frameworks/frontend/uni-app.md",
+    "init/xinyun-ai-init/rules/frameworks/frontend/wechat-miniprogram.md",
+  ];
+
+  for (const file of required) {
+    requireFile(file);
+  }
+
+  requireIncludes("init/xinyun-ai-init/rules/frameworks/backend/php/thinkphp.md", [
+    "topthink/framework",
+    "think\\facade",
+  ]);
+  requireIncludes("init/xinyun-ai-init/rules/frameworks/frontend/uni-app.md", [
+    "pages.json",
+    "vite-plugin-uni",
+  ]);
+  requireIncludes("init/xinyun-ai-init/rules/frameworks/frontend/wechat-miniprogram.md", [
+    "project.config.json",
+    ".wxml",
+  ]);
+}
+
+function verifyJsonAndMarkdown() {
+  const jsonFiles = walkFiles(initRoot).filter((filePath) => filePath.endsWith(".json"));
+  const mdFiles = walkFiles(initRoot).filter((filePath) => filePath.endsWith(".md"));
+
+  for (const filePath of jsonFiles) {
+    requireJson(rel(filePath));
+  }
+
+  for (const filePath of mdFiles) {
+    requireMarkdownBalanced(rel(filePath));
+  }
+}
+
+function main() {
+  requireFile("bin/xinyun-ai-init.js");
+  requireFile("init/xinyun-ai-init/README.md");
+  requireFile("init/xinyun-ai-init/version.json");
+
+  verifyPackageFiles();
+  verifyCliBoundary();
+  verifyInitRules();
+  verifyFrameworkRules();
+  verifyJsonAndMarkdown();
+
+  const failed = checks.filter((check) => !check.ok);
+
+  for (const check of checks) {
+    const prefix = check.ok ? "[PASS]" : "[FAIL]";
+    console.log(`${prefix} ${check.name}`);
+    if (!check.ok && check.detail) {
+      console.log(`       ${check.detail}`);
+    }
+  }
+
+  console.log("");
+  console.log(`[xinyun-ai-init verify] ${checks.length - failed.length}/${checks.length} checks passed.`);
+
+  if (failed.length > 0) {
+    process.exit(1);
+  }
+}
+
+main();