@epoch-agent/tui 3.1.2 → 4.0.0

package/README.md

@@ -4,7 +4,8 @@ Ink 7 + React 19 的终端界面。
 
 - ✅ **做**：组件、布局、键位、Markdown 渲染、斜杠命令
 - ❌ **不做**：**不许 import [core](../core)**（`check:layers` 会红）、不 spawn 子进程、
-  不碰文件系统。折叠逻辑也不在这里，在 [view](../view)（与 [web](../web) 共用同一份）
+  **不碰用户文件**（唯一的写盘是 `EPOCH_DEBUG` 打开的调试日志，`src/debug.ts`
+  往系统临时目录追加 —— 2026-11-03 把上一版那句笼统的「不碰文件系统」改准）。
 - **依赖**：[protocol](../protocol) + [view](../view) + `chalk` / `lowlight` /
   `string-width` 等纯渲染库。`ink` 和 `react` 是 **peer**
 
@@ -254,22 +255,28 @@ Ink 的 `log-update` **只能擦除它上一帧写过的行数**。一旦动态
 
 ## `@` 补全：文件和会话两组
 
-打 `@` 弹补全面板，**分两组**（方案 53 §1.3）：
+打 `@` 弹补全面板，**分两组**（方案 53 §1.3；2026-11-05 起**会话在上**）：
 
 ```
-┌ 文件 ────────────────────────────
-│ packages/core/src/agent/loop.ts
-├ 会话 ────────────────────────────
+┌ 会话 ────────────────────────────
 │ 接上后台任务的输出   12/03 · 42 条 · 本工作区
+├ 文件 ────────────────────────────
+│ packages/core/src/agent/loop.ts
 └──────────────────────────────────
 ```
 
+- **会话组**：`@` 一打就列出来，**不需要先知道 `@:` 这个前缀**（2026-11-05 之前
+  只有 `@:` 才出会话，而那件事只写在文档里）。选中补进去的是 **sessionId**
+  （落成 `@:id`）而不是标题 —— 标题里几乎一定有空白，而提及的抽取规则遇到空白
+  就断 —— 提交时那段会话的 **当前面**（模型当时还看得见的那些）作为一个独立
+  部件发出去
 - **文件组**：子序列模糊匹配（`@c/a/loop` 命中 `packages/core/src/agent/loop.ts`），
   Tab / Enter 补全路径，提交时**文件内容随消息一起发出去**，省掉
-  「模型调 `file_read` → 再等一轮」。文件组排前面，因为它是高频的那个
-- **会话组**：`@:` 只显示这一组。选中补进去的是 **sessionId** 而不是标题
-  （标题里几乎一定有空白，而提及的抽取规则遇到空白就断），提交时那段会话的
-  **当前面**（模型当时还看得见的那些）作为一个独立部件发出去
+  「模型调 `file_read` → 再等一轮」
+- **`@:` 是缩窄**：打了它就只要会话，文件组整个不列。这是「我知道自己要哪段
+  对话」时省掉下半屏的写法，不是另一种语法 —— 落进文本的仍然是 `@:id`
+- 会话组排上面的判据是**影响范围**：引用一段会话改变的是整场对话的前提，
+  一个文件是局部素材。`↑↓` 的高亮下标跨两组连着走（会话最后一条 → 文件第一条）
 
 > ⚠️ **会话组只按 sessionId / cwd / 标题匹配，永远不搜转录文本**（方案 53 §5.2）。
 > 这是**安全边界不是性能考虑**：面板边打边显示，能搜正文的话打 `@:密码` 就会在

package/dist/index.js

@@ -3519,27 +3519,20 @@ function FilePalette({
       t("tui.palette.listing")
     ] }) });
   }
