dsh-composer-plus 1.16.1 → 1.18.0

package/README.zh.md

@@ -29,7 +29,7 @@ dsh plugin --profile web add dsh-composer-plus
 
 然后重启 dsh。（CLI 无法安装到桌面版 profile 中；桌面版 profile 由应用自己管理。）
 
-> dsh 使用的 pnpm 会跳过发布不到 24 小时的版本。刚发布新版本时，请加上版本号：`dsh-composer-plus@1.16.1`。
+> dsh 使用的 pnpm 会跳过发布不到 24 小时的版本。刚发布新版本时，请加上版本号：`dsh-composer-plus@1.18.0`。
 
 ## 功能
 
@@ -47,6 +47,7 @@ dsh plugin --profile web add dsh-composer-plus
 | **Shift+Tab 计划模式** | <a id="feature-plantoggle"></a>`Shift+Tab` 会在草稿开头添加 `/plan `（再按一次可移除）。如果对话已处于计划模式，`Shift+Tab` 会退出计划模式。 | <a href="assets/features/planToggle.webp"><img src="assets/features/planToggle.webp" width="160" alt="截图：Shift+Tab 计划模式"></a> |
 | **保持输入框焦点** | <a id="feature-keepfocus"></a>发送 `/` 命令或技能后，光标仍留在输入框中，你可以立即继续输入。对于输入命令后按 `Enter` 的键盘宏，这同样有效。dsh 在解析命令时会把输入框设为只读，浏览器随后会移除焦点。本功能会把焦点放回输入框，除非菜单、对话框或其他输入框正持有焦点。 | <a href="assets/features/keepFocus.webp"><img src="assets/features/keepFocus.webp" width="160" alt="截图：保持输入框焦点"></a> |
 | **问题卡片适应窗口** | <a id="feature-questionfit"></a>代理向你提问时，问题和答案在卡片中一起滚动，**跳过**和**提交**始终显示在底部。卡片使用窗口的高度（减去 200 px，留给对话标题和一部分对话），所以会随窗口变大变小。没有本功能时，dsh 把卡片限制在窗口的 60%（最多 520 px），并且只有答案可以滚动：较长的问题会把它自己的结尾、答案和按钮挤出卡片。 | <a href="assets/features/questionFit.webp"><img src="assets/features/questionFit.webp" width="160" alt="截图：问题卡片适应窗口"></a> |
+| **对话标题栏适应窗口** | <a id="feature-headerfit"></a>窗口较窄时，dsh 对话标题栏中的按钮（模式、子代理、后台任务、打开方式、分支标签和授权标签）不再互相遮挡。对话标题至少保留 120 px；放不下的按钮换到右侧的第二行，每个按钮仍可点击。所有内容能放在一行时（宽窗口），标题栏与 dsh 原样一致。没有本功能时，dsh 只压缩标题：有子代理和后台任务时，在较窄的对话栏中按钮会互相覆盖。即使关闭本开关，分支标签（**每个对话一个分支**）和授权标签（**本对话内允许**）也会让标题栏适应窗口。 | <a href="assets/features/headerFit.webp"><img src="assets/features/headerFit.webp" width="160" alt="截图：对话标题栏适应窗口"></a> |
 | **一键继续** | <a id="feature-continuebutton"></a>回合被停止、失败或中断后，空输入框会显示 **▶**。点击一次即可在现有对话的基础上继续，不需要在输入框中输入内容，也不会添加可见的对话消息（模型会收到一条简短的隐藏提示“从停止的地方继续”，因为部分提供商，例如 Claude，会拒绝以助手回复结尾的请求）。队列中的消息会保留：▶ 只继续被停止的任务，之后再运行队列。已完成的回合仍显示普通的发送按钮。 | <a href="assets/features/continueButton.webp"><img src="assets/features/continueButton.webp" width="160" alt="截图：一键继续"></a> |
 | **重启后继续** | <a id="feature-resumeafterrestart"></a>默认关闭：请在 **设置 → Composer Plus** 中开启。如果你在对话仍在运行时退出 dsh（或 dsh 被关闭），再次打开 dsh 后，该对话会自动继续，并使用与“一键继续”相同的隐藏提示。如果当时有目标轮次（`/goal`）正在运行，该目标会继续下一轮（dsh 每次启动时都会暂停目标，直到你恢复它们）。你停止的、已完成的或失败的对话不会继续。dsh 本身没有这项设置：它只会把这样的回合标记为已中断。 | <a href="assets/features/resumeAfterRestart.webp"><img src="assets/features/resumeAfterRestart.webp" width="160" alt="截图：重启后继续"></a> |
 | **队列拖拽排序** | <a id="feature-queuereorder"></a>排队的消息会带一个把手（⠿）。拖动它即可调整顺序，或者让把手获得焦点后按 `↑` / `↓`。按 `Esc` 取消。 | <a href="assets/features/queueReorder.webp"><img src="assets/features/queueReorder.webp" width="160" alt="截图：队列拖拽排序"></a> |
@@ -63,19 +64,25 @@ dsh plugin --profile web add dsh-composer-plus
 | **工作区树中的分支** | <a id="feature-branchtree"></a>设置 → Composer Plus → **工作区树中的分支**（默认关闭）。开启后，每个在 `<project>/.worktrees/` 中有 worktree 文件夹的分支都会作为所属项目内的一个项目显示；在 dsh 中选择 **视图选项** → **按工作区树** 即可看到嵌套结构。文件夹被删除的分支会从列表中移除，dsh 会在 **未分组** 下显示它的对话。当项目文件夹中某个对话的智能体创建并切换到一个分支（`git switch -c`、`git checkout -b`），且该文件夹没有未提交的改动时，项目文件夹会切回原来的分支，该分支获得自己的文件夹，对话也会移进去：副本在分支项目中打开并继续执行任务，旧对话被归档。列表会在启动时、每 30 秒、每轮结束后以及你回到窗口时检查。 | <a href="assets/features/branchTree.webp"><img src="assets/features/branchTree.webp" width="160" alt="截图：工作区树中的分支"></a> |
 | **下一条消息预测** | <a id="feature-nextprediction"></a>默认开启；可在 **设置 → Composer Plus** 中关闭。智能体完成一个回合后（被停止或失败的回合除外），空输入框会以灰色文字显示对你下一条消息的猜测，并带有 **按 Tab 接受** 提示。`Tab` 会把文字放入输入框，但不会发送。`Esc` 会在本回合隐藏它。开始输入也会隐藏它，新的回合会替换它。开关下方的 **模型** 菜单列出 dsh 自己的模型（与 dsh 模型菜单的列表相同）。默认选中 **dsh 默认**，它跟随 dsh 的默认模型。每完成一个回合会进行一次简短的模型调用。在 Tether 中，猜测显示在空输入框上方：轻点它即可放入输入框。 | <a href="assets/features/nextPrediction.webp"><img src="assets/features/nextPrediction.webp" width="160" alt="截图：下一条消息预测"></a> |
 | **输入时补全** | <a id="feature-typingcompletion"></a>默认关闭；可在 **设置 → Composer Plus** 中开启。输入时，光标后紧跟的灰色文字会显示你的消息可能的后续内容。`Tab` 会把它添加到消息中，但不会发送。`Esc` 会隐藏它。它只建议你自己接下来要写的话：不会回答你，也不会编造错误信息或名称。消息看起来已完整，或模型不确定时，不显示任何内容。继续输入灰色文字中接下来的字符时，它会保留，不会再次调用模型。它的开关下方有自己的 **模型** 菜单。第一项 **与“下一条消息预测”相同**（默认）使用 **下一条消息预测** 的模型；选择其他模型，就可以为每个功能使用不同的模型，例如为补全选择更快的模型。你每次输入停顿时，它都会调用一次模型，因此消耗的 token 比预测多得多：请选择快速、低成本的模型。输入斜杠命令、消息中带有文件标签，或光标不在末尾时，它不会运行。在 Tether 中，输入时剩余部分会显示在输入框上方：轻点它即可添加。 | <a href="assets/features/typingCompletion.webp"><img src="assets/features/typingCompletion.webp" width="160" alt="截图：输入时补全"></a> |
