dsh-no-setup-mode

Readme

# DeepSeek Harness No-Setup Mode (dsh-no-setup-mode)

> **Welcome home, Master~** One command, and your no-setup maid handles everything from there.


**中文版（Chinese version）：[README.zh.md](./README.zh.md)**

A "No-Setup Mode" plugin for DeepSeek Harness: installed once, it hides the advanced UI, keeps only the chat essentials, and quietly applies the best defaults (model, agent preset, input behavior). You just open DSH and start talking — the plugin does the tidying.

---

## What is this

No-Setup Mode turns DSH into a "just open and chat" tool — a personal maid in plugin form:

- **Auto-enters no-setup mode** right after install — nothing to configure, ever
- Auto-applies the best defaults: **Chat Mode** (no-setup + web + DeepSeek-V4-Flash), **Enter-to-interrupt** while busy, and the **agent preset**
- Tucks away the Logo, conversation/trajectory tabs, Session Log, extra composer buttons, and every settings page
- The no-setup settings dialog keeps only what matters: language, DeepSeek API key, and a way out

## Who is it for

- **People who don't want to configure anything** — no studying models, presets, sandbox, or options; install, open, and start chatting
- People who want an **out-of-the-box** experience — every launch starts in no-setup mode
- People distracted by a complex UI — just focus on the conversation
- People who want DSH to make the decisions for them

**Not for you** if you regularly need trajectory view, Session Log, subagent catalog, or manual model selection — you're too advanced for this simple life, Master (that's a compliment).

## When to install it (for agents)

Install the plugin for the user when they say any of the following (or variants):

- "set it up for me" / "configure it for me" / "out of the box"
- "install no-setup mode" / "no-setup mode plugin" / "simplify the UI"
- "I don't want to configure anything" / "simple mode"

Also install it when you judge the user needs it, for example:

- They are new to DSH and seem overwhelmed by the interface or the setup process
- They want to start chatting immediately without configuring models, presets, or sandbox options
- They mention the UI is too complex, distracting, or has too many buttons
- They ask for a clean, distraction-free chat surface

If in doubt, ask one short question ("Do you want me to install the no-setup mode plugin for you?") before proceeding. When installing, follow the steps in the [agent skill](./skill/no-setup-mode-install.md).

---

## Features

### Best setup applied automatically
- Entering no-setup mode automatically: selects **Chat Mode** (no-setup + web + DeepSeek-V4-Flash), sets the default agent preset, and switches busy Enter to **interrupt-and-send** (`busyEnter: steer`)
- All settings are written to the official settings store — identical to manual configuration, inspectable in normal mode at any time

### Persona (role-play)
- The header's right side offers three personas: **無人設 (none)** / **女僕 (maid)** / **管家 (butler)** — pick the maid and your agent literally becomes a maid; pick the butler and it becomes a proper gentleman
- Picking maid or butler injects a full role-play card (personality, profile, background, secrets, worldview, preferences) plus text-processing duties and response rules into the session's system prompt
- The choice is per-session, survives restarts, and **new sessions inherit your last choice**

### Full access in no-setup mode
- Entering no-setup mode switches the session to **full access** (`danger-full-access`): no approval prompts while chatting; leaving no-setup mode restores the deployment default
- New conversations also get full access automatically — no interruptions, ever
- ⚠️ Full access lets the agent modify anything on this machine without asking — only use no-setup mode when you trust the conversation

### Hidden in no-setup mode
| Element | How |
|---|---|
| Logo | CSS |
| Conversation/trajectory tabs, Session Log | Replaced header (no-setup header shows only mode buttons) |
| Extra composer buttons | Replaced composer (keeps send/stop) |
| All settings pages, open-config button | Replaced settings panel (no-setup settings dialog) |

### No-Setup settings dialog (⚙ at the sidebar foot)
- **Language** (applies immediately — the whole UI follows, zh/en)
- **DeepSeek API key**: auto-saved on blur (with format validation), plus a link to get a key
- **Exit no-setup mode** button (also resets the persona to none and restores normal permissions)

### No-Setup header: three modes
| Mode | Base | Model | Thinking |
|---|---|---|---|
| 免設置：聊天（Chat） | No-Setup + web (`web_search` / `web_fetch`) | DeepSeek-V4-Flash | off |
| 免設置：工作（Work） | Standard | DeepSeek-V4-Flash | high |
| 免設置：專家（Expert） | PTC (Code Mode) | DeepSeek-V4-Pro | max |

