fmq
cd370d88e7
将 TLUSTY/SYNSPEC 拆为各自独立的 enabled/policy/strategies 阶段，
以策略链自动弹栈取代单级 seed_step 布尔回退；定向修复 2026-08-02
僵尸任务涡旋事故；新增节点并发配额热调；前端详情页从 1412 行巨型
视图拆为薄控制器 + detail 子模块，并补齐工具层与单测。
引擎与调度（task_engine_decoupling_design.md）
- models.rs: 新增 StagePolicy / EngineStageConfig / TaskSpec 阶段字段、
normalize_compat() 校正旧版在途消息策略链、failed_stage 归因
- scheduler.rs: resolve_dispatchable_chain 派发门控、
trigger_strategy_fallback 按 failed_stage 精确弹栈；启动期
force_recompute/skip_converged(默认)/skip_failed 三策略
- db.rs: tasks 表 +7 列持久化阶段配置；终态守卫
(mark_grid_point_running 仅 pending/queued→running；
record_task_report 拒绝迟到失败翻黑 converged)；策略弹栈快照
僵尸涡旋修复（runbook-20260802-zombie-vortex-fix.md）
- 全链路跨库活性交叉校验：派发/claim/孤儿回收/回退统一查 MQ 队列活性，
活则放行、死则清僵尸，结构性消除"每点重复派发"
- stop/重启卫生：清队列同步 delete_tasks_by_ids，杜绝遗留 pending 行
- report_task: 幂等吸收 + 409 区分迟到冗余结果，仅 state_changed 时回退
- MQ: NULL workflow_name 回填 __legacy__、requeue 后迟到上报被 403 竞态修复
动态 CPU 配额（dynamic_cpu_slots_design.md）
- admin.rs: POST /admin/nodes/:id/quota（Option<Option<i32>> 区分
缺字段/显式 null）；nodes 表 +admin_max_slots
- worker.rs: effective_max_slots = min(admin, physical)，心跳下发原子生效
科学产物保全（tlusty_result_artifacts.md）
- runner.rs: SYNSPEC 启动前快照 fort.12/fort.14 → .bfac/.emflux 防覆盖
- 半失败点(大气收敛+光谱失败)改判 Failed 并写入 note；仅 SYNSPEC
场景不再恒判失败；撤销归档 LRU 200 上限改为永久保留
- executor.rs: 透传 synspec_params 数值参数（此前固定 None）
前端（dashboard/）
- workflowDetail.js 1412→328 行，拆出 views/detail/{ctx,overview,
pointsTable,parSets,pointPanel}.js，AbortController 治理监听/请求生命周期
- 删除 wfActions.js，新增 wfEnginePanel.js（双阶段三维配置编辑面板）
- 新增 utils/{errors,format,icons,polling,yamlStage}.js 纯函数模块
- 路由级动态 import 代码分割；节点配额三点菜单 + Modal 管理
- 首次引入 node:test 单测（format/polling/yamlStage/psCache，644 行）
- 系统性补齐 a11y：skip-link、ARIA、Tab 键盘漫游、toast 关闭、退出动画
文档与工具
- 新增 6 篇设计/调研：引擎解耦、动态配额、涡旋 runbook、
光谱正确性分析、收敛判断、产物归档
- PIPELINE/design/api/database 等协同重写为分布式 C/S 架构口径
- scripts/fetch_results.sh 跨节点产物备份；import_results 按 cno 升序导入
- workflows/sdB_cno.yaml: 新增 tlusty/synspec_stage 配置块，修正 wstart 笔误
2.8 KiB
2.8 KiB
DCTS 开发者与参与贡献指南 (Contributing Guide)
感谢关注并参与 DCTS (Distributed Computing TLUSTY/SYNSPEC) 的开发！本文档为开发者提供本地环境配置、代码库结构说明及测试规范。
1. 本地开发环境准备
必备依赖
- Rust 工具链：1.75+ (推荐使用
rustup安装) - C/Fortran 编译器（计算节点模拟调试需
gfortran或预编译好的二进制） - SQLite 3开发库（嵌入在 Rust dependencies 中，无需额外安装系统库）
克隆与编译
cd dcts
cargo check --workspace --all-targets
cargo build
2. 代码库结构 (Workspace Layout)
dcts/
├── Cargo.toml # Workspace 根配置
├── crates/
│ ├── common/ # [Library] 物理计算引擎、子进程管理、收敛检测、种子匹配与归档白名单
│ ├── server/ # [Binary] Axum HTTP REST 服务端与 Scheduler
│ ├── node/ # [Binary] Worker 节点 Daemon 与任务抢占回路
│ └── mq/ # [Library] SQLite 事务型分布式任务队列
├── dashboard/ # [Web] ESM 模块化运维看板（Vite）
├── workflows/sdB_cno.yaml # 示例网格工作流配置
├── tools/
│ └── import_results/ # [Binary] 历史计算结果导入工具（旧版网格结果 → 种子/收敛入库）
├── scripts/ # 结果拉取等运维脚本
└── docs/ # 分主题架构与规格技术文档
3. 测试与规范 (Testing & Guidelines)
3.1 运行单元测试与集成测试
# 运行 Workspace 内所有单元测试
cargo test --workspace
# 针对核心物理解析模块独立测试
cargo test -p common
3.2 代码风格与 Linting
提交 PR 前请确保以下命令无 error 和 warning：
# 代码格式化
cargo fmt --all -- --check
# Rust 官方 Linter 静态检查
cargo clippy --workspace --all-targets -- -D warnings
4. 提交 Code Review 规范
- 分支策略：从
main切出特性分支，推荐命名如feature/seed-optimizer或fix/stale-node-leak。 - Commit Message 规范：遵循 Conventional Commits，格式为
<type>(<scope>): <description>，如：feat(common): 有向 CNO 距离种子匹配fix(server): 修复调度竞态与僵尸任务自愈type∈feat/fix/refactor/docs/test/chore/perf/ci；scope常用common/server/node/mq/dashboard/all。
- 保持文档更新：若修改了 API 接口定义或数据库 Schema，请同步更新
docs/api.md、docs/database.md，以及物理/调度设计文档（docs/design.md、docs/task_engine_decoupling_design.md）。