orca-slicer

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Skill: orca-slicer

技能:OrcaSlicer

OrcaSlicer Manager — Profile Creation, Calibration & Settings Expert

OrcaSlicer管理器 — 配置文件创建、校准与设置专家

Expert assistant for OrcaSlicer: creates and edits printer/filament/process profiles, guides calibration workflows, explains every setting, generates custom G-code with placeholders, and diagnoses common print quality issues.

OrcaSlicer专属专家助手:创建和编辑打印机/耗材/工艺配置文件,指导校准工作流,解释各项设置,生成带占位符的自定义G-code,并诊断常见打印质量问题。

Activation

激活场景

Use this skill when the user asks about:
  • Creating or editing OrcaSlicer profiles (printer, filament, process)
  • Understanding any OrcaSlicer setting or what value to use
  • Running a calibration (temperature, flow, pressure advance, retraction, etc.)
  • Writing or debugging custom start/end G-code with placeholder variables
  • Diagnosing print quality issues (stringing, under-extrusion, ringing, layer adhesion, etc.)
  • Connecting OrcaSlicer to Klipper, OctoPrint, or PrusaLink
  • Generating optimized profiles for specific use cases (functional parts, miniatures, speed, visual quality)

当用户询问以下内容时,使用本技能:
  • 创建或编辑OrcaSlicer配置文件(打印机、耗材、工艺)
  • 理解OrcaSlicer的任意设置或应使用的参数值
  • 执行校准操作(温度、流量、压力提前、回抽等)
  • 编写或调试带占位符变量的自定义开始/结束G-code
  • 诊断打印质量问题(拉丝、挤出不足、振纹、层间附着力差等)
  • 将OrcaSlicer连接到Klipper、OctoPrint或PrusaLink
  • 为特定使用场景生成优化配置文件(功能零件、微缩模型、高速打印、视觉质量优先)

Platform Notes

平台说明

OrcaSlicer runs on Windows, macOS, and Linux. Profile files are JSON and work identically across platforms. All paths below use the notation:
PlaceholderWindowsmacOSLinux
<config>
%APPDATA%\OrcaSlicer
~/Library/Application Support/OrcaSlicer
~/.config/OrcaSlicer
<install>
C:\Program Files\OrcaSlicer
/Applications/OrcaSlicer.app/Contents
AppImage mount or install dir
Profile cache lives at
<config>/system/
delete it to force OrcaSlicer to reload profiles after manual edits to
<install>/resources/profiles/
.
User-created profiles live at
<config>/user/
.

OrcaSlicer可在Windows、macOS和Linux系统运行。配置文件为JSON格式,跨平台通用。以下所有路径采用如下表示法:
占位符WindowsmacOSLinux
<config>
%APPDATA%\OrcaSlicer
~/Library/Application Support/OrcaSlicer
~/.config/OrcaSlicer
<install>
C:\Program Files\OrcaSlicer
/Applications/OrcaSlicer.app/Contents
AppImage挂载目录或安装目录
配置文件缓存位于
<config>/system/
—— 手动编辑
<install>/resources/profiles/
后,删除该缓存目录可强制OrcaSlicer重新加载配置文件。
用户创建的配置文件位于
<config>/user/

Phase 1: Understand the User's Setup

阶段1:了解用户设备配置

Before giving advice, establish:
  1. Printer — make/model, kinematics (Cartesian, CoreXY, Delta), build volume
  2. Nozzle — diameter (0.2 / 0.4 / 0.6 / 0.8mm), material (brass, hardened, ruby)
  3. Filament type — PLA / PETG / ABS / ASA / TPU / PA / PC / etc.
  4. Firmware — Klipper, Marlin, RepRapFirmware, PrusaFirmware, Bambu
  5. Goal — speed, visual quality, functional strength, miniatures, multicolor
If the user has a Klipper printer, recommend adding to
printer.cfg
:
ini
[exclude_object]
[gcode_arcs]
resolution: 0.1

提供建议前,请先确认以下信息:
  1. 打印机 — 品牌/型号、运动学类型(笛卡尔、CoreXY、三角洲)、打印体积
  2. 喷嘴 — 直径(0.2/0.4/0.6/0.8mm)、材质(黄铜、硬化钢、红宝石)
  3. 耗材类型 — PLA / PETG / ABS / ASA / TPU / PA / PC / 等
  4. 固件 — Klipper、Marlin、RepRapFirmware、PrusaFirmware、Bambu
  5. 打印目标 — 高速、视觉质量、功能强度、微缩模型、多色打印
