feat: webfetch

feat: implement web cache for persisting and serving fetched content
- Introduced a new `WebCache` module to manage web content caching. - Added functionality to store fetched content and serve it via a dedicated route. - Integrated web cache into the search module for improved content retrieval. - Implemented database migration management with detailed diagnostics for better error handling during startup. - Updated the SQLite store to utilize the new migration system for enhanced database management.
2026-10-04 02:52:55 +08:00 · 2026-08-30 11:54:32 +08:00 · 2026-08-30 04:29:39 +08:00 · 2026-08-30 03:19:01 +08:00 · 2026-08-30 01:33:39 +08:00 · 2026-08-29 22:05:04 +08:00
688 changed files with 71945 additions and 62206 deletions
@@ -0,0 +1,101 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+
+function readOptions(args) {
+  const options = new Map();
+  for (let index = 0; index < args.length; index += 2) {
+    const name = args[index];
+    const value = args[index + 1];
+    if (!name?.startsWith("--") || value === undefined) {
+      throw new Error(`invalid argument near ${name ?? "end of command"}`);
+    }
+    options.set(name.slice(2), value);
+  }
+  return options;
+}
+
+function required(options, name) {
+  const value = options.get(name)?.trim();
+  if (!value) throw new Error(`--${name} is required`);
+  return value;
+}
+
+export function normalizeTauriUpdate(manifest, release, repository, version) {
+  if (manifest.version !== version) {
+    throw new Error(
+      `updater manifest version ${manifest.version ?? "is missing"}; expected ${version}`,
+    );
+  }
+  if (release.tag_name !== `v${version}`) {
+    throw new Error(
+      `GitHub release tag ${release.tag_name ?? "is missing"}; expected v${version}`,
+    );
+  }
+  if (!manifest.platforms || typeof manifest.platforms !== "object") {
+    throw new Error("updater manifest has no platforms");
+  }
+
+  const assetsBySourceUrl = new Map();
+  const publicAssetUrls = new Set();
+  for (const asset of release.assets ?? []) {
+    if (!asset?.id || !asset?.name) continue;
+    const publicUrl = `https://github.com/${repository}/releases/download/v${version}/${encodeURIComponent(asset.name)}`;
+    assetsBySourceUrl.set(
+      `https://api.github.com/repos/${repository}/releases/assets/${asset.id}`,
+      publicUrl,
+    );
+    if (asset.browser_download_url) {
+      assetsBySourceUrl.set(asset.browser_download_url, publicUrl);
+    }
+    publicAssetUrls.add(publicUrl);
+  }
+
+  for (const [platform, entry] of Object.entries(manifest.platforms)) {
+    if (!entry?.signature || !entry?.url) {
+      throw new Error(`updater platform ${platform} is missing its URL or signature`);
+    }
+    const publicUrl = assetsBySourceUrl.get(entry.url) ?? entry.url;
+    if (!publicAssetUrls.has(publicUrl)) {
+      throw new Error(`updater platform ${platform} references an unknown release asset`);
+    }
+    entry.url = publicUrl;
+  }
+
+  return manifest;
+}
+
+async function main() {
+  const options = readOptions(process.argv.slice(2));
+  const manifestPath = resolve(required(options, "manifest"));
+  const releasePath = resolve(required(options, "release"));
+  const repository = required(options, "repository");
+  const version = required(options, "version").replace(/^v/, "");
+
+  if (!/^[^/\s]+\/[^/\s]+$/.test(repository)) {
+    throw new Error(`invalid GitHub repository: ${repository}`);
+  }
+  if (!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(version)) {
+    throw new Error(`invalid semantic version: ${version}`);
+  }
+
+  const manifest = JSON.parse(await readFile(manifestPath, "utf8"));
+  const release = JSON.parse(await readFile(releasePath, "utf8"));
+  const normalized = normalizeTauriUpdate(
+    manifest,
+    release,
+    repository,
+    version,
+  );
+  await writeFile(manifestPath, `${JSON.stringify(normalized, null, 2)}\n`);
+}
+
+if (
+  process.argv[1] &&
+  import.meta.url === pathToFileURL(resolve(process.argv[1])).href
+) {
+  main().catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+  });
+}
@@ -206,13 +206,43 @@ jobs:
        env:
          VERSION: ${{ needs.prepare.outputs.version }}
        run: |
-          node scripts/release/generate-legacy-update.mjs \
+          node .github/scripts/generate-legacy-update.mjs \
            --version "${VERSION}" \
            --repository "${GITHUB_REPOSITORY}" \
            --assets-dir legacy-update \
            --output legacy-update/update.json \
            --notes "Cursor BYOK v${VERSION}"

+      - name: Normalize Tauri updater download URLs
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          VERSION: ${{ needs.prepare.outputs.version }}
+        run: |
+          mkdir -p tauri-update
+          release_id=$(
+            gh api "repos/${GITHUB_REPOSITORY}/releases?per_page=100" \
+              --jq ".[] | select(.tag_name == \"v${VERSION}\") | .id"
+          )
+          test -n "${release_id}"
+          gh api "repos/${GITHUB_REPOSITORY}/releases/${release_id}" > tauri-update/release.json
+          asset_id=$(node -p 'require("./tauri-update/release.json").assets.find(({ name }) => name === "latest.json")?.id ?? ""')
+          test -n "${asset_id}"
+          gh api \
+            -H "Accept: application/octet-stream" \
+            "repos/${GITHUB_REPOSITORY}/releases/assets/${asset_id}" \
+            > tauri-update/latest.json
+          node .github/scripts/normalize-tauri-update.mjs \
+            --manifest tauri-update/latest.json \
+            --release tauri-update/release.json \
+            --repository "${GITHUB_REPOSITORY}" \
+            --version "${VERSION}"
+
+      - name: Upload normalized Tauri updater manifest
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          VERSION: ${{ needs.prepare.outputs.version }}
+        run: gh release upload "v${VERSION}" tauri-update/latest.json --clobber
+
      - name: Upload legacy updater assets
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -7,3 +7,19 @@
 - Prefer established, well-maintained libraries when they reduce overall complexity or improve reliability. Do not reimplement common functionality without a clear reason.
 - Lean on the dependencies already in the project before writing your own implementation or adding packages. Do not assume a library lacks a capability without checking its documentation and types.
 - Make architectural decisions for the long term. Do not accept a stopgap that only works for now and is meant to be replaced later.
+
+## Communication
+
+- Lead with the conclusion. Keep responses direct and omit filler, repeated context, generic explanations, and narration of obvious steps.
+- Match the level requested by the user: discuss architecture as architecture, behavior as behavior, and code details only when they materially support the answer.
+- For architecture, refactoring, and module-boundary discussions, communicate primarily with annotated directory trees and ASCII architecture/data-flow diagrams instead of long prose.
+- In directory trees, annotate every relevant directory and file with its single responsibility. When discussing code size, include line counts in the comments:
+  - use measured line counts for existing code;
+  - use clearly marked approximate targets such as `≈300 lines` for proposed code;
+  - state whether tests, generated code, and blank lines are excluded.
+- Show the complete main execution path, including inputs, ownership boundaries, runtime loops, persistence, outputs, and extension points. Make the direction of data and control flow explicit.
+- Clearly separate the current structure from the proposed structure. Explicitly list modules that move, merge, split, or are deleted.
+- Use the user's vocabulary consistently. Do not introduce new domain terms when existing plain-language terms are sufficient; when an implementation name must be mentioned, distinguish it from the architecture concept.
+- For stateful or concurrent behavior, show timing, ownership, state boundaries, and before/during/after behavior explicitly. Distinguish continuation within the same lifecycle from creation of a new lifecycle.
+- Prefer compact trees, flow diagrams, state matrices, and mappings when they communicate the structure more clearly than paragraphs.
+- Tie recommendations to the actual repository structure and code. Do not present a speculative target architecture as if it already exists.
@@ -97,6 +97,28 @@ dependencies = [
 "x11rb",
 ]

+[[package]]
+name = "ashpd"
+version = "0.11.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d2f3f79755c74fd155000314eb349864caa787c6592eace6c6882dad873d9c39"
+dependencies = [
+ "async-fs",
+ "async-net",
+ "enumflags2",
+ "futures-channel",
+ "futures-util",
+ "rand 0.9.5",
+ "raw-window-handle",
+ "serde",
+ "serde_repr",
+ "url",
+ "wayland-backend",
+ "wayland-client",
+ "wayland-protocols",
+ "zbus",
+]
+
 [[package]]
 name = "asn1-rs"
 version = "0.7.2"
@@ -186,6 +208,17 @@ dependencies = [
 "slab",
 ]

+[[package]]
+name = "async-fs"
+version = "2.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8034a681df4aed8b8edbd7fbe472401ecf009251c8b40556b304567052e294c5"
+dependencies = [
+ "async-lock",
+ "blocking",
+ "futures-lite",
+]
+
 [[package]]
 name = "async-io"
 version = "2.6.0"
@@ -215,6 +248,17 @@ dependencies = [
 "pin-project-lite",
 ]

+[[package]]
+name = "async-net"
+version = "2.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b948000fad4873c1c9339d60f2623323a0cfd3816e5181033c6a5cb68b2accf7"
+dependencies = [
+ "async-io",
+ "blocking",
+ "futures-lite",
+]
+
 [[package]]
 name = "async-process"
 version = "2.5.0"
@@ -926,7 +970,7 @@ dependencies = [
 "bitflags 2.13.1",
 "core-foundation 0.10.1",
 "core-graphics-types",
- "foreign-types",
+ "foreign-types 0.5.0",
 "libc",
 ]

@@ -1128,10 +1172,11 @@ checksum = "52560adf09603e58c9a7ee1fe1dcb95a16927b17c127f0ac02d6e768a0e25bc1"

 [[package]]
 name = "cursor-byok-desktop"
-version = "0.1.2"
+version = "0.1.5-beta.1"
 dependencies = [
 "axum",
 "cursor-server",
+ "rfd",
 "serde",
 "serde_json",
 "tauri",
@@ -1145,6 +1190,7 @@ dependencies = [
 "tokio",
 "tokio-util",
 "tracing",
+ "tracing-appender",
 "tracing-subscriber",
 "url",
 ]
@@ -1520,6 +1566,15 @@ dependencies = [
 "syn 3.0.3",
 ]

+[[package]]
+name = "dlib"
+version = "0.5.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ab8ecd87370524b461f8557c119c405552c396ed91fc0a8eec68679eab26f94a"
+dependencies = [
+ "libloading",
+]
+
 [[package]]
 name = "dlopen2"
 version = "0.8.2"
@@ -1905,6 +1960,15 @@ version = "0.2.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "77ce24cb58228fbb8aa041425bb1050850ac19177686ea6e0f41a70416f56fdb"

+[[package]]
+name = "foreign-types"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f6f339eb8adc052cd2ca78910fda869aefa38d22d5cb648e6485e4d3fc06f3b1"
+dependencies = [
+ "foreign-types-shared 0.1.1",
+]
+
 [[package]]
 name = "foreign-types"
 version = "0.5.0"
@@ -1912,7 +1976,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "d737d9aa519fb7b749cbc3b962edcf310a8dd1f4b67c91c4f83975dbdd17d965"
 dependencies = [
 "foreign-types-macros",
- "foreign-types-shared",
+ "foreign-types-shared 0.3.1",
 ]

 [[package]]
@@ -1926,6 +1990,12 @@ dependencies = [
 "syn 3.0.3",
 ]

+[[package]]
+name = "foreign-types-shared"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "00b0228411908ca8685dba7fc2cdd70ec9990a6e753e89b6ac91a84c40fbaf4b"
+
 [[package]]
 name = "foreign-types-shared"
 version = "0.3.1"
@@ -2727,6 +2797,22 @@ dependencies = [
 "webpki-roots 1.0.9",
 ]

+[[package]]
+name = "hyper-tls"
+version = "0.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "70206fc6890eaca9fde8a0bf71caa2ddfc9fe045ac9e5c70df101a7dbde866e0"
+dependencies = [
+ "bytes",
+ "http-body-util",
+ "hyper",
+ "hyper-util",
+ "native-tls",
+ "tokio",
+ "tokio-native-tls",
+ "tower-service",
+]
+
 [[package]]
 name = "hyper-tungstenite"
 version = "0.30.0"
@@ -3640,6 +3726,23 @@ version = "0.10.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "1d87ecb2933e8aeadb3e3a02b828fed80a7528047e68b4f424523a0981a3a084"

+[[package]]
+name = "native-tls"
+version = "0.2.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "465500e14ea162429d264d44189adc38b199b62b1c21eea9f69e4b73cb03bbf2"
+dependencies = [
+ "libc",
+ "log",
+ "openssl",
+ "openssl-probe",
+ "openssl-sys",
+ "schannel",
+ "security-framework",
+ "security-framework-sys",
+ "tempfile",
+]
+
 [[package]]
 name = "ndk"
 version = "0.9.0"
@@ -4038,12 +4141,49 @@ dependencies = [
 "libc",
 ]

+[[package]]
+name = "openssl"
+version = "0.10.81"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "77823a27f0babb03091cb9ed9ef80af3b39dbc82f97e8fa530374b7dafd87a45"
+dependencies = [
+ "bitflags 2.13.1",
+ "cfg-if",
+ "foreign-types 0.3.2",
+ "libc",
+ "openssl-macros",
+ "openssl-sys",
+]
+
+[[package]]
+name = "openssl-macros"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a948666b637a0f465e8564c73e89d4dde00d72d4d473cc972f390fc3dcee7d9c"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.119",
+]
+
 [[package]]
 name = "openssl-probe"
 version = "0.2.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "7c87def4c32ab89d880effc9e097653c8da5d6ef28e6b539d313baaacfbafcbe"

+[[package]]
+name = "openssl-sys"
+version = "0.9.117"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b47e7e6bb2c38cd930d25a23b40fa52e068c10e85f3e03a7f5ba5aaca5713695"
+dependencies = [
+ "cc",
+ "libc",
+ "pkg-config",
+ "vcpkg",
+]
+
 [[package]]
 name = "option-ext"
 version = "0.2.0"
@@ -4470,6 +4610,12 @@ dependencies = [
 "windows-sys 0.61.2",
 ]

+[[package]]
+name = "pollster"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2f3a9f18d041e6d0e102a0a46750538147e5e8992d3b4873aaafee2520b00ce3"
+
 [[package]]
 name = "portable-atomic"
 version = "1.15.0"
