ziouf/omarchy-dsh-agent

omarchy-dsh-agent

DeepSeek Harness（dsh，DeepSeek 官方编码代理）作为一等 Omarchy 代理——以 Web 为先，完全在用户空间中运行，不触碰 /usr/share/omarchy/ 下的任何内容。

omarchy plugin add https://github.com/ziouf/omarchy-dsh-agent.git --enable

功能

- 后台服务——为整个桌面运行 dsh web，如果退出则自动重启。实例报告的 URL 会被捕获，因此即使使用自定义端口也能打开正确的地址。
- Web 应用——安装一个“DeepSeek Harness”启动器（可通过 dsh 搜索），它会在自己的应用窗口中打开 UI，并聚焦该窗口，而不是堆叠重复窗口。当 Exec 路径不再能解析时（例如在不同 id 下重新安装插件后），服务会在 shell 启动时重新创建启动器。
- 标记——assets/dsh.svg（浅色调，用于深色界面）和 assets/dsh-light.svg（深色调，用于浅色界面）是单色鲸鱼字形，没有品牌色，遵循 Agents 面板的 -light 孪生约定。
- Agents 面板——每 15 分钟重新生成 dsh.json 使用记录，因此 Omarchy 的 Agents 栏面板会获得一个 DSH 标签页：DeepSeek 预付余额（remaining / funded / spent）以及从 $DSH_HOME（默认 ~/.dsh）会话日志中尽力扫描得到的本地 token 统计。

DeepSeek 的 API 是预付费的，因此与 Fireworks 一样，该标签页显示的是信用余额，而不是速率限制计量。dsh 本身是开发者预览版；无法识别的会话格式会被跳过，而不是进行猜测。

技能插件

捆绑的技能能力系列随 dsh 一起提供，但默认部分禁用。要运行完整集合（磁盘上的技能、工作区指令文件、面向模型的技能工具），请将以下内容追加到 ~/.dsh/profiles/web/cordis.patch.yml：

- id: agent-instructions
disabled: false
- id: skill-filesystem
disabled: false
- id: tool-skill
disabled: false

然后重启 Web UI（重启 Omarchy 即可——此服务会在应用补丁后重新启动 dsh）。

升级 dsh

更新插件永远不会触碰已安装的 dsh 包——scripts/lib.sh 中的版本固定仅用于全新安装。在插件更新提升了版本固定后，请对齐二进制文件：

~/.config/omarchy/plugins/ziouf.dsh/scripts/upgrade-dsh

当已安装版本已经匹配时，它是无操作；否则安装固定版本（优先使用 mise，回退到 npm），终止 Web 服务器以便服务看门狗在新构建上将其重新启动，并通知版本变更。

要求

- Omarchy（Quattro 或更新版本）
- 通过 mise 提供 Node.js >= 24（Omarchy 自带）
- 用于余额显示的 DeepSeek API 密钥——没有密钥时，标签页会显示“Waiting for auth”，并且仅显示本地统计。将 DEEPSEEK_API_KEY=... 放入你的环境或 ~/.dsh/.env 中。在  获取密钥。

可选接线
服务和应用启动器开箱即用。两个片段让 dsh 融入 Omarchy 的其余部分：

默认代理菜单项 — 追加到
~/.config/omarchy/extensions/omarchy-menu.jsonc：

"setup.default.agent.dsh": {
"appIcon": "~/.config/omarchy/plugins/ziouf.dsh/assets/dsh.svg",
"label": "DeepSeek Harness",
"when": "omarchy-cmd-present dsh",
"checked": "[[ \"$(omarchy-default-agent)\" == \"dsh\" ]]",
"action": "$HOME/.config/omarchy/plugins/ziouf.dsh/scripts/set-default"
}

appIcon 图像渲染是一个本地扩展：原版菜单只为静态行绘制字体字形。它来自一个克隆的菜单插件
（omarchy plugin clone omarchy.menu，然后教会它的 MenuModel.js 解析
appIcon，并让它的委托渲染该文件，在浅色表面上选择 -light 孪生版本）。没有该克隆，菜单项仍然可用 — 将 appIcon
替换为你选择的 "icon" 字体字形即可。

键位绑定 — Omarchy 的代理键位绑定（Super+Shift+Ctrl+A）只知道
内置代理。要让它通过此插件路由（当 dsh 为默认时启动 dsh 的 web
应用，否则转发到 omarchy-agent），编辑
~/.config/hypr/bindings.lua：

hl.unbind("SUPER + SHIFT + CTRL + A")
o.bind("SUPER + SHIFT + CTRL + A", "Agent",
"$HOME/.config/omarchy/plugins/ziouf.dsh/scripts/launch-agent --pick")

然后通过菜单项将 dsh 设为默认一次（或直接运行
scripts/set-default），这也会在需要时安装 dsh。

它触及的文件

| 路径 | 原因 |
|---|---|
| ~/.local/state/omarchy/dsh/web-url | 实时实例 URL |
| ~/.local/state/omarchy/agents/usage/dsh.json | 由 Agents 面板读取的使用记录 |
| ~/.cache/omarchy/agent-usage/dsh-balance.json | 余额探测缓存（15 分钟） |
| ~/.local/share/applications/DeepSeek Harness.desktop | Web 应用启动器 |

移除（也记录在 manifest.json 的 uninstall 下）：

omarchy plugin remove ziouf.dsh
omarchy-webapp-remove "DeepSeek Harness"
rm -f ~/.local/state/omarchy/dsh/web-url \
~/.local/state/omarchy/agents/usage/dsh.json \
~/.cache/omarchy/agent-usage/dsh-balance.json
optional: pick another default agent, restore the stock keybinding, and drop
the setup.default.agent.dsh menu entry — see manifest.json > uninstall.optional

许可证

MIT