-| **优化提示词** | <a id="feature-promptimprove"></a>输入一个粗略的请求，然后点击模型菜单旁边的魔法棒（**优化提示词**）。一次模型调用会把它改写成更清晰的提示词：先写目标，有多个部分时列出简短的编号步骤，并写明要运行的检查。它会读取此对话（已回滚的消息除外）、项目的 README、AGENTS.md 和清单文件、已更改的文件以及文件名与你的用词匹配的文件，并保留你的语言。它从不编造文件名。新文本会替换你的草稿，但不会发送：阅读、修改后再按 `Enter`。`Cmd/Ctrl+Z` 一步即可恢复你的原文，该按钮（**撤销优化**）也可以。如果你在它处理时继续输入，你的新文本会保留。`Esc` 或再次点击可取消。它在设置中有自己的 **模型** 菜单（默认：**与对话的模型相同**）。不适用于斜杠命令或带文件标签的消息。在 Tether 中，魔法棒位于输入框旁边。 | <a href="assets/features/promptImprove.webp"><img src="assets/features/promptImprove.webp" width="160" alt="截图：优化提示词"></a> |
-| **目标检查** | <a id="feature-goalcheck"></a>用 `/goal` 开始一个目标。当智能体在自动轮次中把目标标记为完成时，目标要通过两项检查才会关闭。首先，项目的测试命令会在对话的文件夹中、按对话的沙箱模式运行。命令是你自己设置的，或者从 `package.json`、`Makefile`、`Cargo.toml`、`go.mod` 或 pytest 中找到的。如果智能体自己最新的一步就是该测试的成功运行，则不再重复运行。然后，一次不带工具的独立模型调用会阅读目标、此对话、`git status` 和测试结果。任一检查失败时，目标保持进行中，智能体会看到原因，下一轮继续。目标栏下方的一行（**目标检查**）显示测试和上次结果。**编辑** 可设置你自己的测试命令以及时间或 token 上限；超过上限时目标会变为受阻。**立即运行** 会运行检查但不关闭目标。它在设置中有自己的 **模型** 菜单（默认：**与对话的模型相同**）。你自己完成目标时，不做任何检查。 | <a href="assets/features/goalCheck.webp"><img src="assets/features/goalCheck.webp" width="160" alt="截图：目标检查"></a> |
-| **项目记忆** | <a id="feature-projectmemory"></a>默认关闭：请在 **设置 → Composer Plus** 中开启。每个项目文件夹都有自己的记忆，该项目之后的对话都会读取，就像 DS Bot 为每个 Bot 保存一份记忆。每个回合结束后，会用对话的模型调用一次，读取新消息（不含已回滚的消息），把你长期的偏好、决定和事实保存为简短笔记，并修改或删除旧笔记。智能体也可以自己保存、删除和搜索笔记（`memory_remember`、`memory_forget`、`memory_recall`）。笔记也可以是全局的：所有项目都会读取。新对话会在系统提示词中获得这些笔记；之后保存的笔记从下一个对话开始显示。文件是 dsh 主目录下的 Markdown（`storages/dsh-composer-plus/memory/`），绝不写入项目文件夹。 | <a href="assets/features/projectMemory.webp"><img src="assets/features/projectMemory.webp" width="160" alt="截图：项目记忆"></a> |
+| **优化提示词** | <a id="feature-promptimprove"></a>输入一个粗略的请求，然后点击模型菜单旁边的魔法棒（**优化提示词**）。一次模型调用会把它改写成更清晰的提示词：先写目标，有多个部分时列出简短的编号步骤，并写明要运行的检查。它会读取此对话（已回滚的消息除外）、项目的 README、AGENTS.md 和清单文件、已更改的文件以及文件名与你的用词匹配的文件，并保留你的语言。它从不编造文件名。新文本会替换你的草稿，但不会发送：阅读、修改后再按 `Enter`。`Cmd/Ctrl+Z` 一步即可恢复你的原文，该按钮（**撤销优化**）也可以。如果你在它处理时继续输入，你的新文本会保留。`Esc` 或再次点击可取消。它在设置中有自己的 **模型** 菜单（默认：**与对话的模型相同**）。对于 `/goal <objective>` 消息，它只改写目标，把它写成 **目标检查** 能够验证的完成条件：产出、必须通过的检查、要在对话中展示的证据、把无法完成的部分标记为未解决，以及同一障碍持续存在时停止。`/goal` 命令保持不变。不适用于其他斜杠命令、`/goal` 控制词（`clear`、`pause`、`resume`）或带文件标签的消息。在 Tether 中，魔法棒位于输入框旁边。 | <a href="assets/features/promptImprove.webp"><img src="assets/features/promptImprove.webp" width="160" alt="截图：优化提示词"></a> |
+| **目标检查** | <a id="feature-goalcheck"></a>用 `/goal` 开始一个目标。当智能体在自动轮次中把目标标记为完成时，目标要通过两项检查才会关闭。首先，项目的测试命令会在对话的文件夹中、按对话的沙箱模式运行。命令是你自己设置的，或者从 `package.json`、`Makefile`、`Cargo.toml`、`go.mod` 或 pytest 中找到的。如果智能体自己最新的一步就是该测试的成功运行，则不再重复运行。然后，一次不带工具的独立模型调用会阅读目标、此对话、`git status` 和测试结果。模型会用一张证据表回答：目标的每一部分都标为已验证、不正确或未解决，并附上证据和修正办法；只有每一部分都已验证时，目标才会关闭。任一检查失败时，目标保持进行中，智能体会看到每个未完成的部分及其证据和修正办法，下一轮继续。目标栏下方的一行（**目标检查**）显示测试、上次结果以及已验证的部分数量（将鼠标悬停在上面可查看表格）。**编辑** 可设置你自己的测试命令以及时间或 token 上限；超过上限时目标会变为受阻。token 上限也会计入该对话的子智能体。**立即运行** 会运行检查但不关闭目标。它在设置中有自己的 **模型** 菜单（默认：**与对话的模型相同**）。你自己完成目标时，不做任何检查。 | <a href="assets/features/goalCheck.webp"><img src="assets/features/goalCheck.webp" width="160" alt="截图：目标检查"></a> |
+| **在新对话中继续** | <a id="feature-handoffchat"></a>在侧边栏中右键点击对话（或打开它的 **…** 菜单）→ **在新对话中继续…**。调用一次该对话自己的模型，根据对话显示的内容写出交接说明：任务、产出、已完成、决定、未解决问题和下一步（工具调用及其结果是证据；你回滚的步骤不计入）。说明会在一个对话框中打开：阅读并修改它。**重新生成** 会写一份新说明。**开始新对话**（或 `Cmd/Ctrl+Enter`）会在同一项目中打开一个新对话，以该说明和旧对话的链接作为第一条消息；旧对话保持不变。当长对话已满或变慢，或者想第二天继续时，可以使用它。不会向项目写入任何内容。 | <a href="assets/features/handoffChat.webp"><img src="assets/features/handoffChat.webp" width="160" alt="截图：在新对话中继续"></a> |
+| **上下文明细** | <a id="feature-contextbreakdown"></a>右侧边栏 → `+` → **上下文**。该页面显示当前是什么在占用打开的对话的模型上下文，以及它占用了上下文窗口的多少：系统提示词、项目指令（AGENTS.md）、技能、你的消息、智能体回复和工具调用、工具结果（按工具）、MCP 结果（按服务器）、工具定义、压缩摘要和其他上下文说明，每项附令牌数和占比。点击某一部分可查看它的工具或服务器。它只读取对话日志（`/compact` 和回滚之后的状态），不调用模型；每个回合结束后以及点击 **刷新** 时会重新读取。可用它查看对话为何变慢或已满，例如一个很大的 MCP 工具结果或大量工具定义。 | <a href="assets/features/contextBreakdown.webp"><img src="assets/features/contextBreakdown.webp" width="160" alt="截图：上下文明细"></a> |
+| **计划步骤** | <a id="feature-plannedsteps"></a>默认关闭：请在 **设置 → Composer Plus** 中开启。智能体会获得工具 `plan_next_steps`：它可以在发出某条命令的同一条消息中，预先计划接下来的命令及其确切参数和条件，例如“构建通过后运行 `npm test`”。结果满足条件时，Composer Plus 会自行运行下一步，无需再次调用模型，因此长对话消耗的令牌更少。该步骤在对话中显示为一行简短说明“Composer Plus · Planned steps: ran `test` … without a model call”，随后是它的工具调用和结果。仅限 `bash`、`read`、`grep` 和 `glob` 步骤；审批、沙箱和受保护的文件照常作用于每一步。条件不满足、同时有两个步骤就绪、最后一步完成后以及你发送消息时，模型会重新作答。这个想法来自 HarnessMM（arXiv 2610.32813）。 | <a href="assets/features/plannedSteps.webp"><img src="assets/features/plannedSteps.webp" width="160" alt="截图：计划步骤"></a> |
+| **受保护的文件** | <a id="feature-protectedfiles"></a>默认开启。智能体自己的文件工具不能读取或更改与你的模式匹配的文件：对于 **读取和写入** 模式，对文件使用的 `read`、`read_image` 和 `grep` 会被拒绝；两种模式下 `write`、`edit` 和 `str_replace_editor` 都会被拒绝。智能体会看到原因，并被告知要问你。默认模式是 `.env*`、`*.pem` 和 `*.key`。设置 → Composer Plus → **受保护的文件**：添加一个模式（例如 `published/**` 或 `config/*.yml`），点击它的类型可在 **读取和写入** 与 **仅写入** 之间切换，用 ✕ 移除它，或点击 **使用默认值**。不含 `/` 的模式会匹配任意文件夹中的文件名。这是护栏，不是沙箱：shell 命令（`cat .env`）、脚本或 MCP 工具仍能访问该文件（见“限制”）。 | <a href="assets/features/protectedFiles.webp"><img src="assets/features/protectedFiles.webp" width="160" alt="截图：受保护的文件"></a> |
+| **禁止的命令** | <a id="feature-blockedcommands"></a>默认开启，列表为空。智能体的 shell 命令（`bash`、`pwsh`）不能运行与你的规则匹配的命令：**阻止** 规则会拒绝调用（智能体会看到原因，并被告知要问你），**先询问** 规则会显示 dsh 的审批卡片，只有你允许后命令才会运行。设置 → Composer Plus → **禁止的命令**：输入一条规则（例如 `npm publish`、`git push --force` 或 `ssh *192.168.2.19`），点击类型可在 **阻止** 与 **先询问** 之间切换，然后点击 **添加**；点击规则的类型可以更改它，用 ✕ 移除它。一条规则是一个命令名和必须按此顺序出现在它后面的词；`*` 匹配任意文本。它也能找到 `&&`、`;`、`\|` 之后，`$(…)`、`bash -c "…"` 或 `eval` 之中，以及 `sudo` 或 `env` 之后的命令。这是护栏，不是沙箱：变量（`$CMD`）、脚本文件或其他程序仍能运行该命令（见“限制”）。 | <a href="assets/features/blockedCommands.webp"><img src="assets/features/blockedCommands.webp" width="160" alt="截图：禁止的命令"></a> |
+| **任务看板** | <a id="feature-taskboard"></a>左侧边栏 → **任务看板**。供你和智能体共用的 dsh 项目看板：**待办**、**进行中**、**审核**和**已完成**（以及**积压**，见下文）。在左侧选择一个项目或**所有项目**。**新建任务**（或按 `n`）会打开一张新卡片：输入标题后按 `Enter`。把卡片拖到另一列或两张卡片之间。点击卡片可查看并修改**状态**、**标签**、**人工**（智能体会跳过）、描述（Markdown）和评论。`/` 搜索所有项目，`h` 只显示人工任务，导出按钮可把看板保存为 Markdown 或 JSON。智能体会获得看板工具：让对话“从看板领取下一个任务”，它会把**待办**最上面的卡片移到**进行中**，评论所做的工作并移到**审核**；由你移到**已完成**。在有未完成任务的项目中，每个对话都会自动获得这条规则。设置 → Composer Plus → **任务看板**中有**积压**列的开关：智能体不会处理其中的卡片。 | <a href="assets/features/taskBoard.webp"><img src="assets/features/taskBoard.webp" width="160" alt="截图：任务看板"></a> |
+| **项目记忆** | <a id="feature-projectmemory"></a>默认关闭：请在 **设置 → Composer Plus** 中开启。每个项目文件夹都有自己的记忆，该项目之后的对话都会读取，就像 DS Bot 为每个 Bot 保存一份记忆。每个回合结束后，会用对话的模型调用一次，读取新消息（不含已回滚的消息），把你长期的偏好、决定和事实保存为简短笔记，并修改或删除旧笔记。智能体也可以自己保存、删除和搜索笔记（`memory_remember`、`memory_forget`、`memory_recall`）。笔记也可以是全局的：所有项目都会读取。新对话会在系统提示词中获得这些笔记；之后保存的笔记从下一个对话开始显示。文件是 dsh 主目录下的 Markdown（`storages/dsh-composer-plus/memory/`），绝不写入项目文件夹。 同一行的 **打开记忆** 会按项目（以及全局记忆）分组显示所有已保存的笔记，并可筛选。用你自己的话写下要修改的内容（例如“我从 yarn 换成了 pnpm”），然后点 **预览修改**：由 dsh 的默认模型提出修改，只有点 **应用** 才会保存。在 Tether 中：聊天标题菜单 → Project memory。 | <a href="assets/features/projectMemory.webp"><img src="assets/features/projectMemory.webp" width="160" alt="截图：项目记忆"></a> |
 | **本对话内允许** | <a id="feature-allowforchat"></a>当 Auto Review 询问你时，审批卡片上会多出 **本对话内允许**：从此以后，同一对话中的同一工具都会被允许，参数不限，直到时限结束（默认 1 小时；可在 **设置 → Composer Plus → 本对话内允许** 中选择）。之后代理会再次询问。标题栏中的标签会列出这些授权及其结束时间，也可以撤销它们。授权在重启后仍然有效。 | <a href="assets/features/allowForChat.webp"><img src="assets/features/allowForChat.webp" width="160" alt="截图：本对话内允许"></a> |
 | **项目状态** | <a id="feature-projectstatus"></a>侧边栏中的项目行会显示与其对话相同的加载图标 / 等待 / 完成标记。因此，即使项目已折叠，你也能知道其中有对话正在运行或需要你处理。等待你处理的对话优先显示，其次是你尚未打开的已完成对话（绿色圆点，即使另一个对话仍在运行也会显示），最后是加载图标。将鼠标悬停在上面可查看详情。在**按工作区树**中，父文件夹的行也会显示其中每个项目（例如 `.worktrees/` 中的每个分支文件夹）的对话状态，折叠时也一样。 | <a href="assets/features/projectStatus.webp"><img src="assets/features/projectStatus.webp" width="160" alt="截图：项目状态"></a> |
