irises 1.0.0

package/data/agents.example/my-agent/configs/tools.yaml

@@ -0,0 +1,231 @@
+# 工具配置
+#
+# ─── 工具防御性参数（防止输出过大撑爆 LLM 上下文） ───
+#
+# 所有参数均有内置默认值，通常无需修改。
+# 如需调整，取消对应行的注释即可。
+#
+limits:
+  # ── read_file ──
+  read_file:
+    maxFiles: 10                   # 单次调用最多读取文件数
+    maxFileSizeBytes: 2097152      # 单文件最大字节数 (2MB)
+    maxTotalOutputChars: 200000    # 所有文件格式化后的总输出字符数上限
+
+  # ── search_in_files ──
+  search_in_files:
+    maxResults: 100                # 最大匹配结果数 (search 模式)
+    maxFiles: 50                   # 最大处理文件数 (replace 模式)
+    contextLines: 2                # 每条匹配的上下文行数
+    maxFileSizeBytes: 2097152      # 单文件最大字节数 (2MB)，超过则跳过
+    maxLineDisplayChars: 500       # 结果中单行最大展示字符数 (防 minified 文件撑爆)
+    maxMatchDisplayChars: 200      # 匹配文本最大展示字符数
+
+  # ── list_files ──
+  list_files:
+    maxEntries: 2000               # 递归列出时最大条目数
+
+  # ── find_files ──
+  find_files:
+    maxResults: 500                # 每个 pattern 的最大结果数
+
+  # ── shell ──
+  shell:
+    defaultTimeout: 30000          # 默认超时 (毫秒)
+    maxOutputChars: 50000          # stdout/stderr 各自的最大字符数
+    maxBuffer: 10485760            # Node.js exec maxBuffer 字节数 (10MB)
+
+# ─── 全局审批开关（最高优先级） ───
+#
+# 全部自动批准（跳过一类 + 二类审批）
+# autoApproveAll: true
+#
+# 仅跳过一类审批（Y/N 确认），二类审批（diff 预览）仍生效
+# autoApproveConfirmation: true
+#
+# 仅跳过二类审批（diff 预览），一类审批（Y/N 确认）仍生效
+# autoApproveDiff: true
+#
+# ─── 按工具配置执行策略 ───
+#
+# 下方按工具名称配置执行策略。
+# 未配置的工具默认需要手动确认。
+#
+# autoApprove: true  -> 工具调用后直接执行
+# autoApprove: false -> 工具执行前需要手动确认
+
+# 只读工具：默认直接执行
+read_file:
+  autoApprove: true
+search_in_files:
+  autoApprove: true
+  # 如需对 mode: replace 打开 diff 审批页，可改为 false，并开启 showApprovalView
+  showApprovalView: true
+find_files:
+  autoApprove: true
+list_files:
+  autoApprove: true
+
+# 修改类工具：默认需要确认
+write_file:
+  autoApprove: false
+  # Console TUI 中是否打开 diff 审批视图；设为 false 时退回到底部 Y/N 确认提示
+  showApprovalView: true
+apply_diff:
+  autoApprove: false
+  # Console TUI 中是否打开 diff 审批视图；设为 false 时退回到底部 Y/N 确认提示
+  showApprovalView: true
+insert_code:
+  autoApprove: false
+  showApprovalView: true
+delete_code:
+  autoApprove: false
+  showApprovalView: true
+delete_file:
+  autoApprove: false
+create_directory:
+  autoApprove: false
+
+# ─────────────────────────────────────────────────────────────
+# Shell 工具配置
+# ─────────────────────────────────────────────────────────────
+#
+# 除了 autoApprove 开关外，shell 工具还支持细粒度的命令模式匹配：
+#
+#   allowPatterns — 白名单：匹配的命令自动执行（即使 autoApprove: false）
+#   denyPatterns  — 黑名单：匹配的命令必须确认（即使 autoApprove: true）
+#
+# 判定优先级：denyPatterns > allowPatterns > autoApprove
+#
+# 支持的模式语法：
+#   - 精确匹配：  "git status"              仅匹配该完整命令
+#   - 通配符 *：  "git log *"               匹配 git log 后跟任意参数
+#   - 通配符 ?：  "ls -?"                   匹配 ls 后跟单字母选项
+#   - 前缀匹配：  "npm run *"               匹配所有 npm run 子命令
+#   - 正则表达式："/^cat\s+\S+$/"           以 / 包裹按正则解析
+#
+# ── 用法示例 ──
+#
+#   场景 A：默认拒绝，仅放行指定命令（推荐）
+#     autoApprove: false
+#     allowPatterns:
+#       - "git status*"
+#       - "ls *"
+#
+#   场景 B：默认放行，拦截危险命令
+#     autoApprove: true
+#     denyPatterns:
+#       - "rm *"
+#       - "/sudo\s+/"
+#
+#   场景 C：混合使用（白名单 + 黑名单 + 兜底）
+#     autoApprove: false
+#     allowPatterns:
+#       - "git *"
+#     denyPatterns:
+#       - "git push *"          # 虽然 git * 在白名单，但 push 被黑名单拦截
+#
+shell:
+  autoApprove: false
+
+  # ── 白名单（取消注释以启用） ──
+  allowPatterns:
+    # 只读 / 查看类
+    # - "ls *"                    # 列出文件
+    # - "cat *"                   # 查看文件内容
+    # - "head *"                  # 查看文件开头
+    # - "tail *"                  # 查看文件结尾
+    # - "wc *"                    # 统计行数/字数
+    # - "which *"                 # 查找命令路径
+    # - "echo *"                  # 输出信息
+    # - "pwd"                     # 当前目录
+    # - "env"                     # 查看环境变量
+    #
+    # 搜索类
+    # - "grep *"                  # 搜索文本
+    # - "find *"                  # 查找文件
+    # - "rg *"                    # ripgrep 搜索
+    # - "fd *"                    # fd 查找
+    #
+    # Git 只读操作
+    # - "git status*"             # 状态查看
+    # - "git log *"               # 日志查看
+    # - "git diff*"               # 差异查看
+    # - "git branch*"             # 分支查看
+    # - "git show *"              # 查看提交
+    # - "git remote -v"           # 查看远程
+    #
+    # 包管理器（只读）
+    # - "npm list*"               # 查看依赖
+    # - "npm run *"               # 运行脚本
+    # - "bun run *"               # bun 运行脚本
+    #
+    # 自定义正则
+    # - "/^(node|bun|npx|tsx)\\s+/"  # 允许 node/bun/npx/tsx 命令
+
+  # ── 黑名单（取消注释以启用） ──
+  denyPatterns:
+    # 危险操作
+    # - "rm -rf *"                # 递归强制删除
+    # - "/^sudo\\s+/"             # 所有 sudo 命令
+    # - "/^chmod\\s+/"            # 修改权限
+    # - "/^chown\\s+/"            # 修改所有者
+    # - "dd *"                    # 磁盘操作
+    # - "/\\|\\s*sh/"             # 管道到 sh 执行
+    # - "curl * | *"              # curl 管道执行
+    #
+    # Git 危险操作
+    # - "git push *"              # 推送
+    # - "git reset --hard*"       # 硬重置
+    # - "git clean -fd*"          # 强制清理
+    #
+    # 包管理器写操作
+    # - "npm install*"            # 安装依赖
+    # - "npm publish*"            # 发布包
+
+sub_agent:
+  autoApprove: false
+
+# ─────────────────────────────────────────────────────────────
+# Computer Use 工具配置（需在 computer_use.yaml 中启用）
+# ─────────────────────────────────────────────────────────────
+#
+# 以下工具在 computer_use.yaml 的 enabled: true 时自动注册。
+# 所有坐标参数均为 0-999 归一化值，由工具内部转换为实际像素。
+#
+# 只读 / 低风险操作：建议自动批准
+# get_screenshot:
+#   autoApprove: true
+# click_at:
+#   autoApprove: true
+# hover_at:
+#   autoApprove: true
+# scroll_document:
+#   autoApprove: true
+# scroll_at:
+#   autoApprove: true
+# go_back:
+#   autoApprove: true
+# go_forward:
+#   autoApprove: true
+# search:
+#   autoApprove: true
+# navigate:
+#   autoApprove: true
+# wait_5_seconds:
+#   autoApprove: true
+#
+# 输入类操作：按需决定是否自动批准
+# type_text_at:
+#   autoApprove: true
+# key_combination:
+#   autoApprove: false          # 按键组合可能触发系统级操作，建议手动确认
+# drag_and_drop:
+#   autoApprove: false
+
+# 如需启用其他工具（记忆、MCP 等），请按工具名补充配置。
+# 例如：
+# memory_search:
+#   autoApprove: true
+# mcp__my_server__my_tool:
+#   autoApprove: false

