@omnicrawl/cli-win32-ia32 0.2.6 → 0.3.0

package/README.md

@@ -1,5 +1,5 @@
 # @omnicrawl/cli-win32-ia32
 
-OmniCrawl 内核二进制（Windows 32 位）。
+OmniCrawl 平台包（Windows 32 位：内核 + 完整宿主）。
 
 由 `omnicrawl-cli` 按平台自动安装，不要直接依赖。

package/host/omnicrawl/config/templates/config.example.toml

@@ -0,0 +1,325 @@
+# OmniCrawl 首次启动配置
+# API Key 会在首次启动时交互式写入当前用户配置目录。
+version = 2
+
+[llm.active_model]
+source = "custom"
+key = "default-chat"
+
+[llm.defaults]
+request_timeout_seconds = 180
+request_retry_count = 5
+discovery_timeout_seconds = 10
+discovery_cache_ttl_seconds = 300
+reasoning_effort = ""
+thinking_type = "disabled"
+
+[llm.profiles.openai-main]
+provider = "openai"
+enabled = true
+base_url = "https://api.openai.com/v1"
+api_key_env = "OPENAI_API_KEY"
+# 可选：覆盖该渠道请求使用的 HTTP User-Agent。
+# user_agent = "OmniCrawl/1.0"
+default_protocol = "openai_chat_completions"
+default_context_window_tokens = 128000
+
+[llm.profiles.openai-main.discovery]
+enabled = true
+
+[llm.profiles.anthropic-main]
+provider = "anthropic"
+enabled = false
+base_url = "https://api.anthropic.com"
+api_key_env = "ANTHROPIC_API_KEY"
+default_protocol = "anthropic_messages"
+default_context_window_tokens = 200000
+
+[llm.profiles.anthropic-main.discovery]
+enabled = true
+
+[llm.profiles.gemini-main]
+provider = "gemini"
+enabled = false
+base_url = "https://generativelanguage.googleapis.com"
+api_key_env = "GEMINI_API_KEY"
+default_protocol = "gemini_generate_content"
+default_context_window_tokens = 1000000
+
+[llm.profiles.gemini-main.discovery]
+enabled = true
+
+# 联网搜索（web_search 工具）：默认引擎在 TUI /settings → 工具设置 → 联网搜索 中切换，
+# 也可在此手改。bing / duckduckgo / arxiv / huggingface
+# 抓各自站点的公开搜索页，无需凭据，统一走浏览器指纹环境；
+# github 配了 github_token 时走 REST 检索接口，未配时仍抓公开搜索页；
+# tavily / exa / firecrawl 走各自的检索接口，需要配置对应的 API Key（写入本地 config.toml，不提交仓库）；
+# mixed 是混合搜索：并发查询上述渠道并去重合并，接口型渠道只在配了凭据时参与。
+# 工具调用时传 engine 参数可覆盖这里的默认引擎。
+[web_search]
+engine = "bing"
+tavily_api_key = ""
+exa_api_key = ""
+firecrawl_api_key = ""
+# GitHub Token 可选：配置后 GitHub 引擎改走 REST 检索接口（30 次/分钟），
+# 留空则抓公开搜索页（10 次/分钟）。token 只影响额度，无需勾选任何仓库权限。
+github_token = ""
+
+# 视觉模型代理：模型引用复用 llm.profiles / models.toml，不在这里存 API Key。
+# models 按顺序作为故障转移链；主模型不支持视觉且此项开启时，图片会先交给这些模型分析。
+# 模型原生视觉在设置页「视觉」按当前模型/渠道开关（models.toml 或 [llm.profiles.<id>] 的 native_vision）。
+[vision]
+enabled = false
+models = []
+
+# 图像生成：两条通道按 provider 二选一——OpenAI 兼容 Image API 与 Gemini 的
+# generateContent。接口地址、Key、模型与默认参数在 TUI /settings → 图像生成 中配置；
+# api_key 写入本地 config.toml（不提交仓库）。size/quality 是 OpenAI 通道的口径，
+# aspect_ratio/image_size 是 Gemini 通道的口径，切换服务商不会丢掉另一家的取值。
+[image_gen]
+enabled = false
+# 服务商：openai / gemini。
+provider = "openai"
+# OpenAI 通道：https://api.openai.com/v1；Gemini 通道：
+# https://generativelanguage.googleapis.com/v1beta。
+base_url = "https://api.openai.com/v1"
+api_key = ""
+api_key_env = "OPENAI_API_KEY"
+# OpenAI 通道默认 gpt-image-2；Gemini 通道默认 gemini-2.5-flash-image。
+model = "gpt-image-2"
+# 仅 OpenAI 通道使用：auto 或 宽x高。
+size = "auto"
+# 仅 OpenAI 通道使用：auto / low / medium / high。
+quality = "auto"
+# 仅 OpenAI 通道使用：png / jpeg / webp（Gemini 恒为 png）。
+output_format = "png"
+# 仅 Gemini 通道使用：画面比例，14 种之一（留空由模型取默认）。
+aspect_ratio = ""
+# 仅 Gemini 通道使用：分辨率档位 1K / 2K / 4K（留空由模型取默认）。
+image_size = ""
+n = 1
+timeout_seconds = 120
+
+# TTS 语音合成（云服务）：两条通道按 tts_cloud.provider 二选一，本机不需要模型文件
+# 或 espeak-ng 一类原生依赖，只要 HTTP 与密钥。在 TUI /settings → TTS 中配置。
+[tts]
+enabled = false
+auto_play = true
+# 回合结束后朗读助手回复（直接在宿主里合成播放，不经 tts_synthesize 工具、也不走审批）。
+speak_replies = false
+output_dir = ".omnicrawl/.agent_tmp/tts"
+
+# 服务商路由：openai / gemini。
+[tts_cloud]
+provider = "openai"
+
+# OpenAI 通道（provider = "openai" 时生效）：POST {base_url}/audio/speech。
+# api_key 写入本地 config.toml（不提交仓库），也可在设置面板直接填写。
+[tts_api]
+base_url = "https://api.openai.com/v1"
+api_key = ""
+model = "gpt-4o-mini-tts"
+# 音色：alloy/ash/ballad/coral/echo/fable/nova/onyx/sage/shimmer/verse/marin/cedar。
+voice = "alloy"
+# 语气指令；只对 gpt-4o-mini-tts 一类模型生效，留空则不下发。
+instructions = ""
+# 语速（0.25~4.0）；1 时不下发该字段。
+speed = 1
+timeout_seconds = 120
+
+# Gemini 通道（provider = "gemini" 时生效）：POST {base_url}/models/{model}:generateContent。
+[tts_gemini]
+base_url = "https://generativelanguage.googleapis.com/v1beta"
+api_key = ""
+model = "gemini-2.5-flash-preview-tts"
+# 预置音色名（如 Kore、Puck、Zephyr）。
+voice = "Kore"
+# 语气指令：Gemini 没有独立的指令字段，这段文本作为正文前缀下发。
+instructions = ""
+timeout_seconds = 120
+
+[approval]
+mode = "review"
+# 自动审查使用的独立模型（可选）：留空时沿用 [llm] model。
+# 审查请求与主对话完全隔离（不携带主对话上下文），独立模型不影响主对话成本，
+# 且主模型被提示词注入时也不影响审查独立性；建议指定更便宜/更严格的模型。
+review_model = ""
+
+# 对话区思考块显示：关闭后思考内容仍照常产生并进入推理链路，只是不在
+# 对话区渲染思考块（Markdown 渲染）。可在 TUI /settings 中切换。
+[ui]
+show_thinking = true
+
+[memory]
+enabled = true
+
+# Skill 额外路径：目录或 .md 文件，相对路径按工作区解析。
+# 与内置作用域一起参与发现，扫描顺序排在最后；同名 Skill 由先扫描到的作用域胜出。
+# [skills]
+# extra_paths = ["./my-skills", "~/.omnicrawl/shared-skills"]
+
+# 内置工具开关：默认除 powershell 关闭外，其余全部启用。
+# 只在需要禁用某个工具时取消注释并设为 false。
+# [tools]
+# powershell = false
+# bash = true
+# read_image = true
+# windows_screenshot = true
+
+# 运行节奏护栏：Reasoning 死循环保护、白名单临时错误恢复与有限自动续跑。
+# 自动续跑会增加模型请求次数和 Token 消耗；保存后从下一次回合生效。
+[run_guard]
+enabled = true
+
+[run_guard.guard]
+enabled = true
+window_chars = 2000
+substr_len = 32
+repeat_ratio = 0.7
+check_every = 50
+max_blocks = 10000
+max_chars = 500000
+max_guard_retries = 2
+# 白名单错误码：默认使用 provider-neutral 统一错误码（SERVICE_UNAVAILABLE 对应
+# HTTP 5xx/网关临时不可用）。如需对网关等上游业务错误码/错误文本做自动重试，
+# 可在此追加自定义字符串，例如 ["SERVICE_UNAVAILABLE", "PI_AI_ERROR"]。
+auto_retry_errors = ["SERVICE_UNAVAILABLE"]
+
+[run_guard.continue]
+enabled = true
+max_auto_followups = 3
+
+[context_compaction]
+# 上下文压缩是 Agent 的基础能力。触发阈值（Token）也可在运行设置面板按当前
+# 模型上下文窗口的百分比设置（5% 步进）：trigger_context_tokens = 上下文窗口 × 百分比。
+# 设置面板修改百分比后会保存该关系，并在上下文窗口变化时实时重算。
+trigger_context_tokens = 100000
+trigger_context_percent = 80
+next_user_reserve_tokens = 10240
+emergency_context_ratio = 0.85
+summary_profile = ""
+reasoning_effort = "low"
+# 模型压缩「压缩即丢弃」：压缩后上下文只有摘要 + 最终回复锚点，不保留原文回合；
+# recent_turns 仍用于触发预估的热窗口划分。
+recent_turns = 6
+target_summary_tokens = 0
+preserve_exact_evidence = true
+allow_cross_provider = false
+failure_fallback = "deterministic"
+
+# AI 消息可逆脱敏（opt-in，默认关闭）：把发往模型的消息副本中命中的敏感值
+# 替换为 ｛Desensitized:n｝ 占位符，模型返回后按序号还原；原文不出本机。
+# 仅作用于 AI 消息（含工具调用消息），不改动请求参数；设计文档见
+# omnicrawl://docs/agent_gateway_desensitization_design.md。
+# 说明：熵检测兜底（entropy_*）为 P2 增强，键位已保留。
+# [desensitization]
+# enabled = false                # 显式启用后才生效；未启用零成本
+# fail_closed = true             # 屏蔽异常时中止请求，不静默发送原文
+# strict_restore = false         # 还原缺失时中止并报错（默认保留 + 告警）
+# extra_sensitive_keys = []      # 追加敏感键名
+# exempt_keys = []               # 豁免键名（优先于命中）
+# entropy_enabled = true         # 熵兜底开关（关闭则仅键名/结构匹配）
+# entropy_min_length = 20        # 熵兜底长度下限
+# entropy_min_bits = 3.5         # 熵兜底阈值
+# entropy_pure_letters = false   # 纯字母令牌：长度达标即脱敏（默认关闭；十六进制字母串仍跳过）
+# entropy_pure_digits = false    # 纯数字令牌：长度达标即脱敏（默认关闭）
+# 值类型规则层（正则识别「无键名的敏感值类型」）：高危类型默认开启，
+# 泛化类型（邮箱 / 外网 IP / 网址）误报较高，默认关闭、按需开启。
+# detect_pem_private_key = true         # PEM 私钥（BEGIN/END … PRIVATE KEY）
+# detect_db_connection_string = true    # 数据库连接串（URI / ADO 键值）
+# detect_email = false                  # 邮箱地址
+# detect_bank_card = true               # 银行卡号（Luhn 校验）
+# detect_internal_ip = true             # 内网 IP（私有 / 链路本地）
+# detect_external_ip = false            # 外网 IP（公网可路由）
+# detect_url = false                    # 网址（http / https / ftp）
+# detect_mac_address = true             # MAC 地址
+# detect_license_plate = true           # 中国大陆车牌
+# gitleaks 开源规则：默认加载内置离线快照（rust/crates/omnicrawl-llm/data/gitleaks.toml）；
+# gitleaks_config_path 指向自定义文件时按规则 id 覆盖 / 追加（失败回退内置快照）。
+# NER 兜底层（BiLSTM-CRF：人名 / 地名 / 机构名）：结构 / 规则 / 熵之外的最后一道语义
+# 兜底，输入是前几层处理后的文本且只对中文片段兜底（非中文字符已等长隔离）；
+# 需要可选依赖 torch（pip install -e .[ner]）。
+# 权重随包分发，可用 ner_model_path 或环境变量 OMNICRAWL_NER_MODEL 覆盖；
+# torch / 权重缺失时本层静默跳过，不影响既有脱敏链路。
+# ner_enabled = false                   # 默认关闭；开启后作为语义兜底
+# ner_model_path = ""                   # checkpoint 路径；留空用随包权重 / 环境变量
+# ner_device = "auto"                   # auto 优先 CUDA、不可用回退 CPU
+# ner_entity_types = ["PER", "ORG", "LOC"]  # 需要识别的实体类型
+# ner_min_entity_chars = 2              # 最小实体长度（2 规避单字地名歧义）
+# 推理结果缓存：按「块」（≤200 字符）缓存，长会话中未变历史不再重复推理；
+# 容量单位是块数，默认 2048（约 400KB 文本），0 关闭。
+# ner_cache_size = 2048
+
+[api]
+bearer_token = "请替换为随机长令牌"
+host = "127.0.0.1"
+port = 8765
+allowed_origins = ["http://localhost:5173"]
+confirmation_timeout_seconds = 300
+# uvicorn worker 进程数，默认 1（Run 状态、事件流、审批全部在进程内存里）。
+# >1 时内核按连接在 worker 间轮询，同一客户端的后续请求可能落到任意 worker，
+# 因此运行状态自动改走跨进程共享存储（~/.OmniCrawl/api-runs-<host>-<port>.sqlite3）。
+# 每个 worker 会各自创建一个 Agent 与独立隔离 worktree，按机器核数与内存设置。
+workers = 1
+
+[agent_temp]
+enabled = true
+directory = ".omnicrawl/.agent_tmp"
+cleanup_enabled = true
+cleanup_interval_hours = 24
+
+# 启动自动更新：每次启动时联网比对 PyPI 最新版（检测结果带 24 小时本地缓存，
+# 同一天不重复请求），本地版本落后时自动执行 pip 升级，完成后重新启动 TUI。
+# 仅对 pip 正常安装的环境生效（源码目录或 editable 安装直接跳过）；离线、升级
+# 失败或配置异常时按"继续使用当前版本"启动，不影响工具可用性。
+# 设置 OMNICRAWL_SKIP_AUTO_UPDATE=1 可彻底关闭。
+[update]
+enabled = true
+
+[plugins]
+enabled = false
+
+# SubAgent 设置已完全迁移到独立文件 subagents.toml（模板见 subagents.example.toml），
+# 支持为每个子代理单独指定模型。本段不再从 config.toml 读取，
+# 请直接编辑 subagents.toml 调整子代理全局边界与逐角色模型。
+# [subagents]
+# enabled = false
+# max_depth = 1
+# max_concurrency = 2
+# max_tasks_per_batch = 4
+# default_timeout_seconds = 3600
+# model_request_concurrency = 2
+# allow_background = false
+# allow_fork = false
+# allow_worktree = true
+# allow_standard_agent = true
+# allow_shared_workspace_writes = false
+# enable_verify_agent = true
+# verify_command_timeout_seconds = 120
+# task_retention_minutes = 60
+# result_summary_chars = 6000
+#
+# [subagents.models.explore]
+# model = "default-chat"
+
+[mcp]
+enabled = false
+default_timeout_seconds = 30
+# 工具输出预算为固定硬编码（单工具 50K 字符、每回合聚合 200K 字符）：
+# 超限输出自动落盘到会话 artifact，模型上下文只保留头尾预览与文件路径。
+servers = {}
+# 远程 Streamable HTTP Server 可在这里声明认证请求头：
+# [mcp.servers.remote_service]
+# enabled = true
+# transport = "streamable_http"
+# url = "https://example.com/mcp"
+#
+# [mcp.servers.remote_service.headers]
+# Authorization = "Bearer replace-with-token"
+# X-API-Key = "replace-with-api-key"
+
+[mcp.policy]
+require_confirmation_for_write = true
+require_confirmation_for_command = true
+allow_external_network_tools = false
+audit_log_enabled = true

