Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

fix(desktop): complete personal build integration and Linux bootstrap

MagicLizi4317bcb9d1f7
diff --git a/apps/desktop/resources/linux/install-omarchy.sh b/apps/desktop/resources/linux/install-omarchy.sh
new file mode 100644
index 0000000000..546d763911
--- /dev/null
+++ b/apps/desktop/resources/linux/install-omarchy.sh
@@ -0,0 +1,204 @@
+#!/usr/bin/env bash
+# Website/OSS bootstrap for Arch and Omarchy. Fetch one stable manifest snapshot,
+# then use the installer shipped INSIDE its verified DEB (never Git HEAD).
+# Keep the entry point last: a truncated curl | bash input must not start an install.
+cindy_bootstrap() (
+ set -euo pipefail
+ umask 077
+ export LC_ALL=C
+ fail() { printf 'Cindy: %s\n' "$*" >&2; exit 1; }
+ usage() {
+ printf '%s\n' 'Usage: bash install-omarchy.sh [--region global|cn] [--prefix /absolute/path]' \
+ 'Installs the latest stable Cindy on Arch Linux / Omarchy, without sudo.'
+ }
+ region=global
+ prefix=''
+ while (( $# )); do
+ case "$1" in
+ --region) [[ $# -ge 2 ]] || fail 'Missing region.'; region=$2; shift 2 ;;
+ --prefix) [[ $# -ge 2 && -n $2 ]] || fail 'Missing prefix.'; prefix=$2; shift 2 ;;
+ --help|-h) usage; exit 0 ;;
+ *) usage >&2; fail "Unknown argument: $1" ;;
+ esac
+ done
+ # Match config/endpoint.global.json and config/endpoint.json. A website chooses
+ # its build via the command, not by guessing the user's IP or locale.
+ case "$region" in
+ global) base_url=https://hotfix.cindy.app/cindy ;;
+ cn) base_url=https://hotfix.cindy.com.cn/cindy ;;
+ *) fail 'Region must be global or cn.' ;;
+ esac
+ [[ $(uname -s) == Linux ]] || fail 'This installer requires Arch Linux / Omarchy.'
+ [[ $EUID -ne 0 ]] || fail 'Run as your desktop user, not root or sudo.'
+ [[ -r /etc/os-release ]] || fail 'Cannot identify this Linux distribution.'
+ ID='' ID_LIKE=''
+ # shellcheck source=/dev/null
+ source /etc/os-release
+ case " $ID $ID_LIKE " in
+ *' debian '*|*' ubuntu '*) fail 'On Ubuntu / Debian, download the official .deb and install it with apt.' ;;
+ *' arch '*|*' omarchy '*) ;;
+ *) fail 'This one-command installer supports Arch Linux / Omarchy only.' ;;
+ esac
+ case "$(uname -m)" in
+ x86_64) arch=x64 ;;
+ aarch64) arch=arm64 ;;
+ *) fail 'No official Linux package is available for this architecture.' ;;
+ esac
+ packages='curl jq libarchive coreutils util-linux findutils procps-ng desktop-file-utils xdg-utils gtk3 nss alsa-lib libxss libxtst libnotify libdrm mesa libsecret'
+ missing=()
+ for tool in curl jq bsdtar sha256sum stat dd mktemp realpath flock find readlink mv ln sort date id pgrep pacman desktop-file-validate update-desktop-database xdg-mime; do
+ command -v "$tool" >/dev/null || missing+=("$tool")
+ done
+ if (( ${#missing[@]} )); then
+ printf 'Missing tools: %s\nRun: sudo pacman -Syu --needed %s\n' "${missing[*]}" "$packages" >&2
+ exit 1
+ fi
+ runtime_missing=$(pacman -T gtk3 nss alsa-lib libxss libxtst libnotify libdrm mesa libsecret) || {
+ printf 'Missing runtime libraries:\n%s\nRun: sudo pacman -Syu --needed %s\n' "$runtime_missing" "$packages" >&2
+ exit 1
+ }
+ # Do not shadow a package-manager-owned install with a new user installation.
+ for executable in /usr/lib/cindy/Cindy /usr/bin/cindy /usr/bin/Cindy; do
+ if pacman -Qo -- "$executable" >/dev/null 2>&1; then
+ fail 'Cindy is managed by pacman/AUR. Update it through that package manager.'
+ fi
+ if command -v dpkg-query >/dev/null && dpkg-query -S "$executable" >/dev/null 2>&1; then
+ fail 'Cindy is a system package. Update it through its package manager.'
+ fi
+ done
+ if pgrep -u "$(id -u)" -x Cindy >/dev/null; then
+ fail 'Quit Cindy fully, then run this command again.'
+ fi
+ user_home=$(realpath -e -- "$HOME")
+ data_dir=$(realpath -m -- "${XDG_DATA_HOME:-$HOME/.local/share}")
+ [[ $data_dir == "$user_home/"* && $data_dir != *[[:cntrl:]]* ]] || fail 'XDG_DATA_HOME must be inside HOME without control characters.'
+
+ # v1 defaulted BOTH regions to cindy. Reuse that legacy prefix when its
+ # marker matches; new cn installs get a distinct, explicitly named prefix.
+ if [[ -z $prefix ]]; then
+ default_prefix="$user_home/.local/opt/cindy"
+ if [[ $region == cn ]]; then
+ legacy_marker="$default_prefix/.cindy-user-install"
+ if [[ ! -L $default_prefix && -f $legacy_marker && ! -L $legacy_marker && $(< "$legacy_marker") == cindy-user-install-v1:cn ]]; then
+ prefix=$default_prefix
+ else
+ default_prefix+=-cn
+ fi
+ fi
+ if [[ -z $prefix ]]; then
+ prefix=$default_prefix
+ suffix=0
+ while [[ -e $prefix || -L $prefix ]]; do
+ marker="$prefix/.cindy-user-install"
+ if [[ ! -L $prefix && -f $marker && ! -L $marker ]]; then
+ identity=$(< "$marker")
+ [[ $identity == "cindy-user-install-v1:$region" || $identity == cindy-user-install-v1:pending ]] && break
+ [[ $identity == cindy-user-install-v1:cn || $identity == cindy-user-install-v1:global ]] || fail "Invalid install marker: $marker"
+ elif [[ ! -L $prefix && ( -e $marker || -L $marker ) ]]; then
+ fail "Invalid install marker: $marker"
+ fi
+ (( suffix += 1 ))
+ [[ $suffix -le 100 ]] || fail 'Choose an unused installation directory with --prefix.'
+ prefix="$default_prefix-managed"
+ (( suffix == 1 )) || prefix+="-$suffix"
+ done
+ fi
+ fi
+ [[ $prefix == /* && ! -L $prefix && $prefix != *[[:cntrl:]=%]* ]] || fail 'PREFIX must be absolute, not a symlink, and contain no control characters, = or %.'
+ prefix=$(realpath -m -- "$prefix")
+ [[ $prefix == "$user_home/"* && $prefix != *[[:cntrl:]=%]* ]] || fail 'PREFIX must be inside HOME with no control characters, = or %.'
+ validate_prefix() {
+ [[ ! -L $prefix && $(realpath -m -- "$prefix") == "$prefix" ]] || fail 'PREFIX changed during installation; retry.'
+ if [[ -e $prefix ]]; then
+ marker="$prefix/.cindy-user-install"
+ [[ -d $prefix && -O $prefix && -f $marker && ! -L $marker && -O $marker ]] || fail 'Existing PREFIX is not a managed, user-owned Cindy installation.'
+ identity=$(< "$marker")
+ [[ $identity == "cindy-user-install-v1:$region" || $identity == cindy-user-install-v1:pending ]] || fail 'Do not mix release regions in one installation.'
+ fi
+ }
+ validate_prefix
+ # Serialize bootstrap invocations before reading the manifest/current version.
+ # A sibling lock works before PREFIX exists and is separate from the packaged
+ # helper's fd 9 / .install.lock. Keep its inode even after releasing the lock.
+ mkdir -p -- "${prefix%/*}"
+ bootstrap_lock="$prefix.bootstrap.lock"
+ [[ ! -L $bootstrap_lock ]] || fail 'Invalid bootstrap lock.'
+ if [[ -e $bootstrap_lock ]]; then
+ [[ -f $bootstrap_lock && -O $bootstrap_lock ]] || fail 'Invalid bootstrap lock.'
+ fi
+ exec 8>> "$bootstrap_lock"
+ flock -n 8 || fail 'Another Cindy bootstrap is in progress for this installation. Wait for it to finish, then retry.'
+ validate_prefix
+
+ temp=$(mktemp -d -t cindy-bootstrap.XXXXXXXX)
+ trap 'rm -rf -- "$temp"' EXIT
+ trap 'exit 130' INT
+ trap 'exit 143' TERM HUP
+ fetch() {
+ curl --fail --show-error --location --proto '=https' --proto-redir '=https' \
+ --connect-timeout 15 --max-time "$4" --retry 2 --max-filesize "$3" \
+ --output "$2" "$1"
+ }
+ printf 'Checking the latest Cindy release...\n'
+ fetch "$base_url/manifest-linux-$arch.json?t=$(date +%s)" "$temp/manifest.json" 1048576 60 || fail 'Could not fetch the latest release. Retry when the release service is reachable.'
+ # Parse JSON as data, never shell code. Only relative, versioned asset paths
+ # under the selected CDN are accepted, matching PlatformAsset.file.
+ jq -er '
+ .app | select(type == "object") |
+ select(.version | type == "string" and test("^[0-9]+\\.[0-9]+\\.[0-9]+$")) |
+ select(.installer.file | type == "string" and test("^[A-Za-z0-9_-][A-Za-z0-9._/+%-]*\\.deb$")) |
+ select(.installer.file | split("/") | all(. != ".." and . != "." and . != "")) |
+ select(.installer.file | contains("%") | not) |
+ select(.installer.sha256 | type == "string" and test("^[a-fA-F0-9]{64}$")) |
+ select(.installer.size | type == "number" and . > 0 and . <= 99999999999 and . == floor) |
+ [.version, .installer.file, (.installer.sha256 | ascii_downcase), (.installer.size | tostring)] | .[]
+ ' "$temp/manifest.json" > "$temp/asset" || fail 'The latest release has no valid stable Linux installer metadata.'
+ mapfile -t asset < "$temp/asset"
+ [[ ${#asset[@]} -eq 4 ]] || fail 'Invalid release metadata.'
+ version=${asset[0]} file=${asset[1]} digest=${asset[2]} size=${asset[3]}
+ # A stale CDN must not roll an existing profile back to an older binary.
+ installed_info="$prefix/current/resources/linux-build-info"
+ if [[ -f $installed_info ]]; then
+ mapfile -t installed < "$installed_info"
+ [[ ${#installed[@]} -eq 5 && ${installed[0]} == cindy-linux-v1 && ${installed[3]} == "$region" ]] || fail 'Invalid installed build identity.'
+ installed_version=${installed[1]}
+ [[ $installed_version =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]] || fail 'Use in-app updates for a non-stable installation.'
+ oldest=$(printf '%s\n%s\n' "$installed_version" "$version" | sort -V | head -n 1)
+ [[ $oldest == "$installed_version" ]] || fail 'The published release is older than this installation; refusing to downgrade.'
+ fi
+ printf 'Downloading Cindy %s (%s)...\n' "$version" "$arch"
+ fetch "$base_url/$file" "$temp/package.deb" "$size" 1800 || fail 'Package download failed. Run this command again to retry.'
+ [[ $(stat -c %s -- "$temp/package.deb") == "$size" ]] || fail 'Package size mismatch; nothing was installed.'
+ actual=$(sha256sum -- "$temp/package.deb")
+ [[ ${actual:0:64} == "$digest" ]] || fail 'Package SHA-256 mismatch; nothing was installed.'
+
+ bsdtar -tf "$temp/package.deb" > "$temp/members"
+ data_member=''
+ while IFS= read -r member; do
+ case "$member" in
+ data.tar|data.tar.gz|data.tar.xz|data.tar.zst)
+ [[ -z $data_member ]] || fail 'Duplicate package payload.'
+ data_member=$member ;;
+ esac
+ done < "$temp/members"
+ [[ -n $data_member ]] || fail 'Missing package payload.'
+ bsdtar -xOf "$temp/package.deb" "$data_member" > "$temp/data.tar"
+ # Read only the identity and helpers, into regular private files. Their bytes
+ # are covered by the trusted DEB digest; no extracted paths are executed.
+ resources=./usr/lib/cindy/resources
+ for entry in linux-build-info linux/install-user.sh linux/register-desktop.sh; do
+ bsdtar -xOf "$temp/data.tar" "$resources/$entry" > "$temp/${entry##*/}" || fail 'This package predates one-command installation support. Publish a newer Linux release.'
+ [[ -s $temp/${entry##*/} ]] || fail 'Missing installation helper or build identity.'
+ done
+ mapfile -t fields < "$temp/linux-build-info"
+ [[ ${#fields[@]} -eq 5 && ${fields[0]} == cindy-linux-v1 && ${fields[1]} == "$version" && ${fields[2]} == "$arch" && ${fields[3]} == "$region" && ${fields[4]} == Cindy ]] || fail 'Package version, architecture or region does not match the selected release.'
+ printf 'Installing to %s...\n' "$prefix"
+ bash "$temp/install-user.sh" --install "$temp/package.deb" "$digest" "$prefix"
+ if ! bash "$temp/register-desktop.sh" "$prefix"; then
+ printf 'Cindy was installed, but desktop registration failed. Retry with:\nbash %q %q\n' "$prefix/current/resources/linux/register-desktop.sh" "$prefix" >&2
+ exit 1
+ fi
+ printf 'Cindy %s is ready. Open Cindy from your application menu, or run:\n%q\n' "$version" "$prefix/launch"
+)
+
+cindy_bootstrap "$@"
diff --git a/apps/desktop/scripts/__tests__/install-omarchy.smoke.mjs b/apps/desktop/scripts/__tests__/install-omarchy.smoke.mjs
new file mode 100644
index 0000000000..cbefe7d93d
--- /dev/null
+++ b/apps/desktop/scripts/__tests__/install-omarchy.smoke.mjs
@@ -0,0 +1,294 @@
+// Native bootstrap smoke: node --test apps/desktop/scripts/__tests__/install-omarchy.smoke.mjs
+// Linux, non-root; requires the tools listed in docs/linux.md plus binutils.
+// HTTP, distro identity, package ownership and desktop MIME writes are faked.
+// DEB creation, extraction, verification, install transactions and desktop-file
+// validation are real. No network, actual user profile or desktop is accessed.
+import assert from 'node:assert/strict';
+import { createHash } from 'node:crypto';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawn, spawnSync, execFileSync } from 'node:child_process';
+import test from 'node:test';
+
+const repo = fileURLToPath(new URL('../../../../', import.meta.url));
+const resources = path.join(repo, 'apps/desktop/resources/linux');
+const bootstrap = path.join(resources, 'install-omarchy.sh');
+
+test('Arch / Omarchy bootstrap with verified native packages', { skip: process.platform !== 'linux' }, async (t) => {
+ assert.notEqual(process.getuid(), 0, 'Run as an unprivileged test user.');
+ for (const tool of ['bash', 'curl', 'jq', 'bsdtar', 'ar', 'desktop-file-validate', 'update-desktop-database', 'xdg-mime']) {
+ execFileSync('sh', ['-c', 'command -v "$1"', 'probe', tool]);
+ }
+ const root = fs.mkdtempSync(path.join(os.tmpdir(), 'cindy-bootstrap-test-'));
+ t.after(() => fs.rmSync(root, { recursive: true, force: true }));
+ const bin = path.join(root, 'bin');
+ fs.mkdirSync(bin);
+ const writeTool = (name, body) => fs.writeFileSync(path.join(bin, name), `#!/bin/bash\nset -eu\n${body}\n`, { mode: 0o755 });
+ writeTool('uname', 'case "$1" in -s) echo "${TEST_KERNEL:-Linux}" ;; -m) echo "${TEST_MACHINE:-x86_64}" ;; esac');
+ writeTool('pgrep', 'exit "${TEST_RUNNING_STATUS:-1}"');
+ writeTool('pacman', 'case "$1" in -T) exit "${TEST_RUNTIME_STATUS:-0}" ;; -Qo) exit "${TEST_PACMAN_STATUS:-1}" ;; *) exit 90 ;; esac');
+ writeTool('dpkg-query', 'exit "${TEST_DPKG_STATUS:-1}"');
+ writeTool('xdg-mime', `printf '%s\\n' "$*" >> "$TEST_HOME/mime.log"; exit "\${TEST_MIME_STATUS:-0}"`);
+ writeTool('curl', `
+output=''
+for ((i=1; i<=$#; i++)); do
+ if [[ "\${!i}" == --output ]]; then ((i+=1)); output=\${!i}; fi
+done
+url=\${!#}
+printf '%s\n' "$url" >> "$TEST_HOME/downloads"
+[[ "\${TEST_NETWORK_FAIL:-0}" == 0 ]] || exit 22
+case "$url" in
+ */manifest-linux-*.json\?t=*) cp -- "$TEST_HOME/manifest.json" "$output" ;;
+ */app/linux-*/*.deb)
+ if [[ -n "\${TEST_PAUSE_FILE:-}" ]]; then
+ touch "$TEST_PAUSE_FILE.ready"
+ while [[ -f $TEST_PAUSE_FILE ]]; do sleep 0.01; done
+ fi
+ cp -- "$TEST_PACKAGE" "$output" ;;
+ *) exit 91 ;;
+esac`);
+ // Tests replace only /etc/os-release through Bash's normal startup hook.
+ // No production bypass flag or alternate download endpoint is introduced.
+ const bashEnv = path.join(root, 'bash-env');
+ fs.writeFileSync(bashEnv, 'source() { if [[ $1 == /etc/os-release ]]; then builtin source "$TEST_HOME/os-release"; else builtin source "$@"; fi; }\n');
+ const packages = new Map();
+ function buildPackage(version, region = 'global', arch = 'x64', legacy = false) {
+ const key = `${version}-${region}-${arch}-${legacy}`;
+ if (packages.has(key)) return packages.get(key);
+ const dir = path.join(root, key);
+ const app = path.join(dir, 'usr/lib/cindy');
+ fs.mkdirSync(path.join(app, 'resources/linux'), { recursive: true });
+ fs.writeFileSync(path.join(app, 'Cindy'), '#!/bin/sh\nexit 0\n', { mode: 0o755 });
+ fs.writeFileSync(path.join(app, 'resources/app.asar'), 'synthetic app');
+ fs.writeFileSync(path.join(app, 'resources/linux-build-info'), `cindy-linux-v1\n${version}\n${arch}\n${region}\nCindy\n`);
+ if (!legacy) for (const name of ['install-user.sh', 'register-desktop.sh']) {
+ fs.copyFileSync(path.join(resources, name), path.join(app, 'resources/linux', name));
+ }
+ execFileSync('bsdtar', ['-czf', 'data.tar.gz', './usr'], { cwd: dir });
+ fs.writeFileSync(path.join(dir, 'debian-binary'), '2.0\n');
+ execFileSync('ar', ['rc', 'package.deb', 'debian-binary', 'data.tar.gz'], { cwd: dir });
+ const file = path.join(dir, 'package.deb');
+ const bytes = fs.readFileSync(file);
+ const pkg = { file, version, region, arch, sha256: createHash('sha256').update(bytes).digest('hex'), size: bytes.length };
+ packages.set(key, pkg);
+ return pkg;
+ }
+ const v1 = buildPackage('1.0.0');
+ const v2 = buildPackage('1.0.1');
+ const v3 = buildPackage('1.0.2');
+ const cn = buildPackage('1.0.0', 'cn');
+ function fixture(name) {
+ const home = path.join(root, name);
+ fs.mkdirSync(home);
+ fs.mkdirSync(path.join(home, 'temp'));
+ fs.writeFileSync(path.join(home, 'os-release'), 'ID=arch\n');
+ return home;
+ }
+ const environment = (home, pkg, env = {}) => ({
+ PATH: `${bin}:${process.env.PATH}`, HOME: home, TMPDIR: path.join(home, 'temp'),
+ XDG_DATA_HOME: path.join(home, '.local/share'), XDG_CONFIG_HOME: path.join(home, '.config'),
+ BASH_ENV: bashEnv, TEST_HOME: home, TEST_PACKAGE: pkg.file, ...env,
+ });
+ function run(home, pkg = v1, { args = [], env = {}, app, input } = {}) {
+ const existingTemp = fs.readdirSync(path.join(home, 'temp'));
+ fs.writeFileSync(path.join(home, 'manifest.json'), JSON.stringify({ app: app ?? { version: pkg.version, installer: { file: `app/linux-${pkg.arch}/cindy-${pkg.version}.deb`, sha256: pkg.sha256, size: pkg.size } } }));
+ const result = spawnSync('bash', input === undefined ? [bootstrap, ...args] : ['-s', '--', ...args], {
+ encoding: 'utf8', timeout: 20000, input,
+ env: environment(home, pkg, env),
+ });
+ assert.ifError(result.error);
+ assert.deepEqual(fs.readdirSync(path.join(home, 'temp')), existingTemp, "only this invocation's temporary downloads must be cleaned");
+ return { ...result, output: result.stdout + result.stderr };
+ }
+ const prefixFor = (home) => path.join(home, '.local/opt/cindy');
+ const pointer = (prefix) => fs.readlinkSync(path.join(prefix, 'current'));
+ const ok = (result) => assert.equal(result.status, 0, result.output);
+ const fails = (result, reason) => { assert.notEqual(result.status, 0, result.output); assert.match(result.output, reason); };
+
+ await t.test('curl pipe, newest manifest on each invocation, two upgrades and idempotent repair', () => {
+ const home = fixture('upgrade');
+ const prefix = prefixFor(home);
+ fs.mkdirSync(path.join(home, '.config/CindyGlobal'), { recursive: true });
+ const data = path.join(home, '.config/CindyGlobal/fixture-data');
+ fs.writeFileSync(data, 'keep existing data');
+ ok(run(home, v1, { input: fs.readFileSync(bootstrap, 'utf8') }));
+ const first = pointer(prefix);
+ fs.unlinkSync(path.join(prefix, 'launch'));
+ ok(run(home));
+ assert.equal(pointer(prefix), first);
+ assert.equal(fs.readdirSync(path.join(prefix, 'releases')).length, 1);
+ assert.ok(fs.existsSync(path.join(prefix, 'launch')));
+ ok(run(home, v2));
+ assert.equal(fs.readlinkSync(path.join(prefix, 'previous')), first);
+ const second = pointer(prefix);
+ ok(run(home, v3));
+ assert.equal(fs.readlinkSync(path.join(prefix, 'previous')), second);
+ assert.equal(fs.readdirSync(path.join(prefix, 'releases')).length, 3);
+ assert.equal(fs.readFileSync(data, 'utf8'), 'keep existing data');
+ const downloads = fs.readFileSync(path.join(home, 'downloads'), 'utf8').trim().split('\n');
+ assert.equal(downloads.filter((url) => url.includes('/manifest-linux-x64.json?t=')).length, 4);
+ assert.ok(downloads.every((url) => url.startsWith('https://hotfix.cindy.app/cindy/')));
+ assert.equal(fs.readdirSync(path.join(home, '.local/share/applications')).filter((f) => f.endsWith('.desktop')).length, 1);
+ assert.ok(fs.readFileSync(path.join(home, 'mime.log'), 'utf8').includes('x-scheme-handler/cindy'));
+ const active = pointer(prefix);
+ fails(run(home, v1), /refusing to downgrade/);
+ assert.equal(pointer(prefix), active);
+ });
+ await t.test('Omarchy / cn uses its own CDN and prefix; legacy cn prefix remains compatible', () => {
+ const home = fixture('cn');
+ fs.writeFileSync(path.join(home, 'os-release'), 'ID=omarchy\nID_LIKE=arch\n');
+ ok(run(home, cn, { args: ['--region', 'cn'] }));
+ const prefix = `${prefixFor(home)}-cn`;
+ assert.equal(fs.readFileSync(path.join(prefix, '.cindy-user-install'), 'utf8').trim(), 'cindy-user-install-v1:cn');
+ assert.ok(fs.readFileSync(path.join(home, 'downloads'), 'utf8').trim().split('\n').every((url) => url.startsWith('https://hotfix.cindy.com.cn/cindy/')));
+ fs.renameSync(prefix, prefixFor(home));
+ ok(run(home, cn, { args: ['--region', 'cn'] }));
+ assert.ok(!fs.existsSync(prefix));
+ });
+ await t.test('unmarked directory is preserved; repeated runs reuse managed neighbor', () => {
+ const home = fixture('manual');
+ const prefix = prefixFor(home);
+ fs.mkdirSync(prefix, { recursive: true });
+ fs.writeFileSync(path.join(prefix, 'keep'), 'manual install');
+ ok(run(home));
+ const managed = `${prefix}-managed`;
+ const first = pointer(managed);
+ ok(run(home));
+ assert.equal(pointer(managed), first);
+ assert.equal(fs.readFileSync(path.join(prefix, 'keep'), 'utf8'), 'manual install');
+ fails(run(home, v1, { args: ['--prefix', prefix] }), /not a managed/);
+ });
+ await t.test('custom prefix with spaces and shell characters; cross-region install is rejected', () => {
+ const home = fixture('custom');
+ const prefix = path.join(home, "Cindy's space $literal");
+ ok(run(home, v1, { args: ['--prefix', prefix] }));
+ const first = pointer(prefix);
+ fails(run(home, cn, { args: ['--region', 'cn', '--prefix', prefix] }), /Do not mix release regions/);
+ assert.equal(pointer(prefix), first);
+ });
+ await t.test('a symlinked default is preserved even when its target is managed', () => {
+ const home = fixture('symlink');
+ const actual = path.join(home, 'original');
+ ok(run(home, v1, { args: ['--prefix', actual] }));
+ const first = pointer(actual);
+ const prefix = prefixFor(home);
+ fs.mkdirSync(path.dirname(prefix), { recursive: true });
+ fs.symlinkSync(actual, prefix);
+ ok(run(home, v2));
+ assert.equal(fs.readlinkSync(prefix), actual);
+ assert.equal(pointer(actual), first);
+ assert.match(pointer(`${prefix}-managed`), /^releases.1[.]0[.]1-/);
+ });
+ await t.test('desktop registration failure is explicit and a repeat invocation repairs it', () => {
+ const home = fixture('registration');
+ fails(run(home, v1, { env: { TEST_MIME_STATUS: '1' } }), /installed, but desktop registration failed/);
+ const first = pointer(prefixFor(home));
+ ok(run(home));
+ assert.equal(pointer(prefixFor(home)), first);
+ });
+ await t.test('bad metadata, bytes, identity and missing helpers leave the current install intact', () => {
+ const home = fixture('rejections');
+ ok(run(home));
+ const prefix = prefixFor(home);
+ const first = pointer(prefix);
+ const asset = { file: 'app/linux-x64/cindy-1.0.1.deb', sha256: v2.sha256, size: v2.size };
+ for (const [installer, reason] of [
+ [{ ...asset, sha256: '0'.repeat(64) }, /SHA-256 mismatch/],
+ [{ ...asset, size: v2.size + 1 }, /size mismatch/],
+ [{ ...asset, file: '../../payload.deb' }, /no valid stable/],
+ [{ ...asset, file: 'https://other.example/payload.deb' }, /no valid stable/],
+ [{ ...asset, file: 'app/%2e%2e/payload.deb' }, /no valid stable/],
+ [{ ...asset, size: '10' }, /no valid stable/],
+ ]) {
+ fails(run(home, v2, { app: { version: v2.version, installer } }), reason);
+ assert.equal(pointer(prefix), first);
+ }
+ fails(run(home, cn), /does not match the selected release/);
+ fails(run(home, v2, { app: { version: '1.0.9', installer: asset } }), /does not match the selected release/);
+ fails(run(home, buildPackage('1.0.1', 'global', 'arm64')), /does not match the selected release/);
+ fails(run(home, buildPackage('1.0.1', 'global', 'x64', true)), /predates one-command/);
+ fails(run(home, v2, { env: { TEST_NETWORK_FAIL: '1' } }), /Could not fetch/);
+ assert.equal(pointer(prefix), first);
+ assert.equal(fs.readdirSync(path.join(prefix, 'releases')).length, 1);
+ });
+ await t.test('arm64 selects the corresponding manifest and payload', () => {
+ const home = fixture('arm');
+ ok(run(home, buildPackage('1.0.0', 'global', 'arm64'), { env: { TEST_MACHINE: 'aarch64' } }));
+ assert.match(fs.readFileSync(path.join(home, 'downloads'), 'utf8'), /manifest-linux-arm64.json/);
+ });
+ await t.test('Ubuntu, Debian, Mint and non-Arch distros exit without any download', () => {
+ for (const [name, release] of [['ubuntu', 'ID=ubuntu\nID_LIKE=debian'], ['debian', 'ID=debian'], ['mint', 'ID=linuxmint\nID_LIKE="ubuntu debian"'], ['fedora', 'ID=fedora']]) {
+ const home = fixture(name);
+ fs.writeFileSync(path.join(home, 'os-release'), release + '\n');
+ fails(run(home), /Ubuntu.*Debian|Arch Linux.*Omarchy only/);
+ assert.ok(!fs.existsSync(path.join(home, 'downloads')));
+ assert.ok(!fs.existsSync(prefixFor(home)));
+ }
+ });
+ await t.test('system installs, running Cindy, missing libraries and invalid inputs exit before download', () => {
+ const home = fixture('preflight');
+ for (const [env, reason] of [
+ [{ TEST_PACMAN_STATUS: '0' }, /pacman.AUR/],
+ [{ TEST_DPKG_STATUS: '0' }, /system package/],
+ [{ TEST_RUNNING_STATUS: '0' }, /Quit Cindy/],
+ [{ TEST_RUNTIME_STATUS: '127' }, /Missing runtime libraries/],
+ [{ TEST_MACHINE: 'riscv64' }, /architecture/],
+ [{ TEST_KERNEL: 'Darwin' }, /requires Arch/],
+ ]) fails(run(home, v1, { env }), reason);
+ fails(run(home, v1, { args: ['--region', 'oops'] }), /Region must be/);
+ fails(run(home, v1, { args: ['--prefix', '/usr/cindy'] }), /inside HOME/);
+ fails(run(home, v1, { args: ['--prefix', path.join(home, 'bad%name')] }), /PREFIX must/);
+ assert.ok(!fs.existsSync(path.join(home, 'downloads')));
+ });
+ await t.test('a truncated curl pipe never starts downloading or installing', () => {
+ const home = fixture('truncated');
+ const input = fs.readFileSync(bootstrap, 'utf8').replace('cindy_bootstrap "$@"\n', 'cindy_bootstrap "');
+ fails(run(home, v1, { input }), /unexpected EOF/);
+ assert.ok(!fs.existsSync(path.join(home, 'downloads')));
+ });
+ await t.test('parallel bootstraps report busy before download; retry upgrades without downgrade', async () => {
+ for (const existing of [false, true]) {
+ const home = fixture(`parallel-${existing}`);
+ if (existing) ok(run(home));
+ const gate = path.join(home, 'download-gate');
+ fs.writeFileSync(gate, 'wait');
+ fs.writeFileSync(path.join(home, 'manifest.json'), JSON.stringify({ app: {
+ version: v2.version, installer: { file: 'app/linux-x64/cindy-1.0.1.deb', sha256: v2.sha256, size: v2.size },
+ } }));
+ const child = spawn('bash', [bootstrap], {
+ timeout: 20000,
+ env: environment(home, v2, { TEST_PAUSE_FILE: gate }),
+ });
+ let output = '';
+ child.stdout.on('data', (chunk) => { output += chunk; });
+ child.stderr.on('data', (chunk) => { output += chunk; });
+ const completion = new Promise((resolve, reject) => {
+ child.once('error', reject);
+ child.once('close', resolve);
+ });
+ try {
+ for (let i = 0; !fs.existsSync(`${gate}.ready`) && i < 1000; i++) {
+ await new Promise((resolve) => setTimeout(resolve, 10));
+ }
+ assert.ok(fs.existsSync(`${gate}.ready`), `older download is paused: ${output}`);
+ const downloads = fs.readFileSync(path.join(home, 'downloads'), 'utf8');
+ fails(run(home, v3), /Another Cindy bootstrap is in progress/);
+ assert.equal(fs.readFileSync(path.join(home, 'downloads'), 'utf8'), downloads);
+ } finally {
+ fs.rmSync(gate, { force: true });
+ assert.equal(await completion, 0, output);
+ }
+ const prefix = prefixFor(home);
+ assert.match(pointer(prefix), /^releases\/1[.]0[.]1-/);
+ assert.deepEqual(fs.readdirSync(path.join(home, 'temp')), []);
+ const lockInode = fs.statSync(`${prefix}.bootstrap.lock`).ino;
+ ok(run(home, v3));
+ assert.match(pointer(prefix), /^releases\/1[.]0[.]2-/);
+ fails(run(home, v2), /refusing to downgrade/);
+ assert.match(pointer(prefix), /^releases\/1[.]0[.]2-/);
+ assert.equal(fs.statSync(`${prefix}.bootstrap.lock`).ino, lockInode);
+ }
+ });
+});
diff --git a/apps/desktop/src/main/__tests__/clientEndpointsService.test.ts b/apps/desktop/src/main/__tests__/clientEndpointsService.test.ts
index 5578c6d31f..bd3815e8ab 100644
--- a/apps/desktop/src/main/__tests__/clientEndpointsService.test.ts
+++ b/apps/desktop/src/main/__tests__/clientEndpointsService.test.ts
@@ -14,6 +14,8 @@ import fs from 'node:fs';
import os from 'node:os';
import path from 'node:path';
import { EventEmitter } from 'node:events';
+import { app } from 'electron';
+import { setCindyPersonalRuntime, setCindyVersionEndpointOverride } from '../cindy-make/versionRuntimeIdentity';
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
@@ -261,6 +263,27 @@ describe('resolveEndpointSource(清单来源三选一)', () => {
});
describe('localhost 开发端点的 realm 固定', () => {
+ it('a packaged personal version keeps the verified local Dev services instead of sending credentials to production', async () => {
+ const previousPackaged = app.isPackaged;
+ (app as { isPackaged: boolean }).isPackaged = true;
+ setCindyPersonalRuntime(true);
+ setCindyVersionEndpointOverride({ manifestText: LOCAL_MANIFEST, local: true });
+ netRequest.mockClear();
+ try {
+ await expect(initClientEndpoints()).resolves.toBe(true);
+ const local = getClientEndpoint('authApiBaseUrl');
+ expect(local.startsWith('http://localhost')).toBe(true);
+ activateClientEndpointRealm('global');
+ expect(getClientEndpoint('authApiBaseUrl')).toBe(local);
+ activateClientEndpointRealm('cn');
+ expect(getClientEndpoint('authApiBaseUrl')).toBe(local);
+ expect(netRequest).not.toHaveBeenCalled();
+ } finally {
+ setCindyPersonalRuntime(false);
+ setCindyVersionEndpointOverride(undefined);
+ (app as { isPackaged: boolean }).isPackaged = previousPackaged;
+ }
+ });
it('登录恢复切换 realm 时仍复用本地文件清单,不加载线上清单', async () => {
const root = fs.mkdtempSync(path.join(os.tmpdir(), 'client-endpoints-local-realm-'));
const manifestPath = path.join(root, 'endpoint.local.json');
diff --git a/apps/desktop/src/main/__tests__/devStartupStatus.test.ts b/apps/desktop/src/main/__tests__/devStartupStatus.test.ts
index f556abb28c..f713e925a4 100644
--- a/apps/desktop/src/main/__tests__/devStartupStatus.test.ts
+++ b/apps/desktop/src/main/__tests__/devStartupStatus.test.ts
@@ -11,6 +11,7 @@ import {
markDesktopDevWindowReady,
recordDesktopDevAuthStartupResult,
recordDesktopDevLocalDbStartupResult,
+ observeDesktopStartupResult,
} from '../devStartupStatus.js';
import { withLocalProfileMigrationStartupBarrier } from '../localProfileDataMigration.js';
@@ -52,7 +53,10 @@ describe('devStartupStatus', () => {
startedAtMs: 100,
});
+ const ready = vi.fn();
+ observeDesktopStartupResult(ready);
markDesktopDevWindowReady();
+ expect(ready).not.toHaveBeenCalled();
expect(JSON.parse(fs.readFileSync(statusPath, 'utf8'))).toMatchObject({
state: 'window-ready',
@@ -63,6 +67,7 @@ describe('devStartupStatus', () => {
))).toMatchObject({ state: 'starting' });
markDesktopDevReady();
+ expect(ready).toHaveBeenCalledExactlyOnceWith(true);
const external = JSON.parse(fs.readFileSync(statusPath, 'utf8'));
const persistent = JSON.parse(fs.readFileSync(
diff --git a/apps/desktop/src/main/__tests__/gitSnapshotHost.test.ts b/apps/desktop/src/main/__tests__/gitSnapshotHost.test.ts
index 71b0caef1b..85487e7739 100644
--- a/apps/desktop/src/main/__tests__/gitSnapshotHost.test.ts
+++ b/apps/desktop/src/main/__tests__/gitSnapshotHost.test.ts
@@ -1,4 +1,6 @@
import { describe, expect, it, vi } from 'vitest';
+import path from 'node:path';
+vi.mock('electron', () => ({ app: { getPath: () => path.resolve('snapshot-profile') } }));
import { createGitSnapshotCoordinator } from '../maker-host/git-snapshot-host';
import type {
@@ -8,10 +10,12 @@ import type {
const logger = { info: vi.fn(), warn: vi.fn(), debug: vi.fn() };
-function makeMaker(overrides: Partial<{
- getSessionMeta: ReturnType<typeof vi.fn>;
- oneShot: ReturnType<typeof vi.fn>;
-}> = {}) {
+function makeMaker(
+ overrides: Partial<{
+ getSessionMeta: ReturnType<typeof vi.fn>;
+ oneShot: ReturnType<typeof vi.fn>;
+ }> = {},
+) {
return {
getSessionMeta: vi.fn().mockResolvedValue({
id: 's1',
@@ -28,26 +32,54 @@ function makeMaker(overrides: Partial<{
}
describe('createGitSnapshotCoordinator', () => {
+ it.each(['source', 'worktrees/run', 'merge-worktrees/12345678-1234-1234-1234-123456789abc'])(
+ 'never creates hidden commits in Cindy Make %s',
+ async (directory) => {
+ const maker = makeMaker({
+ getSessionMeta: vi.fn().mockResolvedValue({
+ agentKind: 'codex',
+ workDir: path.resolve('snapshot-profile/cindy-make', directory),
+ }),
+ });
+ const createShadowSavepoint = vi.fn();
+ const initializeProjectGit = vi.fn();
+ const coordinator = createGitSnapshotCoordinator(maker, {
+ readAutoSnapshotEnabled: () => true,
+ createShadowSavepoint,
+ initializeProjectGit,
+ logger,
+ });
+ await coordinator.onTurnStart('make');
+ await coordinator.onTurnEnd('make');
+ expect(createShadowSavepoint).not.toHaveBeenCalled();
+ expect(initializeProjectGit).not.toHaveBeenCalled();
+ },
+ );
it('creates a local after-edit savepoint with anchor and prompt context', async () => {
const maker = makeMaker();
const getLatestUserMessage = vi.fn().mockResolvedValue({
clientId: 'msg-1',
text: 'please update login',
});
- const createShadowSavepoint = vi.fn().mockImplementation(
- async (_repo: string, input: CreateShadowSavepointInput): Promise<ShadowSavepointResult> => {
- if (typeof input.label === 'function') {
- await input.label({ diffStat: ' src/a.ts | 1 +', diffText: '+x' });
- }
- return {
- commit: 'hash123',
- tree: 'tree123',
- includedFiles: [],
- skippedFiles: [],
- skippedFingerprints: [],
- };
- },
- );
+ const createShadowSavepoint = vi
+ .fn()
+ .mockImplementation(
+ async (
+ _repo: string,
+ input: CreateShadowSavepointInput,
+ ): Promise<ShadowSavepointResult> => {
+ if (typeof input.label === 'function') {
+ await input.label({ diffStat: ' src/a.ts | 1 +', diffText: '+x' });
+ }
+ return {
+ commit: 'hash123',
+ tree: 'tree123',
+ includedFiles: [],
+ skippedFiles: [],
+ skippedFingerprints: [],
+ };
+ },
+ );
const coordinator = createGitSnapshotCoordinator(maker, {
readAutoSnapshotEnabled: () => true,
detectRepoRoot: vi.fn().mockResolvedValue('/workspace/project'),
@@ -74,10 +106,14 @@ describe('createGitSnapshotCoordinator', () => {
});
expect(input.skipIfTreeEquals).toBe('hash123');
expect(getLatestUserMessage).toHaveBeenCalledOnce();
- expect(maker.oneShot).toHaveBeenCalledWith('codex', expect.stringContaining('please update login'), {
- maxTokens: 80,
- timeoutMs: 20_000,
- });
+ expect(maker.oneShot).toHaveBeenCalledWith(
+ 'codex',
+ expect.stringContaining('please update login'),
+ {
+ maxTokens: 80,
+ timeoutMs: 20_000,
+ },
+ );
});
it('skips remote sessions before repo detection', async () => {
diff --git a/apps/desktop/src/main/__tests__/sessionRuntimeControlWiring.test.ts b/apps/desktop/src/main/__tests__/sessionRuntimeControlWiring.test.ts
index 26a8938196..79cdfc62e1 100644
--- a/apps/desktop/src/main/__tests__/sessionRuntimeControlWiring.test.ts
+++ b/apps/desktop/src/main/__tests__/sessionRuntimeControlWiring.test.ts
@@ -30,8 +30,16 @@ function handlerBody(source: string, channel: string, nextChannel: string): stri
describe('session runtime control wiring', () => {
it('replays Windows attention after the main window is shown independently of inventory loading', () => {
- const body = handlerBody(bootstrapSource, "mainWindow.once('ready-to-show'", 'if (!app.isPackaged) markDesktopDevWindowReady();');
- expect(body.indexOf('refreshWindowsAppBadge();')).toBeGreaterThan(body.indexOf('showMainWindowAndRestoreFullscreen('));
+ const body = handlerBody(
+ bootstrapSource,
+ "mainWindow.once('ready-to-show'",
+ 'void runComputerUseSmokeIfRequested();',
+ );
+ const shown = body.indexOf('showMainWindowAndRestoreFullscreen(');
+ const badge = body.indexOf('refreshWindowsAppBadge();');
+ expect(shown).toBeGreaterThan(-1);
+ expect(badge).toBeGreaterThan(shown);
+ expect(body.indexOf('markDesktopDevWindowReady();')).toBeGreaterThan(badge);
});
it('advertises host-side model-window protection to remote controllers', () => {
const capabilities = handlerBody(
diff --git a/apps/desktop/src/main/__tests__/updateService.test.ts b/apps/desktop/src/main/__tests__/updateService.test.ts
index 67f6db556b..bc969ca68c 100644
--- a/apps/desktop/src/main/__tests__/updateService.test.ts
+++ b/apps/desktop/src/main/__tests__/updateService.test.ts
@@ -703,6 +703,30 @@ describe('checkForUpdate 版本无关(占位 0.0.0)打包豁免', () => {
});
});
+describe('personal version app update policy', () => {
+ it('skips app checks, background polling and relaunch even with an ordinary version number', async () => {
+ appGetVersion.mockReturnValue('1.2.3');
+ const service = await freshUpdateService('win32');
+ const identity = await import('../cindy-make/versionRuntimeIdentity');
+ identity.setCindyPersonalRuntime(true);
+ try {
+ service.initUpdateService();
+ expect(await service.checkForUpdate(updateManifest('9.9.9'))).toBe('idle');
+ expect(await ipcHandlers.get('update-check-startup')!()).toMatchObject({ hasUpdate: false, action: 'none' });
+ ipcListeners.get('update-relaunch')!({}, 'dark');
+ expect(fetchManifest).not.toHaveBeenCalled();
+ expect(download).not.toHaveBeenCalled();
+ expect(powerMonitorOn).not.toHaveBeenCalled();
+ expect(spawnProcess).not.toHaveBeenCalled();
+ expect(appQuit).not.toHaveBeenCalled();
+ } finally {
+ service.stopUpdateService();
+ identity.setCindyPersonalRuntime(false);
+ }
+ });
+});
+
+
describe('app update forward-only policy', () => {
it('does not download a manifest version lower than the running app', async () => {
const service = await freshUpdateService('darwin');
diff --git a/apps/desktop/src/main/clientEndpointsService.ts b/apps/desktop/src/main/clientEndpointsService.ts
index e247853860..60a04eeb91 100644
--- a/apps/desktop/src/main/clientEndpointsService.ts
+++ b/apps/desktop/src/main/clientEndpointsService.ts
@@ -85,6 +85,7 @@ import {
import { createLogger, getLogDir } from './logger';
import { ENDPOINT_MANIFEST_BASE_URL, ENDPOINT_MANIFEST_PEER_BASE_URL } from '../shared/endpoints';
import { resolvePreferredSystemLocale } from '../shared/locale';
+import { captureCindyVersionOriginEndpoints, getCindyVersionEndpointOverride } from './cindy-make/versionRuntimeIdentity.js';
const log = createLogger('clientEndpoints');
@@ -1081,7 +1082,10 @@ function cacheResolvedManifest(manifestUrl: string, manifestText: string): void
* 错误框选择退出(app.exit 已调用,调用方必须立即 return,不再继续启动流程)。
*/
export async function initClientEndpoints(): Promise<boolean> {
- const source = resolveEndpointSource({
+ // A verified Make profile carries the original Dev's public service configuration.
+ // Ordinary packaged apps still use CDN; ambient file/env overrides cannot enable this path.
+ const versionSnapshot = getCindyVersionEndpointOverride();
+ const source: EndpointSource = versionSnapshot ? { kind: 'file', filePath: 'Cindy Make' } : resolveEndpointSource({
isPackaged: app.isPackaged,
env: {
XDT_ENDPOINTS_CDN: process.env.XDT_ENDPOINTS_CDN,
@@ -1117,7 +1121,7 @@ export async function initClientEndpoints(): Promise<boolean> {
} = { value: null, fromCache: false };
const endpoints = await resolveClientEndpointsBlocking({
fetchManifest:
- source.kind === 'cdn'
+ versionSnapshot ? () => Promise.resolve({ ok: true as const, text: versionSnapshot.manifestText }) : source.kind === 'cdn'
? fetchManifestViaCdn
: () => Promise.resolve(readManifestFromFile(source.filePath)),
promptRetry: (context) => promptRetryDialog(context, sourceLabel, dialogLocale),
@@ -1158,7 +1162,11 @@ export async function initClientEndpoints(): Promise<boolean> {
// 另一 realm 会重新拉线上清单,把本地服务悄悄替换掉。仅对明确的 local + file
// 启动把同一份清单固定到两个 realm;remote/CDN 与普通文件覆写仍保持区域隔离。
const pinLocalEndpointsToAllRealms =
- !app.isPackaged && process.env.XDT_DESKTOP_DEV_MODE === 'local' && source.kind === 'file';
+ versionSnapshot?.local === true || (!app.isPackaged && process.env.XDT_DESKTOP_DEV_MODE === 'local' && source.kind === 'file');
+ captureCindyVersionOriginEndpoints(source.kind === 'file' ? {
+ manifestText: JSON.stringify({ schemaVersion: 1, region: resolvedRegion ?? BUILD_AUTH_REGION, ...endpoints }),
+ local: pinLocalEndpointsToAllRealms,
+ } : undefined);
if (pinLocalEndpointsToAllRealms) {
realmEndpointCache.set('cn', endpoints);
realmEndpointCache.set('global', endpoints);
diff --git a/apps/desktop/src/main/updateService.ts b/apps/desktop/src/main/updateService.ts
index 8f593d8953..b28c5c5dac 100644
--- a/apps/desktop/src/main/updateService.ts
+++ b/apps/desktop/src/main/updateService.ts
@@ -25,6 +25,7 @@ import { createHash } from 'node:crypto';
import path from 'node:path';
import fs from 'node:fs';
import { spawn } from 'node:child_process';
+import { isCindyPersonalRuntime } from './cindy-make/versionRuntimeIdentity.js';
import os from 'node:os';
import {
@@ -634,6 +635,7 @@ export function clearReloginFlag(): void {
* in the union for backward compatibility with prior callers.)
*/
function checkExistingPatch(): { action: 'relaunch' | 'check' | 'none'; version?: string } {
+ if (isCindyPersonalRuntime()) return { action: 'none' };
const updatesDir = getUpdatesDir();
const infoPath = path.join(updatesDir, PATCH_INFO_FILE);
@@ -1086,6 +1088,7 @@ export function isVersionlessAppVersion(version: string): boolean {
}
async function doCheckForUpdate(manifestOverride?: Manifest | null): Promise<CheckForUpdateResult> {
+ if (isCindyPersonalRuntime()) return 'idle';
log.info('checkForUpdate() called, currentStatus=%s', currentStatus);
// 先跟共享设置对一次有效渠道:共库另一实例改过开关时,本进程内存代际还停在旧值。
if (syncObservedUpdateChannel()) {
@@ -1977,6 +1980,7 @@ function executeUpdateLinux(debPath: string, installation: LinuxUserInstallation
}
async function executeRelaunch(theme: 'light' | 'dark', checkForBinaryUpdates = false): Promise<void> {
+ if (isCindyPersonalRuntime()) return;
try {
await executeRelaunchUnguarded(theme, checkForBinaryUpdates);
} catch (err) {
@@ -2137,7 +2141,7 @@ async function executeRelaunchUnguarded(theme: 'light' | 'dark', checkForBinaryU
export function initUpdateService(): void {
// Observe the successful old-updater receipt before existing cleanup removes
// it. Async and metadata-only; no effect on download/apply/rollback decisions.
- if (process.platform === 'win32' && app.isPackaged && !isDev()) {
+ if (process.platform === 'win32' && app.isPackaged && !isDev() && !isCindyPersonalRuntime()) {
void syncWindowsVersionAfterUpdate({
platform: process.platform,
packaged: true,
@@ -2152,7 +2156,7 @@ export function initUpdateService(): void {
// Best-effort cleanup of >7-day-old `cindy-update*`/`xdt-update*` leftovers in %TEMP%.
// Counterpart to the Rust updater's own sweep — covers the case where the
// user stays on the latest version and never triggers another updater run.
- sweepStaleUpdateTempDirs();
+ if (!isCindyPersonalRuntime()) sweepStaleUpdateTempDirs();
ipcMain.on('update-relaunch', (event, theme: 'light' | 'dark') => {
// Linux 分支会退出应用并触发 pkexec 系统授权,属于特权操作;
@@ -2346,7 +2350,7 @@ export function initUpdateService(): void {
log.info('update-check-startup called');
startupUpdateCheckInProgress = true;
try {
- if (isDev()) {
+ if (isDev() || isCindyPersonalRuntime()) {
return { hasUpdate: false, action: 'none' as const };
}
@@ -2535,7 +2539,7 @@ export function initUpdateService(): void {
}
});
- if (isDev()) {
+ if (isDev() || isCindyPersonalRuntime()) {
log.info('Dev mode — skipping background polling');
return;
}
diff --git a/apps/desktop/src/renderer/__tests__/automationGeneratedSessions.test.ts b/apps/desktop/src/renderer/__tests__/automationGeneratedSessions.test.ts
index 456a1b40d9..6f95053446 100644
--- a/apps/desktop/src/renderer/__tests__/automationGeneratedSessions.test.ts
+++ b/apps/desktop/src/renderer/__tests__/automationGeneratedSessions.test.ts
@@ -122,6 +122,7 @@ describe('automation-generated sessions', () => {
'plugin',
// /cindy-make 制作个人版创建的代码任务:按源码 workingDir 归入项目分组。
'cindy-make',
+ 'cindy-make-merge',
]);
expect(DESKTOP_VISIBLE_SESSION_SOURCES).toContain('feishu');
expect(DESKTOP_VISIBLE_SESSION_SOURCES).toContain('telegram');
diff --git a/apps/desktop/src/renderer/__tests__/buildRenderItemsKeyStability.test.ts b/apps/desktop/src/renderer/__tests__/buildRenderItemsKeyStability.test.ts
index 620b6228f0..ac475b37ba 100644
--- a/apps/desktop/src/renderer/__tests__/buildRenderItemsKeyStability.test.ts
+++ b/apps/desktop/src/renderer/__tests__/buildRenderItemsKeyStability.test.ts
@@ -85,6 +85,47 @@ it('keeps modal-only Cindy Make cards out of the message timeline', () => {
);
});
+it('shows completion history unless the local composer owns the testing handoff', () => {
+ const completion: ChatMessage = {
+ ...mkAssistant('completion'), systemCardType: 'cindy-make-complete',
+ systemCardData: { reportedAt: 123, commit: 'a'.repeat(40) },
+ };
+ expect(buildRenderItems([completion]).items.some((item) => renderItemContainsClientId(item, 'completion'))).toBe(true);
+ expect(buildRenderItems([completion], undefined, undefined, { cindyMakeCompletionInComposer: true }).items).toEqual([]);
+ expect(completion.systemCardData?.commit).toBe('a'.repeat(40));
+});
+
+it.each(['running', 'failed', 'cancelled', 'completed'])(
+ 'moves its own %s preparation out of the timeline without deleting history or hiding other cards',
+ (status) => {
+ const preparation: ChatMessage = {
+ ...mkAssistant('make-card'),
+ systemCardType: 'cindy-make',
+ systemCardData: {
+ request: 'fix scrolling',
+ report: { runId: 'run-1', status, task: { sessionId: 'make-session' } },
+ },
+ };
+ const otherCard: ChatMessage = {
+ ...preparation,
+ clientId: 'other-card',
+ systemCardData: { report: { runId: 'run-2', task: { sessionId: 'other-session' } } },
+ };
+ const messages = [preparation, otherCard, mkUser('u1', 'original request')];
+ const built = buildRenderItems(messages, undefined, undefined, {
+ cindyMakeSessionId: 'make-session',
+ }).items;
+ expect(built.some((item) => renderItemContainsClientId(item, 'make-card'))).toBe(false);
+ expect(built.some((item) => renderItemContainsClientId(item, 'other-card'))).toBe(true);
+ expect(built.some((item) => renderItemContainsClientId(item, 'u1'))).toBe(true);
+ expect(messages).toHaveLength(3);
+ expect(messages[0]).toBe(preparation);
+ // A source task or standalone history view still offers its existing card.
+ const original = buildRenderItems(messages).items;
+ expect(original.some((item) => renderItemContainsClientId(item, 'make-card'))).toBe(true);
+ },
+);
+
describe('Bot 流式正文呈现', () => {
it('preserves consecutive Claude final text blocks only after the turn seal', () => {
let state = { ...EMPTY_SESSION_STATE, isStreaming: true, messages: [mkUser('u1')] };
diff --git a/apps/desktop/src/renderer/__tests__/dialogueSidebarSection.test.ts b/apps/desktop/src/renderer/__tests__/dialogueSidebarSection.test.ts
index ff7fd0b625..a28cd2c671 100644
--- a/apps/desktop/src/renderer/__tests__/dialogueSidebarSection.test.ts
+++ b/apps/desktop/src/renderer/__tests__/dialogueSidebarSection.test.ts
@@ -210,7 +210,7 @@ describe('Mixed main list (sidebar-redesign D 期)', () => {
// 不按设备分组的两条渲染路径不传目标 → 上层沿用作用域推断。
expect(projectsSectionSource).toContain('renderNonProjectEntry(entry, DIALOGUE_GROUP_ALL_KEY)');
expect(projectsSectionSource).toContain(
- 'onCreateDialogue={() => onCreateDialogue(dialogueDeviceTarget)}',
+ 'onCreateDialogue={isMake ? undefined : () => onCreateDialogue(dialogueDeviceTarget)}',
);
// 目标设备离线 → 禁用新建并复用远程写保护文案(被控端才是真正的创建方)。
expect(projectsSectionSource).toContain("t('ccAgent.remoteSession.actionsUnavailable')");
diff --git a/apps/desktop/src/renderer/__tests__/mainListModel.test.ts b/apps/desktop/src/renderer/__tests__/mainListModel.test.ts
index 2e8e3292e5..0d94f81751 100644
--- a/apps/desktop/src/renderer/__tests__/mainListModel.test.ts
+++ b/apps/desktop/src/renderer/__tests__/mainListModel.test.ts
@@ -17,6 +17,7 @@ import {
sessionPriorityRecencyMs,
sessionPriorityRank,
sortSessionsForMainList,
+ partitionCindyMakeSessions,
splitEntriesByDevice,
type MainListEntry,
} from '../features/cc-agent/lib/mainListModel';
@@ -82,6 +83,111 @@ const NO_PRIORITY = {
attentionSessionIds: new Set<string>(),
};
+describe('Cindy Make sidebar group', () => {
+ it('groups a distinct upstream-merge source alongside personal-feature tasks', () => {
+ const merge = session({ source: 'cindy-make-merge', workingDir: '/managed/merge-worktrees/abcd', workspaceKind: 'project', updatedAt: '2026-09-17T00:00:00Z' });
+ const normal = session({ source: 'cindy-make', workingDir: '/managed/worktrees/efgh', workspaceKind: 'project', updatedAt: '2026-09-17T00:00:00Z' });
+ const result = partitionCindyMakeSessions({ projects: [], dialogues: [], unclassified: [merge, normal] });
+ expect(result.cindyMake).toEqual([merge, normal]);
+ expect(result.unclassified).toEqual([]);
+ expect(merge.source).toBe('cindy-make-merge');
+ });
+ const make = (id: string, updatedAt: string, extra: Partial<Session> = {}) =>
+ session({
+ id,
+ updatedAt,
+ title: id,
+ source: 'cindy-make',
+ workspaceKind: 'project',
+ workingDir: '/managed/worktrees/' + id,
+ ...extra,
+ });
+
+ it.each(['project', 'flat'] as const)(
+ 'collects different worktrees and newly preparing tasks under one root in %s mode',
+ (groupBy) => {
+ const first = make('first', '2026-09-17T01:00:00Z');
+ const second = make('second', '2026-09-17T02:00:00Z');
+ const waiting = make('waiting', '2026-09-17T03:00:00Z', { workingDir: null });
+ const ordinary = session({ updatedAt: '2026-09-17T00:00:00Z', title: 'Cindy Make' });
+ const entries = buildMainListEntries({
+ projects: [project('first', [first]), project('second', [second])],
+ dialogues: [ordinary],
+ unclassified: [waiting],
+ groupBy,
+ groupDialogue: false,
+ sortBy: 'recency',
+ manualProjectOrder: [],
+ });
+ expect(labels(entries)).toEqual(['cindy-make-group', 's:Cindy Make']);
+ expect(getMainListEntrySessions(entries[0]).map((value) => value.id)).toEqual([
+ 'waiting',
+ 'second',
+ 'first',
+ ]);
+ expect(first.workingDir).toBe('/managed/worktrees/first');
+ expect(second.workingDir).toBe('/managed/worktrees/second');
+ },
+ );
+
+ it('preserves ordinary tasks that share a directory and leaves empty saved projects intact', () => {
+ const personal = make('make', '2026-09-17T02:00:00Z');
+ const ordinary = session({ updatedAt: '2026-09-17T01:00:00Z', title: 'ordinary' });
+ const mixed = project('shared', [personal, ordinary]);
+ const empty = project('saved', []);
+ const result = partitionCindyMakeSessions({
+ projects: [mixed, empty],
+ dialogues: [],
+ unclassified: [],
+ });
+ expect(result.projects.map((value) => value.projectKey)).toEqual([
+ 'local:shared',
+ 'local:saved',
+ ]);
+ expect(result.projects[0].sessions).toEqual([ordinary]);
+ expect(result.projects[1]).toBe(empty);
+ expect(result.cindyMake).toEqual([personal]);
+ expect(mixed.sessions).toEqual([personal, ordinary]);
+ });
+
+ it('orders the root and its tasks by the existing attention priorities', () => {
+ const waiting = make('waiting', '2026-09-17T01:00:00Z');
+ const newer = make('newer', '2026-09-17T02:00:00Z');
+ const newest = session({ updatedAt: '2026-09-17T03:00:00Z' });
+ const entries = buildMainListEntries({
+ projects: [project('waiting', [waiting]), project('newer', [newer])],
+ dialogues: [newest],
+ groupBy: 'project',
+ groupDialogue: false,
+ sortBy: 'priority',
+ manualProjectOrder: [],
+ priorityContext: {
+ ...NO_PRIORITY,
+ attentionSessionIds: new Set([waiting.id]),
+ waitingSessionIds: new Set([waiting.id]),
+ },
+ });
+ expect(entries[0].kind).toBe('cindy-make-group');
+ expect(getMainListEntrySessions(entries[0])).toEqual([waiting, newer]);
+ });
+
+ it('separates local and remote Cindy Make roots by device', () => {
+ const local = make('local', '2026-09-17T01:00:00Z');
+ const remote = make('remote', '2026-09-17T02:00:00Z', { deviceLinkDeviceId: 'remote-device' });
+ const sections = splitEntriesByDevice(
+ [{ kind: 'cindy-make-group', sessions: [remote, local] }],
+ ['remote-device'],
+ );
+ expect(sections.map((section) => section.deviceId)).toEqual([null, 'remote-device']);
+ expect(sections.map((section) => section.entries[0].kind)).toEqual([
+ 'cindy-make-group',
+ 'cindy-make-group',
+ ]);
+ expect(getMainListEntrySessions(sections[0].entries[0])).toEqual([local]);
+ expect(getMainListEntrySessions(sections[1].entries[0])).toEqual([remote]);
+ });
+});
+
describe('buildMainListEntries — 混排(recency)', () => {
it('interleaves project rows and stray dialogues by latest activity', () => {
const projNew = project('alpha', [session({ updatedAt: '2026-08-12T10:00:00Z' })]);
diff --git a/apps/desktop/src/renderer/__tests__/projectsSidebarSection.test.ts b/apps/desktop/src/renderer/__tests__/projectsSidebarSection.test.ts
index d8789040d7..67d00f03d4 100644
--- a/apps/desktop/src/renderer/__tests__/projectsSidebarSection.test.ts
+++ b/apps/desktop/src/renderer/__tests__/projectsSidebarSection.test.ts
@@ -47,9 +47,12 @@ describe('Projects sidebar section', () => {
'disabled: projectNodesToggleDisabled && !hasDeviceLayer && !hasGroupLayer',
);
expect(projectsSectionSource).toContain(
- "const hasVisibleProjectGroups = mixedEntries.some((entry) => entry.kind === 'project')",
+ 'const allVisibleProjectGroupsCollapsed = mixedEntries.every(',
);
- expect(projectsSectionSource).toContain('(!hasVisibleProjectGroups || isAllCollapsed)');
+ expect(projectsSectionSource).toContain(
+ "entry.kind !== 'project' || collapsed.has(entry.project.projectKey)",
+ );
+ expect(projectsSectionSource).toContain('allSessionGroupsCollapsed');
// 平铺时来源标签要覆盖从项目摊出来的会话,不能只喂 dialogues。
expect(projectsSectionSource).toContain('flattenedSessionsForSourceLabels');
expect(projectsSectionSource).toContain(
@@ -137,7 +140,18 @@ describe('Projects sidebar section', () => {
expect(projectsSectionSource).toContain(
'return splitEntriesByDevice(mixedEntries, [...(remoteDeviceIndex?.keys() ?? [])], {',
);
- expect(projectsSectionSource).toContain('unclassified: deviceGroupingActive && !unclassifiedHidden ? unclassified : undefined');
+ const start = projectsSectionSource.indexOf('const mixedUnclassified = useMemo(');
+ const input = projectsSectionSource.slice(start, projectsSectionSource.indexOf('const mixedEntries', start));
+ expect(start).toBeGreaterThan(-1);
+ expect(input).toContain('unclassifiedHidden');
+ expect(input).toContain('? []');
+ expect(input).toContain('deviceGroupingActive');
+ expect(input).toContain('? unclassified');
+ expect(input).toContain(
+ 'unclassified.filter((session) => isCindyMakeFamilySource(session.source))',
+ );
+ expect(input).toContain('[unclassified, unclassifiedHidden, deviceGroupingActive]');
+ expect(projectsSectionSource).toContain('unclassified: mixedUnclassified,');
// 每段独立折叠视图 + 段内作用域的「显示全部」(复核 P2:共用一个标志会让
// 点任一段全段展开)。
expect(projectsSectionSource).toMatch(
diff --git a/apps/desktop/src/renderer/__tests__/sessionSourceLabel.test.ts b/apps/desktop/src/renderer/__tests__/sessionSourceLabel.test.ts
index 3a7635603d..e3e0acf17a 100644
--- a/apps/desktop/src/renderer/__tests__/sessionSourceLabel.test.ts
+++ b/apps/desktop/src/renderer/__tests__/sessionSourceLabel.test.ts
@@ -72,6 +72,16 @@ function projectNodeFor(session: Session, displayName: string): ProjectNode {
/* ============================== tests ============================== */
describe('buildSessionSourceLabelMap', () => {
+ it('labels pinned Cindy Make tasks with their feature name rather than a worktree id', () => {
+ const personal = {
+ ...s({ id: 'personal', workingDir: '/managed/worktrees/run-id' }),
+ source: 'cindy-make' as const,
+ };
+ const map = buildSessionSourceLabelMap([personal], [], 'Dialogue', 'Cindy Make');
+ expect(map.get(personal.id)).toBe('Cindy Make');
+ });
+
+
it('does not label standalone dialogue sessions', () => {
const d = s({ id: 'd1', workspaceKind: 'dialogue' });
const map = buildSessionSourceLabelMap([d], []);
diff --git a/apps/desktop/src/renderer/components/chat/SystemCard.tsx b/apps/desktop/src/renderer/components/chat/SystemCard.tsx
index 573beeb79a..abd90a830a 100644
--- a/apps/desktop/src/renderer/components/chat/SystemCard.tsx
+++ b/apps/desktop/src/renderer/components/chat/SystemCard.tsx
@@ -44,6 +44,7 @@ import {
} from './activityRowChrome';
import { MarkdownRenderer } from './MarkdownRenderer';
import { CindyMakeDoctorCard } from './CindyMakeDoctorCard';
+import { CindyMakeCompleteCard } from '@/components/cindy-make/CindyMakeCompleteCard';
interface SystemCardProps {
cardType:
@@ -1263,64 +1264,6 @@ function ContextRebuildCard({ data }: { data?: Record<string, unknown> }) {
);
}
-/**
- * 个人版制作任务的完成卡片:Agent 调用 cindy_make.report_complete、本轮回复结束后由
- * Main 落库。整块步骤卡片,与 /cindy-make 弹窗的三步卡同形态;第二阶段的核对、测试与
- * 打包会作为后续步骤长在这张卡上,当前只有「修改源码」一步。内容全部是代码核实的事实
- * (改动文件数、基准 commit、完成时间),不含模型自述。
- */
-function CindyMakeCompleteCard({ data }: { data?: Record<string, unknown> }) {
- const { t, i18n } = useTranslation();
- const changedFiles = typeof data?.changedFiles === 'number' ? data.changedFiles : undefined;
- const commit =
- typeof data?.commit === 'string' && data.commit ? data.commit.slice(0, 12) : undefined;
- const reportedAt = typeof data?.reportedAt === 'number' ? data.reportedAt : undefined;
- const time =
- reportedAt !== undefined
- ? new Intl.DateTimeFormat(i18n?.resolvedLanguage ?? i18n?.language, {
- dateStyle: 'medium',
- timeStyle: 'short',
- }).format(reportedAt)
- : undefined;
- const branch = typeof data?.branch === 'string' && data.branch ? data.branch : undefined;
- const meta = [
- changedFiles !== undefined
- ? t('cindyMake.complete.changedFiles', { count: changedFiles })
- : null,
- branch ? t('cindyMake.complete.branch', { branch }) : null,
- commit ? t('cindyMake.complete.commit', { commit }) : null,
- time ?? null,
- ].filter((part): part is string => typeof part === 'string' && part.length > 0);
-
- return (
- <section
- className="w-full rounded-xl border border-[var(--border-default)] bg-[var(--surface-elevated)] text-14 text-[var(--text-primary)]"
- aria-label={t('cindyMake.complete.title')}
- >
- <div className="flex items-start gap-3 px-4 py-4">
- <div className="flex h-9 w-9 shrink-0 items-center justify-center rounded-full bg-[var(--surface-chip)]">
- <Check size={18} className="text-[var(--status-success)]" aria-hidden />
- </div>
- <div className="min-w-0 flex-1">
- <p className="text-16 font-medium">{t('cindyMake.complete.title')}</p>
- <p className="mt-0.5 text-13 text-[var(--text-secondary)]">
- {t('cindyMake.complete.description')}
- </p>
- </div>
- </div>
- <div className="border-t border-[var(--border-default)] px-4 py-3">
- <p className="flex items-center gap-2 font-medium">
- <Check size={14} className="shrink-0 text-[var(--status-success)]" aria-hidden />
- <span>{t('cindyMake.complete.stepCode')}</span>
- </p>
- {meta.length > 0 && (
- <p className="mt-1 pl-6 text-12 text-[var(--text-secondary)]">{meta.join(' · ')}</p>
- )}
- </div>
- </section>
- );
-}
-
const REVIEW_FAILURE_I18N_KEY: Record<ReviewFailureCode, string> = {
'no-visible-result': 'chat.systemCard.review.noResult',
'reviewer-closed': 'chat.systemCard.review.failure.reviewerClosed',
diff --git a/apps/desktop/src/renderer/features/cc-agent/sidebar/sections/ProjectsSection.tsx b/apps/desktop/src/renderer/features/cc-agent/sidebar/sections/ProjectsSection.tsx
index 2f2ffa31ed..f5fefce58d 100644
--- a/apps/desktop/src/renderer/features/cc-agent/sidebar/sections/ProjectsSection.tsx
+++ b/apps/desktop/src/renderer/features/cc-agent/sidebar/sections/ProjectsSection.tsx
@@ -70,7 +70,6 @@ import {
DIALOGUE_GROUP_ALL_KEY,
} from '../../hooks/helpers/sidebarFilterCore';
import {
- buildMainListEntries,
CINDY_MAKE_GROUP_KEY,
getMainListEntrySessions,
holdViewedPriorityRank,
@@ -79,6 +78,7 @@ import {
type MainListEntry,
type ViewedPriorityHoldState,
} from '../../lib/mainListModel';
+import { useMainListEntries } from '../../hooks/useMainListEntries';
import { sidebarPriorityContext } from '../../lib/sidebarPriorityContext';
import { useViewedPriorityHold } from '../../hooks/useViewedPriorityHold';
import { projectKeyComparisonKey, type BotGroupNode } from '../../lib/projectGrouping';
@@ -561,42 +561,29 @@ export function ProjectsSection({
// 混排模型(D 期):项目行 / 散排对话 / 对话组统一为顶层条目并按同一口径排序。
// 这有意推翻旧「Dialogue 固定段在 Projects 之后」的裁决(mainListModel.ts 文件头)。
// 设备分组开启时,未分类草稿并进混排再按设备切段;单段路径仍走顶部独立段。
- const mixedEntries = useMemo(
+ const mixedUnclassified = useMemo(
() =>
- buildMainListEntries({
- projects,
- dialogues,
- bots,
- unclassified: unclassifiedHidden
- ? []
- : deviceGroupingActive
- ? unclassified
- : unclassified.filter((session) => isCindyMakeFamilySource(session.source)),
- groupBy: filter.groupBy,
- groupDialogue: filter.groupDialogue,
- sortBy: filter.sortBy,
- projectOrder: displayedProjectOrder.projectOrder,
- manualProjectOrder: displayedProjectOrder.manualProjectOrder,
- priorityContext,
- notifications,
- scheduleSessionIndex,
- }),
- [
- projects,
- dialogues,
- bots,
- unclassified,
- unclassifiedHidden,
- deviceGroupingActive,
- filter.groupBy,
- filter.groupDialogue,
- filter.sortBy,
- displayedProjectOrder,
- priorityContext,
- notifications,
- scheduleSessionIndex,
- ],
+ unclassifiedHidden
+ ? []
+ : deviceGroupingActive
+ ? unclassified
+ : unclassified.filter((session) => isCindyMakeFamilySource(session.source)),
+ [unclassified, unclassifiedHidden, deviceGroupingActive],
);
+ const mixedEntries = useMainListEntries({
+ projects,
+ dialogues,
+ bots,
+ unclassified: mixedUnclassified,
+ groupBy: filter.groupBy,
+ groupDialogue: filter.groupDialogue,
+ sortBy: filter.sortBy,
+ projectOrder: displayedProjectOrder.projectOrder,
+ manualProjectOrder: displayedProjectOrder.manualProjectOrder,
+ priorityContext,
+ notifications,
+ scheduleSessionIndex,
+ });
// 顶层条目折叠:最多显示 N 条,超出收起 + 「显示全部 N 项」。与会话同一套
// 规则(getSessionListCollapseView):始终保留"有需关注会话"的条目、以及包含当前会话的
diff --git a/docs/design-rules/DESIGN.md b/docs/design-rules/DESIGN.md
index f8e9feb8a0..a0ad047871 100644
--- a/docs/design-rules/DESIGN.md
+++ b/docs/design-rules/DESIGN.md
@@ -91,6 +91,7 @@ The grayscale rule is near-absolute. The following are the **only** sanctioned n
> **Additional narrowly-scoped exceptions** (documented in their respective component specs, do NOT generalize as system semantic colors):
>
+> - **Cindy Make source comparison** — the owner-requested one-line comparison (2026-09-17) uses `--text-secondary` for the current hash, `--text-tertiary` for the arrow icon, and `--status-success` for the verified latest version and its parenthesized commit difference. This green identifies the official target version, not the state of the local checkout. Unavailable lookups stay neutral. Both modes use the existing semantic tokens; no other version surface inherits this treatment.
> - **CINDY checked Switch** — `--switch-track-on` uses blue `#417CDD` in CINDY Light and Dark (owner decision 2026-09-15, §15.17). This is an enabled-state signal, independently adjustable from focus, caret and Auto Approval despite sharing their current hue. Other themes retain their own checked-track colors.
> - **Windows taskbar attention badge** — the native OS overlay uses a fixed red background (`#D91F37`) and white digits with no outline (`#FFFFFF`) in both Light and Dark taskbars. This is the app-wide count of active tasks needing attention, not an error-only status. The image-specific semantic pair lives in `apps/desktop/src/main/windowsBadgeIcon.ts`; it is not an in-app theme token. Keep a 16-logical-pixel transparent canvas and center the circle and digits at 80% of their original size (user refinement, 2026-09-16). Render using the highest connected display scale and pass that physical-size image directly to the Windows Shell through the native taskbar bridge (Electron 41 otherwise forces overlays to 16 physical pixels). Redraw after display/DPI changes and taskbar recreation; keep the multi-resolution Electron overlay as a failure fallback. Use a circle for one digit, a rounded square for multiple digits, and `99+` above 99. The accessibility description keeps the exact total. Only the OS image may use its fitted 8–12px system-font digits; web typography and status-dot color rules are unchanged.
> - **Toast Info / Success / Warning / Error** — `#417CDD` / `#2AAE5B` / `#F3A115` / `#D91F37`(finalized 2026-07-17; Toast exemption lifted) — used ONLY on the 16×16 lucide icon inside Toast pill notifications. The pill body (background, text, border, close icon) remains strictly grayscale. Info blue #417CDD equals the focus-ring / Auto Approval value (originally #3B82F6, added 2026-07-14, now finalized); success/warning/error equal the global status colors (done green / status error / warning foreground).
diff --git a/docs/design-rules/design-inventory.md b/docs/design-rules/design-inventory.md
index a4d8aa1bdc..f777b917d8 100644
--- a/docs/design-rules/design-inventory.md
+++ b/docs/design-rules/design-inventory.md
@@ -18,12 +18,12 @@
| `desktop.auth.add-account` | desktop | 添加账号 | hash `/add-account`(ProtectedRoute → AddAccountLoginPage) | AddAccountLoginPage | apps/desktop/src/renderer/components/login/AddAccountLoginPage.tsx, apps/desktop/src/renderer/components/login/LoginBrandStage.tsx, apps/desktop/src/renderer/components/login/LoginCaptchaOverlay.tsx, apps/desktop/src/renderer/components/login/LoginControls.tsx, apps/desktop/src/renderer/components/login/LoginPage.tsx, apps/desktop/src/renderer/components/login/loginDesignTokens.ts | 59 | 0 | 20 |
| `desktop.auth.legacy-migration` | desktop | 首登数据迁移弹窗 | App 顶层挂载 LegacyMigrationDialog(仅主窗;main 检测到旧版 userData 经 `legacy-migration:state` 驱动) | LegacyMigrationDialog | apps/desktop/src/renderer/components/auth/LegacyMigrationDialog.tsx | 8 | 0 | 2 |
| `desktop.auth.login` | desktop | 登录页 | hash `/login`(GuestRoute → LoginPage) | LoginBrandStage, LoginCaptchaOverlay, LoginControls, LoginPage | apps/desktop/src/renderer/components/login/LoginBrandStage.tsx, apps/desktop/src/renderer/components/login/LoginCaptchaOverlay.tsx, apps/desktop/src/renderer/components/login/LoginControls.tsx, apps/desktop/src/renderer/components/login/LoginPage.tsx, apps/desktop/src/renderer/components/login/loginDesignTokens.ts | 59 | 0 | 20 |
-| `desktop.bots` | desktop | 伙伴(列表 / 对话 / 设置 / 历史 / 伙伴私聊) | hash `/bots`、`/bots/list`、`/bots/:botId`、`/bots/roster` 及伙伴当前/历史任务、伙伴私聊路由(BotsFeatureLayout) | BotBasicProfileFields, BotCollaborationCard, BotDirectMessageView, BotHistorySessionView, BotLifecycleSettings, BotModelChainEditor, BotRosterView, BotSessionView, BotSettingsDrawer, BotsHomeView, BotsListView, RemoteBotSessionView | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/bots/BotAuthorizationCard.tsx, apps/desktop/src/renderer/features/bots/BotAvatar.tsx, apps/desktop/src/renderer/features/bots/BotBasicProfileFields.tsx, apps/desktop/src/renderer/features/bots/BotCapabilitySettings.tsx, apps/desktop/src/renderer/features/bots/BotCollaborationCard.tsx, apps/desktop/src/renderer/features/bots/BotConnectionStatus.tsx, apps/desktop/src/renderer/features/bots/BotCreateMenu.tsx, apps/desktop/src/renderer/features/bots/BotDeleteDialog.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageCard.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageView.tsx, apps/desktop/src/renderer/features/bots/BotHistorySessionView.tsx, apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx, apps/desktop/src/renderer/features/bots/BotLifecycleSettings.tsx, apps/desktop/src/renderer/features/bots/BotModelChainEditor.tsx, apps/desktop/src/renderer/features/bots/BotPortraitPicker.tsx, apps/desktop/src/renderer/features/bots/BotRosterView.tsx, apps/desktop/src/renderer/features/bots/BotRoutines.tsx, apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsx, apps/desktop/src/renderer/features/bots/BotSessionView.tsx, apps/desktop/src/renderer/features/bots/BotSettingsBlock.tsx, apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotWorkingStatus.tsx, apps/desktop/src/renderer/features/bots/BotsFeatureLayout.tsx, apps/desktop/src/renderer/features/bots/BotsGlobalSettingsSection.tsx, apps/desktop/src/renderer/features/bots/BotsHomeView.tsx, apps/desktop/src/renderer/features/bots/BotsListView.tsx, apps/desktop/src/renderer/features/bots/BotsSidebar.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSessionView.tsx, apps/desktop/src/renderer/features/bots/botAvatarIdentity.ts, apps/desktop/src/renderer/features/bots/botCapabilityDefaults.ts, apps/desktop/src/renderer/features/bots/botChatPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationTimeline.ts, apps/desktop/src/renderer/features/bots/botDelegationLive.ts, apps/desktop/src/renderer/features/bots/botGeneratedArtifacts.ts, apps/desktop/src/renderer/features/bots/botListDisplay.ts, apps/desktop/src/renderer/features/bots/botNavigation.ts, apps/desktop/src/renderer/features/bots/botPronounContext.tsx, apps/desktop/src/renderer/features/bots/botReadState.ts, apps/desktop/src/renderer/features/bots/botRosterDisplay.ts, apps/desktop/src/renderer/features/bots/botSessionOwners.ts, apps/desktop/src/renderer/features/bots/botSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/botStore.ts, apps/desktop/src/renderer/features/bots/botWelcomeContext.ts, apps/desktop/src/renderer/features/bots/remoteBotRoster.ts, apps/desktop/src/renderer/features/bots/useBotGeneratedFileDeliveries.ts, apps/desktop/src/renderer/features/bots/useBotIslandVisibleSession.ts, apps/desktop/src/renderer/features/bots/useBotSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/useRemoteBots.ts, apps/desktop/src/renderer/features/bots/useWorkingStatusCopy.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 293 | 43 | 489 |
+| `desktop.bots` | desktop | 伙伴(列表 / 对话 / 设置 / 历史 / 伙伴私聊) | hash `/bots`、`/bots/list`、`/bots/:botId`、`/bots/roster` 及伙伴当前/历史任务、伙伴私聊路由(BotsFeatureLayout) | BotBasicProfileFields, BotCollaborationCard, BotDirectMessageView, BotHistorySessionView, BotLifecycleSettings, BotModelChainEditor, BotRosterView, BotSessionView, BotSettingsDrawer, BotsHomeView, BotsListView, RemoteBotSessionView | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/bots/BotAuthorizationCard.tsx, apps/desktop/src/renderer/features/bots/BotAvatar.tsx, apps/desktop/src/renderer/features/bots/BotBasicProfileFields.tsx, apps/desktop/src/renderer/features/bots/BotCapabilitySettings.tsx, apps/desktop/src/renderer/features/bots/BotCollaborationCard.tsx, apps/desktop/src/renderer/features/bots/BotConnectionStatus.tsx, apps/desktop/src/renderer/features/bots/BotCreateMenu.tsx, apps/desktop/src/renderer/features/bots/BotDeleteDialog.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageCard.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageView.tsx, apps/desktop/src/renderer/features/bots/BotHistorySessionView.tsx, apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx, apps/desktop/src/renderer/features/bots/BotLifecycleSettings.tsx, apps/desktop/src/renderer/features/bots/BotModelChainEditor.tsx, apps/desktop/src/renderer/features/bots/BotPortraitPicker.tsx, apps/desktop/src/renderer/features/bots/BotRosterView.tsx, apps/desktop/src/renderer/features/bots/BotRoutines.tsx, apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsx, apps/desktop/src/renderer/features/bots/BotSessionView.tsx, apps/desktop/src/renderer/features/bots/BotSettingsBlock.tsx, apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotWorkingStatus.tsx, apps/desktop/src/renderer/features/bots/BotsFeatureLayout.tsx, apps/desktop/src/renderer/features/bots/BotsGlobalSettingsSection.tsx, apps/desktop/src/renderer/features/bots/BotsHomeView.tsx, apps/desktop/src/renderer/features/bots/BotsListView.tsx, apps/desktop/src/renderer/features/bots/BotsSidebar.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSessionView.tsx, apps/desktop/src/renderer/features/bots/botAvatarIdentity.ts, apps/desktop/src/renderer/features/bots/botCapabilityDefaults.ts, apps/desktop/src/renderer/features/bots/botChatPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationTimeline.ts, apps/desktop/src/renderer/features/bots/botDelegationLive.ts, apps/desktop/src/renderer/features/bots/botGeneratedArtifacts.ts, apps/desktop/src/renderer/features/bots/botListDisplay.ts, apps/desktop/src/renderer/features/bots/botNavigation.ts, apps/desktop/src/renderer/features/bots/botPronounContext.tsx, apps/desktop/src/renderer/features/bots/botReadState.ts, apps/desktop/src/renderer/features/bots/botRosterDisplay.ts, apps/desktop/src/renderer/features/bots/botSessionOwners.ts, apps/desktop/src/renderer/features/bots/botSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/botStore.ts, apps/desktop/src/renderer/features/bots/botWelcomeContext.ts, apps/desktop/src/renderer/features/bots/remoteBotRoster.ts, apps/desktop/src/renderer/features/bots/useBotGeneratedFileDeliveries.ts, apps/desktop/src/renderer/features/bots/useBotIslandVisibleSession.ts, apps/desktop/src/renderer/features/bots/useBotSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/useRemoteBots.ts, apps/desktop/src/renderer/features/bots/useWorkingStatusCopy.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 293 | 43 | 487 |
| `desktop.chat.files` | desktop | 工作目录文件浏览 | hash `/cc-agent/files/:sessionId`(WorkdirBrowseRoute) | FileBodyView, FileTreeView, WorkdirBrowseRoute | apps/desktop/src/renderer/features/cc-agent/workdir-browse/DocSearchBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/DrawioPreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileBodyView.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileFilterInput.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTabsBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTreeView.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FilterResultList.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/ImagePreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/OpenInSystemActions.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/PdfPreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/SessionTabsBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/UnrenderablePlaceholder.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/WorkdirBrowseRoute.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/WorkdirBrowseSidebar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useChatRailCollapsed.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useChatRailResize.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useConfirmSwitchAwayIfDirty.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useDelayedFlag.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useFileContent.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useFileTree.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useOpenTabs.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useProjectFileList.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useRevealFileInTree.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/activeFileBodyHandle.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/docModeSwitchProjects.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/drawioExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/expandedStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileContentCache.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileIcon.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileMeta.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileScrollStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileSelectionParams.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/filterFiles.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/imageExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/markdownAutosave.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/openTabsStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/pdfExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/selectedFileStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchInput.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchPanel.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchResults.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/hooks/useProjectSearch.ts | 22 | 7 | 64 |
| `desktop.chat.new-draft` | desktop | 新建任务草稿页 | hash `/cc-agent/new`(NewMakerDraftRoute) | NewMakerDraftRoute | apps/desktop/src/renderer/features/cc-agent/NewMakerDraftRoute.tsx | 15 | 0 | 2 |
-| `desktop.chat.orca-workflow` | desktop | Orca 协同工作台 | hash `/cc-agent/orca/:sessionId`(OrcaWorkflowRoute) | CCAgentSessionView, OrcaSplitView, OrcaWorkerPanel, OrcaWorkflowRoute | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaSplitView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkerPanel.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkflowRoute.tsx | 273 | 43 | 395 |
+| `desktop.chat.orca-workflow` | desktop | Orca 协同工作台 | hash `/cc-agent/orca/:sessionId`(OrcaWorkflowRoute) | CCAgentSessionView, OrcaSplitView, OrcaWorkerPanel, OrcaWorkflowRoute | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaSplitView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkerPanel.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkflowRoute.tsx | 273 | 43 | 393 |
| `desktop.chat.scheduled` | desktop | 调度任务列表 | hash `/cc-agent/scheduled`(SchedulerPage) | SchedulerPage | apps/desktop/src/renderer/features/scheduler/SchedulerPage.tsx, apps/desktop/src/renderer/features/scheduler/components/AgentMark.tsx, apps/desktop/src/renderer/features/scheduler/components/BoundSessionCard.tsx, apps/desktop/src/renderer/features/scheduler/components/ProjectAutomationNotifyBridge.tsx, apps/desktop/src/renderer/features/scheduler/components/RunHistoryCard.tsx, apps/desktop/src/renderer/features/scheduler/components/RunHistoryPane.tsx, apps/desktop/src/renderer/features/scheduler/components/ScheduleChips.tsx, apps/desktop/src/renderer/features/scheduler/components/ScheduleFormDialog.tsx, apps/desktop/src/renderer/features/scheduler/components/ScheduleSessionIndexOwner.tsx, apps/desktop/src/renderer/features/scheduler/components/ScheduleStatusChip.tsx, apps/desktop/src/renderer/features/scheduler/components/ScriptCapabilityMultiSelect.tsx, apps/desktop/src/renderer/features/scheduler/components/TaskListCell.tsx, apps/desktop/src/renderer/features/scheduler/components/TaskListFilterPopover.tsx, apps/desktop/src/renderer/features/scheduler/components/TaskListPane.tsx, apps/desktop/src/renderer/features/scheduler/components/TemplateCard.tsx, apps/desktop/src/renderer/features/scheduler/components/TemplateGallery.tsx, apps/desktop/src/renderer/features/scheduler/components/TemplateParamForm.tsx, apps/desktop/src/renderer/features/scheduler/hooks/useDeleteScheduleWithSessions.tsx, apps/desktop/src/renderer/features/scheduler/hooks/useReadFailedScheduleRuns.ts, apps/desktop/src/renderer/features/scheduler/hooks/useRunNowBusyGuard.ts, apps/desktop/src/renderer/features/scheduler/hooks/useRuns.ts, apps/desktop/src/renderer/features/scheduler/hooks/useScheduleForm.ts, apps/desktop/src/renderer/features/scheduler/hooks/useScheduleUnreadRunCounts.ts, apps/desktop/src/renderer/features/scheduler/hooks/useSchedules.ts, apps/desktop/src/renderer/features/scheduler/hooks/useSessionReferences.ts, apps/desktop/src/renderer/features/scheduler/hooks/useTemplates.ts, apps/desktop/src/renderer/features/scheduler/index.ts, apps/desktop/src/renderer/features/scheduler/lib/cronCodexPreset.ts, apps/desktop/src/renderer/features/scheduler/lib/cronToHuman.ts, apps/desktop/src/renderer/features/scheduler/lib/failedScheduleDismissal.ts, apps/desktop/src/renderer/features/scheduler/lib/formatters.ts, apps/desktop/src/renderer/features/scheduler/lib/pluginScheduleCreateIntent.ts, apps/desktop/src/renderer/features/scheduler/lib/projectAutomationConfig.ts, apps/desktop/src/renderer/features/scheduler/lib/projectScheduleSidebarIndex.ts, apps/desktop/src/renderer/features/scheduler/lib/runHistoryGrouping.ts, apps/desktop/src/renderer/features/scheduler/lib/runUnread.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleFormLogic.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleRunReadSync.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleSessionBinding.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleSidebarIndexRuns.ts, apps/desktop/src/renderer/features/scheduler/lib/schedulesStore.ts, apps/desktop/src/renderer/features/scheduler/lib/statusFilter.ts, apps/desktop/src/renderer/features/scheduler/lib/statusFilterStorage.ts, apps/desktop/src/renderer/features/scheduler/lib/templateLocalization.ts, apps/desktop/src/renderer/features/scheduler/lib/usageLimitScheduleCreateIntent.ts | 44 | 0 | 118 |
-| `desktop.chat.session` | desktop | 会话工作台 | hash `/cc-agent/:sessionId`;副窗经 `/cc-agent/boot` 解析后落到同一会话视图 | AssistantMessage, CCAgentFeatureLayout, CCAgentSessionView, ChatInput, PermissionPrompt | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 273 | 43 | 394 |
+| `desktop.chat.session` | desktop | 会话工作台 | hash `/cc-agent/:sessionId`;副窗经 `/cc-agent/boot` 解析后落到同一会话视图 | AssistantMessage, CCAgentFeatureLayout, CCAgentSessionView, ChatInput, PermissionPrompt | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 273 | 43 | 392 |
| `desktop.dev.maker-experimental` | desktop | Maker 实验诊断页 | hash `/maker-experimental`(MakerExperimentalView;EXPERIMENTAL_FEATURES 现为空,仍是生产路由) | MakerExperimentalView | apps/desktop/src/renderer/features/maker-experimental/MakerExperimentalView.tsx | 10 | 0 | 11 |
| `desktop.issues.guide` | desktop | Issue 引导页 | hash `/issues`(IssueTrackerFeatureLayout,已迁 GitHub 后的引导页) | IssueTrackerFeatureLayout | apps/desktop/src/renderer/features/issue-tracker/IssueTrackerFeatureLayout.tsx, apps/desktop/src/renderer/features/issue-tracker/MyIssueList.tsx, apps/desktop/src/renderer/features/issue-tracker/hooks/useMyIssues.ts, apps/desktop/src/renderer/features/issue-tracker/lib/myIssuesNotices.ts, apps/desktop/src/renderer/features/issue-tracker/lib/startIssueChat.ts | 0 | 0 | 8 |
| `desktop.native.app-menu` | desktop | 应用菜单 | Menu.setApplicationMenu(用户可见出口,不展开业务逻辑) | applicationMenuLabels | apps/desktop/src/main/applicationMenuLabels.ts | 0 | 0 | 0 |
@@ -38,7 +38,7 @@
| `desktop.overlay.toast` | desktop | Toast | App 常驻 ToastContainer(用户可见出口,不展开业务逻辑) | Toast, ToastContainer | apps/desktop/src/renderer/components/ui/toast/Toast.tsx, apps/desktop/src/renderer/components/ui/toast/ToastContainer.tsx, apps/desktop/src/renderer/components/ui/toast/index.ts | 8 | 4 | 4 |
| `desktop.plugins.app-main` | desktop | 插件主视图 | hash `/apps/:ghostId`(GhostMainViewFeatureLayout) | GhostMainViewFeatureLayout, GhostMainViewHost | apps/desktop/src/renderer/features/plugin/GhostMainViewFeatureLayout.tsx, apps/desktop/src/renderer/features/plugin/GhostMainViewHost.tsx | 0 | 0 | 0 |
| `desktop.plugins.installed` | desktop | 已装插件 | hash `/plugins`(GhostPluginPage) | AddMarketplaceDialog, GhostPluginDetailView, GhostPluginPage, MarketPluginDetailView, MyPublishesSection, PluginManagementLayout, PluginScopePicker, UpdateAllDialog | apps/desktop/src/renderer/features/plugin/AddMarketplaceDialog.tsx, apps/desktop/src/renderer/features/plugin/GhostPluginDetailView.tsx, apps/desktop/src/renderer/features/plugin/GhostPluginPage.tsx, apps/desktop/src/renderer/features/plugin/MarketPluginDetailView.tsx, apps/desktop/src/renderer/features/plugin/MyPublishesSection.tsx, apps/desktop/src/renderer/features/plugin/PluginManagementLayout.tsx, apps/desktop/src/renderer/features/plugin/PluginScopePicker.tsx, apps/desktop/src/renderer/features/plugin/UpdateAllDialog.tsx, apps/desktop/src/renderer/features/plugin/plugin-motion.css | 49 | 0 | 82 |
-| `desktop.settings` | desktop | 设置 | hash `/settings`(SettingsView;tab 含 general / personalization / providers / billing / usage / voice-input / im-bot / shortcuts / agent-island / import / remote-control / ghosts / builtin-tools / computer-use / help / about) | SettingsView | apps/desktop/src/renderer/components/settings/AboutSection.tsx, apps/desktop/src/renderer/components/settings/AccountDeletionSection.tsx, apps/desktop/src/renderer/components/settings/AddProviderWizard.tsx, apps/desktop/src/renderer/components/settings/AgentIslandSection.tsx, apps/desktop/src/renderer/components/settings/AgentResourceSection.tsx, apps/desktop/src/renderer/components/settings/AppearanceSection.tsx, apps/desktop/src/renderer/components/settings/AuxiliaryModelSection.tsx, apps/desktop/src/renderer/components/settings/BetaChannelCell.tsx, apps/desktop/src/renderer/components/settings/BrowserBackendSubsection.tsx, apps/desktop/src/renderer/components/settings/BrowserRealProfileSubsection.tsx, apps/desktop/src/renderer/components/settings/BuiltinToolsSection.tsx, apps/desktop/src/renderer/components/settings/ChatEmbeddingCell.tsx, apps/desktop/src/renderer/components/settings/ChipMetricsSection.tsx, apps/desktop/src/renderer/components/settings/CindyMakeSection.tsx, apps/desktop/src/renderer/components/settings/CollaborationSection.tsx, apps/desktop/src/renderer/components/settings/CompactionSection.tsx, apps/desktop/src/renderer/components/settings/ComposerSendShortcutSection.tsx, apps/desktop/src/renderer/components/settings/ComputerPermissionGuideWindow.tsx, apps/desktop/src/renderer/components/settings/ComputerPermissionRow.tsx, apps/desktop/src/renderer/components/settings/ComputerUseSection.tsx, apps/desktop/src/renderer/components/settings/CustomProviderRuntimeFillOverlay.tsx, apps/desktop/src/renderer/components/settings/DefaultOverrideControls.tsx, apps/desktop/src/renderer/components/settings/DingTalkBotSection.tsx, apps/desktop/src/renderer/components/settings/DiscordBotSection.tsx, apps/desktop/src/renderer/components/settings/DownloadMeter.tsx, apps/desktop/src/renderer/components/settings/ExperimentalSection.tsx, apps/desktop/src/renderer/components/settings/FeishuBotNotificationSection.tsx, apps/desktop/src/renderer/components/settings/FeishuBotSection.tsx, apps/desktop/src/renderer/components/settings/FontFamilyPicker.tsx, apps/desktop/src/renderer/components/settings/GenericGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/GitSafetySection.tsx, apps/desktop/src/renderer/components/settings/HelpAssistantPanel.tsx, apps/desktop/src/renderer/components/settings/HelpSection.tsx, apps/desktop/src/renderer/components/settings/HelpThreadView.tsx, apps/desktop/src/renderer/components/settings/HookConnectionsSection.tsx, apps/desktop/src/renderer/components/settings/HookWorkspacePrefsEditor.tsx, apps/desktop/src/renderer/components/settings/ImBotSection.tsx, apps/desktop/src/renderer/components/settings/ImChannelSettingsCard.tsx, apps/desktop/src/renderer/components/settings/ImDefaultSettingsSection.tsx, apps/desktop/src/renderer/components/settings/ImLifecycleAnnouncementSection.tsx, apps/desktop/src/renderer/components/settings/InputDeviceConnectionStatus.tsx, apps/desktop/src/renderer/components/settings/JoyConGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/KeyboardShortcutsSection.tsx, apps/desktop/src/renderer/components/settings/LanguageSection.tsx, apps/desktop/src/renderer/components/settings/LayoutResetControl.tsx, apps/desktop/src/renderer/components/settings/LinkOpenSection.tsx, apps/desktop/src/renderer/components/settings/LocalOllamaInstall.tsx, apps/desktop/src/renderer/components/settings/LocalPackagingTag.tsx, apps/desktop/src/renderer/components/settings/LogoutSection.tsx, apps/desktop/src/renderer/components/settings/LspBetaCell.tsx, apps/desktop/src/renderer/components/settings/McpServerDialog.tsx, apps/desktop/src/renderer/components/settings/McpServersSection.tsx, apps/desktop/src/renderer/components/settings/MemorySection.tsx, apps/desktop/src/renderer/components/settings/MessageNavRailCell.tsx, apps/desktop/src/renderer/components/settings/ModelAdvancedDrawer.tsx, apps/desktop/src/renderer/components/settings/ModelPriceOverrideDialog.tsx, apps/desktop/src/renderer/components/settings/MyDevicesPanel.tsx, apps/desktop/src/renderer/components/settings/NotificationSection.tsx, apps/desktop/src/renderer/components/settings/OAuthDeviceCodeCard.tsx, apps/desktop/src/renderer/components/settings/OllamaProviderDetail.tsx, apps/desktop/src/renderer/components/settings/PiPackagesSection.tsx, apps/desktop/src/renderer/components/settings/PlayStationGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/ProfileEditDialog.tsx, apps/desktop/src/renderer/components/settings/ProviderConnectionDialog.tsx, apps/desktop/src/renderer/components/settings/ProviderImportDialog.tsx, apps/desktop/src/renderer/components/settings/ProvidersSection.tsx, apps/desktop/src/renderer/components/settings/RemoteControlSection.tsx, apps/desktop/src/renderer/components/settings/RemoteDesktopPermissions.tsx, apps/desktop/src/renderer/components/settings/RemoteDesktopSetting.tsx, apps/desktop/src/renderer/components/settings/RemoteHostDetail.tsx, apps/desktop/src/renderer/components/settings/RemoteSection.tsx, apps/desktop/src/renderer/components/settings/SessionImportSection.tsx, apps/desktop/src/renderer/components/settings/SessionRuntimeFallbackCell.tsx, apps/desktop/src/renderer/components/settings/SessionShareImportWizard.tsx, apps/desktop/src/renderer/components/settings/SettingsCatalogPanel.tsx, apps/desktop/src/renderer/components/settings/SettingsSegmentedControl.tsx, apps/desktop/src/renderer/components/settings/SettingsSidebarNav.tsx, apps/desktop/src/renderer/components/settings/SettingsTextInput.tsx, apps/desktop/src/renderer/components/settings/SettingsView.tsx, apps/desktop/src/renderer/components/settings/SilentEncryptedRetryCell.tsx, apps/desktop/src/renderer/components/settings/SshKeySetupDialog.tsx, apps/desktop/src/renderer/components/settings/StorageManagementCard.tsx, apps/desktop/src/renderer/components/settings/StreamFadeSection.tsx, apps/desktop/src/renderer/components/settings/SubagentModelSection.tsx, apps/desktop/src/renderer/components/settings/SwitchProGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/TelegramBehaviorSettings.tsx, apps/desktop/src/renderer/components/settings/TelegramBotSection.tsx, apps/desktop/src/renderer/components/settings/TelegramRemoteDevices.tsx, apps/desktop/src/renderer/components/settings/TerminalShellSection.tsx, apps/desktop/src/renderer/components/settings/TipsSection.tsx, apps/desktop/src/renderer/components/settings/UnifiedModelList.tsx, apps/desktop/src/renderer/components/settings/UserProfileCard.tsx, apps/desktop/src/renderer/components/settings/UserPromptSection.tsx, apps/desktop/src/renderer/components/settings/VisionBridgeSection.tsx, apps/desktop/src/renderer/components/settings/VoiceInputSection.tsx, apps/desktop/src/renderer/components/settings/WechatBotSection.tsx, apps/desktop/src/renderer/components/settings/WecomBotSection.tsx, apps/desktop/src/renderer/components/settings/WindowBehaviorSection.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexKeyboardLayout.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexKeycapGlyphs.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexSettings.tsx, apps/desktop/src/renderer/components/settings/WorktreeRecycleCard.tsx, apps/desktop/src/renderer/components/settings/XUsageGuide.tsx, apps/desktop/src/renderer/components/settings/XboxGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/XboxGamepadSettings.tsx, apps/desktop/src/renderer/components/settings/androidStatusPresentation.ts, apps/desktop/src/renderer/components/settings/billingVisibility.ts, apps/desktop/src/renderer/components/settings/browserOpenForLoginError.ts, apps/desktop/src/renderer/components/settings/cindyMakeVisibility.ts, apps/desktop/src/renderer/components/settings/computerPermissionFlow.ts, apps/desktop/src/renderer/components/settings/contacts/ContactDetailPane.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsImportDialog.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsListPane.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsManagerDialog.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsSection.tsx, apps/desktop/src/renderer/components/settings/contacts/startContactsAiSession.ts, apps/desktop/src/renderer/components/settings/dualSenseSilhouette.ts, apps/desktop/src/renderer/components/settings/feishuBotPresentation.ts, apps/desktop/src/renderer/components/settings/fontFamilyValue.ts, apps/desktop/src/renderer/components/settings/gamepadLayoutPrimitives.tsx, apps/desktop/src/renderer/components/settings/gamepadSilhouetteGeom.ts, apps/desktop/src/renderer/components/settings/hookWorkspacePrefsLogic.ts, apps/desktop/src/renderer/components/settings/imBotVisibility.ts, apps/desktop/src/renderer/components/settings/imDefaultSettingsLogic.ts, apps/desktop/src/renderer/components/settings/joyConSilhouette.ts, apps/desktop/src/renderer/components/settings/modelManagementPresentation.ts, apps/desktop/src/renderer/components/settings/modelManagementState.ts, apps/desktop/src/renderer/components/settings/myDevicesModel.ts, apps/desktop/src/renderer/components/settings/providerAssetModule.ts, apps/desktop/src/renderer/components/settings/realProfilePermissionGuide.ts, apps/desktop/src/renderer/components/settings/switchProSilhouette.ts, apps/desktop/src/renderer/components/settings/ultimateC1Silhouette.ts, apps/desktop/src/renderer/components/settings/usage/UsageBreakdownTables.tsx, apps/desktop/src/renderer/components/settings/usage/UsageHistorySection.tsx, apps/desktop/src/renderer/components/settings/usage/UsageStatRow.tsx, apps/desktop/src/renderer/components/settings/usage/UsageTaskTable.tsx, apps/desktop/src/renderer/components/settings/usage/UsageTokenBars.tsx, apps/desktop/src/renderer/components/settings/usage/formatUsagePercent.ts, apps/desktop/src/renderer/components/settings/usage/usageCharts.css, apps/desktop/src/renderer/components/settings/usage/usageHistoryColors.ts, apps/desktop/src/renderer/components/settings/usage/usageHistoryStats.ts, apps/desktop/src/renderer/components/settings/usageVisibility.ts, apps/desktop/src/renderer/components/settings/useProviderSubscriptionCard.ts, apps/desktop/src/renderer/components/settings/wizardRecommend.ts, apps/desktop/src/renderer/components/settings/workLouderCodexCommandCopy.ts, apps/desktop/src/renderer/components/settings/xboxSeriesSilhouette.ts, apps/desktop/src/renderer/styles/sortable.css | 154 | 109 | 735 |
+| `desktop.settings` | desktop | 设置 | hash `/settings`(SettingsView;tab 含 general / personalization / providers / billing / usage / voice-input / im-bot / shortcuts / agent-island / import / remote-control / ghosts / builtin-tools / computer-use / help / about) | SettingsView | apps/desktop/src/renderer/components/settings/AboutSection.tsx, apps/desktop/src/renderer/components/settings/AccountDeletionSection.tsx, apps/desktop/src/renderer/components/settings/AddProviderWizard.tsx, apps/desktop/src/renderer/components/settings/AgentIslandSection.tsx, apps/desktop/src/renderer/components/settings/AgentResourceSection.tsx, apps/desktop/src/renderer/components/settings/AppearanceSection.tsx, apps/desktop/src/renderer/components/settings/AuxiliaryModelSection.tsx, apps/desktop/src/renderer/components/settings/BetaChannelCell.tsx, apps/desktop/src/renderer/components/settings/BrowserBackendSubsection.tsx, apps/desktop/src/renderer/components/settings/BrowserRealProfileSubsection.tsx, apps/desktop/src/renderer/components/settings/BuiltinToolsSection.tsx, apps/desktop/src/renderer/components/settings/ChatEmbeddingCell.tsx, apps/desktop/src/renderer/components/settings/ChipMetricsSection.tsx, apps/desktop/src/renderer/components/settings/CindyMakeSection.tsx, apps/desktop/src/renderer/components/settings/CollaborationSection.tsx, apps/desktop/src/renderer/components/settings/CompactionSection.tsx, apps/desktop/src/renderer/components/settings/ComposerSendShortcutSection.tsx, apps/desktop/src/renderer/components/settings/ComputerPermissionGuideWindow.tsx, apps/desktop/src/renderer/components/settings/ComputerPermissionRow.tsx, apps/desktop/src/renderer/components/settings/ComputerUseSection.tsx, apps/desktop/src/renderer/components/settings/CustomProviderRuntimeFillOverlay.tsx, apps/desktop/src/renderer/components/settings/DefaultOverrideControls.tsx, apps/desktop/src/renderer/components/settings/DingTalkBotSection.tsx, apps/desktop/src/renderer/components/settings/DiscordBotSection.tsx, apps/desktop/src/renderer/components/settings/DownloadMeter.tsx, apps/desktop/src/renderer/components/settings/ExperimentalSection.tsx, apps/desktop/src/renderer/components/settings/FeishuBotNotificationSection.tsx, apps/desktop/src/renderer/components/settings/FeishuBotSection.tsx, apps/desktop/src/renderer/components/settings/FontFamilyPicker.tsx, apps/desktop/src/renderer/components/settings/GenericGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/GitSafetySection.tsx, apps/desktop/src/renderer/components/settings/HelpAssistantPanel.tsx, apps/desktop/src/renderer/components/settings/HelpSection.tsx, apps/desktop/src/renderer/components/settings/HelpThreadView.tsx, apps/desktop/src/renderer/components/settings/HookConnectionsSection.tsx, apps/desktop/src/renderer/components/settings/HookWorkspacePrefsEditor.tsx, apps/desktop/src/renderer/components/settings/ImBotSection.tsx, apps/desktop/src/renderer/components/settings/ImChannelSettingsCard.tsx, apps/desktop/src/renderer/components/settings/ImDefaultSettingsSection.tsx, apps/desktop/src/renderer/components/settings/ImLifecycleAnnouncementSection.tsx, apps/desktop/src/renderer/components/settings/InputDeviceConnectionStatus.tsx, apps/desktop/src/renderer/components/settings/JoyConGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/KeyboardShortcutsSection.tsx, apps/desktop/src/renderer/components/settings/LanguageSection.tsx, apps/desktop/src/renderer/components/settings/LayoutResetControl.tsx, apps/desktop/src/renderer/components/settings/LinkOpenSection.tsx, apps/desktop/src/renderer/components/settings/LocalOllamaInstall.tsx, apps/desktop/src/renderer/components/settings/LocalPackagingTag.tsx, apps/desktop/src/renderer/components/settings/LogoutSection.tsx, apps/desktop/src/renderer/components/settings/LspBetaCell.tsx, apps/desktop/src/renderer/components/settings/McpServerDialog.tsx, apps/desktop/src/renderer/components/settings/McpServersSection.tsx, apps/desktop/src/renderer/components/settings/MemorySection.tsx, apps/desktop/src/renderer/components/settings/MessageNavRailCell.tsx, apps/desktop/src/renderer/components/settings/ModelAdvancedDrawer.tsx, apps/desktop/src/renderer/components/settings/ModelPriceOverrideDialog.tsx, apps/desktop/src/renderer/components/settings/MyDevicesPanel.tsx, apps/desktop/src/renderer/components/settings/NotificationSection.tsx, apps/desktop/src/renderer/components/settings/OAuthDeviceCodeCard.tsx, apps/desktop/src/renderer/components/settings/OllamaProviderDetail.tsx, apps/desktop/src/renderer/components/settings/PiPackagesSection.tsx, apps/desktop/src/renderer/components/settings/PlayStationGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/ProfileEditDialog.tsx, apps/desktop/src/renderer/components/settings/ProviderConnectionDialog.tsx, apps/desktop/src/renderer/components/settings/ProviderImportDialog.tsx, apps/desktop/src/renderer/components/settings/ProvidersSection.tsx, apps/desktop/src/renderer/components/settings/RemoteControlSection.tsx, apps/desktop/src/renderer/components/settings/RemoteDesktopPermissions.tsx, apps/desktop/src/renderer/components/settings/RemoteDesktopSetting.tsx, apps/desktop/src/renderer/components/settings/RemoteHostDetail.tsx, apps/desktop/src/renderer/components/settings/RemoteSection.tsx, apps/desktop/src/renderer/components/settings/SessionImportSection.tsx, apps/desktop/src/renderer/components/settings/SessionRuntimeFallbackCell.tsx, apps/desktop/src/renderer/components/settings/SessionShareImportWizard.tsx, apps/desktop/src/renderer/components/settings/SettingsCatalogPanel.tsx, apps/desktop/src/renderer/components/settings/SettingsSegmentedControl.tsx, apps/desktop/src/renderer/components/settings/SettingsSidebarNav.tsx, apps/desktop/src/renderer/components/settings/SettingsTextInput.tsx, apps/desktop/src/renderer/components/settings/SettingsView.tsx, apps/desktop/src/renderer/components/settings/SilentEncryptedRetryCell.tsx, apps/desktop/src/renderer/components/settings/SshKeySetupDialog.tsx, apps/desktop/src/renderer/components/settings/StorageManagementCard.tsx, apps/desktop/src/renderer/components/settings/StreamFadeSection.tsx, apps/desktop/src/renderer/components/settings/SubagentModelSection.tsx, apps/desktop/src/renderer/components/settings/SwitchProGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/TelegramBehaviorSettings.tsx, apps/desktop/src/renderer/components/settings/TelegramBotSection.tsx, apps/desktop/src/renderer/components/settings/TelegramRemoteDevices.tsx, apps/desktop/src/renderer/components/settings/TerminalShellSection.tsx, apps/desktop/src/renderer/components/settings/TipsSection.tsx, apps/desktop/src/renderer/components/settings/UnifiedModelList.tsx, apps/desktop/src/renderer/components/settings/UserProfileCard.tsx, apps/desktop/src/renderer/components/settings/UserPromptSection.tsx, apps/desktop/src/renderer/components/settings/VisionBridgeSection.tsx, apps/desktop/src/renderer/components/settings/VoiceInputSection.tsx, apps/desktop/src/renderer/components/settings/WechatBotSection.tsx, apps/desktop/src/renderer/components/settings/WecomBotSection.tsx, apps/desktop/src/renderer/components/settings/WindowBehaviorSection.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexKeyboardLayout.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexKeycapGlyphs.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexSettings.tsx, apps/desktop/src/renderer/components/settings/WorktreeRecycleCard.tsx, apps/desktop/src/renderer/components/settings/XUsageGuide.tsx, apps/desktop/src/renderer/components/settings/XboxGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/XboxGamepadSettings.tsx, apps/desktop/src/renderer/components/settings/androidStatusPresentation.ts, apps/desktop/src/renderer/components/settings/billingVisibility.ts, apps/desktop/src/renderer/components/settings/browserOpenForLoginError.ts, apps/desktop/src/renderer/components/settings/cindyMakeVisibility.ts, apps/desktop/src/renderer/components/settings/computerPermissionFlow.ts, apps/desktop/src/renderer/components/settings/contacts/ContactDetailPane.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsImportDialog.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsListPane.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsManagerDialog.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsSection.tsx, apps/desktop/src/renderer/components/settings/contacts/startContactsAiSession.ts, apps/desktop/src/renderer/components/settings/dualSenseSilhouette.ts, apps/desktop/src/renderer/components/settings/feishuBotPresentation.ts, apps/desktop/src/renderer/components/settings/fontFamilyValue.ts, apps/desktop/src/renderer/components/settings/gamepadLayoutPrimitives.tsx, apps/desktop/src/renderer/components/settings/gamepadSilhouetteGeom.ts, apps/desktop/src/renderer/components/settings/hookWorkspacePrefsLogic.ts, apps/desktop/src/renderer/components/settings/imBotVisibility.ts, apps/desktop/src/renderer/components/settings/imDefaultSettingsLogic.ts, apps/desktop/src/renderer/components/settings/joyConSilhouette.ts, apps/desktop/src/renderer/components/settings/modelManagementPresentation.ts, apps/desktop/src/renderer/components/settings/modelManagementState.ts, apps/desktop/src/renderer/components/settings/myDevicesModel.ts, apps/desktop/src/renderer/components/settings/providerAssetModule.ts, apps/desktop/src/renderer/components/settings/realProfilePermissionGuide.ts, apps/desktop/src/renderer/components/settings/switchProSilhouette.ts, apps/desktop/src/renderer/components/settings/ultimateC1Silhouette.ts, apps/desktop/src/renderer/components/settings/usage/UsageBreakdownTables.tsx, apps/desktop/src/renderer/components/settings/usage/UsageHistorySection.tsx, apps/desktop/src/renderer/components/settings/usage/UsageStatRow.tsx, apps/desktop/src/renderer/components/settings/usage/UsageTaskTable.tsx, apps/desktop/src/renderer/components/settings/usage/UsageTokenBars.tsx, apps/desktop/src/renderer/components/settings/usage/formatUsagePercent.ts, apps/desktop/src/renderer/components/settings/usage/usageCharts.css, apps/desktop/src/renderer/components/settings/usage/usageHistoryColors.ts, apps/desktop/src/renderer/components/settings/usage/usageHistoryStats.ts, apps/desktop/src/renderer/components/settings/usageVisibility.ts, apps/desktop/src/renderer/components/settings/useProviderSubscriptionCard.ts, apps/desktop/src/renderer/components/settings/wizardRecommend.ts, apps/desktop/src/renderer/components/settings/workLouderCodexCommandCopy.ts, apps/desktop/src/renderer/components/settings/xboxSeriesSilhouette.ts, apps/desktop/src/renderer/styles/sortable.css | 154 | 109 | 738 |
| `desktop.shell.main-layout` | desktop | 主窗口壳(标题栏 / 左右栏 / 内容区) | main BrowserWindow → renderer/index.tsx → main-entry.tsx → App → MainLayout (`#/` 受保护壳) | ChromeActions, DeviceSectionHeader, FeishuConflictDialogHost, GhostMediaLightboxHost, MainLayout, ProjectsSection, RightSidebar, RightSidebarShell, SessionShareImportWizard, Sidebar, UpdateNoticeDialog, WindowControls | apps/desktop/src/renderer/cindy-brain/GhostMediaLightboxHost.tsx, apps/desktop/src/renderer/components/UpdateNoticeDialog.tsx, apps/desktop/src/renderer/components/feishuBot/FeishuConflictDialog.tsx, apps/desktop/src/renderer/components/feishuBot/FeishuConflictDialogHost.tsx, apps/desktop/src/renderer/components/layout/AppBadgeAttentionSync.tsx, apps/desktop/src/renderer/components/layout/BrowserWebviewPool.tsx, apps/desktop/src/renderer/components/layout/ChromeActions.tsx, apps/desktop/src/renderer/components/layout/ContentHeader.tsx, apps/desktop/src/renderer/components/layout/CredentialStoreBanner.tsx, apps/desktop/src/renderer/components/layout/FadeSwitcher.tsx, apps/desktop/src/renderer/components/layout/GhostPanelWindowLayout.tsx, apps/desktop/src/renderer/components/layout/GlobalDropImportListener.tsx, apps/desktop/src/renderer/components/layout/MainEntryRedirect.tsx, apps/desktop/src/renderer/components/layout/MainLayout.tsx, apps/desktop/src/renderer/components/layout/RightSidebar.tsx, apps/desktop/src/renderer/components/layout/RightSidebarDetach.tsx, apps/desktop/src/renderer/components/layout/RightSidebarMaximize.tsx, apps/desktop/src/renderer/components/layout/RightSidebarToggle.tsx, apps/desktop/src/renderer/components/layout/SidebarWindowLayout.tsx, apps/desktop/src/renderer/components/layout/chromeActionsGeometry.ts, apps/desktop/src/renderer/components/layout/chromeActionsLayout.ts, apps/desktop/src/renderer/components/layout/railChromeActions.ts, apps/desktop/src/renderer/components/layout/windowDrag.tsx, apps/desktop/src/renderer/components/settings/SessionShareImportWizard.tsx, apps/desktop/src/renderer/components/sidebar/AccountSwitcherDialog.tsx, apps/desktop/src/renderer/components/sidebar/AttentionDot.tsx, apps/desktop/src/renderer/components/sidebar/DatabaseSizeWarningBanner.tsx, apps/desktop/src/renderer/components/sidebar/GhostMainViewNavEntries.tsx, apps/desktop/src/renderer/components/sidebar/MobileDownloadDialog.tsx, apps/desktop/src/renderer/components/sidebar/Sidebar.tsx, apps/desktop/src/renderer/components/sidebar/SidebarIconButton.tsx, apps/desktop/src/renderer/components/sidebar/SidebarTopNav.tsx, apps/desktop/src/renderer/components/sidebar/SortableList.tsx, apps/desktop/src/renderer/components/sidebar/UpdateBanner.tsx, apps/desktop/src/renderer/components/sidebar/UserInfoSection.tsx, apps/desktop/src/renderer/components/sidebar/VendorIcon.tsx, apps/desktop/src/renderer/components/sidebar/VendorReadinessBadge.tsx, apps/desktop/src/renderer/components/sidebar/WorktreeBadge.tsx, apps/desktop/src/renderer/components/title-bar/ChromeIconButton.tsx, apps/desktop/src/renderer/components/title-bar/MenuButton.tsx, apps/desktop/src/renderer/components/title-bar/WindowControls.tsx, apps/desktop/src/renderer/features/cc-agent/sidebar/DeviceSectionHeader.tsx, apps/desktop/src/renderer/features/cc-agent/sidebar/sections/ProjectsSection.tsx, apps/desktop/src/renderer/features/right-sidebar/AddTabDropdown.tsx, apps/desktop/src/renderer/features/right-sidebar/EmptyState.tsx, apps/desktop/src/renderer/features/right-sidebar/RightSidebarShell.tsx, apps/desktop/src/renderer/features/right-sidebar/TabBar.tsx, apps/desktop/src/renderer/features/right-sidebar/TabBodyErrorBoundary.tsx, apps/desktop/src/renderer/features/right-sidebar/hooks/useBrowserWebview.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useNativePopupSurface.ts, apps/desktop/src/renderer/features/right-sidebar/iosSimulatorPluginAvailability.ts, apps/desktop/src/renderer/features/right-sidebar/lib/browserPartition.ts, apps/desktop/src/renderer/features/right-sidebar/lib/browserWebviewPool.ts, apps/desktop/src/renderer/features/right-sidebar/lib/detachedSidebarRouting.ts, apps/desktop/src/renderer/features/right-sidebar/lib/executeSidebarCommand.ts, apps/desktop/src/renderer/features/right-sidebar/lib/iosSimulatorFocusBridge.ts, apps/desktop/src/renderer/features/right-sidebar/lib/lastTurnChangedFiles.ts, apps/desktop/src/renderer/features/right-sidebar/lib/nativePopupTabs.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openBackgroundTasksTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarFileBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openRoutinesTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openSubagentsTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openTerminalShortcut.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openTurnReview.ts, apps/desktop/src/renderer/features/right-sidebar/lib/popupRouter.ts, apps/desktop/src/renderer/features/right-sidebar/lib/popupTabs.ts, apps/desktop/src/renderer/features/right-sidebar/lib/rsbBrowserBridge.ts, apps/desktop/src/renderer/features/right-sidebar/lib/sidebarCommands.ts, apps/desktop/src/renderer/features/right-sidebar/lib/sidebarHostSession.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/BackgroundTasksBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/WorkflowAgentStrip.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/WorkflowProgressTree.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/chatTaskFocusIntent.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/listSessionTasks.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/workflowProgressModel.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/cindy-make/CindyMakeTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/cindy-make/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.css, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/dropExternalFile.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/fileTreeImagePreview.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/useSessionScopedTreeWidth.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/index.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/ios-simulator/IOSSimulatorInstanceGrid.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/ios-simulator/IOSSimulatorTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/ios-simulator/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/ios-simulator/iosSimulatorH264Decoder.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/OrcaWorkersAttentionIcon.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/OrcaWorkersTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/actions.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/closeDecision.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/ResourceUsageBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/resource-usage.css, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/subscription.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/ImageDiffPreview.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/MarkdownDiffPreview.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/PlainUnifiedDiff.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/diffRows.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/highlight.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/inlineDiff.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/useDiffHighlights.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/ReviewTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/diffExpansionPreference.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/fileTree.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/gitApplyCommand.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/markdownPreview.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useLastTurnFilter.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useReviewGitState.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useReviewSource.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/routines/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/ConversationStream.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/DetailView.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/RunList.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentChrome.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentToolCard.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentsBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentChangeFence.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentConversation.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentFormat.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/TerminalTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/lib/xtermPool.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserChrome.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserCommentPopover.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/browserCommentEditorDraft.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/lib/parseOmnibox.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/useBrowserComment.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/useLocalHtmlAutoReload.ts, apps/desktop/src/renderer/features/right-sidebar/registry.ts, apps/desktop/src/renderer/features/right-sidebar/store.ts, apps/desktop/src/renderer/features/right-sidebar/types.ts, apps/desktop/src/renderer/layout/LayoutRoot.tsx, apps/desktop/src/renderer/layout/PanelDragController.tsx, apps/desktop/src/renderer/layout/PanelDragPrototype.tsx, apps/desktop/src/renderer/layout/collapsePrefs.ts, apps/desktop/src/renderer/layout/layoutDevTools.ts, apps/desktop/src/renderer/layout/panePlacement.tsx, apps/desktop/src/renderer/layout/paneWidths.tsx, apps/desktop/src/renderer/layout/panelMaximize.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 153 | 46 | 297 |
| `desktop.skillhub.local` | desktop | SkillHub 本地技能 | hash `/skillhub/local` 及详情 `/skillhub/local/:kind/global/:name`、`/skillhub/local/:kind/project/:projectHash/:name` | InstallTargetPicker, PluginManagementLayout, SkillhubDetailView, SkillhubFeatureLayout, SkillhubHomeView, SkillhubMarketPreviewPanel | apps/desktop/src/renderer/features/plugin/PluginManagementLayout.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubDetailView.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubFeatureLayout.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubHomeView.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubMarketPreviewPanel.tsx, apps/desktop/src/renderer/features/skillhub/components/InstallTargetPicker.tsx | 46 | 0 | 66 |
| `desktop.skillhub.market` | desktop | SkillHub 市场 | hash `/skillhub/market`(SkillhubMarketListView) | InstallTargetPicker, MarketCard, MarketInfoEditDialog, SkillhubMarketListView, SkillhubMarketPreviewPanel, VisibilityEditorDialog | apps/desktop/src/renderer/features/skillhub/SkillhubMarketListView.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubMarketPreviewPanel.tsx, apps/desktop/src/renderer/features/skillhub/components/HomeMarketCard.tsx, apps/desktop/src/renderer/features/skillhub/components/InstallTargetPicker.tsx, apps/desktop/src/renderer/features/skillhub/components/LocalSkillControls.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketCard.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketInfoEditDialog.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketLocalSkills.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketPreviewTree.tsx, apps/desktop/src/renderer/features/skillhub/components/PlatformTagSelector.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillCategoryFilterBar.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillIcon.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillTagList.tsx, apps/desktop/src/renderer/features/skillhub/components/TeamScopePicker.tsx, apps/desktop/src/renderer/features/skillhub/components/VisibilityEditorDialog.tsx | 52 | 0 | 63 |
diff --git a/docs/dev-rules/credentials-and-local-storage.md b/docs/dev-rules/credentials-and-local-storage.md
index 2afd58daa0..0a575d5799 100644
--- a/docs/dev-rules/credentials-and-local-storage.md
+++ b/docs/dev-rules/credentials-and-local-storage.md
@@ -69,6 +69,11 @@
- 钥匙串条目名与 userData profile 的存量密文一一绑定:**不得**在共享既有 profile 的
进程里改 `app.name`——换名后新写入的密文对共用该 profile 的其它身份不可解,双向串坏。
改动条目名属存量凭证迁移,按上方增量适用原则必须单独设计兼容/回滚/验证方案。
+- Cindy Make 的托管个人版按已验证的本机启动交接继承原版的 profile、设备身份与钥匙串
+ 名称;Dev 和安装版同属原版。它只能沿用现有身份,不能认领另一套钥匙串或复制凭证。
+ 已有 `keychain-identity` 必须与交接身份一致;无标记只接受默认身份。原版入口和普通
+ packaged 启动的原规则不变,不开放任意环境变量的 packaged profile 覆写。
+ 见 [versionStartup](../../apps/desktop/src/main/cindy-make/versionStartup.ts)。
- 同机装过 cn 与 global 双版的机器上,后启动的版本首次访问 `safeStorage` 会触发系统
钥匙串授权弹窗,属 macOS 按预期征求同意;应引导用户点「始终允许」。点「拒绝」后
加解密降级失败,authManager 的 safeStorage helpers 会按原因落一次 warn 日志。
diff --git a/docs/dev-rules/database-and-migrations.md b/docs/dev-rules/database-and-migrations.md
index 3a2629b924..57f1e7064c 100644
--- a/docs/dev-rules/database-and-migrations.md
+++ b/docs/dev-rules/database-and-migrations.md
@@ -97,6 +97,10 @@ companion CommonJS 格式和历史 runtime identity 冻结;不能用单独 typ
- 需要启动验证时,按照 `desktop-development.md` 的参数说明使用显式
`--isolated[=<名字>]` 沙箱。migration replay 自身使用临时数据库,不污染用户数据。
- 不得为了测试 migration 临时改写、降级或删除用户数据库;需要历史状态时新增最小 fixture。
+- Cindy Make 托管个人版沿用来源原版的日常 profile,但对已有数据库使用同一严格
+ `checkMigrationCompatibility` 只读准入,禁止个人版迁移/修复共享 schema。全新账号
+ 的数据库可以按与原版一致的 schema 初始化。版本切换比较已保存的 SQL+companion
+ 指纹,并以窗口及认证/数据库共同就绪作为启动成功,失败不恢复旧数据库覆盖用户记录。
## 运行期数据库访问
diff --git a/docs/linux.md b/docs/linux.md
index 401f0a7722..26a6a5bba5 100644
--- a/docs/linux.md
+++ b/docs/linux.md
@@ -5,7 +5,7 @@
| Environment | Installation | How updates are applied |
| --- | --- | --- |
| Ubuntu 22.04 / 24.04 | Official system `.deb` via apt | In-app download, explicit restart, polkit authorization |
-| Arch Linux / Omarchy (Hyprland), x86_64 | Managed user installation below | In-app download, explicit restart, atomic user-owned version switch |
+| Arch Linux / Omarchy (Hyprland), x86_64 | One-command managed user installation below | In-app download, explicit restart, atomic user-owned version switch |
| Other glibc Linux desktops | Same user installer, with compatible runtime dependencies | Same transaction; not a claim that every distribution is tested |
| pacman/AUR or another third-party package | That package manager | Use that package manager, not the in-app installer |
@@ -28,7 +28,7 @@ Keep the distribution fully updated (Arch does not support partial upgrades).
Install the runtime libraries and integration tools if absent:
```sh
-sudo pacman -Syu --needed libarchive coreutils util-linux findutils procps-ng \
+sudo pacman -Syu --needed curl jq libarchive coreutils util-linux findutils procps-ng \
gtk3 nss alsa-lib libxss libxtst libnotify libdrm mesa \
gnome-keyring libsecret desktop-file-utils xdg-utils
```
@@ -51,7 +51,70 @@ Electron's selection. Desktop identity uses the first non-empty value from
`XDG_CURRENT_DESKTOP`, `XDG_SESSION_DESKTOP`, and `DESKTOP_SESSION`.
An explicit `--password-store` always wins and survives an in-app update restart.
-## Install
+## Install on Arch / Omarchy
+
+After the website operator publishes the bootstrap at the addresses below, quit
+Cindy fully and run the command shown on your download page as your desktop user,
+**without sudo**. The command downloads the latest stable `.deb` automatically;
+you do not need to download a package or a second script yourself.
+
+For [cindy.app](https://cindy.app/download/):
+
+```sh
+curl -fsSL https://hotfix.cindy.app/cindy/install-omarchy.sh | bash
+```
+
+For the Mainland China download page:
+
+```sh
+curl -fsSL https://hotfix.cindy.com.cn/cindy/install-omarchy.sh | bash -s -- --region cn
+```
+
+Both websites serve the **same** [bootstrap source](../apps/desktop/resources/linux/install-omarchy.sh).
+The download page supplies its build's region; the script does not infer it from
+IP address or locale. No region argument means `global`. Despite its name,
+`install-omarchy.sh` also supports ordinary Arch. Ubuntu, Debian and Mint exit
+before downloading or changing anything: keep using the website's `.deb` with
+apt. pacman/AUR-owned Cindy installations must use their package manager.
+
+The bootstrap reads `manifest-linux-x64.json` or `manifest-linux-arm64.json` from
+the selected region's existing CDN on **every invocation**. It pins the version,
+file, size and SHA-256 from that one response for the entire installation, checks
+the downloaded bytes, then checks the packaged build identity. It executes
+`install-user.sh` and `register-desktop.sh` taken from that verified `.deb`, never
+from Git HEAD. A newer release appearing during a download is picked up on the
+next run or by Cindy's normal in-app update. Beta/canary channels are not used.
+
+The menu entry and `cindy://` login links are registered automatically. Cindy is
+not launched automatically; open it from the menu or use the printed launcher.
+Missing dependencies produce a `pacman` command for you to run; the bootstrap
+does not install system packages or run sudo itself. A working, unlocked keyring
+and desktop session remain prerequisites.
+
+Repeating the command upgrades the managed installation or repairs its launcher
+and desktop registration if that exact package is already active. It rejects
+a release older than the installed stable version. Keep Cindy closed until the
+command finishes. Only one bootstrap per prefix can run at a time; a concurrent
+command exits with a busy message and can be retried after the first finishes.
+The persistent sibling `PREFIX.bootstrap.lock` serializes the bootstrap from
+manifest lookup through desktop registration; it does not replace the app
+updater's separate installation lock. Do not delete it while a command is running.
+The default prefix is
+`$HOME/.local/opt/cindy` (`cindy-cn` for a new Mainland China install); existing
+v1 Mainland China installs at `cindy` are reused when their marker matches. An
+unmarked directory, symlink or another region's installation is preserved: the
+bootstrap chooses a free `-managed` neighbor and reuses it on subsequent runs.
+A malformed installation marker is reported for repair, not overwritten.
+
+For a custom prefix, append `--prefix /absolute/path` using `bash -s --`, and
+supply the same prefix on later runs. An explicitly supplied occupied, unmarked
+prefix is rejected. Existing accounts and data stay in their original
+region-specific userData directory; see the migration notes below.
+
+### Manual / offline installation
+
+For other compatible glibc distributions, or to review and run the installer
+offline, the existing manual route remains available:
1. Download the matching official Linux package from
[Cindy downloads](https://cindy.app/download/). Obtain its **trusted SHA-256**
@@ -146,7 +209,9 @@ their disk usage and retain a suitable backup before cleaning them.
## Maintenance and validation
-- Forge writes build identity outside ASAR and bundles both Linux scripts.
+- Forge writes build identity outside ASAR and bundles the Linux resources
+ directory. The bootstrap is served separately for first installation; its
+ incidental packaged copy is not called by the app or updater.
The in-app update helper embeds the same installer source at build time;
it does not execute a mutable script from the installation directory.
- Keep `install-user.sh`, the marker schema, `linuxInstallation.ts`, and
@@ -157,8 +222,57 @@ their disk usage and retain a suitable backup before cleaning them.
activation, retry, stable desktop registration, and exact package ownership.
They run on Linux with libarchive/binutils/desktop-file-utils/xdg-utils; all
other platform-selection and UI tests also run on Windows.
+- The bootstrap's standalone native smoke uses the real two helper scripts
+ and small synthetic DEBs, with fake HTTP, distro identity and desktop MIME
+ writes. It covers region routing, two upgrades, repeated installation, legacy
+ paths, rejected distro/package ownership, bad metadata/digest/build identity,
+ older releases, concurrent installation/retry and truncated piped input. Run as a non-root Linux user with
+ the integration tools above, Node.js, `binutils` and ShellCheck installed:
+
+ ```sh
+ node --test apps/desktop/scripts/__tests__/install-omarchy.smoke.mjs
+ bash -n apps/desktop/resources/linux/install-omarchy.sh
+ shellcheck apps/desktop/resources/linux/install-omarchy.sh
+ ```
+
+ This standalone smoke is not part of `pnpm test:unit`; run it when changing
+ the bootstrap. It does not launch Electron or validate a live keyring.
- Before broad rollout, test two **real release** upgrades on both a fresh and
migrated Omarchy profile, cold-start login retention, locked-keyring recovery,
deep links, notifications, file dialogs and Wayland screen sharing. Repeat
Debian system updates and native GNOME/KDE login checks. Synthetic packages
are not a substitute for these release acceptance checks.
+
+## Website / OSS publication
+
+1. Upload `apps/desktop/resources/linux/install-omarchy.sh`, with LF line endings
+ and no HTML wrapper, to `install-omarchy.sh` under **each** CDN's `/cindy`
+ directory. It must be publicly readable over HTTPS without authentication.
+ A private bucket is fine when the CDN provides public access. Serve it as
+ plain text with revalidation or a short cache lifetime. Uploading this entry
+ point does not require rebuilding the app; its prerequisite is a published
+ Linux package containing the v1 build identity and both helpers. If the
+ current release predates that support, publish a new Linux release first.
+2. Continue publishing each region's own official `.deb` and the existing
+ `manifest-linux-<arch>.json`. Its `app.version` and `app.installer` fields
+ (`file`, `sha256`, `size`) are the bootstrap's source of truth. `file` is a
+ relative path under the same regional CDN, as it is for in-app updates. Do
+ not put the other region's bytes under that path. No second latest-version
+ JSON or independently uploaded helper scripts are needed.
+3. Publish the immutable, versioned `.deb` first; check its public availability
+ and digest, then replace the corresponding stable manifest last. Invalidate
+ the manifest's CDN cache / require revalidation. A failed fetch or checksum
+ mismatch stops the bootstrap without activating a new installation. Keep
+ the preceding version's asset available for downloads already in flight.
+4. Keep Ubuntu / Debian's existing `.deb` button. For Arch / Omarchy, show the
+ matching one-line command above instead of two download buttons. Optionally
+ expose a website `/install-omarchy` redirect to its region's CDN script; the
+ Mainland China command must still pass `--region cn`.
+5. Subsequent app releases only need the usual `.deb` + manifest publication.
+ Re-upload the bootstrap when the bootstrap itself changes. The installed
+ app continues using the existing in-app update service and manifest format.
+
+The URLs above are publication targets, not a claim that the script is already
+online. Validate both commands on Arch / Omarchy after upload, including an
+existing installation. Publishing or changing website/OSS content is separate
+from checking this source into the client repository.
diff --git a/i18n/GLOSSARY.md b/i18n/GLOSSARY.md
index 80b1db525e..a4316b6fea 100644
--- a/i18n/GLOSSARY.md
+++ b/i18n/GLOSSARY.md
@@ -201,7 +201,31 @@ Cindy AI 个人账号的免费会员身份标签。只在服务端明确下发 a
### Cindy Make
-用户通过内置 /cindy-make 显式开启的 Cindy 个人版制作流程,先复用 /cindy-make-doctor 检查本机环境,再按平台补齐缺少的便携工具,并在消息流卡片中保留修改需求;Doctor 自身只检查,上游查询与构建分阶段接入。命令名已由用户指定,卡片保留同一专名。
+用户通过 /cindy-make 显式开启的本机定制流程。输入区承接准备与每轮完成选择;修改时使用普通输入框。完成后可继续修改、启动隔离测试或生成个人版,版本切换由原生客户端处理。Doctor 自身只检查。
+
+### Make history
+
+Cindy Make 设置中保留全部制作、修改轮次与合入记录的列表;结束制作及清理工作目录后仍可回看。
+
+### Reapply integration
+
+重新应用之前明确撤销的制作改动,区别于把尚未合入的新修改首次加入个人源码。
+
+### Undo integration
+
+撤销单次制作已合入个人源码的全部改动,保留其他制作与已有应用成品;通过新的反向提交实现。
+
+### Version Control
+
+Cindy Make 设置中用户指定的页签名称,汇总我的版本与制作历史,并提供本地合入、撤销和生成入口。
+
+### Original Version
+
+Cindy Make 中与个人版对应的来源应用。用户明确要求 Dev 和正式安装版属于同一个类型;Dev 只影响底层启动方式,不作为第三类版本。
+
+### Personal Version
+
+Cindy Make 生成的本机定制应用成品。可与原版切换并沿用同一份日常数据,与使用独立数据的隔离测试版区分。
### Content Update
diff --git a/i18n/glossary.json b/i18n/glossary.json
index 0297e51ed4..77548ce20e 100644
--- a/i18n/glossary.json
+++ b/i18n/glossary.json
@@ -5,6 +5,53 @@
"sourceLocale": "en",
"punctuationExempt": ["desktop:settings.help.qnaFeedbackBodyTemplate"],
"terms": [
+ {
+ "id": "cindy-make-history",
+ "status": "proposed",
+ "en": "Make history",
+ "translations": { "zh-CN": "制作历史", "zh-TW": "製作歷史", "ja": "制作履歴", "ko": "제작 기록" },
+ "note": "Cindy Make 设置中保留全部制作、修改轮次与合入记录的列表;结束制作及清理工作目录后仍可回看。"
+ },
+ {
+ "id": "cindy-make-undo-integration",
+ "status": "proposed",
+ "en": "Undo integration",
+ "translations": { "zh-CN": "撤销合入", "zh-TW": "撤銷合入", "ja": "取り込みを取り消す", "ko": "반영 취소" },
+ "note": "撤销单次制作已合入个人源码的全部改动,保留其他制作与已有应用成品;通过新的反向提交实现。"
+ },
+ {
+ "id": "cindy-make-reapply-integration",
+ "status": "proposed",
+ "en": "Reapply integration",
+ "translations": { "zh-CN": "重新合入", "zh-TW": "重新合入", "ja": "再度取り込む", "ko": "다시 반영" },
+ "note": "重新应用之前明确撤销的制作改动,区别于把尚未合入的新修改首次加入个人源码。"
+ },
+ {
+ "id": "cindy-make-version-control",
+ "status": "proposed",
+ "en": "Version Control",
+ "translations": {
+ "zh-CN": "版本控制",
+ "zh-TW": "版本控制",
+ "ja": "バージョン管理",
+ "ko": "버전 관리"
+ },
+ "note": "Cindy Make 设置中用户指定的页签名称,汇总我的版本与制作历史,并提供本地合入、撤销和生成入口。"
+ },
+ {
+ "id": "cindy-original-version",
+ "status": "proposed",
+ "en": "Original Version",
+ "translations": { "zh-CN": "原版", "zh-TW": "原版", "ja": "オリジナル版", "ko": "기본 버전" },
+ "note": "Cindy Make 中与个人版对应的来源应用。用户明确要求 Dev 和正式安装版属于同一个类型;Dev 只影响底层启动方式,不作为第三类版本。"
+ },
+ {
+ "id": "cindy-personal-version",
+ "status": "proposed",
+ "en": "Personal Version",
+ "translations": { "zh-CN": "个人版", "zh-TW": "個人版", "ja": "個人版", "ko": "개인 버전" },
+ "note": "Cindy Make 生成的本机定制应用成品。可与原版切换并沿用同一份日常数据,与使用独立数据的隔离测试版区分。"
+ },
{
"id": "local-session-scope",
"status": "proposed",
@@ -163,7 +210,7 @@
"ja": "Cindy Make",
"ko": "Cindy Make"
},
- "note": "用户通过内置 /cindy-make 显式开启的 Cindy 个人版制作流程,先复用 /cindy-make-doctor 检查本机环境,再按平台补齐缺少的便携工具,并在消息流卡片中保留修改需求;Doctor 自身只检查,上游查询与构建分阶段接入。命令名已由用户指定,卡片保留同一专名。"
+ "note": "用户通过 /cindy-make 显式开启的本机定制流程。输入区承接准备与每轮完成选择;修改时使用普通输入框。完成后可继续修改、启动隔离测试或生成个人版,版本切换由原生客户端处理。Doctor 自身只检查。"
},
{
"id": "cindy-ai-free-tier",