xuanzhu 0.4.5 → 0.5.0

package/README.md

@@ -30,6 +30,8 @@ xzh                 # 启动
 - **默认全自动**：`autoApprove` 默认为 `true`，**所有工具都直接执行、不做任何确认** —— 包括写文件、执行命令、读取工作区之外的文件，以及读取凭据类文件（`~/.ssh`、`.env`、`~/.xzh/config.json` 等）。开箱即用，不打断。`/auto off` 可切换为写文件与执行命令逐项确认。
   - 如果希望读取凭据类文件时确认一次（防止密钥被读进上下文后转交给模型服务商），把 `confirmSensitiveRead` 设为 `true`，默认关闭。
 - **多轮自主执行**：自动串联工具调用完成任务，可随时 `Ctrl+C` 中断。
+- **目标模式（`/goal`）**：设一个目标，玄猪会持续自动推进（每轮答复后立刻继续），
+  直到它调用 `goal_complete` 声明完成 —— 中途不需要你再发「继续」（见「目标模式」）。
 - **任务拆分**：3 步以上的复杂任务会先用 `todo_write` 列出计划并逐步更新，
   顶部信息区实时显示进度条（`任务 2/5` 与当前进行项）。
 - **子代理协作（可并行）**：需要大范围调研（跨多个文件 / 目录 / 命名约定）时，用 `task`
@@ -359,6 +361,7 @@ API Key 也可以来自环境变量，优先级低于配置文件：
 | `memory_write` | 写入项目记忆（长期记忆 / 当日日志），长期记忆超限时自动精简 | 否 |
 | `memory_compact` | 用精简后的完整内容重写长期记忆（把新结论并入主题小节 / 语义压缩） | 否 |
 | `todo_write` | 创建 / 更新任务列表（每次提交完整列表） | 否 |
+| `goal_complete` | 目标模式（`/goal`）下声明目标已全部完成（仅主代理可用） | 否 |
 | `task` | 派生子代理（默认 `code-explorer`）执行子任务，只返回结论；一轮内多个调用**并行**执行 | 否 |
 | `read_file` | 读取文件（带行号，支持偏移与行数限制） | 否 |
 | `list_dir` | 列出目录内容 | 否 |
@@ -407,8 +410,8 @@ API Key 也可以来自环境变量，优先级低于配置文件：
 | `prompt` | 交给子代理的完整任务描述。**子代理看不到主对话**，必须自包含；`code-explorer` 还应在其中写明探索力度（`quick` / `medium` / `very thorough`） |
 | `subagent_name` | 要派生的子代理名称，默认 `code-explorer` |
 
-约束：子代理恒不提供 `task`（禁止无界递归）、`todo_write` 与 `memory_write` / `memory_compact`
-（任务列表与记忆由主代理统一维护）。它的工具活动以 `[code-explorer: <任务说明>]` 前缀显示在
+约束：子代理恒不提供 `task`（禁止无界递归）、`todo_write`、`goal_complete` 与
+`memory_write` / `memory_compact`（任务列表、目标与记忆由主代理统一维护）。它的工具活动以 `[code-explorer: <任务说明>]` 前缀显示在
 输出区 —— 并行时会交错，前缀里的任务说明用于区分是谁在输出；危险操作确认仍会转发给你
 （并行时多个确认会**排队**逐个弹出，不会互相覆盖）。
 
@@ -440,6 +443,33 @@ API Key 也可以来自环境变量，优先级低于配置文件：
   `memory_compact` 做语义压缩：`memory_write` 的返回里会直接给出提示，系统提示词也会带
   「⚠ 长期记忆仍然过长」段落。
 
+## 目标模式（`/goal`）
+
+`/goal <目标>` 让玄猪进入**目标模式**：设定之后它会**持续自动推进**，每轮给出答复后立刻继续，
+直到它调用 `goal_complete` 声明目标完成 —— 不需要你再发「继续」。
+
+```
+/goal 把项目里所有 console.log 换成统一 logger，并跑通测试
+```
+
+| 命令 | 说明 |
+| --- | --- |
+| `/goal <目标>` | 设定目标并**立即开始**自动执行（重复使用会替换原目标） |
+| `/goal` / `/goal status` | 查看当前目标、状态（执行中 / 已暂停 / 已完成）与已执行轮数 |
+| `/goal continue` | 继续一个已暂停的目标（别名 `resume` / `go`） |
+| `/goal off` | 清除目标（别名 `stop` / `clear` / `cancel`） |
+
+- **何时结束**：模型调用 `goal_complete`（要求说明做了什么、如何验证）。目标确实做不下去时
+  （缺凭据、外部依赖不可用）它也应当调用它并写明阻塞原因，而不是无限空转。
+- **随时可停**：`Ctrl+C`（或 `Ctrl+D`）中断当前轮并暂停循环，**目标会保留**；
+  输入 `/goal continue` 接着跑，`/goal off` 清除。
+- **进度可见**：顶部信息区与状态栏显示 `◎goal`、目标与当前轮次；多步任务仍由 `todo_write`
+  维护清单，自动继续时会带着清单提示模型「从没做完的地方接着做」。
+- **安全阀**：最多自动继续 40 轮，到上限会暂停并提示（避免目标本身含糊时无限烧 token）。
+- **确认框仍然生效**：目标模式**不会**自动打开 `/auto`。未开启自动批准时，写文件 / 执行命令
+  仍会弹确认，确认后循环继续；想全程无人值守请先 `/auto on`。
+- `/reset`、`/resume`、`/switch` 会清掉当前目标（它们替换了目标所依赖的对话上下文）。
+
 ## 图片输入（Ctrl+V）
 
 在输入框按 **Ctrl+V**（或 `/image`、`/paste`）会把**系统剪贴板里的图片**加为本轮附件，
@@ -720,7 +750,7 @@ description: 一句话说明该技能的用途与适用场景
 kitty / Ghostty 会把该 xterm 兼容序列映射成「所有按键都用转义码上报」而破坏普通输入，
 故玄猪对这两类终端不发送请求，请改用 `Alt+Enter` 或在终端侧自行配置。
 
-界面内命令：`/help`、`/clear`、`/tools`、`/device`、`/image`（`/paste`）、`/copy [N|A-B|last|all]`、`/mouse`、`/reset`、`/undo`、`/resume [编号]`、`/cwd`、`/switch <目录>`、`/term`、`/model [编号|id|模型名]`、`/auto [on|off]`、`/intent [on|off]`、`/exit`。
+界面内命令：`/help`、`/clear`、`/tools`、`/device`、`/image`（`/paste`）、`/copy [N|A-B|last|all]`、`/mouse`、`/reset`、`/undo`、`/resume [编号]`、`/cwd`、`/switch <目录>`、`/term`、`/model [编号|id|模型名]`、`/goal <目标>`（`/goal [status|continue|off]`）、`/auto [on|off]`、`/intent [on|off]`、`/exit`。
 
 ### 选中与复制