Simulated Peak Plot
触发条件
正向触发：
- 说出"生成峰图"、"模拟信号"、"创建峰谱"
- 说出"可视化保留时间"、"输出 Markdown 表格"
- 说出"导入 CSV 数据"、"生成模拟数据"
- 需要色谱/光谱峰模拟、信号可视化、数据导出等场景
- Python API 调用（直接导入函数生成信号数据）：
否定条件：
除非用户明确提到生成峰图或模拟数据，否则不要主动触发。
快速开始
场景：混合正负峰峰谱
> 模拟色谱中溶剂峰倒置场景，同一谱图正峰和负峰共存
生成包含正峰和负峰的峰谱
- 输入: 时间范围 5~15 min, scan_rate=100, 正峰 (RT=7.7, height=1500, HWHM=0.08), 负峰 (RT=10.3, height=-1200, HWHM=0.12), baseline=20, noise=8
- 输出: 生成 PNG 峰图（正峰向上、负峰向下，Y轴自动包含负区间），打印 Markdown 数据表格
场景：单峰生成 + CSV 导出
> 基础用法，验证单峰生成和数据导出两个核心功能
生成一个高斯峰并导出完整数据
- 输入: 时间范围 0~10 min, scan_rate=200, 单峰 (RT=5.0, height=800, HWHM=0.1), baseline=10, noise=5, export_csv=true
- 输出: 生成 PNG 峰图 + CSV 文件（含全部数据点，RFC 4180 格式），打印 Markdown 采样表格
场景：簇峰 + 融峰混合谱
> 验证簇峰独立标注和融峰合并标注两种混合使用场景
生成包含簇峰和融峰的复杂谱图
- 输入: 时间范围 4~14 min, scan_rate=120, 单峰 (RT=5.5, height=500, HWHM=0.1), 簇峰 (3子峰: RT=7.0,8.0,9.0, height=1000,800,600, HWHM=0.15), 融峰 (2子峰: RT=11.0,12.0, height=700,500, HWHM=0.12)
- 输出: 生成 PNG 峰图，簇峰各子峰独立标注为 {name}-1/2/3，融峰只有单一标注在最高点
概述
本技能用于生成模拟峰图（高斯峰），适用于教学、测试或演示场景。支持：
- 多种峰类型，包括复合峰（任意数量子峰组合）
- 负峰（倒峰）：配置 height 为负数即可产生朝下的倒峰
- 可自定义时间范围、基线和噪声
- 可自定义坐标轴标题和单位（X/Y标签，mV/V/吸光度等）
- CSV完整数据导出（全部数据点）
- 可点击的 file:/// 路径，方便直接打开图片
- Markdown 表格数据输出（在控制台打印）
- 交互式配置，带点数推荐
⚠️ 重要限制（使用前必读）
| 参数 | 建议范围 | 说明 |
|---|---|---|
| 峰组数量（含子峰） | ≤ 20 组 | 过多会导致生成缓慢 |
| 扫描速率 scan_rate | 50 ~ 500 pts/min | 过低锯齿，过高文件大 |
| 总点数 | ≤ 20000 | 超过时请降 scan_rate |
| HWHM | > 0 | 半高半宽必须为正数 |
| RT | 应在 [t_start, t_end] 内 | 否则峰部分在画布外 |
| 负峰 | height 为负，HWHM 仍为正 | 不需要改 baseline |
> 更多反模式与避坑指南 → 渐进式文件索引表
> 常见问题解答 → 渐进式文件索引表
渐进式文件索引
| 文件名 | 分类 | 包含内容 | 审计关联 |
|---|---|---|---|
references/LICENSE.md |
许可协议 | 开源许可证声明（MIT）。包含：MIT 许可证完整文本。 | R-26 |
references/antipatterns.md |
规范指南 | skill 编写中的常见反模式。包含：错误做法示例、正确做法示例、避坑指引。 | R-18 |
references/changelog.md |
版本管理 | 版本更新日志。包含：版本号、更新类型、修复项、升级说明。 | R-24 |
references/faq.md |
常见问题 | 常见疑问与解答。包含：问题分类、原因分析、解决方案。 | R-19, R-25 C-19 |
references/features.md |
参考文档 | 将 height 设为负数即可生成倒峰。Y轴自动缩放包含负区间，标注自动反向指向下方。 | 无 |
references/parameters.md |
参考文档 | 本文档提供模拟峰图生成中所有参数的详细信息。 | 无 |
references/permissions.md |
权限与测试 | 权限扫描说明与测试结论。包含：风险等级、高权限操作说明、测试概览、计时统计。 | R-15, R-16 |
references/test-report.md |
测试报告 | 技能功能测试与场景测试结论报告。包含：测试结果、修复项、测试覆盖说明。 | 无 |
文件目录结构
├── SKILL.md
├── _meta.json
├── scripts/
│ └── generate_peak.py
└── references/
├── antipatterns.md
├── changelog.md
├── faq.md
├── features.md
├── LICENSE.md
├── parameters.md
├── permissions.md
└── test-report.md
工作流程
> 📚 渐进式加载：本技能采用渐进式 MD 体系，SKILL.md 为入口（≤230行），详细内容拆分到 references/*.md 按需加载。
1. 环境检查
始终从检查环境开始：
# 检查 Python 可用性
python --version
# 检查必需包
python -c "import numpy; import matplotlib; print('所有包可用')"
如果缺少包，指导用户安装：
pip install numpy matplotlib
2. 参数配置
通过对话配置。先显示点数推荐表，再询问峰参数、基线/噪声、输出选项。
默认: 起始5min/结束15min/scan_rate=100, 空白峰+3子峰复合峰, baseline=20, noise=8。
3. 点数推荐
总点数 = duration × scan_rate。scan_rate 默认 100 pts/min。
推荐: 短时(5-10min)用80-120 pts/min, 长时(30+)用50-70 pts/min。
4. 生成图表
python {SKILL_DIR}/scripts/generate_peak.py --interactive
5. 输出
PNG + Markdown 表格 + CSV(data_dir)。输出路径：file:///... 可直接点击。
新功能
支持：负峰(倒峰) / 簇峰(各子峰独立标注) / 融峰(合成信号单标注) / 扫描速率(pts/min) / 碰撞避让标注布局。
簇峰 / 融峰
- 簇峰 (cluster): 各子峰独立标注为 {name}-N，type: "cluster"（兼容旧 "composite"）
- 融峰 (merged): 多子峰合成信号，单一标注在真实最高点
文件引用
- 脚本: 主生成脚本
- 参数参考: 详细参数文档
{SKILL_DIR}/scripts/generate_peak.py
{SKILL_DIR}/references/parameters.md
{SKILL_DIR}/references/features.md
使用示例
用户请求: "生成包含5个峰（含1个3子峰簇峰）的峰谱，输出数据为表格"
响应工作流:
1. 检查环境
2. 显示点数推荐表
3. 询问峰参数
4. 生成带 Markdown 表格输出的光谱
5. 保存PNG文件并在控制台打印表格
自定义选项
用户可以更新:
- 峰数量（包括簇峰/融峰的多子峰组合）
- 峰参数（RT、高度、HWHM）— height 设为负数即为负峰
- 峰类型: 单峰 / 簇峰 (cluster) / 融峰 (merged)
- 扫描速率 (scan_rate, pts/min)
- 噪声和基线水平
- 坐标轴标题和单位
- CSV导出 / 网格线 / 标注控制(annotate: false)
JSON 配置示例
> 簇峰的每个子峰会独立标注; 融峰只在最高子峰处标注为单一名称。
CSV 输出格式（RFC 4180 标准）
Time_min,Signal_mV
2.000000,49.782199
2.020040,46.140969
...
触发场景
正向触发（满足以下任意一条）：
- 用户需要模拟峰图生成器 (Simulated Peak Plot Generator)
- 用户需要生成可定制的高斯峰图，支持复合峰（N个子峰组合）和 Markdown 表格输出。
- 用户需要复合峰可形成多种形状：M形、馒头形、泊松分布形等。
- 用户需要优雅处理 Ctrl+C 中断信号
否定条件（满足以下任意一条，不触发）：
- 简单问答、闲聊、问候（不需要本技能）
- 单步任务（不需要结构化执行）
