MENILY / LEARN课程工作包一周课程 ↗

参考资料与实操导读 →

WORKBOOK · V1

把学习结果,
写成可核实的材料。

不用每天从空白开始。五份模板随着实验逐步补齐,最后组成试点草案。

下载五份模板与指标说明 ↓

模板是独立教学材料,不是客户案例或平台能力证明。可在 GitHub 或 Codespaces 编辑,网站不保存作答;客户资料请保存在自己的私有空间。

从第一课开始填。

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. 评审四问

亲手验证了什么?有哪些客户证据?还不知道什么?下一步用哪个最小实验判断?

先统一口径,
再讨论是否变好。

指标建议口径容易混淆的地方
首次可验收结果时间输入齐备 → 首次通过约定验收的实耗时写清是否包括安装、排队与返工
合格任务数 / 人时通过同一契约的任务配置数 / 全员投入工时任务数不是轨迹条数;并行人时需要累加
有效轨迹率符合数据契约的 episode 数 / 原始生成数失败轨迹是否有价值,由契约决定
单位可用数据成本同一观察窗口的全链路成本 / 合格 episode 数计入资产、人工返工、质检、存储与支持,避免重复计费
固定质量的达标训练时间固定评估门槛下首次达标的实耗时未达标须标记状态,不能填成完成时间
人工介入率发生过人工干预的 episode 数 / 总 episode 数另记干预次数与人时,不混用分母
教学算例 · 数字不是经营数据

生成 100 段、60 段合格,总成本为 600 教学货币:原始每段成本是 6,可用每段成本是 10,有效轨迹率是 60%。如果 0 段合格,单位可用成本应标为不可计算。

成本估算还要注明资产复用、摊销与人工统计规则。成本不等于售价;没有真实客户证据,不从这个算例推导收费结论。