dsh-hanako

DSHana

Hana App ID：dshana

把 DeepSeek Harness 接入 HanaAgent，作为受管子代理执行器：App 加载后拉起一个受管 Node runtime（ctx.runtime.start），DSH web 服务跑在里面；DSH 前端以同文档注入方式挂进 DSHana 卡。DSH 及其依赖树随包分发，运行时不需要安装任何东西。

安装

人类版

1. 拖入 zip 包：把发行包 zip（dshana-v.zip，从 GitHub Releases 下载）拖进 HanaAgent 的 App 安装界面；批准安装审阅卡上的权限（共 12 项：模型推理、子代理与任务、角色卡读取、会话读取、资源读取、运行时执行 / 本机运行 / 联网、剪贴板写入、打开外部；其中本机运行档位无文件系统隔离，审阅卡会如实标注）。
2. 打开 DSHana 卡：App 加载后自动拉起受管 runtime，卡上按三态渲染：未启动 / 启动中 / 就绪（装载 DSH Web UI）。失败会进入「需要处理」态，卡上给出原因与原始错误；打开本卡会补一次启动请求，之后由自动退避重试兜着，端口占用会自动换端口。

Agent 版

取件、核验与安装的完整流程见 dshana-install-skill/SKILL.md。

设置

App 级设置由 App 自绘设置页承载，在宿主设置区渲染，不依赖 DSH 运行；页面分「常规」「会话模型」「主题」三节：

项 · 默认 · 说明 审批超时 · 30 · 常规；单位秒，无人应答即自动拒绝，填 0 禁用 任务超时 · 1800 · 常规；单位秒，单次任务超时，填 0 按缺省 1800 兜底 会话模型 · 复用调用方 · 工具建的新会话用哪个模型：复用调用方 = 用发起这次调用的会话当前在用的那条（含推理强度）；自定义模型 = 固定用下面选的那条 模型 · （空） · 选「自定义模型」时出现；候选列宿主目录里的 provider 与模型 推理强度 · 留空 · 选「自定义模型」时出现，该模型支持的档位；留空沿用 DSH 当前设置 强制跟随宿主主题的面 · 仅侧栏 · 主题；勾上的面恒跟随宿主配色且覆盖带 !important，不勾的只在 DSH 偏好为 system 时跟随并让位给插件请求

DSH 数据固定落在 App 内置独立目录，开箱即用；共享或切换已有 DSH 目录暂不提供。

无需配置 API Key / 模型：推理经受管 runtime 内宿主 ctx.models 发起，provider 凭据不进 DSH 进程。DSH 自己那格默认模型（settings 段 agent-default-model）由 DSH 自己与对账维护，App 设置页不经手；dshana 的 provider / model / reasoningEffort 参数可显式覆盖单次任务。

主题

DSH 主题偏好为 system 时跟随宿主配色，宿主切主题后已打开的页面实时跟随；在 DSH 内显式选 light/dark 时完全用 DSH Web UI 自己的主题。

例外是强制跟随宿主主题的面（设置页「主题」节，逐面一个开关，缺省只勾侧栏）：这一面恒跟随宿主，无视 DSH 自己的明暗偏好，且覆盖带 !important，插件改写不了它。缺省只勾侧栏，是因为它整幅嵌在宿主框架里、四周都是宿主色。改完设置即时生效，不必重启。

排错

把现象丢给 Agent 即可（技能 dshana 里有按三态组织的排错表）。也可以直接看：

• 卡上状态与原始错误（需要处理 态会展开）
• 宿主日志面：本 App 的日志一律走 ctx.logger（不另写文件日志），DSH 子进程的 stdout/stderr 由宿主受管 runtime 捕获

License

This project is licensed under the Mozilla Public License 2.0. See the LICENSE file for details.

This Source Code Form is "Incompatible With Secondary Licenses", as defined by the Mozilla Public License, v. 2.0.