Agent Harness · Spring Boot inside · One JAR to ship
-[](https://github.com/matevip/mateclaw) +[](https://github.com/mateaix/mateclaw) [](https://claw.mate.vip/docs) [](https://claw-demo.mate.vip) [](https://claw.mate.vip) [](https://adoptium.net/) [](https://spring.io/projects/spring-boot) [](https://vuejs.org/) -[](https://github.com/matevip/mateclaw) +[](https://github.com/mateaix/mateclaw) [](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 diff --git a/README_zh.md b/README_zh.md index dae024a8..171f8dcb 100644 --- a/README_zh.md +++ b/README_zh.md @@ -10,14 +10,14 @@Agent Harness · Spring Boot 内核 · 一个 JAR 交付
-[](https://github.com/matevip/mateclaw) +[](https://github.com/mateaix/mateclaw) [](https://claw.mate.vip/docs) [](https://claw-demo.mate.vip) [](https://claw.mate.vip) [](https://adoptium.net/) [](https://spring.io/projects/spring-boot) [](https://vuejs.org/) -[](https://github.com/matevip/mateclaw) +[](https://github.com/mateaix/mateclaw) [](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 diff --git a/mateclaw-server/src/main/resources/docs/en/chat.md b/mateclaw-server/src/main/resources/docs/en/chat.md index b50203a0..de586300 100644 --- a/mateclaw-server/src/main/resources/docs/en/chat.md +++ b/mateclaw-server/src/main/resources/docs/en/chat.md @@ -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. diff --git a/mateclaw-server/src/main/resources/docs/en/docker-deploy.md b/mateclaw-server/src/main/resources/docs/en/docker-deploy.md index 051ceae3..d70703a2 100644 --- a/mateclaw-server/src/main/resources/docs/en/docker-deploy.md +++ b/mateclaw-server/src/main/resources/docs/en/docker-deploy.md @@ -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 diff --git a/mateclaw-server/src/main/resources/docs/en/faq.md b/mateclaw-server/src/main/resources/docs/en/faq.md index 72e19322..929d3c0d 100644 --- a/mateclaw-server/src/main/resources/docs/en/faq.md +++ b/mateclaw-server/src/main/resources/docs/en/faq.md @@ -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 diff --git a/mateclaw-server/src/main/resources/docs/en/index.md b/mateclaw-server/src/main/resources/docs/en/index.md index cbd92c6d..37ea8581 100644 --- a/mateclaw-server/src/main/resources/docs/en/index.md +++ b/mateclaw-server/src/main/resources/docs/en/index.md @@ -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: 🧑💼 diff --git a/mateclaw-server/src/main/resources/docs/en/models.md b/mateclaw-server/src/main/resources/docs/en/models.md index 3fcab40d..6926033d 100644 --- a/mateclaw-server/src/main/resources/docs/en/models.md +++ b/mateclaw-server/src/main/resources/docs/en/models.md @@ -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 diff --git a/mateclaw-server/src/main/resources/docs/en/quickstart.md b/mateclaw-server/src/main/resources/docs/en/quickstart.md index 0807a3ad..d5924f09 100644 --- a/mateclaw-server/src/main/resources/docs/en/quickstart.md +++ b/mateclaw-server/src/main/resources/docs/en/quickstart.md @@ -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. --- diff --git a/mateclaw-server/src/main/resources/docs/en/user-guide.md b/mateclaw-server/src/main/resources/docs/en/user-guide.md index 3d38f8eb..8020f6df 100644 --- a/mateclaw-server/src/main/resources/docs/en/user-guide.md +++ b/mateclaw-server/src/main/resources/docs/en/user-guide.md @@ -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` | --- diff --git a/mateclaw-server/src/main/resources/docs/en/webchat.md b/mateclaw-server/src/main/resources/docs/en/webchat.md index 572f6fbb..c373e40a 100644 --- a/mateclaw-server/src/main/resources/docs/en/webchat.md +++ b/mateclaw-server/src/main/resources/docs/en/webchat.md @@ -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 diff --git a/mateclaw-server/src/main/resources/docs/en/workspaces.md b/mateclaw-server/src/main/resources/docs/en/workspaces.md index aafd2ee4..fce3bf69 100644 --- a/mateclaw-server/src/main/resources/docs/en/workspaces.md +++ b/mateclaw-server/src/main/resources/docs/en/workspaces.md @@ -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). --- diff --git a/mateclaw-server/src/main/resources/docs/zh/chat.md b/mateclaw-server/src/main/resources/docs/zh/chat.md index 19950b0b..2910ca2b 100644 --- a/mateclaw-server/src/main/resources/docs/zh/chat.md +++ b/mateclaw-server/src/main/resources/docs/zh/chat.md @@ -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)。 ::: - **置顶 / 取消置顶**——从每行的 `⋮` 溢出菜单操作，重要的会话固定在列表顶部的「置顶」分组里。 diff --git a/mateclaw-server/src/main/resources/docs/zh/docker-deploy.md b/mateclaw-server/src/main/resources/docs/zh/docker-deploy.md index 4bd5ae83..8ed18af9 100644 --- a/mateclaw-server/src/main/resources/docs/zh/docker-deploy.md +++ b/mateclaw-server/src/main/resources/docs/zh/docker-deploy.md @@ -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 diff --git a/mateclaw-server/src/main/resources/docs/zh/faq.md b/mateclaw-server/src/main/resources/docs/zh/faq.md index 9910bbfe..817bfbe2 100644 --- a/mateclaw-server/src/main/resources/docs/zh/faq.md +++ b/mateclaw-server/src/main/resources/docs/zh/faq.md @@ -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)——文档没答案的时候去这里 diff --git a/mateclaw-server/src/main/resources/docs/zh/index.md b/mateclaw-server/src/main/resources/docs/zh/index.md index 6e4081e5..7ec5c7ac 100644 --- a/mateclaw-server/src/main/resources/docs/zh/index.md +++ b/mateclaw-server/src/main/resources/docs/zh/index.md @@ -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: 🧑💼 diff --git a/mateclaw-server/src/main/resources/docs/zh/models.md b/mateclaw-server/src/main/resources/docs/zh/models.md index d28c68bc..4340346b 100644 --- a/mateclaw-server/src/main/resources/docs/zh/models.md +++ b/mateclaw-server/src/main/resources/docs/zh/models.md @@ -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 策略，视觉模型转描述 diff --git a/mateclaw-server/src/main/resources/docs/zh/quickstart.md b/mateclaw-server/src/main/resources/docs/zh/quickstart.md index e07619cd..b96a5920 100644 --- a/mateclaw-server/src/main/resources/docs/zh/quickstart.md +++ b/mateclaw-server/src/main/resources/docs/zh/quickstart.md @@ -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` 的尾巴贴上。我们真的会看。 --- diff --git a/mateclaw-server/src/main/resources/docs/zh/user-guide.md b/mateclaw-server/src/main/resources/docs/zh/user-guide.md index 4c7d389c..4de29321 100644 --- a/mateclaw-server/src/main/resources/docs/zh/user-guide.md +++ b/mateclaw-server/src/main/resources/docs/zh/user-guide.md @@ -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` 尾巴 | --- diff --git a/mateclaw-server/src/main/resources/docs/zh/webchat.md b/mateclaw-server/src/main/resources/docs/zh/webchat.md index 955aaff2..0e484171 100644 --- a/mateclaw-server/src/main/resources/docs/zh/webchat.md +++ b/mateclaw-server/src/main/resources/docs/zh/webchat.md @@ -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 diff --git a/mateclaw-server/src/main/resources/docs/zh/workspaces.md b/mateclaw-server/src/main/resources/docs/zh/workspaces.md index 6ec26084..1a772b85 100644 --- a/mateclaw-server/src/main/resources/docs/zh/workspaces.md +++ b/mateclaw-server/src/main/resources/docs/zh/workspaces.md @@ -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) 上留言。 ---