@deepseek-harness-tui/dsh-tui 0.11.1 → 0.11.2

package/lib/types/settings/definitions.js

@@ -0,0 +1,511 @@
+import { SPLASH_FONT_OPTIONS } from '../components/splashFonts.js';
+export const SETTING_DEFINITIONS = {
+    'diffLayout': {
+        label: 'Diff layout',
+        descriptions: { zh: 'diff 布局' },
+        group: 'conversation',
+        hint: 'Edit/Write tool cards: auto picks by terminal width, or force one layout.',
+        hintDescriptions: { zh: 'Edit/Write 工具卡的 diff 呈现：auto 按终端宽度选择，或强制一种布局。' },
+        kind: 'select',
+        options: [
+            { value: 'auto', label: 'Auto (by width)', descriptions: { zh: '自动（按宽度）' } },
+            { value: 'split', label: 'Side-by-side', descriptions: { zh: '双栏对照' } },
+            { value: 'unified', label: 'Unified', descriptions: { zh: '统一式' } },
+        ],
+    },
+    'effortDefault': {
+        label: 'Default reasoning effort',
+        descriptions: { zh: '默认推理强度' },
+        group: 'conversation',
+        hint: 'Reasoning-effort level new sessions start on; the current session applies it to its next request too, when the model offers the tier (an unlisted level falls back to the model default). Auto = follow the cordis.yml `effort` pin, then the persisted /effort choice, then the model default.',
+        hintDescriptions: { zh: '新会话起始的推理强度档位；模型提供该档位时，当前会话的下一请求也会应用（模型不提供的档位会静默回落到模型默认）。自动 = 依次跟随 cordis.yml 的 effort 配置、持久化的 /effort 选择、模型默认档。' },
+        kind: 'select',
+        options: [
+            { value: 'auto', label: 'Auto (model default)', descriptions: { zh: '自动（模型默认）' } },
+            { value: 'off', label: 'Off', descriptions: { zh: '关闭' } },
+            { value: 'low', label: 'Low', descriptions: { zh: '低' } },
+            { value: 'high', label: 'High', descriptions: { zh: '高' } },
+            { value: 'max', label: 'Max', descriptions: { zh: '最高' } },
+        ],
+    },
+    'expandEditor': {
+        label: 'Fullscreen draft editor',
+        descriptions: { zh: '全屏草稿编辑' },
+        group: 'conversation',
+        hint: 'On: the ⛶ affordance in the input row and the expand-editor shortcut (default Ctrl+Shift+E) expand the draft into a whole-screen editor (Enter = newline, Ctrl+Enter = send). Off: both entry points disappear. On by default.',
+        hintDescriptions: { zh: '开启：输入行尾 ⛶ 按钮与全屏编辑快捷键（默认 Ctrl+Shift+E）把草稿展开成整屏编辑器（Enter 换行、Ctrl+Enter 发送）。关闭：两个入口都不显示。默认开启。' },
+        kind: 'boolean',
+    },
+    'foldTerminalCommand': {
+        label: 'Fold terminal command',
+        descriptions: { zh: '折叠终端命令' },
+        group: 'conversation',
+        hint: 'Terminal cards (Bash/PowerShell): collapse a multi-line command header to its first line + count; Ctrl+O or a click expands it.',
+        hintDescriptions: { zh: '终端卡（Bash/PowerShell）：多行命令头部折叠为首行 + 计数；Ctrl+O 或点击卡片展开。' },
+        kind: 'boolean',
+    },
+    'fullscreen': {
+        label: 'Fullscreen mode',
+        descriptions: { zh: '全屏模式' },
+        group: 'appearance',
+        hint: 'On: app takes the whole screen (vim/less style), in-app mouse. Off: native scrollback; full-page screens keep the mouse. Restart to apply.',
+        hintDescriptions: { zh: '开启：接管整个终端（同 vim/less），应用内鼠标；关闭：终端原生滚动选择；整屏页两种模式都有鼠标。重启生效。' },
+        kind: 'boolean',
+    },
+    'imageBacking': {
+        label: 'Photo image background',
+        descriptions: { zh: '图片底色' },
+        group: 'rendering',
+        hint: "What sits behind photos and illustrations in the chat. Transparent paints only the pixels of the image itself — the terminal background or wallpaper shows through at anti-aliased edges and transparent corners; Terminal colour composites onto the terminal background first, which keeps soft edges smooth (Sixel has no partial alpha). Applies immediately.",
+        hintDescriptions: { zh: '聊天里的照片/插图背后垫什么。透明：只画图片自己的像素，抗锯齿边缘和透明圆角处透出终端底色或壁纸；终端底色：先合成到终端背景色上，柔和边缘更平滑（Sixel 没有部分透明）。立即生效。' },
+        kind: 'select',
+        options: [
+            { value: 'transparent', label: 'Transparent', descriptions: { zh: '透明（透出终端背景）' } },
+            { value: 'terminal', label: 'Terminal colour', descriptions: { zh: '合成到终端底色' } },
+        ],
+    },
+    'lang': {
+        label: 'Language',
+        descriptions: { zh: '界面语言' },
+        group: 'appearance',
+        hint: 'UI language for the whole interface — applies immediately and is saved.',
+        hintDescriptions: { zh: '整个界面的显示语言——立即生效并保存。' },
+        kind: 'select',
+        options: [
+            { value: 'zh', label: '中文', descriptions: { zh: '中文' } },
+            { value: 'en', label: 'English', descriptions: { zh: '英文' } },
+        ],
+    },
+    'mathImageBacking': {
+        label: 'Formula image background',
+        descriptions: { zh: '公式图片底色' },
+        group: 'math',
+        hint: 'What sits behind a formula rendered as an image. Transparent paints only the formula and lets the terminal background (a wallpaper included) show through; Terminal colour composites it onto the terminal background first, which is calmer on busy backgrounds and keeps anti-aliased edges smooth (Sixel has no partial alpha). Applies immediately.',
+        hintDescriptions: { zh: '公式渲染成图片时背后垫什么。透明：只画公式本身，终端底色或壁纸直接透出来；终端底色：先合成到终端背景色上，在花哨的背景上更稳，抗锯齿边缘也更平滑（Sixel 没有部分透明）。立即生效。' },
+        kind: 'select',
+        options: [
+            { value: 'transparent', label: 'Transparent', descriptions: { zh: '透明（透出终端背景）' } },
+            { value: 'terminal', label: 'Terminal colour', descriptions: { zh: '合成到终端底色' } },
+        ],
+    },
+    'mathImageScale': {
+        label: 'Formula image size',
+        descriptions: { zh: '公式图片大小' },
+        group: 'math',
+        hint: 'How large a display formula is set when it renders as an image (LaTeX math → Image, both on this page). Text size matches the body text; Large and Extra large set display math bigger, which also hands the terminal more device pixels for its strokes — the only sharpness lever a terminal image has. Inline formulas are unaffected: their single row of cells caps the resolution. Applies immediately.',
+        hintDescriptions: { zh: '块级公式渲染成图片时的大小（配合 LaTeX 公式的「图片」）。与正文同尺寸：和正文一样大；放大 / 更大：显示公式排得更大，终端也因此有更多像素画笔画，观感更锐利——这是终端图片唯一的清晰度杠杆。行内公式不受影响（只能占一行，像素上限被卡死）。立即生效。' },
+        kind: 'select',
+        options: [
+            { value: 'auto', label: 'Text size', descriptions: { zh: '与正文同尺寸' } },
+            { value: 'large', label: 'Large', descriptions: { zh: '放大' } },
+            { value: 'xlarge', label: 'Extra large', descriptions: { zh: '更大' } },
+        ],
+    },
+    'mathRendering': {
+        label: 'LaTeX math',
+        descriptions: { zh: 'LaTeX 公式' },
+        group: 'math',
+        hint: 'How LaTeX math in replies ($…$, \\(…\\), $$…$$, \\[…\\]) renders. Auto: the best available renderer — today Unicode text with symbols, sub/superscripts, stacked fractions and limits, matrices, cases. Image: typeset block formulas and eligible one-row inline formulas as images when the terminal has graphics — Kitty (Kitty, Ghostty, WezTerm, iTerm2…) or Sixel (Windows Terminal 1.22+, xterm, foot, WezTerm); Unicode elsewhere and for formulas that do not fit. Unicode: always Unicode text. Source: keep the TeX as written. Unsupported, still-streaming, or too-wide formulas keep their source. Applies immediately.',
+        hintDescriptions: { zh: '回复中的 LaTeX 公式（$…$、\\(…\\)、$$…$$、\\[…\\]）怎么显示。自动：用当前最好的渲染方式——目前是 Unicode 文本（符号、上下标、竖排的分数与上下限、矩阵、分段函数）。图片：终端支持图形时把块级公式与能压入一行的行内公式排版成图片——Kitty（Kitty、Ghostty、WezTerm、iTerm2 等）或 Sixel（Windows Terminal 1.22+、xterm、foot、WezTerm）；其他终端与放不下的公式用 Unicode。Unicode：固定用 Unicode 文本。源码：保留原始 TeX。不支持、仍在流式输出或比终端宽的公式保留源码。立即生效。' },
+        kind: 'select',
+        options: [
+            { value: 'auto', label: 'Auto', descriptions: { zh: '自动' } },
+            { value: 'image', label: 'Image', descriptions: { zh: '图片' } },
+            { value: 'unicode', label: 'Unicode', descriptions: { zh: 'Unicode' } },
+            { value: 'source', label: 'Source', descriptions: { zh: '源码' } },
+        ],
+    },
+    'mermaidDiagrams': {
+        label: 'Mermaid diagrams',
+        descriptions: { zh: 'Mermaid 图表' },
+        group: 'rendering',
+        hint: 'Render ```mermaid fences in replies as box-drawing diagrams (flowchart, sequence, state, class, ER, pie, mindmap, timeline, gitGraph). Diagrams wider than the terminal, or of an unsupported type, keep the fenced source. Applies immediately. On by default.',
+        hintDescriptions: { zh: '把回复中的 ```mermaid 代码块画成字符图（flowchart、sequence、state、class、ER、pie、mindmap、timeline、gitGraph）。比终端宽或类型不支持的图保留源码。立即生效。默认开启。' },
+        kind: 'boolean',
+    },
+    'minimal': {
+        label: 'Minimal mode',
+        descriptions: { zh: '极简模式' },
+        group: 'appearance',
+        hint: 'Hide the header splash, emoji glyphs, and decorative colors; code highlight and tool colors stay. Trims the status bar to model + cwd.',
+        hintDescriptions: { zh: '隐藏开屏头部、emoji 状态符与装饰性配色；代码高亮与工具配色保留，底栏只留模型与目录。' },
+        kind: 'boolean',
+    },
+    'pageMargin': {
+        label: 'Page margin',
+        descriptions: { zh: '页边距' },
+        group: 'appearance',
+        hint: 'Inset the whole UI from the terminal edges. ←/→ cycles presets (none / slim / normal / roomy); Enter types a custom spec `NxM`: N columns per side, M rows top/bottom (e.g. 3x1, max 8x4; a bare `N` keeps rows at 1). Empty resets to the default `normal`. Applies immediately.',
+        hintDescriptions: { zh: '让整个界面相对终端四边内缩。←/→ 循环预设（none / slim / normal / roomy）；Enter 输入自定义 `NxM`：左右各 N 列、上下各 M 行（如 3x1，上限 8x4；只填 N 则上下保持 1 行）。清空恢复默认 normal。立即生效。' },
+        kind: 'text',
+        options: [
+            { value: 'none', label: 'None', descriptions: { zh: '无' } },
+            { value: 'slim', label: 'Slim', descriptions: { zh: '窄' } },
+            { value: 'normal', label: 'Normal', descriptions: { zh: '常规' } },
+            { value: 'roomy', label: 'Roomy', descriptions: { zh: '宽' } },
+        ],
+    },
+    'promptSessionLabel': {
+        label: 'Session name chip',
+        descriptions: { zh: '会话名标签' },
+        group: 'conversation',
+        hint: 'Show the session name on the prompt top border, right corner. Off by default.',
+        hintDescriptions: { zh: '在输入框顶边框右上角显示会话名。默认关闭。' },
+        kind: 'boolean',
+    },
+    'recapOnOpen': {
+        label: 'Auto recap on open',
+        descriptions: { zh: '打开会话时自动总结' },
+        group: 'conversation',
+        hint: 'On: opening/resuming a session automatically summarizes its recent activity into a dim line at the bottom of the transcript (hover/click to view or apply the suggested title). Off: use /recap manually.',
+        hintDescriptions: { zh: '开启：打开/恢复会话时自动把最近活动总结成一行灰字显示在会话底部（可悬停/点击查看或应用建议标题）；关闭：手动使用 /recap。' },
+        kind: 'boolean',
+    },
+    'scrollGutter': {
+        label: 'Transcript gutter',
+        descriptions: { zh: '转录边栏' },
+        group: 'appearance',
+        hint: 'Right gutter of the fullscreen transcript: per-turn timeline ticks, a proportional scrollbar, or nothing.',
+        hintDescriptions: { zh: '全屏转录区右侧边栏：按轮次的时间线节点、比例滚动条，或留空。' },
+        kind: 'select',
+        options: [
+            { value: 'timeline', label: 'Turn timeline', descriptions: { zh: '轮次时间线' } },
+            { value: 'scrollbar', label: 'Scrollbar', descriptions: { zh: '滚动条' } },
+            { value: 'hidden', label: 'Hidden', descriptions: { zh: '隐藏' } },
+        ],
+    },
+    'smoothStreaming': {
+        label: 'Smooth streaming',
+        descriptions: { zh: '流式平滑输出' },
+        group: 'conversation',
+        hint: 'Reveal live replies, expanded thinking, and tool-call bodies through an even ~30fps flow instead of per-burst jumps; one-shot non-streaming replies paint as a flow too. Replay/history always paints complete. On by default.',
+        hintDescriptions: { zh: '把实时回复、展开的思考与工具卡正文按 ~30fps 匀速揭示，不再随供应商突发一跳一跳；一次性到达的非流式回复也会平滑打出。回放/历史内容始终完整直出。默认开启。' },
+        kind: 'boolean',
+    },
+    'splashFont': {
+        label: 'Splash font',
+        descriptions: { zh: '开屏大字字体' },
+        group: 'splash',
+        hint: 'Big-text face on the header splash. Daily rotates by local date (default); pick a face to pin that one. Applies immediately.',
+        hintDescriptions: { zh: '开屏头部的大字字面。按天轮换（默认）随本地日期换款；选某一款即固定那一款。立即生效。' },
+        kind: 'select',
+        options: SPLASH_FONT_OPTIONS,
+    },
+    'statusBar.activity': {
+        label: 'Show activity summary',
+        descriptions: { zh: '显示活动摘要' },
+        hint: 'Show the idle working-activity summary.',
+        hintDescriptions: { zh: '显示空闲时的工作活动摘要。' },
+        kind: 'boolean',
+        group: 'status-bar',
+    },
+    'statusBar.cache': {
+        label: 'Show cache',
+        descriptions: { zh: '显示缓存' },
+        hint: 'Show prompt-cache hit information.',
+        hintDescriptions: { zh: '显示提示词缓存命中信息。' },
+        kind: 'boolean',
+        group: 'status-bar',
+    },
+    'statusBar.compact': {
+        label: 'Compact status bar',
+        descriptions: { zh: '紧凑状态栏' },
+        hint: 'Prefer the compact status presentation when terminal space allows.',
+        hintDescriptions: { zh: '终端空间允许时优先使用紧凑状态栏布局。' },
+        kind: 'boolean',
+        group: 'status-bar',
+    },
+    'statusBar.contextBar': {
+        label: 'Show context progress bar',
+        descriptions: { zh: '显示上下文进度条' },
+        hint: 'Show the segmented context progress bar on its own footer row.',
+        hintDescriptions: { zh: '在底部单独一行显示分段上下文进度条。' },
+        kind: 'boolean',
+        group: 'status-bar',
+    },
+    'statusBar.contextUsage': {
+        label: 'Show context usage',
+        descriptions: { zh: '显示上下文用量' },
+        hint: 'Show current context-window consumption.',
+        hintDescriptions: { zh: '显示当前上下文窗口占用情况。' },
+        kind: 'boolean',
+        group: 'status-bar',
+    },
+    'statusBar.cost': {
+        label: 'Show session cost estimate',
+        descriptions: { zh: '显示本会话花费估算' },
+        hint: 'Show the estimated session spend (≈¥) next to the token totals. Only appears for official DeepSeek providers whose model has a known price; the estimate follows the official per-million-token rates (peak/idle hours) and is not a bill.',
+        hintDescriptions: { zh: '在 Token 总量旁显示本会话花费估算（≈¥）。仅在使用 DeepSeek 官方 API key 且模型有已知单价时显示；按官方每百万 token 单价（高峰/空闲时段）估算，非账单。' },
+        kind: 'boolean',
+        group: 'status-bar',
+    },
+    'statusBar.cwd': {
+        label: 'Show working directory',
+        descriptions: { zh: '显示工作目录' },
+        hint: 'Show the session working directory.',
+        hintDescriptions: { zh: '显示当前会话的工作目录。' },
+        kind: 'boolean',
+        group: 'status-bar',
+    },
+    'statusBar.gitBranch': {
+        label: 'Show git branch',
+        descriptions: { zh: '显示 Git 分支' },
+        hint: 'Show the current git branch when available.',
+        hintDescriptions: { zh: '可用时显示当前 Git 分支。' },
+        kind: 'boolean',
+        group: 'status-bar',
+    },
+    'statusBar.goal': {
+        label: 'Show goal status',
+        descriptions: { zh: '显示 Goal 状态' },
+        hint: 'Show a compact goal chip (phase glyph + rounds) in the status footer while a goal exists.',
+        hintDescriptions: { zh: '存在 Goal 时，在底部状态栏显示紧凑的 Goal 状态（阶段符号与轮次）。' },
+        kind: 'boolean',
+        group: 'status-bar',
+    },
+    'statusBar.mode': {
+        label: 'Show session mode',
+        descriptions: { zh: '显示会话模式' },
+        hint: 'Show the active non-default session mode.',
+        hintDescriptions: { zh: '显示当前启用的非默认会话模式。' },
+        kind: 'boolean',
+        group: 'status-bar',
+    },
+    'statusBar.model': {
+        label: 'Show model',
+        descriptions: { zh: '显示模型' },
+        hint: 'Show the live model id in the status bar.',
+        hintDescriptions: { zh: '在状态栏显示当前模型标识。' },
+        kind: 'boolean',
+        group: 'status-bar',
+    },
+    'statusBar.sessionId': {
+        label: 'Show session id',
+        descriptions: { zh: '显示会话 ID' },
+        hint: 'Show the short session id (# + first 8 chars) — it matches the session log filename for --resume.',
+        hintDescriptions: { zh: '显示短会话 ID（# + 前 8 位）——与日志文件名对应，方便 --resume 定位。' },
+        kind: 'boolean',
+        group: 'status-bar',
+    },
+    'statusBar.sessionTitle': {
+        label: 'Show session title',
+        descriptions: { zh: '显示会话标题' },
+        hint: 'Show the current session title.',
+        hintDescriptions: { zh: '显示当前会话标题。' },
+        kind: 'boolean',
+        group: 'status-bar',
+    },
+    'statusBar.shortcutHint': {
+        label: 'Show shortcut reminder',
+        descriptions: { zh: '显示快捷键提示' },
+        hint: 'Control only the idle `? for shortcuts` reminder; pressing ? and the Esc shortcut hints are unaffected.',
+        hintDescriptions: { zh: '仅控制空闲时的 `? for shortcuts` 提示；按 ? 打开快捷键以及 Esc 快捷提示均不受影响。' },
+        kind: 'boolean',
+        group: 'status-bar',
+    },
+    'statusBar.thinking': {
+        label: 'Show thinking',
+        descriptions: { zh: '显示思考' },
+        hint: 'Show the live reasoning effort or thinking mode.',
+        hintDescriptions: { zh: '显示当前推理强度或思考模式。' },
+        kind: 'boolean',
+        group: 'status-bar',
+    },
+    'statusBar.tokens': {
+        label: 'Show token totals',
+        descriptions: { zh: '显示 Token 总量' },
+        hint: 'Show running input and output token totals.',
+        hintDescriptions: { zh: '显示累计输入与输出 Token。' },
+        kind: 'boolean',
+        group: 'status-bar',
+    },
+    'statusBar.tps': {
+        label: 'Show output speed',
+        descriptions: { zh: '显示输出速度' },
+        hint: 'Show live and recent tokens-per-second metrics.',
+        hintDescriptions: { zh: '显示实时及近期每秒 Token 指标。' },
+        kind: 'boolean',
+        group: 'status-bar',
+    },
+    'statusBar.trajectory': {
+        label: 'Show trajectory strip',
+        descriptions: { zh: '显示轨迹条' },
+        hint: 'Show the animated mini trajectory strip at the footer edge.',
+        hintDescriptions: { zh: '在状态栏边缘显示动态迷你轨迹条。' },
+        kind: 'boolean',
+        group: 'status-bar',
+    },
+    'terminalImages': {
+        label: 'Terminal image previews',
+        descriptions: { zh: '终端图片预览' },
+        group: 'rendering',
+        hint: 'Preview images in supported terminals. Use /restart to apply. Sending images is unaffected.',
+        hintDescriptions: { zh: '在支持的终端中预览图片。修改后用 /restart 生效；不影响向模型发送图片。' },
+        kind: 'boolean',
+    },
+    'thinkingFold': {
+        label: 'Thinking display',
+        descriptions: { zh: '思考块展示' },
+        group: 'conversation',
+        hint: 'Preview shows 2-3 live lines; Full stays expanded until turn end. Click a streaming block to switch between preview and full.',
+        hintDescriptions: { zh: '预览模式显示 2-3 行动态思考；展开模式保持至轮末。点击流式思考块可在预览与全文间切换。' },
+        kind: 'select',
+        options: [
+            { value: 'preview', label: 'Preview (2-3 lines)', descriptions: { zh: '预览（2-3 行）' } },
+            { value: 'full', label: 'Full until turn end', descriptions: { zh: '展开至轮末' } },
+        ],
+    },
+    'toolBackground': {
+        label: 'Tool background',
+        descriptions: { zh: '工具卡背景' },
+        group: 'appearance',
+        hint: 'Choose whether tool-call cards add no, subtle, or strong background emphasis.',
+        hintDescriptions: { zh: '选择工具调用卡片不添加、轻微或明显的背景强调。' },
+        kind: 'select',
+        options: [
+            { value: 'none', label: 'None', descriptions: { zh: '无' } },
+            { value: 'subtle', label: 'Subtle', descriptions: { zh: '轻微' } },
+            { value: 'strong', label: 'Strong', descriptions: { zh: '明显' } },
+        ],
+    },
+    'whale': {
+        label: 'Header art',
+        descriptions: { zh: '标题图形 logo' },
+        group: 'splash',
+        hint: 'Show the header splash art — the pixel whale, or the maid portrait when the setting below is on. Off leaves a text-only header.',
+        hintDescriptions: { zh: '开屏头部显示图形 logo：像素鲸鱼（打开下方「女仆娘立绘」时显示女仆娘）。关闭则只留文字标题。' },
+        kind: 'boolean',
+    },
+    'whaleGirl': {
+        label: 'Maid portrait',
+        descriptions: { zh: '女仆娘立绘' },
+        group: 'splash',
+        hint: 'Swap the header splash\'s pixel whale for the author-designed maid portrait, rendered FIRST as a real raster through the terminal image protocols (Kitty/Sixel); terminals without graphics support fall back to the character-art maid.',
+        hintDescriptions: { zh: '把开屏头部的像素鲸鱼换成项目作者绘制的女仆娘立绘，最优先走终端图像协议（Kitty/Sixel）的真图渲染；终端不支持时回落到字符画版女仆娘。' },
+        kind: 'boolean',
+    },
+    'whaleIdle': {
+        label: 'Welcome whale idle',
+        descriptions: { zh: '鲸鱼娘闲置动画（欢迎期）' },
+        group: 'splash',
+        hint: 'Welcome-phase idle behaviors: after the intro the whale flutters its fins, thumps its tail, and dozes off when idle; clicking wakes a dozing whale and pops a heart. The first agent turn freezes it to the static standard frame.',
+        hintDescriptions: { zh: '欢迎期闲置行为：开屏后鲸鱼娘摆鱼鳍、偶尔拍尾巴，空闲会睡着冒 Z；点击唤醒睡着的鲸鱼娘并冒爱心。开始第一个任务后定格为静态标准帧。' },
+        kind: 'boolean',
+    },
+};
+/**
+ * Topic groups for /settings, in root-page order. Two presentations share
+ * this list: 'inline' groups render their fields directly on the root page
+ * under a small header (shallow topics — hiding a handful of fields behind
+ * a navigation row costs more clicks than the ordering buys), 'page' groups
+ * render one navigation row and keep their fields a level down (deep,
+ * cohesive domains: the formula trio, the status-bar block, the shortcut
+ * remaps). Every built-in setting names one of these (verified by
+ * scripts/verify-settings-definitions.ts); a field without a group would
+ * render on the root under "general". */
+export const SETTING_GROUPS = [
+    { id: 'appearance', mode: 'inline', title: 'Appearance', descriptions: { zh: '外观与布局' } },
+    { id: 'splash', mode: 'inline', title: 'Splash', descriptions: { zh: '开屏与吉祥物' } },
+    { id: 'conversation', mode: 'inline', title: 'Conversation', descriptions: { zh: '对话与输入' } },
+    { id: 'rendering', mode: 'inline', title: 'Rendering', descriptions: { zh: '图表与图片' } },
+    { id: 'math', mode: 'page', title: 'Formula', descriptions: { zh: '公式设置' } },
+    { id: 'status-bar', mode: 'page', title: 'Status bar', descriptions: { zh: '底栏设置' } },
+    { id: 'shortcuts', mode: 'page', title: 'Shortcuts', descriptions: { zh: '快捷键' } },
+];
+/**
+ * Top-level Config keys the settings service may edit at runtime: every
+ * defined setting's root, plus the shortcut remaps. Keys without a Config
+ * schema field (state read straight from the settings namespace) are
+ * ignored by editableConfig.
+ */
+export const EDITABLE_CONFIG_KEYS = [
+    ...new Set([...Object.keys(SETTING_DEFINITIONS).map(key => key.split('.')[0]), 'shortcuts']),
+];
+/** The static part of a /settings field for `key` (path included). */
+export function settingField(key) {
+    return { path: key.split('.'), ...SETTING_DEFINITIONS[key] };
+}
+/**
+ * Shortcut remap fields (`shortcuts.<action>`): one per SHORTCUT_ACTIONS
+ * entry; the help text names the platform's default combos.
+ */
+export const SHORTCUT_FIELD_META = {
+    paste: {
+        label: 'Paste shortcut',
+        zh: '粘贴快捷键',
+        hintEn: d => `Clipboard paste (text, file paths, images). Default: ${d}. Alt+V works where the terminal eats Ctrl+V.`,
+        hintZh: d => `剪贴板粘贴（文本、文件路径、图片）。默认 ${d}。终端吞掉 Ctrl+V 时可用 Alt+V。`,
+    },
+    history: {
+        label: 'History search shortcut',
+        zh: '历史搜索快捷键',
+        hintEn: d => `Open the prompt-history search. Default: ${d}.`,
+        hintZh: d => `打开输入历史搜索。默认 ${d}。`,
+    },
+    editor: {
+        label: 'External editor shortcut',
+        zh: '外部编辑器快捷键',
+        hintEn: d => `Edit the draft in $VISUAL/$EDITOR. Default: ${d}.`,
+        hintZh: d => `在 $VISUAL/$EDITOR 外部编辑器中编辑草稿。默认 ${d}。`,
+    },
+    transcript: {
+        label: 'Transcript mode shortcut',
+        zh: '转录模式快捷键',
+        hintEn: d => `Toggle expanded transcript mode. Default: ${d}.`,
+        hintZh: d => `切换展开转录模式。默认 ${d}。`,
+    },
+    trajectory: {
+        label: 'Trajectory scene shortcut',
+        zh: '轨迹场景快捷键',
+        hintEn: d => `Open the trajectory scene. Default: ${d}.`,
+        hintZh: d => `打开轨迹场景。默认 ${d}。`,
+    },
+    dashboard: {
+        label: 'Subagent dashboard shortcut',
+        zh: '子代理面板快捷键',
+        hintEn: d => `Open the subagent dashboard. Default: ${d}.`,
+        hintZh: d => `打开子代理面板。默认 ${d}。`,
+    },
+    contextPanel: {
+        label: 'Loaded-context panel shortcut',
+        zh: '加载上下文面板快捷键',
+        hintEn: d => `Toggle the startup loaded-context panel. Default: ${d}.`,
+        hintZh: d => `切换启动时的已加载上下文面板。默认 ${d}。`,
+    },
+    showAll: {
+        label: 'Show-all shortcut',
+        zh: '显示全部消息快捷键',
+        hintEn: d => `Toggle show-all-messages. Default: ${d}.`,
+        hintZh: d => `切换显示全部消息。默认 ${d}。`,
+    },
+    redraw: {
+        label: 'Redraw shortcut',
+        zh: '终端重绘快捷键',
+        hintEn: d => `Clear and repaint the terminal. Default: ${d}.`,
+        hintZh: d => `清空并重绘终端。默认 ${d}。`,
+    },
+    todoFold: {
+        label: 'Todo fold shortcut',
+        zh: '待办折叠快捷键',
+        hintEn: d => `Fold/unfold the goal/todo panel. Default: ${d}.`,
+        hintZh: d => `折叠/展开目标与待办面板。默认 ${d}。`,
+    },
+    questionFold: {
+        label: 'Question panel fold shortcut',
+        zh: '提问面板折叠快捷键',
+        hintEn: d => `Fold/unfold the pending question panel. Default: ${d}.`,
+        hintZh: d => `折叠/展开等待回答的提问面板。默认 ${d}。`,
+    },
+    expandEditor: {
+        label: 'Fullscreen editor shortcut',
+        zh: '全屏草稿编辑快捷键',
+        hintEn: d => `Toggle the fullscreen draft editor (Enter inserts a newline, Ctrl+Enter sends). Default: ${d}.`,
+        hintZh: d => `切换全屏草稿编辑器（Enter 换行、Ctrl+Enter 发送）。默认 ${d}。`,
+    },
+    star: {
+        label: 'One-key star shortcut',
+        zh: '一键 star 快捷键',
+        hintEn: d => `Star the project via the gh CLI (same action as /star and the splash line's click). Default: ${d}.`,
+        hintZh: d => `用 gh 给项目点 star（与 /star、开屏标语点击同一个动作）。默认 ${d}。`,
+    },
+};

