参考资料与实操导读 →
WORKBOOK · V1
把学习结果,
写成可核实的材料。
不用每天从空白开始。五份模板随着实验逐步补齐,最后组成试点草案。
下载五份模板与指标说明 ↓
模板是独立教学材料,不是客户案例或平台能力证明。可在 GitHub 或 Codespaces 编辑,网站不保存作答;客户资料请保存在自己的私有空间。
BUILD YOUR EVIDENCE
从第一课开始填。
Day 1 开始 · Day 6 补证据
能力台账
记录某项能力在什么版本和条件下被验证,明确演示、规划与未知项。
下载 能力台账 .md ↓展开完整模板
# 能力台账
用途:从 Day 1 起逐条填写,Day 6 补证据,Day 7 支持试点范围。所有示例与未验证项必须标注;空字段不表示已支持。
| 用户问题 | 所需能力 | 当前状态 | 支持对象 / 条件 | 软件与资产版本 | 证据链接 / 运行记录 | 不支持 / 未验证项 | 核实人 / 下一步 |
|---|---|---|---|---|---|---|---|
| 教学例:静态目标坐标不一致 | 参考系与单位检查 | 教学实验已运行;生产能力未知 | 当前简化输入 | 待填 | 待填本人报告 | 动力学、抓取、真机未验证 | 待填 |
| 待填 | 待填 | 未知 | 待填 | 待填 | 待填 | 待填 | 待填 |
状态建议:发布版已验证 / 演示或实验 / 研发中 / 规划 / 未知。不能仅根据某工具的官方教程,把状态提升为本平台已支持。
每次状态变化记录:原状态、现状态、日期、新证据与结论范围。
Day 7 汇总 · 有记录时提前填
客户证据表
围绕最近一次真实工作整理使用者、选型者、成本和采用障碍;没有访谈就保留待验证。
下载 客户证据表 .md ↓展开完整模板
# 客户问题与采用证据
没有真实访谈时,全部写“待验证”。勿提交客户机密或个人信息到公开网站。此模板不授权自动联系客户。
## 先记录一次真实工作
- 场景与日期:
- 实际使用者 / 技术选型者 / 预算决策者(按角色记录即可):
- 最近一次具体任务与原话摘要:
- 当前使用的工具、流程和替代方案:
- 哪个环节耗时 / 失败?有何日志或数量证据:
- 为此投入的人时、算力、返工或支持成本:
- 切换新方案的约束:集成、资产兼容、数据协议、安全与采购:
- 什么条件满足才愿意试用:
- 哪些是事实,哪些只是我的推测:
- 下一步最小验证与责任人:
## 五个访谈问题
1. 上一次完成这类任务,能从输入到结果讲一遍吗?
2. 当时最难或最慢的是哪一步?有具体例子吗?
3. 已经试过什么解决办法?为什么仍不足?
4. 如果换工具,需要谁参与,以及改变哪些现有流程?
5. 一次小规模试用得到什么结果,才值得继续投入?
产出必须关联到具体经历;“功能听起来不错”不等于购买或采用证据。
Day 1 → Day 3 → Day 4
任务与数据契约
先写资产与消费者,再补动作、观测、时序、质量和验收,贯穿整周。
下载 任务与数据契约 .md ↓展开完整模板
# 任务与数据契约
版本:____;日期:____;状态:教学草案 / 待验证 / 已评审。
## A. 谁要什么
- 消费者角色与目标工作流:
- 本次交付:资产 / SDK 接口 / 任务环境 / 感知数据 / 动作轨迹 / 策略模型(明确选择):
- 消费者提供的输入、使用条件和责任:
- 本次明确不承诺的结果:
## B. Day 1:资产和场景
- 资产来源、使用权限与版本:
- 文件格式、引用依赖、米 / 毫米、up axis、缩放:
- 物体 / 相机 / 基座的参考系及旋转约定:
- Visual 与 collision 文件、近似方式与必须保留的几何特征:
- 待补物性:质量、质心、惯量、摩擦等:
- 相机挂载、局部 / 世界位姿、观测通道:
- 已完成的静态检查与报告:
- 导入与真实运行是否验证,使用什么引擎 / 版本:
## C. Day 3:任务和控制
- 本体、末端工具、场景和重置分布:
- 动作含义、维度、顺序、单位和限幅:
- 观测含义、可用时间、控制 / 物理 / 相机频率:
- 运动约束、允许接触与禁止碰撞:
- 可测的成功条件、容差来源、持续时间:
- 失败、超时、重试、终止与人工介入规则:
- 随机化因素、范围、种子和资产版本:
## D. Day 4:数据与质量
- 感知帧还是带动作时序的 episode:
- 数据格式及版本;每个字段的 dtype / shape / 单位 / frame:
- episode 边界、timestamp、动作与观测对齐、缺帧处理:
- 成功 / 失败 / 截断标签及其生成规则:
- 数据血缘:场景、策略、随机化、质检规则与代码版本:
- 接收 / 拒收规则:
- 原始数量、合格数量、拒收原因分布:
- 训练 / 验证 / 测试按 episode 划分的规则:
## E. 验收与责任
- 验收对象与计量单位:
- 固定测试集、质量门槛和测量方法:
- 谁提供条件、谁运行、谁签收:
- 未验证项、限制、支持范围和变更处理:
首日只填写 A、B 与已知的 E;其余填“待验证”。不能把静态检查通过写成抓取、模型或真机成功。
Day 2 开始 · Day 5–6 更新
实验卡
把假设、基线、唯一变量、测试条件、原始记录与结论范围写在一起。
下载 实验卡 .md ↓展开完整模板
# 实验卡
- 实验编号、问题与日期:
- 我的预测 / 可被证伪的假设:
- 基线、改进组与唯一改变的变量:
- 固定项:机器人、资产、环境、软件版本、种子、预算:
- 训练 / 调参数据与独立评估条件:
- 指标定义、分母、观察窗口与质量门槛:
- 原始文件、命令 / 操作步骤、配置与日志位置:
| 条件 / 种子 | 分组 | 成功数 / 总数 | 质量指标 | 模拟时长 | 实际耗时 | 人工介入 episode | 失败与异常 |
|---|---|---|---|---|---|---|---|
| 待填 | 基线 | 待填 | 待填 | 待填 | 待填 | 待填 | 待填 |
| 待填 | 改进 | 待填 | 待填 | 待填 | 待填 | 待填 | 待填 |
- 数据支持什么结论:
- 未达到或没有测量的指标:
- 能否复现,谁复核过:
- 结论不适用于哪些条件:
- 下一步最小验证:
奖励、离线误差、闭环成功率分开报告。演示、小样本探索、仿真评估与真机验证不能混用结论。
Day 7 汇总
试点方案
明确客户输入、交付单位、质量门槛、成本和支持边界;证据不足时标记教学草案。
下载 试点方案 .md ↓展开完整模板
# 试点方案 · 教学草案
只有真实客户证据与技术评审齐全后,才能移除“教学草案”标记。金额、角色和承诺都不得凭空编造。
## 1. 需求与范围
- 关联客户证据表:
- 客户问题、现有办法与采用障碍:
- 本次选择的交付类型与明确排除项:
- 客户输入、本体、资产、数据、算力与接入条件:
## 2. 技术证据
- 关联能力台账 / 任务契约 / 实验卡:
- 已验证部分与证据:
- demo、研发中、规划与未知部分:
- 进入试点前必须通过的最小验证:
## 3. 里程碑与验收
| 里程碑 | 客户输入 | 输出 | 计量单位 | 质量门槛 / 测法 | 验收责任 | 失败或变更怎么办 |
|---|---|---|---|---|---|---|
| 最小闭环 | 待填 | 待填 | 待填 | 待填 | 待填 | 待填 |
| 扩量验证 | 待填 | 待填 | 待填 | 待填 | 待填 | 待填 |
## 4. 成本与支持
- 算力、资产处理、人工返工、质检、存储传输与支持成本分别估算:
- 成本观察窗口、复用 / 摊销规则、一次性与持续成本:
- 原始产量与通过契约的可用产量:
- 单位可用成本及不确定区间:
- 拟议计费单位与选择依据(成本不等于售价):
- 支持时段、责任边界、范围变更与退出条件:
## 5. 评审四问
亲手验证了什么?有哪些客户证据?还不知道什么?下一步用哪个最小实验判断?
SIX METRICS
先统一口径,
再讨论是否变好。
| 指标 | 建议口径 | 容易混淆的地方 |
|---|
| 首次可验收结果时间 | 输入齐备 → 首次通过约定验收的实耗时 | 写清是否包括安装、排队与返工 |
| 合格任务数 / 人时 | 通过同一契约的任务配置数 / 全员投入工时 | 任务数不是轨迹条数;并行人时需要累加 |
| 有效轨迹率 | 符合数据契约的 episode 数 / 原始生成数 | 失败轨迹是否有价值,由契约决定 |
| 单位可用数据成本 | 同一观察窗口的全链路成本 / 合格 episode 数 | 计入资产、人工返工、质检、存储与支持,避免重复计费 |
| 固定质量的达标训练时间 | 固定评估门槛下首次达标的实耗时 | 未达标须标记状态,不能填成完成时间 |
| 人工介入率 | 发生过人工干预的 episode 数 / 总 episode 数 | 另记干预次数与人时,不混用分母 |
教学算例 · 数字不是经营数据生成 100 段、60 段合格,总成本为 600 教学货币:原始每段成本是 6,可用每段成本是 10,有效轨迹率是 60%。如果 0 段合格,单位可用成本应标为不可计算。
成本估算还要注明资产复用、摊销与人工统计规则。成本不等于售价;没有真实客户证据,不从这个算例推导收费结论。