docs: add 2.1.4 release notes

2026-07-22 06:37:11 +08:00 · 2026-07-20 15:39:29 +08:00
parent b755d18e63
commit a78fb711ad
10 changed files with 210 additions and 3 deletions
--- a/README.md
+++ b/README.md
@@ -202,6 +202,8 @@ Learn more: [Skills overview](https://docs.cowagent.ai/skills/index) · [Creatin

 ## 🏷 Changelog

+> **2026.07.20:** [v2.1.4](https://github.com/zhayujie/CowAgent/releases/tag/2.1.4) — Desktop experience improvements, MCP OAuth authorization, Lark channel enhancements, scheduler improvements and data backup, new models.
+
 > **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.
--- a/agent/tools/browser/browser_service.py
+++ b/agent/tools/browser/browser_service.py
@@ -9,6 +9,7 @@ period of inactivity to free resources.

 import os
 import sys
+import json
 import uuid
 import queue
 import threading
@@ -215,6 +216,14 @@ _SNAPSHOT_JS = """
    str(list(_INTERACTIVE_TAGS)),
 )

+# Returning the snapshot as ONE JSON string instead of a nested object is a big
+# win in the frozen desktop build: Playwright serializes a nested return value
+# node-by-node over many driver<->python protocol round trips, and each round
+# trip carries fixed overhead that is dramatically amplified in the frozen
+# bundle (a ~300-node tree can take 20s+). JSON.stringify in-page collapses it
+# to a single string transfer; Python then json.loads it. Behaviour identical.
+_SNAPSHOT_JS_STR = "() => JSON.stringify((%s)())" % _SNAPSHOT_JS.strip()
+

 _BROWSER_DEAD_HINTS = (
    "has been closed",
@@ -846,7 +855,11 @@ class BrowserService:
    def _do_snapshot(self, selector: Optional[str] = None) -> str:
        page = self._page
        try:
-            result = page.evaluate(_SNAPSHOT_JS)
+            # Return a single JSON string (not a nested object) to avoid
+            # Playwright's per-node serialization round trips, which are slow
+            # in the frozen build. See _SNAPSHOT_JS_STR.
+            raw = page.evaluate(_SNAPSHOT_JS_STR)
+            result = json.loads(raw) if isinstance(raw, str) else raw
        except Exception as e:
            return f"[Snapshot error: {e}]"

--- a/agent/tools/browser/chrome_launcher.py
+++ b/agent/tools/browser/chrome_launcher.py
@@ -51,6 +51,28 @@ class ChromeLauncher:
        finally:
            s.close()

+    def _clear_stale_singleton_locks(self):
+        """Remove leftover Chrome Singleton* locks from a crashed/killed run.
+
+        Chrome allows only one instance per user_data_dir and enforces it with
+        SingletonLock / SingletonSocket / SingletonCookie. On a clean exit these
+        are removed, but a crash or force-quit leaves them behind — the next
+        spawn then hands off to the (dead) "existing" instance and exits without
+        opening the debug port, so CDP never comes up (a permanent, non
+        self-healing failure). This profile is private to us, so clearing stale
+        locks before launch is safe: if our own browser were truly alive, the
+        service would still be connected and we wouldn't be re-launching.
+        """
+        for name in ("SingletonLock", "SingletonSocket", "SingletonCookie"):
+            p = os.path.join(self._user_data_dir, name)
+            try:
+                # These are symlinks; use lexists so a dangling link is caught.
+                if os.path.lexists(p):
+                    os.remove(p)
+                    logger.info(f"[Browser] cleared stale Chrome lock: {name}")
+            except OSError as e:
+                logger.debug(f"[Browser] could not remove {name}: {e}")
+
    def launch(self, ready_timeout: float = 25.0) -> str:
        """Spawn Chrome and block until its CDP endpoint answers.

@@ -58,6 +80,7 @@ class ChromeLauncher:
        comes up (the child process is killed in that case).
        """
        os.makedirs(self._user_data_dir, exist_ok=True)
+        self._clear_stale_singleton_locks()
        self._port = self._free_port()

        args = [
@@ -99,9 +122,11 @@ class ChromeLauncher:
        )

        if not self._wait_ready(ready_timeout):
+            # Capture the port before close() clears it, so the error is useful.
+            port = self._port
            self.close()
            raise RuntimeError(
-                f"Chrome did not expose a CDP endpoint on port {self._port} "
+                f"Chrome did not expose a CDP endpoint on port {port} "
                f"within {ready_timeout:.0f}s"
            )
        return self.endpoint
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -259,6 +259,7 @@
                "group": "Release Notes",
                "pages": [
                  "releases/overview",
+                  "releases/v2.1.4",
                  "releases/v2.1.3",
                  "releases/v2.1.2",
                  "releases/v2.1.1",
@@ -487,6 +488,7 @@
                "group": "发布记录",
                "pages": [
                  "zh/releases/overview",
+                  "zh/releases/v2.1.4",
                  "zh/releases/v2.1.3",
                  "zh/releases/v2.1.2",
                  "zh/releases/v2.1.1",
@@ -714,6 +716,7 @@
                "group": "リリースノート",
                "pages": [
                  "ja/releases/overview",
+                  "ja/releases/v2.1.4",
                  "ja/releases/v2.1.3",
                  "ja/releases/v2.1.2",
                  "ja/releases/v2.1.1",
--- a/docs/ja/README.md
+++ b/docs/ja/README.md
@@ -202,6 +202,8 @@ CowAgent は主要な LLM プロバイダーすべてに対応しています。

 ## 🏷 更新履歴

+> **2026.07.20:** [v2.1.4](https://github.com/zhayujie/CowAgent/releases/tag/2.1.4) — デスクトップの体験改善、MCP の OAuth 認可対応、Feishu チャネルの機能向上、定期タスクとデータバックアップ、新モデル追加。
+
 > **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）、セキュリティ強化と改善。
--- a/docs/ja/releases/v2.1.4.mdx
+++ b/docs/ja/releases/v2.1.4.mdx
@@ -0,0 +1,78 @@
+---
+title: v2.1.4
+description: "CowAgent 2.1.4：デスクトップの体験改善、MCP の OAuth 認可対応、Feishu チャネルの機能向上に加え、定期タスク・データバックアップ・新モデルなど多数の更新"
+---
+
+🌐 [English](https://docs.cowagent.ai/releases/v2.1.4) | [中文](https://docs.cowagent.ai/zh/releases/v2.1.4)
+
+## 🖥 デスクトップクライアント
+
+前バージョンでデスクトップクライアントを正式リリースしたのに続き、今回はブラウザ機能、システム互換性、使い勝手をさらに向上させました：
+
+- **ブラウザツール対応**：クライアントにブラウザ機能を内蔵し、システムにインストール済みの Chrome / Edge を優先的に再利用します。ブラウザの起動とアクセス性能も最適化しました。
+- **UI のブラッシュアップ**：チャット画面、メッセージバブル、ツール呼び出しステップ、チャネルページの見た目と操作性を改善しました。
+- **Windows コード署名**：Windows インストーラーにコード署名を追加し、インストール時のセキュリティ警告を軽減しました。
+- **Windows 7/8 対応**：Windows 7/8 などの旧システム向けクライアントに対応し、より多くの環境をカバーします。
+- **ナレッジベースのリンク修正**：デスクトップ版ナレッジベースのドキュメント内リンクが正しく遷移しない問題を修正しました。
+- **パスワードログイン**：デスクトップクライアントでログインパスワードの設定に対応し、パスワード設定後にウィンドウが読み込めない問題を修正しました。
+
+ダウンロード：[CowAgent デスクトップ](https://cowagent.ai/download/)
+
+ドキュメント：[デスクトップクライアント](https://docs.cowagent.ai/guide/desktop)
+
+## 🔌 MCP リモートサービスの OAuth 認可
+
+リモート MCP サービスが **OAuth 認可** に対応しました。ログイン認可が必要なサードパーティ MCP サービスに接続する際、標準の OAuth フローで認証を完了できるため、トークンを手動で設定・管理する必要がなくなります。
+
+ドキュメント：[MCP ツール](https://docs.cowagent.ai/tools/mcp)
+
+## ⏰ 定期タスク
+
+- **サイレントモード**：バックグラウンドで静かに実行され、メッセージを能動的に送信しない定期タスクを作成できます。データ整理や定期アーカイブなど、通知が不要なシーンに最適です。(#2954)
+- **手動実行**：次回のスケジュールを待たずに、コンソール画面から既存タスクを手動で即時実行できます。(#2958)
+- **編集時の設定保持**：Web コンソールでタスクを編集する際、モードタイプなどの隠しフィールドが失われることがある問題を修正しました。(#2959)
+- **クロスチャネルのタスクコマンド**：`/tasks` 管理コマンドを追加し、複数チャネルに対応しました。(#2965)
+
+Thanks @AaronZ345
+
+ドキュメント：[定期タスク](https://docs.cowagent.ai/tools/scheduler)
+
+## 💬 Feishu チャネルの機能向上
+
+Feishu チャネルにメッセージ表示と操作性の強化を一連で追加し、使い勝手を向上させました。
+
+- **ストリーミングカードの改善**：ストリーミングカードに折りたたみパネルを追加し、思考過程、ツール呼び出し、実行時間などを表示します。(#2963)
+- **Markdown 形式**：非ストリーミング応答と定期配信について、Markdown 構文を含む場合はカードとしてレンダリングし、より見やすく表示します。(#2962)
+- **定期タスクカード**：`/tasks` コマンドをカード形式で表示し、カード上でタスクの有効化・無効化ができます。(#2961)
+- **メッセージ引用への対応**：ユーザーがメッセージを引用した際、引用元の内容を自動的にコンテキストへ追加して Agent に送信します。(#2966)
+- **リモート画像のレンダリング**：Feishu カード内でリモート画像リンクをレンダリングできるようになりました。(#2967)
+- **メッセージ取り消しでタスクをキャンセル**：Feishu メッセージを取り消すと、対応する実行中またはキュー中のタスクを自動的にキャンセルします。(#2978)
+
+Thanks @AaronZ345
+
+ドキュメント：[Feishu](https://docs.cowagent.ai/channels/feishu)
+
+## 💾 データのバックアップと復元
+
+`cow backup` と `cow restore` コマンドを追加しました。設定、ナレッジベース、メモリなどのローカルデータをワンコマンドでエクスポート・復元でき、移行やバックアップが容易になります。Thanks @AaronZ345 (#2957)
+
+ドキュメント：[データバックアップ](https://docs.cowagent.ai/cli/backup)
+
+## 🤖 新モデル
+
+- **kimi-k3** に対応
+- **gpt-5.6-luna**、**gpt-5.6-terra**、**gpt-5.6-sol** に対応
+
+ドキュメント：[モデル一覧](https://docs.cowagent.ai/models)
+
+## 🛠 改善と修正
+
+- **アクティブタスクのステアリング**：`/steer` コマンドを追加し、タスクの実行中に新しい指示を挿入して、実行中のタスクをその場で誘導・軌道修正できます。Thanks @AaronZ345 (#2977)
+- **ファイル編集**：ファイル編集時にあいまい一致が誤った位置を特定することがある問題を修正しました。Thanks @weijun-xia (#2945)
+
+## 📦 アップグレード方法
+
+- **ソースデプロイ**：`cow update` でワンクリックアップグレード、または最新コードを取得して再起動してください。詳しくは [アップグレードガイド](https://docs.cowagent.ai/guide/upgrade) を参照してください。
+- **デスクトップクライアント**：クライアント内で更新を確認しワンクリックで更新するか、[ダウンロードページ](https://cowagent.ai/download/) から最新版を入手してください。
+
+**リリース日**：2026.07.20 | [Full Changelog](https://github.com/zhayujie/CowAgent/compare/2.1.3...2.1.4)
--- a/docs/releases/v2.1.4.mdx
+++ b/docs/releases/v2.1.4.mdx
@@ -0,0 +1,78 @@
+---
+title: v2.1.4
+description: "CowAgent 2.1.4: Desktop experience improvements, MCP OAuth authorization, Feishu channel enhancements, plus scheduler, data backup, and new models"
+---
+
+🌐 [English](https://docs.cowagent.ai/releases/v2.1.4) | [中文](https://docs.cowagent.ai/zh/releases/v2.1.4)
+
+## 🖥 Desktop Client
+
+Following the desktop client launched in the previous release, this version further improves browser capabilities, system compatibility, and overall experience:
+
+- **Browser tool support**: the client bundles browser capabilities and prefers reusing the system's installed Chrome / Edge, with optimized browser startup and access performance.
+- **UI polish**: refined visuals and interactions for the chat view, message bubbles, tool-call steps, and channel pages.
+- **Windows code signing**: Windows installers are now code-signed, reducing security warnings during installation.
+- **Windows 7/8 support**: added client support for legacy systems such as Windows 7/8, covering more environments.
+- **Knowledge base link fix**: fixed in-document links in the desktop knowledge base that failed to navigate.
+- **Password login**: the desktop client supports setting a login password, and fixes an issue where the window failed to load after a password was set.
+
+Download: [CowAgent Desktop](https://cowagent.ai/download/)
+
+Docs: [Desktop Client](https://docs.cowagent.ai/guide/desktop)
+
+## 🔌 MCP Remote Server OAuth Authorization
+
+Remote MCP servers now support **OAuth authorization**. When connecting to third-party MCP servers that require login, authentication can be completed via the standard OAuth flow — no more manually configuring and maintaining tokens.
+
+Docs: [MCP Tools](https://docs.cowagent.ai/tools/mcp)
+
+## ⏰ Scheduled Tasks
+
+- **Silent mode**: create silently-running scheduled tasks that execute in the background without pushing messages — ideal for undisturbed scenarios like data organization or periodic archiving. (#2954)
+- **Manual run**: manually trigger an existing task to run immediately from the console, without waiting for the next schedule. (#2958)
+- **Preserve config on edit**: fixed an issue where editing a task in the Web console could drop hidden fields such as the mode type. (#2959)
+- **Cross-channel task command**: added the `/tasks` management command, compatible across channels. (#2965)
+
+Thanks @AaronZ345
+
+Docs: [Scheduled Tasks](https://docs.cowagent.ai/tools/scheduler)
+
+## 💬 Feishu Channel Improvements
+
+The Feishu channel gains a series of message-display and interaction enhancements for a better experience.
+
+- **Streaming card polish**: streaming cards add collapsible panels showing the thinking process, tool calls, and execution time. (#2963)
+- **Markdown formatting**: for non-streaming replies and scheduled pushes, messages containing Markdown are rendered as cards for clearer display. (#2962)
+- **Scheduler cards**: the `/tasks` command is presented as cards, with the ability to enable or disable tasks right from the card. (#2961)
+- **Quoted message context**: when a user quotes a message, the quoted content is automatically added to the context sent to the Agent. (#2966)
+- **Remote image rendering**: remote image links can now be rendered inside Feishu cards. (#2967)
+- **Cancel on message recall**: recalling a Feishu message automatically cancels its corresponding running or queued task. (#2978)
+
+Thanks @AaronZ345
+
+Docs: [Feishu](https://docs.cowagent.ai/channels/feishu)
+
+## 💾 Data Backup & Restore
+
+Added the `cow backup` and `cow restore` commands to export and restore local data — configuration, knowledge base, memory, and more — with one command, making migration and backup easy. Thanks @AaronZ345 (#2957)
+
+Docs: [Data Backup](https://docs.cowagent.ai/cli/backup)
+
+## 🤖 New Models
+
+- Added support for **kimi-k3**
+- Added support for **gpt-5.6-luna**, **gpt-5.6-terra**, and **gpt-5.6-sol**
+
+Docs: [Models](https://docs.cowagent.ai/models)
+
+## 🛠 Improvements & Fixes
+
+- **Active-task steering**: added the `/steer` command to inject new instructions during task execution, guiding or redirecting the running task on the fly. Thanks @AaronZ345 (#2977)
+- **File editing**: fixed an issue where fuzzy matching could locate the wrong position when editing files. Thanks @weijun-xia (#2945)
+
+## 📦 How to Upgrade
+
+- **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).
+- **Desktop client**: check for updates and update with one click inside the client, or get the latest version from the [download page](https://cowagent.ai/download/).
+
+**Release date**: 2026.07.20 | [Full Changelog](https://github.com/zhayujie/CowAgent/compare/2.1.3...2.1.4)
--- a/docs/zh/README-Hant.md
+++ b/docs/zh/README-Hant.md
@@ -203,6 +203,8 @@ CowAgent 支援國內外主流廠商的大語言模型。**文字對話、影像

 ## 🏷 更新日誌

+> **2026.07.20：** [v2.1.4](https://github.com/zhayujie/CowAgent/releases/tag/2.1.4) — 桌面客戶端體驗最佳化、MCP 支援 OAuth 授權、飛書通道能力增強、定時任務與資料備份、新模型接入
+
 > **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）、安全加固和體驗最佳化
--- a/docs/zh/README.md
+++ b/docs/zh/README.md
@@ -203,6 +203,8 @@ CowAgent 支持国内外主流厂商的大语言模型。**文本对话、图像

 ## 🏷 更新日志

+> **2026.07.20：** [v2.1.4](https://github.com/zhayujie/CowAgent/releases/tag/2.1.4) — 桌面客户端体验优化、MCP 支持 OAuth 授权、飞书通道能力增强、定时任务优化与数据备份、新模型接入
+
 > **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）、安全加固和体验优化
--- a/docs/zh/releases/v2.1.4.mdx
+++ b/docs/zh/releases/v2.1.4.mdx
@@ -1,6 +1,6 @@
 ---
 title: v2.1.4
-description: CowAgent 2.1.4：桌面客户端体验优化，MCP 支持 OAuth 授权，定时任务工具优化，飞书通道能力增强，新增数据备份与多个模型
+description: CowAgent 2.1.4：桌面客户端体验优化，MCP 支持 OAuth 授权，飞书通道能力增强，定时任务与数据备份等多项更新
 ---

 🌐 [English](https://docs.cowagent.ai/releases/v2.1.4) | [中文](https://docs.cowagent.ai/zh/releases/v2.1.4)
@@ -46,6 +46,7 @@ Thanks @AaronZ345
 - **定时任务卡片**：定时任务 `/tasks` 命令以卡片形式呈现，并支持在卡片中启用和关闭任务。(#2961)
 - **支持消息引用**：用户引用消息时，自动将被引用消息加入上下文发送给 Agent。(#2966)
 - **远程图片渲染**：支持在飞书卡片中渲染远程图片链接。(#2967)
+- **撤回消息取消任务**：撤回某条飞书消息时，自动取消其对应正在执行或排队中的任务。(#2978)

 Thanks @AaronZ345

@@ -66,6 +67,7 @@ Thanks @AaronZ345

 ## 🛠 体验优化与修复

+- **任务实时引导**：新增 `/steer` 命令，可在任务执行过程中插入新指令来引导或纠偏当前正在执行的任务。Thanks @AaronZ345 (#2977)
 - **文件编辑**：修复编辑文件时模糊匹配可能定位到错误位置的问题。Thanks @weijun-xia (#2945)

 ## 📦 升级方式