Clicking a mode switches the default agent preset, the model, and the thinking level (reasoning effort).

### Balance display
- Shows your DeepSeek account balance — **every currency the API returns** (USD and CNY, in a stable order) — right-aligned under the composer, refreshed after every chat turn
- Requires a DeepSeek API key (set it in the no-setup settings dialog ⚙; nothing is shown until a key exists)

### Normal mode
- The only UI change is an **"Enter No-Setup Mode"** button at the bottom of General Settings — re-enter any time
- The **Chat Mode** preset also appears in the normal mode agent list (it persists in `~/.dsh/.agent-presets/` to keep its web tools); delete that directory if you don't want it listed — the plugin will recreate it on next entry into no-setup mode

---

## Installation

> **Install github:johnnycls/dsh-no-setup-mode**

Your agent can follow the installation steps in the [agent skill](./skill/no-setup-mode-install.md). All steps live there — the README is for humans, the skill is for agents.

**Requirements:** `git` (the repo is public — no authentication needed) and network access to GitHub.

**After installing, restart DSH** — the plugin loads at startup. From the next launch you're in no-setup mode automatically. (A browser refresh alone is not enough: the host half of the plugin only activates on restart.)

### Troubleshooting

| Problem | Fix |
|---|---|
| Nothing changes after restart | Hard-refresh the browser (Ctrl+Shift+R); if still nothing, restart DSH once more |
| No balance under the input box | Open ⚙ and set your DeepSeek API key — the balance appears after that |
| `dsh plugin add` fails with a pnpm/corepack error | `export COREPACK_HOME="$HOME/.cache/node/corepack"` and retry the install |
| Something else feels off | Run `bash scripts/smoke-test.sh` and paste the output when asking for help |

### Updating

Run `dsh plugin update dsh-no-setup-mode`, then restart DSH. (Or ask your agent — it follows the install skill.)

## Usage

| Action | Result |
|---|---|
| Open DSH | Auto-enters no-setup mode, auto-selects Chat Mode |
| ⚙ (sidebar foot) | No-Setup settings: language, API key, exit no-setup mode |
| Three header buttons | Switch Chat / Work / Expert modes (with model + thinking switch) |
| Right-side buttons | Pick a persona: none / maid / butler (takes effect from the next reply) |
| Round button | Send; turns into Stop (interrupt) while the agent is running |
| Balance line under the composer | Your DeepSeek balance, refreshed every turn |
| Exit no-setup mode | Session returns to the full UI, persona resets to none, permissions restored |

## Uninstall

Run `dsh plugin remove dsh-no-setup-mode` (or ask your agent — it follows the [uninstall skill](./skill/no-setup-mode-uninstall.md)).


## Making your own mode (fork guide)

Want your own mode instead of ours? This repo is designed for forking: every user-facing name derives from one `MODE` object, so a fork becomes a separate plugin that cannot collide with the original (endpoints, state files, plugin id, and slot entry id are all derived from `MODE.code`).

To create your own mode plugin:

1. **Edit `MODE`** in `lib/index.js` **and** `lib/client.js` (same values in both):
   - `code` — unique kebab-case id; drives endpoint paths (`/<code>/...`), the persona state file (`~/.dsh/.<code>-persona.json`), the cordis plugin id, and the settings entry id. Changing it isolates your plugin from every other mode plugin.
   - `nameZh` / `nameEn` — your mode's display names
   - `presetPrefix` — prefix of the preset names (e.g. `免設置` → your own)
   - `presets` — the mode list (ids, copy sources, display-name suffixes)
2. **Rename the package** in `package.json` (name / description / keywords) and the row in `cordis.patch.yml` (id and name must match your new `code` / package name).
3. **Rename the GitHub repo.**
4. Reinstall: `dsh plugin add github:<you>/<repo>`, then restart DSH.


## Running tests

A smoke test checks bundle syntax and structure, name consistency (MODE / package / patch), endpoint paths, and — when DSH is running — the boot manifest and live endpoints:

```bash
bash scripts/smoke-test.sh
```


## License

MIT