dsh-refine
dsh continual-harness engine（dsh-continual-harness）的 UX 层：提供 /refine 人类命令和设置面板，支持条目浏览、优化历史时间线、一键回滚和自动门控审计——运行时引擎可选。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-refine@1.2.1Refine 以 dsh-refine 发布，当前版本为 1.2.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 简体中文
A refinement UX layer for the DeepSeek Harness (dsh): the /refine human
command plus a settings panel with entry browsing, a refinement history
timeline, one-click rollback, and auto-gate audit. It drives the
dsh-continual-harness
engine, which is optional at runtime — when the engine is not mounted,
every operation degrades into an actionable instruction instead of an error.
The plugin is the shell, and since 1.2.0 it mounts the engine itself:
dsh-continual-harness starts as a child plugin under ctx.isolate('commands'),
so the engine's own /refine adapter never registers and dsh-refine keeps the
full command surface (status / list / history / rollback / triggers)
while forwarding the engine's --global / --local grammar to it. List only
dsh-refine in your profile's dsh.profile.bundles; a profile that still
mounts dsh-continual-harness as its own row keeps working — the shell detects
the already-registered engine, skips its own mount, and falls back to the
engine's /refine.
This project is a port and practical adaptation of the
prime-agent /refine idea
for the dsh ecosystem.
/refine command — status / list [kind] / history [n] /
rollback <id>, plus free-text refinement instructions (owned by the engine
when it is mounted; provided by dsh-refine otherwise)harness/refinement session event
written by older engine builds is registered into the host reader so legacy
refined-session logs stay loadable (the 0.3.0 engine self-registers and no
longer writes it; dsh-refine keeps an idempotent defensive registration)session.events but the dsh host only exposes snapshotEvents(), dsh-refine
installs a guarded events getter so the engine's projection/planner stops
crashing with Cannot read properties of undefined (reading 'length')^0.1.5-rc.2 for @deepseek-ai/dsh-home-paths /
@deepseek-ai/dsh-typert-protocol, which must stay single-instance with the
host — align them via the profile's pnpm.overrides)Add the package to your profile and let it mount the engine itself (since
1.2.0 the shell owns the whole arrangement — do not mount
dsh-continual-harness as a separate bundle row):
dsh plugin --profile web add dsh-refine
For development, point the profile's package.json dependency at a local
checkout and reinstall:
cd ~/.dsh/profiles/web
pnpm add link:/path/to/dsh-refine
dsh plugin --profile web install
The engine arrives as dsh-refine's own dependency (dsh-continual-harness
^0.3.1) and mounts under an isolated commands scope, so its /refine
adapter never collides with this package's.
Restart dsh web to apply (host-side changes need a restart; client panel
changes hot-reload while pnpm run dev:web is running).
| Input | Description |
|---|---|
/refine status | Overview of engine/rollback state |
/refine list [kind] | List current entries (filter by prompt/memory/skill/subagent) |
/refine history [n] | Recent refinement history (default 10, max 50) |
/refine rollback <id> | Roll back one committed refinement (ids from history) |
/refine <any text> | Trigger an engine refinement; returns immediately, results appear later in the panel / history |
/refine <text>treats the text as a refinement instruction handed to the engine's planner. For ordinary chat, just type in the input box without the/prefix. Whendsh-continual-harness@0.3.0+is mounted it owns/refine(plan + rollback); the panel below still offers the browse / timeline / one-click-rollback views.
Settings → Refine Harness: a settings-style overview of engine and state
path, browse prompt / memory / skill / subagent entries, inspect the
history timeline and roll back with one click, and audit auto-gate decisions.
engine mounted (dsh-continual-harness@0.3.0+):
/refine ──► engine's own /refine ──► coordinator ──► harness_state.json / refinements.jsonl
engine absent:
/refine ──► dsh-refine /refine ──► tools.execute('harness_refine') ──► actionable setup instruction
panel (always): 设置 → 精炼 Harness ──► refineUx data/rollback ──► ESP files + harness_refine
/refine history.lib/compat.js registers harness/refinement
into the host reader's known event-type set (KNOWN_SESSION_EVENT_TYPES) —
one registration keeps logs from older engine builds loadable; as of 0.3.0
the engine no longer writes the event and self-registers the type itself.npm install
npm run lint # ESLint (lib/ + smoke-host.mjs)
npm test # smoke suite — no engine required; extra host-registration
# assertions run when dsh is on PATH
The smoke suite is hermetic: minimal engine ESP fixtures are bootstrapped
automatically when ~/.dsh/harness lacks them, and it also exercises the real
dsh install paths for compatibility regression (skipped gracefully when dsh
is not on PATH). Run DSH_HOME=/tmp/fresh npm test to reproduce the CI
environment in a clean directory.
See CONTRIBUTING.md for commit style, changelog policy, and the release process; see SECURITY.md for reporting vulnerabilities.
MIT © dushaobindoudou