跳转到内容
Micro-Seg

配置

Micro-Seg 启动时读取一个 TOML 文件:

  • Windows: %APPDATA%/MicroSeg/microseg.toml
  • Linux: ~/.config/MicroSeg/microseg.toml

优先级:环境变量覆盖 → microseg.toml → 内置默认值。文件必须声明 schema_version = 1。

[ui]

Section titled “[ui]”
键 取值 说明
theme System · Light · Dark · Cvat 也可点击顶栏 logo 切换
default_export_format Json · Coco · Yolo 标注导出格式
auto_save_interval_ms 整数 0 表示禁用自动保存
max_recent_projects 整数 ≥ 1

[ai]

Section titled “[ai]”

enabled = true 启用 AI 功能。模型来自模型目录:active_model_id 从 [[ai.models]] 中选择一个条目。

每个目录条目包含 id、展示名 name 和 backend:

  • local_ort —— 本地运行的 ONNX 模型:model_path、model_type (HRNetOCR | MobileNetV2)、threshold(0–1)、with_prev_mask、 可选 infer_size / max_size。
  • remote_nuclio —— 推理委托给 Nuclio 函数(例如 SAM 部署): platform_url、function_namespace、function_name、invoke_url。 适合共享 GPU 服务器的团队;其余一切仍在本地。
schema_version = 1


[ai]
enabled = true
active_model_id = "hrnet-local"


[[ai.models]]
id = "hrnet-local"
name = "HRNet-OCR (local)"
backend = "local_ort"
model_path = 'C:/models/HRNetOCR.onnx'
model_type = "HRNetOCR"
threshold = 0.5
with_prev_mask = true

配置的模型路径无效时,运行时会禁用 AI,而不是让应用启动失败。

[plugins.task_plugins]

Section titled “[plugins.task_plugins]”
键 含义
enabled 插件运行时的全局开关
enabled_plugins 插件 id 允许列表——为空则不运行任何插件
user_params 插件参数覆盖(密钥存这里,绝不写入项目文件)

项目级插件绑定存放在 <project_root>/.microseg/plugins.json——见 插件。

[onnx] 与环境变量覆盖

Section titled “[onnx] 与环境变量覆盖”
  • [onnx].dylib_path 指向 ONNX Runtime 库 (onnxruntime.dll / libonnxruntime.so);无效值会回退到内置搜索 逻辑。环境变量 ORT_DYLIB_PATH 可覆盖它。
  • MICROSEG_PLUGIN_HOST_STDIO 控制插件宿主的输出:none(默认)、 inherit(接到你的终端——调试插件时有用)、file(捕获到配置目录 下的日志文件)。