如果用户使用Klipper打印机,建议在
printer.cfg
中添加:
ini
[exclude_object]
[gcode_arcs]
resolution: 0.1

Phase 2: Profile Architecture

阶段2:配置文件架构

OrcaSlicer uses a 4-level JSON profile hierarchy. See
references/profiles.md
for full details.
Vendor meta (.json)
└── Printer model (machine_model)
    └── Printer variant (machine)   ← nozzle-specific
        ├── Process profile          ← layer height, speeds, quality
        └── Filament profile         ← temps, flow, cooling, PA
OrcaSlicer采用4层级JSON配置文件结构。完整细节请参考
references/profiles.md
厂商元数据 (.json)
└── 打印机型号 (machine_model)
    └── 打印机变体 (machine)   ← 喷嘴专属
        ├── 工艺配置文件          ← 层高、速度、质量参数
        └── 耗材配置文件         ← 温度、流量、冷却、压力提前

Profile Locations (installed)

已安装配置文件位置

<install>/resources/profiles/
├── VendorName.json               ← vendor meta
└── VendorName/
    ├── machine/
    │   ├── PrinterModel.json     ← machine_model
    │   └── PrinterModel 0.4 nozzle.json  ← machine
    ├── process/
    │   └── 0.20mm Standard @PrinterModel 0.4.json
    └── filament/
        └── Generic PLA @PrinterModel@.json
<install>/resources/profiles/
├── VendorName.json               ← 厂商元数据
└── VendorName/
    ├── machine/
    │   ├── PrinterModel.json     ← machine_model
    │   └── PrinterModel 0.4 nozzle.json  ← machine
    ├── process/
    │   └── 0.20mm Standard @PrinterModel 0.4.json
    └── filament/
        └── Generic PLA @PrinterModel@.json

Profile Naming Convention

配置文件命名规范

TypePattern
Vendor meta
VendorName.json
Machine model
VendorName PrinterName.json
Machine variant
VendorName PrinterName 0.4 nozzle.json
Process
0.20mm Standard @VendorName PrinterName 0.4.json
Filament
Generic PLA @VendorName PrinterName@.json

类型格式
厂商元数据
VendorName.json
打印机型号
VendorName PrinterName.json
打印机变体
VendorName PrinterName 0.4 nozzle.json
工艺配置
0.20mm Standard @VendorName PrinterName 0.4.json
耗材配置
Generic PLA @VendorName PrinterName@.json

Phase 3: Calibration Workflows

阶段3:校准工作流

Always follow this order when calibrating from scratch. See
references/calibration.md
for step-by-step detail on each test.
从零开始校准时,请始终遵循以下顺序。每个测试的分步细节请参考
references/calibration.md

Recommended Calibration Order

推荐校准顺序

  1. Temperature — find optimal nozzle temp for layer adhesion vs. stringing
  2. Max Volumetric Speed — find the flow ceiling before under-extrusion
  3. Pressure Advance — reduce corner bulging and improve dimensional accuracy
  4. Flow Rate — fine-tune extrusion multiplier for accurate dimensions
  5. Retraction — eliminate stringing
  6. Cornering (Jerk / Junction Deviation) — reduce corner artifacts
  7. Input Shaping — eliminate ringing/ghosting (accelerometer required)
  8. VFA — find resonance-free speed ranges
  9. Tolerance (optional) — tune for tight-fitting parts
All calibrations are under Calibration tab in OrcaSlicer. After each calibration, create a new project to exit calibration mode before printing normally.
  1. 温度校准 — 找到兼顾层间附着力与抗拉丝的最优喷嘴温度
  2. 最大体积流速 — 找到挤出不足前的流量上限
  3. 压力提前(Pressure Advance) — 减少角落鼓包,提高尺寸精度
  4. 流量速率 — 微调挤出倍率以保证尺寸准确
  5. 回抽设置 — 消除拉丝现象
  6. 转角设置(Jerk / Junction Deviation)— 减少角落瑕疵
  7. 输入整形(Input Shaping) — 消除振纹/鬼影(需加速度计)
  8. VFA测试 — 找到无共振的速度区间
  9. 公差校准(可选)— 为精密配合零件调校参数
