@crazyhappyone/dsh-tui 0.1.0-alpha.52 → 0.1.0-alpha.54

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 0.1.0-alpha.53 — 2026-10-22
+
+Prerelease for DSH `0.2.1-rc.2`; npm channel: `next`.
+
+### Fixed
+
+- String arrays such as `defaultInput` and `tags` stay on one editable settings row. Enter opens the value editor instead of one child row per element, and JSON or comma-separated input round-trips through the official settings patch. Arrays containing non-strings, including model lists and numeric arrays, remain browsable.
+- Settings details stop measuring a long value once the visible row budget is full. The last visible row keeps the next source chunk and ends with `…`.
+- Rapid settings selection updates coalesce to one notification per turn, and settled transcript rows reuse their projection while the block version and render scope stay unchanged.
+- CI checks out the DSH tag named by `COMPATIBLE_DSH_VERSION`, activates that checkout's declared pnpm version, and runs the TUI tests from the mounted plugin sources.
+
+### Verification and upgrade
+
+- Focused verification passed 250 tests: settings navigation, settings interaction, content wrapping, settings usability and hierarchy layout, stream view, markdown rendering, and block rows. The full TUI suite, launcher tests, typecheck, and OS PTY checks were not rerun for this patch.
+- Update with `npm install --global @crazyhappyone/dsh-tui@next`, then relaunch. Source-linked installations can use `/reload` once the new bundle is available. The official profile and configuration services remain authoritative; no migration is required.
+
+### 中文变更说明
+
+- `defaultInput`、`tags` 等纯字符串数组留在同一行编辑，Enter 打开值编辑器，不再为每个元素生成子行；JSON 和逗号输入都通过官方 settings patch 往返。包含非字符串的数组，包括模型列表和数字数组，仍可逐项浏览。
+- 设置详情在可见行数用完后停止测量超长值，最后一行保留下一段内容并以 `…` 结束。
+- 连续移动设置选中项时，每个事件循环只通知一次；已完成的聊天投影在块版本和渲染范围不变时复用。
+- CI 按 `COMPATIBLE_DSH_VERSION` 检出对应 DSH tag，启用该检出声明的 pnpm 版本，再运行挂载后的 TUI 测试。
+- 验证：上述聚焦测试 250 项通过。本补丁未重跑完整 TUI 套件、launcher 测试、类型检查和 OS PTY。
+- 升级：`npm install --global @crazyhappyone/dsh-tui@next` 后重新启动；源码链接安装可在新 bundle 就绪后 `/reload`。继续使用官方配置服务，无需迁移。
+
+[Full comparison](https://github.com/zhangyang-crazy-one/dsh-tui/compare/v0.1.0-alpha.52...v0.1.0-alpha.53)
+
 ## 0.1.0-alpha.52 — 2026-10-21
 
 Prerelease for DSH `0.2.1-rc.2`; npm channel: `next`.

package/README.md

@@ -15,9 +15,9 @@ English | [中文](README.zh.md)
 
 `@crazyhappyone/dsh-tui` is a terminal interface for DeepSeek Harness (dsh), shipped as a dsh **plugin bundle** plus a `dsh-tui` launcher. The package declares `dsh.bundle`, so dsh installs it into a profile like any other plugin; the launcher only automates that install and boots the profile. This repository owns the plugin sources (`tui/`, `tui-render/`). DSH continues to own agents, sessions, tools, persistence, providers, permissions, and profile assembly.
 
-## Release 0.1.0-alpha.52
+## Release 0.1.0-alpha.53
 
-This prerelease targets DSH `0.2.1-rc.2`. Settings now shows category tabs, a contrasting selected row, long-value details and clear save/cancel controls. Switching categories remembers the last nested location; search preserves selection, and pending settings writes reject duplicate submissions. See the [changelog](CHANGELOG.md#010-alpha52--2026-10-21) for the full changes and verification boundaries.
+This prerelease targets DSH `0.2.1-rc.2`. String arrays such as `defaultInput` now edit in place, settings details truncate long values at the visible row budget, and settled transcript rows reuse their projection while unchanged. See the [changelog](CHANGELOG.md#010-alpha53--2026-10-22) for the verification boundary.
 
 ```sh
 npm install --global @crazyhappyone/dsh-tui@next
@@ -35,7 +35,7 @@ In `/settings`, Tab / Shift+Tab switches categories and restores each category's
 
 ## Table of Contents
 
-- [Release and upgrade](#release-010-alpha52)
+- [Release and upgrade](#release-010-alpha53)
 - [Changelog](CHANGELOG.md)
 - [Terminal capabilities](#terminal-capabilities)
 - [Screenshots](#screenshots)

package/README.zh.md

@@ -15,9 +15,9 @@ kind: "package-group"
 
 `@crazyhappyone/dsh-tui` 是 DeepSeek Harness（dsh）的终端界面，以 dsh **插件 bundle** 加 `dsh-tui` launcher 的形式发布。包声明了 `dsh.bundle`，因此 dsh 会像安装其他插件一样把它装进 profile；launcher 只负责自动完成这一安装并启动 profile。本仓库拥有插件源码（`tui/`、`tui-render/`）。Agent、会话、工具、持久化、provider、权限与 profile 组装仍由 DSH 拥有。
 
-## 0.1.0-alpha.52 版本
+## 0.1.0-alpha.53 版本
 
-本预发布版面向 DSH `0.2.1-rc.2`，设置增加可见分类栏、选中行背景、长值详情和明确的保存/取消提示。切换分类记忆深层位置，搜索确认保留选择，保存期间防止重复提交。完整变更与验证边界见 [changelog](CHANGELOG.md#010-alpha52--2026-10-21)。
+本预发布版面向 DSH `0.2.1-rc.2`。`defaultInput` 等纯字符串数组改为原位编辑，设置详情按可见行数截断长值，未变化的已完成聊天行复用投影。验证边界见 [changelog](CHANGELOG.md#010-alpha53--2026-10-22)。
 
 ```sh
 npm install --global @crazyhappyone/dsh-tui@next
@@ -35,7 +35,7 @@ dsh-tui
 
 ## 目录
 
-- [版本与升级](#010-alpha52-版本)
+- [版本与升级](#010-alpha53-版本)
 - [Changelog](CHANGELOG.md)
 - [终端能力](#终端能力)
 - [截图](#screenshots)

package/dist/index.js

@@ -39570,6 +39570,44 @@ function wrapDisplayLines(text4, maxCols) {
   }
   return out;
 }
+function wrapDisplayLinesLimited(text4, maxCols, limit) {
+  const bounded = Number.isFinite(limit) ? Math.max(0, Math.floor(limit)) : Number.POSITIVE_INFINITY;
+  if (bounded === 0) return { lines: [], truncated: text4 !== "" };
+  if (bounded === Number.POSITIVE_INFINITY) return { lines: wrapDisplayLines(text4, maxCols), truncated: false };
+  if (maxCols <= 0) {
+    const lines2 = text4.split("\n", bounded + 1);
+    const truncated2 = lines2.length > bounded;
+    if (truncated2) lines2.pop();
+    return { lines: lines2, truncated: truncated2 };
+  }
+  const lines = [];
+  let row = "";
+  let columns = 0;
+  const truncated = () => ({
+    lines: [...lines, `${wcwidthSafeSlice(row, Math.max(0, maxCols - 1))}\u2026`],
+    truncated: true
+  });
+  for (const { segment: segment2 } of GRAPHEME.segment(text4)) {
+    if (segment2 === "\n") {
+      if (lines.length + 1 === bounded) return truncated();
+      lines.push(row);
+      row = "";
+      columns = 0;
+      continue;
+    }
+    const width = displayWidth(segment2);
+    if (columns + width > maxCols && row !== "") {
+      if (lines.length + 1 === bounded) return truncated();
+      lines.push(row);
+      row = "";
+      columns = 0;
+    }
+    row += segment2;
+    columns += width;
+  }
+  lines.push(row);
+  return { lines, truncated: false };
+}
 
 // packages/tui/tui-render/src/terminal-capabilities.ts
 var ESC_TIMEOUT_MS = 40;
@@ -56347,6 +56385,14 @@ function transcriptBlockId(row) {
 function transcriptBlockVersion(row, revisions) {
   return revisions.revision(row.kind === "compaction" ? row.divider : row.message);
 }
+function settledProjectionSignature(row, revisions, options) {
+  return [
+    transcriptBlockVersion(row, revisions),
+    options.hasSubsequent ? "gap" : "tail",
+    options.isLatestAssistant ? "latest" : "",
+    row.kind === "compaction" && options.expandedCompactionId === row.divider.compactionId ? "expanded" : ""
+  ].join("\0");
+}
 function activeTurnVersion(turn, revisions) {
   return revisions.revision(turn, [
     turn.assistantText,
@@ -56880,6 +56926,9 @@ function StreamView({
   const viewportRef = (0, import_react37.useRef)(null);
   const layoutCache = (0, import_react37.useRef)(new TranscriptLayoutCache());
   const projectorStates = (0, import_react37.useRef)(/* @__PURE__ */ new Map());
+  const settledProjectionCache = (0, import_react37.useRef)(/* @__PURE__ */ new Map());
+  const settledProjectionScope = (0, import_react37.useRef)("");
+  const settledProjectionPresenters = (0, import_react37.useRef)(void 0);
   const rebuildBlocks = (0, import_react37.useRef)(/* @__PURE__ */ new Map());
   const lineStore = (0, import_react37.useRef)(void 0);
   if (lineStore.current === void 0) {
@@ -57059,6 +57108,24 @@ function StreamView({
   );
   const hasActiveTurn = activeTurn !== void 0;
   const settledEntryRows = (0, import_react37.useMemo)(() => {
+    const projectionScope = [
+      settledBlockRowsScope.scopeKey,
+      settledAssistantBlockRowsScope.scopeKey,
+      reasoningExpanded ? "r1" : "r0",
+      toolCardsExpanded ? "t1" : "t0",
+      mode,
+      locale
+    ].join("\0");
+    if (settledProjectionScope.current !== projectionScope) {
+      settledProjectionCache.current = /* @__PURE__ */ new Map();
+      settledProjectionScope.current = projectionScope;
+    }
+    if (settledProjectionPresenters.current !== presenters) {
+      settledProjectionCache.current = /* @__PURE__ */ new Map();
+      settledProjectionPresenters.current = presenters;
+    }
+    const previousCache = settledProjectionCache.current;
+    const nextCache = /* @__PURE__ */ new Map();
     const definitions = /* @__PURE__ */ new Map();
     const batchPresenters = presenters === void 0 ? void 0 : { get(name2) {
       if (!definitions.has(name2)) definitions.set(name2, presenters.get(name2));
@@ -57071,10 +57138,33 @@ function StreamView({
     const toolSticky = /* @__PURE__ */ new Map();
     const userSticky = /* @__PURE__ */ new Map();
     const projectorCache = projectorStates.current;
-    const project = makeBlockProjector({ toolRows, plainRows, locale }, storeBlocks);
     const latestAssistant = hasActiveTurn ? void 0 : latestAssistantId(history, void 0);
     for (const [index2, row] of transcript.entries()) {
       const id = transcriptBlockId(row);
+      const hasSubsequent = index2 < transcript.length - 1 || hasActiveTurn;
+      const cached2 = previousCache.get(id);
+      const signature = settledProjectionSignature(row, revisions, {
+        hasSubsequent,
+        isLatestAssistant: row.kind === "message" && row.message.id === latestAssistant,
+        expandedCompactionId
+      });
+      if (cached2?.signature === signature) {
+        map2.set(id, cached2.lines);
+        if (cached2.textRanges !== void 0) textRanges.set(id, cached2.textRanges);
+        if (cached2.reasoningSticky !== void 0) reasoningSticky.set(id, cached2.reasoningSticky);
+        if (cached2.toolSticky !== void 0) toolSticky.set(id, [...cached2.toolSticky]);
+        if (cached2.userSticky !== void 0) userSticky.set(id, cached2.userSticky);
+        for (const block of cached2.storeBlocks) storeBlocks.set(block.entry.id, block);
+        nextCache.set(id, cached2);
+        continue;
+      }
+      const rowBlocks = /* @__PURE__ */ new Map();
+      const project = makeBlockProjector({ toolRows, plainRows, locale }, rowBlocks);
+      const collectBlocks = () => {
+        const blocks = [...rowBlocks.values()];
+        for (const block of blocks) storeBlocks.set(block.entry.id, block);
+        return blocks;
+      };
       if (row.kind === "compaction") {
         const meta3 = {
           compactionSummary: row.divider.summary,
@@ -57089,10 +57179,18 @@ function StreamView({
           meta: meta3
         }, settledBlockRowsScope, void 0, false);
         map2.set(id, projection.lines);
+        nextCache.set(id, {
+          signature,
+          lines: projection.lines,
+          textRanges: void 0,
+          storeBlocks: collectBlocks(),
+          reasoningSticky: void 0,
+          toolSticky: void 0,
+          userSticky: void 0
+        });
         continue;
       }
       if (row.message.kind === "user") {
-        const hasSubsequent = index2 < transcript.length - 1 || hasActiveTurn;
         const projection = project(id, {
           id,
           kind: "user",
@@ -57100,7 +57198,17 @@ function StreamView({
           ...hasSubsequent ? { meta: { userMessageGap: true } } : {}
         }, settledBlockRowsScope, void 0, false);
         map2.set(id, projection.lines);
-        userSticky.set(id, { start: 0, end: projection.lines.length, text: row.message.text });
+        const sticky = { start: 0, end: projection.lines.length, text: row.message.text };
+        userSticky.set(id, sticky);
+        nextCache.set(id, {
+          signature,
+          lines: projection.lines,
+          textRanges: void 0,
+          storeBlocks: collectBlocks(),
+          reasoningSticky: void 0,
+          toolSticky: void 0,
+          userSticky: sticky
+        });
         continue;
       }
       const parts = displayedParts(
@@ -57204,9 +57312,20 @@ function StreamView({
           meta: tailMeta
         }, settledBlockRowsScope, void 0, false).lines);
       }
-      map2.set(id, rows2.build());
+      const built = rows2.build();
+      map2.set(id, built);
       if (ranges.length > 0) textRanges.set(id, ranges);
+      nextCache.set(id, {
+        signature,
+        lines: built,
+        textRanges: ranges.length > 0 ? ranges : void 0,
+        storeBlocks: collectBlocks(),
+        reasoningSticky: reasoningSticky.get(id),
+        toolSticky: toolSticky.get(id),
+        userSticky: void 0
+      });
     }
+    settledProjectionCache.current = nextCache;
     return { rows: map2, textRanges, storeBlocks, reasoningSticky, toolSticky, userSticky };
   }, [
     contentWidth,
@@ -58994,7 +59113,8 @@ var SETTINGS_GROUP_LABELS = {
 var import_jsx_runtime15 = __toESM(require_jsx_runtime(), 1);
 function fit(text4, width) {
   const safe = escapeContent(text4).replace(/\n/gu, " \u21B5 ");
-  return displayWidth(safe) <= width ? safe : `${wcwidthSafeSlice(safe, Math.max(0, width - 1))}\u2026`;
+  const prefix = wcwidthSafeSlice(safe, width);
+  return prefix.length === safe.length ? safe : `${wcwidthSafeSlice(prefix, Math.max(0, width - 1))}\u2026`;
 }
 function canToggleSetting(row) {
   return row !== void 0 && row.navigable !== true && row.editable !== false && (row.value === "true" || row.value === "false" || row.namespace === "tui" && ["brandAnimation", "locale", "theme", "colorTier"].includes(row.field));
@@ -59068,14 +59188,16 @@ function SettingsBrowser(props) {
   const detailBudget = compact || active === void 0 ? 0 : Math.min(6, Math.max(0, space - Math.min(3, Math.max(1, rows.length))));
   if (active !== void 0 && detailBudget > 0) {
     const source = filtered ? `${active.namespace} \xB7 ${active.field}` : fieldLabel(active, locale);
-    detail.push(...wrapDisplayLines(escapeContent(`\u5F53\u524D\u9879: ${source}`), width).slice(0, filtered ? 2 : 1));
+    const pushBounded = (text4, limit) => {
+      if (limit <= 0 || detail.length >= detailBudget) return;
+      const room = Math.min(limit, detailBudget - detail.length);
+      const wrapped = wrapDisplayLinesLimited(escapeContent(text4), width, room);
+      detail.push(...wrapped.lines);
+    };
+    pushBounded(`\u5F53\u524D\u9879: ${source}`, filtered ? 2 : 1);
     const value = active.value === "" ? "\u2014" : active.value;
-    detail.push(...wrapDisplayLines(escapeContent(`${active.navigable === true ? "\u5305\u542B" : "\u5F53\u524D\u503C"}: ${value}`), width));
-    if (active.description !== void 0) detail.push(...wrapDisplayLines(escapeContent(active.description), width));
-    if (detail.length > detailBudget) {
-      detail.length = detailBudget;
-      detail[detail.length - 1] = `${wcwidthSafeSlice(detail[detail.length - 1], Math.max(0, width - 1))}\u2026`;
-    }
+    pushBounded(`${active.navigable === true ? "\u5305\u542B" : "\u5F53\u524D\u503C"}: ${value}`, detailBudget);
+    if (active.description !== void 0) pushBounded(active.description, detailBudget);
   }
   const size = Math.min(rows.length, Math.max(0, space - detail.length));
   const start = Math.max(0, Math.min(rows.length - size, selected - Math.floor(size / 2)));
@@ -99586,7 +99708,19 @@ function parseSettingsFieldValue(namespace, field, current, draft, knownProvider
   if (field === "defaultInput" || field.endsWith(".defaultInput")) {
     const trimmed = draft.trim().toLowerCase();
     if (trimmed === "") return ["text", "image"];
-    const tokens = trimmed.split(/[,\s]+/).filter((t2) => t2 !== "");
+    const json2 = trimmed.startsWith("[") ? trimmed : void 0;
+    let parsed;
+    if (json2 !== void 0) {
+      try {
+        parsed = JSON.parse(json2);
+      } catch {
+        throw new TypeError("JSON \u65E0\u6548");
+      }
+      if (!Array.isArray(parsed) || parsed.some((item) => typeof item !== "string")) {
+        throw new TypeError('defaultInput \u9700\u8981\u5B57\u7B26\u4E32\u6570\u7EC4\uFF0C\u4F8B\u5982 ["text", "image"]');
+      }
+    }
+    const tokens = parsed === void 0 ? trimmed.split(/[,\s]+/).filter((t2) => t2 !== "") : parsed;
     const result = [];
     for (const token of tokens) {
       if (token === "text" || token === "\u6587\u672C") {
@@ -99633,6 +99767,10 @@ function childSchema(schema, key) {
   const node2 = record2(schema);
   return record2(node2.dict)[key] ?? record2(node2.properties)[key] ?? node2.inner ?? node2.items;
 }
+function navigableValue(value) {
+  if (Array.isArray(value)) return value.some((item) => typeof item !== "string");
+  return value !== null && typeof value === "object";
+}
 function summary(value) {
   return Array.isArray(value) ? `${String(value.length)} \u9879` : value !== null && typeof value === "object" ? `${String(Object.keys(value).length)} \u4E2A\u5B57\u6BB5` : stringifySettingValue(value);
 }
@@ -99671,7 +99809,7 @@ function settingsTreeFromDescribe(descriptors, credentials) {
       const modelId = record2(value).id;
       const identity = Array.isArray(parentValue) && typeof modelId === "string" && parentValue.filter((entry) => record2(entry).id === modelId).length === 1 ? `id:${modelId}` : key;
       const id = `${parentId}:${JSON.stringify(identity)}`;
-      const nested = value !== null && typeof value === "object";
+      const navigable = navigableValue(value);
       const meta3 = record2(record2(schema).meta);
       const label = Array.isArray(parentValue) ? String(record2(value).id ?? record2(value).name ?? key) : key;
       nodes.push({
@@ -99681,14 +99819,14 @@ function settingsTreeFromDescribe(descriptors, credentials) {
         field,
         sourcePath: path2,
         label,
-        value: path2.length === 2 && path2[0] === "providers" ? `${String(Array.isArray(record2(value).models) ? record2(value).models.length : 0)} \u6A21\u578B \xB7 ${String(record2(value).api ?? "\u9ED8\u8BA4\u534F\u8BAE")}` : nested ? summary(value) : stringifySettingsFieldValue(namespace, field, value),
+        value: path2.length === 2 && path2[0] === "providers" ? `${String(Array.isArray(record2(value).models) ? record2(value).models.length : 0)} \u6A21\u578B \xB7 ${String(record2(value).api ?? "\u9ED8\u8BA4\u534F\u8BAE")}` : navigable ? summary(value) : stringifySettingsFieldValue(namespace, field, value),
         editValue: stringifySettingValue(value),
-        ...nested && secrets.some((secret) => path2.every((key2, index2) => secret[index2] === key2)) ? { editable: false } : {},
-        ...nested ? { navigable: true } : {},
+        ...navigable && secrets.some((secret) => path2.every((key2, index2) => secret[index2] === key2)) ? { editable: false } : {},
+        ...navigable ? { navigable: true } : {},
         ...typeof meta3.description === "string" ? { description: meta3.description } : {},
         ...meta3.required === true ? { required: true } : {}
       });
-      if (nested) {
+      if (navigable) {
         for (const [child, next] of Object.entries(value)) walk(next, [...path2, child], id, childSchema(schema, child));
         if (namespace === "llm-pi-ai" && field === "providers") {
           nodes.push({ id: `${id}:add`, parentId: id, namespace, field, sourcePath: path2, label: "+ \u6DFB\u52A0 Provider", value: "\u76EE\u5F55\u540D / \u8868\u5355", editValue: PROVIDER_FORM_TEMPLATE });
@@ -100599,6 +100737,9 @@ var RuntimeController = class _RuntimeController {
   settingsOpen = false;
   settingsRows = [];
   settingsSelectedIndex = 0;
+  /** Selection changes inside one input burst share one settings notification. */
+  settingsMovePending = false;
+  settingsMoveEmit;
   settingsNavigation = new SettingsNavigation([]);
   settingsSearching = false;
   settingsEditing = false;
@@ -103523,7 +103664,8 @@ ${line5}`.slice(-64e3);
           Math.max(0, this.settingsSelectedIndex + action.delta)
         );
         this.settingsNavigation.selectedIndex = this.settingsSelectedIndex;
-        this.emit();
+        this.settingsPaneSnapshot = void 0;
+        this.scheduleSettingsSelectionEmit();
         return;
       case "settings-edit":
       case "settings-edit-json":
@@ -106857,6 +106999,8 @@ ${row.hint ?? ""}` });
   notifyListeners() {
     this.emitLastRun = Date.now();
     this.emitPending = false;
+    this.settingsMovePending = false;
+    this.settingsMoveEmit = void 0;
     for (const listener of this.listeners) {
       try {
         listener();
@@ -106865,8 +107009,28 @@ ${row.hint ?? ""}` });
       }
     }
   }
+  /**
+   * Publish only the settings selection. A wheel or key burst keeps the latest
+   * index readable immediately and notifies subscribers once per turn.
+   */
+  scheduleSettingsSelectionEmit() {
+    if (this.closed) return;
+    this.settingsMovePending = true;
+    if (this.settingsMoveEmit !== void 0) return;
+    const token = {};
+    this.settingsMoveEmit = token;
+    queueMicrotask(() => {
+      if (this.settingsMoveEmit !== token || this.closed || !this.settingsMovePending) return;
+      this.settingsMoveEmit = void 0;
+      this.settingsMovePending = false;
+      if (this.emitTimer !== void 0) this.emitPending = true;
+      else this.notifyListeners();
+    });
+  }
   emit() {
     if (this.closed) return;
+    this.settingsMovePending = false;
+    this.settingsMoveEmit = void 0;
     this.modelSnapshot = void 0;
     this.sessionPaneSnapshot = void 0;
     this.searchPaneSnapshot = void 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crazyhappyone/dsh-tui",
-  "version": "0.1.0-alpha.52",
+  "version": "0.1.0-alpha.54",
   "description": "DeepSeek Harness terminal interface: a dsh plugin bundle plus its launcher",
   "type": "module",
   "license": "MIT",