| name | aas-reproducibility |
| description | 当你在为《自动化学报》(Acta Automatica Sinica, AAS) 提升实验可复现性、组织复现包、防范数据污染时调用。覆盖环境与依赖固定、随机种子与多次运行、数据划分与防泄露、控制仿真的求解器/步长/系统参数记录、超参数与调参协议披露、以及配合双盲的匿名化复现材料，帮助控制/自动化/模式识别方向的中文稿在 Acta Automatica Sinica 外审中经得起"结果能否复现"的追问。 |
《自动化学报》可复现性与实验可重复
本技能帮你把投向《自动化学报》(Acta Automatica Sinica, AAS) 的实验做到可复现。外审常问"换个人
能否复现你的结果"，控制类还要能复现稳定性与性能结论。以下方法于 2026-07-09 核验框架（见
resources/official-source-map.md）；本刊是否强制提交复现材料 待核实。
一、可复现性三支柱
| 支柱 | 内容 |
|---|
| 环境可复现 | 语言/库版本、系统、硬件、随机种子固定 |
| 数据可复现 | 数据来源、划分、预处理脚本、校验和 |
| 流程可复现 | 从原始数据到论文图表的一键脚本 |
二、环境与依赖固定
- 记录语言与关键库版本（Python/MATLAB、控制/学习框架），提供
requirements.txt/environment.yml
或 Dockerfile。
- 控制仿真额外记录：仿真器与版本、求解器类型、积分步长、系统模型参数、初始条件。
- 硬件：CPU/GPU 型号、内存；实物实验记录采样周期、控制器硬件与传感器型号。
三、随机性与多次运行
- 固定随机种子；对随机性强的实验（强化学习、随机初始化的识别模型）报告多次运行的均值与方差。
- 说明随机来源（初始化、数据打乱、探索噪声）与控制方式；不要只报单次最好结果。
四、数据划分与防污染
| 风险 | 防范 |
|---|
| 测试集调参 | 只在验证集调参，测试集仅最终评测一次 |
| 数据泄露 | 划分在预处理前，防未来信息进训练 |
| 重复样本跨集 | 去重，确认训练/测试无交叠 |
| 分布偏移未披露 | 说明训练与测试分布差异 |
五、复现包组织（配合双盲）
repro/
README.md # 环境、数据、运行、预期结果、硬件
env/ # requirements.txt / environment.yml / Dockerfile
data/ # 数据或获取脚本 + 校验和
src/ # 方法与基线
configs/ # 每个实验/图表的配置与种子
scripts/ # run_all.sh：原始数据→论文图表
results/ # 关键指标，供复现校验
- 复现材料需匿名：仓库、README、路径、账户名不得泄露作者身份（双盲，见
aas-submission）。
- 用匿名化 Git 快照或匿名仓库分享链接；勿指向作者主页。
六、超参数与调参协议
- 公布搜索空间、选择准则、最终取值；说明基线的调参是否与本文同等投入。
- 控制类公布增益、自适应率、约束参数等；学习类公布学习率、批大小、训练轮数等。
七、可复现性自检清单
[环境] 版本/硬件/种子固定？仿真器/步长/求解器记录？
[数据] 来源/划分/预处理/校验和齐全？无泄露/无跨集重复？
[随机] 多次运行均值±方差？随机来源已说明？
[流程] run_all.sh 可从数据跑到图表？
[超参] 搜索空间/选择准则/取值公布？基线同等调参？
[匿名] 复现材料无身份泄露？
[待核实] 本刊是否强制提交代码/数据：待核实
八、常见复现问题
- 只给结果不给环境，换机器跑不出——补依赖与硬件说明。
- 种子不固定、只报单次——补多次运行统计。
- 测试集调参导致虚高——整改为验证集调参。
- 控制仿真缺步长/求解器/参数，别人复现不了动态——补仿真配置。
- 复现仓库暴露作者身份，违反双盲——匿名化后再放链接。
九、控制仿真的可复现要点（专项）
控制类结论（稳定、收敛、性能改进）依赖仿真设定，须逐项固定并披露：
| 项 | 记录内容 |
|---|
| 被控对象模型 | 状态方程/传递函数、阶数、参数取值 |
| 初始条件 | 状态初值、参考信号 |
| 数值积分 | 求解器类型、步长、容差 |
| 噪声/扰动 | 类型、幅值、随机种子 |
| 仿真时长 | 总时长、采样率 |
| 控制器参数 | 增益、自适应率、约束值 |
同一套参数应能复现论文中的每条响应曲线与性能指标；把这些写进 configs/ 与 README。
十、可重复性的验证方法
- 自我复现：换一台干净机器、按 README 从零跑一遍 run_all.sh，确认无隐性依赖。
- 交叉复现：请合作者独立按说明复现关键结果，暴露"只有作者本机能跑"的问题。
- 结果校验：在
results/ 放关键指标基准值，复现时比对偏差在容许范围内。
十一、可复现性与双盲的平衡
- 投稿阶段复现材料须匿名；不能因追求可复现而在 README、仓库名、提交历史中泄露身份。
- 用匿名快照分享；提交历史若含真实用户名，重新初始化仓库再分享。
- 录用后（见
aas-camera-ready）再去匿名、正式公开，衔接 aas-artifact-evaluation。
十二、复现材料的版本与维护
- 每轮退修补的实验要同步更新复现包，避免论文与代码脱节。
- 用版本标签（如 v1 投稿、v2 退修）标记复现包状态，答复信可引用对应版本。
- README 记录变更历史，便于外审核对"新增实验对应哪段代码"。
- 见刊后（见
aas-camera-ready）把稳定版复现包正式公开，并在稿件中标注最终获取地址。
- 定期检查外部依赖是否失效（数据链接、库版本），保证长期可复现。
十三、与本刊定位
《自动化学报》(Acta Automatica Sinica, AAS) 重视理论与实验双支撑，可复现性是让稳定性/性能结论
可信的基础。把复现包与 aas-experiments、aas-artifact-evaluation 联动整理，能显著降低外审对
"结果可靠性"的疑虑，也为见刊后同行复现打好基础。政策性要求未双源确认前标 待核实。
