返回目录

dsh-harmony

精选清单收录维护状态: 活跃

stlin256/dsh-harmony

DeepSeek Harness 的 HarmonyOS 原生客户端(ArkUI/ArkTS):会话、工具调用、审批、文件预览、Passkey、鸿蒙通知与桌面服务卡片。Native ArkUI client for DeepSeek Harness. 早期版本,需自建 DSH 服务。

前往 GitHub项目主页
$ dsh plugin add dsh-harmony

22

星标

1

Fork

TypeScript

语言

AGPL-3.0

许可证

2026-10-28

创建于

2026-11-09

最近推送

AGPL-3.0 的 HarmonyOS 原生客户端:在自己搭建的 DSH 服务之上提供移动端 ArkUI 工作区,支持单次审批、只读文件预览与分级通知。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-11-15

许可证

AGPL-3.0

01它能帮你完成什么?

  • 在 HarmonyOS 手机或平板上直接使用 DeepSeek Harness 工作区

    单一原生 ArkUI 工作空间:会话、工具调用、实时输出、浮动任务计划与只读文件预览

    自建 DSH 服务、希望在手机上拥有原生前端而不是浏览器的开发者

  • 在手机上对高风险工具调用做单次审批,同时不放开会话权限

    允许一次、拒绝与风险确认三种状态,明确展示影响范围,且只对当前这次工具调用生效

    离开工位后仍需要盯住长任务的 Agent 使用者

  • DSH 任务完成、失败或等待确认时及时收到提醒

    按级别发送的 HarmonyOS 通知(点开回到对应会话),以及呈现工作区与任务状态的桌面服务卡片;社区构建支持 Push Kit 即时推送

    跑定时或无人值守 DSH 任务、不总盯着屏幕的用户

02如何接入 DeepSeek Harness?

前置条件

  • HarmonyOS 7 / API 23+ 的 ARM64 手机或平板——README 为社区版 HAP 列出的唯一目标平台
  • 设备已开启开发者模式与 USB 调试,安装用的电脑上有 DevEco Studio 或 HarmonyOS SDK 自带的 `hdc`
  • 自备 DevEco Studio 签名证书与 Profile,或选择从源码构建——社区版 HAP 使用维护者本机的签名证书
  • 手机可访问的 DSH 服务地址(局域网或公网),且 DSH 中已安装 `@dsh-harmony/plugin`
  • 若要使用 Passkey 登录,需要 HTTPS 环境

安装步骤

  1. 01

    从 GitHub Releases 下载最新的社区版 HAP:`DSH-Harmony-<版本>-community-arm64.hap`

  2. 02

    用你自己的 DevEco Studio 证书与 Profile 重新签名,或按 `docs/DEPLOYMENT.md` 从源码构建,否则设备可能提示签名不受信任(错误码 9568322)

  3. 03

    在设备上用 `hdc install -r .\DSH-Harmony-<版本>-community-arm64.hap` 安装

  4. 04

    安装 DSH 插件:把 README 给出的安装指令发给支持 `plugin_manager` 的 Agent,由它安装 `@dsh-harmony/plugin` 并核对版本;也可以打开 DSH 的「插件 → Add plugin」,粘贴同一版本化 tarball 地址——README 指向与 App 匹配的 `plugin-v0.4.0` Release 中的 `dsh-harmony-plugin-0.4.0.tgz`

  5. 05

    打开 DSH Harmony,填写 DSH 服务地址并选择原生登录或 Passkey

验证接入成功

  • README 给出的安装指令要求 Agent 在安装后确认 `@dsh-harmony/plugin` 正常运行并报告版本

03DSH 适配与能力边界

DSH 适配原生运行时

HarmonyOS 原生(ArkUI/ArkTS)客户端 + DSH 插件:DSH 通过支持 `plugin_manager` 的 Agent 或「插件 → Add plugin」安装 `@dsh-harmony/plugin`,App 填写 DSH 服务地址后用原生登录或 Passkey 连接

  • 原生 ArkUI 工作空间

    DSH 服务地址,以及原生登录凭据或系统 Passkey→会话、工具调用、实时输出、浮动任务计划与工作区文件预览集中在同一个原生界面

    在本机记住上次会话、工作区、滚动位置与展开状态
  • 单次审批边界

    等待确认的高风险工具调用→允许一次、拒绝或风险确认,作用范围仅限当前这次工具调用

    单次授权不会改变会话权限
  • 只读文件预览

    工作区里的配置文件、表格、Markdown、代码与图片→在 App 内直接阅读这些文件

    预览全程只读,不会写回工作区
  • 分级通知与桌面服务卡片

    任务完成、失败或等待确认的事件→按级别发送的 HarmonyOS 通知,点击回到对应会话;桌面服务卡片紧凑呈现工作区与任务状态

    社区构建通过 Push Kit 下发即时推送
  • 自动化任务与已装能力管理

    按日 / 按周重复的定时任务与已安装能力→在同一处集中管理每日巡检、每周整理这类任务,并启用或管理插件

