D-Robotics/dsh-plugin-rdk

D-Robotics RDK · DeepSeek Harness
原生技能目录、模型工具、工作区集成的 RDK 生态适配插件。
English ·
安装 ·
工具 ·
配置 ·
dsh-plugin 生态

概述

dsh-plugin-rdk 是一个 DeepSeek Harness bundle 插件，将 D-Robotics RDK 技能生态原生接入 harness。它把五个内置技能包注册进 harness 技能注册表，提供浏览目录和检测硬件的模型工具，并且能以与官方仓库完全一致的 setup.sh 流程将 OpenExplorer（OE）工具链包安装到项目工作区。

五个技能包（各包的精确来源与 commit 见 skills/manifest.json）：

| 包 | 数量 | 内容 |
| --- | --- | --- |
| rdk-device-skills | 26 | 板端诊断、摄像头、模型部署、GPIO、TROS、无头模式、内存审计、日志取证、LLM、具身智能等 |
| bsp-skills | 8 | Host 侧 BSP 开发：交叉编译、repo 同步、内核/DTB/驱动构建、deb 打包、bootloader、rootfs 定制 |
| oe-skills-x5 | 22 | X5 OE Mapper 量化（PTQ/QAT）、编译、Runtime 推理、性能与精度诊断 |
| oe-skills-s | 20 | S 系列 HBDK 编译、UCP 推理、Perfetto trace 分析、plugin 链调试、精度调优 |
| rdk-skills（Hub） | 1 | d-robotics-pack-installer 技能；Hub 对其他包的镜像被跳过，由专用源替代 |

去重顺序：设备包 → BSP → 专用 OE 包 → Hub 最后。外部 skillsDirs 最先扫描，覆盖所有同名技能。

安装

从 npm registry 安装（发布后可用）
dsh plugin --profile rdk add dsh-plugin-rdk

或直接从本仓库安装（npm 尚未发布时可用）
dsh plugin --profile rdk add github:D-Robotics/dsh-plugin-rdk

或从本地检出安装
dsh plugin --profile rdk add file:/path/to/dsh-plugin-rdk

dsh --profile rdk

装好后直接对话：

有哪些 RDK 技能可以用？
(rdk_skills)  77 个技能，5 个包。26 设备、8 BSP、22 X5、20 S、1 Hub。

诊断一下 X5 板为什么发烫
(加载 rdk-diagnostic)  运行 snapshot.sh —— CPU 46°C, BPU 48°C, BPU core 0 37%...

这台机器是 RDK 板吗？
(rdk_board_detect)  是的：rdk-x5 / sunrise-5 / bayes-e / 4 GB。

架构

flowchart LR
A["rdk-device-skills26 技能"] --> P["rdk-skills Provider"]
B["bsp-skills8 技能"] --> P
C["oe-skills-x522 技能"] --> P
D["oe-skills-s20 技能"] --> P
E["rdk-skills (Hub)1 个 Hub 原生技能"] --> P
F["config.skillsDirs外部目录"] --> P
P --> R["Harness 技能注册表"]
R --> S["内置 skill 工具（按需加载技能正文）"]
P --> T["rdk_skills 工具（目录/搜索）"]
G["detect_rdk.sh"] --> U["rdk_board_detect"]
H["OE 包 setup.sh"] --> V["rdk_oe_setup（工作区安装器）"]

- 懒加载：注册表仅存名字和描述用于路由；技能正文在模型真正加载时才从磁盘读取。
- 不编造数据：板卡检测在非 RDK 主机上返回 { detected: false, reason }。

工具

rdk_skills

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| query | string（可选） | 精确技能名返回详情（路径、脚本、标签）；关键词按名称、描述、标签搜索 |
| refresh | bool（可选） | 强制重新扫描配置目录（默认用缓存索引） |

rdk_skills { query: "diagnostic" }
matched: 7 / total: 77
rdk-diagnostic, rdk-log-forensics, rdk-docs-reference,
x5-accuracy-diagnostics, x5-consistency-diagnostics,
x5-model-diagnostics, x5-performance-diagnostics

rdk_board_detect

rdk_board_detect {}
→ { detected: true, board: "rdk-x5", soc: "sunrise-5",
bpuArch: "bayes-e", memGb: 4, osVersion: "3.0.0" }
非 RDK 主机：
→ { detected: false, reason: "not-an-rdk-host: ..." }