所有校准操作均可在OrcaSlicer的「校准」标签页中进行。每次校准后,创建新项目退出校准模式,再进行常规打印。

Quick Calibration Decision Tree

快速校准决策树

SymptomRun This
StringingTemp ↓, then Retraction
Under-extrusionTemp ↑, then Max Volumetric Speed, then Flow Rate
Corner bulgingPressure Advance
Ringing / ghostingInput Shaping
Wrong dimensionsFlow Rate, then Tolerance
VFA bands / zebra stripesVFA speed test
Rough top surfaceFlow Rate, Ironing

问题症状执行校准
拉丝降低温度,然后校准回抽
挤出不足升高温度,然后校准最大体积流速,再校准流量速率
角落鼓包压力提前校准
振纹/鬼影输入整形校准
尺寸偏差流量速率校准,然后公差校准
VFA条纹/斑马纹VFA速度测试
顶面粗糙流量速率校准,启用熨平功能

Phase 4: Key Settings Reference

阶段4:关键设置参考

See
references/settings.md
for the full annotated settings reference.
完整带注释的设置参考请见
references/settings.md

Quick Values by Intent

按打印目标推荐参数

Functional / Engineering Parts

功能/工程零件

layer_height:          0.20–0.30mm
wall_loops:            4–6
top/bottom_shell_layers: 5–7
infill_density:        40–60%
infill_pattern:        gyroid / cubic / grid
print_speed:           60–120 mm/s (match MVS)
enable_support:        true (tree support for overhangs > 50°)
layer_height:          0.20–0.30mm
wall_loops:            4–6
top/bottom_shell_layers: 5–7
infill_density:        40–60%
infill_pattern:        gyroid / cubic / grid
print_speed:           60–120 mm/s(匹配最大体积流速)
enable_support:        true(悬垂角度>50°时使用树形支撑)

Visual / Display Quality

视觉/展示级质量

layer_height:          0.08–0.15mm
wall_loops:            3–4
wall_sequence:         inner/outer/inner (sandwich)
seam_position:         back or aligned
ironing_type:          top surfaces
print_speed:           40–80 mm/s
layer_height:          0.08–0.15mm
wall_loops:            3–4
wall_sequence:         inner/outer/inner(三明治顺序)
seam_position:         背面或对齐模式
ironing_type:          顶面熨平
print_speed:           40–80 mm/s

Speed / Draft

高速/草稿打印

layer_height:          0.25–0.35mm
wall_loops:            2
infill_density:        10–15%
print_speed:           150–300 mm/s (limited by MVS)
acceleration:          limited by printer capability / input shaper result
layer_height:          0.25–0.35mm
wall_loops:            2
infill_density:        10–15%
print_speed:           150–300 mm/s(受最大体积流速限制)
acceleration:          受打印机性能/输入整形结果限制

Miniatures / Fine Detail

微缩模型/精细细节

layer_height:          0.04–0.10mm (requires 0.2mm nozzle)
line_width:            0.10–0.15mm
wall_loops:            3
support:               tree support, small interface spacing

layer_height:          0.04–0.10mm(需0.2mm喷嘴)
line_width:            0.10–0.15mm
wall_loops:            3
support:               树形支撑,小间距支撑界面

Phase 5: Custom G-Code

阶段5:自定义G-code

OrcaSlicer exposes rich placeholder variables in machine start/end G-code, filament start/end G-code, layer change G-code, and toolchange G-code.
See
references/placeholders.md
for the complete variable reference.
OrcaSlicer在打印机开始/结束G-code、耗材开始/结束G-code、层切换G-code和换刀G-code中提供丰富的占位符变量。
完整变量参考请见
references/placeholders.md

Common Start G-Code Patterns (Klipper)

Klipper通用开始G-code示例

gcode
; --- Machine Start G-code for Klipper ---
M104 S0                          ; cancel any temp from preview
M140 S0
PRINT_START BED={first_layer_bed_temperature[0]} EXTRUDER={first_layer_temperature[0]}
gcode
; --- Machine Start G-code (inline heating) ---
G28                              ; home
M190 S{first_layer_bed_temperature[0]}   ; wait for bed
M109 S{first_layer_temperature[0]}       ; wait for nozzle
G29                              ; bed leveling (if not in PRINT_START)
gcode
; --- Klipper打印机开始G-code ---
M104 S0                          ; 取消预览阶段的温度设置
M140 S0
PRINT_START BED={first_layer_bed_temperature[0]} EXTRUDER={first_layer_temperature[0]}
gcode
; --- 内置加热的打印机开始G-code ---
G28                              ; 回零
M190 S{first_layer_bed_temperature[0]}   ; 等待床温达到目标
M109 S{first_layer_temperature[0]}       ; 等待喷嘴温度达到目标
G29                              ; 床面调平(若未包含在PRINT_START中)