04适合谁?何时不该用?

适合

  • 自建 DSH 服务、希望在手机上拥有原生前端而不是浏览器的开发者
  • 离开工位后仍需要盯住长任务的 Agent 使用者
  • 跑定时或无人值守 DSH 任务、不总盯着屏幕的用户

不适合

  • 社区版 HAP 只面向 HarmonyOS 7 / API 23+ 的 ARM64 手机与平板,README 没有列出其他平台。
  • 社区版 HAP 使用维护者本机的签名证书。在自己的设备上安装,需要用你自己的 DevEco Studio 证书与 Profile 重新签名,或从源码构建,否则设备可能提示签名不受信任(错误码 9568322);AppGallery 版本仍在准备中。
  • App 连接的是你自己填写的 DSH 服务地址:默认的 Harness 原生登录可连局域网或公网地址;Pocket ID · Passkey 为可选方式,需要 HTTPS 环境。

05兼容性、维护与安全提示

  • 社区版 HAP 只面向 HarmonyOS 7 / API 23+ 的 ARM64 手机与平板,README 没有列出其他平台。
  • 社区版 HAP 使用维护者本机的签名证书。在自己的设备上安装,需要用你自己的 DevEco Studio 证书与 Profile 重新签名,或从源码构建,否则设备可能提示签名不受信任(错误码 9568322);AppGallery 版本仍在准备中。
  • App 连接的是你自己填写的 DSH 服务地址:默认的 Harness 原生登录可连局域网或公网地址;Pocket ID · Passkey 为可选方式,需要 HTTPS 环境。
2026-10-282026-11-09v0.4.10

AGPL-3.0 · 最新发布 v0.4.10(2026-11-07);README 记录的配套插件构建为 plugin-v0.4.0,AppGallery 版本仍在准备中

06常见问题

App 需要的 DSH 插件怎么装?

App 连接 DSH 前需要 `@dsh-harmony/plugin`。把 README 给出的安装指令发给 DSH,支持 `plugin_manager` 的 Agent 会完成安装并核对版本;也可以打开 DSH 的「插件 → Add plugin」,粘贴同一版本化 tarball 地址——README 指向与 App 匹配的 `plugin-v0.4.0` Release 中的 `dsh-harmony-plugin-0.4.0.tgz`。

装 HAP 之前一定要重新签名吗?

要。Releases 里的社区版 HAP 使用维护者本机的签名证书,装到自己设备上需要用你自己的 DevEco Studio 证书与 Profile 重新签名,或按 `docs/DEPLOYMENT.md` 从源码构建;否则设备可能提示签名不受信任(错误码 9568322)。

支持哪些设备和 HarmonyOS 版本?

README 为社区版 HAP 列出的是 HarmonyOS 7 / API 23+ 的 ARM64 手机与平板,并要求安装用的设备已开启开发者模式与 USB 调试,电脑上可用 DevEco Studio 或 HarmonyOS SDK 自带的 `hdc`。

能不能连局域网里的 DSH 服务,必须公网地址吗?

两种都行:默认的 Harness 原生登录可连接局域网或公网地址,地址在 App 启动时自行填写。Pocket ID · Passkey 是可选方式,在 HTTPS 环境中使用系统 Passkey。

App 会改动我的工作区文件吗?

App 内的文件预览是只读的:配置文件、表格、Markdown、代码和图片都可以直接阅读,README 写明预览全程只读。工作区本身的读写仍由 DSH 的工具调用执行,其中单次授权只放行当前工具调用,不会改变会话权限。

08数据与来源

  • 作者声明github.com28a079caf309…

    App 需要 `@dsh-harmony/plugin` 才能连接 DSH。把下面这一句发给 DSH,支持 `plugin_manager` 的 Agent 会完成插件安装并核对版本:

  • 作者声明github.com28a079caf309…

    也可以打开 DSH 的 **插件 → Add plugin**,粘贴同一版本化 tarball 地址。

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-15。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。