From 3938cc87702a87d4748861f7ae2b5d4f096bacb8 Mon Sep 17 00:00:00 2001 From: thzxx Date: Mon, 20 Apr 2026 20:29:30 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E5=B8=AE=E5=8A=A9?= =?UTF-8?q?=E9=9D=A2=E6=9D=BF=E5=86=85=E5=AE=B9=EF=BC=8C=E5=AF=B9=E9=BD=90?= =?UTF-8?q?=E5=AE=9E=E9=99=85=E4=BB=A3=E7=A0=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Tool Calling: 工具分类从7类调整为6类，最大轮数15→85，移除超时限制说明 - 搜索引擎: web_search描述从DuckDuckGo+Bing更新为Bing+百度+Google三引擎 - 记忆系统: 新增容量上限500条、安全扫描说明 - 布局说明: 工作空间从2个Tab更新为3个Tab（命令行/工具/文件） - 新增章节: 技能自动生成、系统诊断 - Heartbeat: 补充默认间隔1小时 - 工具面板卡片: web_search描述同步更新 --- src/renderer/index.html | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/src/renderer/index.html b/src/renderer/index.html index 3f8b1cb..ae3b0d9 100644 --- a/src/renderer/index.html +++ b/src/renderer/index.html @@ -437,13 +437,15 @@

🚀 快速开始

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

💬 聊天功能

  • 流式回复 — 实时打字效果，随时点 ■ 停止
  • Think 推理 — 设置中开启，让模型展示深度思考过程（需模型支持，如 Qwen3）
  • 多模态 — 上传图片，模型需支持 Vision 能力
  • 文件分析 — 支持 50+ 种文本/代码格式，单文件 ≤500KB，内容以代码块发送给模型
  • 上下文长度 — 设置中调整 num_ctx，越大记忆越长，消耗显存越多
-

🔧 Tool Calling（AI 自主操作）

  • 设置中开启后，AI 可以在对话中自主调用本地工具，像一个本地 Agent
  • 38 个工具，分为 7 类：
    • 文件操作（14 个）：read_file / write_file / list_directory / search_files / create_directory / delete_file / move_file / copy_file / append_file / edit_file / get_file_info / tree / diff_files / replace_in_files / read_multiple_files
    • 网络工具（3 个）：web_search（联网搜索）/ web_fetch（网页抓取）/ download_file
    • 浏览器控制（8 个）：browser_open / browser_screenshot / browser_evaluate / browser_extract / browser_click / browser_type / browser_scroll / browser_close
    • 系统工具（3 个）：run_command / git / compress
    • 记忆/会话/Skill（8 个）：memory_search / memory_add / memory_replace / memory_remove / session_list / session_read / skill_list / skill_view
    • 子代理（1 个）：spawn_task
  • 仅 run_command（命令执行）支持三模式切换：自动/需确认/禁用
  • 危险命令（rm -rf、mkfs、反弹 shell 等）和系统路径（/etc、~/.ssh 等）被自动拦截
  • 工具调用以可视化卡片展示状态（pending → running → success/error）
  • 最多自动循环 15 轮工具调用，总超时 10 分钟，也可随时中断
  • 独立工具自动并行执行，有依赖关系的工具串行执行
  • ⚠️ 需要模型支持 Tool Calling（推荐 Qwen3、Llama 3.1+、Mistral）
-

🧠 Agent 记忆系统

  • 设置中开启后，AI 从对话中自动提取关键信息（事实/偏好/规则），跨会话持续积累
  • 对话满 6 条消息后自动触发记忆提取
  • 新对话时自动检索相关记忆注入上下文，让 AI "记住"你
  • 点击顶部 🧠 按钮打开记忆面板：搜索、筛选、编辑、删除
  • 向量语义搜索：在设置中选择嵌入模型后，支持语义级别记忆检索（更精准）
  • 未选择嵌入模型时，使用关键词匹配检索记忆
  • AI 可通过 memory_search / memory_add / memory_replace / memory_remove 工具主动管理记忆
  • AI 可通过 session_list / session_read 查阅历史会话
  • 记忆存储在本地 SQLite，不会上传到任何服务器
+