-| **对话行显示 Git 分支** | <a id="feature-sessionbranch"></a>侧边栏中的每个对话行会显示一个小的灰色标签，内容是该对话最后一轮时项目文件夹所在的 git 分支（例如 `main` 或 `feature/login`；分离的 HEAD 会在括号中显示短提交 ID）。同一项目中位于不同分支的两个对话不再看起来一样，你也能立即发现自己是否要在错误的分支上继续对话。将鼠标悬停在标签上可查看完整名称。Host 部分会在每轮开始和结束时读取分支（`git branch --show-current`，只读）；安装后还没有新一轮的对话，或不是 git 仓库的文件夹，不会显示标签。当对话上方的项目行与分支同名时（例如“每个对话一个分支”的文件夹），该对话行不显示分支标签，但“列表视图”中仍会显示。 | <a href="assets/features/sessionBranch.webp"><img src="assets/features/sessionBranch.webp" width="160" alt="截图：对话行显示 Git 分支"></a> |
+| **对话行显示 Git 分支** | <a id="feature-sessionbranch"></a>侧边栏中的每个对话行会显示一个小的灰色标签，内容是该对话最后一轮时项目文件夹所在的 git 分支（例如 `main` 或 `feature/login`；分离的 HEAD 没有分支，不显示标签）。同一项目中位于不同分支的两个对话不再看起来一样，你也能立即发现自己是否要在错误的分支上继续对话。将鼠标悬停在标签上可查看完整名称。Host 部分会在每轮开始和结束时读取分支（`git branch --show-current`，只读）；安装后还没有新一轮的对话，或不是 git 仓库的文件夹，不会显示标签。当对话上方的项目行与分支同名时（例如“每个对话一个分支”的文件夹），该对话行不显示分支标签，但“列表视图”中仍会显示。 | <a href="assets/features/sessionBranch.webp"><img src="assets/features/sessionBranch.webp" width="160" alt="截图：对话行显示 Git 分支"></a> |
 | **全部标为已读** | <a id="feature-markprojectread"></a>在侧边栏中，点击项目的 **…** 按钮 → **全部标为已读**。该项目中所有对话的绿色未读圆点会立即消失；其他项目的圆点保持不变。项目中没有未读对话时，此项显示为灰色（**没有未读对话**）。 | <a href="assets/features/markProjectRead.webp"><img src="assets/features/markProjectRead.webp" width="160" alt="截图：全部标为已读"></a> |
 | **活跃项目置顶** | <a id="feature-activeprojectsfirst"></a>当某个对话开始运行或需要你处理时，它所在的项目会移到侧边栏顶部，并使用 dsh 自带的行动画（与把它拖到那里的效果相同）。已完成的项目保持原位；你可以像往常一样把它们拖到任意位置。移动会保存到 dsh 的项目顺序中，因此关闭此功能后会保留当前顺序。 | <a href="assets/features/projectStatus.webp"><img src="assets/features/projectStatus.webp" width="160" alt="截图：活跃项目置顶"></a> |
 | **近期项目筛选** | <a id="feature-recentprojects"></a>侧边栏 → 视图选项（滑块图标）→ **最近 2 小时内活跃**。选中后，侧边栏只显示最近 2 小时内有活跃对话的项目。活跃对话包括：这段时间内更新过的对话、正在运行或等待中的对话、当前打开的对话，以及你尚未打开的已完成对话（dsh 的绿色“完成”圆点），超过 2 小时后也一样。没有这类对话的项目会被隐藏，新建的空项目也会被隐藏。在 **按工作区树** 中，只要父文件夹中的某个项目处于活跃状态，父文件夹就会保持显示，最近 2 小时内不活跃的对话也会被隐藏，因此只显示最近的对话。再次选择该项即可显示所有项目。这个选择保存在本设备上。 | <a href="assets/features/recentProjects.webp"><img src="assets/features/recentProjects.webp" width="160" alt="截图：近期项目筛选"></a> |
 | **折叠全部项目** | <a id="feature-collapseprojects"></a>侧边栏中有项目展开时，视图选项（滑块图标）旁边会出现一个按钮。点击它可以一次折叠所有展开的项目，例如 5 个项目中展开的 3 个。没有展开的项目时，这个按钮会再次隐藏。 | <a href="assets/features/collapseProjects.webp"><img src="assets/features/collapseProjects.webp" width="160" alt="截图：折叠全部项目"></a> |
 | **按状态排序** | <a id="feature-statusorder"></a>侧边栏 → 视图选项 → **排序方式** → **按状态**（配合 **单列表** 使用）。已完成的对话排在最前（即带 dsh “完成”圆点的对话，以出错结束的回合也会显示这个圆点），然后是正在运行或等待中的对话，再然后是带有活跃自动化任务（Schedule）的对话，其余对话按 dsh 的顺序排列。打开已完成的对话后，它会往下移。只有视图会改变：选择 **手动排序** 或 **最近更新** 即可恢复。 | <a href="assets/features/statusOrder.webp"><img src="assets/features/statusOrder.webp" width="160" alt="截图：按状态排序"></a> |
 | **后台通知** | <a id="feature-notifications"></a>dsh 在后台时，如果回合完成（通知显示回复的第一行），或对话确实在等你处理，你都会收到通知。等你处理的情况包括：审批（显示工具名称）、回答（显示问题）或计划审阅。请求必须在 1.5 秒后仍未处理，才会发出通知，因此被自动处理的审批（Auto Review 授权、其他插件）不会发出通知；请求一旦得到处理，对应的通知也会立即撤回。程序坞/任务栏角标会显示等待中的对话数量。点击通知会打开对应的对话。 | <a href="assets/features/notifications.webp"><img src="assets/features/notifications.webp" width="160" alt="截图：后台通知"></a> |
