@crazyhappyone/dsh-tui 0.1.0-alpha.4 → 0.1.0-alpha.6

package/README.md

@@ -44,22 +44,34 @@ After sending `你好`:
 -----
 
 <a id="install-the-launcher"></a>
-## Install the launcher
+## Install the launcher and runtime modes
 
 The unscoped `dsh-tui` package belongs to another maintainer. This project publishes only under the authenticated `crazyhappyone` npm scope.
 
-The launcher requires Git, pnpm, and a DSH-supported Node version. Installing `@deepseek-ai/dsh` separately is neither required nor used: `dsh-tui` always runs the `deepseek-tui` profile from its dedicated source checkout.
+`dsh-tui` supports two runtime modes:
 
-Install the prerelease and complete the first launch:
+### Mode A: Lightweight Mode (Recommended, Zero-Clone)
+Install the official core engine and the TUI launcher globally (dozens of MB):
 
 ```text
+npm install --global @deepseek-ai/dsh
 npm install --global @crazyhappyone/dsh-tui@next
-dsh-tui version
-dsh-tui update
+dsh-tui probe
 dsh-tui
 ```
 
-Package installation creates only the launcher. It does not clone DSH, run `pnpm install`, prompt for Git credentials, or execute a postinstall script. The explicit `dsh-tui update` command creates the source runtime; its default private source requires repository authorization.
+In this mode, the launcher automatically detects the installed `dsh` executable and mounts the bundled prebuilt TUI extension without cloning the 2GB monorepo.
+
+### Mode B: Source Mode (Developer / Debugging)
+To debug or hack on TUI or DSH source directly:
+
+```text
+npm install --global @crazyhappyone/dsh-tui@next
+dsh-tui update
+dsh-tui --source
+```
+
+The explicit `dsh-tui update` command clones the monorepo via Git and runs `pnpm install`. You can use `dsh-tui probe` anytime to inspect the detected engine.
 
 -----
 

package/README.zh.md

@@ -44,22 +44,34 @@ kind: "package-group"
 -----
 
 <a id="install-the-launcher"></a>
-## 安装 launcher
+## 安装 launcher 与运行模式
 
 无 scope 的 `dsh-tui` 包属于另一位 maintainer。本项目只在已认证的 `crazyhappyone` npm scope 下发布。
 
-Launcher 需要 Git、pnpm 与 DSH 支持的 Node 版本。无需单独安装 `@deepseek-ai/dsh`，launcher 也不会使用它：`dsh-tui` 始终从专用源码 checkout 运行 `deepseek-tui` profile。
+`dsh-tui` 支持两种运行模式：
 
-安装 prerelease 并完成首次启动：
+### 模式 A：轻量模式（推荐，零 Clone 秒开）
+只需通过 npm 全局安装官方核心引擎与 TUI launcher（仅数十 MB），即可直接运行：
 
 ```text
+npm install --global @deepseek-ai/dsh
 npm install --global @crazyhappyone/dsh-tui@next
-dsh-tui version
-dsh-tui update
+dsh-tui probe
 dsh-tui
 ```
 
-安装 npm 包只会创建 launcher。它不会 clone DSH、运行 `pnpm install`、请求 Git 凭据或执行 postinstall script。显式执行 `dsh-tui update` 才会创建源码运行时；其默认 private 源码需要仓库授权。
+在此模式下，launcher 会自动探测全局 `dsh`，并挂载预构建的 TUI 扩展，无需克隆 2GB 的 monorepo 仓库。
+
+### 模式 B：源码模式（开发者调试）
+若需对 TUI 或 DSH 底层代码进行修改与调试：
+
+```text
+npm install --global @crazyhappyone/dsh-tui@next
+dsh-tui update
+dsh-tui --source
+```
+
+显式执行 `dsh-tui update` 才会通过 Git 克隆源码并执行 `pnpm install`。可通过 `dsh-tui probe` 查看当前探测到的运行引擎。
 
 -----
 

package/bin/dsh-tui.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /** Command-line entry for the dsh-tui source-runtime launcher. */
 