🔧 Tool Calling（AI 自主操作）

  • 设置中开启后，AI 可以在对话中自主调用本地工具，像一个本地 Agent
  • 38 个工具，分为 6 类：
    • 文件系统（12 个）：read_file / write_file / list_directory / search_files / create_directory / delete_file / move_file / copy_file / append_file / edit_file / get_file_info / tree
    • 系统 & 网络（6 个）：run_command（执行命令）/ web_search（联网搜索，Bing + 百度 + Google 三引擎）/ web_fetch（网页抓取）/ download_file / diff_files / replace_in_files / read_multiple_files
    • Git（1 个）：git（status / log / diff / add / commit / push / pull / branch / checkout / stash / reset / merge / clone / init / remote / tag，共 16 个子操作）
    • 浏览器控制（8 个）：browser_open / browser_screenshot / browser_evaluate / browser_extract / browser_click / browser_type / browser_scroll / browser_close
    • 压缩（1 个）：compress（创建/解压 zip/tar.gz）
    • 记忆 & 会话 & Skill（8 个）：memory_search / memory_add / memory_replace / memory_remove / session_list / session_read / skill_list / skill_view
    • 子代理（1 个）：spawn_task
  • 仅 run_command（命令执行）支持三模式切换：自动/需确认/禁用
  • 危险命令（rm -rf、mkfs、反弹 shell 等）和系统路径（/etc、~/.ssh 等）被自动拦截
  • 工具调用以可视化卡片展示状态（pending → running → success/error），在工作空间🔧工具页签中显示
  • 默认最大 85 轮工具调用循环，可在设置中调整，也可随时中断
  • 无超时限制，宁可等待也不中断，由用户控制生命周期
  • 独立工具自动并行执行，有依赖关系的工具串行执行
  • ⚠️ 需要模型支持 Tool Calling（推荐 Qwen3、Llama 3.1+、Mistral）
+

🧠 Agent 记忆系统

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

🎭 人格模式

  • 设置中可切换 6 种预设人格：通用助手 / 编程助手 / 写作助手 / 数据分析 / 翻译助手 / 代码审查
  • 不同人格有独立的 system prompt 和温度偏好
  • 通用助手不做额外约束，其他人格会调整行为风格

🔌 MCP（Model Context Protocol）

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

⏰ 定时任务（Cron）

  • 支持一次性（at）和周期性（cron 表达式）任务调度
  • 任务触发后将描述填入输入框，可直接发送给 AI 执行
  • 设置面板可添加/管理/删除定时任务
-

💓 Heartbeat 后台检查

  • 启用后定期检查 Ollama 连接状态和模型可用性
  • 支持 10 分钟 / 30 分钟 / 1 小时 / 2 小时间隔
  • 异常时通过系统通知提醒
-

🖥️ 布局说明

  • 左侧面板 — 执行日志，实时显示应用运行日志（连接、模型加载、工具调用等）
  • 中间区域 — 聊天消息，顶部 Header + 模型栏，底部输入框
  • 右侧面板 — 工作空间（常驻显示），包含：
    • 💻 命令行 Tab — 终端界面，实时流式输出，支持长时间运行（无超时），单一终端进程
    • 📁 文件 Tab — 浏览工作空间目录，点击文件预览内容
  • 工作空间目录可在设置中修改
+

💓 Heartbeat 后台检查

  • 启用后定期检查 Ollama 连接状态和模型可用性
  • 支持 10 分钟 / 30 分钟 / 1 小时 / 2 小时间隔（默认 1 小时）
  • 异常时通过系统通知提醒
+

🧠 技能自动生成

  • AI 完成包含 2+ 工具调用的复杂任务后，自动从执行轨迹中提取可复用技能
  • 技能包含工具链步骤、成功/失败次数、平均执行时长等统计
  • 下次遇到类似任务时自动匹配已有技能，跳过重新推理
  • AI 可通过 skill_list 查看技能列表（名称+描述+成功率），skill_view 查看完整工具链详情
  • 技能存储在本地 SQLite，不会上传到任何服务器
+

🩺 系统诊断

  • 设置面板点击「🩺 一键诊断」按钮，自动检查以下项目：
    • Ollama 服务连接与版本
    • 当前模型可用性与 Tool Calling / Vision 支持
    • 工作空间目录与磁盘空间
    • SQLite 数据库完整性
    • 工具安全配置
  • 诊断结果以 ✅/⚠️/❌ 标记，附带修复建议
+

🖥️ 布局说明

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

🕐 历史记录

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

⚡ 快捷键 & 命令

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

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

/retry重试上一轮回复
/undo撤销最后一条用户消息及回复
/compress用 AI 摘要压缩长对话上下文
@@ -562,7 +564,7 @@
🔍web_search自动
-
联网搜索（DuckDuckGo + Bing），返回标题/URL/摘要
+
联网搜索（Bing + 百度 + Google 三引擎），返回标题/URL/摘要
🧠memory_search自动