TA-skill

可迁移的瞬态吸收（TA）光谱数据处理工作流，包含：

• ta-spectroscopy-workflow/：Codex skill、科学脚本、参考文档和回归测试；
• code/：与 skill 科学脚本保持同步的兼容入口；
• dashboard/：用于查看 TA、chirp、IRF、t0、去卷积和全局拟合结果的 Vinext/React 控制台。

科学流程

1. 将原始数据整理为标准 CSV 矩阵；
2. 进行 chirp 估计与校正；
3. 从独立溶剂/相干响应或样品信号提取 IRF；
4. 对动力学模型执行 IRF 前向卷积和 SVD/全局拟合；
5. 通过 manifest 校验并按需导出 Dashboard 数据。

科学脚本以 ta-spectroscopy-workflow/scripts/ 为规范版本。运行时使用脚本自身位置解析依赖，不依赖固定盘符或当前工作目录。

运行完整流程

在仓库根目录执行：

python ta-spectroscopy-workflow/scripts/ta_pipeline.py run `
  --input "path/to/sample_raw.csv" `
  --input-state raw `
  --calibration "path/to/solvent_or_glass.csv" `
  --irf-trace "path/to/irf_trace.csv" `
  --out "path/to/ta-analysis" `
  --wl-range 535 700 `
  --dashboard-data-dir "dashboard/public/data"

Dashboard 数据目录默认不包含在 Git 仓库中。完成科学分析后，将结果导出到 dashboard/public/data，再启动控制台：

python ta-spectroscopy-workflow/scripts/export_dashboard_data.py `
  --workflow-dir "path/to/ta-analysis" `
  --target "dashboard/public/data"

Set-Location dashboard
npm install
npm run dev

验证

python -m pytest ta-spectroscopy-workflow/tests
Set-Location dashboard
npm test

运行产物、原始数据、依赖缓存和构建目录不纳入源码仓库；它们应通过 manifest 和发布清单单独归档。