@aiwayds/dsh-tui-pi 2.19.0 → 2.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiwayds/dsh-tui-pi",
-  "version": "2.19.0",
+  "version": "2.20.0",
   "description": "A fully-featured pi-style terminal UI for DeepSeek Harness (dsh) — history look-back & fork-at-turn, guided preset switching, live subagent steering, model profiles & themes",
   "repository": {
     "type": "git",
@@ -46,6 +46,7 @@
     "templates",
     "assets",
     "themes",
+    "locales",
     "skills",
     "README.md",
     "LICENSE"

package/skills/dsh-tui-pi-config/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: dsh-tui-pi-config
-description: "dsh TUI 增强套件（@aiwayds/dsh-tui-pi）使用与配置指南。凡涉及 TUI 主题/面板/footer、子代理并发与轮数限制、模型收藏与隐藏、会话保留清理与 /resume 过滤、ask_user_question 超时、preset 记忆，或要配置 dsh-tui 段时先读本指南：settings.yaml 顶层 `dsh-tui:` 段 17 键（theme/panelHeight/maxAgents/maxRounds/maxRoundsGrace/disableSubagent/registeredOnly/footerHints/cacheHitMode/iconSet/rememberPreset/favoriteModels/hiddenModels/retention/resume/askUser）、DSH_TUI_* 环境变量、快速上手向导、keybindings.json 与 /hotkeys。触发词：tui、主题、theme、面板、footer、收藏模型、隐藏模型、保留策略、panelHeight、resume、preset。"
+description: "dsh TUI 增强套件使用与配置指南。凡涉及 TUI 主题/面板/footer、界面语言、子代理并发与轮数限制、模型收藏与隐藏、会话保留与 /resume 过滤、ask_user 超时、preset 记忆，或要配置 dsh-tui 段时先读本指南：settings.yaml 顶层 `dsh-tui:` 段 18 键（language/theme/panelHeight/maxAgents/maxRounds/maxRoundsGrace/disableSubagent/registeredOnly/footerHints/cacheHitMode/iconSet/rememberPreset/favoriteModels/hiddenModels/retention/resume/askUser）、DSH_TUI_* 环境变量、快速上手向导、keybindings.json 与 /hotkeys。触发词：tui、主题、theme、面板、footer、语言、language、收藏模型、隐藏模型、保留策略、panelHeight、resume、preset。"
 ---
 
 # dsh-tui-pi 使用指南（TUI 主题 / 子代理治理 / 会话管理）
@@ -12,10 +12,11 @@ description: "dsh TUI 增强套件（@aiwayds/dsh-tui-pi）使用与配置指南
 ## 配置入口（settings.yaml 顶层 `dsh-tui:` 段）
 
 在 `~/.dsh/settings.yaml` 写顶层 `dsh-tui:` 段（注意段名是 `dsh-tui`，不是 `dsh-tui-pi`）。
-主题 / 面板高度 / footer 提示 / 图标集为 `applies: 'live'`——保存提交即热生效，无需重启。
+语言 / 主题 / 面板高度 / footer 提示 / 图标集为 `applies: 'live'`——保存提交即热生效，无需重启。
 
 | 键 | 类型 | 默认 | 作用 |
 |----|------|------|------|
+| `language` | 任意字符串 | `en` | 界面语言：内置 `locales/` 或 `~/.dsh/locales/` 下语言文件的 id（内置 `en`、`zh-CN`、`ja`、`ko`）；`/language` 经原生 ask-user 面板弹出选择（TUI 或飞书端都能答，先答先得），`/settings` 的 language 行是就地选择器，未知 id 回退 `en` |
 | `theme` | 任意字符串 | `auto` | 配色方案；`auto` 跟随终端明暗，也可填任意已注册主题名（内置 20 个 + `~/.dsh/themes/` 用户主题；`/theme` 写回同一段） |
 | `panelHeight` | `'1'\|'5'\|'7'\|'10'\|'all'` | `'1'` | think/tool 固定面板高度；`all` = 完整内容（推理 200 行尾随、工具结果 2000 行封顶） |
 | `maxAgents` | 非负整数 | `4` | 并发子代理上限，`0` = 不限 |
@@ -67,6 +68,12 @@ retention/resume/askUser 组的优先级：**settings.yaml 显式值 > env > 默
 用户要细调时再指向上面的全表：footerHints 分段、cacheHitMode、iconSet、
 favoriteModels/hiddenModels、retention/resume/askUser。
 
+### 界面语言（/language）
+
+每种语言一个扁平 JSON：`locales/<id>.json`（内置 `en` 规范模板 + `zh-CN` 中文）。`/language` 通过原生 ask-user 面板提问（与模型提问同一套面板：当前语言排第一并标注，面板超时自动选第一项 = 保持原语言；TUI 与飞书等任一面都可作答，先答先得），`/settings` 浏览器的 `dsh-tui.language` 行是就地选择器；`/language <id>` 仍可直接切换。切换写回 `dsh-tui.language` 并即时生效（下一帧刷新；对话 backlog 重建前保持原语言；/settings 描述文案重启生效）。
+新增语言或局部覆盖：把 `<id>.json` 放进 `~/.dsh/locales/`——同名 id 按键合并到内置文件之上（user 覆盖 wins），新 id 直接注册；
+文件契约：必有非空 `name`（该语言的显示名），其余每键一个非空字符串，`{param}` 占位符须与 en 同名键一致（测试守卫）。韩（`ko`）/日（`ja`）已内置。
+
 ### 自定义主题目录
 
 除了内置的 20 个主题（`themes/`），用户可在 `~/.dsh/themes/`（`$DSH_HOME` 被设置时用