Layer Change G-Code

层切换G-code

gcode
; pause at layer 3 for color change
{if layer_num == 3}M600{endif}
gcode
; 第3层暂停以更换耗材
{if layer_num == 3}M600{endif}

Conditional G-Code Syntax

条件G-code语法

gcode
{if condition}...{endif}
{if condition}...{else}...{endif}
{value|default(fallback)}
gcode
{if condition}...{endif}
{if condition}...{else}...{endif}
{value|default(fallback)}

Temperature Placeholders

温度占位符

gcode
M104 S{first_layer_temperature[0]}         ; initial layer nozzle
M190 S{first_layer_bed_temperature[0]}     ; initial layer bed
M104 S{nozzle_temperature[0]}              ; normal printing temp
M140 S{bed_temperature[0]}                 ; normal bed temp

gcode
M104 S{first_layer_temperature[0]}         ; 首层喷嘴温度
M190 S{first_layer_bed_temperature[0]}     ; 首层床温
M104 S{nozzle_temperature[0]}              ; 常规打印喷嘴温度
M140 S{bed_temperature[0]}                 ; 常规打印床温

Phase 6: Filament Profiles — Key Parameters

阶段6:耗材配置文件 — 关键参数

ParameterPLAPETGABS/ASATPUPA/Nylon
Nozzle temp190–220°C230–250°C235–260°C210–240°C240–280°C
Bed temp55–65°C70–85°C100–115°C30–60°C70–90°C
Chamber40–50°C50–60°C
Fan speed80–100%20–50%0–20%50–80%0–30%
Flow ratio0.95–1.00.95–1.00.95–1.00.9–1.00.95–1.0
Max vol. speed12–20 mm³/s8–15 mm³/s8–12 mm³/s3–8 mm³/s6–12 mm³/s
Pressure advance0.02–0.060.04–0.100.02–0.060.05–0.150.03–0.08
Retraction (DD)0.4–1.0mm0.5–1.5mm0.5–1.0mm1.0–3.0mm0.5–1.5mm
Retraction (Bowden)3–6mm4–7mm4–7mm2–4mm4–8mm

参数PLAPETGABS/ASATPUPA/尼龙
喷嘴温度190–220°C230–250°C235–260°C210–240°C240–280°C
床温55–65°C70–85°C100–115°C30–60°C70–90°C
腔温40–50°C50–60°C
风扇转速80–100%20–50%0–20%50–80%0–30%
流量比率0.95–1.00.95–1.00.95–1.00.9–1.00.95–1.0
最大体积流速12–20 mm³/s8–15 mm³/s8–12 mm³/s3–8 mm³/s6–12 mm³/s
压力提前0.02–0.060.04–0.100.02–0.060.05–0.150.03–0.08
回抽距离(直接驱动)0.4–1.0mm0.5–1.5mm0.5–1.0mm1.0–3.0mm0.5–1.5mm
回抽距离(Bowden)3–6mm4–7mm4–7mm2–4mm4–8mm

Phase 7: Diagnosing Print Quality Issues

阶段7:打印质量问题诊断

IssueLikely CauseSetting to Adjust
StringingTemp too high, retraction too lowLower temp, increase retraction, check PA
Under-extrusionTemp too low, flow too fast, cloggedRaise temp, reduce speed, check flow ratio
Over-extrusionFlow ratio too highReduce
filament_flow_ratio
Corner bulgingPA too lowIncrease
pressure_advance
Ringing/ghostingMechanical resonanceRun Input Shaping calibration
Layer adhesion failureTemp too lowRaise nozzle temp
WarpingBed temp too low, no enclosureRaise bed temp, add brim, enclose printer
Elephant footFirst layer too squishedRaise z-offset, or enable "elephant foot compensation"
Gaps in top surfaceFlow too low, or top speed too highIncrease flow ratio, reduce top surface speed
Pillowing on topCooling too aggressive, too few top layersReduce fan, add top layers
Support not removableInterface too tightIncrease support/object gap, use PETG interface for PLA
Seam visibleSeam position not idealUse "aligned" or "rear" seam, or scarf seam
VFA / zebra bandsResonance at specific speedVFA test to find and avoid resonant speeds

