opensource/mateclaw
2
0
Fork 0
mirror of https://gitee.com/mateos/mateclaw.git synced 2026-09-13 03:13:41 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

chore: point GitHub repo URL to mateaix/mateclaw

Browse Source
This commit is contained in:
matevip 2026-06-22 16:23:49 +08:00
parent 2cf08683a4
commit 438a5e00d7
20 changed files with 46 additions and 46 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
README.md
View File

@ -10,14 +10,14 @@
<p align="center"><sub><b>Agent Harness · Spring Boot inside · One JAR to ship</b></sub></p>
[![GitHub Repo](https://img.shields.io/badge/GitHub-Repo-black.svg?logo=github)](https://github.com/matevip/mateclaw)
[![GitHub Repo](https://img.shields.io/badge/GitHub-Repo-black.svg?logo=github)](https://github.com/mateaix/mateclaw)
[![Documentation](https://img.shields.io/badge/Docs-Website-green.svg?logo=readthedocs&label=Docs)](https://claw.mate.vip/docs)
[![Live Demo](https://img.shields.io/badge/Demo-Online-orange.svg?logo=vercel&label=Demo)](https://claw-demo.mate.vip)
[![Website](https://img.shields.io/badge/Website-claw.mate.vip-blue.svg?logo=googlechrome&label=Site)](https://claw.mate.vip)
[![Java Version](https://img.shields.io/badge/Java-21+-blue.svg?logo=openjdk&label=Java)](https://adoptium.net/)
[![Spring Boot](https://img.shields.io/badge/Spring%20Boot-3.5-brightgreen.svg?logo=springboot)](https://spring.io/projects/spring-boot)
[![Vue](https://img.shields.io/badge/Vue-3-4FC08D.svg?logo=vuedotjs)](https://vuejs.org/)
[![Last Commit](https://img.shields.io/github/last-commit/matevip/mateclaw)](https://github.com/matevip/mateclaw)
[![Last Commit](https://img.shields.io/github/last-commit/mateaix/mateclaw)](https://github.com/mateaix/mateclaw)
[![License](https://img.shields.io/badge/license-Apache--2.0-red.svg?logo=opensourceinitiative&label=License)](LICENSE)
[[Website](https://claw.mate.vip)] [[Live Demo](https://claw-demo.mate.vip)] [[Documentation](https://claw.mate.vip/docs)] [[中文](README_zh.md)]
@ -161,7 +161,7 @@ docker compose up -d # http://localhost:18080
### Desktop
Download from [GitHub Releases](https://github.com/matevip/mateclaw/releases). Bundles JRE 21. No Java install needed.
Download from [GitHub Releases](https://github.com/mateaix/mateclaw/releases). Bundles JRE 21. No Java install needed.
---
@ -193,7 +193,7 @@ mateclaw/
└── .env.example
```
Desktop binaries ship via [GitHub Releases](https://github.com/matevip/mateclaw/releases) with a bundled JRE 21 — no Java install needed.
Desktop binaries ship via [GitHub Releases](https://github.com/mateaix/mateclaw/releases) with a bundled JRE 21 — no Java install needed.
## Tech stack
@ -235,7 +235,7 @@ Full docs at **[claw.mate.vip/docs](https://claw.mate.vip/docs)** — setup, arc
## Contributing
```bash
git clone https://github.com/matevip/mateclaw.git
git clone https://github.com/mateaix/mateclaw.git
cd mateclaw
cd mateclaw-server && mvn clean compile
cd ../mateclaw-ui && pnpm install && pnpm dev

10
README_zh.md
View File

@ -10,14 +10,14 @@
<p align="center"><sub><b>Agent Harness · Spring Boot 内核 · 一个 JAR 交付</b></sub></p>
[![GitHub 仓库](https://img.shields.io/badge/GitHub-仓库-black.svg?logo=github)](https://github.com/matevip/mateclaw)
[![GitHub 仓库](https://img.shields.io/badge/GitHub-仓库-black.svg?logo=github)](https://github.com/mateaix/mateclaw)
[![文档](https://img.shields.io/badge/文档-在线-green.svg?logo=readthedocs&label=Docs)](https://claw.mate.vip/docs)
[![在线演示](https://img.shields.io/badge/演示-在线-orange.svg?logo=vercel&label=Demo)](https://claw-demo.mate.vip)
[![官网](https://img.shields.io/badge/官网-claw.mate.vip-blue.svg?logo=googlechrome&label=Site)](https://claw.mate.vip)
[![Java 版本](https://img.shields.io/badge/Java-21+-blue.svg?logo=openjdk&label=Java)](https://adoptium.net/)
[![Spring Boot](https://img.shields.io/badge/Spring%20Boot-3.5-brightgreen.svg?logo=springboot)](https://spring.io/projects/spring-boot)
[![Vue](https://img.shields.io/badge/Vue-3-4FC08D.svg?logo=vuedotjs)](https://vuejs.org/)
[![最后提交](https://img.shields.io/github/last-commit/matevip/mateclaw)](https://github.com/matevip/mateclaw)
[![最后提交](https://img.shields.io/github/last-commit/mateaix/mateclaw)](https://github.com/mateaix/mateclaw)
[![许可证](https://img.shields.io/badge/license-Apache--2.0-red.svg?logo=opensourceinitiative&label=License)](LICENSE)
[[官网](https://claw.mate.vip)] [[在线演示](https://claw-demo.mate.vip)] [[文档](https://claw.mate.vip/docs)] [[English](README.md)]
@ -161,7 +161,7 @@ docker compose up -d # http://localhost:18080
### 桌面端
从 [GitHub Releases](https://github.com/matevip/mateclaw/releases) 下载安装包。内嵌 JRE 21，无需额外装 Java。
从 [GitHub Releases](https://github.com/mateaix/mateclaw/releases) 下载安装包。内嵌 JRE 21，无需额外装 Java。
---
@ -193,7 +193,7 @@ mateclaw/
└── .env.example
```
桌面端安装包通过 [GitHub Releases](https://github.com/matevip/mateclaw/releases) 分发，内嵌 JRE 21——无需安装 Java。
桌面端安装包通过 [GitHub Releases](https://github.com/mateaix/mateclaw/releases) 分发，内嵌 JRE 21——无需安装 Java。
## 技术栈
@ -235,7 +235,7 @@ mateclaw/
## 参与贡献
```bash
git clone https://github.com/matevip/mateclaw.git
git clone https://github.com/mateaix/mateclaw.git
cd mateclaw
cd mateclaw-server && mvn clean compile
cd ../mateclaw-ui && pnpm install && pnpm dev

6
mateclaw-server/src/main/resources/docs/en/chat.md
View File

@ -97,7 +97,7 @@ Files a worker generates via tools (documents / images / audio…) are now **per
### Primary model can't see images? "Multimodal sidecar" routing
::: tip Added in 1.3.0
When the agent's primary model is text-only (e.g. `deepseek-chat`, `kimi-k2`), uploading an image no longer breaks. The runtime auto-routes through a sidecar. See [issue #87](https://github.com/matevip/mateclaw/issues/87).
When the agent's primary model is text-only (e.g. `deepseek-chat`, `kimi-k2`), uploading an image no longer breaks. The runtime auto-routes through a sidecar. See [issue #87](https://github.com/mateaix/mateclaw/issues/87).
:::
How it works:
@ -182,7 +182,7 @@ The segment representation is what powers the progressive display. It also makes
### Per-conversation model selection
::: tip Added in 1.4.0
The model selector in the chat header now binds a model **to the conversation**, not as a global switch. See [issue #150](https://github.com/matevip/mateclaw/issues/150).
The model selector in the chat header now binds a model **to the conversation**, not as a global switch. See [issue #150](https://github.com/mateaix/mateclaw/issues/150).
:::
Switching the model in the header affects **only this conversation**: the choice is stored on the conversation and takes effect starting with the **next message**. A conversation you never set explicitly falls back to the workspace default model. The runtime model indicator stays in sync with whatever is pinned on the conversation — what you see is what the next turn actually uses.
@ -192,7 +192,7 @@ This isolation also makes model config more robust: **a single bad model id no l
### Conversation list management
::: tip Added in 1.4.0
The conversation sidebar grew from a plain history list into an actionable operations panel. See [issue #144](https://github.com/matevip/mateclaw/issues/144).
The conversation sidebar grew from a plain history list into an actionable operations panel. See [issue #144](https://github.com/mateaix/mateclaw/issues/144).
:::
- **Pin / unpin** — from each row's `⋮` overflow menu. Important threads stay at the top in a "Pinned" group.

2
mateclaw-server/src/main/resources/docs/en/docker-deploy.md
View File

@ -166,7 +166,7 @@ curl -s http://localhost:18080/api/v1/system/browser-health | jq .
## First deployment
```sh
git clone https://github.com/matevip/mateclaw.git
git clone https://github.com/mateaix/mateclaw.git
cd mateclaw
# 1. Fill in required values

6
mateclaw-server/src/main/resources/docs/en/faq.md
View File

@ -1,6 +1,6 @@
# FAQ
Common questions and real answers. If your question isn't here, check the relevant feature page or open a [GitHub issue](https://github.com/matevip/mateclaw/issues).
Common questions and real answers. If your question isn't here, check the relevant feature page or open a [GitHub issue](https://github.com/mateaix/mateclaw/issues).
---
@ -322,7 +322,7 @@ Try launching from a terminal. On Windows, right-click → Unblock. On macOS, al
### How do I update the desktop app?
**Auto-updates** via electron-updater. On startup, checks GitHub Releases and prompts you when a new version is available. Manual download also available from [Releases](https://github.com/matevip/mateclaw/releases).
**Auto-updates** via electron-updater. On startup, checks GitHub Releases and prompts you when a new version is available. Manual download also available from [Releases](https://github.com/mateaix/mateclaw/releases).
---
@ -419,4 +419,4 @@ Stored in `localStorage`. Clearing browser data wipes it.
- [Quick Start](./quickstart) — setup walkthrough
- [Configuration](./config) — full configuration reference
- [Contributing](./contributing) — how to report bugs and request features
- [GitHub Issues](https://github.com/matevip/mateclaw/issues) — when the docs don't answer your question
- [GitHub Issues](https://github.com/mateaix/mateclaw/issues) — when the docs don't answer your question

2
mateclaw-server/src/main/resources/docs/en/index.md
View File

@ -17,7 +17,7 @@ hero:
link: /en/intro
- theme: alt
text: GitHub
link: https://github.com/matevip/mateclaw
link: https://github.com/mateaix/mateclaw
features:
- icon: 🧑‍💼

10
mateclaw-server/src/main/resources/docs/en/models.md
View File

@ -272,7 +272,7 @@ Restart MateClaw. Auto-discovered, added, enabled.
No `EMBEDDING_API_KEY` env vars. Embedding models are regular rows in `mate_model_config` with `model_type='embedding'`. They show up alongside chat models in `Settings → Models`. Knowledge bases pick their embedding model from a dropdown.
::: tip New in 1.4.0 ([issue #79](https://github.com/matevip/mateclaw/issues/79))
::: tip New in 1.4.0 ([issue #79](https://github.com/mateaix/mateclaw/issues/79))
**Embedding models from any provider.** In the embedding section of `Settings → Models`, configure an embedding model from any provider — it **reuses that provider's API key**, so there's no separate `EMBEDDING_API_KEY`. Each knowledge base picks its embedding model from a dropdown. Keyless local proxies use a no-op placeholder key; the protocol is resolved from the provider's chat-model / protocol setting, so you never hand-enter it.
:::
@ -299,7 +299,7 @@ System prompts, agent personas, tool definitions — automatically marked with `
**Multi-round tool calls + thinking**: thinking-capable models (DeepSeek-Reasoner / GPT-5 / Kimi K2.5 / Xiaomi MiMo) correctly round-trip historical `reasoning_content` during ReAct multi-round tool calls. Cross-user-turn history is cleared at the boundary, in-turn history is preserved — matching DeepSeek's "pass back within a turn, reset across turns" contract.
**Xiaomi MiMo thinking-mode multi-turn fix** ([issue #189](https://github.com/matevip/mateclaw/issues/189)): MiMo's `reasoning_content` is now kept correctly across turns in thinking mode, instead of being lost on subsequent turns.
**Xiaomi MiMo thinking-mode multi-turn fix** ([issue #189](https://github.com/mateaix/mateclaw/issues/189)): MiMo's `reasoning_content` is now kept correctly across turns in thinking mode, instead of being lost on subsequent turns.
---
@ -323,7 +323,7 @@ Takes effect **immediately** — no restart. Next message uses the new model. In
Per-agent override supported: bind a specific agent to a specific model config.
::: tip New in 1.4.0
- **Per-conversation model selection** ([issue #150](https://github.com/matevip/mateclaw/issues/150)): in the chat UI you can switch the model for **just the current conversation**, without touching the global active model or any other conversation. See [Chat & Messaging](./chat).
- **Per-conversation model selection** ([issue #150](https://github.com/mateaix/mateclaw/issues/150)): in the chat UI you can switch the model for **just the current conversation**, without touching the global active model or any other conversation. See [Chat & Messaging](./chat).
- **A single bad model id no longer evicts the whole provider**: when discovery / probing hits one invalid model identifier, only that model is skipped — the rest of the provider's models stay available.
:::
@ -345,7 +345,7 @@ Use it whenever you add a new provider or suspect a stale key.
## Multimodal sidecar (system-wide)
::: tip Added in 1.3.0
Lets a text-only primary model still answer questions about uploaded images. See [issue #87](https://github.com/matevip/mateclaw/issues/87).
Lets a text-only primary model still answer questions about uploaded images. See [issue #87](https://github.com/mateaix/mateclaw/issues/87).
:::
Entry point: **Settings → Models → Multimodal sidecar**. Two independent cards:
@ -362,7 +362,7 @@ The setting stores `mate_model_config.id` rather than `model_name` — the same
The dropdown only lists models that **actually support the relevant modality** — filtered by `ModelCapabilityService.supports(...)` on the backend; disabled providers or models without a declared vision capability never appear. Each card has its own Save button, independent of the other.
When does it fire? `MultimodalRouter` ([source](https://github.com/matevip/mateclaw/blob/main/mateclaw-server/src/main/java/vip/mate/llm/routing/MultimodalRouter.java)) decides per turn:
When does it fire? `MultimodalRouter` ([source](https://github.com/mateaix/mateclaw/blob/main/mateclaw-server/src/main/java/vip/mate/llm/routing/MultimodalRouter.java)) decides per turn:
- Primary already supports vision → no routing (native multimodal path)
- Primary lacks vision + vision sidecar configured → SIDECAR strategy, captions to text

4
mateclaw-server/src/main/resources/docs/en/quickstart.md
View File

@ -8,7 +8,7 @@ If you want Docker or local development instead, those live in [Configuration](.
## 1. Download
Grab the latest installer from [GitHub Releases](https://github.com/matevip/mateclaw/releases).
Grab the latest installer from [GitHub Releases](https://github.com/mateaix/mateclaw/releases).
- **Windows** — `MateClaw-Setup-x.y.z.exe`
- **macOS** — `MateClaw-x.y.z.dmg`
@ -71,7 +71,7 @@ First run should Just Work. If it didn't:
- **Backend never boots** — Check the log file (macOS: `~/Library/Application Support/MateClaw/logs/mateclaw.log`; Windows: `%APPDATA%\MateClaw\logs\mateclaw.log`). The desktop app picks a dynamic port — any port conflict is reported clearly in the log.
- **Model call fails** — Wrong API key or network can't reach the provider. Go back to Settings, re-verify the key, or try a different provider.
- **UI is blank** — Hard-refresh with Ctrl/Cmd+Shift+R. Electron caches aggressively.
- **Still broken** — Open an issue on [GitHub](https://github.com/matevip/mateclaw/issues) with the tail of `app.log`. We read them.
- **Still broken** — Open an issue on [GitHub](https://github.com/mateaix/mateclaw/issues) with the tail of `app.log`. We read them.
---

2
mateclaw-server/src/main/resources/docs/en/user-guide.md
View File

@ -186,7 +186,7 @@ Create a role-specific agent → install skills → connect MCP servers → conf
| Model call fails | Wrong API key or network issue. Go back to Settings |
| UI is blank | Ctrl+Shift+R to hard-refresh |
| Ollama says "does not support tools" | Switch to a function-calling model (qwen3, llama3.1:8b+) |
| Still broken | [GitHub Issues](https://github.com/matevip/mateclaw/issues) with the tail of `app.log` |
| Still broken | [GitHub Issues](https://github.com/mateaix/mateclaw/issues) with the tail of `app.log` |
---

2
mateclaw-server/src/main/resources/docs/en/webchat.md
View File

@ -247,4 +247,4 @@ curl -N -X POST https://mate.example.com/api/v1/channels/webchat/stream \
## Related
- Upstream epic issue: https://github.com/matevip/mateclaw/issues/355
- Upstream epic issue: https://github.com/mateaix/mateclaw/issues/355

2
mateclaw-server/src/main/resources/docs/en/workspaces.md
View File

@ -204,7 +204,7 @@ Not supported directly. You have two options:
1. **Export and import** — some resources have JSON export (agents via API, wiki KBs via API). Re-create them in the target workspace.
2. **Change ownership** — an admin or owner can directly update the `workspace_id` column in the database for simple resources. This is not officially supported; do it at your own risk and only with a backup.
We'd like to support first-class moving in a future release. If you need this, leave a note on the [GitHub issue](https://github.com/matevip/mateclaw/issues).
We'd like to support first-class moving in a future release. If you need this, leave a note on the [GitHub issue](https://github.com/mateaix/mateclaw/issues).
---

6
mateclaw-server/src/main/resources/docs/zh/chat.md
View File

@ -97,7 +97,7 @@ ChatConsole 不只是你自己聊天的地方。它是一个**运营控制台**
### 主模型不支持图片？走"多模态旁路"
::: tip 1.3.0 新增
当 Agent 配的主模型是纯文本模型（如 `deepseek-chat` / `kimi-k2`），上传图片不再"系统无法工作"，而是自动走旁路（sidecar）。详见 [issue #87](https://github.com/matevip/mateclaw/issues/87)。
当 Agent 配的主模型是纯文本模型（如 `deepseek-chat` / `kimi-k2`），上传图片不再"系统无法工作"，而是自动走旁路（sidecar）。详见 [issue #87](https://github.com/mateaix/mateclaw/issues/87)。
:::
工作机制：
@ -182,7 +182,7 @@ Segment 的结构是渐进展示的底层。它也让**数据库成为单一事
### 按会话选模型
::: tip 1.4.0 新增
聊天顶栏的模型选择器现在把模型**绑定在会话上**，而不是全局开关。详见 [issue #150](https://github.com/matevip/mateclaw/issues/150)。
聊天顶栏的模型选择器现在把模型**绑定在会话上**，而不是全局开关。详见 [issue #150](https://github.com/mateaix/mateclaw/issues/150)。
:::
在顶栏切换模型，只影响**当前这个会话**：选择会随会话存下来，并从**下一条消息**开始生效。没有显式设置过的会话，回落到工作空间默认模型。运行时模型指示器始终和会话上钉住的那一个保持同步——你看到的就是下一回合真正会用的。
@ -192,7 +192,7 @@ Segment 的结构是渐进展示的底层。它也让**数据库成为单一事
### 会话列表管理
::: tip 1.4.0 新增
会话侧栏从一条单纯的历史列表，升级成了一个可操作的运营面板。详见 [issue #144](https://github.com/matevip/mateclaw/issues/144)。
会话侧栏从一条单纯的历史列表，升级成了一个可操作的运营面板。详见 [issue #144](https://github.com/mateaix/mateclaw/issues/144)。
:::
- **置顶 / 取消置顶**——从每行的 `⋮` 溢出菜单操作，重要的会话固定在列表顶部的「置顶」分组里。

2
mateclaw-server/src/main/resources/docs/zh/docker-deploy.md
View File

@ -166,7 +166,7 @@ curl -s http://localhost:18080/api/v1/system/browser-health | jq .
## 第一次部署
```sh
git clone https://github.com/matevip/mateclaw.git
git clone https://github.com/mateaix/mateclaw.git
cd mateclaw
# 1. 必填项写到 .env

6
mateclaw-server/src/main/resources/docs/zh/faq.md
View File

@ -1,6 +1,6 @@
# 常见问题（FAQ）
常见问题 + 真答案。你的问题不在这里就看对应的功能页，或者去 [GitHub issue](https://github.com/matevip/mateclaw/issues) 开一个。
常见问题 + 真答案。你的问题不在这里就看对应的功能页，或者去 [GitHub issue](https://github.com/mateaix/mateclaw/issues) 开一个。
---
@ -322,7 +322,7 @@ docker exec mateclaw-mysql mysqldump -u root -p${MYSQL_ROOT_PASSWORD} mateclaw >
### 怎么更新桌面 app？
**自动更新**通过 electron-updater。启动时检查 GitHub Releases 并弹提示。也可以手动从 [Releases](https://github.com/matevip/mateclaw/releases) 下载。
**自动更新**通过 electron-updater。启动时检查 GitHub Releases 并弹提示。也可以手动从 [Releases](https://github.com/mateaix/mateclaw/releases) 下载。
---
@ -419,4 +419,4 @@ ls ../mateclaw-server/src/main/resources/static/
- [快速开始](./quickstart)——搭建 walkthrough
- [配置说明](./config)——完整配置参考
- [贡献指南](./contributing)——怎么报 bug 和提功能请求
- [GitHub Issues](https://github.com/matevip/mateclaw/issues)——文档没答案的时候去这里
- [GitHub Issues](https://github.com/mateaix/mateclaw/issues)——文档没答案的时候去这里

2
mateclaw-server/src/main/resources/docs/zh/index.md
View File

@ -17,7 +17,7 @@ hero:
link: /zh/intro
- theme: alt
text: GitHub
link: https://github.com/matevip/mateclaw
link: https://github.com/mateaix/mateclaw
features:
- icon: 🧑‍💼

10
mateclaw-server/src/main/resources/docs/zh/models.md
View File

@ -273,7 +273,7 @@ ollama pull qwen3
不用配 `EMBEDDING_API_KEY` 环境变量。嵌入模型就是 `mate_model_config` 里 `model_type='embedding'` 的普通行。`设置 → 模型` 里和聊天模型列在一起。知识库从下拉里选它的嵌入模型。
::: tip 1.4.0 新增（[issue #79](https://github.com/matevip/mateclaw/issues/79)）
::: tip 1.4.0 新增（[issue #79](https://github.com/mateaix/mateclaw/issues/79)）
**任意供应商都能提供嵌入模型。** 在 `设置 → 模型` 的嵌入区域里，配一个来自任何供应商的嵌入模型——直接**复用那家供应商的 API Key**，不再单独要 `EMBEDDING_API_KEY`。每个知识库从下拉里挑自己的嵌入模型。无密钥的本地代理用一个空操作占位 key；协议从该供应商的聊天模型 / protocol 设置里自动解析，不用再手填。
:::
@ -300,7 +300,7 @@ ollama pull qwen3
**多轮 tool call + thinking**：带 thinking 的模型（DeepSeek-Reasoner / GPT-5 / Kimi K2.5 / 小米 MiMo）在 ReAct 多轮 tool call 场景下，历史消息的 `reasoning_content` 会正确回传给 provider；跨用户问题边界时自动清除，同一问题内的子轮次全部保留——符合 DeepSeek 的"同问题子轮必须回传、跨问题时清"契约。
**小米 MiMo 思考模式多轮修复**（[issue #189](https://github.com/matevip/mateclaw/issues/189)）：MiMo 思考模式的 `reasoning_content` 现在能在多轮对话里正确保留，不再在后续轮次丢失。
**小米 MiMo 思考模式多轮修复**（[issue #189](https://github.com/mateaix/mateclaw/issues/189)）：MiMo 思考模式的 `reasoning_content` 现在能在多轮对话里正确保留，不再在后续轮次丢失。
---
@ -324,7 +324,7 @@ MateClaw 用一个**活跃模型**作为全局默认。没有指定自己模型
也支持按 Agent 覆盖：把某个 Agent 绑定到特定模型配置。
::: tip 1.4.0 新增
- **按会话选模型**（[issue #150](https://github.com/matevip/mateclaw/issues/150)）：在聊天界面里可以为**当前这一条会话**临时切换模型，不影响全局活跃模型和别的会话。详见 [聊天与消息](./chat)。
- **按会话选模型**（[issue #150](https://github.com/mateaix/mateclaw/issues/150)）：在聊天界面里可以为**当前这一条会话**临时切换模型，不影响全局活跃模型和别的会话。详见 [聊天与消息](./chat)。
- **单个坏模型 id 不再连累整个供应商**：发现 / 探活时遇到一个无效的模型标识符，只跳过那一个模型，供应商下其余模型照常可用。
:::
@ -346,7 +346,7 @@ MateClaw 用一个**活跃模型**作为全局默认。没有指定自己模型
## 多模态旁路（系统级）
::: tip 1.3.0 新增
让纯文本主模型也能"看图回答"，参见 [issue #87](https://github.com/matevip/mateclaw/issues/87)。
让纯文本主模型也能"看图回答"，参见 [issue #87](https://github.com/mateaix/mateclaw/issues/87)。
:::
入口：**设置 → 模型 → 多模态旁路**。两个独立的卡片：
@ -363,7 +363,7 @@ MateClaw 用一个**活跃模型**作为全局默认。没有指定自己模型
下拉只列**支持对应 modality 的模型**——筛选逻辑走后端 `ModelCapabilityService.supports(...)`，未启用 / 没声明 vision 能力的模型都不会出现在选项里。每张卡片有独立的"保存"按钮，互不干扰。
什么时候触发？运行时由 `MultimodalRouter` 决策（[源码](https://github.com/matevip/mateclaw/blob/main/mateclaw-server/src/main/java/vip/mate/llm/routing/MultimodalRouter.java)）：
什么时候触发？运行时由 `MultimodalRouter` 决策（[源码](https://github.com/mateaix/mateclaw/blob/main/mateclaw-server/src/main/java/vip/mate/llm/routing/MultimodalRouter.java)）：
- 主模型已支持图片 → 不路由（走原 native multimodal 路径）
- 主模型不支持图片 + 配了视觉旁路 → SIDECAR 策略，视觉模型转描述

4
mateclaw-server/src/main/resources/docs/zh/quickstart.md
View File

@ -8,7 +8,7 @@ Docker 和源码启动在 [配置说明](./config) 和 [贡献指南](./contribu
## 1. 下载
去 [GitHub Releases](https://github.com/matevip/mateclaw/releases) 拿最新安装包。
去 [GitHub Releases](https://github.com/mateaix/mateclaw/releases) 拿最新安装包。
- **Windows**——`MateClaw-Setup-x.y.z.exe`
- **macOS**——`MateClaw-x.y.z.dmg`
@ -71,7 +71,7 @@ Docker 和源码启动在 [配置说明](./config) 和 [贡献指南](./contribu
- **后端起不来**——看日志文件（macOS：`~/Library/Application Support/MateClaw/logs/mateclaw.log`；Windows：`%APPDATA%\MateClaw\logs\mateclaw.log`）。桌面端后端使用动态端口，端口冲突会在日志里明确报出。
- **模型调用报错**——API Key 填错了，或者网络不通。回设置里检查，或者换一家试试。
- **界面白屏**——Ctrl/Cmd + Shift + R 强刷。Electron 的缓存比较顽固。
- **还是不行**——去 [GitHub Issues](https://github.com/matevip/mateclaw/issues) 开一个 Issue，把 `app.log` 的尾巴贴上。我们真的会看。
- **还是不行**——去 [GitHub Issues](https://github.com/mateaix/mateclaw/issues) 开一个 Issue，把 `app.log` 的尾巴贴上。我们真的会看。
---

2
mateclaw-server/src/main/resources/docs/zh/user-guide.md
View File

@ -186,7 +186,7 @@ Wiki 不是全文搜索。它是**语义检索**——问「我们关于认证
| 模型调用报错 | API Key 错了，或者网络不通。回设置里检查 |
| 界面白屏 | Ctrl+Shift+R 强刷 |
| Ollama 报 "does not support tools" | 换一个支持 function calling 的模型（qwen3、llama3.1:8b+） |
| 还是不行 | [GitHub Issues](https://github.com/matevip/mateclaw/issues)，贴 `app.log` 尾巴 |
| 还是不行 | [GitHub Issues](https://github.com/mateaix/mateclaw/issues)，贴 `app.log` 尾巴 |
---

2
mateclaw-server/src/main/resources/docs/zh/webchat.md
View File

@ -252,4 +252,4 @@ curl -N -X POST https://mate.example.com/api/v1/channels/webchat/stream \
## 关联
- 上游 epic issue:https://github.com/matevip/mateclaw/issues/355
- 上游 epic issue:https://github.com/mateaix/mateclaw/issues/355

2
mateclaw-server/src/main/resources/docs/zh/workspaces.md
View File

@ -208,7 +208,7 @@ Wiki KB 的数据**永远不会离开它的工作空间**。工作空间 B 里
1. **导出导入**——一些资源有 JSON 导出（Agent 走 API、Wiki KB 走 API）。在目标工作空间重新创建。
2. **改所有权**——admin 或 owner 可以直接在数据库里更新简单资源的 `workspace_id` 列。这不是官方支持的；**自担风险而且一定要带备份**。
我们希望在未来版本里支持一等公民的移动。需要这个就在 [GitHub issue](https://github.com/matevip/mateclaw/issues) 上留言。
我们希望在未来版本里支持一等公民的移动。需要这个就在 [GitHub issue](https://github.com/mateaix/mateclaw/issues) 上留言。
---