A native DSH plugin for Hana that runs DeepSeek Harness tasks in-process (dshana profile), auto-bootstraps DSH deps and web host, and exposes DSH through the embedded DSHana tab — no separate DSH process or API key to manage.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-09-03
License
MPL-2.0
01What can it help you accomplish?
Run DeepSeek Harness coding-agent tasks inside Hana as an in-process subagent
DSH task sessions shown in the embedded DSHana tab, with the ledger and dsh-home scoped to the plugin data directory
Hana users who want DeepSeek Harness tasks without launching a separate DSH process or managing DSH credentials
Configure the default DSH task model and view the bundled DSH version from the Hana settings page
DSHana settings page with a default-model card (Provider/Model/Reasoning three-level linkage) and a DSH-version card
Hana operators who set the task model and track the bundled DSH version
02How to install into DeepSeek Harness
Prerequisites
- Hana host app — load the plugin by dragging its release zip into the Hana plugin install UI (or unzip into the plugins directory).
- A compatible Node.js if macOS Electron’s embedded node fails pnpm signature checks (set `nodejsPath`); otherwise Electron’s bundled node is used.
Installation steps
- 01
Download the release zip `dsh-hanako-v<version>.zip` from GitHub Releases and drag it into the Hana plugin install UI (or unzip into the plugins directory) — the plugin loads on drop.
- 02
No manual steps: on onStartUp the plugin auto-bootstraps — idempotently checks/installs DSH deps (pnpm install --prod on drift; retries npmmirror on official-source failure) and auto-starts the DSH web host.
- 03
For explicit install/verify, call the `dsh_install` tool (action=install renders a live pnpm log card; action=verify does a static check).
Verify the integration
- After load, ask the Agent to run a minimal `dsh_session(action="create", task="…", cwd="<project-sandbox-dir>")` task; if the card reports no web-host error, the install succeeded.
03DSH integration and capability boundaries
Native in-process DSH runtime embedded inside the Hana host — runs DSH tasks under the dshana profile with no separate DSH subprocess; the DSH official Web UI is embedded as the DSHana tab.
In-process DSH embedding
DSH task requests routed through the dshana profile→DSH task sessions visible in the DSHana tab; ledger and dsh-home scoped to the plugin data directory
账本与 dsh-home 锁进插件数据目录,DSH 依赖装进插件 node_modules(版本随插件声明)Auto-bootstrap on startup
Plugin onStartUp event→Idempotent DSH dependency install (pnpm install --prod) and an auto-started DSH web host
自动拉起 DSH web host(依赖装进插件根 node_modules,版本随插件声明)依赖幂等检查/安装(已装且与插件声明版本一致 → 秒过)dsh_session task tool
dsh_session(action=create, task, cwd) with optional provider/model/reasoningEffort→A DSH task session created in the DSHana tab
DSHana settings page
Hana settings page interaction→Default-model card (Provider/Model/Reasoning linkage) and a DSH-version card
04Who is it for? When not to use it?
Good for
- Hana users who want DeepSeek Harness tasks without launching a separate DSH process or managing DSH credentials
- Hana operators who set the task model and track the bundled DSH version
Not for
- On macOS, Electron’s embedded node can fail pnpm signature checks during bootstrap; set `nodejsPath` to a system node absolute path (e.g. /opt/homebrew/bin/node). If the path is missing, a warning is shown and it falls back to bundled node.
05Compatibility, maintenance and safety notes
- On macOS, Electron’s embedded node can fail pnpm signature checks during bootstrap; set `nodejsPath` to a system node absolute path (e.g. /opt/homebrew/bin/node). If the path is missing, a warning is shown and it falls back to bundled node.
- The bundled DSH version is strictly locked to the plugin’s declared version — upgrading DSH means upgrading the plugin release.
MPL-2.0 · actively maintained (latest release v0.25.0, 2026-08-30)
06Frequently asked questions
How does dsh-hanako connect DeepSeek Harness to Hana?
It embeds DSH as an in-process subagent (runProfile boots inside the host process, so there is no separate DSH subprocess). Tasks run under the dshana profile and the DSH official Web UI is shown as the DSHana tab at the top of Hana.
Do I need to configure an API key or model for DSH?
No — DSH credentials are read directly from the Hana host’s provider-catalog.json by the @dsh-hanako/provider plugin, and the model follows the host’s models.json. The default task model is the DSH default (agent-default-model in settings.yaml), configurable in the DSHana settings page.
How do I verify the install worked?
After the plugin loads, ask the Agent to run a minimal dsh_session(action="create", task="…", cwd="<sandbox>") task; if the card shows no web-host error, the install succeeded.
What happens if the auto-bootstrap fails (e.g. on macOS)?
The DSHana tab is a three-state bootstrap page (booting / action-needed / ready). On failure it shows human-readable guidance by errorClass and retries with backoff; when user action is needed (e.g. set nodejsPath, install a toolchain, free disk, restart host after a DSH upgrade) it pauses with clear steps and auto-resumes when done.
Can I override the model or provider per task?
Yes — the dsh_session tool accepts provider / model / reasoningEffort parameters to explicitly override the defaults for a single task.
07Related DSH workflows
archify
by tt-a1i
Agent skill for beautiful, verifiable architecture, workflow, sequence, data-flow, and lifecycle diagrams—self-contained HTML with motion and crisp export.
openviking
by volcengine
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
nocobase
by nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything from scratch, AI works on top of production-proven infrastructure and a WYSIWYG no-code interface, so you get both speed and reliability.
learn-harness-engineering
by walkinglabs
Harness engineering beginner tutorial, from 0 to 1
08Data and sources
把 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)(DSH)接进 Hana,作为**进程内内嵌 agent**(runProfile 在宿主进程内 bo…
任务执行走 **dshana profile**(进程内 boot)
DSH 官方 Web UI 以 **DSHana 标签页**内嵌在 Hana 顶部
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-09-03. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.
