dsh-omarchy-agent：把 DeepSeek Harness 接入 Omarchy 默认智能体体系

它是做什么的？

Omarchy Agent 是 DeepSeek Harness（DSH）的桌面集成插件，把 dsh 变成懂 Omarchy（Arch Linux + Hyprland）的通用智能体。它解决的是 dsh 与 Omarchy 默认智能体体系互不相通的问题，让你在 omarchy agent、Agent 快捷键和选择器里都能直接打开 dsh 终端界面。插件由 yorelog 维护，采用 MIT 协议，核心能力包括 Omarchy 专用工具集、系统文件安全守卫、Omarchy General 智能体预设，以及一条命令完成的桌面集成。

核心功能

• Omarchy 工具集：提供状态、目录、主题、Hyprland 与诊断五类工具，可读取发行版构建、主题、显示器、工作区、活动窗口、失败单元，并支持切换主题与重载配置。
• 安全守卫：在工具执行前拦截对 /usr/share/omarchy 的写入，并对特权或会改动系统的 shell 命令请求确认。
• Omarchy General 预设：内置一个具备 Omarchy 认知的通用编码智能体人格，配合系统提示约定优先使用 Omarchy 工具、改动前先读取、用户改动保留在 ~/.config。
• 桌面集成：把 dsh 接入 Omarchy 的默认智能体系统，注册选择器条目、设置默认智能体，并接管 a 别名与 Agent 快捷键。
• 多档运行方式：同时准备 web、headless 与 tui 三套 profile，浏览器界面只差一个 --web 参数。

怎么使用这个插件？

在 DSH 中启用后，先配置好 DeepSeek 密钥，再通过启动器打开 dsh 终端界面即可开始对话。按 SUPER + SHIFT + CTRL + A 或从 Omarchy 菜单召唤选择器并选中 DeepSeek Harness，也能进入同一界面；需要浏览器界面时加 --web，需要一次性提示时用 --prompt，还可以用 --pick 打开选择器或把默认智能体切回其他选项。安装过程会检查 dsh 与 pnpm 等前置依赖，创建各档 profile 并安装启动器与 shim，每一步都幂等且可单独关闭；想先看改动可以要求预演模式，卸载则按官方说明在插件目录执行卸载脚本后再移除插件。

报错怎么排查？

集成未生效时，先确认 Omarchy 插件服务是否已检测到缺失的智能体集成并完成安装，其日志写在 ~/.local/state/dsh-omarchy-agent/install.log，完成后会发送通知，且后续 shell 启动不会重复执行。若某一步不需要，可用 --no-default、--no-menu、--no-alias、--no-keybind、--no-headless、--no-tui、--no-shim 分别关闭对应步骤后重跑。