xuanzhu 0.8.5 → 0.8.7

package/README.md

@@ -341,7 +341,7 @@ xzh model remove openai/gpt-4o         # 删除（id / 模型名 / 序号 / 别
   实测中用户只发了句「在吗」，它却接着去起服务、查凭据。
 
 > 裁剪依据是**估算**的 token 数（中文约 1 字符/token，英文与代码约 3.5 字符/token），
-> 不依赖 tokenizer，属保守近似。项目规则（`.xuanzhu/rules.md`）与 `systemPromptExtra`
+> 不依赖 tokenizer，属保守近似。项目规则（`AGENTS.md`）与 `systemPromptExtra`
 > 会全文进入系统提示词，写得过长会挤占历史额度 —— 占去窗口一半以上时界面会给出提示。
 >
 > 估算偏差还会被**真实用量回填**逐步校正：每次请求结束后，玄猪拿服务端返回的
@@ -779,14 +779,14 @@ AutoX.js 那侧也可用环境变量 `XZH_DEVICE_PORT` 指定端口。
 
 ## 项目目录（.xuanzhu/）
 
-首次在某个项目中运行 `xzh` 时，会在项目根自动创建 `.xuanzhu/`，用于保存**项目级记忆与规则**
-（对应 CodeBuddy 的 `.codebuddy/memory/`）：
+首次在某个项目中运行 `xzh` 时，会在项目根自动创建 `.xuanzhu/` 保存**项目级记忆**；
+项目规范使用根目录 `AGENTS.md`，只在用户执行 `xzh init` 且文件不存在时创建：
 
 | 路径 | 用途 |
 | --- | --- |
 | `.xuanzhu/memory/MEMORY.md` | 长期记忆：**按主题整理的结论库**（稳定事实、口径与踩坑），启动时会注入系统提示词（节选） |
 | `.xuanzhu/memory/YYYY-MM-DD.md` | 每日日志：按天追加的进展与过程记录 |
-| `.xuanzhu/rules.md` | 项目规则，内容作为「项目级指令」注入系统提示词。**首次初始化时若项目根已有 `AGENTS.md`**，则写入一条「必须严格按照 `AGENTS.md` 执行」的指令（而非复制其内容）—— 这样 `AGENTS.md` 始终是唯一真实来源，你改完它模型下次读取即是新版 |
+| `AGENTS.md` | 项目根的项目规范；**内容会直接注入系统提示词**（不再只让模型“记得去读”），大小写兼容 |
 
 记忆由玄猪自行维护：
 
@@ -888,7 +888,8 @@ v2ray / Clash / mihomo / sing-box **本地 SOCKS/HTTP 入站端口**，验证后
 
 | 文件 | 内容 |
 | --- | --- |
-| `AGENTS.md` | 入口级：项目概览、常用命令、两层目录树、开发约定、文档索引（保持精简） |
+| `AGENTS.md` | **只放入口级大纲**：项目概览、关键命令、顶层目录、必守约定、文档索引；完整内容放 `docs/` |
+| `docs/README.md` | 文档索引：AGENTS.md 与 `docs/` 各文件的对应关系 |
 | `docs/ARCHITECTURE.md` | 目录结构、模块概览、入口与运行方式；无法确定的部分标注「待补充」 |
 | `docs/COMMANDS.md` | 命令表 + `package.json` scripts 原始内容（有命令时才生成） |
 | `docs/CONVENTIONS.md` | 从配置文件探测到的风格与工程约定（有配置时才生成） |
@@ -899,12 +900,24 @@ v2ray / Clash / mihomo / sing-box **本地 SOCKS/HTTP 入站端口**，验证后
 | `xzh init --dry-run` | 只打印变更计划与预览，不写任何文件 |
 | `xzh init --force` | 整体覆盖已有规范文件（覆盖前写 `.bak-<时间戳>` 备份） |
 | `xzh init --yes` | 跳过确认（脚本 / CI） |
-| `/init` | 对话内执行（写入前弹确认框；支持 `/init --dry-run`、`/init --force`） |
+| `/init` | 对话内执行：先搭建框架，再调用模型完善 AGENTS.md/docs（支持 `/init --dry-run`、`/init --force`） |
 
 - **幂等**：再次运行内容无变化时不写盘，只报「已是最新」；
 - **不自动「修正」**：已有同名小节一律保留（不改写团队手写约定），只补缺失部分；
-- **不在进入项目时自动执行**：启动保持只读；需要时手动运行，避免每次启动都扫描、写文件。
-- 已有的 `.xuanzhu/rules.md` 会在项目根存在 `AGENTS.md` 时要求模型严格遵循它，因此生成的规范会直接影响后续对话 —— 请像维护代码一样维护它。
+- **不在进入项目时自动扫描/生成**：`xzh init` 需要手动运行；启动不会创建 `AGENTS.md`，也不会扫描仓库。
+- 项目根 `AGENTS.md` 会**直接注入系统提示词**；启动不会创建它，只有 `xzh init` 在文件不存在时生成入口模板。请像维护代码一样维护它。
+
+## 对话内 `/init` 的模型完善
+
+- **`xzh init`（命令行）**：只做确定性框架搭建——扫描项目，创建 AGENTS.md 与 `docs/`，
+  不调用模型；已有文件只补缺失小节。
+- **`/init`（对话内）**：先执行同样的确定性框架，再调用当前模型，根据扫描事实与现有
+  AGENTS/docs 整理入口大纲和详细文档：
+  - AGENTS.md 仍只保留入口大纲，尽量简短；
+  - 缺失的 `docs/` 文件会补齐，模型可同步更新对应 docs；
+  - 写入前展示预览并确认，覆盖文件前自动备份；
+  - 模型失败不会破坏已写入的初始框架，可稍后再次 `/init`；
+  - 强制保留「文档同步」小节：代码改动同步到 AGENTS/docs，md 设计变化需额外告知用户。
 
 ## 内置技能