deepseekplugins

DeepSeek Harness 插件

embedded-workbench

Embedded C/C++ firmware development toolbox — 4 agents, 7 skills covering FreeRTOS, ISR, NVM storage, Keil MDK, ARMCLANG, HardFault, state machines, architecture, and LVGL patterns. Ships a native（英文原文）

工具与能力
跳到安装方式

来源信息

GitHub 仓库
AmethystLuna/embedded-workbench
最近更新
2026年8月22日
分类
工具与能力
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt，让 Agent 读 GitHub 仓库和源码；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求：

1. 这个插件是什么，解决什么问题；
2. 适合哪些用户和典型使用场景；
3. 安装后如何使用，并给出一个最小使用示例；
4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险；
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。

GitHub：https://github.com/AmethystLuna/embedded-workbench
插件名：embedded-workbench
作者：AmethystLuna

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

嵌入式工作台

<p align="center"><a href="README.en-US.md">English</a> · <strong>中文</strong></p>

嵌入式 C/C++ 固件开发工具箱 — 4 个代理、7 个技能，覆盖 FreeRTOS、中断、NVM 存储、Keil MDK（AC5/AC6）、ARMCLANG、HardFault 分析、状态机、架构原则、LVGL 陷阱。

跨平台 — 支持 Claude Code、Codex CLI、Cursor、Kimi CLI、OpenCode、ZCode。基于 Agent Skills 开放标准构建。

组件

代理 (4)

代理说明
architecture-steward只读规划：设计包、模块边界、切片拆分
design-reviewer设计文档事实核查：逐条核验声称与代码库事实
execution-worker计划 → 审批 → 实施循环，含编译验证
quality-coordinator实现审查：Bug 发现、合规检查、结束完整性

技能 (8)

技能说明
embedded-workbench引导技能：工作流、策略、子代理映射、主动建议、跨平台工具映射、文档模板
debug-methodology8 条调试铁律、修复准则、迭代调试案例研究
embedded-firmware-devFreeRTOS、中断、NVM 存储、异步生命周期、边界分析、架构原则、LVGL 陷阱
keil-mdk-buildUV4 CLI、ARM Compiler 5/6、.map 分析、合并打包、构建诊断
c-cpp-devC/C++ 代码生成、风格、内存布局、重构
state-machine-design状态模型、重试、超时、转换门控、实现模式
hardfault-triage处理器异常分类 — 故障寄存器、栈帧、PC 定位源码、根因分类