rdk_oe_setup

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| pack | string | oe-skills-x5 或 oe-skills-s |
| projectRoot | string | 要初始化的项目工作区绝对路径 |
| source | string（可选） | Git URL 或本地 checkout 路径；默认使用官方仓库 |

此工具运行的是与上游仓库完全相同的 setup.sh。对于 oe-skills-x5，它铺设 .drobotics/ 并将 # X5 Workspace Rules 路由块注入工作区 CLAUDE.md（DeepSeek Harness 会读取）。对于 oe-skills-s，它铺设 .horizon/ 并注入 Horizon 路由规则。结果与手动 git clone + bash setup.sh 完全一致。

rdk_oe_setup { pack: "oe-skills-x5", projectRoot: "/home/user/my-project" }
→ { ok: true, exitCode: 0, verified: { workspaceDir: ".drobotics",
version: "3.2.0", skills: 22 } }

工作区集成（OE 包）

OE 包（oe-skills-x5 和 oe-skills-s）是工作区集成的：它们的技能依赖 setup.sh 创建的 .drobotics/ 和 .horizon/ 目录中的共享状态。插件支持两种模式：

- 目录模式（默认）：内置的 SKILL.md 文件注册为原生技能。Agent 可以读取指令和脚本，但依赖工作区状态的技能（环境检测、包安装）会报告缺失，引导用户通过 rdk_oe_setup 完成安装。
- 工作区模式：每个包运行一次 rdk_oe_setup，铺设完整工作区——共享资源、脚本、平台配置和路由规则。之后 OE 技能与上游流程完全一致。

路由通过两个互相加强的独立机制工作：

1. 路由技能（x5-router、horizon-router）已注册在 harness 目录中。Agent 加载后按内部路由表（references/ 中）分发到正确的子技能。
2. setup.sh 注入的 路由规则写入 CLAUDE.md，DeepSeek Harness 将其作为工作区指令读取，对该工作区的所有会话生效。

配置

在 profile 的 cordis.patch.yml 中覆盖默认值：

- insert:
- id: rdk-skills
name: dsh-plugin-rdk
config:
skillsDirs: []        # 额外目录，最先扫描（同名覆盖内置）
includeOe: true       # 是否包含 oe-skills-x5 / oe-skills-s 包
detectScript: null    # 自定义板卡检测脚本
oeX5Source: null      # oe-skills-x5 的自定义安装源
oeSSource: null       # oe-skills-s 的自定义安装源

| 字段 | 类型 | 默认 | |
| --- | --- | --- | --- |
| skillsDirs | string[] | [] | 存放 SKILL.md 技能目录的外部目录列表 |
| includeOe | boolean | true | false 时去掉 OE 包及其在 Hub 中的镜像 |
| detectScript | string | — | rdk_board_detect 执行的检测脚本 |
| oeX5Source | string | — | rdk_oe_setup 安装 oe-skills-x5 时的自定义源 |
| oeSSource | string | — | rdk_oe_setup 安装 oe-skills-s 时的自定义源 |

保持技能最新

内置技能是普通文件副本，插件离线可用。要同步上游变化：

npm run sync

通过环境变量覆盖来源（路径或 git URL）：

OE_X5_SKILLS_SOURCE=https://github.com/D-Robotics/oe-skills-x5.git \
OE_S_SKILLS_SOURCE=https://github.com/D-Robotics/oe-skills-s.git \
npm run sync

GitHub Action 每周检查上游变化并自动开 PR。同步记录（skills/manifest.json）保存每个包的来源和 commit。新增技能包无需改动代码：skills/ 下的每个目录自动被当作技能包扫描。

开发

npm install
npm run build    # tsc → dist/
npm test         # 构建 + 11 个单测
npm run sync     # 刷新内置技能

dsh-plugin-rdk/
├── cordis.patch.yml        # bundle 补丁层
├── src/                    # provider / 工具 / frontmatter / 检测 / OE 安装
├── skills/                 # 内置技能包（sync 产物）
├── scripts/sync-skills.mjs
└── .github/workflows/      # 测试 + 每周同步

许可证

插件代码：Apache-2.0（LICENSE）。内置技能内容：Apache-2.0 AND CC-BY-4.0，© D-Robotics。详见 NOTICE.md 及各包的 LICENSE* 文件。本项目不是 D-Robotics 官方产品。

链接

- D-Robotics/rdk-skills — 官方技能 Hub（含 .dsh-plugin/marketplace.json 入口）
- GitHub topic: dsh-plugin
- DeepSeek Harness 插件开发文档