# v0.1.6 — DSH 0.1.2-rc.1 and official documentation

[简体中文](./v0.1.6.zh-CN.md)

This release updates the bundled DeepSeek Harness from `0.1.1-rc.2` to `0.1.2-rc.1` and adds a versioned official documentation mirror to the repository.

## Changes

- Adapts Session replay, structured questions, provider settings, and first-token timing to the new Harness APIs. Existing image input, durable attachments, plan mode, approvals, and Session resume remain available.
- Uses `ptc` as the PTC tools-mode value. `DSH_TOOLS_MODE=code` remains an accepted alias; `native` and `both` remain supported.
- Qualifies external DSH runtimes in `>=0.1.2-rc.1 <0.1.3` through an isolated behavioral probe. The bundled runtime stays pinned to `0.1.2-rc.1`.
- Includes the runtime peers needed by cold npm installs and retains Sharp `0.35.3`. Both ordinary npm peer resolution and `--legacy-peer-deps` have installed-artifact coverage.
- Mirrors 1,332 original official files, including 882 Markdown files and 433 Chinese documents. The [documentation entry](../upstream/dsh/README.md) provides navigation, source provenance, licenses, and sync/check commands. CI verifies the snapshot; the mirror is excluded from the npm package.

## Install

After this version is available on npm:

```bash
npx --yes --legacy-peer-deps dsh-claude-tui@0.1.6
```

For a persistent command:

```bash
npm install --global --legacy-peer-deps dsh-claude-tui@0.1.6
dshtui
```

Node.js `22.19+` or `24+` is required. Ordinary npm installation without `--legacy-peer-deps` also works, but cold peer resolution can take several minutes. The shorter `dshtui` and canonical `dsh-claude-tui` commands share the same launcher.

## Upgrade notes and qualification

The upstream release removes the optional SQLite **Session persistence** backend. If you used that backend, export its Sessions with the old Harness before upgrading. SQLite query/index storage is a separate service. Use separate Homes for cross-version testing; this TUI does not supply a SQLite exporter or downgrade migration.

The supported qualification targets remain macOS arm64 and Linux x64. Windows/ConPTY remains unqualified. Deterministic installed-package tests exercise chat, tools, and Session resume against a loopback provider mock; they do not prove production-provider behavior. The real system-clipboard and Files API image flow is a separate opt-in gate and has not been run for this release candidate.

See the [adaptation record](../harness-0.1.2-rc.1-adaptation.md) and [official upstream release](https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.2-rc.1). Upstream Web documentation does not imply matching TUI interfaces.