@pm_zhousl/xinyun-ai-init 1.1.4 → 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,16 @@ UI 类需求至少判断前端改动模式：样式微调 / 新页面 / 页面
 
 普通聊天、临时咨询、无长期价值排查不沉淀。
 
+## 前端官方组件与 API 优先
+
+前端组件调用、框架 API 和交互能力优先使用官方组件、官方 API、官方推荐写法或项目已有封装。
+
+- 微信小程序：优先使用官方基础组件、官方 API、页面配置和项目已有封装。
+- uni-app：优先使用 uni-app 官方组件、`uni.*` API、官方生命周期和项目已有封装。
+- Vue2 / Vue3：优先使用 Vue 官方组件组织方式、官方响应式 / 生命周期 / 组合式或选项式 API，以及项目已有组件体系。
+- React：优先使用 React 官方组件模式、Hooks、受控组件等官方推荐方式，以及项目已有组件体系。
+- 确需第三方库、自定义组件或自造工具时，必须在改动计划中说明原因、影响范围和替代方案。
+
 ## 商业逻辑与变现流程理解
 
 当需求涉及金额、订单、权益、结算、优惠、积分、分润、提现、会员等级、支付状态或退款等商业逻辑时，AI 必须先做触发式业务理解。
@@ -222,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/` 内补齐对应目录和说明文件。
@@ -315,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,15 @@
 - 新页面或页面重写必须先说明页面结构方案，且不得顺手修改无关页面。
 - 普通聊天、临时咨询、无长期价值排查不沉淀。
 
+## 前端官方组件与 API 优先
+
+- 前端组件调用、框架 API 和交互能力优先使用官方组件、官方 API、官方推荐写法或项目已有封装。
+- 微信小程序优先使用官方基础组件、官方 API、页面配置和项目已有封装。
+- uni-app 优先使用 uni-app 官方组件、`uni.*` API、官方生命周期和项目已有封装。
+- Vue2 / Vue3 优先使用 Vue 官方组件组织方式、官方响应式 / 生命周期 / 组合式或选项式 API，以及项目已有组件体系。
+- React 优先使用 React 官方组件模式、Hooks、受控组件等官方推荐方式，以及项目已有组件体系。
+- 确需第三方库、自定义组件或自造工具时，必须在改动计划中说明原因、影响范围和替代方案。
+
 ## 商业逻辑与变现流程理解
 
 - 当需求涉及金额、订单、权益、结算、优惠、积分、分润、提现、会员等级、支付状态或退款等商业逻辑时，先做触发式业务理解。
@@ -88,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/`。

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

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

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

@@ -1,6 +1,6 @@
 {
   "projectName": "",
-  "xinyunAiVersion": "1.1.4",
+  "xinyunAiVersion": "1.1.5",
   "scriptVersion": "2026.07.15",
   "schemaVersion": "1",
   "initializationMode": "fast",
@@ -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,7 +1,7 @@
 {
   "packageName": "xinyun-ai-init",
   "displayName": "欣芸技术开发 Agent 流初始化包",
-  "version": "1.1.4",
+  "version": "1.1.5",
   "scriptVersion": "2026.07.15",
   "schemaVersion": "1",
   "defaultMode": "fast-init",

package/package.json

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

package/scripts/verify-init-package.js

@@ -116,12 +116,28 @@ function verifyInitRules() {
     "涉及 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", [
@@ -129,6 +145,13 @@ function verifyInitRules() {
     "前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及",
     "有 CodeGraph 时，结构性问题优先使用 CodeGraph",
     "发现可复用经验时，先记录为候选经验",
+    "前端官方组件与 API 优先",
+    "uni.*",
+    "Vue2 / Vue3",
+    "React 官方组件模式",
+    "Git 工作区与危险操作门禁",
+    "单仓库 / 多仓库 / 混合仓库 / 无 Git",
+    "不得自动执行 `commit`、`tag`、`push`、`pull`、`merge`、`rebase`、`reset`、`checkout` 回滚或切分支",
   ]);
 }