package/data/agents.yaml.example

@@ -0,0 +1,28 @@
+# 多 Agent 系统配置
+#
+# 首次运行时此文件会自动拷贝到 ~/.iris/agents.yaml。
+# 设置 enabled: true 即可启用多 Agent 模式。
+#
+# 每个 agent 拥有独立的完整配置集（llm.yaml, system.yaml, tools.yaml 等）、
+# 会话存储和记忆数据库。
+#
+# agent 配置目录位于 ~/.iris/agents/<agent-name>/configs/
+# 首次启动时会自动从模板初始化。
+# 请编辑各 agent 的配置文件（至少填写 LLM API Key）。
+
+# 全局开关（默认关闭）
+enabled: false
+
+# Agent 定义
+agents:
+  # 示例 Agent：配置目录在 ~/.iris/agents/my-agent/configs/
+  my-agent:
+    description: "我的 AI 助手"
+
+  # 更多 agent 示例...
+  # code-helper:
+  #   description: "专注代码开发的 AI 助手"
+  # chat-bot:
+  #   description: "日常聊天机器人"
+  #   # 自定义数据根目录（可选，默认 ~/.iris/agents/<name>/）
+  #   dataDir: /custom/path/chat-bot

package/data/configs.example/computer_use.yaml

@@ -0,0 +1,196 @@
+# Computer Use 配置
+#
+# 启用后，LLM 可通过一组预定义工具操控浏览器或桌面。
+# 工具包括 get_screenshot、click_at、type_text_at、scroll_document 等，
+# 走普通 function calling 路径，任何支持工具调用的模型均可使用。
+#
+# 依赖：
+#   browser 环境需要安装 Playwright
+#     npm install playwright
+#     laywright install chromium
+#   screen 环境无额外依赖（Windows 通过 PowerShell 调用系统 API）
+
+# 是否启用（默认关闭）
+enabled: false
+
+# 执行环境
+#   browser — Playwright 控制 Chromium 浏览器（操作范围限定在浏览器窗口内）
+#   screen  — 系统级截屏 + 输入模拟（默认全屏，可通过 targetWindow 限定到单个窗口）
+environment: browser
+
+# ─── 工具策略 ───
+#
+# 按环境配置要启用或排除的工具。
+# 三个环境层级，运行时自动选择匹配的一个：
+#   browser     — Playwright 浏览器环境
+#   screen      — 桌面全屏 / 窗口前台模式
+#   background  — 桌面窗口后台模式（screen + backgroundMode: true）
+#
+# 每个环境支持两种策略（互斥，include 优先）：
+#   include: [工具名]  — 白名单，仅启用列出的工具
+#   exclude: [工具名]  — 黑名单，排除列出的工具，其余全部启用
+#
+# 不配置 environmentTools 时使用内置默认策略：
+#   browser:    全部启用
+#   screen:     排除 go_back, go_forward, search
+#   background: 排除 go_back, go_forward, search, drag_and_drop
+#
+# 配置后覆盖对应环境的默认策略。未配置的环境仍使用默认值。
+#
+# 全部 13 个工具：
+#   get_screenshot, click_at, hover_at, type_text_at,
+#   scroll_document, scroll_at, key_combination, navigate,
+#   go_back, go_forward, search, wait_5_seconds, drag_and_drop
+#
+# ── 示例 ──
+#
+# environmentTools:
+#   # 浏览器环境：排除拖拽
+#   browser:
+#     exclude:
+#       - drag_and_drop
+#
+#   # 桌面环境：使用内置默认排除策略（不配置即可）
+#
+#   # 后台模式：白名单，只允许基础操作
+#   background:
+#     include:
+#       - get_screenshot
+#       - click_at
+#       - type_text_at
+#       - scroll_document
+#       - key_combination
+#       - wait_5_seconds
+
+# ─── browser 环境专用 ───
+
+# 启动时打开的初始页面
+# initialUrl: https://www.google.com
+
+# 搜索引擎首页（search 工具导航的目标）
+# searchEngineUrl: https://www.google.com
+
+# 浏览器视口尺寸（像素），仅 browser 环境生效
+# screen 环境下屏幕/窗口尺寸自动检测，无需手动配置
+# Gemini 推荐 1440×900 以获得最佳效果
+screenWidth: 1440
+screenHeight: 900
+
+# 是否无头模式（不显示浏览器窗口）
+# 调试时建议关闭，以便观察操作过程
+headless: false
+
+# 是否在操作位置显示红色圆圈标记（调试用）
+# highlightMouse: true
+
+# ─── screen 环境专用 ───
+#
+# 默认为全屏模式（截取整个桌面，操作范围不受限制）。
+# 如需限定在某个应用窗口内，设置 targetWindow 即可。
+#
+# targetWindow 仅作为启动时首次绑定的条件。
+# 找到窗口后会锁定到该窗口的原生句柄（HWND），后续操作不依赖标题。
+# 运行时可通过 /window 指令切换绑定到其他窗口。
+#
+# ── 字符串形式 ──
+#
+# 填一个字符串，按标题子串匹配，取第一个匹配的窗口。
+# 大部分场景用这个就够了。
+#
+# 设置后：
+#   - 截屏只截取该窗口区域
+#   - 鼠标坐标自动偏移到窗口位置
+#   - 操作前自动将窗口置于前台（后台模式除外）
+#   - screenSize 返回窗口尺寸（LLM 的坐标归一化基于窗口尺寸）
+#
+# 示例：
+#   targetWindow: "记事本"       # 匹配标题包含"记事本"的窗口
+#   targetWindow: "Chrome"       # 匹配标题包含 Chrome 的窗口
+#   targetWindow: "Visual Studio Code"
+#
+# ── 对象形式 ──
+#
+# 字符串形式不够精确时，改用对象形式。
+#
+# hwnd 优先级最高：填了 hwnd 就直接用它定位，忽略其他所有字段。
+# 其他字段填了多个时，必须全部满足才算匹配。
+# 如果匹配到多个窗口，自动选第一个。
+#
+# 字段说明：
+#
+#   hwnd          窗口句柄，如 "0x00120ABC"。最精确，填了就忽略其他字段。
+#                 可通过 /window 指令查看。注意 HWND 在窗口关闭后会变。
+#   title         标题包含这个文字就算匹配（不区分大小写）
+#   exactTitle    标题必须完全一致才算匹配（区分大小写）
+#   processName   进程名（不带 .exe），比如 WindowsTerminal、notepad
+#   processId     进程 PID，比如 1232。注意 PID 在进程重启后会变。
+#   className     窗口类名，比如 CASCADIA_HOSTING_WINDOW_CLASS
+#
+# 怎么查看这些值：
+#   运行时在 TUI 里输入 /window，列表会显示每个窗口的标题、进程名、PID、HWND。
+#
+# 示例：
+#
+#   # 最精确：直接用 HWND（通过 /window 查看后填入）
+#   targetWindow:
+#     hwnd: "0x00120ABC"
+#
+#   # 按标题 + 进程名匹配
+#   targetWindow:
+#     title: "PowerShell"
+#     processName: "WindowsTerminal"
+#
+#   # 按 PID 指定
+#   targetWindow:
+#     processId: 1232
+#
+# 多个窗口匹配时（比如同一个 WindowsTerminal 下开了三个标签页，
+# title、processName、processId 全一样），自动绑定第一个。
+# 如果绑错了，有两种办法：
+#   - 在配置里填 hwnd，精确指定（通过 /window 查看后填入）
+#   - 启动后用 /window 手动切换
+#
+# targetWindow:
+
+
+# 运行时切换窗口：
+#   在 TUI 中输入 /window 打开当前可见窗口列表，选择后绑定。
+#   输入 /window <关键词> 可预填搜索文本，按标题或进程名过滤。
+#   绑定时直接用窗口的 HWND 精确定位，不受标题重复影响。
+#
+# 不设置 targetWindow 则为全屏模式。
+# 注意：全屏模式下 AI 的操作范围不受限制，请谨慎使用。
+# 建议将 key_combination 等高风险工具设为 autoApprove: false（在 tools.yaml 中配置）。
+
+# 后台操作模式（仅窗口模式下有效，需先设置 targetWindow）。
+# 启用后不需要目标窗口在前台，AI 可以在后台操作窗口。
+# 窗口只需处于显示状态（不最小化），可以被其他窗口遮挡。
+# 如果窗口被最小化，会自动恢复但不激活（不抢焦点）。
+#
+# 实现方式：
+#   截图 → PrintWindow（请求窗口自绘，支持 GPU 加速窗口）
+#   鼠标 → PostMessage(WM_LBUTTONDOWN/UP)
+#   键盘 → PostMessage(WM_KEYDOWN/UP) / WM_CHAR
+#
+# 截图兼容性（PrintWindow）：
+#   ✓ 原生 Win32 / WPF / WinForms 应用
+#   ✓ GPU 加速窗口（Chrome、Electron、游戏等）— 只要窗口处于显示状态
+#
+# 操作兼容性（PostMessage）：
+#   ✓ 原生 Win32 / WPF / WinForms — 点击、键盘、滚动均正常
+#   △ 部分应用可能不响应 PostMessage 的鼠标/键盘消息
+#   △ 拖拽操作通过消息模拟，部分应用可能不支持
+#
+# 默认 false（前台模式）。
+# backgroundMode: true
+
+# ─── 截图保留策略 ───
+#
+# 发送给 LLM 时，只保留最近 N 轮 Computer Use 工具交互中的截图。
+# 超出的旧轮次截图会被自动剥离，以节省 token。
+# 存储中的完整截图不受影响。
+#
+# 默认 3，与 Gemini 官方示例一致。
+# 设为 0 表示不保留任何截图（仅保留 URL 等文本信息）。
+# 不设置或注释掉则使用默认值 3。
+maxRecentScreenshots: 3