package/host/omnicrawl/config/templates/decision_models.example.toml

@@ -0,0 +1,162 @@
+# OmniCrawl 结构化决策模型配置（首次启动自动复制为 decision_models.toml）
+#
+# 结构化决策模型是独立于对话模型的第二类服务：送一段 state 加若干有类型的提问
+# （choice / score / noul），拿回校准过的答案。它不做文本生成，也不进 models.toml
+# 的对话模型目录——两套服务地址与模型命名空间互不相干。
+#
+# 支持的服务：Jev（TypeSafe AI）与自部署的 OneJev（本机 qev 服务）。三种请求方式见下方 mode 注释。
+# 密钥请用环境变量（api_key_env）；也可以直接写 api_key，但不要提交到版本库。
+version = 1
+
+# 默认使用的决策渠道 key；留空或指向不存在的渠道时取第一条启用的渠道。
+default_key = "jev-main"
+
+[channels.jev-main]
+name = "Jev 主渠道"
+# 请求方式：
+#   jev             —— Jev 原生接口，POST {base_url}/v1/decide，state + questions 直接进请求体。
+#   chat_completions —— OpenAI 兼容接口，POST {base_url}/chat/completions，
+#                      base_url 与 [image_gen] 同口径（填到 /v1）；
+#                      同一份 state + questions 作为 user 消息发出，从返回内容里解析 answers。
+#   onejev          —— 本机自部署的 OneJev 服务，POST {base_url}/v1/systemone，
+#                      请求与响应形状与 jev 相同；base_url 指向本地服务（见下方 [local]）。
+mode = "jev"
+# 接口基础地址：jev / onejev 填站点根下的 API 前缀（不含 /v1/decide、/v1/systemone）；
+# chat_completions 按 OpenAI 兼容口径填到 /v1（不含 /chat/completions）。
+base_url = "https://jevtypesafeai.com/api"
+# 内联密钥（可留空，改用下面的环境变量）。
+api_key = ""
+api_key_env = "JEV_API_KEY"
+# 决策模型：jev-latest 跟随最新版本；生产环境建议钉死版本（如 jev-1.13.0）。
+model = "jev-latest"
+# 请求失败后的重试次数（不含首次请求）：连接失败、超时与上游 5xx 按 0.2s→0.4s→0.8s（封顶 2s）
+# 退避重试这么多次；4xx 不重试（那是请求本身的问题），读不到可用答案也不重试（不猜、不编）。
+# 一次决策在回合路径上同步等待，因此次数要有界（上限 10）；0 表示不重试。
+retry_count = 3
+enabled = true
+
+# 决策模型的功能开关。开关关闭时相关功能走原路径（当前即对话模型审查与本地排序检索）。
+[features]
+# 工具调用审查使用决策模型：开启后 approval.mode = review 的审查请求改走决策模型
+# （同一份待审查负载当 state，问一个 choice 问题直接读回结论），不生成文本也不用
+# 解析模型输出，因此更快。审查不可用时按 fail-closed 拒绝，不退化成对话模型审查。
+tool_call_review = false
+
+# 记忆搜索使用决策模型排序：开启后 memory_search 先取更宽的候选池（最多 20 条），
+# 再让决策模型按相关度排序，按各候选项的置信度降序返回，条数仍按调用方给的
+# max_results。决策服务不可用（缺渠道/凭据、超时、响应不可解析）时回退本地排序，
+# 检索工具不会因此失败。
+memory_search_rerank = false
+
+# 知识库检索使用决策模型排序：对 kb_search 同理，候选描述用标题、路径与摘要。
+kb_search_rerank = false
+
+# Skill 检索使用决策模型排序：开启后 skill_search 带关键词检索时先取更宽的候选池（最多 20 条），
+# 再让决策模型按相关程度排序，按各候选项的置信度降序返回，条数仍按调用方给的 max_results。
+# 不带关键词（按作用域列出全部）时没有「相关度」可判，不送审。决策服务不可用时回退本地排序，
+# 检索工具不会因此失败。
+skill_search_rerank = false
+
+# 联网搜索使用决策模型排序：开启后 web_search 把结果切成 5 组（每组 10 条）并发交给决策模型
+# 排序，各组取前 5 条拼接后返回，因此单次最多回 25 条（调用方给的 max_results 更小时按它截断）。
+# 分组只用本地关键词覆盖度圈出候选池，组内顺序由决策模型定。决策服务不可用时回退本地顺序，
+# 搜索不会因此失败。
+web_search_rerank = false
+
+# 提问由决策模型自动作答：开启后模型调用 ask_user 且带选项时，不再弹面板等你作答，
+# 而是把提问正文、你本回合的请求与本回合已有的顾问答复交给决策模型，让它选最符合
+# 你意图的一项。没有选项的提问（自由问答）照旧交给你。决策服务不可用时回退到人工
+# 提问，不会替你瞎猜；自动作答会在会话流里留一条提示。
+ask_user_custody = false
+
+# 旧一轮工具调用按需淘汰（先标注-后压缩）：只裁决「刚变老」的那一批（Agent 又推进了一批
+# 之后，上一批才送审），最新一批永远保留，因此淘汰点贴近上下文尾部、前缀缓存不失效。送审按
+# 「整组」判定——一次调用的请求 + 结果 + 拒绝一起走，协议不会留下半截。送审内容里带上
+# **用户本回合的请求原文**（state.task），判定「还有没有用」以它为准。
+#
+# 判为无用的调用**不会当场离开上下文**：内核先把它当成一次「标注」落一条会话事件
+# （tool_call_evicted），本回合的上下文原样保留原文；到**回合收尾**才把本轮所有标注一次性
+# 移出，且先于工具调用概括与上下文压缩——被淘汰的原文因此不会被概括或压缩摘要再带回来。
+#
+# 送审范围不含记忆与知识库工具（memory_search / memory_read / memory_expand_related /
+# memory_write、kb_search / kb_read / kb_write / kb_append / kb_list）、编辑与替换
+# （write_file / Edit_file）与 git：记忆与知识库给的是跨回合的持久知识，重跑一次未必拿回同一份
+# 内容；写文件与替换文本是已落盘的副作用，记录一旦被删，模型就不知道文件已经变成什么样、也无从
+# 判断后续还要不要接着改；git 的结果是仓库当时的快照，重跑可能落在另一个状态上。
+# read 与 grep **参与送审**：文件内容与检索结果重读重查即可拿回，适合交给决策模型判断。
+# 决策服务不可用（缺渠道/凭据、超时、响应不可解析）时一律保留原文；淘汰结果落成会话事件，
+# 重启后按同一份投影重建同一份上下文。
+tool_call_prune = false
+
+# 新提问自动建议工具：开启后，你每发一条新提问，宿主先把**这一条提问的正文**（不带历史）
+# 与一份「已启用工具」的清单交给决策模型，问它「本次该用哪些工具」。每个工具一个是否题，
+# 概率 ≥0.5 进建议名单、<0.5 排除；另有最后一个兜底判定——本条属于普通对话、寒暄或无从
+# 判断的异常任务时，整份建议作废（不插入任何内容）。名单非空时在提问尾部追加一行
+# 「当前请求建议调用tool：a、b。」再发给模型。
+#
+# 清单就是本机工具表里全部已启用的工具（每项为工具名 + 描述首句，截断到 24 字），不做人工
+# 取舍：关掉的工具与当前没有运行期的工具（语音合成、顾问、Windows 组）本来就不在表里。
+# 该用专用工具还是顺手用泛化工具，由决策模型按选择要求判断——子代理、生图、语音、桌面
+# 操作这类专用工具贴合任务特殊性；读文件、搜代码、执行命令、记待办这类通用工具几乎每轮
+# 都能顺手用一下，除非本次任务明确围绕它展开，否则判为用不到。决策服务不可用（缺渠道/凭据、
+# 超时、响应不可解析）时按「本次无建议」处理，提问原文照发，不会挡住你的输入。
+tool_suggestion = false
+
+# 新提问自动建议子代理：与上面的 `tool_suggestion` 形状相同、互相独立，可单开也可同时开。
+# 区别在候选清单：这里送审的是**本机可调度的子代理角色**（每项为角色名 + 角色描述首句，
+# 截断到 24 字），与 `subagent` 工具的参数枚举同源，内核不能调度的角色不会进审。
+# 判定同样是每个角色一个是否题 + 一个兜底判定（本条是否属于无需任何子代理的普通对话），
+# 概率阈值都是 0.5。名单非空时在提问尾部追加一行「当前请求建议使用子代理：explore、plan。」。
+#
+# 子代理个个都是一次带独立上下文的子回合，开销明显高于主模型自己动手，因此判定要求特别
+# 强调：只有能拆成相互独立、可并行推进的子任务，或需要隔离视角核查与隔离改动时才算用得到；
+# 单步问答、小改动、串行依赖的活一律判为用不到。
+#
+# 两类同时开启时，两条请求**并发发起**，总耗时取两者的较大者而不是相加；任一失败只少一行。
+# 决策服务不可用时同样按「本次无建议」处理，提问原文照发。
+subagent_suggestion = false
+
+# 决策 REST 接口：把决策能力暴露给本机其它程序（CLI 工具、Skill、外部脚本），
+# 它们不必经主模型就能拿到决策结果。大脑（主模型）负责规划，小脑（决策模型）负责
+# 快速判定，两者通过这个接口协同。
+#
+# 端点（成功回 {"data": ...}，失败回 {"error": {code, message}}）：
+#   GET  /health      健康检查
+#   GET  /v1/status   服务与渠道自检（不回传凭据）
+#   POST /v1/decide   通用：{state, questions} → {answers, raw}
+#   POST /v1/choice   选优：{state, options, instructions?} → {index, answers}
+#   POST /v1/rank     排序：{state, candidates, instructions?} → {order, count}
+#   POST /v1/review   审查：{payload, fail_closed?} → {approved, reason, detail, confidence}
+#
+# 接口不做鉴权：只要监听地址可达就能直接调用。因此 host 只允许回环地址
+# （127.0.0.1 / localhost / ::1），即只有本机程序能调用。
+# 随 OmniCrawl 启动时自动拉起，本机已有服务则直接复用。
+# 默认关闭。
+[api]
+enabled = false
+host = "127.0.0.1"
+# 端口：与本地 API（8765）错开。
+port = 8767
+
+# 自部署（OneJev）：在本机跑一份决策模型，不依赖云端服务。
+#
+# 官方发布 0.8B / 4B / 9B / 27B / 27B-FP8 五档（Hugging Face 的 OmniJev/OneJev-*），
+# 由本机的判定 worker 直接驱动引擎，经命名管道（Windows）/ Unix socket 提供同一套判定——
+# 不经 TCP 与 HTTP。设置面板的「结构化决策模型」页可以一键下载某一档、准备运行环境、
+# 启停本地服务，并把决策渠道切到自部署。
+# 权重与虚拟环境都在 model_dir 下（默认 ~/.omnicrawl/onejev），不进工作区。
+[local]
+# 当前部署的尺寸：0.8B / 4B / 9B / 27B-FP8 / 27B。
+# 显存下限大致是 4 / 12 / 24 / 34 / 60 GB；没有独显时只能跑 CPU（很慢）。
+size = "0.8B"
+# 推理设备：auto（有 GPU 用 CUDA）/ cuda / cpu。
+device = "auto"
+# 数据根目录：权重在 <root>/models/、虚拟环境在 <root>/venv/、缓存与日志也在下面。
+# 留空表示默认目录 ~/.omnicrawl/onejev。
+model_dir = ""
+# 决策渠道选了自部署（mode = "onejev"）时，是否随 OmniCrawl 启动自动准备本地服务：
+# 本机已有服务在跑（本机所有实例共用一份）就直接复用，不会重复启动；服务常驻，
+# 不随实例退出被回收，要停就在设置页点「停止服务」。
+auto_start = true
+# 启动后等待服务就绪的上限（秒）：首次加载权重并捕获 CUDA 图，大尺寸会久一些。
+health_timeout_seconds = 600

