@waq666/pneuma 0.7.0 → 0.7.1

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.
Files changed (41) hide show
  1. package/README.md +206 -145
  2. package/lib/app/App.d.ts +3 -1
  3. package/lib/app/App.js +324 -172
  4. package/lib/app/App.js.nv-backup +1650 -0
  5. package/lib/app/ChatView.d.ts +40 -9
  6. package/lib/app/ChatView.js +150 -38
  7. package/lib/app/StatusBar.js +21 -92
  8. package/lib/app/TimelineRail.d.ts +22 -0
  9. package/lib/app/TimelineRail.js +160 -0
  10. package/lib/app/TimelineRail.js.negbak +98 -0
  11. package/lib/app/TimelineRail.js.nv-backup +160 -0
  12. package/lib/app/ToolCard.d.ts +7 -1
  13. package/lib/app/ToolCard.js +30 -6
  14. package/lib/app/ToolCard.js.nv-backup +64 -0
  15. package/lib/app/TranscriptOverlay.d.ts +23 -8
  16. package/lib/app/TranscriptOverlay.js +29 -10
  17. package/lib/app/TranscriptViewport.d.ts +78 -0
  18. package/lib/app/TranscriptViewport.js +218 -0
  19. package/lib/app/Welcome.js +13 -8
  20. package/lib/app/click.d.ts +15 -2
  21. package/lib/app/click.js +20 -6
  22. package/lib/app/keymap.d.ts +56 -0
  23. package/lib/app/keymap.js +56 -0
  24. package/lib/app/mouse.d.ts +33 -0
  25. package/lib/app/mouse.js +35 -0
  26. package/lib/app/pointer.d.ts +16 -0
  27. package/lib/app/pointer.js +60 -0
  28. package/lib/app/scroll-model.d.ts +240 -0
  29. package/lib/app/scroll-model.js +347 -0
  30. package/lib/app/snapshot-subscribe.d.ts +34 -0
  31. package/lib/app/snapshot-subscribe.js +110 -0
  32. package/lib/app/theme.d.ts +29 -1
  33. package/lib/app/theme.js +46 -1
  34. package/lib/app/ticker.d.ts +7 -0
  35. package/lib/app/ticker.js +53 -0
  36. package/lib/core/llm.d.ts +11 -0
  37. package/lib/core/llm.js +19 -2
  38. package/lib/plugins/subagent.js +36 -2
  39. package/lib/plugins/tool-search.js +11 -2
  40. package/lib/plugins/tool-search.js.nv-backup +434 -0
  41. package/package.json +1 -1