package/data/configs.example/llm.yaml

@@ -0,0 +1,99 @@
+# LLM 配置（模型池）
+# defaultModel: 启动时默认使用的模型名称
+# models:       可用模型列表，键名就是模型名称
+
+# defaultModel 必须指向 models 中的某个模型名称
+# 运行中的 Console TUI 可以通过 /model 指令切换当前使用的模型
+
+defaultModel: gemini_flash
+
+# 是否记住各平台上次使用的模型（通过 /model 切换后持久化，重启后自动恢复）
+# 启用后，各平台的 lastModel 会自动写入 platform.yaml 对应平台节内
+rememberPlatformModel: true
+
+# 用于 /compact 上下文压缩的模型名称
+# 需指向 models 中的某个模型，不填则使用 defaultModel
+# 建议使用速度快、成本低的模型（如 gemini-3-flash）
+summaryModel: gemini_flash
+
+models:
+  gemini_flash:
+    # 提供商: gemini | openai-compatible | openai-responses | claude
+    provider: gemini
+    apiKey: your-api-key-here
+    # model 字段填写提供商真实模型 id
+    model: gemini-2.0-flash
+    # Gemini 要以 /v1beta 结尾；OpenAI 兼容 / OpenAI Responses / Claude 要以 /v1 结尾
+    # 在此基础上，程序再补全具体接口后缀
+    baseUrl: https://generativelanguage.googleapis.com/v1beta
+    # 是否支持图片输入；不填时程序会按模型名自动判断。
+    # 如果你使用代理网关、自定义模型别名，建议显式填写。
+    supportsVision: true
+
+    # 模型上下文窗口大小（token 数，用于 TUI 显示占用比例）
+    # 常见模型已有内置默认值，通常无需手动设置
+    # contextWindow: 1048576
+
+    # 自动上下文压缩阈值：token 数超过此值时自动执行 /compact
+    # 支持绝对值（如 100000）或 contextWindow 百分比（如 "80%"）
+    # 不设置则不自动压缩
+    # autoSummaryThreshold: "80%"
+    # autoSummaryThreshold: 100000
+
+    # 自定义请求头：会覆盖 provider 内置同名 header
+    # headers:
+    #   x-goog-api-key: your-override-key
+    #   x-custom-header: hello
+
+    # 自定义请求体：会深合并到 provider 编码后的最终请求体，支持嵌套参数
+    # 例如 Gemini thinking / 输出长度 / 温度等都可以直接这样配置
+    # requestBody:
+    #   generationConfig:
+    #     maxOutputTokens: 32000
+    #     temperature: 1
+    #     topP: 1
+    #     thinkingConfig:
+    #       thinkingBudget: 1228
+    #       includeThoughts: true
+
+  # gpt4o_mini:
+  #   provider: openai-compatible
+  #   apiKey: your-api-key-here
+  #   model: gpt-4o-mini
+  #   baseUrl: https://api.openai.com/v1
+  #   supportsVision: false
+
+  # gpt4o:
+  #   provider: openai-responses
+  #   apiKey: your-api-key-here
+  #   model: gpt-4o
+  #   baseUrl: https://api.openai.com/v1
+  #   supportsVision: true
+
+# Claude 示例：
+# models:
+#   claude_sonnet:
+#     provider: claude
+#     apiKey: your-api-key-here
+#     model: claude-sonnet-4-6
+#     baseUrl: https://api.anthropic.com/v1
+#     # 启用 Anthropic Prompt Caching（手动缓存断点）。
+#     # 在请求体的关键位置注入 cache_control: { type: "ephemeral" } 标记：
+#     #   1. tools    — 最后一个工具定义
+#     #   2. system   — 系统指令（转换为 content-block 数组）
+#     #   3. messages — 最后一条用户消息的最后一个内容块
+#     # 最多使用 3 个断点（Anthropic 允许最多 4 个）。
+#     # 缓存读取仅需基础输入 token 价格的 10%。
+#     promptCaching: true
+#     # 启用 Anthropic 自动提示词缓存。
+#     # 在请求体顶层添加 cache_control 字段；
+#     # 服务端自动决定缓存哪部分前缀。
+#     # 可单独使用，也可与 promptCaching 组合使用。
+#     autoCaching: true
+# Gemini 示例：
+# models:
+#   gemini_flash:
+#     provider: gemini
+#     apiKey: your-api-key-here
+#     model: gemini-2.0-flash
+#     baseUrl: https://generativelanguage.googleapis.com/v1beta

