前言¶
DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。dsh-plugin-garmin 是一个针对 Garmin Fenix 7 设备开发的领域专用插件。它允许开发者通过自然语言对话来生成表盘设计，并在本地进行矢量仿真预览与 Monkey C 源码编译，最终输出可安装的二进制文件。
核心功能¶
该插件提供了以下能力：
* 对话式表盘生成：通过自然语言描述需求，由 Agent 自动生成表盘设计。
* 硬件合规守护：内置 MIP 64 色硬件调色板映射，确保生成的表盘符合 Fenix 7 的显示限制。
* 矢量仿真预览：提供高保真的 260×260 矢量模拟器，支持动态预览与夜间模式。
* 动态源码生成：根据设计规范自动生成生产级的 Monkey C 源码工程。
* 免交互密钥签发：在无头环境下自动生成 Garmin 所需的开发者私钥。
* 一键编译与环境诊断：集成编译工具链，支持直接输出 .prg 固件及环境检查。
安装与启用¶
目前该插件仅支持源码安装，暂未发布 npm 包。安装过程包含本地编译与挂载到 DSH 两个步骤。
1、克隆仓库并编译源码
git clone https://github.com/RayzPub/dsh-plugin-garmin.git
cd dsh-plugin-garmin
npm install
npm run build
2、挂载进 DeepSeek Harness
dsh plugin --profile web add .
（如需在命令行模式使用，请将 --profile web 改为 --profile headless）
典型用法¶
安装完成后，可通过 Web 界面或 Headless 命令行与 Agent 协作。
1、在 Web 界面中交互
启动 Web 服务：
dsh web
在浏览器打开交互界面后，可以直接输入自然语言指令，例如：“生成一款战术风表盘，带橙色指针、心率弧环与电量进度条”。
2、在命令行中查询与诊断
# 查询硬件规格
dsh --profile headless "调用 garmin_specs 工具查询 Fenix 7 的硬件规格"
# 检查编译环境
dsh --profile headless "检查当前系统是否已安装 Garmin Connect IQ SDK、Java 运行环境与开发者私钥"
适用场景与注意事项¶
- 适用场景：适合需要快速迭代 Garmin 表盘设计的开发者，以及希望利用 AI 辅助生成 Monkey C 代码的自动化工作流。
- 环境要求：Linux 环境需要预装 Java、OpenSSL 和 monkeyc 编译器。
- 注意事项：该插件非官方项目，与 Garmin Ltd 无官方合作。需注意仅支持源码安装，npm 包尚未发布。项目采用 MIT License。
结语¶
dsh-plugin-garmin 是 DeepSeek Harness 生态中针对硬件开发的一个典型应用。通过自然语言将复杂的表盘设计与编译流程标准化，降低了 Garmin 开发的门槛。更多详情可查阅 GitHub 仓库。