package/lib/types/starAction.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 求 star 的"一键"动作：`gh repo star <owner>/<repo>`。
+ *
+ * 为什么是 `gh` 而不是 `git`：star 是 GitHub 的 API 概念，`git` 本身没有这个能力；
+ * 而且终端里的 OSC 8 链接**只能打开 URL**，点不出命令来——所以"一键"必须是 TUI 里
+ * 一个显式动作（`/star` 或弹窗按钮），由用户按下去才执行。
+ *
+ * 三条硬约束：
+ * 1. **绝不自动 star**：没有用户动作就不会调用这里；
+ * 2. **绝不阻塞界面**：全部走 `execFileNoThrow`（永不 reject）+ 每步都有超时；
+ * 3. **失败要说人话**：没装 `gh` / 没登录 / 网络失败分别给不同结论，调用方好回一句
+ *    有意义的提示，并回落到"在浏览器里打开"。
+ */
+/** 要 star 的仓库（`owner/name`）。 */
+export declare const STAR_REPO = "ccch1mneyyy/dsh-TUI";
+/** 一键 star 的结果：`starred` 以外都是"没成，但说清了为什么"。 */
+export type StarOutcome = {
+    readonly kind: 'starred';
+} | {
+    readonly kind: 'no-gh';
+} | {
+    readonly kind: 'not-authed';
+} | {
+    readonly kind: 'failed';
+    readonly detail: string;
+};
+/** 执行器签名（测试注入用；生产就是 `execFileNoThrow`）。 */
+export type StarExec = (file: string, args: readonly string[], options?: {
+    timeout?: number;
+}) => Promise<{
+    code: number | null;
+    stdout: string;
+    stderr: string;
+}>;
+/**
+ * 让本机 `gh` 给仓库点一个 star。
+ * @param options - `exec` 是测试缝；`timeoutMs` 是 star 那一步的超时（探测步骤固定短超时）。
+ * @returns 结果；只有 `starred` 表示真的点上了。
+ */
+export declare function starRepo(options?: {
+    exec?: StarExec;
+    timeoutMs?: number;
+}): Promise<StarOutcome>;
+//# sourceMappingURL=starAction.d.ts.map

