Skip to content

armgit / cindy

Public Imported from GitHub
0

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

feat(bots): 伙伴设置新增记忆页,可查看、编辑与删除记忆 (#4971)

Chris Zhanga77d5c321bec
diff --git a/apps/desktop/src/main/localDb/ipc/bots.ts b/apps/desktop/src/main/localDb/ipc/bots.ts
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
index 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.tsx
new file mode 100644
index 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.tsx
index 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">
<button
type="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.tsx
new file mode 100644
index 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.tsx
index 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.json
index 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.json
index 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.json
index 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.json
index 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.json
index 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.ts
index 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.ts
new file mode 100644
index 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.md
index 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.md
index 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 后台任务与伙伴消息:两条边界,不做混合 action
diff --git a/packages/maker-core/src/memory/storage.concurrency.test.ts b/packages/maker-core/src/memory/storage.concurrency.test.ts
new file mode 100644
index 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.ts
index 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.ts
index 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.ts
index 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'