From ac5e3e1efc14f3521cdfa21173661dcc6b440565 Mon Sep 17 00:00:00 2001
From: thzxx <thzxx@gitee.com>
Date: Fri, 5 Jun 2026 09:39:17 +0800
Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E5=B8=AE=E5=8A=A9=E9=9D=A2?=
 =?UTF-8?q?=E6=9D=BF=E5=92=8C=20README=EF=BC=9A=E6=96=B0=E5=B7=A5=E4=BD=9C?=
 =?UTF-8?q?=E7=A9=BA=E9=97=B4=E6=96=87=E4=BB=B6=E6=96=87=E6=A1=A3=EF=BC=8C?=
 =?UTF-8?q?v1.1.0=20=E2=86=92=20v0.9.0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 帮助面板 SOUL.md 改为 SOUL.md/AGENT.md/USER.md 三个自定义文件
- 去掉技能自动生成 (v1.1) 版本标注
- README 版本号、特性表、架构图、快速开始同步更新
---
 README.md               | 16 +++++++---------
 src/renderer/index.html |  4 ++--
 2 files changed, 9 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index ddcc977..2c8926d 100644
--- a/README.md
+++ b/README.md
@@ -14,7 +14,7 @@
 </p>
 
 <p align="center">
-  <img src="https://img.shields.io/badge/version-v1.1.0-E8734A?style=flat-square" alt="version">
+  <img src="https://img.shields.io/badge/version-v0.9.0-E8734A?style=flat-square" alt="version">
   <img src="https://img.shields.io/badge/electron-33+-47848F?style=flat-square&logo=electron" alt="electron">
   <img src="https://img.shields.io/badge/typescript-5.7+-3178C6?style=flat-square&logo=typescript" alt="typescript">
   <img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="license">
@@ -37,7 +37,7 @@
 | 🤖 | **ReAct Agent Loop** | Thought → Action → Observation → Reflection 完整循环，最大 85 轮（可配置），自动重试 2 次，工具去重，并行/链式执行 |
 | 🔧 | **38 个内置工具** | 文件系统 · 命令执行 · 联网搜索 · 浏览器控制 · Git · 记忆 · 技能 · 会话 · 子代理 |
 | 🧠 | **智能记忆系统** | 三类记忆（fact / preference / rule），FTS5 全文搜索 + 向量语义搜索，写入前安全扫描，容量 500 条，90 天衰减 |
-| 📋 | **SOUL.md 自定义人格** | 工作空间下创建 SOUL.md 定义 AI 身份与行为准则，每次发送自动注入为最高优先级系统提示词，永远不可压缩 |
+|| 📋 | **自定义文件** | SOUL.md（人格，不可压缩）+ AGENT.md（行为准则）+ USER.md（用户画像），工作空间优先，内置默认 fallback |
 | 🎯 | **技能自动生成 v1.1** | 工具调用链自动提取 → 语义匹配 → 参数自优化 → 未使用衰减 → 技能链合并，越用越精准 |
 | 🌐 | **MCP 协议扩展** | JSON-RPC 2.0 over stdio，动态工具发现，Shadowing 防护 |
 | 🔍 | **三引擎联网搜索** | Bing + 百度 + Google 聚合，web_search → web_fetch 链式抓取 |
@@ -153,7 +153,7 @@
 ## 🏗️ 架构
 
 ```
-用户消息 → 扫描工作空间 SOUL.md（不可压缩层）
+用户消息 → 扫描工作空间 SOUL.md（不可压缩层）→ AGENT.md → USER.md
               ↓
          Agent Engine (ReAct Loop, ≤85轮)
               ↓
@@ -219,7 +219,6 @@ SQLite (sql.js WASM)，7 张表，WAL 模式 + FTS5 全文搜索：
 ```bash
 git clone https://gitee.com/thzxx/metona-ollama-desktop.git
 cd metona-ollama-desktop
-git checkout desktop-v1.1.0
 npm config set registry https://registry.npmmirror.com
 npm install
 npm start
