feat(webui): v0.7.3 — Kimi Code WebUI 应用内嵌窗口(单例/独立顶层窗口/服务器自动清理)+ 发布说明与网站同步
Release / Version consistency (push) Canceled after 0s
Release / Build (macos-latest) (push) Canceled after 0s
Release / Build (ubuntu-latest) (push) Canceled after 0s
Release / Build (windows-latest) (push) Canceled after 0s
Release / Attach macOS install script (push) Canceled after 0s

This commit is contained in:
KimiSwitch Dev committed 2026-08-07 15:46:45 +08:00
1 parent fc09a29b9f
commit a0e36e928d
16 files changed
+145747 -143679

No files matched your search

+8
View File
@@ -79,6 +79,14 @@ 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
+1 -1
View File
@@ -1,7 +1,7 @@
{
"name": "kimiswitch",
"private": true,
"version": "0.7.2",
"version": "0.7.3",
"type": "module",
"scripts": {
"dev": "vite",
+6
View File
@@ -1,5 +1,10 @@
## v0.7.2
### 高级设置与 WebUI(本次新增)
- 「子代理设置」升级为「**高级设置**」:聚合子代理模型指定、实验功能开关与 WebUI 快捷入口
- 新增 **Kimi Code WebUI 快捷打开**:高级设置页可将新版 Web 界面以独立窗口在应用内打开,也可在系统浏览器打开(kimi-code 0.33+ 内置 code-app;需要 kimi 命令在 PATH 中)
### 子代理模型指定(实验功能)
- 新增「子代理模型(次主力模型)」指定:在实验功能设置中为子代理选择次主力模型后,子代理默认绑定该模型,不再继承主模型
@@ -9,6 +14,7 @@
### 模型数据与发布
- 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` 一键安装脚本(见下方说明)
+33
View File
@@ -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` → 打开 → 弹窗点「打开」;或 系统设置 → 隐私与安全性 → 仍要打开
+1 -1
View File
@@ -1958,7 +1958,7 @@ dependencies = [
[[package]]
name = "kimiswitch"
version = "0.7.2"
version = "0.7.3"
dependencies = [
"anyhow",
"chrono",
+1 -1
View File
@@ -1,6 +1,6 @@
[package]
name = "kimiswitch"
version = "0.7.2"
version = "0.7.3"
description = "Kimi Switch - model config manager"
authors = ["codingplan.site"]
edition = "2021"
+169 -7
View File
@@ -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 {
@@ -950,14 +951,19 @@ pub fn open_installer(app: tauri::AppHandle, path: String) -> Result<(), String>
.map_err(|e| e.to_string())
}
/// Launch `kimi web` — starts the local Kimi Code Web UI server and opens it
/// in the default browser (the code-app web bundle built into kimi-code 0.33+).
/// The kimi CLI must be on PATH; the spawned process is detached so the server
/// keeps running while Kimi Switch stays open.
/// 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 fn open_kimi_web() -> Result<(), String> {
use std::process::Command;
let mut cmd = Command::new("kimi");
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)]
{
@@ -975,6 +981,162 @@ pub fn open_kimi_web() -> Result<(), String> {
}
})
}
// ---------------------------------------------------------------------------
// 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.
+12 -2
View File
@@ -110,6 +110,7 @@ pub fn run() {
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,
@@ -123,6 +124,15 @@ pub fn run() {
dashboard::delete_workspace,
dashboard::get_session_preview,
])
.run(tauri::generate_context!())
.expect("error while running tauri application");
.manage(commands::KimiWebState::default())
.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);
}
});
}
+1 -1
View File
@@ -1,6 +1,6 @@
{
"productName": "Kimi Switch",
"version": "0.7.2",
"version": "0.7.3",
"identifier": "com.kimiswitch.app",
"build": {
"beforeDevCommand": "npm run dev",
+17 -2
View File
@@ -164,6 +164,20 @@ export function SubagentSettingsPage({
{/* 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 () => {
@@ -173,10 +187,11 @@ export function SubagentSettingsPage({
alert(err instanceof Error ? err.message : String(err));
}
}}
className="mt-3 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"
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("openWebUI")}
{t("openWebUIBrowser")}
</button>
</div>
</Card>
{/* Subagent: secondary model picker + inherited settings */}
+3 -2
View File
@@ -482,6 +482,7 @@ export const enTranslations: Record<TranslationKey, string> = {
// Kimi Code WebUI quick open
webuiSection: "Kimi Code WebUI",
webuiDesc:
"Launch `kimi web` to open the new Web UI in your browser (built into kimi-code 0.33+). Requires the kimi CLI on PATH.",
openWebUI: "Open WebUI",
"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",
};
+3 -2
View File
@@ -477,8 +477,9 @@ export const zhTranslations = {
// Kimi Code WebUI quick open
webuiSection: "Kimi Code WebUI",
webuiDesc:
"启动 kimi web,在浏览器中打开新版 Web 界面(kimi-code 0.33+ 内置 code-app)。需要 kimi 命令在 PATH 中。",
openWebUI: "打开 WebUI",
"以独立窗口在应用内打开新版 Web 界面,也可以选择在系统浏览器打开(kimi-code 0.33+ 内置 code-app;需要 kimi 命令在 PATH 中)。",
openWebUIEmbedded: "在应用内打开",
openWebUIBrowser: "在浏览器打开",
} as const;
export type TranslationKey = keyof typeof zhTranslations;
+80908 -79935
View File
File diff suppressed because it is too large. Load diff
+64545 -63712
View File
File diff suppressed because it is too large. Load diff
+32 -6
View File
@@ -16,10 +16,10 @@ const zh = {
performance: "性能",
changelog: "更新日志",
download: "下载",
downloadBtn: "下载 v0.7.2",
downloadBtn: "下载 v0.7.3",
},
hero: {
badge: "v0.7.2 · 开源 MIT · Windows / macOS / Linux",
badge: "v0.7.3 · 开源 MIT · Windows / macOS / Linux",
titleBefore: "统一管理你的",
titleAccent: "AI 供应商",
titleAfter: "",
@@ -140,12 +140,25 @@ 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 一键脚本,自动清除下载隔离,免去手动右键打开",
@@ -289,7 +302,7 @@ const zh = {
},
download: {
title: "下载 Kimi Switch",
subtitle: "当前版本 v0.7.2 · Windows / macOS / Linux 三平台已发布",
subtitle: "当前版本 v0.7.3 · Windows / macOS / Linux 三平台已发布",
autoUpdate: "应用内置自动检测更新,新版本发布后在设置页一键升级。",
ready: "已发布",
wip: "开发中",
@@ -357,10 +370,10 @@ const en: Dict = {
performance: "Performance",
changelog: "Changelog",
download: "Download",
downloadBtn: "Download v0.7.2",
downloadBtn: "Download v0.7.3",
},
hero: {
badge: "v0.7.2 · 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: "",
@@ -481,12 +494,25 @@ 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",
@@ -629,7 +655,7 @@ const en: Dict = {
},
download: {
title: "Download Kimi Switch",
subtitle: "Current version v0.7.2 · 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",
+7 -7
View File
@@ -8,27 +8,27 @@ const icons: Record<string, Icon> = {
linux: LinuxLogo,
};
const VERSION = "0.7.2";
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. NOTE: tauri-bundler keeps the productName verbatim, so the
* real asset is "Kimi Switch_0.7.2_…" (space), URL-encoded as %20. */
* 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%20Switch_0.7.2_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%20Switch_0.7.2_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%20Switch_0.7.2_amd64.deb") },
{ label: ".AppImage", href: dl("Kimi%20Switch_0.7.2_amd64.AppImage") },
{ label: ".rpm", href: dl("Kimi%20Switch-0.7.2-1.x86_64.rpm") },
{ label: ".deb", href: dl("Kimi%20Switch_0.7.3_amd64.deb") },
{ label: ".AppImage", href: dl("Kimi%20Switch_0.7.3_amd64.AppImage") },
{ label: ".rpm", href: dl("Kimi%20Switch-0.7.3-1.x86_64.rpm") },
],
};