-| **空闲时打开等待中的对话** | <a id="feature-idleswitch"></a>当某个对话提出问题，或等待审批或计划审阅（橙色圆点），而你 30 秒没有使用 dsh 时，dsh 会打开该对话。有多个对话在等待时，等待最久的先打开；下一个会在再次 30 秒没有使用后打开。按键、点击、移动鼠标、滚轮或触摸都会让 30 秒重新计时。有焦点的输入框中有文字、选中了文本，或打开了菜单或对话框时，也不会切换。等待中的对话正在屏幕上时，不会切换。如果你没有回答就离开了等待中的对话，再次 30 秒没有使用后，它会再次打开。dsh 在后台时也会生效，但 dsh 不会被带到前台。 | <a href="assets/features/idleSwitch.webp"><img src="assets/features/idleSwitch.webp" width="160" alt="截图：空闲时打开等待中的对话"></a> |
+| **空闲时打开等待中的对话** | <a id="feature-idleswitch"></a>当某个对话提出问题，或等待审批或计划审阅（橙色圆点），或完成了你尚未查看的一轮（绿色圆点），而你 30 秒没有使用 dsh 时，dsh 会打开该对话。橙色对话先于绿色对话打开。同一组中，等待最久的先打开；下一个会在再次 30 秒没有使用后打开。按键、点击、移动鼠标、滚轮或触摸都会让 30 秒重新计时。有焦点的输入框中有文字、选中了文本，或打开了菜单或对话框时，也不会切换。等待中的对话正在屏幕上时，不会切换。如果你没有回答就离开了等待中的对话，再次 30 秒没有使用后，它会再次打开。绿色对话打开后，它的圆点会消失；下一个绿色对话要等你再次使用 dsh，之后又 30 秒没有使用时才会打开。dsh 在后台时也会生效，但 dsh 不会被带到前台。 | <a href="assets/features/idleSwitch.webp"><img src="assets/features/idleSwitch.webp" width="160" alt="截图：空闲时打开等待中的对话"></a> |
 | **应用语言** | <a id="feature-language"></a>设置 → Composer Plus → **应用语言** 可以把整个 dsh 界面切换为 Türkçe、Español、Português (Brasil)、Français、Deutsch、Русский、日本語、한국어、Bahasa Indonesia、Tiếng Việt 或 हिन्दी（见下文）。 | <a href="assets/features/language.webp"><img src="assets/features/language.webp" width="160" alt="截图：应用语言"></a> |
 | **手机连接（iPhone）** | <a id="feature-mobileconnect"></a>通过 [Tether](tether/) 应用在 iPhone 上使用 dsh，可以在同一 Wi-Fi 下使用，也可以通过 [Tailscale](https://tailscale.com) 使用。请在 **设置 → Composer Plus** 中开启它（默认关闭，因为它会在这台 Mac 上开放一个网络端口）。然后点击侧边栏左下角的 **手机连接**：用 iPhone 相机扫描二维码（轻点 **Open in Tether**），或用 Tether 中的 **Scan code** 扫描，轻点 **Connect**，然后点击 **Approve**。请先安装 Tether：没有它，相机无法打开这个二维码。手机可以显示你的对话、发送消息（可附照片：输入框的 **+** → Camera、Photos 或 Paste image）、回答审批和问题，以及切换模型和智能体。你可以配对任意多台 Mac：点击应用左上角的 Mac 名称即可在它们之间切换。**手机连接** 面板会列出已配对的 iPhone 及其上次连接时间：点击 **Remove** 可立即断开其中一部。“Tailscale only”会拒绝来自本地网络的连接（适用于共享 Wi-Fi），访问日志会显示谁尝试过连接。在 Tether 中，“Settings → Privacy”可以用 Face ID 锁定应用。 | <a href="assets/features/mobileConnect.webp"><img src="assets/features/mobileConnect.webp" width="160" alt="截图：手机连接（iPhone）"></a> |
 | **自动更新** | <a id="feature-autoupdate"></a>dsh 启动时，插件会检查 [最新的 GitHub release](https://github.com/furkancak1r/dsh-composer-plus/releases/latest)。如果它比当前版本新，并且已发布到 npm，插件会通过 dsh 自带的插件管理器（与 设置 → 插件 相同的途径）安装这个确切的版本，并通知你。重启 dsh 即可加载新版本。**设置 → Composer Plus → Composer Plus 更新** 会显示版本号，并提供 **检查更新** / **立即更新**。dsh 第一次以新版本启动时，会显示一次 **Composer Plus N 的新功能** 窗口，内容是该版本的发布说明（来自同一次更新检查，不会额外联网）；点击 **关闭** 或按 `Esc` 关闭。 | <a href="assets/features/autoUpdate.webp"><img src="assets/features/autoUpdate.webp" width="160" alt="截图：自动更新"></a> |
@@ -160,7 +167,12 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
 - **输入时补全：** 在你开启之前一直关闭。开启后，你每次输入停顿时，Host 端会把你目前已输入的文字，以及该对话中你自己的消息和智能体的文字回复（不含工具输出、隐藏上下文和推理内容；对话部分最多约 3,000 个字符），发送给在 **输入时补全** 下选择的模型（默认为 **下一条消息预测** 的模型）。新的停顿会停止较早的请求。对话中不会保存任何内容。开关保存在 `$DSH_HOME/storages/dsh-composer-plus/complete.json` 中（仅所有者可访问的文件）。
 - **优化提示词：** 在你点击魔法棒之前，什么都不会运行。点击后，Host 端会以一次请求的形式，把以下内容发送给在 **优化提示词** 下选择的模型（默认为对话自己的模型）：你的草稿；该对话中你自己的消息和智能体的文字回复（不含工具输出、隐藏上下文、推理内容和已回退的消息；最多约 6,000 个字符，最新的部分）；与 **功能创意** 相同的项目概要（文件规则也相同：不读取 `.env*` 或密钥文件，跳过指向文件夹外部的符号链接和 FIFO）；`git status` 列为已更改的路径；以及最多 30 个名称与你的草稿有相同词语的已跟踪或未跟踪（未被忽略）路径。除这份概要外，不会发送任何文件内容。对话和项目中都不会写入任何内容：回答只会替换输入框中的草稿，是否发送由你决定。模型选择保存在 `$DSH_HOME/storages/dsh-composer-plus/improve.json` 中（仅所有者可访问的文件）。
 - **目标检查：** 只有当智能体在自动轮次中把 `/goal` 标记为完成时（或者你点击 **立即运行** 时）才会运行。Host 端在对话的文件夹中、按对话的沙箱模式运行测试命令（与 dsh 自己的 `bash` 工具相同：同样的文件访问策略；沙箱无法启动时，测试不会运行，检查判为失败）。为了找到命令，它只读取 `package.json`、`Makefile`、`Cargo.toml`、`go.mod`、`pyproject.toml` 和 `pytest.ini`，并且只读取文件夹内的普通文件（不跟随指向文件夹外部的符号链接，不读取 FIFO）。然后，它以一次不带工具的请求，把以下内容发送给在 **目标检查** 下选择的模型（默认为对话自己的模型）：目标；从目标开始以来的对话（你的消息、智能体的回复、截断到 1,000 个字符的工具调用以及每个工具结果的最后 2,000 个字符；不含推理内容和已回退的步骤；最多约 60,000 个字符，最新的部分）；`git status --short`；以及测试输出的末尾。工具输出可能包含智能体读取过的内容，因此这次请求可能包含你文件的一部分，与对话本身相同。对话和项目中都不会写入任何内容。你的测试命令、上限、上次结果（含其输出的末尾）和模型选择保存在 `$DSH_HOME/storages/dsh-composer-plus/goal-check.json` 中（仅所有者可访问的文件，最新的 500 个对话）。
-- **项目记忆：** 在你开启之前一直关闭。开启后，每个顶层对话的回合结束时，Host 部分会把该对话自上次整理以来的新消息（你的消息和智能体的文字回复；不含工具输出、推理、隐藏上下文和已回滚的消息；分叉对话中复制自父对话的部分不算在内；最多约 16,000 个字符）和已保存的笔记，作为一次不带工具的请求发给对话自己的模型。笔记是 `$DSH_HOME/storages/dsh-composer-plus/memory/` 下的 Markdown 文件（仅所有者可读写）：每个项目文件夹对应 `projects/<id>/`（`<id>` 是文件夹真实路径的哈希；`project.json` 记录文件夹路径），另有 `global/`、`journal.jsonl`（每次改动及改动前后的那一行）和 `reviewed.json`（每个对话读到的位置）。项目文件夹中不会写入任何内容。看起来像密钥、令牌、密码或证件号码的笔记会被拒绝。项目的笔记会进入该文件夹中每个新对话的系统提示词，因此该对话的每次请求都会把它们发给模型。开关保存在同一位置的 `memory.json` 中。
+- **在新对话中继续：** 在你点击之前，什么都不会运行。点击后，Host 端会把对话（与目标检查读取的方式相同：不含推理内容和已回退的步骤）发送给对话自己的模型，并显示交接说明；只有 **开始新对话** 才会创建新对话。项目中不会写入任何内容。
+- **上下文明细：** 只在 Host 上读取对话日志；不调用模型，不读取项目文件。
+- **任务看板：** 看板（任务的标题、描述、标签和评论，项目文件夹路径及其简短 ID）保存在 `$DSH_HOME/storages/dsh-composer-plus/board.json` 中（仅所有者可访问的文件）；开关保存在旁边的 `board-switch.json` 中。数据不会离开你的电脑，也不会写入任何项目文件夹。看板工具会把你在看板上写的内容交给智能体，因此智能体读取任务时，任务文本会发送给对话所用的模型。损坏的看板文件会另存为 `board.json.broken-<时间>`，看板从空白开始。
+- **受保护的文件：** 列表和开关保存在 `$DSH_HOME/storages/dsh-composer-plus/protected-files.json` 中（仅所有者可访问的文件）。检查只读取每次文件工具调用的路径（及其真实路径），从不读取文件本身。
+- **禁止的命令：** 规则和开关保存在 `$DSH_HOME/storages/dsh-composer-plus/blocked-commands.json` 中（仅所有者可访问的文件）。检查只读取每次 `bash` 和 `pwsh` 调用的命令文本；它不运行任何内容，也不发送任何内容。
+- **项目记忆：** 在你开启之前一直关闭。开启后，每个顶层对话的回合结束时，Host 部分会把该对话自上次整理以来的新消息（你的消息和智能体的文字回复；不含工具输出、推理、隐藏上下文和已回滚的消息；分叉对话中复制自父对话的部分不算在内；最多约 16,000 个字符）和已保存的笔记，作为一次不带工具的请求发给对话自己的模型。笔记是 `$DSH_HOME/storages/dsh-composer-plus/memory/` 下的 Markdown 文件（仅所有者可读写）：每个项目文件夹对应 `projects/<id>/`（`<id>` 是文件夹真实路径的哈希；`project.json` 记录文件夹路径），另有 `global/`、`journal.jsonl`（每次改动及改动前后的那一行）和 `reviewed.json`（每个对话读到的位置）。项目文件夹中不会写入任何内容。看起来像密钥、令牌、密码或证件号码的笔记会被拒绝。项目的笔记会进入该文件夹中每个新对话的系统提示词，因此该对话的每次请求都会把它们发给模型。开关保存在同一位置的 `memory.json` 中。在你点 **预览修改** 之前，**打开记忆** 不会发送任何内容；点了之后，它会把显示的笔记和你的文字作为一次不带工具的请求发给 dsh 的默认模型。修改只在点 **应用** 时写入，日志中记为 `editor`。Tether 通过同一路由读取和修改笔记。
 - **备份：** 任何数据都不会离开你的电脑。归档保存在 `~/Desktop/dsh-backups` 中（仅所有者可访问的文件）。机密不在归档中：凭据文件（`.credentials.yaml`、`.env`）、密钥文件（`.pem`、`.key`、`.p12`、`.pfx`）以及 yml 文件中 token、secret、password 和 API key 设置的值都会被遮蔽；它们的真实副本保存在同一文件夹的 `composer-plus-vault/<archive>/` 中（仅所有者可访问），只在这台电脑上。**用于另一台电脑** 不会复制 vault：请在那台电脑上重新输入这些机密。你的对话日志、设置和 dsh 主目录的其余内容按原样保存在归档中：请像对待 `$DSH_HOME` 本身一样，不要公开该文件夹。备份使用 `O_NOFOLLOW | O_NONBLOCK` 读取文件；符号链接按链接保存（从不跟随），FIFO 和设备文件会被跳过。自动备份的开关和设置保存在 `$DSH_HOME/storages/dsh-composer-plus/auto-backup.json` 中，救援控制台的开关保存在 `rescue-console.json` 中；dsh 运行期间，`running/host-<pid>.json` 标明每个 dsh 进程（救援控制台读取它们，以便拒绝恢复）。
 - **救援控制台：** 一个终端菜单；它不打开网络端口。恢复只写入 dsh 主目录旁边的一个新文件夹（文件使用 `O_EXCL | O_NOFOLLOW` 写入，符号链接最后写入且从不跟随），并拒绝以下归档：含有不安全名称（`..`、绝对路径）、设备文件或 FIFO、多于一个顶层文件夹，或位于链接之下的条目。
 
@@ -182,7 +194,7 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
 - **对话行上没有分支标签：** 安装此版本后，该对话还没有新的一轮；或者它的文件夹不是 git 仓库；或者 **对话行显示 Git 分支** 已关闭。更新后，请重启 dsh（分支由 Host 端记录）。
 - **目标检查显示测试以代码 127 或 “not found” 退出：** 从 Finder 或程序坞启动的 dsh 的 PATH 可能比终端里的短，因此找不到 `npm`、`pnpm` 或 `cargo`。请从终端启动 dsh，或者在 **目标检查** → **编辑** 中用完整路径设置你自己的测试命令。**立即运行** 会马上显示结果。
 - **目标没有关闭，智能体一直在工作：** **目标检查** 发现了失败的测试或缺少的工作；目标下方的一行会显示原因（将鼠标悬停在结果上可查看详情）。请修正原因或测试命令，或者用 `/goal` 或目标栏自己完成目标（这不会被检查）。
-- **刚发布新版本时安装失败：** 请加上版本号（`dsh-composer-plus@1.16.1`），见上文的安装说明。
+- **刚发布新版本时安装失败：** 请加上版本号（`dsh-composer-plus@1.18.0`），见上文的安装说明。
 - **立即备份显示“另一个备份操作正在进行”：** 另一个 dsh 窗口或救援控制台中正在运行一个操作（它们共用备份文件夹中的锁文件 `.composer-plus.lock`）。请等待它完成。如果没有操作在运行，下次点击时会接管已关闭进程留下的锁。
 - **救援控制台显示“dsh is running”：** 请先退出 dsh。如果 dsh 确实已关闭，消息中提到的文件是崩溃后留下的：删除它，然后重试。
 - **恢复后 dsh 无法启动或缺少插件：** 需要重新安装 profile 的插件包。恢复后，救援控制台会提供这一步；你也可以在它列出的 `$DSH_HOME/profiles/` 下的每个文件夹中运行 `pnpm install`。不在 vault 中的机密（另一台电脑）必须重新输入：控制台会列出它们。
@@ -205,6 +217,7 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
 - **本对话内允许** 从授权的那一刻开始计算时限。新的时限会立即应用于仍在生效的授权，因此更短的时限可能会让它们立即结束。1.12 及更早版本的授权没有时间信息：更新后，代理会就这些工具再询问一次。
 - **保持输入框焦点** 只在发送 `/` 命令或技能后才会把焦点还给输入框。dsh 解析命令时，输入框会有几毫秒处于只读状态，因此这段时间内按下的键会丢失。如果 dsh 的 `/` 菜单仍然打开，`Enter` 会选择高亮的行，而不会发送。
 - **问题卡片适应窗口** 只改变 dsh 的问题卡片，不改变计划审阅卡片。它通过 dsh 的标记（`data-question-key`、`data-question-scroll`）找到卡片；如果 dsh 更新改变了这些标记，卡片会按 dsh 自己的样子显示。卡片高度跟随窗口，而不是对话：在较窄侧边面板中的对话里，较高的卡片仍可能超出对话上方。
+- **对话标题栏适应窗口** 通过 dsh 生成的类名（`_titleRow`、`_titleCluster`、`_crumbs`、`_headerActions`、`_headerUtilities`）找到对话标题栏，因为 dsh 没有为它提供布局接口。如果 dsh 更新改了这些类名，标题栏按 dsh 原样显示。在很窄的对话栏中，标题栏可能占两到三行，所以消息上方的空间会变小。
 - **手机连接** 只适用于 macOS（它使用 `en0`、`openssl`、`swift` 和 `dns-sd`）。它使用固定端口 19390 和 19391，因此每台 Mac 上同一时间只能有一个 dsh 运行它（每台 Mac 是手机 Mac 列表中的一项）。只有在 Tether 打开或刚转入后台时，手机才能收到通知（没有推送服务）。在 Tether 中打开“Settings → Notifications → Send notifications”之前，Tether 不会发送通知。此开关默认关闭，打开时 iOS 会请求通知权限。iOS 应用尚未上架 App Store：请用 Xcode 从 `tether/ios` 构建它。“Tailscale only”仍然需要 Mac 有 Wi-Fi 或以太网地址（只有在有这样的地址时，网关才会启动）。访问日志按 Mac 分别保存，只保留最新的 200 次尝试；一分钟内重复的尝试不会新增一行，而是把同一行的次数加一。Tether 的应用锁不会隐藏 iPhone 锁定屏幕上的通知预览：请在 iOS 设置中关闭它们。Tether 的绿点跟随 Mac：在 dsh 中打开的对话，手机上的绿点也会消失。在 Tether 中打开的对话，只在手机上消失；Mac 上 dsh 自己的绿点会一直保留，直到你在 Mac 上打开该对话。
 - 会话链接在对话中有效；点击它不会打开对应的对话。用 **复制消息链接** 复制的链接，只在 dsh 0.2.1 及更高版本中、并且只从对话中的消息里才能打开对应的消息（dsh 0.2.0 没有用户文本规则，所以链接仍会被复制，但只显示为普通文本）。被回退移除的消息，或被压缩从 dsh 加载的历史中移除的消息，无法显示：此时链接会给出提示。🔗 按钮依附在 dsh 的消息行上；如果 dsh 更新改变了这部分标记，按钮就不会显示。
 - **全部标为已读** 通过 dsh 中一个不是公开 API 的部分（dsh 会话状态中的 `completionUnread` 列表）来更改 dsh 自己的未读圆点。如果 dsh 更新重命名了它，该菜单项就不会显示。该菜单项放在 dsh 项目的“…”菜单中，而这个菜单没有给插件的插槽；如果 dsh 修改了这个菜单，该菜单项也不会显示。
@@ -219,7 +232,7 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
 - **每个对话一个分支**：当对话的分支文件夹（`<project>/.worktrees/<name>`）被删除时（例如对话自己的智能体移除了 worktree 并删除了分支），对话的下一步会把对话移出该文件夹。它的分支文件夹项目会从侧边栏消失，对话显示在“未分组”下并保持打开。在 dsh 0.2.1 及更高版本中，对话在主项目文件夹中继续，模型会收到一条关于新文件夹的说明。在 dsh 0.2.0 上，对话保留已删除的文件夹：在那里运行的命令会失败，直到你开始一个新对话。没有对话使用的已删除分支的项目也会从侧边栏消失：Composer Plus 在启动时和每 30 秒检查一次分支文件夹，不需要任何侧边栏筛选。对话移动期间，同一仓库中的**新分支**会回答“请重试”。关闭开关后，dsh 自己的错误会再次出现（“working-directory: directory does not exist”）。
 - **工作区树中的分支** 会在无需点击的情况下写入 git：移动对话时，它把项目文件夹切回原来的分支（`git switch`），并添加一个 worktree（`git worktree add`）。它从不删除分支、worktree 或文件。dsh 不能更改对话的文件夹，所以被移动的对话是一个副本（dsh 自己的分叉，带有新的 id），旧对话会被归档。副本会继续已停止的任务；分支出现时正在运行的工具调用会以拒绝结束，智能体会在新文件夹中再次运行它。旧对话的目标不会随之移动。只有文件夹是仓库主文件夹的对话会移动，而且只针对它在该轮中创建并切换到的分支（`git switch -c`、`git checkout -b`）：只用 `git branch` 创建的分支、有未提交改动的文件夹、链接的 worktree 或子文件夹都不会移动。只有直接位于 `<project>/.worktrees/` 中且有分支的 worktree 会显示在树中；分离的 worktree 或位于其他位置的 worktree 不会显示。只有当原对话是正在打开的对话时，副本才会自动打开（插件通过 dsh 的侧边栏行判断）；否则它在分支项目中。
 - **在对话中查找** 只搜索页面显示的内容：已加载的消息和回复（向上滚动或点击 **加载更早** 可查看更早的内容），不搜索已收起的工具步骤，也不搜索工具输出中被折叠的文本。它最多统计 2,000 个匹配项（之后显示“2000+”）。它使用浏览器的高亮 API（Chromium 105 及更高版本；桌面应用支持）：在较旧的浏览器中，计数和跳转仍然可用，只是没有颜色。`Cmd+F`（Mac）或 `Ctrl+F`（Windows 和 Linux）只在屏幕上有对话时打开它；在其他地方，浏览器自带的查找照常工作。在 Mac 上，`Ctrl+F` 在文本框中仍保持 macOS 的用法（光标向前移动一个字符）。
-- **空闲时打开等待中的对话** 只知道 dsh 自己的窗口看到的操作：在其他应用中的操作不算，因此 dsh 在后台时，它会在 30 秒后打开等待中的对话。它不会把 dsh 带到前台。只阅读而不按键、不点击、不移动鼠标，也算空闲。它只看带有 dsh 橙色圆点的对话（问题、审批或计划审阅）；子代理的请求显示在其父对话中。等待中的对话在屏幕上时，不会打开其他对话；你没有回答就离开的对话，在再次 30 秒没有使用后可能会再次打开。30 秒不能更改。
+- **空闲时打开等待中的对话** 只知道 dsh 自己的窗口看到的操作：在其他应用中的操作不算，因此 dsh 在后台时，它会在 30 秒后打开等待中的对话。它不会把 dsh 带到前台。只阅读而不按键、不点击、不移动鼠标，也算空闲。它只看带有 dsh 橙色圆点（问题、审批或计划审阅）或绿色圆点（你尚未打开的已完成一轮）的对话；子代理的请求显示在其父对话中。橙色对话先打开。打开绿色对话会去掉它的圆点，所以下一个绿色对话要等你下一次按键、点击、移动鼠标、滚动滚轮或触摸后才开始计 30 秒：你回来时，其他绿色圆点仍在。等待中的对话在屏幕上时，不会打开其他对话；你没有回答就离开的对话，在再次 30 秒没有使用后可能会再次打开。30 秒不能更改。
 - 重启前发出的通知，点击后只会把 dsh 带到前台。
 - 活跃项目通过 dsh 保存的项目顺序来移动，因此新顺序在重启后依然保留。不属于任何项目的对话（“未分组”）无法移动；dsh 总是把它们列在最后。
 - dsh 在侧边栏的视图选项菜单中没有扩展点，所以近期项目选项被添加到 dsh 自己的菜单中。如果 dsh 更新修改了这个菜单，该选项将不会显示，所有项目都保持可见。筛选作用于项目行，因此 **单列表** 不会被筛选。在 **按工作区树** 中，只要父文件夹中的某个项目处于活跃状态，父文件夹就会保持显示，最近 2 小时内不活跃的对话行也会被隐藏；在 **按工作区** 中只筛选项目行。筛选会从 dsh 保存的视图设置（不是公开 API）读取 dsh 当前的视图；如果 dsh 更新改了它的名称，**按工作区树** 会按 **按工作区** 的方式筛选。项目状态也读取同一设置：在 **按工作区树** 中，父文件夹的行也会统计其中各项目的对话；如果 dsh 改了该设置的名称，每行只显示自己的对话。**按状态** 也有同类限制：dsh 没有排序插槽，因此该菜单项和行顺序依赖 dsh 的菜单和列表标记。
@@ -228,10 +241,16 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
 - dsh 也没有决定 **新会话** 在何处打开的扩展点。**新会话的默认工作区** 包装了 dsh 的一个非公开 API 方法（dsh 工作区服务的 `startSession`）。如果 dsh 更新改了它的名字，**新会话** 会在 dsh 自己选择的位置打开（当前或最近的项目）。所有不指定项目的调用都使用默认值：侧边栏按钮、它的快捷键、徽标，以及 **自动化任务** 页面上的 **新建**。dsh 启动时仍会打开上一个对话。通用文件夹在首次使用时创建并加入你的项目；在 Windows 或 Linux 上，如果 Documents 文件夹被移动过，它可能与 dsh 自己的文件夹不同。
 - dsh 也没有输入框提示的扩展点，所以 **下一条消息预测** 的文字覆盖在 dsh 自己的占位文字（`[data-composer-placeholder]`）上。如果 dsh 更新修改了这部分标记，就不会显示预测。开启期间，每完成一个回合都会进行一次简短的模型调用。
 - **输入时补全** 通过 dsh 自己的输入框提示显示文字（即 dsh 用于斜杠命令参数提示的 `--dsh-composer-hint` 样式）。输入斜杠命令、消息中带有文件或符号标签，或光标不在消息末尾时，它不会运行。如果 dsh 更新修改了这个样式，就不会显示补全。你每次输入停顿都会进行一次模型调用。
-- **优化提示词** 只能看到简短的项目概要、已更改的路径以及名称与你的用词匹配的路径，看不到代码本身。因此它可能漏掉正确的文件，并且只会提到提供给它的路径。发送前请先阅读新文本。输入斜杠命令或消息中带有文件或符号标签时，它不会运行（新文本是纯文本，标签会丢失）；一条消息最多 8,000 个字符。图片仍保留在附件中：只有文字会改变。每次点击都会进行一次模型调用；较强的模型可能需要一分钟（按 `Esc` 取消）。
-- **目标检查** 只检查智能体在自动目标轮次中做出的完成：你在对话中要求的完成、`/goal` 和目标栏都不会被检查。智能体可以自己修改测试或测试命令用到的文件；审核模型会阅读对话，可以看到这一点，但它在两个方向上都可能出错（错误的“尚未完成”会多花一轮；错误的“已完成”会关闭目标）。审核模型看到的是对话和 `git status`，而不是代码本身。只有当智能体最新的一步能更改文件的操作就是它自己在同一文件夹中成功运行完全相同命令的 `bash` 时，才会复用这次测试；带管道（`| tail`）或 `&&` 的命令不会被复用。预算在回合结束时计算，因此一个回合可能会超出预算。只计算对话自己的模型调用（不含其子智能体的调用）。检查运行期间 `update_goal` 会等待（测试最多 15 分钟，审核最多 3 分钟）。分支对话会得到新的对话 id，因此它开始时没有父对话自己的测试命令和上限。每次进入审核的完成都会花费一次模型调用。
+- **优化提示词** 只能看到简短的项目概要、已更改的路径以及名称与你的用词匹配的路径，看不到代码本身。因此它可能漏掉正确的文件，并且只会提到提供给它的路径。发送前请先阅读新文本。输入除 `/goal <目标>` 以外的斜杠命令、`/goal` 控制词（`clear`、`pause`、`resume`），或消息中带有文件或符号标签时，它不会运行（新文本是纯文本，标签会丢失）；一条消息最多 8,000 个字符。对于 `/goal` 目标，它只根据草稿和上下文写出条件；过于严格的条件可能会多花目标轮次，因此发送前请先阅读。图片仍保留在附件中：只有文字会改变。每次点击都会进行一次模型调用；较强的模型可能需要一分钟（按 `Esc` 取消）。
+- **目标检查** 只检查智能体在自动目标轮次中做出的完成：你在对话中要求的完成、`/goal` 和目标栏都不会被检查。智能体可以自己修改测试或测试命令用到的文件；审核模型会阅读对话，可以看到这一点，但它在两个方向上都可能出错（错误的“尚未完成”会多花一轮；错误的“已完成”会关闭目标）。审核模型看到的是对话和 `git status`，而不是代码本身。只有当智能体最新的一步能更改文件的操作就是它自己在同一文件夹中成功运行完全相同命令的 `bash` 时，才会复用这次测试；带管道（`| tail`）或 `&&` 的命令不会被复用。预算在回合结束时计算，因此一个回合可能会超出预算。token 预算也会计算该对话的子智能体对话的调用（在每个回合结束时从它们保存的日志中读取，因此子智能体很多的对话检查起来会稍慢一些）。证据表来自审核模型自己对对话的阅读：它标为已验证的部分，在重要时仍需要你自己查看。检查运行期间 `update_goal` 会等待（测试最多 15 分钟，审核最多 3 分钟）。分支对话会得到新的对话 id，因此它开始时没有父对话自己的测试命令和上限。每次进入审核的完成都会花费一次模型调用。
+- **受保护的文件** 是护栏，不是沙箱。它覆盖 dsh 自己的文件工具（`read`、`read_image`、对文件使用 `grep`、`write`、`edit`、`str_replace_editor`）。shell 命令（`cat .env`）、智能体编写的脚本、子智能体的 shell、MCP 工具、`glob` 列表以及对整个文件夹使用的 `grep` 仍能访问受保护的文件。如需真正的限制，请使用 dsh 的沙箱模式，或者不要把机密放在项目文件夹中。模式支持 `*`、`**` 和 `?`，不支持 `{a,b}` 或 `[ab]`，并且不区分大小写。
+- **禁止的命令** 是护栏，不是沙箱。它只读取 dsh 的 `bash` 和 `pwsh` 工具的命令文本。指代该命令的变量或别名（`CMD=npm; $CMD publish`）、shell 函数、智能体编写的脚本文件、其他程序（`python -c`、`node -e`、`make`）、MCP 工具以及你自己的终端仍能运行它。规则匹配的范围可能比你想要的更大：命令中的任何词都可以被当作命令名（`echo npm publish` 会匹配 `npm publish`），规则的词之间也可以夹着其他词（`git push --force` 也会匹配 `git push origin main --force`）。规则匹配过多时，请把它写得更长。**先询问** 需要一个能够询问的对话：在审批策略为 never 的对话中（例如委派的子智能体），dsh 无法显示卡片，因此调用会被拒绝并附上原因。审批卡片以英文显示原因。**本对话内允许** 不会回答 **先询问** 卡片。
+- **在新对话中继续** 会把对话（消息、工具调用以及每个工具结果的末尾，最多约 60,000 个字符，最新的部分）发送给对话自己的模型。交接说明可能漏掉某个决定或文件：开始前请先阅读。新对话只知道这份交接说明和链接的对话（dsh 会把旧对话作为只读上下文附加进来）；它的模型上下文从很小开始，旧对话保持不变。每个对话同一时间只能进行一次写说明或开始操作。
+- **上下文明细** 按 dsh 自己的规则显示估算值（每个 token 约 4 个字符），与 dsh 的上下文环使用相同的规则；模型自己的计数可能不同。工具定义取自最新的一次请求。它按对话日志中的样子显示上下文；正在运行的回合会在它的下一步之后出现。
+- **计划步骤** 只有在模型确实做了计划时才会节省令牌：开启后，每个请求都会带上 `plan_next_steps` 工具和一段简短说明（约 500 个令牌），即使在模型从不做计划的对话中也是如此。条件只证明它所写的内容（例如：构建的退出码为 0），并不证明工作正确。`ok` 读取 dsh 自己的结果标记（`[exit code: N]`、超时、沙箱拒绝）；一个失败但退出码不为非零的命令会被视为通过。步骤一次只运行一个；同时就绪的两个步骤会交回给模型。该步骤的消息会作为对话模型的助手消息保存（dsh 没有标记插件所写消息的方式），因此它的文字会说明是 Composer Plus 运行的。Tether 中没有此功能。
+- **任务看板** 只认识 dsh 的项目：不在项目中的对话显示**所有项目**，“每个对话一个分支”的文件夹（`<项目>/.worktrees/<名称>`）算作它所属的项目。项目 ID（`acme#12`）来自文件夹名，在 dsh 中重命名项目后保持不变。“保持看板最新”的规则只会加入其项目有未完成任务的对话；已获得该规则的对话会一直保留它。智能体被告知把**已完成**、**积压**和人工任务留给你，但工具不会拒绝：智能体仍可能移动这些卡片。功能开启时，看板工具会出现在每个对话的工具列表中（每次请求约 1,000 个令牌）；如果不用看板，请关闭它。页面显示时每 2 秒读取一次看板；智能体的修改会在这段时间内显示。你编辑的文本如果被智能体同时修改，则不会保存：面板会显示新文本和原因。不支持图片、不支持在多台电脑之间通过 git 同步、也不支持网络共享（Kanzo 有这些功能）。创意和外观来自 emanuele-em 的 [Kanzo](https://github.com/emanuele-em/kanzo)（AGPL-3.0）；Composer Plus 没有使用它的任何代码。
 - **停止后发送的消息优先** 只在你停止对话后生效（或在某一轮失败后，或打开仍有队列的对话时）：对话运行时发送的消息仍会排在队列末尾。它只会越过你自己的排队消息：如果队列中有目标轮次或问题回复，仍保持 dsh 自己的顺序。它会读取 dsh 中一个非公开 API 的部分（被停止的那一轮是否仍在结束中）；如果 dsh 更新后改了它的名称，消息要等那一轮结束后才会被移到前面。子代理对话保持 dsh 自己的顺序。
-- **项目记忆** 属于对话的第一个文件夹（dsh 的项目文件夹）：用 `cd` 更换文件夹的对话仍使用第一个项目的记忆；通过另一条路径打开的同一文件夹共用同一份记忆。对话开始时会冻结其记忆部分，所以之后保存的笔记从下一个对话开始显示（`memory_recall` 能立即找到）。整理只保留模型决定保留的内容：它可能漏掉某个事实，也可能保留错误的内容；请打开文件检查，并在 dsh 关闭时手动编辑或删除。每个包含你的消息的回合结束后都会调用一次模型；调用失败时，下一个回合后会再次读取同样的消息。子智能体对话不做整理。这个思路和文件格式来自 [DS Bot](https://github.com/Fei2411/DS-Bot)（Apache-2.0）；Composer Plus 没有使用它的代码，也从不读取或写入 DS Bot 自己的记忆。
+- **项目记忆** 属于对话的第一个文件夹（dsh 的项目文件夹）：用 `cd` 更换文件夹的对话仍使用第一个项目的记忆；通过另一条路径打开的同一文件夹共用同一份记忆。对话开始时会冻结其记忆部分，所以之后保存的笔记从下一个对话开始显示（`memory_recall` 能立即找到）。整理只保留模型决定保留的内容：它可能漏掉某个事实，也可能保留错误的内容；请在 **打开记忆** 中检查并在那里修改，或在 dsh 关闭时手动编辑文件。**打开记忆** 会把所选项目的笔记和全局笔记（选择“全部笔记”时为所有项目；最多约 60,000 个字符，其余只计数，在该次请求中无法修改）以及你的文字发送给 dsh 的默认模型，而不是对话的模型。预览在 Mac 上保留 30 分钟，直到 dsh 重启；如果在此期间整理或智能体修改了笔记，**应用** 会拒绝，你需要重新预览。**应用** 要么保存预览中的全部修改，要么一项也不保存：只要有一项修改无法保存（例如 MEMORY.md 已满），笔记就保持原样，并显示原因。每个包含你的消息的回合结束后都会调用一次模型；调用失败时，下一个回合后会再次读取同样的消息。子智能体对话不做整理。这个思路和文件格式来自 [DS Bot](https://github.com/Fei2411/DS-Bot)（Apache-2.0）；Composer Plus 没有使用它的代码，也从不读取或写入 DS Bot 自己的记忆。
 - **备份** 只使用一个固定文件夹 `~/Desktop/dsh-backups`（dsh-backup 的默认文件夹，因此它的归档仍然可用）；没有设置可以改用其他文件夹。归档大小约等于不含 `cache/` 和 `dsh-runtimes/` 的 dsh 主目录（实测：在 Apple Silicon 上，1.6 GB 的文件约用 30 秒生成 830 MB 的归档；期间 dsh 保持响应）。读取期间发生变化的文件，会按备份打开它时的状态保存，因此打开中的对话的日志末尾可能是一条被截断的记录，dsh 会在下次写入时修复它。遮蔽按单行中的键名查找 yml 文件中的机密（`token:`、`apiKey:`、…）；流式映射（`{token: x}`）中、此类键下的列表中、JSON 文件中（例如 `.json` 文件中某个 MCP 服务器的 `apiKey`）或使用其他名称的机密会留在归档中。dsh-backup 按类型生成的归档（`dsh-t-…`）不会列出。**用于另一台电脑** 会复制归档（在 APFS 上是克隆：不占用额外空间）；vault 不会随之复制。**立即备份** 不会删除任何备份。自动备份会保留 Composer Plus 生成的最新备份（**自动备份** 的 **保留** 设置），并删除它生成的更早备份；升级前的快照单独计数（保留最新的 2 份）。dsh-backup 的归档永远不会被删除：请用 **删除** 移除它们。只要 dsh-backup 仍已安装，它就会把 Composer Plus 的归档计入自己的保留份数，并可能删除它们。
 - **恢复** 只在 dsh 关闭时于救援控制台中运行：它会替换整个 dsh 主目录。旧目录会以 `.dsh.pre-restore-<time>` 保留在旁边，直到你删除它，因此磁盘需要能容纳两者。对话保留其项目路径：在另一台电脑上，位于其他路径的项目会显示为缺失，直到你重新添加它。指向 dsh 主目录之外的符号链接（例如从其他文件夹链接的技能）会作为链接恢复；它们的目标必须存在于那台电脑上。
 - **会话日志检查** 按照 dsh 自己判断能否打开的规则读取每个对话的最新日志：不是 JSON 或顺序错乱的行，只有在其后还有回合结束时才算损坏（否则 dsh 会打开该对话，只是不含从该行起的各行，因此不会列出它）。它不会按照 dsh 自己的事件规则检查日志中的事件，因此被判为健康的日志在 dsh 升级后仍可能无法打开。修复会从一份备份中取回副本：该备份之后的消息会从该对话中丢失（损坏的文件保留在旁边）。在此 dsh 中打开的对话不会在设置中修复：dsh 正持有它。
@@ -264,7 +283,9 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
 
 **能否让智能体不再自己宣布工作已完成，就像 loop engineering 中的审核循环那样？** 可以，使用 **目标检查**（默认开启）：用 `/goal` 开始一个目标。当智能体说目标已完成时，会运行项目的测试，并由一次独立的模型调用对照对话检查目标；任一项失败时，目标保持进行中，智能体会看到原因。在目标下方的 **目标检查** 行中用 **编辑** 设置你自己的测试命令、时间上限或 token 上限。
 
-**智能体能像 DS Bot 的记忆那样，在不同对话之间记住我的偏好吗？** 可以，使用 **项目记忆**（默认关闭）：在 **设置 → Composer Plus** 中开启。每个回合结束后，你长期的偏好和决定会作为简短笔记保存到该对话的项目中，该项目的每个新对话都会读取。让智能体记住某件事，它会立即保存。
+**智能体能像 DS Bot 的记忆那样，在不同对话之间记住我的偏好吗？** 可以，使用 **项目记忆**（默认关闭）：在 **设置 → Composer Plus** 中开启。每个回合结束后，你长期的偏好和决定会作为简短笔记保存到该对话的项目中，该项目的每个新对话都会读取。让智能体记住某件事，它会立即保存。要查看或修改笔记，请点同一行的 **打开记忆**，写下要修改的内容。
+
+**我和智能体能像 Kanzo 那样共用一个任务看板吗？** 可以，使用**任务看板**（默认开启）：在左侧边栏打开它，用**新建任务**添加任务。在对话中让智能体“从看板领取下一个任务”：它会把卡片移到**进行中**，评论所做的工作，然后移到**审核**。把任务标记为**人工**即可留给自己。
 
 **dsh 能像 dsh-backup 那样备份我的对话和设置吗？** 可以：**设置 → Composer Plus → 备份 → 立即备份**。它把相同格式的归档写入同一个文件夹（`~/Desktop/dsh-backups`），因此 dsh-backup 的归档也会显示并可以恢复，你可以卸载 dsh-backup。打开 **自动备份** 即可按计划备份。
 
@@ -290,6 +311,8 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
 
 **如何只查看一个对话更改过的文件？** 右侧边栏 → **改动** → **本对话**。点击 **␣** 可隐藏只有空白的改动。
 
+**如何阻止智能体运行 `npm publish` 或 `git push --force`？** **设置 → Composer Plus → 禁止的命令**：输入 `npm publish`，选择 **阻止** 或 **先询问**，然后点击 **添加**。**阻止** 会拒绝该命令，智能体会问你；**先询问** 每次都会显示审批卡片。受保护的文件覆盖智能体的文件工具；禁止的命令覆盖它的 shell 命令。
+
 **如何让 Auto Review 在同一个对话中不再反复询问同一个工具？** 点击审批卡片上的 **本对话内允许**。它只覆盖该对话中的这个确切工具，默认有效 1 小时；可以在标题栏的标签中撤销它。在 **设置 → Composer Plus → 本对话内允许** 中更改时间。
 
 **我的 iPhone 丢了。如何阻止它访问我的 Mac？** 点击侧边栏左下角的 **手机连接**，然后点击该 iPhone 旁边的 **Remove**。它的密钥会立即失效；只有通过你在 Mac 上批准的新配对，它才能重新连接。
@@ -304,7 +327,7 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
 
 **dsh 任务完成或需要审批时，如何收到 macOS / Windows 通知？** 保持 **后台通知** 开启（默认开启），并在操作系统设置中允许 DeepSeek Harness 发送通知。
 
-**dsh 能自己打开向我提问的对话吗？** 可以，使用 **空闲时打开等待中的对话**（默认开启）：当某个对话在等待回答、审批或计划审阅，而你 30 秒没有使用 dsh 时，dsh 会打开它。你在输入、滚动或移动鼠标时，它会等待。
+**dsh 能自己打开向我提问的对话吗？** 可以，使用 **空闲时打开等待中的对话**（默认开启）：当某个对话在等待回答、审批或计划审阅，而你 30 秒没有使用 dsh 时，dsh 会打开它。完成了你尚未查看的一轮的对话（绿色圆点）也会这样打开，在橙色对话之后。你在输入、滚动或移动鼠标时，它会等待。
 
 **如何把 DeepSeek Harness 界面切换为土耳其语、西班牙语、日语……？** 设置 → Composer Plus → **应用语言**。
 
@@ -318,6 +341,8 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
 
 **可以从 iPhone 发送照片吗？** 可以。在 Tether 的对话中，轻点消息输入框旁边的 **+** → Camera、Photos（最多 4 张）或 Paste image。照片会作为你消息的附件发送到 Mac 上的对话，因此模型能看到它们。
 
+**dsh 能否不再询问模型就运行下一条命令？** 可以，使用 **计划步骤**（默认关闭）：在 设置 → Composer Plus 中开启。之后模型可以带条件地计划接下来的命令，例如“构建通过后运行测试”，结果满足条件时，Composer Plus 会在不重新调用模型的情况下运行该步骤。审批和沙箱保持不变。
+
 **它支持桌面应用吗？** 支持：设置 → 插件 → **添加插件** → `dsh-composer-plus`。已在 dsh 0.2.0-rc.2（桌面版和网页版）和 0.2.1-rc.2（网页版）上测试。
 
 ## 开发
@@ -343,6 +368,8 @@ PLAYWRIGHT=/path/to/playwright node test/browser-readme-anchors.mjs
 SHOT=1 PLAYWRIGHT=/path/to/playwright node test/browser-keep-focus.mjs /path/to/dsh/lib/bin.js
 # Fit question card to window (fake model asks a long question at 1280 × 820): question, answers, Skip and Submit readable, height follows the window + its thumbnail
 SHOT=1 PLAYWRIGHT=/path/to/playwright node test/browser-question-fit.mjs /path/to/dsh/lib/bin.js
+# Fit chat header to window (fake model, subagent + background jobs, branch pill, grants chip): no overlap from 1280 to 320 px, wide header unchanged + its thumbnail
+SHOT=1 PLAYWRIGHT=/path/to/playwright node test/browser-header-fit.mjs /path/to/dsh/lib/bin.js
 # Mobile connect: switch on, QR popover, a fake iPhone pairs and calls dsh through the gateway, switch off + its thumbnail
 SHOT=1 PLAYWRIGHT=/path/to/playwright node test/browser-mobile-connect.mjs /path/to/dsh/lib/bin.js
 # Resume after restart (fake slow model, real quit and start): a running chat and a goal continue, a stopped chat does not
@@ -380,6 +407,8 @@ PLAYWRIGHT=/path/to/playwright node test/browser-continue-queue.mjs /path/to/dsh
 SHOT=1 PLAYWRIGHT=/path/to/playwright node test/browser-queue-stop-send.mjs /path/to/dsh/lib/bin.js
 # Edit queued message in place with images and files (slow fake model) + its thumbnail
 SHOT=1 PLAYWRIGHT=/path/to/playwright node test/browser-queue-edit.mjs /path/to/dsh/lib/bin.js
+# Task board: the page, the agent tools (fake model), drag and drop, search, the switch
+SHOT=1 PLAYWRIGHT=/path/to/playwright node test/browser-task-board.mjs /path/to/dsh/lib/bin.js
 ```
 
 ```sh