@songtonyli/dsh-cli 0.1.17 → 0.1.19
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.md +1 -1
- package/bin/dsh.mjs +1 -1
- package/node_modules/@deepseek-ai/dsh-api-session-controller/lib/types/client/sessions/queue-mirror.js +61 -0
- package/node_modules/@deepseek-ai/dsh-client-locale/lib/client.js +7 -7
- package/node_modules/@deepseek-ai/dsh-client-ui-agent-preset/lib/client.js +61 -61
- package/node_modules/@deepseek-ai/dsh-client-ui-approval/lib/client.js +11 -11
- package/node_modules/@deepseek-ai/dsh-client-ui-attachment/lib/client.js +55 -55
- package/node_modules/@deepseek-ai/dsh-client-ui-chat/lib/client.js +182 -182
- package/node_modules/@deepseek-ai/dsh-client-ui-commands/lib/client.js +16 -16
- package/node_modules/@deepseek-ai/dsh-client-ui-conversation/lib/client.js +151 -151
- package/node_modules/@deepseek-ai/dsh-client-ui-cordis/lib/client.js +74 -74
- package/node_modules/@deepseek-ai/dsh-client-ui-deliverables/lib/client.js +76 -76
- package/node_modules/@deepseek-ai/dsh-client-ui-directory-picker-browse/lib/client.js +39 -39
- package/node_modules/@deepseek-ai/dsh-client-ui-goal/lib/client.js +16 -16
- package/node_modules/@deepseek-ai/dsh-client-ui-input-trigger/lib/client.js +23 -23
- package/node_modules/@deepseek-ai/dsh-client-ui-jobs/lib/client.js +15 -15
- package/node_modules/@deepseek-ai/dsh-client-ui-layout/lib/client.js +8 -8
- package/node_modules/@deepseek-ai/dsh-client-ui-message-feedback/lib/client.js +13 -13
- package/node_modules/@deepseek-ai/dsh-client-ui-model-selection/lib/client.js +27 -27
- package/node_modules/@deepseek-ai/dsh-client-ui-open-in-app/lib/client.js +6 -6
- package/node_modules/@deepseek-ai/dsh-client-ui-permission-presets/lib/client.js +18 -18
- package/node_modules/@deepseek-ai/dsh-client-ui-plan/lib/client.js +22 -22
- package/node_modules/@deepseek-ai/dsh-client-ui-plugin-manager/lib/client.js +115 -115
- package/node_modules/@deepseek-ai/dsh-client-ui-schedule/lib/client.js +14 -14
- package/node_modules/@deepseek-ai/dsh-client-ui-settings-general/lib/client.js +40 -40
- package/node_modules/@deepseek-ai/dsh-client-ui-settings-models/lib/client.js +85 -85
- package/node_modules/@deepseek-ai/dsh-client-ui-settings-plugin-inventory/lib/client.js +35 -35
- package/node_modules/@deepseek-ai/dsh-client-ui-settings-plugins/lib/client.js +61 -61
- package/node_modules/@deepseek-ai/dsh-client-ui-settings-signin/lib/client.js +24 -24
- package/node_modules/@deepseek-ai/dsh-client-ui-settings-unarchive-sessions/lib/client.js +10 -10
- package/node_modules/@deepseek-ai/dsh-client-ui-sidebar/lib/client.js +41 -41
- package/node_modules/@deepseek-ai/dsh-client-ui-sidebar-browser/lib/client.js +17 -17
- package/node_modules/@deepseek-ai/dsh-client-ui-sidebar-documentpreview/lib/client.js +68 -68
- package/node_modules/@deepseek-ai/dsh-client-ui-sidebar-documentpreview/lib/client.pdf.js +12 -12
- package/node_modules/@deepseek-ai/dsh-client-ui-sidebar-files/lib/client.js +21 -21
- package/node_modules/@deepseek-ai/dsh-client-ui-sidebar-right/lib/client.js +24 -24
- package/node_modules/@deepseek-ai/dsh-client-ui-sidebar-terminal/lib/client.js +18 -18
- package/node_modules/@deepseek-ai/dsh-client-ui-sidebar-terminal/lib/client.terminal.js +11 -11
- package/node_modules/@deepseek-ai/dsh-client-ui-skill/lib/client.js +19 -19
- package/node_modules/@deepseek-ai/dsh-client-ui-subagent/lib/client.js +38 -38
- package/node_modules/@deepseek-ai/dsh-client-ui-theme/lib/client.js +25 -25
- package/node_modules/@deepseek-ai/dsh-client-ui-tool/lib/client.js +70 -70
- package/node_modules/@deepseek-ai/dsh-client-ui-trajectory/lib/client.js +198 -198
- package/node_modules/@deepseek-ai/dsh-client-ui-user-questions/lib/client.js +50 -50
- package/node_modules/@deepseek-ai/dsh-client-ui-workflow-run/lib/client.js +24 -24
- package/node_modules/@deepseek-ai/dsh-client-ui-workspace/lib/client.js +81 -81
- package/node_modules/@deepseek-ai/dsh-experimental-client-ui-agent-team/lib/client.js +25 -25
- package/node_modules/@deepseek-ai/dsh-llm-cursor/README.i18n.yaml +2 -2
- package/node_modules/@deepseek-ai/dsh-llm-cursor/README.md +12 -6
- package/node_modules/@deepseek-ai/dsh-llm-cursor/README.zh.md +12 -6
- package/node_modules/@deepseek-ai/dsh-llm-cursor/lib/index.js +548 -51
- package/node_modules/@deepseek-ai/dsh-session-log-export/lib/client.js +3 -3
- package/node_modules/@deepseek-ai/dsh-subprocess-local/lib/runner-launch-UEJ3Ntqn.js +1511 -0
- package/node_modules/@deepseek-ai/dsh-tui-app/README.i18n.yaml +2 -2
- package/node_modules/@deepseek-ai/dsh-tui-app/README.md +126 -32
- package/node_modules/@deepseek-ai/dsh-tui-app/README.zh.md +125 -31
- package/node_modules/@deepseek-ai/dsh-tui-app/lib/index.js +3125 -356
- package/node_modules/@deepseek-ai/dsh-tui-app/lib/startup.js +3 -2
- package/package.json +1 -1
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
description: "dsh 的交互式终端模式:在你的终端里与 agent
|
|
2
|
+
description: "dsh 的交互式终端模式:在你的终端里与 agent(智能体)对话,带流式回复、工具卡片、用键盘浏览对话记录、把各轮次并排读出的全屏阅读器、审批、提问、斜杠命令、@ 引用、附件与会话切换。"
|
|
3
3
|
kind: "package-bundle"
|
|
4
4
|
---
|
|
5
5
|
|
|
@@ -9,7 +9,7 @@ kind: "package-bundle"
|
|
|
9
9
|
|
|
10
10
|
## 概述
|
|
11
11
|
|
|
12
|
-
`dsh-tui-app` 是 dsh 的终端表层:`dsh tui`
|
|
12
|
+
`dsh-tui-app` 是 dsh 的终端表层:`dsh tui` 在你的终端里启动一个多轮会话,没有浏览器、也没有服务器。回复流式显示,工具调用变成可折叠的卡片,审批与 `ask_user_question` 的问题出现在输入框上方,`@` 补全路径与会话,`/` 命令与 Web 共用注册表。方向键在停靠的检视面板中走遍对话记录;`Ctrl+G` 把它整屏读出、各轮次并排。会话持久化:`/sessions`、`/new` 与 `/fork` 在会话间切换,`/export` 写出浏览器的 ZIP,`--resume` 稍后继续。它运行 `dsh web` 的模型、工具与安全默认值,同一时间一个会话。
|
|
13
13
|
|
|
14
14
|
## 目录
|
|
15
15
|
|
|
@@ -40,33 +40,108 @@ dsh tui --no-open # print sign-in URLs without opening a
|
|
|
40
40
|
|
|
41
41
|
### 屏幕布局
|
|
42
42
|
|
|
43
|
-
页眉在标题生成或设置后以标题命名会话,并在旁边显示 id。对话记录在终端自身的回滚区中增长:你的提示以 `›` 开头(附件列在其下),assistant 的推理以暗色显示在 Markdown 回复上方,每次工具调用是一张卡片,含状态符号、工具名、呈现器标题,以及折叠到 `toolPreviewLines` 行的正文。非空的系统提示词与每一条注入的上下文——instructions、catalogs、snapshots、notices、relays 与 recalls——绘制为暗色 `⬡`
|
|
43
|
+
页眉在标题生成或设置后以标题命名会话,并在旁边显示 id。对话记录在终端自身的回滚区中增长:你的提示以 `›` 开头(附件列在其下),assistant 的推理以暗色显示在 Markdown 回复上方,每次工具调用是一张卡片,含状态符号、工具名、呈现器标题,以及折叠到 `toolPreviewLines` 行的正文。非空的系统提示词与每一条注入的上下文——instructions、catalogs、snapshots、notices、relays 与 recalls——绘制为暗色 `⬡` 标题,其下是面向模型文本的前 `contextPreviewLines` 行,快照的每一份贡献具名写在其自身各行上方;空的系统提示词与压缩替换则省略。承载的行数多于其绘制行数的工具卡片与上下文块,结尾都是同一条标记:该块被对话记录的焦点持有时为 `… <n> more rows · Space expands`,否则为 `… <n> more rows · Ctrl+O expands`。流式回复文字会淡入,而且每个词各走各的时钟:一个词以接近终端背景色的亮度出现,并经 `streamFadeSteps` 次、每次 `streamFadeStepMs` 提亮到它最终稳定的颜色,因此流得更快只会留下更长的一串正在提亮的词,而不会更暗。流式推理与工具卡片在同一时长内浮出:它们以抬高的颜色出现,再退回到稳定时的暗色斜体或调色板颜色;从持久化历史重绘的卡片不带淡入,已经稳定下来的文字也不会再被调暗。
|
|
44
44
|
|
|
45
|
-
|
|
45
|
+
对话记录下方依次是 agent 工作时的旋转指示、任何打开的提示、编辑器、子 agent 面板,以及页脚:未聚焦时是一行由两端向内构建的状态栏。编辑器的光标是终端自身的闪烁竖条:应用在启动时请求这一形状,退出时把你的默认形状还回去,而状态栏或面板持有键盘期间完全不绘制光标。模型锚定在左端且永不丢弃——超过 20 列时退回到裸模型名,只有仍然过宽的标签才会被省略号截断——离开编辑器的那两个按键则锚定在右端,写作 `Shift+↑ read · Shift+↓ status`,窄到一定程度收缩为 `Shift+↑↓ nav`,不足 40 列时整体丢弃。关键事实填满剩下的中间部分,按状态栏顺序排列:推理强度(选择把推理交给模型时标为 `effort default`)、进行中轮次的已用时间、上下文窗口百分比、todo 计数,以及 workspace 路径(过长时以 `~` 与 `…/` 缩短)。中间部分容纳不下的每个分段都折进末尾的 `+N`,未聚焦行从不绘制的那些分段也一并折入——权限预设、累计 token 用量、来自投影接缝的目标与计划模式标记,以及待发送附件的数量。压缩与模型请求重试以通知形式出现,与浏览器标记承载的事实相同。
|
|
46
46
|
|
|
47
|
-
|
|
47
|
+
键盘在对话记录中移动时,编辑器正上方停靠着一个带边框的检视面板,边框即模式:它恰好在对话记录持有键盘时绘制。其顶边线带有一个反白的 ` ● READ ` 徽标与当前聚焦小节的标题——该小节在可导航块中的位置、所属轮次,以及这是哪一种小节——例如 `╭ ● READ ─ 3/12 · turn 2 · bash git status · result ─╮`。其下在块含多个部分时,把这些部分绘制成形如 `← 1 call · [2 result] →` 的带编号、会折行的选择行,被持有的标签除强调色外还加上方括号,因此完全无颜色时选择仍然可读;再往下是该小节自身的源文本行,每行以 `│ ` 起头并按窄两列换行,对每一种小节——含系统提示词与注入的上下文——都折叠到 `focusPreviewLines` 行,其下写出 `… <n> more rows · Ctrl+G reads it`。底边线列出对话记录所应答的按键 `↑↓ sections · ←→ parts · Space folds · Ctrl+G reader · Esc input`,随着终端列数减少收缩为 `↑↓ ←→ · Space folds · Esc input`,再收缩为 `Esc input`。
|
|
48
|
+
|
|
49
|
+
被聚焦的块也会在原地被标记:一条两列宽的标记条,在块的其他行旁为暗色、在被聚焦小节自身的行旁为强调色——若折叠把该小节整个留在了绘出的行之外,强调色便落在那一行折叠标记旁——标记绘制期间该块的内容按窄两列换行。这个标记只能落在 pi-tui 仍以差分方式重绘的行上——也就是它写出的上一帧的最后 `rows` 行,这条边界只会被更高的帧抬高、不会被更矮的帧降低——因为改动其上方的任何一行都会清空终端的回滚区。已经滚过该位置的块不带标记条,检视面板的标题追加 ` · off screen`,其边框线也改画暗色而非强调色,于是边框本身就报告出标记无法画在该块所在之处。淡入中的各行抵达这一边界时,会在写出它们的同一帧内被结算为最终颜色,因此回滚区里不会留下暗色文字。
|
|
50
|
+
|
|
51
|
+
在任一区域按 `Ctrl+G`、在对话记录的某个小节上按 `Enter`,以及 `/turns`,都会整屏读出对话记录。阅读器是合成进视口的浮层,因此不占用对话记录的任何一行,也让重绘边界保持原位。其顶边线带有 ` ● READER ` 徽标、`turn <n> of <total>` 与对话记录中的位置;左侧的轮次栏每个轮次一行——被持有的那行带 `▸`、轮次编号、其提示的首行,以及右对齐的标记 `⬡<n>` 注入上下文块数、`✻` 有推理、`¶` 有回复、`⚒<n>` 工具调用数——因此各轮次一眼可比;旁边的窗格把被持有轮次的各小节堆叠在 `── <label> · turn <n> ` 标题之下,被持有的小节加粗,且其每一行都带强调色的 `▌`。那里的行从不折叠:阅读器正是读取系统提示词、注入快照、长回复或工具结果完整面向模型文本的地方。在各小节中按 `Enter` 把被持有的小节固定进第二个窗格,于是来自不同提示的两个小节并排出现,在已固定的小节上按 `Enter` 取消固定;列数不足 `readerMinColumns` 时固定仍被记录,但只绘制一个窗格,按键提示改为 `compare needs <n> columns`。`/` 在按键提示的位置打开一行查询,把轮次栏收窄到提示或文本匹配的轮次,读数写作 `<kept>/<total> turns`;其余时候提示边线在右端报告 `turn 3/12 · section 2/9 · row 14/212`,任何宽度都不会丢弃它。不足 60 列时正文一次只画一栏,不足 24 列或 8 行时只画一行暗色文字 `terminal too small for the reader (needs 24×8)`,并且只应答 `Esc`、`Ctrl+G` 与 `Ctrl+C`。它在每一帧都重新读取对话记录,因此流式回复会在其中增长、落地的工具结果会出现、新轮次会加入轮次栏;改变终端大小时它按正在阅读的小节重新锚定,而不是按行号;审批或提问出现时它在该提示存续期间让位;切换会话会让它随通知 `the transcript changed · reader closed` 一同关闭。
|
|
52
|
+
|
|
53
|
+
临时按键反馈以一行暗色带框文字浮在视口右上角:`press Esc again to stop turn <n>`、`press Ctrl+C again to quit`、`nothing in the transcript to read yet` 与 `above the repaint window · opened in the reader`。它以全亮度保持 `toastMs`、随后淡出,不占用对话记录自身的任何一行,也不接管键盘;渲染器已无法重绘视口顶部时,它改为打印进对话记录,从而被保留下来。值得留存的事实则是对话记录中的通知:`stopping the turn…`、`wait for the session switch to finish` 以及每一条命令结果。
|
|
54
|
+
|
|
55
|
+
动效不止于流式文本,而且每种效果都乘着同一个淡入时钟。键盘落到对话记录、子 agent 面板或状态栏上时,会把该表层的边框、其徽标与它持有的标记抬亮六拍;对话记录走查中的一步把新聚焦的标记条抬亮三拍;状态栏上的一步把所选标签抬亮四拍;阅读器用六拍长出、用四拍缩回,并自其底边线向上绘制,因此它画出的每一行都不会滑动。任何抬亮都不改变任何东西绘制的行数,而 `reducedMotion`——与 `NO_COLOR`、被禁用的调色板和 `TERM=dumb` 一样——会把它们全部关闭,并且不为它们安排任何重绘。
|
|
56
|
+
|
|
57
|
+
子 agent 面板在绑定会话之下有常驻的子 agent 会话、或列表中带有无法读取的候选者时绘制。未聚焦时它是一行摘要,含列出的数量与第一个子会话的关键标签;聚焦时其标题统计所列出的条目,并以它所应答的按键 `↑↓ children · Enter details · Tab regions · Esc input` 结尾,在容纳不下时收缩为 `↑↓ children · Esc input`,再收缩为 `Esc input`;每一行给出该子会话的层级缩进、其标签或 id、其模式(`one-shot` 或 `continuable`)、`resident`、其 agent 处于 `running` 还是 `idle`、其已用时间——进行中轮次的用时,否则是已结束轮次的合计——以及其 token 用量,以本进程对该子会话的可见程度与已组合的投影所能提供的为限。最多绘制六行,其下是 `+<n> more · /subagents lists them all`;列表无法解读的候选者绘制为 `unreadable: <reason>` 且打不开任何页面,读取失败的列表则保留上一次成功读取产生的各行,并在其下写出 `listing failed: <reason>`。面板随其最后一行一同消失。
|
|
48
58
|
|
|
49
59
|
### 按键与命令
|
|
50
60
|
|
|
61
|
+
对话记录、编辑器、子 agent 面板与状态栏按屏幕绘制它们的顺序排布,`Up` / `Down` 穿过编辑器走遍这一序列:在最新小节上按 `Down`、在面板第一行上按 `Up`、在没有绘制面板时于状态栏上按 `Up`,都会落到光标处。`Tab` 与 `Shift+Tab` 走遍已绘制的各区域,并在两端环绕。在其中任何一个区域按下可打印键都会回到编辑器并在那里输入,因此在阅读时开始写的句子会落在它所指向的地方;对话记录中的 `Space` 是唯一的例外,它折叠被标记的工具卡片或上下文块。`Ctrl+G` 与 `Ctrl+O` 在这些区域中含义完全相同,而 `Ctrl+C` 与 `Ctrl+D` 会先把键盘交还编辑器再行动。提示与阅读器则各自持有整条按键流,并以交还键盘的方式应答 `Ctrl+C`。
|
|
62
|
+
|
|
63
|
+
编辑器持有键盘时:
|
|
64
|
+
|
|
51
65
|
| 按键 | 效果 |
|
|
52
66
|
|---|---|
|
|
53
67
|
| `Enter` | 发送编辑器文本;轮次进行中时它排队到下一轮次 |
|
|
54
|
-
| `Ctrl+S` | 轮次进行中时,把编辑器文本引导(steer)进当前轮次的下一步 |
|
|
55
68
|
| `Shift+Enter` | 插入换行 |
|
|
56
|
-
| `
|
|
69
|
+
| `Ctrl+S` | 轮次进行中时,把编辑器文本引导(steer)进当前轮次的下一步 |
|
|
57
70
|
| `Up` / `Down` | 调出先前的提示 |
|
|
58
|
-
| `
|
|
59
|
-
| `Shift+
|
|
60
|
-
| `
|
|
61
|
-
| `
|
|
71
|
+
| `Tab` | 采用编辑器给出的补全 |
|
|
72
|
+
| `Shift+Tab` | 循环切换当前模型的推理强度,从下一次请求生效 |
|
|
73
|
+
| `Shift+Up` | 把焦点放到对话记录上、停在走查上次停下的小节;首次进入以及切换会话后的首次进入停在最新小节 |
|
|
74
|
+
| `Shift+Down` | 面板已绘制时把焦点放到子 agent 面板的第一行,否则放到状态栏 |
|
|
75
|
+
| `Ctrl+G` | 整屏读出对话记录,停在其最新小节 |
|
|
76
|
+
| `Ctrl+O` | 展开或折叠所有工具卡片与上下文行 |
|
|
77
|
+
| `Esc` | 装填停止并给出提示;该提示仍在屏幕上时再按一次会停止正在进行的轮次,已排队的消息保持排队 |
|
|
62
78
|
| `Ctrl+C` | 清空编辑器;600 ms 内再按一次则退出 |
|
|
63
79
|
| `Ctrl+D` | 编辑器为空时退出 |
|
|
64
80
|
|
|
65
|
-
|
|
81
|
+
仅仅交还了键盘的 `Esc`——离开某个区域、关闭页面、选择器或阅读器——会打开一个 750 ms 的窗口,其间到达编辑器的 `Esc` 完全不做任何事,因此习惯性的连按停不掉任何轮次。没有轮次进行时,`Esc` 在补全列表打开时关闭它,其余情况保持沉默。尚无可读内容的会话对 `Shift+Up` 与 `Ctrl+G` 回以 `nothing in the transcript to read yet`,并把键盘留在编辑器。
|
|
66
82
|
|
|
67
|
-
|
|
83
|
+
对话记录持有键盘时:
|
|
84
|
+
|
|
85
|
+
| 按键 | 效果 |
|
|
86
|
+
|---|---|
|
|
87
|
+
| `Up` / `Down` | 上一个 / 下一个小节;在最新小节上按 `Down` 落到编辑器 |
|
|
88
|
+
| `Shift+Up` / `Shift+Down` | 上一个 / 下一个块,停在该块的第一个小节 |
|
|
89
|
+
| `PageUp` / `PageDown` | 上一个 / 下一个轮次,停在该轮次的第一个小节 |
|
|
90
|
+
| `Home` / `End` | 最早 / 最新的小节 |
|
|
91
|
+
| `Left` / `Right` | 被持有块的上一个 / 下一个部分,到该块两端即停 |
|
|
92
|
+
| `Shift+Left` / `Shift+Right` | 被持有块的第一个 / 最后一个部分 |
|
|
93
|
+
| `Space` | 折叠或展开被标记的工具卡片或上下文块;渲染器已无法重写的块改为在阅读器中打开,并附上一行 `above the repaint window · opened in the reader` |
|
|
94
|
+
| `Enter` | 整屏读出该小节 |
|
|
95
|
+
| `Tab` / `Shift+Tab` | 已绘制区域中的下一个 / 上一个 |
|
|
96
|
+
| `Esc` | 回到编辑器 |
|
|
97
|
+
| 其他任何可打印键 | 回到编辑器,并把该字符输入到光标处 |
|
|
98
|
+
|
|
99
|
+
走查按阅读顺序覆盖每一个小节——系统提示词、注入的上下文(快照的每一份贡献各自作为一部分)、一条消息的推理与回复、一次工具调用的调用与结果,以及你的提示,轮次结束通知与打印出的报告会被跳过。各部分承载的是块自身的源文本,因此一条回复读到的是模型写下的 Markdown,而不是其上方绘制出的渲染结果。一条先流出推理再调用工具的消息在可见文本到来之前只暴露推理小节,因此走查不会落在空白回复上。切换会话会把键盘放回编辑器,并忘掉走查停下的小节。
|
|
100
|
+
|
|
101
|
+
子 agent 面板持有键盘时:
|
|
68
102
|
|
|
69
|
-
|
|
103
|
+
| 按键 | 效果 |
|
|
104
|
+
|---|---|
|
|
105
|
+
| `Up` / `Down` | 上一行 / 下一行;在第一行按 `Up` 落到编辑器,在最后一行按 `Down` 到达状态栏 |
|
|
106
|
+
| `Shift+Up` / `Shift+Down`、`Home` / `End`、`PageUp` / `PageDown` | 第一行 / 最后一行 |
|
|
107
|
+
| `Enter` | 把该子会话的详情作为只读页面打开,离开后回到面板的同一行 |
|
|
108
|
+
| `Tab` / `Shift+Tab` | 已绘制区域中的下一个 / 上一个 |
|
|
109
|
+
| `Esc` | 回到编辑器 |
|
|
110
|
+
| 任何可打印键 | 回到编辑器,并把该字符输入到光标处 |
|
|
111
|
+
|
|
112
|
+
面板的最后一行离开时,它也会把键盘交还编辑器。
|
|
113
|
+
|
|
114
|
+
状态栏持有键盘时:
|
|
115
|
+
|
|
116
|
+
| 按键 | 效果 |
|
|
117
|
+
|---|---|
|
|
118
|
+
| `Left` / `Right` | 上一个 / 下一个分段,并在两端环绕 |
|
|
119
|
+
| `Shift+Left` / `Shift+Right`、`Home` / `End`、`PageUp` / `PageDown` | 第一个 / 最后一个分段 |
|
|
120
|
+
| `Shift+Up` / `Shift+Down` | 对话记录上走查停下的那个小节,以及状态栏自身的第一个分段 |
|
|
121
|
+
| `Up` | 面板已绘制时到达其最后一行,否则到达编辑器 |
|
|
122
|
+
| `Enter` | 打开所选分段且状态栏保持键盘 |
|
|
123
|
+
| `Tab` / `Shift+Tab` | 已绘制区域中的下一个 / 上一个 |
|
|
124
|
+
| `Esc` | 回到编辑器 |
|
|
125
|
+
| 任何可打印键 | 回到编辑器,并把该字符输入到光标处 |
|
|
126
|
+
|
|
127
|
+
阅读器打开时:
|
|
128
|
+
|
|
129
|
+
| 按键 | 效果 |
|
|
130
|
+
|---|---|
|
|
131
|
+
| `Up` / `Down` | 在轮次栏中是上一个 / 下一个轮次;在各小节中是上一个 / 下一个小节,并滚动到可见处 |
|
|
132
|
+
| `Shift+Up` / `Shift+Down` | 在各小节中滚动一行,选择保持不变 |
|
|
133
|
+
| `PageUp` / `PageDown` | 翻一页轮次,或翻一页行并重叠一行 |
|
|
134
|
+
| `Home` / `End` | 第一个 / 最后一个轮次,或被持有轮次的第一个 / 最后一个小节 |
|
|
135
|
+
| `Right` | 从轮次栏进入被持有轮次的各小节;在各小节中是下一个小节 |
|
|
136
|
+
| `Left` | 回到轮次栏 |
|
|
137
|
+
| `Tab` / `Shift+Tab` | 在轮次栏中 `Tab` 打开其各小节;在各小节中两者都回到轮次栏 |
|
|
138
|
+
| `1`…`9` | 在各小节中,选中被持有轮次里编号对应的小节 |
|
|
139
|
+
| `Enter` | 在轮次栏中打开该轮次的各小节;在各小节中把被持有的小节固定到走查旁边,或取消已固定的那个 |
|
|
140
|
+
| `/` | 在轮次栏中打开轮次过滤:可打印键扩展查询,`Backspace` 删除一个字符,`Ctrl+U` 清空,`Enter` 保留收窄后的轮次栏并关闭该行,`Esc` 先清空非空查询、再关闭该行 |
|
|
141
|
+
| `Esc` | 取消固定的小节;窄终端上从各小节回到轮次栏;其余情况关闭阅读器,并回到对话记录上最后阅读的那个小节 |
|
|
142
|
+
| `Ctrl+G`、`Ctrl+C` | 关闭阅读器并回到编辑器 |
|
|
143
|
+
|
|
144
|
+
到达阅读器的其他每个按键都被消费,而关闭它同样打开那 750 ms 的交接窗口,因此连按多少次 `Esc` 都到不了编辑器的停止。
|
|
70
145
|
|
|
71
146
|
每个聚焦的分段都在第二行展开其最重要的事实。除 `todo` 之外,`Enter` 把这些事实打印到对话记录,并指出改变它们的方式:模型分段指出 `/model`,推理强度分段指出 `Shift+Tab`,权限分段指出其预设;`turn` 分段——绘制在权限与用量分段之间、形如 `turn <elapsed>`,且只在轮次进行时出现——给出轮次编号、其开始时间、已用时间与排队消息数量;用量、上下文、目标与计划分段打印 `/status` 报告中对应的小节,workspace 分段显示完整路径,附件分段列出待发送的附件。`todo` 分段展开按状态统计的计数以及正在进行的条目(若无正在进行的条目则为下一条待办),`Enter` 打开 agent 的 todo 列表,与 `/todos` 打开的是同一个列表。
|
|
72
147
|
|
|
@@ -74,7 +149,7 @@ dsh tui --no-open # print sign-in URLs without opening a
|
|
|
74
149
|
|
|
75
150
|
| 命令 | 效果 |
|
|
76
151
|
|---|---|
|
|
77
|
-
| `/help` |
|
|
152
|
+
| `/help` | 列出命令,以及每个焦点状态所应答的按键 |
|
|
78
153
|
| `/model` | 为下一次请求选择模型(输入即可过滤行),若模型声明多于一种推理强度则接着选择强度;`/model <provider>/<model>` 直接选择,`/model save` 把当前选择存为默认 |
|
|
79
154
|
| `/sessions` | 选择另一个持久化会话并切换过去 |
|
|
80
155
|
| `/new` | 开始新会话 |
|
|
@@ -94,7 +169,8 @@ dsh tui --no-open # print sign-in URLs without opening a
|
|
|
94
169
|
| `/subagents` | 浏览本会话之下的子 agent 会话;`Enter` 打开某个会话的详情 |
|
|
95
170
|
| `/settings [ns [path value]]` | 列出命名空间、显示某一个或设置某个字段;`/settings reset <ns>` 恢复默认 |
|
|
96
171
|
| `/plugins` | 已组合的插件及其启用状态与生命周期阶段;`/plugins bundles` 列出 profile 的组合包,`/plugins enable <id>` 与 `/plugins disable <id>` 切换某个插件条目或组合包,`/plugins add <spec>` 安装组合包,`/plugins remove <name>` 移除组合包 |
|
|
97
|
-
| `/tools` | 像 `Ctrl+O`
|
|
172
|
+
| `/tools` | 像 `Ctrl+O` 一样展开或折叠所有工具卡片与上下文行 |
|
|
173
|
+
| `/turns` | 像 `Ctrl+G` 一样整屏读出对话记录,各轮次并排 |
|
|
98
174
|
| `/quit`、`/exit` | 保存会话并退出 |
|
|
99
175
|
|
|
100
176
|
其他每条 `/name` 行都交给共享命令注册表,因此 `/compact`、`/permission`、`/goal` 与插件命令的行为和浏览器中一致。
|
|
@@ -121,12 +197,15 @@ dsh tui --no-open # print sign-in URLs without opening a
|
|
|
121
197
|
|---|---|---|
|
|
122
198
|
| `prompt` | 无 | 终端就绪后提交的首个提示 |
|
|
123
199
|
| `resume` | 无 | 要继续的持久化会话 id,而不是新建会话 |
|
|
124
|
-
| `toolPreviewLines` | `8` | `Ctrl+O`
|
|
125
|
-
| `
|
|
200
|
+
| `toolPreviewLines` | `8` | 在被标记的卡片上按 `Space` 或按 `Ctrl+O` 展开之前,工具卡片折叠状态下的正文行数 |
|
|
201
|
+
| `contextPreviewLines` | `4` | 在被标记的块上按 `Space` 或按 `Ctrl+O` 展开之前,系统提示词或注入的 `⬡` 上下文块绘制的行数 |
|
|
202
|
+
| `focusPreviewLines` | `12` | 停靠的检视面板为聚焦小节显示的行数,其后由折叠标记把剩余部分交给阅读器;对每一种小节都适用 |
|
|
203
|
+
| `readerMinColumns` | `80` | 阅读器并排绘制两个小节所需的列数;不足时固定仍被记录,其按键提示写作 `compare needs <n> columns` |
|
|
204
|
+
| `toastMs` | `2000` | 临时按键提示行以全亮度保持多久后淡出,这同时也是第二次 `Esc` 停止正在进行轮次的窗口 |
|
|
126
205
|
| `liveRefreshMs` | `1000` | 重绘周期:推进 `turn` 分段与面板中的已用时间,并重新读取已过期的子 agent 列表 |
|
|
127
206
|
| `streamFadeSteps` | `8` | 一次淡入或浮出持续多少拍:回复文字淡入,推理与工具卡片浮出,时长为 `streamFadeSteps × streamFadeStepMs` |
|
|
128
207
|
| `streamFadeStepMs` | `33` | 一拍淡入或浮出的时长,也是仍在变化时的重绘周期;总时长为 `streamFadeSteps × streamFadeStepMs` |
|
|
129
|
-
| `reducedMotion` | `false` |
|
|
208
|
+
| `reducedMotion` | `false` | 以稳定颜色绘制流式文本、流式推理、工具卡片与应用自身的边框装饰,不做淡入、不做抬亮、不做阅读器展开,也不重复重绘 |
|
|
130
209
|
| `openBrowser` | `true` | 把被标记的授权页面交给本地默认浏览器 |
|
|
131
210
|
|
|
132
211
|
`prompt`、`resume` 与 `openBrowser` 经启动提供方来自命令行;生成的[配置目录](../../../docs/config-catalog.zh.md#deepseek-aidsh-tui-app)是所有可接受字段的完整来源。
|
|
@@ -159,33 +238,45 @@ runner 等待完整应用就绪(`ctx.get('loader')?.await()`),并在核心
|
|
|
159
238
|
|---|---|
|
|
160
239
|
| [`src/index.ts`](src/index.ts) | `tui-app` 插件:会话宿主(创建、恢复、fork)、历史读取、退出流程、退出码映射 |
|
|
161
240
|
| [`src/startup.ts`](src/startup.ts) | `tui-app-startup` 提供方:提示位置参数、`--resume`、`--no-open` 与 `--help` |
|
|
162
|
-
| [`src/app.ts`](src/app.ts) |
|
|
241
|
+
| [`src/app.ts`](src/app.ts) | 终端应用:布局、按键路由、命令、会话绑定、接缝、日志与流的折叠、停止装填,以及它挂载的各浮层 |
|
|
242
|
+
| [`src/keys.ts`](src/keys.ts) | 按键模型:各焦点区域、一次按键在每个区域中的含义、它们逐级收缩的按键提示、进入用的按键、`/help` 的各行,以及交接窗口 |
|
|
163
243
|
| [`src/sessions.ts`](src/sessions.ts) | 基于查询引擎的 `/sessions` 列表及其选择器行 |
|
|
164
244
|
| [`src/attach.ts`](src/attach.ts) | `/attach`:本地文件经附件存储成为图片或文件块 |
|
|
165
245
|
| [`src/export.ts`](src/export.ts) | `/export`:通过导出包的归档辅助函数写出会话日志 ZIP |
|
|
166
|
-
| [`src/blocks.ts`](src/blocks.ts) | 对话记录组件:用户提示、assistant
|
|
246
|
+
| [`src/blocks.ts`](src/blocks.ts) | 对话记录组件:用户提示、assistant 回复、工具卡片、系统提示词与注入上下文、通知;可导航的块暴露其各小节并绘制焦点标记条,可折叠的块则承载两个折叠键共用的那条标记 |
|
|
167
247
|
| [`src/context.ts`](src/context.ts) | 把已记录的系统提示词与注入的用户消息投影为对话记录小节 |
|
|
168
|
-
| [`src/navigation.ts`](src/navigation.ts) |
|
|
169
|
-
| [`src/inspector.ts`](src/inspector.ts) |
|
|
248
|
+
| [`src/navigation.ts`](src/navigation.ts) | 把对话记录看作各个小节、沿四条轴走遍它们的光标、这些小节归入的各轮次,以及检视面板的标题 |
|
|
249
|
+
| [`src/inspector.ts`](src/inspector.ts) | 停靠的检视面板:带模式徽标的边框面板、小节标题、带编号且会折行的各部分选择行、折叠后的各行,及其挂载的组件 |
|
|
250
|
+
| [`src/frame.ts`](src/frame.ts) | 纯粹的画框:圆角边框线、反白的模式徽标、正文行,以及某个宽度容纳得下的按键提示级别 |
|
|
251
|
+
| [`src/reader.ts`](src/reader.ts) | 作为纯数据的阅读器:其状态、按键变成的各个意图、其几何布局,以及它画出的各行 |
|
|
252
|
+
| [`src/reader-overlay.ts`](src/reader-overlay.ts) | 挂载的阅读器面板:其按键映射、其展开动效,以及它把键盘留在何处 |
|
|
170
253
|
| [`src/screen.ts`](src/screen.ts) | 在构建一帧与写出该帧之间带若干次结算的主屏幕、每次结算所依据的重绘窗口,以及每个块的重绘下界 |
|
|
171
254
|
| [`src/fade.ts`](src/fade.ts) | 流式文本淡入与浮出:基于挂钟的尾部追踪器、块时钟与注册表、淡入亮度级别、浮出混合,以及对已渲染行的重新着色 |
|
|
255
|
+
| [`src/motion.ts`](src/motion.ts) | 边框装饰的动效时钟与其调用点所绘的三级抬亮:落键、小节步进、状态栏走查与阅读器的展开 |
|
|
172
256
|
| [`src/prompts.ts`](src/prompts.ts) | 审批、提问、选择器与只读详情提示以及模态队列 |
|
|
173
|
-
| [`src/
|
|
257
|
+
| [`src/toast.ts`](src/toast.ts) | 临时按键提示行:其浮层、其时钟,以及它承载的各条文字 |
|
|
258
|
+
| [`src/transcript.ts`](src/transcript.ts) | 呈现视图、用量与轮次结束原因的纯文本折叠,以及每条标记共用的那一套折叠措辞 |
|
|
174
259
|
| [`src/diff.ts`](src/diff.ts) | diff 卡片的行 diff 与 hunk 选择 |
|
|
175
260
|
| [`src/style.ts`](src/style.ts) | 调色板与派生的 pi-tui 主题 |
|
|
176
261
|
| [`src/completion.ts`](src/completion.ts) | 编辑器的斜杠命令与 `@` 引用补全 |
|
|
177
262
|
| [`src/editor.ts`](src/editor.ts) | 去掉 pi-tui 自绘块状光标的提示编辑器,以及终端自身光标所用的 DECSCUSR 序列 |
|
|
178
263
|
| [`src/status.ts`](src/status.ts) | 投影接缝的事实,以及 `/status` 报告与分段详情共享的小节;压缩与重试通知 |
|
|
179
|
-
| [`src/footer.ts`](src/footer.ts) |
|
|
264
|
+
| [`src/footer.ts`](src/footer.ts) | 状态栏:有序的各分段、每个分段的详情行、未聚焦时由两端向内构建的一行,以及聚焦时的滑动窗口 |
|
|
180
265
|
| [`src/subagent-panel.ts`](src/subagent-panel.ts) | 实时子 agent 面板:一次后代列表加上采样到的实时事实构成其各行、未聚焦时的摘要行,以及聚焦时的列表 |
|
|
181
266
|
| [`src/catalog.ts`](src/catalog.ts) | `/settings`、`/plugins`、`/subagents`、`/deliverables`、`/changes` 与 `/outline` 的行,以及 `/plugins` 的管理动作 |
|
|
182
267
|
| [`src/todos.ts`](src/todos.ts) | todo 列表:状态符号、选择器行与单个条目的详情行 |
|
|
183
268
|
| [`cordis.patch.yml`](cordis.patch.yml) | 基于 `dsh-base` 的终端 patch |
|
|
184
269
|
| — | 不发布运行时不变量伴随模块;应用只在一个 Agent 上注册监听器,不持有其他观察者可能与之矛盾的可变关系。 |
|
|
185
|
-
| [`tests/app.spec.ts`](tests/app.spec.ts) |
|
|
270
|
+
| [`tests/app.spec.ts`](tests/app.spec.ts) | 基于伪终端的渲染、按键、命令、停止装填与两个接缝 |
|
|
271
|
+
| [`tests/keys.spec.ts`](tests/keys.spec.ts) | 每个区域为一个按键认领什么、按键提示的各级,以及一次按键输入的文字 |
|
|
272
|
+
| [`tests/frame.spec.ts`](tests/frame.spec.ts) | 边框线、徽标、正文行,以及某个宽度容纳得下的按键提示 |
|
|
273
|
+
| [`tests/motion.spec.ts`](tests/motion.spec.ts) | 动效时钟的各个级别、它对重绘的要求,以及每一级所绘的抬亮 |
|
|
274
|
+
| [`tests/toast.spec.ts`](tests/toast.spec.ts) | 临时提示行的方框、其保持、其淡出与其提前结算 |
|
|
275
|
+
| [`tests/reader.spec.ts`](tests/reader.spec.ts) | 阅读器的几何布局、其状态机、其过滤,以及它返回的各行 |
|
|
276
|
+
| [`tests/reader-overlay.spec.ts`](tests/reader-overlay.spec.ts) | 挂载的面板:其按键映射、其展开动效、其重新锚定与其退出 |
|
|
186
277
|
| [`tests/commands.spec.ts`](tests/commands.spec.ts) | 基于脚本化服务的会话、附件、队列、技能、登录、`/login`、Shift+Tab 推理强度循环、导出、引用与推理强度命令 |
|
|
187
278
|
| [`tests/panels.spec.ts`](tests/panels.spec.ts) | 状态页脚与报告、可导航的子 agent 与 todo 列表、目录命令、命令提示与审批详情 |
|
|
188
|
-
| [`tests/transcript-focus.spec.ts`](tests/transcript-focus.spec.ts) |
|
|
279
|
+
| [`tests/transcript-focus.spec.ts`](tests/transcript-focus.spec.ts) | 走遍对话记录、区域序列、检视面板、实时会话上的阅读器,以及重绘窗口内的原地标记条 |
|
|
189
280
|
| [`tests/context.spec.ts`](tests/context.spec.ts) | 把系统提示词与注入上下文投影为对话记录小节 |
|
|
190
281
|
| [`tests/index.spec.ts`](tests/index.spec.ts) | 创建、恢复分页、fork 切割、会话切换、退出流程与失败报告 |
|
|
191
282
|
| [`tests/startup.spec.ts`](tests/startup.spec.ts) | 基于真实 Loader 配置树的命令行解析 |
|
|
@@ -236,13 +327,16 @@ runner 不向请求前缀添加任何内容;`/model` 切换像在浏览器中
|
|
|
236
327
|
- **审批为一次性**——提示只提供允许一次或拒绝,与审批接缝的词汇一致;没有记忆的授权。
|
|
237
328
|
- **仅浏览器的页面留在浏览器**——workspace 与目录选择器、在应用中打开的链接、轨迹账本与逐条消息的点赞/点踩没有终端对应物;`/settings`、`/plugins`、`/subagents`、`/outline` 与共享的 `/feedback` 以文本覆盖其事实,子 agent 的对话记录通过切换到子会话来阅读。
|
|
238
329
|
- **交付物只列名、不打开**——`/deliverables` 列出交付路径,`/changes` 显示逐行对比;浏览器会预览这些文件。
|
|
239
|
-
-
|
|
240
|
-
- **滚走的聚焦块只在检视面板中被标记**——pi-tui 只对它写出的上一帧的最后 `rows` 行做差分重绘,要改动其上方的内容就得清空终端回滚区,因此更靠前的块得不到标记条,检视面板标题写出 `off screen
|
|
241
|
-
-
|
|
330
|
+
- **历史由终端回滚区持有**——键盘可以走遍对话记录的每个块与每个部分,工具卡片与上下文块可以折叠,阅读器的 `/` 过滤可以收窄本会话的各轮次;搜索一个轮次的文本以及其他会话的历史,属于浏览器表层。
|
|
331
|
+
- **滚走的聚焦块只在检视面板中被标记**——pi-tui 只对它写出的上一帧的最后 `rows` 行做差分重绘,要改动其上方的内容就得清空终端回滚区,因此更靠前的块得不到标记条,检视面板标题写出 `off screen`,其边框转为暗色,在它上面按 `Space` 会打开阅读器而不是重写它;`Ctrl+O` 是唯一仍会重写那些行的按键,在高于终端的对话记录上它会让 pi-tui 整屏重绘。
|
|
332
|
+
- **缩过的帧会让视口顶部脱离可及范围**——重绘窗口随迄今写出的最高一帧上升且不会回落,因此在读取模式关闭或旋转指示离开之后,阅读器会比整屏少画那么多行、其上方露出对话记录,临时提示行也改为打印进对话记录;两者都会随对话记录增长而恢复。
|
|
333
|
+
- **阅读器下沉期间遮住输入行**——`Esc`、`Ctrl+G` 与 `Ctrl+C` 会立刻交还键盘,随后该面板用四拍淡入时钟缩回,默认即 132 ms,其间终端光标不可见;任何移动键盘的按键,以及任何提示或会话变更,都会立即撤下该面板。
|
|
334
|
+
- **阅读器显示的是源文本**——assistant 回复读到的是模型写下的 Markdown,而不是对话记录绘制出的渲染结果,因此表格与标题以源码形式呈现。
|
|
242
335
|
- **面板列出的是常驻,而不是整棵树**——子会话在其会话记录常驻于本进程期间加入面板,因此由进程外提供方运行、在此没有自己会话的子 agent 永远不会出现;`/subagents` 仍是到达每一个持久后代的途径。
|
|
243
336
|
- **常驻不等于正在工作**——列表的 `activity: 'running'` 表示该子会话的记录常驻,这正是行内 `resident` 所报告的内容;子会话是否在工作则是它旁边单独的 `running` / `idle`,读自本进程中该子会话的 Agent。
|
|
244
337
|
- **溢出行之后的各行不可选中**——面板最多绘制六行,`Up` / `Down` 在其两端会离开面板;被折叠进 `+<n> more` 的子会话通过 `/subagents` 到达,后者遍历完整的后代树。
|
|
245
|
-
-
|
|
338
|
+
- **面板的文字按其上次刷新时的宽度构建**——面板绘制期间改变终端大小,其标题按键提示与行文字会保持那次宽度所选的形态,直到下一次列表更新、选择移动或实时重绘重新构建它们。
|
|
339
|
+
- **淡入需要终端的应答**——其亮度级别由终端对启动时发出的查询所报告的背景色构建,因此保持沉默、或既不编码真彩色也不编码 256 色的终端只会得到两级的暗淡模式;`NO_COLOR`、被禁用的调色板、`TERM=dumb` 与 `reducedMotion` 会完全关闭每一种淡入与每一种边框抬亮,临时提示行届时在保持结束时直接消失,而不是淡出。
|
|
246
340
|
- **终端自身的光标可能闪烁**——编辑器不绘制自己的光标,应用打开终端光标,而 pi-tui 会在其重绘的各行之间移动它;不支持 pi-tui 为一帧包裹的同步输出序列的终端可能显示出这种移动。
|
|
247
341
|
- **通过 `dsh` 启动器运行**——以其他方式启动该 profile 会在启动时失败,因为只有启动器能请求进程退出。
|
|
248
342
|
|