package/lib/types/starAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starAction.d.ts","sourceRoot":"","sources":["../../src/starAction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,gCAAgC;AAChC,eAAO,MAAM,SAAS,wBAAwB,CAAA;AAE9C,8CAA8C;AAC9C,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GAC/B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAcxD,2CAA2C;AAC3C,MAAM,MAAM,QAAQ,GAAG,CACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KAC3B,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AASrE;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAWtG"}

package/lib/types/starAction.js

@@ -0,0 +1,52 @@
+/**
+ * 求 star 的"一键"动作：`gh repo star <owner>/<repo>`。
+ *
+ * 为什么是 `gh` 而不是 `git`：star 是 GitHub 的 API 概念，`git` 本身没有这个能力；
+ * 而且终端里的 OSC 8 链接**只能打开 URL**，点不出命令来——所以"一键"必须是 TUI 里
+ * 一个显式动作（`/star` 或弹窗按钮），由用户按下去才执行。
+ *
+ * 三条硬约束：
+ * 1. **绝不自动 star**：没有用户动作就不会调用这里；
+ * 2. **绝不阻塞界面**：全部走 `execFileNoThrow`（永不 reject）+ 每步都有超时；
+ * 3. **失败要说人话**：没装 `gh` / 没登录 / 网络失败分别给不同结论，调用方好回一句
+ *    有意义的提示，并回落到"在浏览器里打开"。
+ */
+import { execFileNoThrow } from './utils/execFileNoThrow.js';
+/** 要 star 的仓库（`owner/name`）。 */
+export const STAR_REPO = 'ccch1mneyyy/dsh-TUI';
+/** 探测 `gh` 是否存在用的命令（只读，不改任何东西）。 */
+const GH_VERSION_ARGS = ['--version'];
+/** 判定登录态：`gh auth status` 退出码非 0 就是没登录。 */
+const GH_AUTH_ARGS = ['auth', 'status'];
+/**
+ * 点 star 的本体：`gh api -X PUT user/starred/<owner>/<repo>`。**不用**
+ * `gh repo star`——那是 gh ≥ 2.63 才有的子命令，老版本直接报
+ * `unknown command "star" for "gh repo"`（本机实测踩坑）；REST PUT 全
+ * 版本 gh 可用，成功即 204（gh api 对 204 打空 body、退出码 0）。
+ */
+const GH_STAR_ARGS = ['api', '-X', 'PUT', `user/starred/${STAR_REPO}`];
+/** 把子进程输出压成一行短句（提示里不塞整段 stderr）。 */
+const summarize = (result) => {
+    if (result.code === null)
+        return '命令超时或被杀掉';
+    const text = (result.stderr.trim() || result.stdout.trim() || `exit ${result.code}`).replace(/\s+/gu, ' ');
+    return text.length > 200 ? `${text.slice(0, 200)}…` : text;
+};
+/**
+ * 让本机 `gh` 给仓库点一个 star。
+ * @param options - `exec` 是测试缝；`timeoutMs` 是 star 那一步的超时（探测步骤固定短超时）。
+ * @returns 结果；只有 `starred` 表示真的点上了。
+ */
+export async function starRepo(options) {
+    const exec = options?.exec ?? execFileNoThrow;
+    const probe = await exec('gh', GH_VERSION_ARGS, { timeout: 3000 });
+    if (probe.code !== 0)
+        return { kind: 'no-gh' };
+    const auth = await exec('gh', GH_AUTH_ARGS, { timeout: 5000 });
+    if (auth.code !== 0)
+        return { kind: 'not-authed' };
+    const star = await exec('gh', GH_STAR_ARGS, { timeout: options?.timeoutMs ?? 15_000 });
+    if (star.code === 0)
+        return { kind: 'starred' };
+    return { kind: 'failed', detail: summarize(star) };
+}

package/lib/types/terminal-utils/latex.d.ts

@@ -0,0 +1,10 @@
+export interface RenderLatexOptions {
+    /** Stack fractions and operator limits vertically for display math (default: false). */
+    display?: boolean;
+}
+/**
+ * Render a basic LaTeX math expression as terminal-friendly Unicode text.
+ * Returns undefined when the expression contains unsupported or malformed syntax.
+ */
+export declare function renderLatex(source: string, options?: RenderLatexOptions): string | undefined;
+//# sourceMappingURL=latex.d.ts.map

package/lib/types/terminal-utils/latex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"latex.d.ts","sourceRoot":"","sources":["../../../src/terminal-utils/latex.ts"],"names":[],"mappings":"AA8+CA,MAAM,WAAW,kBAAkB;IAClC,wFAAwF;IACxF,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,MAAM,GAAG,SAAS,CAkBhG"}