DSH Plugins Marketplace

DSH Plugins

Plugins

/

robot-forge-dsh

y

robot-forge-dsh

Manifest valid

Take a natural language robot aspiration and forge it into a complete project that you can buy, build, run, verify, and deploy. DeepSeek Harness plugin.

hasBundlePatchMachine translated

Robot Forge for DeepSeek Harness

GitHub release CI License: MIT

把一句“我想要一个机器人”变成买得到、造得出、跑得起来、有证据、可发布的完整项目。

GitHub: https://github.com/yry1816186-pixel/robot-forge-dsh · 问题与建议请开 issue,安全漏洞请走私密渠道(见 SECURITY.md)。

Robot Forge 是 DeepSeek Harness 的原生 bundle:12 个模型可见的 rf_* 工具、一个按需加载的 robot-forge 技能、12 类形态配方、两个可跑通的完整蓝本(起点,不是白名单),以及一套用退出码和证据链说话的 Python 门禁。它不是提示词合集:模型说“做完了”不算数,rf_verify、rf_trace、rf_review 和 rf_audit 才算。

面向完全不懂技术的用户:用自然语言许愿即可。插件负责把愿望翻译成形态、预算、BOM、接线、固件、软件、结构、仿真、测试、文档、合规边界和可复现发布包;做不到的部分会明确标成未验证,而不是编造通过。


目录


它解决什么问题

机器人项目最常见的六种失败,不是“不会写代码”,而是:

  1. 幻觉选型:元件不存在、引脚冲突、电压不匹配、买不到。
  2. 假绿:测试没跑、只跑了子集、改了源码还用旧证据,却说“已完成”。
  3. 跳步:没算扭矩就买舵机,没算续航就选电池,装完才发现带不动。
  4. 过设计:零基础用户想要桌面摆件,却生成 Kubernetes + 自研 PCB + 强化学习。
  5. 占位交付:TODO、pass、{{NAME}}、示例数据混进成品。
  6. 自评通过:实现者给自己打分,没有独立复核,也没有可复现证据。

Robot Forge 用四件事封堵:单一事实源 forge/robot.yaml、可执行门禁、四态证据链、独立盲审 + 可复现发布包。


七阶段工作流

阶段做什么工具退出条件
A 接单把自然语言愿望分类到形态,补默认值,识别安全旗标,最多问 3 个带默认值的问题rf_intake形态/预算/域/验收基准明确,或有一个可执行的默认假设
B 定案选最近蓝本,生成项目,写一页方案rf_blueprints → rf_new需求有 must/nice/forbidden,预算和工期可信
C 架构算扭矩、转速、电流、续航、线径、散热、成本;定电源树与接口rf_design无阻断级设计发现;forge/design.md 生成
D 建造硬件/BOM/CAD/固件/软件/仿真/文档,按域推进rf_check0 error;warning 都能解释
E 证明真跑命令,记录 measured/manual 证据,出需求追踪矩阵rf_verify → rf_trace全部 required 退出码 0;must 覆盖率 100%
F 盲审生成可复现盲审包,换一个模型/人独立复核并记录结论rf_review独立 pass、无 blocker、≥70;forge/review.json 与当前构建一致
G 发布六维评分、发布判定、打可复现包rf_audit → rf_packagerelease:0 error + must 100% + ≥85 + 有效盲审 pass≥70;beta:0 error;blocked 不可打包

详细协议见 skills/robot-forge/references/workflow.md;机器规则见 references/spec.md。


12 个工具

所有工具共享统一返回 { ok, text, data }:text 给模型看,data 给程序和 UI 用。都接受可选 project;省略时从会话工作目录向上找 forge/robot.yaml,或找唯一子项目。

