diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 0c7ceec9..2aeaf0ef 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -14,12 +14,9 @@ name: Release Desktop
# 3. (Publish Desktop workflow) flip D1 is_latest=1 and attach GitHub
# Release assets — makes the version live on the site.
#
-# Push a tag like `v1.2.0` (or use workflow_dispatch) to run stage 1.
+# Manual only: run stage 1 via workflow_dispatch. Tag pushes do NOT trigger a
+# build, so cutting a release tag never rebuilds installers or overwrites R2.
on:
- push:
- tags:
- - "v*"
- # Manual trigger for testing the full pipeline without cutting a real tag.
workflow_dispatch:
inputs:
version:
diff --git a/README.md b/README.md
index 55bef94a..0cb88b3c 100644
--- a/README.md
+++ b/README.md
@@ -24,6 +24,7 @@ CowAgent is lightweight, easy to deploy, and built to extend. Plug in any major
📖 Docs ·
🚀 Quick Start ·
🧩 Skill Hub ·
+ 💻 Download ·
☁️ Try Online
@@ -95,6 +96,8 @@ cow skill install # install a skill
cow install-browser # install browser automation
```
+> 💻 Desktop client: download the **[CowAgent Desktop client](https://cowagent.ai/download/)** (macOS / Windows) — the backend is bundled, ready to use out of the box.
+
## 🤖 Models
@@ -199,6 +202,8 @@ Learn more: [Skills overview](https://docs.cowagent.ai/skills/index) · [Creatin
## 🏷 Changelog
+> **2026.07.08:** [v2.1.3](https://github.com/zhayujie/CowAgent/releases/tag/2.1.3) — [Desktop client](https://cowagent.ai/download/) for macOS / Windows, knowledge base document management, on-demand MCP tool retrieval, Traditional Chinese support, new models.
+
> **2026.06.18:** [v2.1.2](https://github.com/zhayujie/CowAgent/releases/tag/2.1.2) — Web console upgrades (scheduled task management, knowledge base categories, multiple custom model providers), Self-Evolution improvements, new models (kimi-k2.7-code, glm-5.2), security hardening and refinements.
> **2026.06.09:** [v2.1.1](https://github.com/zhayujie/CowAgent/releases/tag/2.1.1) — Self-Evolution, Web console upgrades (message management, parallel sessions), cross-platform MCP enhancements with concurrent calls, new models (MiniMax-M3, qwen3.7-plus), Python 3.13 support.
diff --git a/docs/docs.json b/docs/docs.json
index cccce886..66a37696 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -22,6 +22,10 @@
"label": "官网",
"href": "https://cowagent.ai/"
},
+ {
+ "label": "下载",
+ "href": "https://cowagent.ai/download/"
+ },
{
"label": "博客",
"href": "https://cowagent.ai/zh/blog/"
@@ -55,6 +59,10 @@
"label": "Website",
"href": "https://cowagent.ai/"
},
+ {
+ "label": "Download",
+ "href": "https://cowagent.ai/download/"
+ },
{
"label": "Blog",
"href": "https://cowagent.ai/blog/"
@@ -86,6 +94,7 @@
"group": "Installation",
"pages": [
"guide/quick-start",
+ "guide/desktop",
"guide/manual-install",
"guide/upgrade"
]
@@ -249,6 +258,7 @@
"group": "Release Notes",
"pages": [
"releases/overview",
+ "releases/v2.1.3",
"releases/v2.1.2",
"releases/v2.1.1",
"releases/v2.1.0",
@@ -276,6 +286,10 @@
"label": "官网",
"href": "https://cowagent.ai/?lang=zh"
},
+ {
+ "label": "下载",
+ "href": "https://cowagent.ai/zh/download/"
+ },
{
"label": "博客",
"href": "https://cowagent.ai/zh/blog/"
@@ -307,6 +321,7 @@
"group": "安装部署",
"pages": [
"zh/guide/quick-start",
+ "zh/guide/desktop",
"zh/guide/manual-install",
"zh/guide/upgrade"
]
@@ -470,6 +485,7 @@
"group": "发布记录",
"pages": [
"zh/releases/overview",
+ "zh/releases/v2.1.3",
"zh/releases/v2.1.2",
"zh/releases/v2.1.1",
"zh/releases/v2.1.0",
@@ -497,6 +513,10 @@
"label": "ウェブサイト",
"href": "https://cowagent.ai/"
},
+ {
+ "label": "ダウンロード",
+ "href": "https://cowagent.ai/download/"
+ },
{
"label": "ブログ",
"href": "https://cowagent.ai/blog/"
@@ -528,6 +548,7 @@
"group": "インストール",
"pages": [
"ja/guide/quick-start",
+ "ja/guide/desktop",
"ja/guide/manual-install",
"ja/guide/upgrade"
]
@@ -691,6 +712,7 @@
"group": "リリースノート",
"pages": [
"ja/releases/overview",
+ "ja/releases/v2.1.3",
"ja/releases/v2.1.2",
"ja/releases/v2.1.1",
"ja/releases/v2.1.0",
diff --git a/docs/guide/desktop.mdx b/docs/guide/desktop.mdx
new file mode 100644
index 00000000..71feb408
--- /dev/null
+++ b/docs/guide/desktop.mdx
@@ -0,0 +1,36 @@
+---
+title: Desktop Client
+description: Download and use the CowAgent desktop client (macOS / Windows)
+---
+
+CowAgent ships a ready-to-use desktop client with the Agent runtime bundled in — **no need to install Python or dependencies manually**. Just download, install, and run your local super AI assistant.
+
+## Download & Install
+
+
+ Download the macOS / Windows installer
+
+
+
+
+ 1. Open the [download page](https://cowagent.ai/download/) and pick the build for your chip:
+ - Apple Silicon (M1/M2/M3/M4): download the `arm64` build
+ - Intel: download the `x64` build
+ 2. Open the downloaded `.dmg` and drag CowAgent into your Applications folder.
+ 3. Launch CowAgent from Launchpad or Applications.
+
+
+ 1. Open the [download page](https://cowagent.ai/download/) and download the Windows installer (`.exe`).
+ 2. Run the installer and follow the prompts (you can choose the install directory).
+ 3. Launch CowAgent from the desktop or Start menu.
+
+
+
+## Auto Update
+
+The desktop client has built-in auto-update. When a new version is available it is detected automatically; you can also manually "Check for updates" from the menu in the bottom-left corner and upgrade with one click.
+
+## Desktop vs. Command-line Deployment
+
+- **Desktop client**: best for personal use on your own computer — works out of the box, GUI-based, auto-updating.
+- **Command-line deployment**: best for developers or long-running servers with more customization. See [Quick Start](/guide/quick-start).
diff --git a/docs/ja/README.md b/docs/ja/README.md
index 5ebf7685..32b91b87 100644
--- a/docs/ja/README.md
+++ b/docs/ja/README.md
@@ -24,6 +24,7 @@ CowAgent は軽量でデプロイしやすく、拡張性に優れています
📖 ドキュメント ·
🚀 クイックスタート ·
🧩 Skill Hub ·
+ 💻 ダウンロード ·
☁️ オンラインで試す
@@ -95,6 +96,8 @@ cow skill install <名前> # Skill のインストール
cow install-browser # ブラウザツールのインストール
```
+> 💻 デスクトップクライアント:**[CowAgent デスクトップクライアント](https://cowagent.ai/download/)**(macOS / Windows)はバックエンドを内蔵し、ダウンロードしてすぐに使えます。
+
## 🤖 モデル
@@ -199,6 +202,8 @@ CowAgent は主要な LLM プロバイダーすべてに対応しています。
## 🏷 更新履歴
+> **2026.07.08:** [v2.1.3](https://github.com/zhayujie/CowAgent/releases/tag/2.1.3) — [デスクトップクライアント](https://cowagent.ai/download/)(macOS / Windows)、ナレッジベースのドキュメント管理、MCP ツールのオンデマンド検索、繁体字中国語対応、新モデル追加。
+
> **2026.06.18:** [v2.1.2](https://github.com/zhayujie/CowAgent/releases/tag/2.1.2) — Web コンソールの強化(定期タスク管理、ナレッジベースのカテゴリ、複数のカスタムモデルプロバイダー)、自己進化の改善、新モデル(kimi-k2.7-code、glm-5.2)、セキュリティ強化と改善。
> **2026.06.09:** [v2.1.1](https://github.com/zhayujie/CowAgent/releases/tag/2.1.1) — 自己進化、Web コンソールの強化(メッセージ管理、マルチセッション並行)、クロスプラットフォーム対応の MCP 強化と並行呼び出し、新モデル(MiniMax-M3、qwen3.7-plus)、Python 3.13 対応。
diff --git a/docs/ja/guide/desktop.mdx b/docs/ja/guide/desktop.mdx
new file mode 100644
index 00000000..28312007
--- /dev/null
+++ b/docs/ja/guide/desktop.mdx
@@ -0,0 +1,36 @@
+---
+title: デスクトップクライアント
+description: CowAgent デスクトップクライアント(macOS / Windows)のダウンロードと使い方
+---
+
+CowAgent は、Agent の実行環境を内蔵したすぐに使えるデスクトップクライアントを提供しています。**Python や依存関係を手動でインストールする必要はありません**。ダウンロードしてインストールするだけで、ローカルでスーパー AI アシスタントを実行できます。
+
+## ダウンロードとインストール
+
+
+ macOS / Windows 用インストーラーをダウンロード
+
+
+
+
+ 1. [ダウンロードページ](https://cowagent.ai/download/) を開き、チップに合わせて選択します:
+ - Apple Silicon(M1/M2/M3/M4):`arm64` 版をダウンロード
+ - Intel:`x64` 版をダウンロード
+ 2. ダウンロードした `.dmg` を開き、CowAgent を「アプリケーション」フォルダにドラッグします。
+ 3. Launchpad またはアプリケーションから CowAgent を起動します。
+
+
+ 1. [ダウンロードページ](https://cowagent.ai/download/) を開き、Windows インストーラー(`.exe`)をダウンロードします。
+ 2. インストーラーを実行し、画面の指示に従います(インストール先を選択できます)。
+ 3. デスクトップまたはスタートメニューから CowAgent を起動します。
+
+
+
+## 自動アップデート
+
+デスクトップクライアントには自動アップデート機能が組み込まれています。新しいバージョンがあると自動的に検出・通知され、左下のメニューから手動で「アップデートを確認」してワンクリックでアップグレードすることもできます。
+
+## デスクトップとコマンドラインの違い
+
+- **デスクトップクライアント**:自分の PC での個人利用に最適。すぐに使え、GUI 操作で自動アップデート対応。
+- **コマンドラインデプロイ**:開発者やサーバーでの長期運用に最適で、カスタマイズ性が高い。詳しくは [クイックスタート](/ja/guide/quick-start) を参照。
diff --git a/docs/ja/releases/overview.mdx b/docs/ja/releases/overview.mdx
index c9cada76..5bb5391e 100644
--- a/docs/ja/releases/overview.mdx
+++ b/docs/ja/releases/overview.mdx
@@ -5,6 +5,7 @@ description: CowAgent バージョン更新履歴
| バージョン | 日付 | 説明 |
| --- | --- | --- |
+| [2.1.3](/ja/releases/v2.1.3) | 2026.07.08 | デスクトップクライアント正式リリース(macOS / Windows)、ナレッジベースのドキュメント管理強化、MCP ツールのオンデマンド検索、繁体字中国語対応、新モデル追加(claude-sonnet-5、doubao-seed-2.1 など)、セキュリティ強化と改善 |
| [2.1.2](/ja/releases/v2.1.2) | 2026.06.18 | Web コンソールの強化(定期タスク管理、ナレッジベースのカテゴリ、複数のカスタムモデルプロバイダー)、自己進化の改善、新モデル追加(kimi-k2.7-code、glm-5.2)、セキュリティ強化と改善 |
| [2.1.1](/ja/releases/v2.1.1) | 2026.06.09 | 自己進化、Web コンソールの強化(メッセージ管理、マルチセッション並行)、クロスプラットフォーム対応の MCP 強化と並行呼び出し、新モデル追加(MiniMax-M3、qwen3.7-plus など)、各種改善 |
| [2.1.0](/ja/releases/v2.1.0) | 2026.06.01 | 国際化対応、Telegram / Discord / Slack / WeChat カスタマーサービスチャネルの追加、CLI インタラクション強化(ストリーミング出力、コマンドあいまいマッチング、タスクキャンセル)、MCP Streamable HTTP、新モデル追加 |
diff --git a/docs/ja/releases/v2.1.3.mdx b/docs/ja/releases/v2.1.3.mdx
new file mode 100644
index 00000000..248a2504
--- /dev/null
+++ b/docs/ja/releases/v2.1.3.mdx
@@ -0,0 +1,73 @@
+---
+title: v2.1.3
+description: "CowAgent 2.1.3:デスクトップクライアント(macOS / Windows)を正式リリース。ナレッジベースのドキュメント管理を強化し、MCP ツールのオンデマンド検索、繁体字中国語対応、新モデルに加え、セキュリティと使い勝手の各種改善"
+---
+
+🌐 [English](https://docs.cowagent.ai/releases/v2.1.3) | [中文](https://docs.cowagent.ai/zh/releases/v2.1.3)
+
+## 🖥 デスクトップクライアント
+
+**CowAgent デスクトップクライアント**を正式にリリースしました。**macOS と Windows** に対応し、ローカルのスーパー AI アシスタントをそのまますぐに使えます。
+
+
+
+主な特長:
+
+- **すぐに使える**:Agent の実行環境を内蔵しており、インストール後すぐに起動できます。Python などの依存関係を用意する必要はありません
+- **充実したチャット体験**:ストリーミング応答、セッション管理、ツール呼び出しのステップ表示、Markdown レンダリングに加え、画像 / 動画 / ファイルの送信とプレビューに対応
+- **ビジュアル管理**:設定、モデル、ナレッジベース、定期タスク、スキル、メモリなどの画面が Web コンソールと同等で、ネイティブ UI 上で管理できます
+- **チャネル接続**:アプリ内で QR コードをスキャンして各種メッセージチャネルに接続
+- **自動アップデート**:バージョンの自動チェックとワンクリック更新に対応し、地域ごとにダウンロード速度を最適化
+- **ネイティブ体験**:初回起動ガイド、システム言語への追従、プラットフォームに適応したウィンドウ操作
+
+ダウンロード:[CowAgent デスクトップ](https://cowagent.ai/download/)
+
+## 📚 ナレッジベース
+
+- **ドキュメントの作成とインポート**:UI から直接ドキュメントを新規作成したり、外部ドキュメントをインポートできます
+- **インデックスの自動メンテナンス**:実際のディレクトリ構成からインデックスを自動的に再構築し、インデックスのずれやドキュメントの欠落を防ぎます
+- **ベクトル化の修正**:インデックスが統一された埋め込みプロバイダーを再利用するようになり、キーワード検索へのフォールバックではなく本来のセマンティックベクトルを生成します
+
+Thanks @yangziyu-hhh
+
+ドキュメント:[ナレッジベース](https://docs.cowagent.ai/ja/memory/knowledge)
+
+## 🔌 MCP ツールのオンデマンド検索
+
+多数の MCP ツールを接続した際のコンテキスト肥大化に対応するため、**オンデマンドのツール検索**を追加しました。現在のタスクに関連する MCP ツールを RAG ベクトル検索で必要に応じて読み込み、無関係なツールがコンテキストを占有するのを抑えます。Thanks @fengyl07
+
+ドキュメント:[MCP ツール](https://docs.cowagent.ai/ja/tools/mcp)
+
+## 🌏 繁体字中国語対応
+
+Web コンソール、ログ、ドキュメントが **繁体字中国語(zh-Hant)** に対応しました。インターフェース言語はシステムに追従するか、手動で切り替えられます。Thanks @anomixer (#2935)
+
+## 🤖 新モデル追加
+
+- **claude-sonnet-5**、**claude-fable-5** に対応
+- **doubao-seed-2-1-pro**、**doubao-seed-2-1-turbo** に対応
+
+ドキュメント:[モデル](https://docs.cowagent.ai/ja/models)
+
+## 🔒 セキュリティ強化
+
+- **機密ファイル読み取り防護**:認証情報などの機密ファイルへのアクセスを強化し、迂回による読み取りを防止します。Thanks @fengyl07 (#2913)
+- **ブラウザアクセス防護**:ブラウザによる内部ネットワークやクラウドサーバーの内部エンドポイントへのリクエストをブロックし、内部サービスへ誘導されるリスクを低減します。Thanks @christop
+- **設定解析の安全化**:設定内容をより安全な方法で解析し、潜在的なコード実行リスクを回避します。Thanks @shunfeng8421
+
+## 🛠 改善と修正
+
+- **カスタムプロバイダー対応**:埋め込みモデルとビジョンモデルでカスタムプロバイダーを利用可能に。あわせて Windows でのメモリ取得の問題を修正しました。Thanks @HnBigVolibear
+- **ファイル編集の安定性向上**:元のインデントをより適切に保持し、あいまい一致の際に無関係な内容を変更しないようにしました。Thanks @xiaweiwei67-stack (#2942)
+- **コマンド出力の文字化け修正**:コマンドが大量の出力を生成した際に発生し得る中国語の文字化けを修正しました。Thanks @xiaweiwei67-stack (#2941)
+- **Azure OpenAI の修正**:Azure OpenAI のストリーミング出力および関連する設定の問題を修正しました。Thanks @Eric L
+- **企業向け WeChat スマートボット**:webhook(コールバック)モードの接続ドキュメントを追加しました。Thanks @6vision
+- **ディープドリームの切り替え**:`deep_dream_enabled` の専用スイッチを追加し、ディープドリームの蒸留を個別に有効・無効化できます。
+- **安定性**:Web サービスの接続回収を改善し、自己進化に関するいくつかの問題を修正しました (#2924, #2904)
+
+## 📦 アップグレード方法
+
+- **デスクトップクライアント**:[ダウンロードページ](https://cowagent.ai/download/) から最新バージョンを入手してください。
+- **ソースデプロイ**:`cow update` でワンクリックアップグレード、または最新コードを取得して再起動します。詳しくは [アップグレードガイド](https://docs.cowagent.ai/ja/guide/upgrade) を参照してください。
+
+**リリース日**:2026.07.08 | [Full Changelog](https://github.com/zhayujie/CowAgent/compare/2.1.2...2.1.3)
diff --git a/docs/releases/overview.mdx b/docs/releases/overview.mdx
index 2b14e930..8aaaf5da 100644
--- a/docs/releases/overview.mdx
+++ b/docs/releases/overview.mdx
@@ -5,6 +5,7 @@ description: CowAgent version history
| Version | Date | Description |
| --- | --- | --- |
+| [2.1.3](/releases/v2.1.3) | 2026.07.08 | Desktop client released (macOS / Windows), knowledge base document management, on-demand MCP tool retrieval, Traditional Chinese support, new models (claude-sonnet-5, doubao-seed-2.1, etc.), security hardening and refinements |
| [2.1.2](/releases/v2.1.2) | 2026.06.18 | Web Console upgrades (scheduled task management, knowledge base categories, multiple custom model providers), Self-Evolution improvements, new models (kimi-k2.7-code, glm-5.2), security hardening and refinements |
| [2.1.1](/releases/v2.1.1) | 2026.06.09 | Self-Evolution, Web Console message management and parallel sessions, cross-platform MCP enhancements with concurrent calls, new models (MiniMax-M3, qwen3.7-plus, etc.), various improvements |
| [2.1.0](/releases/v2.1.0) | 2026.06.01 | Internationalization, new Telegram / Discord / Slack / WeChat Customer Service channels, CLI interaction upgrades (streaming output, fuzzy command matching, task cancellation), MCP Streamable HTTP, new models |
diff --git a/docs/releases/v2.1.3.mdx b/docs/releases/v2.1.3.mdx
new file mode 100644
index 00000000..a703b7cb
--- /dev/null
+++ b/docs/releases/v2.1.3.mdx
@@ -0,0 +1,74 @@
+---
+title: v2.1.3
+description: "CowAgent 2.1.3: Desktop client for macOS / Windows, enhanced knowledge base document management, on-demand MCP tool retrieval, Traditional Chinese support, new models, plus security and experience improvements"
+---
+
+🌐 [English](https://docs.cowagent.ai/releases/v2.1.3) | [中文](https://docs.cowagent.ai/zh/releases/v2.1.3)
+
+## 🖥 Desktop Client
+
+Introducing the **CowAgent Desktop client** for **macOS and Windows** — your local super AI assistant, truly ready to use out of the box.
+
+Download: [CowAgent Desktop](https://cowagent.ai/download/)
+
+
+
+Highlights:
+
+- **Out of the box**: the full Agent runtime is bundled — launch right after install, no need to set up Python or other dependencies
+- **Full chat experience**: streaming replies, session management, tool-call step display, Markdown rendering, plus sending and previewing images / videos / files
+- **Visual management**: configuration, models, knowledge base, scheduled tasks, skills, and memory pages mirror the Web console, all manageable in the native UI
+- **Channel onboarding**: connect messaging channels by scanning a QR code right inside the app
+- **Auto update**: automatic version checks and one-click updates, with download speed optimized across regions
+- **Native experience**: first-run onboarding, follows the system language, and platform-adaptive window interactions
+
+
+## 📚 Knowledge Base
+
+- **Create & import documents**: create new documents or import external ones directly from the UI
+- **Automatic index maintenance**: the knowledge base index is rebuilt automatically from the actual directory tree, preventing index drift or lost documents
+- **Vectorization fix**: the index now reuses the unified embedding provider, ensuring real semantic vectors instead of falling back to keyword search
+
+Thanks @yangziyu-hhh
+
+Docs: [Knowledge Base](https://docs.cowagent.ai/memory/knowledge)
+
+## 🔌 On-demand MCP Tool Retrieval
+
+To address context bloat when many MCP tools are connected, we added **on-demand tool retrieval**: relevant MCP tools are loaded on demand via RAG vector search based on the current task, reducing the context taken up by irrelevant tools. Thanks @fengyl07
+
+Docs: [MCP Tools](https://docs.cowagent.ai/tools/mcp)
+
+## 🌏 Traditional Chinese Support
+
+The Web console, logs, and documentation now support **Traditional Chinese (zh-Hant)**; the interface language can follow the system or be switched manually. Thanks @anomixer (#2935)
+
+## 🤖 New Models
+
+- Added support for **claude-sonnet-5** and **claude-fable-5**
+- Added support for **doubao-seed-2-1-pro** and **doubao-seed-2-1-turbo**
+
+Docs: [Models](https://docs.cowagent.ai/models)
+
+## 🔒 Security Hardening
+
+- **Sensitive file read protection**: hardened access to credential and other sensitive files to prevent bypass reads. Thanks @fengyl07 (#2913)
+- **Browser access protection**: blocks browser requests targeting internal network and cloud server internal endpoints, reducing the risk of being tricked into reaching internal services. Thanks @christop
+- **Safer config parsing**: config content is parsed in a safer way to avoid potential code execution risks. Thanks @shunfeng8421
+
+## 🛠 Improvements & Fixes
+
+- **Custom provider support**: embedding and vision models can now use custom providers; also fixed a memory query issue on Windows. Thanks @HnBigVolibear
+- **More reliable file editing**: better preserves original indentation, and fuzzy matching no longer touches unrelated content. Thanks @xiaweiwei67-stack (#2942)
+- **Command output encoding fix**: fixed garbled Chinese characters when a command produces large output. Thanks @xiaweiwei67-stack (#2941)
+- **Azure OpenAI fixes**: fixed streaming output and related configuration issues for Azure OpenAI. Thanks @Eric L
+- **WeCom Smart Bot**: added channel docs for the webhook (callback) mode. Thanks @6vision
+- **Deep Dream toggle**: added a dedicated `deep_dream_enabled` switch to enable or disable Deep Dream distillation independently.
+- **Stability**: improved connection recycling in the Web service and fixed several Self-Evolution issues (#2924, #2904)
+
+## 📦 How to Upgrade
+
+- **Desktop client**: get the latest version from the [download page](https://cowagent.ai/download/).
+- **Source deployment**: run `cow update` for a one-click upgrade, or pull the latest code and restart. See the [upgrade guide](https://docs.cowagent.ai/guide/upgrade).
+
+**Release date**: 2026.07.08 | [Full Changelog](https://github.com/zhayujie/CowAgent/compare/2.1.2...2.1.3)
diff --git a/docs/zh/README-Hant.md b/docs/zh/README-Hant.md
index 73ea73e5..7fe85539 100644
--- a/docs/zh/README-Hant.md
+++ b/docs/zh/README-Hant.md
@@ -24,6 +24,7 @@ CowAgent 輕量、易部署、可擴充,自由接入主流大模型,覆蓋
📖 文件中心 ·
🚀 快速開始 ·
🧩 技能廣場 ·
+ 💻 下載客戶端 ·
☁️ 線上體驗
@@ -95,6 +96,8 @@ cow skill install <名稱> # 安裝技能
cow install-browser # 安裝瀏覽器工具
```
+> 💻 桌面客戶端:前往 **[下載 CowAgent 桌面客戶端](https://cowagent.ai/zh/download/)**(macOS / Windows),內建 Agent 執行環境,開箱即用。
+
## 🤖 模型支援
@@ -200,6 +203,8 @@ CowAgent 支援國內外主流廠商的大語言模型。**文字對話、影像
## 🏷 更新日誌
+> **2026.07.08:** [v2.1.3](https://github.com/zhayujie/CowAgent/releases/tag/2.1.3) — [桌面客戶端](https://cowagent.ai/zh/download/)正式發布(macOS / Windows)、知識庫文件管理增強、MCP 工具智能檢索、繁體中文支援、新模型接入
+
> **2026.06.18:** [v2.1.2](https://github.com/zhayujie/CowAgent/releases/tag/2.1.2) — Web 控制台升級(定時任務管理、知識庫分類、多模型自定義廠商)、自主進化最佳化、新模型接入(kimi-k2.7-code、glm-5.2)、安全加固和體驗最佳化
> **2026.06.09:** [v2.1.1](https://github.com/zhayujie/CowAgent/releases/tag/2.1.1) — 自進化能力、Web 控制台升級(訊息管理、多會話並行)、新模型接入(MiniMax-M3、qwen3.7-plus)、Python 3.13 支援
diff --git a/docs/zh/README.md b/docs/zh/README.md
index 1a28aa28..7f3be54f 100644
--- a/docs/zh/README.md
+++ b/docs/zh/README.md
@@ -24,6 +24,7 @@ CowAgent 轻量、易部署、可扩展,自由接入主流大模型,覆盖
📖 文档中心 ·
🚀 快速开始 ·
🧩 技能广场 ·
+ 💻 下载客户端 ·
☁️ 在线体验
@@ -95,6 +96,8 @@ cow skill install <名称> # 安装技能
cow install-browser # 安装浏览器工具
```
+> 💻 桌面客户端:前往 **[下载 CowAgent 桌面客户端](https://cowagent.ai/zh/download/)**(macOS / Windows),内置 Agent 运行环境,开箱即用。
+
## 🤖 模型支持
@@ -200,6 +203,8 @@ CowAgent 支持国内外主流厂商的大语言模型。**文本对话、图像
## 🏷 更新日志
+> **2026.07.08:** [v2.1.3](https://github.com/zhayujie/CowAgent/releases/tag/2.1.3) — [桌面客户端](https://cowagent.ai/zh/download/)正式发布(macOS / Windows)、知识库文档管理增强、MCP 工具智能检索、繁体中文支持、新模型接入
+
> **2026.06.18:** [v2.1.2](https://github.com/zhayujie/CowAgent/releases/tag/2.1.2) — Web 控制台升级(定时任务管理、知识库分类、多模型自定义厂商)、自主进化优化、新模型接入(kimi-k2.7-code、glm-5.2)、安全加固和体验优化
> **2026.06.09:** [v2.1.1](https://github.com/zhayujie/CowAgent/releases/tag/2.1.1) — 自进化能力、Web 控制台升级(消息管理、多会话并行)、新模型接入(MiniMax-M3、qwen3.7-plus)、Python 3.13 支持
diff --git a/docs/zh/guide/desktop.mdx b/docs/zh/guide/desktop.mdx
new file mode 100644
index 00000000..de32e94f
--- /dev/null
+++ b/docs/zh/guide/desktop.mdx
@@ -0,0 +1,35 @@
+---
+title: 桌面客户端
+description: 下载并使用 CowAgent 桌面客户端(macOS / Windows)
+---
+
+CowAgent 提供开箱即用的桌面客户端,内置 Agent 运行环境,**无需手动安装 Python 或依赖**,下载安装后即可在本地运行你的超级 AI 助理。
+
+## 下载安装
+
+
+ 下载 macOS / Windows 客户端安装包
+
+
+
+
+ 1. 打开 [下载页](https://cowagent.ai/zh/download/),根据芯片选择安装包:
+ - Apple Silicon(M1/M2/M3/M4):下载 `arm64` 版本
+ - Intel 芯片:下载 `x64` 版本
+ 2. 打开下载的 `.dmg`,将 CowAgent 拖入「应用程序」文件夹。
+ 3. 从启动台或应用程序中打开 CowAgent 即可。
+
+
+ 1. 打开 [下载页](https://cowagent.ai/zh/download/),下载 Windows 安装包(`.exe`)。
+ 2. 双击运行安装程序,按提示完成安装(可自定义安装目录)。
+ 3. 从桌面或开始菜单打开 CowAgent 即可。
+
+
+## 自动更新
+
+桌面客户端内置自动更新能力。有新版本时会自动检测并提示,你也可以在应用左下角菜单中手动「检查更新」,一键下载并重启完成升级。
+
+## 与命令行部署的区别
+
+- **桌面客户端**:适合个人在本地电脑使用,开箱即用,图形界面操作,自动更新。
+- **命令行部署**:适合开发者或服务器长期运行,可定制性更强,详见 [一键安装](/zh/guide/quick-start)。
diff --git a/docs/zh/intro/index.mdx b/docs/zh/intro/index.mdx
index db4a4613..dca75bba 100644
--- a/docs/zh/intro/index.mdx
+++ b/docs/zh/intro/index.mdx
@@ -71,6 +71,8 @@ CowAgent 支持灵活切换多种模型,能处理文本、语音、图片、
运行后默认会启动 Web 控制台,通过访问 `http://localhost:9899` 可以在网页端进行对话、配置、应用通道接入等操作。
+也可以使用桌面客户端(macOS / Windows),内置 Agent 运行环境,[下载安装](https://cowagent.ai/zh/download/)后开箱即用。
+
查看完整的安装和运行指南
diff --git a/docs/zh/releases/overview.mdx b/docs/zh/releases/overview.mdx
index b3eeb3c4..1d99b81a 100644
--- a/docs/zh/releases/overview.mdx
+++ b/docs/zh/releases/overview.mdx
@@ -5,6 +5,7 @@ description: CowAgent 版本更新历史
| 版本 | 日期 | 说明 |
| --- | --- | --- |
+| [2.1.3](/zh/releases/v2.1.3) | 2026.07.08 | 桌面客户端正式发布(macOS / Windows)、知识库文档管理增强、MCP 工具智能检索、繁体中文支持、新模型接入(claude-sonnet-5、doubao-seed-2.1 等)、安全加固与体验优化 |
| [2.1.2](/zh/releases/v2.1.2) | 2026.06.18 | Web 控制台升级(定时任务管理、知识库分类、多模型自定义厂商)、自主进化优化、新模型接入(kimi-k2.7-code、glm-5.2)、安全加固和体验优化 |
| [2.1.1](/zh/releases/v2.1.1) | 2026.06.09 | 自主进化能力、Web 控制台消息管理升级、新模型接入(MiniMax-M3、qwen3.7-plus 等)、其他多项优化和修复 |
| [2.1.0](/zh/releases/v2.1.0) | 2026.06.01 | 国际化支持、新增 Telegram / Discord / Slack / 微信客服通道、命令行交互升级(流式输出、命令模糊匹配、任务取消)、MCP Streamable HTTP、新模型接入 |
diff --git a/docs/zh/releases/v2.1.3.mdx b/docs/zh/releases/v2.1.3.mdx
new file mode 100644
index 00000000..bf6524a9
--- /dev/null
+++ b/docs/zh/releases/v2.1.3.mdx
@@ -0,0 +1,75 @@
+---
+title: v2.1.3
+description: CowAgent 2.1.3:正式推出桌面客户端(macOS / Windows),知识库文档管理增强,新增 MCP 工具按需检索,繁体中文支持,模型支持,并带来安全与体验的多项改进
+---
+
+🌐 [English](https://docs.cowagent.ai/releases/v2.1.3) | [中文](https://docs.cowagent.ai/zh/releases/v2.1.3)
+
+## 🖥 桌面客户端
+
+正式推出 **CowAgent 桌面客户端**,支持 **macOS 与 Windows**,让本地超级 AI 助理真正做到开箱即用。
+
+下载地址:[CowAgent客户端](https://cowagent.ai/zh/download/)
+
+
+
+核心特性:
+
+- **开箱即用**:内置完整的 Agent 运行环境,安装后直接启动,无需安装 Python 等依赖
+- **完整对话体验**:流式对话、会话管理、工具调用步骤展示、Markdown 渲染,并支持发送与展示图片 / 视频 / 文件
+- **可视化管理**:配置管理、模型配置、知识库、定时任务、技能系统、记忆等页面与 Web 控制台对齐,在原生界面即可管理
+- **通道接入**:支持在客户端内扫码接入各类消息通道
+- **自动更新**:支持版本自动检查与一键更新,优化不同地区的下载速度
+- **原生体验**:首次启动引导、跟随系统语言、平台自适应的窗口交互
+
+
+## 📚 知识库
+
+- **文档创建与导入**:知识库支持在界面直接新建文档、导入外部文档。
+- **索引自动维护**:根据真实目录树自动重建 `knowledge/index.md` 索引文件,避免索引漂移或丢失文档
+- **向量模型修复**:知识库索引同步复用统一的嵌入厂商,确保生成向量而非退化为关键词检索
+
+Thanks @yangziyu-hhh
+
+相关文档:[知识库](https://docs.cowagent.ai/zh/memory/knowledge)
+
+## 🔌 MCP 工具智能检索
+
+针对接入大量 MCP 工具时上下文膨胀的问题,新增 **按需工具检索** 能力,通过 RAG 向量检索按需加载与当前任务相关的 MCP 工具,减少无关工具对上下文的占用。Thanks @fengyl07
+
+相关文档:[MCP 工具](https://docs.cowagent.ai/zh/tools/mcp)
+
+## 🌏 繁体中文支持
+
+Web 控制台、日志与文档新增 **繁体中文(zh-Hant)** 支持,界面语言可跟随系统或手动切换。Thanks @anomixer (#2935)
+
+## 🤖 模型新增
+
+- 新增支持 **claude-sonnet-5**、**claude-fable-5**
+- 新增支持 **doubao-seed-2-1-pro**、**doubao-seed-2-1-turbo**
+
+相关文档:[模型概览](https://docs.cowagent.ai/zh/models)
+
+
+## 🔒 安全加固
+
+- **敏感文件读取防护**:加固对凭证等敏感文件的访问,防止绕过读取。Thanks @fengyl07 (#2913)
+- **浏览器访问防护**:浏览器访问网页时拦截指向内网及云服务器内部地址的请求,降低被诱导访问内部服务的风险。Thanks @christop
+- **配置解析加固**:使用更安全的方式解析配置内容,避免潜在的代码执行风险。Thanks @shunfeng8421
+
+## 🛠 体验优化与修复
+
+- **自定义供应商扩展**:嵌入与视觉模型支持配置自定义供应商;同时修复记忆查询在 Windows 下的问题。Thanks @HnBigVolibear
+- **文件编辑更稳**:编辑文件时更好地保留原有缩进,且模糊匹配时不改动未涉及的内容。Thanks @xiaweiwei67-stack (#2942)
+- **命令输出乱码修复**:修复执行命令产生大量输出时可能出现的中文乱码。Thanks @xiaweiwei67-stack (#2941)
+- **Azure OpenAI 修复**:修复 Azure OpenAI 的流式输出与相关配置问题。Thanks @Eric L
+- **企业微信智能机器人**:补充 webhook(回调)模式的接入文档。Thanks @6vision
+- **深度梦境开关**:新增 `deep_dream_enabled` 配置开关,可按需开启或关闭深度梦境。
+- **稳定性提升**:优化 Web 服务的连接回收,并修复自主进化过程中的若干问题 (#2924, #2904)
+
+## 📦 升级方式
+
+- **桌面客户端**:前往 [下载页](https://cowagent.ai/zh/download/) 获取最新版本。
+- **源码部署**:执行 `cow update` 一键升级,或手动拉取代码后重启。详见 [更新升级文档](https://docs.cowagent.ai/zh/guide/upgrade)。
+
+**发布日期**:2026.07.08 | [Full Changelog](https://github.com/zhayujie/CowAgent/compare/2.1.2...2.1.3)