@pm_zhousl/xinyun-ai-init 1.1.4 → 1.1.6

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/` 内补齐对应目录和说明文件。
@@ -264,6 +299,103 @@ xinyun-ai/global-review/
 - 验证层
 - 交接层
 
+## 双会话执行闭环（MVP）
+
+复杂改动可使用一个主会话 + 一个执行会话的手工协作闭环。普通咨询、只读分析和不涉及文件修改的任务仍可使用单会话。
+
+产品目标：
+
+- 当前版本只验证一个主会话 + 一个执行会话。
+- 主会话负责理解、计划、确认、派发和复核。
+- 执行会话负责按任务单执行、验证和回传交接单。
+- 只做本地文件手工交接，不自动创建外部 AI 会话，不接入 n8n。
+
+主会话职责：
+
+- 理解中文需求。
+- 识别任务类型和影响范围。
+- 生成改动计划。
+- 等待用户明确确认。
+- 生成执行任务单。
+- 复核执行结果并输出最终交付结论。
+
+执行会话职责：
+
+- 读取任务单。
+- 只在确认范围内执行。
+- 进行必要验证。
+- 输出执行交接单。
+- 不创建第三个会话。
+- 不自行扩大范围。
+
+文件契约和读写权限：
+
+- `xinyun-ai/current-task.md`：主会话维护。
+- `xinyun-ai/index/session-current.md`：主会话创建的临时执行任务单，执行会话只读；该文件不再仅作为普通会话线索。
+- `xinyun-ai/handoffs/current-execution.md`：执行会话写入的执行交接单，主会话只读复核。
+
+任务单和交接单必须记录：
+
+- `taskId`
+- `executionId`
+- `status`
+- `owner`
+- `attempt`
+- 用户确认状态
+- 创建时间
+- 更新时间
+
+任务单必须记录：
+
+- 允许修改文件
+- 禁止修改范围
+- 禁止执行的高风险操作
+- 验证命令
+- 验收标准
+- 发现新影响范围后的暂停规则
+
+交接单必须记录：
+
+- 执行前 Git 或文件状态
+- 实际修改文件
+- diff 摘要
+- 测试结果
+- 未完成事项
+- 新风险
+- 是否存在超范围修改
+
+状态机至少包含：待确认、待执行、执行中、暂停待复核、待主会话复核、已完成、失败、中断、超时、阻塞、取消、需重新确认。
+
+失败、中断、超时后不得自动重试。重试必须由主会话重新确认并增加 `attempt`，不能覆盖历史交接结果。
+
+人工启动第二会话：
+
+1. 主会话在用户确认改动计划后创建或更新 `xinyun-ai/index/session-current.md`。
+2. 用户手工新建或打开执行会话，把任务单路径和执行要求交给执行会话。
+3. 执行会话读取任务单，只在允许范围内执行。
+4. 执行会话完成后写入 `xinyun-ai/handoffs/current-execution.md`。
+5. 用户把执行结果或交接单路径回传给主会话。
+6. 主会话复核交接单、diff、验证结果和风险后，输出最终交付结论。
+
+MVP 边界：
+
+- 单项目。
+- 单活动任务。
+- 一个主会话。
+- 一个执行会话。
+- 本地文件手工交接。
+- 暂不支持第三个会话。
+- 暂不接入 n8n。
+- 暂不自动创建外部 AI 会话。
+- 普通咨询任务仍可使用单会话。
+
+与现有规则关系：
+
+- 改动计划与执行确认规则负责用户确认门禁。
+- 双会话执行闭环负责任务分派、执行和交接。
+- Git 工作区与危险操作门禁必须进入任务单和交接单。
+- `session-current.md` 统一定义为临时执行任务单。
+
 ## 会话工作台
 
 首次初始化不创建会话工作台。复杂任务中可按需创建：
@@ -272,7 +404,7 @@ xinyun-ai/global-review/
 xinyun-ai/index/session-current.md
 ```
 