工具作用关键约束
rf_intake愿望 → 形态/预算/域/安全旗标/≤3 问题每个问题都带默认值,不阻塞;违法/伤害用途直接拒绝并给安全替代
rf_blueprints列出内置蓝本、预算、工期、难度蓝本不是白名单;无匹配时按配方派生
rf_new从蓝本生成完整项目blueprint 必填;不改 wish 就交付 = 模板抄袭
rf_status一页状态 + 唯一下一步每次开始工作、上下文变长后先跑
rf_check自动 render + 结构/一致性/设计检查0 error 才能继续;warning 要能解释
rf_design扭矩/续航/电流/线径/散热/成本核算,写 forge/design.md选型变了必须重跑;核算不替代实测
rf_verify真跑 forge/verify.yaml,记录证据必需命令 exit 0 才算“实测通过”;只跑子集会明确标 partial
rf_audit六维评分、must 覆盖、发布判定不通过只能标 beta/blocked,不能写“可发布”
rf_trace需求 × 命令 × 证据 × 覆盖矩阵,写 forge/trace.mdmust 覆盖不到 100% 会被发布门拦下
rf_review独立盲审包(复现命令、追踪、证据、机器发现、评审模板)实现者不得给自己出 pass
rf_package打 zip + RELEASE.json + SHA256SUMS有 error 或 blocked 拒绝;未允许 beta 时未验证项拒绝
rf_evidence记录人工/仿真/假设证据只能在人真的确认后写 manual;measured 只能由 verify 产生

12 类形态配方

配方负责“这类机器人通常怎么搭、哪些件不能省、验收看什么”,不是限制形态。没有匹配时用 freeform 按最近配方派生。

配方一句话默认预算关键域安全旗标
wheel-rover两轮/四轮差速避障小车¥300硬件/固件/软件/仿真battery, motion
desktop-companion桌面陪伴:看人、转头、表情、语音¥400硬件/结构/固件/软件/仿真battery, motion, privacy
arm3–6 自由度桌面机械臂¥800硬件/结构/固件/软件/仿真motion
quadruped四足/双足/人形¥8,000+全栈battery, motion, privacy
drone多旋翼(不自研飞控)¥1,500+硬件/固件/软件battery, outdoor
sensor-node环境/土壤/气象传感节点¥150硬件/固件/软件battery, network
differential-drive-mobile-manipulator移动底盘 + 机械臂¥1,800+全栈battery, motion
lawn-mower户外割草/巡检¥3,000+全栈battery, motion, outdoor, children
education-kit教学套件/实验平台¥200硬件/固件/软件/文档battery, children
camera-gimbal云台/视觉跟踪¥500硬件/固件/软件motion, privacy
underwater水下/两栖¥2,500+全栈battery, outdoor
freeform以上都不像的专机按需按需裁剪按实际识别

每类配方含:适合谁、域裁剪、关键件、总线、软件栈、must 需求、验收基准、证据计划、升级路径、十个坑。见 references/archetypes.md。


质量门与六维评分

六道机器门(全过才算 release)

1. rf_check              0 error
2. rf_check --deep       0 error(must 缺证据会升级为 error)
3. rf_verify             全部 required 退出码 0
4. rf_trace              must 覆盖率 100%
5. rf_review             盲审包 + 独立 pass(无 blocker,>=70)
6. rf_audit              0 error + 100% + score ≥ 85

六维评分(总分 100)

维度分值看什么
买得到15BOM 型号、价格、来源、替代料、EOL
造得出20CAD/结构/公差/装配顺序/工具
跑得起来25固件/软件/仿真/引脚/电源/协议
说得清1511 份文档、接线、故障排查、决策记录
证得了15证据等级、覆盖率、过期检测、可复现
安全与许可10九类安全旗标、合规块、许可证兼容

扣分:每个 error −6,每个 warning −1;evidenced 直接按覆盖率折算,避免重复惩罚。判定:

  • release:0 error + must 覆盖 100% + score ≥ 85。
  • beta:0 error,但覆盖或分数未达 release;必须显式标注。
  • blocked:仍有 error,禁止发布。

