面向 Hana 的原生 DSH 插件，以 dshana profile 进程内运行 DeepSeek Harness 任务、自动自举 DSH 依赖与 web host，并通过内嵌的 DSHana 标签页暴露 DSH——无需单独 DSH 进程，也无需管理 API Key。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-09-03
许可证
MPL-2.0
01它能帮你完成什么？
把 DeepSeek Harness 编码 agent 任务作为进程内内嵌子 agent 在 Hana 内运行
DSH 任务会话显示在内嵌的 DSHana 标签页，账本与 dsh-home 锁进插件数据目录
想在 Hana 中跑 DeepSeek Harness 任务、又不想单独启动 DSH 进程或管理 DSH 凭据的 Hana 用户
在 Hana 设置页配置默认 DSH 任务模型并查看随插件锁定的 DSH 版本
DSHana 设置页：含「默认模型」卡片（Provider/模型/思考强度三级联动）与「DSH 版本」卡片
需要设定任务模型、跟踪随插件捆绑的 DSH 版本的 Hana 运营者
02如何接入 DeepSeek Harness？
前置条件
- Hana 宿主应用——把插件 release zip 拖进 Hana 插件安装界面（或解压到插件目录）即可装载。
- 若 macOS 上 Electron 内嵌 node 跑 pnpm 签名校验失败，需自备兼容的 Node.js（设置 `nodejsPath`）；否则用 Electron 自带的 node。
安装步骤
- 01
从 GitHub Releases 下载 release zip `dsh-hanako-v<version>.zip`，拖进 Hana 插件安装界面（或解压到插件目录）——拖入即完成装载。
- 02
无需手动：插件加载（onStartUp）即自动链自举——幂等检查/安装 DSH 依赖（版本漂移才按声明 `pnpm install --prod`，官方源失败自动重试 npmmirror）并自动拉起 DSH web host。
- 03
需要显式安装/验证时，调用 `dsh_install` 工具（action=install 渲染实时 pnpm 日志卡片；action=verify 做静态核对）。
验证接入成功
- 装载后让 Agent 跑一次最小试任务 `dsh_session(action="create", task="…", cwd="<项目沙箱目录>")`；卡片不报 web host 错误即安装成功。
03DSH 适配与能力边界
原生进程内 DSH 运行时，嵌入 Hana 宿主——以 dshana profile 在宿主进程内运行 DSH 任务，无独立 DSH 子进程；DSH 官方 Web UI 以 DSHana 标签页内嵌。
进程内 DSH 内嵌
经 dshana profile 路由的 DSH 任务请求→DSH 任务会话显示在 DSHana 标签页；账本与 dsh-home 锁进插件数据目录
账本与 dsh-home 锁进插件数据目录，DSH 依赖装进插件 node_modules（版本随插件声明）启动即自动自举
插件 onStartUp 事件→幂等安装 DSH 依赖（pnpm install --prod）并自动拉起 DSH web host
自动拉起 DSH web host（依赖装进插件根 node_modules，版本随插件声明）依赖幂等检查/安装（已装且与插件声明版本一致 → 秒过）dsh_session 任务工具
dsh_session(action=create, task, cwd)，可选 provider/model/reasoningEffort→在 DSHana 标签页创建一个 DSH 任务会话
DSHana 设置页
Hana 设置页交互→「默认模型」卡片（Provider/模型/思考强度联动）与「DSH 版本」卡片
04适合谁？何时不该用？
适合
- 想在 Hana 中跑 DeepSeek Harness 任务、又不想单独启动 DSH 进程或管理 DSH 凭据的 Hana 用户
- 需要设定任务模型、跟踪随插件捆绑的 DSH 版本的 Hana 运营者
不适合
- macOS 上 Electron 内嵌 node 跑 pnpm 签名校验可能失败；此时把 `nodejsPath` 设为系统 node 绝对路径（如 /opt/homebrew/bin/node）。路径不存在时显示警告并降级回退到自带 node。
05兼容性、维护与安全提示
- macOS 上 Electron 内嵌 node 跑 pnpm 签名校验可能失败；此时把 `nodejsPath` 设为系统 node 绝对路径（如 /opt/homebrew/bin/node）。路径不存在时显示警告并降级回退到自带 node。
- 随插件捆绑的 DSH 版本严格锁插件声明——更新 DSH 即等于更新插件发版。
MPL-2.0 · 活跃维护中（最新发布 v0.25.0，2026-08-30）
06常见问题
dsh-hanako 如何把 DeepSeek Harness 接进 Hana？
它把 DSH 作为进程内内嵌 agent 嵌入（runProfile 在宿主进程内 boot，因此没有独立的 DSH 子进程）。任务走 dshana profile 运行，DSH 官方 Web UI 以 DSHana 标签页内嵌在 Hana 顶部。
我需要为 DSH 配置 API Key 或模型吗？
不需要——DSH 凭据由 @dsh-hanako/provider 插件直读 Hana 宿主 provider-catalog.json，模型跟随宿主 models.json。默认任务模型即 DSH 默认模型（settings.yaml 的 agent-default-model），可在 DSHana 设置页配置。
我怎么验证安装是否成功？
插件装载后，让 Agent 跑一次最小试任务 dsh_session(action="create", task="…", cwd="<沙箱>")；卡片不报 web host 错误即安装成功。
自动自举失败（例如 macOS 上）会怎样？
DSHana 标签页是三态自举页（booting / action-needed / ready）。失败时按 errorClass 给出人话指引并退避重试；需要用户动作时（如配 nodejsPath、装编译工具链、清理磁盘、dsh 升级后重启宿主）页面暂停并给出明确步骤，完成后自动续跑。
我可以逐任务覆盖模型或 provider 吗？
可以——dsh_session 工具接受 provider / model / reasoningEffort 参数，对单次任务显式覆盖默认值。
07相关的 DSH 工作流
archify
作者 tt-a1i
为编码智能体生成美观可验证的架构图、时序图与数据流图，输出自包含 HTML，支持动效与清晰导出。
openviking
作者 volcengine
为 AI 智能体打造的自进化上下文数据库，统一智能体记忆、知识 RAG 与技能。
nocobase
作者 nocobase
开源的 AI + 无代码应用搭建平台：AI 在久经生产验证的底层基础设施与所见即所得的无代码界面之上工作，帮你快速构建 CRM、ERP 等业务系统，兼顾速度与可靠性。
learn-harness-engineering
作者 walkinglabs
Harness 工程新手教程，从 0 到 1 系统学习智能体工作流框架。
08数据与来源
把 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）接进 Hana，作为**进程内内嵌 agent**（runProfile 在宿主进程内 bo…
任务执行走 **dshana profile**（进程内 boot）
DSH 官方 Web UI 以 **DSHana 标签页**内嵌在 Hana 顶部
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-09-03。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。