johnnycls/dsh-no-setup-mode

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

中文版（Chinese version）：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.

---

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. 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).

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 scripts/smoke-test.sh

License

MIT