证据四态

状态含义产生方式
measured命令真跑过,退出码 0只能由 rf_verify 写入
manual人按步骤确认过rf_evidence,必须写清谁/怎么确认
simulated只在仿真/核算里通过rf_evidence,不计入发布覆盖
assumed明确假设,未验证rf_evidence,不计入发布覆盖

改动源码、固件、CAD、仿真、robot.yaml 或 verify.yaml 会让旧证据过期(来源指纹变化),必须重跑;这防止“改完还用旧结果”。


安装

先安装 DeepSeek Harness(本包面向 0.2.x),然后二选一:

Web(推荐):侧栏 Plugins → Install bundle → 选择本目录(含 package.json 和 cordis.patch.yml),安装后启用 robot-forge-dsh 并重启 Harness。

CLI:dsh plugin 只负责把包装进 profile;还要把 robot-forge-dsh 加入 profile package.json 的 dsh.profile.bundles,否则不会加载 patch。

# 1) 从 GitHub Release 的 tarball 安装(推荐,锁定 v2.0.2)
dsh plugin --profile desktop add "https://github.com/yry1816186-pixel/robot-forge-dsh/releases/download/v2.0.2/robot-forge-dsh-2.0.2.tgz"

# 或者从本地目录安装
dsh plugin --profile desktop add "C:/path/to/plugins/robot-forge"

然后编辑 profile 的 package.json,在 dsh.profile.bundles 数组里加入:

"robot-forge-dsh"

如果 profile 已有 node_modules,再在 profile 目录执行 pnpm install 并重启 Harness。

安装后重启 Harness,或在启用 HMR 的 profile 里等配置热加载。确认方式:新会话里应能看到 12 个 rf_* 工具和 robot-forge 技能;输入 /forge 可看当前项目状态。

本包未发布到 npm registry;官方发布渠道是 GitHub Releases。安装会修改你的 profile,先在测试 profile 里试更稳。


快速开始

在 Harness 里直接说:

帮我做一个 300 元以内的桌面陪伴机器人,会转头、会做表情,默认不联网。零基础,两个周末能装完。

模型应该:rf_intake 解析愿望 → rf_blueprints 选起点 → ask_user_question 一次读回(≤3 问)→ rf_new 创建 → 改 forge/robot.yaml → rf_design → rf_check → rf_verify → rf_trace → rf_review → rf_audit → rf_package。

也可以直接调用工具:

{"name":"小豆","blueprint":"desktop-companion","dir":"D:/robot"}

或只用 Python CLI:

python skills/robot-forge/scripts/forge.py intake "能避障、能遥控的小车,预算 300"
python skills/robot-forge/scripts/forge.py new 小满 --blueprint wheel-rover --dir /tmp/xiaoman
cd /tmp/xiaoman
python tools/forge.py design --write
python tools/forge.py check
python tools/forge.py verify
python tools/forge.py trace --write
python tools/forge.py review
python tools/forge.py audit
python tools/forge.py package

能力覆盖矩阵

全栈能力覆盖方式机器可判定
需求澄清intake 12 配方 + 一页方案 + ≤3 问✅ 形态/预算/域/安全旗标
选型与 BOMrobot.yaml 单一事实源 → BOM/采购/替代料✅ 型号占位、预算 115%/150%、来源/EOL
机械与结构CAD 脚本、公差表、装配顺序、STL 检查✅ 域文件、尺寸、零件绑定
电子与接线引脚/总线/电源树/线径/上电顺序✅ GPIO 冲突、保留脚、I2C、总线地址、电流
固件PlatformIO/ESP32 骨架、协议、限位、堵转✅ 编译/单元测试、引脚↔清单、协议 token
主机软件Python 包、协议、模拟链路、pytest✅ 测试数量/断言/假绿
仿真运动学、功率、场景脚本✅ 脚本存在 + 退出码
设计核算扭矩/转速/续航/C-rate/散热/成本✅ DSN-01…11
跨产物一致固件↔清单↔文档↔需求↔证据✅ CST-01…14
测试与证据verify.yaml + 四态证据 + 指纹过期✅ 覆盖率/过期/假绿
安全与合规九类旗标 + docs/07 + compliance/security✅ 触发词 + 块字段
供应链来源、价格日期、EOL、替代料✅ 缺 source/EOL/交期
文档11 份中文文档 + 生成块✅ 章节/标记/链接/语言
发布trace/review/audit/package✅ 六道门 + SHA256
可复现固定引擎、RELEASE.json、SHA256SUMS✅ 哈希清单

