v1.0.0

发布日期：2026-03-20

MateClaw 首个正式版本。基于 Spring AI Alibaba 构建的 Java + Vue 3 个人 AI 助手系统。

Agent 引擎

• ReAct Agent — Thought → Action → Observation 循环，支持工具调用与多步骤任务
• Plan-and-Execute — 复杂任务自动拆解为有序子步骤，逐步执行并验证
• StateGraph 统一引擎 — Agent 架构改造，统一流式处理与状态管理
• 多 Agent 协作 — Agent 间委派工具，支持 agent-to-agent 协作
• Agent 工作区 — 基于 Markdown 的系统提示词管理

模型支持

• 多供应商 — DashScope、Ollama、OpenAI、Kimi、DeepSeek、Zhipu、Anthropic/Claude 等 15+ 供应商
• 模型发现与连接测试 — Provider 远端模型自动发现 + 连通性验证
• Thinking 模型 — 支持 Kimi K2.5 thinking 显示 + 打字机效果
• GPT-5 兼容 — tools 与 reasoning_effort 互斥时自动移除
• ModelFamily 适配 — gpt-5 max_tokens → max_completion_tokens 自动转换

工具系统

• 内置工具 — WebSearch、DateTime、ShellExecute、文件操作等
• MCP 协议 — 动态 MCP Server 连接与工具接入（stdio + SSE）
• ToolGuard 安全引擎 — 三级决策（自动放行/人工审批/自动拒绝）
• 人工审批 (HITL) — 敏感工具执行前需用户确认，审批持久化
• 跨平台命令执行 — Windows 兼容 + timeout 生效

技能系统

• SKILL.md 协议 — 定义、上传、安装技能
• 技能运行时 — SkillMarket 全链路集成，启动时自动同步预置技能
• 安全扫描 — Skill Scanner 分层安全策略 + 依赖声明与运行时检查
• 内置技能 — docx/pdf/pptx/xlsx/himalaya 文档处理技能

多渠道接入

• Web — SSE 流式，文件拖拽上传（含目录），上传限制 100MB
• 钉钉 — Stream 长连接模式，事件流与渲染分离
• 飞书 — WebSocket 长连接 + 动态权限提示
• 企业微信 — WebSocket 长连接（替代 HTTP 回调）
• Telegram — Long-Polling 模式 + 代理支持
• Discord — Gateway WebSocket + 媒体上传降级 + 代理支持
• QQ 机器人 — WebSocket 长连接接入
• 渠道图标 — SVG 品牌图标，会话列表显示来源渠道

前端

• Vue 3 + Element Plus + TailwindCSS — Pinia 状态管理，暗黑模式
• 聊天功能 — 多消息队列、线程安全、消息排序、流式 Loading 组件
• 工具审批 UI — 审批操作内联到输入框
• Token 用量 — 采集、持久化、查询与展示
• 工作区文件管理 — 文件系统浏览与文档种子数据

桌面应用

• Electron 跨平台 — macOS (ARM64 + Intel) + Windows (x64)
• 自动升级 — electron-updater 整包自动升级
• macOS 代码签名 — 完整签名与公证流程

后端

• Spring Security + JWT — 认证与授权
• MyBatis Plus ORM — camelCase 自动映射，逻辑删除
• H2 / MySQL / MariaDB — 开发用 H2，生产支持 MySQL 8.0+ 和 MariaDB 10.11
• 数据库自动检测 — MySQL/MariaDB 专用 SQL 文件，启动时自动识别
• SpringDoc OpenAPI — 替换 Knife4j，API 文档
• 定时任务 — Cron Jobs 功能

部署

• Docker 生产部署 — docker-compose + Nginx 域名路由
• Java 21 — Dockerfile 基础镜像 Java 21
• VitePress 文档站 — 中英双语，本地搜索