dsh-ssh-tui 0.3.7 → 0.3.9

package/README.en.md

@@ -72,10 +72,18 @@ because the manifest declares `dsh.bundle`.
 Optional: reuse a SuperGrok / grok-bridge token already on the machine:
 
 ```sh
-dsh plugin --profile tui add github:cyjyyd/dsh-llm-xai-oauth
-dsh plugin --profile headless add github:cyjyyd/dsh-llm-xai-oauth
+dsh plugin --profile tui add dsh-llm-xai-oauth
+dsh plugin --profile headless add dsh-llm-xai-oauth
 ```
 
+SuperGrok access tokens last about an hour. The TUI refreshes a due token on open, and `/usage` force-refreshes once after HTTP 401. If dsh is not running overnight, install the companion refresher or the next session starts with 401:
+
+```sh
+npx dsh-llm-xai-oauth daemon --install
+```
+
+See [dsh-llm-xai-oauth](https://github.com/cyjyyd/dsh-llm-xai-oauth).
+
 Smoke the route before opening the TUI. The TUI exits immediately without a TTY:
 
 ```sh
@@ -102,13 +110,17 @@ approvals) and prints `tmux attach`. Locks live under `$DSH_HOME/tui-locks/`;
 a leftover file from a crash is stolen if the pid is dead.
 `DSH_TUI_NO_SESSION_LOCK=1` skips this.
 
+New sessions inherit the directory you launched from. Resuming a session
+`chdir`s into that session's recorded working directory. The footer shows
+`目录:srv` (last path segment); click it to print the full path.
+
 On start the TUI checks npm for a newer `dsh-ssh-tui` and **notifies only**:
 
 ```text
 发现新版本 dsh-ssh-tui 0.3.5（当前 0.3.4）。更新：dsh plugin --profile tui add dsh-ssh-tui
 ```
 
-Set `DSH_TUI_NO_UPDATE_CHECK=1` to skip. `/status` also shows the plugin version.
+Set `DSH_TUI_NO_UPDATE_CHECK=1` to skip. `/status` also shows the plugin version, the link chip, the quota window, and whether the subagent model is in the same family as the parent route.
 
 From git:
 
@@ -214,7 +226,7 @@ The plugin runs on Linux, macOS, and Windows (Node ≥ 22.19):
 
 | Key | Action |
 | --- | --- |
-| `Enter` | send; while running, steer; with empty input, toggle the selected card |
+| `Enter` | send; while running, steer; with empty input, toggle the selected card. Oversized tool bodies open a dedicated inspect view; `Esc` returns |
 | `Tab` | complete the highlighted slash command |
 | `↑` / `↓` | empty input: move among cards; otherwise history. Same as `Ctrl+N` / `Ctrl+P` |
 | `Ctrl+R` | expand or collapse all cards |
@@ -230,11 +242,14 @@ The plugin runs on Linux, macOS, and Windows (Node ≥ 22.19):
 | `1..9` + `Enter` | answer an `ask_user_question` dialog |
 
 Type `/` to see slash-command suggestions — the panel merges the TUI's own
-commands (`/find`, `/model`, `/provider`, `/help`, ...) with every command the harness
+commands (`/find`, `/model`, `/provider`, `/language`, `/help`, ...) with every command the harness
 registers (`/goal`, `/plan`, `/compact`, `/permission`, `/feedback`, ...).
 `/compact` shows a spinning 「压缩上下文」 card and footer until it
 finishes, then the tokens recovered. `Tab` completes, `Enter` runs.
-`/help` lists everything.
+`/help` lists everything. `/language` (alias `/lang`) opens a picker, or
+`/language zh` / `/language en` switches immediately. `DSH_TUI_LANG` wins,
+then `ssh-tui.language` in `$DSH_HOME/settings.yaml`, then `LANG` /
+`LC_MESSAGES`. Unknown and `C` locales stay Chinese.
 
 `/model` lists models for the **current** provider only. On SuperGrok that
 is `grok-4.6` / `grok-4.5` plus reasoning effort (`xhigh` on 4.6). `/provider`
@@ -249,11 +264,14 @@ configured catalog when the endpoint cannot be reached. Picking a model that
 is not stored in the provider profile automatically adds it to
 `llm-pi-ai.providers.<id>.models` so the harness can serve it.
 
-Subagents follow the parent session's provider by default and run on the
-lightweight `deepseek-v4-flash` model. `/submodel [model-id]` picks (or
-directly sets) the subagent model, and `/subeffort` picks the subagent
-reasoning effort or restores the provider default. Both commands are
-remembered under `ssh-tui-subagent` in `$DSH_HOME/settings.yaml`.
+Subagents follow the parent session's provider by default. Switching
+provider/model persists the subagent model automatically (closest name to
+the parent's, `flash`-suffixed ids first — `deepseek-v4-flash`,
+`grok-4.5`); no dialog is shown, and `/submodel` still overrides it.
+`/submodel [model-id]` picks (or directly sets) the subagent model, and
+`/subeffort` picks the subagent reasoning effort or restores the provider
+default. Both commands are remembered under `ssh-tui-subagent` in
+`$DSH_HOME/settings.yaml`.
 `/subagents` lists active subagents, and `/subagents kill <session-id> [more ids...]`
 releases selected continuable children using the harness 0.1.1
 `drainContinuableChildren` capability.
@@ -289,10 +307,12 @@ labelled `(images ok)` in the command list and completion hints.
 - **OpenCode Zen** is metered — the TUI points at `https://opencode.ai/zen`.
 
 OpenCode Go / SuperGrok quota is fetched silently at start and on a
-window-based cadence; the footer shows remaining %. A ⚠ transcript line
-appears only when remaining crosses 50% / 25% / 10% / 5%. `/usage` or
-`/balance` still prints the full snapshot. Cadence: every 10 turns for a
-5-hour cap (every 4 when near), every 50 for weekly (every 10 when near),
+window-based cadence; the footer shows plan name + remaining bar + percent,
+and on a narrow row drops the plan name first so the bar and percent stay.
+DeepSeek official balance stays on `/balance` and never occupies the footer.
+A ⚠ transcript line appears only when remaining crosses 50% / 25% / 10% / 5%.
+`/usage` or `/balance` still prints the full snapshot. Cadence: every 10 turns
+for a 5-hour cap (every 4 when near), every 50 for weekly (every 10 when near),
 every 80 for monthly (every 20 when near).
 
 The startup screen shows the official DeepSeek whale logo (rendered from the
@@ -310,7 +330,9 @@ the raw reasoning as it arrives. Assistant replies render in bold white with
 terminal markdown support: heading levels (H1 enlarged/underlined, H2
 underlined, H3 colored), bold, italic, inline code, fenced code blocks,
 lists, quotes, and links all get ANSI styling while remaining
-width-wrapped for the terminal. Reasoning, tool, subagent, plan, and question cards are
+width-wrapped for the terminal. System-prompt / `<system-reminder>` / `AGENTS.md` injections collapse to a
+`提示词注入:系统预设 AGENTS.MD` card (sources joined when several match).
+Reasoning, tool, subagent, plan, question, and prompt cards are
 each expandable/collapsible independently. Empty input: `↑`/`↓` (same as
 `Ctrl+N`/`Ctrl+P`) move the highlight, `Enter` toggles, `Ctrl+R` toggles all,
 `Esc` drops the selection. Click a card header to toggle it. Subagent cards
@@ -327,18 +349,17 @@ animated spinner plus `运行中 · 工具 N` while working, `✓ 已完成` for
 seconds after completion, and `待命` when idle. A terminal bell rings on
 completion (`DSH_TUI_NO_BELL=1` disables it).
 
-Tool calls render as compact cards instead of raw argument JSON. A colored
-dot leads each card — yellow while running, green on success, red on failure
-(a shell command with a non-zero exit or signal also turns red, with a
-`[退出码 N]` / `[信号 X]` suffix). Shell tools show the command as
-`$ command`, file mutations (`edit` / `write` / `str_replace_editor`) render
-the applied change git-style: a path header, `-` lines on a light-red
-background, `+` lines on a light-green background, and a `└ +N -M · K file(s)`
-footer. File-mutation diffs are shown in full (never collapsed to a `… more`
-line) and their cards start expanded. Other tools show a short argument
-summary and start collapsed to a single line (the command, truncated with
-`…` when long); expand to reveal output or the result body. Expanded generic
-calls convert their JSON arguments and JSON results into readable indented
+Tool calls render as compact cards instead of raw argument JSON. The title
+stays the default foreground; only the status dot and `[ok]` / `[error]` /
+`[running…]` (plus `[退出码 N]` / `[信号 X]`) are yellow / green / red.
+Shell tools show the command as dim-grey `$ command`. File mutations
+(`edit` / `write` / `str_replace_editor`) render the applied change
+git-style: a path header, `-` lines on a dark-red background, `+` lines on
+a dark-green background, and a `└ +N -M · K file(s)` footer. Expanding a
+card whose body fits the workspace shows it in place; if it would overflow,
+a dedicated inspect view opens (`Esc` returns to the session). Other tools
+show a short argument summary and start collapsed. Expanded generic calls
+convert their JSON arguments and JSON results into readable indented
 content — key/value fields, bullet lists, and multiline blocks for
 code/content — instead of raw JSON text.
 

package/README.md

@@ -51,12 +51,14 @@ dsh --profile tui
   `▸ 已思考 · N 行`，可单独展开；思考过程中也能实时展开/收起查看原文；
 - 工作区支持 markdown 渲染：多级标题（H1 放大/下划线、H2 下划线、H3 着色）、
   粗体、斜体、行内代码、代码块、列表、引用与链接；模型最终回复以粗体白色显示；
-- 工具调用卡片化：彩色状态点（运行黄 / 成功绿 / 失败红）、shell 命令友好展示、
-  编辑工具 git 风格 diff（`-` 浅红底 / `+` 浅绿底 / 文件统计，编辑卡片默认展开且
-  diff 内容不截断）、JSON 参数与结果自动转可读内容；
+- 系统提示词 / `system-reminder` / `AGENTS.md` 等注入折叠为「提示词注入:系统预设 AGENTS.MD」卡片，默认收起，Enter 展开看全文；
+- 工具调用卡片化：标题默认色，只把状态点与 `[ok]`/`[error]` 染成黄/绿/红；
+  shell 命令浅灰、路径 cyan；编辑工具 git 风格 diff（`-` 暗红底 / `+` 暗绿底 /
+  文件统计）。正文超出窗口时单独全览（Esc 返回），放得下就在工作区展开；JSON 参数与结果自动转可读内容；
 - 转录区滚动回看（`PgUp`/`PgDn`、鼠标滚轮），点击思考/工具标题行直接展开收起；
 - 输入框下方两行底栏：第一行链路芯片 + 按宽度丢组的会话数字（轮次、入/出 token、速度）；
-  第二行只留一个活动词（运行中 / 工具 N / 子代理 N / 压缩中…），身份收到右侧；
+  第二行只留一个活动词（运行中 / 工具 N / 子代理 N / 压缩中…），身份收到右侧（含 `目录:srv`；点击打印完整工作目录）；
+- 恢复旧会话会切到该会话记录的工作目录；新建会话用启动时的当前目录；
 - 历史会话启动选择器：`dsh --profile tui --resume`（或 `resume`）先选会话再进入；
 - 终端窗口标题栏：运行中旋转图标 + `运行中 · 工具 N`，完成后 `✓ 已完成`，并响
   一声终端铃（`DSH_TUI_NO_BELL=1` 关闭）；
@@ -79,10 +81,18 @@ dsh --profile tui
 可选：本机已有 SuperGrok / grok-bridge token 时再装配套 OAuth：
 
 ```bash
-dsh plugin --profile tui add github:cyjyyd/dsh-llm-xai-oauth
-dsh plugin --profile headless add github:cyjyyd/dsh-llm-xai-oauth
+dsh plugin --profile tui add dsh-llm-xai-oauth
+dsh plugin --profile headless add dsh-llm-xai-oauth
 ```
 
+SuperGrok 的 access token 大约 1 小时过期。TUI 打开时会刷新即将过期的 token，`/usage` 遇到 401 也会再刷一次。机器长时间不开 dsh 时，请另开刷新进程，否则一打开就是 401：
+
+```bash
+npx dsh-llm-xai-oauth daemon --install
+```
+
+说明见 [dsh-llm-xai-oauth](https://github.com/cyjyyd/dsh-llm-xai-oauth)。
+
 先确认链路再开 TUI（无 TTY 时 TUI 会直接退出）：
 
 ```bash
@@ -111,7 +121,7 @@ tmux attach -t dsh
 发现新版本 dsh-ssh-tui 0.3.5（当前 0.3.4）。更新：dsh plugin --profile tui add dsh-ssh-tui
 ```
 
-`DSH_TUI_NO_UPDATE_CHECK=1` 可关掉。`/status` 里也能看到当前插件版本。
+`DSH_TUI_NO_UPDATE_CHECK=1` 可关掉。`/status` 里也能看到当前插件版本、链路芯片、额度窗口，以及子代理模型是否与父路由同族。
 
 仓库内也可：`bash scripts/smoke-headless.sh`（记录出口摘要，不打印 token）。
 
@@ -184,12 +194,12 @@ dsh --profile tui --no-color
 
 | 键 | 作用 |
 | --- | --- |
-| `Enter` | 发送；运行中则插入指示；空输入且已选卡片时展开/收起 |
+| `Enter` | 发送；运行中则插入指示；空输入且已选卡片时展开/收起。工具正文超出窗口则单独全览，`Esc` 返回 |
 | `↑` / `↓` | 空输入：在卡片间移动；有输入：历史。与 `Ctrl+N` / `Ctrl+P` 相同 |
 | `Ctrl+R` | 全部展开或全部收起 |
 | `Ctrl+T` | 折叠输入框（只影响显示） |
 | `Alt+1` / `2` / `3` / `4` | 跳到最新思考 / 计划 / 子代理 / 回复 |
-| `/find [类] 关键字` | 搜索并跳到该条完整消息（反色高亮）。类：`思考` `计划` `子代理` `回复`。`Ctrl+/` 或 `Alt+/` 打开 |
+| `/find [类] 关键字` | 搜索并跳到该条完整消息（反色高亮）。类：`思考` `计划` `子代理` `回复` `提示词`。`Ctrl+/` 或 `Alt+/` 打开 |
 | `Ctrl+G` / `Alt+N` | 下一条搜索结果；`Alt+P` 上一条 |
 | 鼠标左键 | 点击卡片标题展开/收起 |
 | `PgUp` / `PgDn`、滚轮 | 转录回看 |
@@ -200,8 +210,9 @@ dsh --profile tui --no-color
 
 `/mode` 切换官方 preset：标准 (`standard`)、PTC (`ptc`；dsh 0.1.1 上仍是 `code`)、极简 (`minimal`)、创造 (`cordis`)，以及本地安装的其它模式。
 
-斜杠命令：`/help`、`/find`、`/model`、`/provider`、`/submodel`、`/subeffort`、`/mode`、`/resume`、
+斜杠命令：`/help`、`/find`、`/model`、`/provider`、`/language`（`/lang`）、`/submodel`、`/subeffort`、`/mode`、`/resume`、
 `/status`、`/subagents`、`/usage`（`/balance` 同义）、`/setup`、`/clear`，
+界面语言：`/language` 打开选择器，或 `/language zh` / `/language en` 直接切。优先 `DSH_TUI_LANG`，其次 `$DSH_HOME/settings.yaml` 的 `ssh-tui.language`，再跟 `LANG`/`LC_MESSAGES`。未知和 `C` locale 默认中文。
 以及 harness 自带命令（`/goal`、`/plan`、`/compact` 等）。`/compact` 进行中会显示
 「压缩上下文」卡片和底栏转圈，结束时写出回收的 token 数。模型请求失败会显示重试
 进度；会话标题由模型生成后写到窗口标题。harness 命令若声明
@@ -213,9 +224,10 @@ dsh --profile tui --no-color
 每个提供商上次的模型和思考强度会分开记住。`/setup` 只新增或更新当前这条
 API Key 提供商，不会冲掉其它路由。SuperGrok / X Premium 走本机 OAuth，不需要填 Key。
 
-子代理默认跟随父会话的提供方，并尽量选同一家的轻量模型：DeepSeek 用
-`deepseek-v4-flash` / `deepseek-v4-flash-vision-exp`，xAI 用 `grok-4.5`。
-`/model` 或 `/setup` 换提供商（OAuth / API Key 都一样）时会自动同步子代理：
+子代理默认跟随父会话的提供方，并尽量选同一家的轻量模型：按父会话所选模型名
+近似匹配，`flash` 结尾的优先——DeepSeek 用 `deepseek-v4-flash`，xAI 用
+`grok-4.5`。`/model` 或 `/provider` 换提供商（OAuth / API Key 都一样）时会
+**自动落盘**子代理模型（不弹窗；想手动改再用 `/submodel`）：
 
 - `/submodel [model-id]`：打开子代理模型选择器；带参数时直接指定模型；
 - `/subeffort`：选择子代理思考强度，或恢复为“跟随提供商默认”；
@@ -247,7 +259,7 @@ API Key 提供商，不会冲掉其它路由。SuperGrok / X Premium 走本机 O
 - **OpenCode Go**：官方 `/v1/usage`，滚动 5 小时 / 本周 / 本月剩余%；
 - **OpenCode Zen**：按量计费、没有固定额度，提示到 `https://opencode.ai/zen`。
 
-OpenCode Go / SuperGrok 启动和运行中都静默查询，底栏只显示剩余%；跨过 50% / 25% / 10% / 5% 才往工作区打 ⚠。`/usage` 或 `/balance` 仍打印完整结果。查询节奏按最紧窗口：5 小时额度每 10 轮（接近改 4 轮），周额度每 50 轮（接近改 10 轮），月额度每 80 轮（接近改 20 轮）。
+OpenCode Go / SuperGrok 启动和运行中都静默查询，底栏显示套餐名 + 剩余条 + 百分比；窄屏先丢掉套餐名，只留条和百分比。DeepSeek 官方余额只出现在 `/balance`，不进底栏。跨过 50% / 25% / 10% / 5% 才往工作区打 ⚠。`/usage` 或 `/balance` 仍打印完整结果。查询节奏按最紧窗口：5 小时额度每 10 轮（接近改 4 轮），周额度每 50 轮（接近改 10 轮），月额度每 80 轮（接近改 20 轮）。
 
 ## 配置
 
@@ -264,6 +276,8 @@ ssh-tui-subagent:
   model: deepseek-v4-flash
   # provider 可省略：省略时子代理跟随父会话提供方
   # reasoningEffort 可省略：省略时跟随提供商/模型默认
+ssh-tui:
+  language: zh   # 或 en；/language 写入这里。DSH_TUI_LANG 优先
 ```
 
 `/model`、`/mode`、`/submodel` 与 `/subeffort` 的修改会写回这里，
@@ -326,6 +340,7 @@ src/session-list.ts 历史会话扫描与标签（共享给 /resume）
 src/session-lock.ts 同会话防双开
 src/update-check.ts npm 最新版提示（不自动升级）
 src/tui.ts          终端渲染、交互、统计、标题/铃声
+src/i18n/           中英界面字典（/language、DSH_TUI_LANG）
 cordis.patch.yml    dsh bundle patch（挂载 TUI 与 agent-presets）
 scripts/            安装 / 卸载 / 验证脚本
 ```