package/data/configs.example/mcp.yaml

@@ -0,0 +1,20 @@
+# MCP 服务器配置
+# 连接外部 MCP 服务器，自动将其工具注入 LLM 工具列表
+
+# servers:
+#   # stdio 传输示例（本地进程）
+#   filesystem:
+#     transport: stdio
+#     command: npx
+#     args: ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"]
+#
+#   # HTTP 传输示例（远程服务器）
+#   remote_tools:
+#     transport: streamable-http
+#     url: https://mcp.example.com/sse
+#
+#   # 企微官方文档 MCP（智能表格 + 文档 CRUD，8 个工具）
+#   # 在企微管理后台创建智能机器人后，MCP 端点页面可获取 apikey
+#   wecom-doc:
+#     transport: streamable-http
+#     url: "https://qyapi.weixin.qq.com/mcp/robot-doc?apikey=your-mcp-apikey"

package/data/configs.example/memory.yaml

@@ -0,0 +1,7 @@
+# 记忆配置
+
+# 是否启用记忆
+enabled: false
+
+# 数据库路径（默认 ~/.iris/memory.db）
+# dbPath: ~/.iris/memory.db

package/data/configs.example/modes.yaml

@@ -0,0 +1,18 @@
+# 模式配置
+# 不同模式可定义不同的系统提示词和工具策略
+
+# code:
+#   description: "代码开发模式"
+#   systemPrompt: "你是一个专注于代码开发的 AI 助手。"
+#   tools:
+#     exclude: [memory_add, memory_delete]
+#
+# readonly:
+#   description: "只读分析模式"
+#   tools:
+#     include: [read_file, memory_search, get_current_time]
+#
+# chat:
+#   description: "纯聊天模式"
+#   tools:
+#     include: [get_current_time]