@@ -5043,9 +5189,11 @@ dependencies = [
 "http-body-util",
 "hyper",
 "hyper-rustls",
+ "hyper-tls",
 "hyper-util",
 "js-sys",
 "log",
+ "native-tls",
 "percent-encoding",
 "pin-project-lite",
 "quinn",
@@ -5056,6 +5204,7 @@ dependencies = [
 "serde_urlencoded",
 "sync_wrapper",
 "tokio",
+ "tokio-native-tls",
 "tokio-rustls",
 "tokio-util",
 "tower",
@@ -5108,6 +5257,30 @@ dependencies = [
 "web-sys",
 ]

+[[package]]
+name = "rfd"
+version = "0.15.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ef2bee61e6cffa4635c72d7d81a84294e28f0930db0ddcb0f66d10244674ebed"
+dependencies = [
+ "ashpd",
+ "block2",
+ "dispatch2",
+ "js-sys",
+ "log",
+ "objc2",
+ "objc2-app-kit",
+ "objc2-core-foundation",
+ "objc2-foundation",
+ "pollster",
+ "raw-window-handle",
+ "urlencoding",
+ "wasm-bindgen",
+ "wasm-bindgen-futures",
+ "web-sys",
+ "windows-sys 0.59.0",
+]
+
 [[package]]
 name = "ring"
 version = "0.17.14"
@@ -6201,6 +6374,12 @@ dependencies = [
 "serde_json",
 ]

+[[package]]
+name = "symlink"
+version = "0.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a7973cce6668464ea31f176d85b13c7ab3bba2cb3b77a2ed26abd7801688010a"
+
 [[package]]
 name = "syn"
 version = "1.0.109"
@@ -6924,6 +7103,16 @@ dependencies = [
 "syn 3.0.3",
 ]

+[[package]]
+name = "tokio-native-tls"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bbae76ab933c85776efabc971569dd6119c580d8f5d448769dec1764bf796ef2"
+dependencies = [
+ "native-tls",
+ "tokio",
+]
+
 [[package]]
 name = "tokio-rustls"
 version = "0.26.4"
@@ -7164,6 +7353,19 @@ dependencies = [
 "tracing-core",
 ]

+[[package]]
+name = "tracing-appender"
+version = "0.2.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "050686193eb999b4bb3bc2acfa891a13da00f79734704c4b8b4ef1a10b368a3c"
+dependencies = [
+ "crossbeam-channel",
+ "symlink",
+ "thiserror 2.0.20",
+ "time",
+ "tracing-subscriber",
+]
+
 [[package]]
 name = "tracing-attributes"
 version = "0.1.31"
@@ -7538,6 +7740,12 @@ dependencies = [
 "serde_derive",
 ]

+[[package]]
+name = "urlencoding"
+version = "2.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "daf8dba3b7eb870caf1ddeed7bc9d2a049f3cfdfae7cb521b087cc33ae4c49da"
+
 [[package]]
 name = "urlpattern"
 version = "0.3.0"
@@ -7754,6 +7962,7 @@ dependencies = [
 "cc",
 "downcast-rs",
 "rustix",
+ "scoped-tls",
 "smallvec",
 "wayland-sys",
 ]
@@ -7812,6 +8021,8 @@ version = "0.31.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "d8eab23fefc9e41f8e841df4a9c707e8a8c4ed26e944ef69297184de2785e3be"
 dependencies = [
+ "dlib",
+ "log",
 "pkg-config",
 ]

@@ -8930,6 +9141,7 @@ dependencies = [
 "endi",
 "enumflags2",
 "serde",
+ "url",
 "winnow 1.0.4",
 "zcheapstr",
 "zvariant_derive",
@@ -3,7 +3,7 @@ members = [
    "server",
    "apps/desktop/src-tauri",
    "crates/semble-core",
-    "benchmarks/semble",
+    "support/benchmarks/semble",
 ]
 resolver = "2"

@@ -20,7 +20,7 @@ COPY apps/desktop/src-tauri/src/ apps/desktop/src-tauri/src/
 COPY apps/desktop/src-tauri/capabilities/ apps/desktop/src-tauri/capabilities/
 COPY apps/desktop/src-tauri/icons/ apps/desktop/src-tauri/icons/
 COPY apps/desktop/src-tauri/tauri.conf.json apps/desktop/src-tauri/tauri.conf.json
-COPY scripts/cursor-proto/proto/ scripts/cursor-proto/proto/
+COPY protocols/cursor/ protocols/cursor/
 RUN --mount=type=cache,target=/usr/local/cargo/registry \
    --mount=type=cache,target=/usr/local/cargo/git \
    --mount=type=cache,target=/src/target \
@@ -1,16 +1,20 @@
 LOCAL_TAURI_SIGNING_KEY := $(CURDIR)/.tauri/cursor-byok.local.key

-.PHONY: check dev-web dev-server dev-desktop build-web build-server build-desktop build-docker
+.PHONY: check dev-web dev-docs dev-server dev-desktop build-web build-docs build-server build-desktop build-docker

 check:
 	cargo fmt --all -- --check
 	cargo clippy --workspace --all-targets -- -D warnings
 	cargo test --workspace --all-targets
 	npm --prefix apps/desktop run check
+	npm --prefix apps/docs run check

 dev-web:
 	npm --prefix apps/desktop run dev:web

+dev-docs:
+	npm --prefix apps/docs run dev
+
 dev-server:
 	CURSOR_CONSOLE_DIR=apps/desktop/dist cargo run --package cursor-server --bin cursor-server

@@ -20,9 +24,19 @@ dev-desktop:
 build-web:
 	npm --prefix apps/desktop run build

+build-docs:
+	npm --prefix apps/docs run build
+
 build-server:
 	cargo build --release --package cursor-server --bin cursor-server

+ifeq ($(OS),Windows_NT)
+$(LOCAL_TAURI_SIGNING_KEY):
+	@powershell -NoProfile -Command "New-Item -ItemType Directory -Force -Path '$(dir $@)' | Out-Null; & '$(CURDIR)/apps/desktop/node_modules/.bin/tauri.cmd' signer generate --ci --write-keys '$@'"
+
+build-desktop: $(LOCAL_TAURI_SIGNING_KEY)
+	@node -e "const { spawnSync } = require('node:child_process'); const result = spawnSync(process.execPath, ['node_modules/@tauri-apps/cli/tauri.js', 'build', '--bundles', 'nsis'], { cwd: 'apps/desktop', stdio: 'inherit', env: { ...process.env, TAURI_SIGNING_PRIVATE_KEY: process.argv[1], TAURI_SIGNING_PRIVATE_KEY_PASSWORD: '' } }); process.exit(result.status ?? 1)" "$(LOCAL_TAURI_SIGNING_KEY)"
+else
 $(LOCAL_TAURI_SIGNING_KEY):
 	@install -d -m 700 "$(dir $@)"
 	@apps/desktop/node_modules/.bin/tauri signer generate --ci --write-keys "$@" >/dev/null
@@ -30,6 +44,7 @@ $(LOCAL_TAURI_SIGNING_KEY):

 build-desktop: $(LOCAL_TAURI_SIGNING_KEY)
 	TAURI_SIGNING_PRIVATE_KEY="$(LOCAL_TAURI_SIGNING_KEY)" TAURI_SIGNING_PRIVATE_KEY_PASSWORD="" npm --prefix apps/desktop run tauri:build
+endif

 build-docker:
 	docker build --tag cursor-byok:local .
@@ -0,0 +1,236 @@
+<div align="center">
+
+# cursor-byok
+
+cursor-byok 是一个运行在本机的 Cursor 模型网关，帮助你在 Cursor 中使用自己配置的模型服务。
+
+[English README](./README.md) · [使用指南](https://docs.leokun.cn) · [下载](https://github.com/leookun/cursor-byok/releases/latest) · [提交问题](https://github.com/leookun/cursor-byok/issues)
+
+[![Release](https://img.shields.io/github/v/release/leookun/cursor-byok?style=flat-square)](https://github.com/leookun/cursor-byok/releases/latest)
+[![Downloads](https://img.shields.io/github/downloads/leookun/cursor-byok/total?style=flat-square)](https://github.com/leookun/cursor-byok/releases)
+[![License](https://img.shields.io/github/license/leookun/cursor-byok?style=flat-square)](./LICENSE)
+[![Platforms](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-lightgrey?style=flat-square)](https://github.com/leookun/cursor-byok/releases/latest)
+
+</div>
+
+![将 cursor-byok 连接到多种模型 API](./images/en-brand-1.png)
+
+![cursor-byok 控制面板](./images/en-home-1.png)
+
+## 项目简介
+
+cursor-byok 是一个开源的本地模型网关。它在你的设备上运行服务，接收 Cursor 发出的 Agent 请求，将请求转发到你配置的模型服务，并尽可能保留 Cursor Agent 的工具调用、Skills、MCP 和多轮对话能力。
+
+你可以连接兼容 OpenAI 或 Anthropic 协议的服务，自定义服务地址、模型 ID、API Key 和请求参数，也可以使用 Cursor 平台默认选项之外的模型通道。
+
+> [!IMPORTANT]
+> cursor-byok 免费且开源，但你连接的模型服务商可能会按用量收费。本项目是独立项目，与 Cursor 或其开发者没有关联，也未获得其认可。
+
+## 主要功能
+
+- **自定义模型通道**：配置自己的 API 地址、凭据和模型 ID。
+- **多种 API 协议**：支持 OpenAI Responses API、OpenAI Chat Completions API 和 Anthropic Messages API 兼容服务。
+- **模型管理**：添加、复制、编辑、排序模型配置，并批量测试连接。
+- **连接性能测试**：查看首字延迟、生成速度、总耗时和原始服务商响应。
+- **Agent 工作流**：继续使用工具调用、Skills、MCP 和多轮对话。
+- **会话指标**：查看 Token 用量、缓存命中率、对话轮次和估算价值。
+- **TAB 补全服务**：在公益服务、官方直连和自定义服务之间选择连接方式。
+- **跨平台运行**：支持 macOS、Windows 和 Linux。
+
+## 快速开始
+
+1. 从 [GitHub Releases](https://github.com/leookun/cursor-byok/releases/latest) 下载适合你操作系统的最新版本。
+2. 启动 cursor-byok，打开 **Cursor 配置**，按提示初始化本地 CA（证书颁发机构）。
+3. 在模型设置中添加模型，填写服务地址、API Key 和模型名称，然后保存并运行 **测试**。
+4. 确认测试通过后，保持 cursor-byok 运行。
+5. **首次升级 Cursor 或首次配置模型后，完全退出并重新启动 Cursor，然后新开一个对话**。在模型列表中选择已配置的模型，开始使用 Agent。
+
+完整的安装步骤、配置说明和常见问题，请参阅[中文使用指南](https://docs.leokun.cn/zh/docs)。
+
+> [!TIP]
+> 首次升级 Cursor 或首次完成配置后，必须完全退出并重新启动 Cursor，再新开一个对话。配置前已经打开的对话不会加载新连接；使用自定义模型时，请在模型列表中手动选择该模型，不要选择 **Auto**。
+
+## 模型配置
+
+每个模型配置都是独立的上游通道，可以单独设置服务商、协议、凭据和生成参数。
+
+![模型设置页面](./images/en-model-1.png)
+
+### 类型与协议选择
+
+| 模型系列 | 模型类型 | 请求协议 |
+| --- | --- | --- |
+| Claude 系列 | **Anthropic** | Messages API |
+| GPT / OpenAI 系列 | **OpenAI** | **Responses API** |
+| 其他模型 | **OpenAI** | **Chat Completions API** |
+
+GPT 系列建议使用 **Responses API**。如果使用 Chat Completions，可能无法保留提示词缓存，导致速度变慢和费用增加。
+
+### 常用字段
+
+- **模型类型**：选择 OpenAI 或 Anthropic，决定上游接口格式。
+- **请求协议**：OpenAI 类型需要继续选择 Responses API 或 Chat Completions API。
+- **服务器地址**：可以填写服务商基础地址，让应用按协议追加标准端点，也可以填写完整请求 URL 并原样使用。
+- **API Key**：填写上游服务要求的访问密钥。密钥保存在本机，用于发送模型请求。
+- **模型名称**：填写服务商接口接受的模型标识，也可以使用 **获取模型** 读取服务商返回的模型列表。
+- **显示名称**：Cursor 模型列表中显示的名称，不会改变发送给上游的模型标识。
+- **备注**：显示在 Cursor 的模型说明中。
+
+还可以根据模型能力设置上下文窗口 Token、最大输出 Token、推理或思考强度、自定义 Headers，以及 OpenAI 或 Anthropic 的额外参数。自定义 Headers 和额外参数必须是 JSON 对象，只应填写服务商明确支持的字段。
+
+保存配置后运行 **测试**，确认地址、协议、API Key、模型标识和流式响应都正常，再在 Cursor 中使用该模型。
+
+## TAB 补全服务
+
+Cursor 的 Tab 补全由独立的 TAB 服务处理，不经过模型通道。你可以在 **系统设置 → TAB 设置** 中选择以下模式：
+
+- **使用公益服务（默认）**：使用项目作者部署的公共服务，无需额外配置。
+- **直连**：直接连接当前 Cursor 账号对应的官方 TAB 服务，适合账号拥有官方额度的情况。
+- **自定义**：自行部署 [`cursor-tab-server`](https://github.com/leookun/cursor-byok/tree/archive/v0.0.49/cursor-tab-server)，然后填写 TAB 服务地址。
+
+修改 TAB 设置后，建议重启 Cursor 并新开一个对话，确保新的连接方式生效。
+
+## 与官方账号并存
+
+新版设计支持 cursor-byok 与 Cursor 官方服务并存：
+
+- 直接在 Cursor 中登录自己的账号。如果之前使用旧版生成的 fake 账户，请先退出该账户，再登录自己的账号。
+- 账号拥有官方额度时，官方模型和本地模型可以随时切换混用。
+- **Auto 只使用官方模型**，不会自动使用你配置的本地模型。账号没有官方额度时，请手动选择自己配置的模型。
+- 插件、代码库索引等 Cursor 功能可以继续使用。
+
+## 数据流转
+
+```text
+Cursor 客户端
+    │
+    │ Agent 请求与工具结果
+    ▼
+cursor-byok 本地服务
+    │
+    │ OpenAI / Anthropic 兼容请求
+    ▼
+你配置的模型 API
+```
+
+API Key、模型配置和应用设置保存在本机。模型请求仍会发送到你选择的上游服务商，请根据对应服务商的隐私政策和计费规则使用。
+
+## 项目结构
+
+```text
+cursor-byok/
+├── apps/
+│   ├── desktop/
+│   │   ├── src/
+│   │   │   ├── features/ # 首页、模型、调用记录与设置
+│   │   │   ├── shell/    # 窗口框架、页面布局与广告外壳
+│   │   │   ├── shared/   # UI、虚拟列表、状态、API 与平台能力
+│   │   │   ├── i18n/     # 本地化运行时与语言目录
+│   │   │   └── styles/   # 全局主题与排版令牌
+│   │   └── src-tauri/    # Tauri 桌面生命周期
+│   └── docs/          # Next.js 与 Fumadocs 中文/英文文档站
+├── server/
+│   ├── src/
+│   │   ├── cursor/    # Cursor 协议适配
+│   │   ├── run/       # 通用 Agent Runtime 与内部 Port
+│   │   ├── provider/  # 模型供应商适配
+│   │   ├── model/     # 聚合领域模型
+│   │   ├── store/     # SQLite Repository
+│   │   ├── control/   # 管理面 API
+│   │   ├── harness/   # Cursor 本地集成
+│   │   └── search/    # Web 与 Semble 搜索接入
+│   ├── prompt/
+│   └── migrations/
+├── crates/
+│   └── semble-core/   # 本地代码索引与搜索核心库
+├── protocols/
+│   └── cursor/        # Cursor 协议定义的唯一来源
+├── support/                     # 仓库辅助设施
+│   ├── cursor-protocol-extractor/ # Cursor 协议提取与 Go 代码生成工具
+│   ├── cursor-capture/            # Cursor 协议抓取和调试工具
+│   └── benchmarks/                # 代码搜索和索引基准测试
+├── images/            # README 展示图片
+├── Cargo.toml         # Rust 工作区配置
+└── Makefile           # 常用开发、检查和构建命令
+```
+
+## 本地开发
+
+### 环境要求
+
+- Rust 工具链和 Cargo
+- Node.js 与 npm
+- Tauri 2 的系统构建依赖
+- Docker（仅在构建 Docker 镜像时需要）
+
+### 安装依赖
+
+```bash
+npm --prefix apps/desktop install
+npm --prefix apps/docs install
+```
+
+### 启动开发环境
+
+启动桌面前端：
+
+```bash
+make dev-web
+```
+
+启动桌面应用：
+
+```bash
+make dev-desktop
+```
+
+启动文档站：
+
+```bash
+make dev-docs
+```
+
+文档站默认地址为 <http://localhost:3000>。
+
+### 检查与构建
+
+运行完整检查：
+
+```bash
+make check
+```
+
+分别构建各部分：
+
+```bash
+make build-web       # 构建桌面前端
+make build-server    # 构建 Rust 本地服务
+make build-docs      # 构建文档站
+make build-desktop   # 构建 Tauri 桌面安装包
+make build-docker    # 构建 Docker 镜像
+```
+
+文档内容位于 `apps/docs/content/docs` 和 `apps/docs/content/blog`。修改文档侧边栏时同步更新 `apps/docs/content/docs/meta.json`。
+
+## 路线图
+
+项目将继续改进模型兼容性、Agent 工具、本地运行稳定性和自托管体验，并探索支持更多 IDE、聊天和 Agent 工作流。
+
+计划与进展请参阅[发布路线图](https://github.com/leookun/cursor-byok/discussions/32)。
+
+## 社区与反馈
+
+- [中文使用指南](https://docs.leokun.cn/zh/docs)
+- [GitHub Issues](https://github.com/leookun/cursor-byok/issues)
+- [Telegram 社区](https://t.me/cursor_byok)
+- QQ 群：`1095916242`、`1094411438`、`1095918002`、`1094419321`
+
+提交问题时，请附上操作系统、cursor-byok 版本、模型类型、请求协议、已脱敏的服务地址、错误信息和复现步骤。请勿公开 API Key 或其他凭据。
+
+## 参与贡献
+
+欢迎提交 Issue 和 Pull Request。提交代码前请先阅读项目中的开发说明，并运行 `make check` 确认格式、测试和前端构建检查通过。
+
+## 许可证
+
+本项目采用 [MIT License](./LICENSE) 开源。
@@ -17,9 +17,9 @@ cursor-byok is a local implementation of Cursor's backend.

 </div>

-![Connect cursor-byok to a wide range of model APIs](./images/en-brand.png)
+![Connect cursor-byok to a wide range of model APIs](./images/en-brand-1.png)

-![cursor-byok dashboard](./images/en-home.png)
+![cursor-byok dashboard](./images/en-home-1.png)

 ## About

@@ -45,15 +45,16 @@ You can connect OpenAI- and Anthropic-compatible services, customize endpoints,
 1. Download the latest build for your platform from [GitHub Releases](https://github.com/leookun/cursor-byok/releases/latest).
 2. Launch cursor-byok, open **Model Settings**, and enter the endpoint, API key, and model ID.
 3. Test the model configuration. Once it passes, return to the dashboard and start the service.
-4. Open Cursor, select the configured model, and start using Agent.
+4. Test the model configuration. Once it passes, return to the dashboard and start the service.
+5. After upgrading Cursor or configuring a model for the first time, quit Cursor completely and restart it, then start a new conversation and select the configured model.

-For complete installation steps, system configuration, and troubleshooting, see the [User Guide](https://docs.leokun.cn).
+For complete installation steps, system configuration, and Frequently Asked Questions, see the [User Guide](https://docs.leokun.cn).

 ## Model Management

 Model configurations support both OpenAI and Anthropic API protocols. Each model channel can independently define its context window, maximum output tokens, reasoning effort, custom headers, and additional request parameters.

-![cursor-byok model settings](./images/en-model.png)
+![cursor-byok model settings](./images/en-model-1.png)

 ## How It Works

@@ -0,0 +1,33 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <style>
+      html,
+      body,
+      #root {
+        width: 100%;
+        height: 100%;
+        margin: 0;
+        background: var(--boot-bg, #141414);
+      }
+    </style>
+    <script>
+      // 在应用样式加载前按主题参数铺底色，避免切换 poster 时闪出错误颜色
+      (function () {
+        var light = new URLSearchParams(location.search).get("theme") === "default-light";
+        document.documentElement.style.setProperty("--boot-bg", light ? "#f5f5f5" : "#141414");
+        var meta = document.createElement("meta");
+        meta.name = "theme-color";
+        meta.content = light ? "#f5f5f5" : "#141414";
+        document.head.appendChild(meta);
+      })();
+    </script>
+    <title>Cursor BYOK 产品演示</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script src="/src/demo/index.tsx" type="module"></script>
+  </body>
+</html>
@@ -1,12 +1,12 @@
 {
  "name": "cursor-byok-desktop",
-  "version": "0.1.2",
+  "version": "0.1.5-beta.1",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "cursor-byok-desktop",
-      "version": "0.1.2",
+      "version": "0.1.5-beta.1",
      "license": "MIT",
      "dependencies": {
        "@floating-ui/dom": "^1.8.0",
@@ -18,13 +18,11 @@
        "@tauri-apps/plugin-opener": "^2.5.4",
        "@tauri-apps/plugin-process": "^2.3.1",
        "@tauri-apps/plugin-updater": "^2.10.1",
-        "chart.js": "^4.5.1",
        "echarts": "^6.1.0",
        "keepalive-for-react": "^5.0.11",
        "keepalive-for-react-router": "^5.0.7",
        "monaco-editor": "0.56.0",
        "react": "^19.2.8",
-        "react-chartjs-2": "^5.3.1",
        "react-dom": "^19.2.8",
        "react-router-dom": "^7.18.2",
        "sortablejs": "^1.15.7",
@@ -427,12 +425,6 @@
        "@jridgewell/sourcemap-codec": "^1.4.14"
      }
    },
-    "node_modules/@kurkle/color": {
-      "version": "0.3.4",
-      "resolved": "https://registry.npmjs.org/@kurkle/color/-/color-0.3.4.tgz",
-      "integrity": "sha512-M5UknZPHRu3DEDWoipU6sE8PdkZ6Z/S+v4dD+Ke8IaNlpdSQah50lz1KtcFBa2vsdOnwbbnxJwVM4wty6udA5w==",
-      "license": "MIT"
-    },
    "node_modules/@oxc-project/types": {
      "version": "0.142.0",
      "resolved": "https://registry.npmjs.org/@oxc-project/types/-/types-0.142.0.tgz",
@@ -1817,18 +1809,6 @@
        "node": ">=8"
      }
    },
-    "node_modules/chart.js": {
-      "version": "4.5.1",
-      "resolved": "https://registry.npmjs.org/chart.js/-/chart.js-4.5.1.tgz",
-      "integrity": "sha512-GIjfiT9dbmHRiYi6Nl2yFCq7kkwdkp1W/lp2J99rX0yo9tgJGn3lKQATztIjb5tVtevcBtIdICNWqlq5+E8/Pw==",
-      "license": "MIT",
-      "dependencies": {
-        "@kurkle/color": "^0.3.0"
-      },
-      "engines": {
-        "pnpm": ">=8"
-      }
-    },
    "node_modules/chokidar": {
      "version": "5.0.0",
      "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-5.0.0.tgz",
@@ -2998,16 +2978,6 @@
        "node": ">=0.10.0"
      }
    },
-    "node_modules/react-chartjs-2": {
-      "version": "5.3.1",
-      "resolved": "https://registry.npmjs.org/react-chartjs-2/-/react-chartjs-2-5.3.1.tgz",
-      "integrity": "sha512-h5IPXKg9EXpjoBzUfyWJvllMjG2mQ4EiuHQFhms/AjUm0XSZHhyRy2xVmLXHKrtcdrPO4mnGqRtYoD0vp95A0A==",
-      "license": "MIT",
-      "peerDependencies": {
-        "chart.js": "^4.1.1",
-        "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
-      }
-    },
    "node_modules/react-dom": {
      "version": "19.2.8",
      "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.2.8.tgz",
@@ -1,6 +1,6 @@
 {
  "name": "cursor-byok-desktop",
-  "version": "0.1.2",
+  "version": "0.1.5-beta.1",
  "description": "Cursor BYOK desktop management application",
  "type": "module",
  "scripts": {
@@ -10,6 +10,7 @@
    "typecheck:node": "tsc --noEmit -p tsconfig.node.json",
    "i18n:scan": "STATIC_I18N_SCAN=true vite build",
    "build": "vite build",
+    "build:demo": "npm run typecheck && npm run typecheck:node && vite build --config vite.demo.config.ts",
    "check": "npm run typecheck && npm run typecheck:node && npm run build",
    "dev:web": "concurrently --kill-others --success first --names server,web \"cross-env CURSOR_CONSOLE_PROXY=http://127.0.0.1:1420 cargo run --manifest-path ../../server/Cargo.toml --bin cursor-server\" \"wait-on http-get://127.0.0.1:3000/__byok-api__/healthz && vite\"",
    "serve": "vite preview",
@@ -28,13 +29,11 @@
    "@tauri-apps/plugin-opener": "^2.5.4",
    "@tauri-apps/plugin-process": "^2.3.1",
    "@tauri-apps/plugin-updater": "^2.10.1",
-    "chart.js": "^4.5.1",
    "echarts": "^6.1.0",
    "keepalive-for-react": "^5.0.11",
    "keepalive-for-react-router": "^5.0.7",
    "monaco-editor": "0.56.0",
    "react": "^19.2.8",
-    "react-chartjs-2": "^5.3.1",
    "react-dom": "^19.2.8",
    "react-router-dom": "^7.18.2",
    "sortablejs": "^1.15.7",
@@ -1,6 +1,6 @@
 [package]
 name = "cursor-byok-desktop"
-version = "0.1.2"
+version = "0.1.5-beta.1"
 edition = "2021"
 publish = false

@@ -14,6 +14,7 @@ tauri-build = { version = "2", features = [] }
 [dependencies]
 axum = "0.8"
 cursor-server = { path = "../../../server" }
+rfd = "0.15"
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
 tauri = { version = "2", features = ["tray-icon"] }
@@ -26,5 +27,6 @@ tauri-plugin-updater = "2"
 tokio = { version = "1", features = ["time"] }
 tokio-util = "0.7"
 tracing = "0.1"
+tracing-appender = "0.2"
 tracing-subscriber = { version = "0.3", features = ["env-filter"] }
 url = "2"
@@ -16,6 +16,7 @@
    "core:window:allow-toggle-maximize",
    "core:window:allow-is-maximized",
    "core:window:allow-close",
+    "core:app:allow-set-dock-visibility",
    "allow-open-terminal-with-command",
    "clipboard-manager:allow-write-text",
    "autostart:default",
@@ -1,5 +1,5 @@
 use std::{
-    process::Command,
+    process::{Command, ExitCode},
    sync::{
        atomic::{AtomicBool, Ordering},
        Mutex,
@@ -19,7 +19,6 @@ use tauri::{
 };
 use tauri_plugin_opener::OpenerExt;
 use tokio_util::sync::CancellationToken;
-use tracing_subscriber::{layer::SubscriberExt, util::SubscriberInitExt};

 #[cfg(dev)]
 use cursor_server::config::ConsoleSource;
@@ -27,6 +26,7 @@ use cursor_server::{App, Config, Result};

 #[cfg(not(dev))]
 use crate::frontend;
+use crate::startup::{self, StartupDiagnostics};
 use crate::tray;

 pub(crate) const MAIN_WINDOW_LABEL: &str = "main";
@@ -141,16 +141,23 @@ fn create_main_window(
    builder.build()
 }

-pub fn run() {
-    let started_by_autostart = std::env::args_os().any(|arg| arg == AUTOSTART_ARG);
+pub fn run() -> ExitCode {
+    let diagnostics = match StartupDiagnostics::initialize() {
+        Ok(diagnostics) => diagnostics,
+        Err(error) => {
+            startup::report_logging_failure(error.as_ref());
+            return ExitCode::FAILURE;
+        }
+    };
+    tracing::info!(
+        version = env!("CARGO_PKG_VERSION"),
+        os = std::env::consts::OS,
+        architecture = std::env::consts::ARCH,
+        log_directory = %diagnostics.log_directory().display(),
+        "desktop starting"
+    );

-    tracing_subscriber::registry()
-        .with(
-            tracing_subscriber::EnvFilter::try_from_default_env()
-                .unwrap_or_else(|_| "cursor_server=info".into()),
-        )
-        .with(tracing_subscriber::fmt::layer())
-        .init();
+    let started_by_autostart = std::env::args_os().any(|arg| arg == AUTOSTART_ARG);

    let app = tauri::Builder::default()
        .invoke_handler(tauri::generate_handler![open_terminal_with_command])
@@ -186,9 +193,12 @@ pub fn run() {
            let listener = tauri::async_runtime::block_on(server.bind())?;
            let address = listener.local_addr()?;
            tauri::async_runtime::block_on(server.harness().cleanup_stale_settings())?;
-            let silent_start = tauri::async_runtime::block_on(server.store().desktop_settings())
-                .map(|settings| settings.silent_start)
-                .unwrap_or(false);
+            let desktop_settings =
+                tauri::async_runtime::block_on(server.store().desktop_settings())
+                    .unwrap_or_default();
+            #[cfg(target_os = "macos")]
+            app.handle()
+                .set_dock_visibility(desktop_settings.show_dock_icon)?;
            let shutdown = CancellationToken::new();
            let server_shutdown = shutdown.clone();
            let app_handle = app.handle().clone();
@@ -206,7 +216,7 @@ pub fn run() {
                exiting: AtomicBool::new(false),
            });
            let window = create_main_window(app.handle(), address)?;
-            if silent_start && started_by_autostart {
+            if desktop_settings.silent_start && started_by_autostart {
                tracing::info!("silent autostart enabled; keeping the main window hidden");
            } else {
                window.show()?;
@@ -215,8 +225,14 @@ pub fn run() {
            tray::create(app)?;
            Ok(())
        })
-        .build(tauri::generate_context!())
-        .expect("failed to build Cursor BYOK desktop app");
+        .build(tauri::generate_context!());
+    let app = match app {
+        Ok(app) => app,
+        Err(error) => {
+            diagnostics.report_fatal(&error);
+            return ExitCode::FAILURE;
+        }
+    };

    app.run(|app, event| match event {
        RunEvent::WindowEvent {
@@ -261,4 +277,6 @@ pub fn run() {
        } => tray::show_main_window(app),
        _ => {}
    });
+
+    ExitCode::SUCCESS
 }
@@ -1,6 +1,7 @@
 mod desktop;
 #[cfg(not(dev))]
 mod frontend;
+mod startup;
 mod tray;

 pub use desktop::run;
@@ -1,5 +1,5 @@
 #![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]

-fn main() {
-    cursor_byok_desktop::run();
+fn main() -> std::process::ExitCode {
+    cursor_byok_desktop::run()
 }
@@ -0,0 +1,139 @@
+//! Captures startup diagnostics before the database and desktop runtime initialize.
+use std::{error::Error, path::PathBuf};
+
+use rfd::{MessageButtons, MessageDialog, MessageLevel};
+use tracing_appender::{
+    non_blocking::WorkerGuard,
+    rolling::{RollingFileAppender, Rotation},
+};
+use tracing_subscriber::{layer::SubscriberExt, util::SubscriberInitExt};
+
+const LOG_DIRECTORY_NAME: &str = "logs";
+const LOG_FILE_PREFIX: &str = "cursor-byok";
+const LOG_FILE_SUFFIX: &str = "log";
+const RETAINED_LOG_FILES: usize = 15;
+
+type BoxError = Box<dyn Error + Send + Sync>;
+
+pub(crate) struct StartupDiagnostics {
+    log_directory: PathBuf,
+    _writer_guard: WorkerGuard,
+}
+
+impl StartupDiagnostics {
+    pub(crate) fn initialize() -> Result<Self, BoxError> {
+        let log_directory = cursor_server::config::managed_data_dir()?.join(LOG_DIRECTORY_NAME);
+        std::fs::create_dir_all(&log_directory)?;
+
+        let file_appender = RollingFileAppender::builder()
+            .rotation(Rotation::DAILY)
+            .filename_prefix(LOG_FILE_PREFIX)
+            .filename_suffix(LOG_FILE_SUFFIX)
+            .max_log_files(RETAINED_LOG_FILES)
+            .build(&log_directory)?;
+        let (file_writer, writer_guard) = tracing_appender::non_blocking(file_appender);
+        let filter = tracing_subscriber::EnvFilter::try_from_default_env()
+            .unwrap_or_else(|_| "cursor_byok_desktop=info,cursor_server=info".into());
+
+        tracing_subscriber::registry()
+            .with(filter)
+            .with(tracing_subscriber::fmt::layer())
+            .with(
+                tracing_subscriber::fmt::layer()
+                    .with_ansi(false)
+                    .with_writer(file_writer),
+            )
+            .try_init()?;
+
+        Ok(Self {
+            log_directory,
+            _writer_guard: writer_guard,
+        })
+    }
+
+    pub(crate) fn log_directory(&self) -> &std::path::Path {
+        &self.log_directory
+    }
+
+    pub(crate) fn report_fatal(&self, error: &(dyn Error + 'static)) {
+        let details = error_chain(error);
+        tracing::error!(
+            error = %details,
+            log_directory = %self.log_directory.display(),
+            "desktop failed to start"
+        );
+        show_fatal_dialog(&details, Some(&self.log_directory));
+    }
+}
+
+pub(crate) fn report_logging_failure(error: &(dyn Error + 'static)) {
+    let details = error_chain(error);
+    eprintln!("Cursor BYOK failed to initialize logging: {details}");
+    show_fatal_dialog(&details, None);
+}
+
+fn show_fatal_dialog(details: &str, log_directory: Option<&std::path::Path>) {
+    let log_guidance = match log_directory {
+        Some(directory) => format!(
+            "日志目录 / Log directory:\n{}\n\n请将最新的日志文件发送给开发者。\nPlease send the latest log file to the developer.",
+            directory.display()
+        ),
+        None => "日志系统也未能启动，因此没有生成日志文件。\nLogging also failed to initialize, so no log file was created."
+            .to_owned(),
+    };
+    let description = format!(
+        "Cursor BYOK 无法启动 / failed to start.\n\n错误 / Error:\n{details}\n\n{log_guidance}"
+    );
+
+    let _ = MessageDialog::new()
+        .set_level(MessageLevel::Error)
+        .set_title("Cursor BYOK 启动失败 / Startup Error")
+        .set_description(description)
+        .set_buttons(MessageButtons::Ok)
+        .show();
+}
+
+fn error_chain(error: &(dyn Error + 'static)) -> String {
+    let mut details = error.to_string();
+    let mut source = error.source();
+    while let Some(cause) = source {
+        details.push_str("\nCaused by: ");
+        details.push_str(&cause.to_string());
+        source = cause.source();
+    }
+    details
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use std::fmt;
+
+    #[derive(Debug)]
+    struct OuterError(std::io::Error);
+
+    impl fmt::Display for OuterError {
+        fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
+            formatter.write_str("database initialization failed")
+        }
+    }
+
+    impl Error for OuterError {
+        fn source(&self) -> Option<&(dyn Error + 'static)> {
+            Some(&self.0)
+        }
+    }
+
+    #[test]
+    fn fatal_report_includes_the_complete_error_chain() {
+        let error = OuterError(std::io::Error::new(
+            std::io::ErrorKind::PermissionDenied,
+            "database file is read-only",
+        ));
+
+        assert_eq!(
+            error_chain(&error),
+            "database initialization failed\nCaused by: database file is read-only"
+        );
+    }
+}
@@ -1,7 +1,7 @@
 {
  "$schema": "https://schema.tauri.app/config/2",
  "productName": "Cursor BYOK",
-  "version": "0.1.2",
+  "version": "0.1.5-beta.1",
  "identifier": "dev.cursorbyok.desktop",
  "build": {
    "beforeDevCommand": "npm run dev",
@@ -1,16 +1,16 @@
 import { useEffect, useRef } from "react";
 import { HashRouter, Navigate, Route, Routes } from "react-router-dom";
-import { MessageProvider } from "./components/ui/MessageProvider";
-import { useMessage } from "./components/ui/message";
-import { AppFrame } from "./layouts/AppFrame";
-import { AppLayout } from "./layouts/AppLayout";
-import { CallsPage } from "./pages/CallsPage";
-import { CallDetailsPage } from "./pages/CallDetailsPage";
-import { CursorSettingsPage } from "./pages/CursorSettingsPage";
-import { HomePage } from "./pages/HomePage";
-import { SettingsPage } from "./pages/SettingsPage";
-import { useAppStore } from "./store/appStore";
-import { updateStore } from "./store/updateStore";
+import { MessageProvider } from "./shared/ui/MessageProvider";
+import { useMessage } from "./shared/ui/message";
+import { AppFrame } from "./shell/AppFrame";
+import { AppLayout } from "./shell/AppLayout";
+import { CallsPage } from "./features/calls/CallsPage";
+import { CallDetailsPage } from "./features/calls/CallDetailsPage";
+import { CursorSettingsPage } from "./features/models/CursorSettingsPage";
+import { HomePage } from "./features/home/HomePage";
+import { SettingsPage } from "./features/settings/SettingsPage";
+import { useAppStore } from "./shared/store/appStore";
+import { updateStore } from "./shared/store/updateStore";

 export function App() {
  return (
@@ -1,75 +0,0 @@
-import { ArcElement, Chart as ChartJS, Tooltip, type ChartOptions, type ScriptableContext } from "chart.js";
-import { useMemo } from "react";
-import { Doughnut } from "react-chartjs-2";
-import styles from "./CacheHitRateChart.module.scss";
-
-ChartJS.register(ArcElement, Tooltip);
-
-type SegmentRadius = number | {
-  outerStart: number;
-  outerEnd: number;
-  innerStart: number;
-  innerEnd: number;
-};
-
-function chartColor(context: ScriptableContext<"doughnut">) {
-  const styles = getComputedStyle(context.chart.canvas);
-  const variable = context.dataIndex === 0 ? "--cache-hit-value-color" : "--cache-hit-track-color";
-  return styles.getPropertyValue(variable).trim();
-}
-
-function segmentBorderRadius(percentage: number, dataIndex: number): SegmentRadius {
-  const radius = 5;
-
-  if (percentage <= 0) {
-    return dataIndex === 1
-      ? { outerStart: radius, outerEnd: radius, innerStart: radius, innerEnd: radius }
-      : 0;
-  }
-
-  if (percentage >= 100) {
-    return dataIndex === 0
-      ? { outerStart: radius, outerEnd: radius, innerStart: radius, innerEnd: radius }
-      : 0;
-  }
-
-  return dataIndex === 0
-    ? { outerStart: radius, outerEnd: 0, innerStart: radius, innerEnd: 0 }
-    : { outerStart: 0, outerEnd: radius, innerStart: 0, innerEnd: radius };
-}
-
-const options: ChartOptions<"doughnut"> = {
-  responsive: true,
-  maintainAspectRatio: false,
-  cutout: "82%",
-  rotation: -90,
-  circumference: 180,
-  animation: { duration: 450 },
-  events: [],
-  plugins: {
-    legend: { display: false },
-    tooltip: { enabled: false },
-  },
-};
-
-export function CacheHitRateChart({ rate }: { rate: number }) {
-  const finiteRate = Number.isFinite(rate) ? rate : 0;
-  const percentage = Math.max(0, Math.min(100, finiteRate * 100));
-  const label = Number.isFinite(rate) ? `${percentage.toFixed(2)}%` : "--";
-  const data = useMemo(() => ({
-    labels: [t("命中"), t("未命中")],
-    datasets: [{
-      data: [percentage, Math.max(0, 100 - percentage)],
-      backgroundColor: chartColor,
-      borderWidth: 0,
-      hoverBorderWidth: 0,
-      selfJoin: false,
-      borderRadius: (context: ScriptableContext<"doughnut">) => segmentBorderRadius(percentage, context.dataIndex),
-    }],
-  }), [percentage]);
-
-  return <div className={styles.root} role="img" aria-label={t("缓存命中率 {rate}", { rate: label })}>
-    <Doughnut className={styles.canvas} data={data} options={options} />
-    <div className={styles.label}>{label}</div>
-  </div>;
-}
@@ -0,0 +1,292 @@
+import type {
+  CallDetail,
+  CursorHarnessStatus,
+  LlmCall,
+  Model,
+  Overview,
+  OverviewTokenUsageBucket,
+  ProxySettings,
+  StatisticsStorage,
+  TabSettings,
+} from "../shared/api";
+
+const API_ROOT = "/__byok-api__/api";
+const FIXED_NOW = Date.UTC(2026, 7, 27, 8, 0, 0);
+
+const models: Model[] = [
+  createModel({ hash: "mock-claude-sonnet", order: 1, name: "Claude Sonnet 4", type: "anthropic", url: "https://api.anthropic.com", modelId: "claude-sonnet-4-20250514" }),
+  createModel({ hash: "mock-claude-opus", order: 2, name: "Claude Opus 4", type: "anthropic", url: "https://api.anthropic.com", modelId: "claude-opus-4-20250514" }),
+  createModel({ hash: "mock-gpt", order: 3, name: "GPT-5.2", type: "openai", url: "https://api.openai.com", modelId: "gpt-5.2" }),
+  createModel({ hash: "mock-o3", order: 4, name: "o3", type: "openai", url: "https://api.openai.com", modelId: "o3" }),
+  createModel({ hash: "mock-deepseek-v3", order: 5, name: "DeepSeek V3.2", type: "openai", url: "https://api.deepseek.com", modelId: "deepseek-chat", endpoint: "/v1/chat/completions" }),
+  createModel({ hash: "mock-deepseek-r1", order: 6, name: "DeepSeek R1", type: "openai", url: "https://api.deepseek.com", modelId: "deepseek-reasoner", endpoint: "/v1/chat/completions" }),
+  createModel({ hash: "mock-gemini-pro", order: 7, name: "Gemini 2.5 Pro", type: "openai", url: "https://generativelanguage.googleapis.com", modelId: "gemini-2.5-pro", endpoint: "/v1beta/openai/chat/completions" }),
+  createModel({ hash: "mock-gemini-flash", order: 8, name: "Gemini 2.5 Flash", type: "openai", url: "https://generativelanguage.googleapis.com", modelId: "gemini-2.5-flash", endpoint: "/v1beta/openai/chat/completions" }),
+  createModel({ hash: "mock-qwen-max", order: 9, name: "Qwen3 Max", type: "openai", url: "https://dashscope.aliyuncs.com/compatible-mode", modelId: "qwen3-max", endpoint: "/v1/chat/completions" }),
+  createModel({ hash: "mock-qwen-plus", order: 10, name: "Qwen Plus", type: "openai", url: "https://dashscope.aliyuncs.com/compatible-mode", modelId: "qwen-plus", endpoint: "/v1/chat/completions" }),
+  createModel({ hash: "mock-kimi-k2", order: 11, name: "Kimi K2", type: "openai", url: "https://api.moonshot.cn", modelId: "kimi-k2-0711-preview", endpoint: "/v1/chat/completions" }),
+  createModel({ hash: "mock-kimi-128k", order: 12, name: "Moonshot V1 128K", type: "openai", url: "https://api.moonshot.cn", modelId: "moonshot-v1-128k", endpoint: "/v1/chat/completions" }),
+  createModel({ hash: "mock-glm-45", order: 13, name: "GLM-4.5", type: "openai", url: "https://open.bigmodel.cn", modelId: "glm-4.5", endpoint: "/api/paas/v4/chat/completions" }),
+  createModel({ hash: "mock-glm-air", order: 14, name: "GLM-4.5-Air", type: "openai", url: "https://open.bigmodel.cn", modelId: "glm-4.5-air", endpoint: "/api/paas/v4/chat/completions" }),
+  createModel({ hash: "mock-mistral-large", order: 15, name: "Mistral Large", type: "openai", url: "https://api.mistral.ai", modelId: "mistral-large-latest", endpoint: "/v1/chat/completions" }),
+  createModel({ hash: "mock-mistral-small", order: 16, name: "Mistral Small", type: "openai", url: "https://api.mistral.ai", modelId: "mistral-small-latest", endpoint: "/v1/chat/completions" }),
+];
+
+const calls: LlmCall[] = Array.from({ length: 24 }, (_, index) => {
+  const model = models[index % models.length];
+  const failed = index === 7 || index === 19;
+  return {
+    call_kind: "provider_llm",
+    route: "local_byok",
+    call_id: `mock-call-${String(index + 1).padStart(3, "0")}`,
+    run_id: `mock-run-${Math.floor(index / 3) + 1}`,
+    conversation_id: `mock-conversation-${Math.floor(index / 4) + 1}`,
+    provider_call_index: index + 1,
+    model_hash: model.model_hash,
+    provider_type: model.type,
+    provider_url: model.base_url,
+    request_type: model.type === "anthropic" ? "messages" : "responses",
+    request_url: model.type === "anthropic" ? `${model.base_url}/v1/messages` : `${model.base_url}${model.openai_endpoint}`,
+    model_id: model.model_id,
+    display_name: model.display_name,
+    reasoning_effort: index % 2 === 0 ? "high" : null,
+    fast: index % 3 === 0,
+    status: failed ? "failed" : "completed",
+    finish_reason: failed ? null : "stop",
+    created_at_ms: FIXED_NOW - index * 3 * 60_000,
+    ttfb_ms: 210 + index * 13,
+    ttfr_ms: 290 + index * 15,
+    ttft_ms: 370 + index * 17,
+    duration_ms: failed ? 812 : 1_420 + index * 71,
+    input_tokens: 4_800 + index * 337,
+    output_tokens: failed ? 0 : 820 + index * 43,
+    total_tokens: failed ? 4_800 + index * 337 : 5_620 + index * 380,
+    cache_read_tokens: 3_100 + index * 251,
+    cache_write_tokens: 320 + index * 19,
+    reasoning_tokens: index % 2 === 0 ? 420 + index * 11 : null,
+    message_count: 14 + (index % 8),
+    tool_count: 3 + (index % 5),
+    http_status: failed ? 429 : 200,
+    error_kind: failed ? "provider_rate_limit" : null,
+    error_message: failed ? "Mock provider rate limit" : null,
+    detailed: true,
+  };
+});
+
+const harnessStatus: CursorHarnessStatus = {
+  platform: "macos",
+  ca: "ready",
+  configured_models: models.length,
+  enabled_models: models.length,
+  integration: "enabled",
+  proxy_url: "http://127.0.0.1:54321",
+  ca_install_command: null,
+};
+
+let detailed = true;
+let portSettings = { proxy_port: 0, service_port: 0 };
+let proxySettings: ProxySettings = {
+  mode: "system",
+  address: "",
+  auth_enabled: false,
+  username: "",
+  has_password: false,
+};
+let tabSettings: TabSettings = { mode: "public", address: "" };
+let storage: StatisticsStorage = { bytes: 26_004_480, call_count: calls.length, trace_count: calls.length };
+
+export function installDemoApi() {
+  const nativeFetch = window.fetch.bind(window);
+
+  window.fetch = async (input, init) => {
+    const requestUrl = input instanceof Request ? input.url : input instanceof URL ? input.href : input;
+    const url = new URL(requestUrl, window.location.href);
+    if (!url.pathname.startsWith(API_ROOT)) return nativeFetch(input, init);
+
+    const path = url.pathname.slice(API_ROOT.length) || "/";
+    const method = (init?.method ?? (input instanceof Request ? input.method : "GET")).toUpperCase();
+    const body = await readBody(input, init);
+
+    if (path === "/ads") return json({ slots: [] });
+    if (path === "/models" && method === "GET") return json(models);
+    if (path === "/models" && method === "POST") return json(models);
+    if (path === "/models/order") return json(models);
+    if (path === "/models/discover") return json({ models: models.map((model) => model.model_id) });
+    if (path === "/models/import-v0049" && method === "GET") {
+      return json({ source: "demo", total: 0, new_models: 0, existing_models: 0, models: [] });
+    }
+    if (path === "/models/import-v0049") return json({ imported: 0, skipped: 0, total: 0 });
+    if (/^\/models\/[^/]+\/test\/[^/]+$/.test(path) && method === "POST") {
+      return json({ duration_ms: 1_284, first_valid_response_ms: 418, output_tokens: 42, tokens_per_second: 38.6, tokens_estimated: false, output: "Mock connectivity test passed." });
+    }
+    if (/^\/models\/[^/]+\/test\/[^/]+$/.test(path) || /^\/models\/[^/]+$/.test(path)) {
+      return method === "DELETE" ? empty() : json(models[0]);
+    }
+    if (path === "/overview") return json(createOverview(url.searchParams));
+    if (path === "/llm-calls") return json(calls);
+    if (path.startsWith("/llm-calls/")) return json(createCallDetail(path.slice("/llm-calls/".length)));
+    if (path === "/harness/cursor/status") return json(harnessStatus);
+    if (path === "/harness/cursor/ca/initialize" || path === "/harness/cursor/enabled") return json(harnessStatus);
+    if (path === "/settings/observability" && method === "GET") return json({ detailed });
+    if (path === "/settings/observability") {
+      detailed = Boolean((body as { detailed?: unknown } | null)?.detailed);
+      return json({ detailed });
+    }
+    if (path === "/settings/ports" && method === "GET") return json(portSettings);
+    if (path === "/settings/ports") {
+      portSettings = body as typeof portSettings;
+      return json(portSettings);
+    }
+    if (path === "/settings/storage/statistics" && method === "GET") return json(storage);
+    if (path === "/settings/storage/statistics") {
+      const scope = (body as { scope?: string } | null)?.scope ?? "details";
+      storage = scope === "all"
+        ? { bytes: 0, call_count: 0, trace_count: 0 }
+        : { ...storage, bytes: 0 };
+      return json(storage);
+    }
+    if (path === "/settings/proxy" && method === "GET") return json(proxySettings);
+    if (path === "/settings/proxy") {
+      const next = body as Partial<ProxySettings>;
+      proxySettings = { ...proxySettings, ...next, has_password: Boolean(next.has_password) };
+      return json(proxySettings);
+    }
+    if (path === "/settings/tab" && method === "GET") return json(tabSettings);
+    if (path === "/settings/tab") {
+      tabSettings = body as TabSettings;
+      return json(tabSettings);
+    }
+    if (path === "/settings/desktop" && method === "GET") return json({ silent_start: false, show_dock_icon: true });
+    if (path === "/settings/desktop") return json(body);
+    if (path === "/desktop/open-external-url") {
+      const target = (body as { url?: string } | null)?.url;
+      if (target) {
+        const next = new URL(target, window.location.href);
+        if (next.origin === window.location.origin && next.hash) window.location.hash = next.hash;
+      }
+      return empty();
+    }
+    if (path.endsWith("/dismissals")) return empty();
+
+    return json({ message: `Unhandled demo endpoint: ${method} ${path}` }, 404);
+  };
+}
+
+function createModel({ hash, order, name, type, url, modelId, endpoint = "/v1/responses" }: {
+  hash: string;
+  order: number;
+  name: string;
+  type: Model["type"];
+  url: string;
+  modelId: string;
+  endpoint?: string;
+}): Model {
+  return {
+    model_hash: hash,
+    sort_order: order,
+    display_name: name,
+    type,
+    base_url: url,
+    use_full_url: false,
+    api_key: "demo-key",
+    tooltip_data: `${name} Mock 通道`,
+    model_id: modelId,
+    reasoning_effort: type === "openai" ? "high" : null,
+    openai_endpoint: type === "openai" ? endpoint : "",
+    openai_extra_params_enabled: false,
+    openai_extra_params: {},
+    custom_headers_enabled: false,
+    custom_headers: {},
+    anthropic_extra_params_enabled: false,
+    anthropic_extra_params: {},
+    context_window_tokens: 200_000,
+    max_completion_tokens: type === "openai" ? 32_000 : null,
+    anthropic_max_tokens: type === "anthropic" ? 32_000 : null,
+    anthropic_thinking_effort: type === "anthropic" ? "high" : null,
+    thinking_budget_tokens: null,
+    created_at_ms: FIXED_NOW - order * 86_400_000,
+    updated_at_ms: FIXED_NOW,
+  };
+}
+
+function createOverview(params: URLSearchParams): Overview {
+  const start = Number(params.get("start_ms"));
+  const end = Number(params.get("end_ms"));
+  const duration = Number.isFinite(start) && Number.isFinite(end) && end > start ? end - start : 365 * 86_400_000;
+  const granularity = duration <= 2 * 60 * 60_000 ? "minute" : duration <= 2 * 86_400_000 ? "hour" : "day";
+  const step = granularity === "minute" ? 60_000 : granularity === "hour" ? 3_600_000 : 86_400_000;
+  const count = granularity === "minute" ? Math.min(60, Math.max(10, Math.ceil(duration / step))) : granularity === "hour" ? Math.min(24, Math.max(8, Math.ceil(duration / step))) : Math.min(365, Math.max(7, Math.ceil(duration / step)));
+  const series = createSeries(count, step, Number.isFinite(end) && end > 0 ? end : FIXED_NOW);
+  const totals = series.reduce((sum, bucket) => ({
+    input: sum.input + bucket.input_tokens,
+    cacheRead: sum.cacheRead + bucket.cache_read_tokens,
+    cacheWrite: sum.cacheWrite + bucket.cache_write_tokens,
+    output: sum.output + bucket.output_tokens,
+  }), { input: 0, cacheRead: 0, cacheWrite: 0, output: 0 });
+  const llmCalls = Math.max(12, Math.round(count * 5.4));
+
+  return {
+    metrics: {
+      llm_calls: llmCalls,
+      successful_calls: llmCalls - Math.max(1, Math.floor(llmCalls * 0.008)),
+      failed_calls: Math.max(1, Math.floor(llmCalls * 0.008)),
+      token_usage: totals.input + totals.cacheRead + totals.cacheWrite + totals.output,
+      prompt_tokens: totals.input + totals.cacheRead + totals.cacheWrite,
+      input_tokens: totals.input,
+      cache_read_tokens: totals.cacheRead,
+      cache_write_tokens: totals.cacheWrite,
+      output_tokens: totals.output,
+    },
+    token_usage_granularity: granularity,
+    token_usage_series: series,
+  };
+}
+
+function createSeries(count: number, step: number, end: number): OverviewTokenUsageBucket[] {
+  return Array.from({ length: count }, (_, index) => {
+    const wave = 0.72 + ((index * 17) % 31) / 50;
+    return {
+      bucket_start_ms: end - (count - index) * step,
+      // input : cache_read = 1 : 99，使默认口径缓存命中率恰为 99%
+      input_tokens: Math.round(800 * wave),
+      cache_read_tokens: Math.round(79_200 * wave),
+      cache_write_tokens: Math.round(7_500 * wave),
+      output_tokens: Math.round(12_500 * wave),
+    };
+  });
+}
+
+function createCallDetail(id: string): CallDetail {
+  const call = calls.find((item) => item.call_id === decodeURIComponent(id)) ?? calls[0];
+  return {
+    call,
+    request: {
+      headers: { authorization: "Bearer sk-demo-••••", "content-type": "application/json" },
+      body: { model: call.model_id, stream: true, messages: [{ role: "user", content: "Mock Agent request" }] },
+      byte_count: 8_426,
+    },
+    response_chunks: [
+      { seq: 1, received_offset_ms: 418, data: "event: response.created", byte_count: 128 },
+      { seq: 2, received_offset_ms: 512, data: "event: response.output_text.delta", byte_count: 256 },
+    ],
+    cursor_trace: null,
+  };
+}
+
+async function readBody(input: RequestInfo | URL, init?: RequestInit): Promise<unknown> {
+  const raw = init?.body ?? (input instanceof Request ? await input.clone().text() : null);
+  if (typeof raw !== "string" || raw.length === 0) return null;
+  try { return JSON.parse(raw) as unknown; }
+  catch { return raw; }
+}
+
+function json(value: unknown, status = 200) {
+  return new Response(JSON.stringify(value), {
+    status,
+    headers: { "content-type": "application/json" },
+  });
+}
+
+function empty() {
+  return new Response(null, { status: 204 });
+}
@@ -0,0 +1,13 @@
+import { installDemoApi } from "./api";
+
+installDemoApi();
+
+const params = new URLSearchParams(window.location.search);
+const locale = params.get("locale") === "en-US" ? "en-US" : "zh-CN";
+const theme = params.get("theme") === "default-light" ? "default-light" : "default-dark";
+
+document.documentElement.dataset.platform = "macos";
+localStorage.setItem("cursor-byok.locale", locale);
+localStorage.setItem("cursor-byok.theme", theme);
+
+void import("../index");
@@ -1,4 +1,4 @@
-@use "../styles/typography" as type;
+@use "../../styles/typography" as type;

 .root {
  section { min-width: 0; }
@@ -1,6 +1,6 @@
-import type { CallDetail } from "../api";
-import { JsonEditor } from "./ui/JsonEditor";
-import { Tabs, type TabItem } from "./ui/Tabs";
+import type { CallDetail } from "../../shared/api";
+import { JsonEditor } from "../../shared/ui/JsonEditor";
+import { Tabs, type TabItem } from "../../shared/ui/Tabs";
 import styles from "./CallDetails.module.scss";

 const show = (value: string | number | null) => value ?? "-";
@@ -32,6 +32,7 @@ export function CallDetails({ detail }: { detail: CallDetail }) {
    ["Created At", `${call.created_at_ms} · ${new Date(call.created_at_ms).toLocaleString()}`],
    [t("耗时"), timing(call.duration_ms)],
    ["TTFB", timing(call.ttfb_ms)],
+    ["TTFR", timing(call.ttfr_ms)],
    ["TTFT", timing(call.ttft_ms)],
    ["Input Token", show(call.input_tokens)],
    ["Output Token", show(call.output_tokens)],
@@ -1,4 +1,4 @@
-@use "../styles/typography" as type;
+@use "../../styles/typography" as type;

 .root {
  width: 100%;
@@ -1,10 +1,10 @@
 import { useEffect, useState } from "react";
 import { useParams } from "react-router-dom";
-import { api, type CallDetail } from "../api";
-import { CallDetails } from "../components/CallDetails";
-import { TitledCard } from "../components/ui/TitledCard";
+import { api, type CallDetail } from "../../shared/api";
+import { CallDetails } from "./CallDetails";
+import { TitledCard } from "../../shared/ui/TitledCard";
 import styles from "./CallDetailsPage.module.scss";
-import { ScrollableContent } from "../components/virtual/ScrollableContent";
+import { ScrollableContent } from "../../shared/virtual/ScrollableContent";

 export function CallDetailsPage() {
  const { callId = "" } = useParams();
@@ -1,4 +1,4 @@
-@use "../styles/typography" as type;
+@use "../../styles/typography" as type;

 .status {
  padding: 3px 7px;
@@ -1,9 +1,9 @@
-import type { LlmCall } from "../api";
-import controls from "./ui/Controls.module.scss";
-import { DataTable, type DataTableColumn } from "./ui/DataTable";
-import { Icon } from "./ui/Icon";
-import { TooltipTrigger } from "./ui/TooltipTrigger";
-import { eyeIcon } from "./ui/icons";
+import type { LlmCall } from "../../shared/api";
+import controls from "../../shared/ui/Controls.module.scss";
+import { DataTable, type DataTableColumn } from "../../shared/ui/DataTable";
+import { Icon } from "../../shared/ui/Icon";
+import { TooltipTrigger } from "../../shared/ui/TooltipTrigger";
+import { eyeIcon } from "../../shared/ui/icons";
 import styles from "./CallTable.module.scss";

 const value = (input: string | number | null) => input ?? "-";
@@ -87,6 +87,11 @@ export function CallTable({ calls, onDetails }: { calls: LlmCall[]; onDetails: (
      header: "TTFB",
      render: (call) => milliseconds(call.ttfb_ms),
    },
+    {
+      key: "ttfr",
+      header: "TTFR",
+      render: (call) => milliseconds(call.ttfr_ms),
+    },
    {
      key: "ttft",
      header: "TTFT",
@@ -0,0 +1,34 @@
+import { useEffect } from "react";
+import { CallTable } from "./CallTable";
+import { PageContent } from "../../shell/layout/PageContent";
+import { appStore, useAppStore } from "../../shared/store/appStore";
+import styles from "./CallsPage.module.scss";
+
+const CALL_REFRESH_INTERVAL_MS = 2_000;
+
+export function CallsPage() {
+  const { calls } = useAppStore();
+
+  useEffect(() => {
+    let disposed = false;
+    const refreshCalls = () => {
+      if (!disposed && document.visibilityState === "visible") {
+        void appStore.refreshCalls();
+      }
+    };
+
+    refreshCalls();
+    const interval = window.setInterval(refreshCalls, CALL_REFRESH_INTERVAL_MS);
+    window.addEventListener("focus", refreshCalls);
+    document.addEventListener("visibilitychange", refreshCalls);
+    return () => {
+      disposed = true;
+      window.clearInterval(interval);
+      window.removeEventListener("focus", refreshCalls);
+      document.removeEventListener("visibilitychange", refreshCalls);
+    };
+  }, []);
+
+  const content = <div className={styles.page}><CallTable calls={calls} onDetails={(call) => void appStore.openCallDetails(call.call_id)} /></div>;
+  return <PageContent fixed title={t("调用")} contentClassName={styles.pageContent} sections={[{ key: "calls", estimatedHeight: 720, content }]} />;
+}
@@ -1,15 +1,15 @@
 import { useEffect, useState } from "react";
-import { api, type Overview } from "../api";
-import { ContributionCalendarChart } from "../components/charts/ContributionCalendarChart";
-import { DailyTokenUsageChart } from "../components/charts/DailyTokenUsageChart";
-import { HomeMetrics } from "../components/metrics/HomeMetrics";
-import { PageContent } from "../components/layout/PageContent";
-import type { VirtualPageSection } from "../components/layout/VirtualPage";
-import { OverviewTimeRangeFilter, type OverviewRangePreset } from "../components/overview/OverviewTimeRangeFilter";
-import { PageActions } from "../layouts/PageActions";
-import { appStore, useAppStore } from "../store/appStore";
-import { formatTimeInput, parseTimeInput } from "../utils/parseTimeInput";
-import { claudeIcon, openAiIcon } from "../components/ui/icons";
+import { api, type Overview } from "../../shared/api";
+import { ContributionCalendarChart } from "./charts/ContributionCalendarChart";
+import { DailyTokenUsageChart } from "./charts/DailyTokenUsageChart";
+import { HomeMetrics } from "./metrics/HomeMetrics";
+import { PageContent } from "../../shell/layout/PageContent";
+import type { VirtualPageSection } from "../../shell/layout/VirtualPage";
+import { OverviewTimeRangeFilter, type OverviewRangePreset } from "./overview/OverviewTimeRangeFilter";
+import { PageActions } from "../../shell/PageActions";
+import { appStore, useAppStore } from "../../shared/store/appStore";
+import { formatTimeInput, parseTimeInput } from "../../shared/utils/parseTimeInput";
+import { claudeIcon, openAiIcon } from "../../shared/ui/icons";

 type TimeRange = { startMs: number; endMs: number };

@@ -118,7 +118,7 @@ export function HomePage() {
    {
      key: "metrics",
      estimatedHeight: 130,
-      content: <HomeMetrics data={metrics} />,
+      content: <HomeMetrics data={metrics} refreshVersion={refreshVersion} />,
    },

    {
@@ -1,4 +1,4 @@
-@use "../../styles/typography" as type;
+@use "../../../styles/typography" as type;

 .root {
  width: 100%;
@@ -1,6 +1,8 @@
 import { useLayoutEffect, useMemo, useRef, useState } from "react";
 import { init, Rect, type ElementEvent } from "zrender";
-import { Tooltip, type TooltipAnchor } from "../ui/Tooltip";
+import type { Locale } from "../../../i18n/runtime";
+import { useI18n } from "../../../i18n/store";
+import { Tooltip, type TooltipAnchor } from "../../../shared/ui/Tooltip";
 import styles from "./ContributionCalendarChart.module.scss";

 export type ContributionDay = {
@@ -54,8 +56,6 @@ const CALENDAR_CONFIG = {
  axisLabelGap: 8,
  axisLabelWidth: 28,
 } as const;
-const tokenFormatter = new Intl.NumberFormat("zh-CN");
-
 function parseDate(date: string) {
  return new Date(`${date}T00:00:00Z`);
 }
@@ -72,9 +72,10 @@ function isCellExtra(value: unknown): value is CellExtra {
  return typeof value === "object" && value !== null && (value as CellExtra).kind === "calendar-cell";
 }

-function buildCalendarLayout(data: ContributionDay[]) {
+function buildCalendarLayout(data: ContributionDay[], locale: Locale) {
  if (data.length === 0) return null;

+  const monthFormatter = new Intl.DateTimeFormat(locale, { month: "short", timeZone: "UTC" });
  const maximum = Math.max(1, ...data.map(({ tokens }) => tokens));
  const firstDate = parseDate(data[0].date);
  const calendarStart = new Date(firstDate.getTime() - mondayIndex(firstDate) * DAY_IN_MS);
@@ -88,20 +89,22 @@ function buildCalendarLayout(data: ContributionDay[]) {
  const monthTicks = cells.reduce<Array<{ key: string; text: string; column: number }>>((ticks, cell) => {
    const date = parseDate(cell.date);
    const key = `${date.getUTCFullYear()}-${date.getUTCMonth()}`;
-    if (ticks.at(-1)?.key !== key) ticks.push({ key, text: `${date.getUTCMonth() + 1}月`, column: cell.column });
+    if (ticks.at(-1)?.key !== key) ticks.push({ key, text: monthFormatter.format(date), column: cell.column });
    return ticks;
  }, []);
  return { cells, columnCount, monthTicks };
 }

 export function ContributionCalendarChart({ data }: ContributionCalendarChartProps) {
+  const { locale } = useI18n();
  const scrollerRef = useRef<HTMLDivElement>(null);
  const canvasRef = useRef<HTMLDivElement>(null);
  const layoutRef = useRef<ReturnType<typeof buildCalendarLayout>>(null);
  const scheduleDrawRef = useRef<() => void>(() => undefined);
  const [tooltip, setTooltip] = useState<TooltipState | null>(null);
  const [axisLabels, setAxisLabels] = useState<AxisLabel[]>([]);
-  const layout = useMemo(() => buildCalendarLayout(data), [data]);
+  const layout = useMemo(() => buildCalendarLayout(data, locale), [data, locale]);
+  const tokenFormatter = useMemo(() => new Intl.NumberFormat(locale), [locale]);
  layoutRef.current = layout;

  useLayoutEffect(() => {
@@ -1,4 +1,4 @@
-@use "../../styles/typography" as type;
+@use "../../../styles/typography" as type;

 .root {
  --daily-token-tooltip-font-size: #{type.$font-size-2xs};
@@ -1,7 +1,7 @@
 import type { EChartsCoreOption } from "echarts/core";
 import { useMemo, useState } from "react";
-import type { TokenUsageGranularity } from "../../api";
-import { formatCompactInteger } from "../../utils/numberFormat";
+import type { TokenUsageGranularity } from "../../../shared/api";
+import { formatCompactInteger } from "../../../shared/utils/numberFormat";
 import { EChart } from "./EChart";
 import styles from "./DailyTokenUsageChart.module.scss";

@@ -1,11 +1,11 @@
-import { BarChart, LineChart } from "echarts/charts";
+import { BarChart, GaugeChart, LineChart } from "echarts/charts";
 import { GridComponent, LegendComponent, MarkLineComponent, TooltipComponent } from "echarts/components";
 import { getInstanceByDom, init, use, type EChartsCoreOption } from "echarts/core";
 import { CanvasRenderer } from "echarts/renderers";
 import { useEffect, useRef, type MouseEventHandler } from "react";
 import styles from "./EChart.module.scss";

-use([BarChart, LineChart, GridComponent, LegendComponent, MarkLineComponent, TooltipComponent, CanvasRenderer]);
+use([BarChart, GaugeChart, LineChart, GridComponent, LegendComponent, MarkLineComponent, TooltipComponent, CanvasRenderer]);

 type EChartProps = {
  option: EChartsCoreOption;
@@ -1,18 +1,19 @@
 import type { EChartsCoreOption } from "echarts/core";
-import type { LlmCall } from "../../api";
+import type { LlmCall } from "../../../shared/api";
 import { EChart } from "./EChart";

 export function LatencyChart({ calls }: { calls: LlmCall[] }) {
  const points = calls.slice(0, 20).reverse();
  const option: EChartsCoreOption = {
    animationDuration: 280,
-    color: ["#d79a62", "#ad84cf"],
+    color: ["#d79a62", "#ad84cf", "#72a8d8"],
    grid: { top: 22, right: 18, bottom: 30, left: 48 },
    legend: { top: 0, right: 8, textStyle: { color: "#999" } },
    tooltip: { trigger: "axis" },
    xAxis: { type: "category", data: points.map((call) => new Date(call.created_at_ms).toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" })), axisLabel: { color: "#888" }, axisLine: { lineStyle: { color: "#5555" } } },
    yAxis: { type: "value", axisLabel: { color: "#888", formatter: "{value} ms" }, splitLine: { lineStyle: { color: "#8882" } } },
    series: [
+      { name: "TTFR", type: "line", smooth: true, symbol: "none", data: points.map((call) => call.ttfr_ms ?? 0) },
      { name: "TTFT", type: "line", smooth: true, symbol: "none", data: points.map((call) => call.ttft_ms ?? 0) },
      { name: t("总耗时"), type: "line", smooth: true, symbol: "none", data: points.map((call) => call.duration_ms ?? 0) },
    ],
@@ -1,5 +1,5 @@
 import type { EChartsCoreOption } from "echarts/core";
-import type { LlmCall } from "../../api";
+import type { LlmCall } from "../../../shared/api";
 import { EChart } from "./EChart";

 export function TokenTrendChart({ calls }: { calls: LlmCall[] }) {
@@ -1,18 +1,22 @@
-@use "../../styles/typography" as type;
+@use "../../../styles/typography" as type;

 .root {
-  --cache-hit-track-color: color-mix(in srgb, var(--vscode-foreground) 12%, transparent);
-  --cache-hit-value-color: var(--vscode-gitDecoration-addedResourceForeground, #4ade80);
  position: relative;
-  width: 132px;
+  width: 200px;
+  max-width: 100%;
  height: 82px;
+  overflow: hidden;
  align-self: center;
  flex: 0 0 auto;
 }

-.canvas {
-  width: 100% !important;
-  height: 100% !important;
+.chart {
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 140px;
+  pointer-events: none;
 }

 .label {
@@ -0,0 +1,62 @@
+import type { EChartsCoreOption } from "echarts/core";
+import { useEffect, useMemo, useState } from "react";
+import { EChart } from "../charts/EChart";
+import styles from "./CacheHitRateChart.module.scss";
+
+const valueColor = "#40c463";
+const trackColor = "rgba(139, 148, 158, 0.20)";
+
+export function CacheHitRateChart({ rate, animationKey = 0 }: { rate: number; animationKey?: number }) {
+  const finiteRate = Number.isFinite(rate) ? rate : 0;
+  const percentage = Math.max(0, Math.min(100, finiteRate * 100));
+  const [displayedPercentage, setDisplayedPercentage] = useState(0);
+  const label = Number.isFinite(rate) ? `${percentage.toFixed(2)}%` : "--";
+
+  useEffect(() => {
+    setDisplayedPercentage(0);
+    let frame = requestAnimationFrame(() => {
+      frame = requestAnimationFrame(() => setDisplayedPercentage(percentage));
+    });
+    return () => cancelAnimationFrame(frame);
+  }, [animationKey, percentage]);
+
+  const option = useMemo<EChartsCoreOption>(() => ({
+    animationDuration: 0,
+    animationDurationUpdate: displayedPercentage > 0 ? 1_000 : 0,
+    animationEasing: "cubicOut",
+    animationEasingUpdate: "cubicOut",
+    series: [{
+      type: "gauge",
+      min: 0,
+      max: 100,
+      startAngle: 180,
+      endAngle: 0,
+      center: ["50%", "50%"],
+      radius: "90%",
+      silent: true,
+      pointer: { show: false },
+      progress: {
+        show: true,
+        roundCap: true,
+        width: 11,
+        itemStyle: { color: displayedPercentage > 0 ? valueColor : "transparent" },
+      },
+      axisLine: {
+        roundCap: true,
+        lineStyle: { width: 11, color: [[1, trackColor]] },
+      },
+      axisTick: { show: false },
+      splitLine: { show: false },
+      axisLabel: { show: false },
+      anchor: { show: false },
+      title: { show: false },
+      detail: { show: false },
+      data: [{ value: displayedPercentage }],
+    }],
+  }), [displayedPercentage]);
+
+  return <div className={styles.root} role="img" aria-label={t("缓存命中率 {rate}", { rate: label })}>
+    <EChart className={styles.chart} option={option} />
+    <div className={styles.label}>{label}</div>
+  </div>;
+}
@@ -1,4 +1,4 @@
-@use "../../styles/typography" as type;
+@use "../../../styles/typography" as type;

 .scroller {
  width: 100%;
@@ -1,8 +1,8 @@
 import { useState } from "react";
-import { formatCompactInteger, formatInteger } from "../../utils/numberFormat";
-import { Icon } from "../ui/Icon";
-import { Tooltip, type TooltipAnchor } from "../ui/Tooltip";
-import { informationOutlineIcon } from "../ui/icons";
+import { formatCompactInteger, formatInteger } from "../../../shared/utils/numberFormat";
+import { Icon } from "../../../shared/ui/Icon";
+import { Tooltip, type TooltipAnchor } from "../../../shared/ui/Tooltip";
+import { informationOutlineIcon } from "../../../shared/ui/icons";
 import { CacheHitRateChart } from "./CacheHitRateChart";
 import styles from "./HomeMetrics.module.scss";

@@ -71,7 +71,7 @@ function InfoTooltip({ content }: { content: string }) {
  </>;
 }

-export function HomeMetrics({ data }: { data: HomeMetricsData }) {
+export function HomeMetrics({ data, refreshVersion = 0 }: { data: HomeMetricsData; refreshVersion?: number }) {
  const inputTokens = Math.max(0, data.promptTokens - data.cacheReadTokens - data.cacheWriteTokens);
  const outputTokens = Math.max(0, data.tokenUsage - data.promptTokens);
  const defaultCacheHitRate = calculateRate(data.cacheReadTokens, data.cacheReadTokens + inputTokens);
@@ -148,7 +148,7 @@ export function HomeMetrics({ data }: { data: HomeMetricsData }) {
    <section className={styles.root} aria-label={t("调用统计")}>
      <article className={styles.metric}>
        <div className={styles.label}>{t("缓存命中率")}<InfoTooltip content={cacheTooltip} /></div>
-        <CacheHitRateChart rate={defaultCacheHitRate ?? 0} />
+        <CacheHitRateChart rate={defaultCacheHitRate ?? 0} animationKey={refreshVersion} />
      </article>
      <article className={styles.metric}>
        <div className={styles.label}>{t("LLM 调用")}<InfoTooltip content={callsTooltip} /></div>
@@ -1,4 +1,4 @@
-@use "../../styles/typography" as type;
+@use "../../../styles/typography" as type;

 .root,
 .presets {
@@ -18,7 +18,7 @@
  border-radius: 5px;

  button {
-    height: 30px;
+    height: 25px;
    padding: 0 8px;
    color: var(--vscode-descriptionForeground);
    background: transparent;
@@ -1,12 +1,12 @@
 import { autoUpdate, computePosition, flip, offset, shift, size } from "@floating-ui/dom";
 import { useEffect, useId, useLayoutEffect, useRef, useState } from "react";
 import { createPortal } from "react-dom";
-import { parseTimeInput } from "../../utils/parseTimeInput";
-import controls from "../ui/Controls.module.scss";
-import { Icon } from "../ui/Icon";
-import { MultiSelect, type MultiSelectOption } from "../ui/MultiSelect";
-import { TooltipTrigger } from "../ui/TooltipTrigger";
-import { refreshIcon } from "../ui/icons";
+import { parseTimeInput } from "../../../shared/utils/parseTimeInput";
+import controls from "../../../shared/ui/Controls.module.scss";
+import { Icon } from "../../../shared/ui/Icon";
+import { MultiSelect, type MultiSelectOption } from "../../../shared/ui/MultiSelect";
+import { TooltipTrigger } from "../../../shared/ui/TooltipTrigger";
+import { refreshIcon } from "../../../shared/ui/icons";
 import styles from "./OverviewTimeRangeFilter.module.scss";

 export type OverviewRangePreset = "ten-minutes" | "hour" | "today" | "week" | "month" | "custom";
@@ -1,6 +1,6 @@
 import { createContext, useContext, type ReactNode } from "react";
-import { useAppStore } from "../../store/appStore";
-import controls from "../ui/Controls.module.scss";
+import { useAppStore } from "../../shared/store/appStore";
+import controls from "../../shared/ui/Controls.module.scss";
 import styles from "./CursorSettings.module.scss";

 const CaReady = createContext(false);
@@ -1,25 +1,26 @@
+import type { IconifyIcon } from "@iconify/react/offline";
 import { useEffect, useRef } from "react";
 import Sortable from "sortablejs";
-import type { Model } from "../../api";
-import { Button } from "../ui/Button";
-import { Card } from "../ui/Card";
-import { Icon } from "../ui/Icon";
-import { claudeIcon, dragIcon, openAiIcon } from "../ui/icons";
+import type { Model } from "../../shared/api";
+import { Button } from "../../shared/ui/Button";
+import { Card } from "../../shared/ui/Card";
+import { Icon } from "../../shared/ui/Icon";
+import { claudeIcon, dragIcon, flatColorOrganizationIcon, openAiIcon } from "../../shared/ui/icons";
 import { CursorModelTestResult, type CursorModelTestState } from "./CursorModelTestResult";
 import styles from "./CursorSettings.module.scss";

-export function CursorModelCards({
-  models,
-  disabled,
-  testingModelHashes,
-  testResults,
-  onTest,
-  onEdit,
-  onDuplicate,
-  onDelete,
-  onReorder,
-}: {
+export type CursorModelGrouping = "flat" | "provider" | "type";
+
+export type CursorModelGroup = {
+  key: string;
+  label: string;
+  icon: IconifyIcon;
  models: Model[];
+};
+
+type CursorModelCardsProps = {
+  models: Model[];
+  grouping: CursorModelGrouping;
  disabled: boolean;
  testingModelHashes: Set<string>;
  testResults: Map<string, CursorModelTestState>;
@@ -28,7 +29,54 @@ export function CursorModelCards({
  onDuplicate: (model: Model) => void;
  onDelete: (model: Model) => void;
  onReorder: (modelHashes: string[]) => void;
-}) {
+};
+
+type ModelGridProps = Omit<CursorModelCardsProps, "grouping"> & {
+  sortable: boolean;
+};
+
+export function cursorModelGroups(models: Model[], grouping: Exclude<CursorModelGrouping, "flat">): CursorModelGroup[] {
+  const groups = new Map<string, CursorModelGroup>();
+  for (const model of models) {
+    const descriptor = grouping === "provider" ? providerGroup(model) : typeGroup(model);
+    const group = groups.get(descriptor.key);
+    if (group) {
+      group.models.push(model);
+    } else {
+      groups.set(descriptor.key, { ...descriptor, models: [model] });
+    }
+  }
+  return [...groups.values()];
+}
+
+export function CursorModelCards(props: CursorModelCardsProps) {
+  if (props.grouping === "flat") return <div style={{ paddingTop: "10px" }}>
+    <ModelGrid {...props} sortable />
+  </div>;
+
+  return <div className={styles.modelGroups}>
+    {cursorModelGroups(props.models, props.grouping).map((group) => <section className={styles.modelGroup} key={group.key}>
+      <div className={styles.modelGroupHeader}>
+        <Icon icon={group.icon} size="1.1em" />
+        <span>{group.label}</span>
+      </div>
+      <ModelGrid {...props} models={group.models} sortable={false} />
+    </section>)}
+  </div>;
+}
+
+function ModelGrid({
+  models,
+  sortable: sortableEnabled,
+  disabled,
+  testingModelHashes,
+  testResults,
+  onTest,
+  onEdit,
+  onDuplicate,
+  onDelete,
+  onReorder,
+}: ModelGridProps) {
  const grid = useRef<HTMLDivElement>(null);
  const sortable = useRef<Sortable | null>(null);
  const currentModels = useRef(models);
@@ -37,7 +85,7 @@ export function CursorModelCards({
  reorder.current = onReorder;

  useEffect(() => {
-    if (!grid.current) return;
+    if (!sortableEnabled || !grid.current) return;
    sortable.current = Sortable.create(grid.current, {
      animation: 160,
      dataIdAttr: "data-model-hash",
@@ -72,7 +120,7 @@ export function CursorModelCards({
      sortable.current?.destroy();
      sortable.current = null;
    };
-  }, []);
+  }, [sortableEnabled]);

  useEffect(() => {
    sortable.current?.option("disabled", disabled);
@@ -84,14 +132,14 @@ export function CursorModelCards({
      const result = testResults.get(model.model_hash);
      const testing = testingModelHashes.has(model.model_hash);
      return <Card className={styles.modelCard} data-model-hash={model.model_hash} key={model.model_hash}>
-        <button type="button" className={styles.sortHandle} disabled={disabled} aria-label={t("拖动排序")} title={t("拖动排序")} onClick={(event) => event.stopPropagation()}>
+        {sortableEnabled && <button type="button" className={styles.sortHandle} disabled={disabled} aria-label={t("拖动排序")} title={t("拖动排序")} onClick={(event) => event.stopPropagation()}>
          <Icon icon={dragIcon} size="1.25em" />
-        </button>
+        </button>}
        <div className={styles.modelCardContent}>
          <div className={styles.modelCardTop}>
            <div className={styles.modelCardName}>
-              <strong>{model.display_name}</strong>
-              <span>{model.model_id}</span>
+              <span className={styles.modelCardNameText}>{model.display_name}</span>
+              <span className={styles.modelCardModelId}>{model.model_id}</span>
            </div>
            <span className={styles.modelTypeBadge}>
              <Icon icon={model.type === "anthropic" ? claudeIcon : openAiIcon} />
@@ -102,7 +150,7 @@ export function CursorModelCards({
            <CursorModelTestResult state={result} testing={testing} />
          </div>
          <div className={styles.modelCardActions}>
-            <Button size="small" disabled={disabled} onClick={() => onTest(model)}>{testing ? t("测试中…") : t("测试")}</Button>
+            <Button size="small" disabled={disabled && !testing} onClick={() => onTest(model)}>{testing ? t("取消测试") : t("测试")}</Button>
            <Button size="small" disabled={disabled} onClick={() => onEdit(model)}>{t("编辑")}</Button>
            <Button size="small" disabled={disabled} onClick={() => onDuplicate(model)}>{t("复制")}</Button>
            <Button size="small" className={styles.deleteButton} disabled={disabled} onClick={() => onDelete(model)}>{t("删除")}</Button>
@@ -112,3 +160,27 @@ export function CursorModelCards({
    })}
  </div>;
 }
+
+function providerGroup(model: Model) {
+  const label = providerDomain(model.base_url);
+  return { key: label, label, icon: flatColorOrganizationIcon };
+}
+
+function providerDomain(baseUrl: string) {
+  const value = baseUrl.trim();
+  try {
+    return new URL(value).hostname.toLowerCase() || value;
+  } catch {
+    try {
+      return new URL(`https://${value}`).hostname.toLowerCase() || value;
+    } catch {
+      return value;
+    }
+  }
+}
+
+function typeGroup(model: Model) {
+  if (model.type === "anthropic") return { key: "anthropic", label: "Anthropic", icon: claudeIcon };
+  if (model.openai_endpoint === "/v1/chat/completions") return { key: "openai-chat", label: "OpenAI Chat", icon: openAiIcon };
+  return { key: "openai-responses", label: "OpenAI Responses", icon: openAiIcon };
+}
@@ -1,12 +1,14 @@
-import type { ModelInput, ModelType } from "../../api";
-import { defaultCustomHeadersText } from "../../utils/modelDefaults";
-import { Button } from "../ui/Button";
-import { Checkbox } from "../ui/Checkbox";
-import { FormField, SecretTextInput, TextInput } from "../ui/FormControls";
-import { JsonEditor } from "../ui/JsonEditor";
-import { Combobox, Select } from "../ui/Select";
-import { Switch } from "../ui/Switch";
-import { claudeIcon, openAiIcon } from "../ui/icons";
+import type { ModelInput, ModelType } from "../../shared/api";
+import { defaultCustomHeadersText } from "../../shared/utils/modelDefaults";
+import { modelPresets, presetEndpoint, trimTrailingSlash, type ModelPreset } from "../../shared/utils/modelPresets";
+import { Button } from "../../shared/ui/Button";
+import { Checkbox } from "../../shared/ui/Checkbox";
+import { FormField, SecretTextInput, TextInput } from "../../shared/ui/FormControls";
+import { JsonEditor } from "../../shared/ui/JsonEditor";
+import { Combobox, Select } from "../../shared/ui/Select";
+import { Switch } from "../../shared/ui/Switch";
+import { claudeIcon, openAiIcon } from "../../shared/ui/icons";
+import { CursorPresetChips } from "./CursorPresetChips";
 import styles from "./CursorSettings.module.scss";

 export type CursorModelDraft = {
@@ -24,7 +26,7 @@ export const emptyCursorModelDraft = (): CursorModelDraft => ({
    base_url: "",
    use_full_url: false,
    api_key: "",
-    tooltip_data: t("备注"),
+    tooltip_data: "",
    model_id: "",
    reasoning_effort: null,
    openai_endpoint: "/v1/responses",
@@ -53,13 +55,64 @@ export function CursorModelEditor({ draft, modelOptions, discovering, onChange,
  onDiscover: () => void;
 }) {
  const setModel = (patch: Partial<ModelInput>) => onChange({ ...draft, model: { ...draft.model, ...patch } });
-  const setType = (type: ModelType) => setModel({
-    type,
-    openai_endpoint: type === "openai" ? draft.model.openai_endpoint || "/v1/responses" : "",
-    anthropic_thinking_effort: type === "anthropic" ? draft.model.anthropic_thinking_effort || "xhigh" : null,
-  });
+  const setType = (type: ModelType) => {
+    // 切换协议类型时，若当前地址命中某预设的另一协议端点，自动换到该预设对应协议的端点，
+    // 避免出现「类型是 Anthropic、URL 却是 OpenAI chat/completions」的错配
+    const other: ModelType = type === "anthropic" ? "openai" : "anthropic";
+    const preset = modelPresets.find((candidate) => trimTrailingSlash(presetEndpoint(candidate, other).baseUrl) === trimTrailingSlash(draft.model.base_url.trim()));
+    const endpoint = preset ? presetEndpoint(preset, type) : null;
+    onChange({
+      ...draft,
+      model: {
+        ...draft.model,
+        type,
+        ...(endpoint ? {
+          base_url: endpoint.baseUrl,
+          use_full_url: endpoint.useFullUrl,
+          custom_headers_enabled: endpoint.customHeaders !== null,
+          custom_headers: endpoint.customHeaders ? { ...endpoint.customHeaders } : {},
+        } : {}),
+        openai_endpoint: type === "openai" ? (endpoint?.openaiEndpoint || draft.model.openai_endpoint || "/v1/responses") : "",
+        anthropic_thinking_effort: type === "anthropic" ? draft.model.anthropic_thinking_effort || "xhigh" : null,
+      },
+      customHeadersText: endpoint?.customHeaders ? JSON.stringify(endpoint.customHeaders, null, 2) : draft.customHeadersText,
+    });
+  };
  const numberValue = (value: string) => value === "" ? null : Math.trunc(Number(value));
  const canDiscover = Boolean(draft.model.base_url.trim() && draft.model.api_key.trim());
+  // 选中预设后，把该服务商已知的模型 id 并入下拉，方便直接选（仍可用「获取模型」发现）
+  const presetModelOptions = modelPresets
+    .filter((preset) => trimTrailingSlash(presetEndpoint(preset, draft.model.type).baseUrl) === trimTrailingSlash(draft.model.base_url.trim()))
+    .flatMap((preset) => preset.models.map((item) => item.model_id));
+  const combinedOptions = [...new Set([...modelOptions, ...presetModelOptions])];
+  const applyPreset = (preset: ModelPreset) => {
+    const endpoint = presetEndpoint(preset, draft.model.type);
+    const first = preset.models[0];
+    // 切到别家服务商时清空 API Key（不同家的 Key 不能串用）；同一家内切换协议则保留
+    const currentBase = trimTrailingSlash(draft.model.base_url.trim());
+    const sameProvider = [preset.endpoints.anthropic, preset.endpoints.openai]
+      .some((candidate) => trimTrailingSlash(candidate.baseUrl) === currentBase);
+    onChange({
+      ...draft,
+      model: {
+        ...draft.model,
+        base_url: endpoint.baseUrl,
+        use_full_url: endpoint.useFullUrl,
+        openai_endpoint: draft.model.type === "openai" ? endpoint.openaiEndpoint : draft.model.openai_endpoint,
+        custom_headers_enabled: endpoint.customHeaders !== null,
+        custom_headers: endpoint.customHeaders ? { ...endpoint.customHeaders } : {},
+        api_key: sameProvider ? draft.model.api_key : "",
+        model_id: first?.model_id ?? draft.model.model_id,
+        display_name: first?.display_name ?? draft.model.display_name,
+        tooltip_data: !draft.model.tooltip_data.trim() || draft.model.tooltip_data === t("备注") ? preset.name : draft.model.tooltip_data,
+        context_window_tokens: first?.context_window_tokens ?? draft.model.context_window_tokens,
+        ...(draft.model.type === "openai"
+          ? { max_completion_tokens: first?.max_output_tokens ?? draft.model.max_completion_tokens }
+          : { anthropic_max_tokens: first?.max_output_tokens ?? draft.model.anthropic_max_tokens }),
+      },
+      customHeadersText: endpoint.customHeaders ? JSON.stringify(endpoint.customHeaders, null, 2) : draft.customHeadersText,
+    });
+  };
  const requestUrlPlaceholder = draft.model.use_full_url
    ? draft.model.type === "anthropic"
      ? "https://api.anthropic.com/v1/messages"
@@ -71,6 +124,7 @@ export function CursorModelEditor({ draft, modelOptions, discovering, onChange,
      : "https://api.openai.com";

  return <div className={styles.editor}>
+    <CursorPresetChips type={draft.model.type} baseUrl={draft.model.base_url} onPick={applyPreset} />
    <div className={styles.grid}>
      <FormField label={t("模型类型")}><Select ariaLabel={t("模型类型")} value={draft.model.type} options={[
        { value: "openai", label: "OpenAI", icon: openAiIcon },
@@ -87,18 +141,18 @@ export function CursorModelEditor({ draft, modelOptions, discovering, onChange,
      </div>
      <FormField label="API Key" hint={t("访问模型服务所需的密钥。")}> <SecretTextInput placeholder="sk-xxxxxx" autoComplete="off" value={draft.model.api_key} onChange={(event) => setModel({ api_key: event.target.value })} /></FormField>

-      <FormField label={t("模型名称")} hint={t("可以直接输入模型标识，也可以读取接口返回的模型列表。")}> <Combobox value={draft.model.model_id} options={modelOptions} placeholder="gpt-5" append={<Button className={styles.discoverButton} disabled={discovering || !canDiscover} onClick={onDiscover}>{discovering ? t("获取中…") : t("获取模型")}</Button>} onChange={(model_id) => setModel({ model_id, display_name: draft.model.display_name || model_id })} /></FormField>
-      <FormField label={t("显示名称")} hint={t("仅用于界面展示，不会改变发送给模型服务的模型名称。")}> <TextInput value={draft.model.display_name} onChange={(event) => setModel({ display_name: event.target.value })} /></FormField>
-      <FormField className={styles.fullWidth} label={t("备注")} hint={t("显示在 Cursor 模型说明中。")}> <TextInput value={draft.model.tooltip_data} onChange={(event) => setModel({ tooltip_data: event.target.value })} /></FormField>
+      <FormField label={t("模型名称")} hint={t("可以直接输入模型标识，也可以读取接口返回的模型列表。")}> <Combobox value={draft.model.model_id} options={combinedOptions} placeholder="gpt-5" append={<Button className={styles.discoverButton} disabled={discovering || !canDiscover} onClick={onDiscover}>{discovering ? t("获取中…") : t("获取模型")}</Button>} onChange={(model_id) => setModel({ model_id, display_name: draft.model.display_name || model_id })} /></FormField>
+      <FormField label={t("显示名称")} hint={t("仅用于界面展示，不会改变发送给模型服务的模型名称。")}> <TextInput placeholder={t("例如：主力模型")} value={draft.model.display_name} onChange={(event) => setModel({ display_name: event.target.value })} /></FormField>
+      <FormField className={styles.fullWidth} label={t("备注")} hint={t("显示在 Cursor 模型说明中。")}> <TextInput placeholder={t("请输入模型备注")} value={draft.model.tooltip_data} onChange={(event) => setModel({ tooltip_data: event.target.value })} /></FormField>

-      <FormField label={t("上下文窗口 Token")} hint={t("留空时使用默认值。")}> <TextInput type="number" min={1} step={1} value={draft.model.context_window_tokens ?? ""} onChange={(event) => setModel({ context_window_tokens: numberValue(event.target.value) })} /></FormField>
+      <FormField label={t("上下文窗口 Token")} hint={t("留空时使用默认值。")}> <TextInput type="number" min={1} step={1} placeholder={t("留空使用默认值")} value={draft.model.context_window_tokens ?? ""} onChange={(event) => setModel({ context_window_tokens: numberValue(event.target.value) })} /></FormField>
      {draft.model.type === "openai" ? <>
-        <FormField label={t("最大输出 Token")} hint={t("留空时使用默认值。")}> <TextInput type="number" min={1} step={1} value={draft.model.max_completion_tokens ?? ""} onChange={(event) => setModel({ max_completion_tokens: numberValue(event.target.value) })} /></FormField>
+        <FormField label={t("最大输出 Token")} hint={t("留空时使用默认值。")}> <TextInput type="number" min={1} step={1} placeholder={t("留空使用默认值")} value={draft.model.max_completion_tokens ?? ""} onChange={(event) => setModel({ max_completion_tokens: numberValue(event.target.value) })} /></FormField>
        <FormField label={t("推理强度")}> <Select ariaLabel={t("推理强度")} value={draft.model.reasoning_effort ?? ""} options={effortOptions(true)} onChange={(value) => setModel({ reasoning_effort: value || null })} /></FormField>
      </> : <>
-        <FormField label={t("最大输出 Token")} hint={t("留空时使用默认值。")}> <TextInput type="number" min={1} step={1} value={draft.model.anthropic_max_tokens ?? ""} onChange={(event) => setModel({ anthropic_max_tokens: numberValue(event.target.value) })} /></FormField>
+        <FormField label={t("最大输出 Token")} hint={t("留空时使用默认值。")}> <TextInput type="number" min={1} step={1} placeholder={t("留空使用默认值")} value={draft.model.anthropic_max_tokens ?? ""} onChange={(event) => setModel({ anthropic_max_tokens: numberValue(event.target.value) })} /></FormField>
        <FormField label={t("思考强度")}> <Select ariaLabel={t("思考强度")} value={draft.model.anthropic_thinking_effort ?? "xhigh"} options={effortOptions(false)} onChange={(anthropic_thinking_effort) => setModel({ anthropic_thinking_effort })} /></FormField>
-        <FormField label={t("思考预算 Token")} hint={t("留空时使用 adaptive thinking。")}> <TextInput type="number" min={1} step={1} value={draft.model.thinking_budget_tokens ?? ""} onChange={(event) => setModel({ thinking_budget_tokens: numberValue(event.target.value) })} /></FormField>
+        <FormField label={t("思考预算 Token")} hint={t("留空时使用 adaptive thinking。")}> <TextInput type="number" min={1} step={1} placeholder={t("留空使用 adaptive thinking")} value={draft.model.thinking_budget_tokens ?? ""} onChange={(event) => setModel({ thinking_budget_tokens: numberValue(event.target.value) })} /></FormField>
      </>}

      <ToggleJsonField
@@ -1,16 +1,18 @@
-import type { ModelConnectivityResult } from "../../api";
-import { Icon } from "../ui/Icon";
-import { TooltipTrigger } from "../ui/TooltipTrigger";
-import { informationOutlineIcon } from "../ui/icons";
+import type { ModelConnectivityResult } from "../../shared/api";
+import { Icon } from "../../shared/ui/Icon";
+import { TooltipTrigger } from "../../shared/ui/TooltipTrigger";
+import { informationOutlineIcon } from "../../shared/ui/icons";
 import styles from "./CursorModelTestResult.module.scss";

 export type CursorModelTestState =
  | { status: "success"; result: ModelConnectivityResult }
-  | { status: "error"; error: string };
+  | { status: "error"; error: string }
+  | { status: "cancelled" };

 export function CursorModelTestResult({ state, testing = false }: { state?: CursorModelTestState; testing?: boolean }) {
  if (testing) return <div className={`${styles.root} ${styles.testing}`}><span className={styles.summary}>{t("测试中…")}</span></div>;
  if (!state) return <div className={`${styles.root} ${styles.idle}`}><span className={styles.summary}>{t("未测试")}</span></div>;
+  if (state.status === "cancelled") return <div className={`${styles.root} ${styles.idle}`}><span className={styles.summary}>{t("测试已取消")}</span></div>;

  const success = state.status === "success";
  const summary = success
@@ -19,7 +21,7 @@ export function CursorModelTestResult({ state, testing = false }: { state?: Curs
  const detail = success
    ? t("速度 {speed} tokens/s · 首字 {firstText} ms · 总耗时 {duration} ms · 输出 {tokens} tokens{estimated} · 返回：{output}", {
      speed: formatSpeed(state.result.tokens_per_second),
-      firstText: state.result.first_text_ms ?? "--",
+      firstText: state.result.first_valid_response_ms ?? "--",
      duration: state.result.duration_ms,
      tokens: state.result.output_tokens,
      estimated: state.result.tokens_estimated ? t("（估算）") : "",
@@ -0,0 +1,47 @@
+.wrap {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  flex-wrap: wrap;
+}
+
+.label {
+  font-size: 12px;
+  color: var(--vscode-descriptionForeground, rgba(255, 255, 255, 0.7));
+}
+
+.chips {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  flex-wrap: wrap;
+}
+
+.chip {
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+  padding: 3px 10px;
+  border: 1px solid var(--vscode-editorWidget-border, rgba(255, 255, 255, 0.16));
+  border-radius: 999px;
+  background: transparent;
+  color: inherit;
+  font-size: 12px;
+  cursor: pointer;
+
+  &:hover {
+    border-color: var(--vscode-focusBorder, #49b0ff);
+  }
+
+  &.active {
+    border-color: var(--vscode-focusBorder, #49b0ff);
+    color: var(--vscode-focusBorder, #49b0ff);
+  }
+}
+
+.icon {
+  width: 14px;
+  height: 14px;
+  border-radius: 3px;
+  object-fit: contain;
+}
@@ -0,0 +1,25 @@
+import type { ModelType } from "../../shared/api";
+import { modelPresets, presetEndpoint, trimTrailingSlash, type ModelPreset } from "../../shared/utils/modelPresets";
+import styles from "./CursorPresetChips.module.scss";
+
+/** 常用服务商预设：点击按当前协议类型自动填充对应端点与默认模型 */
+export function CursorPresetChips({ type, baseUrl, onPick }: { type: ModelType; baseUrl: string; onPick: (preset: ModelPreset) => void }) {
+  return <div className={styles.wrap}>
+    <span className={styles.label}>{t("常用预设")}</span>
+    <div className={styles.chips}>
+      {modelPresets.map((preset) => {
+        const active = trimTrailingSlash(baseUrl) === trimTrailingSlash(presetEndpoint(preset, type).baseUrl);
+        return <button
+          type="button"
+          key={preset.key}
+          className={active ? `${styles.chip} ${styles.active}` : styles.chip}
+          title={preset.keyHint}
+          onClick={() => onPick(preset)}
+        >
+          <img className={styles.icon} src={preset.icon} alt="" />
+          {preset.name}
+        </button>;
+      })}
+    </div>
+  </div>;
+}
@@ -5,6 +5,29 @@
  gap: 16px;
 }

+.groupActions {
+  display: flex;
+  align-items: center;
+  overflow: hidden;
+  border-radius: 5px;
+
+  button {
+    height: 25px;
+    padding: 0 8px;
+    color: var(--vscode-descriptionForeground);
+    background: transparent;
+    border: 0;
+    border-right: 1px solid var(--vscode-sideBar-border);
+    font-size: type.$font-size-xs;
+    white-space: nowrap;
+
+    &:last-child { border-right: 0; }
+    &:hover:not(:disabled) { color: var(--vscode-foreground); background: var(--vscode-list-hoverBackground); }
+    &[aria-pressed="true"] { color: var(--vscode-list-activeSelectionForeground); background: var(--vscode-list-activeSelectionBackground); }
+    &:disabled { opacity: 0.5; cursor: not-allowed; }
+  }
+}
+
 .gateActions {
  display: flex;
  align-items: center;
@@ -39,13 +62,34 @@
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(250px, 1fr));
  gap: 12px;
+
+}
+.modelGroups {
+  display: flex;
+  flex-direction: column;
+  gap: 20px;
+  padding-top: 10px;
+}
+.modelGroup {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+}
+.modelGroupHeader {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  color: var(--vscode-foreground);
+  font-size: type.$font-size-base;
+  opacity: 0.6;
+  padding-left: 6px;
 }
 .modelCard {
  position: relative;
  padding: 16px;
 }
 .modelCardContent {
-  height: 150px;
+  min-height: 120px;
  display: flex;
  flex-direction: column;
  justify-content: space-between;
@@ -64,19 +108,19 @@
  flex-direction: column;
  gap: 4px;

-  strong,
-  span {
+  .modelCardNameText,
+  .modelCardModelId {
    overflow: hidden;
    text-overflow: ellipsis;
    white-space: nowrap;
  }
-  strong {
+  .modelCardNameText {
    color: var(--vscode-foreground);
    font-size: type.$font-size-base;
  }
-  span {
+  .modelCardModelId {
    color: var(--vscode-descriptionForeground);
-    font-size: type.$font-size-xs;
+    font-size: type.$font-size-2xs;
  }
 }
 .modelTypeBadge {
@@ -1,21 +1,21 @@
-import { useCallback, useEffect, useState } from "react";
-import { api, type Model, type ModelInput } from "../api";
-import { CursorCaGate, CursorCaProvider, CursorModelGate, CursorModelProvider } from "../components/cursor/CursorGates";
-import { CursorModelCards } from "../components/cursor/CursorModelCards";
-import { CursorModelEditor, emptyCursorModelDraft, type CursorModelDraft } from "../components/cursor/CursorModelEditor";
-import { CursorModelTestResult, type CursorModelTestState } from "../components/cursor/CursorModelTestResult";
-import styles from "../components/cursor/CursorSettings.module.scss";
-import { PageContent } from "../components/layout/PageContent";
-import { LegacyModelImport } from "../components/models/LegacyModelImport";
-import { ConfirmDialog } from "../components/ui/ConfirmDialog";
-import controls from "../components/ui/Controls.module.scss";
-import { Icon } from "../components/ui/Icon";
-import { Modal } from "../components/ui/Modal";
-import { TooltipTrigger } from "../components/ui/TooltipTrigger";
-import { addIcon } from "../components/ui/icons";
-import { useMessage } from "../components/ui/message";
-import { PageActions } from "../layouts/PageActions";
-import { appStore, useAppStore } from "../store/appStore";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { api, type Model, type ModelInput } from "../../shared/api";
+import { CursorCaGate, CursorCaProvider, CursorModelGate, CursorModelProvider } from "./CursorGates";
+import { CursorModelCards, cursorModelGroups, type CursorModelGrouping } from "./CursorModelCards";
+import { CursorModelEditor, emptyCursorModelDraft, type CursorModelDraft } from "./CursorModelEditor";
+import { CursorModelTestResult, type CursorModelTestState } from "./CursorModelTestResult";
+import styles from "./CursorSettings.module.scss";
+import { PageContent } from "../../shell/layout/PageContent";
+import { LegacyModelImport } from "./LegacyModelImport";
+import { ConfirmDialog } from "../../shared/ui/ConfirmDialog";
+import controls from "../../shared/ui/Controls.module.scss";
+import { Icon } from "../../shared/ui/Icon";
+import { Modal } from "../../shared/ui/Modal";
+import { TooltipTrigger } from "../../shared/ui/TooltipTrigger";
+import { addIcon } from "../../shared/ui/icons";
+import { useMessage } from "../../shared/ui/message";
+import { PageActions } from "../../shell/PageActions";
+import { appStore, useAppStore } from "../../shared/store/appStore";

 export function CursorSettingsPage() {
  const { models, cursorHarness, cursorBusy } = useAppStore();
@@ -31,7 +31,19 @@ export function CursorSettingsPage() {
  const [modelTestResults, setModelTestResults] = useState<Map<string, CursorModelTestState>>(() => new Map());
  const [savingAndTesting, setSavingAndTesting] = useState(false);
  const [batchTesting, setBatchTesting] = useState(false);
+  const [grouping, setGrouping] = useState<CursorModelGrouping>("flat");
+  const activeModelTests = useRef(new Map<string, { testId: string; controller: AbortController; cancelling: boolean }>());
  const caReady = cursorHarness?.ca === "ready";
+  const providerGroups = cursorModelGroups(models, "provider");
+  const typeGroups = cursorModelGroups(models, "type");
+  const canGroupByProvider = providerGroups.length > 1;
+  const canGroupByType = typeGroups.length > 1;
+
+  useEffect(() => {
+    if ((grouping === "provider" && !canGroupByProvider) || (grouping === "type" && !canGroupByType)) {
+      setGrouping("flat");
+    }
+  }, [canGroupByProvider, canGroupByType, grouping]);

  useEffect(() => {
    if (caCommand) void api.copyCursorText(caCommand);
@@ -93,19 +105,45 @@ export function CursorSettingsPage() {
      message(errorText(cause));
    }
  };
-  const testModel = async (model: Model, notify = true) => {
+  const cancelModelTest = async (modelHash: string) => {
+    const active = activeModelTests.current.get(modelHash);
+    if (!active || active.cancelling) return;
+    active.cancelling = true;
+    try {
+      await api.cancelModelTest(modelHash, active.testId);
+      active.controller.abort();
+    } catch (cause) {
+      active.cancelling = false;
+      message(t("取消测试失败：{error}", { error: errorText(cause) }), { duration: 5000 });
+    }
+  };
+  const cancelAllModelTests = async () => {
+    await Promise.all([...activeModelTests.current.keys()].map((modelHash) => cancelModelTest(modelHash)));
+  };
+  const testModel = async (model: Model, notify = true): Promise<"success" | "failure" | "cancelled"> => {
+    if (activeModelTests.current.has(model.model_hash)) {
+      await cancelModelTest(model.model_hash);
+      return "cancelled";
+    }
+    const active = { testId: crypto.randomUUID(), controller: new AbortController(), cancelling: false };
+    activeModelTests.current.set(model.model_hash, active);
    setTestingModelHashes((current) => new Set(current).add(model.model_hash));
    try {
-      const result = await api.testModel(model.model_hash);
+      const result = await api.testModel(model.model_hash, active.testId, active.controller.signal);
      setModelTestResults((current) => new Map(current).set(model.model_hash, { status: "success", result }));
      if (notify) message(t("模型 {model} 连通性测试成功（{duration} ms）", { model: model.display_name, duration: result.duration_ms }));
-      return true;
+      return "success";
    } catch (cause) {
+      if (active.cancelling || active.controller.signal.aborted) {
+        setModelTestResults((current) => new Map(current).set(model.model_hash, { status: "cancelled" }));
+        return "cancelled";
+      }
      const error = errorText(cause);
      setModelTestResults((current) => new Map(current).set(model.model_hash, { status: "error", error }));
      if (notify) message(t("连通性测试失败：{error}", { error }), { duration: 5000 });
-      return false;
+      return "failure";
    } finally {
+      if (activeModelTests.current.get(model.model_hash) === active) activeModelTests.current.delete(model.model_hash);
      setTestingModelHashes((current) => {
        const next = new Set(current);
        next.delete(model.model_hash);
@@ -115,29 +153,33 @@ export function CursorSettingsPage() {
  };
  const saveAndTest = async () => {
    setSavingAndTesting(true);
+    let saved: Model | null = null;
    try {
-      const saved = await persist();
-      if (!saved) return;
-      setEditing(saved);
-      await testModel(saved);
-      await appStore.refresh();
+      saved = await persist();
    } catch (cause) {
      message(errorText(cause));
    } finally {
      setSavingAndTesting(false);
    }
+    if (!saved) return;
+    setEditing(saved);
+    await testModel(saved);
+    await appStore.refresh();
  };
  const testAllModels = async () => {
    if (!models.length || batchTesting) return;
    setBatchTesting(true);
    try {
      const results = await Promise.all(models.map((model) => testModel(model, false)));
-      const successful = results.filter(Boolean).length;
-      const failed = models.length - successful;
-      message(failed === 0
-        ? t("全部 {count} 个模型连通性测试成功", { count: models.length })
-        : t("连通性测试完成：成功 {successful}，失败 {failed}", { successful, failed }),
-      { duration: failed === 0 ? 2400 : 5000 });
+      const successful = results.filter((result) => result === "success").length;
+      const failed = results.filter((result) => result === "failure").length;
+      const cancelled = results.filter((result) => result === "cancelled").length;
+      message(cancelled > 0
+        ? t("连通性测试已取消：成功 {successful}，失败 {failed}", { successful, failed })
+        : failed === 0
+          ? t("全部 {count} 个模型连通性测试成功", { count: models.length })
+          : t("连通性测试完成：成功 {successful}，失败 {failed}", { successful, failed }),
+      { duration: failed === 0 && cancelled === 0 ? 2400 : 5000 });
    } finally {
      setBatchTesting(false);
    }
@@ -166,7 +208,8 @@ export function CursorSettingsPage() {

  const list = <CursorModelCards
    models={models}
-    disabled={testingModelHashes.size > 0 || cursorBusy || batchTesting}
+    grouping={grouping}
+    disabled={cursorBusy}
    testingModelHashes={testingModelHashes}
    testResults={modelTestResults}
    onTest={(model) => void testModel(model)}
@@ -194,13 +237,24 @@ export function CursorSettingsPage() {
  </CursorCaGate></CursorCaProvider>;

  const editorTestState = editing ? modelTestResults.get(editing.model_hash) : undefined;
-  const editorTesting = savingAndTesting || Boolean(editing && testingModelHashes.has(editing.model_hash));
+  const editorTesting = Boolean(editing && testingModelHashes.has(editing.model_hash));
+  const activeGroups = grouping === "provider" ? providerGroups : typeGroups;
+  const estimatedModelHeight = grouping === "flat"
+    ? Math.max(380, Math.ceil(models.length / 3) * 196)
+    : Math.max(380, activeGroups.reduce((height, group) => height + Math.ceil(group.models.length / 3) * 196 + 34, 0) + Math.max(0, activeGroups.length - 1) * 20);

  return <>
-    {models.length > 0 && <PageActions position="left"><button type="button" className={controls.secondary} disabled={cursorBusy || testingModelHashes.size > 0 || batchTesting} onClick={() => void testAllModels()}>{batchTesting ? t("测试中…") : t("一键测试")}</button></PageActions>}
+    {models.length > 0 && <PageActions position="left">
+      <div className={styles.groupActions} role="group" aria-label={t("操作")}>
+        <button type="button" aria-pressed={grouping === "flat"} onClick={() => setGrouping("flat")}>{t("默认平铺")}</button>
+        {canGroupByProvider && <button type="button" aria-pressed={grouping === "provider"} onClick={() => setGrouping("provider")}>{t("按供应商")}</button>}
+        {canGroupByType && <button type="button" aria-pressed={grouping === "type"} onClick={() => setGrouping("type")}>{t("按类型")}</button>}
+        <button type="button" disabled={cursorBusy || (!batchTesting && testingModelHashes.size > 0)} onClick={() => void (batchTesting ? cancelAllModelTests() : testAllModels())}>{batchTesting ? t("取消全部测试") : t("一键测试")}</button>
+      </div>
+    </PageActions>}
    <PageActions><TooltipTrigger label={caReady ? t("添加模型") : t("请先初始化 CA")}><button className={controls.iconButton} aria-label={t("添加模型")} disabled={!caReady || cursorBusy} onClick={openNew}><Icon icon={addIcon} size="1.1em" /></button></TooltipTrigger></PageActions>
-    <PageContent title={t("Cursor 配置")} sections={[{ key: "cursor-settings", estimatedHeight: Math.max(380, Math.ceil(models.length / 3) * 196), content }]} />
-    <Modal open={draft !== null} title={editing ? t("编辑模型") : t("添加模型")} banner={draft && (editorTesting || editorTestState) ? <CursorModelTestResult state={editorTestState} testing={editorTesting} /> : undefined} busy={cursorBusy || savingAndTesting} onClose={() => setDraft(null)} onSubmit={() => void save()} secondaryAction={<button type="button" className={controls.secondary} disabled={cursorBusy || savingAndTesting} onClick={() => void saveAndTest()}>{savingAndTesting ? t("测试中…") : t("保存并测试")}</button>}>
+    <PageContent title={t("Cursor 配置")} sections={[{ key: "cursor-settings", estimatedHeight: estimatedModelHeight, content }]} />
+    <Modal fullHeight open={draft !== null} title={editing ? t("编辑模型") : t("添加模型")} banner={draft && (editorTesting || editorTestState) ? <CursorModelTestResult state={editorTestState} testing={editorTesting} /> : undefined} busy={cursorBusy || savingAndTesting} onClose={() => { if (editing && editorTesting) void cancelModelTest(editing.model_hash); setDraft(null); setEditing(null); }} onSubmit={() => void save()} secondaryAction={<button type="button" className={controls.secondary} disabled={cursorBusy || savingAndTesting} onClick={() => void (editorTesting && editing ? cancelModelTest(editing.model_hash) : saveAndTest())}>{savingAndTesting ? t("处理中…") : editorTesting ? t("取消测试") : t("保存并测试")}</button>}>
      {draft && <>
        <CursorModelEditor draft={draft} modelOptions={modelOptions} discovering={discovering} onChange={setDraft} onDiscover={() => void discover()} />
      </>}
@@ -1,8 +1,8 @@
 import { useState, type ReactNode } from "react";
-import { api, type LegacyModelImportPreview } from "../../api";
-import { appStore } from "../../store/appStore";
-import { ConfirmDialog } from "../ui/ConfirmDialog";
-import { useMessage } from "../ui/message";
+import { api, type LegacyModelImportPreview } from "../../shared/api";
+import { appStore } from "../../shared/store/appStore";
+import { ConfirmDialog } from "../../shared/ui/ConfirmDialog";
+import { useMessage } from "../../shared/ui/message";
 import styles from "./LegacyModelImport.module.scss";

 type LegacyModelImportControl = {
@@ -1,28 +1,32 @@
 import { useEffect, useState } from "react";
 import {
  currentAppVersion,
+  hasDockVisibilitySetting,
  hasNativeAppLifecycle,
  readAutostart,
-  readSilentStart,
+  readDesktopSettings,
  writeAutostart,
+  writeDockIconVisibility,
  writeSilentStart,
-} from "../../native/appLifecycle";
-import { updateStore, useUpdateStore } from "../../store/updateStore";
-import { Button } from "../ui/Button";
-import { Switch } from "../ui/Switch";
-import { TitledCard } from "../ui/TitledCard";
-import { useMessage } from "../ui/message";
+} from "../../shared/native/appLifecycle";
+import { updateStore, useUpdateStore } from "../../shared/store/updateStore";
+import { Button } from "../../shared/ui/Button";
+import { Switch } from "../../shared/ui/Switch";
+import { TitledCard } from "../../shared/ui/TitledCard";
+import { useMessage } from "../../shared/ui/message";
 import styles from "./AppLifecycleSettingsCard.module.scss";

 export function AppLifecycleSettingsCard() {
  const message = useMessage();
  const native = hasNativeAppLifecycle();
+  const dockVisibilitySetting = hasDockVisibilitySetting();
  const { availableVersion, checking, installing } = useUpdateStore();
  const [version, setVersion] = useState("…");
  const [autostart, setAutostart] = useState(false);
  const [loadingAutostart, setLoadingAutostart] = useState(native);
  const [silentStart, setSilentStart] = useState(false);
-  const [loadingSilentStart, setLoadingSilentStart] = useState(native);
+  const [dockIconVisible, setDockIconVisible] = useState(true);
+  const [loadingDesktopSettings, setLoadingDesktopSettings] = useState(native);

  useEffect(() => {
    let disposed = false;
@@ -32,10 +36,17 @@ export function AppLifecycleSettingsCard() {
        .then((enabled) => { if (!disposed) setAutostart(enabled); })
        .catch((cause) => message(cause instanceof Error ? cause.message : String(cause)))
        .finally(() => { if (!disposed) setLoadingAutostart(false); });
-      void readSilentStart()
-        .then((silent) => { if (!disposed) setSilentStart(silent); })
+      void readDesktopSettings()
+        .then((settings) => {
+          if (disposed) return;
+          setSilentStart(settings.silent_start);
+          setDockIconVisible(settings.show_dock_icon);
+        })
        .catch(() => {})
-        .finally(() => { if (!disposed) setLoadingSilentStart(false); });
+        .finally(() => {
+          if (disposed) return;
+          setLoadingDesktopSettings(false);
+        });
    }
    return () => { disposed = true; };
  }, [message, native]);
@@ -55,14 +66,27 @@ export function AppLifecycleSettingsCard() {

  const toggleSilentStart = async (enabled: boolean) => {
    try {
-      setLoadingSilentStart(true);
+      setLoadingDesktopSettings(true);
      await writeSilentStart(enabled);
-      setSilentStart(await readSilentStart());
+      setSilentStart(enabled);
      message(enabled ? t("已开启静默启动") : t("已关闭静默启动"));
    } catch (cause) {
      message(cause instanceof Error ? cause.message : String(cause));
    } finally {
-      setLoadingSilentStart(false);
+      setLoadingDesktopSettings(false);
+    }
+  };
+
+  const toggleDockIcon = async (visible: boolean) => {
+    try {
+      setLoadingDesktopSettings(true);
+      await writeDockIconVisibility(visible);
+      setDockIconVisible(visible);
+      message(visible ? t("已显示 Dock 栏图标") : t("已隐藏 Dock 栏图标"));
+    } catch (cause) {
+      message(cause instanceof Error ? cause.message : String(cause));
+    } finally {
+      setLoadingDesktopSettings(false);
    }
  };

@@ -103,11 +127,23 @@ export function AppLifecycleSettingsCard() {
      </div>
      <Switch
        checked={silentStart}
-        disabled={!native || loadingSilentStart}
+        disabled={!native || loadingDesktopSettings}
        label={t("静默启动")}
        onChange={(enabled) => void toggleSilentStart(enabled)}
      />
    </div>}
+    {dockVisibilitySetting && <div className={styles.row}>
+      <div>
+        <strong>{t("在 Dock 栏显示")}</strong>
+        <small>{t("关闭后隐藏 Dock 栏图标，仍可通过菜单栏图标打开应用。")}</small>
+      </div>
+      <Switch
+        checked={dockIconVisible}
+        disabled={loadingDesktopSettings}
+        label={t("在 Dock 栏显示")}
+        onChange={(visible) => void toggleDockIcon(visible)}
+      />
+    </div>}
    <div className={styles.row}>
      <div>
        <strong>{t("软件更新")}</strong>
@@ -1,9 +1,9 @@
-import type { ProxySettings, ProxySettingsInput } from "../../api";
-import { Button } from "../ui/Button";
-import { Checkbox } from "../ui/Checkbox";
-import { TextInput } from "../ui/FormControls";
-import { Select } from "../ui/Select";
-import { TitledCard } from "../ui/TitledCard";
+import type { ProxySettings, ProxySettingsInput } from "../../shared/api";
+import { Button } from "../../shared/ui/Button";
+import { Checkbox } from "../../shared/ui/Checkbox";
+import { TextInput } from "../../shared/ui/FormControls";
+import { Select } from "../../shared/ui/Select";
+import { TitledCard } from "../../shared/ui/TitledCard";
 import styles from "./ProxySettingsCard.module.scss";

 export function ProxySettingsCard({
@@ -1,4 +1,4 @@
-@use "../styles/typography" as type;
+@use "../../styles/typography" as type;

 .page {
  display: grid;
@@ -41,6 +41,15 @@
  }
 }

+.textButton {
+  padding: 4px;
+  color: var(--vscode-textLink-foreground);
+  background: transparent;
+  border: 0;
+
+  &:hover { color: var(--vscode-textLink-activeForeground); }
+}
+
 .importRow {
  display: flex;
  align-items: center;
@@ -59,15 +68,6 @@
  }
 }

-.textButton {
-  padding: 4px;
-  color: var(--vscode-textLink-foreground);
-  background: transparent;
-  border: 0;
-
-  &:hover { color: var(--vscode-textLink-activeForeground); }
-}
-
 .confirmContent {
  display: grid;
  gap: 8px;
@@ -155,6 +155,7 @@
    align-items: stretch;
    flex-direction: column;
  }
+
 }

 .themeActions .selected {
@@ -1,20 +1,20 @@
 import { useEffect, useState } from "react";
-import { api, type ProxySettings, type ProxySettingsInput, type StatisticsStorage, type TabSettings } from "../api";
-import { PageContent } from "../components/layout/PageContent";
-import { LegacyModelImport } from "../components/models/LegacyModelImport";
-import { AppLifecycleSettingsCard } from "../components/settings/AppLifecycleSettingsCard";
-import { ProxySettingsCard } from "../components/settings/ProxySettingsCard";
-import { TabSettingsCard } from "../components/settings/TabSettingsCard";
-import { Button } from "../components/ui/Button";
-import { Checkbox } from "../components/ui/Checkbox";
-import { ConfirmDialog } from "../components/ui/ConfirmDialog";
-import { FormField, TextInput } from "../components/ui/FormControls";
-import { Select } from "../components/ui/Select";
-import { TitledCard } from "../components/ui/TitledCard";
-import { setLocalePreference, useI18n, type LocalePreference } from "../i18n/store";
-import { useMessage } from "../components/ui/message";
-import { appStore, useAppStore } from "../store/appStore";
-import { themeOptions } from "../theme/theme";
+import { api, type ProxySettings, type ProxySettingsInput, type StatisticsStorage, type StatisticsStorageScope, type TabSettings } from "../../shared/api";
+import { PageContent } from "../../shell/layout/PageContent";
+import { LegacyModelImport } from "../models/LegacyModelImport";
+import { AppLifecycleSettingsCard } from "./AppLifecycleSettingsCard";
+import { ProxySettingsCard } from "./ProxySettingsCard";
+import { TabSettingsCard } from "./TabSettingsCard";
+import { Button } from "../../shared/ui/Button";
+import { Checkbox } from "../../shared/ui/Checkbox";
+import { ConfirmDialog } from "../../shared/ui/ConfirmDialog";
+import { FormField, TextInput } from "../../shared/ui/FormControls";
+import { Select } from "../../shared/ui/Select";
+import { TitledCard } from "../../shared/ui/TitledCard";
+import { setLocalePreference, useI18n, type LocalePreference } from "../../i18n/store";
+import { useMessage } from "../../shared/ui/message";
+import { appStore, useAppStore } from "../../shared/store/appStore";
+import { themeOptions } from "../../shared/theme/theme";
 import styles from "./SettingsPage.module.scss";

 export function SettingsPage() {
@@ -27,6 +27,7 @@ export function SettingsPage() {
  const [savingPorts, setSavingPorts] = useState(false);
  const [storage, setStorage] = useState<StatisticsStorage | null>(null);
  const [confirmClear, setConfirmClear] = useState(false);
+  const [clearScope, setClearScope] = useState<StatisticsStorageScope>("details");
  const [clearing, setClearing] = useState(false);
  const [outboundProxy, setOutboundProxy] = useState<ProxySettings | null>(null);
  const [proxyDraft, setProxyDraft] = useState<ProxySettingsInput>({ mode: "system", address: "", auth_enabled: false, username: "", password: "" });
@@ -87,10 +88,10 @@ export function SettingsPage() {
  const clearStorage = async () => {
    try {
      setClearing(true);
-      setStorage(await api.clearStatisticsStorage());
+      setStorage(await api.clearStatisticsStorage(clearScope));
      setConfirmClear(false);
      await appStore.refresh();
-      message(t("统计数据已清理"));
+      message(clearScope === "all" ? t("全部统计数据已清理") : t("详细记录已清理"));
    } catch (cause) {
      message(cause instanceof Error ? cause.message : String(cause));
    } finally {
@@ -154,6 +155,10 @@ export function SettingsPage() {
    while (value >= 1024 && unit < units.length - 1) { value /= 1024; unit += 1; }
    return `${value < 10 ? value.toFixed(1) : Math.round(value)} ${units[unit]}`;
  };
+  const clearTitle = clearScope === "all" ? t("确定要清理全部统计数据吗？") : t("确定要清理详细记录吗？");
+  const clearDescription = clearScope === "all"
+    ? t("所有调用汇总、详细内容和追踪记录都会被删除。模型配置、CA 和应用设置不会受到影响，此操作无法撤销。")
+    : t("仅删除请求、响应和追踪附件等详细内容，保留调用汇总、统计指标和配置。");
  const content = (
    <div className={styles.page}>
      <TitledCard title={t("调用观测")}>
@@ -278,7 +283,7 @@ export function SettingsPage() {
          <button
            type="button"
            className={styles.textButton}
-            onClick={() => setConfirmClear(true)}
+            onClick={() => { setClearScope("details"); setConfirmClear(true); }}
          >
            {t("清理存储空间")}
          </button>
@@ -286,7 +291,7 @@ export function SettingsPage() {
      </TitledCard>
      <ConfirmDialog
        open={confirmClear}
-        title={t("确定要清理所有统计数据吗？")}
+        title={clearTitle}
        busy={clearing}
        cancelLabel={t("取消")}
        confirmLabel={t("确认清理")}
@@ -294,11 +299,16 @@ export function SettingsPage() {
        onConfirm={() => void clearStorage()}
      >
        <div className={styles.confirmContent}>
-          <small>
-            {t(
-              "所有调用记录和详细追踪数据都会被删除。模型配置、CA 和应用设置不会受到影响，此操作无法撤销。",
-            )}
-          </small>
+          <Select
+            value={clearScope}
+            ariaLabel={t("清理范围")}
+            options={[
+              { value: "details", label: t("仅清理详细记录") },
+              { value: "all", label: t("清理全部统计数据") },
+            ]}
+            onChange={(value) => setClearScope(value as StatisticsStorageScope)}
+          />
+          <small>{clearDescription}</small>
        </div>
      </ConfirmDialog>
    </div>
@@ -1,10 +1,10 @@
-import cursorIconUrl from "../../assets/icons/cursor.svg";
-import type { TabMode, TabSettings } from "../../api";
-import { Button } from "../ui/Button";
-import { TextInput } from "../ui/FormControls";
-import { Icon } from "../ui/Icon";
-import { Select } from "../ui/Select";
-import { TitledCard } from "../ui/TitledCard";
+import cursorIconUrl from "../../shared/assets/icons/cursor.svg";
+import type { TabMode, TabSettings } from "../../shared/api";
+import { Button } from "../../shared/ui/Button";
+import { TextInput } from "../../shared/ui/FormControls";
+import { Icon } from "../../shared/ui/Icon";
+import { Select } from "../../shared/ui/Select";
+import { TitledCard } from "../../shared/ui/TitledCard";
 import styles from "./TabSettingsCard.module.scss";

 export function TabSettingsCard({
@@ -10,13 +10,13 @@
  "076832c1b2de22c3": "Cache write: {tokens}",
  "07879e064ae16542": "Estimated output: {tokens}",
  "07c657ed4747126e": "Anthropic extra parameters",
-  "08d742566ffc9fa3": "Clear all statistics?",
  "092b520558eff5f2": "Not tested",
  "099008ea7a42ebd1": "All custom Header values must be strings",
  "09ebc2643631ba25": "Estimated value",
  "0b96da34f6fbdd3b": "Cache read: {tokens} × ${price}/1M = {cost}",
  "0c70665b6eb65f1a": "No",
  "0c72229b7db0e1a9": "Model output",
+  "0d2dab3d62eb73d6": "All statistics cleared",
  "0d5e2bdb15579fc4": "Messages",
  "0e41f8e3d59ec47b": "Storage management",
  "0e67021ebf0a3580": "Import complete: added {imported} models and skipped {skipped} existing models",
@@ -47,6 +47,8 @@
  "20e14248fd4fb981": "{label} must be an integer greater than 0",
  "217cfe7db1e3d10a": "Use system language",
  "22c6b4eb4caee6ae": "Proxy settings saved",
+  "22d7895ea5fca72e": "By provider",
+  "23ae7a90b1b9816d": "Clear scope",
  "23e49479e15e6770": "Version {version} is available",
  "24a0a24864454575": "Existing, skipped",
  "2555d6c7fbb7e070": "Enter a model ID directly or load models returned by the API.",
@@ -70,7 +72,7 @@
  "37125ef2e1d707cb": "Server address or complete request URL, API Key, model name, display name, and note are required",
  "378bb0eec39fa8a2": "Last page",
  "37cb98ff4d5dcfcc": "Successful {successful} / failed {failed}",
-  "393df9bb13ea4900": "Hit",
+  "382f2e3419a02fef": "Only clear detailed records",
  "393e1241552b1870": "Request",
  "398f8e6c6f0a0b97": "Continue selecting or typing",
  "39f52eee100131d7": "Cached input",
@@ -78,12 +80,15 @@
  "3a3f595df70ec8ff": "Clear storage",
  "3a5040b68abf75f9": "Select all",
  "3a8c76b2ce785f96": "Review and import",
+  "3b67824289b5fa1e": "Dock icon hidden",
  "3c94b4c75940c178": "Input Tokens",
  "3cfae5728b92b334": "Token usage: {tokens}",
  "3d13868593ae4eeb": "Display language",
  "3da0bf1610ff5db5": "Recommended",
  "3f6c25aa329163a4": "The original endpoint path is appended to this service address.",
+  "3fd118e2ffe0b2b6": "Cancel all tests",
  "3fd47edce45b3603": "Close",
+  "40a08e7cf320ae07": "Clear detailed records?",
  "4125fc7ba333524c": "Default light",
  "42655ed8e4108ae2": "Input (non-cached)",
  "42a1d9e5b037c210": "Bytes",
@@ -98,6 +103,7 @@
  "4927a53bcc886afb": "Loading…",
  "497c85690c4cc0fc": "No data",
  "499c729eb09aa2a6": "Context window tokens",
+  "49be72e6045c007d": "Cancel test",
  "4a8d6841b4023edf": "Confirm import",
  "4b458e6e147221d7": "The standard endpoint path is appended automatically for the selected protocol.",
  "4d0680f9efaef147": "Unread",
@@ -119,8 +125,8 @@
  "5a284a1a2be8da0e": "Read models from the local legacy configuration. New and existing models are shown before confirmation.",
  "5a3bd99fa69a40c1": "Use public service",
  "5b17f59d33bde39e": "Error: {error}",
+  "5ba65a74c4e792c5": "By type",
  "5c55a67935af8f45": "All",
-  "5cae248525cb9140": "All call records and detailed traces will be deleted. Model configuration, CA, and application settings are unaffected. This action cannot be undone.",
  "5d59857bf039cac9": "Cursor Assistant v{version}",
  "5f8d556a9c47da3c": "Launch at login disabled",
  "5f9acfb945229062": "Are you sure you no longer want to see this ad?",
@@ -139,6 +145,8 @@
  "656ab25e264cc4e4": "No models are available to Cursor yet",
  "65a6318e07ec1e07": "Tools",
  "65cb9a7b4f620b6b": "Prompt {tokens}",
+  "680680288a6d2ad2": "Show in Dock",
+  "68102220092c1f0f": "Detailed records cleared",
  "68ad603fafe4e0d6": "Import legacy configuration",
  "68ea5dd4d7af20e6": "System settings",
  "6a9906c79f26c0ba": "Start time",
@@ -147,6 +155,7 @@
  "6d1876364ac6457d": "Proxy mode",
  "6e86570183c3cdd0": "You're up to date",
  "7005693f4f050bce": "Cache I/O {cost}",
+  "72644ec4389da2f7": "Default layout",
  "736c9dc2a04c65fd": "The model configuration changed. Refresh and try again.",
  "7392e20d61abaa07": "Also store complete requests and streamed responses; by default only timing, status, and usage are stored.",
  "788db1cfec2a3db5": "Theme",
@@ -157,11 +166,11 @@
  "7cea2f3c46565d29": "OpenAI extra parameters",
  "7d9f043f8f7ab45c": "Version {version} is available in Settings",
  "7e0891860c9e6374": "TAB service address is required",
-  "7e1f06318e80c3af": "Statistics cleared",
  "7e7df68f2a82e09e": "Importing the same configuration again will not create duplicate models. Existing models are skipped automatically.",
  "7f3c8312816fe26a": "Refreshing…",
  "7f68ebad19ba6bcd": "Check for updates",
  "811a3b22a5a7f2d5": "Unable to connect to the local management service",
+  "83c4efccd9a6bf69": "Connectivity test cancelled: {successful} succeeded, {failed} failed",
  "83fcfb4c1f2c1641": "Fetch models",
  "842b9f11cdd96bda": "Launch at login",
  "843ac7e15a5047a7": "Confirm legacy model configuration import",
@@ -181,6 +190,7 @@
  "90800c48a1dd0655": "{label} must be a JSON object",
  "919cb0ce0c8db4e7": "Leave blank to keep the current password",
  "91aaf184cfc17ffd": "Overview",
+  "92156a483d4ba248": "Only request, response, and trace attachments are deleted; call summaries, metrics, and configuration are kept.",
  "940a168911ade998": "Items per page",
  "946b3ffc02f026c0": "Delete this model?",
  "966498853d801a52": "TAB connection",
@@ -202,6 +212,7 @@
  "a363743025795ec7": "I've initialized it — refresh",
  "a3ab741ceb188e9e": "Request content was not recorded. Enable detailed records and try again.",
  "a49ffd73bc85333d": "Average",
+  "a4d222236dc1003d": "Failed to cancel test: {error}",
  "a5fb6189a8ad011d": "Open tutorial",
  "a621ab606db2a11f": "Password",
  "a693d69af48bfe48": "Save and test",
@@ -211,15 +222,19 @@
  "a98585871c5313ff": "Display name",
  "ab9084a640fbb864": "Deselect all",
  "abecab6701177721": "Launch at login enabled",
+  "ac58d0f9a3f8d389": "Enter model notes",
  "ac69f68b7010ec79": "Download and install",
  "ad6a60ee93d3ba3e": "Loading call details…",
  "ae2d0b7f79cea4a3": "Model output: {tokens} × ${price}/1M = {cost}",
+  "aecb952b1e6cce36": "Hide the Dock icon when disabled. You can still open the app from the menu bar icon.",
  "aee88743413144a2": "Refresh",
  "b06325c5660f0c29": "Direct",
  "b16c3b2ecedd6fe1": "Cursor integration is active. Add a model configuration to use a BYOK model.",
  "b4411558b932266f": "Provider type",
  "b502b1d414664337": "Prompt: {tokens}",
  "b5141d3d19e9a048": "Yes",
+  "b6725f218ebaef26": "Dock icon shown",
+  "b67e408132f4dbd7": "Clear all statistics?",
  "b75a46aad3e7c132": "Non-cached input: {tokens}",
  "b79354009c614ae9": "Statistics",
  "b86967982067d295": " (estimated)",
@@ -227,6 +242,7 @@
  "b8c9b486c83b5778": "Hide ad",
  "b9670c85a4ab939e": "Route",
  "b9af2de88d903be7": "Proxy address",
+  "ba5865fbc734e672": "For example: Primary model",
  "baff6c144180b185": "Connectivity tests completed: {successful} succeeded, {failed} failed",
  "bb2b7736433ae867": "Cursor tracing",
  "bb7efdcb6af6e805": "Default dark",
@@ -247,15 +263,20 @@
  "cfe085015632e9c8": "The local management service port used by the desktop frontend. Enter 0 to select a random port at startup.",
  "d0bfccc77315d887": "Last month",
  "d1251cd752d4ec25": "Leave blank to use adaptive thinking.",
+  "d1a3d72618d1ed27": "All call summaries, detailed content, and trace records will be deleted. Model configuration, CA, and application settings are unaffected. This action cannot be undone.",
  "d2d648bd1c94b7f9": "Authentication",
  "d34335433395cd3a": "Start Cursor BYOK automatically after signing in.",
  "d3716cc5a2f5a810": "Server address",
  "d3d21191f32e79a5": "Processing…",
+  "d58c88688e1a949d": "Presets",
+  "d60669bb26a22f5d": "Leave blank to use the default",
+  "d6b1f203680f5496": "Leave blank to use adaptive thinking",
  "d86fa42c3848c680": "Use system proxy",
  "d8c47e9776cf1082": "Main menu",
  "da521d1c1cbd36af": "Authorization is required to install the certificate",
  "da7ae985487c38e6": "Last hour",
  "daede9881787abe7": "Notes",
+  "db340a9896306d08": "Test cancelled",
  "dbd3596e4a86f3c2": "Configured models",
  "ddde16f8839da3ce": "Total requests",
  "dea7749c4cd77e6d": "Total request Tokens include the prompt and model output.",
@@ -290,7 +311,6 @@
  "ee239f3943293f87": "Sunday",
  "ee6b89a6a740a4c4": "If a port is occupied, a new random port is selected and saved automatically. Restart the app after changing these settings.",
  "f2bdc88464c51c2e": "Show API Key",
-  "f3a76d896853c1df": "Miss",
  "f4694c46b1e19602": "Final request type",
  "f4dcb6a3ceb32247": "Page {page} of {count}",
  "f4fa9f31ea2ae58d": "Token usage calendar for the past year",
@@ -311,6 +331,7 @@
  "fdc4cabc370fa3f7": "No options",
  "fea405f9b01d1416": "Summary",
  "fec45092945f8790": "User guide",
+  "fec7210590309465": "Clear all statistics",
  "ff509c9ba052a21c": "Saving…",
  "ff66b1c7e010bbc2": "Paste the authorization command into the terminal and enter your password, then click the button below",
  "ff673195f05fb056": "Service port"
@@ -10,13 +10,13 @@
  "076832c1b2de22c3": "缓存写入：{tokens}",
  "07879e064ae16542": "输出推算：{tokens}",
  "07c657ed4747126e": "Anthropic 额外参数",
-  "08d742566ffc9fa3": "确定要清理所有统计数据吗？",
  "092b520558eff5f2": "未测试",
  "099008ea7a42ebd1": "自定义 Headers 的值必须都是字符串",
  "09ebc2643631ba25": "价值估算",
  "0b96da34f6fbdd3b": "缓存读取：{tokens} × ${price}/1M = {cost}",
  "0c70665b6eb65f1a": "否",
  "0c72229b7db0e1a9": "模型输出",
+  "0d2dab3d62eb73d6": "全部统计数据已清理",
  "0d5e2bdb15579fc4": "消息数",
  "0e41f8e3d59ec47b": "存储管理",
  "0e67021ebf0a3580": "导入完成：新增 {imported} 个模型，跳过 {skipped} 个已存在模型",
@@ -47,6 +47,8 @@
  "20e14248fd4fb981": "{label} 必须是大于 0 的整数",
  "217cfe7db1e3d10a": "跟随系统",
  "22c6b4eb4caee6ae": "代理设置已保存",
+  "22d7895ea5fca72e": "按供应商",
+  "23ae7a90b1b9816d": "清理范围",
  "23e49479e15e6770": "发现新版本 {version}",
  "24a0a24864454575": "已存在，跳过",
  "2555d6c7fbb7e070": "可以直接输入模型标识，也可以读取接口返回的模型列表。",
@@ -70,7 +72,7 @@
  "37125ef2e1d707cb": "服务器地址或完整请求 URL、API Key、模型名称、显示名称和备注不能为空",
  "378bb0eec39fa8a2": "最后一页",
  "37cb98ff4d5dcfcc": "成功 {successful} / 异常 {failed}",
-  "393df9bb13ea4900": "命中",
+  "382f2e3419a02fef": "仅清理详细记录",
  "393e1241552b1870": "请求",
  "398f8e6c6f0a0b97": "继续选择或输入",
  "39f52eee100131d7": "缓存输入",
@@ -78,12 +80,15 @@
  "3a3f595df70ec8ff": "清理存储空间",
  "3a5040b68abf75f9": "全选",
  "3a8c76b2ce785f96": "查看并导入",
+  "3b67824289b5fa1e": "已隐藏 Dock 栏图标",
  "3c94b4c75940c178": "输入 Token",
  "3cfae5728b92b334": "Token 用量：{tokens}",
  "3d13868593ae4eeb": "界面语言",
  "3da0bf1610ff5db5": "推荐内容",
  "3f6c25aa329163a4": "原接口路径会追加到此服务地址。",
+  "3fd118e2ffe0b2b6": "取消全部测试",
  "3fd47edce45b3603": "关闭",
+  "40a08e7cf320ae07": "确定要清理详细记录吗？",
  "4125fc7ba333524c": "默认亮色",
  "42655ed8e4108ae2": "输入（非缓存）",
  "42a1d9e5b037c210": "字节数",
@@ -98,6 +103,7 @@
  "4927a53bcc886afb": "加载中…",
  "497c85690c4cc0fc": "暂无数据",
  "499c729eb09aa2a6": "上下文窗口 Token",
+  "49be72e6045c007d": "取消测试",
  "4a8d6841b4023edf": "确认导入",
  "4b458e6e147221d7": "系统会根据请求协议自动追加标准端点路径。",
  "4d0680f9efaef147": "未读",
@@ -119,8 +125,8 @@
  "5a284a1a2be8da0e": "从本机旧版配置读取模型；确认前会显示新增和已存在的模型。",
  "5a3bd99fa69a40c1": "使用公益服务",
  "5b17f59d33bde39e": "错误：{error}",
+  "5ba65a74c4e792c5": "按类型",
  "5c55a67935af8f45": "全部",
-  "5cae248525cb9140": "所有调用记录和详细追踪数据都会被删除。模型配置、CA 和应用设置不会受到影响，此操作无法撤销。",
  "5d59857bf039cac9": "Cursor 助手 v{version}",
  "5f8d556a9c47da3c": "已关闭开机启动",
  "5f9acfb945229062": "你确认不想再看到此广告吗？",
@@ -139,6 +145,8 @@
  "656ab25e264cc4e4": "还没有可供 Cursor 使用的模型",
  "65a6318e07ec1e07": "工具数",
  "65cb9a7b4f620b6b": "提示词 {tokens}",
+  "680680288a6d2ad2": "在 Dock 栏显示",
+  "68102220092c1f0f": "详细记录已清理",
  "68ad603fafe4e0d6": "导入旧版配置",
  "68ea5dd4d7af20e6": "系统设置",
  "6a9906c79f26c0ba": "开始时间",
@@ -147,6 +155,7 @@
  "6d1876364ac6457d": "代理方式",
  "6e86570183c3cdd0": "当前已是最新版本",
  "7005693f4f050bce": "缓存读写 {cost}",
+  "72644ec4389da2f7": "默认平铺",
  "736c9dc2a04c65fd": "模型配置已发生变化，请刷新后重试",
  "7392e20d61abaa07": "额外保存完整请求和流响应；默认只保存时间、状态与用量。",
  "788db1cfec2a3db5": "主题",
@@ -157,11 +166,11 @@
  "7cea2f3c46565d29": "OpenAI 额外参数",
  "7d9f043f8f7ab45c": "发现新版本 {version}，可在设置中安装",
  "7e0891860c9e6374": "TAB 服务地址不能为空",
-  "7e1f06318e80c3af": "统计数据已清理",
  "7e7df68f2a82e09e": "重复导入相同配置不会创建重复模型；已经存在的模型会自动跳过。",
  "7f3c8312816fe26a": "刷新中…",
  "7f68ebad19ba6bcd": "检查更新",
  "811a3b22a5a7f2d5": "无法连接本地管理服务",
+  "83c4efccd9a6bf69": "连通性测试已取消：成功 {successful}，失败 {failed}",
  "83fcfb4c1f2c1641": "获取模型",
  "842b9f11cdd96bda": "开机启动",
  "843ac7e15a5047a7": "确认导入旧版模型配置",
@@ -181,6 +190,7 @@
  "90800c48a1dd0655": "{label} 必须是 JSON 对象",
  "919cb0ce0c8db4e7": "留空表示保留当前密码",
  "91aaf184cfc17ffd": "数据概览",
+  "92156a483d4ba248": "仅删除请求、响应和追踪附件等详细内容，保留调用汇总、统计指标和配置。",
  "940a168911ade998": "每页条数",
  "946b3ffc02f026c0": "确定删除这个模型吗？",
  "966498853d801a52": "TAB 选择",
@@ -202,6 +212,7 @@
  "a363743025795ec7": "我已初始化，刷新",
  "a3ab741ceb188e9e": "未记录请求内容，请开启详细记录后重试。",
  "a49ffd73bc85333d": "平均",
+  "a4d222236dc1003d": "取消测试失败：{error}",
  "a5fb6189a8ad011d": "打开教程",
  "a621ab606db2a11f": "密码",
  "a693d69af48bfe48": "保存并测试",
@@ -211,15 +222,19 @@
  "a98585871c5313ff": "显示名称",
  "ab9084a640fbb864": "全不选",
  "abecab6701177721": "已开启开机启动",
+  "ac58d0f9a3f8d389": "请输入模型备注",
  "ac69f68b7010ec79": "下载并安装",
  "ad6a60ee93d3ba3e": "正在加载调用详情…",
  "ae2d0b7f79cea4a3": "模型输出：{tokens} × ${price}/1M = {cost}",
+  "aecb952b1e6cce36": "关闭后隐藏 Dock 栏图标，仍可通过菜单栏图标打开应用。",
  "aee88743413144a2": "刷新",
  "b06325c5660f0c29": "直连",
  "b16c3b2ecedd6fe1": "Cursor 接管已生效；添加模型配置后即可使用 BYOK 模型。",
  "b4411558b932266f": "上游类型",
  "b502b1d414664337": "提示词：{tokens}",
  "b5141d3d19e9a048": "是",
+  "b6725f218ebaef26": "已显示 Dock 栏图标",
+  "b67e408132f4dbd7": "确定要清理全部统计数据吗？",
  "b75a46aad3e7c132": "非缓存输入：{tokens}",
  "b79354009c614ae9": "统计数据",
  "b86967982067d295": "（估算）",
@@ -227,6 +242,7 @@
  "b8c9b486c83b5778": "不再显示广告",
  "b9670c85a4ab939e": "路由",
  "b9af2de88d903be7": "代理地址",
+  "ba5865fbc734e672": "例如：主力模型",
  "baff6c144180b185": "连通性测试完成：成功 {successful}，失败 {failed}",
  "bb2b7736433ae867": "Cursor 追踪",
  "bb7efdcb6af6e805": "默认暗色",
@@ -247,15 +263,20 @@
  "cfe085015632e9c8": "桌面前端连接的本地管理服务端口；填写 0 时启动时随机选择。",
  "d0bfccc77315d887": "近一个月",
  "d1251cd752d4ec25": "留空时使用 adaptive thinking。",
+  "d1a3d72618d1ed27": "所有调用汇总、详细内容和追踪记录都会被删除。模型配置、CA 和应用设置不会受到影响，此操作无法撤销。",
  "d2d648bd1c94b7f9": "认证",
  "d34335433395cd3a": "登录系统后自动启动 Cursor BYOK。",
  "d3716cc5a2f5a810": "服务器地址",
  "d3d21191f32e79a5": "处理中…",
+  "d58c88688e1a949d": "常用预设",
+  "d60669bb26a22f5d": "留空使用默认值",
+  "d6b1f203680f5496": "留空使用 adaptive thinking",
  "d86fa42c3848c680": "使用系统代理",
  "d8c47e9776cf1082": "主菜单",
  "da521d1c1cbd36af": "需要授权安装证书",
  "da7ae985487c38e6": "近1小时",
  "daede9881787abe7": "备注",
+  "db340a9896306d08": "测试已取消",
  "dbd3596e4a86f3c2": "配置模型",
  "ddde16f8839da3ce": "总请求",
  "dea7749c4cd77e6d": "总请求 Token 包含提示词和模型输出。",
@@ -290,7 +311,6 @@
  "ee239f3943293f87": "周日",
  "ee6b89a6a740a4c4": "端口被占用时会自动选择新的随机端口并保存。修改后需要重启软件才会生效。",
  "f2bdc88464c51c2e": "显示 API Key",
-  "f3a76d896853c1df": "未命中",
  "f4694c46b1e19602": "最终请求类型",
  "f4dcb6a3ceb32247": "第 {page} / {count} 页",
  "f4fa9f31ea2ae58d": "过去一年的 Token 用量日历",
@@ -311,6 +331,7 @@
  "fdc4cabc370fa3f7": "暂无选项",
  "fea405f9b01d1416": "概览",
  "fec45092945f8790": "使用教程",
+  "fec7210590309465": "清理全部统计数据",
  "ff509c9ba052a21c": "保存中…",
  "ff66b1c7e010bbc2": "请在终端中粘贴授权命令并输入密码，完成后点击下方按钮",
  "ff673195f05fb056": "服务端口"
@@ -2,8 +2,8 @@ import ReactDOM from "react-dom/client";
 import "../node_modules/monaco-editor/min/vs/editor/editor.main.css";
 import { I18nRoot } from "./i18n/I18nRoot";
 import { initializeI18n } from "./i18n/store";
-import { appStore } from "./store/appStore";
-import { applyTheme } from "./theme/theme";
+import { appStore } from "./shared/store/appStore";
+import { applyTheme } from "./shared/theme/theme";
 import "./styles/globals.scss";

 initializeI18n();
@@ -1,10 +0,0 @@
-import { CallTable } from "../components/CallTable";
-import { PageContent } from "../components/layout/PageContent";
-import { appStore, useAppStore } from "../store/appStore";
-import styles from "./CallsPage.module.scss";
-
-export function CallsPage() {
-  const { calls } = useAppStore();
-  const content = <div className={styles.page}><CallTable calls={calls} onDetails={(call) => void appStore.openCallDetails(call.call_id)} /></div>;
-  return <PageContent fixed title={t("调用")} contentClassName={styles.pageContent} sections={[{ key: "calls", estimatedHeight: 720, content }]} />;
-}
@@ -1,5 +1,5 @@
-import type { AdRuntime } from "./components/ads/types";
-import type { Locale } from "./i18n/runtime";
+import type { AdRuntime } from "../shell/ads/types";
+import type { Locale } from "../i18n/runtime";

 export type ModelType = "openai" | "anthropic";

@@ -86,7 +86,7 @@ export interface LegacyModelImportResult {

 export interface ModelConnectivityResult {
  duration_ms: number;
-  first_text_ms: number | null;
+  first_valid_response_ms: number | null;
  output_tokens: number;
  tokens_per_second: number;
  tokens_estimated: boolean;
@@ -116,6 +116,8 @@ export interface StatisticsStorage {
  trace_count: number;
 }

+export type StatisticsStorageScope = "details" | "all";
+
 export type ProxyMode = "system" | "custom";

 export interface ProxySettings {
@@ -143,6 +145,7 @@ export interface TabSettings {

 export interface DesktopSettings {
  silent_start: boolean;
+  show_dock_icon: boolean;
 }

 export interface OverviewMetrics {
@@ -194,6 +197,7 @@ export interface LlmCall {
  created_at_ms: number;
  ttfb_ms: number | null;
  ttft_ms: number | null;
+  ttfr_ms: number | null;
  duration_ms: number | null;
  input_tokens: number | null;
  output_tokens: number | null;
@@ -291,7 +295,8 @@ export const api = {
  importV0049Models: () => request<LegacyModelImportResult>("/models/import-v0049", { method: "POST" }),
  updateModel: (hash: string, model: ModelInput) => request<Model>(`/models/${hash}`, { method: "PUT", body: JSON.stringify(model) }),
  deleteModel: (hash: string) => request<void>(`/models/${hash}`, { method: "DELETE" }),
-  testModel: (hash: string) => request<ModelConnectivityResult>(`/models/${hash}/test`, { method: "POST" }),
+  testModel: (hash: string, testId: string, signal?: AbortSignal) => request<ModelConnectivityResult>(`/models/${hash}/test/${encodeURIComponent(testId)}`, { method: "POST", signal }),
+  cancelModelTest: (hash: string, testId: string) => request<void>(`/models/${hash}/test/${encodeURIComponent(testId)}`, { method: "DELETE" }),
  overview: (filter?: { startMs: number; endMs: number; modelHashes?: string[] }) => {
    const params = new URLSearchParams();
    if (filter) {
@@ -299,8 +304,8 @@ export const api = {
      params.set("end_ms", String(filter.endMs));
      if (filter.modelHashes?.length) params.set("model_hashes", JSON.stringify(filter.modelHashes));
    }
-    const query = params.size ? `?${params}` : "";
-    return request<Overview>(`/overview${query}`);
+    const query = params.toString();
+    return request<Overview>(`/overview${query ? `?${query}` : ""}`);
  },
  cursorHarness: () => request<CursorHarnessStatus>("/harness/cursor/status"),
  initializeCursorCa: () => request<CursorHarnessStatus>("/harness/cursor/ca/initialize", { method: "POST" }),
@@ -328,7 +333,7 @@ export const api = {
  ports: () => request<PortSettings>("/settings/ports"),
  setPorts: (settings: PortSettings) => request<PortSettings>("/settings/ports", { method: "PUT", body: JSON.stringify(settings) }),
  statisticsStorage: () => request<StatisticsStorage>("/settings/storage/statistics"),
-  clearStatisticsStorage: () => request<StatisticsStorage>("/settings/storage/statistics", { method: "DELETE" }),
+  clearStatisticsStorage: (scope: StatisticsStorageScope) => request<StatisticsStorage>("/settings/storage/statistics", { method: "DELETE", body: JSON.stringify({ scope }) }),
  proxySettings: () => request<ProxySettings>("/settings/proxy"),
  setProxySettings: (settings: ProxySettingsInput) => request<ProxySettings>("/settings/proxy", { method: "PUT", body: JSON.stringify(settings) }),
  tabSettings: () => request<TabSettings>("/settings/tab"),
@@ -0,0 +1 @@
+<svg height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>DeepSeek</title><path d="M23.748 4.482c-.254-.124-.364.113-.512.234-.051.039-.094.09-.137.136-.372.397-.806.657-1.373.626-.829-.046-1.537.214-2.163.848-.133-.782-.575-1.248-1.247-1.548-.352-.156-.708-.311-.955-.65-.172-.241-.219-.51-.305-.774-.055-.16-.11-.323-.293-.35-.2-.031-.278.136-.356.276-.313.572-.434 1.202-.422 1.84.027 1.436.633 2.58 1.838 3.393.137.093.172.187.129.323-.082.28-.18.552-.266.833-.055.179-.137.217-.329.14a5.526 5.526 0 01-1.736-1.18c-.857-.828-1.631-1.742-2.597-2.458a11.365 11.365 0 00-.689-.471c-.985-.957.13-1.743.388-1.836.27-.098.093-.432-.779-.428-.872.004-1.67.295-2.687.684a3.055 3.055 0 01-.465.137 9.597 9.597 0 00-2.883-.102c-1.885.21-3.39 1.102-4.497 2.623C.082 8.606-.231 10.684.152 12.85c.403 2.284 1.569 4.175 3.36 5.653 1.858 1.533 3.997 2.284 6.438 2.14 1.482-.085 3.133-.284 4.994-1.86.47.234.962.327 1.78.397.63.059 1.236-.03 1.705-.128.735-.156.684-.837.419-.961-2.155-1.004-1.682-.595-2.113-.926 1.096-1.296 2.746-2.642 3.392-7.003.05-.347.007-.565 0-.845-.004-.17.035-.237.23-.256a4.173 4.173 0 001.545-.475c1.396-.763 1.96-2.015 2.093-3.517.02-.23-.004-.467-.247-.588zM11.581 18c-2.089-1.642-3.102-2.183-3.52-2.16-.392.024-.321.471-.235.763.09.288.207.486.371.739.114.167.192.416-.113.603-.673.416-1.842-.14-1.897-.167-1.361-.802-2.5-1.86-3.301-3.307-.774-1.393-1.224-2.887-1.298-4.482-.02-.386.093-.522.477-.592a4.696 4.696 0 011.529-.039c2.132.312 3.946 1.265 5.468 2.774.868.86 1.525 1.887 2.202 2.891.72 1.066 1.494 2.082 2.48 2.914.348.292.625.514.891.677-.802.09-2.14.11-3.054-.614zm1-6.44a.306.306 0 01.415-.287.302.302 0 01.2.288.306.306 0 01-.31.307.303.303 0 01-.304-.308zm3.11 1.596c-.2.081-.399.151-.59.16a1.245 1.245 0 01-.798-.254c-.274-.23-.47-.358-.552-.758a1.73 1.73 0 01.016-.588c.07-.327-.008-.537-.239-.727-.187-.156-.426-.199-.688-.199a.559.559 0 01-.254-.078c-.11-.054-.2-.19-.114-.358.028-.054.16-.186.192-.21.356-.202.767-.136 1.146.016.352.144.618.408 1.001.782.391.451.462.576.685.914.176.265.336.537.445.848.067.195-.019.354-.25.452z" fill="#4D6BFE"></path></svg>
@@ -0,0 +1 @@
+<svg fill="currentColor" fill-rule="evenodd" height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Kimi</title><path d="M19.738 5.776c.163-.209.306-.4.457-.585.07-.087.064-.153-.004-.244-.655-.861-.717-1.817-.34-2.787.283-.73.909-1.072 1.674-1.145.477-.045.945.004 1.379.236.57.305.902.77 1.01 1.412.086.512.07 1.012-.075 1.508-.257.878-.888 1.333-1.753 1.448-.718.096-1.446.108-2.17.157-.056.004-.113 0-.178 0z" fill="#027AFF"></path><path d="M17.962 1.844h-4.326l-3.425 7.81H5.369V1.878H1.5V22h3.87v-8.477h6.824a3.025 3.025 0 002.743-1.75V22h3.87v-8.477a3.87 3.87 0 00-3.588-3.86v-.01h-2.125a3.94 3.94 0 002.323-2.12l2.545-5.689z"></path></svg>
@@ -0,0 +1 @@
+<svg height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Minimax</title><defs><linearGradient id="lobe-icons-minimax-fill" x1="0%" x2="100.182%" y1="50.057%" y2="50.057%"><stop offset="0%" stop-color="#E2167E"></stop><stop offset="100%" stop-color="#FE603C"></stop></linearGradient></defs><path d="M16.278 2c1.156 0 2.093.927 2.093 2.07v12.501a.74.74 0 00.744.709.74.74 0 00.743-.709V9.099a2.06 2.06 0 012.071-2.049A2.06 2.06 0 0124 9.1v6.561a.649.649 0 01-.652.645.649.649 0 01-.653-.645V9.1a.762.762 0 00-.766-.758.762.762 0 00-.766.758v7.472a2.037 2.037 0 01-2.048 2.026 2.037 2.037 0 01-2.048-2.026v-12.5a.785.785 0 00-.788-.753.785.785 0 00-.789.752l-.001 15.904A2.037 2.037 0 0113.441 22a2.037 2.037 0 01-2.048-2.026V18.04c0-.356.292-.645.652-.645.36 0 .652.289.652.645v1.934c0 .263.142.506.372.638.23.131.514.131.744 0a.734.734 0 00.372-.638V4.07c0-1.143.937-2.07 2.093-2.07zm-5.674 0c1.156 0 2.093.927 2.093 2.07v11.523a.648.648 0 01-.652.645.648.648 0 01-.652-.645V4.07a.785.785 0 00-.789-.78.785.785 0 00-.789.78v14.013a2.06 2.06 0 01-2.07 2.048 2.06 2.06 0 01-2.071-2.048V9.1a.762.762 0 00-.766-.758.762.762 0 00-.766.758v3.8a2.06 2.06 0 01-2.071 2.049A2.06 2.06 0 010 12.9v-1.378c0-.357.292-.646.652-.646.36 0 .653.29.653.646V12.9c0 .418.343.757.766.757s.766-.339.766-.757V9.099a2.06 2.06 0 012.07-2.048 2.06 2.06 0 012.071 2.048v8.984c0 .419.343.758.767.758.423 0 .766-.339.766-.758V4.07c0-1.143.937-2.07 2.093-2.07z" fill="url(#lobe-icons-minimax-fill)" fill-rule="nonzero"></path></svg>
@@ -0,0 +1 @@
+<svg height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Zhipu</title><path d="M11.991 23.503a.24.24 0 00-.244.248.24.24 0 00.244.249.24.24 0 00.245-.249.24.24 0 00-.22-.247l-.025-.001zM9.671 5.365a1.697 1.697 0 011.099 2.132l-.071.172-.016.04-.018.054c-.07.16-.104.32-.104.498-.035.71.47 1.279 1.186 1.314h.366c1.309.053 2.338 1.173 2.286 2.523-.052 1.332-1.152 2.38-2.478 2.327h-.174c-.715.018-1.274.64-1.239 1.368 0 .124.018.23.053.337.209.373.54.658.96.8.75.23 1.517-.125 1.9-.782l.018-.035c.402-.64 1.17-.96 1.92-.711.854.284 1.378 1.226 1.099 2.167a1.661 1.661 0 01-2.077 1.102 1.711 1.711 0 01-.907-.711l-.017-.035c-.2-.323-.463-.58-.851-.711l-.056-.018a1.646 1.646 0 00-1.954.746 1.66 1.66 0 01-1.065.764 1.677 1.677 0 01-1.989-1.279c-.209-.906.332-1.83 1.257-2.043a1.51 1.51 0 01.296-.035h.018c.68-.071 1.151-.622 1.116-1.333a1.307 1.307 0 00-.227-.693 2.515 2.515 0 01-.366-1.403 2.39 2.39 0 01.366-1.208c.14-.195.21-.444.227-.693.018-.71-.506-1.261-1.186-1.332l-.07-.018a1.43 1.43 0 01-.299-.07l-.05-.019a1.7 1.7 0 01-1.047-2.114 1.68 1.68 0 012.094-1.101zm-5.575 10.11c.26-.264.639-.367.994-.27.355.096.633.379.728.74.095.362-.007.748-.267 1.013-.402.41-1.053.41-1.455 0a1.062 1.062 0 010-1.482zm14.845-.294c.359-.09.738.024.992.297.254.274.344.665.237 1.025-.107.36-.396.634-.756.718-.551.128-1.1-.22-1.23-.781a1.05 1.05 0 01.757-1.26zm-.064-4.39c.314.32.49.753.49 1.206 0 .452-.176.886-.49 1.206-.315.32-.74.5-1.185.5-.444 0-.87-.18-1.184-.5a1.727 1.727 0 010-2.412 1.654 1.654 0 012.369 0zm-11.243.163c.364.484.447 1.128.218 1.691a1.665 1.665 0 01-2.188.923c-.855-.36-1.26-1.358-.907-2.228a1.68 1.68 0 011.33-1.038c.593-.08 1.183.169 1.547.652zm11.545-4.221c.368 0 .708.2.892.524.184.324.184.724 0 1.048a1.026 1.026 0 01-.892.524c-.568 0-1.03-.47-1.03-1.048 0-.579.462-1.048 1.03-1.048zm-14.358 0c.368 0 .707.2.891.524.184.324.184.724 0 1.048a1.026 1.026 0 01-.891.524c-.569 0-1.03-.47-1.03-1.048 0-.579.461-1.048 1.03-1.048zm10.031-1.475c.925 0 1.675.764 1.675 1.706s-.75 1.705-1.675 1.705-1.674-.763-1.674-1.705c0-.942.75-1.706 1.674-1.706zm-2.626-.684c.362-.082.653-.356.761-.718a1.062 1.062 0 00-.238-1.028 1.017 1.017 0 00-.996-.294c-.547.14-.881.7-.752 1.257.13.558.675.907 1.225.783zm0 16.876c.359-.087.644-.36.75-.72a1.062 1.062 0 00-.237-1.019 1.018 1.018 0 00-.985-.301 1.037 1.037 0 00-.762.717c-.108.361-.017.754.239 1.028.245.263.606.377.953.305l.043-.01zM17.19 3.5a.631.631 0 00.628-.64c0-.355-.279-.64-.628-.64a.631.631 0 00-.628.64c0 .355.28.64.628.64zm-10.38 0a.631.631 0 00.628-.64c0-.355-.28-.64-.628-.64a.631.631 0 00-.628.64c0 .355.279.64.628.64zm-5.182 7.852a.631.631 0 00-.628.64c0 .354.28.639.628.639a.63.63 0 00.627-.606l.001-.034a.62.62 0 00-.628-.64zm5.182 9.13a.631.631 0 00-.628.64c0 .355.279.64.628.64a.631.631 0 00.628-.64c0-.355-.28-.64-.628-.64zm10.38.018a.631.631 0 00-.628.64c0 .355.28.64.628.64a.631.631 0 00.628-.64c0-.355-.279-.64-.628-.64zm5.182-9.148a.631.631 0 00-.628.64c0 .354.279.639.628.639a.631.631 0 00.628-.64c0-.355-.28-.64-.628-.64zm-.384-4.992a.24.24 0 00.244-.249.24.24 0 00-.244-.249.24.24 0 00-.244.249c0 .142.122.249.244.249zM11.991.497a.24.24 0 00.245-.248A.24.24 0 0011.99 0a.24.24 0 00-.244.249c0 .133.108.236.223.247l.021.001zM2.011 6.36a.24.24 0 00.245-.249.24.24 0 00-.244-.249.24.24 0 00-.244.249.24.24 0 00.244.249zm0 11.263a.24.24 0 00-.243.248.24.24 0 00.244.249.24.24 0 00.244-.249.252.252 0 00-.244-.248zm19.995-.018a.24.24 0 00-.245.248.24.24 0 00.245.25.24.24 0 00.244-.25.252.252 0 00-.244-.248z" fill="#3859FF" fill-rule="nonzero"></path></svg>
@@ -1,14 +1,19 @@
-import { getVersion } from "@tauri-apps/api/app";
+import { getVersion, setDockVisibility } from "@tauri-apps/api/app";
 import { isTauri } from "@tauri-apps/api/core";
 import { disable, enable, isEnabled } from "@tauri-apps/plugin-autostart";
 import { relaunch } from "@tauri-apps/plugin-process";
 import { check, type Update } from "@tauri-apps/plugin-updater";
-import { api } from "../api";
+import { api, type DesktopSettings } from "../api";
+import { desktopPlatform } from "./platform";

 export function hasNativeAppLifecycle(): boolean {
  return isTauri();
 }

+export function hasDockVisibilitySetting(): boolean {
+  return hasNativeAppLifecycle() && desktopPlatform() === "macos";
+}
+
 export async function currentAppVersion(): Promise<string> {
  return hasNativeAppLifecycle() ? getVersion() : "dev";
 }
@@ -21,12 +26,24 @@ export async function writeAutostart(enabled: boolean): Promise<void> {
  await (enabled ? enable() : disable());
 }

-export async function readSilentStart(): Promise<boolean> {
-  return (await api.desktopSettings()).silent_start;
+export async function readDesktopSettings(): Promise<DesktopSettings> {
+  return api.desktopSettings();
 }

 export async function writeSilentStart(silentStart: boolean): Promise<void> {
-  await api.setDesktopSettings({ silent_start: silentStart });
+  const settings = await readDesktopSettings();
+  await api.setDesktopSettings({ ...settings, silent_start: silentStart });
+}
+
+export async function writeDockIconVisibility(visible: boolean): Promise<void> {
+  const settings = await readDesktopSettings();
+  await setDockVisibility(visible);
+  try {
+    await api.setDesktopSettings({ ...settings, show_dock_icon: visible });
+  } catch (cause) {
+    await setDockVisibility(settings.show_dock_icon).catch(() => {});
+    throw cause;
+  }
 }

 export async function checkForUpdate(): Promise<Update | null> {
@@ -0,0 +1,13 @@
+export type DesktopPlatform = "macos" | "windows" | "linux";
+
+export function desktopPlatform(): DesktopPlatform {
+  const configured = document.documentElement.dataset.platform;
+  if (configured === "macos" || configured === "windows" || configured === "linux") {
+    return configured;
+  }
+
+  const agent = navigator.userAgent;
+  if (/Macintosh|Mac OS X/.test(agent)) return "macos";
+  if (/Windows/.test(agent)) return "windows";
+  return "linux";
+}
@@ -97,6 +97,7 @@ export const ScrollArea = forwardRef<HTMLDivElement, ScrollAreaProps>(

    const hostRef = useRef<HTMLDivElement | null>(null)
    const localViewportRef = useRef<HTMLDivElement | null>(null)
+    const localContentRef = useRef<HTMLDivElement | null>(null)
    const trackRef = useRef<HTMLDivElement | null>(null)
    const thumbRef = useRef<HTMLDivElement | null>(null)
    const dragRef = useRef<{
@@ -107,6 +108,7 @@ export const ScrollArea = forwardRef<HTMLDivElement, ScrollAreaProps>(

    const { state, api, metricsRef, scrollToNow } = useScrollableModel({
      viewportRef: localViewportRef,
+      contentRef: localContentRef,
      trackRef,
      thumbRef,
      contentHeight,
@@ -132,7 +134,10 @@ export const ScrollArea = forwardRef<HTMLDivElement, ScrollAreaProps>(
    )

    const setContentRef = useCallback(
-      (node: HTMLDivElement | null) => assignRef(contentRef, node),
+      (node: HTMLDivElement | null) => {
+        localContentRef.current = node
+        assignRef(contentRef, node)
+      },
      [contentRef]
    )

@@ -33,6 +33,7 @@ export interface ScrollMetrics extends ScrollAreaState {

 interface UseScrollableModelOptions {
  viewportRef: RefObject<HTMLDivElement | null>
+  contentRef: RefObject<HTMLDivElement | null>
  trackRef: RefObject<HTMLDivElement | null>
  thumbRef: RefObject<HTMLDivElement | null>
  contentHeight?: number
@@ -131,6 +132,7 @@ function applyThumbStyle(
 export function useScrollableModel(options: UseScrollableModelOptions) {
  const {
    viewportRef,
+    contentRef,
    trackRef,
    thumbRef,
    contentHeight,
@@ -319,28 +321,30 @@ export function useScrollableModel(options: UseScrollableModelOptions) {

  useEffect(() => {
    const element = viewportRef.current
+    const content = contentRef.current
    const track = trackRef.current
-    if (!element || !track) return
+    if (!element || !content || !track) return

    const resizeObserver = new ResizeObserver((entries) => {
-      const entry = entries[0]
-      if (entry) {
+      const viewportEntry = entries.find((entry) => entry.target === element)
+      if (viewportEntry) {
        onViewportResizeRef.current?.({
-          width: entry.contentRect.width,
-          height: entry.contentRect.height,
+          width: viewportEntry.contentRect.width,
+          height: viewportEntry.contentRect.height,
        })
      }
      snapshot(false)
    })

    resizeObserver.observe(element)
+    resizeObserver.observe(content)
    resizeObserver.observe(track)
    snapshot(false)

    return () => {
      resizeObserver.disconnect()
    }
-  }, [snapshot, trackRef, viewportRef])
+  }, [contentRef, snapshot, trackRef, viewportRef])

  useEffect(() => {
    snapshot(false)
@@ -177,6 +177,14 @@ export const appStore = {
    }
  },

+  async refreshCalls() {
+    try {
+      update({ calls: await api.calls() });
+    } catch (cause) {
+      update({ error: cause instanceof Error ? cause.message : String(cause) });
+    }
+  },
+
  async openCallDetails(callId: string) {
    await perform(() => api.openCallDetails(callId));
  },
@@ -8,6 +8,7 @@
  color: var(--vscode-foreground);
  font-size: type.$font-size-xs;
  cursor: pointer;
+  flex-shrink: 0;

  input {
    position: absolute;
@@ -34,8 +34,8 @@
 }

 .iconButton {
-  width: 30px;
-  height: 30px;
+  width: 25px;
+  height: 25px;
  display: grid;
  place-items: center;
  padding: 0;
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
leookun	2ff74bc6a8	feat: webfetch	2026-08-30 11:54:32 +08:00
leookun	66ac94d5b1	feat: implement web cache for persisting and serving fetched content - Introduced a new `WebCache` module to manage web content caching. - Added functionality to store fetched content and serve it via a dedicated route. - Integrated web cache into the search module for improved content retrieval. - Implemented database migration management with detailed diagnostics for better error handling during startup. - Updated the SQLite store to utilize the new migration system for enhanced database management.	2026-08-30 04:29:39 +08:00
leookun	fd7998e43c	feat: enhance desktop application startup diagnostics and logging - Introduced a new `startup` module to capture and manage startup diagnostics. - Implemented logging functionality with daily rotation and error reporting for application startup failures. - Updated the main application run function to return an exit code based on startup success or failure. - Added new dependencies for logging and diagnostics in `Cargo.toml`. - Increased request timeout in the control service for improved stability. - Expanded maximum search results in the federation module for better search capabilities.	2026-08-30 03:19:01 +08:00
leookun	44e2d8057a	feat: initialize server structure and database schema - Added initial server setup with Cargo.toml defining dependencies and project structure. - Created build.rs for generating protobuf bindings and validating wire contracts. - Established database schema with initial migration files for conversations, messages, and runs. - Introduced tools and prompts for Cursor functionality, enhancing user interaction capabilities.	2026-08-30 01:33:39 +08:00
leookun	d200b3791d	new plan	2026-08-29 22:05:04 +08:00
leookun	279e6bb07c	refactor: align project directory architecture	2026-08-29 20:45:51 +08:00
leookun	88f258f184	feat: enhance Makefile for Windows and non-Windows desktop builds - Added conditional logic in the Makefile to support Tauri signing key generation for Windows environments. - Updated the build-desktop target to ensure proper signing key handling across different operating systems.	2026-08-28 23:36:27 +08:00
leokun	c983124288	Merge pull request #374 from zwenooo/codex/fix-cursor-reasoning-parameter fix: align Cursor reasoning parameter metadata	2026-08-28 23:22:06 +08:00
leokun	6447fd998a	Merge pull request #367 from jiah0231/fix/runtime-unsupported-tool-recovery 修复：运行中遇到已移除/未知工具时避免 Agent 中断Fix/runtime unsupported tool recovery	2026-08-28 23:20:32 +08:00
leookun	5cc2401ce2	feat: add first valid response timing and related metrics - Introduced `first_valid_response_ms` and `ttfr_ms` to track the timing of the first valid response in LLM calls. - Updated relevant interfaces and components to display and utilize the new metrics, including CallDetails, CallTable, and LatencyChart. - Enhanced the database schema to accommodate the new timing fields. - Implemented logic in the service layer to record the first valid response during model interactions.	2026-08-28 22:56:39 +08:00
leokun	5a0bc2e0e9	fix: persist each provider retry as its own llm_calls row Retry attempts now finish the failed call, start a new call id, and record the next request so call history shows intermediate failures.	2026-08-28 21:09:45 +08:00
leokun	6a3570a95a	refactor: implement retry mechanism for API calls in Anthropic, OpenAI Chat, and OpenAI Responses providers - Replaced direct API call handling with a retry mechanism using `send_with_retry`. - Improved error handling and response management for better reliability in network requests.	2026-08-28 20:37:52 +08:00
leokun	921bcfd247	feat: implement automatic call refresh on CallsPage - Added a refreshCalls function to appStore to fetch updated call data. - Integrated useEffect in CallsPage to periodically refresh calls every 2 seconds and on visibility change.	2026-08-28 19:46:37 +08:00
leokun	e27b989002	Fix compaction projection and MCP image truncation	2026-08-28 18:54:27 +08:00
leokun	e874d68b79	docs: update README and documentation to clarify model configuration and restart requirements - Enhanced instructions for restarting Cursor after upgrades or initial model configuration to ensure proper functionality. - Updated references from "Troubleshooting" to "Frequently Asked Questions" for better alignment with user needs. - Improved clarity in the installation and usage steps across multiple language versions.	2026-08-28 16:12:06 +08:00
zwen	befb18d9c3	fix: align Cursor reasoning parameter metadata	2026-08-28 15:24:12 +08:00
leokun	d0033a768b	Merge pull request #369 from leookun/fix/stream-lifecycle-reliability fix: repair stream lifecycle reliability	2026-08-28 13:02:16 +08:00
leookun	59379f1f72	fix: repair stream lifecycle reliability	2026-08-28 13:00:39 +08:00
leookun	370f120b8a	docs: update README to reflect recent changes and improve clarity	2026-08-28 12:50:01 +08:00
leookun	1ab86c1851	docs: update image references in README for consistency	2026-08-28 12:44:18 +08:00
leokun	d015d1c33b	docs: sync README from source repo	2026-08-28 12:36:30 +08:00
jiah0231	2c32dad271	test: cover AwaitShell emitted during active run	2026-08-28 12:21:45 +08:00
jiah0231	85241a0413	docs: describe AwaitShell as runtime unsupported tool	2026-08-28 12:21:34 +08:00
leokun	1fcb78ad95	Merge pull request #366 from joel01-dev/fix/stream-reliability-v2	2026-08-28 12:14:10 +08:00
jiah0231	edc28de86b	修复：兼容已移除工具，避免旧会话 Resume 中断兼容 v0.1.5-beta.1 删除 AwaitShell 后的旧会话 Resume，并将未知/已移除工具降级为模型可见失败结果，避免整个 Agent Run 被 Protocol Error 直接终止。	2026-08-28 12:12:50 +08:00
joel01-dev	b2610c562e	fix: restore upstream openai_chat.rs, add only debug logging	2026-08-28 01:12:31 -03:00
joel01-dev	318545cebd	fix: restore upstream dispatch/mod.rs, add only Bash alias	2026-08-28 01:07:41 -03:00
joel01-dev	2369d101ec	docs: add PR description	2026-08-28 00:48:43 -03:00
joel01-dev	80604bdf97	fix: prevent silent SSE stream hangs, add Bash alias, debug logging - Actor: use lifecycle::cancel() instead of handle.cancel() on channel close and Abort, ensuring end-stream frame is always emitted - Lifecycle: use match instead of ? on encode_error_end_stream with fallback end-stream frame to prevent silent hangs - Dispatch: add Bash tool alias for Shell - Context/Blob sync: increase timeouts from 15s to 60s - Providers: add detailed debug logging to openai_chat and router	2026-08-28 00:47:53 -03:00
leookun	c4031d4074	chore(release): bump desktop to v0.1.5-beta.1	2026-08-28 10:40:26 +08:00
leookun	b15e149b9d	fix：add anthropic cache block	2026-08-28 10:33:00 +08:00
leookun	15f2280e07	Merge branch 'main' of github.com:leookun/cursor-byok	2026-08-28 10:18:18 +08:00
leookun	71ddf71ec1	feat(api): enhance statistics storage management with scope options - Introduced a new type `StatisticsStorageScope` to specify the scope for clearing statistics. - Updated the `clearStatisticsStorage` API method to accept a scope parameter, allowing for selective clearing of detailed records or all statistics. - Modified the demo API to handle the new scope parameter appropriately. - Updated the SettingsPage component to include a selection for clearing scope, enhancing user control over statistics management. - Added new translations for the updated messages related to statistics clearing in both English and Chinese.	2026-08-28 10:18:11 +08:00
leokun	cde4d55fd2	Merge pull request #361 from LyricalNanoha/fix/omit-empty-tools-array	2026-08-28 10:11:09 +08:00
leookun	217f984112	feat(docs): enhance documentation and UI consistency - Updated the index.html to dynamically set the theme color based on user selection, improving user experience during theme switching. - Modified proxy.ts to include 'icon.png' in the matcher for better asset handling. - Added a new icon.png file for enhanced branding. - Improved metadata in layout.tsx and page.tsx files for better clarity and consistency in documentation. - Updated various documentation files to reflect the new branding of 'Cursor Byok' and ensure consistent terminology throughout. - Removed outdated blog entries and added new content to better align with the current product direction.	2026-08-28 01:33:51 +08:00
leookun	2b54014cf9	feat(docs): update ESLint configuration to include additional directories - Added '.open-next/', '.wrangler/', and 'cloudflare-env.d.ts' to the ESLint configuration for improved linting coverage of new files and directories.	2026-08-28 00:47:45 +08:00
leookun	6b65a4ae31	feat(docs): reorganize images in README for clarity and consistency - Moved image assets to a more appropriate section in README.md for better visual flow. - Removed duplicate image entries to streamline the documentation.	2026-08-28 00:43:40 +08:00
leookun	8ca62e933b	feat(docs): update image assets in README for improved visuals - Replaced existing images in README.md with updated versions for brand, dashboard, and model settings. - Added new image files: en-brand-1.png, en-home-1.png, and en-model-1.png.	2026-08-28 00:42:52 +08:00
leookun	c711690f90	feat(docs): update configuration and improve caching for documentation site - Added Cloudflare and OpenNext configurations to .gitignore. - Updated next.config.mjs to disable image optimization for better performance with CDN. - Modified fetchJson function in github.ts to use 'force-cache' for improved data fetching efficiency. - Updated multiple image assets for the documentation site.	2026-08-28 00:41:13 +08:00
leookun	ed300cc92e	feat(docs): add wrangler configuration for cursor-byok documentation site - Created a new wrangler.jsonc file to define the configuration for the cursor-byok-docs project. - Set compatibility date and enabled necessary compatibility flags for Node.js API and public fetch. - Specified asset directory and service bindings for the documentation site.	2026-08-28 00:35:37 +08:00
leookun	eca063e424	feat(docs): enhance documentation site with internationalization and layout updates - Updated the demo API to support locale-based content rendering. - Refactored the main layout to accommodate language-specific metadata and routing. - Introduced new components for blog and documentation pages, ensuring proper language handling. - Added styles for improved UI consistency across different sections. - Removed deprecated layout files and streamlined the structure for better maintainability.	2026-08-28 00:35:31 +08:00
leokun	6c758f2b44	Merge branch 'main' of github.com:leookun/cursor-byok # Conflicts: # server/src/cursor/tools/dispatch/mod.rs	2026-08-27 21:47:27 +08:00
leokun	9cb16e116b	feat(cursor): normalize block_until_ms argument for shell tool calls - Added a new function to normalize the `block_until_ms` argument for shell tool calls, ensuring it is an integer and within valid range. - Updated the `start` function to utilize the normalization logic. - Introduced tests to validate the behavior of the normalization function, including acceptance of integer-valued floats and rejection of invalid values.	2026-08-27 21:45:36 +08:00
leokun	c5d578c5b1	feat(docs): add documentation site and demo features - Introduced a new documentation site for Cursor BYOK using Next.js and Fumadocs. - Added a product demo page with a corresponding Vite configuration. - Implemented a demo API to simulate LLM calls and responses. - Enhanced the Makefile to include new build and development commands for the documentation. - Updated package.json scripts for building and running the documentation site. - Created various components and layouts for the documentation structure, including blog and user documentation sections. - Added styling for the new components and layouts to ensure a cohesive design. - Included a README and other necessary files for local development and deployment.	2026-08-27 21:45:28 +08:00
leokun	661ce11207	Merge pull request #359 from jiah0231/fix/shell-block-until-ms 修复：兼容 Shell/AwaitShell 的整数值 block_until_ms	2026-08-27 19:57:52 +08:00
leokun	477750860f	Merge pull request #363 from Weizhena/fix/ollama-reasoning fix: accept reasoning field in OpenAI Chat streams（ When using Ollama Cloud）	2026-08-27 19:56:57 +08:00
Jilin Chen	02a190489a	fix: accept reasoning field in OpenAI Chat streams	2026-08-27 19:23:58 +08:00
leokun	ee915ee760	fix: preempt root loop on context injection	2026-08-27 17:01:03 +08:00
leokun	aa68205735	fix: extend provider request timeout	2026-08-27 15:54:08 +08:00
nanoha	e4515dc4e0	fix: omit tools field from provider requests when empty vLLM and some OpenAI-compatible APIs reject requests containing an empty `tools: []` array with a 400 Bad Request. This affects the model connectivity test which sends no tools. Instead of always including the tools field, conditionally add it only when tools are present.	2026-08-27 14:02:16 +08:00
leokun	14d6a501a0	chore: release v0.1.4	2026-08-27 11:30:54 +08:00
leokun	82f3ae8d59	feat(settings): add dock icon visibility setting to desktop settings - Introduced a new setting `show_dock_icon` in the `DesktopSettings` interface. - Updated `AppLifecycleSettingsCard` to manage dock icon visibility with a toggle switch. - Enhanced the API to read and write the new dock icon visibility setting. - Added corresponding translations for the new setting in both English and Chinese locales. - Updated tests to ensure the default behavior of showing the dock icon and proper round-trip functionality for settings.	2026-08-27 11:24:04 +08:00
leokun	31dfa8d295	refactor: improve MCP parameter normalization and test clarity - Changed `normalize_mcp_parameters` to avoid mutating the input parameters. - Updated the test name to better reflect its purpose of preserving the cursor object union schema. - Adjusted assertions in the test to compare the entire schema instead of individual fields.	2026-08-27 11:11:13 +08:00
jiah0231	7914f24d83	fix: preserve dynamic MCP argument schemas	2026-08-27 10:31:18 +08:00
jiah0231	b85cb37898	fix: normalize integer-valued shell timeouts	2026-08-27 10:30:42 +08:00
leookun	995a12df44	chore: update dependencies and improve chart components - Updated `foreign-types` to version 0.5.0 and added new dependencies in `Cargo.lock`. - Removed unused dependencies `chart.js` and `react-chartjs-2` from `package.json` and `package-lock.json`. - Enhanced `CacheHitRateChart` to use `EChart` for rendering, improving performance and visual fidelity. - Adjusted styles for `CacheHitRateChart` to ensure proper layout and responsiveness. - Refactored API query construction in `api.ts` for better readability. - Updated `HomeMetrics` to support refresh functionality for dynamic data updates.	2026-08-27 00:34:35 +08:00
leokun	7058d0193d	Merge pull request #356 from GGboya/feat/provider-presets feat(console): dual-protocol provider presets + fix sub-path model di…	2026-08-27 00:12:14 +08:00
leookun	eff642fdcf	Merge branch 'main' into pr/GGboya/356	2026-08-26 23:28:11 +08:00
leokun	2c95d7f836	fix: finalize draft releases by asset id	2026-08-26 22:44:27 +08:00
ggboysongyuhangandClaude Fable 5	75babb7334	feat(console): dual-protocol provider presets + fix sub-path model discovery Console — provider presets inside the model editor: - Preset chips for five coding-plan providers (Zhipu GLM / Kimi / DeepSeek / Volcengine Ark / MiniMax) rendered at the top of the add/edit model dialog - All five providers expose both an Anthropic-protocol and an OpenAI-protocol endpoint; a click fills the endpoint matching the current model type, and switching the type automatically swaps to the same provider's other endpoint (no stale URL/protocol mismatches) - Switching to a different provider clears the API key; switching protocols within the same provider keeps it - Fills base URL (full-request-URL form for irregular paths), request protocol, claude-cli custom headers for Anthropic endpoints, token limits, remark, and the default model id + display name; known preset model ids merge into the model-name combobox Server — model discovery for sub-path endpoints: - model_discovery_url previously replaced the whole path with /v1/models, which strips the /api/anthropic, /coding, /api/paas/v4 style prefixes every coding-plan provider uses, so discovery always 404'd for them. It now appends to the existing path and normalizes endpoint/version suffixes (/chat/completions, /responses, /messages, /v1, /v3, /v4) - Verified live against Zhipu (10 models) and Kimi (4 models) coding plans; existing tests updated to the append semantics plus new URL cases Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-08-26 22:43:24 +08:00
leokun	f6be6c2b27	release: v0.1.3	2026-08-26 22:09:36 +08:00
leokun	ded534fecf	feat: update UI	2026-08-26 22:01:14 +08:00
leokun	5450fc76e2	fix: shell	2026-08-26 20:20:38 +08:00
leokun	df053c3720	fix: harden concurrent persistence and task recovery	2026-08-26 16:46:41 +08:00
				`@@ -0,0 +1 @@`
				<svg height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>DeepSeek</title><path d="M23.748 4.482c-.254-.124-.364.113-.512.234-.051.039-.094.09-.137.136-.372.397-.806.657-1.373.626-.829-.046-1.537.214-2.163.848-.133-.782-.575-1.248-1.247-1.548-.352-.156-.708-.311-.955-.65-.172-.241-.219-.51-.305-.774-.055-.16-.11-.323-.293-.35-.2-.031-.278.136-.356.276-.313.572-.434 1.202-.422 1.84.027 1.436.633 2.58 1.838 3.393.137.093.172.187.129.323-.082.28-.18.552-.266.833-.055.179-.137.217-.329.14a5.526 5.526 0 01-1.736-1.18c-.857-.828-1.631-1.742-2.597-2.458a11.365 11.365 0 00-.689-.471c-.985-.957.13-1.743.388-1.836.27-.098.093-.432-.779-.428-.872.004-1.67.295-2.687.684a3.055 3.055 0 01-.465.137 9.597 9.597 0 00-2.883-.102c-1.885.21-3.39 1.102-4.497 2.623C.082 8.606-.231 10.684.152 12.85c.403 2.284 1.569 4.175 3.36 5.653 1.858 1.533 3.997 2.284 6.438 2.14 1.482-.085 3.133-.284 4.994-1.86.47.234.962.327 1.78.397.63.059 1.236-.03 1.705-.128.735-.156.684-.837.419-.961-2.155-1.004-1.682-.595-2.113-.926 1.096-1.296 2.746-2.642 3.392-7.003.05-.347.007-.565 0-.845-.004-.17.035-.237.23-.256a4.173 4.173 0 001.545-.475c1.396-.763 1.96-2.015 2.093-3.517.02-.23-.004-.467-.247-.588zM11.581 18c-2.089-1.642-3.102-2.183-3.52-2.16-.392.024-.321.471-.235.763.09.288.207.486.371.739.114.167.192.416-.113.603-.673.416-1.842-.14-1.897-.167-1.361-.802-2.5-1.86-3.301-3.307-.774-1.393-1.224-2.887-1.298-4.482-.02-.386.093-.522.477-.592a4.696 4.696 0 011.529-.039c2.132.312 3.946 1.265 5.468 2.774.868.86 1.525 1.887 2.202 2.891.72 1.066 1.494 2.082 2.48 2.914.348.292.625.514.891.677-.802.09-2.14.11-3.054-.614zm1-6.44a.306.306 0 01.415-.287.302.302 0 01.2.288.306.306 0 01-.31.307.303.303 0 01-.304-.308zm3.11 1.596c-.2.081-.399.151-.59.16a1.245 1.245 0 01-.798-.254c-.274-.23-.47-.358-.552-.758a1.73 1.73 0 01.016-.588c.07-.327-.008-.537-.239-.727-.187-.156-.426-.199-.688-.199a.559.559 0 01-.254-.078c-.11-.054-.2-.19-.114-.358.028-.054.16-.186.192-.21.356-.202.767-.136 1.146.016.352.144.618.408 1.001.782.391.451.462.576.685.914.176.265.336.537.445.848.067.195-.019.354-.25.452z" fill="#4D6BFE"></path></svg>
				`@@ -0,0 +1 @@`
				<svg fill="currentColor" fill-rule="evenodd" height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Kimi</title><path d="M19.738 5.776c.163-.209.306-.4.457-.585.07-.087.064-.153-.004-.244-.655-.861-.717-1.817-.34-2.787.283-.73.909-1.072 1.674-1.145.477-.045.945.004 1.379.236.57.305.902.77 1.01 1.412.086.512.07 1.012-.075 1.508-.257.878-.888 1.333-1.753 1.448-.718.096-1.446.108-2.17.157-.056.004-.113 0-.178 0z" fill="#027AFF"></path><path d="M17.962 1.844h-4.326l-3.425 7.81H5.369V1.878H1.5V22h3.87v-8.477h6.824a3.025 3.025 0 002.743-1.75V22h3.87v-8.477a3.87 3.87 0 00-3.588-3.86v-.01h-2.125a3.94 3.94 0 002.323-2.12l2.545-5.689z"></path></svg>