feat(webui): v0.7.3 — Kimi Code WebUI 应用内嵌窗口（单例/独立顶层窗口/服务器自动清理）+ 发布说明与网站同步

.github/workflows/release.yml

@@ -79,13 +79,44 @@ jobs:
           releaseBody: |
             ## ${{ github.ref_name }}
 
+            ### 本次更新
+
+            - **高级设置**：原「子代理设置」升级为「高级设置」，聚合子代理模型指定、实验功能开关与 WebUI 快捷入口
+            - **Kimi Code WebUI 应用内嵌窗口**：高级设置页可将新版 Web 界面以**独立顶层窗口**在应用内打开（单例、可缩放，关闭自动清理服务器进程），也可在系统浏览器打开（复用已运行的本地服务器）
+            - **子代理模型指定（实验功能）**：为子代理绑定次主力模型，不再默认继承主模型；实验开关改为滑动开关并修复开启态隐形
+            - **兼容 kimi-code 0.33+（v2 引擎）**：`loop_control` 写入新键名 `max_attempts_per_step`，旧配置自动迁移并保留旧键兼容 `KIMI_CODE_LEGACY_FLAG=1`；hooks 候选补充新事件
+            - models.dev 模型数据同步；官网企业版视觉升级；出品公司标识统一
+
             ### Downloads by platform
 
             - **Windows**: `.msi` installer
-            - **macOS**: `.dmg` (unsigned — first launch needs right-click → Open) + `.app`
+            - **macOS**: `.dmg` + `.app`（未签名，仅 Apple Silicon / M 系列芯片）
             - **Linux**: `.deb` / `.AppImage` / `.rpm`
 
+            ### macOS 安装说明（无开发者账号签名，需一次手动绕过）
+
+            1. 下载 `KimiSwitch_*.dmg`，双击挂载后把 `Kimi Switch.app` 拖入「应用程序」文件夹
+            2. 下载本 Release 附带的 `install-macos.sh`，在终端运行：
+
+               ```bash
+               bash install-macos.sh
+               ```
+
+               脚本会自动清除「下载隔离」属性并启动应用，之后可正常使用。
+            3. 手动替代方案：右键 `Kimi Switch.app` → 打开 → 弹窗中点「打开」（或 系统设置 → 隐私与安全性 → 仍要打开）
+
             Full changelog: see commit history.
           prerelease: ${{ contains(github.ref_name, '-rc') || contains(github.ref_name, '-beta') || contains(github.ref_name, '-alpha') }}
           overwrite: true
           args: ${{ matrix.args }}
+
+  upload-macos-script:
+    name: Attach macOS install script
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Upload install-macos.sh to release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: gh release upload "${{ github.ref_name }}" scripts/install-macos.sh --clobber

README.md