-`session-current.md` 只记录本轮临时线索，不是项目事实源。会话结束前筛选：长期有价值的沉淀到正式目录，仅本轮有价值的写入 `sessions/`，无价值、误判、非项目内容不沉淀。
+`session-current.md` 在普通单会话任务中只记录本轮临时线索；在双会话执行闭环中统一作为临时执行任务单。它不是项目事实源。会话结束前筛选：长期有价值的沉淀到正式目录，仅本轮有价值的写入 `sessions/`，无价值、误判、非项目内容不沉淀。
 
 ## 自我学习
 
@@ -315,5 +447,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/rules/session-workbench.md

@@ -8,9 +8,15 @@ xinyun-ai/index/session-current.md
 
 规则：
 
-- `session-current.md` 只记录本轮临时线索，不是项目事实源。
+- 普通单会话任务中，`session-current.md` 只记录本轮临时线索，不是项目事实源。
+- 双会话执行闭环中，`session-current.md` 统一作为主会话创建的临时执行任务单，执行会话只读。
+- 执行会话的交接结果写入 `xinyun-ai/handoffs/current-execution.md`，主会话只读复核。
 - 不记录非项目内容、闲聊、敏感值。
 - 不记录完整搜索流水账，只记录关键文件、关键发现、待确认点、候选沉淀。
 - 如果发现旧 AI 沉淀，只记录来源路径、分类结果和是否可接管，不直接把旧内容写成事实。
 - 会话结束前必须筛选：长期有价值的沉淀到正式目录；仅本轮有价值的写入 `sessions/`；无价值、误判、非项目内容不沉淀。
 - 筛选完成后更新 `index/project-index.json`。
