2026-07-24 文档迁移审计
本页是迁移时点的可审计清单，不是当前事实源。判断优先级为代码、配置、测试与稳定产物，其次才是旧文档。迁移后的唯一 owner 从 Research Hub 进入；维护规则保存在 source-only docs/README.md。
| 原路径 | 实际负责的问题 | 当前一致性与冲突 | 类型 / 独有信息 | 最终处置 |
|---|---|---|---|---|
affordance_field_unified_hsi_proposal.md |
reference→teacher→state policy 提案 | 主线部分有效；folder/manifest 设计过时，与总体计划重复 | 研究；四阶段因果边界 | 吸收到 scope/method；归档 |
exp/contactgen_scaffold_map_free_refinement_20260721.md |
map-free grasp 协议与结果 | 实现大体一致；与 benchmark/grasp gate 重复 | 实验；8-object gate、wrench ablation | 成为 experiments/grasp_refinement.md |
exp/contactgen_task_object_stability_benchmark_20260719.md |
official ContactGen 稳定性 | runner/output 存在 | 实验；48 samples 与 bimanual 分母 | 摘要合入 grasp；归档 |
exp/generated_motion_to_physical_execution_strategy_20260724.md |
RQ-A/RQ-B 总体策略 | 研究边界准确，多数实验待执行 | 研究/计划；五轴 taxonomy、A/S 矩阵 | 拆入 scope/method/evaluation/overall；归档 |
exp/grail_minimal_smplx_phcx_adaptation_plan_20260724.md |
GRAIL-Min preregistration | 静态实现部分存在，training 未执行 | 协议；exact gates/hash chain | 原文归档；简化 canonical 页 |
exp/hand_object_interaction_domain_refactor_plan_20260723.md |
HOI API refactor + v14/v20 evidence | 接口有代码；candidate 已被 2026-07-24 替代 | 工程/实验；失败与 curriculum | 吸入 pipeline/kinematic；归档 |
exp/hoi_hsi_teacher_model_experiment_plan_20260711.md |
teacher baselines、协议和 rolling results | 混有过时 shape-mismatched result | 总计划；多 baseline stop gate | 拆入 evaluation/overall/teacher；归档 |
exp/hoi_raw_mocap_physics_refinement_report_20260716.md |
native/adapted physics refinement | native evidence 有效；旧 project adaptation 不可排名 | 实验；65.01M native result、失败诊断 | 合入 teacher；归档 |
exp/omnigrasp_cup_transfer_experiment_20260717.md |
pretrained cup transfer | 输出存在；不满足 current shape/reference contract | 实验；object-control/rotation 边界 | 作为 historical diagnostic canonical |
hoifhli_pure_path_audit.md |
HOI-FHLI path adapter | runner 已入 legacy；历史 output 仍在 | 实验；root-offset/object-COM bug | 合入 external generators；归档 |
hsi_1hour_smplx_toy_experiment.md |
early agent handoff/prompt | 当前入口和 exact06 均被替代 | prompt；acceptance 已吸收 | 删除 |
hsi_generation_hoifhli_style_plan.md |
generation refactor checklist | 多数理念已实现，目录/状态过时 | 工程；action-template reasoning | 合入 pipeline；归档 |
hsi_generation_pipeline_handoff_20260710.md |
当时接口、样例和 tests | 部分路径可用，身份是过期 handoff | handoff；action coverage snapshot | 合入 pipeline；归档 |
hsi_movable_object_motion_model_survey_20260602.md |
generator survey | release 状态时效有限 | related work；路线定位 | 合入 related work；归档 |
hsi_reference_data_generation.md |
reference source/primitive/schema | 方法边界有效，schema 非 current canonical | 方法；generator selection | 合入 method；归档 |
humanoidpf_lessmimic_apex_notes.md |
field/navigation code notes | code observations 可追溯，release 状态有限 | related work；field 拆解 | 合入 related work/matrix；归档 |
interactmove_result_note_20260601.md |
InteractMove native smoke | blocked historical attempt，无 metrics | 实验；missing artifact 边界 | 合入 external generators；归档 |
keyframe_binding_usage.md |
old keyframe/socket 操作 | 旧工具非 current public API | 指南；binding 数学 | 概念合入 pipeline；归档 |
kimodo_hoi_pipeline_spec.md |
specialized Kimodo runner contract | 与 task-first/in-memory 主线冲突 | 旧规范；artifact/gate 历史 | 标记 superseded；归档 |
kimodo_object_attach_repair_case_report.md |
N1 attach failure | 旧 pipeline，但 failure 有效 | 失败；proximity false positive | 合入 kinematic；归档 |
kimodo_object_attach_repair_execution_plan.md |
repair plan | 主入口替代，部分 gate 已实现 | 计划；禁止 broad repair | 合入 method；归档 |
kimodo_pipeline_reorg_20260606.md |
multi-action reorg | 结构与 gap 过时 | 工程；reusable/task boundary | 归档 |
kimodo_smplx_rp_headless_demo_runbook.md |
gated model runbook | 主机状态过时，脚本经验保留 | 操作；access/watcher 诊断 | 合入 external models；归档 |
phcx_zup_reconstruction_tracking_prompt.md |
cross-repo prompt/converter specimen | prompt 非入口；coordinate invariant 已吸收 | prompt；Z-up conversion | 删除 |
physhsi_general_high_level_task_plan.md |
项目范围与层级 | 主线有效，混有排期/旧 manifest 原则 | 研究/计划；训练部署边界 | 重写 project scope；归档 |
physhsi_refiner_development_readme.md |
refiner 架构/MVP | current direct 与 legacy 混杂 | 工程/计划；SOMA contract | 合入 tracking；归档 |
refiner_handoff_20260612.md |
refiner MVP handoff | 2026-06 snapshot | handoff；tray/tracker diagnostics | 合入 tracking；归档 |
related_work/hoi_hsi_teacher_model_research_20260711.md |
teacher/student capability audit | 定位较新；native capability 不能冒充 result | related work；obs/reward taxonomy | 重写 related work/matrix；归档 |
route1_retrieval_kimodo_experiment_plan.md |
retrieval+Kimodo route | old exact06，被 current pipeline 替代 | 计划；fairness boundary 已吸收 | 删除 |
route2_hosig_experiment_plan.md |
HOSIG native/proxy plan | 无 canonical reproduced result | 计划；go/no-go 已吸收 | 删除 |
route2_interactmove_experiment_plan.md |
InteractMove plan | 已被 blocked result note 替代 | 计划；inputs/outputs 已吸收 | 删除 |
sage_task_generator_change_log.md |
追加式 e2e change log | current baseline 停在 2026-05 | 历史日志；E-series decisions | 完整归档，关键结论索引 |
scalable_paired_hsi_sage_kimodo_protomotions.md |
paired HSI data proposal | scale-up 主线有效，模块/schema 过时 | 提案；data split/quality loop | 合入 method/overall；归档 |
scene_aware_generation_experiment_plan.md |
Route1/2 umbrella protocol | exact06 与路径过时 | 总计划；common protocol 已吸收 | 删除 |
smart_object_primitive_todo.md |
socket→constraint TODO | typed schema 未实现且不符 simple dict API | 设计；object-local socket | 合入 method；归档 |
sugar_inspired_physhsi_framework_plan_20260611.md |
SUGAR-inspired framework | teacher/student 边界有效；folder protocol 过时 | 研究；privileged→student | 合入 method；归档 |
审计结论
- current docs 不依赖
*_state.md、*_handoff.md或日期版计划作为默认阅读路径。 - 独有结果、失败诊断和设计理由均有 canonical 摘要或完整 archive。
- 无法确认的外部 release、旧 adapter 数值和计划均保留为历史/待验证，没有选择更乐观版本。
docs/hosig_agent_handoff.txt的删除早于本次迁移，属于用户未提交改动；没有恢复。
docs/ 外 first-party Markdown
第三方 submodules/、baseline/ 与生成目录中的上游文档不迁移。下列 first-party code-adjacent 文档已核对，保留在实现旁；网站只维护 public contract 与研究边界。
| 路径 | 实际职责 / 一致性 | 决定 |
|---|---|---|
README.md |
workspace/Git scope；不是项目研究入口 | 保留；Research Hub 为新成员入口 |
AGENTS.md |
agent implementation rules | 保留，不进入网站 |
sage10k-scene-viewer/README.md |
packaged viewer 启动 | 保留；由 task/visualization guide 定位 |
utils/kimodo/README.md |
old demo wrapper，仍存在但非 current pipeline | 加 superseded warning，保留代码邻近历史 |
utils/kimodo/legacy/pipeline/README.md |
legacy scene-bank/task materialization | 明确 legacy；不作为 current entry |
utils/metrics/README.md |
metric collector API | 保留；Evaluation 管 public boundary |
utils/sage_task_generator/README.md |
generator 细节 | 保留；Task Generation 管 public entry |
utils/sage_task_generator/OUTPUT_FORMAT_FOR_VISUALIZER.md |
task/visualizer schema | 保留；action contract 已吸收 |
utils/sage_task_generator/plan_visualizer/*.md |
visualizer 使用/API | 保留；不是研究事实源 |
utils/sage_task_generator/prompt_templates/*.md |
runtime prompt templates | 保留为输入资产，不进入 nav |
utils/task_validator/README.md |
validator API/metrics | 保留；研究 metric 仍由 evaluation strategy 管 |
utils/uniphys_adapter/README.md |
UniPhys SAGE adapter | 保留为 baseline-specific 指南 |
utils/visualization/README.md、sage_to_gym.md |
runtime/offline viewer API | 保留；可视化 管推荐入口 |