@@ -55,7 +55,13 @@
 ## 下载
 
 - **Windows**: [GitHub Releases](https://github.com/billowliu2/KimiSwitch/releases/latest) → `.msi`
-- **macOS**: [GitHub Releases](https://github.com/billowliu2/KimiSwitch/releases/latest) → `.dmg`（**未签名** —— 首次启动请右键 → 打开绕过 Gatekeeper）
+- **macOS**: [GitHub Releases](https://github.com/billowliu2/KimiSwitch/releases/latest) → `.dmg`（**未签名**，仅 Apple Silicon / M 系列芯片）。安装请下载 Release 附带的 `install-macos.sh` 一键处理：
+
+  ```bash
+  bash install-macos.sh
+  ```
+
+  或手动：把 `Kimi Switch.app` 拖入「应用程序」→ 右键 → 打开 → 点「打开」绕过 Gatekeeper。
 - **Linux**: [GitHub Releases](https://github.com/billowliu2/KimiSwitch/releases/latest) → `.deb` / `.AppImage` / `.rpm`
 
 历史版本（v0.5.x 及之前）请前往 [git.codingplan.site 仓库](https://git.codingplan.site/admin/KimiCodeSwitch/releases)。

docs/BUILD.md

@@ -26,7 +26,9 @@ npm run tauri build -- --bundles app,dmg
 
 Output: `src-tauri/target/release/bundle/{macos,dmg}/`.
 
-Unsigned: first launch requires right-click → Open to bypass Gatekeeper.
+Unsigned (no Developer ID account): downloaded copies are blocked by Gatekeeper.
+For end users, attach `install-macos.sh` (auto-uploaded to each Release) or instruct:
+right-click → Open, or `xattr -cr "/Applications/Kimi Switch.app"`.
 
 ### Linux (native)
 

package.json

@@ -1,7 +1,7 @@
 {
   "name": "kimiswitch",
   "private": true,
-  "version": "0.7.1",
+  "version": "0.7.3",
   "type": "module",
   "scripts": {
     "dev": "vite",

release-notes-v0.7.2.md

@@ -0,0 +1,39 @@
+## v0.7.2
+
+### 高级设置与 WebUI（本次新增）
+
+- 「子代理设置」升级为「**高级设置**」：聚合子代理模型指定、实验功能开关与 WebUI 快捷入口
+- 新增 **Kimi Code WebUI 快捷打开**：高级设置页可将新版 Web 界面以独立窗口在应用内打开，也可在系统浏览器打开（kimi-code 0.33+ 内置 code-app；需要 kimi 命令在 PATH 中）
+
+### 子代理模型指定（实验功能）
+
+- 新增「子代理模型（次主力模型）」指定：在实验功能设置中为子代理选择次主力模型后，子代理默认绑定该模型，不再继承主模型
+- 实验开关改为滑动开关，修复开启态因样式缺失而不可见的问题
+- 仅保存模型引用，子代理直接继承所选模型的上下文长度与思考模式
+
+### 模型数据与发布
+
+- models.dev 模型列表与价格数据同步更新
+- 兼容 kimi-code 0.33+（v2 引擎）：`loop_control` 改用新键名 `max_attempts_per_step`（旧配置自动迁移，并保留旧键兼容 `KIMI_CODE_LEGACY_FLAG=1`）
+- 官网企业版视觉升级；出品公司标识统一为 codingplan.site
+- macOS 发布优化：Release 附带 `install-macos.sh` 一键安装脚本（见下方说明）
+
+### Downloads by platform
+
+- **Windows**: `.msi` installer
+- **macOS**: `.dmg` + `.app`（未签名，仅 Apple Silicon / M 系列芯片）
+- **Linux**: `.deb` / `.AppImage` / `.rpm`
+
+### macOS 安装说明（无开发者账号签名，需一次手动绕过）
+
+> 原因：macOS 包未做 Developer ID 签名与公证（无 Apple 开发者账号），系统会拦截从网络下载的未签名应用（Gatekeeper）。`install-macos.sh` 通过清除「下载隔离」属性绕过该拦截，不影响功能与安全。
+
+1. 下载 `Kimi.Switch_0.7.2_aarch64.dmg`，双击挂载后把 `Kimi Switch.app` 拖入「应用程序」文件夹
+2. 下载本 Release 附带的 `install-macos.sh`，在终端运行：
+
+   ```bash
+   bash install-macos.sh
+   ```
+
+   脚本会自动清除下载隔离属性并启动应用，只需执行一次，之后正常使用。
+3. 手动替代方案：右键 `Kimi Switch.app` → 打开 → 弹窗点「打开」；或 系统设置 → 隐私与安全性 → 仍要打开

release-notes-v0.7.3.md

@@ -0,0 +1,33 @@
+## v0.7.3
+
+### Kimi Code WebUI 应用内嵌窗口（本次新增）
+
+- 高级设置页「在应用内打开」：新版 Web 界面以**独立顶层窗口**打开（1100×750、可缩放、居中），不再跳转到外部浏览器
+- **单例**：窗口最多一个，重复点击自动聚焦；最小化后再次打开可恢复
+- **服务器自动管理**：复用已在运行的 `kimi web` 本地服务（不重复拉起）；自己启动的服务器在窗口关闭或应用退出时自动清理，不留残留进程
+- 两个入口并存：「在应用内打开」+「在浏览器打开」（浏览器入口复用已运行的本地服务器，直接打开 `http://127.0.0.1:58627`）
+
+### 修复与打磨
+
+- 窗口创建失败（快速双击竞态）时不再泄漏 `kimi web` 进程
+- WebUI 说明文案与发布说明同步更新
+
+### Downloads by platform
+
+- **Windows**: `.msi` installer
+- **macOS**: `.dmg` + `.app`（未签名，仅 Apple Silicon / M 系列芯片）
+- **Linux**: `.deb` / `.AppImage` / `.rpm`
+
+### macOS 安装说明（无开发者账号签名，需一次手动绕过）
+
+> 原因：macOS 包未做 Developer ID 签名与公证（无 Apple 开发者账号），系统会拦截从网络下载的未签名应用（Gatekeeper）。`install-macos.sh` 通过清除「下载隔离」属性绕过该拦截，不影响功能与安全。
+
+1. 下载 `Kimi.Switch_0.7.3_aarch64.dmg`，双击挂载后把 `Kimi Switch.app` 拖入「应用程序」文件夹
+2. 下载本 Release 附带的 `install-macos.sh`，在终端运行：
+
+   ```bash
+   bash install-macos.sh
+   ```
+
+   脚本会自动清除下载隔离属性并启动应用，只需执行一次，之后正常使用。
+3. 手动替代方案：右键 `Kimi Switch.app` → 打开 → 弹窗点「打开」；或 系统设置 → 隐私与安全性 → 仍要打开

scripts/install-macos.sh

@@ -0,0 +1,48 @@
+#!/bin/bash
+# install-macos.sh — Kimi Switch macOS 一键安装辅助脚本
+#
+# 背景：macOS 包未做 Developer ID 签名（无开发者账号），从网络下载后会被
+# Gatekeeper 的「下载隔离（quarantine）」属性拦截。本脚本清除该属性后启动应用。
+#
+# 用法（把 Kimi Switch.app 拖入「应用程序」文件夹后执行）：
+#   bash install-macos.sh
+#
+# 若脚本提示找不到应用，请先手动把 Kimi Switch.app 拖到 /Applications 再运行。
+
+set -e
+
+APP_NAME="Kimi Switch"
+APP_PATH="/Applications/${APP_NAME}.app"
+DOWNLOADED_DMG_NAME="KimiSwitch.dmg"
+
+if [ ! -d "$APP_PATH" ]; then
+  echo "❌ 未找到 ${APP_PATH}"
+  echo ""
+  echo "请先把「${APP_NAME}.app」拖到「应用程序」文件夹，再重新运行本脚本："
+  echo "  1. 双击下载的 ${DOWNLOADED_DMG_NAME}（磁盘映像会自动挂载）"
+  echo "  2. 把其中的 Kimi Switch.app 拖入「应用程序」文件夹"
+  echo "  3. 回到终端重新运行：bash install-macos.sh"
+  exit 1
+fi
+
+echo "① 清除「下载隔离」属性（Gatekeeper 拦截的来源）..."
+xattr -cr "$APP_PATH" 2>/dev/null || true
+echo "   完成"
+
+echo "② 验证代码签名状态："
+if codesign -dv "$APP_PATH" 2>&1 | grep -q "Signature=adhoc"; then
+  echo "   Signature=adhoc（正常，ad-hoc 签名，右键打开即可运行）"
+else
+  echo "   （未检测到签名信息，属正常，不影响本脚本的运行方式）"
+fi
+
+echo "③ 正在启动「${APP_NAME}」..."
+open "$APP_PATH"
+echo ""
+echo "✅ 启动完成。"
+echo ""
+echo "如果仍提示「无法验证开发者」，请按下面任一种方式再试："
+echo "  a) 右键 ${APP_NAME}.app → 打开 → 在弹出的提示中点「打开」"
+echo "  b) 系统设置 → 隐私与安全性 → 滚动到「安全性」→ 点「仍要打开」"
+echo ""
+echo "首次启动后应用即可正常使用，之后无需重复本操作。"

src-tauri/Cargo.lock

@@ -1958,7 +1958,7 @@ dependencies = [
 
 [[package]]
 name = "kimiswitch"
-version = "0.7.1"
+version = "0.7.3"
 dependencies = [
  "anyhow",
  "chrono",

src-tauri/Cargo.toml

@@ -1,8 +1,8 @@
 [package]
 name = "kimiswitch"
-version = "0.7.1"
+version = "0.7.3"
 description = "Kimi Switch - model config manager"
-authors = ["you"]
+authors = ["codingplan.site"]
 edition = "2021"
 
 [build-dependencies]

src-tauri/src/commands.rs

@@ -7,6 +7,7 @@ use serde::Serialize;
 use std::collections::HashMap;
 use std::sync::{Mutex, OnceLock};
 use std::time::{Duration, Instant};
+use tauri::Manager;
 use tauri_plugin_opener::OpenerExt;
 
 fn fmt_anyhow(err: anyhow::Error) -> String {
@@ -949,6 +950,193 @@ pub fn open_installer(app: tauri::AppHandle, path: String) -> Result<(), String>
         .open_path(&path, None::<&str>)
         .map_err(|e| e.to_string())
 }
+
+/// Open the Kimi Code WebUI in the system default browser. Reuses an
+/// already-running local `kimi web` server (embedded window, terminal, …);
+/// otherwise spawns `kimi web`, which starts the server and opens the browser.
+#[tauri::command]
+pub async fn open_kimi_web(app: tauri::AppHandle) -> Result<(), String> {
+    if kimi_web_alive(Duration::from_millis(800)).await {
+        // Server already running — just open the browser at the local origin.
+        return app
+            .opener()
+            .open_url(kimi_web_url(), None::<&str>)
+            .map_err(|e| e.to_string());
+    }
+    let mut cmd = std::process::Command::new("kimi");
+    cmd.arg("web");
+    #[cfg(windows)]
+    {
+        use std::os::windows::process::CommandExt;
+        // CREATE_NO_WINDOW: avoid a console window flashing next to the GUI.
+        cmd.creation_flags(0x08000000);
+    }
+    cmd.spawn()
+        .map(|_| ())
+        .map_err(|e| {
+            if e.kind() == std::io::ErrorKind::NotFound {
+                "kimi executable not found on PATH — install Kimi Code CLI first".to_string()
+            } else {
+                format!("failed to start `kimi web`: {e}")
+            }
+        })
+}
+
+// ---------------------------------------------------------------------------
+// Kimi Code WebUI — embedded in-app window
+//
+// `open_kimi_web_embedded` opens the Kimi Code Web UI inside a dedicated,
+// independent top-level window (no parent/child relationship with the main
+// window). At most one such window exists: re-invoking focuses it. The local
+// `kimi web` server is reused when already running; otherwise one is spawned
+// (`--no-open`) and terminated when the window closes or the app exits.
+// ---------------------------------------------------------------------------
+
+/// Shared state for the embedded WebUI window and the server we may have spawned.
+#[derive(Default)]
+pub struct KimiWebState {
+    /// The embedded WebUI window (at most one).
+    window: Mutex<Option<tauri::WebviewWindow>>,
+    /// The `kimi web` child spawned by this app (None when reusing a server).
+    child: Mutex<Option<std::process::Child>>,
+}
+
+const KIMI_WEB_PORT: u16 = 58627;
+const KIMI_WEB_ORIGIN: &str = "http://127.0.0.1:58627";
+const KIMI_WEB_WINDOW_LABEL: &str = "kimi-web-ui";
+
+/// Build the Web UI URL; the home-wide bearer token rides in the `#token=`
+/// fragment (same as the `kimi web` ready banner, see kimi-code
+/// `cli/sub/web/access-urls.ts`).
+fn kimi_web_url() -> String {
+    let token = dirs::home_dir()
+        .map(|h| h.join(".kimi-code").join("server.token"))
+        .and_then(|p| std::fs::read_to_string(p).ok())
+        .map(|s| s.trim().to_string())
+        .filter(|s| !s.is_empty());
+    match token {
+        Some(t) => format!("{KIMI_WEB_ORIGIN}/#token={t}"),
+        None => format!("{KIMI_WEB_ORIGIN}/"),
+    }
+}
+
+/// Best-effort probe of the local Kimi web server root.
+async fn kimi_web_alive(timeout: Duration) -> bool {
+    let Ok(client) = reqwest::Client::builder().timeout(timeout).build() else {
+        return false;
+    };
+    client
+        .get(KIMI_WEB_ORIGIN)
+        .send()
+        .await
+        .map(|r| r.status().is_success())
+        .unwrap_or(false)
+}
+
+/// Kill the `kimi web` server spawned by this app (no-op when reusing one).
+pub fn kill_spawned_kimi_web(state: &tauri::State<'_, KimiWebState>) {
+    if let Ok(mut guard) = state.child.lock() {
+        if let Some(mut child) = guard.take() {
+            let _ = child.kill();
+            let _ = child.wait();
+        }
+    }
+}
+
+/// Open the Kimi Code WebUI in an embedded, independent top-level window.
+#[tauri::command]
+pub async fn open_kimi_web_embedded(
+    app: tauri::AppHandle,
+    state: tauri::State<'_, KimiWebState>,
+) -> Result<(), String> {
+    // Singleton: focus the existing window instead of creating a second one.
+    if let Ok(guard) = state.window.lock() {
+        if let Some(w) = guard.as_ref() {
+            if w.is_visible().unwrap_or(false) {
+                let _ = w.unminimize();
+                let _ = w.set_focus();
+                return Ok(());
+            }
+        }
+    }
+
+    // Reuse an already-running server, otherwise spawn `kimi web --no-open`.
+    if !kimi_web_alive(Duration::from_millis(800)).await {
+        let mut cmd = std::process::Command::new("kimi");
+        cmd.args(["web", "--no-open", "--port", &KIMI_WEB_PORT.to_string()]);
+        #[cfg(windows)]
+        {
+            use std::os::windows::process::CommandExt;
+            cmd.creation_flags(0x08000000); // CREATE_NO_WINDOW — no console flash
+        }
+        let child = cmd.spawn().map_err(|e| {
+            if e.kind() == std::io::ErrorKind::NotFound {
+                "kimi executable not found on PATH — install Kimi Code CLI first".to_string()
+            } else {
+                format!("failed to start `kimi web`: {e}")
+            }
+        })?;
+        if let Ok(mut guard) = state.child.lock() {
+            *guard = Some(child);
+        }
+    }
+
+    // Wait for the server to come up (fresh start takes a moment).
+    if !kimi_web_alive(Duration::from_secs(8)).await {
+        kill_spawned_kimi_web(&state);
+        return Err(format!("kimi web did not come up within 8s ({KIMI_WEB_ORIGIN})"));
+    }
+
+    // Create the window on the main thread (required on macOS).
+    let url: tauri::Url = match kimi_web_url().parse() {
+        Ok(u) => u,
+        Err(_) => return Err("invalid kimi web url".to_string()),
+    };
+    let app = app.clone();
+    tauri::async_runtime::spawn(async move {
+        let builder_app = app.clone();
+        let _ = app.run_on_main_thread(move || {
+            match tauri::WebviewWindowBuilder::new(
+                &builder_app,
+                KIMI_WEB_WINDOW_LABEL,
+                tauri::WebviewUrl::External(url),
+            )
+            .title("Kimi Code WebUI")
+            .inner_size(1100.0, 750.0)
+            .resizable(true)
+            .center()
+            .build()
+            {
+                Ok(window) => {
+                    // Track the window for the singleton check.
+                    if let Ok(mut guard) = builder_app.state::<KimiWebState>().window.lock() {
+                        *guard = Some(window.clone());
+                    }
+                    // Clean up when the window closes: forget it and stop the
+                    // `kimi web` server we spawned (reused servers are untouched).
+                    let w = window.clone();
+                    window.on_window_event(move |event| match event {
+                        tauri::WindowEvent::Destroyed => {
+                            let app = w.app_handle().clone();
+                            let state = app.state::<KimiWebState>();
+                            if let Ok(mut guard) = state.window.lock() {
+                                *guard = None;
+                            }
+                            kill_spawned_kimi_web(&state);
+                        }
+                        _ => {}
+                    });
+                }
+                Err(_) => {
+                    // Window creation failed (e.g. rapid double-click racing
+                    // the singleton check): don't leak the server we spawned.
+                    kill_spawned_kimi_web(&builder_app.state::<KimiWebState>());
+                }
+            }
+        });
+    });
+    Ok(())
+}
 /// Preference for Linux is AppImage (portable, no install). If the preferred
 /// extension is not present, returns None so the UI can fall back to
 /// "open release page" instead of guessing a less-preferred format.

src-tauri/src/lib.rs

@@ -109,6 +109,8 @@ pub fn run() {
             commands::download_update,
             commands::open_installer,
             commands::open_external_url,
+            commands::open_kimi_web,
+            commands::open_kimi_web_embedded,
             commands::kimi_oauth_start,
             commands::kimi_oauth_poll,
             commands::get_experimental_env_status,
@@ -122,6 +124,15 @@ pub fn run() {
             dashboard::delete_workspace,
             dashboard::get_session_preview,
         ])
-        .run(tauri::generate_context!())
+        .manage(commands::KimiWebState::default())
-        .expect("error while running tauri application");
+        .build(tauri::generate_context!())
+        .expect("error while running tauri application")
+        .run(|app: &tauri::AppHandle, event| {
+            // Ensure a `kimi web` server spawned for the embedded WebUI window
+            // is stopped when the app exits (windows already destroyed first).
+            if let tauri::RunEvent::Exit = event {
+                let state = app.state::<commands::KimiWebState>();
+                commands::kill_spawned_kimi_web(&state);
+            }
+        });
 }

src-tauri/tauri.conf.json

@@ -1,6 +1,6 @@
 {
   "productName": "Kimi Switch",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "identifier": "com.kimiswitch.app",
   "build": {
     "beforeDevCommand": "npm run dev",
@@ -37,6 +37,7 @@
       "icons/icon.ico",
       "icons/icon.icns"
     ],
+    "publisher": "codingplan.site",
     "windows": {
       "webviewInstallMode": {
         "type": "downloadBootstrapper"

src/components/AgentSettingsPanel.tsx

@@ -24,7 +24,18 @@ const PERMISSION_LABELS: Record<(typeof PERMISSION_DECISIONS)[number], Translati
   ask: "permissionAsk",
 };
 
-const COMMON_EVENTS = ["PreToolUse", "PostToolUse"] as const;
+// kimi-code 0.33+ added TurnStarted / UserPromptQueued / TaskStarted /
+// SessionHeartbeat hook events (plus SessionStart / SessionEnd).
+const COMMON_EVENTS = [
+  "PreToolUse",
+  "PostToolUse",
+  "TurnStarted",
+  "UserPromptQueued",
+  "TaskStarted",
+  "SessionHeartbeat",
+  "SessionStart",
+  "SessionEnd",
+] as const;
 
 export function AgentSettingsPanel({ rawOther, onChange }: AgentSettingsPanelProps) {
   const { t } = useTranslation();
@@ -91,9 +102,18 @@ export function AgentSettingsPanel({ rawOther, onChange }: AgentSettingsPanelPro
 
       <Card title={t("loopControlSettings")}>
         <NumberField
-          label={t("maxRetriesPerStep")}
+          label={t("maxAttemptsPerStep")}
-          value={settings.loop_control?.max_retries_per_step ?? 3}
+          value={
-          onChange={(v) => updateLoopControl({ max_retries_per_step: v })}
+            settings.loop_control?.max_attempts_per_step ??
+            settings.loop_control?.max_retries_per_step ??
+            3
+          }
+          onChange={(v) =>
+            updateLoopControl({
+              max_attempts_per_step: v,
+              max_retries_per_step: v,
+            })
+          }
         />
         <NumberField
           label={t("reservedContextSize")}

src/components/SubagentSettingsPage.tsx

@@ -161,6 +161,39 @@ export function SubagentSettingsPage({
           </div>
         )}
 
+        {/* Kimi Code WebUI quick open */}
+        <Card title={t("webuiSection")}>
+          <p className="text-xs text-content-muted">{t("webuiDesc")}</p>
+          <div className="mt-3 flex flex-wrap gap-2">
+            <button
+              type="button"
+              onClick={async () => {
+                try {
+                  await invoke("open_kimi_web_embedded");
+                } catch (err) {
+                  alert(err instanceof Error ? err.message : String(err));
+                }
+              }}
+              className="px-3 py-1.5 text-sm rounded bg-blue-600 text-white hover:bg-blue-500 focus:ring-2 focus:ring-blue-500 focus:outline-none"
+            >
+              {t("openWebUIEmbedded")}
+            </button>
+            <button
+              type="button"
+              onClick={async () => {
+                try {
+                  await invoke("open_kimi_web");
+                } catch (err) {
+                  alert(err instanceof Error ? err.message : String(err));
+                }
+              }}
+              className="px-3 py-1.5 text-sm border border-border rounded hover:bg-hover-2 focus:ring-2 focus:ring-blue-500 focus:outline-none"
+            >
+              {t("openWebUIBrowser")}
+            </button>
+          </div>
+        </Card>
+
         {/* Subagent: secondary model picker + inherited settings */}
         <Card title={t("secondaryModelSection")}>
           <label className="flex items-center gap-3 text-sm text-content-primary">

src/i18n/en.ts

@@ -136,7 +136,7 @@ export const enTranslations: Record<TranslationKey, string> = {
   thinkingMax: "Max",
   thinkingContextHint: "Thinking uses more context. Ensure the model context length and reserved size are sufficient.",
   loopControlSettings: "Loop Control",
-  maxRetriesPerStep: "Max retries per step",
+  maxAttemptsPerStep: "Max attempts per step",
   reservedContextSize: "Reserved context size",
   backgroundSettings: "Background Tasks",
   maxRunningTasks: "Max running tasks",
@@ -449,8 +449,8 @@ export const enTranslations: Record<TranslationKey, string> = {
   trendLineTooltip: "{date}\nTokens: {tokens}\nCache hit: {cache}\nRequests: {req}",
   trendLineNoData: "No data",
 
-  // Subagent settings page (experimental flags + secondary model)
+  // Advanced settings page (WebUI quick open + experimental flags + secondary model)
-  subagentSettings: "Subagent Settings",
+  subagentSettings: "Advanced Settings",
   experimentalFlags: "Experimental Features",
   otherExperimentalFlags: "Other Experimental Features",
   experimentalFlagsHint:
@@ -478,4 +478,11 @@ export const enTranslations: Record<TranslationKey, string> = {
     "Second model config bound to subagents by default; when unset, subagents inherit the primary model. Only the model reference is stored; subagents inherit all of that model's settings",
   secondaryModelPriorityHint:
     "Priority: explicit tool model param > profile model_preference > this config > inherit primary model",
+
+  // Kimi Code WebUI quick open
+  webuiSection: "Kimi Code WebUI",
+  webuiDesc:
+    "Open the new Web UI in an independent in-app window, or in your system browser (built into kimi-code 0.33+). Requires the kimi CLI on PATH.",
+  openWebUIEmbedded: "Open in App",
+  openWebUIBrowser: "Open in Browser",
 };

src/i18n/zh.ts

@@ -134,7 +134,7 @@ export const zhTranslations = {
   thinkingMax: "最大",
   thinkingContextHint: "启用思考会占用更多上下文，请确保模型上下文长度和预留空间足够。",
   loopControlSettings: "循环控制",
-  maxRetriesPerStep: "单步重试次数",
+  maxAttemptsPerStep: "单步最大尝试次数",
   reservedContextSize: "上下文预留大小",
   backgroundSettings: "后台任务",
   maxRunningTasks: "最大并发数",
@@ -444,8 +444,8 @@ export const zhTranslations = {
   trendLineTooltip: "{date}\nToken: {tokens}\n命中率: {cache}\n请求: {req}",
   trendLineNoData: "暂无数据",
 
-  // Subagent settings page (experimental flags + secondary model)
+  // Advanced settings page (WebUI quick open + experimental flags + secondary model)
-  subagentSettings: "子代理设置",
+  subagentSettings: "高级设置",
   experimentalFlags: "实验功能开关",
   otherExperimentalFlags: "其他实验功能",
   experimentalFlagsHint:
@@ -473,6 +473,13 @@ export const zhTranslations = {
     "子代理默认绑定的第二份模型配置；未配置时子代理继承主模型；仅保存模型引用，子代理继承该模型的全部设置",
   secondaryModelPriorityHint:
     "优先级：工具显式 model 参数 > 子代理 profile 的 model_preference > 本配置 > 继承主模型",
+
+  // Kimi Code WebUI quick open
+  webuiSection: "Kimi Code WebUI",
+  webuiDesc:
+    "以独立窗口在应用内打开新版 Web 界面，也可以选择在系统浏览器打开（kimi-code 0.33+ 内置 code-app；需要 kimi 命令在 PATH 中）。",
+  openWebUIEmbedded: "在应用内打开",
+  openWebUIBrowser: "在浏览器打开",
 } as const;
 
 export type TranslationKey = keyof typeof zhTranslations;

src/lib/agent-settings.ts

@@ -7,7 +7,7 @@ const DEFAULT_SETTINGS: AgentSettings = {
     keep: "all",
   },
   loop_control: {
-    max_retries_per_step: 3,
+    max_attempts_per_step: 3,
     reserved_context_size: 50000,
   },
   background: {
@@ -32,15 +32,29 @@ function getSection<T>(rawOther: unknown, key: string): T | undefined {
 }
 
 export function getAgentSettings(rawOther: unknown): AgentSettings {
+  const sectionLoop = getSection<AgentSettings["loop_control"]>(
+    rawOther,
+    "loop_control"
+  );
+  const loop: AgentSettings["loop_control"] = {
+    ...DEFAULT_SETTINGS.loop_control,
+    ...sectionLoop,
+  };
+  // kimi-code 0.33+ (v2 engine) renamed max_retries_per_step →
+  // max_attempts_per_step; migrate legacy values so they still show and edit.
+  if (
+    sectionLoop &&
+    sectionLoop.max_attempts_per_step === undefined &&
+    sectionLoop.max_retries_per_step !== undefined
+  ) {
+    loop.max_attempts_per_step = sectionLoop.max_retries_per_step;
+  }
   return {
     thinking: {
       ...DEFAULT_SETTINGS.thinking,
       ...getSection<AgentSettings["thinking"]>(rawOther, "thinking"),
     },
-    loop_control: {
+    loop_control: loop,
-      ...DEFAULT_SETTINGS.loop_control,
-      ...getSection<AgentSettings["loop_control"]>(rawOther, "loop_control"),
-    },
     background: {
       ...DEFAULT_SETTINGS.background,
       ...getSection<AgentSettings["background"]>(rawOther, "background"),

src/types/index.ts

@@ -97,6 +97,11 @@ export interface ThinkingConfig {
 }
 
 export interface LoopControlConfig {
+  /** v2 engine key (kimi-code 0.33+): `max_retries_per_step` was renamed. */
+  max_attempts_per_step?: number;
+  /** v2 engine key (kimi-code 0.33+): `max_steps_per_run` was renamed. */
+  max_steps_per_turn?: number;
+  /** Legacy v1 key — written in sync so KIMI_CODE_LEGACY_FLAG=1 still works. */
   max_retries_per_step?: number;
   reserved_context_size?: number;
 }

website/src/i18n.tsx

@@ -16,10 +16,10 @@ const zh = {
     performance: "性能",
     changelog: "更新日志",
     download: "下载",
-    downloadBtn: "下载 v0.7.0",
+    downloadBtn: "下载 v0.7.3",
   },
   hero: {
-    badge: "v0.7.0 · 开源 MIT · Windows / macOS / Linux",
+    badge: "v0.7.3 · 开源 MIT · Windows / macOS / Linux",
     titleBefore: "统一管理你的",
     titleAccent: "AI 供应商",
     titleAfter: "",
@@ -140,6 +140,39 @@ const zh = {
     syncedNote: "数据已同步 GitHub Releases",
     fallbackNote: "内置版本记录",
     entries: [
+      {
+        version: "v0.7.3",
+        date: "2026-08-07",
+        items: [
+          "高级设置新增 Kimi Code WebUI 应用内嵌窗口：新版 Web 界面以独立顶层窗口打开（单例、可缩放、居中），不再跳转外部浏览器",
+          "WebUI 两个入口并存：应用内独立窗口 / 系统浏览器（复用已运行的 kimi web 服务器，不重复拉起）",
+          "服务器进程自动管理：自己启动的服务器随窗口关闭/应用退出清理，不留残留；窗口创建失败不再泄漏进程",
+          "最小化窗口再次打开可恢复；发布说明文案同步更新",
+        ],
+      },
+      {
+        version: "v0.7.2",
+        date: "2026-08-07",
+        items: [
+          "「子代理设置」升级为「高级设置」：聚合子代理模型指定、实验功能开关与 WebUI 快捷入口",
+          "新增 Kimi Code WebUI 快捷打开：高级设置页可将新版 Web 界面以独立窗口在应用内打开，也可在系统浏览器打开（kimi-code 0.33+）",
+          "子代理模型指定（实验功能）：设置中为子代理选择次主力模型，子代理不再默认继承主模型",
+          "实验开关改为滑动开关，修复开启态因样式缺失而不可见的问题",
+          "兼容 kimi-code 0.33+（v2 引擎）：循环控制改用新键 max_attempts_per_step，旧配置自动迁移",
+          "models.dev 模型列表与价格数据同步更新",
+          "官网企业版视觉升级；出品公司标识统一为 codingplan.site",
+          "macOS 安装优化：Release 附带 install-macos.sh 一键脚本，自动清除下载隔离，免去手动右键打开",
+        ],
+      },
+      {
+        version: "v0.7.1",
+        date: "2026-08-05",
+        items: [
+          "实验功能设置新增「子代理模型（次主力模型）」配置：选择后子代理绑定该模型，不再继承主模型",
+          "仪表盘用量统计识别子代理请求（__secondary__）独立展示，并缓存次主力模型定价",
+          "自定义网关模型按官方同名模型跨 provider 匹配价格，不再落入兜底估算",
+        ],
+      },
       {
         version: "v0.7.0",
         date: "2026-08-02",
@@ -269,7 +302,7 @@ const zh = {
   },
   download: {
     title: "下载 Kimi Switch",
-    subtitle: "当前版本 v0.7.0 · Windows / macOS / Linux 三平台已发布",
+    subtitle: "当前版本 v0.7.3 · Windows / macOS / Linux 三平台已发布",
     autoUpdate: "应用内置自动检测更新，新版本发布后在设置页一键升级。",
     ready: "已发布",
     wip: "开发中",
@@ -277,7 +310,7 @@ const zh = {
     mirrorBtn: "镜像下载",
     items: [
       { id: "windows", name: "Windows", ready: true, note: ".msi 安装包，系统托盘常驻" },
-      { id: "macos", name: "macOS", ready: true, note: ".dmg 安装包（Apple Silicon），未签名需右键打开" },
+      { id: "macos", name: "macOS", ready: true, note: ".dmg 安装包（Apple Silicon），未签名：下载 install-macos.sh 后运行 bash install-macos.sh 一键安装" },
       { id: "linux", name: "Linux", ready: true, note: ".deb / .AppImage / .rpm 三格式" },
     ],
   },
@@ -337,10 +370,10 @@ const en: Dict = {
     performance: "Performance",
     changelog: "Changelog",
     download: "Download",
-    downloadBtn: "Download v0.7.0",
+    downloadBtn: "Download v0.7.3",
   },
   hero: {
-    badge: "v0.7.0 · Open source MIT · Windows / macOS / Linux",
+    badge: "v0.7.3 · Open source MIT · Windows / macOS / Linux",
     titleBefore: "One app for all your ",
     titleAccent: "AI providers",
     titleAfter: "",
@@ -461,6 +494,39 @@ const en: Dict = {
     syncedNote: "Synced from GitHub Releases",
     fallbackNote: "Built-in release notes",
     entries: [
+      {
+        version: "v0.7.3",
+        date: "2026-08-07",
+        items: [
+          "Advanced Settings gains an embedded Kimi Code WebUI window: the new Web UI opens in an independent top-level window (singleton, resizable, centered) instead of the external browser",
+          "Two WebUI entries coexist: in-app independent window / system browser (reuses an already-running kimi web server, no duplicate spawn)",
+          "Server process is managed automatically: servers we start are cleaned up when the window closes or the app exits; a failed window creation no longer leaks the process",
+          "Re-opening focuses and restores a minimized window; release notes wording synced",
+        ],
+      },
+      {
+        version: "v0.7.2",
+        date: "2026-08-07",
+        items: [
+          "Subagent settings upgraded to an Advanced Settings page: subagent model assignment, experimental toggles and a WebUI quick launcher",
+          "New Kimi Code WebUI quick open: open the new Web UI in an independent in-app window from Advanced Settings, or in your system browser (kimi-code 0.33+)",
+          "Subagent model assignment (experimental): pick a secondary model for subagents so they no longer inherit the main model by default",
+          "Experiment toggle converted to a sliding switch, fixing the invisible enabled state",
+          "Compatible with kimi-code 0.33+ (v2 engine): loop control now writes max_attempts_per_step with auto-migration",
+          "models.dev model list and pricing snapshot synced",
+          "Enterprise-style website refresh; publisher identity unified as codingplan.site",
+          "macOS install polish: releases now ship install-macos.sh, a one-click script that clears the download quarantine",
+        ],
+      },
+      {
+        version: "v0.7.1",
+        date: "2026-08-05",
+        items: [
+          "Experimental settings gain a secondary-model picker for subagents, decoupling them from the main model",
+          "Dashboard usage stats identify subagent requests (__secondary__) and show them separately with cached secondary-model pricing",
+          "Custom gateway models match prices against the same-named official model across providers",
+        ],
+      },
       {
         version: "v0.7.0",
         date: "2026-08-02",
@@ -589,7 +655,7 @@ const en: Dict = {
   },
   download: {
     title: "Download Kimi Switch",
-    subtitle: "Current version v0.7.0 · Windows, macOS and Linux now released",
+    subtitle: "Current version v0.7.3 · Windows, macOS and Linux now released",
     autoUpdate: "Built-in update detection: upgrade in one click from Settings when a new version ships.",
     ready: "Available",
     wip: "In development",
@@ -597,7 +663,7 @@ const en: Dict = {
     mirrorBtn: "China mirror",
     items: [
       { id: "windows", name: "Windows", ready: true, note: ".msi installer, lives in the system tray" },
-      { id: "macos", name: "macOS", ready: true, note: ".dmg installer (Apple Silicon), unsigned - right-click to open" },
+      { id: "macos", name: "macOS", ready: true, note: ".dmg installer (Apple Silicon), unsigned: download install-macos.sh and run bash install-macos.sh for one-click install" },
       { id: "linux", name: "Linux", ready: true, note: ".deb / .AppImage / .rpm" },
     ],
   },

website/src/sections/Download.tsx

@@ -8,25 +8,27 @@ const icons: Record<string, Icon> = {
   linux: LinuxLogo,
 };
 
-const VERSION = "0.7.0";
+const VERSION = "0.7.3";
 const GITHUB = "https://github.com/billowliu2/KimiSwitch";
 const MIRROR_RELEASES = "https://git.codingplan.site/admin/KimiCodeSwitch/releases";
 const dl = (file: string) => `${GITHUB}/releases/download/v${VERSION}/${file}`;
 
 /** Per-platform download assets for the current release (names match the CI
- *  release workflow, e.g. Kimi.Switch_0.7.0_x64_en-US.msi). */
+ *  release workflow. NOTE: tauri-bundler keeps the productName verbatim, so the
+ *  real asset is "Kimi Switch_0.7.3_…" (space), URL-encoded as %20. */
 const assets: Record<string, { label: string; href: string }[]> = {
   windows: [
-    { label: "MSI", href: dl("Kimi.Switch_0.7.0_x64_en-US.msi") },
+    { label: "MSI", href: dl("Kimi%20Switch_0.7.3_x64_en-US.msi") },
     { label: "镜像", href: MIRROR_RELEASES },
   ],
   macos: [
-    { label: "Apple Silicon (.dmg)", href: dl("Kimi.Switch_0.7.0_aarch64.dmg") },
+    { label: "Apple Silicon (.dmg)", href: dl("Kimi%20Switch_0.7.3_aarch64.dmg") },
+    { label: "安装脚本", href: dl("install-macos.sh") },
   ],
   linux: [
-    { label: ".deb", href: dl("Kimi.Switch_0.7.0_amd64.deb") },
+    { label: ".deb", href: dl("Kimi%20Switch_0.7.3_amd64.deb") },
-    { label: ".AppImage", href: dl("Kimi.Switch_0.7.0_amd64.AppImage") },
+    { label: ".AppImage", href: dl("Kimi%20Switch_0.7.3_amd64.AppImage") },
-    { label: ".rpm", href: dl("Kimi.Switch-0.7.0-1.x86_64.rpm") },
+    { label: ".rpm", href: dl("Kimi%20Switch-0.7.3-1.x86_64.rpm") },
   ],
 };