-import { lstatSync, mkdirSync, readFileSync } from 'node:fs'
+import { lstatSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
 import { constants, homedir } from 'node:os'
 import { fileURLToPath } from 'node:url'
 import { spawnSync } from 'node:child_process'
@@ -50,17 +50,21 @@ function signalOutcome(signal) {
 
 const manifest = JSON.parse(readFileSync(fileURLToPath(new URL('../package.json', import.meta.url)), 'utf8'))
 
+const packageRoot = fileURLToPath(new URL('..', import.meta.url))
+
 try {
   const invocation = parseLauncherInvocation(process.argv.slice(2))
-  const settings = resolveLauncherSettings({ env: process.env, homeDirectory: homedir() })
+  const settings = resolveLauncherSettings({ env: process.env, homeDirectory: homedir(), packageRoot })
   process.exitCode = runLauncher({
     invocation,
     settings,
     packageVersion: manifest.version,
+    env: process.env,
     adapters: {
       inspectPath,
       makeDirectory: path => mkdirSync(path, { recursive: true, mode: 0o700 }),
       readText: path => readFileSync(path, 'utf8'),
+      writeText: (path, content) => writeFileSync(path, content, 'utf8'),
       run,
       writeOut: text => process.stdout.write(text),
       writeError: text => process.stderr.write(text),

package/cordis.patch.yml

@@ -0,0 +1,73 @@
+# The deepseek-tui bundle patch: terminal-surface mode directly over dsh-base.
+# It mounts no Host, HTTP server, Web runtime, or browser plugin. An ordinary
+# provider plugin parses --resume/--cwd and the task positional, then the
+# terminal driver creates an Agent through the core registry and prints its
+# durable result. Unlike the web surface, the agent plane stays process-wide:
+# dsh-base keeps tool-bash/tool-fs/tool-todo and friends because the TUI is
+# single-session and composes its agent process-wide.
+
+- id: system-prompt
+  config:
+    persona: >-
+      You are a coding agent powered by the {{model}} model. Your working directory is {{cwd}}.
+      You are interacting with the user through the deepseek-tui terminal interface.
+
+# The shared module-reload HMR row stays off; the launcher's watch-only
+# fallback still keeps the user patch layers live until the run exits.
+- id: hmr
+  disabled: true
+
+- id: tools
+  config:
+    # Keep the same temporary process-wide Code Mode opt-in as the Web surface.
+    mode: !!js process.env.DSH_TOOLS_MODE
+
+- id: approval
+  config:
+    policy: !!js "(process.env.DSH_PERMISSION_MODE ?? 'workspace-write') === 'danger-full-access' ? 'never' : 'ask'"
+
+# Full-text session search stays disabled until the first Ctrl+K search (the
+# base row's `openAt: never`). The TUI has no browser-latency concern, so the
+# node:sqlite import and in-memory handle open lazily on first search.
+- id: session-query-sqlite
+  config:
+    path: ':memory:'
+    openAt: first-search
+
+- insert:
+    - id: tui-startup
+      name: "./dist/startup.js"
+
+    # Reads its task from the ordinary tuiStartup provider.
+    - id: tui-runtime
+      name: "./dist/index.js"
+      inject: [tuiStartup]
+      config:
+        task: !!js ctx.tuiStartup.task
+        resume: !!js ctx.tuiStartup.resume
+        cwd: !!js ctx.tuiStartup.cwd
+        frameStats: !!js ctx.tuiStartup.frameStats
+        # Render policy (overscan + stream pacing + scroll pacing + cache budgets).
+        # Loaded by the runtime Config schema; the values below mirror the
+        # schema defaults so the deployment layer owns the tunables. Override
+        # here to retune without touching the plugin.
+        renderPolicy:
+          transcriptOverscan: 16
+          stream:
+            frameIntervalMs: 16
+            entryDepth: 64
+            exitDepth: 32
+            entryOldestAgeMs: 500
+            exitOldestAgeMs: 250
+            entryDrainBackpressureMs: 100
+            exitDrainBackpressureMs: 50
+            catchUpRowsPerFrame: 16
+          scroll:
+            frameIntervalMs: 16
+            stepPerFrame: 1
+            wheelRows: 3
+            catchUpThreshold: 10
+            maxCatchUpStep: 8
+          cache:
+            maxRows: 4096
+            maxBytes: 4194304