Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
Merge origin/main and resolve integration regressions
Lizi6db9b508a798
diff --cc apps/desktop/native/windows-atomic-rename/main.rsindex 0000000000,041366f9dc..ab9cb2873emode 000000,100644..100644--- a/apps/desktop/native/windows-atomic-rename/main.rs+++ b/apps/desktop/native/windows-atomic-rename/main.rs@@@ -1,0 -1,157 +1,160 @@@+ //! Atomically replace one Windows directory entry with another.+ //!+ //! Node's rename cannot replace an existing directory junction. FileRenameInfoEx+ //! with POSIX semantics publishes the replacement in one filesystem operation:+ //! old handles stay valid and every later open sees the new entry.++ #![cfg(windows)]++ use std::{+ env,+ ffi::c_void,+ io,+ mem::{align_of, size_of},+ os::windows::ffi::OsStrExt,+ path::{Path, PathBuf},+ ptr,+ };++ type Handle = *mut c_void;++ #[link(name = "kernel32")]+ extern "system" {+ fn CreateFileW(+ file_name: *const u16,+ desired_access: u32,+ share_mode: u32,+ security_attributes: *mut c_void,+ creation_disposition: u32,+ flags_and_attributes: u32,+ template_file: Handle,+ ) -> Handle;+ fn SetFileInformationByHandle(+ file: Handle,+ information_class: i32,+ information: *const c_void,+ buffer_size: u32,+ ) -> i32;+ fn CloseHandle(object: Handle) -> i32;+ }++ const DELETE: u32 = 0x0001_0000;+ const FILE_SHARE_READ: u32 = 0x0000_0001;+ const FILE_SHARE_WRITE: u32 = 0x0000_0002;+ const FILE_SHARE_DELETE: u32 = 0x0000_0004;+ const OPEN_EXISTING: u32 = 3;+ const FILE_FLAG_OPEN_REPARSE_POINT: u32 = 0x0020_0000;+ const FILE_FLAG_BACKUP_SEMANTICS: u32 = 0x0200_0000;+ const FILE_RENAME_INFO_EX: i32 = 22;+ const FILE_RENAME_REPLACE_IF_EXISTS: u32 = 0x0000_0001;+ const FILE_RENAME_POSIX_SEMANTICS: u32 = 0x0000_0002;++ struct OwnedHandle(Handle);++ impl Drop for OwnedHandle {+ fn drop(&mut self) {+ unsafe { CloseHandle(self.0) };+ }+ }++ fn align_up(value: usize, alignment: usize) -> usize {+ (value + alignment - 1) & !(alignment - 1)+ }++ fn wide_null(path: &Path) -> Vec<u16> {+ path.as_os_str().encode_wide().chain(Some(0)).collect()+ }++ fn absolute_same_parent(source: &Path, destination: &Path) -> io::Result<()> {+ if !source.is_absolute() || !destination.is_absolute() {+ return Err(io::Error::new(+ io::ErrorKind::InvalidInput,+ "paths must be absolute",+ ));+ }+ if source == destination || source.parent() != destination.parent() {+ return Err(io::Error::new(+ io::ErrorKind::InvalidInput,+ "source and destination must be distinct siblings",+ ));+ }+ Ok(())+ }++ fn atomic_replace(source: &Path, destination: &Path) -> io::Result<()> {+ absolute_same_parent(source, destination)?;+ let source_wide = wide_null(source);+ let handle = unsafe {+ CreateFileW(+ source_wide.as_ptr(),+ DELETE,+ FILE_SHARE_READ | FILE_SHARE_WRITE | FILE_SHARE_DELETE,+ ptr::null_mut(),+ OPEN_EXISTING,+ FILE_FLAG_OPEN_REPARSE_POINT | FILE_FLAG_BACKUP_SEMANTICS,+ ptr::null_mut(),+ )+ };+ if handle as isize == -1 {+ return Err(io::Error::last_os_error());+ }+ let _handle = OwnedHandle(handle);++ let destination_wide: Vec<u16> = destination.as_os_str().encode_wide().collect();+ let root_offset = align_up(size_of::<u32>(), align_of::<Handle>());+ let length_offset = root_offset + size_of::<Handle>();+ let name_offset = length_offset + size_of::<u32>();+ let name_bytes = destination_wide+ .len()+ .checked_mul(size_of::<u16>())+ .ok_or_else(|| {+ io::Error::new(io::ErrorKind::InvalidInput, "destination path is too long")+ })?;+ let buffer_size = name_offset+ .checked_add(name_bytes)++ // SetFileInformationByHandle converts absolute DOS paths using a++ // NUL-terminated string. FileNameLength still excludes this terminator.++ .and_then(|length| length.checked_add(size_of::<u16>()))+ .ok_or_else(|| io::Error::new(io::ErrorKind::InvalidInput, "rename buffer is too large"))?;+ let buffer_size_u32 = u32::try_from(buffer_size)+ .map_err(|_| io::Error::new(io::ErrorKind::InvalidInput, "rename buffer is too large"))?;+ let name_bytes_u32 = u32::try_from(name_bytes)+ .map_err(|_| io::Error::new(io::ErrorKind::InvalidInput, "destination path is too long"))?;++ let mut buffer = vec![0u8; buffer_size];+ buffer[..4].copy_from_slice(+ &(FILE_RENAME_REPLACE_IF_EXISTS | FILE_RENAME_POSIX_SEMANTICS).to_ne_bytes(),+ );+ buffer[length_offset..length_offset + 4].copy_from_slice(&name_bytes_u32.to_ne_bytes());+ for (index, code_unit) in destination_wide.iter().enumerate() {+ let offset = name_offset + index * 2;+ buffer[offset..offset + 2].copy_from_slice(&code_unit.to_ne_bytes());+ }++ let succeeded = unsafe {+ SetFileInformationByHandle(+ handle,+ FILE_RENAME_INFO_EX,+ buffer.as_ptr().cast(),+ buffer_size_u32,+ )+ };+ if succeeded == 0 {+ return Err(io::Error::last_os_error());+ }+ Ok(())+ }++ fn main() {+ let mut args = env::args_os().skip(1);+ let source = args.next().map(PathBuf::from);+ let destination = args.next().map(PathBuf::from);+ if source.is_none() || destination.is_none() || args.next().is_some() {+ eprintln!("usage: cindy-windows-atomic-rename <source> <destination>");+ std::process::exit(2);+ }+ if let Err(error) = atomic_replace(&source.unwrap(), &destination.unwrap()) {+ eprintln!("atomic directory entry replacement failed: {error}");+ std::process::exit(1);+ }+ }diff --cc apps/desktop/scripts/check-windows-atomic-rename.mjsindex 0000000000,7f4d39f1fd..f5932b27d4mode 000000,100644..100644--- a/apps/desktop/scripts/check-windows-atomic-rename.mjs+++ b/apps/desktop/scripts/check-windows-atomic-rename.mjs@@@ -1,0 -1,65 +1,66 @@@+ import assert from 'node:assert/strict';+ import { spawn, spawnSync } from 'node:child_process';+ import fs from 'node:fs';+ import os from 'node:os';+ import path from 'node:path';+ import { fileURLToPath } from 'node:url';++ if (process.platform !== 'win32') {+ console.log('Windows atomic rename check skipped on this platform.');+ process.exit(0);+ }++ const scriptDir = path.dirname(fileURLToPath(import.meta.url));+ const source = path.join(scriptDir, '..', 'native', 'windows-atomic-rename', 'main.rs');+ const root = fs.mkdtempSync(path.join(os.tmpdir(), 'cindy-atomic-rename-check-'));+ const binary = path.join(root, 'cindy-windows-atomic-rename.exe');+ let oldHandle;++ try {+ const compile = spawnSync('rustc', [+ source,+ '--edition=2021',+ '-C', 'opt-level=s',+ '-C', 'panic=abort',+ '-o', binary,+ ], { encoding: 'utf8', windowsHide: true });+ assert.equal(compile.status, 0, compile.stderr || compile.stdout);++ const first = path.join(root, 'first');+ const second = path.join(root, 'second');+ const active = path.join(root, '.active');+ const replacement = path.join(root, '.active.next');+ fs.mkdirSync(first);+ fs.mkdirSync(second);+ fs.writeFileSync(path.join(first, 'SKILL.md'), 'first');+ fs.writeFileSync(path.join(second, 'SKILL.md'), 'second');+ fs.symlinkSync(first, active, 'junction');+ fs.symlinkSync(second, replacement, 'junction');++ oldHandle = fs.openSync(path.join(active, 'SKILL.md'), 'r');+ let missingObservations = 0;+ const child = spawn(binary, [replacement, active], { windowsHide: true });+ const poll = setInterval(() => {+ if (!fs.existsSync(active)) missingObservations += 1;+ }, 0);+ const exitCode = await new Promise((resolve, reject) => {+ child.once('error', reject);+ child.once('exit', resolve);+ });+ clearInterval(poll);+ assert.equal(exitCode, 0, 'native helper failed');+ assert.equal(missingObservations, 0, '.active disappeared during publication');++ assert.equal(fs.readlinkSync(active), second, 'the exact destination entry must be replaced');+ assert.equal(fs.readFileSync(path.join(active, 'SKILL.md'), 'utf8'), 'second');+ assert.equal(fs.existsSync(replacement), false);++ const oldBytes = Buffer.alloc(5);+ assert.equal(fs.readSync(oldHandle, oldBytes, 0, oldBytes.length, 0), 5);+ assert.equal(oldBytes.toString(), 'first');+ fs.closeSync(oldHandle);+ oldHandle = undefined;+ console.log('Windows atomic rename check passed.');+ } finally {+ if (oldHandle !== undefined) fs.closeSync(oldHandle);+ fs.rmSync(root, { recursive: true, force: true });+ }diff --cc apps/desktop/src/main/maker-host/__tests__/built-in-skills.test.tsindex 0000000000,1c917bb3f3..ec0e3c7f9dmode 000000,100644..100644--- a/apps/desktop/src/main/maker-host/__tests__/built-in-skills.test.ts+++ b/apps/desktop/src/main/maker-host/__tests__/built-in-skills.test.ts@@@ -1,0 -1,920 +1,930 @@@+ import fs from 'node:fs';+ import os from 'node:os';+ import path from 'node:path';+ import { afterEach, describe, expect, it, vi } from 'vitest';+ import type { Maker } from '@cindy/maker-core';+ import { scanAllSkills } from '../../skillhub/scanner';++ vi.mock('../../skillhub/registry', () => ({+ registryService: { listAllInstalls: vi.fn(async () => []), getInstall: vi.fn(async () => null) },+ }));++ import {+ activeCindyBuiltInAgentSkills,+ BUILT_IN_SKILLS_BUNDLE_VERSION,+ builtInSkillDescriptors,+ markCindyBuiltInAgentSkills,+ prepareBuiltInSkills,+ refreshBuiltInClaudeSkillLinks,+ resolveBundledSystemSkillsRoot,+ } from '../built-in-skills';++ const roots: string[] = [];++ function fixture() {+ const root = fs.mkdtempSync(path.join(os.tmpdir(), 'cindy-built-in-skills-'));+ roots.push(root);+ const bundledRoot = path.join(root, 'resources', 'system-skills');+ const source = path.join(bundledRoot, 'cindy-skill-creator');+ const learnSource = path.join(bundledRoot, 'learn');+ const userDataDir = path.join(root, 'user-data');+ const appDataDir = path.join(root, 'app-data');+ const homeDir = path.join(root, 'home');+ fs.mkdirSync(path.join(source, 'scripts'), { recursive: true });+ fs.mkdirSync(learnSource, { recursive: true });+ fs.writeFileSync(+ path.join(source, 'SKILL.md'),+ '---\nname: cindy-skill-creator\ndescription: Create Skills\n---\n\n# Creator\n',+ );+ fs.writeFileSync(path.join(source, 'scripts', 'validate.py'), 'print("ok")\n');+ fs.writeFileSync(+ path.join(learnSource, 'SKILL.md'),+ '---\nname: learn\ndescription: Start Cindy Learn\n---\n\n# Learn\n',+ );+ const withSharedMutation = async <T>(+ _names: readonly string[],+ operation: () => Promise<T>,+ ): Promise<T> => operation();+ const replaceDirectoryEntryAtomically = process.platform === 'win32'+ ? async (replacement: string, destination: string) => {+ // Unit-test adapter only. The native helper has a dedicated Windows smoke+ // test; keep these filesystem fixtures independent from Electron's app stub.+ const previousTarget = await fs.promises.readlink(destination);+ await fs.promises.unlink(destination);+ try {+ await fs.promises.rename(replacement, destination);+ } catch (error) {+ await fs.promises.symlink(previousTarget, destination, 'junction');+ throw error;+ }+ }+ : undefined;+ return {+ bundledRoot,+ source,+ userDataDir,+ appDataDir,+ homeDir,+ withSharedMutation,+ ...(replaceDirectoryEntryAtomically ? { replaceDirectoryEntryAtomically } : {}),+ };+ }++ async function prepareAndProjectBuiltInSkills(+ input: ReturnType<typeof fixture> & { bundleVersion?: number },+ ) {+ return prepareBuiltInSkills(input);+ }++ afterEach(() => {+ vi.restoreAllMocks();+ for (const root of roots.splice(0)) fs.rmSync(root, { recursive: true, force: true });+ });++ describe('built-in Skills', () => {+ it('materializes immutable versioned bytes and exposes the active version', async () => {+ const input = fixture();+ const first = await prepareAndProjectBuiltInSkills(input);+ const descriptor = builtInSkillDescriptors(input.userDataDir, input.appDataDir)[0]!;+ const root = path.join(input.appDataDir, 'Cindy', 'shared-system-skills');+ const manifest = JSON.parse(+ fs.readFileSync(path.join(root, '.cindy-system-skills.json'), 'utf8'),+ );+ const link = path.join(input.homeDir, '.agents', 'skills', 'cindy-skill-creator');+ expect(first.changed).toBe(true);+ expect(first.warnings).toEqual([]);+ expect(manifest).toMatchObject({+ schemaVersion: 3,+ bundleVersion: BUILT_IN_SKILLS_BUNDLE_VERSION,+ });+ expect(descriptor.absolutePath).toBe(+ path.join(root, '.active', 'cindy-skill-creator'),+ );+ const firstImmutablePath = fs.realpathSync(descriptor.absolutePath);+ expect(firstImmutablePath).toBe(+ fs.realpathSync(path.join(root, '.versions', manifest.activeBundle, 'cindy-skill-creator')),+ );+ expect(fs.realpathSync(link)).toBe(fs.realpathSync(descriptor.absolutePath));+ expect(fs.realpathSync(descriptor.nativeClaudePath)).toBe(+ fs.realpathSync(descriptor.absolutePath),+ );+ expect(fs.readFileSync(path.join(descriptor.absolutePath, 'SKILL.md'), 'utf8')).toContain(+ '# Creator',+ );+ const learnDescriptor = first.descriptors.find((item) => item.name === 'learn')!;+ expect(fs.realpathSync(path.join(input.homeDir, '.agents', 'skills', 'learn'))).toBe(+ fs.realpathSync(learnDescriptor.absolutePath),+ );+ expect(fs.readFileSync(path.join(learnDescriptor.absolutePath, 'SKILL.md'), 'utf8')).toContain(+ '# Learn',+ );++ const second = await prepareAndProjectBuiltInSkills(input);+ expect(second.changed).toBe(false);++ fs.writeFileSync(path.join(descriptor.absolutePath, 'SKILL.md'), '# Tampered\n');+ const repaired = await prepareAndProjectBuiltInSkills(input);+ const repairedDescriptor = repaired.descriptors.find(+ (item) => item.name === 'cindy-skill-creator',+ )!;+ expect(repaired.changed).toBe(true);+ expect(repairedDescriptor.absolutePath).toBe(descriptor.absolutePath);+ expect(fs.realpathSync(repairedDescriptor.absolutePath)).not.toBe(firstImmutablePath);+ expect(fs.readFileSync(path.join(repairedDescriptor.absolutePath, 'SKILL.md'), 'utf8')).toContain(+ '# Creator',+ );+ expect(fs.existsSync(path.join(firstImmutablePath, 'SKILL.md'))).toBe(true);++ fs.appendFileSync(path.join(input.source, 'SKILL.md'), '\nUpdated\n');+ const updated = await prepareAndProjectBuiltInSkills({+ ...input,+ bundleVersion: BUILT_IN_SKILLS_BUNDLE_VERSION + 1,+ });+ expect(updated.changed).toBe(true);+ const updatedDescriptor = updated.descriptors.find(+ (item) => item.name === 'cindy-skill-creator',+ )!;+ expect(fs.readFileSync(path.join(updatedDescriptor.absolutePath, 'SKILL.md'), 'utf8')).toContain(+ 'Updated',+ );+ expect(fs.realpathSync(link)).toBe(fs.realpathSync(updatedDescriptor.absolutePath));+ });++ it('does not let an older or conflicting bundle overwrite newer shared bytes', async () => {+ const input = fixture();+ fs.appendFileSync(path.join(input.source, 'SKILL.md'), '\nNewer bundle\n');+ const newer = await prepareBuiltInSkills({ ...input, bundleVersion: 2 });+ const descriptor = newer.descriptors[0]!;+ const installed = fs.readFileSync(path.join(descriptor.absolutePath, 'SKILL.md'), 'utf8');++ fs.writeFileSync(+ path.join(input.source, 'SKILL.md'),+ '---\nname: cindy-skill-creator\ndescription: Old bundle\n---\n\n# Old\n',+ );+ const older = await prepareBuiltInSkills({ ...input, bundleVersion: 1 });+ expect(fs.readFileSync(path.join(descriptor.absolutePath, 'SKILL.md'), 'utf8')).toBe(installed);+ expect(older.warnings.join('\n')).toContain('only carries older bundle 1');++ const conflicting = await prepareBuiltInSkills({ ...input, bundleVersion: 2 });+ expect(fs.readFileSync(path.join(descriptor.absolutePath, 'SKILL.md'), 'utf8')).toBe(installed);+ expect(conflicting.warnings.join('\n')).toContain('bundle version 2 was reused');+ });++ it('fails closed when an existing bundle manifest is corrupt', async () => {+ const input = fixture();+ const newer = await prepareBuiltInSkills({ ...input, bundleVersion: 5 });+ const descriptor = newer.descriptors[0]!;+ const manifestPath = path.join(input.appDataDir, 'Cindy', 'shared-system-skills', '.cindy-system-skills.json');+ const installed = fs.readFileSync(path.join(descriptor.absolutePath, 'SKILL.md'), 'utf8');+ fs.writeFileSync(manifestPath, '{ invalid json');+ fs.writeFileSync(+ path.join(input.source, 'SKILL.md'),+ '---\nname: cindy-skill-creator\ndescription: Old bundle\n---\n\n# Old\n',+ );++ const older = await prepareBuiltInSkills({ ...input, bundleVersion: 4 });++ expect(fs.readFileSync(path.join(descriptor.absolutePath, 'SKILL.md'), 'utf8')).toBe(installed);+ expect(older.changed).toBe(false);+ expect(older.projectionSafe).toBe(false);+ expect(older.warnings.join('\n')).toContain('manifest is unavailable');+ });++ it('preserves existing projections when a manifest has a corrupt shape', async () => {+ const input = fixture();+ await prepareAndProjectBuiltInSkills(input);+ const sharedLink = path.join(input.homeDir, '.agents', 'skills', 'cindy-skill-creator');+ const claudeLink = path.join(input.userDataDir, 'claude-home', 'skills', 'cindy-skill-creator');+ const sharedTarget = fs.realpathSync(sharedLink);+ const claudeTarget = fs.realpathSync(claudeLink);+ const manifestPath = path.join(+ input.appDataDir,+ 'Cindy',+ 'shared-system-skills',+ '.cindy-system-skills.json',+ );+ fs.writeFileSync(manifestPath, JSON.stringify({+ schemaVersion: 3,+ bundleVersion: BUILT_IN_SKILLS_BUNDLE_VERSION,+ fingerprints: {},+ activeBundle: 'damaged',+ }));++ const failed = await prepareAndProjectBuiltInSkills(input);++ expect(failed.projectionSafe).toBe(false);+ expect(failed.warnings.join('\n')).toContain('manifest is unavailable');+ expect(fs.realpathSync(sharedLink)).toBe(sharedTarget);+ expect(fs.realpathSync(claudeLink)).toBe(claudeTarget);+ });++ it('does not infer a first install when the manifest is missing beside existing Skills', async () => {+ const input = fixture();+ const newer = await prepareBuiltInSkills({ ...input, bundleVersion: 5 });+ const descriptor = newer.descriptors[0]!;+ const manifestPath = path.join(input.appDataDir, 'Cindy', 'shared-system-skills', '.cindy-system-skills.json');+ const installed = fs.readFileSync(path.join(descriptor.absolutePath, 'SKILL.md'), 'utf8');+ fs.unlinkSync(manifestPath);++ const retried = await prepareBuiltInSkills({ ...input, bundleVersion: 4 });++ expect(fs.readFileSync(path.join(descriptor.absolutePath, 'SKILL.md'), 'utf8')).toBe(installed);+ expect(retried.changed).toBe(false);+ expect(retried.warnings.join('\n')).toContain('manifest is unavailable');+ });++ it('restores the atomic manifest backup before applying version ordering', async () => {+ const input = fixture();+ const newer = await prepareBuiltInSkills({ ...input, bundleVersion: 5 });+ const descriptor = newer.descriptors[0]!;+ const manifestPath = path.join(input.appDataDir, 'Cindy', 'shared-system-skills', '.cindy-system-skills.json');+ const installed = fs.readFileSync(path.join(descriptor.absolutePath, 'SKILL.md'), 'utf8');+ fs.renameSync(manifestPath, `${manifestPath}.bak`);+ fs.writeFileSync(+ path.join(input.source, 'SKILL.md'),+ '---\nname: cindy-skill-creator\ndescription: Old bundle\n---\n\n# Old\n',+ );++ const older = await prepareBuiltInSkills({ ...input, bundleVersion: 4 });++ expect(fs.existsSync(manifestPath)).toBe(true);+ expect(fs.existsSync(`${manifestPath}.bak`)).toBe(false);+ expect(fs.readFileSync(path.join(descriptor.absolutePath, 'SKILL.md'), 'utf8')).toBe(installed);+ expect(older.warnings.join('\n')).toContain('only carries older bundle 4');+ });++ it('advances the bundle version only after every Skill is ready and retries partial upgrades', async () => {+ const input = fixture();+ await prepareBuiltInSkills(input);+ fs.appendFileSync(path.join(input.source, 'SKILL.md'), '\nCreator v2\n');+ fs.writeFileSync(path.join(input.bundledRoot, 'learn', 'SKILL.md'), 'Learn v2\n');+ fs.renameSync(+ path.join(input.bundledRoot, 'learn', 'SKILL.md'),+ path.join(input.bundledRoot, 'learn', 'SKILL.md.missing'),+ );++ const partial = await prepareBuiltInSkills({+ ...input,+ bundleVersion: BUILT_IN_SKILLS_BUNDLE_VERSION + 1,+ });+ const manifestPath = path.join(input.appDataDir, 'Cindy', 'shared-system-skills', '.cindy-system-skills.json');+ expect(JSON.parse(fs.readFileSync(manifestPath, 'utf8')).bundleVersion).toBe(+ BUILT_IN_SKILLS_BUNDLE_VERSION,+ );+ expect(partial.warnings.join('\n')).toContain('missing SKILL.md');+ expect(+ fs.readFileSync(path.join(partial.descriptors[0]!.absolutePath, 'SKILL.md'), 'utf8'),+ ).not.toContain('Creator v2');++ fs.renameSync(+ path.join(input.bundledRoot, 'learn', 'SKILL.md.missing'),+ path.join(input.bundledRoot, 'learn', 'SKILL.md'),+ );+ const retried = await prepareBuiltInSkills({+ ...input,+ bundleVersion: BUILT_IN_SKILLS_BUNDLE_VERSION + 1,+ });+ expect(retried.warnings).toEqual([]);+ expect(JSON.parse(fs.readFileSync(manifestPath, 'utf8')).bundleVersion).toBe(+ BUILT_IN_SKILLS_BUNDLE_VERSION + 1,+ );+ expect(+ fs.readFileSync(+ path.join(+ retried.descriptors.find((descriptor) => descriptor.name === 'learn')!.absolutePath,+ 'SKILL.md',+ ),+ 'utf8',+ ),+ ).toBe('Learn v2\n');+ });++ it('keeps the active bundle readable when publishing a new version directory fails', async () => {+ const input = fixture();+ const initial = await prepareBuiltInSkills(input);+ const creator = initial.descriptors.find((descriptor) => descriptor.name === 'cindy-skill-creator')!;+ const learn = initial.descriptors.find((descriptor) => descriptor.name === 'learn')!;+ const root = path.join(input.appDataDir, 'Cindy', 'shared-system-skills');+ const manifestPath = path.join(root, '.cindy-system-skills.json');+ const initialManifest = fs.readFileSync(manifestPath, 'utf8');+ const initialActiveBundle = JSON.parse(initialManifest).activeBundle as string;+ const initialCreator = fs.readFileSync(path.join(creator.absolutePath, 'SKILL.md'), 'utf8');+ const initialLearn = fs.readFileSync(path.join(learn.absolutePath, 'SKILL.md'), 'utf8');+ fs.appendFileSync(path.join(input.source, 'SKILL.md'), '\nCreator v2\n');+ fs.writeFileSync(path.join(input.bundledRoot, 'learn', 'SKILL.md'), 'Learn v2\n');++ const versionsRoot = path.join(root, '.versions');+ const originalRename = fs.promises.rename.bind(fs.promises);+ let activeBundleWasReadable = false;+ vi.spyOn(fs.promises, 'rename').mockImplementation(async (source, destination) => {+ if (+ path.dirname(String(source)) === versionsRoot &&+ path.basename(String(source)).endsWith('.pending') &&+ path.dirname(String(destination)) === versionsRoot+ ) {+ activeBundleWasReadable = fs.existsSync(path.join(creator.absolutePath, 'SKILL.md'));+ throw new Error('blocked version publish');+ }+ await originalRename(source, destination);+ });++ const failed = await prepareBuiltInSkills({+ ...input,+ bundleVersion: BUILT_IN_SKILLS_BUNDLE_VERSION + 1,+ });++ expect(failed.changed).toBe(false);+ expect(failed.warnings.join('\n')).toContain('blocked version publish');+ expect(activeBundleWasReadable).toBe(true);+ expect(fs.readFileSync(manifestPath, 'utf8')).toBe(initialManifest);+ expect(fs.readFileSync(path.join(creator.absolutePath, 'SKILL.md'), 'utf8')).toBe(initialCreator);+ expect(fs.readFileSync(path.join(learn.absolutePath, 'SKILL.md'), 'utf8')).toBe(initialLearn);+ expect(fs.readdirSync(versionsRoot)).toEqual([initialActiveBundle]);+ });++ it('keeps the previous version active when the manifest pointer switch fails', async () => {+ const input = fixture();+ const initial = await prepareBuiltInSkills(input);+ const creator = initial.descriptors.find((descriptor) => descriptor.name === 'cindy-skill-creator')!;+ const root = path.join(input.appDataDir, 'Cindy', 'shared-system-skills');+ const versionsRoot = path.join(root, '.versions');+ const manifestPath = path.join(root, '.cindy-system-skills.json');+ const initialManifest = fs.readFileSync(manifestPath, 'utf8');+ const initialActiveBundle = JSON.parse(initialManifest).activeBundle as string;+ fs.appendFileSync(path.join(input.source, 'SKILL.md'), '\nCreator v2\n');++ const originalRename = fs.renameSync.bind(fs);+ vi.spyOn(fs, 'renameSync').mockImplementation((source, destination) => {+ if (String(destination) === manifestPath && String(source).endsWith('.tmp')) {+ throw new Error('blocked manifest switch');+ }+ originalRename(source, destination);+ });++ const failed = await prepareBuiltInSkills({+ ...input,+ bundleVersion: BUILT_IN_SKILLS_BUNDLE_VERSION + 1,+ });++ expect(failed.changed).toBe(false);+ expect(failed.warnings.join('\n')).toContain('blocked manifest switch');+ expect(fs.readFileSync(manifestPath, 'utf8')).toBe(initialManifest);+ expect(fs.readFileSync(path.join(creator.absolutePath, 'SKILL.md'), 'utf8')).not.toContain(+ 'Creator v2',+ );+ expect(failed.descriptors[0]!.absolutePath).toBe(creator.absolutePath);+ expect(fs.readdirSync(versionsRoot)).toEqual([initialActiveBundle]);+ });++ it('keeps every managed projection on one stable target across bundle upgrades', async () => {+ const input = fixture();+ const initial = await prepareBuiltInSkills(input);+ const root = path.join(input.appDataDir, 'Cindy', 'shared-system-skills');+ const initialCreator = initial.descriptors.find(+ (descriptor) => descriptor.name === 'cindy-skill-creator',+ )!;+ const initialLearn = initial.descriptors.find((descriptor) => descriptor.name === 'learn')!;+ const creatorLink = path.join(input.homeDir, '.agents', 'skills', 'cindy-skill-creator');+ const learnLink = path.join(input.homeDir, '.agents', 'skills', 'learn');+ const nativeCreatorLink = initialCreator.nativeClaudePath;+ const nativeLearnLink = initialLearn.nativeClaudePath;+ const initialCreatorBytes = fs.realpathSync(initialCreator.absolutePath);+ const initialLearnBytes = fs.realpathSync(initialLearn.absolutePath);+ const projectionTargets = new Map([+ [creatorLink, fs.readlinkSync(creatorLink)],+ [learnLink, fs.readlinkSync(learnLink)],+ [nativeCreatorLink, fs.readlinkSync(nativeCreatorLink)],+ [nativeLearnLink, fs.readlinkSync(nativeLearnLink)],+ ]);+ fs.appendFileSync(path.join(input.source, 'SKILL.md'), '\nCreator v2\n');+ fs.appendFileSync(path.join(input.bundledRoot, 'learn', 'SKILL.md'), '\nLearn v2\n');++ const updated = await prepareBuiltInSkills({+ ...input,+ bundleVersion: BUILT_IN_SKILLS_BUNDLE_VERSION + 1,+ });++ expect(updated.warnings).toEqual([]);+ expect(updated.projectionSafe).toBe(true);+ for (const [linkPath, target] of projectionTargets) {+ expect(fs.readlinkSync(linkPath)).toBe(target);+ }+ expect(fs.readlinkSync(creatorLink)).toBe(path.join(root, '.active', 'cindy-skill-creator'));+ expect(fs.realpathSync(creatorLink)).not.toBe(initialCreatorBytes);+ expect(fs.realpathSync(learnLink)).not.toBe(initialLearnBytes);+ expect(fs.realpathSync(nativeCreatorLink)).toBe(fs.realpathSync(creatorLink));+ expect(fs.realpathSync(nativeLearnLink)).toBe(fs.realpathSync(learnLink));+ });++ it('finishes a committed active-pointer switch after an interrupted upgrade', async () => {+ const input = fixture();+ const initial = await prepareBuiltInSkills(input);+ const root = path.join(input.appDataDir, 'Cindy', 'shared-system-skills');+ const activePath = path.join(root, '.active');+ const oldActiveTarget = fs.readlinkSync(activePath);+ const oldCreatorBytes = fs.realpathSync(initial.descriptors[0]!.absolutePath);+ fs.appendFileSync(path.join(input.source, 'SKILL.md'), '\nCreator v2\n');++ const upgraded = await prepareBuiltInSkills({+ ...input,+ bundleVersion: BUILT_IN_SKILLS_BUNDLE_VERSION + 1,+ });+ const committedCreatorBytes = fs.realpathSync(upgraded.descriptors[0]!.absolutePath);+ expect(committedCreatorBytes).not.toBe(oldCreatorBytes);++ // Simulate termination after the manifest commit but before .active moved.+ fs.unlinkSync(activePath);+ fs.symlinkSync(oldActiveTarget, activePath, process.platform === 'win32' ? 'junction' : 'dir');+ const sharedLink = path.join(input.homeDir, '.agents', 'skills', 'cindy-skill-creator');+ expect(fs.realpathSync(sharedLink)).toBe(oldCreatorBytes);++ const recovered = await prepareBuiltInSkills({+ ...input,+ bundleVersion: BUILT_IN_SKILLS_BUNDLE_VERSION + 1,+ });++ expect(recovered.changed).toBe(true);+ expect(recovered.projectionSafe).toBe(true);+ expect(recovered.warnings).toEqual([]);+ expect(fs.realpathSync(sharedLink)).toBe(committedCreatorBytes);+ });++ it('repairs a committed active pointer redirected outside the managed versions directory', async () => {+ const input = fixture();+ const initial = await prepareBuiltInSkills(input);+ const root = path.join(input.appDataDir, 'Cindy', 'shared-system-skills');+ const activePath = path.join(root, '.active');+ const manifest = JSON.parse(+ fs.readFileSync(path.join(root, '.cindy-system-skills.json'), 'utf8'),+ );+ const committedRoot = path.join(root, '.versions', manifest.activeBundle);+ const redirectedRoot = path.join(input.appDataDir, 'redirected-system-skills');+ const redirectedCreator = path.join(redirectedRoot, 'cindy-skill-creator');+ fs.mkdirSync(redirectedCreator, { recursive: true });+ fs.writeFileSync(path.join(redirectedCreator, 'SKILL.md'), '# Redirected\n');+ fs.unlinkSync(activePath);+ fs.symlinkSync(redirectedRoot, activePath, process.platform === 'win32' ? 'junction' : 'dir');+ const sharedLink = path.join(input.homeDir, '.agents', 'skills', 'cindy-skill-creator');+ expect(fs.realpathSync(sharedLink)).toBe(fs.realpathSync(redirectedCreator));++ const recovered = await prepareBuiltInSkills(input);++ expect(recovered.changed).toBe(true);+ expect(recovered.projectionSafe).toBe(true);+ expect(recovered.warnings).toEqual([]);+ expect(fs.realpathSync(activePath)).toBe(fs.realpathSync(committedRoot));+ expect(fs.realpathSync(sharedLink)).toBe(fs.realpathSync(initial.descriptors[0]!.absolutePath));+ expect(fs.readFileSync(path.join(redirectedCreator, 'SKILL.md'), 'utf8')).toBe(+ '# Redirected\n',+ );+ });++ it.each(['directory', 'outside-link', 'wrong-bundle', 'modified-content', 'missing-manifest', 'linked-bundle'])(+ 'withholds official identity from %s even after successful preparation',+ async (damage) => {+ const input = fixture();+ const prepared = await prepareBuiltInSkills(input);+ const root = path.join(input.appDataDir, 'Cindy', 'shared-system-skills');+ const active = path.join(root, '.active');+ const target = fs.realpathSync(active);+ const skillPath = path.join(active, 'cindy-skill-creator');+ expect(prepared.projectionSafe).toBe(true);+ expect(builtInSkillDescriptors(input.userDataDir, input.appDataDir)).toHaveLength(2);+ if (damage === 'modified-content') {+ fs.appendFileSync(path.join(skillPath, 'SKILL.md'), '\nChanged');+ } else if (damage === 'missing-manifest') {+ fs.unlinkSync(path.join(root, '.cindy-system-skills.json'));+ } else if (damage === 'linked-bundle') {+ const outside = path.join(input.homeDir, 'substituted-bundle');+ fs.renameSync(target, outside);+ fs.symlinkSync(outside, target, process.platform === 'win32' ? 'junction' : 'dir');+ } else {+ fs.unlinkSync(active);+ const replacement = damage === 'directory' ? active+ : damage === 'outside-link' ? path.join(input.homeDir, 'outside-bundle')+ : path.join(root, '.versions', 'v10-0123456789abcdef-11111111-1111-1111-1111-111111111111');+ fs.cpSync(target, replacement, { recursive: true });+ if (damage !== 'directory') {+ fs.symlinkSync(replacement, active, process.platform === 'win32' ? 'junction' : 'dir');+ }+ }+ const descriptors = builtInSkillDescriptors(input.userDataDir, input.appDataDir);+ expect(descriptors).toEqual([]);+ const [command] = markCindyBuiltInAgentSkills([{+ kind: 'agent-skill', name: 'cindy-skill-creator', source: 'skill',+ path: path.join(skillPath, 'SKILL.md'), scope: 'user', enabled: true, builtIn: true,+ }], descriptors);+ expect(command?.builtIn).toBeUndefined();+ const maker = { listCustomizations: async () => ({ errors: [], items: [{+ engine: 'codex', kind: 'skill', scope: 'user', name: 'cindy-skill-creator',+ absolutePath: skillPath, mdPath: path.join(skillPath, 'SKILL.md'), files: [],+ }] }) } as unknown as Maker;+ const scanned = await scanAllSkills({}, maker, [], descriptors);+ expect(scanned.skills).toHaveLength(1);+ expect(scanned.skills[0]?.builtIn).not.toBe(true);+ },+ );++ it('does not overwrite a non-link active pointer placeholder', async () => {+ const input = fixture();+ await prepareBuiltInSkills(input);+ const root = path.join(input.appDataDir, 'Cindy', 'shared-system-skills');+ const activePath = path.join(root, '.active');+ fs.unlinkSync(activePath);+ fs.mkdirSync(path.join(activePath, 'cindy-skill-creator'), { recursive: true });+ fs.writeFileSync(+ path.join(activePath, 'cindy-skill-creator', 'SKILL.md'),+ '# User placeholder\n',+ );++ const failed = await prepareBuiltInSkills(input);++ expect(failed.changed).toBe(false);+ expect(failed.projectionSafe).toBe(false);+ expect(failed.descriptors).toEqual([]);+ expect(failed.warnings.join('\n')).toContain('active pointer is not a link');+ expect(fs.lstatSync(activePath).isDirectory()).toBe(true);+ expect(fs.readFileSync(path.join(activePath, 'cindy-skill-creator', 'SKILL.md'), 'utf8')).toBe(+ '# User placeholder\n',+ );+ });++ it('restores the previous manifest and active pointer when publication fails', async () => {+ const input = fixture();+ const initial = await prepareBuiltInSkills(input);+ const root = path.join(input.appDataDir, 'Cindy', 'shared-system-skills');+ const manifestPath = path.join(root, '.cindy-system-skills.json');+ const activePath = path.join(root, '.active');+ const initialManifest = fs.readFileSync(manifestPath, 'utf8');+ const initialActiveTarget = fs.readlinkSync(activePath);+ const initialCreatorBytes = fs.realpathSync(initial.descriptors[0]!.absolutePath);+ fs.appendFileSync(path.join(input.source, 'SKILL.md'), '\nCreator v2\n');++ const failed = await prepareBuiltInSkills({+ ...input,+ bundleVersion: BUILT_IN_SKILLS_BUNDLE_VERSION + 1,+ replaceDirectoryEntryAtomically: async (replacement, destination) => {+ expect(replacement).toContain('.active.next-');+ expect(destination).toBe(activePath);+ expect(fs.existsSync(activePath)).toBe(true);+ throw new Error('blocked active pointer switch');+ },+ });++ expect(failed.projectionSafe).toBe(true);+ expect(failed.warnings.join('\n')).toContain('blocked active pointer switch');+ expect(fs.readFileSync(manifestPath, 'utf8')).toBe(initialManifest);+ expect(fs.readlinkSync(activePath)).toBe(initialActiveTarget);+ expect(fs.realpathSync(initial.descriptors[0]!.absolutePath)).toBe(initialCreatorBytes);+ expect(fs.readdirSync(path.join(root, '.versions'))).toEqual([+ JSON.parse(initialManifest).activeBundle,+ ]);+ });++ it('repairs projections left on an unpublished bundle before another activation', async () => {+ const input = fixture();+ const initial = await prepareBuiltInSkills(input);+ const root = path.join(input.appDataDir, 'Cindy', 'shared-system-skills');+ const orphanBundle = 'v10-aaaaaaaaaaaaaaaa-00000000-0000-0000-0000-000000000000';+ const orphanRoot = path.join(root, '.versions', orphanBundle);- fs.cpSync(path.dirname(initial.descriptors[0]!.absolutePath), orphanRoot, { recursive: true });++ // Copy immutable bytes, not the active junction: Windows symlink creation++ // requires privileges, and an alias would not model an unpublished bundle.++ fs.cpSync(path.dirname(initial.descriptors[0]!.absolutePath), orphanRoot, {++ recursive: true,++ dereference: true,++ });++ expect(fs.lstatSync(orphanRoot).isSymbolicLink()).toBe(false);+ const creatorLink = path.join(input.homeDir, '.agents', 'skills', 'cindy-skill-creator');+ fs.unlinkSync(creatorLink);+ fs.symlinkSync(+ path.join(orphanRoot, 'cindy-skill-creator'),+ creatorLink,+ process.platform === 'win32' ? 'junction' : 'dir',+ );+++ expect(fs.realpathSync(creatorLink)).not.toBe(++ fs.realpathSync(initial.descriptors[0]!.absolutePath),++ );+++ const repaired = await prepareBuiltInSkills(input);++ expect(repaired.projectionSafe).toBe(true);+ expect(fs.realpathSync(creatorLink)).toBe(+ fs.realpathSync(initial.descriptors[0]!.absolutePath),+ );+ });++ it('migrates direct current-version links onto the stable active path', async () => {+ const input = fixture();+ const initial = await prepareBuiltInSkills(input);+ const root = path.join(input.appDataDir, 'Cindy', 'shared-system-skills');+ const descriptor = initial.descriptors[0]!;+ const immutableTarget = fs.realpathSync(descriptor.absolutePath);+ const sharedLink = path.join(input.homeDir, '.agents', 'skills', descriptor.name);+ fs.unlinkSync(sharedLink);+ fs.symlinkSync(+ immutableTarget,+ sharedLink,+ process.platform === 'win32' ? 'junction' : 'dir',+ );++ const migrated = await prepareBuiltInSkills(input);++ expect(fs.readlinkSync(sharedLink)).toBe(path.join(root, '.active', descriptor.name));+ expect(fs.realpathSync(sharedLink)).toBe(immutableTarget);+ expect(migrated.changed).toBe(true);+ expect(migrated.warnings).toEqual([]);+ });++ it('removes first-install projections when no bundle was ever activated', async () => {+ const input = fixture();+ const root = path.join(input.appDataDir, 'Cindy', 'shared-system-skills');+ const orphanBundle = 'v8-bbbbbbbbbbbbbbbb-00000000-0000-0000-0000-000000000000';+ const orphanRoot = path.join(root, '.versions', orphanBundle);+ const sharedLink = path.join(input.homeDir, '.agents', 'skills', 'cindy-skill-creator');+ const nativeLink = path.join(input.userDataDir, 'claude-home', 'skills', 'cindy-skill-creator');+ fs.mkdirSync(path.join(orphanRoot, 'cindy-skill-creator'), { recursive: true });+ fs.writeFileSync(+ path.join(orphanRoot, 'cindy-skill-creator', 'SKILL.md'),+ '# Unpublished\n',+ );+ fs.mkdirSync(path.dirname(sharedLink), { recursive: true });+ fs.mkdirSync(path.dirname(nativeLink), { recursive: true });+ fs.symlinkSync(+ path.join(orphanRoot, 'cindy-skill-creator'),+ sharedLink,+ process.platform === 'win32' ? 'junction' : 'dir',+ );+ fs.symlinkSync(sharedLink, nativeLink, process.platform === 'win32' ? 'junction' : 'dir');+ fs.writeFileSync(+ path.join(root, '.cindy-system-skills.json'),+ `${JSON.stringify({ schemaVersion: 2, bundleVersion: 0, fingerprints: {} })}\n`,+ );+ fs.renameSync(+ path.join(input.bundledRoot, 'learn', 'SKILL.md'),+ path.join(input.bundledRoot, 'learn', 'SKILL.md.missing'),+ );++ const recovered = await prepareBuiltInSkills(input);++ expect(recovered.projectionSafe).toBe(false);+ expect(recovered.warnings.join('\n')).toContain('missing SKILL.md');+ expect(fs.existsSync(sharedLink)).toBe(false);+ expect(fs.existsSync(nativeLink)).toBe(false);+ expect(JSON.parse(fs.readFileSync(+ path.join(root, '.cindy-system-skills.json'),+ 'utf8',+ ))).toEqual({ schemaVersion: 2, bundleVersion: 0, fingerprints: {} });+ });++ it('creates a durable empty manifest before publishing the first version', async () => {+ const input = fixture();+ const root = path.join(input.appDataDir, 'Cindy', 'shared-system-skills');+ const manifestPath = path.join(root, '.cindy-system-skills.json');+ const originalRename = fs.renameSync.bind(fs);+ let manifestWrites = 0;+ const rename = vi.spyOn(fs, 'renameSync').mockImplementation((source, destination) => {+ if (String(destination) === manifestPath && String(source).endsWith('.tmp')) {+ manifestWrites += 1;+ if (manifestWrites === 2) throw new Error('blocked first activation');+ }+ originalRename(source, destination);+ });++ const failed = await prepareBuiltInSkills(input);++ expect(failed.changed).toBe(false);+ expect(failed.warnings.join('\n')).toContain('blocked first activation');+ expect(JSON.parse(fs.readFileSync(manifestPath, 'utf8'))).toEqual({+ schemaVersion: 2,+ bundleVersion: 0,+ fingerprints: {},+ });++ rename.mockRestore();+ const retried = await prepareBuiltInSkills(input);+ expect(retried.changed).toBe(true);+ expect(retried.warnings).toEqual([]);+ expect(JSON.parse(fs.readFileSync(manifestPath, 'utf8'))).toMatchObject({+ schemaVersion: 3,+ bundleVersion: BUILT_IN_SKILLS_BUNDLE_VERSION,+ });+ });++ it('keeps a user-owned same-name Skill while retaining the Cindy copy', async () => {+ const input = fixture();+ const userSkill = path.join(input.homeDir, '.agents', 'skills', 'cindy-skill-creator');+ fs.mkdirSync(userSkill, { recursive: true });+ fs.writeFileSync(path.join(userSkill, 'SKILL.md'), '# User copy\n');++ const result = await prepareAndProjectBuiltInSkills(input);+ expect(fs.readFileSync(path.join(userSkill, 'SKILL.md'), 'utf8')).toBe('# User copy\n');+ expect(fs.existsSync(path.join(result.descriptors[0]!.absolutePath, 'SKILL.md'))).toBe(true);+ expect(fs.realpathSync(result.descriptors[0]!.nativeClaudePath)).toBe(+ fs.realpathSync(userSkill),+ );+ expect(result.warnings.join('\n')).toContain('already owned by the user');+ });++ it('keeps every profile on one stable shared copy', async () => {+ const input = fixture();+ const first = await prepareAndProjectBuiltInSkills(input);+ const sharedDescriptor = first.descriptors[0]!;+ const link = path.join(input.homeDir, '.agents', 'skills', 'cindy-skill-creator');+ const nextUserDataDir = path.join(path.dirname(input.userDataDir), 'next-user-data');++ const next = await prepareAndProjectBuiltInSkills({ ...input, userDataDir: nextUserDataDir });+ const nextDescriptor = next.descriptors[0]!;++ expect(next.warnings).toEqual([]);+ expect(next.changed).toBe(true);+ expect(nextDescriptor.absolutePath).toBe(sharedDescriptor.absolutePath);+ expect(fs.realpathSync(link)).toBe(fs.realpathSync(sharedDescriptor.absolutePath));+ expect(fs.realpathSync(nextDescriptor.nativeClaudePath)).toBe(fs.realpathSync(link));+ });++ it('repairs a broken link left by an earlier Cindy profile', async () => {+ const input = fixture();+ const oldProfile = path.join(input.appDataDir, 'CindyDev-dev2-old-checkout');+ const oldTarget = path.join(oldProfile, 'system-skills', 'cindy-skill-creator');+ const link = path.join(input.homeDir, '.agents', 'skills', 'cindy-skill-creator');+ fs.mkdirSync(path.dirname(link), { recursive: true });+ fs.symlinkSync(oldTarget, link, process.platform === 'win32' ? 'junction' : 'dir');++ const result = await prepareAndProjectBuiltInSkills(input);++ expect(result.warnings).toEqual([]);+ expect(fs.realpathSync(link)).toBe(fs.realpathSync(result.descriptors[0]!.absolutePath));+ });++ it('does not mutate shared Skill paths when the cross-process lease is unavailable', async () => {+ const input = fixture();+ const result = await prepareBuiltInSkills({+ ...input,+ withSharedMutation: async () => undefined,+ });++ expect(result.changed).toBe(false);+ expect(result.warnings.join('\n')).toContain('another Skill mutation is in progress');+ expect(result.descriptors).toEqual([]);+ expect(fs.existsSync(path.join(input.appDataDir, 'Cindy', 'shared-system-skills', '.active'))).toBe(false);+ expect(fs.existsSync(path.join(input.homeDir, '.agents', 'skills', 'cindy-skill-creator'))).toBe(false);+ });++ it('does not activate app-owned bytes until home and Claude projections are ready', async () => {+ const input = fixture();+ const result = await prepareBuiltInSkills(input);++ expect(fs.existsSync(result.descriptors[0]!.absolutePath)).toBe(true);+ expect(fs.realpathSync(path.join(+ input.homeDir,+ '.agents',+ 'skills',+ 'cindy-skill-creator',+ ))).toBe(fs.realpathSync(result.descriptors[0]!.absolutePath));+ expect(fs.realpathSync(result.descriptors[0]!.nativeClaudePath)).toBe(+ fs.realpathSync(result.descriptors[0]!.absolutePath),+ );+ });++ it('waits a bounded interval for another profile to finish materialization', async () => {+ const input = fixture();+ let waitMs: number | undefined;+ const result = await prepareBuiltInSkills({+ ...input,+ withSharedMutation: async (_names, operation, options) => {+ waitMs = options?.waitMs;+ return operation();+ },+ });++ expect(waitMs).toBe(5_000);+ expect(result.warnings).toEqual([]);+ expect(fs.existsSync(result.descriptors[0]!.absolutePath)).toBe(true);+ });++ it('keeps a user-owned same-name symlink', async () => {+ const input = fixture();+ const userSource = path.join(path.dirname(input.homeDir), 'user-skill');+ const userSkill = path.join(input.homeDir, '.agents', 'skills', 'cindy-skill-creator');+ fs.mkdirSync(userSource, { recursive: true });+ fs.mkdirSync(path.dirname(userSkill), { recursive: true });+ fs.writeFileSync(path.join(userSource, 'SKILL.md'), '# User symlink copy\n');+ fs.symlinkSync(userSource, userSkill, process.platform === 'win32' ? 'junction' : 'dir');++ const result = await prepareAndProjectBuiltInSkills(input);++ expect(fs.realpathSync(userSkill)).toBe(fs.realpathSync(userSource));+ expect(result.warnings.join('\n')).toContain('already owned by the user');+ });++ it('keeps a user-owned Skill in the isolated Claude config directory', async () => {+ const input = fixture();+ const nativeClaudePath = path.join(input.userDataDir, 'claude-home', 'skills', 'cindy-skill-creator');+ fs.mkdirSync(nativeClaudePath, { recursive: true });+ fs.writeFileSync(path.join(nativeClaudePath, 'SKILL.md'), '# Claude user copy\n');++ const result = await prepareAndProjectBuiltInSkills(input);+ expect(fs.readFileSync(path.join(nativeClaudePath, 'SKILL.md'), 'utf8')).toBe(+ '# Claude user copy\n',+ );+ expect(result.warnings.join('\n')).toContain('already owned by the user');+ });++ it('refreshes the isolated Claude runtime when the palette winner changes', async () => {+ const input = fixture();+ const first = await prepareAndProjectBuiltInSkills(input);+ const descriptor = first.descriptors.find((item) => item.name === 'learn')!;+ const sharedSkill = path.join(input.homeDir, '.agents', 'skills', 'learn');+ expect(fs.realpathSync(descriptor.nativeClaudePath)).toBe(fs.realpathSync(sharedSkill));++ const claudePaletteSkill = path.join(input.homeDir, '.claude', 'skills', 'learn');+ fs.mkdirSync(claudePaletteSkill, { recursive: true });+ fs.writeFileSync(path.join(claudePaletteSkill, 'SKILL.md'), '# User Claude Learn\n');++ const updated = await refreshBuiltInClaudeSkillLinks({+ ...input,+ descriptors: first.descriptors,+ });++ expect(updated.warnings).toEqual([]);+ expect(fs.realpathSync(sharedSkill)).toBe(fs.realpathSync(descriptor.absolutePath));+ expect(fs.realpathSync(descriptor.nativeClaudePath)).toBe(+ fs.realpathSync(claudePaletteSkill),+ );++ fs.rmSync(claudePaletteSkill, { recursive: true, force: true });+ const restored = await refreshBuiltInClaudeSkillLinks({+ ...input,+ descriptors: first.descriptors,+ });++ expect(restored.warnings).toEqual([]);+ expect(fs.realpathSync(descriptor.nativeClaudePath)).toBe(fs.realpathSync(sharedSkill));+ });++ it('attests only commands backed by the materialized Cindy copy', async () => {+ const input = fixture();+ const { descriptors } = await prepareBuiltInSkills(input);+ const bundledSkill = path.join(descriptors[0]!.absolutePath, 'SKILL.md');+ const userCopy = path.join(input.homeDir, 'user-copy', 'SKILL.md');+ fs.mkdirSync(path.dirname(userCopy), { recursive: true });+ fs.writeFileSync(userCopy, '# User copy\n');++ const [official, spoofed] = markCindyBuiltInAgentSkills([+ {+ kind: 'agent-skill', name: 'cindy-skill-creator', source: 'skill',+ path: bundledSkill, scope: 'user', enabled: true,+ },+ {+ kind: 'agent-skill', name: 'cindy-skill-creator', source: 'skill',+ description: 'Create or update a Cindy Skill', path: userCopy,+ scope: 'user', enabled: true, builtIn: true,+ },+ ], descriptors);++ expect(official?.builtIn).toBe(true);+ expect(spoofed?.builtIn).toBeUndefined();+ });++ it('removes disabled Cindy built-ins from the Agent roster without hiding user collisions', async () => {+ const input = fixture();+ const { descriptors } = await prepareBuiltInSkills(input);+ const descriptor = descriptors[0]!;+ const userCopy = path.join(input.homeDir, 'user-copy', 'SKILL.md');+ fs.mkdirSync(path.dirname(userCopy), { recursive: true });+ fs.writeFileSync(userCopy, '# User copy\n');++ const skills = activeCindyBuiltInAgentSkills([+ {+ kind: 'agent-skill', name: descriptor.name, source: 'skill',+ path: path.join(descriptor.absolutePath, 'SKILL.md'), scope: 'user', enabled: true,+ },+ {+ kind: 'agent-skill', name: descriptor.name, source: 'skill',+ path: userCopy, scope: 'user', enabled: true,+ },+ ], descriptors, (source) => source !== descriptor.absolutePath);++ expect(skills).toHaveLength(1);+ expect(skills[0]?.path).toBe(userCopy);+ expect(skills[0]?.builtIn).toBeUndefined();+ });++ it('resolves source and packaged resource roots', () => {+ expect(+ resolveBundledSystemSkillsRoot({+ isPackaged: false,+ appPath: '/repo/apps/desktop',+ resourcesPath: '/app/resources',+ }),+ ).toBe(path.join('/repo/apps/desktop', 'resources', 'system-skills'));+ expect(+ resolveBundledSystemSkillsRoot({+ isPackaged: true,+ appPath: '/repo/apps/desktop',+ resourcesPath: '/app/resources',+ }),+ ).toBe(path.join('/app/resources', 'system-skills'));+ });+ });diff --cc apps/desktop/src/renderer/__tests__/botGroupLampRendering.test.tsxindex 685daad20d,0de8971320..608c5f3482--- a/apps/desktop/src/renderer/__tests__/botGroupLampRendering.test.tsx+++ b/apps/desktop/src/renderer/__tests__/botGroupLampRendering.test.tsx@@@ -85,7 -85,7 +85,7 @@@ function activity(phase: typeof phases[}describe.each([false, true])('Bot groups with device grouping %s', (groupDevice) => {- it.each(phases)('renders the collapsed Bot header lamp for remote %s', (phase) => {- it.each(phases)('renders the Bot header indicator for remote %s', (phase) => {++ it.each(phases)('renders the collapsed Bot header indicator for remote %s', (phase) => {activity(phase);render(<ProjectsSection {...props(groupDevice)} />);expect(Boolean(screen.queryByText('Remote device'))).toBe(groupDevice);diff --cc apps/desktop/src/renderer/components/cindy-make/CindyMakeHistoryPanel.tsxindex e832773202,0a1f5cf5d0..c11197e15a--- a/apps/desktop/src/renderer/components/cindy-make/CindyMakeHistoryPanel.tsx+++ b/apps/desktop/src/renderer/components/cindy-make/CindyMakeHistoryPanel.tsx@@@ -247,7 -164,7 +247,15 @@@ export function CindyMakeHistoryPanel(const next = await window.electronAPI.actCindyMakeHistory(selected.runId, action);if (!isDataOwnerGenerationCurrent(owner)) return;update(next);-- if (action === 'continue') navigate('/cc-agent/' + selected.sessionId);++ if (action === 'continue')++ navigate('/cc-agent/' + selected.sessionId, {++ state: {++ cindyMakeEditing: {++ sessionId: selected.sessionId,++ completionId: selected.completionId,++ },++ },++ });if (action === 'resolve') {const session = next.items.find((item) => item.runId === selected.runId,diff --cc apps/desktop/src/renderer/components/cindy-make/__tests__/CindyMakeHistoryPanel.test.tsxindex 6dbde3182f,b617aa98cc..ed9ccfcf22--- a/apps/desktop/src/renderer/components/cindy-make/__tests__/CindyMakeHistoryPanel.test.tsx+++ b/apps/desktop/src/renderer/components/cindy-make/__tests__/CindyMakeHistoryPanel.test.tsx@@@ -256,50 -185,9 +256,63 @@@ describe('Make history controls', () =screen.queryByRole('button', { name: 'cindyMake.history.actions.integrate' }),).toBeNull();expect(screen.queryByRole('button', { name: 'cindyMake.history.actions.reapply' })).toBeNull();- expect(screen.queryByRole('button', { name: 'cindyMake.history.actions.open' })).toBeNull();+ expect(screen.getByRole('button', { name: 'cindyMake.history.actions.open' })).toBeTruthy();+ expect(screen.getByRole('button', { name: 'cindyMake.history.actions.test' })).toBeTruthy();+ expect(screen.getByRole('button', { name: 'cindyMake.history.actions.build' })).toBeTruthy();+ expect(screen.getAllByText(/cindyMake.history.versionPending/)).toHaveLength(2);expect(screen.getByText('cindyMake.history.needsBuild')).toBeTruthy();});++ it('hands off the selected completion only after Main accepts Continue Editing', async () => {++ const f = harness([item({ completionId: 'done-a' })]);++ render(<CindyMakeHistoryPanel />);++ fireEvent.click(++ await screen.findByRole('button', { name: 'cindyMake.history.actions.continue' }),++ );++ await waitFor(() =>++ expect(h.navigate).toHaveBeenCalledWith('/cc-agent/task-a', {++ state: { cindyMakeEditing: { sessionId: 'task-a', completionId: 'done-a' } },++ }),++ );++ expect(f.execute).toHaveBeenCalledWith('aaaa', 'continue');++ });+ it('opens an active task and keeps it available in the sidebar', async () => {+ const f = harness([item({ actions: ['open'] })]);+ render(<CindyMakeHistoryPanel />);+ fireEvent.click(await screen.findByRole('button', { name: 'cindyMake.history.actions.open' }));+ await waitFor(() => expect(h.navigate).toHaveBeenCalledWith('/cc-agent/task-a'));+ expect(h.get).toHaveBeenCalledWith('task-a');+ expect(h.restore).not.toHaveBeenCalled();+ expect(h.prepend).toHaveBeenCalledWith(expect.objectContaining({ id: 'task-a' }));+ expect(f.execute).not.toHaveBeenCalled();+ });+ it('restores an archived task before navigating to it', async () => {+ const archived = {+ id: 'task-a',+ status: 'archived',+ workingDir: '/make/task-a',+ workspaceKind: 'project',+ remoteHostId: null,+ };+ h.get.mockResolvedValue(archived);+ let resolve!: (value: typeof archived & { status: 'active' }) => void;+ h.restore.mockImplementation(+ () =>+ new Promise((done) => {+ resolve = done;+ }),+ );+ const f = harness([item({ actions: ['open'] })]);+ render(<CindyMakeHistoryPanel />);+ fireEvent.click(await screen.findByRole('button', { name: 'cindyMake.history.actions.open' }));+ await waitFor(() => expect(h.restore).toHaveBeenCalledWith('task-a', archived));+ expect(h.navigate).not.toHaveBeenCalled();+ await act(async () => resolve({ ...archived, status: 'active' }));+ expect(h.prepend).toHaveBeenCalledWith(+ expect.objectContaining({ id: 'task-a', status: 'active' }),+ );+ expect(h.navigate).toHaveBeenCalledWith('/cc-agent/task-a');+ expect(f.execute).not.toHaveBeenCalled();+ });it('retains finished history and exposes retained undo without edit, test, or repeated cleanup actions', async () => {harness([item({diff --cc apps/desktop/src/renderer/components/cindy-make/__tests__/useCindyMakeEditing.test.tsxindex 0000000000,0000000000..f2fd27e3ebnew file mode 100644--- /dev/null+++ b/apps/desktop/src/renderer/components/cindy-make/__tests__/useCindyMakeEditing.test.tsx@@@ -1,0 -1,0 +1,94 @@@++// @vitest-environment jsdom++import { cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react';++import { afterEach, expect, it } from 'vitest';++import { MemoryRouter, useLocation } from 'react-router-dom';++import type { ChatMessage } from '@/lib/makerChatStore';++import { getCindyMakeTestRecovery } from '@/lib/cindyMakeComposer';++import { useCindyMakeEditing } from '../useCindyMakeEditing';++++afterEach(cleanup);++const completion: ChatMessage = {++ clientId: 'completion',++ role: 'assistant',++ content: '',++ systemCardType: 'cindy-make-complete',++ systemCardData: { reportedAt: 123, continuedAt: 456, commit: 'a'.repeat(40) },++};++const intent = { sessionId: 'task', completionId: completion.clientId };++function Visit({ messages, enabled = true }: { messages: ChatMessage[]; enabled?: boolean }) {++ const { dismissedId, continueEditing } = useCindyMakeEditing('task', enabled);++ const location = useLocation();++ const recovery = getCindyMakeTestRecovery({++ session: { id: 'task', source: 'cindy-make', status: 'active', clearedAt: null },++ messages,++ busy: false,++ historyLoaded: true,++ dismissedId,++ });++ return (++ <>++ <output data-testid="composer">{recovery ?? 'input'}</output>++ <output data-testid="navigation">{JSON.stringify(location.state)}</output>++ <button onClick={() => continueEditing(recovery!)}>continue</button>++ </>++ );++}++++it('opens input on a History continuation, consumes the intent, and recovers the next turn', async () => {++ const view = (messages: ChatMessage[]) => (++ <MemoryRouter++ initialEntries={[++ {++ pathname: '/cc-agent/task',++ state: { cindyMakeEditing: intent, from: 'history' },++ },++ ]}++ >++ <Visit messages={messages} />++ </MemoryRouter>++ );++ const result = render(view([completion]));++ expect(screen.getByTestId('composer').textContent).toBe('input');++ await waitFor(() =>++ expect(screen.getByTestId('navigation').textContent).toBe('{"from":"history"}'),++ );++ const messages: ChatMessage[] = [++ completion,++ { clientId: 'request', role: 'user', content: 'edit again' },++ { clientId: 'next', role: 'assistant', content: 'Done', turnCompleted: true },++ ];++ result.rerender(view(messages));++ expect(screen.getByTestId('composer').textContent).toBe('next');++ fireEvent.click(screen.getByText('continue'));++ expect(screen.getByTestId('composer').textContent).toBe('input');++ // A new visit has no stored intent: unfinished testing is recoverable again.++ result.unmount();++ render(++ <MemoryRouter initialEntries={['/cc-agent/task']}>++ <Visit messages={[completion]} />++ </MemoryRouter>,++ );++ expect(screen.getByTestId('composer').textContent).toBe('completion');++});++++it.each([++ [{ ...intent, sessionId: 'another-task' }, true],++ [intent, false],++] as const)(++ 'does not apply another task or remote/read-only editing intent',++ (cindyMakeEditing, enabled) => {++ render(++ <MemoryRouter++ initialEntries={[++ {++ pathname: '/cc-agent/task',++ state: { cindyMakeEditing },++ },++ ]}++ >++ <Visit messages={[completion]} enabled={enabled} />++ </MemoryRouter>,++ );++ expect(screen.getByTestId('composer').textContent).toBe('completion');++ },++);diff --cc apps/desktop/src/renderer/components/cindy-make/useCindyMakeEditing.tsindex 0000000000,0000000000..c98c2fd07bnew file mode 100644--- /dev/null+++ b/apps/desktop/src/renderer/components/cindy-make/useCindyMakeEditing.ts@@@ -1,0 -1,0 +1,34 @@@++import { useEffect, useState } from 'react';++import { useLocation, useNavigate } from 'react-router-dom';++++/** Carry an explicit History → Continue choice into this visit, then consume it. */++export function useCindyMakeEditing(sessionId: string | undefined, enabled: boolean) {++ const location = useLocation();++ const navigate = useNavigate();++ const [editing, setEditing] = useState<{ sessionId: string; messageId: string }>();++ const intent = location.state?.cindyMakeEditing;++ const navigationId =++ enabled &&++ sessionId &&++ intent?.sessionId === sessionId &&++ typeof intent.completionId === 'string' &&++ intent.completionId.length > 0++ ? intent.completionId++ : undefined;++ useEffect(() => {++ if (!sessionId || !navigationId) return;++ setEditing({ sessionId, messageId: navigationId });++ navigate(`${location.pathname}${location.search}`, {++ replace: true,++ state: { ...location.state, cindyMakeEditing: undefined },++ });++ }, [sessionId, navigationId, location.pathname, location.search, location.state, navigate]);++ return {++ dismissedId: enabled++ ? (navigationId ?? (editing?.sessionId === sessionId ? editing?.messageId : undefined))++ : undefined,++ continueEditing: (messageId: string) => {++ if (enabled && sessionId) setEditing({ sessionId, messageId });++ },++ };++}diff --cc apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsxindex dfbb79bfd1,51ae9c207d..65bcb5b5cb--- a/apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx+++ b/apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx@@@ -62,14 -63,10 +63,16 @@@ import { setRemoteReceiptDisplayReadyimport { shortSessionId } from '@/lib/sessionId';import { ChatInput } from '@/components/new-chat/ChatInput';import { CindyMakeComposerMask } from '@/components/cindy-make/CindyMakeComposerMask';-import { getCindyMakeComposerPhase, getCindyMakePendingTest, getCindyMakePreparation } from '@/lib/cindyMakeComposer';+import {+ getCindyMakeTestRecovery,+ getCindyMakeComposerPhase,+ getCindyMakePendingTest,+ getCindyMakePreparation,+} from '@/lib/cindyMakeComposer';import { CindyMakeTestCard } from '@/components/cindy-make/CindyMakeTestCard';++import { useCindyMakeEditing } from '@/components/cindy-make/useCindyMakeEditing';import { useCindyMakeState } from '@/lib/cindyMakeState';+ import { resolveLearnDesktopCommandFeedback } from '@/features/learn/desktopCommandFeedback';import { GoalIndicator } from '@/components/new-chat/GoalIndicator';import { PinnedPlanPanel } from '@/components/new-chat/PinnedPlanPanel';import { sessionsStore } from '@/lib/sessionsStore';@@@ -1804,29 -1802,6 +1808,23 @@@ export function CCAgentSessionView(? getCindyMakePendingTest({ session, messages, busy: isAgentBusy }) : null,[session, messages, isAgentBusy, remoteDeviceId, readOnly],);- const [cindyMakeEditing, setCindyMakeEditing] = useState<{- sessionId: string;- messageId: string;- }>();++ const cindyMakeEditing = useCindyMakeEditing(sessionId, !remoteDeviceId && !readOnly);+ const cindyMakeRecoveryId =+ !remoteDeviceId &&+ !readOnly &&+ !pendingQueue.length &&+ typeof window.electronAPI.cindyMakeTest === 'function'+ ? getCindyMakeTestRecovery({+ session,+ messages,+ busy: isAgentBusy,+ historyLoaded,- dismissedId:- cindyMakeEditing && cindyMakeEditing.sessionId === sessionId- ? cindyMakeEditing.messageId- : undefined,++ dismissedId: cindyMakeEditing.dismissedId,+ })+ : null;+ const cindyMakeInputLocked = Boolean(+ cindyMakeComposerPhase || cindyMakePendingTest || cindyMakeRecoveryId,+ );useEffect(() => {if (!sessionId || !isOrcaLeadSessionView || !historyLoaded) return;const recoveredAssignment = getRecoverableDeferredUiAssignment({@@@ -5245,9 -5206,6 +5236,9 @@@sessionId={sessionId}completionId={cindyMakePendingTest.completionId}meta={cindyMakePendingTest.meta}+ onContinue={() =>- setCindyMakeEditing({ sessionId, messageId: cindyMakePendingTest.completionId })++ cindyMakeEditing.continueEditing(cindyMakePendingTest.completionId)+ }/>) : worktreePreparing && smoothedBranchName ? (<WorktreeCreatingOverlay branchName={smoothedBranchName} />@@@ -5257,25 -5215,6 +5248,25 @@@barWidth={inputWidth}getContentWidth={getMessageWidth}/>+ ) : cindyMakeRecoveryId && session ? (+ <CindyMakeTestCard+ key={`${session.id}:${cindyMakeRecoveryId}`}+ sessionId={session.id}+ recovery={{+ onContinue: () =>- setCindyMakeEditing({ sessionId: session.id, messageId: cindyMakeRecoveryId }),++ cindyMakeEditing.continueEditing(cindyMakeRecoveryId),+ onCheck: () =>+ handleSend(+ t('cindyMake.test.resume.request'),+ session.model,+ session.effort as Effort,+ session.permissionMode as PermissionMode,+ undefined,+ undefined,+ { cindyMakeRecovery: true },+ ),+ }}+ />) : (<ChatInputonSend={handleSend}diff --cc docs/design-rules/design-inventory.mdindex 15ab14839f,66e24fd29f..90a8e34319--- a/docs/design-rules/design-inventory.md+++ b/docs/design-rules/design-inventory.md@@@ -38,13 -38,13 +38,13 @@@| `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 | 47 | 0 | 79 |-| `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/DialogueDirectorySection.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/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/dialogueDirectoryDisplay.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 | 719 |+| `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/DialogueDirectorySection.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/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/dialogueDirectoryDisplay.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 | 716 || `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 | 295 || `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 | 63 |- | `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 | 61 |+ | `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/OfficialSkillBadge.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 | 53 | 0 | 62 || `desktop.window.computer-permission-guide` | desktop | 电脑使用权限引导 | `?view=computer-permission-guide` → ComputerPermissionGuideWindow;backdrop 同文件 | ComputerPermissionBackdrop, ComputerPermissionGuideWindow | apps/desktop/src/main/computer-permission-guide/MacComputerPermissionGuideNativeHost.ts, apps/desktop/src/main/computer-permission-guide/placement.ts, apps/desktop/src/main/computer-permission-guide/request.ts, apps/desktop/src/main/computer-permission-guide/switch-target.ts, apps/desktop/src/main/computer-permission-guide/window.ts, apps/desktop/src/renderer/components/settings/ComputerPermissionGuideWindow.tsx | 7 | 2 | 9 || `desktop.window.ghost-panel` | desktop | 插件面板独立窗口 | `?ghostPanelWindow=<id>` → renderer/ghost-panel-window-entry.tsx;hash `/ghost-panel-window` | GhostPanelWindowLayout | apps/desktop/src/main/ghost-panel-window/controller.ts, apps/desktop/src/main/ghost-panel-window/ipc.ts, apps/desktop/src/main/ghost-panel-window/registry.ts, apps/desktop/src/main/ghost-panel-window/settings-store.ts, apps/desktop/src/main/ghost-panel-window/window.ts, apps/desktop/src/renderer/components/layout/GhostPanelWindowLayout.tsx, apps/desktop/src/renderer/ghost-panel-window-entry.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 63 | 38 | 14 |- | `desktop.window.remote-desktop` | desktop | 远程桌面独立窗口 | `?remoteDesktopViewer=1` → renderer/remote-desktop-viewer-entry.tsx | Button, ConfirmDialog, FormField, RemoteDesktopViewerWindow, Select | apps/desktop/src/main/remote-desktop-viewer/connection.ts, apps/desktop/src/main/remote-desktop-viewer/registry.ts, apps/desktop/src/main/remote-desktop-viewer/windows.ts, apps/desktop/src/renderer/components/ui/button.tsx, apps/desktop/src/renderer/components/ui/confirm-dialog.tsx, apps/desktop/src/renderer/components/ui/form-field.tsx, apps/desktop/src/renderer/components/ui/select.tsx, apps/desktop/src/renderer/features/remote-desktop/RemoteDesktopViewerWindow.tsx, apps/desktop/src/renderer/features/remote-desktop/viewerWindow.css, apps/desktop/src/renderer/remote-desktop-viewer-entry.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 103 | 36 | 26 |+ | `desktop.window.remote-desktop` | desktop | 远程桌面独立窗口 | `?remoteDesktopViewer=1` → renderer/remote-desktop-viewer-entry.tsx | Button, ConfirmDialog, FormField, Popover, RemoteDesktopViewerWindow, Select, Switch, Tip | apps/desktop/src/main/remote-desktop-viewer/connection.ts, apps/desktop/src/main/remote-desktop-viewer/credentials.ts, apps/desktop/src/main/remote-desktop-viewer/preferences.ts, apps/desktop/src/main/remote-desktop-viewer/registry.ts, apps/desktop/src/main/remote-desktop-viewer/safety.ts, apps/desktop/src/main/remote-desktop-viewer/windows.ts, apps/desktop/src/renderer/components/ui/button.tsx, apps/desktop/src/renderer/components/ui/confirm-dialog.tsx, apps/desktop/src/renderer/components/ui/form-field.tsx, apps/desktop/src/renderer/components/ui/popover.tsx, apps/desktop/src/renderer/components/ui/select.tsx, apps/desktop/src/renderer/components/ui/switch.tsx, apps/desktop/src/renderer/components/ui/tooltip.tsx, apps/desktop/src/renderer/features/remote-desktop/RemoteDesktopViewerWindow.tsx, apps/desktop/src/renderer/features/remote-desktop/viewerWindow.css, apps/desktop/src/renderer/remote-desktop-viewer-entry.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 114 | 36 | 34 || `desktop.window.resource-usage` | desktop | 资源用量窗口 | `?resourceUsageWindow=1` → renderer/resource-usage-entry.tsx(不走 router.tsx) | ResourceUsageWindowLayout, ResourceUsageWindowRoot | apps/desktop/src/main/resource-usage-window/controller.ts, apps/desktop/src/main/resource-usage-window/ipc.ts, apps/desktop/src/main/resource-usage-window/open-sender.ts, apps/desktop/src/main/resource-usage-window/registry.ts, apps/desktop/src/main/resource-usage-window/window.ts, apps/desktop/src/renderer/components/resource-usage/ResourceUsageWindowLayout.tsx, apps/desktop/src/renderer/resource-usage-entry.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 63 | 38 | 14 || `desktop.window.review-artifact-confirm` | desktop | Review 成果确认窗 | main/reviewer/reviewArtifactConfirmWindow.ts 内联 HTML/CSS(不走 renderer 路由) | reviewArtifactConfirmWindow | apps/desktop/src/main/reviewer/reviewArtifactConfirmWindow.ts | 8 | 18 | 2 || `desktop.window.session-drag-preview` | desktop | 会话拖拽预览 | main/session-drag-preview.ts 透明预览窗 | session-drag-preview | apps/desktop/src/main/session-drag-preview.ts | 0 | 1 | 0 |