update at 2026-10-12 14:18:03

忽略 .venv;剔除误提交的虚拟环境;更新 README 与实现方案
This commit is contained in:
douboer
2026-10-12 14:18:03 +08:00
parent 3622171c5e
commit ae1c774606
3 changed files with 135 additions and 8 deletions

View File

@@ -141,8 +141,8 @@ fiber_delay_sim/
| 统计 | numpy + scipy.stats | 蒙特卡洛、置信区间;bootstrap 按需 |
| 绘图 | matplotlib | 论文图表直接产出(SVG+PNG) |
| 随机数 | numpy.random.default_rng(seed) | 种子固定 → 逐位可复现 |
| 界面 | CLI 先行;M5 再做简单 GUI(如 Tkinter/Streamlit 单页) | 遵守"先算对,再好看" |
| 附加演示(可选) | 网页 demo,见附录 B | 交流用,不进入里程碑 |
| 界面 | CLI 先行;M5 再做简单 GUI | 遵守"先算对,再好看",GUI 不阻塞算法开发 |
| 展示网站(副产品) | 静态站 + Pyodide 复用 core/ + ECharts,随里程碑同步增量(见附录 B) | 同步展示成果;core 保持浏览器可运行,网站零算法重写 |
---
@@ -310,6 +310,21 @@ runs/YYYYMMDD-HHMMSS-<实验名>-<seed>/
**完成 M0 后立即执行任务书"开始工作时先做什么"的检查**:四项前置工作(理解说明/框图、实验流程、最小程序、光纤长度表)全部具备后,再继续 M2 以后工作。
### 11.1 网站同步增量计划(副产品,随里程碑上线)
> 网站与主线并行开发、每个里程碑后同步部署一次;工作量控制在"薄壳页面 + 部署",若与主线冲突,主线优先。
| 里程碑 | 网站同步增量 | 页面内容 |
|---|---|---|
| M0 | **网站骨架上线** | 项目简介(摘自 `项目说明.md`)+ 最小交互 demo:调节寿命/噪声,实时看 10ns 直接采样与拟合 |
| M1 | 光纤设计器页 | 长度→延时→相位计算器、反向设计、相位圆图(复现原项目名义四组) |
| M2 | 校准与重建页 | 误差注入开关;校准前后重建曲线对比 |
| M3 | 算法比较页 | 同一数据切换对数线性 / NLS,拟合与残差对比 |
| M4 | 统计结果页 | 蒙特卡洛分布与扫描热图:默认加载预计算记录包 JSON,提供小规模(如 20 次)交互重算体验 |
| M5 | 六页教学界面完整化 | 对应任务书六页面 + 一键导出 |
**内容纪律**:网站展示的每个案例必须对应一个实验记录包(`meta.json` 可追溯);页面显著标注"仿真演示,非实测数据";不出现任何整机性能表述。
---
## 12. 测试与验证策略
@@ -364,14 +379,36 @@ runs/YYYYMMDD-HHMMSS-<实验名>-<seed>/
---
## 附录 B:附加演示网站(非交付主线,可选)
## 附录 B:展示网站(副产品,与主线同步开发)
> **定位**:仅为方便交流和演示的附加产物,不进入任何里程碑,M5 完成后视余力实施。内容仅限已被记录包验证过的仿真案例,页面显著标注"仿真演示,非实测数据"。
### B.1 定位
- 域名:`https://chenxy.biboer.cn`(HTTPS 已配置,证书有效期至 2027-01-10;服务器 24.233.3.126,nginx 当前为 302 占位配置,实施时替换为站点 root);
- 推荐技术路线:**同一 `core/` 算法核心经 Pyodide 在浏览器运行**(Python 代码零重写,保算法一致性);备选:核心案例预计算为 JSON + 轻量 JS 页面;
- 内容:教学实验六步流程的交互式复刻(参数滑块 → 曲线/拟合实时更新),重点展示三组核心比较;
- 约束:不影响主线进度;所有演示参数与记录包对应;不承载任何"实测"表述。
- **副产品**:不进入任务书交付清单,不参与里程碑验收;
- **同步开发**:整个软件构建周期较长,网站与主线并行推进,每个里程碑完成后同步部署对应增量,作为阶段性成果的对外展示窗口;
- **优先级**:与主线时间冲突时主线优先;网站只做"薄壳",不反向拖慢算法开发。
### B.2 技术路线(M0 锁定,因为它决定 core 的约束)
- **静态站 + Pyodide**:同一 `core/` Python 算法核心经 Pyodide 在浏览器运行,前端用 ECharts 渲染——算法零重写,与论文/CLI 结果天然一致;
- 无后端、无数据库:nginx 纯静态托管,零运维成本;
- 重计算场景(如 200 次蒙特卡洛):默认加载预计算记录包 JSON,另提供小规模交互重算;
- core 的浏览器兼容约束已在 §5.1 定义,从 M0 第一行代码起生效。
### B.3 部署
| 项 | 说明 |
|---|---|
| 域名 | `https://chenxy.biboer.cn`(HTTPS 已配置,证书有效期至 2027-01-10) |
| 服务器 | 24.233.3.126(`ssh web`),nginx 当前为 302 占位配置,首次部署时替换为静态站点 root |
| 发布方式 | `deploy.sh` 一键同步:rsync `web/` + `core/*.py` + 记录包 JSON 至站点目录,nginx reload |
| 目录 | 站点根仅放静态产物;不部署源码与无关文件 |
### B.4 内容纪律(诚信红线在网站的落实)
- 页面显著标注"仿真演示,非实测数据";
- 展示的每个案例对应一个实验记录包(页面附 `meta.json` 摘要:参数/种子/运行日期);
- 不出现"整机 2.5ns 时间分辨率"等性能表述,措辞与软件一致("等效时间细分");
- 不展示未通过主线验收的功能。
---