问题可能原因调整设置
拉丝温度过高、回抽距离不足降低温度,增加回抽距离,检查压力提前参数
挤出不足温度过低、流速过快、喷嘴堵塞升高温度,降低打印速度,检查流量比率
挤出过量流量比率过高降低
filament_flow_ratio
参数
角落鼓包压力提前值过低提高
pressure_advance
参数
振纹/鬼影机械共振执行输入整形校准
层间附着力差温度过低提高喷嘴温度
翘边床温过低、无封闭打印舱提高床温,添加裙边,使用封闭打印舱
大象脚首层挤压过紧提高Z轴偏移量,或启用“大象脚补偿”功能
顶面缝隙流量过低、顶面打印速度过快提高流量比率,降低顶面打印速度
顶面鼓包冷却过度、顶层层数不足降低风扇转速,增加顶层层数
支撑难以去除支撑界面过紧增大支撑与模型间隙,PLA模型使用PETG支撑界面
接缝明显接缝位置不合理使用“对齐”或“背面”接缝模式,或斜接接缝
VFA条纹/斑马纹特定速度下共振执行VFA测试,避开共振速度

Phase 8: Network Printer Integration

阶段8:网络打印机集成

Klipper (via Moonraker)

Klipper(通过Moonraker)

In OrcaSlicer: Printer Settings → Connection
  • Protocol:
    Moonraker
  • Hostname/IP:
    <printer_ip>
  • Port:
    7125
  • API key: (leave blank if not configured)
在OrcaSlicer中:打印机设置 → 连接
  • 协议:
    Moonraker
  • 主机名/IP:
    <printer_ip>
  • 端口:
    7125
  • API密钥:(未配置则留空)

OctoPrint

OctoPrint

  • Protocol:
    OctoPrint
  • Hostname/IP:
    <printer_ip>
  • Port:
    5000
    (default)
  • API key: from OctoPrint → Settings → Application Keys
  • 协议:
    OctoPrint
  • 主机名/IP:
    <printer_ip>
  • 端口:
    5000
    (默认)
  • API密钥:从OctoPrint → 设置 → 应用密钥获取

PrusaLink (Prusa MK4 / XL)

PrusaLink(Prusa MK4 / XL)

  • Protocol:
    PrusaLink
  • Hostname/IP:
    <printer_ip>
  • Password: found on printer screen
  • 协议:
    PrusaLink
  • 主机名/IP:
    <printer_ip>
  • 密码:在打印机屏幕上查看

Bambu Lab

Bambu Lab

  • Uses the proprietary Bambu networking plugin (optional install)
  • Cloud mode requires Bambu account
  • LAN mode: enable on printer, set access code in OrcaSlicer

  • 使用专属Bambu网络插件(可选安装)
  • 云模式需绑定Bambu账号
  • LAN模式:在打印机上启用,在OrcaSlicer中设置访问码

Phase 9: Profile JSON Structure

阶段9:配置文件JSON结构

Minimal Printer Variant (machine) Profile

最简打印机变体(machine)配置文件

json
{
  "type": "machine",
  "name": "MyPrinter 0.4 nozzle",
  "inherits": "fdm_machine_common",
  "from": "system",
  "instantiation": "true",
  "nozzle_diameter": ["0.4"],
  "printer_model": "MyPrinter",
  "printer_variant": "0.4",
  "printable_area": ["0x0", "235x0", "235x235", "0x235"],
  "printable_height": 250,
  "default_filament_profile": ["Generic PLA @System"],
  "default_print_profile": "0.20mm Standard @MyPrinter 0.4",
  "machine_start_gcode": "PRINT_START BED={first_layer_bed_temperature[0]} EXTRUDER={first_layer_temperature[0]}",
  "machine_end_gcode": "PRINT_END"
}
json
{
  "type": "machine",
  "name": "MyPrinter 0.4 nozzle",
  "inherits": "fdm_machine_common",
  "from": "system",
  "instantiation": "true",
  "nozzle_diameter": ["0.4"],
  "printer_model": "MyPrinter",
  "printer_variant": "0.4",
  "printable_area": ["0x0", "235x0", "235x235", "0x235"],
  "printable_height": 250,
  "default_filament_profile": ["Generic PLA @System"],
  "default_print_profile": "0.20mm Standard @MyPrinter 0.4",
  "machine_start_gcode": "PRINT_START BED={first_layer_bed_temperature[0]} EXTRUDER={first_layer_temperature[0]}",
  "machine_end_gcode": "PRINT_END"
}