两个可跑通蓝本

蓝本形态预算工期域
desktop-companion桌面陪伴:ESP32-S3 + 麦克风 + 喇叭 + 圆屏 + 双舵机 + 触摸/测距¥2642 个周末硬件/结构/固件/软件/仿真
wheel-rover两轮差速避障小车:TB6612 + HC-SR04 + MPU6050 + OLED + 18650 2S¥2612 个周末硬件/固件/软件/仿真(买成品底盘,无 CAD)

两个蓝本都带:可跑的 pytest、固件原生测试、仿真检查脚本、11 份中文文档、forge/ 状态层、BOM/接线/电源生成块、证据四态。wheel-rover 故意删掉 CAD 域,演示另一种形态和“删域”也走同一套契约。

这两个蓝本是起点,不是白名单。 机械臂、四足、无人机、水下等按 12 类配方派生;没有现成完整项目时,插件会明确说“这是派生起点”,不会假装已验证。


结构与编排

index.js + lib/               Host 插件:12 个工具、系统提示、/forge 命令
skills/robot-forge/
  SKILL.md                    按需加载的技能正文(七阶段、12 工具、红线)
  references/                 11 篇参考:spec/workflow/quality/blueprints/stacks/
                              archetypes/design/compliance/testing/release/orchestration
  templates/                  两个完整蓝本
  scripts/forgekit/           Python 引擎:intake/design/consistency/report/render/check/api/cli
cordis.patch.yml              把 Host 插件和 skill-filesystem 挂进 profile
evals/                        12 个行为评测(有/无插件对照)
tests/                        Host 运行时回归 + Python 引擎单测
docs/                         设计说明、贡献指南、验收标准

Python 引擎职责

模块职责
intake.py12 类形态分类、默认值、安全旗标、≤3 问题
design.py扭矩/续航/电流/线径/散热/成本核算,DSN 规则
consistency.py固件↔清单↔协议↔需求↔证据↔供应链,CST 规则
report.pytrace 矩阵、盲审包、发布 zip + SHA256
render.py从 robot.yaml 生成 BOM/接线/电源/图/文档块
check.py结构、占位、链接、语法、块、证据、假绿、语言、许可
api.py工具用 JSON 载荷与“下一步”
cli.py人类 CLI,也是工具后端

DSH 能力利用

Harness 能力Robot Forge 怎么用
原生工具注册12 个 rf_*,带 JSON schema、超时、取消、结构化结果
Agent Skillrobot-forge 按需加载;正文、七阶段、红线和 references 在磁盘
PTC 模式注册工具进入 run_code SDK,可在一个程序里串“生成→核算→检查→验证→打包”
子代理prompts/roles/verifier.md、reviewer.md 做独立只读复核;实现者不自审
人机回环接单用 ask_user_question 一次读回;交付用 present 交 BOM/指南/报告
目标与计划长任务 create_goal,阶段 todo_write
Web插件页标题/描述/图标;失败与未验证项直接出现在工具结果

开发与验证

# 插件结构 + 清单 + 版本锁步 + 11 篇参考 + 两个蓝本
python scripts/validate_plugin.py

# Host 运行时:真实调用 Python 引擎,覆盖 12 个工具
node --test tests/plugin.test.mjs