package/data/configs.example/ocr.yaml

@@ -0,0 +1,9 @@
+# OCR 配置（可选）
+# 当主模型不支持图片输入时，Iris 会调用这里配置的 openai-compatible vision 模型提取文字与图片内容，
+# 再把提取结果发送给主对话模型。
+# 删除整个文件即可关闭 OCR 回退。
+
+provider: openai-compatible
+apiKey: your-api-key-here
+baseUrl: https://api.openai.com/v1
+model: gpt-4o-mini

package/data/configs.example/platform.yaml

@@ -0,0 +1,71 @@
+# 平台配置
+
+# 类型: console | discord | telegram | web | weixin | wxwork | lark | qq
+# 支持单平台或多平台同时启动：
+#   type: console            # 单平台
+#   type: [console, web]     # 多平台同时启动
+type: console
+
+# 对码系统配置（可选，平台层访问控制）
+# dmPolicy: 
+#   pairing   = 需对码验证（默认，通过 /invite 生成码）
+#   allowlist = 仅配置的 allowFrom 成员可用
+#   open      = 任何人均可私聊
+pairing:
+  dmPolicy: pairing
+  # admin: "telegram:123456"       # 可直接指定管理员（跳过首次对码）
+  # allowFrom: ["telegram:123"]    # 预设白名单
+
+discord:
+  token: your-discord-bot-token
+
+telegram:
+  token: your-telegram-bot-token
+  # 是否在流式回复中展示工具执行状态（默认 true）
+  # showToolStatus: false
+  # 群聊中是否要求 @机器人 后才响应（默认 true）
+  # groupMentionRequired: true
+
+web:
+  port: 8192
+  # 127.0.0.1 = 仅本机访问（配合 Nginx 反代使用，推荐）
+  # 0.0.0.0   = 允许所有网络接口访问（本地开发/无反代时使用）
+  host: 127.0.0.1
+  # API 全局认证令牌（可选，未配置时不启用）
+  # authToken: your-secret-token-here
+  # 管理接口认证令牌（推荐）
+  # managementToken: your-management-token-here
+
+wxwork:
+  # 企业微信智能机器人 Bot ID 和 Secret
+  # 在企业微信管理后台 → 应用管理 → 智能机器人 中创建并获取
+  # 文档: https://developer.work.weixin.qq.com/document/path/101463
+  botId: your-bot-id
+  secret: your-bot-secret
+  # 是否在流式回复中展示工具执行状态（默认 true）
+  # showToolStatus: false
+
+lark:
+  # 飞书自建应用 App ID 和 App Secret
+  # 在飞书开放平台创建自建应用，开启「机器人」能力后获取
+  # 文档: https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes
+  appId: your-app-id
+  appSecret: your-app-secret
+  # 是否在流式回复中展示工具执行状态（默认 true）
+  # showToolStatus: false
+  # 可选：Webhook 模式用的验证 token（WebSocket 模式不需要）
+  # verificationToken: your-verification-token
+  # 可选：Webhook 模式用的加密 key（WebSocket 模式不需要）
+  # encryptKey: your-encrypt-key
+
+weixin:
+  # 普通微信（WeChat），基于腾讯官方 ilink 协议
+  # 首次启动时会自动弹出二维码，用微信扫码即可完成登录
+  # 登录成功后 Token 自动缓存到 data/configs/weixin-auth.json，无需手动配置
+  #
+  # 可选：手动指定 Bot Token（如从其他实例迁移）
+  # botToken: your-bot-token
+  # 可选：覆盖 API 基地址
+  # baseUrl: https://ilinkai.weixin.qq.com
+  # 是否在回复中展示工具执行状态（默认 true）
+  # showToolStatus: false