@@ -232,7 +231,7 @@ npm start
 ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ npm run dist
 ```
 
-产出：`release/Metona Ollama Setup v1.1.0.exe`
+产出：`release/Metona Ollama Setup v0.9.0.exe`
 
 ## 🛠️ 常用命令
 
@@ -265,7 +264,7 @@ npm run dist           # 构建 Windows 安装包
 | 🤖 | **ReAct Agent Loop** | Full Thought → Action → Observation → Reflection cycle, up to 85 iterations (configurable), auto-retry 2 times, tool dedup, parallel/chain execution |
 | 🔧 | **38 Built-in Tools** | File system · Command · Web search · Browser · Git · Memory · Skills · Sessions · Sub-agent |
 | 🧠 | **Smart Memory System** | Three types (fact / preference / rule), FTS5 + vector semantic search, pre-write security scan, 500 capacity, 90-day decay |
-| 📋 | **SOUL.md Custom Persona** | Define AI identity & rules in workspace SOUL.md, auto-injected as highest-priority system prompt, never compressed |
+|| 📋 | **Custom Files** | SOUL.md (persona, never compressed) + AGENT.md (behavior rules) + USER.md (user profile), workspace-first with built-in defaults |
 | 🎯 | **Auto Skill Generation v1.1** | Tool chain extraction → semantic matching → parameter self-optimization → decay → chain merging |
 | 🌐 | **MCP Protocol Extension** | JSON-RPC 2.0 over stdio, dynamic tool discovery, Shadowing protection |
 | 🔍 | **Triple-engine Web Search** | Bing + Baidu + Google aggregation, web_search → web_fetch chain |
@@ -381,7 +380,7 @@ npm run dist           # 构建 Windows 安装包
 ## 🏗️ Architecture
 
 ```
-User message → Agent Engine (ReAct Loop, ≤85 rounds)
+User message → workspace SOUL.md (never compressed) → AGENT.md → USER.md
               ↓
          Memory Retrieval (FTS5 + Vector Semantic Search) → Context Injection
               ↓
@@ -443,7 +442,6 @@ SQLite (sql.js WASM), 7 tables, WAL mode + FTS5 full-text search:
 ```bash
 git clone https://gitee.com/thzxx/metona-ollama-desktop.git
 cd metona-ollama-desktop
-git checkout desktop-v1.1.0
 npm config set registry https://registry.npmmirror.com
 npm install
 npm start
@@ -456,7 +454,7 @@ npm start
 ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ npm run dist
 ```
 
-Output: `release/Metona Ollama Setup v1.1.0.exe`
+Output: `release/Metona Ollama Setup v0.9.0.exe`
 
 ## 🛠️ Common Commands
 
