dsh-code 0.9.1 → 1.0.0

package/README.en.md

@@ -7,6 +7,7 @@ English | [中文](README.md)
 <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://www.npmjs.com/package/@deepseek-ai/dsh"><img alt="dsh version" src="https://img.shields.io/badge/dsh-0.1.0--rc.8-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>
@@ -34,22 +35,27 @@ The interface follows familiar terminal conventions, while runtime behavior cont
 
 ## 2. Quick start
 
-Requires Node `^22.19 || >=24` and the preview `dsh` CLI. `DEEPSEEK_API_KEY` is not a startup prerequisite: the TUI, sessions, and non-model features remain available without it; press `a` in `/model` to add an API key through the Harness credentials service.
+Requires Node `^22.19 || >=24` and the preview `dsh` CLI (current line: `@deepseek-ai/dsh@0.1.0-rc.8`). `DEEPSEEK_API_KEY` is not a startup prerequisite: the TUI, sessions, and non-model features remain available without it; press `a` in `/model` to add an API key through the Harness credentials service.
+
+### 1. Install or update
+
+First install and updates use the same commands:
 
 ```sh
-npm install -g @deepseek-ai/dsh dsh-code
+npm install -g @deepseek-ai/dsh@0.1.0-rc.8 dsh-code@1.0.0
 npm install -g pnpm
-dsh plugin --profile cli add dsh-code@0.9.1
+dsh plugin --profile cli add dsh-code@1.0.0
 ```
 
-> Note: pnpm ignores packages published less than 24 hours ago, so pin `dsh-code@0.9.1` on the release day; the version can be omitted afterwards. npm installs are not affected.
+> Note: pnpm ignores packages published less than 24 hours ago, so pin `dsh-code@1.0.0` on the release day; the version can be omitted afterwards. npm installs are not affected.
+>
+> Version alignment: dsh-code 1.0.x builds against the dsh `0.1.0-rc.8` plugin line (all peer dependencies are `^0.1.0-rc.8`). Keep the global dsh CLI and dsh-code on the same release line so the host and the plugin stay aligned.
 
-### Updating
+### DSH-Code wrapper
 
-```sh
-npm install -g dsh-code@0.9.1
-dsh plugin --profile cli add dsh-code@0.9.1
-```
+DSH-Code is a terminal wrapper over DeepSeek Harness. It does not replace Harness services for Agent, sessions, models, tools, approvals, or persistence; the `cli` profile composes those services with the terminal bundle. `deepseek` and `dsh-code` are convenience aliases for `dsh --profile cli`.
+
+### 2. launching
 
 Available launch commands:
 
@@ -89,6 +95,11 @@ 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
+deepseek setup                        # mount the current release in the cli profile
+deepseek doctor                       # check Node, DSH, profile, and composition
+deepseek completion powershell       # generate shell completion
+deepseek update                       # check available versions only
+deepseek update --apply               # explicitly update the global install
 ```
 
 Inside the TUI:
@@ -97,9 +108,13 @@ Inside the TUI:
 | --- | --- |
 | `/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 |
+| `/fork [event-seq]` | Create a resumable ordinary fork from a completed turn containing the event |
 | `/mode [preset]` | Inspect or select the blank session's Agent composition |
-| `/model` | Switch among models from the live LLM registry; press `a` to manage providers and API keys |
+| `/model` | Switch among live-registry models; press `a` to manage providers, then `Tab` to edit URL, models, and windows |
 | `/plugin [query]` | Inspect loader entries, enabled state, module identity, and fiber phase |
+| `/diff [--staged\|ref]` | Inspect the complete Git diff by file; left/right switches files |
+| `/review [--staged\|ref]` | Submit a bounded code review after switching to `read-only` permissions |
+| `/copy` | Copy the latest complete assistant response |
 | `/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 |
@@ -107,7 +122,7 @@ Inside the TUI:
 | `@` | Mention workspace files or bounded snapshots of persisted sessions |
 | `Esc` / `Ctrl+C` | Close the topmost surface or interrupt the active turn |
 
-The `/model` provider panel reads only credential configuration, source, and writability facts. Typed keys stay masked and are handed directly to Harness persistence. Keys supplied by the launch environment are shown as read-only and cannot be overwritten or removed in the TUI.
+Press `a` in `/model` to manage providers; press `Tab` on a provider to edit its endpoint URL, explicit model allow-list, and per-model context/output windows. Typed API keys stay masked and are handed directly to Harness persistence. Keys supplied by the launch environment are read-only and cannot be overwritten or removed in the TUI.
 
 ## 4. Features
 
@@ -116,17 +131,18 @@ The `/model` provider panel reads only credential configuration, source, and wri
 - 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; `/model` can add or rotate keys, remove writable keys, and delete user-added provider profiles
+- Model routing through the live LLM registry, restored per persisted session; `/model` can add or rotate keys, remove writable keys, delete user-added provider profiles, and set an endpoint, explicit model allow-list, and token windows
 - Plans, goals, todos, permissions, sandbox state, subagents, and runtime steering
 
 ### 2. Sessions and context
 
-- `/new`, `/resume`, `--continue`, and explicit session identifiers without remounting Ink
+- `/new`, `/resume`, `/fork`, `--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
+- Initial prompts and repeated `--image`; Harness persists image bytes in its attachment store and records content-addressed references in session events
 - Markdown export, persistent titles, context occupancy, cache, token, TTFT, and timing metrics
 
 ### 3. Approvals and interaction