@pm_zhousl/xinyun-ai-init 1.1.6 → 1.3.0

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

@@ -2,6 +2,8 @@
 
 本目录是“欣芸技术开发 Agent 流”的初始化包，负责把完整 AI 执行要求下发到目标项目。
 
+当前规则版本：`1.3.0`。
+
 ## Codex 一句话入口
 
 ```md
@@ -29,8 +31,12 @@ AI 读取本文件后，必须按以下方式执行：
 5. 涉及 SQL / 数据库改动时，必须单独输出 SQL 执行提醒。
 6. 非项目开发内容不要沉淀。
 7. 如果当前项目已有旧 AI 沉淀或历史规则痕迹，先梳理清单并分类接管，能合并的内容归入 `xinyun-ai/`，不能确认的内容标记为 `待确认`，不要直接当作正式事实。
-8. 首次初始化不执行语言级语法检查、lint、typecheck、测试或构建命令；本机缺少运行时只记录为待确认，不展开长解释。
-9. 完成后用中文输出初始化或升级结果、项目导读、待确认问题和后续短指令。
+8. 前端页面改动必须标注改动模式和页面类型，生产页面默认使用克制、真实业务语境的文案。
+9. 复杂改动可使用双会话执行闭环，主会话负责计划和复核，执行会话只按任务单执行。
+10. 需求模糊、涉及改动或出现高风险词时，先做中文需求解析和任务分型；普通咨询不强制输出完整解析结构。
+11. 新功能、大改、重构、跨端、规则或索引调整时，先做全局影响审视；首次极速初始化不强制创建全局审视目录。
+12. 首次初始化不执行语言级语法检查、lint、typecheck、测试或构建命令；本机缺少运行时只记录为待确认，不展开长解释。
+13. 完成后用中文输出初始化或升级结果、项目导读、待确认问题和后续短指令。
 
 ## 初始化授权边界
 
@@ -65,8 +71,11 @@ CLI 只负责生成 `xinyun-ai-init/`，不创建 `xinyun-ai/`，也不修改业
 - 是否影响 UI：
 - 是否影响配置：
 - 前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及
+- 页面类型：生产页面 / 原型页面 / 营销页面 / 不涉及
+- 页面文案预算：
 - Git 模式：单仓库 / 多仓库 / 混合仓库 / 未发现
 - Git 影响范围：
+- 用户确认状态：
 
 ## 4. 预计修改文件
 
@@ -86,18 +95,56 @@ CLI 只负责生成 `xinyun-ai-init/`，不创建 `xinyun-ai/`，也不修改业
 
 只有用户明确回复“确认执行”“可以修改”“按方案改”“同意”等类似内容后，才允许在确认范围内执行。
 
+执行过程中发现新增影响范围、计划外文件、计划外数据库 / API / UI / 配置影响、计划外高风险操作或验收标准变化时，必须暂停并重新确认。
+
 ## 轻量需求与 UI 理解
 
 涉及功能、业务流程、API、数据库、页面、组件、交互或样式时，出计划前先做轻量需求理解。
 
 信息不足时，最多问 1-3 个关键问题。
 
+需求模糊、涉及改动或出现高风险词时，必须先做中文需求语义规范化。普通咨询不强制输出完整解析结构。
+
+中文需求解析格式：
+
+```md
+## 中文需求解析
+
+- 用户原话：
+- AI 理解：
+- 任务类型：
+- 影响对象：
+- 可能涉及：
+- 不确定点：
+- 风险词：
+- 是否需要追问：
+- 下一步处理方式：
+```
+
+任务类型至少包括：问题排查、新功能开发、UI 调整、API / 接口调整、数据库 / SQL、商业逻辑、Git / 发布、文档沉淀、规则调整、临时咨询。
+
+高歧义表达包括：优化一下、处理一下、不对、怪怪的、照之前、顺便、差不多、参考一下。
+
+高风险词包括：订单、支付、退款、优惠券、会员、权益、金额、积分、分润、提现、结算、权限、删除、批量、发布、回滚。
+
+高歧义需求最多追问 1-3 个关键问题；信息足够时直接进入对应任务流程。高风险词触发更严格的业务理解、问题排查、Git / 发布门禁或 SQL 提醒，不得直接进入代码修改。
+
 UI 类需求至少判断前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及。
 
+UI 类需求还必须判断页面类型：生产页面 / 原型页面 / 营销页面 / 不涉及。
+
 如果当前 AI 工具有需求分析、原型、UI 交互、截图风格识别等 Skill，仅在任务明确匹配时调用对应 Skill；不得因为普通开发任务默认启用所有 Skill。
 
 样式微调应优先局部修改，不重写页面结构；新页面或页面重写必须先说明页面结构方案，且不得顺手修改无关页面。
 
+生产页面默认采用克制文案。未明确要求时，不添加功能介绍、设计解释、营销式或教程式占位文案，不出现“本页面用于……”等泛化说明，不默认使用“智能、高效、便捷、全方位”等泛化表达。
+
+标题、按钮、字段、状态、错误提示使用真实业务表达，围绕用户任务、业务数据和操作结果。允许保留高风险操作、空状态、异常状态所必需的提示。
+
+改动计划中应给出页面文案预算，说明新增文案的用途和大致数量。原型页面和营销页面可以使用说明性文案，但不能默认套用到生产页面。
+
+生产页面的去 AI 化验收标准：删除非必要说明后核心操作仍清楚；交付页面不出现明显 AI 话术；页面中不出现规则复述、教程式自我说明或与业务无关的占位文案。
+
 普通聊天、临时咨询、无长期价值排查不沉淀。
 
 ## 前端官方组件与 API 优先
@@ -135,6 +182,15 @@ UI 类需求至少判断前端改动模式：样式微调 / 新页面 / 页面
 
 如旧规则与 `xinyun-ai/` 冲突，以 `xinyun-ai/` 为准。
 
+规则优先级：
+
+1. `xinyun-ai/` 当前正式规则。
+2. 当前文件系统事实。
+3. 旧 AI 文档。
+4. 历史会话记忆。
+
+历史会话记忆不得覆盖当前文件系统事实，也不得补写文件系统中不存在的旧规则路径。
+
 ## 旧沉淀接管
 
 如果项目里已经存在旧 AI 沉淀，如旧 `AGENTS.md`、`docs/`、`CLAUDE.md`、`.cursor/`、旧提示词、旧规则文件或旧工作台记录，AI 应先做接管梳理，再决定是否纳入 `xinyun-ai/`。
@@ -143,6 +199,16 @@ UI 类需求至少判断前端改动模式：样式微调 / 新页面 / 页面
 
 临时聊天、无关内容、明显过期内容和无法确认的内容不进入正式沉淀；不存在的旧路径必须标注为 `当前项目未发现`。
 
+旧 AI 沉淀必须按“先识别、再分类、再接管”的顺序处理。
+
+接管分类：
+
+- 可接管：项目导读、规则入口、需求沉淀、问题记录、框架线索、当前任务线索、可复用经验候选。
+- 不接管：临时聊天、普通闲聊、无关内容、明显过期内容、无法确认来源的结论、敏感信息。
+- 待确认：来源不明、与当前项目文件冲突、无法验证或需要用户判断的内容。
+
+旧沉淀只做规则和模板接管，不创建自动迁移脚本，不自动覆盖现有正式规则。未确认内容不能直接写入正式规则。
+
 ## 欣芸技术开发 Agent 流
 
 这是一套面向 AI 编程工具的本地项目接手、按需理解、受控开发和持续沉淀方法论。
@@ -233,6 +299,8 @@ xinyun-ai/index/project-index.json
 - 输出中区分 `已确认`、`推断`、`待确认`、`未在项目中发现`。
 - 回复先给结论，再给依据路径，再给待确认问题。
 - 不沿用用户已经纠正或否定的旧方向。
+- 不做无关全量扫描，不把旧规则、旧路径或历史会话内容直接当作当前事实。
+- 少复述规则，多输出当前任务可直接使用的结论、计划、交接结果或下一步动作。
 
 ## Git 工作区与危险操作门禁
 
@@ -285,6 +353,26 @@ xinyun-ai/global-review/
 
 全局审视不代替改动计划，它是改动计划前的影响检查。
 
+首次极速初始化不强制创建 `xinyun-ai/global-review/`。
+
+触发条件包括：新功能、大范围修改、重构、跨端改动、目录 / 规则 / 索引调整、数据库 / API / UI 联动变更、涉及多会话交接的复杂任务。
+
+全局审视最小字段：
+
+- `reviewId`
+- 触发原因
+- 关联任务
+- 影响层
+- 已确认内容
+- 推断内容
+- 待确认内容
+- 风险点
+- 后续动作
+- 创建时间
+- 更新时间
+
+创建或更新全局审视后，应同步 `xinyun-ai/global-review/index.json` 和 `xinyun-ai/index/project-index.json`。全局审视不会授权 AI 直接修改业务代码。
+
 建议审视层：
 
 - 入口层
@@ -353,6 +441,8 @@ xinyun-ai/global-review/
 - 验证命令
 - 验收标准
 - 发现新影响范围后的暂停规则
+- Git 模式、涉及仓库、当前分支和工作区状态
+- 数据库 / API / UI / 配置影响
 
 交接单必须记录：
 
@@ -363,6 +453,8 @@ xinyun-ai/global-review/
 - 未完成事项
 - 新风险
 - 是否存在超范围修改
+- 是否执行过高风险操作
+- 是否发现新影响范围
 
 状态机至少包含：待确认、待执行、执行中、暂停待复核、待主会话复核、已完成、失败、中断、超时、阻塞、取消、需重新确认。
 
@@ -450,3 +542,11 @@ npx --yes @pm_zhousl/xinyun-ai-init@latest --force
 8. Git 模式、涉及仓库、当前分支和工作区状态。
 9. 待确认问题。
 10. 后续日常开发和问题排查短指令。
+
+交付输出要求：
+
+- 先给状态结论：已完成 / 部分完成 / 阻塞 / 需重新确认。
+- 说明实际创建、更新、未创建或未修改的内容。
+- 说明验证命令和结果；未验证时说明原因。
+- 说明风险、未完成事项和下一步动作。
+- 少复述规则，不输出明显 AI 话术，不把原型说明文案带入生产页面。

package/init/xinyun-ai-init/rules/directory-self-completion.md

@@ -8,4 +8,8 @@
 - 只允许补齐 `xinyun-ai/` 内的文档、索引和记录，不修改业务代码。
 - 新目录创建后必须更新 `manifest.json` 和 `index/project-index.json`。
 - 自完善内容必须标注来源、判断依据和状态：`推断`、`已确认`、`待确认`。
-- 如果自完善会改变正式规则、开发流程或代码修改策略，必须先输出方案并等待用户确认。
+- 如果自完善会改变正式规则、开发流程或代码修改策略，必须先输出方案并等待用户确认。
+- `xinyun-ai/global-review/` 只在新功能、大改、重构、跨端改动、目录 / 规则 / 索引调整、数据库 / API / UI 联动变更或多会话交接复杂任务中按需创建。
+- 首次极速初始化不强制创建 `xinyun-ai/global-review/`。
+- 创建或更新全局审视后，必须同步 `xinyun-ai/global-review/index.json` 和 `xinyun-ai/index/project-index.json`。
+- 全局审视最小字段包括：`reviewId`、触发原因、关联任务、影响层、已确认内容、推断内容、待确认内容、风险点、后续动作、创建时间、更新时间。

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

@@ -9,3 +9,9 @@
 - 用户发送一句话入口后，视为已授权创建或补齐最小 `xinyun-ai/` 与极简 `AGENTS.md`。
 - 初始化授权不包含业务代码、配置、数据库、API、UI 或业务流程修改。
 - 如果项目里已有旧 AI 沉淀，首次应先做清单化梳理，再决定哪些内容接管到 `xinyun-ai/`。
+- 当前项目 AI 规则以 `xinyun-ai/` 为准，旧 AI 文档只作为历史线索。
+- 旧规则路径不存在时必须标注为 `当前项目未发现`，不得引用历史会话中的旧内容。
+- 旧沉淀按可接管、不接管、待确认分类；未确认内容不得写入正式规则。
+- 首次极速初始化不强制创建 `xinyun-ai/global-review/`。
+- 需求模糊、涉及改动或出现高风险词时，先做中文需求解析；普通咨询不强制输出完整解析结构。
+- 中文需求解析最多追问 1-3 个关键问题。

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

@@ -14,9 +14,80 @@ xinyun-ai/index/session-current.md
 - 不记录非项目内容、闲聊、敏感值。
 - 不记录完整搜索流水账，只记录关键文件、关键发现、待确认点、候选沉淀。
 - 如果发现旧 AI 沉淀，只记录来源路径、分类结果和是否可接管，不直接把旧内容写成事实。
+- 旧 AI 沉淀分类必须区分可接管、不接管、待确认；不存在路径标注 `当前项目未发现`。
+- 需求模糊、涉及改动或出现高风险词时，`session-current.md` 可记录中文需求解析结果，但普通咨询不强制输出完整解析结构。
+- 新功能、大改、重构、跨端、规则或索引调整时，`session-current.md` 可记录全局影响审视摘要；需要落盘时再按需创建 `xinyun-ai/global-review/`。
 - 会话结束前必须筛选：长期有价值的沉淀到正式目录；仅本轮有价值的写入 `sessions/`；无价值、误判、非项目内容不沉淀。
 - 筛选完成后更新 `index/project-index.json`。
 
 双会话任务单至少记录：`taskId`、`executionId`、`status`、`owner`、`attempt`、用户确认状态、允许修改文件、禁止修改范围、高风险操作、验证命令、验收标准和发现新影响范围后的暂停规则。
 
 双会话交接单至少记录：执行前 Git 或文件状态、实际修改文件、diff 摘要、测试结果、未完成事项、新风险和是否存在超范围修改。
+
+状态机至少包含：待确认、待执行、执行中、暂停待复核、待主会话复核、已完成、失败、中断、超时、阻塞、取消、需重新确认。
+
+失败、中断、超时后不得自动重试。重试必须由主会话重新确认并增加 `attempt`，不能覆盖历史交接结果。
+
+## 临时执行任务单建议结构
+
+```md
+# 临时执行任务单
+
+- taskId：
+- executionId：
+- status：待确认 / 待执行 / 执行中 / 暂停待复核 / 待主会话复核 / 已完成 / 失败 / 中断 / 超时 / 阻塞 / 取消 / 需重新确认
+- owner：主会话
+- attempt：
+- 用户确认状态：
+- 创建时间：
+- 更新时间：
+
+## 允许修改文件
+
+## 禁止修改范围
+
+## 禁止执行的高风险操作
+
+## Git / 文件状态要求
+
+## 数据库 / API / UI / 配置影响
+
+## 验证命令
+
+## 验收标准
+
+## 发现新影响范围后的暂停规则
+```
+
+## 执行交接单建议结构
+
+```md
+# 执行交接单
+
+- taskId：
+- executionId：
+- status：待主会话复核 / 已完成 / 失败 / 中断 / 超时 / 阻塞 / 需重新确认
+- owner：执行会话
+- attempt：
+- 用户确认状态：
+- 创建时间：
+- 更新时间：
+
+## 执行前 Git 或文件状态
+
+## 实际修改文件
+
+## diff 摘要
+
+## 测试结果
+
+## 未完成事项
+
+## 新风险
+
+## 是否存在超范围修改
+
+## 是否执行过高风险操作
+
+## 是否发现新影响范围
+```

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

@@ -20,7 +20,13 @@
 - `AGENTS.md` 是否明确 `xinyun-ai/` 为当前项目 AI 规则入口。
 - 旧 AI 规则路径不存在时，是否标注为 `当前项目未发现`，并停止引用旧会话内容。
 - 旧 AI 沉淀是否需要接管、分类和整合进 `xinyun-ai/`。
+- 旧沉淀是否按可接管、不接管、待确认分类，未确认内容是否没有进入正式规则。
+- 规则优先级是否为 `xinyun-ai/` 当前正式规则 > 当前文件系统事实 > 旧 AI 文档 > 历史会话记忆。
+- 是否需要补充中文需求解析和任务分型规则。
+- 是否需要补充 `xinyun-ai/global-review/` 按需创建规则。
 - 是否需要补充轻量框架适配识别规则。
 - 当前 `xinyun-ai/manifest.json` 的版本是否低于初始化包版本。
 
 涉及正式规则、目录结构、索引结构或旧规则合并时，必须先确认。
+
+升级不自动迁移全部旧 AI 文档，不会自动覆盖现有正式规则，也不会因为补充全局审视规则而在首次极速初始化阶段强制创建全局审视目录。

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

@@ -6,6 +6,8 @@
 
 如果旧规则路径在当前文件系统中不存在，必须标注为 `当前项目未发现`，不得引用历史会话中的旧内容。如旧规则与 `xinyun-ai/` 冲突，以 `xinyun-ai/` 为准。
 
+规则优先级：`xinyun-ai/` 当前正式规则 > 当前文件系统事实 > 旧 AI 文档 > 历史会话记忆。历史会话记忆不得覆盖当前文件系统事实，也不得补写文件系统中不存在的旧规则路径。
+
 ## 旧沉淀接管
 
 如果项目中已经存在旧 AI 沉淀，如旧 `AGENTS.md`、`docs/`、`CLAUDE.md`、`.cursor/`、旧提示词、旧规则文件或旧工作台记录，AI 应先梳理这些内容，再把有长期价值的部分整合进 `xinyun-ai/`。
@@ -14,6 +16,8 @@
 
 临时聊天、无关内容、明显过期内容和无法确认的内容不进入正式沉淀；不存在的旧路径必须标注为 `当前项目未发现`。
 
+旧 AI 沉淀必须先识别、再分类、再接管。分类为：可接管、不接管、待确认。未确认内容不得直接写入正式规则；本包只做规则和模板接管，不创建自动迁移脚本，不自动覆盖现有正式规则。
+
 ## 改动计划与执行确认
 
 任何代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程修改前，AI 必须先输出改动计划，并等待用户明确确认。
@@ -22,7 +26,7 @@
 
 未确认前，只允许读取、分析、定位问题、输出方案；禁止 `apply_patch`、重写文件、格式化、自动修复、migration、seed、SQL、配置修改和任何会产生文件变化或业务副作用的命令。
 
-改动计划至少说明：修改目标、需求理解、影响范围、预计修改文件、数据库 / SQL / 测试数据、执行步骤、验证方式、风险点和等待确认。
+改动计划至少说明：修改目标、需求理解、影响范围、预计修改文件、数据库 / SQL / 测试数据、API / UI / 配置影响、前端改动模式、页面类型、页面文案预算、Git 模式、执行步骤、验证方式、风险点和等待确认。
 
 简单小改可以合并字段，但不得省略影响范围、预计修改文件、数据库 / API / UI / 配置影响、验证方式和风险点。
 
@@ -30,16 +34,72 @@
 
 说明：用户发送 `xinyun-ai-init` 一句话入口后，视为已授权 AI 创建或补齐最小 `xinyun-ai/` 与本入口文件；该授权不包含业务代码、配置、数据库、API、UI 或业务流程修改。
 
+执行过程中发现新增影响范围、计划外文件、计划外数据库 / API / UI / 配置影响、计划外高风险操作或验收标准变化时，必须暂停并重新确认。
+
+## 中文需求解析与任务分型
+
+需求模糊、涉及改动或出现高风险词时，先做中文需求语义规范化；普通咨询不强制输出完整解析结构。
+
+解析格式：
+
+```md
+## 中文需求解析
+
+- 用户原话：
+- AI 理解：
+- 任务类型：
+- 影响对象：
+- 可能涉及：
+- 不确定点：
+- 风险词：
+- 是否需要追问：
+- 下一步处理方式：
+```
+
+任务类型至少包括：问题排查、新功能开发、UI 调整、API / 接口调整、数据库 / SQL、商业逻辑、Git / 发布、文档沉淀、规则调整、临时咨询。
+
+高歧义表达包括：优化一下、处理一下、不对、怪怪的、照之前、顺便、差不多、参考一下。
+
+高风险词包括：订单、支付、退款、优惠券、会员、权益、金额、积分、分润、提现、结算、权限、删除、批量、发布、回滚。
+
+高歧义需求最多追问 1-3 个关键问题；高风险词触发更严格的业务理解、问题排查、Git / 发布门禁或 SQL 提醒，不得直接进入代码修改。
+
 ## 前端与 Git 安全边界
 
 前端组件调用、框架 API 和交互能力优先使用官方组件、官方 API、官方推荐写法或项目已有封装。微信小程序、uni-app、Vue2、Vue3、React 等框架中，能用官方能力解决的，不优先引入第三方组件或自造工具。
 
 确需第三方库、自定义组件或自造工具时，必须先说明原因、影响范围和替代方案，并等待用户确认。
 
+前端 UI 改动必须标注改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及。
+
+页面类型必须标注为：生产页面 / 原型页面 / 营销页面 / 不涉及。
+
+生产页面默认采用克制文案。未明确要求时，不添加功能介绍、设计解释、营销式或教程式占位文案，不出现“本页面用于……”等泛化说明，不默认使用“智能、高效、便捷、全方位”等泛化表达。
+
+标题、按钮、字段、状态、错误提示使用真实业务表达，围绕用户任务、业务数据和操作结果。允许保留高风险操作、空状态、异常状态所必需的提示。原型页面和营销页面可以使用说明性文案，但不能默认套用到生产页面。
+
 如果项目使用 Git，AI 必须识别单仓库 / 多仓库 / 混合仓库 / 无 Git 模式，并在改动计划中说明涉及仓库、当前分支、工作区是否干净、是否建议新分支、是否建议拆分 commit、是否涉及 tag / 发布。
 
 未获用户明确确认前，AI 不得自动执行 `commit`、`tag`、`push`、`pull`、`merge`、`rebase`、`reset`、`checkout` 回滚或切分支。
 
+复杂改动可使用双会话执行闭环。主会话负责理解中文需求、识别任务类型和影响范围、生成改动计划、等待用户确认、生成执行任务单、复核执行结果并输出最终交付结论。执行会话负责读取任务单、只在确认范围内执行、进行必要验证、输出执行交接单、不创建第三个会话、不自行扩大范围。
+
+双会话文件契约：`xinyun-ai/current-task.md` 由主会话维护；`xinyun-ai/index/session-current.md` 是主会话创建的临时执行任务单，执行会话只读；`xinyun-ai/handoffs/current-execution.md` 是执行会话写入的执行交接单，主会话只读复核。
+
+任务单和交接单必须记录 `taskId`、`executionId`、`status`、`owner`、`attempt`、用户确认状态、创建时间和更新时间。失败、中断、超时后不得自动重试；重试必须由主会话重新确认并增加 `attempt`，不能覆盖历史交接结果。
+
+交付输出先给状态结论：已完成 / 部分完成 / 阻塞 / 需重新确认；说明实际创建、更新、未创建或未修改内容、验证结果、风险、未完成事项和下一步动作。少复述规则，不输出明显 AI 话术。
+
+## 全局影响审视
+
+新功能、大改、重构、跨端改动、目录 / 规则 / 索引调整、数据库 / API / UI 联动变更、涉及多会话交接的复杂任务，必须先做全局影响审视。
+
+小改可以只在改动计划中简写全局影响；首次极速初始化不强制创建 `xinyun-ai/global-review/`。
+
+全局审视最小字段包括：`reviewId`、触发原因、关联任务、影响层、已确认内容、推断内容、待确认内容、风险点、后续动作、创建时间、更新时间。
+
+需要落盘时按需创建或更新 `xinyun-ai/global-review/`、`xinyun-ai/global-review/index.json`，并同步 `xinyun-ai/index/project-index.json`。全局审视不代替改动计划，也不会授权 AI 直接修改业务代码。
+
 AI 接手本项目时，请先读取：
 
 - `xinyun-ai/README.md`

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

@@ -7,6 +7,8 @@
 - 旧 AI 文档、旧 docs、旧提示词、旧规则文件只作为历史线索，不作为执行依据。
 - 如果旧规则路径在当前文件系统中不存在，必须标注为 `当前项目未发现`，不得引用历史会话中的旧内容。
 - 如旧规则与 `xinyun-ai/` 冲突，以 `xinyun-ai/` 为准。
+- 规则优先级：`xinyun-ai/` 当前正式规则 > 当前文件系统事实 > 旧 AI 文档 > 历史会话记忆。
+- 历史会话记忆不得覆盖当前文件系统事实，也不得补写文件系统中不存在的旧规则路径。
 
 ## 旧沉淀接管
 
@@ -15,6 +17,12 @@
 - 临时聊天、无关内容、明显过期内容和无法确认的内容不进入正式沉淀。
 - 不存在的旧路径必须标注为 `当前项目未发现`。
 - 旧沉淀接管完成后，仍以 `xinyun-ai/` 为唯一正式入口。
+- 旧 AI 沉淀必须按“先识别、再分类、再接管”的顺序处理。
+- 接管分类为：可接管、不接管、待确认。
+- 可接管内容：项目导读、规则入口、需求沉淀、问题记录、框架线索、当前任务线索、可复用经验候选。
+- 不接管内容：临时聊天、普通闲聊、无关内容、明显过期内容、无法确认来源的结论、敏感信息。
+- 待确认内容：来源不明、与当前项目文件冲突、无法验证或需要用户判断的内容。
+- 未确认内容不得直接写入正式规则；本包只做规则和模板接管，不创建自动迁移脚本，不自动覆盖现有正式规则。
 
 ## 初始化授权边界
 
@@ -28,6 +36,7 @@
 - 未确认前，只允许读取、分析、定位问题、输出方案；禁止 `apply_patch`、重写文件、格式化、自动修复、migration、seed、SQL、配置修改和任何会产生文件变化或业务副作用的命令。
 - 用户确认计划后，AI 才能在计划范围内执行。
 - 确认后只改确认范围内的文件，不顺手重构、不顺手格式化无关文件。
+- 执行过程中发现新增影响范围、计划外文件、计划外数据库 / API / UI / 配置影响、计划外高风险操作或验收标准变化时，必须暂停并重新确认。
 
 标准改动计划：
 
@@ -46,8 +55,11 @@
 - 是否影响 UI：
 - 是否影响配置：
 - 前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及
+- 页面类型：生产页面 / 原型页面 / 营销页面 / 不涉及
+- 页面文案预算：
 - Git 模式：单仓库 / 多仓库 / 混合仓库 / 未发现
 - Git 影响范围：
+- 用户确认状态：
 
 ## 4. 预计修改文件
 
@@ -69,10 +81,41 @@
 
 - 涉及功能、业务流程、API、数据库、页面、组件、交互或样式时，出计划前先做轻量需求理解。
 - 信息不足时，最多问 1-3 个关键问题。
+- 需求模糊、涉及改动或出现高风险词时，先做中文需求语义规范化；普通咨询不强制输出完整解析结构。
+- 中文需求解析格式必须保留用户原话，并包含 AI 理解、任务类型、影响对象、可能涉及、不确定点、风险词、是否需要追问和下一步处理方式。
+- 任务类型至少包括：问题排查、新功能开发、UI 调整、API / 接口调整、数据库 / SQL、商业逻辑、Git / 发布、文档沉淀、规则调整、临时咨询。
+- 高歧义表达包括：优化一下、处理一下、不对、怪怪的、照之前、顺便、差不多、参考一下。
+- 高风险词包括：订单、支付、退款、优惠券、会员、权益、金额、积分、分润、提现、结算、权限、删除、批量、发布、回滚。
+- 高歧义需求最多追问 1-3 个关键问题；信息足够时直接进入对应任务流程。
+- 高风险词触发更严格的业务理解、问题排查、Git / 发布门禁或 SQL 提醒，不得直接进入代码修改。
+
+中文需求解析格式：
+
+```md
+## 中文需求解析
+
+- 用户原话：
+- AI 理解：
+- 任务类型：
+- 影响对象：
+- 可能涉及：
+- 不确定点：
+- 风险词：
+- 是否需要追问：
+- 下一步处理方式：
+```
+
 - UI 类需求至少判断前端改动模式：样式微调 / 新页面 / 页面重写 / 组件重构 / 不涉及。
+- UI 类需求还必须判断页面类型：生产页面 / 原型页面 / 营销页面 / 不涉及。
 - 如果当前 AI 工具有需求分析、原型、UI 交互、截图风格识别等 Skill，仅在任务明确匹配时调用对应 Skill；不得因为普通开发任务默认启用所有 Skill。
 - 样式微调应优先局部修改，不重写页面结构。
 - 新页面或页面重写必须先说明页面结构方案，且不得顺手修改无关页面。
+- 生产页面默认采用克制文案。未明确要求时，不添加功能介绍、设计解释、营销式或教程式占位文案，不出现“本页面用于……”等泛化说明，不默认使用“智能、高效、便捷、全方位”等泛化表达。
+- 标题、按钮、字段、状态、错误提示使用真实业务表达，围绕用户任务、业务数据和操作结果。
+- 允许保留高风险操作、空状态、异常状态所必需的提示。
+- 改动计划中应给出页面文案预算，说明新增文案的用途和大致数量。
+- 原型页面和营销页面可以使用说明性文案，但不能默认套用到生产页面。
+- 去 AI 化验收标准：删除非必要说明后核心操作仍清楚；交付页面不出现明显 AI 话术；页面中不出现规则复述、教程式自我说明或与业务无关的占位文案。
 - 普通聊天、临时咨询、无长期价值排查不沉淀。
 
 ## 前端官方组件与 API 优先
@@ -98,6 +141,8 @@
 - 输出中区分 `已确认`、`推断`、`待确认`、`未在项目中发现`。
 - 回复先给结论，再给依据路径，再给待确认问题。
 - 不沿用用户已经纠正或否定的旧方向。
+- 不做无关全量扫描，不把旧规则、旧路径或历史会话内容直接当作当前事实。
+- 少复述规则，多输出当前任务可直接使用的结论、计划、交接结果或下一步动作。
 
 ## Git 工作区与危险操作门禁
 
@@ -138,6 +183,11 @@
 - 需要落盘时按需创建或更新 `xinyun-ai/global-review/`。
 - 全局审视不代替改动计划，它是改动计划前的影响检查。
 - 建议审视入口层、目录层、索引层、任务层、规则层、多端层、数据层、API 层、UI 层、验证层和交接层。
+- 首次极速初始化不强制创建 `xinyun-ai/global-review/`。
+- 触发条件包括：新功能、大范围修改、重构、跨端改动、目录 / 规则 / 索引调整、数据库 / API / UI 联动变更、涉及多会话交接的复杂任务。
+- 全局审视最小字段包括：`reviewId`、触发原因、关联任务、影响层、已确认内容、推断内容、待确认内容、风险点、后续动作、创建时间、更新时间。
+- 创建或更新全局审视后，应同步 `xinyun-ai/global-review/index.json` 和 `xinyun-ai/index/project-index.json`。
+- 全局审视不会授权 AI 直接修改业务代码。
 
 ## 双会话执行闭环（MVP）
 
@@ -148,13 +198,30 @@
 - `xinyun-ai/index/session-current.md` 是主会话创建的临时执行任务单，执行会话只读；该文件不再仅作为普通会话线索。
 - `xinyun-ai/handoffs/current-execution.md` 是执行会话写入的执行交接单，主会话只读复核。
 - 任务单和交接单必须记录 `taskId`、`executionId`、`status`、`owner`、`attempt`、用户确认状态、创建时间和更新时间。
-- 任务单必须记录允许修改文件、禁止修改范围、禁止执行的高风险操作、验证命令、验收标准、发现新影响范围后的暂停规则。
-- 交接单必须记录执行前 Git 或文件状态、实际修改文件、diff 摘要、测试结果、未完成事项、新风险、是否存在超范围修改。
+- 任务单必须记录允许修改文件、禁止修改范围、禁止执行的高风险操作、验证命令、验收标准、发现新影响范围后的暂停规则、Git 模式、涉及仓库、当前分支、工作区状态、数据库 / API / UI / 配置影响。
+- 交接单必须记录执行前 Git 或文件状态、实际修改文件、diff 摘要、测试结果、未完成事项、新风险、是否存在超范围修改、是否执行过高风险操作、是否发现新影响范围。
 - 状态机至少包含：待确认、待执行、执行中、暂停待复核、待主会话复核、已完成、失败、中断、超时、阻塞、取消、需重新确认。
 - 失败、中断、超时后不得自动重试；重试必须由主会话重新确认并增加 `attempt`，不能覆盖历史交接结果。
 - MVP 边界：单项目、单活动任务、一个主会话、一个执行会话、本地文件手工交接、暂不支持第三个会话、暂不接入 n8n、暂不自动创建外部 AI 会话。
 - 改动计划与执行确认规则负责用户确认门禁；双会话执行闭环负责任务分派、执行和交接。
 
+人工启动第二会话：
+
+1. 主会话在用户确认改动计划后创建或更新 `xinyun-ai/index/session-current.md`。
+2. 用户手工新建或打开执行会话，把任务单路径和执行要求交给执行会话。
+3. 执行会话读取任务单，只在允许范围内执行。
+4. 执行会话完成后写入 `xinyun-ai/handoffs/current-execution.md`。
+5. 用户把执行结果或交接单路径回传给主会话。
+6. 主会话复核交接单、diff、验证结果和风险后，输出最终交付结论。
+
+## 交付输出
+
+- 先给状态结论：已完成 / 部分完成 / 阻塞 / 需重新确认。
+- 说明实际创建、更新、未创建或未修改的内容。
+- 说明验证命令和结果；未验证时说明原因。
+- 说明风险、未完成事项和下一步动作。
+- 少复述规则，不输出明显 AI 话术，不把原型说明文案带入生产页面。
+
 ## 自我学习
 
 发现可复用经验时，先记录为候选经验。候选经验必须标注来源、适用范围、可信度、状态和最后验证时间。用户确认后，才能合并进正式规则。

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

@@ -2,14 +2,34 @@
 
 - 状态：初始化
 - 用户原始需求：
+- 中文需求解析：
+  - 用户原话：
+  - AI 理解：
+  - 任务类型：
+  - 影响对象：
+  - 可能涉及：
+  - 不确定点：
+  - 风险词：
+  - 是否需要追问：
+  - 下一步处理方式：
 - 当前任务理解：
 - 影响端：
 - 是否影响数据库 / API / UI / 配置：
+- 前端改动模式：
+- 页面类型：
+- 页面文案预算：
 - 待确认问题：
 - 改动计划摘要：
+- 用户确认状态：
 - SQL 执行提醒：
 - 商业逻辑 / 变现流程提醒：
 - 全局影响审视：
+  - reviewId：
+  - 是否触发：
+  - 触发原因：
+  - 已确认内容：
+  - 推断内容：
+  - 待确认内容：
 - Git 模式与仓库影响：
 - 前端官方组件 / API 选型：
 - 双会话执行：
@@ -18,8 +38,17 @@
   - owner：
   - attempt：
   - 用户确认状态：
+  - status：
   - 执行任务单：
   - 执行交接单：
+- 交付状态：
+- 未完成事项：
+- 下一步动作：
 - 验证结果：
 - 旧沉淀接管：
+  - 来源清单：
+  - 可接管：
+  - 不接管：
+  - 待确认：
+  - 不存在路径：
 - 本轮沉淀位置：

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

@@ -1,7 +1,7 @@
 {
   "projectName": "",
-  "xinyunAiVersion": "1.1.6",
-  "scriptVersion": "2026.07.15",
+  "xinyunAiVersion": "1.3.0",
+  "scriptVersion": "2026.07.16",
   "schemaVersion": "1",
   "initializationMode": "fast",
   "expansionMode": "triggered",
@@ -19,6 +19,13 @@
     "confirmationGate": true,
     "legacyRuleHandoff": true,
     "lightFrameworkDetection": true,
-    "focusedSearchResponse": true
+    "focusedSearchResponse": true,
+    "safeExecutionGate": true,
+    "restrainedProductionCopy": true,
+    "doubleSessionMvp": true,
+    "unifiedEntryPriority": true,
+    "legacyHandoffClassification": true,
+    "globalReview": true,
+    "chineseRequirementParsing": true
   }
 }

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

@@ -19,6 +19,11 @@
 - 旧 AI 沉淀来源：待填写
 - 可接管内容：待填写
 - 不接管内容：待填写
+- 待确认内容：待填写
+- 不存在的旧路径：待填写
+- 规则入口优先级：待填写
+- 中文需求解析触发情况：待填写
+- 全局影响审视触发情况：待填写
 - 轻量框架识别：待填写
 
 ## 待确认问题