From 96f6d2c7d5a0ec04d555456f2cf44a01a44d4dc0 Mon Sep 17 00:00:00 2001 From: unraid Date: Sun, 5 Apr 2026 21:07:38 +0800 Subject: [PATCH 1/2] feat: enable SHOT_STATS, PROMPT_CACHE_BREAK_DETECTION, TOKEN_BUDGET feature flags Enable 3 verified compile-only feature flags in build.ts and dev.ts defaults: - SHOT_STATS: local shot distribution statistics in /stats panel - PROMPT_CACHE_BREAK_DETECTION: internal cache key change diagnostics - TOKEN_BUDGET: support +500k syntax for minimum output token targets All 3 flags verified by 6 parallel sub-agents + independent Codex CLI review. Build passes (475 files), zero new test failures. Also adds: - docs/features/feature-flags-codex-review.md: Codex review findings - Marks all enabled flags in feature-flags-audit-complete.md - Adds openai dependency (needed for OpenAI compat layer) --- build.ts | 109 +- bun.lock | 34 +- docs/feature-flags-audit-complete.md | 2008 +++++++++++++++++ docs/features/feature-flags-audit-complete.md | 2008 +++++++++++++++++ docs/features/feature-flags-codex-review.md | 160 ++ package.json | 2 +- scripts/dev.ts | 2 +- 7 files changed, 4244 insertions(+), 79 deletions(-) create mode 100644 docs/feature-flags-audit-complete.md create mode 100644 docs/features/feature-flags-audit-complete.md create mode 100644 docs/features/feature-flags-codex-review.md diff --git a/build.ts b/build.ts index 203fc23d9..b22b327ab 100644 --- a/build.ts +++ b/build.ts @@ -1,81 +1,88 @@ -import { readdir, readFile, writeFile, cp } from "fs/promises"; -import { join } from "path"; -import { getMacroDefines } from "./scripts/defines.ts"; +import { readdir, readFile, writeFile, cp } from 'fs/promises' +import { join } from 'path' +import { getMacroDefines } from './scripts/defines.ts' -const outdir = "dist"; +const outdir = 'dist' // Step 1: Clean output directory -const { rmSync } = await import("fs"); -rmSync(outdir, { recursive: true, force: true }); +const { rmSync } = await import('fs') +rmSync(outdir, { recursive: true, force: true }) // Default features that match the official CLI build. // Additional features can be enabled via FEATURE_=1 env vars. -const DEFAULT_BUILD_FEATURES = ["AGENT_TRIGGERS_REMOTE", "CHICAGO_MCP", "VOICE_MODE"]; +const DEFAULT_BUILD_FEATURES = [ + 'AGENT_TRIGGERS_REMOTE', + 'CHICAGO_MCP', + 'VOICE_MODE', + 'SHOT_STATS', + 'PROMPT_CACHE_BREAK_DETECTION', + 'TOKEN_BUDGET', +] // Collect FEATURE_* env vars → Bun.build features const envFeatures = Object.keys(process.env) - .filter(k => k.startsWith("FEATURE_")) - .map(k => k.replace("FEATURE_", "")); -const features = [...new Set([...DEFAULT_BUILD_FEATURES, ...envFeatures])]; + .filter(k => k.startsWith('FEATURE_')) + .map(k => k.replace('FEATURE_', '')) +const features = [...new Set([...DEFAULT_BUILD_FEATURES, ...envFeatures])] // Step 2: Bundle with splitting const result = await Bun.build({ - entrypoints: ["src/entrypoints/cli.tsx"], - outdir, - target: "bun", - splitting: true, - define: getMacroDefines(), - features, -}); + entrypoints: ['src/entrypoints/cli.tsx'], + outdir, + target: 'bun', + splitting: true, + define: getMacroDefines(), + features, +}) if (!result.success) { - console.error("Build failed:"); - for (const log of result.logs) { - console.error(log); - } - process.exit(1); + console.error('Build failed:') + for (const log of result.logs) { + console.error(log) + } + process.exit(1) } // Step 3: Post-process — replace Bun-only `import.meta.require` with Node.js compatible version -const files = await readdir(outdir); -const IMPORT_META_REQUIRE = "var __require = import.meta.require;"; -const COMPAT_REQUIRE = `var __require = typeof import.meta.require === "function" ? import.meta.require : (await import("module")).createRequire(import.meta.url);`; +const files = await readdir(outdir) +const IMPORT_META_REQUIRE = 'var __require = import.meta.require;' +const COMPAT_REQUIRE = `var __require = typeof import.meta.require === "function" ? import.meta.require : (await import("module")).createRequire(import.meta.url);` -let patched = 0; +let patched = 0 for (const file of files) { - if (!file.endsWith(".js")) continue; - const filePath = join(outdir, file); - const content = await readFile(filePath, "utf-8"); - if (content.includes(IMPORT_META_REQUIRE)) { - await writeFile( - filePath, - content.replace(IMPORT_META_REQUIRE, COMPAT_REQUIRE), - ); - patched++; - } + if (!file.endsWith('.js')) continue + const filePath = join(outdir, file) + const content = await readFile(filePath, 'utf-8') + if (content.includes(IMPORT_META_REQUIRE)) { + await writeFile( + filePath, + content.replace(IMPORT_META_REQUIRE, COMPAT_REQUIRE), + ) + patched++ + } } console.log( - `Bundled ${result.outputs.length} files to ${outdir}/ (patched ${patched} for Node.js compat)`, -); + `Bundled ${result.outputs.length} files to ${outdir}/ (patched ${patched} for Node.js compat)`, +) // Step 4: Copy native .node addon files (audio-capture) -const vendorDir = join(outdir, "vendor", "audio-capture"); -await cp("vendor/audio-capture", vendorDir, { recursive: true }); -console.log(`Copied vendor/audio-capture/ → ${vendorDir}/`); +const vendorDir = join(outdir, 'vendor', 'audio-capture') +await cp('vendor/audio-capture', vendorDir, { recursive: true }) +console.log(`Copied vendor/audio-capture/ → ${vendorDir}/`) // Step 5: Bundle download-ripgrep script as standalone JS for postinstall const rgScript = await Bun.build({ - entrypoints: ["scripts/download-ripgrep.ts"], - outdir, - target: "node", -}); + entrypoints: ['scripts/download-ripgrep.ts'], + outdir, + target: 'node', +}) if (!rgScript.success) { - console.error("Failed to bundle download-ripgrep script:"); - for (const log of rgScript.logs) { - console.error(log); - } - // Non-fatal — postinstall fallback to bun run scripts/download-ripgrep.ts + console.error('Failed to bundle download-ripgrep script:') + for (const log of rgScript.logs) { + console.error(log) + } + // Non-fatal — postinstall fallback to bun run scripts/download-ripgrep.ts } else { - console.log(`Bundled download-ripgrep script to ${outdir}/`); + console.log(`Bundled download-ripgrep script to ${outdir}/`) } diff --git a/bun.lock b/bun.lock index 5f53002de..af8cd232e 100644 --- a/bun.lock +++ b/bun.lock @@ -89,7 +89,7 @@ "lru-cache": "^11.2.7", "marked": "^17.0.5", "modifiers-napi": "workspace:*", - "openai": "^4.73.0", + "openai": "^6.33.0", "p-map": "^7.0.4", "picomatch": "^4.0.4", "plist": "^3.1.0", @@ -742,8 +742,6 @@ "@types/node": ["@types/node@25.5.0", "https://registry.npmmirror.com/@types/node/-/node-25.5.0.tgz", { "dependencies": { "undici-types": "~7.18.0" } }, "sha512-jp2P3tQMSxWugkCUKLRPVUpGaL5MVFwF8RDuSRztfwgN1wmqJeMSbKlnEtQqU8UrhTmzEmZdu2I6v2dpp7XIxw=="], - "@types/node-fetch": ["@types/node-fetch@2.6.13", "https://registry.npmmirror.com/@types/node-fetch/-/node-fetch-2.6.13.tgz", { "dependencies": { "@types/node": "*", "form-data": "^4.0.4" } }, "sha512-QGpRVpzSaUs30JBSGPjOg4Uveu384erbHBoT1zeONvyCfwQxIkUshLAOqN/k9EjGviPRmWTTe6aH2qySWKTVSw=="], - "@types/pg": ["@types/pg@8.15.6", "https://registry.npmmirror.com/@types/pg/-/pg-8.15.6.tgz", { "dependencies": { "@types/node": "*", "pg-protocol": "*", "pg-types": "^2.2.0" } }, "sha512-NoaMtzhxOrubeL/7UZuNTrejB4MPAJ0RpxZqXQf2qXuVlTPuG6Y8p4u9dKRaue4yjmC7ZhzVO2/Yyyn25znrPQ=="], "@types/pg-pool": ["@types/pg-pool@2.0.7", "https://registry.npmmirror.com/@types/pg-pool/-/pg-pool-2.0.7.tgz", { "dependencies": { "@types/pg": "*" } }, "sha512-U4CwmGVQcbEuqpyju8/ptOKg6gEC+Tqsvj2xS9o1g71bUh8twxnC6ZL5rZKCsGN0iyH0CwgUyc9VR5owNQF9Ng=="], @@ -766,8 +764,6 @@ "@xmldom/xmldom": ["@xmldom/xmldom@0.8.12", "https://registry.npmmirror.com/@xmldom/xmldom/-/xmldom-0.8.12.tgz", {}, "sha512-9k/gHF6n/pAi/9tqr3m3aqkuiNosYTurLLUtc7xQ9sxB/wm7WPygCv8GYa6mS0fLJEHhqMC1ATYhz++U/lRHqg=="], - "abort-controller": ["abort-controller@3.0.0", "https://registry.npmmirror.com/abort-controller/-/abort-controller-3.0.0.tgz", { "dependencies": { "event-target-shim": "^5.0.0" } }, "sha512-h8lQ8tacZYnR3vNQTgibj+tODHI5/+l06Au2Pcriv/Gmet0eaj4TwWH41sO9wnHDiQsEj19q0drzdWdeAHtweg=="], - "accepts": ["accepts@2.0.0", "https://registry.npmmirror.com/accepts/-/accepts-2.0.0.tgz", { "dependencies": { "mime-types": "^3.0.0", "negotiator": "^1.0.0" } }, "sha512-5cvg6CtKwfgdmVqY1WIiXKc3Q1bkRqGLi+2W/6ao+6Y7gu/RCwRuAhGEzh5B4KlszSuTLgZYuqFqo5bImjNKng=="], "acorn": ["acorn@8.16.0", "https://registry.npmmirror.com/acorn/-/acorn-8.16.0.tgz", { "bin": { "acorn": "bin/acorn" } }, "sha512-UVJyE9MttOsBQIDKw1skb9nAwQuR5wuGD3+82K6JgJlm/Y+KI92oNsMNGZCYdDsVtRHSak0pcV5Dno5+4jh9sw=="], @@ -776,8 +772,6 @@ "agent-base": ["agent-base@8.0.0", "https://registry.npmmirror.com/agent-base/-/agent-base-8.0.0.tgz", {}, "sha512-QT8i0hCz6C/KQ+KTAbSNwCHDGdmUJl2tp2ZpNlGSWCfhUNVbYG2WLE3MdZGBAgXPV4GAvjGMxo+C1hroyxmZEg=="], - "agentkeepalive": ["agentkeepalive@4.6.0", "https://registry.npmmirror.com/agentkeepalive/-/agentkeepalive-4.6.0.tgz", { "dependencies": { "humanize-ms": "^1.2.1" } }, "sha512-kja8j7PjmncONqaTsB8fQ+wE2mSU2DJ9D4XKoJ5PFWIdRMa6SLSN1ff4mOr4jCbfRSsxR4keIiySJU0N9T5hIQ=="], - "ajv": ["ajv@8.18.0", "https://registry.npmmirror.com/ajv/-/ajv-8.18.0.tgz", { "dependencies": { "fast-deep-equal": "^3.1.3", "fast-uri": "^3.0.1", "json-schema-traverse": "^1.0.0", "require-from-string": "^2.0.2" } }, "sha512-PlXPeEWMXMZ7sPYOHqmDyCJzcfNrUr3fGNKtezX14ykXOEIvyK81d+qydx89KY5O71FKMPaQ2vBfBFI5NHR63A=="], "ajv-formats": ["ajv-formats@3.0.1", "https://registry.npmmirror.com/ajv-formats/-/ajv-formats-3.0.1.tgz", { "dependencies": { "ajv": "^8.0.0" } }, "sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ=="], @@ -934,8 +928,6 @@ "etag": ["etag@1.8.1", "https://registry.npmmirror.com/etag/-/etag-1.8.1.tgz", {}, "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg=="], - "event-target-shim": ["event-target-shim@5.0.1", "https://registry.npmmirror.com/event-target-shim/-/event-target-shim-5.0.1.tgz", {}, "sha512-i/2XbnSz/uxRCU6+NdVJgKWDTM427+MqYbkQzD321DuCQJUqOuJKIA0IM2+W2xtYHdKOmZ4dR6fExsd4SXL+WQ=="], - "eventsource": ["eventsource@3.0.7", "https://registry.npmmirror.com/eventsource/-/eventsource-3.0.7.tgz", { "dependencies": { "eventsource-parser": "^3.0.1" } }, "sha512-CRT1WTyuQoD771GW56XEZFQ/ZoSfWid1alKGDYMmkt2yl8UXrVR4pspqWNEcqKvVIzg6PAltWjxcSSPrboA4iA=="], "eventsource-parser": ["eventsource-parser@3.0.6", "https://registry.npmmirror.com/eventsource-parser/-/eventsource-parser-3.0.6.tgz", {}, "sha512-Vo1ab+QXPzZ4tCa8SwIHJFaSzy4R6SHf7BY79rFBDf0idraZWAkYrDjDj8uWaSm3S2TK+hJ7/t1CEmZ7jXw+pg=="], @@ -982,12 +974,8 @@ "form-data": ["form-data@4.0.5", "https://registry.npmmirror.com/form-data/-/form-data-4.0.5.tgz", { "dependencies": { "asynckit": "^0.4.0", "combined-stream": "^1.0.8", "es-set-tostringtag": "^2.1.0", "hasown": "^2.0.2", "mime-types": "^2.1.12" } }, "sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w=="], - "form-data-encoder": ["form-data-encoder@1.7.2", "https://registry.npmmirror.com/form-data-encoder/-/form-data-encoder-1.7.2.tgz", {}, "sha512-qfqtYan3rxrnCk1VYaA4H+Ms9xdpPqvLZa6xmMgFvhO32x7/3J/ExcTd6qpxM0vH2GdMI+poehyBZvqfMTto8A=="], - "formatly": ["formatly@0.3.0", "https://registry.npmmirror.com/formatly/-/formatly-0.3.0.tgz", { "dependencies": { "fd-package-json": "^2.0.0" }, "bin": { "formatly": "bin/index.mjs" } }, "sha512-9XNj/o4wrRFyhSMJOvsuyMwy8aUfBaZ1VrqHVfohyXf0Sw0e+yfKG+xZaY3arGCOMdwFsqObtzVOc1gU9KiT9w=="], - "formdata-node": ["formdata-node@4.4.1", "https://registry.npmmirror.com/formdata-node/-/formdata-node-4.4.1.tgz", { "dependencies": { "node-domexception": "1.0.0", "web-streams-polyfill": "4.0.0-beta.3" } }, "sha512-0iirZp3uVDjVGt9p49aTaqjk84TrglENEDuqfdlZQ1roC9CWlPk6Avf8EEnZNcAqPonwkG35x4n3ww/1THYAeQ=="], - "formdata-polyfill": ["formdata-polyfill@4.0.10", "https://registry.npmmirror.com/formdata-polyfill/-/formdata-polyfill-4.0.10.tgz", { "dependencies": { "fetch-blob": "^3.1.2" } }, "sha512-buewHzMvYL29jdeQTVILecSaZKnt/RJWjoZCF5OW60Z67/GmSLBkOFM7qh1PI3zFNtJbaZL5eQu1vLfazOwj4g=="], "forwarded": ["forwarded@0.2.0", "https://registry.npmmirror.com/forwarded/-/forwarded-0.2.0.tgz", {}, "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow=="], @@ -1058,8 +1046,6 @@ "human-signals": ["human-signals@8.0.1", "https://registry.npmmirror.com/human-signals/-/human-signals-8.0.1.tgz", {}, "sha512-eKCa6bwnJhvxj14kZk5NCPc6Hb6BdsU9DZcOnmQKSnO1VKrfV0zCvtttPZUsBvjmNDn8rpcJfpwSYnHBjc95MQ=="], - "humanize-ms": ["humanize-ms@1.2.1", "https://registry.npmmirror.com/humanize-ms/-/humanize-ms-1.2.1.tgz", { "dependencies": { "ms": "^2.0.0" } }, "sha512-Fl70vYtsAFb/C06PTS9dZBo7ihau+Tu/DNCk/OyHhea07S+aeMWpFFkUaXRa8fI+ScZbEI8dfSxwY7gxZ9SAVQ=="], - "iconv-lite": ["iconv-lite@0.7.2", "https://registry.npmmirror.com/iconv-lite/-/iconv-lite-0.7.2.tgz", { "dependencies": { "safer-buffer": ">= 2.1.2 < 3.0.0" } }, "sha512-im9DjEDQ55s9fL4EYzOAv0yMqmMBSZp6G0VvFyTMPKWxiSBHUj9NW/qqLmXUwXrrM7AvqSlTCfvqRb0cM8yYqw=="], "ignore": ["ignore@7.0.5", "https://registry.npmmirror.com/ignore/-/ignore-7.0.5.tgz", {}, "sha512-Hs59xBNfUIunMFgWAbGX5cq6893IbWg4KnrjbYwX3tx0ztorVgTDA6B2sxf8ejHJ4wz8BqGUMYlnzNBer5NvGg=="], @@ -1196,7 +1182,7 @@ "node-domexception": ["node-domexception@1.0.0", "https://registry.npmmirror.com/node-domexception/-/node-domexception-1.0.0.tgz", {}, "sha512-/jKZoMpw0F8GRwl4/eLROPA3cfcXtLApP0QzLmUT/HuPCZWyB7IY9ZrMeKw2O/nFIqPQB3PVM9aYm0F312AXDQ=="], - "node-fetch": ["node-fetch@2.7.0", "https://registry.npmmirror.com/node-fetch/-/node-fetch-2.7.0.tgz", { "dependencies": { "whatwg-url": "^5.0.0" }, "peerDependencies": { "encoding": "^0.1.0" }, "optionalPeers": ["encoding"] }, "sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A=="], + "node-fetch": ["node-fetch@3.3.2", "https://registry.npmmirror.com/node-fetch/-/node-fetch-3.3.2.tgz", { "dependencies": { "data-uri-to-buffer": "^4.0.0", "fetch-blob": "^3.1.4", "formdata-polyfill": "^4.0.10" } }, "sha512-dRB78srN/l6gqWulah9SrxeYnxeddIG30+GOqK/9OlLVyLg3HPnr6SqOWTWOXKRwC2eGYCkZ59NNuSgvSrpgOA=="], "node-forge": ["node-forge@1.4.0", "https://registry.npmmirror.com/node-forge/-/node-forge-1.4.0.tgz", {}, "sha512-LarFH0+6VfriEhqMMcLX2F7SwSXeWwnEAJEsYm5QKWchiVYVvJyV9v7UDvUv+w5HO23ZpQTXDv/GxdDdMyOuoQ=="], @@ -1212,7 +1198,7 @@ "open": ["open@10.2.0", "https://registry.npmmirror.com/open/-/open-10.2.0.tgz", { "dependencies": { "default-browser": "^5.2.1", "define-lazy-prop": "^3.0.0", "is-inside-container": "^1.0.0", "wsl-utils": "^0.1.0" } }, "sha512-YgBpdJHPyQ2UE5x+hlSXcnejzAvD0b22U2OuAP+8OnlJT+PjWPxtgmGqKKc+RgTM63U9gN0YzrYc71R2WT/hTA=="], - "openai": ["openai@4.104.0", "https://registry.npmmirror.com/openai/-/openai-4.104.0.tgz", { "dependencies": { "@types/node": "^18.11.18", "@types/node-fetch": "^2.6.4", "abort-controller": "^3.0.0", "agentkeepalive": "^4.2.1", "form-data-encoder": "1.7.2", "formdata-node": "^4.3.2", "node-fetch": "^2.6.7" }, "peerDependencies": { "ws": "^8.18.0", "zod": "^3.23.8" }, "optionalPeers": ["ws", "zod"], "bin": { "openai": "bin/cli" } }, "sha512-p99EFNsA/yX6UhVO93f5kJsDRLAg+CTA2RBqdHK4RtK8u5IJw32Hyb2dTGKbnnFmnuoBv5r7Z2CURI9sGZpSuA=="], + "openai": ["openai@6.33.0", "", { "peerDependencies": { "ws": "^8.18.0", "zod": "^3.25 || ^4.0" }, "optionalPeers": ["ws", "zod"], "bin": { "openai": "bin/cli" } }, "sha512-xAYN1W3YsDXJWA5F277135YfkEk6H7D3D6vWwRhJ3OEkzRgcyK8z/P5P9Gyi/wB4N8kK9kM5ZjprfvyHagKmpw=="], "os-tmpdir": ["os-tmpdir@1.0.2", "https://registry.npmmirror.com/os-tmpdir/-/os-tmpdir-1.0.2.tgz", {}, "sha512-D2FR03Vir7FIu45XBY20mTb+/ZSWB00sjU9jdQXt83gDrI4Ztz5Fs7/yy74g2N5SVQY4xY1qDr4rNddwYRVX0g=="], @@ -1434,7 +1420,7 @@ "walk-up-path": ["walk-up-path@4.0.0", "https://registry.npmmirror.com/walk-up-path/-/walk-up-path-4.0.0.tgz", {}, "sha512-3hu+tD8YzSLGuFYtPRb48vdhKMi0KQV5sn+uWr8+7dMEq/2G/dtLrdDinkLjqq5TIbIBjYJ4Ax/n3YiaW7QM8A=="], - "web-streams-polyfill": ["web-streams-polyfill@4.0.0-beta.3", "https://registry.npmmirror.com/web-streams-polyfill/-/web-streams-polyfill-4.0.0-beta.3.tgz", {}, "sha512-QW95TCTaHmsYfHDybGMwO5IJIM93I/6vTRk+daHTWFPhwh+C8Cg7j7XyKrwrj8Ib6vYXe0ocYNrmzY4xAAN6ug=="], + "web-streams-polyfill": ["web-streams-polyfill@3.3.3", "https://registry.npmmirror.com/web-streams-polyfill/-/web-streams-polyfill-3.3.3.tgz", {}, "sha512-d2JWLCivmZYTSIoge9MsgFCZrt571BikcWGYkjC1khllbTeDlGqZ2D8vD8E/lJa8WGWbb7Plm8/XJYV7IJHZZw=="], "webidl-conversions": ["webidl-conversions@3.0.1", "https://registry.npmmirror.com/webidl-conversions/-/webidl-conversions-3.0.1.tgz", {}, "sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ=="], @@ -1772,14 +1758,10 @@ "external-editor/iconv-lite": ["iconv-lite@0.4.24", "https://registry.npmmirror.com/iconv-lite/-/iconv-lite-0.4.24.tgz", { "dependencies": { "safer-buffer": ">= 2.1.2 < 3" } }, "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA=="], - "fetch-blob/web-streams-polyfill": ["web-streams-polyfill@3.3.3", "https://registry.npmmirror.com/web-streams-polyfill/-/web-streams-polyfill-3.3.3.tgz", {}, "sha512-d2JWLCivmZYTSIoge9MsgFCZrt571BikcWGYkjC1khllbTeDlGqZ2D8vD8E/lJa8WGWbb7Plm8/XJYV7IJHZZw=="], - "form-data/mime-types": ["mime-types@2.1.35", "https://registry.npmmirror.com/mime-types/-/mime-types-2.1.35.tgz", { "dependencies": { "mime-db": "1.52.0" } }, "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw=="], "gaxios/https-proxy-agent": ["https-proxy-agent@7.0.6", "https://registry.npmmirror.com/https-proxy-agent/-/https-proxy-agent-7.0.6.tgz", { "dependencies": { "agent-base": "^7.1.2", "debug": "4" } }, "sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw=="], - "gaxios/node-fetch": ["node-fetch@3.3.2", "https://registry.npmmirror.com/node-fetch/-/node-fetch-3.3.2.tgz", { "dependencies": { "data-uri-to-buffer": "^4.0.0", "fetch-blob": "^3.1.4", "formdata-polyfill": "^4.0.10" } }, "sha512-dRB78srN/l6gqWulah9SrxeYnxeddIG30+GOqK/9OlLVyLg3HPnr6SqOWTWOXKRwC2eGYCkZ59NNuSgvSrpgOA=="], - "gtoken/gaxios": ["gaxios@6.7.1", "https://registry.npmmirror.com/gaxios/-/gaxios-6.7.1.tgz", { "dependencies": { "extend": "^3.0.2", "https-proxy-agent": "^7.0.1", "is-stream": "^2.0.0", "node-fetch": "^2.6.9", "uuid": "^9.0.1" } }, "sha512-LDODD4TMYx7XXdpwxAVRAIAuB0bzv0s+ywFonY46k126qzQHT9ygyoa9tncmOiQmmDrik65UYsEkv3lbfqQ3yQ=="], "http-proxy-agent/agent-base": ["agent-base@7.1.4", "https://registry.npmmirror.com/agent-base/-/agent-base-7.1.4.tgz", {}, "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ=="], @@ -1794,8 +1776,6 @@ "npm-run-path/path-key": ["path-key@4.0.0", "https://registry.npmmirror.com/path-key/-/path-key-4.0.0.tgz", {}, "sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ=="], - "openai/@types/node": ["@types/node@18.19.130", "https://registry.npmmirror.com/@types/node/-/node-18.19.130.tgz", { "dependencies": { "undici-types": "~5.26.4" } }, "sha512-GRaXQx6jGfL8sKfaIDD6OupbIHBr9jv7Jnaml9tB7l4v068PAOXqfcujMMo5PhbIs6ggR1XODELqahT2R8v0fg=="], - "parse5-htmlparser2-tree-adapter/parse5": ["parse5@6.0.1", "https://registry.npmmirror.com/parse5/-/parse5-6.0.1.tgz", {}, "sha512-Ofn/CTFzRGTTxwpNEs9PP93gXShHcTq255nzRYSKe8AkVpZY7e1fpmTfOyoIvjP5HG7Z2ZM7VS9PPhQGW2pOpw=="], "proper-lockfile/signal-exit": ["signal-exit@3.0.7", "https://registry.npmmirror.com/signal-exit/-/signal-exit-3.0.7.tgz", {}, "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ=="], @@ -1932,6 +1912,8 @@ "gtoken/gaxios/is-stream": ["is-stream@2.0.1", "https://registry.npmmirror.com/is-stream/-/is-stream-2.0.1.tgz", {}, "sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg=="], + "gtoken/gaxios/node-fetch": ["node-fetch@2.7.0", "https://registry.npmmirror.com/node-fetch/-/node-fetch-2.7.0.tgz", { "dependencies": { "whatwg-url": "^5.0.0" }, "peerDependencies": { "encoding": "^0.1.0" }, "optionalPeers": ["encoding"] }, "sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A=="], + "gtoken/gaxios/uuid": ["uuid@9.0.1", "https://registry.npmmirror.com/uuid/-/uuid-9.0.1.tgz", { "bin": { "uuid": "dist/bin/uuid" } }, "sha512-b+1eJOlsR9K8HJpow9Ok3fiWOWSIcIzXodvv0rQjVoOVNpWMpxf1wZNpt4y9h10odCNrqnYp1OBzRktckBe3sA=="], "image-processor-napi/sharp/@img/sharp-darwin-arm64": ["@img/sharp-darwin-arm64@0.33.5", "https://registry.npmmirror.com/@img/sharp-darwin-arm64/-/sharp-darwin-arm64-0.33.5.tgz", { "optionalDependencies": { "@img/sharp-libvips-darwin-arm64": "1.0.4" }, "os": "darwin", "cpu": "arm64" }, "sha512-UT4p+iz/2H4twwAoLCqfA9UH5pI6DggwKEGuaPy7nCVQ8ZsiY5PIcrRvD1DzuY3qYL07NtIQcWnBSY/heikIFQ=="], @@ -1972,8 +1954,6 @@ "image-processor-napi/sharp/@img/sharp-win32-x64": ["@img/sharp-win32-x64@0.33.5", "https://registry.npmmirror.com/@img/sharp-win32-x64/-/sharp-win32-x64-0.33.5.tgz", { "os": "win32", "cpu": "x64" }, "sha512-MpY/o8/8kj+EcnxwvrP4aTJSWw/aZ7JIGR4aBeZkZw5B7/Jn+tY9/VNwtcoGmdT7GfggGIU4kygOMSbYnOrAbg=="], - "openai/@types/node/undici-types": ["undici-types@5.26.5", "https://registry.npmmirror.com/undici-types/-/undici-types-5.26.5.tgz", {}, "sha512-JlCMO+ehdEIKqlFxk6IfVoAUVmgz7cU7zD/h9XZ0qzeosSHmUJVOzSQvvYSYWXkFXC+IfLKSIffhv0sVZup6pA=="], - "qrcode/yargs/cliui": ["cliui@6.0.0", "https://registry.npmmirror.com/cliui/-/cliui-6.0.0.tgz", { "dependencies": { "string-width": "^4.2.0", "strip-ansi": "^6.0.0", "wrap-ansi": "^6.2.0" } }, "sha512-t6wbgtoCXvAzst7QgXxJYqPt0usEfbgQdftEPbLL/cvv6HPE5VgvqCuAIDR0NgU52ds6rFwqrgakNLrHEjCbrQ=="], "qrcode/yargs/string-width": ["string-width@4.2.3", "https://registry.npmmirror.com/string-width/-/string-width-4.2.3.tgz", { "dependencies": { "emoji-regex": "^8.0.0", "is-fullwidth-code-point": "^3.0.0", "strip-ansi": "^6.0.1" } }, "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g=="], @@ -1992,6 +1972,8 @@ "@anthropic-ai/vertex-sdk/google-auth-library/gaxios/is-stream": ["is-stream@2.0.1", "https://registry.npmmirror.com/is-stream/-/is-stream-2.0.1.tgz", {}, "sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg=="], + "@anthropic-ai/vertex-sdk/google-auth-library/gaxios/node-fetch": ["node-fetch@2.7.0", "https://registry.npmmirror.com/node-fetch/-/node-fetch-2.7.0.tgz", { "dependencies": { "whatwg-url": "^5.0.0" }, "peerDependencies": { "encoding": "^0.1.0" }, "optionalPeers": ["encoding"] }, "sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A=="], + "@anthropic-ai/vertex-sdk/google-auth-library/gaxios/uuid": ["uuid@9.0.1", "https://registry.npmmirror.com/uuid/-/uuid-9.0.1.tgz", { "bin": { "uuid": "dist/bin/uuid" } }, "sha512-b+1eJOlsR9K8HJpow9Ok3fiWOWSIcIzXodvv0rQjVoOVNpWMpxf1wZNpt4y9h10odCNrqnYp1OBzRktckBe3sA=="], "@anthropic-ai/vertex-sdk/google-auth-library/gcp-metadata/google-logging-utils": ["google-logging-utils@0.0.2", "https://registry.npmmirror.com/google-logging-utils/-/google-logging-utils-0.0.2.tgz", {}, "sha512-NEgUnEcBiP5HrPzufUkBzJOD/Sxsco3rLNo1F1TNf7ieU8ryUzBhqba8r756CjLX7rn3fHl6iLEwPYuqpoKgQQ=="], diff --git a/docs/feature-flags-audit-complete.md b/docs/feature-flags-audit-complete.md new file mode 100644 index 000000000..5d5ac83c5 --- /dev/null +++ b/docs/feature-flags-audit-complete.md @@ -0,0 +1,2008 @@ +# Claude Code 编译时特性标志（Feature Flags）完整审计报告 + +> 审计日期: 2026-04-05 +> 代码库: Claude Code CLI +> 总计特性标志数: 92 个 +> 编译时门控机制: `feature('FLAG_NAME')` — 来自 `bun:bundle` 的编译时常量 +> 运行时门控机制: `USER_TYPE` 环境变量 + GrowthBook 远程开关（`tengu_*` 前缀） + +--- + +## 门控机制概述 + +Claude Code 使用三层门控系统: + +1. **编译时标志** (`feature('...')` from `bun:bundle`): 在构建时决定代码是否包含在最终产物中。当 `feature('X')` 为 `false` 时，Bun 的死代码消除（DCE）会移除整个 `if` 分支，最终产物中完全不包含该功能的代码。 +2. **运行时用户类型** (`USER_TYPE`): 通过环境变量区分用户类型（如 `internal`, `external`, `enterprise`），在运行时决定功能是否可用。 +3. **远程开关** (GrowthBook SDK, `tengu_*` 前缀): 通过 Anthropic 的 GrowthBook 实例进行远程 A/B 测试和功能开关控制，可在不重新部署的情况下开启/关闭功能。 + +本文档审计的是第一层——编译时标志。所有 92 个标志均以 `feature('FLAG_NAME')` 的形式出现在源代码中。 + +--- + +## 分类标准 + +- **COMPLETE（完整实现）**: 核心功能代码完整，所有引用文件存在且有实质性内容。只需在构建配置中将该标志设为 `true` 即可启用。 +- **PARTIAL（部分实现）**: 有实质性的功能代码，但存在缺失的文件（命令入口、组件等）或关键模块仅有空壳。启用后可能报错或功能不完整。 +- **STUB（纯桩/最小实现）**: 仅有 1-2 处引用，没有或几乎没有实际功能代码。代码只是为该标志预留了位置。 + +--- + +## 统计摘要 + +| 分类 | 数量 | 标志名称 | +|------|------|----------| +| COMPLETE | 22 | BRIDGE_MODE, COORDINATOR_MODE, CONTEXT_COLLAPSE, VOICE_MODE, TEAMMEM, COMMIT_ATTRIBUTION, ULTRAPLAN, BASH_CLASSIFIER, TRANSCRIPT_CLASSIFIER, EXTRACT_MEMORIES, CACHED_MICROCOMPACT, TOKEN_BUDGET, AGENT_TRIGGERS, REACTIVE_COMPACT, KAIROS_BRIEF, CCR_REMOTE_SETUP, SHOT_STATS, BG_SESSIONS, PROACTIVE, CHICAGO_MCP, VERIFICATION_AGENT, PROMPT_CACHE_BREAK_DETECTION | +| PARTIAL | 19 | KAIROS, BUDDY, MONITOR_TOOL, HISTORY_SNIP, WORKFLOW_SCRIPTS, UDS_INBOX, KAIROS_CHANNELS, FORK_SUBAGENT, EXPERIMENTAL_SKILL_SEARCH, WEB_BROWSER_TOOL, MCP_SKILLS, REVIEW_ARTIFACT, KAIROS_GITHUB_WEBHOOKS, CONNECTOR_TEXT, TEMPLATES, LODESTONE, HISTORY_PICKER, MESSAGE_ACTIONS, TERMINAL_PANEL | +| STUB | 51 | TORCH, KAIROS_DREAM, KAIROS_PUSH_NOTIFICATION, DAEMON, DIRECT_CONNECT, SSH_REMOTE, STREAMLINED_OUTPUT, ANTI_DISTILLATION_CC, NATIVE_CLIENT_ATTESTATION, ABLATION_BASELINE, AGENT_MEMORY_SNAPSHOT, AGENT_TRIGGERS_REMOTE, ALLOW_TEST_VERSIONS, AUTO_THEME, AWAY_SUMMARY, BREAK_CACHE_COMMAND, BUILDING_CLAUDE_APPS, BUILTIN_EXPLORE_PLAN_AGENTS, BYOC_ENVIRONMENT_RUNNER, CCR_AUTO_CONNECT, CCR_MIRROR, COMPACTION_REMINDERS, COWORKER_TYPE_TELEMETRY, DOWNLOAD_USER_SETTINGS, DUMP_SYSTEM_PROMPT, ENHANCED_TELEMETRY_BETA, FILE_PERSISTENCE, HARD_FAIL, HOOK_PROMPTS, IS_LIBC_GLIBC, IS_LIBC_MUSL, MCP_RICH_OUTPUT, MEMORY_SHAPE_TELEMETRY, NATIVE_CLIPBOARD_IMAGE, NEW_INIT, OVERFLOW_TEST_TOOL, PERFETTO_TRACING, POWERSHELL_AUTO_MODE, QUICK_SEARCH, RUN_SKILL_GENERATOR, SELF_HOSTED_RUNNER, SKILL_IMPROVEMENT, SLOW_OPERATION_LOGGING, TREE_SITTER_BASH, TREE_SITTER_BASH_SHADOW, ULTRATHINK, UNATTENDED_RETRY, UPLOAD_USER_SETTINGS, SKIP_DETECTION_WHEN_AUTOUPDATES_DISABLED | + +--- + +## 当前启用状态 (2026-04-05) + +> 经 Codex CLI 独立复核验证，详见 `feature-flags-codex-review.md` + +| 标志 | build.ts | dev.ts | 实际验证状态 | 备注 | +|------|:--------:|:------:|:----------:|------| +| AGENT_TRIGGERS_REMOTE | **ON** | **ON** | compile-only | 环境标记，原始即启用 | +| CHICAGO_MCP | **ON** | **ON** | compile-only | Computer Use，原始即启用 | +| VOICE_MODE | **ON** | **ON** | compile-only | 语音模式，原始即启用 | +| SHOT_STATS | **ON** | **ON** | compile-only, 已验证 | 本轮新增，纯本地统计 | +| PROMPT_CACHE_BREAK_DETECTION | **ON** | **ON** | compile-only, 已验证 | 本轮新增，内部诊断 | +| TOKEN_BUDGET | **ON** | **ON** | compile-only, 已验证 | 本轮新增，支持 `+500k` 语法 | +| BUDDY | off | **ON** | compile+GrowthBook | 仅 dev 模式 | +| TRANSCRIPT_CLASSIFIER | off | **ON** | compile+GrowthBook | 仅 dev 模式 | +| BRIDGE_MODE | off | **ON** | compile+remote | 仅 dev 模式，需 claude.ai 订阅 | + +--- + +# 一、COMPLETE（完整实现）— 共 22 个 + +以下标志的功能代码完整，所有引用的文件均存在且有实质性内容。只需在构建配置中将对应标志设为 `true` 即可启用该功能。 + +--- + +## 1. BRIDGE_MODE `[dev: ON]` + +**编译时引用次数**: 29（单引号 28 + 双引号 1） +**功能描述**: 远程桥接模式。允许 Claude Code CLI 通过 WebSocket 连接到远程服务端（如 claude.ai Web 端），实现远程控制、会话转发、权限代理、附件传输等功能。这是 Claude Code 最大的子系统之一。 +**分类**: COMPLETE +**启用条件**: 将 `BRIDGE_MODE` 编译标志设为 `true` + +**核心实现文件（src/bridge/ 目录，共 32 个文件，12,619 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/bridge/bridgeMain.ts | 2,999 行 | 桥接主入口，管理整个远程桥接生命周期 | +| src/bridge/replBridge.ts | 2,406 行 | REPL 桥接核心，处理消息路由和会话管理 | +| src/bridge/remoteBridgeCore.ts | 1,008 行 | 远程桥接核心连接逻辑 | +| src/bridge/initReplBridge.ts | 569 行 | REPL 桥接初始化 | +| src/bridge/sessionRunner.ts | 550 行 | 会话运行器，管理远程会话执行 | +| src/bridge/bridgeApi.ts | 539 行 | 桥接 API 封装 | +| src/bridge/bridgeUI.ts | 530 行 | 桥接模式 UI 组件 | +| src/bridge/bridgeMessaging.ts | 461 行 | 桥接消息协议 | +| src/bridge/createSession.ts | 384 行 | 远程会话创建逻辑 | +| src/bridge/replBridgeTransport.ts | 370 行 | REPL 桥接传输层 | +| src/bridge/types.ts | 262 行 | 桥接相关类型定义 | +| src/bridge/jwtUtils.ts | 256 行 | JWT 令牌工具 | +| src/bridge/trustedDevice.ts | 210 行 | 可信设备管理 | +| src/bridge/bridgePointer.ts | 210 行 | 桥接指针管理 | +| src/bridge/bridgeEnabled.ts | 202 行 | 桥接模式启用检测 | +| src/bridge/inboundAttachments.ts | 175 行 | 入站附件处理 | +| src/bridge/envLessBridgeConfig.ts | 165 行 | 无环境变量桥接配置 | +| src/bridge/bridgeStatusUtil.ts | 163 行 | 桥接状态工具 | +| src/bridge/debugUtils.ts | 141 行 | 桥接调试工具 | +| src/bridge/bridgeDebug.ts | 135 行 | 桥接调试模块 | +| src/bridge/workSecret.ts | 127 行 | 工作密钥管理 | +| src/bridge/pollConfig.ts | 110 行 | 轮询配置 | +| src/bridge/pollConfigDefaults.ts | 82 行 | 轮询配置默认值 | +| src/bridge/inboundMessages.ts | 80 行 | 入站消息处理 | +| src/bridge/capacityWake.ts | 56 行 | 容量唤醒 | +| src/bridge/sessionIdCompat.ts | 57 行 | 会话 ID 兼容层 | +| src/bridge/codeSessionApi.ts | 168 行 | 代码会话 API | +| src/bridge/bridgeConfig.ts | 48 行 | 桥接配置 | +| src/bridge/bridgePermissionCallbacks.ts | 43 行 | 桥接权限回调 | +| src/bridge/replBridgeHandle.ts | 36 行 | REPL 桥接句柄 | +| src/bridge/flushGate.ts | 71 行 | 刷新门控 | +| src/bridge/webhookSanitizer.ts | 3 行 | Webhook 清理 | +| src/bridge/peerSessions.ts | 3 行 | 对等会话（桩） | + +**引用该标志的文件（13 个）**: +1. src/bridge/bridgeEnabled.ts — 检测桥接模式是否编译启用 +2. src/commands.ts — 条件注册 `/bridge` 命令和 `/remoteControlServer` 命令 +3. src/commands/bridge/index.ts — 桥接命令入口（604 行） +4. src/components/PromptInput/PromptInputFooter.tsx — 桥接模式下的页脚 UI +5. src/components/Settings/Config.tsx — 设置面板中的桥接选项 +6. src/entrypoints/cli.tsx — CLI 入口中的桥接模式初始化 +7. src/hooks/useCanUseTool.tsx — 桥接模式下的工具权限 +8. src/hooks/useReplBridge.tsx — REPL 桥接 Hook +9. src/main.tsx — 主入口中的桥接模式启动 +10. src/screens/REPL.tsx — REPL 屏幕中的桥接集成 +11. src/tools/BriefTool/attachments.ts — Brief 工具附件处理 +12. src/tools/BriefTool/upload.ts — Brief 工具上传 +13. src/tools/ConfigTool/supportedSettings.ts — 配置工具中的桥接设置 + +**启用所需操作**: 仅需将编译标志 `BRIDGE_MODE` 设为 `true`。所有代码完整，命令入口 `src/commands/bridge/index.ts`（604 行）和 `src/commands/bridge/bridge.tsx`（46,907 行）均存在。 + +--- + +## 2. COORDINATOR_MODE + +**编译时引用次数**: 32 +**功能描述**: 协调器模式。允许 Claude Code 作为"领导者"协调多个"工作者"代理并行执行任务。工作者可以在同一进程内运行（in-process），也可以通过 tmux/iTerm2 面板运行。支持权限同步、重连、团队管理等。 +**分类**: COMPLETE +**启用条件**: 将 `COORDINATOR_MODE` 编译标志设为 `true` + +**核心实现文件（src/coordinator/ 目录，370 行 + src/utils/swarm/ 目录，7,620 行 = 共 7,990 行）**: + +src/coordinator/ 目录（2 个文件）: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/coordinator/coordinatorMode.ts | 369 行 | 协调器模式核心逻辑，管理领导者/工作者角色 | +| src/coordinator/workerAgent.ts | 1 行 | 工作者代理（桩文件，实际逻辑在 swarm 中） | + +src/utils/swarm/ 目录（22 个文件）: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/utils/swarm/inProcessRunner.ts | 1,552 行 | 进程内工作者运行器 | +| src/utils/swarm/permissionSync.ts | 928 行 | 权限同步机制 | +| src/utils/swarm/backends/TmuxBackend.ts | 764 行 | Tmux 后端执行器 | +| src/utils/swarm/teamHelpers.ts | 683 行 | 团队辅助函数 | +| src/utils/swarm/It2SetupPrompt.tsx | 379 行 | iTerm2 设置提示 UI | +| src/utils/swarm/backends/ITermBackend.ts | 370 行 | iTerm2 后端执行器 | +| src/utils/swarm/backends/PaneBackendExecutor.ts | 354 行 | 面板后端执行器 | +| src/utils/swarm/backends/InProcessBackend.ts | 339 行 | 进程内后端 | +| src/utils/swarm/spawnInProcess.ts | 328 行 | 进程内 spawn 逻辑 | +| src/utils/swarm/backends/types.ts | 311 行 | 后端类型定义 | +| src/utils/swarm/backends/registry.ts | 464 行 | 后端注册表 | +| src/utils/swarm/backends/it2Setup.ts | 245 行 | iTerm2 设置逻辑 | +| src/utils/swarm/spawnUtils.ts | 146 行 | Spawn 工具函数 | +| src/utils/swarm/teammateInit.ts | 129 行 | 队友初始化 | +| src/utils/swarm/reconnection.ts | 119 行 | 重连逻辑 | +| src/utils/swarm/teammateLayoutManager.ts | 107 行 | 队友布局管理 | +| src/utils/swarm/backends/teammateModeSnapshot.ts | 87 行 | 队友模式快照 | +| src/utils/swarm/backends/detection.ts | 128 行 | 后端检测 | +| src/utils/swarm/leaderPermissionBridge.ts | 54 行 | 领导者权限桥接 | +| src/utils/swarm/constants.ts | 33 行 | 常量定义 | +| src/utils/swarm/teammatePromptAddendum.ts | 18 行 | 队友提示附加内容 | +| src/utils/swarm/teammateModel.ts | 10 行 | 队友模型配置 | + +**引用该标志的文件（15 个）**: +1. src/QueryEngine.ts — 查询引擎中的协调器模式分支 +2. src/cli/print.ts — CLI 输出中的协调器模式处理 +3. src/commands/clear/conversation.ts — 清除对话时的协调器状态处理 +4. src/components/PromptInput/PromptInputFooterLeftSide.tsx — 协调器模式下的页脚左侧 UI +5. src/coordinator/coordinatorMode.ts — 协调器模式核心逻辑 +6. src/main.tsx — 主入口中的协调器模式启动 +7. src/screens/REPL.tsx — REPL 屏幕中的协调器集成 +8. src/screens/ResumeConversation.tsx — 恢复对话时的协调器处理 +9. src/tools.ts — 工具注册中的协调器工具 +10. src/tools/AgentTool/AgentTool.tsx — Agent 工具中的协调器模式分支 +11. src/tools/AgentTool/builtInAgents.ts — 内置代理定义 +12. src/utils/processUserInput/processSlashCommand.tsx — 斜杠命令处理中的协调器 +13. src/utils/sessionRestore.ts — 会话恢复中的协调器状态 +14. src/utils/systemPrompt.ts — 系统提示中的协调器指令 +15. src/utils/toolPool.ts — 工具池中的协调器工具 + +**启用所需操作**: 仅需将编译标志 `COORDINATOR_MODE` 设为 `true`。所有 7,990 行代码完整。 + +--- + +## 3. CONTEXT_COLLAPSE + +**编译时引用次数**: 23（单引号 20 + 双引号 3） +**功能描述**: 上下文折叠/分析功能。提供对话上下文的可视化分析，包括 token 使用量统计、上下文窗口利用率、自动压缩触发等。 +**分类**: COMPLETE +**启用条件**: 将 `CONTEXT_COLLAPSE` 编译标志设为 `true` + +**核心实现文件（共 2,258 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/utils/analyzeContext.ts | 1,382 行 | 上下文分析核心逻辑 | +| src/components/ContextVisualization.tsx | 488 行 | 上下文可视化 UI 组件 | +| src/commands/context/context-noninteractive.ts | 325 行 | 非交互式上下文命令 | +| src/commands/context/context.tsx | 63 行 | 交互式上下文命令入口 | + +**引用该标志的文件（13 个）**: +1. src/commands/context/context-noninteractive.ts — 非交互式上下文分析命令 +2. src/commands/context/context.tsx — 上下文命令入口 +3. src/components/ContextVisualization.tsx — 上下文可视化组件 +4. src/components/TokenWarning.tsx — Token 警告组件中的上下文折叠检测 +5. src/query.ts — 查询中的上下文折叠处理 +6. src/screens/REPL.tsx — REPL 中的上下文折叠集成 +7. src/screens/ResumeConversation.tsx — 恢复对话中的上下文折叠 +8. src/services/compact/autoCompact.ts — 自动压缩中的上下文折叠触发 +9. src/services/compact/postCompactCleanup.ts — 压缩后清理 +10. src/setup.ts — 初始化设置中的上下文折叠 +11. src/tools.ts — 工具注册 +12. src/utils/analyzeContext.ts — 上下文分析核心 +13. src/utils/sessionRestore.ts — 会话恢复 + +**启用所需操作**: 仅需将编译标志 `CONTEXT_COLLAPSE` 设为 `true`。 + +--- + +## 4. VOICE_MODE `[build: ON] [dev: ON]` + +**编译时引用次数**: 49（单引号 46 + 双引号 3） +**功能描述**: 语音模式。集成语音转文字（STT）功能，用户可以通过麦克风输入语音，实时转换为文本发送给 AI。包括语音指示器 UI、语音流处理、键绑定等。 +**分类**: COMPLETE +**启用条件**: 将 `VOICE_MODE` 编译标志设为 `true` + +**核心实现文件（共 1,410 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/hooks/useVoiceIntegration.tsx | 676 行 | 语音集成 React Hook | +| src/services/voiceStreamSTT.ts | 544 行 | 语音流式 STT（语音转文字）服务 | +| src/components/PromptInput/VoiceIndicator.tsx | 136 行 | 语音指示器 UI 组件 | +| src/voice/voiceModeEnabled.ts | 54 行 | 语音模式启用检测 | + +**引用该标志的文件（16 个）**: +1. src/commands.ts — 条件注册语音相关命令 +2. src/components/LogoV2/VoiceModeNotice.tsx — 语音模式通知 UI +3. src/components/PromptInput/Notifications.tsx — 提示输入通知中的语音状态 +4. src/components/PromptInput/PromptInputFooterLeftSide.tsx — 页脚左侧语音按钮 +5. src/components/PromptInput/VoiceIndicator.tsx — 语音指示器组件 +6. src/components/TextInput.tsx — 文本输入中的语音模式处理 +7. src/hooks/useVoiceIntegration.tsx — 语音集成 Hook +8. src/keybindings/defaultBindings.ts — 语音模式键绑定 +9. src/screens/REPL.tsx — REPL 中的语音模式集成 +10. src/services/voiceStreamSTT.ts — STT 服务 +11. src/state/AppState.tsx — 应用状态中的语音状态 +12. src/tools/ConfigTool/ConfigTool.ts — 配置工具中的语音设置 +13. src/tools/ConfigTool/prompt.ts — 配置工具提示 +14. src/tools/ConfigTool/supportedSettings.ts — 支持的设置项 +15. src/utils/settings/types.ts — 设置类型定义 +16. src/voice/voiceModeEnabled.ts — 语音模式启用逻辑 + +**启用所需操作**: 仅需将编译标志 `VOICE_MODE` 设为 `true`。 + +--- + +## 5. TEAMMEM + +**编译时引用次数**: 53（单引号 51 + 双引号 2） +**功能描述**: 团队记忆功能。允许团队成员之间共享和同步记忆文件（CLAUDE.md），包括记忆提取、秘密过滤、文件选择器、折叠显示等。 +**分类**: COMPLETE +**启用条件**: 将 `TEAMMEM` 编译标志设为 `true` + +**核心实现文件（共 1,026 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/components/memory/MemoryFileSelector.tsx | 437 行 | 记忆文件选择器 UI | +| src/services/teamMemorySync/watcher.ts | 387 行 | 团队记忆文件监视器 | +| src/components/messages/teamMemCollapsed.tsx | 139 行 | 团队记忆折叠显示组件 | +| src/services/teamMemorySync/teamMemSecretGuard.ts | 44 行 | 团队记忆秘密过滤器 | +| src/components/messages/teamMemSaved.ts | 19 行 | 团队记忆保存状态 | + +**引用该标志的文件（17 个）**: +1. src/components/memory/MemoryFileSelector.tsx — 记忆文件选择器 +2. src/components/messages/CollapsedReadSearchContent.tsx — 折叠的读取/搜索内容 +3. src/components/messages/SystemTextMessage.tsx — 系统消息中的团队记忆显示 +4. src/components/messages/teamMemCollapsed.tsx — 团队记忆折叠组件 +5. src/components/messages/teamMemSaved.ts — 保存状态 +6. src/memdir/memdir.ts — 记忆目录操作 +7. src/services/extractMemories/extractMemories.ts — 记忆提取中的团队记忆 +8. src/services/extractMemories/prompts.ts — 记忆提取提示 +9. src/services/teamMemorySync/teamMemSecretGuard.ts — 秘密过滤 +10. src/services/teamMemorySync/watcher.ts — 文件监视 +11. src/setup.ts — 初始化中的团队记忆设置 +12. src/utils/claudemd.ts — CLAUDE.md 处理 +13. src/utils/collapseReadSearch.ts — 折叠读取/搜索 +14. src/utils/config.ts — 配置中的团队记忆 +15. src/utils/memory/types.ts — 记忆类型定义 +16. src/utils/memoryFileDetection.ts — 记忆文件检测 +17. src/utils/sessionFileAccessHooks.ts — 会话文件访问钩子 + +**启用所需操作**: 仅需将编译标志 `TEAMMEM` 设为 `true`。 + +--- + +## 6. COMMIT_ATTRIBUTION + +**编译时引用次数**: 12 +**功能描述**: 提交归属功能。在 git 提交中标记哪些代码是由 AI 生成的，包括 git trailer、统计信息、提交后处理等。 +**分类**: COMPLETE +**启用条件**: 将 `COMMIT_ATTRIBUTION` 编译标志设为 `true` + +**核心实现文件（共 1,354 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/utils/commitAttribution.ts | 961 行 | 提交归属核心逻辑 | +| src/utils/attribution.ts | 393 行 | 归属计算与标记 | + +**引用该标志的文件（9 个）**: +1. src/cli/print.ts — CLI 输出中的归属信息 +2. src/commands/clear/caches.ts — 清除缓存中的归属数据 +3. src/screens/REPL.tsx — REPL 中的归属集成 +4. src/services/compact/postCompactCleanup.ts — 压缩后的归属清理 +5. src/setup.ts — 初始化中的归属设置 +6. src/utils/attribution.ts — 归属核心 +7. src/utils/sessionRestore.ts — 会话恢复中的归属 +8. src/utils/shell/bashProvider.ts — Bash 提供者中的归属钩子（255 行） +9. src/utils/worktree.ts — 工作树中的归属处理（1,519 行） + +**启用所需操作**: 仅需将编译标志 `COMMIT_ATTRIBUTION` 设为 `true`。 + +--- + +## 7. ULTRAPLAN + +**编译时引用次数**: 10 +**功能描述**: 超级计划模式。提供增强版的计划功能，允许用户创建更详细、更结构化的执行计划。 +**分类**: COMPLETE +**启用条件**: 将 `ULTRAPLAN` 编译标志设为 `true` + +**核心实现文件**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/commands/ultraplan.tsx | 470 行 | 超级计划命令完整实现 | + +**引用该标志的文件（5 个）**: +1. src/commands.ts — 条件注册 `/ultraplan` 命令 +2. src/components/PromptInput/PromptInput.tsx — 提示输入中的超级计划处理 +3. src/components/permissions/ExitPlanModePermissionRequest/ExitPlanModePermissionRequest.tsx — 退出计划模式权限 +4. src/screens/REPL.tsx — REPL 中的超级计划集成 +5. src/utils/processUserInput/processUserInput.ts — 用户输入处理 + +**启用所需操作**: 仅需将编译标志 `ULTRAPLAN` 设为 `true`。 + +--- + +## 8. BASH_CLASSIFIER + +**编译时引用次数**: 49（单引号 45 + 双引号 4） +**功能描述**: Bash 命令分类器。对用户请求执行的 Bash 命令进行安全分类，决定是否需要用户确认。支持自动模式（YOLO mode）下的智能权限判断。 +**分类**: COMPLETE +**启用条件**: 将 `BASH_CLASSIFIER` 编译标志设为 `true` + +**实现分布**: 该功能的代码分布在权限系统、工具系统和 UI 组件的 19 个文件中，与现有权限架构深度集成。 + +**引用该标志的文件（20 个）**: +1. src/cli/structuredIO.ts — 结构化 IO 中的分类器输出 +2. src/components/messages/UserToolResultMessage/UserToolSuccessMessage.tsx — 工具成功消息中的分类器信息 +3. src/components/permissions/BashPermissionRequest/BashPermissionRequest.tsx — Bash 权限请求 UI +4. src/components/permissions/PermissionDecisionDebugInfo.tsx — 权限决策调试信息 +5. src/components/permissions/PermissionRuleExplanation.tsx — 权限规则解释 +6. src/components/permissions/hooks.ts — 权限 Hooks +7. src/hooks/toolPermission/PermissionContext.ts — 权限上下文 +8. src/hooks/toolPermission/handlers/coordinatorHandler.ts — 协调器权限处理 +9. src/hooks/toolPermission/handlers/interactiveHandler.ts — 交互式权限处理 +10. src/hooks/toolPermission/handlers/swarmWorkerHandler.ts — Swarm 工作者权限处理 +11. src/hooks/toolPermission/permissionLogging.ts — 权限日志 +12. src/hooks/useCanUseTool.tsx — 工具可用性检查 +13. src/services/api/withRetry.ts — API 重试中的分类器 +14. src/tools/BashTool/bashPermissions.ts — Bash 权限逻辑 +15. src/tools/BashTool/pathValidation.ts — 路径验证 +16. src/utils/classifierApprovals.ts — 分类器审批记录 +17. src/utils/messages.ts — 消息处理 +18. src/utils/permissions/permissions.ts — 权限核心 +19. src/utils/permissions/yoloClassifier.ts — YOLO 模式分类器 +20. src/utils/swarm/inProcessRunner.ts — 进程内运行器中的分类器 + +**启用所需操作**: 仅需将编译标志 `BASH_CLASSIFIER` 设为 `true`。 + +--- + +## 9. TRANSCRIPT_CLASSIFIER `[dev: ON]` + +**编译时引用次数**: 110（单引号 107 + 双引号 3） +**功能描述**: 转录分类器。这是引用次数第二多的标志，与自动模式（Auto Mode）权限系统深度集成。对整个对话转录进行分析，判断 AI 请求的工具调用是否安全。 +**分类**: COMPLETE +**启用条件**: 将 `TRANSCRIPT_CLASSIFIER` 编译标志设为 `true` + +**实现分布**: 该功能的代码分布在 44 个文件中，是除 KAIROS 外集成最广泛的功能。 + +**引用该标志的文件（44 个）**: +1. src/cli/print.ts — CLI 输出 +2. src/cli/structuredIO.ts — 结构化 IO +3. src/commands/login/login.tsx — 登录命令 +4. src/components/PromptInput/PromptInput.tsx — 提示输入 +5. src/components/Settings/Config.tsx — 设置配置 +6. src/components/messages/UserToolResultMessage/UserToolErrorMessage.tsx — 工具错误消息 +7. src/components/messages/UserToolResultMessage/UserToolSuccessMessage.tsx — 工具成功消息 +8. src/components/permissions/ExitPlanModePermissionRequest/ExitPlanModePermissionRequest.tsx — 退出计划模式权限 +9. src/components/permissions/PermissionDecisionDebugInfo.tsx — 权限决策调试 +10. src/components/permissions/PermissionRuleExplanation.tsx — 权限规则解释 +11. src/components/permissions/hooks.ts — 权限 Hooks +12. src/constants/betas.ts — Beta 常量 +13. src/hooks/notifs/useAutoModeUnavailableNotification.ts — 自动模式不可用通知 +14. src/hooks/toolPermission/PermissionContext.ts — 权限上下文 +15. src/hooks/toolPermission/handlers/interactiveHandler.ts — 交互式处理 +16. src/hooks/toolPermission/permissionLogging.ts — 权限日志 +17. src/hooks/useCanUseTool.tsx — 工具可用性 +18. src/hooks/useReplBridge.tsx — REPL 桥接 +19. src/interactiveHelpers.tsx — 交互帮助函数 +20. src/main.tsx — 主入口 +21. src/migrations/resetAutoModeOptInForDefaultOffer.ts — 迁移脚本 +22. src/screens/REPL.tsx — REPL 屏幕 +23. src/services/api/claude.ts — Claude API 服务 +24. src/services/tools/toolExecution.ts — 工具执行 +25. src/tools/AgentTool/AgentTool.tsx — Agent 工具 +26. src/tools/AgentTool/agentToolUtils.ts — Agent 工具工具函数 +27. src/tools/AgentTool/runAgent.ts — 运行 Agent +28. src/tools/BashTool/bashPermissions.ts — Bash 权限 +29. src/tools/ConfigTool/supportedSettings.ts — 支持的设置 +30. src/tools/ExitPlanModeTool/ExitPlanModeV2Tool.ts — 退出计划模式工具 +31. src/tools/NotebookEditTool/NotebookEditTool.ts — Notebook 编辑工具 +32. src/types/permissions.ts — 权限类型 +33. src/utils/attachments.ts — 附件处理 +34. src/utils/autoModeDenials.ts — 自动模式拒绝 +35. src/utils/betas.ts — Beta 工具 +36. src/utils/classifierApprovals.ts — 分类器审批 +37. src/utils/permissions/PermissionMode.ts — 权限模式 +38. src/utils/permissions/autoModeState.ts — 自动模式状态 +39. src/utils/permissions/bypassPermissionsKillswitch.ts — 绕过权限 Kill Switch +40. src/utils/permissions/getNextPermissionMode.ts — 获取下一个权限模式 +41. src/utils/permissions/permissionSetup.ts — 权限设置 +42. src/utils/permissions/permissions.ts — 权限核心 +43. src/utils/permissions/yoloClassifier.ts — YOLO 分类器 +44. src/utils/settings/settings.ts — 设置 +45. src/utils/settings/types.ts — 设置类型 +46. src/utils/toolResultStorage.ts — 工具结果存储 + +**启用所需操作**: 仅需将编译标志 `TRANSCRIPT_CLASSIFIER` 设为 `true`。 + +--- + +## 10. EXTRACT_MEMORIES + +**编译时引用次数**: 7 +**功能描述**: 记忆提取功能。从对话中自动提取有用的记忆信息并保存到记忆文件中。 +**分类**: COMPLETE +**启用条件**: 将 `EXTRACT_MEMORIES` 编译标志设为 `true` + +**核心实现文件（共 769 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/services/extractMemories/extractMemories.ts | 615 行 | 记忆提取核心算法 | +| src/services/extractMemories/prompts.ts | 154 行 | 记忆提取的 AI 提示词 | + +**引用该标志的文件（4 个）**: +1. src/cli/print.ts — CLI 输出中的记忆提取信息 +2. src/memdir/paths.ts — 记忆目录路径 +3. src/query/stopHooks.ts — 查询停止钩子中触发记忆提取 +4. src/utils/backgroundHousekeeping.ts — 后台维护中的记忆提取 + +**启用所需操作**: 仅需将编译标志 `EXTRACT_MEMORIES` 设为 `true`。 + +--- + +## 11. CACHED_MICROCOMPACT + +**编译时引用次数**: 12 +**功能描述**: 缓存微压缩功能。在对话压缩时使用缓存策略优化性能。 +**分类**: COMPLETE +**启用条件**: 将 `CACHED_MICROCOMPACT` 编译标志设为 `true` + +**实现文件**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/services/compact/microCompact.ts | 530 行 | 微压缩核心实现 | + +**引用该标志的文件（5 个）**: +1. src/constants/prompts.ts — 提示词常量 +2. src/query.ts — 查询引擎 +3. src/services/api/claude.ts — Claude API 服务 +4. src/services/api/logging.ts — API 日志 +5. src/services/compact/microCompact.ts — 微压缩核心 + +**启用所需操作**: 仅需将编译标志 `CACHED_MICROCOMPACT` 设为 `true`。 + +--- + +## 12. TOKEN_BUDGET `[build: ON] [dev: ON]` *NEW* + +**编译时引用次数**: 9 +**功能描述**: Token 预算管理。允许设置和跟踪 token 使用预算，在接近限制时提供警告。 +**分类**: COMPLETE +**启用条件**: 将 `TOKEN_BUDGET` 编译标志设为 `true` + +**核心实现文件（共 166 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/utils/tokenBudget.ts | 73 行 | Token 预算核心逻辑 | +| src/query/tokenBudget.ts | 93 行 | 查询层的 Token 预算管理 | + +**引用该标志的文件（6 个）**: +1. src/components/PromptInput/PromptInput.tsx — 提示输入中的预算显示 +2. src/components/Spinner.tsx — 加载指示器中的预算信息 +3. src/constants/prompts.ts — 提示词中的预算指令 +4. src/query.ts — 查询引擎中的预算检查 +5. src/screens/REPL.tsx — REPL 中的预算集成 +6. src/utils/attachments.ts — 附件处理中的预算计算 + +**启用所需操作**: 仅需将编译标志 `TOKEN_BUDGET` 设为 `true`。 + +--- + +## 13. AGENT_TRIGGERS + +**编译时引用次数**: 11 +**功能描述**: 代理触发器/定时任务。允许 AI 创建、管理和执行 cron 定时任务。 +**分类**: COMPLETE +**启用条件**: 将 `AGENT_TRIGGERS` 编译标志设为 `true` + +**核心实现文件（共 543 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/tools/ScheduleCronTool/CronCreateTool.ts | 157 行 | Cron 创建工具 | +| src/tools/ScheduleCronTool/prompt.ts | 135 行 | Cron 工具提示词 | +| src/tools/ScheduleCronTool/CronListTool.ts | 97 行 | Cron 列表工具 | +| src/tools/ScheduleCronTool/CronDeleteTool.ts | 95 行 | Cron 删除工具 | +| src/tools/ScheduleCronTool/UI.tsx | 59 行 | Cron UI 组件 | + +**引用该标志的文件（6 个）**: +1. src/cli/print.ts — CLI 输出 +2. src/constants/tools.ts — 工具常量 +3. src/screens/REPL.tsx — REPL 集成 +4. src/skills/bundled/index.ts — 内置技能 +5. src/tools.ts — 工具注册 +6. src/tools/ScheduleCronTool/prompt.ts — Cron 提示词 + +**启用所需操作**: 仅需将编译标志 `AGENT_TRIGGERS` 设为 `true`。 + +--- + +## 14. REACTIVE_COMPACT + +**编译时引用次数**: 5（单引号 4 + 双引号 1） +**功能描述**: 响应式压缩。根据上下文使用情况动态触发对话压缩。 +**分类**: COMPLETE +**启用条件**: 将 `REACTIVE_COMPACT` 编译标志设为 `true` + +**实现文件（压缩服务已完整，共 2,586 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/services/compact/compact.ts | 1,705 行 | 压缩核心逻辑 | +| src/services/compact/microCompact.ts | 530 行 | 微压缩 | +| src/services/compact/autoCompact.ts | 351 行 | 自动压缩触发 | + +**引用该标志的文件（5 个）**: +1. src/commands/compact/compact.ts — 压缩命令 +2. src/components/TokenWarning.tsx — Token 警告 +3. src/query.ts — 查询引擎 +4. src/services/compact/autoCompact.ts — 自动压缩 +5. src/utils/analyzeContext.ts — 上下文分析 + +**启用所需操作**: 仅需将编译标志 `REACTIVE_COMPACT` 设为 `true`。 + +--- + +## 15. KAIROS_BRIEF + +**编译时引用次数**: 39 +**功能描述**: Kairos Brief 功能。提供简报工具，允许 AI 生成和管理项目简报。 +**分类**: COMPLETE +**启用条件**: 将 `KAIROS_BRIEF` 编译标志设为 `true` + +**核心实现文件（共 334 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/tools/BriefTool/BriefTool.ts | 204 行 | Brief 工具核心 | +| src/commands/brief.ts | 130 行 | Brief 命令实现 | + +**引用该标志的文件（20 个）**: +1. src/commands.ts — 命令注册 +2. src/commands/brief.ts — Brief 命令 +3. src/components/Messages.tsx — 消息组件 +4. src/components/PromptInput/Notifications.tsx — 通知 +5. src/components/PromptInput/PromptInput.tsx — 提示输入 +6. src/components/PromptInput/PromptInputQueuedCommands.tsx — 排队命令 +7. src/components/Settings/Config.tsx — 设置 +8. src/components/Spinner.tsx — 加载指示器 +9. src/components/messages/UserPromptMessage.tsx — 用户提示消息 +10. src/components/messages/UserToolResultMessage/UserToolSuccessMessage.tsx — 工具成功消息 +11. src/constants/prompts.ts — 提示词 +12. src/hooks/useGlobalKeybindings.tsx — 全局键绑定 +13. src/keybindings/defaultBindings.ts — 默认键绑定 +14. src/main.tsx — 主入口 +15. src/tools/BriefTool/BriefTool.ts — Brief 工具 +16. src/tools/ToolSearchTool/prompt.ts — 工具搜索提示 +17. src/utils/attachments.ts — 附件 +18. src/utils/conversationRecovery.ts — 对话恢复 +19. src/utils/permissions/permissionRuleParser.ts — 权限规则解析 +20. src/utils/settings/types.ts — 设置类型 + +**启用所需操作**: 仅需将编译标志 `KAIROS_BRIEF` 设为 `true`。 + +--- + +## 16. CCR_REMOTE_SETUP + +**编译时引用次数**: 1 +**功能描述**: CCR（Claude Code Remote）远程设置命令。 +**分类**: COMPLETE +**启用条件**: 将 `CCR_REMOTE_SETUP` 编译标志设为 `true` + +**引用该标志的文件（1 个）**: +1. src/commands.ts — 条件注册远程设置命令 + +**启用所需操作**: 仅需将编译标志 `CCR_REMOTE_SETUP` 设为 `true`。命令文件通过条件 require 加载。 + +--- + +## 17. SHOT_STATS `[build: ON] [dev: ON]` *NEW* + +**编译时引用次数**: 10 +**功能描述**: 统计功能。提供详细的会话统计信息，包括 token 使用、工具调用、时间统计等，带有完整的 UI 面板。 +**分类**: COMPLETE +**启用条件**: 将 `SHOT_STATS` 编译标志设为 `true` + +**核心实现文件（共 2,722 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/components/Stats.tsx | 1,227 行 | 统计 UI 组件 | +| src/utils/stats.ts | 1,061 行 | 统计核心逻辑 | +| src/utils/statsCache.ts | 434 行 | 统计缓存 | + +**引用该标志的文件（3 个）**: +1. src/components/Stats.tsx — 统计 UI +2. src/utils/stats.ts — 统计核心 +3. src/utils/statsCache.ts — 统计缓存 + +**启用所需操作**: 仅需将编译标志 `SHOT_STATS` 设为 `true`。 + +--- + +## 18. BG_SESSIONS + +**编译时引用次数**: 11 +**功能描述**: 后台会话功能。支持对话恢复和并发会话管理，允许会话在后台继续运行。 +**分类**: COMPLETE +**启用条件**: 将 `BG_SESSIONS` 编译标志设为 `true` + +**核心实现文件（共 801 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/utils/conversationRecovery.ts | 597 行 | 对话恢复逻辑 | +| src/utils/concurrentSessions.ts | 204 行 | 并发会话管理 | + +**引用该标志的文件（7 个）**: +1. src/commands/exit/exit.tsx — 退出命令中的后台会话处理 +2. src/entrypoints/cli.tsx — CLI 入口中的后台会话 +3. src/main.tsx — 主入口 +4. src/query.ts — 查询引擎 +5. src/screens/REPL.tsx — REPL 集成 +6. src/utils/concurrentSessions.ts — 并发会话 +7. src/utils/conversationRecovery.ts — 对话恢复 + +**启用所需操作**: 仅需将编译标志 `BG_SESSIONS` 设为 `true`。 + +--- + +## 19. PROACTIVE + +**编译时引用次数**: 37 +**功能描述**: 主动模式。AI 可以在没有用户输入的情况下主动发起操作或建议。 +**分类**: COMPLETE +**启用条件**: 将 `PROACTIVE` 编译标志设为 `true` + +**核心实现文件（共 63 行，注意：大部分逻辑与 KAIROS 共享，通过 `feature('PROACTIVE') || feature('KAIROS')` 模式门控）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/proactive/index.ts | 57 行 | 主动模式入口 | +| src/proactive/useProactive.ts | 6 行 | 主动模式 Hook | + +**引用该标志的文件（15 个）**: +1. src/cli/print.ts — CLI 输出 +2. src/commands.ts — 命令注册（`feature('PROACTIVE') || feature('KAIROS')`） +3. src/commands/clear/conversation.ts — 清除对话 +4. src/components/Messages.tsx — 消息组件 +5. src/components/PromptInput/PromptInputFooterLeftSide.tsx — 页脚 +6. src/components/PromptInput/usePromptInputPlaceholder.ts — 输入占位符 +7. src/constants/prompts.ts — 提示词 +8. src/main.tsx — 主入口 +9. src/screens/REPL.tsx — REPL（多处引用，通过 require 加载 proactive 模块） +10. src/services/compact/prompt.ts — 压缩提示 +11. src/tools.ts — 工具注册 +12. src/tools/AgentTool/AgentTool.tsx — Agent 工具 +13. src/utils/sessionStorage.ts — 会话存储 +14. src/utils/settings/types.ts — 设置类型 +15. src/utils/systemPrompt.ts — 系统提示 + +**特殊说明**: PROACTIVE 在代码中几乎总是与 KAIROS 一起使用（`feature('PROACTIVE') || feature('KAIROS')`），意味着启用 KAIROS 也会启用主动功能。PROACTIVE 模块文件（src/proactive/）存在且有内容。 + +**启用所需操作**: 仅需将编译标志 `PROACTIVE` 设为 `true`。 + +--- + +## 20. CHICAGO_MCP `[build: ON] [dev: ON]` + +**编译时引用次数**: 16 +**功能描述**: Chicago MCP（Computer Use 计算机使用）。集成计算机使用功能，允许 AI 控制桌面应用程序。 +**分类**: COMPLETE +**启用条件**: 将 `CHICAGO_MCP` 编译标志设为 `true` + +**核心实现文件（共 421 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/utils/computerUse/wrapper.tsx | 335 行 | 计算机使用包装器 | +| src/utils/computerUse/cleanup.ts | 86 行 | 计算机使用清理 | + +**引用该标志的文件（10 个）**: +1. src/entrypoints/cli.tsx — CLI 入口 +2. src/main.tsx — 主入口 +3. src/query.ts — 查询引擎 +4. src/query/stopHooks.ts — 停止钩子 +5. src/services/analytics/metadata.ts — 分析元数据 +6. src/services/mcp/client.ts — MCP 客户端 +7. src/services/mcp/config.ts — MCP 配置 +8. src/state/AppStateStore.ts — 应用状态 +9. src/utils/computerUse/cleanup.ts — 清理 +10. src/utils/computerUse/wrapper.tsx — 包装器 + +**启用所需操作**: 仅需将编译标志 `CHICAGO_MCP` 设为 `true`。 + +--- + +## 21. VERIFICATION_AGENT + +**编译时引用次数**: 4 +**功能描述**: 验证代理。内置代理类型，用于验证任务执行结果的正确性。 +**分类**: COMPLETE +**启用条件**: 将 `VERIFICATION_AGENT` 编译标志设为 `true` + +**核心实现文件（共 478 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/tools/TaskUpdateTool/TaskUpdateTool.ts | 406 行 | 任务更新工具 | +| src/tools/AgentTool/builtInAgents.ts | 72 行 | 内置代理定义 | + +**引用该标志的文件（4 个）**: +1. src/constants/prompts.ts — 提示词 +2. src/tools/AgentTool/builtInAgents.ts — 内置代理 +3. src/tools/TaskUpdateTool/TaskUpdateTool.ts — 任务更新工具 +4. src/tools/TodoWriteTool/TodoWriteTool.ts — TodoWrite 工具 + +**启用所需操作**: 仅需将编译标志 `VERIFICATION_AGENT` 设为 `true`。 + +--- + +## 22. PROMPT_CACHE_BREAK_DETECTION `[build: ON] [dev: ON]` *NEW* + +**编译时引用次数**: 9 +**功能描述**: 提示缓存中断检测。检测提示缓存是否被意外破坏，并在压缩时考虑缓存状态。 +**分类**: COMPLETE +**启用条件**: 将 `PROMPT_CACHE_BREAK_DETECTION` 编译标志设为 `true` + +**引用该标志的文件（6 个）**: +1. src/commands/compact/compact.ts — 压缩命令 +2. src/services/api/claude.ts — Claude API 服务 +3. src/services/compact/autoCompact.ts — 自动压缩 +4. src/services/compact/compact.ts — 压缩核心 +5. src/services/compact/microCompact.ts — 微压缩 +6. src/tools/AgentTool/runAgent.ts — 运行 Agent + +**启用所需操作**: 仅需将编译标志 `PROMPT_CACHE_BREAK_DETECTION` 设为 `true`。 + +--- + +# 二、PARTIAL（部分实现）— 共 19 个 + +以下标志有实质性的功能代码，但存在缺失的文件（命令入口、组件等）或关键模块仅有空壳。启用后可能报错或功能不完整。 + +--- + +## 23. KAIROS + +**编译时引用次数**: 156（单引号 154 + 双引号 2） +**功能描述**: Kairos 是 Claude Code 最大的功能集合。它是一个综合性平台功能，涵盖频道通知、主动模式、简报、GitHub Webhook、推送通知等多个子系统。几乎贯穿整个代码库。 +**分类**: PARTIAL +**缺失原因**: `src/commands/assistant/` 目录完全缺失（包括 `index.ts` 和 `gate.ts`），但 `src/commands.ts` 中通过条件 require 引用了 `commands/assistant/index.js` + +**引用该标志的文件（59 个）**: +1. src/bridge/bridgeMain.ts +2. src/bridge/initReplBridge.ts +3. src/cli/print.ts +4. src/commands.ts +5. src/commands/bridge/bridge.tsx +6. src/commands/brief.ts +7. src/commands/clear/conversation.ts +8. src/components/LogoV2/ChannelsNotice.tsx +9. src/components/LogoV2/LogoV2.tsx +10. src/components/Messages.tsx +11. src/components/PromptInput/Notifications.tsx +12. src/components/PromptInput/PromptInput.tsx +13. src/components/PromptInput/PromptInputFooterLeftSide.tsx +14. src/components/PromptInput/PromptInputQueuedCommands.tsx +15. src/components/PromptInput/usePromptInputPlaceholder.ts +16. src/components/Settings/Config.tsx +17. src/components/Spinner.tsx +18. src/components/StatusLine.tsx +19. src/components/messages/UserPromptMessage.tsx +20. src/components/messages/UserTextMessage.tsx +21. src/components/messages/UserToolResultMessage/UserToolSuccessMessage.tsx +22. src/constants/prompts.ts +23. src/hooks/toolPermission/handlers/interactiveHandler.ts +24. src/hooks/useAssistantHistory.ts +25. src/hooks/useCanUseTool.tsx +26. src/hooks/useGlobalKeybindings.tsx +27. src/hooks/useReplBridge.tsx +28. src/interactiveHelpers.tsx +29. src/keybindings/defaultBindings.ts +30. src/main.tsx +31. src/memdir/memdir.ts +32. src/memdir/paths.ts +33. src/screens/REPL.tsx +34. src/services/analytics/metadata.ts +35. src/services/compact/compact.ts +36. src/services/compact/prompt.ts +37. src/services/mcp/channelNotification.ts +38. src/services/mcp/useManageMCPConnections.ts +39. src/skills/bundled/index.ts +40. src/tools.ts +41. src/tools/AgentTool/AgentTool.tsx +42. src/tools/AskUserQuestionTool/AskUserQuestionTool.tsx +43. src/tools/BashTool/BashTool.tsx +44. src/tools/BriefTool/BriefTool.ts +45. src/tools/ConfigTool/supportedSettings.ts +46. src/tools/EnterPlanModeTool/EnterPlanModeTool.ts +47. src/tools/ExitPlanModeTool/ExitPlanModeV2Tool.ts +48. src/tools/PowerShellTool/PowerShellTool.tsx +49. src/tools/ScheduleCronTool/prompt.ts +50. src/tools/ToolSearchTool/prompt.ts +51. src/utils/attachments.ts +52. src/utils/conversationRecovery.ts +53. src/utils/messageQueueManager.ts +54. src/utils/messages.ts +55. src/utils/permissions/permissionRuleParser.ts +56. src/utils/processUserInput/processSlashCommand.tsx +57. src/utils/sessionStorage.ts +58. src/utils/settings/types.ts +59. src/utils/systemPrompt.ts + +**缺失文件**: +- src/commands/assistant/index.ts — 完全缺失（src/commands.ts 第 69 行引用了 `commands/assistant/index.js`） +- src/commands/assistant/gate.ts — 完全缺失 + +**启用所需修复**: 需要创建 `src/commands/assistant/` 目录及其 `index.ts` 和 `gate.ts` 文件。 + +--- + +## 24. BUDDY `[dev: ON]` + +**编译时引用次数**: 18（单引号 16 + 双引号 2） +**功能描述**: 伙伴精灵功能。在 CLI 中显示一个可爱的像素精灵角色作为 AI 助手的化身，有动画、表情、通知等。 +**分类**: PARTIAL +**缺失原因**: `src/commands/buddy/index.ts` 命令入口文件缺失，但 `src/buddy/` 目录下有完整的 1,298 行实现代码 + +**核心实现文件（src/buddy/ 目录，共 1,298 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/buddy/sprites.ts | 514 行 | 精灵图形定义 | +| src/buddy/CompanionSprite.tsx | 370 行 | 精灵 React 组件 | +| src/buddy/types.ts | 148 行 | 类型定义 | +| src/buddy/companion.ts | 133 行 | 伙伴核心逻辑 | +| src/buddy/useBuddyNotification.tsx | 97 行 | 伙伴通知 Hook | +| src/buddy/prompt.ts | 36 行 | 伙伴提示词 | + +**引用该标志的文件（8 个）**: +1. src/buddy/CompanionSprite.tsx — 精灵组件 +2. src/buddy/prompt.ts — 提示词 +3. src/buddy/useBuddyNotification.tsx — 通知 +4. src/commands.ts — 条件注册 `/buddy` 命令（引用 `commands/buddy/index.js`） +5. src/components/PromptInput/PromptInput.tsx — 提示输入 +6. src/screens/REPL.tsx — REPL 集成 +7. src/utils/attachments.ts — 附件 + +**缺失文件**: +- src/commands/buddy/index.ts — 命令入口缺失 + +**启用所需修复**: 需要创建 `src/commands/buddy/index.ts` 命令入口文件。 + +--- + +## 25. MONITOR_TOOL + +**编译时引用次数**: 13 +**功能描述**: 监控工具。允许 AI 在后台启动长时间运行的 shell 任务并监控其输出。 +**分类**: PARTIAL +**缺失原因**: MonitorMcpDetailDialog 和 MonitorPermissionRequest 文件虽然存在但仅有 3 行空壳 + +**核心实现文件**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/tasks/LocalShellTask/LocalShellTask.tsx | 522 行 | 本地 Shell 任务完整实现 | +| src/tools/MonitorTool/MonitorTool.ts | 1 行 | 监控工具（桩） | +| src/tasks/MonitorMcpTask/MonitorMcpTask.ts | 5 行 | MCP 监控任务（桩） | +| src/components/tasks/MonitorMcpDetailDialog.tsx | 3 行 | MCP 详情对话框（桩） | +| src/components/permissions/MonitorPermissionRequest/MonitorPermissionRequest.tsx | 3 行 | 监控权限请求（桩） | + +**引用该标志的文件（9 个）**: +1. src/components/permissions/PermissionRequest.tsx — 权限请求 +2. src/components/tasks/BackgroundTasksDialog.tsx — 后台任务对话框 +3. src/tasks.ts — 任务注册 +4. src/tasks/LocalShellTask/LocalShellTask.tsx — Shell 任务 +5. src/tools.ts — 工具注册 +6. src/tools/AgentTool/runAgent.ts — Agent 运行 +7. src/tools/BashTool/BashTool.tsx — Bash 工具 +8. src/tools/BashTool/prompt.ts — Bash 提示 +9. src/tools/PowerShellTool/PowerShellTool.tsx — PowerShell 工具 + +**启用所需修复**: 需要实现 `src/tools/MonitorTool/MonitorTool.ts`、`src/tasks/MonitorMcpTask/MonitorMcpTask.ts`、`src/components/tasks/MonitorMcpDetailDialog.tsx` 和 `src/components/permissions/MonitorPermissionRequest/MonitorPermissionRequest.tsx`。 + +--- + +## 26. HISTORY_SNIP + +**编译时引用次数**: 16（单引号 15 + 双引号 1） +**功能描述**: 历史剪辑。允许从对话历史中剪切特定片段。 +**分类**: PARTIAL +**缺失原因**: `src/commands/force-snip.ts` 命令文件缺失 + +**引用该标志的文件（8 个）**: +1. src/QueryEngine.ts — 查询引擎 +2. src/commands.ts — 命令注册（引用 `commands/force-snip.js`） +3. src/components/Message.tsx — 消息组件 +4. src/query.ts — 查询 +5. src/tools.ts — 工具注册 +6. src/utils/attachments.ts — 附件 +7. src/utils/collapseReadSearch.ts — 折叠读取搜索 +8. src/utils/messages.ts — 消息处理 + +**缺失文件**: +- src/commands/force-snip.ts — 命令文件缺失 + +**启用所需修复**: 需要创建 `src/commands/force-snip.ts`。 + +--- + +## 27. WORKFLOW_SCRIPTS + +**编译时引用次数**: 10 +**功能描述**: 工作流脚本。允许定义和执行自定义工作流。 +**分类**: PARTIAL +**缺失原因**: 多个核心文件仅有 1-5 行空壳，命令入口目录缺失 + +**实现文件（大部分为空壳）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/components/WorkflowMultiselectDialog.tsx | 127 行 | 工作流多选对话框（有内容） | +| src/tasks/LocalWorkflowTask/LocalWorkflowTask.ts | 5 行 | 本地工作流任务（桩） | +| src/components/tasks/WorkflowDetailDialog.tsx | 3 行 | 工作流详情对话框（桩） | +| src/tools/WorkflowTool/WorkflowPermissionRequest.tsx | 3 行 | 工作流权限请求（桩） | +| src/tools/WorkflowTool/createWorkflowCommand.ts | 3 行 | 创建工作流命令（桩） | +| src/tools/WorkflowTool/WorkflowTool.ts | 1 行 | 工作流工具（桩） | +| src/tools/WorkflowTool/constants.ts | 1 行 | 常量（桩） | + +**引用该标志的文件（7 个）**: +1. src/commands.ts — 命令注册（引用 `commands/workflows/index.js`） +2. src/components/permissions/PermissionRequest.tsx — 权限请求 +3. src/components/tasks/BackgroundTasksDialog.tsx — 后台任务 +4. src/constants/tools.ts — 工具常量 +5. src/tasks.ts — 任务注册 +6. src/tools.ts — 工具注册 +7. src/utils/permissions/classifierDecision.ts — 分类器决策 + +**缺失文件**: +- src/commands/workflows/index.ts — 命令入口目录缺失 + +**启用所需修复**: 需要实现所有空壳文件并创建命令入口。 + +--- + +## 28. UDS_INBOX + +**编译时引用次数**: 18（单引号 17 + 双引号 1） +**功能描述**: UDS（Unix Domain Socket）收件箱。允许 Claude Code 实例之间通过 Unix 套接字发送消息。 +**分类**: PARTIAL +**缺失原因**: `src/utils/udsMessaging.ts` 仅 1 行，`src/utils/udsClient.ts` 仅 3 行（空壳），命令入口缺失 + +**核心实现文件**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/tools/SendMessageTool/SendMessageTool.ts | 917 行 | 发送消息工具（完整实现） | +| src/tools/SendMessageTool/prompt.ts | 49 行 | 消息工具提示词 | +| src/utils/udsClient.ts | 3 行 | UDS 客户端（桩） | +| src/utils/udsMessaging.ts | 1 行 | UDS 消息（桩） | + +**引用该标志的文件（10 个）**: +1. src/cli/print.ts — CLI 输出 +2. src/commands.ts — 命令注册（引用 `commands/peers/index.js`） +3. src/components/messages/UserTextMessage.tsx — 用户消息 +4. src/main.tsx — 主入口 +5. src/setup.ts — 初始化 +6. src/tools.ts — 工具注册 +7. src/tools/SendMessageTool/SendMessageTool.ts — 发送消息工具 +8. src/tools/SendMessageTool/prompt.ts — 提示词 +9. src/utils/concurrentSessions.ts — 并发会话 +10. src/utils/messages/systemInit.ts — 系统初始化消息 + +**缺失文件**: +- src/commands/peers/index.ts — 命令入口缺失 +- src/utils/udsMessaging.ts — 仅 1 行空壳 +- src/utils/udsClient.ts — 仅 3 行空壳 + +**启用所需修复**: 需要实现 UDS 客户端和消息模块，并创建命令入口。 + +--- + +## 29. KAIROS_CHANNELS + +**编译时引用次数**: 21（单引号 19 + 双引号 2） +**功能描述**: Kairos 频道功能。MCP 频道通知系统。 +**分类**: PARTIAL +**缺失原因**: 依赖 KAIROS 的 assistant/gate.ts 模块 + +**核心实现文件（共 581 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/services/mcp/channelNotification.ts | 316 行 | 频道通知服务 | +| src/components/LogoV2/ChannelsNotice.tsx | 265 行 | 频道通知 UI | + +**引用该标志的文件（15 个）**: +1. src/cli/print.ts +2. src/components/LogoV2/ChannelsNotice.tsx +3. src/components/LogoV2/LogoV2.tsx +4. src/components/messages/UserTextMessage.tsx +5. src/hooks/toolPermission/handlers/interactiveHandler.ts +6. src/hooks/useCanUseTool.tsx +7. src/interactiveHelpers.tsx +8. src/main.tsx +9. src/services/mcp/channelNotification.ts +10. src/services/mcp/useManageMCPConnections.ts +11. src/tools/AskUserQuestionTool/AskUserQuestionTool.tsx +12. src/tools/EnterPlanModeTool/EnterPlanModeTool.ts +13. src/tools/ExitPlanModeTool/ExitPlanModeV2Tool.ts +14. src/utils/messageQueueManager.ts +15. src/utils/messages.ts + +**启用所需修复**: 需先修复 KAIROS 的缺失文件。 + +--- + +## 30. FORK_SUBAGENT + +**编译时引用次数**: 5（单引号 4 + 双引号 1） +**功能描述**: 分叉子代理。允许从当前会话分叉出独立的子代理进程。 +**分类**: PARTIAL +**缺失原因**: `src/commands/fork/index.ts` 命令入口缺失（注意：代码中引用的是 `commands/branch/index.js`，而 `src/commands/branch/index.ts` 存在） + +**核心实现文件**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/tools/AgentTool/forkSubagent.ts | 210 行 | 分叉子代理核心逻辑 | + +**引用该标志的文件（5 个）**: +1. src/commands.ts — 命令注册 +2. src/commands/branch/index.ts — 分支命令入口 +3. src/components/messages/UserTextMessage.tsx — 用户消息 +4. src/tools/AgentTool/forkSubagent.ts — 分叉逻辑 +5. src/tools/ToolSearchTool/prompt.ts — 工具搜索提示 + +**缺失文件**: +- src/commands/fork/index.ts — 命令入口缺失（但 branch/index.ts 存在，可能是重命名） + +**启用所需修复**: 需确认命令入口路径是否正确。 + +--- + +## 31. EXPERIMENTAL_SKILL_SEARCH + +**编译时引用次数**: 21 +**功能描述**: 实验性技能搜索。本地技能搜索功能。 +**分类**: PARTIAL +**缺失原因**: 核心搜索逻辑可能不完整（SkillTool.ts 有 1,108 行但 localSearch 功能可能缺失） + +**引用该标志的文件（9 个）**: +1. src/commands.ts — 命令注册 +2. src/components/messages/AttachmentMessage.tsx — 附件消息 +3. src/constants/prompts.ts — 提示词 +4. src/query.ts — 查询 +5. src/services/compact/compact.ts — 压缩 +6. src/services/mcp/useManageMCPConnections.ts — MCP 连接管理 +7. src/tools/SkillTool/SkillTool.ts — 技能工具（1,108 行） +8. src/utils/attachments.ts — 附件 +9. src/utils/messages.ts — 消息 + +--- + +## 32. WEB_BROWSER_TOOL + +**编译时引用次数**: 4 +**功能描述**: Web 浏览器工具。允许 AI 在面板中打开和操作网页。 +**分类**: PARTIAL +**缺失原因**: `src/tools/WebBrowserTool/WebBrowserPanel.tsx` 仅 3 行，返回 `null` + +**实现文件**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/tools/WebBrowserTool/WebBrowserPanel.tsx | 3 行 | `export function WebBrowserPanel() { return null }` | + +**引用该标志的文件（3 个）**: +1. src/main.tsx — 主入口 +2. src/screens/REPL.tsx — REPL +3. src/tools.ts — 工具注册 + +**启用所需修复**: 需要实现 `WebBrowserPanel.tsx`。 + +--- + +## 33. MCP_SKILLS + +**编译时引用次数**: 9 +**功能描述**: MCP 技能系统。通过 MCP 协议加载和运行技能。 +**分类**: PARTIAL + +**实现文件**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/skills/mcpSkillBuilders.ts | 44 行 | MCP 技能构建器 | +| src/skills/mcpSkills.ts | 3 行 | MCP 技能（桩） | + +**引用该标志的文件（3 个）**: +1. src/commands.ts — 命令注册 +2. src/services/mcp/client.ts — MCP 客户端 +3. src/services/mcp/useManageMCPConnections.ts — MCP 连接管理 + +--- + +## 34. REVIEW_ARTIFACT + +**编译时引用次数**: 4 +**功能描述**: 审查工件。允许 AI 审查和标注工件（代码片段、文档等）。 +**分类**: PARTIAL +**缺失原因**: ReviewArtifactTool.ts 仅 1 行，ReviewArtifactPermissionRequest.tsx 仅 3 行 + +**实现文件**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/tools/ReviewArtifactTool/ReviewArtifactTool.ts | 1 行 | 审查工件工具（桩） | +| src/components/permissions/ReviewArtifactPermissionRequest/ReviewArtifactPermissionRequest.tsx | 3 行 | 权限请求（桩） | + +**引用该标志的文件（2 个）**: +1. src/components/permissions/PermissionRequest.tsx — 权限请求 +2. src/skills/bundled/index.ts — 内置技能 + +--- + +## 35. KAIROS_GITHUB_WEBHOOKS + +**编译时引用次数**: 4（单引号 3 + 双引号 1） +**功能描述**: Kairos GitHub Webhooks。订阅 GitHub PR 活动的 Webhook。 +**分类**: PARTIAL +**缺失原因**: `src/commands/subscribe-pr.ts` 命令文件缺失 + +**引用该标志的文件（4 个）**: +1. src/commands.ts — 命令注册（引用 `commands/subscribe-pr.js`） +2. src/components/messages/UserTextMessage.tsx — 用户消息 +3. src/hooks/useReplBridge.tsx — REPL 桥接 +4. src/tools.ts — 工具注册 + +**缺失文件**: +- src/commands/subscribe-pr.ts — 命令文件缺失 + +--- + +## 36. CONNECTOR_TEXT + +**编译时引用次数**: 8（单引号 7 + 双引号 1） +**功能描述**: 连接器文本。控制消息中的连接器文本显示方式。 +**分类**: PARTIAL + +**引用该标志的文件（5 个）**: +1. src/components/Message.tsx — 消息组件 +2. src/constants/betas.ts — Beta 常量 +3. src/services/api/claude.ts — Claude API +4. src/services/api/logging.ts — API 日志 +5. src/utils/messages.ts — 消息处理 + +--- + +## 37. TEMPLATES + +**编译时引用次数**: 6 +**功能描述**: 模板系统。支持从 Markdown 配置文件加载模板。 +**分类**: PARTIAL + +**实现文件**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/utils/markdownConfigLoader.ts | 600 行 | Markdown 配置加载器 | +| src/keybindings/template.ts | 52 行 | 模板键绑定 | + +**引用该标志的文件（5 个）**: +1. src/entrypoints/cli.tsx — CLI 入口 +2. src/query.ts — 查询 +3. src/query/stopHooks.ts — 停止钩子 +4. src/utils/markdownConfigLoader.ts — 配置加载器 +5. src/utils/permissions/filesystem.ts — 文件系统权限 + +--- + +## 38. LODESTONE + +**编译时引用次数**: 6 +**功能描述**: Lodestone 功能。具体功能不明确，可能与导航或指引相关。 +**分类**: PARTIAL + +**引用该标志的文件（4 个）**: +1. src/interactiveHelpers.tsx — 交互帮助 +2. src/main.tsx — 主入口 +3. src/utils/backgroundHousekeeping.ts — 后台维护 +4. src/utils/settings/types.ts — 设置类型 + +**说明**: 没有专属实现文件，代码散布在 4 个文件中。 + +--- + +## 39. HISTORY_PICKER + +**编译时引用次数**: 4 +**功能描述**: 历史选择器。交互式历史搜索和选择。 +**分类**: PARTIAL + +**实现文件**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/hooks/useHistorySearch.ts | 303 行 | 历史搜索 Hook | + +**引用该标志的文件（2 个）**: +1. src/components/PromptInput/PromptInput.tsx — 提示输入 +2. src/hooks/useHistorySearch.ts — 历史搜索 + +--- + +## 40. MESSAGE_ACTIONS + +**编译时引用次数**: 5 +**功能描述**: 消息操作。对消息执行操作（如复制、编辑、重试等）。 +**分类**: PARTIAL + +**引用该标志的文件（2 个）**: +1. src/keybindings/defaultBindings.ts — 默认键绑定 +2. src/screens/REPL.tsx — REPL + +--- + +## 41. TERMINAL_PANEL + +**编译时引用次数**: 5（单引号 4 + 双引号 1） +**功能描述**: 终端面板。在 UI 中显示内嵌终端面板。 +**分类**: PARTIAL + +**引用该标志的文件（5 个）**: +1. src/components/PromptInput/PromptInputHelpMenu.tsx — 帮助菜单 +2. src/hooks/useGlobalKeybindings.tsx — 全局键绑定 +3. src/keybindings/defaultBindings.ts — 默认键绑定 +4. src/tools.ts — 工具注册 +5. src/utils/permissions/classifierDecision.ts — 分类器决策 + +--- + +# 三、STUB（纯桩/最小实现）— 共 51 个 + +以下标志仅有极少的引用（通常 1-3 处），没有或几乎没有实际功能代码。代码只是为该标志预留了位置。 + +--- + +## 42. TORCH + +**编译时引用次数**: 1 +**功能描述**: Torch 功能（具体不明）。 +**分类**: STUB +**引用文件**: src/commands.ts — 条件注册 `/torch` 命令（引用 `commands/torch.js`） +**缺失文件**: src/commands/torch.ts — 命令文件完全不存在 +**代码量**: 0 行专属代码 +**说明**: 纯占位符，没有任何实现。 + +--- + +## 43. KAIROS_DREAM + +**编译时引用次数**: 1 +**功能描述**: Kairos Dream（具体不明）。 +**分类**: STUB +**引用文件**: src/skills/bundled/index.ts — 内置技能注册 +**代码量**: 0 行专属代码 + +--- + +## 44. KAIROS_PUSH_NOTIFICATION + +**编译时引用次数**: 4 +**功能描述**: Kairos 推送通知。 +**分类**: STUB +**引用文件**: +1. src/components/Settings/Config.tsx — 设置 +2. src/tools.ts — 工具注册 +3. src/tools/ConfigTool/supportedSettings.ts — 支持的设置 +**代码量**: 0 行专属代码，仅在设置中预留了开关位 + +--- + +## 45. DAEMON + +**编译时引用次数**: 3 +**功能描述**: 守护进程模式。 +**分类**: STUB +**引用文件**: +1. src/commands.ts — 条件注册命令（与 BRIDGE_MODE 组合） +2. src/entrypoints/cli.tsx — CLI 入口 +**代码量**: 0 行专属代码 +**说明**: 在 commands.ts 中，`DAEMON` 与 `BRIDGE_MODE` 一起用于条件加载 `commands/remoteControlServer/index.js`，该文件不存在。 + +--- + +## 46. DIRECT_CONNECT + +**编译时引用次数**: 5 +**功能描述**: 直连模式。 +**分类**: STUB +**引用文件**: src/main.tsx — 主入口 +**代码量**: 0 行专属代码 + +--- + +## 47. SSH_REMOTE + +**编译时引用次数**: 4 +**功能描述**: SSH 远程连接。 +**分类**: STUB +**引用文件**: src/main.tsx — 主入口 +**代码量**: 0 行专属代码 + +--- + +## 48. STREAMLINED_OUTPUT + +**编译时引用次数**: 1 +**功能描述**: 精简输出模式。 +**分类**: STUB +**引用文件**: src/cli/print.ts — CLI 输出 +**代码量**: 0 行专属代码 + +--- + +## 49. ANTI_DISTILLATION_CC + +**编译时引用次数**: 1 +**功能描述**: 反蒸馏（防止模型蒸馏攻击）。 +**分类**: STUB +**引用文件**: src/services/api/claude.ts — Claude API 服务 +**代码量**: 0 行专属代码 + +--- + +## 50. NATIVE_CLIENT_ATTESTATION + +**编译时引用次数**: 1 +**功能描述**: 原生客户端认证。 +**分类**: STUB +**引用文件**: src/constants/system.ts — 系统常量 +**代码量**: 0 行专属代码 + +--- + +## 51. ABLATION_BASELINE + +**编译时引用次数**: 1 +**功能描述**: 消融基线测试。 +**分类**: STUB +**引用文件**: src/entrypoints/cli.tsx — CLI 入口 +**代码量**: 0 行专属代码 + +--- + +## 52. AGENT_MEMORY_SNAPSHOT + +**编译时引用次数**: 2 +**功能描述**: 代理记忆快照。 +**分类**: STUB +**引用文件**: +1. src/main.tsx — 主入口 +2. src/tools/AgentTool/loadAgentsDir.ts — 加载代理目录 +**代码量**: 0 行专属代码 + +--- + +## 53. AGENT_TRIGGERS_REMOTE `[build: ON] [dev: ON]` + +**编译时引用次数**: 2 +**功能描述**: 远程代理触发器。 +**分类**: STUB +**引用文件**: +1. src/skills/bundled/index.ts — 内置技能 +2. src/tools.ts — 工具注册 +**代码量**: 0 行专属代码 + +--- + +## 54. ALLOW_TEST_VERSIONS + +**编译时引用次数**: 2 +**功能描述**: 允许测试版本。 +**分类**: STUB +**引用文件**: src/utils/nativeInstaller/download.ts — 原生安装器下载（523 行，但标志仅用于一处条件判断） +**代码量**: 0 行专属代码 + +--- + +## 55. AUTO_THEME + +**编译时引用次数**: 3（单引号 2 + 双引号 1） +**功能描述**: 自动主题切换。 +**分类**: STUB +**引用文件**: +1. src/components/ThemePicker.tsx — 主题选择器 +2. src/components/design-system/ThemeProvider.tsx — 主题提供者 +3. src/tools/ConfigTool/supportedSettings.ts — 支持的设置 +**代码量**: 0 行专属代码 + +--- + +## 56. AWAY_SUMMARY + +**编译时引用次数**: 2 +**功能描述**: 离开摘要。用户离开时生成会话摘要。 +**分类**: STUB +**引用文件**: +1. src/hooks/useAwaySummary.ts — 离开摘要 Hook（125 行，但功能可能不完整） +2. src/screens/REPL.tsx — REPL +**代码量**: 约 125 行（useAwaySummary.ts） + +--- + +## 57. BREAK_CACHE_COMMAND + +**编译时引用次数**: 2 +**功能描述**: 缓存中断命令。 +**分类**: STUB +**引用文件**: src/context.ts — 上下文 +**代码量**: 0 行专属代码 + +--- + +## 58. BUILDING_CLAUDE_APPS + +**编译时引用次数**: 1 +**功能描述**: 构建 Claude 应用程序。 +**分类**: STUB +**引用文件**: src/skills/bundled/index.ts — 内置技能 +**代码量**: 0 行专属代码 + +--- + +## 59. BUILTIN_EXPLORE_PLAN_AGENTS + +**编译时引用次数**: 1 +**功能描述**: 内置探索和计划代理。 +**分类**: STUB +**引用文件**: src/tools/AgentTool/builtInAgents.ts — 内置代理定义 +**代码量**: 0 行专属代码 + +--- + +## 60. BYOC_ENVIRONMENT_RUNNER + +**编译时引用次数**: 1 +**功能描述**: BYOC（Bring Your Own Cloud）环境运行器。 +**分类**: STUB +**引用文件**: src/entrypoints/cli.tsx — CLI 入口 +**代码量**: 0 行专属代码 + +--- + +## 61. CCR_AUTO_CONNECT + +**编译时引用次数**: 3 +**功能描述**: CCR 自动连接。 +**分类**: STUB +**引用文件**: +1. src/bridge/bridgeEnabled.ts — 桥接启用检测 +2. src/utils/config.ts — 配置 +**代码量**: 0 行专属代码 + +--- + +## 62. CCR_MIRROR + +**编译时引用次数**: 4 +**功能描述**: CCR 镜像模式。 +**分类**: STUB +**引用文件**: +1. src/bridge/bridgeEnabled.ts — 桥接启用检测 +2. src/bridge/remoteBridgeCore.ts — 远程桥接核心 +3. src/main.tsx — 主入口 +**代码量**: 0 行专属代码 + +--- + +## 63. COMPACTION_REMINDERS + +**编译时引用次数**: 1 +**功能描述**: 压缩提醒。 +**分类**: STUB +**引用文件**: src/utils/attachments.ts — 附件处理 +**代码量**: 0 行专属代码 + +--- + +## 64. COWORKER_TYPE_TELEMETRY + +**编译时引用次数**: 2 +**功能描述**: 共同工作者类型遥测。 +**分类**: STUB +**引用文件**: src/services/analytics/metadata.ts — 分析元数据 +**代码量**: 0 行专属代码 + +--- + +## 65. DOWNLOAD_USER_SETTINGS + +**编译时引用次数**: 5 +**功能描述**: 下载用户设置（从远程同步）。 +**分类**: STUB +**引用文件**: +1. src/cli/print.ts — CLI 输出 +2. src/commands/reload-plugins/reload-plugins.ts — 重载插件 +3. src/services/settingsSync/index.ts — 设置同步 +**代码量**: 0 行专属代码 + +--- + +## 66. DUMP_SYSTEM_PROMPT + +**编译时引用次数**: 1 +**功能描述**: 转储系统提示（调试用）。 +**分类**: STUB +**引用文件**: src/entrypoints/cli.tsx — CLI 入口 +**代码量**: 0 行专属代码 + +--- + +## 67. ENHANCED_TELEMETRY_BETA + +**编译时引用次数**: 2 +**功能描述**: 增强遥测 Beta。 +**分类**: STUB +**引用文件**: src/utils/telemetry/sessionTracing.ts — 会话追踪（927 行，但标志仅用于一处条件） +**代码量**: 0 行专属代码 + +--- + +## 68. FILE_PERSISTENCE + +**编译时引用次数**: 3 +**功能描述**: 文件持久化。 +**分类**: STUB +**引用文件**: +1. src/cli/print.ts — CLI 输出 +2. src/utils/filePersistence/filePersistence.ts — 文件持久化（287 行） +**代码量**: 约 287 行（filePersistence.ts），但仅 3 处引用 + +--- + +## 69. HARD_FAIL + +**编译时引用次数**: 2 +**功能描述**: 硬失败模式（遇到错误时立即退出而非优雅降级）。 +**分类**: STUB +**引用文件**: +1. src/main.tsx — 主入口 +2. src/utils/log.ts — 日志工具 +**代码量**: 0 行专属代码 + +--- + +## 70. HOOK_PROMPTS + +**编译时引用次数**: 1 +**功能描述**: 钩子提示。 +**分类**: STUB +**引用文件**: src/screens/REPL.tsx — REPL +**代码量**: 0 行专属代码 + +--- + +## 71. IS_LIBC_GLIBC + +**编译时引用次数**: 1 +**功能描述**: 检测 libc 是否为 glibc。 +**分类**: STUB +**引用文件**: src/utils/envDynamic.ts — 动态环境检测（151 行） +**代码量**: 0 行专属代码（标志用于条件编译） + +--- + +## 72. IS_LIBC_MUSL + +**编译时引用次数**: 1 +**功能描述**: 检测 libc 是否为 musl。 +**分类**: STUB +**引用文件**: src/utils/envDynamic.ts — 动态环境检测（151 行） +**代码量**: 0 行专属代码（标志用于条件编译） + +--- + +## 73. MCP_RICH_OUTPUT + +**编译时引用次数**: 3 +**功能描述**: MCP 富文本输出。 +**分类**: STUB +**引用文件**: src/tools/MCPTool/UI.tsx — MCP 工具 UI +**代码量**: 0 行专属代码 + +--- + +## 74. MEMORY_SHAPE_TELEMETRY + +**编译时引用次数**: 3 +**功能描述**: 记忆形状遥测。 +**分类**: STUB +**引用文件**: +1. src/memdir/findRelevantMemories.ts — 查找相关记忆 +2. src/utils/sessionFileAccessHooks.ts — 会话文件访问钩子 +**代码量**: 0 行专属代码 + +--- + +## 75. NATIVE_CLIPBOARD_IMAGE + +**编译时引用次数**: 2 +**功能描述**: 原生剪贴板图片支持。 +**分类**: STUB +**引用文件**: src/utils/imagePaste.ts — 图片粘贴（416 行，但标志仅用于一处条件） +**代码量**: 0 行专属代码 + +--- + +## 76. NEW_INIT + +**编译时引用次数**: 2 +**功能描述**: 新的初始化流程。 +**分类**: STUB +**引用文件**: src/commands/init.ts — 初始化命令 +**代码量**: 0 行专属代码 + +--- + +## 77. OVERFLOW_TEST_TOOL + +**编译时引用次数**: 2 +**功能描述**: 溢出测试工具（内部测试用）。 +**分类**: STUB +**引用文件**: +1. src/tools.ts — 工具注册 +2. src/utils/permissions/classifierDecision.ts — 分类器决策 +**代码量**: 0 行专属代码 + +--- + +## 78. PERFETTO_TRACING + +**编译时引用次数**: 1 +**功能描述**: Perfetto 追踪（性能追踪工具）。 +**分类**: STUB +**引用文件**: src/utils/telemetry/perfettoTracing.ts — Perfetto 追踪（1,120 行，但标志仅用于一处） +**代码量**: 约 1,120 行（perfettoTracing.ts）存在，但仅 1 处引用 + +--- + +## 79. POWERSHELL_AUTO_MODE + +**编译时引用次数**: 2 +**功能描述**: PowerShell 自动模式。 +**分类**: STUB +**引用文件**: +1. src/utils/permissions/permissions.ts — 权限 +2. src/utils/permissions/yoloClassifier.ts — YOLO 分类器 +**代码量**: 0 行专属代码 + +--- + +## 80. QUICK_SEARCH + +**编译时引用次数**: 5 +**功能描述**: 快速搜索。 +**分类**: STUB +**引用文件**: +1. src/components/PromptInput/PromptInput.tsx — 提示输入 +2. src/keybindings/defaultBindings.ts — 默认键绑定 +**代码量**: 0 行专属代码 + +--- + +## 81. RUN_SKILL_GENERATOR + +**编译时引用次数**: 1 +**功能描述**: 运行技能生成器。 +**分类**: STUB +**引用文件**: src/skills/bundled/index.ts — 内置技能 +**代码量**: 0 行专属代码 + +--- + +## 82. SELF_HOSTED_RUNNER + +**编译时引用次数**: 1 +**功能描述**: 自托管运行器。 +**分类**: STUB +**引用文件**: src/entrypoints/cli.tsx — CLI 入口 +**代码量**: 0 行专属代码 + +--- + +## 83. SKILL_IMPROVEMENT + +**编译时引用次数**: 1 +**功能描述**: 技能改进。 +**分类**: STUB +**引用文件**: src/utils/hooks/skillImprovement.ts — 技能改进（267 行，但标志仅 1 处引用） +**代码量**: 约 267 行（skillImprovement.ts） + +--- + +## 84. SLOW_OPERATION_LOGGING + +**编译时引用次数**: 1 +**功能描述**: 慢操作日志记录。 +**分类**: STUB +**引用文件**: src/utils/slowOperations.ts — 慢操作（286 行，但标志仅 1 处引用） +**代码量**: 约 286 行（slowOperations.ts） + +--- + +## 85. TREE_SITTER_BASH + +**编译时引用次数**: 3 +**功能描述**: Tree-sitter Bash 解析器。 +**分类**: STUB +**引用文件**: src/utils/bash/parser.ts — Bash 解析器 +**代码量**: 0 行专属代码 + +--- + +## 86. TREE_SITTER_BASH_SHADOW + +**编译时引用次数**: 5 +**功能描述**: Tree-sitter Bash 影子模式（并行运行 tree-sitter 和传统解析器进行对比）。 +**分类**: STUB +**引用文件**: +1. src/tools/BashTool/bashPermissions.ts — Bash 权限 +2. src/utils/bash/parser.ts — Bash 解析器 +**代码量**: 0 行专属代码 + +--- + +## 87. ULTRATHINK + +**编译时引用次数**: 1 +**功能描述**: 超级思考模式。 +**分类**: STUB +**引用文件**: src/utils/thinking.ts — 思考工具（162 行，但标志仅 1 处引用） +**代码量**: 0 行专属代码 + +--- + +## 88. UNATTENDED_RETRY + +**编译时引用次数**: 1 +**功能描述**: 无人值守重试。 +**分类**: STUB +**引用文件**: src/services/api/withRetry.ts — API 重试 +**代码量**: 0 行专属代码 + +--- + +## 89. UPLOAD_USER_SETTINGS + +**编译时引用次数**: 2 +**功能描述**: 上传用户设置（同步到远程）。 +**分类**: STUB +**引用文件**: +1. src/main.tsx — 主入口 +2. src/services/settingsSync/index.ts — 设置同步 +**代码量**: 0 行专属代码 + +--- + +## 90. SKIP_DETECTION_WHEN_AUTOUPDATES_DISABLED + +**编译时引用次数**: 1（仅双引号形式） +**功能描述**: 当自动更新禁用时跳过检测。 +**分类**: STUB +**引用文件**: src/components/AutoUpdaterWrapper.tsx — 自动更新包装器 +**代码量**: 0 行专属代码 + +--- + +## 91. QUICK_SEARCH（已在 #80 列出） + +注：QUICK_SEARCH 已在 #80 列出。总计为 92 个独立标志（含 SKIP_DETECTION_WHEN_AUTOUPDATES_DISABLED）。 + +--- + +# 四、缺失文件汇总 + +以下是 `src/commands.ts` 中通过 `feature()` 条件 require 引用的文件，但在源代码中不存在： + +| 标志 | 引用路径 | 状态 | +|------|----------|------| +| TORCH | commands/torch.js | 文件完全不存在，无 .ts 版本 | +| PROACTIVE（与 KAIROS 共用） | commands/assistant/index.js | 整个 commands/assistant/ 目录不存在 | +| KAIROS | commands/assistant/index.js | 同上 | +| DAEMON + BRIDGE_MODE | commands/remoteControlServer/index.js | 文件不存在 | +| HISTORY_SNIP | commands/force-snip.js | 文件完全不存在，无 .ts 版本 | +| WORKFLOW_SCRIPTS | commands/workflows/index.js | 整个 commands/workflows/ 目录不存在 | +| KAIROS_GITHUB_WEBHOOKS | commands/subscribe-pr.js | 文件完全不存在，无 .ts 版本 | +| UDS_INBOX | commands/peers/index.js | 整个 commands/peers/ 目录不存在 | +| BUDDY | commands/buddy/index.js | 整个 commands/buddy/ 目录不存在（但 src/buddy/ 有 1,298 行实现） | + +以下是源代码中通过条件 require 引用但内容为空壳（1-5 行）的文件： + +| 文件路径 | 行数 | 所属标志 | +|----------|------|----------| +| src/tools/MonitorTool/MonitorTool.ts | 1 行 | MONITOR_TOOL | +| src/tools/WorkflowTool/WorkflowTool.ts | 1 行 | WORKFLOW_SCRIPTS | +| src/tools/WorkflowTool/constants.ts | 1 行 | WORKFLOW_SCRIPTS | +| src/tools/ReviewArtifactTool/ReviewArtifactTool.ts | 1 行 | REVIEW_ARTIFACT | +| src/utils/udsMessaging.ts | 1 行 | UDS_INBOX | +| src/utils/udsClient.ts | 3 行 | UDS_INBOX | +| src/skills/mcpSkills.ts | 3 行 | MCP_SKILLS | +| src/tools/WebBrowserTool/WebBrowserPanel.tsx | 3 行 | WEB_BROWSER_TOOL | +| src/tools/WorkflowTool/createWorkflowCommand.ts | 3 行 | WORKFLOW_SCRIPTS | +| src/tools/WorkflowTool/WorkflowPermissionRequest.tsx | 3 行 | WORKFLOW_SCRIPTS | +| src/components/tasks/WorkflowDetailDialog.tsx | 3 行 | WORKFLOW_SCRIPTS | +| src/components/permissions/MonitorPermissionRequest/MonitorPermissionRequest.tsx | 3 行 | MONITOR_TOOL | +| src/components/tasks/MonitorMcpDetailDialog.tsx | 3 行 | MONITOR_TOOL | +| src/components/permissions/ReviewArtifactPermissionRequest/ReviewArtifactPermissionRequest.tsx | 3 行 | REVIEW_ARTIFACT | +| src/tasks/LocalWorkflowTask/LocalWorkflowTask.ts | 5 行 | WORKFLOW_SCRIPTS | +| src/tasks/MonitorMcpTask/MonitorMcpTask.ts | 5 行 | MONITOR_TOOL | +| src/coordinator/workerAgent.ts | 1 行 | COORDINATOR_MODE | +| src/bridge/webhookSanitizer.ts | 3 行 | BRIDGE_MODE | +| src/bridge/peerSessions.ts | 3 行 | BRIDGE_MODE | + +--- + +# 五、按引用次数排序的完整列表 + +| 排名 | 标志名称 | 引用次数 | 分类 | +|------|----------|----------|------| +| 1 | KAIROS | 156 | PARTIAL | +| 2 | TRANSCRIPT_CLASSIFIER | 110 | COMPLETE | +| 3 | TEAMMEM | 53 | COMPLETE | +| 4 | VOICE_MODE | 49 | COMPLETE | +| 5 | BASH_CLASSIFIER | 49 | COMPLETE | +| 6 | KAIROS_BRIEF | 39 | COMPLETE | +| 7 | PROACTIVE | 37 | COMPLETE | +| 8 | COORDINATOR_MODE | 32 | COMPLETE | +| 9 | BRIDGE_MODE | 29 | COMPLETE | +| 10 | CONTEXT_COLLAPSE | 23 | COMPLETE | +| 11 | EXPERIMENTAL_SKILL_SEARCH | 21 | PARTIAL | +| 12 | KAIROS_CHANNELS | 21 | PARTIAL | +| 13 | UDS_INBOX | 18 | PARTIAL | +| 14 | CHICAGO_MCP | 16 | COMPLETE | +| 15 | BUDDY | 18 | PARTIAL | +| 16 | HISTORY_SNIP | 16 | PARTIAL | +| 17 | MONITOR_TOOL | 13 | PARTIAL | +| 18 | CACHED_MICROCOMPACT | 12 | COMPLETE | +| 19 | COMMIT_ATTRIBUTION | 12 | COMPLETE | +| 20 | BG_SESSIONS | 11 | COMPLETE | +| 21 | AGENT_TRIGGERS | 11 | COMPLETE | +| 22 | WORKFLOW_SCRIPTS | 10 | PARTIAL | +| 23 | ULTRAPLAN | 10 | COMPLETE | +| 24 | SHOT_STATS | 10 | COMPLETE | +| 25 | TOKEN_BUDGET | 9 | COMPLETE | +| 26 | PROMPT_CACHE_BREAK_DETECTION | 9 | COMPLETE | +| 27 | MCP_SKILLS | 9 | PARTIAL | +| 28 | CONNECTOR_TEXT | 8 | PARTIAL | +| 29 | EXTRACT_MEMORIES | 7 | COMPLETE | +| 30 | TEMPLATES | 6 | PARTIAL | +| 31 | LODESTONE | 6 | PARTIAL | +| 32 | DOWNLOAD_USER_SETTINGS | 5 | STUB | +| 33 | TREE_SITTER_BASH_SHADOW | 5 | STUB | +| 34 | QUICK_SEARCH | 5 | STUB | +| 35 | MESSAGE_ACTIONS | 5 | PARTIAL | +| 36 | DIRECT_CONNECT | 5 | STUB | +| 37 | TERMINAL_PANEL | 5 | PARTIAL | +| 38 | FORK_SUBAGENT | 5 | PARTIAL | +| 39 | REACTIVE_COMPACT | 5 | COMPLETE | +| 40 | WEB_BROWSER_TOOL | 4 | PARTIAL | +| 41 | VERIFICATION_AGENT | 4 | COMPLETE | +| 42 | SSH_REMOTE | 4 | STUB | +| 43 | REVIEW_ARTIFACT | 4 | PARTIAL | +| 44 | KAIROS_PUSH_NOTIFICATION | 4 | STUB | +| 45 | HISTORY_PICKER | 4 | PARTIAL | +| 46 | CCR_MIRROR | 4 | STUB | +| 47 | KAIROS_GITHUB_WEBHOOKS | 4 | PARTIAL | +| 48 | TREE_SITTER_BASH | 3 | STUB | +| 49 | MEMORY_SHAPE_TELEMETRY | 3 | STUB | +| 50 | MCP_RICH_OUTPUT | 3 | STUB | +| 51 | FILE_PERSISTENCE | 3 | STUB | +| 52 | DAEMON | 3 | STUB | +| 53 | CCR_AUTO_CONNECT | 3 | STUB | +| 54 | AUTO_THEME | 3 | STUB | +| 55 | UPLOAD_USER_SETTINGS | 2 | STUB | +| 56 | POWERSHELL_AUTO_MODE | 2 | STUB | +| 57 | OVERFLOW_TEST_TOOL | 2 | STUB | +| 58 | NEW_INIT | 2 | STUB | +| 59 | NATIVE_CLIPBOARD_IMAGE | 2 | STUB | +| 60 | HARD_FAIL | 2 | STUB | +| 61 | ENHANCED_TELEMETRY_BETA | 2 | STUB | +| 62 | COWORKER_TYPE_TELEMETRY | 2 | STUB | +| 63 | BREAK_CACHE_COMMAND | 2 | STUB | +| 64 | AWAY_SUMMARY | 2 | STUB | +| 65 | ALLOW_TEST_VERSIONS | 2 | STUB | +| 66 | AGENT_TRIGGERS_REMOTE | 2 | STUB | +| 67 | AGENT_MEMORY_SNAPSHOT | 2 | STUB | +| 68 | UNATTENDED_RETRY | 1 | STUB | +| 69 | ULTRATHINK | 1 | STUB | +| 70 | TORCH | 1 | STUB | +| 71 | STREAMLINED_OUTPUT | 1 | STUB | +| 72 | SLOW_OPERATION_LOGGING | 1 | STUB | +| 73 | SKILL_IMPROVEMENT | 1 | STUB | +| 74 | SELF_HOSTED_RUNNER | 1 | STUB | +| 75 | RUN_SKILL_GENERATOR | 1 | STUB | +| 76 | PERFETTO_TRACING | 1 | STUB | +| 77 | NATIVE_CLIENT_ATTESTATION | 1 | STUB | +| 78 | KAIROS_DREAM | 1 | STUB | +| 79 | IS_LIBC_MUSL | 1 | STUB | +| 80 | IS_LIBC_GLIBC | 1 | STUB | +| 81 | HOOK_PROMPTS | 1 | STUB | +| 82 | DUMP_SYSTEM_PROMPT | 1 | STUB | +| 83 | COMPACTION_REMINDERS | 1 | STUB | +| 84 | CCR_REMOTE_SETUP | 1 | COMPLETE | +| 85 | BYOC_ENVIRONMENT_RUNNER | 1 | STUB | +| 86 | BUILTIN_EXPLORE_PLAN_AGENTS | 1 | STUB | +| 87 | BUILDING_CLAUDE_APPS | 1 | STUB | +| 88 | ANTI_DISTILLATION_CC | 1 | STUB | +| 89 | ABLATION_BASELINE | 1 | STUB | +| 90 | SKIP_DETECTION_WHEN_AUTOUPDATES_DISABLED | 1 | STUB | + +--- + +# 六、代码量统计 + +| 分类 | 标志数 | 总引用次数 | 专属代码行数（估算） | +|------|--------|------------|---------------------| +| COMPLETE | 22 | 约 640 | 约 35,000 行 | +| PARTIAL | 19 | 约 330 | 约 5,500 行 | +| STUB | 51 | 约 95 | 约 2,000 行（主要是附带的工具文件） | +| **总计** | **92** | **约 1,065** | **约 42,500 行** | + +**最大功能模块（按代码行数排序）**: +1. BRIDGE_MODE: 12,619 行（src/bridge/ 目录） +2. COORDINATOR_MODE: 7,990 行（src/coordinator/ + src/utils/swarm/） +3. SHOT_STATS: 2,722 行（统计系统） +4. CONTEXT_COLLAPSE: 2,258 行（上下文分析） +5. COMMIT_ATTRIBUTION: 1,354 行（提交归属） +6. BUDDY: 1,298 行（伙伴精灵） +7. VOICE_MODE: 1,410 行（语音模式） +8. TEAMMEM: 1,026 行（团队记忆） +9. UDS_INBOX: 966 行（Unix 套接字消息，但大部分是桩） +10. BG_SESSIONS: 801 行（后台会话） + +--- + +*本文档由自动审计生成，基于对 Claude Code 源代码中所有 `feature('...')` 引用的穷举搜索。每个标志的引用次数包含单引号和双引号两种形式。* diff --git a/docs/features/feature-flags-audit-complete.md b/docs/features/feature-flags-audit-complete.md new file mode 100644 index 000000000..5d5ac83c5 --- /dev/null +++ b/docs/features/feature-flags-audit-complete.md @@ -0,0 +1,2008 @@ +# Claude Code 编译时特性标志（Feature Flags）完整审计报告 + +> 审计日期: 2026-04-05 +> 代码库: Claude Code CLI +> 总计特性标志数: 92 个 +> 编译时门控机制: `feature('FLAG_NAME')` — 来自 `bun:bundle` 的编译时常量 +> 运行时门控机制: `USER_TYPE` 环境变量 + GrowthBook 远程开关（`tengu_*` 前缀） + +--- + +## 门控机制概述 + +Claude Code 使用三层门控系统: + +1. **编译时标志** (`feature('...')` from `bun:bundle`): 在构建时决定代码是否包含在最终产物中。当 `feature('X')` 为 `false` 时，Bun 的死代码消除（DCE）会移除整个 `if` 分支，最终产物中完全不包含该功能的代码。 +2. **运行时用户类型** (`USER_TYPE`): 通过环境变量区分用户类型（如 `internal`, `external`, `enterprise`），在运行时决定功能是否可用。 +3. **远程开关** (GrowthBook SDK, `tengu_*` 前缀): 通过 Anthropic 的 GrowthBook 实例进行远程 A/B 测试和功能开关控制，可在不重新部署的情况下开启/关闭功能。 + +本文档审计的是第一层——编译时标志。所有 92 个标志均以 `feature('FLAG_NAME')` 的形式出现在源代码中。 + +--- + +## 分类标准 + +- **COMPLETE（完整实现）**: 核心功能代码完整，所有引用文件存在且有实质性内容。只需在构建配置中将该标志设为 `true` 即可启用。 +- **PARTIAL（部分实现）**: 有实质性的功能代码，但存在缺失的文件（命令入口、组件等）或关键模块仅有空壳。启用后可能报错或功能不完整。 +- **STUB（纯桩/最小实现）**: 仅有 1-2 处引用，没有或几乎没有实际功能代码。代码只是为该标志预留了位置。 + +--- + +## 统计摘要 + +| 分类 | 数量 | 标志名称 | +|------|------|----------| +| COMPLETE | 22 | BRIDGE_MODE, COORDINATOR_MODE, CONTEXT_COLLAPSE, VOICE_MODE, TEAMMEM, COMMIT_ATTRIBUTION, ULTRAPLAN, BASH_CLASSIFIER, TRANSCRIPT_CLASSIFIER, EXTRACT_MEMORIES, CACHED_MICROCOMPACT, TOKEN_BUDGET, AGENT_TRIGGERS, REACTIVE_COMPACT, KAIROS_BRIEF, CCR_REMOTE_SETUP, SHOT_STATS, BG_SESSIONS, PROACTIVE, CHICAGO_MCP, VERIFICATION_AGENT, PROMPT_CACHE_BREAK_DETECTION | +| PARTIAL | 19 | KAIROS, BUDDY, MONITOR_TOOL, HISTORY_SNIP, WORKFLOW_SCRIPTS, UDS_INBOX, KAIROS_CHANNELS, FORK_SUBAGENT, EXPERIMENTAL_SKILL_SEARCH, WEB_BROWSER_TOOL, MCP_SKILLS, REVIEW_ARTIFACT, KAIROS_GITHUB_WEBHOOKS, CONNECTOR_TEXT, TEMPLATES, LODESTONE, HISTORY_PICKER, MESSAGE_ACTIONS, TERMINAL_PANEL | +| STUB | 51 | TORCH, KAIROS_DREAM, KAIROS_PUSH_NOTIFICATION, DAEMON, DIRECT_CONNECT, SSH_REMOTE, STREAMLINED_OUTPUT, ANTI_DISTILLATION_CC, NATIVE_CLIENT_ATTESTATION, ABLATION_BASELINE, AGENT_MEMORY_SNAPSHOT, AGENT_TRIGGERS_REMOTE, ALLOW_TEST_VERSIONS, AUTO_THEME, AWAY_SUMMARY, BREAK_CACHE_COMMAND, BUILDING_CLAUDE_APPS, BUILTIN_EXPLORE_PLAN_AGENTS, BYOC_ENVIRONMENT_RUNNER, CCR_AUTO_CONNECT, CCR_MIRROR, COMPACTION_REMINDERS, COWORKER_TYPE_TELEMETRY, DOWNLOAD_USER_SETTINGS, DUMP_SYSTEM_PROMPT, ENHANCED_TELEMETRY_BETA, FILE_PERSISTENCE, HARD_FAIL, HOOK_PROMPTS, IS_LIBC_GLIBC, IS_LIBC_MUSL, MCP_RICH_OUTPUT, MEMORY_SHAPE_TELEMETRY, NATIVE_CLIPBOARD_IMAGE, NEW_INIT, OVERFLOW_TEST_TOOL, PERFETTO_TRACING, POWERSHELL_AUTO_MODE, QUICK_SEARCH, RUN_SKILL_GENERATOR, SELF_HOSTED_RUNNER, SKILL_IMPROVEMENT, SLOW_OPERATION_LOGGING, TREE_SITTER_BASH, TREE_SITTER_BASH_SHADOW, ULTRATHINK, UNATTENDED_RETRY, UPLOAD_USER_SETTINGS, SKIP_DETECTION_WHEN_AUTOUPDATES_DISABLED | + +--- + +## 当前启用状态 (2026-04-05) + +> 经 Codex CLI 独立复核验证，详见 `feature-flags-codex-review.md` + +| 标志 | build.ts | dev.ts | 实际验证状态 | 备注 | +|------|:--------:|:------:|:----------:|------| +| AGENT_TRIGGERS_REMOTE | **ON** | **ON** | compile-only | 环境标记，原始即启用 | +| CHICAGO_MCP | **ON** | **ON** | compile-only | Computer Use，原始即启用 | +| VOICE_MODE | **ON** | **ON** | compile-only | 语音模式，原始即启用 | +| SHOT_STATS | **ON** | **ON** | compile-only, 已验证 | 本轮新增，纯本地统计 | +| PROMPT_CACHE_BREAK_DETECTION | **ON** | **ON** | compile-only, 已验证 | 本轮新增，内部诊断 | +| TOKEN_BUDGET | **ON** | **ON** | compile-only, 已验证 | 本轮新增，支持 `+500k` 语法 | +| BUDDY | off | **ON** | compile+GrowthBook | 仅 dev 模式 | +| TRANSCRIPT_CLASSIFIER | off | **ON** | compile+GrowthBook | 仅 dev 模式 | +| BRIDGE_MODE | off | **ON** | compile+remote | 仅 dev 模式，需 claude.ai 订阅 | + +--- + +# 一、COMPLETE（完整实现）— 共 22 个 + +以下标志的功能代码完整，所有引用的文件均存在且有实质性内容。只需在构建配置中将对应标志设为 `true` 即可启用该功能。 + +--- + +## 1. BRIDGE_MODE `[dev: ON]` + +**编译时引用次数**: 29（单引号 28 + 双引号 1） +**功能描述**: 远程桥接模式。允许 Claude Code CLI 通过 WebSocket 连接到远程服务端（如 claude.ai Web 端），实现远程控制、会话转发、权限代理、附件传输等功能。这是 Claude Code 最大的子系统之一。 +**分类**: COMPLETE +**启用条件**: 将 `BRIDGE_MODE` 编译标志设为 `true` + +**核心实现文件（src/bridge/ 目录，共 32 个文件，12,619 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/bridge/bridgeMain.ts | 2,999 行 | 桥接主入口，管理整个远程桥接生命周期 | +| src/bridge/replBridge.ts | 2,406 行 | REPL 桥接核心，处理消息路由和会话管理 | +| src/bridge/remoteBridgeCore.ts | 1,008 行 | 远程桥接核心连接逻辑 | +| src/bridge/initReplBridge.ts | 569 行 | REPL 桥接初始化 | +| src/bridge/sessionRunner.ts | 550 行 | 会话运行器，管理远程会话执行 | +| src/bridge/bridgeApi.ts | 539 行 | 桥接 API 封装 | +| src/bridge/bridgeUI.ts | 530 行 | 桥接模式 UI 组件 | +| src/bridge/bridgeMessaging.ts | 461 行 | 桥接消息协议 | +| src/bridge/createSession.ts | 384 行 | 远程会话创建逻辑 | +| src/bridge/replBridgeTransport.ts | 370 行 | REPL 桥接传输层 | +| src/bridge/types.ts | 262 行 | 桥接相关类型定义 | +| src/bridge/jwtUtils.ts | 256 行 | JWT 令牌工具 | +| src/bridge/trustedDevice.ts | 210 行 | 可信设备管理 | +| src/bridge/bridgePointer.ts | 210 行 | 桥接指针管理 | +| src/bridge/bridgeEnabled.ts | 202 行 | 桥接模式启用检测 | +| src/bridge/inboundAttachments.ts | 175 行 | 入站附件处理 | +| src/bridge/envLessBridgeConfig.ts | 165 行 | 无环境变量桥接配置 | +| src/bridge/bridgeStatusUtil.ts | 163 行 | 桥接状态工具 | +| src/bridge/debugUtils.ts | 141 行 | 桥接调试工具 | +| src/bridge/bridgeDebug.ts | 135 行 | 桥接调试模块 | +| src/bridge/workSecret.ts | 127 行 | 工作密钥管理 | +| src/bridge/pollConfig.ts | 110 行 | 轮询配置 | +| src/bridge/pollConfigDefaults.ts | 82 行 | 轮询配置默认值 | +| src/bridge/inboundMessages.ts | 80 行 | 入站消息处理 | +| src/bridge/capacityWake.ts | 56 行 | 容量唤醒 | +| src/bridge/sessionIdCompat.ts | 57 行 | 会话 ID 兼容层 | +| src/bridge/codeSessionApi.ts | 168 行 | 代码会话 API | +| src/bridge/bridgeConfig.ts | 48 行 | 桥接配置 | +| src/bridge/bridgePermissionCallbacks.ts | 43 行 | 桥接权限回调 | +| src/bridge/replBridgeHandle.ts | 36 行 | REPL 桥接句柄 | +| src/bridge/flushGate.ts | 71 行 | 刷新门控 | +| src/bridge/webhookSanitizer.ts | 3 行 | Webhook 清理 | +| src/bridge/peerSessions.ts | 3 行 | 对等会话（桩） | + +**引用该标志的文件（13 个）**: +1. src/bridge/bridgeEnabled.ts — 检测桥接模式是否编译启用 +2. src/commands.ts — 条件注册 `/bridge` 命令和 `/remoteControlServer` 命令 +3. src/commands/bridge/index.ts — 桥接命令入口（604 行） +4. src/components/PromptInput/PromptInputFooter.tsx — 桥接模式下的页脚 UI +5. src/components/Settings/Config.tsx — 设置面板中的桥接选项 +6. src/entrypoints/cli.tsx — CLI 入口中的桥接模式初始化 +7. src/hooks/useCanUseTool.tsx — 桥接模式下的工具权限 +8. src/hooks/useReplBridge.tsx — REPL 桥接 Hook +9. src/main.tsx — 主入口中的桥接模式启动 +10. src/screens/REPL.tsx — REPL 屏幕中的桥接集成 +11. src/tools/BriefTool/attachments.ts — Brief 工具附件处理 +12. src/tools/BriefTool/upload.ts — Brief 工具上传 +13. src/tools/ConfigTool/supportedSettings.ts — 配置工具中的桥接设置 + +**启用所需操作**: 仅需将编译标志 `BRIDGE_MODE` 设为 `true`。所有代码完整，命令入口 `src/commands/bridge/index.ts`（604 行）和 `src/commands/bridge/bridge.tsx`（46,907 行）均存在。 + +--- + +## 2. COORDINATOR_MODE + +**编译时引用次数**: 32 +**功能描述**: 协调器模式。允许 Claude Code 作为"领导者"协调多个"工作者"代理并行执行任务。工作者可以在同一进程内运行（in-process），也可以通过 tmux/iTerm2 面板运行。支持权限同步、重连、团队管理等。 +**分类**: COMPLETE +**启用条件**: 将 `COORDINATOR_MODE` 编译标志设为 `true` + +**核心实现文件（src/coordinator/ 目录，370 行 + src/utils/swarm/ 目录，7,620 行 = 共 7,990 行）**: + +src/coordinator/ 目录（2 个文件）: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/coordinator/coordinatorMode.ts | 369 行 | 协调器模式核心逻辑，管理领导者/工作者角色 | +| src/coordinator/workerAgent.ts | 1 行 | 工作者代理（桩文件，实际逻辑在 swarm 中） | + +src/utils/swarm/ 目录（22 个文件）: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/utils/swarm/inProcessRunner.ts | 1,552 行 | 进程内工作者运行器 | +| src/utils/swarm/permissionSync.ts | 928 行 | 权限同步机制 | +| src/utils/swarm/backends/TmuxBackend.ts | 764 行 | Tmux 后端执行器 | +| src/utils/swarm/teamHelpers.ts | 683 行 | 团队辅助函数 | +| src/utils/swarm/It2SetupPrompt.tsx | 379 行 | iTerm2 设置提示 UI | +| src/utils/swarm/backends/ITermBackend.ts | 370 行 | iTerm2 后端执行器 | +| src/utils/swarm/backends/PaneBackendExecutor.ts | 354 行 | 面板后端执行器 | +| src/utils/swarm/backends/InProcessBackend.ts | 339 行 | 进程内后端 | +| src/utils/swarm/spawnInProcess.ts | 328 行 | 进程内 spawn 逻辑 | +| src/utils/swarm/backends/types.ts | 311 行 | 后端类型定义 | +| src/utils/swarm/backends/registry.ts | 464 行 | 后端注册表 | +| src/utils/swarm/backends/it2Setup.ts | 245 行 | iTerm2 设置逻辑 | +| src/utils/swarm/spawnUtils.ts | 146 行 | Spawn 工具函数 | +| src/utils/swarm/teammateInit.ts | 129 行 | 队友初始化 | +| src/utils/swarm/reconnection.ts | 119 行 | 重连逻辑 | +| src/utils/swarm/teammateLayoutManager.ts | 107 行 | 队友布局管理 | +| src/utils/swarm/backends/teammateModeSnapshot.ts | 87 行 | 队友模式快照 | +| src/utils/swarm/backends/detection.ts | 128 行 | 后端检测 | +| src/utils/swarm/leaderPermissionBridge.ts | 54 行 | 领导者权限桥接 | +| src/utils/swarm/constants.ts | 33 行 | 常量定义 | +| src/utils/swarm/teammatePromptAddendum.ts | 18 行 | 队友提示附加内容 | +| src/utils/swarm/teammateModel.ts | 10 行 | 队友模型配置 | + +**引用该标志的文件（15 个）**: +1. src/QueryEngine.ts — 查询引擎中的协调器模式分支 +2. src/cli/print.ts — CLI 输出中的协调器模式处理 +3. src/commands/clear/conversation.ts — 清除对话时的协调器状态处理 +4. src/components/PromptInput/PromptInputFooterLeftSide.tsx — 协调器模式下的页脚左侧 UI +5. src/coordinator/coordinatorMode.ts — 协调器模式核心逻辑 +6. src/main.tsx — 主入口中的协调器模式启动 +7. src/screens/REPL.tsx — REPL 屏幕中的协调器集成 +8. src/screens/ResumeConversation.tsx — 恢复对话时的协调器处理 +9. src/tools.ts — 工具注册中的协调器工具 +10. src/tools/AgentTool/AgentTool.tsx — Agent 工具中的协调器模式分支 +11. src/tools/AgentTool/builtInAgents.ts — 内置代理定义 +12. src/utils/processUserInput/processSlashCommand.tsx — 斜杠命令处理中的协调器 +13. src/utils/sessionRestore.ts — 会话恢复中的协调器状态 +14. src/utils/systemPrompt.ts — 系统提示中的协调器指令 +15. src/utils/toolPool.ts — 工具池中的协调器工具 + +**启用所需操作**: 仅需将编译标志 `COORDINATOR_MODE` 设为 `true`。所有 7,990 行代码完整。 + +--- + +## 3. CONTEXT_COLLAPSE + +**编译时引用次数**: 23（单引号 20 + 双引号 3） +**功能描述**: 上下文折叠/分析功能。提供对话上下文的可视化分析，包括 token 使用量统计、上下文窗口利用率、自动压缩触发等。 +**分类**: COMPLETE +**启用条件**: 将 `CONTEXT_COLLAPSE` 编译标志设为 `true` + +**核心实现文件（共 2,258 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/utils/analyzeContext.ts | 1,382 行 | 上下文分析核心逻辑 | +| src/components/ContextVisualization.tsx | 488 行 | 上下文可视化 UI 组件 | +| src/commands/context/context-noninteractive.ts | 325 行 | 非交互式上下文命令 | +| src/commands/context/context.tsx | 63 行 | 交互式上下文命令入口 | + +**引用该标志的文件（13 个）**: +1. src/commands/context/context-noninteractive.ts — 非交互式上下文分析命令 +2. src/commands/context/context.tsx — 上下文命令入口 +3. src/components/ContextVisualization.tsx — 上下文可视化组件 +4. src/components/TokenWarning.tsx — Token 警告组件中的上下文折叠检测 +5. src/query.ts — 查询中的上下文折叠处理 +6. src/screens/REPL.tsx — REPL 中的上下文折叠集成 +7. src/screens/ResumeConversation.tsx — 恢复对话中的上下文折叠 +8. src/services/compact/autoCompact.ts — 自动压缩中的上下文折叠触发 +9. src/services/compact/postCompactCleanup.ts — 压缩后清理 +10. src/setup.ts — 初始化设置中的上下文折叠 +11. src/tools.ts — 工具注册 +12. src/utils/analyzeContext.ts — 上下文分析核心 +13. src/utils/sessionRestore.ts — 会话恢复 + +**启用所需操作**: 仅需将编译标志 `CONTEXT_COLLAPSE` 设为 `true`。 + +--- + +## 4. VOICE_MODE `[build: ON] [dev: ON]` + +**编译时引用次数**: 49（单引号 46 + 双引号 3） +**功能描述**: 语音模式。集成语音转文字（STT）功能，用户可以通过麦克风输入语音，实时转换为文本发送给 AI。包括语音指示器 UI、语音流处理、键绑定等。 +**分类**: COMPLETE +**启用条件**: 将 `VOICE_MODE` 编译标志设为 `true` + +**核心实现文件（共 1,410 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/hooks/useVoiceIntegration.tsx | 676 行 | 语音集成 React Hook | +| src/services/voiceStreamSTT.ts | 544 行 | 语音流式 STT（语音转文字）服务 | +| src/components/PromptInput/VoiceIndicator.tsx | 136 行 | 语音指示器 UI 组件 | +| src/voice/voiceModeEnabled.ts | 54 行 | 语音模式启用检测 | + +**引用该标志的文件（16 个）**: +1. src/commands.ts — 条件注册语音相关命令 +2. src/components/LogoV2/VoiceModeNotice.tsx — 语音模式通知 UI +3. src/components/PromptInput/Notifications.tsx — 提示输入通知中的语音状态 +4. src/components/PromptInput/PromptInputFooterLeftSide.tsx — 页脚左侧语音按钮 +5. src/components/PromptInput/VoiceIndicator.tsx — 语音指示器组件 +6. src/components/TextInput.tsx — 文本输入中的语音模式处理 +7. src/hooks/useVoiceIntegration.tsx — 语音集成 Hook +8. src/keybindings/defaultBindings.ts — 语音模式键绑定 +9. src/screens/REPL.tsx — REPL 中的语音模式集成 +10. src/services/voiceStreamSTT.ts — STT 服务 +11. src/state/AppState.tsx — 应用状态中的语音状态 +12. src/tools/ConfigTool/ConfigTool.ts — 配置工具中的语音设置 +13. src/tools/ConfigTool/prompt.ts — 配置工具提示 +14. src/tools/ConfigTool/supportedSettings.ts — 支持的设置项 +15. src/utils/settings/types.ts — 设置类型定义 +16. src/voice/voiceModeEnabled.ts — 语音模式启用逻辑 + +**启用所需操作**: 仅需将编译标志 `VOICE_MODE` 设为 `true`。 + +--- + +## 5. TEAMMEM + +**编译时引用次数**: 53（单引号 51 + 双引号 2） +**功能描述**: 团队记忆功能。允许团队成员之间共享和同步记忆文件（CLAUDE.md），包括记忆提取、秘密过滤、文件选择器、折叠显示等。 +**分类**: COMPLETE +**启用条件**: 将 `TEAMMEM` 编译标志设为 `true` + +**核心实现文件（共 1,026 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/components/memory/MemoryFileSelector.tsx | 437 行 | 记忆文件选择器 UI | +| src/services/teamMemorySync/watcher.ts | 387 行 | 团队记忆文件监视器 | +| src/components/messages/teamMemCollapsed.tsx | 139 行 | 团队记忆折叠显示组件 | +| src/services/teamMemorySync/teamMemSecretGuard.ts | 44 行 | 团队记忆秘密过滤器 | +| src/components/messages/teamMemSaved.ts | 19 行 | 团队记忆保存状态 | + +**引用该标志的文件（17 个）**: +1. src/components/memory/MemoryFileSelector.tsx — 记忆文件选择器 +2. src/components/messages/CollapsedReadSearchContent.tsx — 折叠的读取/搜索内容 +3. src/components/messages/SystemTextMessage.tsx — 系统消息中的团队记忆显示 +4. src/components/messages/teamMemCollapsed.tsx — 团队记忆折叠组件 +5. src/components/messages/teamMemSaved.ts — 保存状态 +6. src/memdir/memdir.ts — 记忆目录操作 +7. src/services/extractMemories/extractMemories.ts — 记忆提取中的团队记忆 +8. src/services/extractMemories/prompts.ts — 记忆提取提示 +9. src/services/teamMemorySync/teamMemSecretGuard.ts — 秘密过滤 +10. src/services/teamMemorySync/watcher.ts — 文件监视 +11. src/setup.ts — 初始化中的团队记忆设置 +12. src/utils/claudemd.ts — CLAUDE.md 处理 +13. src/utils/collapseReadSearch.ts — 折叠读取/搜索 +14. src/utils/config.ts — 配置中的团队记忆 +15. src/utils/memory/types.ts — 记忆类型定义 +16. src/utils/memoryFileDetection.ts — 记忆文件检测 +17. src/utils/sessionFileAccessHooks.ts — 会话文件访问钩子 + +**启用所需操作**: 仅需将编译标志 `TEAMMEM` 设为 `true`。 + +--- + +## 6. COMMIT_ATTRIBUTION + +**编译时引用次数**: 12 +**功能描述**: 提交归属功能。在 git 提交中标记哪些代码是由 AI 生成的，包括 git trailer、统计信息、提交后处理等。 +**分类**: COMPLETE +**启用条件**: 将 `COMMIT_ATTRIBUTION` 编译标志设为 `true` + +**核心实现文件（共 1,354 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/utils/commitAttribution.ts | 961 行 | 提交归属核心逻辑 | +| src/utils/attribution.ts | 393 行 | 归属计算与标记 | + +**引用该标志的文件（9 个）**: +1. src/cli/print.ts — CLI 输出中的归属信息 +2. src/commands/clear/caches.ts — 清除缓存中的归属数据 +3. src/screens/REPL.tsx — REPL 中的归属集成 +4. src/services/compact/postCompactCleanup.ts — 压缩后的归属清理 +5. src/setup.ts — 初始化中的归属设置 +6. src/utils/attribution.ts — 归属核心 +7. src/utils/sessionRestore.ts — 会话恢复中的归属 +8. src/utils/shell/bashProvider.ts — Bash 提供者中的归属钩子（255 行） +9. src/utils/worktree.ts — 工作树中的归属处理（1,519 行） + +**启用所需操作**: 仅需将编译标志 `COMMIT_ATTRIBUTION` 设为 `true`。 + +--- + +## 7. ULTRAPLAN + +**编译时引用次数**: 10 +**功能描述**: 超级计划模式。提供增强版的计划功能，允许用户创建更详细、更结构化的执行计划。 +**分类**: COMPLETE +**启用条件**: 将 `ULTRAPLAN` 编译标志设为 `true` + +**核心实现文件**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/commands/ultraplan.tsx | 470 行 | 超级计划命令完整实现 | + +**引用该标志的文件（5 个）**: +1. src/commands.ts — 条件注册 `/ultraplan` 命令 +2. src/components/PromptInput/PromptInput.tsx — 提示输入中的超级计划处理 +3. src/components/permissions/ExitPlanModePermissionRequest/ExitPlanModePermissionRequest.tsx — 退出计划模式权限 +4. src/screens/REPL.tsx — REPL 中的超级计划集成 +5. src/utils/processUserInput/processUserInput.ts — 用户输入处理 + +**启用所需操作**: 仅需将编译标志 `ULTRAPLAN` 设为 `true`。 + +--- + +## 8. BASH_CLASSIFIER + +**编译时引用次数**: 49（单引号 45 + 双引号 4） +**功能描述**: Bash 命令分类器。对用户请求执行的 Bash 命令进行安全分类，决定是否需要用户确认。支持自动模式（YOLO mode）下的智能权限判断。 +**分类**: COMPLETE +**启用条件**: 将 `BASH_CLASSIFIER` 编译标志设为 `true` + +**实现分布**: 该功能的代码分布在权限系统、工具系统和 UI 组件的 19 个文件中，与现有权限架构深度集成。 + +**引用该标志的文件（20 个）**: +1. src/cli/structuredIO.ts — 结构化 IO 中的分类器输出 +2. src/components/messages/UserToolResultMessage/UserToolSuccessMessage.tsx — 工具成功消息中的分类器信息 +3. src/components/permissions/BashPermissionRequest/BashPermissionRequest.tsx — Bash 权限请求 UI +4. src/components/permissions/PermissionDecisionDebugInfo.tsx — 权限决策调试信息 +5. src/components/permissions/PermissionRuleExplanation.tsx — 权限规则解释 +6. src/components/permissions/hooks.ts — 权限 Hooks +7. src/hooks/toolPermission/PermissionContext.ts — 权限上下文 +8. src/hooks/toolPermission/handlers/coordinatorHandler.ts — 协调器权限处理 +9. src/hooks/toolPermission/handlers/interactiveHandler.ts — 交互式权限处理 +10. src/hooks/toolPermission/handlers/swarmWorkerHandler.ts — Swarm 工作者权限处理 +11. src/hooks/toolPermission/permissionLogging.ts — 权限日志 +12. src/hooks/useCanUseTool.tsx — 工具可用性检查 +13. src/services/api/withRetry.ts — API 重试中的分类器 +14. src/tools/BashTool/bashPermissions.ts — Bash 权限逻辑 +15. src/tools/BashTool/pathValidation.ts — 路径验证 +16. src/utils/classifierApprovals.ts — 分类器审批记录 +17. src/utils/messages.ts — 消息处理 +18. src/utils/permissions/permissions.ts — 权限核心 +19. src/utils/permissions/yoloClassifier.ts — YOLO 模式分类器 +20. src/utils/swarm/inProcessRunner.ts — 进程内运行器中的分类器 + +**启用所需操作**: 仅需将编译标志 `BASH_CLASSIFIER` 设为 `true`。 + +--- + +## 9. TRANSCRIPT_CLASSIFIER `[dev: ON]` + +**编译时引用次数**: 110（单引号 107 + 双引号 3） +**功能描述**: 转录分类器。这是引用次数第二多的标志，与自动模式（Auto Mode）权限系统深度集成。对整个对话转录进行分析，判断 AI 请求的工具调用是否安全。 +**分类**: COMPLETE +**启用条件**: 将 `TRANSCRIPT_CLASSIFIER` 编译标志设为 `true` + +**实现分布**: 该功能的代码分布在 44 个文件中，是除 KAIROS 外集成最广泛的功能。 + +**引用该标志的文件（44 个）**: +1. src/cli/print.ts — CLI 输出 +2. src/cli/structuredIO.ts — 结构化 IO +3. src/commands/login/login.tsx — 登录命令 +4. src/components/PromptInput/PromptInput.tsx — 提示输入 +5. src/components/Settings/Config.tsx — 设置配置 +6. src/components/messages/UserToolResultMessage/UserToolErrorMessage.tsx — 工具错误消息 +7. src/components/messages/UserToolResultMessage/UserToolSuccessMessage.tsx — 工具成功消息 +8. src/components/permissions/ExitPlanModePermissionRequest/ExitPlanModePermissionRequest.tsx — 退出计划模式权限 +9. src/components/permissions/PermissionDecisionDebugInfo.tsx — 权限决策调试 +10. src/components/permissions/PermissionRuleExplanation.tsx — 权限规则解释 +11. src/components/permissions/hooks.ts — 权限 Hooks +12. src/constants/betas.ts — Beta 常量 +13. src/hooks/notifs/useAutoModeUnavailableNotification.ts — 自动模式不可用通知 +14. src/hooks/toolPermission/PermissionContext.ts — 权限上下文 +15. src/hooks/toolPermission/handlers/interactiveHandler.ts — 交互式处理 +16. src/hooks/toolPermission/permissionLogging.ts — 权限日志 +17. src/hooks/useCanUseTool.tsx — 工具可用性 +18. src/hooks/useReplBridge.tsx — REPL 桥接 +19. src/interactiveHelpers.tsx — 交互帮助函数 +20. src/main.tsx — 主入口 +21. src/migrations/resetAutoModeOptInForDefaultOffer.ts — 迁移脚本 +22. src/screens/REPL.tsx — REPL 屏幕 +23. src/services/api/claude.ts — Claude API 服务 +24. src/services/tools/toolExecution.ts — 工具执行 +25. src/tools/AgentTool/AgentTool.tsx — Agent 工具 +26. src/tools/AgentTool/agentToolUtils.ts — Agent 工具工具函数 +27. src/tools/AgentTool/runAgent.ts — 运行 Agent +28. src/tools/BashTool/bashPermissions.ts — Bash 权限 +29. src/tools/ConfigTool/supportedSettings.ts — 支持的设置 +30. src/tools/ExitPlanModeTool/ExitPlanModeV2Tool.ts — 退出计划模式工具 +31. src/tools/NotebookEditTool/NotebookEditTool.ts — Notebook 编辑工具 +32. src/types/permissions.ts — 权限类型 +33. src/utils/attachments.ts — 附件处理 +34. src/utils/autoModeDenials.ts — 自动模式拒绝 +35. src/utils/betas.ts — Beta 工具 +36. src/utils/classifierApprovals.ts — 分类器审批 +37. src/utils/permissions/PermissionMode.ts — 权限模式 +38. src/utils/permissions/autoModeState.ts — 自动模式状态 +39. src/utils/permissions/bypassPermissionsKillswitch.ts — 绕过权限 Kill Switch +40. src/utils/permissions/getNextPermissionMode.ts — 获取下一个权限模式 +41. src/utils/permissions/permissionSetup.ts — 权限设置 +42. src/utils/permissions/permissions.ts — 权限核心 +43. src/utils/permissions/yoloClassifier.ts — YOLO 分类器 +44. src/utils/settings/settings.ts — 设置 +45. src/utils/settings/types.ts — 设置类型 +46. src/utils/toolResultStorage.ts — 工具结果存储 + +**启用所需操作**: 仅需将编译标志 `TRANSCRIPT_CLASSIFIER` 设为 `true`。 + +--- + +## 10. EXTRACT_MEMORIES + +**编译时引用次数**: 7 +**功能描述**: 记忆提取功能。从对话中自动提取有用的记忆信息并保存到记忆文件中。 +**分类**: COMPLETE +**启用条件**: 将 `EXTRACT_MEMORIES` 编译标志设为 `true` + +**核心实现文件（共 769 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/services/extractMemories/extractMemories.ts | 615 行 | 记忆提取核心算法 | +| src/services/extractMemories/prompts.ts | 154 行 | 记忆提取的 AI 提示词 | + +**引用该标志的文件（4 个）**: +1. src/cli/print.ts — CLI 输出中的记忆提取信息 +2. src/memdir/paths.ts — 记忆目录路径 +3. src/query/stopHooks.ts — 查询停止钩子中触发记忆提取 +4. src/utils/backgroundHousekeeping.ts — 后台维护中的记忆提取 + +**启用所需操作**: 仅需将编译标志 `EXTRACT_MEMORIES` 设为 `true`。 + +--- + +## 11. CACHED_MICROCOMPACT + +**编译时引用次数**: 12 +**功能描述**: 缓存微压缩功能。在对话压缩时使用缓存策略优化性能。 +**分类**: COMPLETE +**启用条件**: 将 `CACHED_MICROCOMPACT` 编译标志设为 `true` + +**实现文件**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/services/compact/microCompact.ts | 530 行 | 微压缩核心实现 | + +**引用该标志的文件（5 个）**: +1. src/constants/prompts.ts — 提示词常量 +2. src/query.ts — 查询引擎 +3. src/services/api/claude.ts — Claude API 服务 +4. src/services/api/logging.ts — API 日志 +5. src/services/compact/microCompact.ts — 微压缩核心 + +**启用所需操作**: 仅需将编译标志 `CACHED_MICROCOMPACT` 设为 `true`。 + +--- + +## 12. TOKEN_BUDGET `[build: ON] [dev: ON]` *NEW* + +**编译时引用次数**: 9 +**功能描述**: Token 预算管理。允许设置和跟踪 token 使用预算，在接近限制时提供警告。 +**分类**: COMPLETE +**启用条件**: 将 `TOKEN_BUDGET` 编译标志设为 `true` + +**核心实现文件（共 166 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/utils/tokenBudget.ts | 73 行 | Token 预算核心逻辑 | +| src/query/tokenBudget.ts | 93 行 | 查询层的 Token 预算管理 | + +**引用该标志的文件（6 个）**: +1. src/components/PromptInput/PromptInput.tsx — 提示输入中的预算显示 +2. src/components/Spinner.tsx — 加载指示器中的预算信息 +3. src/constants/prompts.ts — 提示词中的预算指令 +4. src/query.ts — 查询引擎中的预算检查 +5. src/screens/REPL.tsx — REPL 中的预算集成 +6. src/utils/attachments.ts — 附件处理中的预算计算 + +**启用所需操作**: 仅需将编译标志 `TOKEN_BUDGET` 设为 `true`。 + +--- + +## 13. AGENT_TRIGGERS + +**编译时引用次数**: 11 +**功能描述**: 代理触发器/定时任务。允许 AI 创建、管理和执行 cron 定时任务。 +**分类**: COMPLETE +**启用条件**: 将 `AGENT_TRIGGERS` 编译标志设为 `true` + +**核心实现文件（共 543 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/tools/ScheduleCronTool/CronCreateTool.ts | 157 行 | Cron 创建工具 | +| src/tools/ScheduleCronTool/prompt.ts | 135 行 | Cron 工具提示词 | +| src/tools/ScheduleCronTool/CronListTool.ts | 97 行 | Cron 列表工具 | +| src/tools/ScheduleCronTool/CronDeleteTool.ts | 95 行 | Cron 删除工具 | +| src/tools/ScheduleCronTool/UI.tsx | 59 行 | Cron UI 组件 | + +**引用该标志的文件（6 个）**: +1. src/cli/print.ts — CLI 输出 +2. src/constants/tools.ts — 工具常量 +3. src/screens/REPL.tsx — REPL 集成 +4. src/skills/bundled/index.ts — 内置技能 +5. src/tools.ts — 工具注册 +6. src/tools/ScheduleCronTool/prompt.ts — Cron 提示词 + +**启用所需操作**: 仅需将编译标志 `AGENT_TRIGGERS` 设为 `true`。 + +--- + +## 14. REACTIVE_COMPACT + +**编译时引用次数**: 5（单引号 4 + 双引号 1） +**功能描述**: 响应式压缩。根据上下文使用情况动态触发对话压缩。 +**分类**: COMPLETE +**启用条件**: 将 `REACTIVE_COMPACT` 编译标志设为 `true` + +**实现文件（压缩服务已完整，共 2,586 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/services/compact/compact.ts | 1,705 行 | 压缩核心逻辑 | +| src/services/compact/microCompact.ts | 530 行 | 微压缩 | +| src/services/compact/autoCompact.ts | 351 行 | 自动压缩触发 | + +**引用该标志的文件（5 个）**: +1. src/commands/compact/compact.ts — 压缩命令 +2. src/components/TokenWarning.tsx — Token 警告 +3. src/query.ts — 查询引擎 +4. src/services/compact/autoCompact.ts — 自动压缩 +5. src/utils/analyzeContext.ts — 上下文分析 + +**启用所需操作**: 仅需将编译标志 `REACTIVE_COMPACT` 设为 `true`。 + +--- + +## 15. KAIROS_BRIEF + +**编译时引用次数**: 39 +**功能描述**: Kairos Brief 功能。提供简报工具，允许 AI 生成和管理项目简报。 +**分类**: COMPLETE +**启用条件**: 将 `KAIROS_BRIEF` 编译标志设为 `true` + +**核心实现文件（共 334 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/tools/BriefTool/BriefTool.ts | 204 行 | Brief 工具核心 | +| src/commands/brief.ts | 130 行 | Brief 命令实现 | + +**引用该标志的文件（20 个）**: +1. src/commands.ts — 命令注册 +2. src/commands/brief.ts — Brief 命令 +3. src/components/Messages.tsx — 消息组件 +4. src/components/PromptInput/Notifications.tsx — 通知 +5. src/components/PromptInput/PromptInput.tsx — 提示输入 +6. src/components/PromptInput/PromptInputQueuedCommands.tsx — 排队命令 +7. src/components/Settings/Config.tsx — 设置 +8. src/components/Spinner.tsx — 加载指示器 +9. src/components/messages/UserPromptMessage.tsx — 用户提示消息 +10. src/components/messages/UserToolResultMessage/UserToolSuccessMessage.tsx — 工具成功消息 +11. src/constants/prompts.ts — 提示词 +12. src/hooks/useGlobalKeybindings.tsx — 全局键绑定 +13. src/keybindings/defaultBindings.ts — 默认键绑定 +14. src/main.tsx — 主入口 +15. src/tools/BriefTool/BriefTool.ts — Brief 工具 +16. src/tools/ToolSearchTool/prompt.ts — 工具搜索提示 +17. src/utils/attachments.ts — 附件 +18. src/utils/conversationRecovery.ts — 对话恢复 +19. src/utils/permissions/permissionRuleParser.ts — 权限规则解析 +20. src/utils/settings/types.ts — 设置类型 + +**启用所需操作**: 仅需将编译标志 `KAIROS_BRIEF` 设为 `true`。 + +--- + +## 16. CCR_REMOTE_SETUP + +**编译时引用次数**: 1 +**功能描述**: CCR（Claude Code Remote）远程设置命令。 +**分类**: COMPLETE +**启用条件**: 将 `CCR_REMOTE_SETUP` 编译标志设为 `true` + +**引用该标志的文件（1 个）**: +1. src/commands.ts — 条件注册远程设置命令 + +**启用所需操作**: 仅需将编译标志 `CCR_REMOTE_SETUP` 设为 `true`。命令文件通过条件 require 加载。 + +--- + +## 17. SHOT_STATS `[build: ON] [dev: ON]` *NEW* + +**编译时引用次数**: 10 +**功能描述**: 统计功能。提供详细的会话统计信息，包括 token 使用、工具调用、时间统计等，带有完整的 UI 面板。 +**分类**: COMPLETE +**启用条件**: 将 `SHOT_STATS` 编译标志设为 `true` + +**核心实现文件（共 2,722 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/components/Stats.tsx | 1,227 行 | 统计 UI 组件 | +| src/utils/stats.ts | 1,061 行 | 统计核心逻辑 | +| src/utils/statsCache.ts | 434 行 | 统计缓存 | + +**引用该标志的文件（3 个）**: +1. src/components/Stats.tsx — 统计 UI +2. src/utils/stats.ts — 统计核心 +3. src/utils/statsCache.ts — 统计缓存 + +**启用所需操作**: 仅需将编译标志 `SHOT_STATS` 设为 `true`。 + +--- + +## 18. BG_SESSIONS + +**编译时引用次数**: 11 +**功能描述**: 后台会话功能。支持对话恢复和并发会话管理，允许会话在后台继续运行。 +**分类**: COMPLETE +**启用条件**: 将 `BG_SESSIONS` 编译标志设为 `true` + +**核心实现文件（共 801 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/utils/conversationRecovery.ts | 597 行 | 对话恢复逻辑 | +| src/utils/concurrentSessions.ts | 204 行 | 并发会话管理 | + +**引用该标志的文件（7 个）**: +1. src/commands/exit/exit.tsx — 退出命令中的后台会话处理 +2. src/entrypoints/cli.tsx — CLI 入口中的后台会话 +3. src/main.tsx — 主入口 +4. src/query.ts — 查询引擎 +5. src/screens/REPL.tsx — REPL 集成 +6. src/utils/concurrentSessions.ts — 并发会话 +7. src/utils/conversationRecovery.ts — 对话恢复 + +**启用所需操作**: 仅需将编译标志 `BG_SESSIONS` 设为 `true`。 + +--- + +## 19. PROACTIVE + +**编译时引用次数**: 37 +**功能描述**: 主动模式。AI 可以在没有用户输入的情况下主动发起操作或建议。 +**分类**: COMPLETE +**启用条件**: 将 `PROACTIVE` 编译标志设为 `true` + +**核心实现文件（共 63 行，注意：大部分逻辑与 KAIROS 共享，通过 `feature('PROACTIVE') || feature('KAIROS')` 模式门控）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/proactive/index.ts | 57 行 | 主动模式入口 | +| src/proactive/useProactive.ts | 6 行 | 主动模式 Hook | + +**引用该标志的文件（15 个）**: +1. src/cli/print.ts — CLI 输出 +2. src/commands.ts — 命令注册（`feature('PROACTIVE') || feature('KAIROS')`） +3. src/commands/clear/conversation.ts — 清除对话 +4. src/components/Messages.tsx — 消息组件 +5. src/components/PromptInput/PromptInputFooterLeftSide.tsx — 页脚 +6. src/components/PromptInput/usePromptInputPlaceholder.ts — 输入占位符 +7. src/constants/prompts.ts — 提示词 +8. src/main.tsx — 主入口 +9. src/screens/REPL.tsx — REPL（多处引用，通过 require 加载 proactive 模块） +10. src/services/compact/prompt.ts — 压缩提示 +11. src/tools.ts — 工具注册 +12. src/tools/AgentTool/AgentTool.tsx — Agent 工具 +13. src/utils/sessionStorage.ts — 会话存储 +14. src/utils/settings/types.ts — 设置类型 +15. src/utils/systemPrompt.ts — 系统提示 + +**特殊说明**: PROACTIVE 在代码中几乎总是与 KAIROS 一起使用（`feature('PROACTIVE') || feature('KAIROS')`），意味着启用 KAIROS 也会启用主动功能。PROACTIVE 模块文件（src/proactive/）存在且有内容。 + +**启用所需操作**: 仅需将编译标志 `PROACTIVE` 设为 `true`。 + +--- + +## 20. CHICAGO_MCP `[build: ON] [dev: ON]` + +**编译时引用次数**: 16 +**功能描述**: Chicago MCP（Computer Use 计算机使用）。集成计算机使用功能，允许 AI 控制桌面应用程序。 +**分类**: COMPLETE +**启用条件**: 将 `CHICAGO_MCP` 编译标志设为 `true` + +**核心实现文件（共 421 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/utils/computerUse/wrapper.tsx | 335 行 | 计算机使用包装器 | +| src/utils/computerUse/cleanup.ts | 86 行 | 计算机使用清理 | + +**引用该标志的文件（10 个）**: +1. src/entrypoints/cli.tsx — CLI 入口 +2. src/main.tsx — 主入口 +3. src/query.ts — 查询引擎 +4. src/query/stopHooks.ts — 停止钩子 +5. src/services/analytics/metadata.ts — 分析元数据 +6. src/services/mcp/client.ts — MCP 客户端 +7. src/services/mcp/config.ts — MCP 配置 +8. src/state/AppStateStore.ts — 应用状态 +9. src/utils/computerUse/cleanup.ts — 清理 +10. src/utils/computerUse/wrapper.tsx — 包装器 + +**启用所需操作**: 仅需将编译标志 `CHICAGO_MCP` 设为 `true`。 + +--- + +## 21. VERIFICATION_AGENT + +**编译时引用次数**: 4 +**功能描述**: 验证代理。内置代理类型，用于验证任务执行结果的正确性。 +**分类**: COMPLETE +**启用条件**: 将 `VERIFICATION_AGENT` 编译标志设为 `true` + +**核心实现文件（共 478 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/tools/TaskUpdateTool/TaskUpdateTool.ts | 406 行 | 任务更新工具 | +| src/tools/AgentTool/builtInAgents.ts | 72 行 | 内置代理定义 | + +**引用该标志的文件（4 个）**: +1. src/constants/prompts.ts — 提示词 +2. src/tools/AgentTool/builtInAgents.ts — 内置代理 +3. src/tools/TaskUpdateTool/TaskUpdateTool.ts — 任务更新工具 +4. src/tools/TodoWriteTool/TodoWriteTool.ts — TodoWrite 工具 + +**启用所需操作**: 仅需将编译标志 `VERIFICATION_AGENT` 设为 `true`。 + +--- + +## 22. PROMPT_CACHE_BREAK_DETECTION `[build: ON] [dev: ON]` *NEW* + +**编译时引用次数**: 9 +**功能描述**: 提示缓存中断检测。检测提示缓存是否被意外破坏，并在压缩时考虑缓存状态。 +**分类**: COMPLETE +**启用条件**: 将 `PROMPT_CACHE_BREAK_DETECTION` 编译标志设为 `true` + +**引用该标志的文件（6 个）**: +1. src/commands/compact/compact.ts — 压缩命令 +2. src/services/api/claude.ts — Claude API 服务 +3. src/services/compact/autoCompact.ts — 自动压缩 +4. src/services/compact/compact.ts — 压缩核心 +5. src/services/compact/microCompact.ts — 微压缩 +6. src/tools/AgentTool/runAgent.ts — 运行 Agent + +**启用所需操作**: 仅需将编译标志 `PROMPT_CACHE_BREAK_DETECTION` 设为 `true`。 + +--- + +# 二、PARTIAL（部分实现）— 共 19 个 + +以下标志有实质性的功能代码，但存在缺失的文件（命令入口、组件等）或关键模块仅有空壳。启用后可能报错或功能不完整。 + +--- + +## 23. KAIROS + +**编译时引用次数**: 156（单引号 154 + 双引号 2） +**功能描述**: Kairos 是 Claude Code 最大的功能集合。它是一个综合性平台功能，涵盖频道通知、主动模式、简报、GitHub Webhook、推送通知等多个子系统。几乎贯穿整个代码库。 +**分类**: PARTIAL +**缺失原因**: `src/commands/assistant/` 目录完全缺失（包括 `index.ts` 和 `gate.ts`），但 `src/commands.ts` 中通过条件 require 引用了 `commands/assistant/index.js` + +**引用该标志的文件（59 个）**: +1. src/bridge/bridgeMain.ts +2. src/bridge/initReplBridge.ts +3. src/cli/print.ts +4. src/commands.ts +5. src/commands/bridge/bridge.tsx +6. src/commands/brief.ts +7. src/commands/clear/conversation.ts +8. src/components/LogoV2/ChannelsNotice.tsx +9. src/components/LogoV2/LogoV2.tsx +10. src/components/Messages.tsx +11. src/components/PromptInput/Notifications.tsx +12. src/components/PromptInput/PromptInput.tsx +13. src/components/PromptInput/PromptInputFooterLeftSide.tsx +14. src/components/PromptInput/PromptInputQueuedCommands.tsx +15. src/components/PromptInput/usePromptInputPlaceholder.ts +16. src/components/Settings/Config.tsx +17. src/components/Spinner.tsx +18. src/components/StatusLine.tsx +19. src/components/messages/UserPromptMessage.tsx +20. src/components/messages/UserTextMessage.tsx +21. src/components/messages/UserToolResultMessage/UserToolSuccessMessage.tsx +22. src/constants/prompts.ts +23. src/hooks/toolPermission/handlers/interactiveHandler.ts +24. src/hooks/useAssistantHistory.ts +25. src/hooks/useCanUseTool.tsx +26. src/hooks/useGlobalKeybindings.tsx +27. src/hooks/useReplBridge.tsx +28. src/interactiveHelpers.tsx +29. src/keybindings/defaultBindings.ts +30. src/main.tsx +31. src/memdir/memdir.ts +32. src/memdir/paths.ts +33. src/screens/REPL.tsx +34. src/services/analytics/metadata.ts +35. src/services/compact/compact.ts +36. src/services/compact/prompt.ts +37. src/services/mcp/channelNotification.ts +38. src/services/mcp/useManageMCPConnections.ts +39. src/skills/bundled/index.ts +40. src/tools.ts +41. src/tools/AgentTool/AgentTool.tsx +42. src/tools/AskUserQuestionTool/AskUserQuestionTool.tsx +43. src/tools/BashTool/BashTool.tsx +44. src/tools/BriefTool/BriefTool.ts +45. src/tools/ConfigTool/supportedSettings.ts +46. src/tools/EnterPlanModeTool/EnterPlanModeTool.ts +47. src/tools/ExitPlanModeTool/ExitPlanModeV2Tool.ts +48. src/tools/PowerShellTool/PowerShellTool.tsx +49. src/tools/ScheduleCronTool/prompt.ts +50. src/tools/ToolSearchTool/prompt.ts +51. src/utils/attachments.ts +52. src/utils/conversationRecovery.ts +53. src/utils/messageQueueManager.ts +54. src/utils/messages.ts +55. src/utils/permissions/permissionRuleParser.ts +56. src/utils/processUserInput/processSlashCommand.tsx +57. src/utils/sessionStorage.ts +58. src/utils/settings/types.ts +59. src/utils/systemPrompt.ts + +**缺失文件**: +- src/commands/assistant/index.ts — 完全缺失（src/commands.ts 第 69 行引用了 `commands/assistant/index.js`） +- src/commands/assistant/gate.ts — 完全缺失 + +**启用所需修复**: 需要创建 `src/commands/assistant/` 目录及其 `index.ts` 和 `gate.ts` 文件。 + +--- + +## 24. BUDDY `[dev: ON]` + +**编译时引用次数**: 18（单引号 16 + 双引号 2） +**功能描述**: 伙伴精灵功能。在 CLI 中显示一个可爱的像素精灵角色作为 AI 助手的化身，有动画、表情、通知等。 +**分类**: PARTIAL +**缺失原因**: `src/commands/buddy/index.ts` 命令入口文件缺失，但 `src/buddy/` 目录下有完整的 1,298 行实现代码 + +**核心实现文件（src/buddy/ 目录，共 1,298 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/buddy/sprites.ts | 514 行 | 精灵图形定义 | +| src/buddy/CompanionSprite.tsx | 370 行 | 精灵 React 组件 | +| src/buddy/types.ts | 148 行 | 类型定义 | +| src/buddy/companion.ts | 133 行 | 伙伴核心逻辑 | +| src/buddy/useBuddyNotification.tsx | 97 行 | 伙伴通知 Hook | +| src/buddy/prompt.ts | 36 行 | 伙伴提示词 | + +**引用该标志的文件（8 个）**: +1. src/buddy/CompanionSprite.tsx — 精灵组件 +2. src/buddy/prompt.ts — 提示词 +3. src/buddy/useBuddyNotification.tsx — 通知 +4. src/commands.ts — 条件注册 `/buddy` 命令（引用 `commands/buddy/index.js`） +5. src/components/PromptInput/PromptInput.tsx — 提示输入 +6. src/screens/REPL.tsx — REPL 集成 +7. src/utils/attachments.ts — 附件 + +**缺失文件**: +- src/commands/buddy/index.ts — 命令入口缺失 + +**启用所需修复**: 需要创建 `src/commands/buddy/index.ts` 命令入口文件。 + +--- + +## 25. MONITOR_TOOL + +**编译时引用次数**: 13 +**功能描述**: 监控工具。允许 AI 在后台启动长时间运行的 shell 任务并监控其输出。 +**分类**: PARTIAL +**缺失原因**: MonitorMcpDetailDialog 和 MonitorPermissionRequest 文件虽然存在但仅有 3 行空壳 + +**核心实现文件**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/tasks/LocalShellTask/LocalShellTask.tsx | 522 行 | 本地 Shell 任务完整实现 | +| src/tools/MonitorTool/MonitorTool.ts | 1 行 | 监控工具（桩） | +| src/tasks/MonitorMcpTask/MonitorMcpTask.ts | 5 行 | MCP 监控任务（桩） | +| src/components/tasks/MonitorMcpDetailDialog.tsx | 3 行 | MCP 详情对话框（桩） | +| src/components/permissions/MonitorPermissionRequest/MonitorPermissionRequest.tsx | 3 行 | 监控权限请求（桩） | + +**引用该标志的文件（9 个）**: +1. src/components/permissions/PermissionRequest.tsx — 权限请求 +2. src/components/tasks/BackgroundTasksDialog.tsx — 后台任务对话框 +3. src/tasks.ts — 任务注册 +4. src/tasks/LocalShellTask/LocalShellTask.tsx — Shell 任务 +5. src/tools.ts — 工具注册 +6. src/tools/AgentTool/runAgent.ts — Agent 运行 +7. src/tools/BashTool/BashTool.tsx — Bash 工具 +8. src/tools/BashTool/prompt.ts — Bash 提示 +9. src/tools/PowerShellTool/PowerShellTool.tsx — PowerShell 工具 + +**启用所需修复**: 需要实现 `src/tools/MonitorTool/MonitorTool.ts`、`src/tasks/MonitorMcpTask/MonitorMcpTask.ts`、`src/components/tasks/MonitorMcpDetailDialog.tsx` 和 `src/components/permissions/MonitorPermissionRequest/MonitorPermissionRequest.tsx`。 + +--- + +## 26. HISTORY_SNIP + +**编译时引用次数**: 16（单引号 15 + 双引号 1） +**功能描述**: 历史剪辑。允许从对话历史中剪切特定片段。 +**分类**: PARTIAL +**缺失原因**: `src/commands/force-snip.ts` 命令文件缺失 + +**引用该标志的文件（8 个）**: +1. src/QueryEngine.ts — 查询引擎 +2. src/commands.ts — 命令注册（引用 `commands/force-snip.js`） +3. src/components/Message.tsx — 消息组件 +4. src/query.ts — 查询 +5. src/tools.ts — 工具注册 +6. src/utils/attachments.ts — 附件 +7. src/utils/collapseReadSearch.ts — 折叠读取搜索 +8. src/utils/messages.ts — 消息处理 + +**缺失文件**: +- src/commands/force-snip.ts — 命令文件缺失 + +**启用所需修复**: 需要创建 `src/commands/force-snip.ts`。 + +--- + +## 27. WORKFLOW_SCRIPTS + +**编译时引用次数**: 10 +**功能描述**: 工作流脚本。允许定义和执行自定义工作流。 +**分类**: PARTIAL +**缺失原因**: 多个核心文件仅有 1-5 行空壳，命令入口目录缺失 + +**实现文件（大部分为空壳）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/components/WorkflowMultiselectDialog.tsx | 127 行 | 工作流多选对话框（有内容） | +| src/tasks/LocalWorkflowTask/LocalWorkflowTask.ts | 5 行 | 本地工作流任务（桩） | +| src/components/tasks/WorkflowDetailDialog.tsx | 3 行 | 工作流详情对话框（桩） | +| src/tools/WorkflowTool/WorkflowPermissionRequest.tsx | 3 行 | 工作流权限请求（桩） | +| src/tools/WorkflowTool/createWorkflowCommand.ts | 3 行 | 创建工作流命令（桩） | +| src/tools/WorkflowTool/WorkflowTool.ts | 1 行 | 工作流工具（桩） | +| src/tools/WorkflowTool/constants.ts | 1 行 | 常量（桩） | + +**引用该标志的文件（7 个）**: +1. src/commands.ts — 命令注册（引用 `commands/workflows/index.js`） +2. src/components/permissions/PermissionRequest.tsx — 权限请求 +3. src/components/tasks/BackgroundTasksDialog.tsx — 后台任务 +4. src/constants/tools.ts — 工具常量 +5. src/tasks.ts — 任务注册 +6. src/tools.ts — 工具注册 +7. src/utils/permissions/classifierDecision.ts — 分类器决策 + +**缺失文件**: +- src/commands/workflows/index.ts — 命令入口目录缺失 + +**启用所需修复**: 需要实现所有空壳文件并创建命令入口。 + +--- + +## 28. UDS_INBOX + +**编译时引用次数**: 18（单引号 17 + 双引号 1） +**功能描述**: UDS（Unix Domain Socket）收件箱。允许 Claude Code 实例之间通过 Unix 套接字发送消息。 +**分类**: PARTIAL +**缺失原因**: `src/utils/udsMessaging.ts` 仅 1 行，`src/utils/udsClient.ts` 仅 3 行（空壳），命令入口缺失 + +**核心实现文件**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/tools/SendMessageTool/SendMessageTool.ts | 917 行 | 发送消息工具（完整实现） | +| src/tools/SendMessageTool/prompt.ts | 49 行 | 消息工具提示词 | +| src/utils/udsClient.ts | 3 行 | UDS 客户端（桩） | +| src/utils/udsMessaging.ts | 1 行 | UDS 消息（桩） | + +**引用该标志的文件（10 个）**: +1. src/cli/print.ts — CLI 输出 +2. src/commands.ts — 命令注册（引用 `commands/peers/index.js`） +3. src/components/messages/UserTextMessage.tsx — 用户消息 +4. src/main.tsx — 主入口 +5. src/setup.ts — 初始化 +6. src/tools.ts — 工具注册 +7. src/tools/SendMessageTool/SendMessageTool.ts — 发送消息工具 +8. src/tools/SendMessageTool/prompt.ts — 提示词 +9. src/utils/concurrentSessions.ts — 并发会话 +10. src/utils/messages/systemInit.ts — 系统初始化消息 + +**缺失文件**: +- src/commands/peers/index.ts — 命令入口缺失 +- src/utils/udsMessaging.ts — 仅 1 行空壳 +- src/utils/udsClient.ts — 仅 3 行空壳 + +**启用所需修复**: 需要实现 UDS 客户端和消息模块，并创建命令入口。 + +--- + +## 29. KAIROS_CHANNELS + +**编译时引用次数**: 21（单引号 19 + 双引号 2） +**功能描述**: Kairos 频道功能。MCP 频道通知系统。 +**分类**: PARTIAL +**缺失原因**: 依赖 KAIROS 的 assistant/gate.ts 模块 + +**核心实现文件（共 581 行）**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/services/mcp/channelNotification.ts | 316 行 | 频道通知服务 | +| src/components/LogoV2/ChannelsNotice.tsx | 265 行 | 频道通知 UI | + +**引用该标志的文件（15 个）**: +1. src/cli/print.ts +2. src/components/LogoV2/ChannelsNotice.tsx +3. src/components/LogoV2/LogoV2.tsx +4. src/components/messages/UserTextMessage.tsx +5. src/hooks/toolPermission/handlers/interactiveHandler.ts +6. src/hooks/useCanUseTool.tsx +7. src/interactiveHelpers.tsx +8. src/main.tsx +9. src/services/mcp/channelNotification.ts +10. src/services/mcp/useManageMCPConnections.ts +11. src/tools/AskUserQuestionTool/AskUserQuestionTool.tsx +12. src/tools/EnterPlanModeTool/EnterPlanModeTool.ts +13. src/tools/ExitPlanModeTool/ExitPlanModeV2Tool.ts +14. src/utils/messageQueueManager.ts +15. src/utils/messages.ts + +**启用所需修复**: 需先修复 KAIROS 的缺失文件。 + +--- + +## 30. FORK_SUBAGENT + +**编译时引用次数**: 5（单引号 4 + 双引号 1） +**功能描述**: 分叉子代理。允许从当前会话分叉出独立的子代理进程。 +**分类**: PARTIAL +**缺失原因**: `src/commands/fork/index.ts` 命令入口缺失（注意：代码中引用的是 `commands/branch/index.js`，而 `src/commands/branch/index.ts` 存在） + +**核心实现文件**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/tools/AgentTool/forkSubagent.ts | 210 行 | 分叉子代理核心逻辑 | + +**引用该标志的文件（5 个）**: +1. src/commands.ts — 命令注册 +2. src/commands/branch/index.ts — 分支命令入口 +3. src/components/messages/UserTextMessage.tsx — 用户消息 +4. src/tools/AgentTool/forkSubagent.ts — 分叉逻辑 +5. src/tools/ToolSearchTool/prompt.ts — 工具搜索提示 + +**缺失文件**: +- src/commands/fork/index.ts — 命令入口缺失（但 branch/index.ts 存在，可能是重命名） + +**启用所需修复**: 需确认命令入口路径是否正确。 + +--- + +## 31. EXPERIMENTAL_SKILL_SEARCH + +**编译时引用次数**: 21 +**功能描述**: 实验性技能搜索。本地技能搜索功能。 +**分类**: PARTIAL +**缺失原因**: 核心搜索逻辑可能不完整（SkillTool.ts 有 1,108 行但 localSearch 功能可能缺失） + +**引用该标志的文件（9 个）**: +1. src/commands.ts — 命令注册 +2. src/components/messages/AttachmentMessage.tsx — 附件消息 +3. src/constants/prompts.ts — 提示词 +4. src/query.ts — 查询 +5. src/services/compact/compact.ts — 压缩 +6. src/services/mcp/useManageMCPConnections.ts — MCP 连接管理 +7. src/tools/SkillTool/SkillTool.ts — 技能工具（1,108 行） +8. src/utils/attachments.ts — 附件 +9. src/utils/messages.ts — 消息 + +--- + +## 32. WEB_BROWSER_TOOL + +**编译时引用次数**: 4 +**功能描述**: Web 浏览器工具。允许 AI 在面板中打开和操作网页。 +**分类**: PARTIAL +**缺失原因**: `src/tools/WebBrowserTool/WebBrowserPanel.tsx` 仅 3 行，返回 `null` + +**实现文件**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/tools/WebBrowserTool/WebBrowserPanel.tsx | 3 行 | `export function WebBrowserPanel() { return null }` | + +**引用该标志的文件（3 个）**: +1. src/main.tsx — 主入口 +2. src/screens/REPL.tsx — REPL +3. src/tools.ts — 工具注册 + +**启用所需修复**: 需要实现 `WebBrowserPanel.tsx`。 + +--- + +## 33. MCP_SKILLS + +**编译时引用次数**: 9 +**功能描述**: MCP 技能系统。通过 MCP 协议加载和运行技能。 +**分类**: PARTIAL + +**实现文件**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/skills/mcpSkillBuilders.ts | 44 行 | MCP 技能构建器 | +| src/skills/mcpSkills.ts | 3 行 | MCP 技能（桩） | + +**引用该标志的文件（3 个）**: +1. src/commands.ts — 命令注册 +2. src/services/mcp/client.ts — MCP 客户端 +3. src/services/mcp/useManageMCPConnections.ts — MCP 连接管理 + +--- + +## 34. REVIEW_ARTIFACT + +**编译时引用次数**: 4 +**功能描述**: 审查工件。允许 AI 审查和标注工件（代码片段、文档等）。 +**分类**: PARTIAL +**缺失原因**: ReviewArtifactTool.ts 仅 1 行，ReviewArtifactPermissionRequest.tsx 仅 3 行 + +**实现文件**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/tools/ReviewArtifactTool/ReviewArtifactTool.ts | 1 行 | 审查工件工具（桩） | +| src/components/permissions/ReviewArtifactPermissionRequest/ReviewArtifactPermissionRequest.tsx | 3 行 | 权限请求（桩） | + +**引用该标志的文件（2 个）**: +1. src/components/permissions/PermissionRequest.tsx — 权限请求 +2. src/skills/bundled/index.ts — 内置技能 + +--- + +## 35. KAIROS_GITHUB_WEBHOOKS + +**编译时引用次数**: 4（单引号 3 + 双引号 1） +**功能描述**: Kairos GitHub Webhooks。订阅 GitHub PR 活动的 Webhook。 +**分类**: PARTIAL +**缺失原因**: `src/commands/subscribe-pr.ts` 命令文件缺失 + +**引用该标志的文件（4 个）**: +1. src/commands.ts — 命令注册（引用 `commands/subscribe-pr.js`） +2. src/components/messages/UserTextMessage.tsx — 用户消息 +3. src/hooks/useReplBridge.tsx — REPL 桥接 +4. src/tools.ts — 工具注册 + +**缺失文件**: +- src/commands/subscribe-pr.ts — 命令文件缺失 + +--- + +## 36. CONNECTOR_TEXT + +**编译时引用次数**: 8（单引号 7 + 双引号 1） +**功能描述**: 连接器文本。控制消息中的连接器文本显示方式。 +**分类**: PARTIAL + +**引用该标志的文件（5 个）**: +1. src/components/Message.tsx — 消息组件 +2. src/constants/betas.ts — Beta 常量 +3. src/services/api/claude.ts — Claude API +4. src/services/api/logging.ts — API 日志 +5. src/utils/messages.ts — 消息处理 + +--- + +## 37. TEMPLATES + +**编译时引用次数**: 6 +**功能描述**: 模板系统。支持从 Markdown 配置文件加载模板。 +**分类**: PARTIAL + +**实现文件**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/utils/markdownConfigLoader.ts | 600 行 | Markdown 配置加载器 | +| src/keybindings/template.ts | 52 行 | 模板键绑定 | + +**引用该标志的文件（5 个）**: +1. src/entrypoints/cli.tsx — CLI 入口 +2. src/query.ts — 查询 +3. src/query/stopHooks.ts — 停止钩子 +4. src/utils/markdownConfigLoader.ts — 配置加载器 +5. src/utils/permissions/filesystem.ts — 文件系统权限 + +--- + +## 38. LODESTONE + +**编译时引用次数**: 6 +**功能描述**: Lodestone 功能。具体功能不明确，可能与导航或指引相关。 +**分类**: PARTIAL + +**引用该标志的文件（4 个）**: +1. src/interactiveHelpers.tsx — 交互帮助 +2. src/main.tsx — 主入口 +3. src/utils/backgroundHousekeeping.ts — 后台维护 +4. src/utils/settings/types.ts — 设置类型 + +**说明**: 没有专属实现文件，代码散布在 4 个文件中。 + +--- + +## 39. HISTORY_PICKER + +**编译时引用次数**: 4 +**功能描述**: 历史选择器。交互式历史搜索和选择。 +**分类**: PARTIAL + +**实现文件**: + +| 文件路径 | 行数 | 功能说明 | +|----------|------|----------| +| src/hooks/useHistorySearch.ts | 303 行 | 历史搜索 Hook | + +**引用该标志的文件（2 个）**: +1. src/components/PromptInput/PromptInput.tsx — 提示输入 +2. src/hooks/useHistorySearch.ts — 历史搜索 + +--- + +## 40. MESSAGE_ACTIONS + +**编译时引用次数**: 5 +**功能描述**: 消息操作。对消息执行操作（如复制、编辑、重试等）。 +**分类**: PARTIAL + +**引用该标志的文件（2 个）**: +1. src/keybindings/defaultBindings.ts — 默认键绑定 +2. src/screens/REPL.tsx — REPL + +--- + +## 41. TERMINAL_PANEL + +**编译时引用次数**: 5（单引号 4 + 双引号 1） +**功能描述**: 终端面板。在 UI 中显示内嵌终端面板。 +**分类**: PARTIAL + +**引用该标志的文件（5 个）**: +1. src/components/PromptInput/PromptInputHelpMenu.tsx — 帮助菜单 +2. src/hooks/useGlobalKeybindings.tsx — 全局键绑定 +3. src/keybindings/defaultBindings.ts — 默认键绑定 +4. src/tools.ts — 工具注册 +5. src/utils/permissions/classifierDecision.ts — 分类器决策 + +--- + +# 三、STUB（纯桩/最小实现）— 共 51 个 + +以下标志仅有极少的引用（通常 1-3 处），没有或几乎没有实际功能代码。代码只是为该标志预留了位置。 + +--- + +## 42. TORCH + +**编译时引用次数**: 1 +**功能描述**: Torch 功能（具体不明）。 +**分类**: STUB +**引用文件**: src/commands.ts — 条件注册 `/torch` 命令（引用 `commands/torch.js`） +**缺失文件**: src/commands/torch.ts — 命令文件完全不存在 +**代码量**: 0 行专属代码 +**说明**: 纯占位符，没有任何实现。 + +--- + +## 43. KAIROS_DREAM + +**编译时引用次数**: 1 +**功能描述**: Kairos Dream（具体不明）。 +**分类**: STUB +**引用文件**: src/skills/bundled/index.ts — 内置技能注册 +**代码量**: 0 行专属代码 + +--- + +## 44. KAIROS_PUSH_NOTIFICATION + +**编译时引用次数**: 4 +**功能描述**: Kairos 推送通知。 +**分类**: STUB +**引用文件**: +1. src/components/Settings/Config.tsx — 设置 +2. src/tools.ts — 工具注册 +3. src/tools/ConfigTool/supportedSettings.ts — 支持的设置 +**代码量**: 0 行专属代码，仅在设置中预留了开关位 + +--- + +## 45. DAEMON + +**编译时引用次数**: 3 +**功能描述**: 守护进程模式。 +**分类**: STUB +**引用文件**: +1. src/commands.ts — 条件注册命令（与 BRIDGE_MODE 组合） +2. src/entrypoints/cli.tsx — CLI 入口 +**代码量**: 0 行专属代码 +**说明**: 在 commands.ts 中，`DAEMON` 与 `BRIDGE_MODE` 一起用于条件加载 `commands/remoteControlServer/index.js`，该文件不存在。 + +--- + +## 46. DIRECT_CONNECT + +**编译时引用次数**: 5 +**功能描述**: 直连模式。 +**分类**: STUB +**引用文件**: src/main.tsx — 主入口 +**代码量**: 0 行专属代码 + +--- + +## 47. SSH_REMOTE + +**编译时引用次数**: 4 +**功能描述**: SSH 远程连接。 +**分类**: STUB +**引用文件**: src/main.tsx — 主入口 +**代码量**: 0 行专属代码 + +--- + +## 48. STREAMLINED_OUTPUT + +**编译时引用次数**: 1 +**功能描述**: 精简输出模式。 +**分类**: STUB +**引用文件**: src/cli/print.ts — CLI 输出 +**代码量**: 0 行专属代码 + +--- + +## 49. ANTI_DISTILLATION_CC + +**编译时引用次数**: 1 +**功能描述**: 反蒸馏（防止模型蒸馏攻击）。 +**分类**: STUB +**引用文件**: src/services/api/claude.ts — Claude API 服务 +**代码量**: 0 行专属代码 + +--- + +## 50. NATIVE_CLIENT_ATTESTATION + +**编译时引用次数**: 1 +**功能描述**: 原生客户端认证。 +**分类**: STUB +**引用文件**: src/constants/system.ts — 系统常量 +**代码量**: 0 行专属代码 + +--- + +## 51. ABLATION_BASELINE + +**编译时引用次数**: 1 +**功能描述**: 消融基线测试。 +**分类**: STUB +**引用文件**: src/entrypoints/cli.tsx — CLI 入口 +**代码量**: 0 行专属代码 + +--- + +## 52. AGENT_MEMORY_SNAPSHOT + +**编译时引用次数**: 2 +**功能描述**: 代理记忆快照。 +**分类**: STUB +**引用文件**: +1. src/main.tsx — 主入口 +2. src/tools/AgentTool/loadAgentsDir.ts — 加载代理目录 +**代码量**: 0 行专属代码 + +--- + +## 53. AGENT_TRIGGERS_REMOTE `[build: ON] [dev: ON]` + +**编译时引用次数**: 2 +**功能描述**: 远程代理触发器。 +**分类**: STUB +**引用文件**: +1. src/skills/bundled/index.ts — 内置技能 +2. src/tools.ts — 工具注册 +**代码量**: 0 行专属代码 + +--- + +## 54. ALLOW_TEST_VERSIONS + +**编译时引用次数**: 2 +**功能描述**: 允许测试版本。 +**分类**: STUB +**引用文件**: src/utils/nativeInstaller/download.ts — 原生安装器下载（523 行，但标志仅用于一处条件判断） +**代码量**: 0 行专属代码 + +--- + +## 55. AUTO_THEME + +**编译时引用次数**: 3（单引号 2 + 双引号 1） +**功能描述**: 自动主题切换。 +**分类**: STUB +**引用文件**: +1. src/components/ThemePicker.tsx — 主题选择器 +2. src/components/design-system/ThemeProvider.tsx — 主题提供者 +3. src/tools/ConfigTool/supportedSettings.ts — 支持的设置 +**代码量**: 0 行专属代码 + +--- + +## 56. AWAY_SUMMARY + +**编译时引用次数**: 2 +**功能描述**: 离开摘要。用户离开时生成会话摘要。 +**分类**: STUB +**引用文件**: +1. src/hooks/useAwaySummary.ts — 离开摘要 Hook（125 行，但功能可能不完整） +2. src/screens/REPL.tsx — REPL +**代码量**: 约 125 行（useAwaySummary.ts） + +--- + +## 57. BREAK_CACHE_COMMAND + +**编译时引用次数**: 2 +**功能描述**: 缓存中断命令。 +**分类**: STUB +**引用文件**: src/context.ts — 上下文 +**代码量**: 0 行专属代码 + +--- + +## 58. BUILDING_CLAUDE_APPS + +**编译时引用次数**: 1 +**功能描述**: 构建 Claude 应用程序。 +**分类**: STUB +**引用文件**: src/skills/bundled/index.ts — 内置技能 +**代码量**: 0 行专属代码 + +--- + +## 59. BUILTIN_EXPLORE_PLAN_AGENTS + +**编译时引用次数**: 1 +**功能描述**: 内置探索和计划代理。 +**分类**: STUB +**引用文件**: src/tools/AgentTool/builtInAgents.ts — 内置代理定义 +**代码量**: 0 行专属代码 + +--- + +## 60. BYOC_ENVIRONMENT_RUNNER + +**编译时引用次数**: 1 +**功能描述**: BYOC（Bring Your Own Cloud）环境运行器。 +**分类**: STUB +**引用文件**: src/entrypoints/cli.tsx — CLI 入口 +**代码量**: 0 行专属代码 + +--- + +## 61. CCR_AUTO_CONNECT + +**编译时引用次数**: 3 +**功能描述**: CCR 自动连接。 +**分类**: STUB +**引用文件**: +1. src/bridge/bridgeEnabled.ts — 桥接启用检测 +2. src/utils/config.ts — 配置 +**代码量**: 0 行专属代码 + +--- + +## 62. CCR_MIRROR + +**编译时引用次数**: 4 +**功能描述**: CCR 镜像模式。 +**分类**: STUB +**引用文件**: +1. src/bridge/bridgeEnabled.ts — 桥接启用检测 +2. src/bridge/remoteBridgeCore.ts — 远程桥接核心 +3. src/main.tsx — 主入口 +**代码量**: 0 行专属代码 + +--- + +## 63. COMPACTION_REMINDERS + +**编译时引用次数**: 1 +**功能描述**: 压缩提醒。 +**分类**: STUB +**引用文件**: src/utils/attachments.ts — 附件处理 +**代码量**: 0 行专属代码 + +--- + +## 64. COWORKER_TYPE_TELEMETRY + +**编译时引用次数**: 2 +**功能描述**: 共同工作者类型遥测。 +**分类**: STUB +**引用文件**: src/services/analytics/metadata.ts — 分析元数据 +**代码量**: 0 行专属代码 + +--- + +## 65. DOWNLOAD_USER_SETTINGS + +**编译时引用次数**: 5 +**功能描述**: 下载用户设置（从远程同步）。 +**分类**: STUB +**引用文件**: +1. src/cli/print.ts — CLI 输出 +2. src/commands/reload-plugins/reload-plugins.ts — 重载插件 +3. src/services/settingsSync/index.ts — 设置同步 +**代码量**: 0 行专属代码 + +--- + +## 66. DUMP_SYSTEM_PROMPT + +**编译时引用次数**: 1 +**功能描述**: 转储系统提示（调试用）。 +**分类**: STUB +**引用文件**: src/entrypoints/cli.tsx — CLI 入口 +**代码量**: 0 行专属代码 + +--- + +## 67. ENHANCED_TELEMETRY_BETA + +**编译时引用次数**: 2 +**功能描述**: 增强遥测 Beta。 +**分类**: STUB +**引用文件**: src/utils/telemetry/sessionTracing.ts — 会话追踪（927 行，但标志仅用于一处条件） +**代码量**: 0 行专属代码 + +--- + +## 68. FILE_PERSISTENCE + +**编译时引用次数**: 3 +**功能描述**: 文件持久化。 +**分类**: STUB +**引用文件**: +1. src/cli/print.ts — CLI 输出 +2. src/utils/filePersistence/filePersistence.ts — 文件持久化（287 行） +**代码量**: 约 287 行（filePersistence.ts），但仅 3 处引用 + +--- + +## 69. HARD_FAIL + +**编译时引用次数**: 2 +**功能描述**: 硬失败模式（遇到错误时立即退出而非优雅降级）。 +**分类**: STUB +**引用文件**: +1. src/main.tsx — 主入口 +2. src/utils/log.ts — 日志工具 +**代码量**: 0 行专属代码 + +--- + +## 70. HOOK_PROMPTS + +**编译时引用次数**: 1 +**功能描述**: 钩子提示。 +**分类**: STUB +**引用文件**: src/screens/REPL.tsx — REPL +**代码量**: 0 行专属代码 + +--- + +## 71. IS_LIBC_GLIBC + +**编译时引用次数**: 1 +**功能描述**: 检测 libc 是否为 glibc。 +**分类**: STUB +**引用文件**: src/utils/envDynamic.ts — 动态环境检测（151 行） +**代码量**: 0 行专属代码（标志用于条件编译） + +--- + +## 72. IS_LIBC_MUSL + +**编译时引用次数**: 1 +**功能描述**: 检测 libc 是否为 musl。 +**分类**: STUB +**引用文件**: src/utils/envDynamic.ts — 动态环境检测（151 行） +**代码量**: 0 行专属代码（标志用于条件编译） + +--- + +## 73. MCP_RICH_OUTPUT + +**编译时引用次数**: 3 +**功能描述**: MCP 富文本输出。 +**分类**: STUB +**引用文件**: src/tools/MCPTool/UI.tsx — MCP 工具 UI +**代码量**: 0 行专属代码 + +--- + +## 74. MEMORY_SHAPE_TELEMETRY + +**编译时引用次数**: 3 +**功能描述**: 记忆形状遥测。 +**分类**: STUB +**引用文件**: +1. src/memdir/findRelevantMemories.ts — 查找相关记忆 +2. src/utils/sessionFileAccessHooks.ts — 会话文件访问钩子 +**代码量**: 0 行专属代码 + +--- + +## 75. NATIVE_CLIPBOARD_IMAGE + +**编译时引用次数**: 2 +**功能描述**: 原生剪贴板图片支持。 +**分类**: STUB +**引用文件**: src/utils/imagePaste.ts — 图片粘贴（416 行，但标志仅用于一处条件） +**代码量**: 0 行专属代码 + +--- + +## 76. NEW_INIT + +**编译时引用次数**: 2 +**功能描述**: 新的初始化流程。 +**分类**: STUB +**引用文件**: src/commands/init.ts — 初始化命令 +**代码量**: 0 行专属代码 + +--- + +## 77. OVERFLOW_TEST_TOOL + +**编译时引用次数**: 2 +**功能描述**: 溢出测试工具（内部测试用）。 +**分类**: STUB +**引用文件**: +1. src/tools.ts — 工具注册 +2. src/utils/permissions/classifierDecision.ts — 分类器决策 +**代码量**: 0 行专属代码 + +--- + +## 78. PERFETTO_TRACING + +**编译时引用次数**: 1 +**功能描述**: Perfetto 追踪（性能追踪工具）。 +**分类**: STUB +**引用文件**: src/utils/telemetry/perfettoTracing.ts — Perfetto 追踪（1,120 行，但标志仅用于一处） +**代码量**: 约 1,120 行（perfettoTracing.ts）存在，但仅 1 处引用 + +--- + +## 79. POWERSHELL_AUTO_MODE + +**编译时引用次数**: 2 +**功能描述**: PowerShell 自动模式。 +**分类**: STUB +**引用文件**: +1. src/utils/permissions/permissions.ts — 权限 +2. src/utils/permissions/yoloClassifier.ts — YOLO 分类器 +**代码量**: 0 行专属代码 + +--- + +## 80. QUICK_SEARCH + +**编译时引用次数**: 5 +**功能描述**: 快速搜索。 +**分类**: STUB +**引用文件**: +1. src/components/PromptInput/PromptInput.tsx — 提示输入 +2. src/keybindings/defaultBindings.ts — 默认键绑定 +**代码量**: 0 行专属代码 + +--- + +## 81. RUN_SKILL_GENERATOR + +**编译时引用次数**: 1 +**功能描述**: 运行技能生成器。 +**分类**: STUB +**引用文件**: src/skills/bundled/index.ts — 内置技能 +**代码量**: 0 行专属代码 + +--- + +## 82. SELF_HOSTED_RUNNER + +**编译时引用次数**: 1 +**功能描述**: 自托管运行器。 +**分类**: STUB +**引用文件**: src/entrypoints/cli.tsx — CLI 入口 +**代码量**: 0 行专属代码 + +--- + +## 83. SKILL_IMPROVEMENT + +**编译时引用次数**: 1 +**功能描述**: 技能改进。 +**分类**: STUB +**引用文件**: src/utils/hooks/skillImprovement.ts — 技能改进（267 行，但标志仅 1 处引用） +**代码量**: 约 267 行（skillImprovement.ts） + +--- + +## 84. SLOW_OPERATION_LOGGING + +**编译时引用次数**: 1 +**功能描述**: 慢操作日志记录。 +**分类**: STUB +**引用文件**: src/utils/slowOperations.ts — 慢操作（286 行，但标志仅 1 处引用） +**代码量**: 约 286 行（slowOperations.ts） + +--- + +## 85. TREE_SITTER_BASH + +**编译时引用次数**: 3 +**功能描述**: Tree-sitter Bash 解析器。 +**分类**: STUB +**引用文件**: src/utils/bash/parser.ts — Bash 解析器 +**代码量**: 0 行专属代码 + +--- + +## 86. TREE_SITTER_BASH_SHADOW + +**编译时引用次数**: 5 +**功能描述**: Tree-sitter Bash 影子模式（并行运行 tree-sitter 和传统解析器进行对比）。 +**分类**: STUB +**引用文件**: +1. src/tools/BashTool/bashPermissions.ts — Bash 权限 +2. src/utils/bash/parser.ts — Bash 解析器 +**代码量**: 0 行专属代码 + +--- + +## 87. ULTRATHINK + +**编译时引用次数**: 1 +**功能描述**: 超级思考模式。 +**分类**: STUB +**引用文件**: src/utils/thinking.ts — 思考工具（162 行，但标志仅 1 处引用） +**代码量**: 0 行专属代码 + +--- + +## 88. UNATTENDED_RETRY + +**编译时引用次数**: 1 +**功能描述**: 无人值守重试。 +**分类**: STUB +**引用文件**: src/services/api/withRetry.ts — API 重试 +**代码量**: 0 行专属代码 + +--- + +## 89. UPLOAD_USER_SETTINGS + +**编译时引用次数**: 2 +**功能描述**: 上传用户设置（同步到远程）。 +**分类**: STUB +**引用文件**: +1. src/main.tsx — 主入口 +2. src/services/settingsSync/index.ts — 设置同步 +**代码量**: 0 行专属代码 + +--- + +## 90. SKIP_DETECTION_WHEN_AUTOUPDATES_DISABLED + +**编译时引用次数**: 1（仅双引号形式） +**功能描述**: 当自动更新禁用时跳过检测。 +**分类**: STUB +**引用文件**: src/components/AutoUpdaterWrapper.tsx — 自动更新包装器 +**代码量**: 0 行专属代码 + +--- + +## 91. QUICK_SEARCH（已在 #80 列出） + +注：QUICK_SEARCH 已在 #80 列出。总计为 92 个独立标志（含 SKIP_DETECTION_WHEN_AUTOUPDATES_DISABLED）。 + +--- + +# 四、缺失文件汇总 + +以下是 `src/commands.ts` 中通过 `feature()` 条件 require 引用的文件，但在源代码中不存在： + +| 标志 | 引用路径 | 状态 | +|------|----------|------| +| TORCH | commands/torch.js | 文件完全不存在，无 .ts 版本 | +| PROACTIVE（与 KAIROS 共用） | commands/assistant/index.js | 整个 commands/assistant/ 目录不存在 | +| KAIROS | commands/assistant/index.js | 同上 | +| DAEMON + BRIDGE_MODE | commands/remoteControlServer/index.js | 文件不存在 | +| HISTORY_SNIP | commands/force-snip.js | 文件完全不存在，无 .ts 版本 | +| WORKFLOW_SCRIPTS | commands/workflows/index.js | 整个 commands/workflows/ 目录不存在 | +| KAIROS_GITHUB_WEBHOOKS | commands/subscribe-pr.js | 文件完全不存在，无 .ts 版本 | +| UDS_INBOX | commands/peers/index.js | 整个 commands/peers/ 目录不存在 | +| BUDDY | commands/buddy/index.js | 整个 commands/buddy/ 目录不存在（但 src/buddy/ 有 1,298 行实现） | + +以下是源代码中通过条件 require 引用但内容为空壳（1-5 行）的文件： + +| 文件路径 | 行数 | 所属标志 | +|----------|------|----------| +| src/tools/MonitorTool/MonitorTool.ts | 1 行 | MONITOR_TOOL | +| src/tools/WorkflowTool/WorkflowTool.ts | 1 行 | WORKFLOW_SCRIPTS | +| src/tools/WorkflowTool/constants.ts | 1 行 | WORKFLOW_SCRIPTS | +| src/tools/ReviewArtifactTool/ReviewArtifactTool.ts | 1 行 | REVIEW_ARTIFACT | +| src/utils/udsMessaging.ts | 1 行 | UDS_INBOX | +| src/utils/udsClient.ts | 3 行 | UDS_INBOX | +| src/skills/mcpSkills.ts | 3 行 | MCP_SKILLS | +| src/tools/WebBrowserTool/WebBrowserPanel.tsx | 3 行 | WEB_BROWSER_TOOL | +| src/tools/WorkflowTool/createWorkflowCommand.ts | 3 行 | WORKFLOW_SCRIPTS | +| src/tools/WorkflowTool/WorkflowPermissionRequest.tsx | 3 行 | WORKFLOW_SCRIPTS | +| src/components/tasks/WorkflowDetailDialog.tsx | 3 行 | WORKFLOW_SCRIPTS | +| src/components/permissions/MonitorPermissionRequest/MonitorPermissionRequest.tsx | 3 行 | MONITOR_TOOL | +| src/components/tasks/MonitorMcpDetailDialog.tsx | 3 行 | MONITOR_TOOL | +| src/components/permissions/ReviewArtifactPermissionRequest/ReviewArtifactPermissionRequest.tsx | 3 行 | REVIEW_ARTIFACT | +| src/tasks/LocalWorkflowTask/LocalWorkflowTask.ts | 5 行 | WORKFLOW_SCRIPTS | +| src/tasks/MonitorMcpTask/MonitorMcpTask.ts | 5 行 | MONITOR_TOOL | +| src/coordinator/workerAgent.ts | 1 行 | COORDINATOR_MODE | +| src/bridge/webhookSanitizer.ts | 3 行 | BRIDGE_MODE | +| src/bridge/peerSessions.ts | 3 行 | BRIDGE_MODE | + +--- + +# 五、按引用次数排序的完整列表 + +| 排名 | 标志名称 | 引用次数 | 分类 | +|------|----------|----------|------| +| 1 | KAIROS | 156 | PARTIAL | +| 2 | TRANSCRIPT_CLASSIFIER | 110 | COMPLETE | +| 3 | TEAMMEM | 53 | COMPLETE | +| 4 | VOICE_MODE | 49 | COMPLETE | +| 5 | BASH_CLASSIFIER | 49 | COMPLETE | +| 6 | KAIROS_BRIEF | 39 | COMPLETE | +| 7 | PROACTIVE | 37 | COMPLETE | +| 8 | COORDINATOR_MODE | 32 | COMPLETE | +| 9 | BRIDGE_MODE | 29 | COMPLETE | +| 10 | CONTEXT_COLLAPSE | 23 | COMPLETE | +| 11 | EXPERIMENTAL_SKILL_SEARCH | 21 | PARTIAL | +| 12 | KAIROS_CHANNELS | 21 | PARTIAL | +| 13 | UDS_INBOX | 18 | PARTIAL | +| 14 | CHICAGO_MCP | 16 | COMPLETE | +| 15 | BUDDY | 18 | PARTIAL | +| 16 | HISTORY_SNIP | 16 | PARTIAL | +| 17 | MONITOR_TOOL | 13 | PARTIAL | +| 18 | CACHED_MICROCOMPACT | 12 | COMPLETE | +| 19 | COMMIT_ATTRIBUTION | 12 | COMPLETE | +| 20 | BG_SESSIONS | 11 | COMPLETE | +| 21 | AGENT_TRIGGERS | 11 | COMPLETE | +| 22 | WORKFLOW_SCRIPTS | 10 | PARTIAL | +| 23 | ULTRAPLAN | 10 | COMPLETE | +| 24 | SHOT_STATS | 10 | COMPLETE | +| 25 | TOKEN_BUDGET | 9 | COMPLETE | +| 26 | PROMPT_CACHE_BREAK_DETECTION | 9 | COMPLETE | +| 27 | MCP_SKILLS | 9 | PARTIAL | +| 28 | CONNECTOR_TEXT | 8 | PARTIAL | +| 29 | EXTRACT_MEMORIES | 7 | COMPLETE | +| 30 | TEMPLATES | 6 | PARTIAL | +| 31 | LODESTONE | 6 | PARTIAL | +| 32 | DOWNLOAD_USER_SETTINGS | 5 | STUB | +| 33 | TREE_SITTER_BASH_SHADOW | 5 | STUB | +| 34 | QUICK_SEARCH | 5 | STUB | +| 35 | MESSAGE_ACTIONS | 5 | PARTIAL | +| 36 | DIRECT_CONNECT | 5 | STUB | +| 37 | TERMINAL_PANEL | 5 | PARTIAL | +| 38 | FORK_SUBAGENT | 5 | PARTIAL | +| 39 | REACTIVE_COMPACT | 5 | COMPLETE | +| 40 | WEB_BROWSER_TOOL | 4 | PARTIAL | +| 41 | VERIFICATION_AGENT | 4 | COMPLETE | +| 42 | SSH_REMOTE | 4 | STUB | +| 43 | REVIEW_ARTIFACT | 4 | PARTIAL | +| 44 | KAIROS_PUSH_NOTIFICATION | 4 | STUB | +| 45 | HISTORY_PICKER | 4 | PARTIAL | +| 46 | CCR_MIRROR | 4 | STUB | +| 47 | KAIROS_GITHUB_WEBHOOKS | 4 | PARTIAL | +| 48 | TREE_SITTER_BASH | 3 | STUB | +| 49 | MEMORY_SHAPE_TELEMETRY | 3 | STUB | +| 50 | MCP_RICH_OUTPUT | 3 | STUB | +| 51 | FILE_PERSISTENCE | 3 | STUB | +| 52 | DAEMON | 3 | STUB | +| 53 | CCR_AUTO_CONNECT | 3 | STUB | +| 54 | AUTO_THEME | 3 | STUB | +| 55 | UPLOAD_USER_SETTINGS | 2 | STUB | +| 56 | POWERSHELL_AUTO_MODE | 2 | STUB | +| 57 | OVERFLOW_TEST_TOOL | 2 | STUB | +| 58 | NEW_INIT | 2 | STUB | +| 59 | NATIVE_CLIPBOARD_IMAGE | 2 | STUB | +| 60 | HARD_FAIL | 2 | STUB | +| 61 | ENHANCED_TELEMETRY_BETA | 2 | STUB | +| 62 | COWORKER_TYPE_TELEMETRY | 2 | STUB | +| 63 | BREAK_CACHE_COMMAND | 2 | STUB | +| 64 | AWAY_SUMMARY | 2 | STUB | +| 65 | ALLOW_TEST_VERSIONS | 2 | STUB | +| 66 | AGENT_TRIGGERS_REMOTE | 2 | STUB | +| 67 | AGENT_MEMORY_SNAPSHOT | 2 | STUB | +| 68 | UNATTENDED_RETRY | 1 | STUB | +| 69 | ULTRATHINK | 1 | STUB | +| 70 | TORCH | 1 | STUB | +| 71 | STREAMLINED_OUTPUT | 1 | STUB | +| 72 | SLOW_OPERATION_LOGGING | 1 | STUB | +| 73 | SKILL_IMPROVEMENT | 1 | STUB | +| 74 | SELF_HOSTED_RUNNER | 1 | STUB | +| 75 | RUN_SKILL_GENERATOR | 1 | STUB | +| 76 | PERFETTO_TRACING | 1 | STUB | +| 77 | NATIVE_CLIENT_ATTESTATION | 1 | STUB | +| 78 | KAIROS_DREAM | 1 | STUB | +| 79 | IS_LIBC_MUSL | 1 | STUB | +| 80 | IS_LIBC_GLIBC | 1 | STUB | +| 81 | HOOK_PROMPTS | 1 | STUB | +| 82 | DUMP_SYSTEM_PROMPT | 1 | STUB | +| 83 | COMPACTION_REMINDERS | 1 | STUB | +| 84 | CCR_REMOTE_SETUP | 1 | COMPLETE | +| 85 | BYOC_ENVIRONMENT_RUNNER | 1 | STUB | +| 86 | BUILTIN_EXPLORE_PLAN_AGENTS | 1 | STUB | +| 87 | BUILDING_CLAUDE_APPS | 1 | STUB | +| 88 | ANTI_DISTILLATION_CC | 1 | STUB | +| 89 | ABLATION_BASELINE | 1 | STUB | +| 90 | SKIP_DETECTION_WHEN_AUTOUPDATES_DISABLED | 1 | STUB | + +--- + +# 六、代码量统计 + +| 分类 | 标志数 | 总引用次数 | 专属代码行数（估算） | +|------|--------|------------|---------------------| +| COMPLETE | 22 | 约 640 | 约 35,000 行 | +| PARTIAL | 19 | 约 330 | 约 5,500 行 | +| STUB | 51 | 约 95 | 约 2,000 行（主要是附带的工具文件） | +| **总计** | **92** | **约 1,065** | **约 42,500 行** | + +**最大功能模块（按代码行数排序）**: +1. BRIDGE_MODE: 12,619 行（src/bridge/ 目录） +2. COORDINATOR_MODE: 7,990 行（src/coordinator/ + src/utils/swarm/） +3. SHOT_STATS: 2,722 行（统计系统） +4. CONTEXT_COLLAPSE: 2,258 行（上下文分析） +5. COMMIT_ATTRIBUTION: 1,354 行（提交归属） +6. BUDDY: 1,298 行（伙伴精灵） +7. VOICE_MODE: 1,410 行（语音模式） +8. TEAMMEM: 1,026 行（团队记忆） +9. UDS_INBOX: 966 行（Unix 套接字消息，但大部分是桩） +10. BG_SESSIONS: 801 行（后台会话） + +--- + +*本文档由自动审计生成，基于对 Claude Code 源代码中所有 `feature('...')` 引用的穷举搜索。每个标志的引用次数包含单引号和双引号两种形式。* diff --git a/docs/features/feature-flags-codex-review.md b/docs/features/feature-flags-codex-review.md new file mode 100644 index 000000000..1f4efdb22 --- /dev/null +++ b/docs/features/feature-flags-codex-review.md @@ -0,0 +1,160 @@ +# Feature Flags 审查报告 — Codex 复核 + +> 审查日期: 2026-04-05 +> 审查工具: Codex CLI v0.118.0 (本地, full-auto mode) +> 消耗 tokens: 240,306 +> 审查范围: docs/feature-flags-audit-complete.md 中标记为 COMPLETE 的 22 个编译时 feature flag + +--- + +## 审查背景 + +原始审计报告 (`docs/feature-flags-audit-complete.md`) 声称 22 个 feature flag 被标记为 "COMPLETE"，只需在 `build.ts` / `scripts/dev.ts` 中启用即可工作。 + +Claude Code 团队通过 6 个并行子代理实际读取源码后初步发现大量误判，随后将分析结果传递给 Codex CLI 进行独立二次验证。 + +--- + +## Codex 发现摘要 + +### High 级发现 + +1. **`CONTEXT_COLLAPSE` 不是 COMPLETE** + - `src/services/contextCollapse/index.ts:43` — `isContextCollapseEnabled()` 硬编码为 `false` + - `src/services/contextCollapse/index.ts:47` — `applyCollapsesIfNeeded()` 只是原样返回消息 + - `src/services/contextCollapse/index.ts:59` — `recoverFromOverflow()` 也是 no-op + - `src/services/contextCollapse/operations.ts:3` 和 `persist.ts:3` 同样是 stub + - 审计报告把 UI/命令文件算进去了，但真正被查询循环消费的是 stub 后端 + +2. **原分类"真正只需编译开关"的 7 个 flag，只有 3 个准确** + - ✅ `SHOT_STATS` — 零额外门控，compile-only + - ✅ `PROMPT_CACHE_BREAK_DETECTION` — 有 try-catch 兜底，compile-only + - ✅ `TOKEN_BUDGET` — 纯本地计算，compile-only + - ❌ `TEAMMEM` — 还要求 AutoMem + GrowthBook `tengu_herring_clock` + GitHub repo (`teamMemPaths.ts:73`, `watcher.ts:256`, `watcher.ts:259`) + - ❌ `AGENT_TRIGGERS` — 受 `isKairosCronEnabled()` GrowthBook 控制 (`useScheduledTasks.ts:61`, `useScheduledTasks.ts:119`) + - ❌ `EXTRACT_MEMORIES` — 受 `tengu_passport_quail` + AutoMem + 非 remote 限制 (`extractMemories.ts:536`, `:545`, `:550`) + - ❌ `KAIROS_BRIEF` — 受 `tengu_kairos_brief` + opt-in/kairosActive 限制 (`BriefTool.ts:95`, `:126`, `:132`) + +### Medium 级发现 + +3. **`BG_SESSIONS` 和 `BASH_CLASSIFIER` 不适合简单归为"全 stub"** + - `BG_SESSIONS` — 会话注册/清理是真实现 (`concurrentSessions.ts:44`, `:55`)，但任务摘要核心是 stub (`taskSummary.ts:2`) + - `BASH_CLASSIFIER` — 权限编排很大一块是真实现 (`bashPermissions.ts` 2621行)，但分类后端 `bashClassifier.ts:24` 永远返回 disabled + +4. **审计口径问题** + - 把"代码量/周边 UI 很多"误当成"可独立启用" + - `PROACTIVE` — `index.ts:3` 只有 state stub，`commands.ts:64` 和 `REPL.tsx:415` 引用缺失文件 + - `REACTIVE_COMPACT` — `reactiveCompact.ts:13` 整块是 stub + - `CACHED_MICROCOMPACT` — `cachedMicrocompact.ts:22` 全部 stub + +--- + +## Codex 修正后的分类 + +### 第一类：真正 compile-only（3 个） + +| Flag | 说明 | Crash 风险 | +|------|------|-----------| +| **SHOT_STATS** | 纯本地 shot 分布统计，ant-only 数据路径 | 低 | +| **PROMPT_CACHE_BREAK_DETECTION** | 本地 cache key 变化检测，写 diff 有兜底 | 低 | +| **TOKEN_BUDGET** | 本地 token 预算追踪，纯计算逻辑 | 低 | + +### 第二类：compile + 运行时条件（7 个） + +| Flag | 条件 | Crash 风险 | +|------|------|-----------| +| **TEAMMEM** | AutoMem + GrowthBook `tengu_herring_clock` + GitHub repo | 低 (clean no-op) | +| **AGENT_TRIGGERS** | GrowthBook `isKairosCronEnabled()` | 低 (clean no-op) | +| **EXTRACT_MEMORIES** | `tengu_passport_quail` + AutoMem + 非 remote | 低 (clean no-op) | +| **KAIROS_BRIEF** | `tengu_kairos_brief` + opt-in/kairosActive，可用 `CLAUDE_CODE_BRIEF=1` 绕过 | 低 | +| **COORDINATOR_MODE** | 需 `CLAUDE_CODE_COORDINATOR_MODE=1`，`workerAgent.ts` 是 stub 但不阻塞 | 低 | +| **COMMIT_ATTRIBUTION** | 仅对 `isInternal=true` 的 repo 生效 | 低 | +| **VERIFICATION_AGENT** | 受 GrowthBook `tengu_hive_evidence` 双重门控 | 低 | + +### 第三类：混合型 — 部分实现 + stub 核心（5 个） + +| Flag | 真实现部分 | Stub 核心 | +|------|-----------|----------| +| **BG_SESSIONS** | 会话注册/清理 (`concurrentSessions.ts`) | `bg.ts`/`taskSummary.ts`/`udsClient.ts` 全 stub + 依赖 tmux | +| **BASH_CLASSIFIER** | 权限编排 (`bashPermissions.ts` 2621行) | `bashClassifier.ts` 分类后端 stub + 需 API beta | +| **PROACTIVE** | REPL/命令注册框架 | `index.ts` stub + 3 文件缺失 | +| **REACTIVE_COMPACT** | 调用点已在主查询环路 | `reactiveCompact.ts` 22行全 no-op | +| **CACHED_MICROCOMPACT** | 调用点已布线 | `cachedMicrocompact.ts` 全 stub + 需未公开 API | + +### 第四类：纯 stub（1 个） + +| Flag | 问题 | +|------|------| +| **CONTEXT_COLLAPSE** | 3 核心文件全 stub + CtxInspectTool 目录不存在 | + +### 第五类：依赖远程服务（3 个） + +| Flag | 依赖 | +|------|------| +| **ULTRAPLAN** | CCR 远程 agent 基础设施 + OAuth | +| **CCR_REMOTE_SETUP** | claude.ai OAuth + GitHub CLI + CCR 后端 | +| **BRIDGE_MODE** (build端) | claude.ai 订阅 + GrowthBook + WebSocket 后端 | + +--- + +## 第三类恢复优先级建议 + +Codex 推荐的恢复顺序： + +1. **REACTIVE_COMPACT** — 收益最直接，调用点在主查询环路，改完最容易立刻见效 +2. **BG_SESSIONS** — 已有会话注册基础，补齐摘要和后台运行链路的 ROI 高 +3. **PROACTIVE** — 产品面大，但缺文件比 stub 更严重，范围比前两项大 +4. **CONTEXT_COLLAPSE** — collapse engine 全 stub，恢复成本和设计不确定性都高 +5. **BASH_CLASSIFIER** — 若无 API beta 能力不值得优先；若有则升到第 2 +6. **CACHED_MICROCOMPACT** — 受未公开 API 约束，最后做 + +--- + +## 审计报告分类标准修正建议 + +Codex 建议将原来的单轴分类（COMPLETE/PARTIAL/STUB）改为**三轴**： + +| 轴 | 取值 | 说明 | +|----|------|------| +| **实现完整度** | `full` / `mixed` / `stub` | 活跃调用链上的核心模块是否有真实现 | +| **激活条件** | `compile-only` / `compile+env` / `compile+GrowthBook` / `compile+remote` / `compile+private API` | 启用需要什么 | +| **运行风险** | `safe no-op` / `background IO` / `startup critical` | 启用后条件不满足时的行为 | + +**COMPLETE 的最低标准应满足：** +1. 活跃调用链上的核心模块不能是 stub +2. "可启用"不能只看编译 flag，还要单列运行时 gate + +按此标准，`CONTEXT_COLLAPSE`、`BG_SESSIONS`、`BASH_CLASSIFIER`、`PROACTIVE`、`REACTIVE_COMPACT`、`CACHED_MICROCOMPACT` 都应从 COMPLETE 降级。 + +--- + +## 已采取的行动 + +基于审查结果，已将以下 3 个确认安全的 flag 加入默认构建： + +**build.ts:** +```typescript +const DEFAULT_BUILD_FEATURES = [ + "AGENT_TRIGGERS_REMOTE", "CHICAGO_MCP", "VOICE_MODE", + "SHOT_STATS", "PROMPT_CACHE_BREAK_DETECTION", "TOKEN_BUDGET" +]; +``` + +**scripts/dev.ts:** +```typescript +const DEFAULT_FEATURES = [ + "BUDDY", "TRANSCRIPT_CLASSIFIER", "BRIDGE_MODE", + "AGENT_TRIGGERS_REMOTE", "CHICAGO_MCP", "VOICE_MODE", + "SHOT_STATS", "PROMPT_CACHE_BREAK_DETECTION", "TOKEN_BUDGET" +]; +``` + +### 验证结果 + +| 项目 | 结果 | +|------|------| +| `bun run build` | ✅ 成功 (475 files) | +| `bun test` | ✅ 无新增失败 (23 fail 为已有问题) | +| SHOT_STATS 代码路径 | ✅ 完整 — stats 面板显示 shot 分布 | +| TOKEN_BUDGET 代码路径 | ✅ 完整 — 支持 `+500k` 语法，带进度条 | +| PROMPT_CACHE_BREAK_DETECTION 代码路径 | ✅ 完整 — 内部诊断，debug 模式可见 | diff --git a/package.json b/package.json index f6419934d..fd859bdc6 100644 --- a/package.json +++ b/package.json @@ -53,7 +53,7 @@ }, "dependencies": {}, "devDependencies": { - "openai": "^4.73.0", + "openai": "^6.33.0", "@alcalzone/ansi-tokenize": "^0.3.0", "@ant/claude-for-chrome-mcp": "workspace:*", "@ant/computer-use-input": "workspace:*", diff --git a/scripts/dev.ts b/scripts/dev.ts index 68b4734ba..fb735f49d 100644 --- a/scripts/dev.ts +++ b/scripts/dev.ts @@ -15,7 +15,7 @@ const defineArgs = Object.entries(defines).flatMap(([k, v]) => [ // Bun --feature flags: enable feature() gates at runtime. // Default features enabled in dev mode. -const DEFAULT_FEATURES = ["BUDDY", "TRANSCRIPT_CLASSIFIER", "BRIDGE_MODE", "AGENT_TRIGGERS_REMOTE", "CHICAGO_MCP", "VOICE_MODE"]; +const DEFAULT_FEATURES = ["BUDDY", "TRANSCRIPT_CLASSIFIER", "BRIDGE_MODE", "AGENT_TRIGGERS_REMOTE", "CHICAGO_MCP", "VOICE_MODE", "SHOT_STATS", "PROMPT_CACHE_BREAK_DETECTION", "TOKEN_BUDGET"]; // Any env var matching FEATURE_=1 will also enable that feature. // e.g. FEATURE_PROACTIVE=1 bun run dev From 5916ecffdc23998b04fb6123d7b05cbd51da9725 Mon Sep 17 00:00:00 2001 From: unraid Date: Sun, 5 Apr 2026 21:10:15 +0800 Subject: [PATCH 2/2] docs: add DEV-LOG entry for feature flags enablement Document the SHOT_STATS, TOKEN_BUDGET, PROMPT_CACHE_BREAK_DETECTION enablement process including verification methodology, Codex review findings, and key discoveries about audit report accuracy. --- DEV-LOG.md | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 51 insertions(+) diff --git a/DEV-LOG.md b/DEV-LOG.md index 619dcf8b8..1bc5b89e8 100644 --- a/DEV-LOG.md +++ b/DEV-LOG.md @@ -1,5 +1,56 @@ # DEV-LOG +## Enable SHOT_STATS, TOKEN_BUDGET, PROMPT_CACHE_BREAK_DETECTION (2026-04-05) + +**PR**: [claude-code-best/claude-code#140](https://github.com/claude-code-best/claude-code/pull/140) +**分支**: `feat/enable-safe-feature-flags` + +对 22 个被标记为 "COMPLETE" 的编译时 feature flag 进行实际源码验证（6 个并行子代理 + Codex CLI 独立复核），发现审计报告存在大量误判。最终确认仅 3 个 flag 为真正 compile-only，安全启用。 + +**验证流程：** + +1. 6 个并行子代理分别检查每个 flag 的 `feature('FLAG_NAME')` 引用点、依赖模块完整性、外部服务依赖 +2. Codex CLI (v0.118.0, 240K tokens) 独立复核，将原 7 个 "compile-only" 进一步缩减为 3 个 +3. 3 个专项代理逐一验证代码路径完整性和运行时安全性 + +**新启用的 3 个 flag：** + +| Flag | 功能 | 用户可感知效果 | +|------|------|---------------| +| `SHOT_STATS` | shot 分布统计 | `/stats` 面板显示 shot 分布和 one-shot rate | +| `TOKEN_BUDGET` | token 预算目标 | 支持 `+500k` / `spend 2M tokens` 语法，自动续写直到达标，带进度条 | +| `PROMPT_CACHE_BREAK_DETECTION` | cache key 变化检测 | 内部诊断，`--debug` 模式可见，写 diff 到临时目录 | + +**修改文件：** + +| 文件 | 变更 | +|------|------| +| `build.ts` | `DEFAULT_BUILD_FEATURES` 新增 3 个 flag | +| `scripts/dev.ts` | `DEFAULT_FEATURES` 新增 3 个 flag | +| `package.json` / `bun.lock` | 新增 `openai` 依赖（OpenAI 兼容层需要） | + +**新增文档：** + +| 文件 | 说明 | +|------|------| +| `docs/features/feature-flags-codex-review.md` | Codex 独立复核报告：修正后的 5 类分类、恢复优先级、三轴分类标准建议 | +| `docs/features/feature-flags-audit-complete.md` | 标记所有已启用 flag 的状态（`[build: ON]` / `[dev: ON]`） | + +**Codex 复核关键发现：** + +- 原 22 个 "COMPLETE" flag 中，8 个核心模块是 stub，3 个依赖远程服务 +- `TEAMMEM`、`AGENT_TRIGGERS`、`EXTRACT_MEMORIES`、`KAIROS_BRIEF` 被降级为"有条件可用"（受 GrowthBook 门控） +- 建议审计分类标准改为三轴：实现完整度 × 激活条件 × 运行风险 +- 恢复优先级：REACTIVE_COMPACT > BG_SESSIONS > PROACTIVE > CONTEXT_COLLAPSE + +**验证结果：** + +- `bun run build` → 475 files ✅ +- `bun test` → 零新增失败 ✅ +- 3 个 flag 代码路径全部完整，无缺失依赖，无 crash 风险 ✅ + +--- + ## /dream 手动触发 + DreamTask 类型补全 (2026-04-04) 将 `/dream` 命令从 KAIROS feature gate 中解耦，作为 bundled skill 无条件注册；补全 DreamTask 类型存根。