diff --git a/src/renderer/index.html b/src/renderer/index.html
index df2a2b9..8b1340e 100644
--- a/src/renderer/index.html
+++ b/src/renderer/index.html
@@ -390,8 +390,8 @@
             <div class="help-section"><h4>🔧 Tool Calling（AI 自主操作）</h4><ul><li>设置中开启后，AI 可以在对话中<strong>自主调用本地工具</strong>，像一个本地 Agent</li><li><strong>38 个工具</strong>，分为 8 类：<ul><li><strong>文件系统</strong>（16 个）：read_file / write_file / list_directory / search_files / create_directory / delete_file / move_file / copy_file / append_file / edit_file / get_file_info / tree / download_file / diff_files / replace_in_files / read_multiple_files</li><li><strong>命令执行</strong>（1 个）：run_command（实时流式输出，支持自动/需确认/禁用三种模式）</li><li><strong>联网搜索</strong>（2 个）：web_search（联网搜索，Bing + 百度 + Google 三引擎）/ web_fetch（网页抓取）</li><li><strong>Git</strong>（1 个）：git（status / log / diff / add / commit / push / pull / branch / checkout / stash / reset / merge / clone / init / remote / tag，共 16 个子操作）</li><li><strong>浏览器控制</strong>（8 个）：browser_open / browser_screenshot / browser_evaluate / browser_extract / browser_click / browser_type / browser_scroll / browser_close</li><li><strong>压缩</strong>（1 个）：compress（创建/解压 zip/tar.gz）</li><li><strong>记忆 & 会话 & Skill</strong>（8 个）：memory_search / memory_add / memory_replace / memory_remove / session_list / session_read / skill_list / skill_view</li><li><strong>子代理</strong>（1 个）：spawn_task</li></ul></li><li>仅 <code>run_command</code>（命令执行）支持三模式切换：自动/需确认/禁用</li><li>危险命令（<code>rm -rf</code>、<code>mkfs</code>、反弹 shell 等）和系统路径（<code>/etc</code>、<code>~/.ssh</code> 等）被自动拦截</li><li>工具调用以<strong>可视化卡片</strong>展示状态（pending → running → success/error），在工作空间🔧工具页签中显示</li><li>默认最大 <strong>85 轮</strong>工具调用循环，可在设置中调整，也可随时中断</li><li>无超时限制，宁可等待也不中断，由用户控制生命周期</li><li>独立工具自动并行执行，有依赖关系的工具串行执行</li><li>⚠️ 需要模型支持 Tool Calling（推荐 Qwen3、Llama 3.1+、Mistral）</li></ul></div>
             <div class="help-section"><h4>🧠 Agent 记忆系统</h4><ul><li>设置中开启后，AI 从对话中<strong>自动提取关键信息</strong>（事实/偏好/规则），跨会话持续积累</li><li>对话满 <strong>6 条消息</strong>后自动触发记忆提取</li><li>新对话时自动检索相关记忆注入上下文，让 AI "记住"你</li><li>点击顶部 🧠 按钮打开记忆面板：搜索、筛选、编辑、删除</li><li><strong>记忆容量上限 500 条</strong>，超限时自动清理低价值条目（规则类型受保护）</li><li><strong>向量语义搜索</strong>：在设置中选择嵌入模型后，支持语义级别记忆检索（更精准）</li><li>未选择嵌入模型时，使用关键词匹配检索记忆</li><li>AI 可通过 <code>memory_search</code> / <code>memory_add</code> / <code>memory_replace</code> / <code>memory_remove</code> 工具主动管理记忆</li><li>AI 可通过 <code>session_list</code> / <code>session_read</code> 查阅历史会话</li><li>记忆写入前自动安全扫描（prompt injection / 敏感信息 / 不可见字符检测）</li><li>记忆存储在本地 SQLite，不会上传到任何服务器</li></ul></div>
             <div class="help-section"><h4>🔌 MCP（Model Context Protocol）</h4><ul><li>支持连接外部 MCP Server，动态扩展工具能力</li><li>设置面板可添加/启用/禁用/删除 MCP 服务器</li><li>MCP 工具以 <code>mcp_{server}_{tool}</code> 前缀注册，与内置工具统一调度</li><li>启动时自动连接已启用的 MCP 服务器</li></ul></div>