package/host/omnicrawl/config/templates/models.example.toml

@@ -0,0 +1,71 @@
+# OmniCrawl 默认模型目录
+# 不要在此文件中写入 api_key、token 或其他凭据。
+version = 1
+
+[models.default-chat]
+display_name = "OpenAI 主渠道"
+profile = "openai-main"
+model_id = "gpt-5.2"
+protocol = "openai_chat_completions"
+enabled = true
+aliases = ["default", "chat"]
+description = "默认 OpenAI Chat Completions 模型"
+tags = ["default", "tools"]
+context_window_tokens = 128000
+max_output_tokens = 8192
+temperature = 0.7
+# 模型原生视觉：true/false 显式指定该模型（或所属渠道）能否自行读图；
+# 省略时按模型能力判断（设置页「视觉」可按当前模型开关，写入此键）。
+native_vision = false
+sort_order = 0
+
+[models.default-chat.capabilities]
+streaming = true
+tools = true
+parallel_tool_calls = true
+reasoning = false
+vision = false
+model_discovery = true
+prompt_cache = true
+
+[models.anthropic-main]
+display_name = "Anthropic 主渠道"
+profile = "anthropic-main"
+model_id = "claude-sonnet-4-5"
+protocol = "anthropic_messages"
+enabled = false
+description = "Anthropic Messages 渠道"
+tags = ["tools"]
+context_window_tokens = 200000
+max_output_tokens = 8192
+sort_order = 10
+
+[models.anthropic-main.capabilities]
+streaming = true
+tools = true
+parallel_tool_calls = false
+reasoning = true
+vision = true
+model_discovery = true
+prompt_cache = true
+
+[models.gemini-main]
+display_name = "Gemini 主渠道"
+profile = "gemini-main"
+model_id = "gemini-2.5-pro"
+protocol = "gemini_generate_content"
+enabled = false
+description = "Gemini Generate Content 渠道"
+tags = ["tools"]
+context_window_tokens = 1000000
+max_output_tokens = 8192
+sort_order = 20
+
+[models.gemini-main.capabilities]
+streaming = true
+tools = true
+parallel_tool_calls = false
+reasoning = true
+vision = true
+model_discovery = true
+prompt_cache = false