logicprobe（文档与计划声称核查、逻辑原语验证、对抗性探测）已拆分为独立插件 — 见下方[其他插件推荐](#其他插件推荐)。

> 技能内容大多来自作者个人嵌入式/固件开发工作经验和代码洁癖，按实际工程踩坑与约束沉淀，而非泛泛的模型生成内容。

深度参考

embedded-firmware-dev、debug-methodology、state-machine-design、c-cpp-dev 包含深度参考或代码示例。亮点：12 条架构原则、嵌入式模式（GIF 定时器安全、状态锁存、异步生命周期）、LVGL 陷阱、7 轮迭代调试案例研究、状态机实现模式、嵌入式 C 专项（volatile MMIO、链接器段、ISR 安全路径）。

安装

Marketplace 安装（推荐）

在 ~/.claude/settings.json 中添加 marketplace：

{
  "extraKnownMarketplaces": {
    "embedded-workbench": {
      "source": { "source": "github", "repo": "AmethystLuna/embedded-workbench" }
    }
  }
}

然后通过 CLI 安装：

claude plugin install embedded-workbench@embedded-workbench

手动安装

git clone https://github.com/AmethystLuna/embedded-workbench.git ~/.claude/plugins/dev/embedded-workbench

然后在 ~/.claude/settings.json 中启用：

{
  "enabledPlugins": {
    "embedded-workbench@dev": true
  }
}

DeepSeek Harness (dsh)

原生 dsh 支持以 cordis 插件 bundle 的形式提供，位于仓库根（根 package.json 声明了 dsh.bundle）：

  • 技能遵循 Agent Skills 开放标准，被 dsh 的 skill-filesystem provider 原样发现——零代码。
  • bundle 将首步门禁（1% Rule / Red Flags / Plan Verification Gate）注入每个 agent 会话的第一个模型步骤——是 Claude SessionStart hook 在 dsh 的原生对应物，并注册了模型可见的目录条目（cordis_inspect）。
  • 4 个自定义 agent 有意不移植——dsh 原生 subagent 工具已覆盖并行多 agent 工作。

安装：参见 [.dsh/INSTALL.md](.dsh/INSTALL.md)（四种方式，从纯技能拷贝到 dsh plugin add）。

> DSH 安装注意：包名已使用 scoped 形式 @amethystluna/embedded-workbench。在 web profile 的 package.json 中，依赖键与 dsh.profile.bundles 必须写 @amethystluna/embedded-workbench；否则 dsh 加载器会因找不到 node_modules/@amethystluna/embedded-workbench 而启动失败。

使用

插件在会话首个模型步骤自动注入能力通知（含技能表、1% Rule、Red Flags 强化）。技能按需加载：

  • 说"用 Multi-Agent Workflow"或调用 Skill("embedded-workbench") 加载完整工作流系统
  • 领域技能在任务匹配其 Use when 描述时自动激活——NOT 子句防止误触发（如纯格式化不会加载 c-cpp-dev）
  • Agent 在检测到状态机、行为声称或多模块任务时，主动建议验证、对抗探测和并行子代理
  • 无需手动配置 CLAUDE.md

Codex CLI

本插件同样支持 OpenAI Codex CLI。技能遵循 Agent Skills 标准，跨平台行为一致。代理以 Codex TOML 格式提供于 .codex/agents/。

Codex 安装

# 添加 marketplace
codex plugin marketplace add AmethystLuna/embedded-workbench

# 安装
codex plugin install embedded-workbench

或手动安装：

git clone https://github.com/AmethystLuna/embedded-workbench.git ~/.codex/plugins/embedded-workbench

技能通过 $skill-name 调用（如 $debug-methodology），或由 Codex 根据任务上下文自动匹配。

Cursor

Cursor 2.5+ 内置插件支持。agents/ 中的代理自动发现。

Cursor 安装

# 克隆到 Cursor 插件目录
git clone https://github.com/AmethystLuna/embedded-workbench.git ~/.cursor/plugins/embedded-workbench

或通过 Cursor 插件市场 UI 安装：/add-plugin AmethystLuna/embedded-workbench

Kimi CLI

Kimi CLI 自动从 .claude/skills/ 等标准路径发现技能。.kimi-plugin/plugin.json 为 Kimi 插件管理器注册插件。

Kimi 安装

# 通过 Kimi 插件管理器
/plugins install https://github.com/AmethystLuna/embedded-workbench.git

# 或手动克隆
git clone https://github.com/AmethystLuna/embedded-workbench.git ~/.kimi/plugins/embedded-workbench

技能通过 /skill:<name> 调用（如 /skill:debug-methodology）。

OpenCode

技能从 .claude/skills/ 和 .codex/skills/ 路径自动发现。在 opencode.json 中添加：

{
  "plugin": ["embedded-workbench@git+https://github.com/AmethystLuna/embedded-workbench.git"]
}

或通过 skop 安装（兼容 Claude marketplace 清单）。详见 .opencode/INSTALL.md。

ZCode（智谱 Z.AI）

ZCode 3.0+ 遵循 Agent Skills 标准。无插件商店，手动复制技能到 .zcode/skills/：

git clone https://github.com/AmethystLuna/embedded-workbench.git
cp -r embedded-workbench/skills/* .zcode/skills/

技能通过 $skill-name 调用。ZCode 也自动从 .claude/skills/ 和 .codex/skills/ 发现技能。详见 .zcode/INSTALL.md。

依赖

  • Claude Code v2.1+ / Codex CLI 最新版 / Cursor 2.5+ / Kimi CLI 最新版 / OpenCode 最新版 / ZCode 3.0+
  • DeepSeek Harness (dsh): dev preview — 已实测 mainline 2026-08-14（gate bundle 加载并注入会话成功）
  • 无外部依赖

配置

在 DeepSeek Harness 中，bundle 支持以下配置：

键类型默认值说明
enabledbooleantrue设为 false 可关闭首步 Gate 注入。
gateContentstring内置 gate 文本覆盖注入到首轮模型上下文中的文本。

在 profile 的 cordis.patch.yml 中按 row id 覆盖：

- insert:
    - id: embedded-workbench
      name: '@amethystluna/embedded-workbench'
      config:
        enabled: true
        gateContent: |
          ...

卸载

  • 如果通过 DSH 插件管理器安装，请使用同一管理器从目标 profile 中移除 embedded-workbench。
  • 如果手动复制过 skills/*，请删除复制到 ~/.agents/skills/ 或项目 .dsh/skills/ 下的对应目录。
  • 如果通过 cordis.patch.yml 添加，请删除 profile patch 中 id: embedded-workbench 对应的行，并重启 DSH。

权限与数据

  • 插件运行时只读取包内自带的 skills/ 目录，用于通过 DSH 标准 filesystem skill provider 注册技能。
  • 它会在会话首轮向模型上下文注入配置好的 gate 文本。
  • 它不读取凭据、不发起网络连接，也不会访问 DSH 会话上下文之外的用户数据。
  • 实际使用技能时，模型会像使用其他编码技能一样，按用户指示读取项目文件。

故障排查

  • 技能在 DSH 中不可见：确认 DSH 版本支持 ctx.skills / Agent Skills 发现，并在安装后重启 profile。
  • Gate 未注入：检查 enabled 是否为 false，以及 profile patch 中是否存在 id: embedded-workbench 的行。
  • 插件管理器拒绝安装：确认 @deepseek-ai/* 包声明在 peerDependencies 中，而不是 dependencies。
  • 手动复制后 DSH 仍看不到技能：改用原生 bundle 安装（dsh plugin add "github:AmethystLuna/embedded-workbench"）。

开发

npm install
npm run typecheck
npm run build

运行 DSH 技能注册测试和触发测试：

node tests/dsh-skills-registration.test.mjs
bash tests/skill-triggering/run-all.sh

许可证与安全

本项目使用 MIT 许可证，见 [LICENSE](LICENSE)。

如发现安全漏洞，请不要公开创建 issue，应使用 GitHub Security Advisory 或 [SECURITY.md](SECURITY.md) 中的联系方式私下报告。

其他插件推荐

插件简介
logicprobe文档与计划声称核查——逻辑原语验证（7 结构 + 7 对抗探针）、重构回归检测。自本插件拆分；Plan Verification Gate 依赖它。
superpowers原始 agent 纪律引擎——技能加载强制、Red Flags、子代理驱动开发。本插件的多项 agent 合规模式（1% Rule、Red Flags、<SUBAGENT-STOP>、指令优先级）均借鉴自 Superpowers。

致谢

本插件的 agent 合规架构借鉴自 Jesse Vincent 的 Superpowers（MIT License）。特别感谢以下设计模式的启发：

  • 1% Rule — agent 会抗拒加载技能，需要极端语言突破偏见的关键洞察
  • Red Flags 表 — 枚举 agent 的合理化借口以预先阻断
  • <SUBAGENT-STOP> — 阻止子代理重复加载引导上下文
  • 指令优先级 — 用户 > 技能 > 系统提示的分层架构
  • 技能类型 — Rigid vs Flexible 分类体系
  • 会话启动注入模式 — 在会话启动时注入能力上下文的 hook 机制
  • 触发测试框架 — tests/skill-triggering/ 的结构和方法论

Superpowers 是通用开发插件。Embedded Workbench 将相同的纪律模式应用到嵌入式 C/C++ 领域。

返回搜索打开 GitHub 仓库

更多相关插件

查看分类