feat: 升级至 v0.3.4 — 接入 Xiaomi MiMo Provider + 文档全量校准
新增 MiMo (小米) LLM Provider 适配器，支持 mimo-v2.5-pro 和 mimo-v2.5 两个文本模型，复用 OpenAI 兼容 SSE 流式解析，支持 Thinking 模式和 Function Calling。同步校准全量 docs 文档与 README 使其与实际代码一致。 主要变更： - 新增 mimo.adapter.ts 适配器（SSE + thinking.type + max_completion_tokens） - 修复 thinking 逻辑 bug：禁用思考时未传 temperature/top_p - 补全 sse-stream.ts 的 MiMo 缓存字段映射（prompt_tokens_details.cached_tokens） - 补全 sse-stream.ts 的 finish_reason 映射（repetition_truncation） - 注册 MiMo 适配器到 adapters/index.ts、main.ts 工厂 - handlers.ts 添加 mimo.contextWindow 热重载触发 - database.service.ts seed 添加 mimo 默认配置 - SettingsModal/OnboardingWizard/Header 添加 MiMo Provider UI - constants.ts PROVIDER_LABELS 添加 mimo - .env.example 添加 MIMO_API_KEY/MIMO_BASE_URL - 反向修改 4 个 docs HTML 设计文档（工具数量/版本日期/适配器列表/数据库表） - 反向修改 Agent网络工具通用设计-v2.md 附录 B 文件索引 - 完全重写 README.md（v0.3.4、27 工具、4 适配器、9 表）
This commit is contained in:
thzxx
@@ -591,7 +591,7 @@
|
||||
<div class="hero-meta">
|
||||
<span><span class="dot dot-blue"></span> 技术栈: <strong>TypeScript + React + SQLite + Electron</strong></span>
|
||||
<span><span class="dot dot-green"></span> 版本: <strong>v1.0.0</strong></span>
|
||||
<span><span class="dot dot-amber"></span> 更新日期: <strong>2026-06-26</strong></span>
|
||||
<span><span class="dot dot-amber"></span> 更新日期: <strong>2026-07-15</strong></span>
|
||||
</div>
|
||||
<div class="note-box" style="margin-top:16px">
|
||||
<strong>📋 文档层级：</strong>本文档是 <strong>理论基础与全景概述</strong>。各子领域的权威定义见以下文档（冲突时以子文档为准）：<br>• 类型系统与数据格式 → <strong>《Metona 内部 API 请求与响应标准》</strong><br>• 工作空间/工具/磁盘文件 → <strong>《MetonaAI-Desktop 架构与交互设计》</strong><br>• 用户界面与交互 → <strong>《MetonaAI-Desktop UI/UX 设计集成方案》</strong>
|
||||
@@ -601,7 +601,7 @@
|
||||
<div class="content">
|
||||
<h1>生产级通用 AI Agent 智能体桌面应用：完整设计与构建指南</h1>
|
||||
<blockquote>
|
||||
<p><strong>技术栈</strong>：TypeScript + React + SQLite + Electron<br><strong>版本</strong>：v1.0.0 | <strong>更新日期</strong>：2026-06-24<br><strong>定位</strong>：从架构设计到代码实现的全链路生产级工程指南</p>
|
||||
<p><strong>技术栈</strong>：TypeScript + React + SQLite + Electron<br><strong>版本</strong>：v1.0.0 | <strong>更新日期</strong>：2026-07-15<br><strong>定位</strong>：从架构设计到代码实现的全链路生产级工程指南</p>
|
||||
</blockquote>
|
||||
<hr>
|
||||
<h2>目录</h2>
|
||||
@@ -1092,12 +1092,28 @@
|
||||
│ │ ├── tools/ # 工具注册与管理
|
||||
│ │ │ ├── registry.ts # 工具注册表
|
||||
│ │ │ ├── base-tool.ts # 工具基类/接口
|
||||
│ │ │ └── built-in/ # 内置工具集
|
||||
│ │ │ ├── filesystem.ts # 文件系统工具
|
||||
│ │ │ ├── web-search.ts # 网络搜索工具
|
||||
│ │ │ ├── calculator.ts # 计算器工具
|
||||
│ │ │ ├── code-executor.ts # 代码执行工具
|
||||
│ │ │ └── index.ts
|
||||
│ │ │ └── built-in/ # 内置工具集（21 个文件，27 个工具）
|
||||
│ │ │ ├── filesystem.ts # 文件系统（5 工具）
|
||||
│ │ │ ├── file-editor.ts # 编辑器
|
||||
│ │ │ ├── code-search.ts # 代码搜索
|
||||
│ │ │ ├── diff-viewer.ts # 差异查看
|
||||
│ │ │ ├── web-search.ts # 网络搜索
|
||||
│ │ │ ├── web-fetch.ts # 网页抓取
|
||||
│ │ │ ├── browser.ts # 浏览器工具
|
||||
│ │ │ ├── browser-window-manager.ts
|
||||
│ │ │ ├── network.ts # 网络工具入口
|
||||
│ │ │ ├── network-utils.ts # 网络工具函数
|
||||
│ │ │ ├── http-request.ts # HTTP 请求
|
||||
│ │ │ ├── memory.ts # 记忆工具
|
||||
│ │ │ ├── command.ts # 命令执行
|
||||
│ │ │ ├── git.ts # Git 工具（4 个）
|
||||
│ │ │ ├── dev-tools.ts # 开发工具（3 个）
|
||||
│ │ │ ├── task-manager.ts # 任务管理
|
||||
│ │ │ ├── delegate-task.ts # 子任务委派
|
||||
│ │ │ ├── todo.ts # TODO 工具
|
||||
│ │ │ ├── think.ts # 思考工具
|
||||
│ │ │ ├── view-image.ts # 图片查看
|
||||
│ │ │ └── file-guard.ts # 文件保护
|
||||
│ │ ├── prompts/ # Prompt 模板管理
|
||||
│ │ │ ├── system-prompt.ts # 系统 Prompt 构建
|
||||
│ │ │ ├── templates/ # Prompt 模板文件
|
||||
@@ -2661,6 +2677,7 @@ export class ToolRegistry {
|
||||
}
|
||||
}
|
||||
</code></pre>
|
||||
<p><strong>🔧 备注</strong>：v0.3.3 当前已实现 <strong>27 个内置工具</strong>，完整列表详见 <code>README.md</code>「内置工具」章节。下方仅以文件系统工具为示例展示实现规范。</p>
|
||||
<p><strong>内置工具示例——文件系统工具</strong>：</p>
|
||||
<pre><code class="language-typescript">// ====== electron/harness/tools/built-in/filesystem.ts ======
|
||||
|
||||
@@ -3298,6 +3315,7 @@ export interface ValidationIssue {
|
||||
</tbody>
|
||||
</table>
|
||||
<h3>6.2 SQLite 存储方案设计</h3>
|
||||
<p><strong>📁 实际表结构</strong>：v0.3.3 实际共 <strong>9 张表</strong>，包含：<code>sessions</code>、<code>messages</code>、<code>app_config</code>、<code>audit_logs</code>、<code>mcp_servers</code>、<code>episodic_memories</code>、<code>semantic_memories</code>、<code>working_memories</code>、<code>tasks</code>（新增任务表，用于 Agent 子任务管理）。</p>
|
||||
<pre><code class="language-sql">-- ====== database/schema.sql ======
|
||||
|
||||
-- ============================================
|
||||
@@ -4345,6 +4363,7 @@ declare global {
|
||||
}
|
||||
</code></pre>
|
||||
<h3>8.3 IPC 通道设计规范</h3>
|
||||
<p><strong>🔗 实际规模</strong>：v0.3.3 实际已注册 <strong>50+ 个 IPC 通道</strong>，覆盖 agent、sessions、db、mcp、config、app、tasks 等多个 domain。下方代码为注册规范的代表性示例。</p>
|
||||
<pre><code class="language-typescript">// ====== electron/ipc/index.ts ======
|
||||
|
||||
/**
|
||||
@@ -6548,7 +6567,7 @@ ENABLE_TELEMETRY=true
|
||||
<!-- FOOTER -->
|
||||
<div style="text-align:center;padding:40px 0 20px;color:var(--text-dim);font-size:13px;border-top:1px solid var(--border)">
|
||||
<p>🤖 生产级通用 AI Agent 智能体桌面应用：完整设计与构建指南</p>
|
||||
<p>版本: <strong style="color:var(--accent)">v1.0.0</strong> · 最后更新: <strong style="color:var(--accent)">2026-06-24</strong></p>
|
||||
<p>版本: <strong style="color:var(--accent)">v1.0.0</strong> · 最后更新: <strong style="color:var(--accent)">2026-07-15</strong></p>
|
||||
<p style="margin-top:8px">作者: <strong style="color:var(--accent2)">AI Agent Engineering Team</strong> · 许可协议: <strong style="color:var(--green)">CC BY-SA 4.0</strong></p>
|
||||
</div>
|
||||
|
||||
|
||||
Reference in New Issue
Block a user