-            <div class="help-section"><h4>📋 SOUL.md 自定义人格</h4><ul><li>在工作空间目录创建 <strong>SOUL.md</strong> 文件，定义 AI 的身份、性格、行为准则</li><li>每次发送消息时自动读取并注入为系统提示词的最顶层（<strong>永远不可被压缩</strong>）</li><li>支持所有 Markdown 格式，可以定义铁律/纪律/偏好三层规则体系</li><li>可在 AI 回复顶部的 📋 系统提示词卡片中查看实际注入的内容</li><li>修改 SOUL.md 后下一轮对话立即生效，无需重启</li></ul></div>
-            <div class="help-section"><h4>🎯 技能自动生成 (v1.1)</h4><ul><li>AI 完成包含 <strong>2+ 工具调用</strong>的复杂任务后，自动从执行轨迹中提取可复用技能</li><li><strong>语义匹配</strong>：配置嵌入模型后，根据用户消息的语义自动匹配最相关技能</li><li><strong>参数自优化</strong>：同一技能链多次执行后，自动合并高频参数提示，越用越精准</li><li><strong>技能衰减</strong>：30 天未使用的技能自动降权，90 天几乎忽略</li><li><strong>链合并</strong>：相同前缀（前 2 步相同）的多个技能自动合并为抽象技能</li><li>AI 可通过 <code>skill_list</code>（渐进式摘要）和 <code>skill_view</code>（完整工具链）查看技能</li><li>技能存储在本地 SQLite，不会上传到任何服务器</li></ul></div>
+            <div class="help-section"><h4>📋 自定义文件（SOUL.md / AGENT.md / USER.md）</h4><ul><li>在工作空间目录创建以下文件即可自定义 AI 行为，修改后下一轮对话立即生效</li><li><strong>SOUL.md</strong> — AI 身份、性格、行为准则（<strong>永远不可被压缩</strong>，注入为最高优先级系统提示词）</li><li><strong>AGENT.md</strong> — 工具调用规则、链式调用模式、核心约束（内置精简默认版，可通过工作空间覆盖）</li><li><strong>USER.md</strong> — 用户画像：技术栈、偏好、习惯等个人信息，AI 在对话中自动参考</li><li>可在 AI 回复顶部的 📋 系统提示词卡片中查看实际注入的完整上下文</li><li>删除工作空间中的文件即可恢复为内置默认版本</li></ul></div>
+            <div class="help-section"><h4>🎯 技能自动生成</h4><ul><li>AI 完成包含 <strong>2+ 工具调用</strong>的复杂任务后，自动从执行轨迹中提取可复用技能</li><li><strong>语义匹配</strong>：配置嵌入模型后，根据用户消息的语义自动匹配最相关技能</li><li><strong>参数自优化</strong>：同一技能链多次执行后，自动合并高频参数提示，越用越精准</li><li><strong>技能衰减</strong>：30 天未使用的技能自动降权，90 天几乎忽略</li><li><strong>链合并</strong>：相同前缀（前 2 步相同）的多个技能自动合并为抽象技能</li><li>AI 可通过 <code>skill_list</code>（渐进式摘要）和 <code>skill_view</code>（完整工具链）查看技能</li><li>技能存储在本地 SQLite，不会上传到任何服务器</li></ul></div>
             <div class="help-section"><h4>📊 Token 实时监控</h4><ul><li>点击顶部 📊 按钮打开 Token 监控仪表盘</li><li><strong>全局统计</strong> — 跨会话累计 Token 消耗，柱状图按会话展示趋势</li><li><strong>当前会话</strong> — 实时显示本轮对话的 Token 消耗，按轮次展示明细</li><li>每 2 秒自动刷新数据，支持输入/输出分色显示</li></ul></div>
             <div class="help-section"><h4>🖥️ 布局说明</h4><ul><li><strong>左侧面板</strong> — 执行日志，实时显示应用运行日志（连接、模型加载、工具调用等）</li><li><strong>中间区域</strong> — 聊天消息，顶部 Header + 模型栏，底部输入框</li><li><strong>右侧面板</strong> — 工作空间（常驻显示），包含 3 个页签：<ul><li><strong>💻 命令行 Tab</strong> — 终端界面，实时流式输出，支持长时间运行（无超时），单一终端进程</li><li><strong>🔧 工具 Tab</strong> — 展示本轮对话的工具调用卡片，含状态统计（总数 ✅ 成功 ❌ 失败），AI 执行命令时自动切到此页签</li><li><strong>📁 文件 Tab</strong> — 浏览工作空间目录，点击文件预览内容（带行号），支持上级目录导航</li></ul></li><li>工作空间目录可在设置中修改</li></ul></div>
             <div class="help-section"><h4>🕐 历史记录</h4><ul><li>所有会话自动保存到本地 SQLite</li><li>点击顶部 🕐 按钮查看、搜索、恢复历史会话</li><li>支持导出 JSON / <code>.metona</code> 加密备份</li></ul></div>