dsh-composer-plus 1.20.0 → 1.21.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.de.md +71 -9
- package/README.es.md +71 -9
- package/README.fr.md +71 -9
- package/README.hi.md +71 -9
- package/README.id.md +71 -9
- package/README.ja.md +71 -9
- package/README.ko.md +71 -9
- package/README.md +71 -9
- package/README.pt-BR.md +71 -9
- package/README.ru.md +71 -9
- package/README.tr.md +71 -9
- package/README.vi.md +71 -9
- package/README.zh.md +71 -9
- package/assets/features/diffComments.webp +0 -0
- package/assets/features/memoryCopy.webp +0 -0
- package/assets/features/memoryExport.webp +0 -0
- package/assets/features/memoryHistory.webp +0 -0
- package/assets/features/memoryPerChat.webp +0 -0
- package/assets/features/memorySource.webp +0 -0
- package/assets/features/memoryStale.webp +0 -0
- package/assets/features/memorySuggest.webp +0 -0
- package/assets/features/nextWaiting.webp +0 -0
- package/assets/features/optionPicks.webp +0 -0
- package/assets/features/quoteReply.webp +0 -0
- package/assets/features/rejectNote.webp +0 -0
- package/assets/features/remoteComputers.webp +0 -0
- package/assets/features/secretInput.webp +0 -0
- package/assets/features/sideChat.webp +0 -0
- package/assets/features/taskBoard.webp +0 -0
- package/client.js +2587 -169
- package/index.js +1432 -77
- package/package.json +4 -3
- package/release-notes.json +14 -14
- package/tether/gateway/server.mjs +246 -21
package/README.zh.md
CHANGED
|
@@ -29,7 +29,7 @@ dsh plugin --profile web add dsh-composer-plus
|
|
|
29
29
|
|
|
30
30
|
然后重启 dsh。(CLI 无法安装到桌面版 profile 中;桌面版 profile 由应用自己管理。)
|
|
31
31
|
|
|
32
|
-
> dsh 使用的 pnpm 会跳过发布不到 24 小时的版本。刚发布新版本时,请加上版本号:`dsh-composer-plus@1.
|
|
32
|
+
> dsh 使用的 pnpm 会跳过发布不到 24 小时的版本。刚发布新版本时,请加上版本号:`dsh-composer-plus@1.21.0`。
|
|
33
33
|
|
|
34
34
|
## 功能
|
|
35
35
|
|
|
@@ -71,9 +71,21 @@ dsh plugin --profile web add dsh-composer-plus
|
|
|
71
71
|
| **计划步骤** | <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> |
|
|
72
72
|
| **受保护的文件** | <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> |
|
|
73
73
|
| **禁止的命令** | <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> |
|
|
74
|
-
| **任务看板** | <a id="feature-taskboard"></a>左侧边栏 →
|
|
74
|
+
| **任务看板** | <a id="feature-taskboard"></a>左侧边栏 → **任务看板**,或在 dsh 的任意位置按 `Cmd+Shift+K`(Windows 和 Linux 上为 `Ctrl+Shift+K`)。dsh 对话的看板,显示与侧边栏相同的实时状态:等待你审批、回答或审阅计划的对话在**审核**中并带橙色圆点,运行中的对话在**进行中**,尚未打开的已完成对话在**已完成**中(绿色)。打开对话后,它的卡片会自动离开**已完成**;点击绿色卡片下方的**最近完成 (N)**,可查看你已读的已完成对话(最新 10 个,然后是**显示更早的 N 个**;展开或收起状态保存在此设备上)。在看板后面打开着时完成的对话(**新建任务**)会保持绿色,直到你打开它。点击看板顶部的项目名称打开项目列表,然后选择一个项目或**所有项目**;“每个对话一个分支”的文件夹算作它所属的项目。选择后、按 `Esc` 或点击列表外部时,列表会关闭。在列表顶部的**搜索项目**中输入,可按名称查找项目(不区分大小写和重音符号;按 `Esc` 清空搜索框),按 `Enter` 选择第一个匹配项;点击**最近 2 小时内活跃**,则只显示有对话正在等待、正在运行、已完成但尚未查看,或在最近 2 小时内有变化的项目(此设置保存在此设备上)。**新建任务**(或按 `n`)会在看板显示的项目中打开 dsh 自己的新对话(选择**所有项目**时,在 dsh 的新会话所选的项目中打开),因此你可以像在任何对话中一样添加文件、使用命令和选择模型。你的第一条消息发出后,会自动回到看板。在此之前,该对话以**新建任务**显示在**进行中**的最上方:点击它即可写第一条消息。有对话在等待你的项目,在项目列表中带橙色圆点(有任何对话在等待时,顶部的项目名称旁也有橙色圆点)。dsh 为对话命名,对话的模型根据这条消息最多写出 3 个标签。点击卡片可打开它的对话。点击橙色卡片(或其上的**回答**),即可直接在看板上回答;面板中的**打开对话**可打开完整对话:**拒绝**或**允许一次**;计划则选**同意执行**或**要求修改**;问题则选择选项或输入你自己的文字。点击已完成卡片上的 **×**,可把这张卡片从看板移除;展开**最近完成**后点击**已完成**顶部的**全部清除**,可把这些卡片从看板移除:它会先显示将移除哪个项目的多少张卡片,未读(绿色)卡片会保留。之后 8 秒内,**撤销**可把卡片放回;**已完成**下方的**已移除 (N)**列出已从看板移除的卡片,**放回**可让其中一张重新显示在**已完成**中。不会删除任何对话:对话仍保留在 dsh 的侧边栏中,重启后看板仍会记住这些操作(Tether 显示同一个看板),再次运行的对话会回到看板上。将指针指向**进行中**里的卡片(或把键盘焦点移到卡片上),即可看到它的进度:运行了多久、待办列表中的当前步骤、正在运行的工具,以及智能体的最后一行。在设置 → Composer Plus → 任务看板中,**悬停显示进度**可选择**快速(不用 AI)**(默认:只读取对话)或 **AI 摘要**(再向对话的模型发送一次简短调用,额外写出一两句话)。 | <a href="assets/features/taskBoard.webp"><img src="assets/features/taskBoard.webp" width="160" alt="截图:任务看板"></a> |
|
|
75
75
|
| **项目记忆** | <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> |
|
|
76
|
+
| **记忆版本历史** | <a id="feature-memoryhistory"></a>在 **项目记忆** 开启时默认开启。每次保存记忆之前(智能体、回合结束后的回顾、**打开记忆**),都会保留一份原来的笔记副本。在 **打开记忆** 中选择一个项目或 **全局记忆**,然后点 **历史**:按日期列出各个版本,以及之后是谁修改了记忆。选择一个版本,即可以差异形式查看恢复会改变什么,然后点 **恢复**。恢复前的笔记也会保留,所以可以撤销恢复。每份记忆保留最新的 50 个版本。在 Tether 中:对话标题菜单 → Project memory → History。 | <a href="assets/features/memoryHistory.webp"><img src="assets/features/memoryHistory.webp" width="160" alt="截图:记忆版本历史"></a> |
|
|
77
|
+
| **把记忆导出到 AGENTS.md** | <a id="feature-memoryexport"></a>在 **打开记忆** 中选择一个项目,然后点 **导出到 AGENTS.md**:该项目的笔记会写入其文件夹中 `AGENTS.md` 的一个标记区块,你可以提交它,并与团队和其他智能体工具共享。你会先看到差异形式的修改,只有点 **写入 AGENTS.md** 才会保存。下次导出只替换该区块。全局记忆、来源和日期不会写入。在 Tether 中:对话标题菜单 → Project memory → Export to AGENTS.md。 | <a href="assets/features/memoryExport.webp"><img src="assets/features/memoryExport.webp" width="160" alt="截图:把记忆导出到 AGENTS.md"></a> |
|
|
78
|
+
| **记忆笔记来源链接** | <a id="feature-memorysource"></a>在 **打开记忆** 中,来自对话的笔记(智能体保存的、回合结束后的回顾保留的,或你接受的建议)旁边有 **来源**:点击即可在该消息处打开那个对话,这样在修改或删除笔记之前,可以先查看它为什么会在记忆里。较早版本保存的笔记只打开它的对话。在 Tether 中:对话标题菜单 → Project memory → Source。 | <a href="assets/features/memorySource.webp"><img src="assets/features/memorySource.webp" width="160" alt="截图:记忆笔记来源链接"></a> |
|
|
79
|
+
| **把记忆复制到其他项目** | <a id="feature-memorycopy"></a>在 **打开记忆** 中选择一个项目或 **全局记忆**,然后点 **复制到项目**:勾选笔记,搜索 dsh 的项目并点击其中一个。勾选的笔记会全部复制到该项目的记忆中(连同主题和来源),或者一条都不复制:只要有一条放不下,就不复制任何笔记并显示原因。目标项目中已有的笔记会被跳过。在 Tether 中:对话标题菜单 → Project memory → Copy to project。 | <a href="assets/features/memoryCopy.webp"><img src="assets/features/memoryCopy.webp" width="160" alt="截图:把记忆复制到其他项目"></a> |
|
|
80
|
+
| **查找过时的记忆笔记** | <a id="feature-memorystale"></a>在 **打开记忆** 中选择一个项目时,会把其笔记中提到的文件路径(写在 `code` 中)、npm 脚本和分支名与项目当前的状态核对。笔记提到了项目已经没有的东西时,会显示 ⚠ 和缺少的内容,这样可以在模型依据它工作之前修改或删除它。它只读取项目文件夹内的普通文件和一次 git 分支列表;不会修改任何内容,也不会调用模型。在 Tether 中:对话标题菜单 → Project memory。 | <a href="assets/features/memoryStale.webp"><img src="assets/features/memoryStale.webp" width="160" alt="截图:查找过时的记忆笔记"></a> |
|
|
81
|
+
| **此对话不使用记忆** | <a id="feature-memoryperchat"></a>在 **项目记忆** 开启时,对话标题栏显示 **记忆开启**:点击即可只为该对话关闭记忆(**记忆关闭**)。之后该对话的模型不会获得记忆区块和记忆工具,每个回合后的回顾也不会读取它。在 dsh 0.2.1 及以上版本中,新对话界面也有同一个按钮,测试对话可以在没有记忆的情况下开始。其他对话不受影响。在 Tether 中:对话标题菜单 → Use project memory。 | <a href="assets/features/memoryPerChat.webp"><img src="assets/features/memoryPerChat.webp" width="160" alt="截图:此对话不使用记忆"></a> |
|
|
82
|
+
| **从对话中建议记忆笔记** | <a id="feature-memorysuggest"></a>在 **项目记忆** 开启时,对话标题栏有 **建议记忆**:点击后会让该对话的模型找出此对话中值得为之后的对话保留的规则和决定。每条建议都会说明原因;**接受** 会连同指向来源对话和消息的链接一起保存,**拒绝** 则丢弃。接受之前不会保存任何内容,只有在你点击时才会调用模型。被回滚撤回的消息不会发送。在 Tether 中:对话标题菜单 → Suggest for memory。 | <a href="assets/features/memorySuggest.webp"><img src="assets/features/memorySuggest.webp" width="160" alt="截图:从对话中建议记忆笔记"></a> |
|
|
76
83
|
| **本对话内允许** | <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> |
|
|
84
|
+
| **拒绝并附言** | <a id="feature-rejectnote"></a>审批卡片的 **拒绝** 旁边会多出 **拒绝并附言…**。点击它,写下原因或应改做什么,然后点 **拒绝**(或按 `Enter`;`Shift+Enter` 换行,`Esc` 关闭输入框)。附言会先作为一条消息发进正在等待的这一轮,然后请求被拒绝:模型在同一轮中读到拒绝和你的附言,你无需再发一条消息。如果附言发不出去,就什么也不会被拒绝,输入框保持打开。Tether 中:审批页 → Reject with note。 | <a href="assets/features/rejectNote.webp"><img src="assets/features/rejectNote.webp" width="160" alt="截图:拒绝并附言"></a> |
|
|
85
|
+
| **密钥输入** | <a id="feature-secretinput"></a>代理会获得工具 `request_secret`。当它需要密码、令牌或 API 密钥时,会用这个工具索要,而不是在对话里问你:工具行上会出现一个卡片,显示名称、它为什么需要这个值、一个密码输入框,以及 **保存** 和 **拒绝**。**保存** 会把值写入这台 Mac 上只有你能读取的文件,代理只拿到文件路径,并把它作为命令的输入使用(例如 `"$(cat <path>)"`)。之后的工具结果如果显示该值,会在模型看到之前替换为 `[secret]`。这一轮结束时文件会被删除。**拒绝** 会告诉代理你没有提供该值。在 **设置 → Composer Plus** 中关闭它即可移除该工具。Tether 中:输入框上方的 “Secret: …” 条 → Enter。 | <a href="assets/features/secretInput.webp"><img src="assets/features/secretInput.webp" width="160" alt="截图:密钥输入"></a> |
|
|
86
|
+
| **引用回复** | <a id="feature-quotereply"></a>在回答中选中一段文字:选区上方会出现 **引用** 按钮。点击它,这段文字会以 Markdown 引用(`> …`)的形式插入输入框的光标处,后面留一个空行,并且输入框会获得焦点,你可以直接在下面写回复。只适用于回答正文,不适用于思考过程、工具行或你自己的消息。引用最多 2,000 个字符。`Cmd+Z`(`Ctrl+Z`)可以撤销。Tether 中:长按一条回答 → Quote(整条回答)。 | <a href="assets/features/quoteReply.webp"><img src="assets/features/quoteReply.webp" width="160" alt="截图:引用回复"></a> |
|
|
87
|
+
| **旁支对话** | <a id="feature-sidechat"></a>在输入框中输入旁支问题,然后点击对话气泡按钮(**在旁支对话中提问**):会打开此对话的一个副本,以 dsh 的只读模式回答,而原对话继续工作。副本了解对话到目前为止的内容(仍在队列中等待的消息除外),并沿用其模型。副本输入框上方的横条中有 **带回**:会打开原对话,并把你的问题(`> ` 引用)和回答放入它的输入框。**返回对话** 只打开原对话。旁支对话以“↳ <问题>”留在侧边栏中,可以在那里归档。Tether 中:对话标题菜单 → Side chat…。 | <a href="assets/features/sideChat.webp"><img src="assets/features/sideChat.webp" width="160" alt="截图:旁支对话"></a> |
|
|
88
|
+
| **差异批注** | <a id="feature-diffcomments"></a>在 **改动面板** 中打开一个文件的差异,点击某一行的 **+**(按住 Shift 点击同一区块的另一行可选范围),写下批注并点击 **保存批注**。此对话的批注会在面板顶部的横条中等待;**发送到输入框** 会把它们以 Markdown 放到输入框的光标处:`path:12-14`、作为 `diff` 代码块的这些行和你的批注。**清除** 会丢弃它们。批注保存在此浏览器中,直到你发送或清除。需要 **改动面板**。Tether 中:文件差异 → 长按一行 → Add note…。 | <a href="assets/features/diffComments.webp"><img src="assets/features/diffComments.webp" width="160" alt="截图:差异批注"></a> |
|
|
77
89
|
| **项目状态** | <a id="feature-projectstatus"></a>侧边栏中的项目行会显示与其对话相同的加载图标 / 等待 / 完成标记。因此,即使项目已折叠,你也能知道其中有对话正在运行或需要你处理。等待你处理的对话优先显示,其次是你尚未打开的已完成对话(绿色圆点,即使另一个对话仍在运行也会显示),最后是加载图标。将鼠标悬停在上面可查看详情。在**按工作区树**中,父文件夹的行也会显示其中每个项目(例如 `.worktrees/` 中的每个分支文件夹)的对话状态,折叠时也一样。 | <a href="assets/features/projectStatus.webp"><img src="assets/features/projectStatus.webp" width="160" alt="截图:项目状态"></a> |
|
|
78
90
|
| **对话行显示 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> |
|
|
79
91
|
| **全部标为已读** | <a id="feature-markprojectread"></a>在侧边栏中,点击项目的 **…** 按钮 → **全部标为已读**。该项目中所有对话的绿色未读圆点会立即消失;其他项目的圆点保持不变。项目中没有未读对话时,此项显示为灰色(**没有未读对话**)。 | <a href="assets/features/markProjectRead.webp"><img src="assets/features/markProjectRead.webp" width="160" alt="截图:全部标为已读"></a> |
|
|
@@ -83,8 +95,11 @@ dsh plugin --profile web add dsh-composer-plus
|
|
|
83
95
|
| **按状态排序** | <a id="feature-statusorder"></a>侧边栏 → 视图选项 → **排序方式** → **按状态**(配合 **单列表** 使用)。已完成的对话排在最前(即带 dsh “完成”圆点的对话,以出错结束的回合也会显示这个圆点),然后是正在运行或等待中的对话,再然后是带有活跃自动化任务(Schedule)的对话,其余对话按 dsh 的顺序排列。打开已完成的对话后,它会往下移。只有视图会改变:选择 **手动排序** 或 **最近更新** 即可恢复。 | <a href="assets/features/statusOrder.webp"><img src="assets/features/statusOrder.webp" width="160" alt="截图:按状态排序"></a> |
|
|
84
96
|
| **后台通知** | <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> |
|
|
85
97
|
| **空闲时打开等待中的对话** | <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> |
|
|
98
|
+
| **下一个等待中的对话** | <a id="feature-nextwaiting"></a>侧边栏标题栏中的按钮显示还有多少其他对话在等你,圆点颜色与下一个对话一致:它提出问题或等待审批或计划审阅时为橙色,完成了你尚未查看的一轮时为绿色。点击按钮或按 Cmd+Shift+E(Windows 和 Linux 上为 Ctrl+Shift+E)即可打开该对话。橙色对话先于绿色对话;同一组中,等待最久的对话排在前面。当前屏幕上的对话不计入。没有其他对话在等你时,按钮不显示,按键也不起作用。可在 dsh 的键盘快捷键页面(下一个等待中的对话)中更改按键。 | <a href="assets/features/nextWaiting.webp"><img src="assets/features/nextWaiting.webp" width="160" alt="截图:下一个等待中的对话"></a> |
|
|
99
|
+
| **选项按钮** | <a id="feature-optionpicks"></a>当回答以选项列表结尾(“选项”标题或加粗的“选项”行下的 1 到 9 项编号列表,也包括“下一步”以及应用各语言中的同义词)时,回答下方会为每个选项显示一个按钮。点击即把“Option N: …”连同整个选项作为你的消息发送,就像你自己输入的一样。标有“(推荐)”的选项会有标记。按钮只显示在最新的回答下,且对话空闲、输入框为空时才显示;已选择过的回答和被回退撤回的回答不显示按钮。按钮显示期间,“下一条消息预测”不会给出猜测。在智能体的提问卡片上,按 1–9 键与点击效果相同,选择对应选项(在回答输入框中无效,问题出现后的前 0.8 秒内也无效)。 | <a href="assets/features/optionPicks.webp"><img src="assets/features/optionPicks.webp" width="160" alt="截图:选项按钮"></a> |
|
|
86
100
|
| **应用语言** | <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> |
|
|
87
101
|
| **手机连接(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> |
|
|
102
|
+
| **远程电脑** | <a id="feature-remotecomputers"></a>通过 [Tailscale](https://tailscale.com) 打开你其他 Mac 上的 dsh,并在这里继续它们的对话。在每台 Mac 的 **设置 → Composer Plus** 中开启它(默认关闭,因为它会打开网络端口)。在要被打开的 Mac 上开启 **允许其他电脑打开本机**,点击 **创建配对链接** 并复制链接。在本机对话标题左侧的电脑选择器中选择 **添加电脑…**,粘贴链接并点击 **连接**,然后在另一台 Mac 上点击 **批准**。之后选择器会列出 **本机** 和你的电脑:选择一台,它的 dsh 会在右侧边栏的浏览器标签页(或浏览器窗口)中打开,带有它自己的对话、工具和文件。设置面板可以重命名和移除电脑,并列出可以打开本机的电脑(**移除** 会立即断开其中一台)。 | <a href="assets/features/remoteComputers.webp"><img src="assets/features/remoteComputers.webp" width="160" alt="截图:远程电脑"></a> |
|
|
88
103
|
| **自动更新** | <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> |
|
|
89
104
|
| **备份** | <a id="feature-backup"></a>设置 → Composer Plus → **备份** → **立即备份**:把整个 dsh 主目录(对话、设置、插件、MCP、技能)连同校验和写成 `~/Desktop/dsh-backups` 中的一个归档。归档中的机密会被遮蔽:凭据文件、密钥文件(`.pem`、`.key`)以及 yml 设置中的 token、secret 和 password 值只保存在这台电脑上,位于该文件夹的 `vault` 中。`cache/`、`dsh-runtimes/` 和 `node_modules` 不会归档(dsh 会重新生成它们)。列表中的每份备份都有 **检查**(完整读取)、**用于另一台电脑**(一个可复制到新电脑的文件夹,含救援控制台)和 **删除**。同一文件夹中 dsh-backup 的归档也会显示并可使用。要恢复,请退出 dsh 并使用救援控制台。 | <a href="assets/features/backup.webp"><img src="assets/features/backup.webp" width="160" alt="截图:备份"></a> |
|
|
90
105
|
| **自动备份** | <a id="feature-autobackup"></a>打开 **自动备份**(默认关闭:每份大约与不含缓存的 dsh 主目录一样大)。选择频率(**每**:6 小时到 7 天,默认 24 小时)和保留的份数(**保留**:3 到 14 份,默认 7 份)。下次备份时间显示在开关下方;失败的备份也会显示在那里,并在 30 分钟后重试。dsh 或 Composer Plus 以新版本启动时,会在启动后不久、新版本长时间使用你的数据之前拍一份快照(保留最新的两份,标记为 **升级前**)。 | <a href="assets/features/autoBackup.webp"><img src="assets/features/autoBackup.webp" width="160" alt="截图:自动备份"></a> |
|
|
@@ -137,6 +152,9 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
|
|
|
137
152
|
| Mac 上为 `Cmd+F`,Windows 和 Linux 上为 `Ctrl+F` | 打开的对话 | 打开 **在对话中查找** |
|
|
138
153
|
| `Enter` / `Shift+Enter`、`↓` / `↑` | **在对话中查找** 框 | 下一个 / 上一个匹配项 |
|
|
139
154
|
| `Esc` | **在对话中查找** 框 | 关闭查找框 |
|
|
155
|
+
| Mac 上为 `Cmd+Shift+E`,Windows 和 Linux 上为 `Ctrl+Shift+E` | dsh 中任意位置 | 打开 **下一个等待中的对话**(可在 dsh 的键盘快捷键页面中更改) |
|
|
156
|
+
| Mac 上为 `Cmd+Shift+K`,Windows 和 Linux 上为 `Ctrl+Shift+K` | dsh 中任意位置 | 打开 **任务看板**(可在 dsh 的键盘快捷键页面中更改) |
|
|
157
|
+
| `1`–`9` | dsh 的问题卡片(不在其回答输入框中) | 选择该选项(**选项按钮**) |
|
|
140
158
|
|
|
141
159
|
打开的 `/` 或 `@` 菜单会自己占用这些按键。
|
|
142
160
|
|
|
@@ -162,17 +180,20 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
|
|
|
162
180
|
- **本对话内允许:** 授权连同授予时间一起保存在 `$DSH_HOME/storages/dsh-composer-plus/chat-grants.json` 中(仅所有者可访问)。一项授权只覆盖一个对话中的一个确切工具,直到时限结束(默认 1 小时)。如果该工具可以写入,授权也覆盖任何写入操作。可以在标题栏的标签中撤销授权。
|
|
163
181
|
- Auto Review 仍会检查每一次调用;审查失败的调用永远不会被自动允许。
|
|
164
182
|
- **手机连接:** 在你开启之前一直关闭。开启后,Host 端会运行 Tether 网关:端口 19390 上的 HTTPS 服务只接受你的 Wi-Fi 子网和你的 tailnet(100.64.0.0/10);另有一个位于 `127.0.0.1:19391` 的配对页面(仅限这台 Mac)。手机需要二维码中的一次性代码(5 分钟内有效),还需要你在 Mac 上点击 **Approve**。手机会固定(pin)网关的证书。Mac 只保存每部手机令牌的哈希值(有效期 30 天,使用期间会续期);**Remove** 会立即关闭该手机的连接。手机只能调用允许列表中的 dsh 方法(对话、提示词、附件、斜杠命令、审批、问题、模型、智能体、目标),不能访问设置、凭据、文件浏览器或终端。“Tailscale only”会拒绝来自本地网络的所有连接,包括已经打开的连接。访问日志在 `access.json` 中保存最新的 200 次连接尝试(时间、IP 地址、设备名称、允许或拒绝,以及原因);其中从不包含令牌或配对代码。数据:`$DSH_HOME/storages/dsh-composer-plus/mobile/`(仅所有者可访问的文件)。详情:[tether/README.md](tether/README.md)。
|
|
183
|
+
- **远程电脑:** 在你于每台 Mac 上开启之前一直关闭。**允许其他电脑打开本机** 会再开放一个 HTTPS 端口(19392),只在这台 Mac 的 Tailscale 地址上开放(不在 Wi-Fi 上,也不通过 Bonjour 广播)。另一台 Mac 需要一次性配对链接(5 分钟内有效)、匹配的证书(已固定)和你点击 **批准**;这台 Mac 只保存其令牌的哈希值。已配对的电脑可以完全控制这台 Mac 上的 dsh,就像你在这里使用一样:包括对话、模型、工具、文件和终端。在设置面板中移除它,它的连接会立即关闭。用来打开其他 Mac 的那台 Mac 会把对方的令牌保存在 `$DSH_HOME/storages/dsh-composer-plus/computers.json` 中(仅所有者可访问)。你每选择一台电脑,它都会在 `127.0.0.1` 上打开一个中继:页面会得到一个一次性链接(60 秒内有效),中继只接受它自己的页面(它自己的地址,不接受其他网站)。由另一台 Mac 打开的页面不显示电脑选择器,也不能更改这台 Mac 的电脑。
|
|
165
184
|
- **更新:** Host 端会向 `api.github.com` 查询最新版本,并向 `registry.npmjs.org` 查询这个确切的版本;不会发送任何关于你或你的对话的信息。安装使用 dsh 的插件管理器(`pnpm add dsh-composer-plus@<version>`;如果 dsh 0.2.1 对已安装的插件拒绝这样做,则使用 `pnpm add https://registry.npmjs.org/dsh-composer-plus/-/dsh-composer-plus-<version>.tgz`,之后 profile 会把这个 URL 列为插件的来源),因此 dsh 自己的 registry、脚本和版本兼容性检查都会生效。预发布标签和旧版本永远不会被安装。
|
|
185
|
+
- **使用计数:** Host 端每天一次向 GitHub 请求已安装版本对应 release 中的小文件 `active.txt`(`github.com/furkancak1r/dsh-composer-plus/releases/download/v<version>/active.txt`)。GitHub 按文件统计这些请求,因此作者只能看到当天每个版本有多少份副本发出了请求。请求中没有 ID、Cookie,也没有关于你或你的对话的任何数据;和每次检查更新一样,GitHub 能看到你的 IP 地址。最后一次请求的日期保存在 `$DSH_HOME/storages/dsh-composer-plus/active.json`。本仓库的 git 检出副本和改名的副本不会发送请求。此功能没有开关。
|
|
166
186
|
- **下一条消息预测:** 默认开启;在 **设置 → Composer Plus** 中关闭它,即可停止这些模型调用。每完成一个回合,Host 端会把该对话中你自己的消息和智能体的文字回复(不含工具输出、隐藏上下文和推理内容),最多约 6,000 个字符(最新的部分),发送给所选的模型(除非你另选,否则为 dsh 的默认模型)。它通过 dsh 自己的提供商设置,以一次请求的形式发送。对话中不会保存任何内容:猜测不会被添加到对话历史中。开关和模型选择保存在 `$DSH_HOME/storages/dsh-composer-plus/predict.json` 中(仅所有者可访问的文件)。
|
|
167
187
|
- **输入时补全:** 在你开启之前一直关闭。开启后,你每次输入停顿时,Host 端会把你目前已输入的文字,以及该对话中你自己的消息和智能体的文字回复(不含工具输出、隐藏上下文和推理内容;对话部分最多约 3,000 个字符),发送给在 **输入时补全** 下选择的模型(默认为 **下一条消息预测** 的模型)。新的停顿会停止较早的请求。对话中不会保存任何内容。开关保存在 `$DSH_HOME/storages/dsh-composer-plus/complete.json` 中(仅所有者可访问的文件)。
|
|
168
188
|
- **优化提示词:** 在你点击魔法棒之前,什么都不会运行。点击后,Host 端会以一次请求的形式,把以下内容发送给在 **优化提示词** 下选择的模型(默认为对话自己的模型):你的草稿;该对话中你自己的消息和智能体的文字回复(不含工具输出、隐藏上下文、推理内容和已回退的消息;最多约 6,000 个字符,最新的部分);与 **功能创意** 相同的项目概要(文件规则也相同:不读取 `.env*` 或密钥文件,跳过指向文件夹外部的符号链接和 FIFO);`git status` 列为已更改的路径;以及最多 30 个名称与你的草稿有相同词语的已跟踪或未跟踪(未被忽略)路径。除这份概要外,不会发送任何文件内容。对话和项目中都不会写入任何内容:回答只会替换输入框中的草稿,是否发送由你决定。模型选择保存在 `$DSH_HOME/storages/dsh-composer-plus/improve.json` 中(仅所有者可访问的文件)。
|
|
169
189
|
- **目标检查:** 只有当智能体在自动轮次中把 `/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 个对话)。
|
|
170
190
|
- **在新对话中继续:** 在你点击之前,什么都不会运行。点击后,Host 端会把对话(与目标检查读取的方式相同:不含推理内容和已回退的步骤)发送给对话自己的模型,并显示交接说明;只有 **开始新对话** 才会创建新对话。项目中不会写入任何内容。
|
|
171
191
|
- **上下文明细:** 只在 Host 上读取对话日志;不调用模型,不读取项目文件。
|
|
172
|
-
- **任务看板:** 看板显示 dsh 自己的对话,数据来自 dsh 在此窗口中自己的列表;它不会添加自己的对话数据。**新建任务** 会打开 dsh 自己的新对话,你在 dsh 的输入框中写第一条消息,因此审批、沙箱和对话的模型照常适用。Host 端把该对话的第一条消息保存为卡片的提示,并以另一次不带工具的请求,把它(只有前 4,000 个字符,没有其他内容)发送给该对话的模型,以获得最多 3 个标签。每个任务的提示、标签和开始时间保存在 `$DSH_HOME/storages/dsh-composer-plus/board-chats.json` 中(仅所有者可访问的文件,保留最新的 2,000 个);开关保存在旁边的 `board-switch.json` 中。不会向任何项目文件夹写入内容。**回答** 会把你的回答发送给 dsh 自己的待处理请求,与对话中自己的卡片做法相同。早期版本的旧任务列表(`board.json`)原样留在磁盘上,不会被读取。**悬停显示进度** 在这台 Mac 上读取对话的日志。使用 **快速(不用 AI)**(默认)时,不发送任何内容。使用 **AI 摘要** 时,在正在运行的卡片的进度框显示期间(或在 Tether 的看板打开期间,最多 8 张正在运行的卡片),Host 端会把该对话最新的部分(最多约 6,000 个字符:你的消息、智能体的文字回复、它的工具调用及其结果的末尾;不含推理和已回退的消息)以一次不带工具的请求发送给该对话的模型。只有在对话有了新进展后才会再次发送,每个对话最多每 20 秒一次。说明只保存在内存中;设置保存在 `$DSH_HOME/storages/dsh-composer-plus/board-progress.json` 中(仅所有者可访问的文件)。
|
|
192
|
+
- **任务看板:** 看板显示 dsh 自己的对话,数据来自 dsh 在此窗口中自己的列表;它不会添加自己的对话数据。**新建任务** 会打开 dsh 自己的新对话,你在 dsh 的输入框中写第一条消息,因此审批、沙箱和对话的模型照常适用。Host 端把该对话的第一条消息保存为卡片的提示,并以另一次不带工具的请求,把它(只有前 4,000 个字符,没有其他内容)发送给该对话的模型,以获得最多 3 个标签。每个任务的提示、标签和开始时间保存在 `$DSH_HOME/storages/dsh-composer-plus/board-chats.json` 中(仅所有者可访问的文件,保留最新的 2,000 个),还保存你用 **×** 或 **全部清除** 从看板移除的对话的 ID(保留最新的 5,000 个);开关保存在旁边的 `board-switch.json` 中。不会向任何项目文件夹写入内容。**回答** 会把你的回答发送给 dsh 自己的待处理请求,与对话中自己的卡片做法相同。早期版本的旧任务列表(`board.json`)原样留在磁盘上,不会被读取。**悬停显示进度** 在这台 Mac 上读取对话的日志。使用 **快速(不用 AI)**(默认)时,不发送任何内容。使用 **AI 摘要** 时,在正在运行的卡片的进度框显示期间(或在 Tether 的看板打开期间,最多 8 张正在运行的卡片),Host 端会把该对话最新的部分(最多约 6,000 个字符:你的消息、智能体的文字回复、它的工具调用及其结果的末尾;不含推理和已回退的消息)以一次不带工具的请求发送给该对话的模型。只有在对话有了新进展后才会再次发送,每个对话最多每 20 秒一次。说明只保存在内存中;设置保存在 `$DSH_HOME/storages/dsh-composer-plus/board-progress.json` 中(仅所有者可访问的文件)。
|
|
173
193
|
- **受保护的文件:** 列表和开关保存在 `$DSH_HOME/storages/dsh-composer-plus/protected-files.json` 中(仅所有者可访问的文件)。检查只读取每次文件工具调用的路径(及其真实路径),从不读取文件本身。
|
|
174
194
|
- **禁止的命令:** 规则和开关保存在 `$DSH_HOME/storages/dsh-composer-plus/blocked-commands.json` 中(仅所有者可访问的文件)。检查只读取每次 `bash` 和 `pwsh` 调用的命令文本;它不运行任何内容,也不发送任何内容。
|
|
175
|
-
-
|
|
195
|
+
- **密钥输入:** 值只会在回答请求中从卡片(或经由不记录请求内容的网关从 Tether)发送到 Host。Host 将它写入 `$DSH_HOME/storages/dsh-composer-plus/secrets/<随机名称>`(文件夹 0700,文件 0600);不会写入项目、对话记录或工具结果。Host 会在内存中保留该值,以便在该对话之后的工具结果中把它替换为 `[secret]`。文件和这份副本会在该对话这一轮结束时以及 dsh 启动时删除。开关在同一位置的 `secrets.json` 中。代理用该文件运行的命令可以把值发送到该命令发送的地方:这正是它的用途。
|
|
196
|
+
- **项目记忆:** 在你开启之前一直关闭。开启后,每个顶层对话的回合结束时,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 通过同一路由读取和修改笔记。 **记忆版本历史**(默认开启)会在每次保存前,把记忆文件的副本保存在旁边的 `memory/history/` 中(仅所有者可读写,每份记忆保留最新 50 个);它不会向任何模型发送内容。 **把记忆导出到 AGENTS.md** 不会向任何模型发送内容,只有在你点 **写入 AGENTS.md** 时才写入:它只读写该记忆所属项目文件夹中的 `AGENTS.md`(只限其中的普通文件,绝不通过指向文件夹外的符号链接),并且只修改其中的标记区块。 **查找过时的记忆笔记** 不会向任何模型发送内容,也不会写入:它用 realpath 检查项目文件夹内的路径(不读取文件内容),只把 `package.json` 作为文件夹内的普通文件读取,并在那里运行一次 `git for-each-ref`。 **此对话不使用记忆** 会把你关闭记忆的每个对话保存在旁边的 `memory-chats.json` 中(仅所有者可读写,最新的 500 个);这样的对话不会向其模型发送任何记忆。 **从对话中建议记忆笔记** 在你点击 **建议记忆** 之前不会发送任何内容;点击后,它会把该对话所属项目的已保存笔记、全局笔记,以及该对话自己的消息和文字回复(不含工具输出和已回滚的消息;分叉对话中复制自父对话的部分不发送;最多约 24,000 个字符)作为一次不带工具的请求发送给该对话自己的模型。只有在点 **接受** 时才会保存建议。
|
|
176
197
|
- **备份:** 任何数据都不会离开你的电脑。归档保存在 `~/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 进程(救援控制台读取它们,以便拒绝恢复)。
|
|
177
198
|
- **救援控制台:** 一个终端菜单;它不打开网络端口。恢复只写入 dsh 主目录旁边的一个新文件夹(文件使用 `O_EXCL | O_NOFOLLOW` 写入,符号链接最后写入且从不跟随),并拒绝以下归档:含有不安全名称(`..`、绝对路径)、设备文件或 FIFO、多于一个顶层文件夹,或位于链接之下的条目。
|
|
178
199
|
|
|
@@ -194,7 +215,7 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
|
|
|
194
215
|
- **对话行上没有分支标签:** 侧边栏不是“单列表”视图(在“按工作区”和“按工作区树”中,对话行都不显示标签);或者安装此版本后,该对话还没有新的一轮;或者它的文件夹不是 git 仓库;或者 **对话行显示 Git 分支** 已关闭。更新后,请重启 dsh(分支由 Host 端记录)。
|
|
195
216
|
- **目标检查显示测试以代码 127 或 “not found” 退出:** 从 Finder 或程序坞启动的 dsh 的 PATH 可能比终端里的短,因此找不到 `npm`、`pnpm` 或 `cargo`。请从终端启动 dsh,或者在 **目标检查** → **编辑** 中用完整路径设置你自己的测试命令。**立即运行** 会马上显示结果。
|
|
196
217
|
- **目标没有关闭,智能体一直在工作:** **目标检查** 发现了失败的测试或缺少的工作;目标下方的一行会显示原因(将鼠标悬停在结果上可查看详情)。请修正原因或测试命令,或者用 `/goal` 或目标栏自己完成目标(这不会被检查)。
|
|
197
|
-
- **刚发布新版本时安装失败:** 请加上版本号(`dsh-composer-plus@1.
|
|
218
|
+
- **刚发布新版本时安装失败:** 请加上版本号(`dsh-composer-plus@1.21.0`),见上文的安装说明。
|
|
198
219
|
- **立即备份显示“另一个备份操作正在进行”:** 另一个 dsh 窗口或救援控制台中正在运行一个操作(它们共用备份文件夹中的锁文件 `.composer-plus.lock`)。请等待它完成。如果没有操作在运行,下次点击时会接管已关闭进程留下的锁。
|
|
199
220
|
- **救援控制台显示“dsh is running”:** 请先退出 dsh。如果 dsh 确实已关闭,消息中提到的文件是崩溃后留下的:删除它,然后重试。
|
|
200
221
|
- **恢复后 dsh 无法启动或缺少插件:** 需要重新安装 profile 的插件包。恢复后,救援控制台会提供这一步;你也可以在它列出的 `$DSH_HOME/profiles/` 下的每个文件夹中运行 `pnpm install`。不在 vault 中的机密(另一台电脑)必须重新输入:控制台会列出它们。
|
|
@@ -215,11 +236,17 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
|
|
|
215
236
|
- dsh 的队列没有 `move` 操作,所以由插件的 Host 端在 dsh 的队列中直接移动排队的消息本身(一次改动,还是同一条消息)。带有图片或文件的消息也能移动。只有你自己的消息可以移动:队列中的目标轮次或对问题的回答会留在原处。如果在你拖动时有消息开始发送,则不会移动任何消息,并会显示一条提示说明这一点。
|
|
216
237
|
- 如果新版本不改动任何 dsh 设置,dsh 0.2.1 会立即加载更新;否则(以及在 dsh 0.2.0 上),请重启 dsh 来加载更新。插件从不替你重启 dsh。没有 dsh 插件管理器的网页版/CLI profile 只会提示有新版本。
|
|
217
238
|
- **Composer Plus N 的新功能** 使用 **应用语言** 中的语言显示说明。带其他地区的界面语言使用其基础语言的说明(`en-GB` 显示英文说明,`zh-TW` 显示 `zh` 的中文说明)。没有说明的语言(由其他语言包添加的语言,或不是 `pt-BR` 的 `pt-PT`)显示英文说明。说明随新版本一起安装。如果运行的副本没有可读的说明文件(`release-notes.json`),窗口会显示 GitHub 上的英文说明。
|
|
239
|
+
- **拒绝并附言** 会先把附言作为一条消息发进正在等待的这一轮,然后拒绝该请求;dsh 会在对话中把附言显示为你的消息。附言输入框打开时,卡片上只显示 **取消** 和 **拒绝**,所以一次点击不会误允许该请求;`Esc` 或 **取消** 会让 dsh 的按钮重新出现。空附言不会发送任何内容(请使用 dsh 自己的 **拒绝**)。如果附言发出后拒绝失败(例如该请求在此期间已在别处被回答),附言会留在对话中,模型会在它的下一步读到它。按钮放在 dsh 审批卡片的标记(`data-approval-key`)中,因为 dsh 没有给卡片操作的插槽;如果 dsh 更新改变了这部分标记,按钮就不会显示,dsh 自己的 **拒绝** 照常可用。一条附言最多 4,000 个字符。
|
|
240
|
+
- **密钥输入** 只隐藏值的完整原文:同一对话之后的工具结果中,它会被替换为 `[secret]`。但代理仍然可以用 shell 命令读取文件,并以其他形式(base64、其中一部分、加入空格)输出该值,这种形式会到达模型。代理自己的文件工具(read、grep、write、edit)无法打开密钥文件夹。如果该值同时也是常见词,该对话的其他结果中也会显示 `[secret]`。文件会保留到这一轮结束;如果 dsh 在这一轮中退出,下次启动时会删除它。每个对话同一时间只能有一个未完成的请求。该工具会给每次模型请求增加约 870 个字符(估计约 220 个 token):不用时请关闭。
|
|
241
|
+
- **引用回复** 引用的是页面上显示的文字:代码块、表格或列表会变成普通的行,不带 Markdown 标记。如果选区从一条回答开始、在另一条回答结束,或者碰到思考过程、工具行或你自己的消息,就不会显示按钮:请只在一条回答内选择。按钮通过 dsh 的对话结构找到回答,因为 dsh 没有用于文字选区的插槽;如果 dsh 更新改变了这种结构,按钮就不会显示。如果引用位于输入框末尾,后面会多加一个空行,让你接着输入的内容从下一行开始;dsh 发送时会去掉末尾的空行。
|
|
242
|
+
- **旁支对话** 的只读依靠 dsh 自己的只读模式:文件工具不能写入,shell 命令在不可写的 dsh 沙箱中运行(沙箱无法启动时不会运行)。代理仍可以通过 dsh 的审批卡请求更多权限,网络调用(例如 API 请求)仍可能改变计算机之外的东西。副本取自队列中没有消息等待的最新时刻,所以在有排队消息时提出的问题看不到之后发生的事。对话中正在运行的步骤在副本中会被关闭,所以旁支对话知道该步骤的开始,但不知道它的结果。旁支对话是普通对话:它留在侧边栏中并计入你的模型用量,可以在那里归档。“带回”只取旁支对话自己的消息(最多 12,000 个字符),每个问题只取最后一条回复;代理在工具调用之间的说明不会带回。dsh 没有让插件在右侧边栏中显示对话的插槽,所以旁支对话在主视图中打开。
|
|
243
|
+
- **差异批注** 只在改动面板中可用,不能用于 dsh 自己的“上一轮”视图。范围必须在差异的同一个区块内(同一个 `@@` 部分)。批注保存在此浏览器的存储中,所以其他浏览器或其他电脑上的 dsh 看不到;Tether 在内存中保留自己的批注。批注保留你点击时的那些行:代理之后修改文件时,批注仍显示旧的行和行号。每个对话最多 50 条批注,每条最多 2,000 个字符、40 行(超出部分以 `…` 行表示)。
|
|
218
244
|
- **本对话内允许** 从授权的那一刻开始计算时限。新的时限会立即应用于仍在生效的授权,因此更短的时限可能会让它们立即结束。1.12 及更早版本的授权没有时间信息:更新后,代理会就这些工具再询问一次。
|
|
219
245
|
- **保持输入框焦点** 只在发送 `/` 命令或技能后才会把焦点还给输入框。dsh 解析命令时,输入框会有几毫秒处于只读状态,因此这段时间内按下的键会丢失。如果 dsh 的 `/` 菜单仍然打开,`Enter` 会选择高亮的行,而不会发送。
|
|
220
246
|
- **问题卡片适应窗口** 只改变 dsh 的问题卡片,不改变计划审阅卡片。它通过 dsh 的标记(`data-question-key`、`data-question-scroll`)找到卡片;如果 dsh 更新改变了这些标记,卡片会按 dsh 自己的样子显示。卡片高度跟随窗口,而不是对话:在较窄侧边面板中的对话里,较高的卡片仍可能超出对话上方。
|
|
221
247
|
- **对话标题栏适应窗口** 通过 dsh 生成的类名(`_titleRow`、`_titleCluster`、`_crumbs`、`_headerActions`、`_headerUtilities`)找到对话标题栏,因为 dsh 没有为它提供布局接口。如果 dsh 更新改了这些类名,标题栏按 dsh 原样显示。在很窄的对话栏中,标题栏可能占两到三行,所以消息上方的空间会变小。
|
|
222
|
-
- **手机连接** 只适用于 macOS(它使用 `en0`、`openssl`、`swift` 和 `dns-sd`)。它使用固定端口 19390 和 19391,因此每台 Mac 上同一时间只能有一个 dsh 运行它(每台 Mac 是手机 Mac 列表中的一项)。只有在 Tether 打开或刚转入后台时,手机才能收到通知(没有推送服务)。在 Tether 中打开“Settings → Notifications → Send notifications”之前,Tether
|
|
248
|
+
- **手机连接** 只适用于 macOS(它使用 `en0`、`openssl`、`swift` 和 `dns-sd`)。它使用固定端口 19390 和 19391,因此每台 Mac 上同一时间只能有一个 dsh 运行它(每台 Mac 是手机 Mac 列表中的一项)。只有在 Tether 打开或刚转入后台时,手机才能收到通知(没有推送服务)。在 Tether 中打开“Settings → Notifications → Send notifications”之前,Tether 不会发送通知。Tether 为每台已配对的 Mac 分别保存此开关和时间段。此开关在每台 Mac 上都默认关闭,打开时 iOS 会请求通知权限。iOS 应用尚未上架 App Store:请用 Xcode 从 `tether/ios` 构建它。“Tailscale only”仍然需要 Mac 有 Wi-Fi 或以太网地址(只有在有这样的地址时,网关才会启动)。访问日志按 Mac 分别保存,只保留最新的 200 次尝试;一分钟内重复的尝试不会新增一行,而是把同一行的次数加一。Tether 的应用锁不会隐藏 iPhone 锁定屏幕上的通知预览:请在 iOS 设置中关闭它们。Tether 的绿点跟随 Mac:在 dsh 中打开的对话,手机上的绿点也会消失。在 Tether 中打开的对话,只在手机上消失;Mac 上 dsh 自己的绿点会一直保留,直到你在 Mac 上打开该对话。
|
|
249
|
+
- **远程电脑** 需要两台 Mac 都有 Tailscale,并且被打开的 Mac 上要有开启了此功能的 Composer Plus。那台 Mac 必须处于唤醒状态,并且正在运行 dsh。另一台电脑会在屏幕上当前对话的右侧边栏浏览器标签页中打开:这个标签页属于该对话,所以其他对话会显示自己的侧边栏。没有对话时(或在没有浏览器标签页的 dsh web 中),电脑会在浏览器窗口中打开。只有主区域显示对话或新对话界面时,才会显示选择器;任务看板上不显示。它使用端口 19392(每台 Mac 上只有一个 dsh 能让其他电脑进入)。在另一台电脑的页面中打开的电脑没有选择器,所以你不能从那里打开第三台 Mac。
|
|
223
250
|
- 会话链接在对话中有效;点击它不会打开对应的对话。用 **复制消息链接** 复制的链接,只在 dsh 0.2.1 及更高版本中、并且只从对话中的消息里才能打开对应的消息(dsh 0.2.0 没有用户文本规则,所以链接仍会被复制,但只显示为普通文本)。被回退移除的消息,或被压缩从 dsh 加载的历史中移除的消息,无法显示:此时链接会给出提示。🔗 按钮依附在 dsh 的消息行上;如果 dsh 更新改变了这部分标记,按钮就不会显示。
|
|
224
251
|
- **全部标为已读** 通过 dsh 中一个不是公开 API 的部分(dsh 会话状态中的 `completionUnread` 列表)来更改 dsh 自己的未读圆点。如果 dsh 更新重命名了它,该菜单项就不会显示。该菜单项放在 dsh 项目的“…”菜单中,而这个菜单没有给插件的插槽;如果 dsh 修改了这个菜单,该菜单项也不会显示。
|
|
225
252
|
- **原地编辑排队消息** 不会修改在此期间已经开始发送的消息,也不会覆盖在此期间已被修改的消息(例如在 iPhone 上的 Tether 中修改的),并会显示提示说明这一点。新图片需要支持图片的模型(dsh 自身的图片限制同样适用),新文件必须上传完成后才能保存。只能编辑你自己的排队消息,不能编辑队列中的目标轮次或对问题的回答。插件更新后,只有纯文字的编辑能立即生效:保存带图片或文件的消息之前,请重启 dsh(Host 端在启动时加载)。
|
|
@@ -234,6 +261,8 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
|
|
|
234
261
|
- **工作区树中的分支** 会在无需点击的情况下写入 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 的侧边栏行判断);否则它在分支项目中。
|
|
235
262
|
- **在对话中查找** 只搜索页面显示的内容:已加载的消息和回复(向上滚动或点击 **加载更早** 可查看更早的内容),不搜索已收起的工具步骤,也不搜索工具输出中被折叠的文本。它最多统计 2,000 个匹配项(之后显示“2000+”)。它使用浏览器的高亮 API(Chromium 105 及更高版本;桌面应用支持):在较旧的浏览器中,计数和跳转仍然可用,只是没有颜色。`Cmd+F`(Mac)或 `Ctrl+F`(Windows 和 Linux)只在屏幕上有对话时打开它;在其他地方,浏览器自带的查找照常工作。在 Mac 上,`Ctrl+F` 在文本框中仍保持 macOS 的用法(光标向前移动一个字符)。
|
|
236
263
|
- **空闲时打开等待中的对话** 只知道 dsh 自己的窗口看到的操作:在其他应用中的操作不算,因此 dsh 在后台时,它会在 30 秒后打开等待中的对话。它不会把 dsh 带到前台。只阅读而不按键、不点击、不移动鼠标,也算空闲。它只看带有 dsh 橙色圆点(问题、审批或计划审阅)或绿色圆点(你尚未打开的已完成一轮)的对话;子代理的请求显示在其父对话中。橙色对话先打开。打开绿色对话会去掉它的圆点,所以下一个绿色对话要等你下一次按键、点击、移动鼠标、滚动滚轮或触摸后才开始计 30 秒:你回来时,其他绿色圆点仍在。等待中的对话在屏幕上时,不会打开其他对话;你没有回答就离开的对话,在再次 30 秒没有使用后可能会再次打开。30 秒不能更改。
|
|
264
|
+
- **下一个等待中的对话** 计入的对话与 **空闲时打开等待中的对话** 相同:dsh 的橙色圆点(可在此处回答的问题、审批或计划审阅)和绿色圆点(你尚未打开的已完成一轮);子代理的请求显示在其父对话中。dsh 不记录对话开始等待的时间,因此顺序从本窗口看到它的那一刻算起:重新加载后,已在等待的对话保持 dsh 的顺序。该按键是 dsh 快捷键:在 Linux 的浏览器中,它没有默认按键,需要你在 dsh 的键盘快捷键页面中设置;浏览器扩展或其他应用也可能先占用 `Cmd+Shift+E`。dsh 的侧边栏标题栏没有扩展插槽,所以按钮放在 dsh 的标题栏结构中;如果 dsh 更新改变了它,按钮不会显示,但按键仍然可用。窄侧边栏中没有该按钮。
|
|
265
|
+
- **选项按钮** 只读取以选项列表结尾的回答:一个从 1 开始编号、有 1 到 9 项的编号列表,位于回答的最后,紧接在标题或加粗行“选项”或“下一步”之下(也包括英文的“Options”“Choices”“Next steps”以及应用其他语言中的相同词语)。回答中间的列表、代码块中的列表或其他标题下的列表不显示按钮。Composer Plus 不会要求智能体写这样的列表。按钮只显示在最新的回答下,且对话空闲、输入框为空时才显示;并且要等 Composer Plus 知道哪些回答已被回退撤回之后才显示。在 dsh 的问题卡片上,问题出现后的前 0.8 秒内按 1–9 键无效,这样你本想用于别处的按键不会选中你还没读过的选项。dsh 的问题卡片没有按键 API,所以这些按键在 dsh 的标记中查找卡片上的按钮;如果 dsh 更新改变了这些标记,按键将不起作用。
|
|
237
266
|
- 重启前发出的通知,点击后只会把 dsh 带到前台。
|
|
238
267
|
- 活跃项目通过 dsh 保存的项目顺序来移动,因此新顺序在重启后依然保留。不属于任何项目的对话(“未分组”)无法移动;dsh 总是把它们列在最后。
|
|
239
268
|
- dsh 在侧边栏的视图选项菜单中没有扩展点,所以近期项目选项被添加到 dsh 自己的菜单中。如果 dsh 更新修改了这个菜单,该选项将不会显示,所有项目都保持可见。筛选作用于项目行,因此 **单列表** 不会被筛选。在 **按工作区树** 中,只要父文件夹中的某个项目处于活跃状态,父文件夹就会保持显示,最近 2 小时内不活跃的对话行也会被隐藏;在 **按工作区** 中只筛选项目行。筛选会从 dsh 保存的视图设置(不是公开 API)读取 dsh 当前的视图;如果 dsh 更新改了它的名称,**按工作区树** 会按 **按工作区** 的方式筛选。项目状态也读取同一设置:在 **按工作区树** 中,父文件夹的行也会统计其中各项目的对话;如果 dsh 改了该设置的名称,每行只显示自己的对话。**按状态** 也有同类限制:dsh 没有排序插槽,因此该菜单项和行顺序依赖 dsh 的菜单和列表标记。
|
|
@@ -249,9 +278,16 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
|
|
|
249
278
|
- **在新对话中继续** 会把对话(消息、工具调用以及每个工具结果的末尾,最多约 60,000 个字符,最新的部分)发送给对话自己的模型。交接说明可能漏掉某个决定或文件:开始前请先阅读。新对话只知道这份交接说明和链接的对话(dsh 会把旧对话作为只读上下文附加进来);它的模型上下文从很小开始,旧对话保持不变。每个对话同一时间只能进行一次写说明或开始操作。
|
|
250
279
|
- **上下文明细** 按 dsh 自己的规则显示估算值(每个 token 约 4 个字符),与 dsh 的上下文环使用相同的规则;模型自己的计数可能不同。工具定义取自最新的一次请求。它按对话日志中的样子显示上下文;正在运行的回合会在它的下一步之后出现。
|
|
251
280
|
- **计划步骤** 只有在模型确实做了计划时才会节省令牌:开启后,每个请求都会带上 `plan_next_steps` 工具和一段简短说明(约 500 个令牌),即使在模型从不做计划的对话中也是如此。条件只证明它所写的内容(例如:构建的退出码为 0),并不证明工作正确。`ok` 读取 dsh 自己的结果标记(`[exit code: N]`、超时、沙箱拒绝);一个失败但退出码不为非零的命令会被视为通过。步骤一次只运行一个;同时就绪的两个步骤会交回给模型。该步骤的消息会作为对话模型的助手消息保存(dsh 没有标记插件所写消息的方式),因此它的文字会说明是 Composer Plus 运行的。Tether 中没有此功能。
|
|
252
|
-
- **任务看板** 显示 dsh 在此窗口中列出的对话:不在项目中的对话只显示在**所有项目**中,“每个对话一个分支”的文件夹(`<project>/.worktrees/<name>`)算作它所属的项目。卡片所在的列就是对话的实时状态,因此卡片不能拖动:对话的回合结束时(包括出错或停止之后)会移到**已完成**,再次运行时会回到**进行中**。绿色圆点是 dsh 自己的完成圆点,dsh 只在此窗口中保留它:重新加载后,已完成的对话不再显示圆点。**已完成** 显示最新的 50 个对话(**显示更早的 N 个** 显示其余对话)。**搜索项目** 只按名称查找项目,不按文件夹路径查找。当项目的所有对话都超过 2 小时、处于空闲且已读时,**最近 2 小时内活跃** 会隐藏该项目;看板仍会显示你选择的项目。**新建任务** 只记住此窗口中最新的一个新对话:如果你在发出第一条消息前打开了另一个对话,该对话会以 **新建任务** 留在
|
|
281
|
+
- **任务看板** 显示 dsh 在此窗口中列出的对话:不在项目中的对话只显示在**所有项目**中,“每个对话一个分支”的文件夹(`<project>/.worktrees/<name>`)算作它所属的项目。卡片所在的列就是对话的实时状态,因此卡片不能拖动:对话的回合结束时(包括出错或停止之后)会移到**已完成**,再次运行时会回到**进行中**。绿色圆点是 dsh 自己的完成圆点,dsh 只在此窗口中保留它:重新加载后,已完成的对话不再显示圆点。**已完成** 显示最新的 50 个对话(**显示更早的 N 个** 显示其余对话)。**搜索项目** 只按名称查找项目,不按文件夹路径查找。当项目的所有对话都超过 2 小时、处于空闲且已读时,**最近 2 小时内活跃** 会隐藏该项目;看板仍会显示你选择的项目。**新建任务** 只记住此窗口中最新的一个新对话:如果你在发出第一条消息前打开了另一个对话,该对话会以 **新建任务** 留在 **进行中** 的最上方,直到你在其中写消息,但只有最新的那个对话会自动回到看板。重新加载后,没有消息的新对话不会出现在看板上(dsh 把它保留为自己的空白新会话)。标签来自每个任务根据其第一条消息进行的一次模型调用:它们可能不准确,不是在看板上开始的对话没有标签。标题是 dsh 自己的对话标题(由 dsh 的标题服务使用对话的模型生成);标题出现前,卡片显示第一条消息的第一行。**×** 和 **全部清除** 只把卡片从看板移除:不会删除任何对话。**撤销** 只显示 8 秒,并且只在此窗口中;之后,**已移除 (N)** → **放回** 可让卡片回来,再次运行的对话也会自动回来。**全部清除** 会先询问,然后移除所显示项目中已读的已完成卡片(选择 **所有项目** 时为所有项目),也包括 **显示更早的 N 个** 后面的卡片;未读(绿色)卡片会保留。dsh 只在此窗口中保留绿色圆点,因此重新加载后,全部清除可能会移除你还没读过回答的卡片。这个列表保存在这台 Mac 上,对每个窗口和 Tether 都有效;列表达到 5,000 个对话时,最早的对话会回来。**回答** 只回答对话最新的请求:如果对话已在别处(另一个窗口、Tether、Auto Review)回答了它,或提出了新的问题,面板会说明这一点,并且不发送任何内容。早期版本有带评论和智能体工具的任务列表;它们已被移除,旧的 `board.json` 不会显示。创意和外观来自 emanuele-em 的 [Kanzo](https://github.com/emanuele-em/kanzo)(AGPL-3.0);Composer Plus 没有使用它的任何代码。 `Cmd+Shift+K` 是 dsh 快捷键:在 Linux 的浏览器中,它没有默认按键,需要你在 dsh 的键盘快捷键页面中设置;浏览器扩展或其他应用也可能先占用它。卡片在 dsh 自己的绿点消失时(你打开了对话)离开**已完成**;对于在看板后面作为当前对话完成的对话,则在它显示且上面没有面板时离开。这个已读状态和 dsh 自己的圆点一样只保存在当前 dsh 窗口中:重新加载后或在另一个窗口中,所有已完成的对话都算已读,因此都在**最近完成**中。
|
|
253
282
|
- **停止后发送的消息优先** 只在你停止对话后生效(或在某一轮失败后,或打开仍有队列的对话时):对话运行时发送的消息仍会排在队列末尾。它只会越过你自己的排队消息:如果队列中有目标轮次或问题回复,仍保持 dsh 自己的顺序。它会读取 dsh 中一个非公开 API 的部分(被停止的那一轮是否仍在结束中);如果 dsh 更新后改了它的名称,消息要等那一轮结束后才会被移到前面。子代理对话保持 dsh 自己的顺序。
|
|
254
283
|
- **项目记忆** 属于对话的第一个文件夹(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 自己的记忆。
|
|
284
|
+
- **记忆版本历史** 为每份记忆(每个项目和全局记忆)保留最新的 50 个版本,更早的会被删除。一个版本保存的是该项目的整份记忆,而不是一条笔记。**恢复** 会放回该版本的所有文件(包括主题);如果打开版本之后记忆又被修改,就会拒绝恢复。恢复前的记忆会成为一个新版本,所以可以撤销。开关关闭时,不会保留新版本,**恢复** 也会被拒绝;已保留的版本仍在。安装此功能之前的版本不存在:历史从安装后的第一次保存开始。
|
|
285
|
+
- **把记忆导出到 AGENTS.md** 只写入一个项目记忆的笔记;全局笔记、来源和日期不会写入。下次导出会替换整个标记区块,所以你在区块内手动做的修改会丢失(差异会先显示出来);标记之外的文字保持不变。标记损坏时(缺少一个或出现两次),导出会拒绝,直到你修好它们。大于 512 kB 的 AGENTS.md、指向项目文件夹外的符号链接以及非普通文件都会被拒绝。预览之后 AGENTS.md 或笔记有变化时,**写入 AGENTS.md** 会拒绝,需要重新导出。
|
|
286
|
+
- **记忆笔记来源链接** 只适用于安装此版本之后保存的笔记:较早的笔记只记录了对话(或什么都没记录),所以 **来源** 只会打开对话,或者不显示。消息已不存在时(被回滚撤回,或对话已删除),会打开对话并提示该消息已不在。
|
|
287
|
+
- **把记忆复制到其他项目** 一次最多复制 100 条笔记,只能复制到 dsh 列出的项目(读取 dsh 自己的项目列表,窗口不会传入路径)。每份副本都是独立的:之后在一个项目中修改笔记,不会改变副本。只要有一条勾选的笔记放不下(目标的 MEMORY.md 或主题已满,或已有 40 个主题),就不复制任何笔记。目标中已有相同文字和主题的笔记会被跳过,并显示跳过的条数。
|
|
288
|
+
- **查找过时的记忆笔记** 只能找到以它认识的形式写出的内容:代码片段中的路径(`src/cart.ts`)、`npm run` 之后的 npm 脚本(或 `npm test`、`pnpm lint`)、在“分支”一词旁边的代码片段中的分支名。指向项目文件夹外的路径不会报告;只有项目有 `package.json` 时才检查脚本,只有在 git 仓库中才检查分支。一次最多检查 200 项。警告的意思是“现在找不到”,而不是“错误”:之后由构建生成的文件也会被报告。
|
|
289
|
+
- **此对话不使用记忆** 从该对话的下一次模型请求开始生效:已经在运行的请求保持原样。在运行中的对话里切换会让其系统提示词改变一次,因此那一次请求无法使用模型服务商的缓存。子智能体跟随其根对话。对话在记忆关闭期间收到的消息,回顾不会读取,之后重新开启也不会读取。在 dsh 0.2.0 中,新对话界面没有放置按钮的位置:按钮会在第一条消息之后出现在对话标题栏中。
|
|
290
|
+
- **从对话中建议记忆笔记** 最多显示 10 条建议,保留 30 分钟,dsh 重启后失效;之后接受时会提示你重新获取建议。较长的对话会发送最新的消息:最早的智能体回复最先被略去。建议可能有误:接受前请先阅读,之后可在 **打开记忆** 中修改笔记。被拒绝的建议在下次点击时可能再次出现。
|
|
255
291
|
- **备份** 只使用一个固定文件夹 `~/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 的归档计入自己的保留份数,并可能删除它们。
|
|
256
292
|
- **恢复** 只在 dsh 关闭时于救援控制台中运行:它会替换整个 dsh 主目录。旧目录会以 `.dsh.pre-restore-<time>` 保留在旁边,直到你删除它,因此磁盘需要能容纳两者。对话保留其项目路径:在另一台电脑上,位于其他路径的项目会显示为缺失,直到你重新添加它。指向 dsh 主目录之外的符号链接(例如从其他文件夹链接的技能)会作为链接恢复;它们的目标必须存在于那台电脑上。
|
|
257
293
|
- **会话日志检查** 按照 dsh 自己判断能否打开的规则读取每个对话的最新日志:不是 JSON 或顺序错乱的行,只有在其后还有回合结束时才算损坏(否则 dsh 会打开该对话,只是不含从该行起的各行,因此不会列出它)。它不会按照 dsh 自己的事件规则检查日志中的事件,因此被判为健康的日志在 dsh 升级后仍可能无法打开。修复会从一份备份中取回副本:该备份之后的消息会从该对话中丢失(损坏的文件保留在旁边)。在此 dsh 中打开的对话不会在设置中修复:dsh 正持有它。
|
|
@@ -286,7 +322,13 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
|
|
|
286
322
|
|
|
287
323
|
**智能体能像 DS Bot 的记忆那样,在不同对话之间记住我的偏好吗?** 可以,使用 **项目记忆**(默认关闭):在 **设置 → Composer Plus** 中开启。每个回合结束后,你长期的偏好和决定会作为简短笔记保存到该对话的项目中,该项目的每个新对话都会读取。让智能体记住某件事,它会立即保存。要查看或修改笔记,请点同一行的 **打开记忆**,写下要修改的内容。
|
|
288
324
|
|
|
289
|
-
|
|
325
|
+
**我或 AI 对记忆做了错误的修改。能找回原来的笔记吗?** 可以,使用 **记忆版本历史**(默认开启):在 **打开记忆** 中选择该项目,然后点 **历史**。选择修改之前的版本查看会恢复什么,然后点 **恢复**。
|
|
326
|
+
|
|
327
|
+
**我能把项目记忆分享给团队或其他智能体工具吗?** 可以,使用 **把记忆导出到 AGENTS.md**(默认开启):在 **打开记忆** 中选择该项目,然后点 **导出到 AGENTS.md**。检查差异后点 **写入 AGENTS.md**,再提交该文件。
|
|
328
|
+
|
|
329
|
+
**AI 能从很长的对话中建议要保留的内容吗?** 可以,使用 **从对话中建议记忆笔记**(在 **项目记忆** 开启时默认开启):点对话标题栏中的 **建议记忆**,然后 **接受** 值得保留的笔记。
|
|
330
|
+
|
|
331
|
+
**我能把所有对话看成一个看板,并从中开始新对话吗?** 可以,使用**任务看板**(默认开启):在左侧边栏打开它。每个对话都是一张卡片,位于**进行中**、**审核**(等待你处理)或**已完成**中。**新建任务**会在项目中打开 dsh 的新对话,你的第一条消息发出后会回到看板;在橙色卡片上点击**回答**,无需打开对话即可回答。**已完成**中的**全部清除**会先询问,然后把你已读的已完成卡片从看板移除;**撤销**和**已移除 (N)**可让它们回来,对话仍保留在 dsh 中。
|
|
290
332
|
|
|
291
333
|
**dsh 能像 dsh-backup 那样备份我的对话和设置吗?** 可以:**设置 → Composer Plus → 备份 → 立即备份**。它把相同格式的归档写入同一个文件夹(`~/Desktop/dsh-backups`),因此 dsh-backup 的归档也会显示并可以恢复,你可以卸载 dsh-backup。打开 **自动备份** 即可按计划备份。
|
|
292
334
|
|
|
@@ -314,10 +356,22 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
|
|
|
314
356
|
|
|
315
357
|
**如何阻止智能体运行 `npm publish` 或 `git push --force`?** **设置 → Composer Plus → 禁止的命令**:输入 `npm publish`,选择 **阻止** 或 **先询问**,然后点击 **添加**。**阻止** 会拒绝该命令,智能体会问你;**先询问** 每次都会显示审批卡片。受保护的文件覆盖智能体的文件工具;禁止的命令覆盖它的 shell 命令。
|
|
316
358
|
|
|
359
|
+
**我能告诉智能体为什么拒绝了一个工具调用吗?** 可以,使用 **拒绝并附言**(默认开启):点击审批卡片上的 **拒绝并附言…**,写下原因或应改做什么,然后点击 **拒绝**。智能体会在同一轮中读到拒绝和你的附言。
|
|
360
|
+
|
|
361
|
+
**如何不在对话中输入就把密码或令牌交给代理?** 使用 **密钥输入**(默认开启):让代理使用 `request_secret`,或等它主动询问。在工具行的卡片中输入值,然后点击 **保存**。代理只拿到保存该值的文件路径,文件在这一轮结束时删除。
|
|
362
|
+
|
|
363
|
+
**如何只回复长回答中的一部分?** 选中那一部分,然后点击选区上方的 **引用**(**引用回复**,默认开启)。这部分会以 `> …` 引用的形式进入输入框,你在下面写回复即可。
|
|
364
|
+
|
|
365
|
+
**能在代理工作时提问而不打断它吗?** 输入问题,然后点击输入框中的 **在旁支对话中提问**(**旁支对话**,默认开启)。此对话的只读副本会回答,而原对话继续工作。在旁支对话中,**带回** 会把回答放入原对话的输入框。
|
|
366
|
+
|
|
367
|
+
**如何告诉代理在它的差异中要改什么?** 在 **改动面板** 中打开文件的差异,点击某一行的 **+** 并写下批注(**差异批注**,默认开启)。然后点击 **发送到输入框**:批注会连同文件、行号和这些行一起进入输入框。
|
|
368
|
+
|
|
317
369
|
**如何让 Auto Review 在同一个对话中不再反复询问同一个工具?** 点击审批卡片上的 **本对话内允许**。它只覆盖该对话中的这个确切工具,默认有效 1 小时;可以在标题栏的标签中撤销它。在 **设置 → Composer Plus → 本对话内允许** 中更改时间。
|
|
318
370
|
|
|
319
371
|
**我的 iPhone 丢了。如何阻止它访问我的 Mac?** 点击侧边栏左下角的 **手机连接**,然后点击该 iPhone 旁边的 **Remove**。它的密钥会立即失效;只有通过你在 Mac 上批准的新配对,它才能重新连接。
|
|
320
372
|
|
|
373
|
+
**如何在这台 Mac 上继续另一台 Mac 的对话?** 在另一台 Mac 上开启 **设置 → Composer Plus → 远程电脑** 和 **允许其他电脑打开本机**,点击 **创建配对链接** 并复制链接(例如用 AirDrop 或备忘录发给自己)。在这台 Mac 上也开启 **远程电脑**,在对话标题左侧选择 **添加电脑…**,粘贴链接并点击 **连接**,然后在另一台 Mac 上点击 **批准**。之后,在同一个菜单中选择那台电脑即可。
|
|
374
|
+
|
|
321
375
|
**可以用 Face ID 锁定 Tether 吗?** 可以:在 Tether 中打开“Settings → Privacy → Lock with Face ID”。之后,Tether 在打开时以及你回到它时,都会要求 Face ID(或密码)。
|
|
322
376
|
|
|
323
377
|
**如何在 dsh 侧边栏中只显示我今天用过的项目?** 侧边栏 → 视图选项(滑块图标)→ **最近 2 小时内活跃**。再次选择该项即可显示所有项目。
|
|
@@ -330,6 +384,10 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
|
|
|
330
384
|
|
|
331
385
|
**dsh 能自己打开向我提问的对话吗?** 可以,使用 **空闲时打开等待中的对话**(默认开启):当某个对话在等待回答、审批或计划审阅,而你 30 秒没有使用 dsh 时,dsh 会打开它。完成了你尚未查看的一轮的对话(绿色圆点)也会这样打开,在橙色对话之后。你在输入、滚动或移动鼠标时,它会等待。
|
|
332
386
|
|
|
387
|
+
**能直接跳到下一个在等我的对话吗?** 可以,使用 **下一个等待中的对话**(默认开启):按 `Cmd+Shift+E`(Windows 和 Linux 上为 `Ctrl+Shift+E`),或点击侧边栏标题栏中带数字的按钮。提出问题或等待审批的对话排在前面,然后是完成了你尚未查看的一轮的对话。
|
|
388
|
+
|
|
389
|
+
**能一键回答智能体给出的选项吗?** 可以,使用 **选项按钮**(默认开启):当回答以“选项”列表结尾时,点击回答下方的按钮。它会把“Option N: …”作为你的消息发送。在智能体的提问卡片上,按 1–9 键。
|
|
390
|
+
|
|
333
391
|
**如何把 DeepSeek Harness 界面切换为土耳其语、西班牙语、日语……?** 设置 → Composer Plus → **应用语言**。
|
|
334
392
|
|
|
335
393
|
**如何在 iPhone 上使用 dsh?** 用 Xcode 从 `tether/ios` 构建 Tether 应用,开启 **设置 → Composer Plus → 手机连接(iPhone)**,点击左下角的 **手机连接**,扫描二维码(用 iPhone 相机或 Tether 中的 **Scan code**),轻点 **Connect**,然后点击 **Approve**。不在家时,请在两台设备上都使用 Tailscale。
|
|
@@ -359,6 +417,10 @@ PLAYWRIGHT=/path/to/playwright node test/browser-recent-finished.mjs /path/to/ds
|
|
|
359
417
|
PLAYWRIGHT=/path/to/playwright node test/browser-recent-tree.mjs /path/to/dsh/lib/bin.js
|
|
360
418
|
# Order by status (fake model + Schedule): real-app test + its thumbnail
|
|
361
419
|
SHOT=1 PLAYWRIGHT=/path/to/playwright node test/browser-status-order.mjs /path/to/dsh/lib/bin.js
|
|
420
|
+
# Next waiting chat and Option buttons (fake model): the sidebar button and Cmd+Shift+E open the waiting chats in order, the Keyboard shortcuts row, the option buttons and the question card keys, switch off + their thumbnails
|
|
421
|
+
SHOT=1 PLAYWRIGHT=/path/to/playwright node test/browser-agentbox-ideas.mjs /path/to/dsh/lib/bin.js
|
|
422
|
+
# Reject with note, Secret input, Quote in reply, Side chat and Diff notes (fake model + a test-only approval gate): the button on dsh's card, the note after the rejection in the next request, Esc; the secret card, Save, the value in no request, file or page, Decline, Stop; a selected part of an answer → Quote → the sent message; a side question while the chat waits on a card (read-only, no queued message in it), Bring back; notes on a diff line and range → Send to composer → the sent message; switch off + their thumbnails
|
|
423
|
+
SHOT=1 PLAYWRIGHT=/path/to/playwright node test/browser-t3code-ideas.mjs /path/to/dsh/lib/bin.js
|
|
362
424
|
# every Settings feature row shows a loading screenshot and a ? link to its README row
|
|
363
425
|
PLAYWRIGHT=/path/to/playwright node test/browser-settings-shots.mjs /path/to/dsh/lib/bin.js
|
|
364
426
|
# What's new after an update: the release notes show once, Esc and Close close them
|
|
@@ -408,7 +470,7 @@ PLAYWRIGHT=/path/to/playwright node test/browser-continue-queue.mjs /path/to/dsh
|
|
|
408
470
|
SHOT=1 PLAYWRIGHT=/path/to/playwright node test/browser-queue-stop-send.mjs /path/to/dsh/lib/bin.js
|
|
409
471
|
# Edit queued message in place with images and files (slow fake model) + its thumbnail
|
|
410
472
|
SHOT=1 PLAYWRIGHT=/path/to/playwright node test/browser-queue-edit.mjs /path/to/dsh/lib/bin.js
|
|
411
|
-
# Task board: New task opens dsh's new chat and comes back after the first message, AI tags, live columns, Answer on the board,
|
|
473
|
+
# Task board: New task opens dsh's new chat and comes back after the first message, AI tags, live columns, Answer on the board, × with Undo, Clear all with its question (unread cards stay), Removed and Put back (kept after a restart), the switch
|
|
412
474
|
SHOT=1 PLAYWRIGHT=/path/to/playwright node test/browser-task-board.mjs /path/to/dsh/lib/bin.js
|
|
413
475
|
```
|
|
414
476
|
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|