@@ -0,0 +1,1650 @@
1
+ import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
2
+ /**
3
+ * 顶层界面:快照订阅(useSyncExternalStore)+ 键盘路由 + 鼠标层 + 恒定帧布局。
4
+ *
5
+ * 布局(0.6.56):根盒高度恒为「终端行数 − 1」并 overflow hidden——ink 的帧写带尾随
6
+ * 换行,帧高一旦随内容变化终端就会滚动(「↑↓ 跳回底部」的根源);固定帧之后任何
7
+ * 状态下重绘都从屏顶原位擦写、零滚动。聊天区是 flexGrow 的滚动视口:底对齐、老的
8
+ * 条目从顶上裁掉(只丢历史不丢最新),滚轮 / PgUp·PgDn 以条为单位回看,滚动时在
9
+ * 输入框上方挂一条可点击的「回到底部」提示;选择器与模型浮层独占整屏、列表行与
10
+ * 屏幕行一一对应,点击即命中。
11
+ *
12
+ * 键盘优先级:Ctrl+C(打断/退出)→ 审批卡(四档)→ 提问卡(模态作答)→ 计划反馈
13
+ * 输入 → 计划评审卡(批准/拒绝/带反馈)→ 图片预览浮层 → 子代理浮层 → 回看浮层
14
+ * (Ctrl+O)→ 会话选择器 → 模型/模式/技能浮层 → Esc(打断 / 双击撤回上一轮)→ PgUp/PgDn
15
+ * 滚动 → Ctrl+O/Ctrl+T → 其余交给 Composer(↑↓ 在输入框里仍是历史回忆,对齐
16
+ * dsh-TUI)。
17
+ *
18
+ * 鼠标(0.6.56):进程存活期间开启 SGR 跟踪(DECSET 1000+1006),卸载时关闭。
19
+ * ink 的按键解析不认识 SGR 序列,剥掉 ESC 头后以 `'[<b;x;yM|m'` 原样进 useInput——
20
+ * 在最顶层拦截:滚轮按状态路由(浮层/聊天/两个选择器);左键点击派发给命中区注册表
21
+ * (卡片页脚按钮、提问选项、回底提示条、附件芯片、后台芯片、图片行——组件用 yoga
22
+ * 绝对行自报几何,见 click.ts),列表则用构造行号直接映射。跟踪开着时终端原生选区
23
+ * 要走 Shift+拖拽,全终端 TUI 通例。
24
+ *
25
+ * 光标停靠(0.6.57):App 包一层 stdout.write,帧(含 `\x1b[2K`)写完追加一条
26
+ * CUP 把物理光标送回 Composer 声明的 caret(cursor.ts)——Windows Terminal 的
27
+ * IME 拼音预览因此画在输入框里;无声明时隐藏光标。
28
+ *
29
+ * @module dsc-tui/app/App
30
+ */
31
+ import { spawn } from 'node:child_process';
32
+ import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';
33
+ import { Box, Text, useInput, useStdout } from 'ink';
34
+ import { DEFAULT_STATUS_BAR_PREFS, normalizeStatusBarPrefs } from '../contract.js';
35
+ import { runCommand } from '../plugins/commands.js';
36
+ import { AgentsOverlay, buildAgentRows } from './AgentsOverlay.js';
37
+ import { absoluteTop, measuredHeight, useClickRegion } from './click.js';
38
+ import { ApprovalCard } from './ApprovalCard.js';
39
+ import { AskCard, SKIPPED_ANSWER } from './AskCard.js';
40
+ import { readClipboardImage } from './clipboard-image.js';
41
+ import { ChatView } from './ChatView.js';
42
+ import { Composer } from './Composer.js';
43
+ import { renderImageBlock } from './image-blocks.js';
44
+ import { HINT } from './keymap.js';
45
+ import { ModelPicker } from './ModelPicker.js';
46
+ import { parseMouse } from './mouse.js';
47
+ import { PlanReviewCard } from './PlanReviewCard.js';
48
+ import { clearPointer, publishPointer } from './pointer.js';
49
+ import { PresetPicker } from './PresetPicker.js';
50
+ import { PreviewOverlay } from './PreviewOverlay.js';
51
+ import { SessionPicker } from './SessionPicker.js';
52
+ import { SETTINGS_CHROME, SETTINGS_LIST_TOP, SettingsOverlay } from './SettingsOverlay.js';
53
+ import { SkillsPicker } from './SkillsPicker.js';
54
+ import { TRANSCRIPT_CHROME, TranscriptOverlay } from './TranscriptOverlay.js';
55
+ import { WHEEL_LINES } from './TranscriptViewport.js';
56
+ import { useCoalescedSnapshot } from './snapshot-subscribe.js';
57
+ import { buildSettingsRows, focusableRows, isFocusableRow, settingsWindowStart, } from './settings-model.js';
58
+ import { shortId, StatusBar } from './StatusBar.js';
59
+ import { RAIL_WIDTH } from './scroll-model.js';
60
+ import { TaskStrips } from './TaskStrips.js';
61
+ import { Welcome } from './Welcome.js';
62
+ import { extractImages, readImageAsDataUrl } from './attach.js';
63
+ import { BORDER, GAP, PAD, PALETTE, STATUS_COLOR, TEXT } from './theme.js';
64
+ /** 双击 Ctrl+C 的判定窗口。 */
65
+ const EXIT_WINDOW_MS = 2000;
66
+ /** 双击 Esc 撤回上一轮的判定窗口(对齐 dsh 的 3 秒)。 */
67
+ const REWIND_WINDOW_MS = 3000;
68
+ /** 子代理转录跟活的节流:队友在写的时候最多每 400ms 重放一次它的运行记录。 */
69
+ const PEEK_REFRESH_MS = 400;
70
+ /** 子代理只读转录的提示行(比主回看多一句「只读」)。 */
71
+ const PEEK_HINT = HINT.peek;
72
+ /** 欢迎页只挂在短会话顶上(resume 长会话再画只是把历史往下顶,dsh skipIntro 同款)。 */
73
+ const WELCOME_MAX_ENTRIES = 30;
74
+ /** 选择器框的固定行数:上下边框 2 + 标题 1 + 筛选行 1 + 提示行 1(改名行与提示行 1:1 互换)。 */
75
+ const PICKER_CHROME = 5;
76
+ /** 工作区显示名:最后一段路径(dsh 会话总管的 rail 同款;盘根/空目录给兜底文案)。 */
77
+ const workspaceLabel = (cwd) => {
78
+ if (cwd === '')
79
+ return '(无目录)';
80
+ const base = cwd.replace(/[\\/]+$/, '').split(/[\\/]/).pop() ?? cwd;
81
+ return base === '' ? cwd : base;
82
+ };
83
+ /**
84
+ * 「已离开最新」提示条(0.6.59 对齐 dsh 的 pill):蓝底深字,整枚可点回底。
85
+ *
86
+ * **浮在转录区最后一行上、不占净高度**(`marginTop={-1}` 把它从页脚里"借"的那一行还回去):
87
+ * 占一行会让聊天区高度随它出现/消失变化——刻度栏每滚一下就上下挪一行、滚回底部还差一行
88
+ * 到不了(两处都是用户报障)。负 margin 让页脚总高与没有胶囊时**完全相同**,而胶囊照旧
89
+ * 画在输入框上方那一行(ink 6.8 的 Box 没有 `bottom`/`top`,absolute 定位放不到底部)。
90
+ *
91
+ * **靠右**(本批改的):原先贴左,它盖住的正是每一行的**行首**——回看时最要紧的那一列。
92
+ * 右缘留出 `RAIL_WIDTH` 列,正好把刻度列让开(胶囊出现时人正在回看,刻度列正是要看的东西)。
93
+ */
94
+ function TailIndicator({ hidden, onJump, registerClick, }) {
95
+ const ref = useRef(null);
96
+ useClickRegion(ref, registerClick, (col, row, top, height) => {
97
+ if (row < top || row >= top + height)
98
+ return false;
99
+ onJump();
100
+ return true;
101
+ });
102
+ return (_jsx(Box, { ref: ref, marginTop: -1, paddingRight: RAIL_WIDTH, justifyContent: "flex-end", children: _jsxs(Text, { backgroundColor: PALETTE.pillBg, color: PALETTE.pillText, bold: true, children: [HINT.backToBottom, hidden > 99 ? ` · ${hidden} 条新` : '', ' '] }) }));
103
+ }
104
+ export function App({ runtime, clipboardReader, imageRenderer, tuiNoticeExtras, snapshotMs, }) {
105
+ // 快照通知合并(见 snapshot-subscribe 的头注):上游是同步的「每个 delta 一次」,
106
+ // 直接喂给 useSyncExternalStore 就是每个 delta 一次全树 reconcile——开队友就卡在那。
107
+ const store = useCoalescedSnapshot(runtime, snapshotMs);
108
+ const snapshot = useSyncExternalStore(store.subscribe, store.getSnapshot);
109
+ const approval = snapshot.surfaces.pendingApproval;
110
+ const question = snapshot.surfaces.pendingQuestion;
111
+ const plan = snapshot.surfaces.pendingPlan;
112
+ const { stdout } = useStdout();
113
+ const [picker, setPicker] = useState(false);
114
+ const [pickerIndex, setPickerIndex] = useState(0);
115
+ const [expandThinking, setExpandThinking] = useState(false);
116
+ /**
117
+ * 已展开的工具卡(点一行工具卡切换)。持有在 App 而不是卡片自己:卡片滚出窗口切片会
118
+ * 卸载重挂,状态在 App 里才「展开过的还是展开着」;聊天区与回看浮层也共用同一份。
119
+ */
120
+ const [expandedTools, setExpandedTools] = useState(new Set());
121
+ const toggleTool = useCallback((id) => {
122
+ setExpandedTools((previous) => {
123
+ const next = new Set(previous);
124
+ if (next.has(id))
125
+ next.delete(id);
126
+ else
127
+ next.add(id);
128
+ return next;
129
+ });
130
+ }, []);
131
+ // 换会话:条目 id 的作用域跟着换(新会话从头编号、id 会撞),展开集合清掉。
132
+ // 空集合时原样返回同一个引用,挂载那一次不触发多余渲染。
133
+ const sessionKey = snapshot.status.sessionId;
134
+ useEffect(() => {
135
+ setExpandedTools((previous) => (previous.size === 0 ? previous : new Set()));
136
+ }, [sessionKey]);
137
+ const [notice, setNotice] = useState(null);
138
+ /** 审批卡内嵌 diff 的展开态(v 切换;换卡即复位)。 */
139
+ const [approvalExpanded, setApprovalExpanded] = useState(false);
140
+ /** 计划全文的展开态。 */
141
+ const [planExpanded, setPlanExpanded] = useState(false);
142
+ /** 计划卡的「带反馈退回」输入模式:Composer 临时改成反馈输入框。 */
143
+ const [planFeedback, setPlanFeedback] = useState(false);
144
+ /** 提问卡的作答进度(一批多题逐题作答;换卡即复位)。 */
145
+ const [askIndex, setAskIndex] = useState(0);
146
+ const [askChecked, setAskChecked] = useState([]);
147
+ const [askHighlight, setAskHighlight] = useState(0);
148
+ const [askText, setAskText] = useState('');
149
+ /** 回看浮层(Ctrl+O)与子代理转录:滚动状态在 TranscriptViewport 里(按行),这里只持有手柄。 */
150
+ const [transcriptOpen, setTranscriptOpen] = useState(false);
151
+ const overlayRef = useRef(null);
152
+ const peekRef = useRef(null);
153
+ /** 上一次 peek 的时刻(跟活节流用)。 */
154
+ const lastPeek = useRef(0);
155
+ /** 聊天视口手柄(滚动状态在 TranscriptViewport 里,按行)。 */
156
+ const chatRef = useRef(null);
157
+ /** 滚离最新时记下当时的条数(回到底部那颗胶囊的「N 条新」);null = 贴着最新。 */
158
+ const [chatAwayFrom, setChatAwayFrom] = useState(null);
159
+ /** Composer 补全面板开合(Esc 打断与「关面板」的分流依据)。 */
160
+ const [panelOpen, setPanelOpen] = useState(false);
161
+ /** ---- 0.6.57:双击 Esc 撤回 / 剪贴板贴图 / 子代理浮层 / 图片预览 ---- */
162
+ /** 上一次 Esc 的时刻(撤回的 prime 判定;任何非 Esc 按键清零)。 */
163
+ const lastEsc = useRef(0);
164
+ /** Composer 草稿镜像(撤回要判断输入框是否为空;不进状态避免多余重渲染)。 */
165
+ const draftRef = useRef('');
166
+ /** 外部灌入 Composer 的草稿(token 变化即生效)。 */
167
+ const [composerPreset, setComposerPreset] = useState({ text: '', token: 0 });
168
+ /** 剪贴板贴图暂存的附件芯片。 */
169
+ const [attachments, setAttachments] = useState([]);
170
+ const attachmentSeq = useRef(0);
171
+ /** 子代理浮层:名单 / 某个代理的只读转录(null = 关闭)。 */
172
+ const [agentView, setAgentView] = useState(null);
173
+ const [agentEntries, setAgentEntries] = useState(null);
174
+ const [agentIndex, setAgentIndex] = useState(0);
175
+ /** 图片预览浮层(半块真彩;block 由 effect 现算)。 */
176
+ const [preview, setPreview] = useState(null);
177
+ const [previewBlock, setPreviewBlock] = useState(null);
178
+ const [previewLoading, setPreviewLoading] = useState(false);
179
+ const [previewError, setPreviewError] = useState(null);
180
+ // ---- 会话选择器:页 / 筛选 / 改名 / 删除确认 ----
181
+ const [pickerPage, setPickerPage] = useState('active');
182
+ const [archivedList, setArchivedList] = useState([]);
183
+ const [pickerQuery, setPickerQuery] = useState('');
184
+ const [pickerBuffer, setPickerBuffer] = useState(null);
185
+ const [pickerArmed, setPickerArmed] = useState(false);
186
+ /**
187
+ * 两级导航(0.6.63 对齐 dsh 的会话总管):已钻取的工作区 cwd;null = 工作区层。
188
+ * 工作区只有一个时派生为「直落会话层」(pickerWorkspace 保持 null,Esc 直接关)。
189
+ */
190
+ const [pickerWorkspace, setPickerWorkspace] = useState(null);
191
+ /** 模型选择浮层(/model 无参数打开;输入即筛选)。 */
192
+ const [modelPicker, setModelPicker] = useState(false);
193
+ const [modelIndex, setModelIndex] = useState(0);
194
+ const [modelQuery, setModelQuery] = useState('');
195
+ /** 模式选择浮层(/preset 无参数打开,对齐 dsh 裸命令开 picker)。 */
196
+ const [presetPicker, setPresetPicker] = useState(false);
197
+ const [presetIndex, setPresetIndex] = useState(0);
198
+ const [presetQuery, setPresetQuery] = useState('');
199
+ /** 技能选择浮层(/skills 无参数打开;Enter 回填 /技能名 到输入行)。 */
200
+ const [skillsPicker, setSkillsPicker] = useState(false);
201
+ const [skillsIndex, setSkillsIndex] = useState(0);
202
+ const [skillsQuery, setSkillsQuery] = useState('');
203
+ /** ---- 0.6.61:设置页(/settings)---- 焦点/草稿/回执/滚动全在这组状态里。 */
204
+ const [settingsOpen, setSettingsOpen] = useState(false);
205
+ const [settingsSections, setSettingsSections] = useState([]);
206
+ const [settingsValues, setSettingsValues] = useState({});
207
+ /** 焦点在 focusables(可聚焦行号表)里的位置。 */
208
+ const [settingsIndex, setSettingsIndex] = useState(0);
209
+ const [settingsEdit, setSettingsEdit] = useState(null);
210
+ const [settingsNotice, setSettingsNotice] = useState(null);
211
+ /** 当前展开的设置子页(null = 根页;dsh 式一层分组,Esc 先退子页再关页)。 */
212
+ const [settingsGroup, setSettingsGroup] = useState(null);
213
+ /** 当前展开的分区页(0.6.64 两级导航:null = 根页只列分区名;组子页在分区页之下)。 */
214
+ const [settingsSection, setSettingsSection] = useState(null);
215
+ /** 状态栏段显隐(0.6.62):启动读一次 prefs,设置页改动后就地更新。 */
216
+ const [statusBarPrefs, setStatusBarPrefs] = useState(DEFAULT_STATUS_BAR_PREFS);
217
+ const lastCtrlC = useRef(0);
218
+ /** 可切换模型列表:进程内静态,取一次即可。 */
219
+ const models = useMemo(() => runtime.listModels(), [runtime]);
220
+ /** @ 提及补全的文件清单来源(dock 的 fs-list;不可用时补全退化为空)。 */
221
+ const dockLister = useCallback((dir) => runtime.dock('fs-list', { dir: dir === '' ? '.' : dir }), [runtime]);
222
+ /** 卡片/提示条的点击命中注册表(组件登记判定函数,几何在点击时现量,见 click.ts)。 */
223
+ const clickRegions = useRef(new Set());
224
+ const registerClick = useCallback((region) => {
225
+ clickRegions.current.add(region);
226
+ return () => {
227
+ clickRegions.current.delete(region);
228
+ };
229
+ }, []);
230
+ /** 拖动会话开在哪个区上(按下时命中、且它认拖动);没在拖 = null(见 `dispatchMouseDrag`)。 */
231
+ const dragTarget = useRef(null);
232
+ const askQuestions = question?.questions ?? (question !== null ? [question] : []);
233
+ const currentQuestion = askQuestions[askIndex];
234
+ /** 模型浮层的筛选结果(value/description 子串匹配)。 */
235
+ const modelList = useMemo(() => {
236
+ const q = modelQuery.trim().toLowerCase();
237
+ if (q === '')
238
+ return models;
239
+ return models.filter((choice) => choice.value.toLowerCase().includes(q) || choice.description.toLowerCase().includes(q));
240
+ }, [models, modelQuery]);
241
+ /** 模式投影(浮层开着才算:listPresets 是同步读盘)。 */
242
+ const presetSurface = useMemo(() => (presetPicker ? runtime.listPresets() : null), [runtime, presetPicker]);
243
+ /** 模式浮层的筛选结果(显示名/名字/说明子串匹配)。 */
244
+ const presetList = useMemo(() => {
245
+ if (presetSurface === null)
246
+ return [];
247
+ const q = presetQuery.trim().toLowerCase();
248
+ if (q === '')
249
+ return presetSurface.options;
250
+ return presetSurface.options.filter((preset) => preset.label.toLowerCase().includes(q) ||
251
+ preset.name.toLowerCase().includes(q) ||
252
+ preset.description.toLowerCase().includes(q));
253
+ }, [presetSurface, presetQuery]);
254
+ /** 技能投影(浮层开着才算)。 */
255
+ const skillsSurface = useMemo(() => (skillsPicker ? runtime.listSkills() : []), [runtime, skillsPicker]);
256
+ /** 技能浮层的筛选结果(名字/描述/来源子串匹配)。 */
257
+ const skillsList = useMemo(() => {
258
+ const q = skillsQuery.trim().toLowerCase();
259
+ if (q === '')
260
+ return skillsSurface;
261
+ return skillsSurface.filter((skill) => skill.name.toLowerCase().includes(q) ||
262
+ skill.description.toLowerCase().includes(q) ||
263
+ skill.source.toLowerCase().includes(q));
264
+ }, [skillsSurface, skillsQuery]);
265
+ /** 回合跑动 → 空闲时响一声 BEL:长任务跑完人不在终端前也能听见。 */
266
+ const previousTurn = useRef(snapshot.status.turnState);
267
+ useEffect(() => {
268
+ const current = snapshot.status.turnState;
269
+ const wasActive = previousTurn.current !== 'idle';
270
+ previousTurn.current = current;
271
+ if (wasActive && current === 'idle') {
272
+ try {
273
+ stdout?.write('\x07');
274
+ }
275
+ catch {
276
+ // 管道里写不进去就算了,提示音是锦上添花
277
+ }
278
+ }
279
+ }, [snapshot.status.turnState, stdout]);
280
+ // 设置里的「思考块默认展开」是初值(0.6.61):启动读一次,Ctrl+T 仍是会话内
281
+ // 的临时开关。旧测试的 runtime mock 没有这个方法——缺了就静默跳过。
282
+ useEffect(() => {
283
+ if (typeof runtime.getUiPrefs !== 'function')
284
+ return;
285
+ const prefs = runtime.getUiPrefs();
286
+ if (prefs.reasoningDefaultOpen === true)
287
+ setExpandThinking(true);
288
+ // 状态栏段显隐(0.6.62):缺键归一(老 mock / 老宿主)后装填。
289
+ setStatusBarPrefs(normalizeStatusBarPrefs(prefs.statusBar));
290
+ }, [runtime]);
291
+ // 鼠标跟踪全时开启:1000 点击/滚轮、1002 按住拖动、1003 纯移动(悬停)。
292
+ //
293
+ // 1002/1003 是本批为「刻度列悬停读数 + 拖动 scrub」新开的(对齐 dsh)。**代价写清楚**:
294
+ // 应用一开鼠标上报,终端就不再自己处理拖拽选区(Windows Terminal 等本来就要按 Shift
295
+ // 才选——1000 已经如此,这里只是把运动事件也接过来)。偏移量没有别的用处:指针位置只
296
+ // 喂给 `pointer` 那个小 store,且只在指针位于右侧刻度列时才通知(见 pointer.ts)。
297
+ useEffect(() => {
298
+ stdout?.write('\x1b[?1000;1002;1003;1006h');
299
+ return () => {
300
+ try {
301
+ stdout?.write('\x1b[?1000;1002;1003;1006l');
302
+ clearPointer();
303
+ }
304
+ catch {
305
+ // 卸载收尾时写不进就放弃,别让退出路径再抛错
306
+ }
307
+ };
308
+ }, [stdout]);
309
+ /** Composer 草稿镜像(双击 Esc 撤回判断输入框是否为空)。 */
310
+ const handleDraftChange = useCallback((text) => {
311
+ draftRef.current = text;
312
+ }, []);
313
+ // notice 8 秒自动过期:提示盒常驻会挡住后续操作语义(用户反馈:命令提示
314
+ // 一直展示);有新 notice 就重置计时。不做「打字即清」——双击 Esc 撤回会把
315
+ // 文本灌回输入框(非空草稿事件),当场抹掉刚设置的撤回提示(电池实锤)。
316
+ useEffect(() => {
317
+ if (notice === null)
318
+ return;
319
+ const timer = setTimeout(() => setNotice(null), 8_000);
320
+ return () => clearTimeout(timer);
321
+ }, [notice]);
322
+ // 图片预览的字符画现算:preview(含 index)一变就重渲染当前那张。
323
+ useEffect(() => {
324
+ if (preview === null) {
325
+ setPreviewBlock(null);
326
+ setPreviewError(null);
327
+ setPreviewLoading(false);
328
+ return;
329
+ }
330
+ const source = preview.sources[preview.index];
331
+ if (source === undefined)
332
+ return;
333
+ let cancelled = false;
334
+ setPreviewLoading(true);
335
+ setPreviewError(null);
336
+ const render = imageRenderer ?? renderImageBlock;
337
+ render(source, Math.max(10, (stdout?.columns ?? 80) - 4), Math.max(4, (stdout?.rows ?? 24) - 10))
338
+ .then((block) => {
339
+ if (cancelled)
340
+ return;
341
+ setPreviewBlock(block);
342
+ setPreviewLoading(false);
343
+ })
344
+ .catch((cause) => {
345
+ if (cancelled)
346
+ return;
347
+ setPreviewBlock(null);
348
+ setPreviewLoading(false);
349
+ setPreviewError(cause instanceof Error ? cause.message : String(cause));
350
+ });
351
+ return () => {
352
+ cancelled = true;
353
+ };
354
+ }, [preview, imageRenderer, stdout]);
355
+ // 卡片换人(或消失)时复位对应的本地状态。
356
+ useEffect(() => setApprovalExpanded(false), [approval?.id]);
357
+ useEffect(() => {
358
+ setPlanExpanded(false);
359
+ setPlanFeedback(false);
360
+ }, [plan?.file, plan?.title]);
361
+ useEffect(() => {
362
+ setAskIndex(0);
363
+ setAskChecked([]);
364
+ setAskHighlight(0);
365
+ setAskText('');
366
+ }, [question?.id]);
367
+ /** 提问卡推进到下一题(最后一题交出后服务收卡,本地进度直接归零)。 */
368
+ const advanceAsk = () => {
369
+ setAskChecked([]);
370
+ setAskHighlight(0);
371
+ setAskText('');
372
+ setAskIndex((current) => (current + 1 < askQuestions.length ? current + 1 : 0));
373
+ };
374
+ /** 交出当前题的答案:有自由文本用文本,否则按勾选(多选)或高亮(单选)。 */
375
+ const submitAsk = (raw) => {
376
+ if (question === null || currentQuestion === undefined)
377
+ return;
378
+ let answer = raw.trim();
379
+ if (answer === '') {
380
+ if (currentQuestion.multiSelect) {
381
+ const labels = askChecked
382
+ .map((position) => currentQuestion.options[position]?.label)
383
+ .filter((label) => label !== undefined);
384
+ if (labels.length === 0)
385
+ return;
386
+ answer = labels.join('、');
387
+ }
388
+ else {
389
+ const option = currentQuestion.options[askHighlight];
390
+ if (option === undefined)
391
+ return;
392
+ answer = option.label;
393
+ }
394
+ }
395
+ runtime.answerQuestion(answer);
396
+ advanceAsk();
397
+ };
398
+ // ---- 会话选择器的数据整形:置顶优先、最近更新在前,输入即筛选 ----
399
+ const pickerSource = useMemo(() => {
400
+ const source = pickerPage === 'active'
401
+ ? [...snapshot.sessions]
402
+ : archivedList.map((item) => ({
403
+ id: item.path,
404
+ cwd: item.cwd,
405
+ createdAt: item.createdAt,
406
+ updatedAt: item.updatedAt,
407
+ ...(item.title !== undefined ? { title: item.title } : {}),
408
+ }));
409
+ source.sort((a, b) => (b.pinnedAt ?? 0) - (a.pinnedAt ?? 0) || b.updatedAt - a.updatedAt);
410
+ return source;
411
+ }, [pickerPage, snapshot.sessions, archivedList]);
412
+ /** 工作区分桶(当前页数据源按 cwd 归堆):当前会话所在工作区置顶,其余按最新会话时间降序。 */
413
+ const workspaceEntries = useMemo(() => {
414
+ const buckets = new Map();
415
+ for (const session of pickerSource) {
416
+ const bucket = buckets.get(session.cwd);
417
+ if (bucket === undefined) {
418
+ buckets.set(session.cwd, { cwd: session.cwd, count: 1, latest: session.updatedAt });
419
+ }
420
+ else {
421
+ bucket.count += 1;
422
+ bucket.latest = Math.max(bucket.latest, session.updatedAt);
423
+ }
424
+ }
425
+ const currentCwd = snapshot.status.cwd ?? null;
426
+ return [...buckets.values()].sort((a, b) => (a.cwd === currentCwd ? 0 : 1) - (b.cwd === currentCwd ? 0 : 1) || b.latest - a.latest);
427
+ }, [pickerSource, snapshot.status.cwd]);
428
+ /** 工作区层 = 未钻取且工作区不止一个(单工作区直落会话层,省一次回车)。 */
429
+ const activeWorkspace = pickerWorkspace ?? (workspaceEntries.length === 1 ? (workspaceEntries[0]?.cwd ?? null) : null);
430
+ const isWorkspaceLevel = activeWorkspace === null;
431
+ /** 工作区层的筛选(名称/路径子串)。 */
432
+ const workspaceList = useMemo(() => {
433
+ const q = pickerQuery.trim().toLowerCase();
434
+ if (q === '')
435
+ return workspaceEntries;
436
+ return workspaceEntries.filter((entry) => workspaceLabel(entry.cwd).toLowerCase().includes(q) || entry.cwd.toLowerCase().includes(q));
437
+ }, [workspaceEntries, pickerQuery]);
438
+ /** 会话层 = 已选工作区(或单工作区直落)的会话,再过筛选词。 */
439
+ const pickerList = useMemo(() => {
440
+ const scoped = activeWorkspace === null
441
+ ? pickerSource
442
+ : pickerSource.filter((session) => session.cwd === activeWorkspace);
443
+ const q = pickerQuery.trim().toLowerCase();
444
+ if (q === '')
445
+ return scoped;
446
+ return scoped.filter((session) => (session.title ?? '').toLowerCase().includes(q) ||
447
+ session.cwd.toLowerCase().includes(q) ||
448
+ session.id.toLowerCase().includes(q));
449
+ }, [pickerSource, activeWorkspace, pickerQuery]);
450
+ // ---- 恒定帧与各视口的窗口切片 ----
451
+ const termRows = stdout?.rows ?? 24;
452
+ /** 帧内容行数:终端行数 − 1(ink 帧自带尾随换行,末行留给光标落点)。 */
453
+ const frameRows = Math.max(1, termRows - 1);
454
+ /** 终端列数(浮层宽度、刻度栏门槛、标题截断都按它算)。 */
455
+ const columns = stdout?.columns ?? 100;
456
+ /** 状态栏行数(去掉 context 进度条后固定一行):正文、浮层视口、刻度居中高度都按它算。 */
457
+ const statusbarLines = 1;
458
+ /** 回看 / 子代理转录浮层的视口行数(帧内扣掉状态栏与浮层框架)。翻页步长问视口要。 */
459
+ const overlayViewportLines = Math.max(1, frameRows - statusbarLines - TRANSCRIPT_CHROME);
460
+ /** 当前层的行数(工作区层 = 工作区数,会话层 = 会话数);窗口切片与点击映射都按它算。 */
461
+ const pickerRowCount = isWorkspaceLevel ? workspaceList.length : pickerList.length;
462
+ /** 选择器列表窗口:框内除固定框架外全部让给列表(点击行号映射按它 1:1 对齐)。 */
463
+ const pickerListRows = Math.min(Math.max(pickerRowCount, 0), Math.max(1, frameRows - statusbarLines - PICKER_CHROME));
464
+ /** 窗口起点:选中项尽量居中(fzf 式),两端夹住;列表放得下时等于 0。 */
465
+ const pickerStart = Math.min(Math.max(0, pickerIndex - Math.floor((pickerListRows - 1) / 2)), Math.max(0, pickerRowCount - pickerListRows));
466
+ const visibleSessions = pickerList.slice(pickerStart, pickerStart + pickerListRows);
467
+ const visibleWorkspaces = workspaceList
468
+ .slice(pickerStart, pickerStart + pickerListRows)
469
+ .map((entry) => ({
470
+ cwd: entry.cwd,
471
+ name: workspaceLabel(entry.cwd),
472
+ count: entry.count,
473
+ latest: entry.latest,
474
+ current: entry.cwd !== '' && entry.cwd === snapshot.status.cwd,
475
+ }));
476
+ // ---- 设置页(/settings)的行模型与窗口切片(几何与 SettingsOverlay 共表)----
477
+ const settingsRows = useMemo(() => buildSettingsRows(settingsSections, settingsSection, settingsGroup), [settingsSections, settingsSection, settingsGroup]);
478
+ const settingsFocusables = useMemo(() => focusableRows(settingsRows, settingsSections), [settingsRows, settingsSections]);
479
+ /** 焦点行 = focusables 里的第 index 个;列表变短时夹住(分区装载前后都安全)。 */
480
+ const settingsFocusRow = settingsFocusables[Math.min(settingsIndex, Math.max(0, settingsFocusables.length - 1))] ?? 0;
481
+ /** 设置页视口:帧内扣除固定框架(上下边框 2 + 标题 1 + notice 1 + 提示条 1)。 */
482
+ const settingsViewport = Math.max(1, frameRows - statusbarLines - SETTINGS_CHROME);
483
+ const settingsWindow = settingsWindowStart(settingsFocusRow, settingsViewport, settingsRows.length);
484
+ /** 条数的实时镜像(「离开最新」回调里要用当次的条数,回调引用要稳定)。 */
485
+ const entriesLenRef = useRef(0);
486
+ entriesLenRef.current = snapshot.entries.length;
487
+ /** 聊天区贴着最新 / 离开最新的切换(回到底部胶囊的数据源)。 */
488
+ const handleChatAtTail = useCallback((atTail) => {
489
+ setChatAwayFrom(atTail ? null : entriesLenRef.current);
490
+ }, []);
491
+ /** 归档页的数据加载(Tab 切页时拉一次;动作之后刷新也走这里)。 */
492
+ const reloadArchived = useCallback(() => {
493
+ void runtime
494
+ .listArchivedSessions()
495
+ .then((page) => setArchivedList(page.items))
496
+ .catch(() => setArchivedList([]));
497
+ }, [runtime]);
498
+ const togglePickerPage = () => {
499
+ setPickerArmed(false);
500
+ setPickerBuffer(null);
501
+ setPickerIndex(0);
502
+ setPickerQuery('');
503
+ // 两页的工作区集合不同:切页回工作区层重新选(dsh 总管同语义)。
504
+ setPickerWorkspace(null);
505
+ if (pickerPage === 'active') {
506
+ setPickerPage('archived');
507
+ reloadArchived();
508
+ }
509
+ else {
510
+ setPickerPage('active');
511
+ void runtime.refreshSessions();
512
+ }
513
+ };
514
+ /** 选择器里的会话动作(改名/置顶/归档/恢复/删除/分叉)统一收口:跑完刷新 + 错误上屏。 */
515
+ const pickerAction = (work) => {
516
+ void work()
517
+ .then((result) => {
518
+ if (result !== undefined && result.ok === false)
519
+ setNotice(result.error ?? '操作失败');
520
+ if (pickerPage === 'active')
521
+ void runtime.refreshSessions();
522
+ else
523
+ reloadArchived();
524
+ })
525
+ .catch((cause) => setNotice(cause instanceof Error ? cause.message : String(cause)));
526
+ };
527
+ /** 打开当前选中会话(Enter 与「点击已选中行」共用):归档页先恢复回活动区再打开。 */
528
+ const openSelectedSession = () => {
529
+ const selected = pickerList[pickerIndex];
530
+ if (selected === undefined)
531
+ return;
532
+ setPicker(false);
533
+ chatRef.current?.toTail();
534
+ if (pickerPage === 'archived') {
535
+ pickerAction(() => runtime.restoreSessions([selected.id]));
536
+ void runtime.openSession(selected.id);
537
+ }
538
+ else {
539
+ void runtime.openSession(selected.id);
540
+ }
541
+ };
542
+ /** 应用当前选中的模型(Enter 与「点击已选中项」共用)。 */
543
+ const applyModel = () => {
544
+ const choice = modelList[modelIndex];
545
+ if (choice === undefined)
546
+ return;
547
+ setModelPicker(false);
548
+ void runtime.setModel(choice.value);
549
+ };
550
+ /** 应用当前选中的模式(Enter 与「点击已选中项」共用):回执走 notice。 */
551
+ const applyPreset = () => {
552
+ const preset = presetList[presetIndex];
553
+ if (preset === undefined)
554
+ return;
555
+ setPresetPicker(false);
556
+ const mutation = runtime.usePreset(preset.name);
557
+ setNotice(mutation.ok ? mutation.notice ?? `已切换到模式「${preset.label}」` : mutation.error);
558
+ };
559
+ /** 应用当前选中的技能(Enter 与「点击已选中项」共用):把 /技能名 灌回输入行。 */
560
+ const applySkill = () => {
561
+ const skill = skillsList[skillsIndex];
562
+ if (skill === undefined)
563
+ return;
564
+ if (!skill.userInvocable) {
565
+ setNotice(`技能 ${skill.name} 没注册成命令(不进模型目录),不能这样调用`);
566
+ return;
567
+ }
568
+ setSkillsPicker(false);
569
+ setNotice(null);
570
+ setComposerPreset({ text: `/${skill.name} `, token: Date.now() });
571
+ };
572
+ // ---- 0.6.61:设置页的动作(Enter 与鼠标点击共用的唯一真源)----
573
+ /** 写一个设置项:回执进设置页底部 notice 行;成功后就地刷新值表(改动即保存)。 */
574
+ const applySetting = (sectionId, key, value) => {
575
+ void runtime
576
+ .setSettingValue(sectionId, key, value)
577
+ .then((mutation) => {
578
+ if (!mutation.ok) {
579
+ setSettingsNotice({ ok: false, text: mutation.error });
580
+ return;
581
+ }
582
+ setSettingsValues((current) => ({
583
+ ...current,
584
+ [sectionId]: { ...current[sectionId], [key]: value },
585
+ }));
586
+ setSettingsNotice({ ok: true, text: mutation.notice ?? '已保存' });
587
+ // 思考块默认展开除了新会话语义,当前会话也当场跟着切
588
+ if (sectionId === 'tui' && key === 'reasoningDefaultOpen')
589
+ setExpandThinking(value === true);
590
+ // 状态栏段开关(0.6.62):就地改 state,关页即见(静默保存,无回执)
591
+ if (sectionId === 'tui' && key.startsWith('statusBar.')) {
592
+ setStatusBarPrefs((current) => ({ ...current, [key.slice('statusBar.'.length)]: value === true }));
593
+ }
594
+ })
595
+ .catch((cause) => setSettingsNotice({ ok: false, text: cause instanceof Error ? cause.message : String(cause) }));
596
+ };
597
+ /** 执行分区动作(button 字段):回执可能带结构化载荷(发布页链接等),TUI 只显示文案。 */
598
+ const runSettingsAction = (sectionId, action) => {
599
+ void runtime
600
+ .runSettingAction(sectionId, action)
601
+ .then((mutation) => {
602
+ if (!mutation.ok) {
603
+ setSettingsNotice({ ok: false, text: mutation.error });
604
+ return;
605
+ }
606
+ const fallback = mutation.data?.kind === 'url' ? mutation.data.url : '已完成';
607
+ setSettingsNotice({ ok: true, text: mutation.notice ?? fallback });
608
+ })
609
+ .catch((cause) => setSettingsNotice({ ok: false, text: cause instanceof Error ? cause.message : String(cause) }));
610
+ };
611
+ /** info.copyable 行的复制:/copy 同款(win32 clip / darwin pbcopy / linux wl-copy)。 */
612
+ const copyInfoText = (text) => {
613
+ const command = process.platform === 'darwin' ? 'pbcopy' : process.platform === 'win32' ? 'clip' : 'wl-copy';
614
+ try {
615
+ const child = spawn(command, [], { stdio: ['pipe', 'ignore', 'ignore'] });
616
+ child.on('error', () => setSettingsNotice({ ok: false, text: `复制失败:找不到 ${command} 命令` }));
617
+ child.stdin?.end(text);
618
+ setSettingsNotice({ ok: true, text: `已复制:${text}` });
619
+ }
620
+ catch (error) {
621
+ setSettingsNotice({
622
+ ok: false,
623
+ text: `复制失败:${error instanceof Error ? error.message : String(error)}`,
624
+ });
625
+ }
626
+ };
627
+ /** 行 → 字段解析(结构行或下标越界返回 null)。 */
628
+ const settingsFieldAt = (row) => {
629
+ if (row === undefined || row.kind !== 'field')
630
+ return null;
631
+ const section = settingsSections.find((entry) => entry.id === row.sectionId);
632
+ const field = section?.fields[row.fieldIndex];
633
+ return field !== undefined ? { sectionId: row.sectionId, field } : null;
634
+ };
635
+ /** 行的主动作(Enter 与「点击该行」共用):switch/select 改值即存,text/number 进编辑。 */
636
+ const activateSettingsRow = (row, direction) => {
637
+ if (row?.kind === 'section') {
638
+ // 进分区页(0.6.64 两级导航):焦点与草稿归零;Esc 由键盘分支逐级退栈
639
+ setSettingsSection(row.sectionId);
640
+ setSettingsIndex(0);
641
+ setSettingsEdit(null);
642
+ return;
643
+ }
644
+ if (row?.kind === 'group') {
645
+ // 进组子页(dsh 同款):焦点与草稿归零;Esc 由键盘分支先退子页再关页
646
+ setSettingsGroup({ sectionId: row.sectionId, groupId: row.groupId });
647
+ setSettingsIndex(0);
648
+ setSettingsEdit(null);
649
+ return;
650
+ }
651
+ if (row?.kind === 'hint') {
652
+ if (row.jump === 'model-picker') {
653
+ setSettingsOpen(false);
654
+ setModelPicker(true);
655
+ setModelIndex(0);
656
+ setModelQuery('');
657
+ }
658
+ else if (row.jump === 'usage') {
659
+ setSettingsOpen(false);
660
+ runCommand('/usage', runtime, {
661
+ openPicker: openSessionPicker,
662
+ openModels: () => { },
663
+ openAgents,
664
+ notice: setNotice,
665
+ });
666
+ }
667
+ return;
668
+ }
669
+ const hit = settingsFieldAt(row);
670
+ if (hit === null)
671
+ return;
672
+ const { sectionId, field } = hit;
673
+ if (field.type === 'switch') {
674
+ applySetting(sectionId, field.key, settingsValues[sectionId]?.[field.key] === true ? false : true);
675
+ return;
676
+ }
677
+ if (field.type === 'select') {
678
+ const options = field.options;
679
+ if (options.length === 0)
680
+ return;
681
+ const current = String(settingsValues[sectionId]?.[field.key] ?? '');
682
+ const at = options.findIndex((option) => option.value === current);
683
+ const next = options[(((at + direction) % options.length) + options.length) % options.length] ?? options[0];
684
+ if (next !== undefined)
685
+ applySetting(sectionId, field.key, next.value);
686
+ return;
687
+ }
688
+ if (field.type === 'text' || field.type === 'number') {
689
+ const current = settingsValues[sectionId]?.[field.key];
690
+ setSettingsEdit({ sectionId, key: field.key, draft: current === undefined ? '' : String(current) });
691
+ return;
692
+ }
693
+ if (field.type === 'button') {
694
+ runSettingsAction(sectionId, field.action);
695
+ return;
696
+ }
697
+ if (field.type === 'info' && field.copyable === true)
698
+ copyInfoText(field.text);
699
+ };
700
+ /** 编辑态 Enter:number 先校验(非法留编辑态弹红,对齐 dsh),text 直接入库。 */
701
+ const commitSettingsEdit = () => {
702
+ if (settingsEdit === null)
703
+ return;
704
+ const hit = settingsFieldAt(settingsRows[settingsFocusRow]);
705
+ if (hit === null || !('key' in hit.field) || hit.field.key !== settingsEdit.key) {
706
+ setSettingsEdit(null);
707
+ return;
708
+ }
709
+ if (hit.field.type === 'number') {
710
+ const parsed = Number(settingsEdit.draft);
711
+ const invalid = settingsEdit.draft.trim() === '' ||
712
+ Number.isNaN(parsed) ||
713
+ (hit.field.min !== undefined && parsed < hit.field.min) ||
714
+ (hit.field.max !== undefined && parsed > hit.field.max);
715
+ if (invalid) {
716
+ const range = `${hit.field.min ?? '-∞'}–${hit.field.max ?? '∞'}`;
717
+ setSettingsNotice({ ok: false, text: `无效输入:需要 ${range} 之间的数字` });
718
+ return;
719
+ }
720
+ setSettingsEdit(null);
721
+ applySetting(hit.sectionId, hit.field.key, parsed);
722
+ return;
723
+ }
724
+ setSettingsEdit(null);
725
+ if (hit.field.type === 'text')
726
+ applySetting(hit.sectionId, hit.field.key, settingsEdit.draft);
727
+ };
728
+ // ---- 0.6.57:双击 Esc 撤回上一轮 ----
729
+ /**
730
+ * 撤回上一轮(对齐 codex 的 backtrack 语义、dsh 的 fork 实现):fork 出
731
+ * 「最后一条用户消息之前」的新会话并切换过去,原话放回输入框改完重发;
732
+ * 原会话原样保留(不删任何条目,/resume 里随时找回)。
733
+ */
734
+ const rewindLastTurn = () => {
735
+ const path = snapshot.status.sessionId;
736
+ if (path === null || path === '') {
737
+ setNotice('还没有对话可撤回');
738
+ return;
739
+ }
740
+ void runtime
741
+ .listUserMessages(path)
742
+ .then(async (messages) => {
743
+ const last = messages[messages.length - 1];
744
+ if (last === undefined)
745
+ return '这个会话还没有用户消息,没得撤';
746
+ const fork = await runtime.forkSession(path, messages.length - 1);
747
+ if (!fork.ok)
748
+ return fork.error === '' ? '撤回失败' : fork.error;
749
+ await runtime.openSession(fork.path);
750
+ setComposerPreset((current) => ({ text: last, token: current.token + 1 }));
751
+ chatRef.current?.toTail();
752
+ setAttachments([]);
753
+ return '已撤回上一轮,原话已放回输入框(原会话保留在 /resume)';
754
+ })
755
+ .then((message) => {
756
+ if (typeof message === 'string')
757
+ setNotice(message);
758
+ })
759
+ .catch((cause) => setNotice(cause instanceof Error ? cause.message : String(cause)));
760
+ };
761
+ // ---- 0.6.57:剪贴板贴图与附件芯片 ----
762
+ /** Ctrl+V:剪贴板里是图就挂芯片(提交时读成 data URL),是文本就并入草稿。 */
763
+ const handlePaste = () => {
764
+ const read = clipboardReader ?? readClipboardImage;
765
+ void read()
766
+ .then((result) => {
767
+ if (result.kind === 'image') {
768
+ attachmentSeq.current += 1;
769
+ const id = attachmentSeq.current;
770
+ setAttachments((current) => [
771
+ ...current,
772
+ {
773
+ id,
774
+ path: result.path,
775
+ name: result.path.split(/[\\/]/).pop() ?? result.path,
776
+ },
777
+ ]);
778
+ setNotice(`已附加图片 #${id}(点击芯片预览,Enter 随消息发送)`);
779
+ return;
780
+ }
781
+ if (result.kind === 'text' && result.text.trim() !== '') {
782
+ setComposerPreset((current) => ({
783
+ text: draftRef.current + result.text,
784
+ token: current.token + 1,
785
+ }));
786
+ return;
787
+ }
788
+ setNotice('剪贴板里没有图片(文字粘贴交给终端,Ctrl+V 只接图)');
789
+ })
790
+ .catch(() => setNotice('剪贴板读取失败'));
791
+ };
792
+ /** 摘下一枚附件芯片。 */
793
+ const removeAttachment = (id) => {
794
+ setAttachments((current) => current.filter((att) => att.id !== id));
795
+ };
796
+ /** 点附件芯片:开这张图的预览。 */
797
+ const previewAttachment = (id) => {
798
+ const att = attachments.find((item) => item.id === id);
799
+ if (att === undefined)
800
+ return;
801
+ setPreview({ title: att.name, sources: [{ path: att.path }], index: 0 });
802
+ };
803
+ /** 点会话流里的图片行:预览历史消息带的图(data URL 现场落临时文件解码)。 */
804
+ const handlePreviewImages = useCallback((images) => {
805
+ setPreview({
806
+ title: `图片(${images.length} 张)`,
807
+ sources: images.map((dataUrl) => ({ dataUrl })),
808
+ index: 0,
809
+ });
810
+ }, []);
811
+ // ---- 0.6.57:子代理查看 ----
812
+ /** 打开某个代理/后台会话的只读转录(peek 不改文件)。 */
813
+ const openAgentTranscript = useCallback((file, title) => {
814
+ setAgentView({ mode: 'transcript', file, title });
815
+ setAgentEntries(null);
816
+ lastPeek.current = Date.now();
817
+ void runtime
818
+ .peekTranscript(file)
819
+ .then((entries) => setAgentEntries(entries))
820
+ .catch(() => setAgentEntries([]));
821
+ }, [runtime]);
822
+ /**
823
+ * 子代理转录「跟活」(旧账修正):原先只在打开那一刻 peek 一次,之后永远冻着——队友
824
+ * 干到哪都看不见(用户报的「点进子代看不到工作过程」)。现在打开期间跟着父转录的每次
825
+ * 快照更新重新取一次,节流到 ≥400ms(每次都是一次 `Session.load` + 全量重放,文件大
826
+ * 时是重活);关闭即停,过期回包按 cancelled 丢掉。
827
+ */
828
+ useEffect(() => {
829
+ if (agentView === null || agentView.mode !== 'transcript')
830
+ return;
831
+ const file = agentView.file;
832
+ let cancelled = false;
833
+ const wait = Math.max(0, PEEK_REFRESH_MS - (Date.now() - lastPeek.current));
834
+ const timer = setTimeout(() => {
835
+ if (cancelled)
836
+ return;
837
+ lastPeek.current = Date.now();
838
+ void runtime
839
+ .peekTranscript(file)
840
+ .then((entries) => {
841
+ if (!cancelled)
842
+ setAgentEntries(entries);
843
+ })
844
+ .catch(() => {
845
+ if (!cancelled)
846
+ setAgentEntries([]);
847
+ });
848
+ }, wait);
849
+ return () => {
850
+ cancelled = true;
851
+ clearTimeout(timer);
852
+ };
853
+ }, [agentView, snapshot, runtime]);
854
+ /** 子代理卡点击:打开它的只读转录。引用要稳定——`Entry` 是 memo 的,内联箭头会让它每帧重渲染。 */
855
+ const handleOpenAgent = useCallback((file) => openAgentTranscript(file, shortId(file)), [openAgentTranscript]);
856
+ /** /agents 打开名单浮层(命令 ui 回调)。 */
857
+ const openAgents = useCallback(() => {
858
+ setAgentView({ mode: 'list' });
859
+ setAgentIndex(0);
860
+ }, []);
861
+ /** 打开设置页(/settings 命令入口):同步拿分区表,值表逐分区异步装填。 */
862
+ const openSettings = useCallback(() => {
863
+ const sections = runtime.getSettingsSections();
864
+ setSettingsSections(sections);
865
+ setSettingsValues({});
866
+ setSettingsIndex(0);
867
+ setSettingsEdit(null);
868
+ setSettingsNotice(null);
869
+ setSettingsGroup(null);
870
+ setSettingsSection(null);
871
+ setSettingsOpen(true);
872
+ for (const section of sections) {
873
+ void runtime
874
+ .getSectionValues(section.id)
875
+ .then((sectionValues) => {
876
+ setSettingsValues((current) => ({ ...current, [section.id]: sectionValues }));
877
+ })
878
+ .catch(() => {
879
+ // 单个分区取值失败不拖垮整页:空表 = 控件显示占位,保存时由后端报错
880
+ setSettingsValues((current) => ({ ...current, [section.id]: {} }));
881
+ });
882
+ }
883
+ }, [runtime]);
884
+ /** 打开会话选择器(/resume 命令、输入框 ⌸ 按钮、点击入口共用一条通道)。 */
885
+ const openSessionPicker = useCallback(() => {
886
+ setPicker(true);
887
+ setPickerIndex(0);
888
+ setPickerQuery('');
889
+ setPickerPage('active');
890
+ setPickerWorkspace(null);
891
+ void runtime.refreshSessions();
892
+ }, [runtime]);
893
+ /** 工作区层的 Enter/再点:钻进该工作区的会话列表(清筛选,焦点回顶)。 */
894
+ const enterWorkspace = (index) => {
895
+ const entry = workspaceList[index];
896
+ if (entry === undefined)
897
+ return;
898
+ setPickerWorkspace(entry.cwd);
899
+ setPickerIndex(0);
900
+ setPickerQuery('');
901
+ setPickerArmed(false);
902
+ };
903
+ /** 名单浮层的行(队友在前、后台会话在后;与渲染同一条装配规则)。 */
904
+ const agentRows = agentView !== null && agentView.mode === 'list'
905
+ ? buildAgentRows(runtime.listTeammates(), snapshot.sessionStates)
906
+ : [];
907
+ // ---- 卡片鼠标动作(与按键一一等价;键盘路由仍是唯一真源,这里只是映射)----
908
+ const handleApprovalAction = (action) => {
909
+ if (approval === null)
910
+ return;
911
+ if (action === 'allow-once')
912
+ runtime.answerApproval('allow-once');
913
+ else if (action === 'allow-session') {
914
+ if (approval.scopes.includes('session'))
915
+ runtime.answerApproval('allow-session');
916
+ }
917
+ else if (action === 'allow-always') {
918
+ if (approval.scopes.includes('always'))
919
+ runtime.answerApproval('allow-always');
920
+ }
921
+ else if (action === 'reject')
922
+ runtime.answerApproval('reject');
923
+ else if (action === 'toggle-diff')
924
+ setApprovalExpanded((current) => !current);
925
+ };
926
+ const handlePlanAction = (action) => {
927
+ if (action === 'approve')
928
+ runtime.answerPlan('approved');
929
+ else if (action === 'reject')
930
+ runtime.answerPlan('rejected');
931
+ else if (action === 'feedback')
932
+ setPlanFeedback(true);
933
+ else if (action === 'toggle')
934
+ setPlanExpanded((current) => !current);
935
+ };
936
+ const handleAskOption = (option) => {
937
+ if (question === null || currentQuestion === undefined)
938
+ return;
939
+ if (currentQuestion.multiSelect) {
940
+ setAskChecked((current) => current.includes(option)
941
+ ? current.filter((position) => position !== option)
942
+ : [...current, option]);
943
+ return;
944
+ }
945
+ const chosen = currentQuestion.options[option];
946
+ if (chosen === undefined)
947
+ return;
948
+ runtime.answerQuestion(chosen.label);
949
+ advanceAsk();
950
+ };
951
+ /**
952
+ * 把一次「左键按下」派发给命中区:选择器/浮层优先,其余交给登记过的命中区(卡片页脚按钮、
953
+ * 提问选项、回底提示条、附件与后台芯片、图片行、刻度列与滚动条…)。
954
+ *
955
+ * 几何**点击时才现量**(`absoluteTop` / `measuredHeight` 读的是上一帧的 yoga 结果):
956
+ * 注册时量到的是更早的尺寸,而点击离上一次绘制总有一段人手时差——现量才跟得上节流渲染。
957
+ *
958
+ * 返回**这次按下的去向**:认拖动的区(刻度列 / 比例滚动条)被按下时要把拖动会话开在它
959
+ * 身上(见 `dragTarget`)——按住划 = 一连串跳到那一行,且只有从那个区上按下去的才认。
960
+ */
961
+ function dispatchMouseClick(col, row) {
962
+ if (picker) {
963
+ if (pickerBuffer !== null)
964
+ return null; // 改名输入态不响应鼠标
965
+ // 列表行从「顶边框+标题+筛选行」之后起排(改名行再往下顺延一行)。
966
+ const listTop = 3 + (pickerBuffer !== null ? 1 : 0);
967
+ const row0 = row - 1 - listTop;
968
+ if (row0 < 0 || row0 >= pickerListRows)
969
+ return null;
970
+ const hit = pickerStart + row0;
971
+ // 两级行结构相同(listTop/切片一致):工作区层再点 = 钻入,会话层再点 = 打开。
972
+ if (hit !== pickerIndex) {
973
+ setPickerIndex(hit);
974
+ return null;
975
+ }
976
+ if (isWorkspaceLevel)
977
+ enterWorkspace(hit);
978
+ else
979
+ openSelectedSession();
980
+ return null;
981
+ }
982
+ if (modelPicker) {
983
+ const row0 = row - 1 - 3;
984
+ if (row0 < 0 || row0 >= modelList.length)
985
+ return null;
986
+ if (row0 === modelIndex)
987
+ applyModel();
988
+ else
989
+ setModelIndex(row0);
990
+ return null;
991
+ }
992
+ if (presetPicker) {
993
+ const row0 = row - 1 - 3;
994
+ if (row0 < 0 || row0 >= presetList.length)
995
+ return null;
996
+ if (row0 === presetIndex)
997
+ applyPreset();
998
+ else
999
+ setPresetIndex(row0);
1000
+ return null;
1001
+ }
1002
+ if (skillsPicker) {
1003
+ const row0 = row - 1 - 3;
1004
+ if (row0 < 0 || row0 >= skillsList.length)
1005
+ return null;
1006
+ if (row0 === skillsIndex)
1007
+ applySkill();
1008
+ else
1009
+ setSkillsIndex(row0);
1010
+ return null;
1011
+ }
1012
+ if (settingsOpen) {
1013
+ if (settingsEdit !== null)
1014
+ return null; // 草稿由键盘独占(对齐 dsh 的编辑态)
1015
+ // 列表行从「外框顶边 + 标题行」之后起排,滚动窗口与组件共用同一份行模型
1016
+ const slice = row - 1 - SETTINGS_LIST_TOP;
1017
+ if (slice < 0 || slice >= settingsViewport)
1018
+ return null;
1019
+ const target = settingsRows[settingsWindow + slice];
1020
+ if (target === undefined || (target.kind !== 'field' && target.kind !== 'hint' && target.kind !== 'group' && target.kind !== 'section'))
1021
+ return null;
1022
+ const fields = settingsSections.find((section) => section.id === target.sectionId)?.fields ?? [];
1023
+ if (!isFocusableRow(target, fields))
1024
+ return null;
1025
+ activateSettingsRow(target, 1);
1026
+ return null;
1027
+ }
1028
+ // 卡片页脚按钮 / 提问选项 / 回底提示条 / 附件与后台芯片 / 图片行:点击时现量
1029
+ // 几何(避免节流渲染导致的滞后),再询问判定函数;谁命中谁消费。
1030
+ for (const entry of clickRegions.current) {
1031
+ const top = absoluteTop(entry.node.current);
1032
+ const height = measuredHeight(entry.node.current);
1033
+ if (top === null || height === null)
1034
+ continue;
1035
+ if (entry.hit(col - 1, row - 1, top, height))
1036
+ return entry;
1037
+ }
1038
+ return null;
1039
+ }
1040
+ /**
1041
+ * 把一次「按住划」(SGR 1002 的 32 号事件)派发给**按下时开在这上面的那个拖动区**
1042
+ * (刻度列 / 比例滚动条)。
1043
+ *
1044
+ * 为什么要有会话:没有它,终端报的每一个「按住移动」都要拿去问所有认拖动的区——
1045
+ * 只要行落在刻度块那一段、列碰巧对上,正文里按住划一下就把视图跳走(用户报障:
1046
+ * 「左键点任意位置都被当成点滚动条」)。会话只从**按下**开(`dispatchMouseClick` 的
1047
+ * 返回值),松手即关;命中判定里的列判定也照旧生效——手划出刻度列就停,划回来接着跟手。
1048
+ */
1049
+ function dispatchMouseDrag(col, row) {
1050
+ const entry = dragTarget.current;
1051
+ if (entry === null)
1052
+ return;
1053
+ // 区已注销(换会话/开浮层把聊天区卸了):会话作废
1054
+ if (!clickRegions.current.has(entry)) {
1055
+ dragTarget.current = null;
1056
+ return;
1057
+ }
1058
+ const top = absoluteTop(entry.node.current);
1059
+ const height = measuredHeight(entry.node.current);
1060
+ if (top === null || height === null)
1061
+ return;
1062
+ entry.hit(col - 1, row - 1, top, height);
1063
+ }
1064
+ useInput((input, key) => {
1065
+ // SGR 鼠标事件最顶层拦截:滚轮按状态路由,左键点击派发给命中区,纯移动喂刻度列的悬停。
1066
+ // `parseMouse` 收**一包多条**(终端会把连着发生的事件攒一包发;旧锚定正则碰上就整包掉进
1067
+ // 键盘路径,最坏被读成 Esc)。
1068
+ const mouse = parseMouse(input);
1069
+ if (mouse !== null) {
1070
+ for (const event of mouse) {
1071
+ const col = event.col;
1072
+ const row = event.row;
1073
+ // 按钮号拆位:低两位 0 左 / 1 中 / 2 右 / 3 无按钮;32 位 = 移动;64 位 = 滚轮。
1074
+ const kind = event.button & 3;
1075
+ const moving = (event.button & 32) !== 0;
1076
+ if ((event.button & 64) !== 0) {
1077
+ // 滚轮:64 上 / 65 下,一步一条(浮层/聊天同款颗粒度)。
1078
+ const step = kind === 0 ? -1 : 1;
1079
+ if (picker) {
1080
+ setPickerIndex((current) => Math.max(0, Math.min(current + step, pickerRowCount - 1)));
1081
+ }
1082
+ else if (modelPicker) {
1083
+ setModelIndex((current) => Math.max(0, Math.min(current + step, modelList.length - 1)));
1084
+ }
1085
+ else if (presetPicker) {
1086
+ setPresetIndex((current) => Math.max(0, Math.min(current + step, presetList.length - 1)));
1087
+ }
1088
+ else if (skillsPicker) {
1089
+ setSkillsIndex((current) => Math.max(0, Math.min(current + step, skillsList.length - 1)));
1090
+ }
1091
+ else if (agentView !== null) {
1092
+ if (agentView.mode === 'list') {
1093
+ setAgentIndex((current) => Math.max(0, Math.min(current + step, agentRows.length - 1)));
1094
+ }
1095
+ else {
1096
+ peekRef.current?.scrollLines(-step * WHEEL_LINES);
1097
+ }
1098
+ }
1099
+ else if (transcriptOpen) {
1100
+ overlayRef.current?.scrollLines(-step * WHEEL_LINES);
1101
+ }
1102
+ else if (settingsOpen) {
1103
+ // 设置页滚轮 = 移动焦点(dsh 同语义),窗口随焦点跟随
1104
+ setSettingsIndex((current) => Math.max(0, Math.min(current + step, Math.max(0, settingsFocusables.length - 1))));
1105
+ }
1106
+ else {
1107
+ chatRef.current?.scrollLines(-step * WHEEL_LINES);
1108
+ }
1109
+ continue;
1110
+ }
1111
+ if (moving && kind === 3) {
1112
+ // 纯移动(1003):只发布给刻度列的悬停用;指针在别处时 store 连通知都不发。
1113
+ // 「没有按键的移动」顺带说明没人按着——陈旧的拖动会话到此为止。
1114
+ dragTarget.current = null;
1115
+ publishPointer(col, row, columns);
1116
+ continue;
1117
+ }
1118
+ // 按住左键划过(1002):只喂「按下时开在刻度列/滚动条上的那个会话」,正文里划过
1119
+ // 不再误触任何滚动(用户报障:左键点/拖任意位置都像在点滚动条)。指针位置照发,
1120
+ // 读数条因此跟着手走(dsh 同观感)。
1121
+ const dragging = moving && kind === 0;
1122
+ if (kind !== 0)
1123
+ continue;
1124
+ if (dragging) {
1125
+ publishPointer(col, row, columns);
1126
+ dispatchMouseDrag(col, row);
1127
+ continue;
1128
+ }
1129
+ if (!event.press) {
1130
+ // 松手(0;x;ym):拖动会话结束
1131
+ dragTarget.current = null;
1132
+ continue;
1133
+ }
1134
+ clearPointer();
1135
+ // 按下:派发点击,并「就手」把拖动会话开给认拖动的区(按住划 = 一连串跳到那一行)
1136
+ const consumed = dispatchMouseClick(col, row);
1137
+ dragTarget.current = consumed !== null && consumed.drag === true ? consumed : null;
1138
+ }
1139
+ return;
1140
+ }
1141
+ // 任何非 Esc 按键都取消「再按一次 Esc」的 prime 态(对齐 codex 的 backtrack)。
1142
+ if (!key.escape)
1143
+ lastEsc.current = 0;
1144
+ // Ctrl+V 贴图:终端把粘贴限定成文本,纯图片剪贴板不发任何字节——按键层自己接。
1145
+ if (key.ctrl && input === 'v' && !modal) {
1146
+ handlePaste();
1147
+ return;
1148
+ }
1149
+ if (key.ctrl && input === 'c') {
1150
+ const now = Date.now();
1151
+ if (now - lastCtrlC.current < EXIT_WINDOW_MS) {
1152
+ runtime.exit();
1153
+ return;
1154
+ }
1155
+ lastCtrlC.current = now;
1156
+ if (snapshot.status.turnState !== 'idle')
1157
+ runtime.interrupt();
1158
+ else
1159
+ setNotice('再按一次 Ctrl+C 退出');
1160
+ return;
1161
+ }
1162
+ if (approval !== null) {
1163
+ if (input === 'y' || input === 'Y')
1164
+ runtime.answerApproval('allow-once');
1165
+ else if (input === 'a' || input === 'A') {
1166
+ if (approval.scopes.includes('session'))
1167
+ runtime.answerApproval('allow-session');
1168
+ }
1169
+ else if (input === 'p' || input === 'P') {
1170
+ if (approval.scopes.includes('always'))
1171
+ runtime.answerApproval('allow-always');
1172
+ }
1173
+ else if (input === 'n' || input === 'N' || key.escape)
1174
+ runtime.answerApproval('reject');
1175
+ else if ((input === 'v' || input === 'V') && approval.diff !== undefined)
1176
+ setApprovalExpanded((current) => !current);
1177
+ return;
1178
+ }
1179
+ if (question !== null) {
1180
+ const optionCount = currentQuestion?.options.length ?? 0;
1181
+ if (key.upArrow) {
1182
+ setAskHighlight((current) => Math.max(0, current - 1));
1183
+ }
1184
+ else if (key.downArrow) {
1185
+ setAskHighlight((current) => Math.min(optionCount - 1, current + 1));
1186
+ }
1187
+ else if (key.escape) {
1188
+ runtime.answerQuestion(SKIPPED_ANSWER);
1189
+ advanceAsk();
1190
+ }
1191
+ else if (key.return) {
1192
+ submitAsk(askText);
1193
+ }
1194
+ else if (key.backspace || key.delete) {
1195
+ setAskText((current) => current.slice(0, -1));
1196
+ }
1197
+ else if (input === ' ' && optionCount > 0 && currentQuestion !== undefined) {
1198
+ // 空格在选择题里是「选定/勾选」;有自由文本需求时打字即可(数字不占用)。
1199
+ if (currentQuestion.multiSelect) {
1200
+ setAskChecked((current) => current.includes(askHighlight)
1201
+ ? current.filter((position) => position !== askHighlight)
1202
+ : [...current, askHighlight]);
1203
+ }
1204
+ else {
1205
+ const option = currentQuestion.options[askHighlight];
1206
+ if (option !== undefined) {
1207
+ runtime.answerQuestion(option.label);
1208
+ advanceAsk();
1209
+ }
1210
+ }
1211
+ }
1212
+ else if (!key.ctrl && !key.meta && !key.tab) {
1213
+ const printable = input.replace(/[\r\n]+/g, '');
1214
+ if (printable !== '')
1215
+ setAskText((current) => current + printable);
1216
+ }
1217
+ return;
1218
+ }
1219
+ if (planFeedback) {
1220
+ // 反馈文本由 Composer 承接(Enter 走 handleSubmit),这里只管 Esc 收摊。
1221
+ if (key.escape)
1222
+ setPlanFeedback(false);
1223
+ return;
1224
+ }
1225
+ if (plan !== null) {
1226
+ if (input === 'y' || input === 'Y')
1227
+ runtime.answerPlan('approved');
1228
+ else if (input === 'n' || input === 'N' || key.escape)
1229
+ runtime.answerPlan('rejected');
1230
+ else if (input === 'e' || input === 'E')
1231
+ setPlanFeedback(true);
1232
+ else if (input === 'v' || input === 'V')
1233
+ setPlanExpanded((current) => !current);
1234
+ return;
1235
+ }
1236
+ // 图片预览浮层:Esc / 点击关闭,←→ 在同一批图里切换。
1237
+ if (preview !== null) {
1238
+ if (key.escape)
1239
+ setPreview(null);
1240
+ else if (key.leftArrow)
1241
+ setPreview((current) => current === null ? current : { ...current, index: Math.max(0, current.index - 1) });
1242
+ else if (key.rightArrow)
1243
+ setPreview((current) => current === null
1244
+ ? current
1245
+ : { ...current, index: Math.min(current.sources.length - 1, current.index + 1) });
1246
+ return;
1247
+ }
1248
+ // 子代理浮层:名单(Enter/点击看转录)与转录(回看浮层同款滚动)两种形态。
1249
+ if (agentView !== null) {
1250
+ if (agentView.mode === 'list') {
1251
+ if (key.escape)
1252
+ setAgentView(null);
1253
+ else if (key.return) {
1254
+ const row = agentRows[agentIndex];
1255
+ if (row !== undefined)
1256
+ openAgentTranscript(row.file, row.title);
1257
+ }
1258
+ else if (key.upArrow)
1259
+ setAgentIndex((current) => Math.max(0, current - 1));
1260
+ else if (key.downArrow)
1261
+ setAgentIndex((current) => Math.min(agentRows.length - 1, current + 1));
1262
+ return;
1263
+ }
1264
+ if (key.escape || input === 'q' || (key.ctrl && input === 'o'))
1265
+ setAgentView(null);
1266
+ else if (key.upArrow || input === 'k')
1267
+ peekRef.current?.scrollLines(1);
1268
+ else if (key.downArrow || input === 'j')
1269
+ peekRef.current?.scrollLines(-1);
1270
+ else if (key.pageUp)
1271
+ peekRef.current?.scrollLines(peekRef.current.page());
1272
+ else if (key.pageDown)
1273
+ peekRef.current?.scrollLines(-peekRef.current.page());
1274
+ else if (input === '[')
1275
+ peekRef.current?.jumpTurn('up');
1276
+ else if (input === ']')
1277
+ peekRef.current?.jumpTurn('down');
1278
+ return;
1279
+ }
1280
+ if (transcriptOpen) {
1281
+ if (key.escape || input === 'q' || (key.ctrl && input === 'o'))
1282
+ setTranscriptOpen(false);
1283
+ else if (key.upArrow || input === 'k')
1284
+ overlayRef.current?.scrollLines(1);
1285
+ else if (key.downArrow || input === 'j')
1286
+ overlayRef.current?.scrollLines(-1);
1287
+ else if (key.pageUp)
1288
+ overlayRef.current?.scrollLines(overlayRef.current.page());
1289
+ else if (key.pageDown)
1290
+ overlayRef.current?.scrollLines(-overlayRef.current.page());
1291
+ else if (input === '[')
1292
+ overlayRef.current?.jumpTurn('up');
1293
+ else if (input === ']')
1294
+ overlayRef.current?.jumpTurn('down');
1295
+ return;
1296
+ }
1297
+ if (picker) {
1298
+ const selected = pickerList[pickerIndex];
1299
+ // 改名态:输入行归改名缓冲
1300
+ if (pickerBuffer !== null) {
1301
+ if (key.escape)
1302
+ setPickerBuffer(null);
1303
+ else if (key.return) {
1304
+ if (selected !== undefined && pickerBuffer.trim() !== '') {
1305
+ const title = pickerBuffer.trim();
1306
+ pickerAction(() => runtime.renameSession(selected.id, title));
1307
+ }
1308
+ setPickerBuffer(null);
1309
+ }
1310
+ else if (key.backspace || key.delete)
1311
+ setPickerBuffer((current) => (current ?? '').slice(0, -1));
1312
+ else if (!key.ctrl && !key.meta) {
1313
+ const printable = input.replace(/[\r\n]+/g, '');
1314
+ if (printable !== '')
1315
+ setPickerBuffer((current) => (current ?? '') + printable);
1316
+ }
1317
+ return;
1318
+ }
1319
+ if (key.escape) {
1320
+ if (pickerArmed)
1321
+ setPickerArmed(false);
1322
+ else if (pickerWorkspace !== null) {
1323
+ // 会话层 Esc 先回工作区层(dsh 子页惯例);单工作区直落时没有上层,直接关。
1324
+ setPickerWorkspace(null);
1325
+ setPickerIndex(0);
1326
+ }
1327
+ else
1328
+ setPicker(false);
1329
+ return;
1330
+ }
1331
+ if (key.tab) {
1332
+ togglePickerPage();
1333
+ return;
1334
+ }
1335
+ if (key.return) {
1336
+ if (isWorkspaceLevel)
1337
+ enterWorkspace(pickerIndex);
1338
+ else
1339
+ openSelectedSession();
1340
+ return;
1341
+ }
1342
+ if (key.upArrow) {
1343
+ setPickerIndex((current) => Math.max(0, current - 1));
1344
+ return;
1345
+ }
1346
+ if (key.downArrow) {
1347
+ setPickerIndex((current) => Math.min(pickerRowCount - 1, current + 1));
1348
+ return;
1349
+ }
1350
+ if (key.ctrl) {
1351
+ // 动作键全走 Ctrl 组合——普通字符留给筛选输入;工作区层没有会话动作。
1352
+ if (isWorkspaceLevel)
1353
+ return;
1354
+ if (input === 'r' && selected !== undefined) {
1355
+ setPickerBuffer(selected.title ?? '');
1356
+ }
1357
+ else if (input === 'p' && selected !== undefined) {
1358
+ const pinned = selected.pinnedAt !== undefined;
1359
+ pickerAction(() => runtime.setSessionPinned(selected.id, !pinned));
1360
+ }
1361
+ else if (input === 'a' && pickerPage === 'active' && selected !== undefined) {
1362
+ pickerAction(() => runtime.archiveSessions([selected.id]));
1363
+ }
1364
+ else if (input === 'u' && pickerPage === 'archived' && selected !== undefined) {
1365
+ pickerAction(() => runtime.restoreSessions([selected.id]));
1366
+ }
1367
+ else if (input === 'x' && selected !== undefined) {
1368
+ if (pickerArmed) {
1369
+ setPickerArmed(false);
1370
+ pickerAction(() => runtime.purgeSessions([selected.id]));
1371
+ }
1372
+ else {
1373
+ setPickerArmed(true);
1374
+ }
1375
+ }
1376
+ else if (input === 'f' && selected !== undefined) {
1377
+ pickerAction(() => runtime
1378
+ .listUserMessages(selected.id)
1379
+ .then((messages) => runtime.forkSession(selected.id, messages.length))
1380
+ .then((result) => {
1381
+ if (result.ok) {
1382
+ setPicker(false);
1383
+ void runtime.openSession(result.path);
1384
+ }
1385
+ return result.ok ? { ok: true } : { ok: false, error: '分叉失败' };
1386
+ }));
1387
+ }
1388
+ return;
1389
+ }
1390
+ // 普通字符:筛选输入
1391
+ if (key.backspace || key.delete) {
1392
+ setPickerQuery((current) => current.slice(0, -1));
1393
+ setPickerIndex(0);
1394
+ return;
1395
+ }
1396
+ if (!key.meta) {
1397
+ const printable = input.replace(/[\r\n\t]+/g, '');
1398
+ if (printable !== '') {
1399
+ setPickerQuery((current) => current + printable);
1400
+ setPickerIndex(0);
1401
+ setPickerArmed(false);
1402
+ }
1403
+ }
1404
+ return;
1405
+ }
1406
+ if (modelPicker) {
1407
+ if (key.escape)
1408
+ setModelPicker(false);
1409
+ else if (key.return) {
1410
+ applyModel();
1411
+ }
1412
+ else if (key.upArrow)
1413
+ setModelIndex((current) => Math.max(0, current - 1));
1414
+ else if (key.downArrow)
1415
+ setModelIndex((current) => Math.min(modelList.length - 1, current + 1));
1416
+ else if (key.backspace || key.delete) {
1417
+ setModelQuery((current) => current.slice(0, -1));
1418
+ setModelIndex(0);
1419
+ }
1420
+ else if (!key.ctrl && !key.meta) {
1421
+ const printable = input.replace(/[\r\n\t]+/g, '');
1422
+ if (printable !== '') {
1423
+ setModelQuery((current) => current + printable);
1424
+ setModelIndex(0);
1425
+ }
1426
+ }
1427
+ return;
1428
+ }
1429
+ // 模式浮层:与模型浮层同款(输入即筛选、Enter 切换、Esc 关)。
1430
+ if (presetPicker) {
1431
+ if (key.escape)
1432
+ setPresetPicker(false);
1433
+ else if (key.return)
1434
+ applyPreset();
1435
+ else if (key.upArrow)
1436
+ setPresetIndex((current) => Math.max(0, current - 1));
1437
+ else if (key.downArrow)
1438
+ setPresetIndex((current) => Math.min(presetList.length - 1, current + 1));
1439
+ else if (key.backspace || key.delete) {
1440
+ setPresetQuery((current) => current.slice(0, -1));
1441
+ setPresetIndex(0);
1442
+ }
1443
+ else if (!key.ctrl && !key.meta) {
1444
+ const printable = input.replace(/[\r\n\t]+/g, '');
1445
+ if (printable !== '') {
1446
+ setPresetQuery((current) => current + printable);
1447
+ setPresetIndex(0);
1448
+ }
1449
+ }
1450
+ return;
1451
+ }
1452
+ // 技能浮层:同款;Enter 对不可回填的技能只提示不关页。
1453
+ if (skillsPicker) {
1454
+ if (key.escape)
1455
+ setSkillsPicker(false);
1456
+ else if (key.return)
1457
+ applySkill();
1458
+ else if (key.upArrow)
1459
+ setSkillsIndex((current) => Math.max(0, current - 1));
1460
+ else if (key.downArrow)
1461
+ setSkillsIndex((current) => Math.min(skillsList.length - 1, current + 1));
1462
+ else if (key.backspace || key.delete) {
1463
+ setSkillsQuery((current) => current.slice(0, -1));
1464
+ setSkillsIndex(0);
1465
+ }
1466
+ else if (!key.ctrl && !key.meta) {
1467
+ const printable = input.replace(/[\r\n\t]+/g, '');
1468
+ if (printable !== '') {
1469
+ setSkillsQuery((current) => current + printable);
1470
+ setSkillsIndex(0);
1471
+ }
1472
+ }
1473
+ return;
1474
+ }
1475
+ // 设置页:编辑态独占键盘(对齐 dsh,草稿之外的一切都不响应);其余 ↑↓ 焦点、
1476
+ // ←→ 循环 select、Enter 主动作(切换/编辑/执行/复制/跳转)、Esc 关页。
1477
+ if (settingsOpen) {
1478
+ const at = Math.min(settingsIndex, Math.max(0, settingsFocusables.length - 1));
1479
+ const focusRow = settingsFocusables[at] ?? 0;
1480
+ if (settingsEdit !== null) {
1481
+ if (key.escape) {
1482
+ setSettingsEdit(null);
1483
+ }
1484
+ else if (key.return) {
1485
+ commitSettingsEdit();
1486
+ }
1487
+ else if (key.backspace || key.delete) {
1488
+ setSettingsEdit({ ...settingsEdit, draft: settingsEdit.draft.slice(0, -1) });
1489
+ }
1490
+ else if (!key.ctrl && !key.meta) {
1491
+ const printable = input.replace(/[\r\n\t]+/g, '');
1492
+ if (printable !== '') {
1493
+ setSettingsEdit({ ...settingsEdit, draft: settingsEdit.draft + printable });
1494
+ }
1495
+ }
1496
+ return;
1497
+ }
1498
+ if (key.escape) {
1499
+ // 逐级退栈(dsh 同款:子页里 Esc 是「返回上级」):组子页 → 分区页 → 根页 → 关页
1500
+ if (settingsGroup !== null) {
1501
+ setSettingsGroup(null);
1502
+ setSettingsIndex(0);
1503
+ }
1504
+ else if (settingsSection !== null) {
1505
+ setSettingsSection(null);
1506
+ setSettingsIndex(0);
1507
+ }
1508
+ else {
1509
+ setSettingsOpen(false);
1510
+ }
1511
+ return;
1512
+ }
1513
+ if (key.upArrow) {
1514
+ setSettingsIndex(Math.max(0, at - 1));
1515
+ return;
1516
+ }
1517
+ if (key.downArrow) {
1518
+ setSettingsIndex(Math.min(settingsFocusables.length - 1, at + 1));
1519
+ return;
1520
+ }
1521
+ if (key.return || key.rightArrow)
1522
+ activateSettingsRow(settingsRows[focusRow], 1);
1523
+ else if (key.leftArrow)
1524
+ activateSettingsRow(settingsRows[focusRow], -1);
1525
+ return;
1526
+ }
1527
+ // 回到底部 pill 可见且输入为空时:Enter/End 跳回最新(codex/dsh 同语义;
1528
+ // 输入非空时 End 仍归 Composer 的光标移动)。
1529
+ if (chatAwayFrom !== null && !modal && !panelOpen && draftRef.current === '') {
1530
+ if (key.end || key.return) {
1531
+ chatRef.current?.toTail();
1532
+ return;
1533
+ }
1534
+ }
1535
+ // Esc(对齐 codex):回合跑着 = 打断;空闲且输入框为空 = prime 撤回——双击
1536
+ // Esc 把上一轮撤掉、原话放回输入框(dsh 同款 3 秒窗口)。补全面板开着时
1537
+ // Esc 只关面板。
1538
+ if (key.escape && !panelOpen) {
1539
+ if (snapshot.status.turnState !== 'idle') {
1540
+ runtime.interrupt();
1541
+ return;
1542
+ }
1543
+ if (draftRef.current === '') {
1544
+ const now = Date.now();
1545
+ if (now - lastEsc.current < REWIND_WINDOW_MS) {
1546
+ lastEsc.current = 0;
1547
+ rewindLastTurn();
1548
+ }
1549
+ else {
1550
+ lastEsc.current = now;
1551
+ setNotice('再按一次 Esc:撤回上一轮对话');
1552
+ }
1553
+ }
1554
+ return;
1555
+ }
1556
+ // 聊天回看(对齐 codex 的 PgUp/PgDn;滚轮同义,↑↓ 留给输入框历史)。
1557
+ if (key.pageUp) {
1558
+ chatRef.current?.scrollLines(chatRef.current.page());
1559
+ return;
1560
+ }
1561
+ if (key.pageDown) {
1562
+ chatRef.current?.scrollLines(-chatRef.current.page());
1563
+ return;
1564
+ }
1565
+ if (key.ctrl && input === 't') {
1566
+ setExpandThinking((current) => !current);
1567
+ return;
1568
+ }
1569
+ if (key.ctrl && input === 'o') {
1570
+ setTranscriptOpen(true);
1571
+ return;
1572
+ }
1573
+ });
1574
+ const handleSubmit = (text) => {
1575
+ setNotice(null);
1576
+ chatRef.current?.toTail();
1577
+ if (planFeedback) {
1578
+ setPlanFeedback(false);
1579
+ if (text !== '')
1580
+ runtime.answerPlan('rejected', text);
1581
+ return;
1582
+ }
1583
+ if (text.startsWith('/')) {
1584
+ runCommand(text, runtime, {
1585
+ openPicker: openSessionPicker,
1586
+ openModels: () => {
1587
+ setModelPicker(true);
1588
+ setModelIndex(0);
1589
+ setModelQuery('');
1590
+ },
1591
+ openPresets: () => {
1592
+ setPresetPicker(true);
1593
+ setPresetIndex(0);
1594
+ setPresetQuery('');
1595
+ },
1596
+ openSkills: () => {
1597
+ setSkillsPicker(true);
1598
+ setSkillsIndex(0);
1599
+ setSkillsQuery('');
1600
+ },
1601
+ toggleThinking: (visible) => {
1602
+ const next = visible ?? !expandThinking;
1603
+ setExpandThinking(next);
1604
+ setNotice(next ? '思考块已展开(Ctrl+T 随时切换)' : '思考块已折叠(Ctrl+T 随时切换)');
1605
+ },
1606
+ openAgents,
1607
+ openSettings,
1608
+ notice: setNotice,
1609
+ });
1610
+ return;
1611
+ }
1612
+ // 图片合流:附件芯片(剪贴板贴图)先读成 data URL,正文里的图片路径交给
1613
+ // extractImages;两类失败一起提示。发完即清空芯片。
1614
+ const fromChips = [];
1615
+ const failedChips = [];
1616
+ for (const att of attachments) {
1617
+ try {
1618
+ fromChips.push(readImageAsDataUrl(att.path));
1619
+ }
1620
+ catch {
1621
+ failedChips.push(att.name);
1622
+ }
1623
+ }
1624
+ setAttachments([]);
1625
+ const attached = extractImages(text);
1626
+ const failed = [...failedChips, ...attached.failed];
1627
+ if (failed.length > 0) {
1628
+ setNotice(`图片读取失败(太大或 IO 错误):${failed.join('、')}`);
1629
+ }
1630
+ const images = [...fromChips, ...attached.images];
1631
+ runtime.submit(attached.text, images.length > 0 ? images : undefined);
1632
+ };
1633
+ const modal = approval !== null ||
1634
+ question !== null ||
1635
+ picker ||
1636
+ transcriptOpen ||
1637
+ modelPicker ||
1638
+ presetPicker ||
1639
+ skillsPicker ||
1640
+ settingsOpen ||
1641
+ preview !== null ||
1642
+ agentView !== null ||
1643
+ (plan !== null && !planFeedback);
1644
+ /** 子代理转录的条数(标题用;切片与滚动都在 TranscriptViewport 里按行算)。 */
1645
+ const agentTotal = agentEntries?.length ?? 0;
1646
+ return (_jsxs(Box, { height: frameRows, width: "100%", flexDirection: "column", overflow: "hidden", paddingX: PAD.page, children: [preview !== null ? (_jsx(PreviewOverlay, { title: preview.title, index: preview.index, total: preview.sources.length, block: previewBlock, loading: previewLoading, error: previewError, registerClick: registerClick, onClose: () => setPreview(null) })) : agentView !== null && agentView.mode === 'list' ? (_jsx(AgentsOverlay, { rows: agentRows, index: agentIndex })) : agentView !== null && agentView.mode === 'transcript' ? (_jsx(TranscriptOverlay, { ref: peekRef, entries: agentEntries ?? [], total: agentTotal, title: agentView.title, columns: columns, viewportLines: overlayViewportLines, hint: PEEK_HINT, registerClick: registerClick, expandedTools: expandedTools, onToggleTool: toggleTool })) : picker ? (_jsx(SessionPicker, { level: isWorkspaceLevel ? 'workspaces' : 'sessions', workspaces: visibleWorkspaces, workspaceTitle: pickerWorkspace === null ? null : workspaceLabel(pickerWorkspace), sessions: visibleSessions, total: isWorkspaceLevel ? workspaceList.length : pickerList.length, start: pickerStart, index: pickerIndex, page: pickerPage, query: pickerQuery, buffer: pickerBuffer, armed: pickerArmed, loading: snapshot.sessionsLoading, sessionStates: snapshot.sessionStates })) : transcriptOpen ? (_jsx(TranscriptOverlay, { ref: overlayRef, entries: snapshot.entries, total: snapshot.entries.length, columns: columns, viewportLines: overlayViewportLines, registerClick: registerClick, expandedTools: expandedTools, onToggleTool: toggleTool })) : modelPicker ? (_jsx(ModelPicker, { models: modelList, index: modelIndex, query: modelQuery })) : presetPicker && presetSurface !== null ? (_jsx(PresetPicker, { presets: presetList, current: presetSurface.current, defaultName: presetSurface.defaultName, index: presetIndex, query: presetQuery })) : skillsPicker ? (_jsx(SkillsPicker, { skills: skillsList, index: skillsIndex, query: skillsQuery })) : settingsOpen ? (_jsx(SettingsOverlay, { sections: settingsSections, rows: settingsRows, values: settingsValues, focusRow: settingsFocusRow, windowStart: settingsWindow, viewport: settingsViewport, editing: settingsEdit, notice: settingsNotice, section: settingsSection, group: settingsGroup })) : (_jsxs(_Fragment, { children: [_jsx(Box, { flexDirection: "column", flexGrow: 1, minHeight: 0, children: _jsx(ChatView, { entries: snapshot.entries, turnState: snapshot.status.turnState, expandThinking: expandThinking, empty: snapshot.entries.length === 0, welcome: snapshot.entries.length < WELCOME_MAX_ENTRIES ? (_jsx(Welcome, { model: snapshot.status.model, effort: snapshot.status.effort ?? '-', cwd: snapshot.status.cwd })) : undefined, maxWidth: Math.max(20, columns - PAD.page * 2), columns: columns,
1647
+ // 刻度栏居中按「帧高 − 状态栏」(只在终端改尺寸时才变):聊天区可用高度会随
1648
+ // 「回到底部」胶囊、草稿行数变化,按它居中会让整块刻度每滚一下上下挪一行
1649
+ railCenterLines: Math.max(1, frameRows - statusbarLines), viewportRef: chatRef, onAtTailChange: handleChatAtTail, expandedTools: expandedTools, onToggleTool: toggleTool, onPreviewImages: handlePreviewImages, onOpenAgent: handleOpenAgent, onPickTurn: (turn) => chatRef.current?.jumpToTurn(turn), registerClick: registerClick }) }), _jsxs(Box, { flexShrink: 0, flexDirection: "column", children: [_jsx(TaskStrips, { goal: snapshot.surfaces.goal, todos: snapshot.surfaces.todos }), approval !== null ? (_jsx(ApprovalCard, { request: approval, expanded: approvalExpanded, onAction: handleApprovalAction, registerClick: registerClick })) : null, approval === null && question !== null ? (_jsx(AskCard, { ask: question, index: askIndex, checked: askChecked, highlight: askHighlight, text: askText, onOptionClick: handleAskOption, registerClick: registerClick })) : null, approval === null && question === null && plan !== null ? (_jsx(PlanReviewCard, { plan: plan, expanded: planExpanded, feedbacking: planFeedback, onAction: handlePlanAction, registerClick: registerClick })) : null, notice !== null ? (_jsx(Box, { borderStyle: "single", borderColor: BORDER.frame, paddingX: PAD.inline, marginTop: GAP.tight, children: _jsx(Text, { ...TEXT.label, color: STATUS_COLOR.waiting, children: notice }) })) : null, tuiNoticeExtras, chatAwayFrom !== null ? (_jsx(TailIndicator, { hidden: Math.max(0, snapshot.entries.length - chatAwayFrom), onJump: () => chatRef.current?.toTail(), registerClick: registerClick })) : null, _jsx(Composer, { disabled: modal, models: models, placeholder: planFeedback ? '反馈原话(Enter 退回计划,Esc 取消)' : undefined, completionsEnabled: !planFeedback, lister: dockLister, onPanelOpenChange: setPanelOpen, onDraftChange: handleDraftChange, preset: composerPreset, attachments: attachments, onRemoveAttachment: removeAttachment, onPreviewAttachment: previewAttachment, onOpenSessions: openSessionPicker, working: snapshot.status.turnState !== 'idle', registerClick: registerClick, onSubmit: handleSubmit })] })] })), _jsx(Box, { flexShrink: 0, children: _jsx(StatusBar, { status: snapshot.status, surfaces: snapshot.surfaces, subagents: snapshot.subagents ?? [], queued: (snapshot.queued ?? []).length + (snapshot.notices ?? []).length, config: statusBarPrefs, onOpenAgent: handleOpenAgent, registerClick: registerClick }) })] }));
1650
+ }