Minimal Filament Profile

最简耗材配置文件

json
{
  "type": "filament",
  "name": "Generic PLA @MyPrinter@",
  "inherits": "Generic PLA @System",
  "from": "system",
  "instantiation": "true",
  "nozzle_temperature": ["215"],
  "bed_temperature": ["60"],
  "filament_flow_ratio": ["0.98"],
  "compatible_printers": ["MyPrinter 0.4 nozzle"]
}
json
{
  "type": "filament",
  "name": "Generic PLA @MyPrinter@",
  "inherits": "Generic PLA @System",
  "from": "system",
  "instantiation": "true",
  "nozzle_temperature": ["215"],
  "bed_temperature": ["60"],
  "filament_flow_ratio": ["0.98"],
  "compatible_printers": ["MyPrinter 0.4 nozzle"]
}

Minimal Process Profile

最简工艺配置文件

json
{
  "type": "process",
  "name": "0.20mm Standard @MyPrinter 0.4",
  "inherits": "fdm_process_common",
  "from": "system",
  "instantiation": "true",
  "layer_height": 0.2,
  "print_speed": 150,
  "compatible_printers": ["MyPrinter 0.4 nozzle"]
}

json
{
  "type": "process",
  "name": "0.20mm Standard @MyPrinter 0.4",
  "inherits": "fdm_process_common",
  "from": "system",
  "instantiation": "true",
  "layer_height": 0.2,
  "print_speed": 150,
  "compatible_printers": ["MyPrinter 0.4 nozzle"]
}

Phase 10: Profile Validation

阶段10:配置文件验证

After creating or editing profiles, validate them:
创建或编辑配置文件后,请进行验证:

Method 1 — OrcaSlicer Profile Validator

方法1 — OrcaSlicer配置文件验证工具

bash
undefined
bash
undefined

Linux / macOS

Linux / macOS

./OrcaSlicer_profile_validator -p /path/to/resources/profiles -l 2 -v VendorName
./OrcaSlicer_profile_validator -p /path/to/resources/profiles -l 2 -v VendorName

Windows

Windows

OrcaSlicer_profile_validator.exe --path C:\path\to\resources\profiles -l 2 -v VendorName
undefined
OrcaSlicer_profile_validator.exe --path C:\path\to\resources\profiles -l 2 -v VendorName
undefined

Method 2 — Python Script

方法2 — Python脚本

bash
python orca_extra_profile_check.py --vendor="VendorName" --check-filaments --check-materials
bash
python orca_extra_profile_check.py --vendor="VendorName" --check-filaments --check-materials

Force Profile Reload (after editing installed profiles)

强制重新加载配置文件(编辑已安装配置文件后)

Delete the system cache:
  • Windows:
    %APPDATA%\OrcaSlicer\system\
  • macOS:
    ~/Library/Application Support/OrcaSlicer/system/
  • Linux:
    ~/.config/OrcaSlicer/system/
Then restart OrcaSlicer.

删除系统缓存目录:
  • Windows:
    %APPDATA%\OrcaSlicer\system\
  • macOS:
    ~/Library/Application Support/OrcaSlicer/system/
  • Linux:
    ~/.config/OrcaSlicer/system/
然后重启OrcaSlicer。

References

参考资料

  • references/profiles.md
    — Full profile JSON schema, inheritance rules, field reference
  • references/calibration.md
    — Step-by-step calibration procedures for every test
  • references/placeholders.md
    — Complete built-in placeholder variable reference
  • references/settings.md
    — Annotated settings reference for all three profile types
  • references/profiles.md
    — 完整配置文件JSON schema、继承规则、字段参考
  • references/calibration.md
    — 所有测试的分步校准流程
  • references/placeholders.md
    — 完整内置占位符变量参考
  • references/settings.md
    — 三类配置文件的带注释设置参考