Skip to content

armgit / cindy

Public Imported from GitHub
0

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

Merge origin/main and resolve integration regressions

Lizi6db9b508a798
diff --cc apps/desktop/native/windows-atomic-rename/main.rs
index 0000000000,041366f9dc..ab9cb2873e
mode 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.mjs
index 0000000000,7f4d39f1fd..f5932b27d4
mode 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.ts
index 0000000000,1c917bb3f3..ec0e3c7f9d
mode 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.tsx
index 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.tsx
index 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.tsx
index 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.tsx
index 0000000000,0000000000..f2fd27e3eb
new 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.ts
index 0000000000,0000000000..c98c2fd07b
new 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.tsx
index 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 { setRemoteReceiptDisplayReady
import { 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 },
+ ),
+ }}
+ />
) : (
<ChatInput
onSend={handleSend}
diff --cc docs/design-rules/design-inventory.md
index 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 |