Repository navigation
Releases
robot-forge v2.0.2
Robot Forge v2.0.2 发布报告
- 版本:2.0.2
- 日期:2026-11-11
- 状态:补丁发布(Patch Release),修复公开 CI 的环境可移植性
- 适用宿主:DeepSeek Harness(DSH)0.2.x
- 许可证:MIT
1. 摘要
v2.0.2 不改变任何生成项目的契约、12 个工具、评分规则、参考手册或蓝本。它只修复插件自身在干净 CI 环境中的两个可移植性缺陷:
- Windows runner 的 cp1252 控制台无法打印校验器的中文状态行,导致 6 个 Windows job 在 Validate bundle 步骤直接抛
UnicodeEncodeError。 - Ubuntu runner 先跑 pytest 生成
.pytest_cache,随后 Blueprint selftest 的 P071 缓存卫生检查把它判为错误,导致 6 个 Ubuntu job 在 selftest 步骤失败。
修复后,校验器在 cp1252 控制台也能输出 UTF-8 诊断;CI 的所有步骤都禁用字节码与 pytest 缓存;本地 npm test 也不会再污染发布树。
2. 触发问题
GitHub Actions run 43011968820 的 12 个 job(Ubuntu/Windows × Python 3.11/3.12/3.13 × Node 22/24)全部失败。
2.1 Windows:cp1252 控制台无法编码中文
失败步骤:Validate bundle。日志原文(节选):
File "D:\a\robot-forge-dsh\robot-forge-dsh\skills\robot-forge\scripts\forgekit\validate.py", line 356, in main
print("robot-forge DSH bundle 校验:%s" % root)
UnicodeEncodeError: 'charmap' codec can't encode characters in position 23-25:
character maps to <undefined>
Windows GitHub runner 的控制台编码是 cp1252,校验器启动后第一行中文诊断就失败。开发机使用 UTF-8 控制台,因此本地无法复现。
2.2 Ubuntu:pytest 缓存触发 P071
失败步骤:Blueprint selftest。日志原文(节选):
[ERROR] P071 存在缓存目录 /home/runner/work/robot-forge-dsh/robot-forge-dsh/.pytest_cache
CI 的顺序是 Validate → pytest → Host test → selftest。pytest 在仓库根目录生成 .pytest_cache,而 selftest 的发布卫生检查 P071 要求仓库中不存在缓存目录。两个步骤单独看都正确,组合起来却互相拆台。
3. 修复内容
| 文件 | 改动 | 作用 |
|---|---|---|
skills/robot-forge/scripts/forgekit/validate.py |
新增 _force_utf8_stdio(),在 main() 入口把 stdout/stderr 重配置为 UTF-8(errors="replace") |
cp1252 / cp936 控制台不再因中文诊断崩溃;GitHub 日志仍是可读 UTF-8 |
.github/workflows/ci.yml |
job 级 env 增加 PYTHONDONTWRITEBYTECODE=1、PYTHONIOENCODING=utf-8、PYTHONUTF8=1;pytest 加 -p no:cacheprovider |
所有矩阵步骤编码一致;pytest 不再生成 .pytest_cache;不生成 __pycache__ |
package.json |
test / test:engine 加 -p no:cacheprovider;版本锁步到 2.0.2 |
本地按文档执行也不会制造 P071 假红 |
SKILL.md / forgekit/__init__.py / CHANGELOG.md |
版本锁步到 2.0.2 | 满足 P047 版本一致性 |
README.md / docs/acceptance.md |
安装 URL 与验收版本更新到 2.0.2 | 用户按文档安装到正确版本 |
没有修改:生成项目模板、robot.yaml 契约、verify.yaml 语义、CST/DSN 规则、六维评分、发布门、12 个工具 schema、11 篇 references。
4. 兼容性
2.0.2 是 2.0.1 / 2.0.0 的 drop-in 升级:
- 已生成项目的
forge/robot.yaml、证据文件、review 记录与发布包保持兼容; - 12 个
rf_*工具的参数、返回结构与语义不变; - 六维评分、CST-01…14、DSN-01…11、release/beta/blocked 判定不变;
- 11 篇 references 与 12 个形态配方不变;
- 无需迁移脚本,无需重新生成项目。
5. 验证证据
以下命令在清理 __pycache__/.pytest_cache 后执行:
| 命令 | 结果 |
|---|---|
python scripts/validate_plugin.py |
0 错误 · 0 警告 |
PYTHONIOENCODING=cp1252 python scripts/validate_plugin.py |
0 错误 · 0 警告(模拟 Windows cp1252 控制台) |
python -S scripts/validate_plugin.py(强制走 yamlmini 回退) |
0 错误 · 0 警告 |
python -m pytest tests -q -p no:cacheprovider |
21 passed |
node --test tests/plugin.test.mjs |
1 file passed |
python skills/robot-forge/scripts/forge.py selftest |
两蓝本 check 0 error、verify 通过、自检通过 |
npm pack --dry-run |
文件表完整、无缓存目录、无 tgz/临时产物 |
CI 验证:代码提交 49a1174 的 GitHub Actions run 43012635410 的 12 个矩阵 job 全部通过(Ubuntu/Windows × Python 3.11–3.13 × Node 22/24)。
6. 安装与升级
从 2.0.1 升级无需迁移项目。把 profile 的依赖指向新 tarball、重新安装并重启 Harness 即可:
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"仍需把 robot-forge-dsh 加入 profile package.json 的 dsh.profile.bundles,否则 DSH 不会加载 patch。Web 安装方式不变。
7. 发布检查单
- 版本四处一致(package.json / forgekit / SKILL / CHANGELOG)
- cp1252 控制台校验通过
- 无 PyYAML 环境校验通过
- 校验后无
__pycache__/.pytest_cache - Python 单测、Host 测试、蓝本自检通过
- tarball 与 GitHub Release 资产 SHA256 一致(发布后核对)
- 2.0.1 → 2.0.2 为 drop-in 升级,无迁移
- GitHub Actions 12/12 job 通过(run 43012635410)
Robot Forge v2.0.1 - CI-safe validator patch
Robot Forge v2.0.1 发布报告
- 版本:2.0.1
- 日期:2026-11-11
- 状态:补丁发布(Patch Release),修复发布流水线误报
- 适用宿主:DeepSeek Harness(DSH)0.2.x
- 许可证:MIT
1. 摘要
v2.0.1 不改变任何生成项目的契约、12 个工具、评分规则、参考手册或蓝本。它只修复插件自身的两个校验器缺陷:这两个缺陷在开发机的 python -B 习惯下不可见,但在 GitHub Actions 的干净 Linux 环境中会让 12 个矩阵 job 全部在 “Validate bundle” 步骤失败。
修复后,校验器在没有 PyYAML 的干净环境中通过,并且不会在仓库里留下 __pycache__——后者原本会让校验器自己触发 P071 缓存卫生检查,造成“越跑越失败”的假红。
2. 触发问题
GitHub Actions run 43010397993 的 12 个 job(Ubuntu/Windows × Python 3.11/3.12/3.13 × Node 22/24)全部失败,失败步骤为 Validate bundle,退出码 1。日志原文:
[ERROR] P021 cordis.patch.yml 解析失败:PyYAML 未安装,跳过 patch 结构解析 cordis.patch.yml
[ERROR] P071 存在缓存目录 .../skills/robot-forge/scripts/forgekit/__pycache__
2 错误 · 0 警告
两个根因:
- 可选依赖被当成硬错误:bundle 运行时是 stdlib-only,但
_parse_yaml在缺少 PyYAML 时直接报错;GitHub 的python环境没有预装 PyYAML。cordis.patch.yml只使用yamlmini已覆盖的子集,所以这不应阻断发布。 - 校验器污染自己的检查:入口脚本导入
forgekit时先生成__pycache__,随后 P071 扫描又把这个刚生成的目录判为错误。本地常用python -B,因此没有暴露。
3. 修复内容
| 文件 | 改动 | 作用 |
|---|---|---|
skills/robot-forge/scripts/forgekit/validate.py |
_parse_yaml 优先 PyYAML,ImportError 时回退到 yamlmini;两者都失败才报错 |
干净 CI 环境不再因可选依赖失败;与运行时 stdlib-only 契约一致 |
scripts/validate_plugin.py |
导入 forgekit 前设置 sys.dont_write_bytecode = True |
校验不生成 __pycache__,P071 不再自阻塞 |
skills/robot-forge/scripts/validate_plugin.py |
同上 | 两个入口行为一致 |
package.json / SKILL.md / forgekit/__init__.py / CHANGELOG.md |
版本锁步到 2.0.1 | 满足 P047 四处一致 |
README.md / docs/acceptance.md |
安装 URL 与验收版本更新到 2.0.1 | 用户按文档安装到正确版本 |
没有修改:生成项目模板、robot.yaml 契约、verify.yaml 语义、CST/DSN 规则、六维评分、发布门、12 个工具 schema、11 篇 references。
4. 验证证据
以下命令在清理 __pycache__/.pytest_cache 后执行;全部通过才发布 2.0.1。
| 命令 | 结果 |
|---|---|
python scripts/validate_plugin.py |
0 错误 · 0 警告;运行后无 __pycache__ |
python -S scripts/validate_plugin.py(强制走 yamlmini 回退) |
0 错误 · 0 警告 |
python skills/robot-forge/scripts/validate_plugin.py |
0 错误 · 0 警告 |
python -m pytest tests -q -p no:cacheprovider |
21 passed |
node --test tests/plugin.test.mjs |
1 file passed |
python skills/robot-forge/scripts/forge.py selftest |
两蓝本 check 0 error、verify 通过、自检通过 |
npm pack --dry-run |
文件表完整、无缓存目录、无 tgz/临时产物 |
5. 安装与升级
从 2.0.0 升级无需迁移项目;已生成项目的 forge/robot.yaml、证据和发布包保持兼容。把 profile 的依赖指向新 tarball、重新安装并重启 Harness 即可:
dsh plugin --profile desktop add "https://github.com/yry1816186-pixel/robot-forge-dsh/releases/download/v2.0.1/robot-forge-dsh-2.0.1.tgz"仍需把 robot-forge-dsh 加入 profile package.json 的 dsh.profile.bundles,否则 DSH 不会加载 patch。Web 安装方式不变。
6. 发布检查单
- 版本四处一致(package.json / forgekit / SKILL / CHANGELOG)
- 无 PyYAML 环境校验通过
- 校验后无
__pycache__ - Python 单测、Host 测试、蓝本自检通过
- tarball 与 GitHub Release 资产 SHA256 一致
- 2.0.0 → 2.0.1 为 drop-in 升级,无迁移
- GitHub Actions 12/12 job 通过(push v2.0.1 后确认)
robot-forge v2.0.0 - DSH-native robot project forge
Robot Forge v2.0 发布报告
- 版本:2.0.0
- 日期:2026-11-11
- 状态:发布候选(Release Candidate),插件自验收通过
- 适用宿主:DeepSeek Harness(DSH)
- 许可证:MIT
1. 交付摘要
Robot Forge 不是提示词合集,而是“机器人项目的门禁层”:模型说“做完了”不算数,只有渲染一致、检查通过、真实命令退出码为 0、需求追踪覆盖、独立盲审记录、审计评分达标,才允许生成发布包。
v2.0 把 v1.1.3 的“契约 + 门禁 + 证据 + 双蓝本”骨架扩展为完整研发流水线:
| 维度 | v1.1.3 | v2.0 |
|---|---|---|
| 形态覆盖 | 2 个蓝本 | 11 个具体配方 + freeform |
| 模型工具 | 7 | 12(新增 intake/design/trace/review/package) |
| 工作阶段 | 5 | 7(接单→定案→架构→建造→证明→盲审→发布) |
| 参考手册 | 5 篇 | 11 篇 |
| 检查规则 | S1–S14、D1–D10 | 再增 CST-01–14 跨产物规则、DSN-01–11 设计核算规则 |
| 设计能力 | 无 | 扭矩/转速/爬坡/续航/C-rate/线径 AWG/散热/成本八类核算 |
| 跨产物一致性 | 部分 | 固件引脚↔清单、总线初始化、协议 token、需求↔验证↔证据、BOM↔文档、安全↔合规 |
| 盲审 | 只出报告 | 盲审包 + 独立结论记录 forge/review.json,audit 强制校验 |
| 发布包 | zip | 可复现 zip + RELEASE.json + SHA256SUMS + 独立 .sha256 |
| 评测 | 6 例 | 12 例 |
| 测试 | 1 套 host 测试 | host 全链路 + 21 个 Python 引擎测试 |
| 开源工程 | 基础 | CI 矩阵、SECURITY、CoC、SUPPORT、ROADMAP、issue/PR 模板、验收手册、版本锁步 |
当前插件共 179 个文件、约 0.8 MB:Python 47、JavaScript 3、Markdown 81、JSON 7、YAML 5。
2. 结构编排
plugins/robot-forge/
├── index.js Host 入口:12 工具、系统提示、/forge
├── lib/run.js Python 启动器、项目发现、JSON/错误封装、取消
├── lib/tools.js 12 个模型可见工具的 schema 与渲染
├── cordis.patch.yml DSH bundle:挂载 skill / 工具 / 提示
├── skills/robot-forge/
│ ├── SKILL.md 按需加载:七阶段、12 工具、机器门、红线
│ ├── references/ 11 篇专家手册(唯一真相源)
│ ├── scripts/forgekit/ intake/design/consistency/report/model/
│ │ check/render/api/cli/validate 等
│ └── templates/ wheel-rover 与 desktop-companion 两个完整蓝本
├── prompts/roles/ planner/hardware/embedded/software/sim/
│ verifier/reviewer/integrator + README
├── evals/ 12 个行为评测 + 确定性判分器
├── tests/ host 测试 + Python 引擎测试
├── docs/ design / acceptance / CONTRIBUTING / 本报告
├── .github/ CI、issue 模板、PR 模板
├── SECURITY.md / CODE_OF_CONDUCT.md / SUPPORT.md / ROADMAP.md
└── README.md / CHANGELOG.md / LICENSE
七阶段编排
| 阶段 | 动作 | 退出条件 | 工具 |
|---|---|---|---|
| A 接单 | 解析愿望、形态、预算、安全旗标 | 12 配方/freeform、≤3 问且每问有默认、must/nice/不做 | rf_intake |
| B 定案 | 选最近蓝本,写一页方案与契约 | 目录完整、占位符可替换、预算口径清楚 | rf_blueprints / rf_new |
| C 架构 | 机械/电子/电源/固件/软件/仿真 | render 成功、check 0 error、design 0 阻断 | rf_design / rf_check |
| D 建造 | 按域实现,Lead 合并 | check --deep 0 error、必需文档齐全 | rf_check |
| E 证明 | 真实命令 + 证据 + 追踪矩阵 | verify 全 required 通过、must 100% 有 measured/manual | rf_verify / rf_trace / rf_evidence |
| F 盲审 | 独立评审者按包复核 | pass、无未解决 blocker、≥70、与当前构建一致 | rf_review |
| G 发布 | 审计 + 可复现打包 | 0 error、覆盖 100%、≥85、有效盲审、release | rf_audit / rf_package |
机器门不是建议:rf_check 0 error、--deep 0 error、rf_verify exit 0、rf_trace must 100%、rf_review 有效 pass、rf_audit ≥85 且无 blocker,缺一不可 release;否则只能是 beta 或 blocked。
3. 12 个工具
| 工具 | 作用 | 关键输出 |
|---|---|---|
| rf_intake | 自然语言愿望 → 形态/预算/域/安全旗标/问题 | archetype、confidence、assumptions、≤3 questions、safe_alternatives |
| rf_blueprints | 列出最接近的可运行蓝本 | blueprint、cost、time、domains、tags |
| rf_new | 从蓝本生成完整 0→1 项目 | 目录、vendored 引擎、render 结果 |
| rf_status | 进度、预算、需求、证据概览 | 组件/需求/证据/下一步 |
| rf_check | 渲染 + L1–L4 检查 | issues、stats、next |
| rf_design | 扭矩/续航/C-rate/线径/散热/成本 | 数值 + forge/design.md + 阻断项 |
| rf_verify | 执行 verify.yaml 命令并记证据 | pass/fail/skip、measured/assumed、指纹 |
| rf_audit | 六维评分与发布级别 | score、scorecard、release_level、verdict |
| rf_trace | 需求→验证→证据追踪矩阵 | forge/trace.md、coverage、must 列表 |
| rf_review | 盲审包;可记录独立结论 | packet SHA256、review.json 状态 |
| rf_package | 可复现发布包 | zip、SHA256SUMS、RELEASE.json |
| rf_evidence | 追加人工/仿真/假设证据 | 证据账本、四态等级、指纹 |
所有工具统一返回 {ok, text, data},错误带可执行的下一步;/forge status|next|check 提供不打扰模型的人工入口。
4. 能力覆盖矩阵
图例:✅ 机器强制;◐ 有模板/参考但需人工判断;— 不适用。
| 全栈能力 | 覆盖 | 主要产物 | 机器门/证据 |
|---|---|---|---|
| 愿望理解与范围控制 | ✅ | 一页方案、must/nice/不做、假设 | intake 形态/预算/≤3 问;wish.story≥20 |
| 形态与架构选型 | ✅ | robot.yaml、architecture、features | 12 配方映射;S1–S3;CST-14 |
| 机械结构/CAD | ◐ | cad/*.py、STL、装配说明、公差 | cad 文件存在;D1–D10;design 质量/扭矩 |
| 电子与接线 | ✅ | docs/03、pinout、bus/power 表、SVG | S4 冲突/保留脚、S5 地址、CST-01/03、渲染一致 |
| 电源与续航 | ✅ | 电源轨、电池、续航、线径 | S6 轨/峰值/续航、DSN-03/04 |
| BOM 与供应链 | ✅ | hardware/bom.csv、docs/01 | S7 预算、S14 占位型号、CST-09/13、D9 |
| 固件 | ✅ | firmware/、config.h、协议、测试 | platformio.ini/main.cpp/test、CST-01/03/04、S4 |
| 主机软件 | ✅ | software/、协议、pytest | pyproject/main.py/tests、CST-04/08、测试质量 |
| 仿真/控制 | ✅ | sim/ 场景、运动学/功率检查 | 场景+README、verify 命令、S9 映射 |
| 测试与假绿封堵 | ✅ | verify.yaml、12 类假绿规则 | 真命令退出码、TRIVIAL 拦截、断言数、CST-08 |
| 安全与合规 | ✅ | docs/07、compliance/security 块 | S11 触发、CST-07/10/11、audit safety 10 |
| 文档完整性 | ✅ | docs/00–10、README、CHANGELOG、LICENSE | 14 必需文档、12 章节、块标记、D7/D8 |
| 需求追踪 | ✅ | forge/trace.md、REQ 表 | must 100%;CST-05/06 |
| 证据链 | ✅ | forge/evidence.jsonl | measured/manual/simulated/assumed;指纹过期 |
| 独立盲审 | ✅ | review-packet.md/json、review.json | pass/无 blocker/≥70/指纹+包哈希一致 |
| 发布与可复现 | ✅ | dist/*.zip、RELEASE.json、SHA256SUMS | 0 error+100%+≥85+有效盲审;固定 zip 时间 |
| DSH 编排 | ◐ | 系统提示、skill、子代理角色、PTC 参考 | 写作用域不重叠;Lead 合并后复检 |
| 开源工程 | ✅ | CI 矩阵、SECURITY/CoC/SUPPORT/ROADMAP、模板 | validate 0/0、CI 全绿、版本锁步 |
覆盖边界:配方给的是“这类机器人通常怎么搭、哪些件不能省、验收看什么”,不是形态白名单;没有完整蓝本的形态会明确标注为派生起点,不假装已验证。
5. 质量验收标准
5.1 插件自身出厂验收(docs/acceptance.md)
| 项目 | 权重 | 通过线 |
|---|---|---|
| 结构与版本(validate 0 error 0 warn、四处版本一致) | 15 | 0 错 0 警 |
| Host 12 工具测试 | 20 | 全绿 |
| Python 引擎测试 | 20 | 21/21 |
| 两蓝本全量自检与冒烟 | 20 | check 0 error、verify 通过、release 可达 |
| 生成质量抽检 | 10 | 6 文档 + 4 代码无占位/TODO |
| 安全与合规 | 10 | 越权/伤害用途拒绝、安全旗标落文档 |
| 开源物料 | 5 | npm pack 含 README/LICENSE/SECURITY/CI |
| 总分 | 100 | ≥95 可发布;≥80 Beta;<80 不可发布 |
5.2 生成项目验收(六维 100 分)
| 维度 | 分 | 判定 |
|---|---|---|
| 买得到(BOM/价格/来源/替代料) | 15 | 缺来源、EOL、假货风险扣分 |
| 造得出(结构/装配/公差/工具) | 20 | CAD 缺失、装配不可执行扣分 |
| 跑得起来(固件/软件/仿真/真实命令) | 25 | 未验证、命令失败扣分 |
| 说得清(文档/接线/决策/复现) | 15 | 文档缺章、术语不一致扣分 |
| 证得了(需求→验证→证据) | 15 | must 无证据、指纹过期扣分 |
| 安全与许可 | 10 | 锂电/市电/运动/激光/隐私/联网缺口扣分 |
规则:每 error −6、每 warning −1;evidenced 按 must 覆盖率给分;D4 不重复扣。release = 0 error + must 100% + score ≥85 + 有效盲审 pass(无未解决 blocker、≥70、与当前构建一致);缺盲审或结论过期只能 beta;needs_revision/reject 直接 blocked,且 blocked 不能靠 --beta 绕过。
5.3 证据四态
- measured:真实命令执行且退出码为 0,带命令与指纹;
- manual:用户真实试用后记录,必须写 note;
- simulated:仿真/Mock,不替代实测;
- assumed:缺工具或未执行,明确标未验证。
模型不得替用户写 manual;源码或关键产物改变后,旧证据指纹失效,必须重跑。
5.4 可复现发布包
- zip 内每个文件的日期、权限、顺序固定;
- RELEASE.json 记录逐文件 SHA256、六维分、release_level、fingerprint;
- SHA256SUMS 覆盖全部文件,另写独立 .sha256;
- 同一构建重复打包 SHA256 必须完全相同(已在 E2E 验证)。
6. 相对 v1.1.3 的关键增强点
- 从 2 个蓝本到 12 形态配方:新增机械臂、四足、无人机、传感节点、移动抓取、割草、教育套件、云台、水下与 freeform,每类给出关键件、必须项、验收基准、安全旗标与常见坑。
- 从“能生成”到“能算”:design.py 计算轮式扭矩/转速/爬坡、臂关节扭矩、续航、C-rate、AWG 线径、散热密度、成本上限;数值不达标直接阻断,不再靠感觉选型。
- 从单文件检查到跨产物一致性:CST-01–14 校验固件 GPIO↔robot.yaml、I2C 初始化、主机协议 token↔固件、must↔verify↔证据、BOM↔docs/01、密钥、测试质量、EOL、安全术语。
- 从“自评”到独立盲审门:review-packet 含复现命令/追踪矩阵/证据/机器发现/哈希;独立评审者给结论,Lead 记录 review.json;audit 只认当前构建的 pass,源码一变即失效。
- 从“能跑”到“可复现发布”:固定 zip 时间/权限/顺序,RELEASE.json 逐文件哈希,重复打包 SHA 相同;blocked 不能靠 beta 绕过。
- 从 5 阶段到 7 阶段、7 工具到 12 工具:接单、定案、架构、建造、证明、盲审、发布每阶段都有唯一入口和退出条件;工具只做一件事,返回结构化问题与下一步。
- 从“提示模型”到“激发 DSH”:systemPrompt 只放红线,细节按需加载 skill;明确 PTC、子代理写作用域、todo/goal、人机回环、present 的用法;弱模型降级路径写入参考。
- 从“示例评测”到 12 例行为评测:新增形态分类、安全拒绝、设计数值、跨产物不一致、盲审包、发布包、水下 freeform;判据优先确定性,人工 rubric 只评机器测不了的。
- 从“能测”到“可回归”:21 个 Python 引擎测试 + host 全链路测试,覆盖 review 记录/失效、package 拒绝/确定性、证据过期、路径穿越、cwd 越界、空跑、可选失败。
- 从“仓库”到“开源项目”:CI(Ubuntu/Windows × Python 3.11–3.13 × Node 22/24)、SECURITY、CoC、SUPPORT、ROADMAP、issue/PR 模板、验收手册、贡献流程、版本锁步校验。
- 从“文档提到”到“机器可查”:11 篇参考成为唯一真相源,validate 检查 12 工具白名单、11 篇参考、必需文档、SKILL 大小、缓存/占位/版本一致性。
- 从“可能污染”到“路径安全”:项目路径按相对路径过滤,不再因宿主绝对路径含 build/dist 而跳过整个项目;指纹排除生成物,避免 check 自身导致证据过期。
7. 验证证据(本轮实测)
| 命令 | 结果 |
|---|---|
| python -B skills/robot-forge/scripts/validate_plugin.py | 0 错误 · 0 警告 |
| python -B skills/robot-forge/scripts/forge.py selftest | 2.0.0;desktop 0 error/10 warn、wheel 0 error/9 warn;两蓝本 verify 通过;自检通过 |
| python -B -m pytest tests -q -p no:cacheprovider | 21 passed(2.54s) |
| node --test tests/plugin.test.mjs | 1 file pass(24.2s) |
| E2E:new→design→verify→manual evidence→trace→review→audit→record pass→audit→package ×2 | 盲审前 beta;记录 pass 后 release;score 97;再生成 packet 仍 release;两次 SHA256 相同 0c15bb4c…0696d4(71 文件,163,506 字节) |
| npm pack --dry-run | 179 文件(含 .github/CI、README/SECURITY/templates/evals),打包体积 301 KB,无缓存目录 |
E2E 关键语义:未记录 blind review 时 audit 只能 beta;记录 pass/90/reviewer 后 release;改源码后 review.valid=false、audit 回到 blocked;不静默发布。
8. 已知限制
- 插件不能替代真实焊接、装配、上电与长时间老化;没有实测证据时它只会标 beta/未验证。
- 内置完整蓝本仍只有 2 个;其余形态是“配方 + 最近蓝本派生”,深度低于这两个蓝本,不假装已验证。
- 价格是 2026-11 人民币快照,元器件价格/交期会变;关键件需在下单前复核。
- 未对所有历史 DSH 版本做回归;engines 要求 dsh >= 0.2.0,CI 覆盖当前 Node/Python 矩阵。
- 盲审的“独立性”是流程约束(reviewer 角色、Lead 记录、禁止自评),不是密码学身份认证;开源协作中仍需维护者把关。
- 可复现 zip 依赖文件 mtime 或 SOURCE_DATE_EPOCH;跨机器/跨 checkout 的字节一致需要统一时间源。
- 高风险形态(无人机、割草、水下、市电、激光)只提供工程与合规参考,不构成法律/安全认证;必须由具备资质的人复核。
- 12 类配方不是形态白名单;完全未命中的专机走 freeform,能力覆盖取决于最近蓝本与新增验证。
9. 快速开始
dsh plugin add ./plugins/robot-forge
对话示例:
做一个能跟着我走、避开障碍、桌面陪伴聊天的小机器人,预算 800,两周内能跑起来。
模型应先加载 robot-forge skill,调用 rf_intake 得到形态/预算/≤3 个带默认值的问题,再 rf_blueprints → rf_new → rf_design → 建造 → rf_verify → rf_trace → rf_review → rf_audit → rf_package。
10. 发布检查单
- 版本四处一致(package.json / forgekit / SKILL / CHANGELOG)
- validate 0 错误 0 警告
- 21 个 Python 测试通过
- host 全链路测试通过
- 两蓝本 selftest 通过
- E2E 盲审门与可复现打包验证
- npm pack 文件表检查
- README / design / acceptance / CONTRIBUTING / CHANGELOG 同步
- SECURITY / CoC / SUPPORT / ROADMAP / issue / PR 模板
- 清理 pycache / .pytest_cache