Metona Ollama

🚀 快速开始

确保 Ollama 已启动（默认 http://127.0.0.1:11434，可在设置中修改）
顶部模型栏选择一个模型，右侧会显示模型能力徽章（🧠 Think / 👁️ Vision / 🔧 Tools）
输入消息，按 Enter 发送，Shift+Enter 换行

💬 聊天功能

流式回复 — 实时打字效果，随时点 ■ 停止
Think 推理 — 下方 Think 按钮切换，让模型展示深度思考过程（需模型支持，如 Qwen3）
上下文长度自动检测 — 切换模型时自动从模型元数据获取实际支持的上下文长度（如 Qwen3.6 27B = 262,144 tokens），无需手动配置
多模态 — 上传图片或视频（≤10MB），模型需支持 Vision。图片自动压缩，视频 1fps 提取帧序列带时序标注
文件分析 — 支持 50+ 种文本/代码格式，单文件 ≤500KB，自动剥离注释并按上下文预算智能截断
AI 回复顶部 — 每条 AI 回复上方展示 📋 系统提示词折叠卡片，可点击查看实际发送给模型的完整上下文

🔧 Tool Calling（始终开启）

所有消息均通过 Agent Loop 自主调用本地工具，像一个本地 Agent，无普通聊天模式
42+1 个工具，分为 9 类：
- 文件系统（16 个）：read_file / write_file / list_directory / search_files / create_directory / delete_file / move_file / copy_file / edit_file / get_file_info / tree / download_file / diff_files / replace_in_files / read_multiple_files / compress
- 命令执行（1 个）：run_command（实时流式输出，支持自动/需确认/禁用三种模式，可配置超时）
- 联网搜索（2 个）：web_search（支持 SearXNG 元搜索引擎 JSON API / 四引擎 HTML 解析，双模式可切换）/ web_fetch（反爬headers+UA自动切换+自动回退浏览器渲染）
- Git（1 个）：git（17 个子操作，push/pull/clone 内置60-120s超时保护）
- 浏览器控制（9 个）：browser_open / browser_screenshot / browser_evaluate / browser_extract / browser_click / browser_type / browser_scroll / browser_wait / browser_close
- 记忆 & 会话（6 个）：memory_search / memory_add / memory_replace / memory_remove / session_list / session_read
- 子代理（1 个）：spawn_task
- 系统工具（6 个）：datetime / calculator / random / uuid / json_format / hash
read_file 支持 binary模式读取/base64解码/字节分页/2000行默认+截断hint自动续读
write_file 支持 base64写二进制文件/mode(overwrite+append)合并append_file功能/10MB
edit_file 支持 use_regex 正则替换
search_files 支持正则表达式搜索（use_regex=true）
browser_screenshot 支持全页面截图+元素截图
browser_extract 支持CSS选择器提取特定区域
new browser_wait 等待元素出现或定时等待
仅 run_command 支持三模式切换：自动/需确认/禁用
危险命令（rm -rf、mkfs、反弹 shell 等）和系统路径（/etc、~/.ssh 等）被自动拦截
工具调用以可视化卡片展示状态（pending → running → success/error），在工作空间🔧工具页签中显示
默认最大 85 轮工具调用循环，上下文使用率>80%时自动缩减到3轮
独立工具自动并行执行（16个只读工具加入并行白名单），有依赖关系的工具串行执行

🧠 Agent 记忆系统

设置中开启后，AI 从对话中自动提取关键信息（事实/偏好/规则），跨会话持续积累
增量提取：长对话中每 20 轮自动触发轻量级记忆提取，不等到对话结束
对话结束时自动触发完整记忆提取
新对话时自动检索相关记忆注入上下文，让 AI "记住"你
点击顶部 🧠 按钮打开记忆面板：搜索、筛选、编辑、删除
记忆容量上限 500 条，超限时自动清理低价值条目（规则类型受保护）
向量语义搜索：在设置中选择嵌入模型后，支持语义级别记忆检索（更精准）
未选择嵌入模型时，使用关键词匹配检索记忆
AI 可通过 memory 工具主动管理记忆
记忆写入前自动安全扫描（prompt injection / 敏感信息 / 不可见字符检测）
记忆存储在本地 SQLite，不会上传到任何服务器

📋 Plan Mode（计划模式）

点击输入框上方 📋 按钮开启 Plan Mode（开关式）
开启后，AI 先生成执行计划（Markdown 渲染弹窗），用户批准后才开始执行
计划批准后自动初始化追踪器，每个步骤完成后调用 plan_track 工具标记进度
系统提示词自动注入当前进度状态，AI 始终知道还剩多少步未完成
多步骤任务防遗忘：自动检测用户请求中的动作动词，对比已完成步骤，注入提醒
关闭 Plan Mode 后恢复正常 Agent Loop 模式
仅 Plan 模式 下 plan_track 工具可见，避免污染普通模式的工具列表

🛡️ 抗幻觉 & 稳定性

5 层防御体系：系统提示词加固 → 中途幻觉检测（16 条规则覆盖全部工具类别）→ 进度锚点 → 完成闸门（6 项检查）→ 钩子校验
完成闸门：对话结束前自动审查 AI 回复，检测 4 类关键问题（工具幻觉/注入/文件操作/遗漏），阻断有问题的回复
16 条幻觉检测规则：覆盖文件编辑、浏览器操作、Git、记忆、压缩等所有工具类别，防止 AI 声称执行了未调用的工具
看门狗超时：设置面板可配置全局超时（默认 30 分钟），AI 卡死或无限循环时自动中止
中止保护：所有状态处理器 + 重试循环均检查中止信号，点击 ■ 按钮立即生效
上下文硬上限：消息数超过阈值时强制触发压缩，防止 OOM