+
+双会话任务单至少记录：`taskId`、`executionId`、`status`、`owner`、`attempt`、用户确认状态、允许修改文件、禁止修改范围、高风险操作、验证命令、验收标准和发现新影响范围后的暂停规则。
+
+双会话交接单至少记录：执行前 Git 或文件状态、实际修改文件、diff 摘要、测试结果、未完成事项、新风险和是否存在超范围修改。

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/`。
@@ -109,7 +129,7 @@
 
 ## 会话工作台
 
-复杂任务可按需创建 `xinyun-ai/index/session-current.md`。该文件只记录本轮临时线索，不是项目事实源。
+复杂任务可按需创建 `xinyun-ai/index/session-current.md`。普通单会话任务中，该文件只记录本轮临时线索；双会话执行闭环中，该文件统一作为临时执行任务单。它不是项目事实源。
 
 ## 通用项目全局视角
 
@@ -119,6 +139,22 @@
 - 全局审视不代替改动计划，它是改动计划前的影响检查。
 - 建议审视入口层、目录层、索引层、任务层、规则层、多端层、数据层、API 层、UI 层、验证层和交接层。
 
+## 双会话执行闭环（MVP）
+
+- 复杂改动可使用一个主会话 + 一个执行会话的手工协作闭环；普通咨询、只读分析和不涉及文件修改的任务仍可使用单会话。
+- 主会话负责理解中文需求、识别任务类型和影响范围、生成改动计划、等待用户确认、生成执行任务单、复核执行结果并输出最终交付结论。
+- 执行会话负责读取任务单、只在确认范围内执行、进行必要验证、输出执行交接单、不创建第三个会话、不自行扩大范围。
+- `xinyun-ai/current-task.md` 由主会话维护。
+- `xinyun-ai/index/session-current.md` 是主会话创建的临时执行任务单，执行会话只读；该文件不再仅作为普通会话线索。
+- `xinyun-ai/handoffs/current-execution.md` 是执行会话写入的执行交接单，主会话只读复核。
+- 任务单和交接单必须记录 `taskId`、`executionId`、`status`、`owner`、`attempt`、用户确认状态、创建时间和更新时间。
+- 任务单必须记录允许修改文件、禁止修改范围、禁止执行的高风险操作、验证命令、验收标准、发现新影响范围后的暂停规则。
+- 交接单必须记录执行前 Git 或文件状态、实际修改文件、diff 摘要、测试结果、未完成事项、新风险、是否存在超范围修改。
+- 状态机至少包含：待确认、待执行、执行中、暂停待复核、待主会话复核、已完成、失败、中断、超时、阻塞、取消、需重新确认。
+- 失败、中断、超时后不得自动重试；重试必须由主会话重新确认并增加 `attempt`，不能覆盖历史交接结果。
+- MVP 边界：单项目、单活动任务、一个主会话、一个执行会话、本地文件手工交接、暂不支持第三个会话、暂不接入 n8n、暂不自动创建外部 AI 会话。
+- 改动计划与执行确认规则负责用户确认门禁；双会话执行闭环负责任务分派、执行和交接。
+
 ## 自我学习
 
 发现可复用经验时，先记录为候选经验。候选经验必须标注来源、适用范围、可信度、状态和最后验证时间。用户确认后，才能合并进正式规则。

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

@@ -10,6 +10,16 @@
 - SQL 执行提醒：
 - 商业逻辑 / 变现流程提醒：
 - 全局影响审视：
+- Git 模式与仓库影响：
+- 前端官方组件 / API 选型：
+- 双会话执行：
+  - taskId：
+  - executionId：
+  - owner：
+  - attempt：
+  - 用户确认状态：
+  - 执行任务单：
+  - 执行交接单：
 - 验证结果：
 - 旧沉淀接管：
 - 本轮沉淀位置：

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

@@ -1,6 +1,6 @@
 {
   "projectName": "",
-  "xinyunAiVersion": "1.1.4",
+  "xinyunAiVersion": "1.1.6",
   "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/project-index.template.json

@@ -9,5 +9,10 @@
   "database": "unknown",
   "api": "unknown",
   "tests": "unknown",
+  "handoffs": {
+    "activeTask": "none",
+    "taskFile": "xinyun-ai/index/session-current.md",
+    "handoffFile": "xinyun-ai/handoffs/current-execution.md"
+  },
   "lastUpdatedAt": ""
 }

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.6",
   "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.6",
   "description": "欣芸技术开发 Agent 流初始化包",
   "bin": {
     "xinyun-ai-init": "bin/xinyun-ai-init.js"

package/scripts/verify-init-package.js

@@ -116,12 +116,35 @@ function verifyInitRules() {
     "涉及 SQL / 数据库改动时，必须单独输出 SQL 执行提醒",
     "商业逻辑",
     "xinyun-ai/global-review/",
+    "Git 工作区与危险操作门禁",
+    "单仓库",
+    "多仓库",
+    "混合仓库",
+    "commit",
+    "push",
+    "rebase",
+    "前端官方组件与 API 优先",
+    "微信小程序",
+    "uni.*",
+    "Vue2 / Vue3",
+    "React",
+    "第三方库",
+    "双会话执行闭环（MVP）",
+    "xinyun-ai/index/session-current.md",
+    "xinyun-ai/handoffs/current-execution.md",
+    "taskId",
+    "executionId",
+    "待主会话复核",
+    "不得自动重试",
   ]);
 
   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 +152,19 @@ function verifyInitRules() {
     "前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及",
     "有 CodeGraph 时，结构性问题优先使用 CodeGraph",
     "发现可复用经验时，先记录为候选经验",
+    "前端官方组件与 API 优先",
+    "uni.*",
+    "Vue2 / Vue3",
+    "React 官方组件模式",
+    "Git 工作区与危险操作门禁",
+    "单仓库 / 多仓库 / 混合仓库 / 无 Git",
+    "不得自动执行 `commit`、`tag`、`push`、`pull`、`merge`、`rebase`、`reset`、`checkout` 回滚或切分支",
+    "双会话执行闭环（MVP）",
+    "xinyun-ai/index/session-current.md",
+    "xinyun-ai/handoffs/current-execution.md",
+    "taskId",
+    "executionId",
+    "不得自动重试",
   ]);
 }