# Python 引擎单测:intake/design/consistency/report
python -m pytest tests/ -q

# Python 侧:两个蓝本生成 + check + verify
python skills/robot-forge/scripts/forge.py selftest

要求 Python 3.10+。可选:PlatformIO(固件编译)、build123d(CAD 导出)、MuJoCo(场景仿真)、pytest。缺工具不会让 check 失败,但对应验证只能 SKIP/标未验证——这是诚实,不是通过。

CI 矩阵:Ubuntu + Windows × Python 3.11/3.12/3.13 × Node 22/24。发布前跑 docs/acceptance.md 的验收清单。


限制与诚实边界

  • 内置两个可跑通蓝本;其余 10 类是按配方派生的起点,不是现成完整项目。插件会标清哪些验证做过、哪些没做。
  • 不替代真实装配、电气安全审查、法规认证和实机测试;插件只能保证“没做到的部分会暴露”。
  • 价格、型号、版本是 2026-11 的快照;采购前按 docs/01-物料清单.md 复核。
  • rf_evidence 的 manual 仍需要人真正确认;模型可以撒谎,但审计和证据链会把撒谎变成可检查的记录。
  • 高风险形态(载人、飞行、水下、市电、激光、儿童)会先做安全确认与降级;不承诺超预算/超能力的版本。
  • 未在 npm 发布,也未在全部 DSH 版本上回归;按 0.2.x 的 bundle/patch 契约编写。

参与贡献

  • 贡献流程与新增蓝本验收:docs/CONTRIBUTING.md
  • 安全漏洞报告:SECURITY.md
  • 行为准则:CODE_OF_CONDUCT.md
  • 路线图:ROADMAP.md
  • 发布验收清单:docs/acceptance.md

开源供全国技术爱好者使用和检验。欢迎用真实项目“打脸”:提交一个插件生成的失败案例,比一句“很好”更有价值。

许可

MIT。蓝本中的第三方库/工具保留各自许可;生成项目默认 MIT,可自行改。

Comments

Loading…

Similar plugins

dsh-requirement-copilot

by coreyleung-art

Say It For Me (帮我说): turn rough requirement notes into a validated, agent-ready prompt with gaps, bilingual output and a confirmation gate — inside the DeepSeek Harness composer.

Manifest valid

★ 0

MIT

JavaScript

Nov 5, 2026

dsh plugin --profile web add dsh-requirement-copilot

by qkycir-123

Automatically turn successful DeepSeek Harness sessions into reusable, reviewable Agent Skills.

Tools & CapabilitiesManifest valid

★ 109

↓ 442/wk

MIT

TypeScript

Nov 15, 2026

dsh plugin --profile web add dsh-run2skill

by dude1wudv

DeepSeek Harness 插件:一轮结束后预测下一句提示词,ghost text 显示在输入框,Tab 填入;自动模式自驱续跑

Manifest valid

★ 0

MIT

JavaScript

Nov 13, 2026

dsh plugin --profile web add dsh-next-turn

by omdsh-dev

Reproducible Python and R work on DeepSeek Harness, built as plugins.

Tools & CapabilitiesManifest valid

★ 8

↓ 829.3k/wk

MIT

TypeScript

Aug 18, 2026

dsh plugin --profile web add @deepseek-ai/dsh-base

by QLM1234

Natural-language driven, security-gated dynamic assembly plugin for DeepSeek Harness (dsh)

Manifest valid

★ 0

MIT

TypeScript

Aug 24, 2026

dsh plugin --profile web add dsh-plugin-dynamic-assembler

by Tim-ReJet

Durable subagent execution for DeepSeek Harness: a `durable` provider and a model-facing tool that drive pi-durable-subagents, so a crashed delegation converges on its first outcome instead of running twice.

Manifest valid

★ 0

MIT

TypeScript

Oct 14, 2026

dsh plugin --profile web add dsh-plugin-durable-subagent