Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
feat(bots): 伙伴设置新增记忆页,可查看、编辑与删除记忆 (#4971)
Chris Zhanga77d5c321bec
diff --git a/apps/desktop/src/main/localDb/ipc/bots.ts b/apps/desktop/src/main/localDb/ipc/bots.tsindex bd85cbe0d0..ab06068f39 100644--- a/apps/desktop/src/main/localDb/ipc/bots.ts+++ b/apps/desktop/src/main/localDb/ipc/bots.ts@@ -28,7 +28,7 @@ import {} from '../schema';import { assertTrustedAppRendererEvent } from '../../security/trustedAppRenderer.js';import { isDeviceLinkInvoke } from '../../device-link/invoke-context.js';-import { requireString, throwIpcError } from '../../utils/ipcValidate.js';+import { requireObject, requireString, throwIpcError } from '../../utils/ipcValidate.js';import { isBotVisibleRemotely } from './botRemoteVisibility.js';import { readRemoteBotSessionAccess, readRemoteBotSessionAccessBatch } from './botRemoteSessionAccess.js';import { setRemoteBotSessionLookup } from '../../device-link/remoteBotSessionBoundary.js';@@ -94,6 +94,7 @@ import { getResolvedMainLocale } from '../../i18n.js';import { SUPPORTED_LOCALES, type SupportedLocale } from '../../../shared/locale.js';import { normalizeBotWelcomeContext, type BotWelcomeContext } from '../../../shared/botWelcomeContext';import { broadcastBotRemoteResourceChanged } from '../../maker-ipc/botRemoteResourceInvalidation.js';+import { createBotMemoryService } from '../../maker-ipc/botMemoryService.js';const log = createLogger('bots');@@ -1811,6 +1812,74 @@ export function registerBotIpc(): void {});});+ const memory = createBotMemoryService({+ async getStore(scopeKey) {+ const manager = getMakerIfReady()?.makerMemory;+ if (!manager) throwIpcError('MAKER_MEMORY_NOT_READY', 'Memory is not ready');+ return manager.getStore(scopeKey, { skipDisabledCheck: true });+ },+ async readBot(botId) {+ const owner = captureBotOperationOwner();+ const [row] = await getDbClient()+ .drizzle.select({ status: botProfiles.status, canonicalSessionId: botProfiles.canonicalSessionId })+ .from(botProfiles)+ .where(eq(botProfiles.id, botId))+ .limit(1);+ owner.assertCurrent();+ return row && row.status !== 'deleting'+ ? { canonicalSessionId: row.canonicalSessionId, assertCurrent: owner.assertCurrent }+ : null;+ },+ requestRefresh: (sessionId) => requestBotRuntimeEpochRefresh(sessionId, 'resource'),+ });+ /** Bind each memory operation to the account that started it. */+ const withMemoryOwner = async <T>(run: () => Promise<T>): Promise<T> => {+ const owner = captureBotOperationOwner();+ const result = await run();+ owner.assertCurrent();+ return result;+ };+ ipcMain.handle('local-db:bots:memory:list', async (event, rawBotId: unknown, rawQuery: unknown) => {+ assertTrustedAppRendererEvent(event);+ const botId = readText(rawBotId, 'botId', 128, true);+ const query = rawQuery === undefined || rawQuery === null ? '' : readText(rawQuery, 'query', 200);+ return withMemoryOwner(() => memory.list(botId, query));+ });+ ipcMain.handle('local-db:bots:memory:read', async (event, rawBotId: unknown, rawFilename: unknown) => {+ assertTrustedAppRendererEvent(event);+ const botId = readText(rawBotId, 'botId', 128, true);+ return withMemoryOwner(() => memory.read(botId, rawFilename));+ });+ ipcMain.handle('local-db:bots:memory:update', async (event, raw: unknown) => {+ assertTrustedAppRendererEvent(event);+ const body = requireObject(raw);+ const botId = readText(body.botId, 'botId', 128, true);+ if (typeof body.title !== 'string' || typeof body.body !== 'string') {+ throwIpcError('INVALID_PARAMS', 'Invalid memory');+ }+ return withMemoryOwner(() =>+ memory.update({+ botId,+ filename: body.filename as string,+ title: body.title as string,+ body: body.body as string,+ expectedUpdatedAt: body.expectedUpdatedAt as string,+ }),+ );+ });+ ipcMain.handle('local-db:bots:memory:delete', async (event, raw: unknown) => {+ assertTrustedAppRendererEvent(event);+ const body = requireObject(raw);+ const botId = readText(body.botId, 'botId', 128, true);+ await withMemoryOwner(() =>+ memory.delete({+ botId,+ filename: body.filename as string,+ expectedUpdatedAt: body.expectedUpdatedAt as string,+ }),+ );+ });+ipcMain.handle('local-db:bots:history', async (event, rawBotId: unknown) => {assertTrustedAppRendererEvent(event);const botId = readText(rawBotId, 'botId', 128, true);diff --git a/apps/desktop/src/main/maker-ipc/__tests__/botMemoryService.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/botMemoryService.test.tsnew file mode 100644index 0000000000..2204f55575--- /dev/null+++ b/apps/desktop/src/main/maker-ipc/__tests__/botMemoryService.test.ts@@ -0,0 +1,221 @@+/**+ * 伙伴记忆页服务:列表只含四类正式记忆、搜索走 store 检索、保存 / 删除前做并发比对,+ * 改正文时摘要按首句刷新,连续改动只合并请求一次运行时刷新。+ *+ * 读写落在真实的 MemoryStorage(文件 + MEMORY.md 索引),只有 FTS 检索用替身。+ */++import { promises as fs } from 'node:fs';+import os from 'node:os';+import path from 'node:path';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';++import {+ DEFAULT_MEMORY_CONFIG,+ MemoryStorage,+ type MakerMemoryStore,+ type SearchHit,+} from '@cindy/maker-core';++import { BOT_MEMORY_CHANGED } from '../../../shared/botMemory';+import { botMemoryDescriptionFromBody, createBotMemoryService } from '../botMemoryService';++let dir = '';+let storage: MemoryStorage;+let hits: SearchHit[];++beforeEach(async () => {+ dir = await fs.mkdtemp(path.join(os.tmpdir(), 'cindy-bot-memory-svc-'));+ storage = new MemoryStorage(dir, DEFAULT_MEMORY_CONFIG);+ hits = [];+ await storage.write({+ type: 'feedback',+ name: 'verify-before-claiming',+ title: '说结论前核实',+ description: '先核实再陈述事实',+ body: '回复前主动核实事实。\n\n- 没有核实的内容标注待验证;\n- 已有证据可以复用。',+ });+ await storage.write({+ type: 'digest',+ name: 'pi-compaction-1',+ title: 'internal digest',+ description: 'dropped context',+ body: 'summary',+ });+});++afterEach(async () => {+ await fs.rm(dir, { recursive: true, force: true });+});++function setup(options: { bot?: { canonicalSessionId: string | null } | null } = {}) {+ const store = {+ list: () => storage.list(),+ read: (filename: string) => storage.read(filename),+ write: (opts: Parameters<MemoryStorage['write']>[0]) => storage.write(opts),+ update: (...args: Parameters<MemoryStorage['update']>) => storage.update(...args),+ delete: (...args: Parameters<MemoryStorage['delete']>) => storage.delete(...args),+ search: vi.fn(async () => hits),+ } as unknown as MakerMemoryStore;+ const timers: Array<() => void> = [];+ const requestRefresh = vi.fn(async () => true);+ const service = createBotMemoryService({+ getStore: async () => store,+ readBot: async () => (options.bot === undefined ? { canonicalSessionId: 'session-1' } : options.bot),+ requestRefresh,+ setTimer: (callback) => {+ timers.push(callback);+ return timers.length;+ },+ clearTimer: (handle) => {+ timers[(handle as number) - 1] = () => {};+ },+ });+ const flushTimers = () => timers.splice(0).forEach((run) => run());+ return { service, store, requestRefresh, flushTimers };+}++describe('bot memory service', () => {+ it('lists curated memories only, with a plain-text preview', async () => {+ const { service } = setup();+ const entries = await service.list('bot-1');+ expect(entries).toEqual([+ expect.objectContaining({+ filename: 'feedback_verify-before-claiming.md',+ type: 'feedback',+ title: '说结论前核实',+ preview: '回复前主动核实事实。 没有核实的内容标注待验证; 已有证据可以复用。',+ }),+ ]);+ });++ it('searches through the store and skips internal or vanished hits', async () => {+ const { service, store } = setup();+ hits = [+ { filename: 'digest_pi-compaction-1.md', type: 'digest', title: '', snippet: '', score: 0 },+ { filename: 'user_missing.md', type: 'user', title: '', snippet: '', score: 0 },+ { filename: 'feedback_verify-before-claiming.md', type: 'feedback', title: '', snippet: '', score: 0 },+ ];+ const entries = await service.list('bot-1', ' 核实 ');+ expect(store.search).toHaveBeenCalledWith('核实', { limit: 50 });+ expect(entries.map((entry) => entry.filename)).toEqual(['feedback_verify-before-claiming.md']);+ });++ it('rejects unknown teammates and internal memories', async () => {+ await expect(setup({ bot: null }).service.list('bot-x')).rejects.toThrow('[NOT_FOUND]');+ await expect(setup().service.read('bot-1', 'digest_pi-compaction-1.md')).rejects.toThrow('[INVALID_PARAMS]');+ await expect(setup().service.read('bot-1', '../MEMORY.md')).rejects.toThrow('[INVALID_PARAMS]');+ });++ it('updates title and body, refreshing the summary from the new first sentence', async () => {+ const { service, requestRefresh, flushTimers } = setup();+ const current = await service.read('bot-1', 'feedback_verify-before-claiming.md');+ const saved = await service.update({+ botId: 'bot-1',+ filename: current.filename,+ title: ' 先核实再说 ',+ body: '区分已实现、已验证与已合并。其余照旧。',+ expectedUpdatedAt: current.updatedAt,+ });+ expect(saved).toMatchObject({ title: '先核实再说', body: '区分已实现、已验证与已合并。其余照旧。' });+ const record = await storage.read(current.filename);+ expect(record.frontmatter.description).toBe('区分已实现、已验证与已合并。');+ expect(await storage.getIndex()).toContain('先核实再说');+ expect(requestRefresh).not.toHaveBeenCalled();+ flushTimers();+ expect(requestRefresh).toHaveBeenCalledWith('session-1');+ });++ it('keeps the existing summary when only the title changes', async () => {+ const { service } = setup();+ const current = await service.read('bot-1', 'feedback_verify-before-claiming.md');+ await service.update({ ...current, botId: 'bot-1', title: '新标题', expectedUpdatedAt: current.updatedAt });+ expect((await storage.read(current.filename)).frontmatter.description).toBe('先核实再陈述事实');+ });++ it('refuses to overwrite or delete a memory the teammate changed meanwhile', async () => {+ const { service, requestRefresh, flushTimers } = setup();+ const opened = await service.read('bot-1', 'feedback_verify-before-claiming.md');+ await new Promise((resolve) => setTimeout(resolve, 5));+ await storage.write({+ type: 'feedback',+ name: 'verify-before-claiming',+ title: '伙伴改过',+ description: '伙伴改过',+ body: '伙伴改过的正文',+ mode: 'update',+ });+ const conflict = `[PRECONDITION_FAILED] ${BOT_MEMORY_CHANGED}`;+ await expect(+ service.update({ botId: 'bot-1', filename: opened.filename, title: 'mine', body: 'mine', expectedUpdatedAt: opened.updatedAt }),+ ).rejects.toThrow(conflict);+ await expect(+ service.delete({ botId: 'bot-1', filename: opened.filename, expectedUpdatedAt: opened.updatedAt }),+ ).rejects.toThrow(conflict);+ expect((await storage.read(opened.filename)).body).toBe('伙伴改过的正文');+ flushTimers();+ expect(requestRefresh).not.toHaveBeenCalled();+ });++ it('edits legacy double-prefix memories without renaming or changing another shard', async () => {+ const original = 'feedback_verify-before-claiming.md';+ const legacy = 'feedback_feedback_verify-before-claiming.md';+ await fs.copyFile(path.join(dir, original), path.join(dir, legacy));+ const { service } = setup();+ const current = await service.read('bot-1', legacy);+ await service.update({ ...current, botId: 'bot-1', title: 'Legacy edit', expectedUpdatedAt: current.updatedAt });+ expect((await storage.read(legacy)).frontmatter.title).toBe('Legacy edit');+ expect((await storage.read(original)).frontmatter.title).toBe('说结论前核实');+ expect(await storage.getIndex()).toContain(`[${legacy}] Legacy edit`);+ });++ it('does not open a store after the initiating account changes during the profile read', async () => {+ const getStore = vi.fn();+ const service = createBotMemoryService({+ getStore,+ readBot: async () => ({ canonicalSessionId: 'old', assertCurrent: () => { throw new Error('account changed'); } }),+ requestRefresh: vi.fn(),+ });+ await expect(service.list('bot-1')).rejects.toThrow('account changed');+ expect(getStore).not.toHaveBeenCalled();+ });++ it('validates title and body limits before writing', async () => {+ const { service } = setup();+ const current = await service.read('bot-1', 'feedback_verify-before-claiming.md');+ const base = { botId: 'bot-1', filename: current.filename, expectedUpdatedAt: current.updatedAt };+ await expect(service.update({ ...base, title: ' ', body: 'x' })).rejects.toThrow('[INVALID_PARAMS]');+ await expect(service.update({ ...base, title: 'x'.repeat(101), body: 'x' })).rejects.toThrow('[INVALID_PARAMS]');+ await expect(service.update({ ...base, title: 'x', body: '字'.repeat(3000) })).rejects.toThrow('[INVALID_PARAMS]');+ expect((await storage.read(current.filename)).body).toBe(current.body);+ });++ it('deletes after the version check and coalesces the runtime refresh', async () => {+ const { service, requestRefresh, flushTimers } = setup();+ const current = await service.read('bot-1', 'feedback_verify-before-claiming.md');+ await service.update({ ...current, botId: 'bot-1', title: '改一次', expectedUpdatedAt: current.updatedAt });+ const updated = await service.read('bot-1', current.filename);+ await service.delete({ botId: 'bot-1', filename: current.filename, expectedUpdatedAt: updated.updatedAt });+ await expect(storage.read(current.filename)).rejects.toThrow();+ expect(await service.list('bot-1')).toEqual([]);+ flushTimers();+ expect(requestRefresh).toHaveBeenCalledTimes(1);+ });++ it('skips the runtime refresh for teammates without a main task', async () => {+ const { service, requestRefresh, flushTimers } = setup({ bot: { canonicalSessionId: null } });+ const current = await service.read('bot-1', 'feedback_verify-before-claiming.md');+ await service.delete({ botId: 'bot-1', filename: current.filename, expectedUpdatedAt: current.updatedAt });+ flushTimers();+ expect(requestRefresh).not.toHaveBeenCalled();+ });+});++describe('botMemoryDescriptionFromBody', () => {+ it('takes the first sentence as a single line', () => {+ expect(botMemoryDescriptionFromBody('- 第一条。\n- 第二条。')).toBe('第一条。');+ expect(botMemoryDescriptionFromBody('Verify first! Then answer.')).toBe('Verify first!');+ expect(botMemoryDescriptionFromBody('没有句号的一段\n换行')).toBe('没有句号的一段 换行');+ expect(Array.from(botMemoryDescriptionFromBody('长'.repeat(500)))).toHaveLength(200);+ });+});diff --git a/apps/desktop/src/main/maker-ipc/botMemoryService.ts b/apps/desktop/src/main/maker-ipc/botMemoryService.tsnew file mode 100644index 0000000000..c321ec251a--- /dev/null+++ b/apps/desktop/src/main/maker-ipc/botMemoryService.ts@@ -0,0 +1,267 @@+/**+ * 伙伴记忆页的读写服务:把设置页的「看 / 改 / 删」落到伙伴自己的 MakerMemoryStore。+ *+ * - 存储、MEMORY.md 索引与 FTS 由 maker-core 的 store 维护;这里不另建一份。+ * - 摘要(description)是模型读目录用的钩子,界面不展示。用户改正文时按正文首句+ * 确定性刷新,不调用模型;只改标题时保留原摘要。+ * - 保存 / 删除在共享 storage 互斥内比对 updatedAt,与伙伴工具写入串行;+ * 不一致就拒绝(BOT_MEMORY_CHANGED),交给用户看最新内容。+ * - 运行中的伙伴在会话启动时冻结了记忆目录。改动后合并请求一次运行时刷新,+ * 让下一轮拿到新目录;刷新失败不影响已经落盘的改动。+ */++import {+ buildBotMemoryScopeKey,+ MemoryError,+ type MakerMemoryStore,+ type MemoryRecord,+} from '@cindy/maker-core';++import {+ BOT_MEMORY_BODY_MAX_BYTES,+ BOT_MEMORY_CHANGED,+ BOT_MEMORY_TITLE_MAX,+ BOT_MEMORY_TYPES,+ type BotMemoryDeleteInput,+ type BotMemoryDetail,+ type BotMemorySummary,+ type BotMemoryType,+ type BotMemoryUpdateInput,+} from '../../shared/botMemory.js';+import { throwIpcError } from '../utils/ipcValidate.js';++const PREVIEW_CHARS = 240;+const DESCRIPTION_MAX = 200;+/** FTS 单次命中上限与 maker-core 一致;界面上的搜索只需要最相关的这些。 */+const SEARCH_LIMIT = 50;+/** 连续编辑会产生多次保存,合并成一次运行时刷新。 */+const REFRESH_COALESCE_MS = 3_000;+const FILENAME_RE = /^(user|feedback|project|reference)_[a-z0-9_-]{1,64}\.md$/;++interface BotMemoryOwner {+ canonicalSessionId: string | null;+ assertCurrent?: () => void;+}++export interface BotMemoryServiceDeps {+ getStore(scopeKey: string): Promise<MakerMemoryStore>;+ /** 当前账号下的伙伴;不存在或正在删除时返回 null。 */+ readBot(botId: string): Promise<BotMemoryOwner | null>;+ requestRefresh(sessionId: string): Promise<unknown>;+ setTimer?: (callback: () => void, ms: number) => unknown;+ clearTimer?: (handle: unknown) => void;+}++const isBotMemoryType = (value: string): value is BotMemoryType =>+ (BOT_MEMORY_TYPES as readonly string[]).includes(value);++/** 正文里去掉 Markdown 列表符号与换行后的纯文本。 */+function plainText(body: string): string {+ return body+ .replace(/^\s*(?:[-*+]|\d+[.)])\s+/gm, '')+ .replace(/^#+\s+/gm, '')+ .replace(/\s+/g, ' ')+ .trim();+}++/** 模型目录用的一句话摘要:正文首句,单行、不超过 store 的 200 字上限。 */+export function botMemoryDescriptionFromBody(body: string): string {+ const text = plainText(body);+ const sentence = /^.+?[。!?!?;;](?=\s|$|[^。!?!?;;])/u.exec(text)?.[0] ?? text;+ return Array.from(sentence).slice(0, DESCRIPTION_MAX).join('').trim();+}++function preview(body: string): string {+ const text = plainText(body);+ const chars = Array.from(text);+ return chars.length > PREVIEW_CHARS ? `${chars.slice(0, PREVIEW_CHARS).join('')}…` : text;+}++function toSummary(record: MemoryRecord): BotMemorySummary | null {+ const type = record.frontmatter.type;+ if (!isBotMemoryType(type)) return null;+ return {+ filename: record.filename,+ type,+ title: record.frontmatter.title,+ preview: preview(record.body),+ updatedAt: record.frontmatter.updatedAt,+ };+}++function toDetail(record: MemoryRecord): BotMemoryDetail {+ const type = record.frontmatter.type;+ if (!isBotMemoryType(type)) throwIpcError('NOT_FOUND', 'Memory not found');+ return {+ filename: record.filename,+ type,+ title: record.frontmatter.title,+ body: record.body,+ updatedAt: record.frontmatter.updatedAt,+ };+}++const byNewest = (a: BotMemorySummary, b: BotMemorySummary) =>+ b.updatedAt.localeCompare(a.updatedAt) || a.filename.localeCompare(b.filename);++function translateStoreError(error: unknown): never {+ if (error instanceof MemoryError) {+ if (error.code === 'version-conflict') throwIpcError('PRECONDITION_FAILED', BOT_MEMORY_CHANGED);+ if (error.code === 'not-found') throwIpcError('NOT_FOUND', 'Memory not found');+ if (error.code === 'not-ready')+ throwIpcError('PRECONDITION_FAILED', 'Memory is not ready; retry');+ throwIpcError('INVALID_PARAMS', error.message);+ }+ throw error;+}++function readFilename(value: unknown): string {+ if (typeof value !== 'string' || !FILENAME_RE.test(value)) {+ throwIpcError('INVALID_PARAMS', 'Invalid memory');+ }+ return value;+}++function readExpected(value: unknown): string {+ if (typeof value !== 'string' || !value || value.length > 64) {+ throwIpcError('INVALID_PARAMS', 'Invalid memory version');+ }+ return value;+}++export function createBotMemoryService(deps: BotMemoryServiceDeps) {+ const locks = new Map<string, Promise<unknown>>();+ const pendingRefresh = new Map<string, unknown>();+ const setTimer = deps.setTimer ?? ((callback, ms) => setTimeout(callback, ms));+ const clearTimer =+ deps.clearTimer ?? ((handle) => clearTimeout(handle as ReturnType<typeof setTimeout>));++ async function storeOf(+ botId: string,+ ): Promise<{ store: MakerMemoryStore; owner: BotMemoryOwner }> {+ const owner = await deps.readBot(botId);+ if (!owner) throwIpcError('NOT_FOUND', 'Teammate not found');+ try {+ owner.assertCurrent?.();+ const store = await deps.getStore(buildBotMemoryScopeKey(botId));+ owner.assertCurrent?.();+ return { store, owner };+ } catch (error) {+ return translateStoreError(error);+ }+ }++ function scheduleRefresh(owner: BotMemoryOwner): void {+ const sessionId = owner.canonicalSessionId;+ if (!sessionId) return;+ const previous = pendingRefresh.get(sessionId);+ if (previous !== undefined) clearTimer(previous);+ pendingRefresh.set(+ sessionId,+ setTimer(() => {+ pendingRefresh.delete(sessionId);+ try {+ owner.assertCurrent?.();+ void deps.requestRefresh(sessionId).catch(() => {});+ } catch {+ // The initiating account has left; never refresh another account's runtime.+ }+ }, REFRESH_COALESCE_MS),+ );+ }++ async function serialized<T>(key: string, run: () => Promise<T>): Promise<T> {+ const previous = locks.get(key) ?? Promise.resolve();+ const next = previous.catch(() => {}).then(run);+ locks.set(key, next);+ try {+ return await next;+ } finally {+ if (locks.get(key) === next) locks.delete(key);+ }+ }++ async function readCurrent(store: MakerMemoryStore, filename: string, expected: string) {+ const current = await store.read(filename).catch(translateStoreError);+ if (current.frontmatter.updatedAt !== expected) {+ throwIpcError('PRECONDITION_FAILED', BOT_MEMORY_CHANGED);+ }+ return current;+ }++ return {+ async list(botId: string, rawQuery?: unknown): Promise<BotMemorySummary[]> {+ const { store } = await storeOf(botId);+ const query = typeof rawQuery === 'string' ? rawQuery.trim().slice(0, 200) : '';+ try {+ if (!query) {+ return (await store.list()).flatMap((record) => toSummary(record) ?? []).sort(byNewest);+ }+ const hits = await store.search(query, { limit: SEARCH_LIMIT });+ const entries: BotMemorySummary[] = [];+ for (const hit of hits) {+ if (!isBotMemoryType(hit.type)) continue;+ // 命中与读取之间可能被伙伴删掉,跳过即可。+ const record = await store.read(hit.filename).catch((error: unknown) => {+ if (error instanceof MemoryError && error.code === 'not-found') return null;+ throw error;+ });+ const summary = record ? toSummary(record) : null;+ if (summary) entries.push(summary);+ }+ return entries;+ } catch (error) {+ return translateStoreError(error);+ }+ },++ async read(botId: string, rawFilename: unknown): Promise<BotMemoryDetail> {+ const filename = readFilename(rawFilename);+ const { store } = await storeOf(botId);+ return toDetail(await store.read(filename).catch(translateStoreError));+ },++ async update(input: BotMemoryUpdateInput): Promise<BotMemoryDetail> {+ const filename = readFilename(input.filename);+ const expected = readExpected(input.expectedUpdatedAt);+ if (typeof input.title !== 'string' || typeof input.body !== 'string') {+ throwIpcError('INVALID_PARAMS', 'Invalid memory');+ }+ const title = input.title.replace(/\s+/g, ' ').trim();+ const body = input.body.trim();+ if (!title || Array.from(title).length > BOT_MEMORY_TITLE_MAX) {+ throwIpcError('INVALID_PARAMS', 'Invalid memory title');+ }+ if (!body || Buffer.byteLength(body, 'utf8') > BOT_MEMORY_BODY_MAX_BYTES) {+ throwIpcError('INVALID_PARAMS', 'Invalid memory content');+ }+ const { store, owner } = await storeOf(input.botId);+ return serialized(`${input.botId}/${filename}`, async () => {+ const current = await readCurrent(store, filename, expected);+ const type = current.frontmatter.type;+ if (!isBotMemoryType(type)) throwIpcError('NOT_FOUND', 'Memory not found');+ if (current.frontmatter.title === title && current.body === body) return toDetail(current);+ const description =+ current.body === body+ ? current.frontmatter.description+ : botMemoryDescriptionFromBody(body) || title;+ const saved = toDetail(await store+ .update(filename, expected, { title, description, body })+ .catch(translateStoreError));+ scheduleRefresh(owner);+ return saved;+ });+ },++ async delete(input: BotMemoryDeleteInput): Promise<void> {+ const filename = readFilename(input.filename);+ const expected = readExpected(input.expectedUpdatedAt);+ const { store, owner } = await storeOf(input.botId);+ await serialized(`${input.botId}/${filename}`, async () => {+ await readCurrent(store, filename, expected);+ await store.delete(filename, expected).catch(translateStoreError);+ });+ scheduleRefresh(owner);+ },+ };+}diff --git a/apps/desktop/src/preload/preload.ts b/apps/desktop/src/preload/preload.tsindex 89cec7a90f..4c7256ba94 100644--- a/apps/desktop/src/preload/preload.ts+++ b/apps/desktop/src/preload/preload.ts@@ -5404,6 +5404,16 @@ contextBridge.exposeInMainWorld('electronAPI', {ipcRenderer.invoke('local-db:bots:create-canonical-session', body),history: (botId: string): Promise<unknown[]> =>ipcRenderer.invoke('local-db:bots:history', botId),+ memory: {+ list: (botId: string, query?: string): Promise<unknown> =>+ ipcRenderer.invoke('local-db:bots:memory:list', botId, query),+ read: (botId: string, filename: string): Promise<unknown> =>+ ipcRenderer.invoke('local-db:bots:memory:read', botId, filename),+ update: (body: unknown): Promise<unknown> =>+ ipcRenderer.invoke('local-db:bots:memory:update', body),+ delete: (body: unknown): Promise<void> =>+ ipcRenderer.invoke('local-db:bots:memory:delete', body),+ },},conversations: {search: (request: unknown): Promise<unknown> =>diff --git a/apps/desktop/src/renderer/features/bots/BotMemorySettings.tsx b/apps/desktop/src/renderer/features/bots/BotMemorySettings.tsxnew file mode 100644index 0000000000..128b834600--- /dev/null+++ b/apps/desktop/src/renderer/features/bots/BotMemorySettings.tsx@@ -0,0 +1,670 @@+import { useCallback, useEffect, useMemo, useRef, useState, type MutableRefObject } from 'react';+import { Check, PenLine, Search } from 'lucide-react';++import { MarkdownRenderer } from '@/components/chat/MarkdownRenderer';+import { Button } from '@/components/ui/button';+import { useConfirmDialog } from '@/components/ui/confirm-dialog-provider';+import { Input, Textarea } from '@/components/ui/input';+import { Spinner } from '@/components/ui/spinner';+import { Switch } from '@/components/ui/switch';+import { toast } from '@/components/ui/toast';+import { cn } from '@/lib/utils';+import { extractIpcError } from '@/utils/ipcError';+import {+ BOT_MEMORY_BODY_MAX_BYTES,+ BOT_MEMORY_CHANGED,+ BOT_MEMORY_TITLE_MAX,+ BOT_MEMORY_TYPES,+ type BotMemoryDetail,+ type BotMemorySummary,+} from '../../../shared/botMemory';+import { useBotTranslation } from './botPronounContext';++const SEARCH_DEBOUNCE_MS = 200;+const SAVE_DEBOUNCE_MS = 800;++type View =+ { kind: 'list' } | { kind: 'detail'; filename: string } | { kind: 'edit'; filename: string };+type SaveState = 'idle' | 'saving' | 'saved' | 'error' | 'conflict';++const memoryApi = () => window.electronAPI.localDb.bots.memory;+const isConflict = (error: unknown) => {+ const ipc = extractIpcError(error);+ return ipc?.code === 'PRECONDITION_FAILED' && ipc.message.includes(BOT_MEMORY_CHANGED);+};+const normalizeTitle = (title: string) => title.replace(/\s+/g, ' ').trim();+const bodyTooLong = (body: string) =>+ new TextEncoder().encode(body.trim()).length > BOT_MEMORY_BODY_MAX_BYTES;++function useDateLabels() {+ const { t, i18n } = useBotTranslation();+ return useMemo(() => {+ const dayKey = (value: Date) => value.toDateString();+ const locale = i18n?.language;+ const dateFormat = new Intl.DateTimeFormat(locale, { month: 'short', day: 'numeric' });+ const timeFormat = new Intl.DateTimeFormat(locale, {+ hour: '2-digit',+ minute: '2-digit',+ });+ const day = (iso: string) => {+ const date = new Date(iso);+ if (Number.isNaN(date.getTime())) return '';+ return dayKey(date) === dayKey(new Date()) ? t('bots.memory.today') : dateFormat.format(date);+ };+ const stamp = (iso: string) => {+ const date = new Date(iso);+ if (Number.isNaN(date.getTime())) return '';+ return `${day(iso)} ${timeFormat.format(date)}`;+ };+ return { day, stamp };+ }, [i18n?.language, t]);+}++/**+ * 伙伴设置里的「记忆」页:列表(分组 / 搜索)→ 详情 → 编辑。+ * 返回与离开由上层设置页的返回键驱动:`backRef` 先在页内回退,`leaveRef` 保证离开前落盘。+ */+export function BotMemorySettings({+ botId,+ botName,+ memoryEnabled,+ onMemoryEnabledChange,+ backRef,+ leaveRef,+}: {+ botId: string;+ botName: string;+ memoryEnabled: boolean;+ onMemoryEnabledChange: (enabled: boolean) => void;+ backRef: MutableRefObject<(() => Promise<boolean>) | null>;+ leaveRef: MutableRefObject<(() => Promise<boolean>) | null>;+}) {+ const { t } = useBotTranslation();+ const [view, setView] = useState<View>({ kind: 'list' });+ const [detail, setDetail] = useState<BotMemoryDetail | null>(null);+ const editorRef = useRef<{ flush: () => Promise<boolean> } | null>(null);++ const openDetail = useCallback((filename: string) => setView({ kind: 'detail', filename }), []);+ // Stable: the detail view reloads whenever these identities change.+ const showList = useCallback(() => setView({ kind: 'list' }), []);++ useEffect(() => {+ backRef.current = async () => {+ if (view.kind === 'edit') {+ if (!(await (editorRef.current?.flush() ?? Promise.resolve(true)))) return true;+ setView({ kind: 'detail', filename: view.filename });+ return true;+ }+ if (view.kind === 'detail') {+ setView({ kind: 'list' });+ return true;+ }+ return false;+ };+ leaveRef.current = async () => (await editorRef.current?.flush()) ?? true;+ return () => {+ backRef.current = null;+ leaveRef.current = null;+ };+ }, [backRef, leaveRef, view]);++ if (view.kind === 'list') {+ return (+ <MemoryList+ botId={botId}+ memoryEnabled={memoryEnabled}+ onMemoryEnabledChange={onMemoryEnabledChange}+ onOpen={openDetail}+ />+ );+ }+ if (view.kind === 'edit' && detail?.filename === view.filename) {+ return (+ <MemoryEditor+ botId={botId}+ botName={botName}+ initial={detail}+ editorRef={editorRef}+ onSaved={setDetail}+ onDone={() => setView({ kind: 'detail', filename: view.filename })}+ />+ );+ }+ return (+ <MemoryDetail+ botId={botId}+ botName={botName}+ filename={view.filename}+ onLoaded={setDetail}+ onEdit={() => setView({ kind: 'edit', filename: view.filename })}+ onDeleted={() => {+ setDetail(null);+ setView({ kind: 'list' });+ toast.success(t('bots.memory.deleted'));+ }}+ onMissing={showList}+ />+ );+}++function MemoryList({+ botId,+ memoryEnabled,+ onMemoryEnabledChange,+ onOpen,+}: {+ botId: string;+ memoryEnabled: boolean;+ onMemoryEnabledChange: (enabled: boolean) => void;+ onOpen: (filename: string) => void;+}) {+ const { t } = useBotTranslation();+ const { day } = useDateLabels();+ const [query, setQuery] = useState('');+ const [entries, setEntries] = useState<BotMemorySummary[] | null>(null);+ const [total, setTotal] = useState<number | null>(null);+ const [failed, setFailed] = useState(false);+ const [reload, setReload] = useState(0);++ useEffect(() => {+ let cancelled = false;+ const search = query.trim();+ const run = () => {+ memoryApi()+ .list(botId, search || undefined)+ .then((next) => {+ if (cancelled) return;+ setEntries(next);+ if (!search) setTotal(next.length);+ setFailed(false);+ })+ .catch(() => {+ if (!cancelled) setFailed(true);+ });+ };+ const timer = search ? setTimeout(run, SEARCH_DEBOUNCE_MS) : null;+ if (!timer) run();+ return () => {+ cancelled = true;+ if (timer) clearTimeout(timer);+ };+ }, [botId, query, reload]);++ const groups = BOT_MEMORY_TYPES.map((type) => ({+ type,+ items: (entries ?? []).filter((entry) => entry.type === type),+ })).filter((group) => group.items.length);++ return (+ <div className="flex flex-col gap-4 pt-1">+ <div className="flex min-h-[52px] items-center justify-between gap-3 rounded-xl border border-[var(--border-default)] bg-[var(--surface-elevated)] px-4 py-3">+ <div className="min-w-0">+ <p className="text-14 text-[var(--text-primary)]">{t('bots.memory.enabled')}</p>+ {!memoryEnabled ? (+ <p className="mt-0.5 text-12 text-[var(--text-secondary)]">+ {t('bots.memory.disabledHint')}+ </p>+ ) : null}+ </div>+ <Switch+ checked={memoryEnabled}+ onCheckedChange={onMemoryEnabledChange}+ aria-label={t('bots.memory.enabled')}+ />+ </div>+ {failed ? (+ <div+ className="flex flex-col items-center gap-3 py-10 text-13 text-[var(--text-secondary)]"+ role="alert"+ >+ {t('bots.memory.loadFailed')}+ <Button variant="secondary" size="md" onClick={() => setReload((value) => value + 1)}>+ {t('commonUi.retry')}+ </Button>+ </div>+ ) : entries === null ? (+ <div className="flex justify-center py-10">+ <Spinner size={16} />+ </div>+ ) : total === 0 && !query.trim() ? (+ <p className="py-12 text-center text-13 text-[var(--text-secondary)]">+ {t('bots.memory.empty')}+ </p>+ ) : (+ <div className={cn('flex flex-col gap-4', !memoryEnabled && 'opacity-60')}>+ <div className="relative">+ <Search+ size={14}+ aria-hidden="true"+ className="pointer-events-none absolute left-3 top-1/2 z-10 -translate-y-1/2 text-[var(--text-tertiary)]"+ />+ <Input+ size="md"+ value={query}+ onChange={setQuery}+ ariaLabel={t('bots.memory.search')}+ placeholder={t('bots.memory.search')}+ inputClassName="pl-8"+ />+ </div>+ {groups.length ? (+ groups.map((group) => (+ <section key={group.type} aria-label={t(`bots.memory.types.${group.type}`)}>+ <h3 className="flex items-baseline gap-1.5 px-1 pb-2 text-12 font-medium text-[var(--text-secondary)]">+ {t(`bots.memory.types.${group.type}`)}+ <span className="font-normal tabular-nums text-[var(--text-tertiary)]">+ {group.items.length}+ </span>+ </h3>+ <div className="overflow-hidden rounded-xl border border-[var(--border-default)] bg-[var(--surface-elevated)]">+ {group.items.map((entry) => (+ <button+ key={entry.filename}+ type="button"+ onClick={() => onOpen(entry.filename)}+ className="block w-full border-b border-[var(--border-default)] px-4 py-3 text-left last:border-b-0 hover:bg-[var(--surface-hover)] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-[var(--focus-ring)]"+ >+ <span className="flex items-start gap-3">+ <span className="min-w-0 flex-1 break-words text-14 font-medium leading-[1.45] text-[var(--text-primary)] [overflow-wrap:anywhere]">+ {entry.title}+ </span>+ <span className="shrink-0 pt-0.5 text-11 tabular-nums text-[var(--text-tertiary)]">+ {day(entry.updatedAt)}+ </span>+ </span>+ <span className="mt-1 line-clamp-2 break-words text-12 leading-[1.55] text-[var(--text-secondary)] [overflow-wrap:anywhere]">+ {entry.preview}+ </span>+ </button>+ ))}+ </div>+ </section>+ ))+ ) : (+ <p className="py-12 text-center text-13 text-[var(--text-secondary)]">+ {t('bots.memory.noResults')}+ </p>+ )}+ </div>+ )}+ </div>+ );+}++function MemoryDetail({+ botId,+ botName,+ filename,+ onLoaded,+ onEdit,+ onDeleted,+ onMissing,+}: {+ botId: string;+ botName: string;+ filename: string;+ onLoaded: (detail: BotMemoryDetail) => void;+ onEdit: () => void;+ onDeleted: () => void;+ onMissing: () => void;+}) {+ const { t } = useBotTranslation();+ const { stamp } = useDateLabels();+ const { confirm } = useConfirmDialog();+ const [detail, setDetail] = useState<BotMemoryDetail | null>(null);+ const [failed, setFailed] = useState(false);+ const [changed, setChanged] = useState(false);+ const [busy, setBusy] = useState(false);+ const [reload, setReload] = useState(0);++ useEffect(() => {+ let cancelled = false;+ memoryApi()+ .read(botId, filename)+ .then((next) => {+ if (cancelled) return;+ setDetail(next);+ onLoaded(next);+ setFailed(false);+ })+ .catch((error: unknown) => {+ if (cancelled) return;+ if (extractIpcError(error)?.code === 'NOT_FOUND') onMissing();+ else setFailed(true);+ });+ return () => {+ cancelled = true;+ };+ }, [botId, filename, reload, onLoaded, onMissing]);++ const remove = async () => {+ if (!detail || busy) return;+ const ok = await confirm({+ presentation: 'standard',+ title: t('bots.memory.deleteTitle'),+ description: t('bots.memory.deleteDescription', { name: botName, title: detail.title }),+ confirmText: t('bots.memory.delete'),+ cancelText: t('bots.memory.cancel'),+ confirmVariant: 'destructive',+ });+ if (!ok) return;+ setBusy(true);+ try {+ await memoryApi().delete({ botId, filename, expectedUpdatedAt: detail.updatedAt });+ onDeleted();+ } catch (error) {+ if (isConflict(error)) {+ setChanged(true);+ setReload((value) => value + 1);+ } else if (extractIpcError(error)?.code === 'NOT_FOUND') {+ onDeleted();+ } else {+ toast.error(t('bots.memory.deleteFailed'));+ }+ } finally {+ setBusy(false);+ }+ };++ if (failed) {+ return (+ <div+ className="flex flex-col items-center gap-3 py-10 text-13 text-[var(--text-secondary)]"+ role="alert"+ >+ {t('bots.memory.loadFailed')}+ <Button variant="secondary" size="md" onClick={() => setReload((value) => value + 1)}>+ {t('commonUi.retry')}+ </Button>+ </div>+ );+ }+ if (!detail) {+ return (+ <div className="flex justify-center py-10">+ <Spinner size={16} />+ </div>+ );+ }+ return (+ <article className="pt-2">+ {changed ? (+ <p+ className="mb-3 rounded-xl border border-[var(--border-default)] bg-[var(--surface-elevated)] px-4 py-3 text-12 text-[var(--text-secondary)]"+ role="status"+ >+ {t('bots.memory.changedTitle', { name: botName })}+ </p>+ ) : null}+ <h3 className="break-words text-16 font-medium leading-[1.45] text-[var(--text-primary)] [overflow-wrap:anywhere]">+ {detail.title}+ </h3>+ <p className="mt-1.5 text-12 text-[var(--text-secondary)]">+ {t(`bots.memory.types.${detail.type}`)} ·{' '}+ {t('bots.memory.updated', { time: stamp(detail.updatedAt) })}+ </p>+ <div className="mt-4 text-14 leading-[1.75] text-[var(--text-primary)]">+ <MarkdownRenderer workingDir="" content={detail.body} allowPrivilegedLinks={false} />+ </div>+ <div className="mt-6 flex items-center gap-2 border-t border-[var(--border-default)] pt-4">+ <Button variant="secondary" size="md" onClick={onEdit} disabled={busy}>+ <PenLine size={14} aria-hidden="true" />+ {t('bots.memory.edit')}+ </Button>+ <span className="flex-1" />+ <Button+ variant="secondary"+ tone="quiet"+ size="md"+ onClick={() => void remove()}+ loading={busy}+ >+ {t('bots.memory.delete')}+ </Button>+ </div>+ </article>+ );+}++function MemoryEditor({+ botId,+ botName,+ initial,+ editorRef,+ onSaved,+ onDone,+}: {+ botId: string;+ botName: string;+ initial: BotMemoryDetail;+ editorRef: MutableRefObject<{ flush: () => Promise<boolean> } | null>;+ onSaved: (detail: BotMemoryDetail) => void;+ onDone: () => void;+}) {+ const { t } = useBotTranslation();+ const { confirm } = useConfirmDialog();+ const [title, setTitle] = useState(initial.title);+ const [body, setBody] = useState(initial.body);+ const [state, setState] = useState<SaveState>('idle');+ const [latest, setLatest] = useState<BotMemoryDetail | null>(null);+ const saved = useRef(initial);+ const draft = useRef({ title: initial.title, body: initial.body });+ const timer = useRef<ReturnType<typeof setTimeout> | null>(null);+ const inFlight = useRef<Promise<boolean> | null>(null);+ const blocked = useRef(false);++ const invalid = !title.trim() || !body.trim() || bodyTooLong(body);+ // 与主进程保存时的规范化一致,避免只差空白的标题永远算作未保存。+ const isDirty = () =>+ normalizeTitle(draft.current.title) !== saved.current.title ||+ draft.current.body.trim() !== saved.current.body;+ const isValid = () =>+ Boolean(draft.current.title.trim() && draft.current.body.trim()) &&+ !bodyTooLong(draft.current.body);++ const save = useCallback(async (): Promise<boolean> => {+ if (timer.current) {+ clearTimeout(timer.current);+ timer.current = null;+ }+ if (inFlight.current) return inFlight.current;+ if (blocked.current) return false;+ if (!isDirty()) return true;+ if (!isValid()) return false;+ const run = (async () => {+ setState('saving');+ try {+ // Edits made while a save is in flight must also reach disk before leaving.+ while (isDirty()) {+ if (!isValid()) {+ setState('idle');+ return false;+ }+ const next = { ...draft.current };+ const result = await memoryApi().update({+ botId,+ filename: saved.current.filename,+ title: next.title,+ body: next.body,+ expectedUpdatedAt: saved.current.updatedAt,+ });+ saved.current = result;+ onSaved(result);+ }+ setState('saved');+ return true;+ } catch (error) {+ if (isConflict(error)) {+ blocked.current = true;+ setState('conflict');+ setLatest(+ await memoryApi()+ .read(botId, saved.current.filename)+ .catch(() => null),+ );+ } else {+ setState('error');+ }+ return false;+ }+ })();+ inFlight.current = run;+ try {+ return await run;+ } finally {+ inFlight.current = null;+ }+ }, [botId, onSaved]);++ // 离开编辑:能保存就保存;保存不了(冲突、超限、写入失败)时由用户决定放弃还是留下。+ const settle = useCallback(async (): Promise<boolean> => {+ if (await save()) return true;+ return confirm({+ presentation: 'standard',+ title: t('bots.memory.unsavedTitle'),+ description: t('bots.memory.unsavedDescription'),+ confirmText: t('bots.memory.discard'),+ cancelText: t('bots.memory.continueEditing'),+ });+ }, [confirm, save, t]);+ useEffect(() => {+ editorRef.current = { flush: settle };+ return () => {+ editorRef.current = null;+ if (timer.current) clearTimeout(timer.current);+ };+ }, [editorRef, settle]);++ const edit = (patch: Partial<{ title: string; body: string }>) => {+ draft.current = { ...draft.current, ...patch };+ if (patch.title !== undefined) setTitle(patch.title);+ if (patch.body !== undefined) setBody(patch.body);+ if (blocked.current) return;+ setState('idle');+ if (timer.current) clearTimeout(timer.current);+ timer.current = setTimeout(() => void save(), SAVE_DEBOUNCE_MS);+ };++ // 冲突时最新内容可能没读到;两个选择都先确保拿到它,读不到就留在原处。+ const resolveLatest = async () => {+ const next =+ latest ??+ (await memoryApi()+ .read(botId, saved.current.filename)+ .catch(() => null));+ if (!next) toast.error(t('bots.memory.loadFailed'));+ return next;+ };+ const useLatest = async () => {+ const next = await resolveLatest();+ if (!next) return;+ blocked.current = false;+ saved.current = next;+ draft.current = { title: next.title, body: next.body };+ setTitle(next.title);+ setBody(next.body);+ onSaved(next);+ setLatest(null);+ setState('idle');+ };+ const keepMine = async () => {+ const next = await resolveLatest();+ if (!next) return;+ blocked.current = false;+ // 用户看过最新内容后仍选择自己的版本:以最新版本为比对基准重新保存。+ saved.current = next;+ setLatest(null);+ await save();+ };++ return (+ <div className="flex flex-col gap-3 pt-2">+ {state === 'conflict' ? (+ <div+ className="rounded-xl border border-[var(--border-default)] bg-[var(--surface-elevated)] px-4 py-3"+ role="alert"+ >+ <p className="text-13 font-medium text-[var(--text-primary)]">+ {t('bots.memory.changedTitle', { name: botName })}+ </p>+ {latest ? (+ <p className="mt-1.5 max-h-40 overflow-y-auto whitespace-pre-wrap break-words text-12 leading-[1.55] text-[var(--text-secondary)]">+ {latest.body}+ </p>+ ) : null}+ <div className="mt-3 flex flex-wrap gap-2">+ <Button variant="secondary" size="sm" onClick={() => void useLatest()}>+ {t('bots.memory.useLatest')}+ </Button>+ <Button variant="secondary" tone="quiet" size="sm" onClick={() => void keepMine()}>+ {t('bots.memory.keepMine')}+ </Button>+ </div>+ </div>+ ) : null}+ <label className="block">+ <span className="mb-1.5 ml-1 block text-12 text-[var(--text-secondary)]">+ {t('bots.memory.titleLabel')}+ </span>+ <Input+ size="md"+ value={title}+ maxLength={BOT_MEMORY_TITLE_MAX}+ onChange={(value) => edit({ title: value })}+ error={!title.trim()}+ />+ </label>+ <label className="block">+ <span className="mb-1.5 ml-1 block text-12 text-[var(--text-secondary)]">+ {t('bots.memory.bodyLabel')}+ </span>+ <Textarea+ rows={10}+ value={body}+ onChange={(value) => edit({ body: value })}+ error={!body.trim() || bodyTooLong(body)}+ className="min-h-[220px] resize-y text-14 leading-[1.75]"+ />+ </label>+ {bodyTooLong(body) ? (+ <p className="ml-1 text-12 text-[var(--text-danger)]" role="alert">+ {t('bots.memory.tooLong')}+ </p>+ ) : null}+ <div className="mt-1 flex items-center justify-end gap-3">+ {state === 'saving' ? (+ <span+ role="status"+ className="inline-flex items-center gap-1 text-11 text-[var(--text-tertiary)]"+ >+ <Spinner size={12} /> {t('bots.autosave.saving')}+ </span>+ ) : state === 'saved' ? (+ <span+ role="status"+ className="inline-flex items-center gap-1 text-11 text-[var(--text-tertiary)]"+ >+ <Check size={12} /> {t('bots.autosave.saved')}+ </span>+ ) : state === 'error' ? (+ <span role="alert" className="text-11 text-[var(--text-danger)]">+ {t('bots.memory.saveFailed')}+ </span>+ ) : null}+ <Button+ variant="secondary"+ size="md"+ disabled={state === 'conflict'}+ onClick={() =>+ void (async () => {+ if (invalid && isDirty()) return;+ if (await save()) onDone();+ })()+ }+ >+ {t('bots.memory.done')}+ </Button>+ </div>+ </div>+ );+}diff --git a/apps/desktop/src/renderer/features/bots/BotsHomeView.tsx b/apps/desktop/src/renderer/features/bots/BotsHomeView.tsxindex 7febcb44da..a55bdb5cb8 100644--- a/apps/desktop/src/renderer/features/bots/BotsHomeView.tsx+++ b/apps/desktop/src/renderer/features/bots/BotsHomeView.tsx@@ -8,6 +8,7 @@ import { BotPortraitPicker } from './BotPortraitPicker';import {ArrowLeft,Bot,+ Brain,Camera,Check,ChevronRight,@@ -56,6 +57,7 @@ import { BotInvitationWelcome } from './BotInvitationWelcome';import { BotModelChainEditor } from './BotModelChainEditor';import { BotCapabilitySettings } from './BotCapabilitySettings';import { BotRoutines } from './BotRoutines';+import { BotMemorySettings } from './BotMemorySettings';import {botSettingsChanges,normalizeBotSettingsPayload,@@ -132,22 +134,27 @@ export function BotSettings({| 'history'| 'advanced'| 'routines'+ | 'memory'>('home');const routineLeaveRef = useRef<(() => Promise<boolean>) | null>(null);+ const memoryLeaveRef = useRef<(() => Promise<boolean>) | null>(null);+ const memoryBackRef = useRef<(() => Promise<boolean>) | null>(null);const pageTitle =- page === 'model'- ? t('bots.settingsTabs.model')- : page === 'routines'- ? t('routines.title')- : page === 'history'- ? t('bots.historySearch.title')- : page === 'advanced'- ? t('bots.homeFolder.title')- : page === 'capabilities'- ? t('bots.capabilities.title')- : page === 'personality'- ? t('bots.profile.personality')- : t('bots.profile.title');+ page === 'memory'+ ? t('bots.memory.title')+ : page === 'model'+ ? t('bots.settingsTabs.model')+ : page === 'routines'+ ? t('routines.title')+ : page === 'history'+ ? t('bots.historySearch.title')+ : page === 'advanced'+ ? t('bots.homeFolder.title')+ : page === 'capabilities'+ ? t('bots.capabilities.title')+ : page === 'personality'+ ? t('bots.profile.personality')+ : t('bots.profile.title');const [folderError, setFolderError] = useState<string | null>(null);const avatarInFlight = useRef(false);const [avatarBusy, setAvatarBusy] = useState(false);@@ -210,6 +217,7 @@ export function BotSettings({if (avatarInFlight.current) return false;await autosave.flush();if (autosave.isDirty()) return false;+ if (!((await memoryLeaveRef.current?.()) ?? true)) return false;return (await routineLeaveRef.current?.()) ?? true;}, [autosave.flush, autosave.isDirty]);useEffect(() => {@@ -220,7 +228,7 @@ export function BotSettings({};}, [beforeCloseRef, canLeave]);const go = (next: typeof page) => {- if (!autosave.isDirty() && !routineLeaveRef.current) {+ if (!autosave.isDirty() && !routineLeaveRef.current && !memoryLeaveRef.current) {setPage(next);return;}@@ -361,6 +369,7 @@ export function BotSettings({const settingsRows = [['profile', Info, t('bots.profile.title')],['personality', UserRound, t('bots.profile.personality')],+ ['memory', Brain, t('bots.memory.title')],['model', Sparkles, t('bots.settingsTabs.model')],['capabilities', Settings2, t('bots.capabilities.title')],['routines', Clock3, t('routines.title')],@@ -375,7 +384,12 @@ export function BotSettings({<div className="flex min-w-0 items-center gap-2"><buttontype="button"- onClick={() => void go('home')}+ onClick={() =>+ void (async () => {+ if (page === 'memory' && (await memoryBackRef.current?.())) return;+ go('home');+ })()+ }aria-label={t('bots.settingsBack')}className="flex h-9 w-9 shrink-0 items-center justify-center rounded-full text-[var(--text-secondary)] hover:bg-[var(--surface-hover)]">@@ -599,18 +613,6 @@ export function BotSettings({>{t('bots.homeFolder.open')}</Button>- {!capabilities.memory ? (- <Button- variant="secondary"- size="lg"- compact- type="button"- onClick={() => updateCapability('memory', true)}- className="ml-2 mt-3"- >- {t('bots.memoryRecovery.action')}- </Button>- ) : null}{folderError ? (<p className="mt-2 text-11 text-[var(--text-danger)]" role="alert">{folderError}@@ -620,6 +622,16 @@ export function BotSettings({</div></div>) : null}+ {page === 'memory' ? (+ <BotMemorySettings+ botId={bot.id}+ botName={name}+ memoryEnabled={capabilities.memory}+ onMemoryEnabledChange={(enabled) => updateCapability('memory', enabled)}+ backRef={memoryBackRef}+ leaveRef={memoryLeaveRef}+ />+ ) : null}{page === 'routines' ? (<BotRoutines embedded botId={bot.id} beforeLeaveRef={routineLeaveRef} />) : null}diff --git a/apps/desktop/src/renderer/features/bots/__tests__/botMemorySettings.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/botMemorySettings.test.tsxnew file mode 100644index 0000000000..3de2f6fa99--- /dev/null+++ b/apps/desktop/src/renderer/features/bots/__tests__/botMemorySettings.test.tsx@@ -0,0 +1,246 @@+// @vitest-environment jsdom++import { act, cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';+import type { MutableRefObject } from 'react';++import { createIpcError } from '../../../../shared/ipc-errors';+import { BOT_MEMORY_CHANGED, type BotMemoryDetail, type BotMemorySummary } from '../../../../shared/botMemory';++const translate = (key: string, opts?: Record<string, unknown>) =>+ opts ? `${key}:${JSON.stringify(opts)}` : key;+vi.mock('react-i18next', () => ({ useTranslation: () => ({ t: translate }) }));+vi.mock('@/components/chat/MarkdownRenderer', () => ({+ MarkdownRenderer: ({ content }: { content: string }) => <div data-testid="markdown">{content}</div>,+}));+const mocks = vi.hoisted(() => ({+ confirm: vi.fn(async () => true),+ toastSuccess: vi.fn(),+ toastError: vi.fn(),+}));+vi.mock('@/components/ui/confirm-dialog-provider', () => ({+ useConfirmDialog: () => ({ confirm: mocks.confirm }),+}));+vi.mock('@/components/ui/toast', () => ({+ toast: { success: mocks.toastSuccess, error: mocks.toastError },+}));++import { BotMemorySettings } from '../BotMemorySettings';++const summaries: BotMemorySummary[] = [+ { filename: 'user_quiet.md', type: 'user', title: '检查没事不说话', preview: '无变化时不播报。', updatedAt: '2026-09-23T09:35:33.152Z' },+ { filename: 'feedback_verify.md', type: 'feedback', title: '说结论前核实', preview: '回复前主动核实事实。', updatedAt: '2026-09-17T05:01:04.387Z' },+];+const detail: BotMemoryDetail = {+ filename: 'feedback_verify.md',+ type: 'feedback',+ title: '说结论前核实',+ body: '回复前主动核实事实。\n\n- 没核实的标待验证',+ updatedAt: '2026-09-17T05:01:04.387Z',+};++const api = {+ list: vi.fn(async (_botId: string, _query?: string) => summaries),+ read: vi.fn(async () => detail),+ update: vi.fn(async (input: { title: string; body: string }) => ({+ ...detail,+ ...input,+ updatedAt: '2026-09-23T10:00:00.000Z',+ })),+ delete: vi.fn(async () => undefined),+};++function renderMemory(memoryEnabled = true) {+ const backRef: MutableRefObject<(() => Promise<boolean>) | null> = { current: null };+ const leaveRef: MutableRefObject<(() => Promise<boolean>) | null> = { current: null };+ const onMemoryEnabledChange = vi.fn();+ render(+ <BotMemorySettings+ botId="bot-1"+ botName="Cindy"+ memoryEnabled={memoryEnabled}+ onMemoryEnabledChange={onMemoryEnabledChange}+ backRef={backRef}+ leaveRef={leaveRef}+ />,+ );+ return { backRef, leaveRef, onMemoryEnabledChange };+}++async function openDetail() {+ fireEvent.click(await screen.findByRole('button', { name: /说结论前核实/ }));+ await screen.findByTestId('markdown');+}++beforeEach(() => {+ for (const fn of Object.values(api)) fn.mockClear();+ api.list.mockImplementation(async () => summaries);+ api.read.mockImplementation(async () => detail);+ mocks.confirm.mockReset().mockResolvedValue(true);+ mocks.toastSuccess.mockReset();+ mocks.toastError.mockReset();+ (window as unknown as { electronAPI: unknown }).electronAPI = { localDb: { bots: { memory: api } } };+});++afterEach(() => {+ vi.useRealTimers();+ cleanup();+});++describe('BotMemorySettings', () => {+ it('groups memories by type and shows the content preview', async () => {+ renderMemory();+ const about = await screen.findByRole('region', { name: 'bots.memory.types.user' });+ expect(about.textContent).toContain('检查没事不说话');+ expect(about.textContent).toContain('无变化时不播报。');+ expect(screen.getByRole('region', { name: 'bots.memory.types.feedback' }).textContent).toContain('回复前主动核实事实。');+ expect(screen.queryByRole('region', { name: 'bots.memory.types.project' })).toBeNull();+ });++ it('shows the empty state without a search box', async () => {+ api.list.mockResolvedValueOnce([]);+ renderMemory();+ expect(await screen.findByText('bots.memory.empty')).toBeTruthy();+ expect(screen.queryByRole('textbox', { name: 'bots.memory.search' })).toBeNull();+ });++ it('searches through the host and reports no matches', async () => {+ renderMemory();+ await screen.findByRole('region', { name: 'bots.memory.types.user' });+ api.list.mockResolvedValueOnce([]);+ fireEvent.change(screen.getByRole('textbox', { name: 'bots.memory.search' }), { target: { value: '报错' } });+ expect(await screen.findByText('bots.memory.noResults')).toBeTruthy();+ expect(api.list).toHaveBeenLastCalledWith('bot-1', '报错');+ });++ it('keeps the list visible and forwards the switch when memory is off', async () => {+ const { onMemoryEnabledChange } = renderMemory(false);+ expect(screen.getByText('bots.memory.disabledHint')).toBeTruthy();+ await screen.findByRole('region', { name: 'bots.memory.types.user' });+ fireEvent.click(screen.getByRole('switch', { name: 'bots.memory.enabled' }));+ expect(onMemoryEnabledChange).toHaveBeenCalledWith(true);+ });++ it('opens the full memory once and steps back to the list', async () => {+ // Each host reply is a new object; loading it must not retrigger another read.+ api.read.mockImplementation(async () => ({ ...detail }));+ const { backRef } = renderMemory();+ await openDetail();+ await act(async () => {+ await new Promise((resolve) => setTimeout(resolve, 20));+ });+ expect(api.read).toHaveBeenCalledTimes(1);+ expect(api.read).toHaveBeenCalledWith('bot-1', 'feedback_verify.md');+ expect(screen.getByTestId('markdown').textContent).toContain('没核实的标待验证');+ await act(async () => {+ expect(await backRef.current?.()).toBe(true);+ });+ expect(await screen.findByRole('region', { name: 'bots.memory.types.user' })).toBeTruthy();+ expect(await backRef.current?.()).toBe(false);+ });++ it('autosaves edits with the version that was opened', async () => {+ const { leaveRef } = renderMemory();+ await openDetail();+ fireEvent.click(screen.getByRole('button', { name: 'bots.memory.edit' }));+ fireEvent.change(screen.getByRole('textbox', { name: 'bots.memory.bodyLabel' }), {+ target: { value: '先核实,再说结论。' },+ });+ await act(async () => {+ expect(await leaveRef.current?.()).toBe(true);+ });+ expect(api.update).toHaveBeenCalledWith({+ botId: 'bot-1',+ filename: 'feedback_verify.md',+ title: '说结论前核实',+ body: '先核实,再说结论。',+ expectedUpdatedAt: detail.updatedAt,+ });+ expect(screen.getByText('bots.autosave.saved')).toBeTruthy();+ });++ it('flushes edits typed during an in-flight save before allowing the page to close', async () => {+ const { leaveRef } = renderMemory();+ await openDetail();+ fireEvent.click(screen.getByRole('button', { name: 'bots.memory.edit' }));+ let finish!: (value: BotMemoryDetail) => void;+ api.update.mockImplementationOnce(() => new Promise((resolve) => { finish = resolve; }));+ fireEvent.change(screen.getByRole('textbox', { name: 'bots.memory.bodyLabel' }), { target: { value: 'First edit' } });+ let leaving!: Promise<boolean>;+ await act(async () => { leaving = leaveRef.current!(); });+ fireEvent.change(screen.getByRole('textbox', { name: 'bots.memory.bodyLabel' }), { target: { value: 'Second edit' } });+ await act(async () => {+ finish({ ...detail, body: 'First edit', updatedAt: '2026-09-23T12:00:00.000Z' });+ expect(await leaving).toBe(true);+ });+ expect(api.update).toHaveBeenCalledTimes(2);+ expect(api.update).toHaveBeenLastCalledWith(expect.objectContaining({+ body: 'Second edit', expectedUpdatedAt: '2026-09-23T12:00:00.000Z',+ }));+ });++ it('does not save an over-limit body', async () => {+ const { leaveRef } = renderMemory();+ await openDetail();+ fireEvent.click(screen.getByRole('button', { name: 'bots.memory.edit' }));+ fireEvent.change(screen.getByRole('textbox', { name: 'bots.memory.bodyLabel' }), {+ target: { value: '字'.repeat(3000) },+ });+ expect(screen.getByText('bots.memory.tooLong')).toBeTruthy();+ mocks.confirm.mockResolvedValueOnce(false);+ await act(async () => {+ expect(await leaveRef.current?.()).toBe(false);+ });+ expect(mocks.confirm).toHaveBeenLastCalledWith(+ expect.objectContaining({ title: 'bots.memory.unsavedTitle' }),+ );+ // Choosing to discard lets the user leave without writing anything.+ await act(async () => {+ expect(await leaveRef.current?.()).toBe(true);+ });+ expect(api.update).not.toHaveBeenCalled();+ });++ it('stops on a teammate change and lets the user keep their edit', async () => {+ const latest = { ...detail, body: '伙伴刚写的', updatedAt: '2026-09-23T11:00:00.000Z' };+ api.update.mockRejectedValueOnce(createIpcError('PRECONDITION_FAILED', BOT_MEMORY_CHANGED));+ renderMemory();+ await openDetail();+ api.read.mockResolvedValue(latest);+ fireEvent.click(screen.getByRole('button', { name: 'bots.memory.edit' }));+ fireEvent.change(screen.getByRole('textbox', { name: 'bots.memory.bodyLabel' }), {+ target: { value: '我的版本' },+ });+ fireEvent.click(screen.getByRole('button', { name: 'bots.memory.done' }));+ expect(await screen.findByText('伙伴刚写的')).toBeTruthy();+ expect(screen.getByText('bots.memory.changedTitle:{"name":"Cindy"}')).toBeTruthy();+ fireEvent.click(screen.getByRole('button', { name: 'bots.memory.keepMine' }));+ await waitFor(() => expect(api.update).toHaveBeenCalledTimes(2));+ expect(api.update).toHaveBeenLastCalledWith(+ expect.objectContaining({ body: '我的版本', expectedUpdatedAt: latest.updatedAt }),+ );+ });++ it('deletes after confirmation with the opened version', async () => {+ renderMemory();+ await openDetail();+ fireEvent.click(screen.getByRole('button', { name: 'bots.memory.delete' }));+ await waitFor(() => expect(api.delete).toHaveBeenCalledWith({+ botId: 'bot-1',+ filename: 'feedback_verify.md',+ expectedUpdatedAt: detail.updatedAt,+ }));+ expect(mocks.confirm).toHaveBeenCalledWith(expect.objectContaining({ confirmVariant: 'destructive' }));+ expect(mocks.toastSuccess).toHaveBeenCalledWith('bots.memory.deleted');+ expect(await screen.findByRole('region', { name: 'bots.memory.types.user' })).toBeTruthy();+ });++ it('keeps the memory when deletion is cancelled', async () => {+ mocks.confirm.mockResolvedValueOnce(false);+ renderMemory();+ await openDetail();+ fireEvent.click(screen.getByRole('button', { name: 'bots.memory.delete' }));+ await waitFor(() => expect(mocks.confirm).toHaveBeenCalled());+ expect(api.delete).not.toHaveBeenCalled();+ });+});diff --git a/apps/desktop/src/renderer/features/bots/__tests__/botSettings.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/botSettings.test.tsxindex e13dbd202e..ef300603dc 100644--- a/apps/desktop/src/renderer/features/bots/__tests__/botSettings.test.tsx+++ b/apps/desktop/src/renderer/features/bots/__tests__/botSettings.test.tsx@@ -128,6 +128,9 @@ vi.mock('@/state/newMakerDraft', () => ({}));vi.mock('../../feature-context', () => ({ useRegisterContentHeader: () => undefined }));+vi.mock('@/components/chat/MarkdownRenderer', () => ({+ MarkdownRenderer: ({ content }: { content: string }) => <div>{content}</div>,+}));import { BotsHomeView, BotSettings } from '../BotsHomeView';@@ -633,14 +636,23 @@ describe('Bot settings unified autosave', () => {);});- it('offers one recovery action only for a legacy profile with memory disabled', async () => {+ it('turns memory on and off from the memory page', async () => {vi.useFakeTimers();+ const listMemory = vi.fn(async () => []);+ Object.assign(window.electronAPI, {+ localDb: { ...window.electronAPI.localDb, bots: { memory: { list: listMemory } } },+ });renderSettings({ capabilities: capabilities({ memory: false }) });fireEvent.click(screen.getByRole('button', { name: 'bots.homeFolder.title' }));- fireEvent.click(screen.getByRole('button', { name: 'bots.memoryRecovery.action' }));+ expect(screen.queryByRole('switch')).toBeNull();+ fireEvent.click(screen.getByRole('button', { name: 'bots.settingsBack' }));+ fireEvent.click(screen.getByRole('button', { name: 'bots.memory.title' }));+ expect(screen.getByText('bots.memory.disabledHint')).toBeTruthy();+ fireEvent.click(screen.getByRole('switch', { name: 'bots.memory.enabled' }));await act(async () => {await vi.advanceTimersByTimeAsync(0);});+ expect(listMemory).toHaveBeenCalledWith('bot-1', undefined);expect(mocks.updateBotProfile.mock.calls[0]?.[1]).toMatchObject({capabilities: expect.objectContaining({ memory: true }),});diff --git a/apps/desktop/src/renderer/i18n/locales/en/common.json b/apps/desktop/src/renderer/i18n/locales/en/common.jsonindex e67c0c412b..49fed552f1 100644--- a/apps/desktop/src/renderer/i18n/locales/en/common.json+++ b/apps/desktop/src/renderer/i18n/locales/en/common.json@@ -7725,8 +7725,41 @@"restarted": "Restarted. Send a message to continue."},"backToChat": "Back to chat",- "memoryRecovery": {- "action": "Turn memory back on"+ "memory": {+ "title": "Memory",+ "enabled": "Use memory",+ "disabledHint": "Off. Memories aren't read or saved.",+ "search": "Search memories",+ "empty": "No memories yet",+ "noResults": "No matching memories",+ "loadFailed": "Memories couldn't be loaded",+ "types": {+ "user": "About you",+ "feedback": "Your preferences",+ "project": "Projects",+ "reference": "References"+ },+ "today": "Today",+ "updated": "Updated {{time}}",+ "edit": "Edit",+ "delete": "Delete",+ "cancel": "Cancel",+ "done": "Done",+ "titleLabel": "Title",+ "bodyLabel": "Content",+ "tooLong": "Too long. Shorten it to save.",+ "deleteTitle": "Delete this memory?",+ "deleteDescription": "{{name}} will no longer refer to “{{title}}”.",+ "deleted": "Deleted",+ "deleteFailed": "The memory couldn't be deleted",+ "changedTitle": "{{name}} just updated this memory",+ "useLatest": "Use latest",+ "keepMine": "Keep my changes",+ "saveFailed": "Not saved",+ "unsavedTitle": "Unsaved Changes",+ "unsavedDescription": "Leaving will discard these changes to the memory.",+ "discard": "Discard Changes",+ "continueEditing": "Keep Editing"},"profileSaveFailed": "Teammate settings could not be saved. No changes were applied.","modelLabel": "Model",diff --git a/apps/desktop/src/renderer/i18n/locales/ja/common.json b/apps/desktop/src/renderer/i18n/locales/ja/common.jsonindex bc9ffd3bfd..f4fbecc7fa 100644--- a/apps/desktop/src/renderer/i18n/locales/ja/common.json+++ b/apps/desktop/src/renderer/i18n/locales/ja/common.json@@ -7723,8 +7723,41 @@"restarted": "再起動しました。メッセージを送信して続けられます。"},"backToChat": "チャットに戻る",- "memoryRecovery": {- "action": "メモリをオンに戻す"+ "memory": {+ "title": "メモリ",+ "enabled": "メモリを使う",+ "disabledHint": "オフです。メモリの読み取りも保存もしません",+ "search": "メモリを検索",+ "empty": "まだメモリはありません",+ "noResults": "一致するメモリはありません",+ "loadFailed": "メモリを読み込めませんでした",+ "types": {+ "user": "あなたについて",+ "feedback": "あなたの要望",+ "project": "プロジェクト",+ "reference": "参考"+ },+ "today": "今日",+ "updated": "{{time}} に更新",+ "edit": "編集",+ "delete": "削除",+ "cancel": "キャンセル",+ "done": "完了",+ "titleLabel": "タイトル",+ "bodyLabel": "内容",+ "tooLong": "長すぎます。短くすると保存されます",+ "deleteTitle": "このメモリを削除しますか?",+ "deleteDescription": "{{name}}は今後「{{title}}」を参照しません。",+ "deleted": "削除しました",+ "deleteFailed": "削除できませんでした",+ "changedTitle": "{{name}}がこのメモリを更新しました",+ "useLatest": "最新の内容を使う",+ "keepMine": "自分の変更を残す",+ "saveFailed": "保存できませんでした",+ "unsavedTitle": "未保存の変更があります",+ "unsavedDescription": "移動すると、このメモリへの変更は破棄されます。",+ "discard": "変更を破棄",+ "continueEditing": "編集を続ける"},"profileSaveFailed": "仲間設定を保存できませんでした。変更は適用されていません。","modelLabel": "モデル",diff --git a/apps/desktop/src/renderer/i18n/locales/ko/common.json b/apps/desktop/src/renderer/i18n/locales/ko/common.jsonindex 2710291782..db7da223dc 100644--- a/apps/desktop/src/renderer/i18n/locales/ko/common.json+++ b/apps/desktop/src/renderer/i18n/locales/ko/common.json@@ -7723,8 +7723,41 @@"restarted": "다시 시작했습니다. 메시지를 보내 계속하세요."},"backToChat": "채팅으로 돌아가기",- "memoryRecovery": {- "action": "메모리 다시 켜기"+ "memory": {+ "title": "메모리",+ "enabled": "메모리 사용",+ "disabledHint": "꺼져 있어 메모리를 읽거나 저장하지 않습니다",+ "search": "메모리 검색",+ "empty": "아직 메모리가 없습니다",+ "noResults": "일치하는 메모리가 없습니다",+ "loadFailed": "메모리를 불러오지 못했습니다",+ "types": {+ "user": "나에 대해",+ "feedback": "요청 사항",+ "project": "프로젝트",+ "reference": "참고"+ },+ "today": "오늘",+ "updated": "{{time}} 업데이트",+ "edit": "편집",+ "delete": "삭제",+ "cancel": "취소",+ "done": "완료",+ "titleLabel": "제목",+ "bodyLabel": "내용",+ "tooLong": "너무 깁니다. 줄이면 저장됩니다",+ "deleteTitle": "이 메모리를 삭제할까요?",+ "deleteDescription": "{{name}}은(는) 앞으로 “{{title}}”을(를) 참고하지 않습니다.",+ "deleted": "삭제됨",+ "deleteFailed": "삭제하지 못했습니다",+ "changedTitle": "{{name}}이(가) 방금 이 메모리를 업데이트했습니다",+ "useLatest": "최신 내용 사용",+ "keepMine": "내 변경 유지",+ "saveFailed": "저장하지 못했습니다",+ "unsavedTitle": "저장하지 않은 변경 사항",+ "unsavedDescription": "나가면 이 메모리에 대한 변경 사항이 삭제됩니다.",+ "discard": "변경 사항 버리기",+ "continueEditing": "계속 편집"},"profileSaveFailed": "동료 설정을 저장하지 못했습니다. 변경 사항은 적용되지 않았습니다.","modelLabel": "모델",diff --git a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.jsonindex 9482302cf5..2ec17c81d3 100644--- a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json+++ b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json@@ -7723,8 +7723,41 @@"restarted": "已重启,发送消息即可继续。"},"backToChat": "返回对话",- "memoryRecovery": {- "action": "重新开启记忆"+ "memory": {+ "title": "记忆",+ "enabled": "开启记忆",+ "disabledHint": "已关闭,不会读取或保存记忆",+ "search": "搜索记忆",+ "empty": "还没有记忆",+ "noResults": "没有找到相关记忆",+ "loadFailed": "记忆读取失败",+ "types": {+ "user": "关于你",+ "feedback": "你的要求",+ "project": "项目",+ "reference": "参考"+ },+ "today": "今天",+ "updated": "{{time}} 更新",+ "edit": "编辑",+ "delete": "删除",+ "cancel": "取消",+ "done": "完成",+ "titleLabel": "标题",+ "bodyLabel": "内容",+ "tooLong": "内容太长,缩短后才会保存",+ "deleteTitle": "删除这条记忆?",+ "deleteDescription": "{{name}}之后不会再参考「{{title}}」。",+ "deleted": "已删除",+ "deleteFailed": "删除失败",+ "changedTitle": "{{name}}刚更新了这条记忆",+ "useLatest": "用最新内容",+ "keepMine": "保留我的修改",+ "saveFailed": "没有保存成功",+ "unsavedTitle": "尚有未保存的修改",+ "unsavedDescription": "离开后会丢弃这次对记忆的修改。",+ "discard": "放弃修改",+ "continueEditing": "继续编辑"},"profileSaveFailed": "伙伴设置未能保存,变更没有生效。","modelLabel": "模型",diff --git a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.jsonindex 625c2722b1..003e64a56c 100644--- a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json+++ b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json@@ -7723,8 +7723,41 @@"restarted": "已重新啟動,傳送訊息即可繼續。"},"backToChat": "返回對話",- "memoryRecovery": {- "action": "重新開啟記憶"+ "memory": {+ "title": "記憶",+ "enabled": "開啟記憶",+ "disabledHint": "已關閉,不會讀取或儲存記憶",+ "search": "搜尋記憶",+ "empty": "還沒有記憶",+ "noResults": "找不到相關記憶",+ "loadFailed": "無法讀取記憶",+ "types": {+ "user": "關於你",+ "feedback": "你的要求",+ "project": "專案",+ "reference": "參考"+ },+ "today": "今天",+ "updated": "{{time}} 更新",+ "edit": "編輯",+ "delete": "刪除",+ "cancel": "取消",+ "done": "完成",+ "titleLabel": "標題",+ "bodyLabel": "內容",+ "tooLong": "內容太長,縮短後才會儲存",+ "deleteTitle": "刪除這條記憶?",+ "deleteDescription": "{{name}}之後不會再參考「{{title}}」。",+ "deleted": "已刪除",+ "deleteFailed": "刪除失敗",+ "changedTitle": "{{name}}剛更新了這條記憶",+ "useLatest": "使用最新內容",+ "keepMine": "保留我的修改",+ "saveFailed": "沒有儲存成功",+ "unsavedTitle": "尚有未儲存的修改",+ "unsavedDescription": "離開後會捨棄這次對記憶的修改。",+ "discard": "捨棄修改",+ "continueEditing": "繼續編輯"},"profileSaveFailed": "夥伴設定未能儲存,變更沒有生效。","modelLabel": "模型",diff --git a/apps/desktop/src/renderer/vite-env.d.ts b/apps/desktop/src/renderer/vite-env.d.tsindex a39a58a4bb..867841adf8 100644--- a/apps/desktop/src/renderer/vite-env.d.ts+++ b/apps/desktop/src/renderer/vite-env.d.ts@@ -4756,6 +4756,20 @@ interface ElectronAPI {session: import('@/lib/ccAgent.types').Session;}>;history: (botId: string) => Promise<unknown[]>;+ memory: {+ list: (+ botId: string,+ query?: string,+ ) => Promise<import('../shared/botMemory').BotMemorySummary[]>;+ read: (+ botId: string,+ filename: string,+ ) => Promise<import('../shared/botMemory').BotMemoryDetail>;+ update: (+ body: import('../shared/botMemory').BotMemoryUpdateInput,+ ) => Promise<import('../shared/botMemory').BotMemoryDetail>;+ delete: (body: import('../shared/botMemory').BotMemoryDeleteInput) => Promise<void>;+ };};conversations: {search: (diff --git a/apps/desktop/src/shared/botMemory.ts b/apps/desktop/src/shared/botMemory.tsnew file mode 100644index 0000000000..e7069c95bb--- /dev/null+++ b/apps/desktop/src/shared/botMemory.ts@@ -0,0 +1,55 @@+/**+ * 伙伴记忆页的跨进程线型(main / preload / renderer 共用一份)。+ *+ * 磁盘事实在 Bot Home 的 `memories/`,由 maker-core 的 MakerMemoryStore 维护+ * (文件 + MEMORY.md 索引 + FTS)。这里只放设置页要的字段:不含绝对路径,也不含+ * 摘要(description)——摘要是给模型看的目录钩子,界面不展示,由 main 在保存时维护。+ */++/** 设置页展示的四类。Pi 压缩沉淀的 `digest` 是系统内部类型,不进这里。 */+export const BOT_MEMORY_TYPES = ['user', 'feedback', 'project', 'reference'] as const;+export type BotMemoryType = (typeof BOT_MEMORY_TYPES)[number];++/** 与 maker-core DEFAULT_MEMORY_CONFIG 对齐:标题字符数上限、正文字节硬上限。 */+export const BOT_MEMORY_TITLE_MAX = 100;+export const BOT_MEMORY_BODY_MAX_BYTES = 8192;++/** 列表里的一条:正文只带开头一段,够显示两行预览。 */+export interface BotMemorySummary {+ /** `<type>_<slug>.md`,读 / 改 / 删的稳定标识。 */+ filename: string;+ type: BotMemoryType;+ title: string;+ preview: string;+ /** ISO 串;同时是保存 / 删除时的并发比对基准。 */+ updatedAt: string;+}++export interface BotMemoryDetail {+ filename: string;+ type: BotMemoryType;+ title: string;+ body: string;+ updatedAt: string;+}++export interface BotMemoryUpdateInput {+ botId: string;+ filename: string;+ title: string;+ body: string;+ /** 打开编辑时看到的 updatedAt;不一致说明伙伴刚改过,拒绝覆盖。 */+ expectedUpdatedAt: string;+}++export interface BotMemoryDeleteInput {+ botId: string;+ filename: string;+ expectedUpdatedAt: string;+}++/**+ * 「伙伴在你打开之后改过这条」的拒绝原因。走 PRECONDITION_FAILED,message 固定为此值,+ * renderer 据此重新读取并展示最新内容;账号切换等其它前置失败不带它。+ */+export const BOT_MEMORY_CHANGED = 'bot-memory-changed';diff --git a/docs/design-rules/design-inventory.md b/docs/design-rules/design-inventory.mdindex da864b2f21..2cea784926 100644--- a/docs/design-rules/design-inventory.md+++ b/docs/design-rules/design-inventory.md@@ -18,7 +18,7 @@| `desktop.auth.add-account` | desktop | 添加账号 | hash `/add-account`(ProtectedRoute → AddAccountLoginPage) | AddAccountLoginPage | apps/desktop/src/renderer/components/login/AddAccountLoginPage.tsx, apps/desktop/src/renderer/components/login/LoginBrandStage.tsx, apps/desktop/src/renderer/components/login/LoginCaptchaOverlay.tsx, apps/desktop/src/renderer/components/login/LoginControls.tsx, apps/desktop/src/renderer/components/login/LoginPage.tsx, apps/desktop/src/renderer/components/login/loginDesignTokens.ts | 59 | 0 | 20 || `desktop.auth.legacy-migration` | desktop | 首登数据迁移弹窗 | App 顶层挂载 LegacyMigrationDialog(仅主窗;main 检测到旧版 userData 经 `legacy-migration:state` 驱动) | LegacyMigrationDialog | apps/desktop/src/renderer/components/auth/LegacyMigrationDialog.tsx | 8 | 0 | 2 || `desktop.auth.login` | desktop | 登录页 | hash `/login`(GuestRoute → LoginPage) | LoginBrandStage, LoginCaptchaOverlay, LoginControls, LoginPage | apps/desktop/src/renderer/components/login/LoginBrandStage.tsx, apps/desktop/src/renderer/components/login/LoginCaptchaOverlay.tsx, apps/desktop/src/renderer/components/login/LoginControls.tsx, apps/desktop/src/renderer/components/login/LoginPage.tsx, apps/desktop/src/renderer/components/login/loginDesignTokens.ts | 59 | 0 | 20 |-| `desktop.bots` | desktop | 伙伴(列表 / 对话 / 设置 / 历史 / 伙伴私聊) | hash `/bots`、`/bots/list`、`/bots/:botId`、`/bots/roster` 及伙伴当前/历史任务、伙伴私聊路由(BotsFeatureLayout) | BotBasicProfileFields, BotCollaborationCard, BotDirectMessageView, BotHistorySessionView, BotLifecycleSettings, BotModelChainEditor, BotRosterView, BotSessionView, BotSettingsDrawer, BotsHomeView, BotsListView, RemoteBotSessionView | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/bots/BotAuthorizationCard.tsx, apps/desktop/src/renderer/features/bots/BotAvatar.tsx, apps/desktop/src/renderer/features/bots/BotBasicProfileFields.tsx, apps/desktop/src/renderer/features/bots/BotCapabilitySettings.tsx, apps/desktop/src/renderer/features/bots/BotCollaborationCard.tsx, apps/desktop/src/renderer/features/bots/BotConnectionStatus.tsx, apps/desktop/src/renderer/features/bots/BotCreateMenu.tsx, apps/desktop/src/renderer/features/bots/BotDeleteDialog.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageCard.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageView.tsx, apps/desktop/src/renderer/features/bots/BotGenerationLabel.tsx, apps/desktop/src/renderer/features/bots/BotHistorySessionView.tsx, apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx, apps/desktop/src/renderer/features/bots/BotLifecycleSettings.tsx, apps/desktop/src/renderer/features/bots/BotModelChainEditor.tsx, apps/desktop/src/renderer/features/bots/BotPortraitPicker.tsx, apps/desktop/src/renderer/features/bots/BotRosterView.tsx, apps/desktop/src/renderer/features/bots/BotRoutines.tsx, apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsx, apps/desktop/src/renderer/features/bots/BotSessionView.tsx, apps/desktop/src/renderer/features/bots/BotSettingsBlock.tsx, apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotWorkingStatus.tsx, apps/desktop/src/renderer/features/bots/BotsFeatureLayout.tsx, apps/desktop/src/renderer/features/bots/BotsGlobalSettingsSection.tsx, apps/desktop/src/renderer/features/bots/BotsHomeView.tsx, apps/desktop/src/renderer/features/bots/BotsListView.tsx, apps/desktop/src/renderer/features/bots/BotsSidebar.tsx, apps/desktop/src/renderer/features/bots/CindyDevicePicker.tsx, apps/desktop/src/renderer/features/bots/CindyDeviceRow.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSessionView.tsx, apps/desktop/src/renderer/features/bots/botAvatarIdentity.ts, apps/desktop/src/renderer/features/bots/botCapabilityDefaults.ts, apps/desktop/src/renderer/features/bots/botChatPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationTimeline.ts, apps/desktop/src/renderer/features/bots/botDelegationLive.ts, apps/desktop/src/renderer/features/bots/botGeneratedArtifacts.ts, apps/desktop/src/renderer/features/bots/botListDisplay.ts, apps/desktop/src/renderer/features/bots/botNavigation.ts, apps/desktop/src/renderer/features/bots/botPronounContext.tsx, apps/desktop/src/renderer/features/bots/botReadState.ts, apps/desktop/src/renderer/features/bots/botRosterDisplay.ts, apps/desktop/src/renderer/features/bots/botSessionOwners.ts, apps/desktop/src/renderer/features/bots/botSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/botStore.ts, apps/desktop/src/renderer/features/bots/botWelcomeContext.ts, apps/desktop/src/renderer/features/bots/cindyDeviceRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotRoster.ts, apps/desktop/src/renderer/features/bots/useBotGeneratedFileDeliveries.ts, apps/desktop/src/renderer/features/bots/useBotIslandVisibleSession.ts, apps/desktop/src/renderer/features/bots/useBotSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/useRemoteBots.ts, apps/desktop/src/renderer/features/bots/useWorkingStatusCopy.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 276 | 43 | 438 |+| `desktop.bots` | desktop | 伙伴(列表 / 对话 / 设置 / 历史 / 伙伴私聊) | hash `/bots`、`/bots/list`、`/bots/:botId`、`/bots/roster` 及伙伴当前/历史任务、伙伴私聊路由(BotsFeatureLayout) | BotBasicProfileFields, BotCollaborationCard, BotDirectMessageView, BotHistorySessionView, BotLifecycleSettings, BotModelChainEditor, BotRosterView, BotSessionView, BotSettingsDrawer, BotsHomeView, BotsListView, RemoteBotSessionView | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/bots/BotAuthorizationCard.tsx, apps/desktop/src/renderer/features/bots/BotAvatar.tsx, apps/desktop/src/renderer/features/bots/BotBasicProfileFields.tsx, apps/desktop/src/renderer/features/bots/BotCapabilitySettings.tsx, apps/desktop/src/renderer/features/bots/BotCollaborationCard.tsx, apps/desktop/src/renderer/features/bots/BotConnectionStatus.tsx, apps/desktop/src/renderer/features/bots/BotCreateMenu.tsx, apps/desktop/src/renderer/features/bots/BotDeleteDialog.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageCard.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageView.tsx, apps/desktop/src/renderer/features/bots/BotGenerationLabel.tsx, apps/desktop/src/renderer/features/bots/BotHistorySessionView.tsx, apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx, apps/desktop/src/renderer/features/bots/BotLifecycleSettings.tsx, apps/desktop/src/renderer/features/bots/BotMemorySettings.tsx, apps/desktop/src/renderer/features/bots/BotModelChainEditor.tsx, apps/desktop/src/renderer/features/bots/BotPortraitPicker.tsx, apps/desktop/src/renderer/features/bots/BotRosterView.tsx, apps/desktop/src/renderer/features/bots/BotRoutines.tsx, apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsx, apps/desktop/src/renderer/features/bots/BotSessionView.tsx, apps/desktop/src/renderer/features/bots/BotSettingsBlock.tsx, apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotWorkingStatus.tsx, apps/desktop/src/renderer/features/bots/BotsFeatureLayout.tsx, apps/desktop/src/renderer/features/bots/BotsGlobalSettingsSection.tsx, apps/desktop/src/renderer/features/bots/BotsHomeView.tsx, apps/desktop/src/renderer/features/bots/BotsListView.tsx, apps/desktop/src/renderer/features/bots/BotsSidebar.tsx, apps/desktop/src/renderer/features/bots/CindyDevicePicker.tsx, apps/desktop/src/renderer/features/bots/CindyDeviceRow.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSessionView.tsx, apps/desktop/src/renderer/features/bots/botAvatarIdentity.ts, apps/desktop/src/renderer/features/bots/botCapabilityDefaults.ts, apps/desktop/src/renderer/features/bots/botChatPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationTimeline.ts, apps/desktop/src/renderer/features/bots/botDelegationLive.ts, apps/desktop/src/renderer/features/bots/botGeneratedArtifacts.ts, apps/desktop/src/renderer/features/bots/botListDisplay.ts, apps/desktop/src/renderer/features/bots/botNavigation.ts, apps/desktop/src/renderer/features/bots/botPronounContext.tsx, apps/desktop/src/renderer/features/bots/botReadState.ts, apps/desktop/src/renderer/features/bots/botRosterDisplay.ts, apps/desktop/src/renderer/features/bots/botSessionOwners.ts, apps/desktop/src/renderer/features/bots/botSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/botStore.ts, apps/desktop/src/renderer/features/bots/botWelcomeContext.ts, apps/desktop/src/renderer/features/bots/cindyDeviceRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotRoster.ts, apps/desktop/src/renderer/features/bots/useBotGeneratedFileDeliveries.ts, apps/desktop/src/renderer/features/bots/useBotIslandVisibleSession.ts, apps/desktop/src/renderer/features/bots/useBotSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/useRemoteBots.ts, apps/desktop/src/renderer/features/bots/useWorkingStatusCopy.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 276 | 43 | 442 || `desktop.chat.files` | desktop | 工作目录文件浏览 | hash `/cc-agent/files/:sessionId`(WorkdirBrowseRoute) | FileBodyView, FileTreeView, WorkdirBrowseRoute | apps/desktop/src/renderer/features/cc-agent/workdir-browse/DocSearchBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/DrawioPreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileBodyView.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileFilterInput.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTabsBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTreeView.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FilterResultList.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/ImagePreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/OpenInSystemActions.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/PdfPreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/SessionTabsBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/UnrenderablePlaceholder.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/WorkdirBrowseRoute.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/WorkdirBrowseSidebar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useChatRailCollapsed.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useChatRailResize.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useConfirmSwitchAwayIfDirty.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useDelayedFlag.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useFileContent.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useFileTree.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useOpenTabs.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useProjectFileList.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useRevealFileInTree.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/activeFileBodyHandle.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/docModeSwitchProjects.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/drawioExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/expandedStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileContentCache.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileIcon.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileMeta.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileScrollStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileSelectionParams.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/filterFiles.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/imageExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/markdownAutosave.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/openTabsStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/pdfExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/selectedFileStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchInput.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchPanel.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchResults.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/hooks/useProjectSearch.ts | 17 | 7 | 62 || `desktop.chat.new-draft` | desktop | 新建任务草稿页 | hash `/cc-agent/new`(NewMakerDraftRoute) | NewMakerDraftRoute | apps/desktop/src/renderer/features/cc-agent/NewMakerDraftRoute.tsx | 15 | 0 | 2 || `desktop.chat.orca-workflow` | desktop | Orca 协同工作台 | hash `/cc-agent/orca/:sessionId`(OrcaWorkflowRoute) | CCAgentSessionView, OrcaSplitView, OrcaWorkerPanel, OrcaWorkflowRoute | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaSplitView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkerPanel.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkflowRoute.tsx | 256 | 43 | 355 |diff --git a/docs/product-rules/cindy-bots-runtime.md b/docs/product-rules/cindy-bots-runtime.mdindex ba86538473..d54845006f 100644--- a/docs/product-rules/cindy-bots-runtime.md+++ b/docs/product-rules/cindy-bots-runtime.md@@ -72,7 +72,7 @@ Cindy Session,以父任务关系回到发起伙伴,但不冒充该伙伴或普通设置不显示“永久 Session”“手动压缩”“自动换 Session”或运行时 fallback 开关。健康、归档和故障信息可以在需要时呈现,但维护动作默认由系统完成。用户只管理伙伴,不管理容器。-伙伴设置采用紧凑的分组列表,右侧抽屉最大宽度 448px,窄于该宽度的可视区域内占满可用宽度;此尺寸只用于伙伴设置,不改变全局设置。头像居中且可更换。伙伴聊天头部只保留姓名/头像与设置入口,不显示独立的例行任务图标;例行任务从伙伴设置内管理。资料、性格、模型、能力、自动化任务、历史检索和高级配置在同一抽屉内打开完整内页;返回与关闭前先保存资料,保存失败留在原页。自动化任务复用既有编辑与执行接口,未保存的任务草稿离开前允许继续编辑。模型复用统一选择器,保留来源、Harness、思考深度、Fast 与备用链,不另造默认模型规则。+伙伴设置采用紧凑的分组列表,右侧抽屉最大宽度 448px,窄于该宽度的可视区域内占满可用宽度;此尺寸只用于伙伴设置,不改变全局设置。头像居中且可更换。伙伴聊天头部只保留姓名/头像与设置入口,不显示独立的例行任务图标;例行任务从伙伴设置内管理。资料、性格、记忆、模型、能力、自动化任务、历史检索和高级配置在同一抽屉内打开完整内页;返回与关闭前先保存资料,保存失败留在原页。自动化任务复用既有编辑与执行接口,未保存的任务草稿离开前允许继续编辑。模型复用统一选择器,保留来源、Harness、思考深度、Fast 与备用链,不另造默认模型规则。不提供新的「暂停伙伴」操作;已有暂停状态仍保留恢复入口。设置页与伙伴列表复用同一删除确认,保留任务历史和独立工作树;确认文案必须说明伙伴自身资料、记忆与工作区会被删除。「重启伙伴」直接显示在管理区,不隐藏在高级配置或历史折叠项内。该操作:停止当前主任务运行、取消旧自动续跑,保留同一条主时间线、已存消息、伙伴记忆与文件,以持久交接重建原生上下文。排队输入保留但暂停,@@ -189,6 +189,11 @@ harness + provider + model + effort + fastMode写入前去重,写入后可见、可编辑、可删除;尊重记忆开关和不保存要求,不记流水账或臆造流程。学习在当前轮用当前可用模型完成,不另选学习模型或启动后台 review worker。保存 Skill 后请求主任务在安全轮次边界刷新,不打断运行中的工作或授权卡;同一个聊天继续使用新技能。+ 桌面伙伴设置的「记忆」页承载这一承诺:同页开关记忆(关闭后已存记忆仍可查看、删除);+ 按关于你 / 你的要求 / 项目 / 参考分组列出标题与正文开头,搜索复用记忆检索,内部 `digest` 不展示;+ 详情显示全文,编辑自动保存,单条标题与正文沿用存储上限。改正文时摘要按正文首句确定性刷新,+ 不调用模型。保存与删除前核对打开时的更新时间,伙伴期间改过则不覆盖,由用户选择最新内容或+ 保留自己的修改;改动合并后请求主任务在安全边界刷新记忆目录。手机端记忆列表另行跟进。### 6.1 后台任务与伙伴消息:两条边界,不做混合 actiondiff --git a/packages/maker-core/src/memory/storage.concurrency.test.ts b/packages/maker-core/src/memory/storage.concurrency.test.tsnew file mode 100644index 0000000000..e0dd527045--- /dev/null+++ b/packages/maker-core/src/memory/storage.concurrency.test.ts@@ -0,0 +1,103 @@+import { promises as fs } from 'node:fs';+import os from 'node:os';+import path from 'node:path';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';+import { MemoryStorage } from './storage.js';+import { MakerMemoryStore } from './store.js';+import Database from 'better-sqlite3';+import type { Logger } from '../interfaces/logger.js';++let dir: string;+let storage: MemoryStorage;+const seed = { type: 'user' as const, name: 'preference', title: 'Original', description: 'Original', body: 'Original' };+const filename = 'user_preference.md';++beforeEach(async () => {+ dir = await fs.mkdtemp(path.join(os.tmpdir(), 'cindy-memory-concurrency-'));+ storage = new MemoryStorage(dir);+ await storage.write(seed);+});+afterEach(async () => {+ vi.restoreAllMocks();+ await fs.rm(dir, { recursive: true, force: true });+});++// Pause real file I/O so a competing operation enters the exact read/write window.+function pauseNextRead() {+ let entered!: () => void;+ let release!: () => void;+ const started = new Promise<void>((resolve) => { entered = resolve; });+ const gate = new Promise<void>((resolve) => { release = resolve; });+ const read = fs.readFile.bind(fs);+ vi.spyOn(fs, 'readFile').mockImplementationOnce(async (...args: Parameters<typeof fs.readFile>) => {+ const result = await read(...args);+ entered();+ await gate;+ return result;+ });+ return { started, release };+}++describe('conditional memory mutations', () => {+ it.each(['update', 'delete'] as const)('rejects stale %s after an in-flight tool write, across storage instances', async (operation) => {+ const opened = await storage.read(filename);+ const pause = pauseNextRead();+ const toolWrite = storage.write({ ...seed, mode: 'update', body: 'Teammate update' });+ await pause.started;+ const editor = new MemoryStorage(dir);+ const mutation = operation === 'update'+ ? editor.update(filename, opened.frontmatter.updatedAt, { title: 'Mine', description: 'Mine', body: 'Mine' })+ : editor.delete(filename, opened.frontmatter.updatedAt);+ const rejected = expect(mutation).rejects.toMatchObject({ code: 'version-conflict' });+ pause.release();+ await toolWrite;+ await rejected;+ expect((await storage.read(filename)).body).toBe('Teammate update');+ });++ it('keeps tool writes outside an editor version-check/write window', async () => {+ const opened = await storage.read(filename);+ const pause = pauseNextRead();+ const edit = storage.update(filename, opened.frontmatter.updatedAt, { title: 'Mine', description: 'Mine', body: 'Mine' });+ await pause.started;+ const toolWrite = storage.write({ ...seed, mode: 'update', body: 'Later teammate update' });+ pause.release();+ const [saved] = await Promise.all([edit, toolWrite]);+ expect(saved.body).toBe('Mine');+ expect((await storage.read(filename)).body).toBe('Later teammate update');+ });++ it('changes the version even when consecutive writes have the same clock time', async () => {+ const opened = await storage.read(filename);+ vi.spyOn(Date, 'now').mockReturnValue(Date.parse(opened.frontmatter.updatedAt));+ await storage.write({ ...seed, mode: 'update', body: 'Changed' });+ expect((await storage.read(filename)).frontmatter.updatedAt).not.toBe(opened.frontmatter.updatedAt);+ await expect(storage.delete(filename, opened.frontmatter.updatedAt)).rejects.toMatchObject({ code: 'version-conflict' });+ });++ it('keeps the real store index and FTS synchronized after editing and deleting a legacy file', async () => {+ const legacy = 'user_user_preference.md';+ await fs.copyFile(path.join(dir, filename), path.join(dir, legacy));+ const db = new Database(':memory:');+ const logger: Logger = { trace() {}, debug() {}, info() {}, warn() {}, error() {}, fatal() {}, child() { return logger; } };+ const store = new MakerMemoryStore({ storageDir: dir, absWorkdir: dir, db, logger });+ try {+ const opened = await store.read(legacy);+ const saved = await store.update(legacy, opened.frontmatter.updatedAt, { title: 'New title', description: 'New summary', body: 'uniquememorykeyword' });+ expect(saved.body).toBe('uniquememorykeyword');+ expect(await store.search('uniquememorykeyword')).toEqual([expect.objectContaining({ filename: legacy })]);+ expect(await store.getIndex()).toContain(`[${legacy}] New title`);+ await store.delete(legacy, saved.frontmatter.updatedAt);+ expect(await store.search('uniquememorykeyword')).toEqual([]);+ expect((await store.read(filename)).body).toBe('Original');+ } finally {+ db.close();+ }+ });++ it('releases the queue after a rejected mutation', async () => {+ await expect(storage.update(filename, 'stale', seed)).rejects.toMatchObject({ code: 'version-conflict' });+ await storage.write({ ...seed, mode: 'update', body: 'Recovered' });+ expect((await storage.read(filename)).body).toBe('Recovered');+ });+});diff --git a/packages/maker-core/src/memory/storage.ts b/packages/maker-core/src/memory/storage.tsindex bdbf46af9d..5aac3a7b49 100644--- a/packages/maker-core/src/memory/storage.ts+++ b/packages/maker-core/src/memory/storage.ts@@ -15,8 +15,8 @@* 返给调用方 (size 接近上限, 提示 LLM consolidate)。** 时序:- * fs 操作不加锁 — 同一 workdir 下多 session 并发写概率极低, 真撞了 OS 文件 lock 兜底,- * 最坏情况 MEMORY.md 短暂不一致, rebuildIndex 幂等可恢复。要 ACID 加 SQLite 太重。+ * 同一宿主进程内按目录串行写入与删除,界面版本检查和伙伴工具写入共享互斥。+ * 不宣称保护外部编辑器或其它进程直接修改文件。*/import { createHash } from 'node:crypto';@@ -43,6 +43,9 @@ const META_FILENAME = 'meta.json';const SHARD_EXT = '.md';const SLUG_REGEX = /^[a-z0-9_-]+$/;+// Multiple store instances for the same directory must share the mutation queue.+const mutationQueues = new Map<string, Promise<unknown>>();+/*** 把 workdir 绝对路径转成 sanitize 后的目录名 (Claude Code 风格)。* E:\AIWork\xdt-maker → 'E--AIWork-xdt-maker'@@ -301,7 +304,47 @@ export class MemoryStorage {*/async write(opts: WriteOptions): Promise<WriteResult> {this.validateOpts(opts);- const filename = buildFilename(opts.type, opts.name);+ return this.mutate(() => this.writeFile(opts, buildFilename(opts.type, opts.name)));+ }++ /** Edit a known file in place, including legacy names rejected for new shards. */+ async update(+ filename: string,+ expectedUpdatedAt: string,+ changes: Pick<WriteOptions, 'title' | 'description' | 'body'>,+ ): Promise<MemoryRecord> {+ return this.mutate(async () => {+ const current = await this.checkVersion(filename, expectedUpdatedAt);+ await this.writeFile({+ ...changes, type: current.frontmatter.type, name: current.slug, mode: 'update',+ }, filename);+ // Return the revision this edit wrote, never a subsequent tool write.+ return this.read(filename);+ });+ }++ private async mutate<T>(run: () => Promise<T>): Promise<T> {+ const key = path.resolve(this.dir);+ const previous = mutationQueues.get(key) ?? Promise.resolve();+ const next = previous.catch(() => {}).then(run);+ mutationQueues.set(key, next);+ try {+ return await next;+ } finally {+ if (mutationQueues.get(key) === next) mutationQueues.delete(key);+ }+ }++ private async checkVersion(filename: string, expected: string): Promise<MemoryRecord> {+ const current = await this.read(filename);+ if (current.frontmatter.updatedAt !== expected) {+ throw new MemoryError('version-conflict', 'Memory changed since it was opened');+ }+ return current;+ }++ private async writeFile(opts: WriteOptions, filename: string): Promise<WriteResult> {+ this.validateOpts(opts);const fullPath = path.join(this.dir, filename);let nextBody = opts.body;@@ -334,7 +377,8 @@ export class MemoryStorage {title: opts.title || parsed.frontmatter.title,description: opts.description || parsed.frontmatter.description,type: opts.type,- updatedAt: new Date().toISOString(),+ // A second write in the same millisecond must still invalidate old editors.+ updatedAt: new Date(Math.max(Date.now(), (Date.parse(parsed.frontmatter.updatedAt) || 0) + 1)).toISOString(),};}@@ -368,7 +412,14 @@ export class MemoryStorage {return result;}- async delete(filename: string): Promise<void> {+ async delete(filename: string, expectedUpdatedAt?: string): Promise<void> {+ return this.mutate(async () => {+ if (expectedUpdatedAt !== undefined) await this.checkVersion(filename, expectedUpdatedAt);+ await this.deleteFile(filename);+ });+ }++ private async deleteFile(filename: string): Promise<void> {this.assertSafeFilename(filename);const fullPath = path.join(this.dir, filename);// 删除前复核 (review #2388 Codex 14th P1): 单次预检只保护 delete 开始瞬间,diff --git a/packages/maker-core/src/memory/store.ts b/packages/maker-core/src/memory/store.tsindex bec6b0e1cb..4ed9a4df96 100644--- a/packages/maker-core/src/memory/store.ts+++ b/packages/maker-core/src/memory/store.ts@@ -14,7 +14,7 @@** 跨 session 一致性:* 本类是 per-workdir 单例 (manager 实例池保证), 同一 workdir 内多 session 共享同一个 store,- * 内存里没有缓存的脏状态; 文件系统级别多 session 写撞到 OS 锁是小概率, rebuild 兜底。+ * storage 按目录串行变更,界面条件更新/删除与伙伴工具写入共享同一互斥。*/import type Database from 'better-sqlite3';@@ -174,7 +174,23 @@ export class MakerMemoryStore {async write(opts: WriteOptions): Promise<WriteResult> {this.assertScopeOk();await this.init();- const result = await this.storage.write(opts);+ return this.syncWrite(await this.storage.write(opts));+ }++ /** Conditional in-place edit; retains legacy filenames and uses the shared storage queue. */+ async update(+ filename: string,+ expectedUpdatedAt: string,+ changes: Pick<WriteOptions, 'title' | 'description' | 'body'>,+ ): Promise<MemoryRecord> {+ this.assertScopeOk();+ await this.init();+ const saved = await this.storage.update(filename, expectedUpdatedAt, changes);+ await this.syncWrite({ ok: true, filename });+ return saved;+ }++ private async syncWrite(result: WriteResult): Promise<WriteResult> {// storage await 后、FTS 同步前复核 (review #2388 Codex 15th P1): 边界不得// 让 manager.write 直接路径 (Pi compaction) 改旧 owner 的 fts.db。this.assertScopeOk();@@ -195,10 +211,10 @@ export class MakerMemoryStore {return result;}- async delete(filename: string): Promise<void> {+ async delete(filename: string, expectedUpdatedAt?: string): Promise<void> {this.assertScopeOk();await this.init();- await this.storage.delete(filename);+ await this.storage.delete(filename, expectedUpdatedAt);// storage await 后、FTS 同步前复核 (review #2388 Codex 15th P1)this.assertScopeOk();try {diff --git a/packages/maker-core/src/memory/types.ts b/packages/maker-core/src/memory/types.tsindex 85c7126062..90bfed6a67 100644--- a/packages/maker-core/src/memory/types.ts+++ b/packages/maker-core/src/memory/types.ts@@ -139,6 +139,7 @@ export type MemoryErrorCode =| 'description-too-long'| 'title-too-long'| 'description-has-newline'+ | 'version-conflict'| 'already-exists'| 'not-found'| 'path-traversal'