-  const start = visibleWindowStart(matched.length, selectedIndex, MAX_VISIBLE4);
-  const visible = matched.slice(start, start + MAX_VISIBLE4);
+  const fileStart = visibleWindowStart(
+    matched.length,
+    Math.max(0, selectedIndex - sessions.length),
+    MAX_VISIBLE4
+  );
+  const visible = matched.slice(fileStart, fileStart + MAX_VISIBLE4);
   const grouped = matched.length > 0 && sessions.length > 0;
   return /* @__PURE__ */ jsxs20(Box20, { flexDirection: "column", paddingX: 1, children: [
-    grouped && /* @__PURE__ */ jsxs20(Text21, { color: dim9, dimColor: true, children: [
-      "  ",
-      t("tui.palette.files_head")
-    ] }),
-    visible.map((m, i) => {
-      const selected = start + i === selectedIndex;
-      return /* @__PURE__ */ jsxs20(Box20, { flexDirection: "row", children: [
-        /* @__PURE__ */ jsx22(Text21, { color: selected ? accent6 : dim9, children: selected ? "\u276F " : "  " }),
-        /* @__PURE__ */ jsx22(Text21, { color: selected ? accent6 : "#F8F8F2", bold: selected, children: highlight(m.item, m.positions) })
-      ] }, m.item);
-    }),
     grouped && /* @__PURE__ */ jsxs20(Text21, { color: dim9, dimColor: true, children: [
       "  ",
       t("tui.palette.sessions_head")
     ] }),
     sessions.map((m, i) => {
-      const selected = matched.length + i === selectedIndex;
+      const selected = i === selectedIndex;
       return /* @__PURE__ */ jsxs20(Box20, { flexDirection: "row", children: [
         /* @__PURE__ */ jsx22(Text21, { color: selected ? accent6 : dim9, children: selected ? "\u276F " : "  " }),
         /* @__PURE__ */ jsx22(Text21, { color: selected ? accent6 : "#F8F8F2", bold: selected, children: m.item.title }),
@@ -3549,6 +3542,17 @@ function FilePalette({
         ] })
       ] }, m.item.id);
     }),
+    grouped && /* @__PURE__ */ jsxs20(Text21, { color: dim9, dimColor: true, children: [
+      "  ",
+      t("tui.palette.files_head")
+    ] }),
+    visible.map((m, i) => {
+      const selected = sessions.length + fileStart + i === selectedIndex;
+      return /* @__PURE__ */ jsxs20(Box20, { flexDirection: "row", children: [
+        /* @__PURE__ */ jsx22(Text21, { color: selected ? accent6 : dim9, children: selected ? "\u276F " : "  " }),
+        /* @__PURE__ */ jsx22(Text21, { color: selected ? accent6 : "#F8F8F2", bold: selected, children: highlight(m.item, m.positions) })
+      ] }, m.item);
+    }),
     /* @__PURE__ */ jsx22(Box20, { flexDirection: "row", children: /* @__PURE__ */ jsxs20(Text21, { color: dim9, dimColor: true, children: [
       "  ",
       matched.length > MAX_VISIBLE4 ? t("tui.palette.total", { n: matched.length }) : "",
@@ -3681,10 +3685,10 @@ var InputBox = React11.forwardRef(function InputBox2({
       }
       if (action !== "complete" && action !== "submit") return false;
       const index = fileIndexRef.current < total ? fileIndexRef.current : 0;
-      const picked = index < matches.length ? matches[index]?.item : (() => {
-        const candidate = sessions[index - matches.length]?.item;
+      const picked = index < sessions.length ? (() => {
+        const candidate = sessions[index]?.item;
         return candidate ? sessionInsertion(candidate) : void 0;
-      })();
+      })() : matches[index - sessions.length]?.item;
       if (picked === void 0) return false;
       const next = applyMention(curLines[row] ?? "", at, col, picked);
       const lines2 = [...curLines];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epoch-agent/tui",
-  "version": "3.1.2",
+  "version": "4.0.0",
   "private": false,
   "description": "epoch-agent Ink TUI 界面",
   "repository": {
@@ -29,8 +29,8 @@
     "mnemonist": "0",
     "string-width": "8",
     "strip-ansi": "7",
-    "@epoch-agent/protocol": "3.1.2",
-    "@epoch-agent/view": "3.1.2"
+    "@epoch-agent/protocol": "4.0.0",
+    "@epoch-agent/view": "4.0.0"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",