package/host/omnicrawl/config/templates/subagents.example.toml

@@ -0,0 +1,38 @@
+# OmniCrawl 子代理设置模板（首次启动自动复制为 subagents.toml）
+# 子代理设置已从 config.toml 完全迁移到本文件；程序只读取 subagents.toml，
+# 不再回退读取 config.toml 的 [subagents] 段。
+version = 1
+
+# SubAgent 全局边界：默认关闭；开启后三种角色的能力开关默认放开（verify / standard / worktree）。
+[subagents]
+enabled = false
+max_depth = 1
+max_concurrency = 2
+max_tasks_per_batch = 4
+default_timeout_seconds = 3600
+model_request_concurrency = 2
+allow_background = false
+# 仅开放已脱敏父公开上下文的 read_only/verify Fork；默认关闭。
+allow_fork = false
+allow_shared_workspace_writes = false
+allow_worktree = true
+allow_standard_agent = true
+enable_verify_agent = true
+verify_command_timeout_seconds = 120
+task_retention_minutes = 60
+result_summary_chars = 6000
+
+# 单独设置每个子代理使用的模型；key 必须与 Agent 定义名一致（如 explore/plan/verify）。
+# model 支持：models.toml key/alias、profile/model_id 或裸 model_id；
+# 缺省或写 inherit 表示沿用父模型（与任务级 model=inherit 语义一致）。
+[subagents.models.explore]
+# model = "default-chat"
+
+[subagents.models.plan]
+# model = "default-chat"
+
+[subagents.models.verify]
+# model = "default-chat"
+
+[subagents.models.general-purpose]
+# model = "default-chat"