🤖 Agent Loop 增强

🎬 视频上传：支持上传 .mp4/.avi/.mov/.mkv/.webm 等视频（≤10MB），自动 1fps 提取帧序列（带时间戳），多模态模型原生理解视频时序关系
8 状态机：INIT→THINKING→PARSING→EXECUTING→OBSERVING→REFLECTING→COMPRESSING→TERMINATED，每个状态独立的中止检查和处理
智能上下文压缩：滑动窗口 + LLM结构化JSON摘要，超过50%上下文窗口自动触发
流式调用超时保护：可配置超时（默认300s），Ollama 卡死不再永久阻塞
HTTP/MCP 超时可配：设置面板可分别调整 HTTP（默认30s）和 MCP（默认60s）超时
Final Answer 智能检测：多模式匹配（Final Answer/最终答案/最终回答/总结），避免漏检或误触
Token 感知迭代预算：上下文使用率>80%时自动缩减剩余轮次到3轮
工具缓存 TTL：搜索5分钟/网页10分钟/文件30分钟，过期自动刷新
自动子任务拆解：检测"同时/分别/以及"等并行关键词，自动 spawn 子代理并行处理
旧工具结果自动截断：超过10轮的工具结果自动截断到500字符，控制上下文膨胀

🔌 MCP（Model Context Protocol）

支持连接外部 MCP Server，动态扩展工具能力
设置面板可添加/启用/禁用/删除 MCP 服务器
MCP 工具以 mcp_{server}__{tool} 前缀注册，与内置工具统一调度
启动时自动连接已启用的 MCP 服务器

🔍 SearXNG 元搜索引擎

点击顶部 🔍 按钮打开配置面板，可接入自部署的 SearXNG 实例
JSON 模式：调用 SearXNG JSON API，聚合 70+ 引擎结果，结构化解析
HTML 模式：获取原始搜索结果页面，交由 AI 自行分析提取信息
支持认证 Key（HTTP Header Authorization），保护私有实例
启用后替代内置四引擎方案；关闭即回退，无缝切换
所有参数（引擎、语言、安全搜索、时间范围等）均可独立配置

📋 自定义文件（SOUL.md / AGENT.md / USER.md）

在工作空间目录创建以下文件即可自定义 AI 行为，修改后下一轮对话立即生效
SOUL.md — AI 身份、性格、行为准则（永远不可被压缩，注入为最高优先级系统提示词）
AGENT.md — 工具调用规则、链式调用模式、核心约束（内置精简默认版，可通过工作空间覆盖）
USER.md — 用户画像：技术栈、偏好、习惯等个人信息，AI 在对话中自动参考
可在 AI 回复顶部的 📋 系统提示词卡片中查看实际注入的完整上下文
删除工作空间中的文件即可恢复为内置默认版本

📊 Token 实时监控

点击顶部 📊 按钮打开 Token 监控仪表盘
全局统计 — 跨会话累计 Token 消耗，柱状图按会话展示趋势
当前会话 — 实时显示本轮对话的 Token 消耗，按轮次展示明细
每 2 秒自动刷新数据，支持输入/输出分色显示

🖥️ 布局说明

左侧面板 — 执行日志，实时显示应用运行日志（连接、模型加载、工具调用等）
中间区域 — 聊天消息，顶部 Header + 模型栏，底部输入框
右侧面板 — 工作空间（常驻显示），包含 3 个页签：
- 💻 命令行 Tab — 终端界面，实时流式输出，支持长时间运行（无超时），单一终端进程
- 🔧 工具 Tab — 展示本轮对话的工具调用卡片，含状态统计（总数 ✅ 成功 ❌ 失败），AI 执行命令时自动切到此页签
- 📁 文件 Tab — 浏览工作空间目录，点击文件预览内容（带行号），支持上级目录导航
工作空间目录可在设置中修改

🕐 历史记录

所有会话自动保存到本地 SQLite
点击顶部 🕐 按钮查看、搜索、恢复历史会话
支持导出 JSON / .metona 加密备份

⚡ 快捷键 & 命令

`Enter`	发送消息
`Shift + Enter`	换行
`Ctrl + N`	新建会话
`Ctrl + M`	记忆管理
`Esc`	关闭弹窗

输入框命令（直接输入后发送）：

`/retry`	重试上一轮回复
`/undo`	撤销最后一条用户消息及回复
`/compress`	用 AI 摘要压缩长对话上下文

开始对话

⚙️ 设置

🕐 历史记录

📖 使用帮助

🚀 快速开始

💬 聊天功能

🔧 Tool Calling（始终开启）

🧠 Agent 记忆系统

📋 Plan Mode（计划模式）

🛡️ 抗幻觉 & 稳定性

🤖 Agent Loop 增强

🔌 MCP（Model Context Protocol）

🔍 SearXNG 元搜索引擎

📋 自定义文件（SOUL.md / AGENT.md / USER.md）

📊 Token 实时监控

🖥️ 布局说明

🕐 历史记录

⚡ 快捷键 & 命令

🔧 工具面板（42 个 + 1 Plan 专属）

📊 Token 实时监控

⚠️ 确认操作

🔍 SearXNG 元搜索引擎