SelfRising/docs/PROVENANCE.md

45 lines
4.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 来源、收录范围与权利说明
本地整理日期:**2026-11-13,Asia/Shanghai**。本项目供复现、审阅与后续优化,尚未上传远端;仓库地址由项目发起人之后提供。
## 三个来源聊天
| 聊天 | 标识 | 提取的项目范围 |
|---|---|---|
| 不倒翁-3.0 | `01a1cb30-61e0-7312-9a73-5681e42086cd` | 大底板、SG90适配、结构简化、装入审查、v4加高圆角与打印准备 |
| 仿真训练不倒翁-3.0 | `01a1cb4d-620c-7d82-b657-76dfcbd4a9d9` | 定位模型历史、速度策略、v3校准/搜索/BC/PPO及147M冻结测试 |
| 不倒翁调试-3.0 | `01a1ce90-e494-7d61-bf39-b33378fd7eb9` | IMU网页校准、360°类型纠正、X5旧权重部署、纯模型与辅助撑地的实机对照 |
聊天中的讨论已按问题与证据重写为交接文档;**不分发完整聊天或工具日志**。聊天含历史继承内容,不能把所有早期型号和方案都当作当前硬件。
首次整理的工作区快照中,`training/sg90_360_contact_v4/`新实验尚未完成,未作为结果或默认模型收录。本仓库冻结主线是已经完成审计的v3;将来可在新提交中添加下一版,保留环境和权重身份。
## 文件身份与封存
- 根目录`SOURCE_MANIFEST.json`的source记录原始来源,path记录当前仓库路径,sha256保留导入时原始字节哈希。目录按3Dmodel、RL、RDK重组,模块内部历史层次保留。
- 顶层STL/装配与RL推理文件是同字节便捷副本,清单用alias_of标明;少数跨模块路径适配列于`docs/LAYOUT_CHANGES.json`,其中同时保留原始与整理后哈希。它们不改变网络、动力参数或控制规则。
- `RL/reproduction/PACKING.json`记录完整原v3交付ZIP的SHA,以及每个恢复文件的长度、SHA和存储方式。四个大型JSON改为gzip存储;恢复后的319个文件保持原封存字节。
- 原`SHA256SUMS.json`与`ENV_IDENTITY.json`不重签、不放宽。外部可检查原评测、网络和环境身份。
- `SOURCE_MANIFEST.json`只封存导入的来源文件,不将新编写文档或后续协作者改动伪称原证据。修改代码后可通过Git差异与来源哈希识别。
- 本次没有改写原工作区文件、运行中训练、原校准、打印任务或板端程序。
## 收录与省略
保留:当前及关键历史源码、必要模型和参考几何、所保留IMU版的打印STL、安装说明与离散检查、六轮实机JSON/视频、主v3完整最终测试、教师快照和训练检查点。
省略:SSH transport目录、私钥、known_hosts、登录信息、本地网页session、自动运行的部署标记、缓存、虚拟环境、重复ZIP、打印机专用G-code,以及大量中间重复评测。4,859次迁移尝试的逐尝试NPZ不是本包全集;完整原清单/汇总在封存交付包中,不能把已保存失败汇总说成逐轨迹全部收录。早期delivery目录是审阅快照,**完整可执行的封存入口是恢复后的build/v3**。
原source provenance有历史绝对路径,表示当时来源,不是用户需要创建的运行路径;旧报告中的localhost链接或未收录的中间产物链接也属于历史记录。以根README和本目录的复现步骤作为当前入口。
## 上游与权利
设计方法参考了原SelfRisingRobot项目;X5官方STEP与社区SG90参考模型来源记录在`3Dmodel/v4_taller_rounded_imu/support/reference_sources.json`。本仓库的控制硬件、连续旋转速度接口和训练结果与上游不同。
本次整理**没有代替权利人统一授予MIT或其他开源许可**。原代码、第三方参考CAD及衍生产物的可再分发条件需要按原来源分别确认;参考STEP的可获取不等于已经获授任意再许可权。保留来源说明,待项目负责人决定公开授权范围。实机录像可能包含现场背景,公开分发前可选用裁剪版。
项目按用户要求先本地交付,不创建远端仓库、不推送、不邀请协作者。提供目标仓库后再按该仓库的可见性和权限交付。
## 2026-11-17机械版本选择
2026-11-18 起,`3Dmodel/` 只发布加高圆角 v4+QMI8658C 安装位。`source/` 保存该设计的冻结 v4 底胚输入,用于复建孔位与固定座。其他 CAD 版本可从 Git 历史追溯。历史训练和部署证据以原记录中的结构为准。