dsh-code 0.4.0 → 0.6.0

package/README.en.md

@@ -0,0 +1,217 @@
+# DSH-Code
+
+English | [中文](README.md)
+
+<p align="center"><img src="docs/pictures/1.png" width="95%" alt="DSH-Code terminal with slash-command completion"></p>
+
+<p align="center"><img alt="Typing SVG" src="https://readme-typing-svg.herokuapp.com?font=JetBrains+Mono&amp;weight=500&amp;size=22&amp;duration=4000&amp;pause=700&amp;color=4176E6&amp;center=true&amp;vCenter=true&amp;width=680&amp;lines=DeepSeek+Harness+Code;DSH+%E5%86%85%E6%A0%B8%E7%9A%84%E7%BB%88%E7%AB%AF%E7%BC%96%E7%A0%81%E7%95%8C%E9%9D%A2"></p>
+<p align="center">
+  <a href="https://github.com/deepseek-ai/deepseek-harness"><img alt="DeepSeek Harness" src="https://img.shields.io/badge/DeepSeek-Harness-4176E6?style=for-the-badge&amp;logo=deepseek&amp;logoColor=white&amp;labelColor=1c1917"></a>
+  <a href="https://github.com/UNLINEARITY/dsh-code/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/UNLINEARITY/dsh-code?label=Stars&amp;style=for-the-badge&amp;logo=github&amp;logoColor=white&amp;color=4176E6&amp;labelColor=1c1917"></a>
+  <a href="https://www.npmjs.com/package/dsh-code"><img alt="npm version" src="https://img.shields.io/npm/v/dsh-code?label=npm&amp;style=for-the-badge&amp;logo=npm&amp;color=cb3837&amp;labelColor=1c1917"></a>
+  <a href="https://github.com/UNLINEARITY/dsh-code/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/github/license/UNLINEARITY/dsh-code?label=License&amp;style=for-the-badge&amp;logo=opensourceinitiative&amp;color=4176E6&amp;labelColor=1c1917"></a>
+</p>
+
+**DSH-Code is a terminal coding interface for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (`dsh`).** It runs as an out-of-tree bundle over the official `@deepseek-ai/dsh-base` and uses the same Agent, Session, tool, command, skill, permission, sandbox, compaction, and plugin services as the Harness Web UI.
+
+DSH-Code does not implement a separate agent loop. It adds a coding-focused TUI to the DSH runtime, drawing on the session handling of [Codex CLI](https://github.com/openai/codex) and the terminal interaction patterns of [Claude Code](https://code.claude.com/docs/en/overview).
+
+---
+
+## 1. Overview
+
+DeepSeek Harness treats models, tools, storage, policies, and interfaces as plugins registered through Cordis. Durable session events record the conversation and runtime state needed for replay.
+
+DSH-Code keeps that structure and adds a terminal workflow for coding tasks.
+
+| Reference | Used in DSH-Code |
+| --- | --- |
+| **DeepSeek Harness** | Plugin composition, scoped services, Agent Presets, durable sessions, tools, skills, policies, sandboxing, and delegation |
+| **Codex CLI** | Session navigation, bounded overlays, history inspection, stable bottom layout, and resize handling |
+| **Claude Code** | Slash-command discovery, thinking folds, approvals, questions, and turn steering |
+
+The interface follows familiar terminal conventions, while runtime behavior continues to come from DSH services and configuration.
+
+## 2. Quick start
+
+Requires Node `^22.19 || >=24`, the preview `dsh` CLI, and `DEEPSEEK_API_KEY`.
+
+```sh
+npm install -g @deepseek-ai/dsh@next dsh-code
+npm install -g pnpm
+dsh plugin --profile cli add dsh-code
+```
+
+Available launch commands:
+
+```sh
+deepseek
+dsh --profile cli
+dsh-code
+```
+
+`dsh --profile cli`, `deepseek`, and `dsh-code` are parallel launch commands. `deepseek` and `dsh-code` are global aliases for `dsh --profile cli`; all following arguments are forwarded, for example `deepseek --resume abc123`.
+
+> DeepSeek Harness is currently a developer preview and may introduce compatibility-breaking changes. DSH-Code tracks that evolving plugin surface.
+
+For installation, native-module, and plugin-loading issues, see the [troubleshooting guide](docs/problems.md).
+
+## 3. Terminal interaction
+
+### Basics
+
+DSH-Code keeps one Ink owner for the lifetime of the process. `/new` and `/resume` replace the active Agent, not the terminal itself. If a switch is requested while the Agent is busy, it waits for the turn to finish; the newest request wins, and a failed target leaves the current session untouched.
+
+Dynamic content is deliberately bounded. Streaming output, thinking, approvals, questions, `/help`, `/model`, `/mode`, `/resume`, `/plugin`, and Ctrl+O all share terminal-aware viewport rules. The composer remains immediately above the status line. After a resize, the screen is redrawn from the stored transcript once the new width settles.
+
+Use `/mode` before the first turn to inspect or select the session's Agent Preset.
+
+<p align="center"><img src="docs/pictures/2.png" width="95%" alt="Per-session Agent Preset picker"></p>
+
+Use `/resume` to search persisted sessions without restarting the TUI.
+
+<p align="center"><img src="docs/pictures/3.png" width="95%" alt="Searchable session resume picker"></p>
+
+### Common commands
+
+```sh
+dsh --profile cli                    # start a fresh standard session
+dsh --profile cli --mode code        # start with an Agent Preset
+dsh --profile cli --continue         # resume the newest session for this directory
+dsh --profile cli --resume abc123    # resume by id or unique prefix
+dsh --profile cli --session my-id    # start a fresh session with an explicit id
+```
+
+Inside the TUI:
+
+| Action | Purpose |
+| --- | --- |
+| `/new [preset]` | Create and enter another session without restarting the terminal |
+| `/resume [id\|prefix]` | Search root sessions or all conversations; filter by cwd, order, and density |
+| `/mode [preset]` | Inspect or select the blank session's Agent composition |
+| `/model` | Switch among models advertised by the live LLM registry |
+| `/plugin [query]` | Inspect loader entries, enabled state, module identity, and fiber phase |
+| `/permission <name>` | Change the permission preset; Shift+Tab cycles presets |
+| `/help` | Browse local commands, Harness commands, skills, and key bindings |
+| `Ctrl+O` | Open the exclusive history detail view; switch entries and scroll all content |
+| `Ctrl+R` | Fold or reveal model reasoning |
+| `@` | Mention workspace files or bounded snapshots of persisted sessions |
+| `Esc` / `Ctrl+C` | Close the topmost surface or interrupt the active turn |
+
+## 4. Features
+
+### 1. Agent and extensions
+
+- Per-session Agent Presets for tools, prompt sections, skills, compaction, plan mode, and delegation
+- Live slash-command and skill discovery from shared Harness registries
+- Read-only Cordis loader diagnostics through `/plugin`
+- Model routing through the live LLM registry, restored per persisted session
+- Plans, goals, todos, permissions, sandbox state, subagents, and runtime steering
+
+### 2. Sessions and context
+
+- `/new`, `/resume`, `--continue`, and explicit session identifiers without remounting Ink
+- Codex-style searchable resume panel with root/all-conversation, cwd, order, and density filters
+- Bare launches defer session creation until your first real input; quitting early leaves nothing behind
+- Global input recall: Up/Down walks past prompts across sessions, and `/history` searches and fills the composer
+- Lazy title snapshots and explicitly loaded, fully scrollable transcripts
+- Read-only subagent conversation inspection and bounded `@` session references
+- Markdown export, persistent titles, context occupancy, cache, token, TTFT, and timing metrics
+
+### 3. Approvals and interaction
+
+- One-shot tool approval bar for sandbox escalation and hook `ask` decisions
+- Structured `ask_user_question` and plan-review menus with multi-select and custom answers
+- Turn steering at the next step boundary plus explicit interruption semantics
+- Independent Agent mode, plan state, permission preset, goal, and sandbox indicators
+
+### 4. Terminal rendering
+
+- Append-only settled transcript with bounded mutable streaming output
+- Folded thinking, terminal Markdown, compact tool summaries, and full structured details
+- Two-row status bar with mode and context on the second row, a blue context-occupancy meter, and all-blue accents
+- Submissions while a turn runs appear immediately as ordinary prompt rows; Delete cancels the newest queued message, and busy states use the web StateDot chase animation
+- Replies align with the input cursor, and the welcome wordmark is brighter
+- Ctrl+O exclusive history inspection with entry navigation and complete vertical scrolling
+- Width-safe CJK/control-character handling, compact-terminal degradation, and debounced resize replay
+- Stable bottom order: content or panel → notice → composer → status
+
+## 5. How DSH-Code integrates with DSH
+
+### 1. Runtime composition
+
+DSH-Code reads the live Harness registries instead of maintaining separate copies. Model adapters, tool providers, skill sources, commands, permission policies, persistence backends, sandboxes, and subagent providers can be added or replaced through DSH composition.
+
+`/plugin` provides a read-only view of the current Cordis loader state.
+
+### 2. Session-scoped Agent Presets
+
+The Host owns shared infrastructure—registries, persistence, session queries, permissions, and sandbox policy—while each session receives an isolated Agent scope composed from an **Agent Preset**:
+
+- `standard` — the full general-purpose coding agent
+- `code` — Code Mode / PTC-oriented multi-operation workflows
+- `minimal` — only persistent shell access and `str_replace_editor`
+- `cordis` — the full agent plus runtime inspection and preset-authoring guidance
+- user presets — your own tools, prompt sections, skills, compaction, plan mode, and subagent behavior
+
+Use `/mode` before the first turn or start directly with `--mode <preset>`. The selected preset is written to the session and restored on resume.
+
+### 3. Session history and replay
+
+Prompts, streamed chunks, tool calls and results, model choices, plan state, permissions, titles, and preset selections are projected from durable Session events. Resume, export, history inspection, context accounting, and terminal replay use the same record.
+
+React state is limited to temporary interface details such as the input draft, cursor, open panel, selection, and scroll position.
+
+```text
+dsh profile
+└─ Host plane: registries · persistence · query · permissions · sandbox
+   ├─ Agent session A + preset code
+   ├─ Agent session B + preset minimal
+   └─ DSH-Code TUI
+      durable events → pure projection → append-only transcript
+                                  └→ bounded panels → composer → status
+```
+
+## 6. Development
+
+```sh
+pnpm install
+pnpm test
+pnpm typecheck
+pnpm build
+pnpm run gen:whale   # regenerate src/whale-glyph.ts from the vendored logo path
+```
+
+The whale glyph is generated from the DeepSeek FishLogo geometry vendored in `scripts/fish-logo.ts` (source: DeepSeek Harness, MIT).
+
+### 1. Source development installation
+
+For a local checkout:
+
+```sh
+dsh plugin --profile cli add file:C:/path/to/dsh-code
+```
+
+GitHub installation is available for source development:
+
+```sh
+dsh plugin --profile cli add github:unlinearity/dsh-code
+```
+
+The Git package builds during installation. If pnpm asks for an `allowBuilds` entry, copy the complete entry it prints into `~/.dsh/profiles/cli/pnpm-workspace.yaml`, then run the command again. The key includes the Git URL and commit, so do not replace it with only `dsh-code`.
+
+### 2. References
+
+- Runtime services, events, plugin scopes, and persistence follow **DeepSeek Harness**.
+- Session navigation, popup sizing, scrollback, bottom-pane layout, and resize behavior refer to **Codex CLI**.
+- Slash discovery, turn steering, thinking folds, approvals, and question flows refer to **Claude Code**.
+
+DSH-Code is an independent MIT-licensed community project and is not affiliated with OpenAI or Anthropic.
+
+Communities:
+- [Linux DO](https://linux.do/): Learn AI, head to L Station!
+- [Deepseek harness](https://www.deepseek.com/harness): DSH official website.
+
+## License
+
+[MIT](LICENSE). The vendored FishLogo geometry is from DeepSeek Harness (MIT).

package/README.md

@@ -1,67 +1,216 @@
-# dsh-code
-
-English | [中文](README.zh.md)
-
-A Claude-Code-style interactive terminal (TUI) bundle for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (`dsh`), installed as an out-of-tree plugin bundle over the official `@deepseek-ai/dsh-base` — the same plugin ecosystem the official web surface composes, nothing forked.
-
-<p align='center'><img src='src\pictures\1.png' width=95%></p> 
-
-## What you get
-
-- DeepSeek-blue banner: the whale wordmark rasterized half-block from the exact FishLogo path, in a compact content-hugging header
-- Live transcript streamed from the durable session log: user prompts, streaming assistant text, compact tool-call and slash-command rows with running/done/error marks, todo snapshots
-- **Tool approval y/n bar**: when the agent asks for permission (a sandbox escalation, a hook's `ask` decision), an amber bar shows the reason plus the paired command line; `y` allows once, `n` rejects
-- **`/model` panel**: list every provider route the live `llm` registry advertises, switch the session's model for the next step; a resumed session restores its own last model
-- **Session resume**: `--resume <id|prefix>` continues a persisted session, `--continue` picks the newest one for the working directory; the full transcript replays from the log and appends to the same durable session
-- **Slash-command passthrough**: every command registered in the shared `ctx.commands` registry (the same surface the web composer dispatches) is executable from the terminal, with a completion menu on `/`; user-invocable skills join the same menu (marked `skill`), and an unknown `/name` falls through to the prompt so the host's skill injection picks it up
-- **Todo panel**: the live todo list renders inline with done/active/pending counts and three-state markers, cleared at each fresh turn (mirroring the web TodoPanel)
-- **Thinking lines**: model reasoning renders as a Claude-Code-style `✻` fold — collapsed to a dim marker with a character count, expanded to dim-italic text, live-streamed while the model thinks; Ctrl+R toggles globally
-- **Terminal markdown**: assistant replies render through a pure GFM-subset renderer (headings, fenced/inline code, emphasis, lists, quotes, links) wrapped to the terminal width; streaming stays plain until the message settles
-- **Ctrl+O history inspector**: browse one retained transcript entry at a time without replacing the composer or status footer; ←/→ switches entries, ↑/↓ and PageUp/PageDown scroll the complete content, and `g`/`G` jump to either end
-- **Structured tool details**: persisted edit/write diffs, numbered read windows, web-search sources, fetch summaries, and bounded raw output remain compact in the transcript and expand into their full presentation inside Ctrl+O
-- **ask_user_question bar**: the model's questions appear as an option menu (↑/↓, space multi-select, `c` custom answer, Esc interrupts); plan reviews (`exit_plan_mode`) arrive through the same bar with the approve option highlighted
-- **@ mentions**: `@` completion over workspace files and persisted sessions; session mentions expand into bounded read-only snapshots injected as sourced context before the prompt
-- **Plan mode and permissions**: `⧉ plan` and `⛨ <preset>` badges in the status line; `/permission <name>` switches the session preset, Shift+Tab cycles through them (the registry's own `/plan` command enables plan mode)
-- **Local terminal workflows**: `/help` opens the complete key/command/skill surface, `/export` writes the folded transcript to Markdown, `/title` pins a session title, Ctrl+K deletes to end of line, Ctrl+L redraws the terminal, and bare workspace paths participate in Tab completion
-- Input with history (↑/↓), cursor editing (←/→, Ctrl+A/E/U), Tab completion for slash commands, skills, and @ mentions; submitting while the agent runs steers the live turn (consumed at the next step boundary), `Esc` or Ctrl+C interrupts it, Ctrl+C on an empty idle input exits, Ctrl+D refuses to exit mid-turn
-- A blended status line: Claude-Code-style identity facts (model, working directory, git branch, title/session, plan, permission preset, goal and sandbox overrides) beside the web composer's figures (turns/steps, llm and tool wall time, TTFT, decode tok/s, context occupancy, cache hit, token totals)
-- Bounded live rendering: streaming output, Ctrl+O, `/help`, `/model`, approvals, and question/plan-review panels stay within terminal-aware viewports; the composer remains directly above its status footer, and a debounced resize reflows the screen once at the settled width
-
-## Install
-
-Requires Node `^22.19 || >=24` and the `dsh` CLI (`npm i -g @deepseek-ai/dsh@next`).
-
-```sh
-dsh plugin --profile cli add dsh-code       # from npm, once published
-dsh plugin --profile cli add github:unlinearity/dsh-code  # track this repo
-dsh plugin --profile cli add file:C:/path/to/dsh-code     # local checkout
-```
-
-Then:
-
-```sh
-dsh --profile cli                    # fresh session
-dsh --profile cli --continue         # resume the newest session in this directory
-dsh --profile cli --resume abc123    # resume by session id or unique prefix
-dsh --profile cli --session my-id    # fresh session under an explicit id
-```
-
-Set `DEEPSEEK_API_KEY` in your environment (or a `.env` in the launch directory or `$DSH_HOME`).
-
-Git-hosted plugins build on install via their install scripts, which pnpm blocks until allowed: if an `add` fails, append the key it prints under `allowBuilds` in `~/.dsh/profiles/cli/pnpm-workspace.yaml` and re-run.
-
-## Develop
-
-```sh
-pnpm install
-pnpm test         # vitest unit tests
-pnpm typecheck
-pnpm build        # tsdown bundles lib/*.mjs, tsc emits lib/types
-pnpm run gen:whale   # regenerate src/whale-glyph.ts from the vendored logo path
-```
-
-The whale glyph is generated from the DeepSeek fish-logo path vendored in `scripts/fish-logo.ts` (source: [deepseek-harness](https://github.com/deepseek-ai/deepseek-harness), MIT).
-
-## License
-
-[MIT](LICENSE). The vendored fish-logo geometry is from DeepSeek Harness (MIT).
+# DSH-Code
+
+[English](README.en.md) | 中文
+
+<p align="center"><img src="docs/pictures/1.png" width="95%" alt="带斜杠命令补全的 DSH-Code 终端"></p>
+
+<p align="center"><img alt="Typing SVG" src="https://readme-typing-svg.herokuapp.com?font=JetBrains+Mono&amp;weight=500&amp;size=22&amp;duration=4000&amp;pause=700&amp;color=4176E6&amp;center=true&amp;vCenter=true&amp;width=680&amp;lines=DeepSeek+Harness+Code;DSH+%E5%86%85%E6%A0%B8%E7%9A%84%E7%BB%88%E7%AB%AF%E7%BC%96%E7%A0%81%E7%95%8C%E9%9D%A2"></p>
+<p align="center">
+  <a href="https://github.com/deepseek-ai/deepseek-harness"><img alt="DeepSeek Harness" src="https://img.shields.io/badge/DeepSeek-Harness-4176E6?style=for-the-badge&amp;logo=deepseek&amp;logoColor=white&amp;labelColor=1c1917"></a>
+  <a href="https://github.com/UNLINEARITY/dsh-code/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/UNLINEARITY/dsh-code?label=Stars&amp;style=for-the-badge&amp;logo=github&amp;logoColor=white&amp;color=4176E6&amp;labelColor=1c1917"></a>
+  <a href="https://www.npmjs.com/package/dsh-code"><img alt="npm version" src="https://img.shields.io/npm/v/dsh-code?label=npm&amp;style=for-the-badge&amp;logo=npm&amp;color=cb3837&amp;labelColor=1c1917"></a>
+  <a href="https://github.com/UNLINEARITY/dsh-code/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/github/license/UNLINEARITY/dsh-code?label=License&amp;style=for-the-badge&amp;logo=opensourceinitiative&amp;color=4176E6&amp;labelColor=1c1917"></a>
+</p>
+
+**DSH-Code 是 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（`dsh`）的终端编码界面。** 它以树外 bundle 的形式组合在官方 `@deepseek-ai/dsh-base` 之上，与 Harness Web UI 使用同一套 Agent、Session、工具、命令、技能、权限、sandbox、上下文压缩与插件服务。
+
+DSH-Code 没有另外实现一套 Agent loop，而是在 DSH 运行时上增加面向编码工作的 TUI。会话处理参考 [Codex CLI](https://github.com/openai/codex)，终端交互参考 [Claude Code](https://code.claude.com/docs/en/overview)。
+
+---
+
+## 一、项目概览
+
+DeepSeek Harness 将模型、工具、存储、策略和界面作为插件，通过 Cordis 注册。持久化会话事件记录恢复对话与运行状态所需的信息。
+
+DSH-Code 保留这套结构，并补充适合编码任务的终端工作流。
+
+| 参考项目 | DSH-Code 使用的机制 |
+| --- | --- |
+| **DeepSeek Harness** | 插件组合、作用域服务、Agent Preset、持久会话、工具、技能、策略、sandbox 与委派 |
+| **Codex CLI** | 会话导航、有界浮层、历史检查、稳定底部布局与缩放处理 |
+| **Claude Code** | 斜杠命令发现、思考折叠、审批、提问与 turn steering |
+
+界面采用开发者熟悉的终端操作方式，运行行为仍由 DSH 服务和配置决定。
+
+## 二、快速开始
+
+需要 Node `^22.19 || >=24`、预览版 `dsh` CLI，以及 `DEEPSEEK_API_KEY`。
+
+```sh
+npm install -g @deepseek-ai/dsh@next dsh-code
+npm install -g pnpm
+dsh plugin --profile cli add dsh-code
+```
+
+可用的启动指令：
+```sh
+deepseek
+dsh --profile cli
+dsh-code
+```
+
+`dsh --profile cli`、`deepseek` 与 `dsh-code` 是并列的启动命令。`deepseek` 与 `dsh-code` 都是 `dsh --profile cli` 的全局别名，后续参数会原样转发，例如 `deepseek --resume abc123`。
+
+> DeepSeek Harness 目前仍处于 developer preview，可能出现破坏兼容性的变化；DSH-Code 会持续跟随其插件接口演进。
+
+安装、原生模块和插件加载问题，请查看[常见问题与排障](docs/problems.md)。
+
+## 三、终端交互
+
+### 基础
+
+DSH-Code 在整个进程中只保留一个 Ink owner。`/new` 和 `/resume` 替换的是活动 Agent，而不是终端本身。若 Agent 忙碌，切换会等待当前 turn 自然结束；最新请求优先，目标加载失败也不会破坏当前会话。
+
+所有动态内容都受到明确的视口约束。流式输出、思考过程、审批、问题、`/help`、`/model`、`/mode`、`/resume`、`/plugin` 与 Ctrl+O 使用统一的终端预算。输入框始终紧贴状态栏上方；终端宽度稳定后，界面会根据保存的会话记录重新绘制一次。
+
+在第一次 turn 之前使用 `/mode`，查看或选择当前会话的 Agent Preset。
+
+<p align="center"><img src="docs/pictures/2.png" width="95%" alt="每会话 Agent Preset 选择器"></p>
+
+使用 `/resume` 搜索持久会话，无需重新启动 TUI。
+
+<p align="center"><img src="docs/pictures/3.png" width="95%" alt="可搜索的会话恢复选择器"></p>
+
+### 常用命令
+
+```sh
+dsh --profile cli                    # 新建 standard 会话
+dsh --profile cli --mode code        # 使用 Agent Preset 启动
+dsh --profile cli --continue         # 恢复当前目录最新会话
+dsh --profile cli --resume abc123    # 按 id 或唯一前缀恢复持久会话
+dsh --profile cli --session my-id    # 使用指定 id 新建会话
+```
+
+进入 TUI 后：
+
+| 操作 | 用途 |
+| --- | --- |
+| `/new [preset]` | 不重启终端，创建并进入另一个会话 |
+| `/resume [id\|前缀]` | 搜索根会话或全部对话，并按 cwd、排序和密度筛选 |
+| `/mode [preset]` | 检查或选择空会话的 Agent 组合 |
+| `/model` | 在实时 LLM 注册表提供的模型间切换 |
+| `/plugin [query]` | 检查 loader 条目、启用状态、模块身份和 fiber 阶段 |
+| `/permission <name>` | 切换权限预设；Shift+Tab 可循环切换 |
+| `/help` | 浏览本地命令、Harness 命令、技能和快捷键 |
+| `Ctrl+O` | 打开独占历史详情视图，切换条目并滚动完整内容 |
+| `Ctrl+R` | 折叠或展开模型思考过程 |
+| `@` | 引用工作区文件或持久会话的有界快照 |
+| `Esc` / `Ctrl+C` | 关闭最上层界面或中断当前 turn |
+
+## 四、功能
+
+### 1. Agent 与扩展
+
+- 每会话 Agent Preset：组合工具、提示词、技能、上下文压缩、plan mode 与委派能力
+- 从共享 Harness 注册表实时发现斜杠命令和用户技能
+- 通过 `/plugin` 只读诊断 Cordis loader
+- 从实时 LLM 注册表路由模型，并按持久会话恢复选择
+- 支持 plan、goal、todo、权限、sandbox、subagent 与运行中 steering
+
+### 2. 会话与上下文
+
+- `/new`、`/resume`、`--continue` 与显式 session id，且无需重新挂载 Ink
+- Codex 风格可搜索恢复面板，支持根/全部对话、cwd、排序和密度筛选
+- 裸启动延迟到首次真实输入才创建会话，未输入即退出零残留
+- 全局输入历史：Up/Down 跨会话召回，`/history` 搜索面板回填输入框
+- 标题快照按需折叠，完整转录仅在显式请求时加载并支持全量滚动
+- subagent 对话只读检查，以及通过 `@` 注入有界会话引用
+- Markdown 导出、持久标题、上下文占用、缓存、token、TTFT 与耗时指标
+
+### 3. 审批与交互
+
+- sandbox 升级与 hook `ask` 决策的一次性工具审批条
+- 结构化 `ask_user_question` 与 plan review 菜单，支持多选和自定义答案
+- 在下一个 step 边界进行 turn steering，并提供明确的中断语义
+- Agent mode、plan、权限 preset、goal 与 sandbox 状态相互独立
+
+### 4. 终端渲染
+
+- 已落定历史只追加，流式可变区域严格有界
+- 思考折叠、终端 Markdown、紧凑工具摘要与完整结构化详情
+- 双行状态栏：mode 与 context 在第二行，context 为蓝色进度条，全蓝强调
+- 运行中提交即时显示为普通提示词行，Delete 取消排队消息，busy 使用 web StateDot 八点追逐动画
+- 回复与输入框光标对齐，欢迎头字标提亮
+- Ctrl+O 独占历史检查，支持切换条目与完整纵向滚动
+- CJK/控制字符宽度安全、短终端主动降级、缩放防抖重放
+- 固定底部顺序：内容或面板 → notice → 输入框 → 状态栏
+
+## 五、DSH-Code 如何接入 DSH
+
+### 1. 运行时组合
+
+DSH-Code 读取 Harness 的实时注册表，不在本地维护另一套副本。模型适配器、工具 provider、技能来源、命令、权限策略、持久化后端、sandbox 和 subagent provider 都可以通过 DSH composition 添加或替换。
+
+`/plugin` 提供当前 Cordis loader 状态的只读视图。
+
+### 2. 会话级 Agent Preset
+
+Host 持有共享基础设施——注册表、持久化、会话查询、权限和 sandbox 策略；每个会话则获得一个隔离的 Agent scope，并由 **Agent Preset** 进行组合：
+
+- `standard`——功能完整的通用编码 Agent
+- `code`——面向 Code Mode / PTC 的多操作工作流
+- `minimal`——只保留持久 shell 和 `str_replace_editor`
+- `cordis`——完整 Agent，加上运行时检查与 Preset 编写指导
+- 用户预设——自行定义工具、提示词段落、技能、上下文压缩、plan mode 与 subagent 行为
+
+在第一次 turn 之前使用 `/mode`，或通过 `--mode <preset>` 直接启动。选中的 preset 会写入会话，并在恢复时还原。
+
+### 3. 会话记录与恢复
+
+提示词、流式 chunk、工具调用与结果、模型选择、plan 状态、权限、标题和 preset 选择都由持久 Session 事件投影得到。会话恢复、导出、历史检查、上下文统计和终端重放使用同一份记录。
+
+React state 只保存输入草稿、光标、当前面板、选中项和滚动位置等临时界面状态。
+
+```text
+dsh profile
+└─ Host plane：注册表 · 持久化 · 查询 · 权限 · sandbox
+   ├─ Agent 会话 A + preset code
+   ├─ Agent 会话 B + preset minimal
+   └─ DSH-Code TUI
+      持久事件 → 纯投影 → 只追加的历史转录
+                         └→ 有界面板 → 输入框 → 状态栏
+```
+
+## 六、开发
+
+```sh
+pnpm install
+pnpm test
+pnpm typecheck
+pnpm build
+pnpm run gen:whale   # 从 vendored Logo 路径重新生成 src/whale-glyph.ts
+```
+
+鲸鱼字形由 `scripts/fish-logo.ts` 中 vendored 的 DeepSeek FishLogo 几何数据生成（来源：DeepSeek Harness，MIT）。
+
+### 1. 源码开发安装
+
+本地 checkout 可使用：
+
+```sh
+dsh plugin --profile cli add file:C:/path/to/dsh-code
+```
+
+GitHub 安装可用于源码开发：
+
+```sh
+dsh plugin --profile cli add github:unlinearity/dsh-code
+```
+
+Git 包会在安装阶段构建。若 pnpm 要求添加 `allowBuilds`，请把它输出的完整条目复制到 `~/.dsh/profiles/cli/pnpm-workspace.yaml`，再重新执行命令。该键包含 Git URL 与 commit，不能只写 `dsh-code`。
+
+### 2. 参考
+
+- 运行时服务、事件、插件作用域和持久化模型遵循 **DeepSeek Harness**。
+- 会话导航、浮层尺寸、scrollback、底部布局与缩放处理参考 **Codex CLI**。
+- 斜杠发现、turn steering、思考折叠、审批和提问流程参考 **Claude Code**。
+
+DSH-Code 是独立的 MIT 社区项目，与 OpenAI 或 Anthropic 无隶属关系。
+
+社区：
+- [Linux DO](https://linux.do/)：学 AI，上 L 站！
+- [Deepseek harness](https://www.deepseek.com/harness): DSH 官方网站
+
+## 许可
+
+[MIT](LICENSE)。vendored FishLogo 几何数据来自 DeepSeek Harness（MIT）。

package/bin/deepseek.mjs

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+
+import { spawn } from 'node:child_process'
+import { existsSync, realpathSync } from 'node:fs'
+import { createRequire } from 'node:module'
+import { join, resolve } from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+
+const packageRequire = createRequire(import.meta.url)
+
+/** Arguments required to boot DSH-Code's conventional profile. */
+export const profileArgs = (args = []) => ['--profile', 'cli', ...args]
+
+/** Npm global-prefix roots that may contain DSH when this launcher is globally linked to a checkout. */
+export function globalDshRoots() {
+  return [...new Set([
+    process.env.npm_config_prefix,
+    process.env.APPDATA === undefined ? undefined : join(process.env.APPDATA, 'npm'),
+    process.env.PREFIX,
+  ].filter(Boolean))]
+}
+
+/** Resolve the DSH entrypoint without passing user arguments through a Windows shell. */
+export function dshCommand(args, {
+  platform = process.platform,
+  moduleUrl = import.meta.url,
+  fileExists = existsSync,
+  roots = globalDshRoots(),
+  resolvePackage = packageRequire.resolve,
+} = {}) {
+  if (platform !== 'win32') return { command: 'dsh', args: profileArgs(args) }
+  const adjacentEntrypoint = fileURLToPath(new URL('../../@deepseek-ai/dsh/lib/bin.js', moduleUrl))
+  if (fileExists(adjacentEntrypoint)) return { command: process.execPath, args: [adjacentEntrypoint, ...profileArgs(args)] }
+  for (const root of roots) {
+    try {
+      const entrypoint = resolvePackage('@deepseek-ai/dsh/lib/bin.js', { paths: [root] })
+      return { command: process.execPath, args: [entrypoint, ...profileArgs(args)] }
+    } catch {
+      // The next configured global prefix may own DSH instead.
+    }
+  }
+  return undefined
+}
+
+/** Launch the installed DSH CLI while preserving its exit status and stdio. */
+export function launchDsh(args = process.argv.slice(2), spawnProcess = spawn, resolveCommand = dshCommand) {
+  const command = resolveCommand(args)
+  if (command === undefined) {
+    console.error('dsh-code: @deepseek-ai/dsh must be installed globally beside dsh-code; run: npm install -g @deepseek-ai/dsh@next dsh-code')
+    process.exitCode = 1
+    return undefined
+  }
+  const child = spawnProcess(command.command, command.args, {
+    stdio: 'inherit',
+  })
+
+  child.once('error', error => {
+    console.error(`dsh-code: could not start dsh: ${error.message}`)
+    process.exitCode = 1
+  })
+  child.once('exit', (code, signal) => {
+    process.exitCode = code ?? (signal === null ? 0 : 1)
+  })
+  return child
+}
+
+const entrypoint = process.argv[1]
+if (entrypoint !== undefined && pathToFileURL(realpathSync(resolve(entrypoint))).href === import.meta.url) {
+  launchDsh()
+}