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): 伙伴主任务拥有完整 session 能力,按本轮来源分档判定 (#5354)

Chris Zhang3c6daddf6715
diff --git a/apps/desktop/src/main/localDb/__tests__/botHistoryScope.test.ts b/apps/desktop/src/main/localDb/__tests__/botHistoryScope.test.ts
new file mode 100644
index 0000000000..4f1aad9d51
--- /dev/null
+++ b/apps/desktop/src/main/localDb/__tests__/botHistoryScope.test.ts
@@ -0,0 +1,37 @@
+import Database from 'better-sqlite3';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+const h = vi.hoisted(() => ({ sqlite: null as Database.Database | null }));
+
+vi.mock('../client/current.js', () => ({
+ getDbClient: () => ({
+ queryOne: async <T,>(sql: string, args: unknown[] = []) => h.sqlite!.prepare(sql).get(...args) as T | undefined,
+ query: async <T,>(sql: string, args: unknown[] = []) => h.sqlite!.prepare(sql).all(...args) as T[],
+ }),
+}));
+
+import { resolveBotHistorySessionIds } from '../botHistoryScope.js';
+
+beforeEach(() => {
+ h.sqlite = new Database(':memory:');
+ h.sqlite.exec(`
+ CREATE TABLE sessions (id TEXT PRIMARY KEY, source TEXT);
+ CREATE TABLE bot_session_links (session_id TEXT, bot_id TEXT, created_at INTEGER);
+ CREATE TABLE bot_delegations (requesting_bot_id TEXT, child_session_id TEXT, created_at INTEGER);
+ INSERT INTO sessions VALUES ('bot-main', 'bot'), ('owner-task', 'desktop'), ('child-1', 'desktop');
+ INSERT INTO bot_session_links VALUES ('bot-main', 'bot-1', 1), ('other-bot-main', 'bot-2', 2);
+ INSERT INTO bot_delegations VALUES ('bot-1', 'child-1', 3), ('bot-1', NULL, 4), ('bot-2', 'child-2', 5);
+ `);
+});
+afterEach(() => h.sqlite?.close());
+
+describe('resolveBotHistorySessionIds', () => {
+ it('scopes a Bot to its own sessions plus the background tasks it started', async () => {
+ expect(await resolveBotHistorySessionIds('bot-main', undefined)).toEqual(['child-1', 'bot-main']);
+ });
+
+ it('leaves ordinary tasks unscoped and fails closed for unknown callers', async () => {
+ expect(await resolveBotHistorySessionIds('owner-task', undefined)).toBeNull();
+ expect(await resolveBotHistorySessionIds('missing', undefined)).toEqual([]);
+ });
+});
diff --git a/apps/desktop/src/main/localDb/__tests__/taskTags.test.ts b/apps/desktop/src/main/localDb/__tests__/taskTags.test.ts
index 1eb1384e99..211aa29b77 100644
--- a/apps/desktop/src/main/localDb/__tests__/taskTags.test.ts
+++ b/apps/desktop/src/main/localDb/__tests__/taskTags.test.ts
@@ -166,6 +166,17 @@ describe('task labels transactions', () => {
db.exec("INSERT INTO bot_session_links VALUES('a')");
expect(() => run({ action: 'list', callerSessionId: 'a' })).toThrow('NOT_FOUND');
});
+ it('accepts a trusted Bot caller only from an active canonical Bot main task', () => {
+ db.exec(
+ "ALTER TABLE bot_session_links ADD COLUMN role TEXT; ALTER TABLE bot_session_links ADD COLUMN archived_at INTEGER;"
+ + " INSERT INTO sessions(id,source) VALUES('bot-main','bot'),('bot-lane','bot');"
+ + " INSERT INTO bot_session_links(session_id,role) VALUES('bot-main','canonical'),('bot-lane','group');",
+ );
+ expect(() => run({ action: 'list', callerSessionId: 'bot-main' })).toThrow('NOT_FOUND');
+ expect(run({ action: 'list', callerSessionId: 'bot-main', callerIsTrustedBot: true }).tags.length).toBeGreaterThan(0);
+ expect(() => run({ action: 'list', callerSessionId: 'bot-lane', callerIsTrustedBot: true })).toThrow('NOT_FOUND');
+ expect(() => run({ action: 'list', callerSessionId: 'a', callerIsTrustedBot: true })).toThrow('NOT_FOUND');
+ });
it('persists order across edits and projects it onto task associations', () => {
const expectedOrder = run({ action: 'list' }).tags.map((t) => t.id);
const tagIds = [...expectedOrder].reverse();
diff --git a/apps/desktop/src/main/localDb/botHistoryScope.ts b/apps/desktop/src/main/localDb/botHistoryScope.ts
index fd6f495c5c..c10af9632d 100644
--- a/apps/desktop/src/main/localDb/botHistoryScope.ts
+++ b/apps/desktop/src/main/localDb/botHistoryScope.ts
@@ -45,14 +45,22 @@ export async function resolveBotHistorySessionIds(
const scope = await resolveBotHistoryScope(callerSessionId, callerMemoryScopeKey);
if (scope.kind === 'unscoped') return null;
if (scope.kind === 'denied') return [];
+ // The Bot's own sessions plus the background tasks it started (ordinary
+ // `desktop` sessions without a bot_session_links row).
const rows = await getDbClient().query<{ sessionId: string }>(
- `SELECT session_id AS sessionId
- FROM bot_session_links
- WHERE bot_id = ?
- ORDER BY created_at DESC`,
- [scope.botId],
+ `SELECT sessionId FROM (
+ SELECT session_id AS sessionId, created_at AS createdAt
+ FROM bot_session_links
+ WHERE bot_id = ?
+ UNION
+ SELECT child_session_id AS sessionId, created_at AS createdAt
+ FROM bot_delegations
+ WHERE requesting_bot_id = ? AND child_session_id IS NOT NULL
+ )
+ ORDER BY createdAt DESC`,
+ [scope.botId, scope.botId],
);
- return rows.map((row) => row.sessionId);
+ return [...new Set(rows.map((row) => row.sessionId))];
}
/**
diff --git a/apps/desktop/src/main/localDb/ipc/__tests__/botCanonicalSession.test.ts b/apps/desktop/src/main/localDb/ipc/__tests__/botCanonicalSession.test.ts
index 04d5cfe216..2cac404782 100644
--- a/apps/desktop/src/main/localDb/ipc/__tests__/botCanonicalSession.test.ts
+++ b/apps/desktop/src/main/localDb/ipc/__tests__/botCanonicalSession.test.ts
@@ -2698,6 +2698,18 @@ describe('Bot canonical Session lifecycle', () => {
expect(opts.botRuntimeProfile?.mcpPolicy.configured).toContain(server);
});
+ it('mounts the baseline scheduler MCP for a local Bot without the toolset being selected', async () => {
+ const created = await invoke('local-db:bots:create-canonical-session', { botId: 'bot-1', expectedCanonicalSessionId: null, expectedProfileVersion: 1 });
+ const opts: MakerSessionCreateOpts = { id: created.session.id, agentKind: 'claude-code', workingDir: created.session.workingDir, workspaceKind: 'dialogue', model: 'test-model', permissionMode: 'auto' };
+ await hydrateBotProfileRuntime(opts, {
+ listMcpServers: async () => [{ name: 'cindy_scheduler', source: 'builtin', available: true }],
+ listToolsets: async () => [{ id: 'scheduler', name: 'Scheduler', essential: true, available: true }],
+ });
+ expect(opts.botRuntimeProfile?.mcpPolicy.configured).toContain('cindy_scheduler');
+ expect(opts.botProfileContextPrompt).toContain('你能建普通自动化');
+ expect(opts.botProfileContextPrompt).toContain('你能看、能管主人的任务');
+ });
+
it('refreshes canonical MCP generations and Toolset versions in place', async () => {
await invoke('local-db:bots:update', {
id: 'bot-1',
diff --git a/apps/desktop/src/main/localDb/ipc/bots.ts b/apps/desktop/src/main/localDb/ipc/bots.ts
index 38eba34d95..4ddf1e6e90 100644
--- a/apps/desktop/src/main/localDb/ipc/bots.ts
+++ b/apps/desktop/src/main/localDb/ipc/bots.ts
@@ -64,6 +64,7 @@ import {
addBotWorkbenchDirectory,
broadcastBotWorkbenchChanged,
readBotWorkbench,
+ readBotWorkbenchDirectoryPaths,
removeBotWorkbenchDirectory,
} from '../../maker-ipc/botWorkbenchService.js';
import {
@@ -2114,6 +2115,22 @@ export function registerBotIpc(): void {
if (result.ok) broadcastBotWorkbenchChanged(botId);
return result;
});
+ // 侧栏「<伙伴>在跟进」:每个在用的本机伙伴接手了哪些项目。只给路径列表,不做文件系统探测,
+ // 也不带判断与会话内容;渲染层按任务的工作目录自己匹配。
+ ipcMain.handle('local-db:bots:workbench:follow-scopes', async (event) => {
+ assertTrustedAppRendererEvent(event);
+ const owner = captureBotOperationOwner();
+ const bots = await getDbClient().drizzle
+ .select({ id: botProfiles.id })
+ .from(botProfiles)
+ .where(eq(botProfiles.status, 'active'));
+ const scopes = await Promise.all(bots.map(async (bot) => ({
+ botId: bot.id,
+ directories: await readBotWorkbenchDirectoryPaths(owner.userDataDir, bot.id),
+ })));
+ owner.assertCurrent();
+ return scopes.filter((scope) => scope.directories.length > 0);
+ });
// 工作台详情视图:只读一件任务的最近内容(有界)。范围限于该伙伴已接手的项目,
// 外部会话只读转录尾部,不写库、不导入。
ipcMain.handle('local-db:bots:workbench:read-task', async (event, rawBotId: unknown, rawTaskId: unknown) => {
diff --git a/apps/desktop/src/main/localDb/ipc/taskTags.ts b/apps/desktop/src/main/localDb/ipc/taskTags.ts
index e72a141696..0f957f9205 100644
--- a/apps/desktop/src/main/localDb/ipc/taskTags.ts
+++ b/apps/desktop/src/main/localDb/ipc/taskTags.ts
@@ -16,10 +16,16 @@ import { broadcastSessionPatched } from './sessions';
const log = createLogger('taskTags');
export const TASK_TAG_CHANNEL = 'local-db:task-tags:execute';
-/** All surfaces share validation, transactions and owner-scoped task patches. */
+/**
+ * All surfaces share validation, transactions and owner-scoped task patches.
+ * `trustedBotOwnerTurn`: the caller is a Bot main task on its owner's own turn
+ * (decided by the host, maker-ipc/botTurnAuthority.ts); Bot sessions themselves
+ * still cannot be tagged.
+ */
export async function executeTaskTags(
request: TaskTagRequest,
callerSessionId?: string,
+ options: { trustedBotOwnerTurn?: boolean } = {},
): Promise<TaskTagResult> {
const scope = captureDataOwnerBroadcastScope();
const assertCurrent = () => {
@@ -44,6 +50,7 @@ export async function executeTaskTags(
...request,
newId: preset?.id ?? randomUUID(),
callerSessionId,
+ ...(callerSessionId && options.trustedBotOwnerTurn ? { callerIsTrustedBot: true } : {}),
});
assertCurrent();
if (['create', 'update', 'delete', 'attach', 'detach'].includes(request.action)) {
diff --git a/apps/desktop/src/main/localDb/worker/opHandlers/taskTagsTx.ts b/apps/desktop/src/main/localDb/worker/opHandlers/taskTagsTx.ts
index af554150db..a8581bc2eb 100644
--- a/apps/desktop/src/main/localDb/worker/opHandlers/taskTagsTx.ts
+++ b/apps/desktop/src/main/localDb/worker/opHandlers/taskTagsTx.ts
@@ -6,7 +6,7 @@ export function runTaskTagsTransaction(db: Database.Database, raw: unknown): Tas
const fail = (code: string): never => {
throw new Error(`[${code}] Task tag operation failed`);
};
- const body = raw as TaskTagRequest & { newId?: string; callerSessionId?: string };
+ const body = raw as TaskTagRequest & { newId?: string; callerSessionId?: string; callerIsTrustedBot?: boolean };
const text = (value: unknown, max = 128): string => {
if (typeof value !== 'string' || !value.trim() || value.trim().length > max)
return fail('INVALID_PARAMS');
@@ -76,7 +76,17 @@ export function runTaskTagsTransaction(db: Database.Database, raw: unknown): Tas
}));
return db.transaction(() => {
if (!body || typeof body !== 'object') return fail('INVALID_PARAMS');
- if (body.callerSessionId) {
+ if (body.callerSessionId && body.callerIsTrustedBot) {
+ // The host already decided this is a Bot main task on its owner's own turn.
+ if (
+ !db
+ .prepare(
+ "SELECT s.id FROM sessions s JOIN bot_session_links b ON b.session_id=s.id WHERE s.id=? AND s.status='active' AND s.source='bot' AND b.role='canonical' AND b.archived_at IS NULL",
+ )
+ .get(body.callerSessionId)
+ )
+ return fail('NOT_FOUND');
+ } else if (body.callerSessionId) {
if (
!db
.prepare(
diff --git a/apps/desktop/src/main/maker-host/__tests__/sessionSearch.test.ts b/apps/desktop/src/main/maker-host/__tests__/sessionSearch.test.ts
index f1cc0e2b8d..02f6b297ee 100644
--- a/apps/desktop/src/main/maker-host/__tests__/sessionSearch.test.ts
+++ b/apps/desktop/src/main/maker-host/__tests__/sessionSearch.test.ts
@@ -10,7 +10,7 @@ vi.mock('../../localDb/client/current.js', () => ({
getDbClient: mocks.getDbClient,
}));
-import { searchSessionsFn } from '../session-search.js';
+import { searchSessionsFn, searchSessionsWithBotScope } from '../session-search.js';
describe('session_search Bot ownership boundary', () => {
beforeEach(() => {
@@ -31,11 +31,21 @@ describe('session_search Bot ownership boundary', () => {
'bot-session-a',
]);
expect(mocks.query).toHaveBeenCalledWith(
- expect.stringMatching(/FROM\s+bot_session_links scoped/),
- [16_384, '"release"', 'bot-a', 10],
+ expect.stringMatching(/FROM\s+bot_session_links scoped[\s\S]*FROM\s+bot_delegations delegated/),
+ [16_384, '"release"', 'bot-a', 'bot-a', 10],
);
});
+ it('lets the host widen a Bot main task to account history for owner or arranged turns', async () => {
+ mocks.queryOne.mockResolvedValue({ source: 'bot', botId: 'bot-a' });
+
+ await searchSessionsWithBotScope('release', { callerSessionId: 'bot-session-a' }, { botAccountWide: true });
+
+ const [sql, params] = mocks.query.mock.calls[0] as [string, unknown[]];
+ expect(sql).not.toContain('FROM bot_session_links scoped');
+ expect(params).toEqual([16_384, '"release"', 10]);
+ });
+
it('keeps a model-supplied session filter inside the same Bot scope', async () => {
mocks.queryOne.mockResolvedValue({ source: 'bot', botId: 'bot-a' });
@@ -46,7 +56,7 @@ describe('session_search Bot ownership boundary', () => {
expect(mocks.query).toHaveBeenCalledWith(
expect.stringMatching(/m\.session_id = \?[\s\S]*scoped\.bot_id = \?/),
- [16_384, '"release"', 'foreign-session', 'bot-a', 10],
+ [16_384, '"release"', 'foreign-session', 'bot-a', 'bot-a', 10],
);
});
diff --git a/apps/desktop/src/main/maker-host/plugins/__tests__/botBuiltinToolPolicy.test.ts b/apps/desktop/src/main/maker-host/plugins/__tests__/botBuiltinToolPolicy.test.ts
index 926217c783..ef8ab8ba50 100644
--- a/apps/desktop/src/main/maker-host/plugins/__tests__/botBuiltinToolPolicy.test.ts
+++ b/apps/desktop/src/main/maker-host/plugins/__tests__/botBuiltinToolPolicy.test.ts
@@ -12,10 +12,11 @@ describe('Bot built-in tool baseline', () => {
{ id: 'browser', available: false },
];
- it('keeps only memory and the narrow Bot helper by default', () => {
+ it('keeps memory, the Bot helper and automations by default', () => {
expect(resolveBotAllowedBuiltinPluginIds(catalog, [])).toEqual([
'memory',
'xdt_helper',
+ 'scheduler',
]);
});
@@ -23,6 +24,7 @@ describe('Bot built-in tool baseline', () => {
expect(resolveBotAllowedBuiltinPluginIds(catalog, ['docs', 'browser'])).toEqual([
'memory',
'xdt_helper',
+ 'scheduler',
'docs',
]);
});
diff --git a/apps/desktop/src/main/maker-host/plugins/types.ts b/apps/desktop/src/main/maker-host/plugins/types.ts
index b8622e1f50..40e4b365d6 100644
--- a/apps/desktop/src/main/maker-host/plugins/types.ts
+++ b/apps/desktop/src/main/maker-host/plugins/types.ts
@@ -67,10 +67,15 @@ export const ESSENTIAL_PLUGIN_IDS: ReadonlySet<string> = new Set([
'lsp',
]);
-/** Minimal built-ins every Bot needs; ordinary Cindy Sessions keep all essentials. */
+/**
+ * Built-ins every Bot needs; ordinary Cindy Sessions keep all essentials.
+ * `scheduler`: a Bot main task can create ordinary automations on its owner's
+ * own turn (calls are judged per turn, maker-ipc/botTurnAuthority.ts).
+ */
export const BOT_BASELINE_PLUGIN_IDS: ReadonlySet<string> = new Set([
'memory',
'xdt_helper',
+ 'scheduler',
]);
export function resolveBotAllowedBuiltinPluginIds(
diff --git a/apps/desktop/src/main/maker-host/session-search.ts b/apps/desktop/src/main/maker-host/session-search.ts
index c3450a11bd..2d683e8d99 100644
--- a/apps/desktop/src/main/maker-host/session-search.ts
+++ b/apps/desktop/src/main/maker-host/session-search.ts
@@ -34,7 +34,17 @@ const DEFAULT_LIMIT = 10;
export const searchSessionsFn: SessionSearchFn = async (
query: string,
opts: SessionSearchOptions = {},
-): Promise<SessionSearchHit[]> => {
+): Promise<SessionSearchHit[]> => searchSessionsWithBotScope(query, opts, { botAccountWide: false });
+
+/**
+ * `botAccountWide`:宿主已判定这是伙伴主任务里主人本人(或主人事先安排)的一轮,可以搜全部任务。
+ * 其余伙伴调用只搜这个伙伴自己的会话与它开的后台任务。
+ */
+export async function searchSessionsWithBotScope(
+ query: string,
+ opts: SessionSearchOptions,
+ scopeOptions: { botAccountWide: boolean },
+): Promise<SessionSearchHit[]> {
if (!query || query.trim().length === 0) return [];
const limit = Math.max(1, Math.min(opts.limit ?? DEFAULT_LIMIT, 50));
const escapedQuery = buildMessagesFtsMatch(query, 'AND');
@@ -72,16 +82,21 @@ export const searchSessionsFn: SessionSearchFn = async (
sql += ` AND m.session_id = ?`;
params.push(opts.sessionId);
}
- if (callerScope.kind === 'bot') {
+ if (callerScope.kind === 'bot' && !scopeOptions.botAccountWide) {
// Bot ownership is resolved from the current runtime Session. The model can
// optionally narrow within that set, but cannot widen it by supplying an
- // arbitrary sessionId.
+ // arbitrary sessionId. Background tasks the Bot started are its own work too.
sql += ` AND m.session_id IN (
SELECT scoped.session_id
FROM bot_session_links scoped
WHERE scoped.bot_id = ?
+ UNION
+ SELECT delegated.child_session_id
+ FROM bot_delegations delegated
+ WHERE delegated.requesting_bot_id = ?
+ AND delegated.child_session_id IS NOT NULL
)`;
- params.push(callerScope.botId);
+ params.push(callerScope.botId, callerScope.botId);
}
if (opts.role) {
sql += ` AND m.role = ?`;
@@ -113,4 +128,4 @@ export const searchSessionsFn: SessionSearchFn = async (
log.warn('session_search: query failed', { error: msg });
throw e;
}
-};
+}
diff --git a/apps/desktop/src/main/maker-ipc/__tests__/botSystemPrompt.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/botSystemPrompt.test.ts
index d55027ea21..b7ccd682bf 100644
--- a/apps/desktop/src/main/maker-ipc/__tests__/botSystemPrompt.test.ts
+++ b/apps/desktop/src/main/maker-ipc/__tests__/botSystemPrompt.test.ts
@@ -44,6 +44,24 @@ describe('稳定层:能力必须写进提示词', () => {
enabled.capabilities.botModeEnabled = false;
expect(buildBotStableTier(enabled)).not.toContain('routine_save');
});
+ it('只给本机伙伴主任务讲它能管主人的任务,自动化另需挂载', () => {
+ const main = input();
+ main.capabilities.botModeEnabled = true;
+ main.capabilities.sessionControlEnabled = true;
+ const stable = buildBotStableTier(main);
+ expect(stable).toContain('你能看、能管主人的任务');
+ expect(stable).toContain('OWNER_TURN_REQUIRED');
+ expect(stable).toContain('add_workbench_project');
+ expect(stable).not.toContain('你能建普通自动化');
+ main.capabilities.automationEnabled = true;
+ expect(buildBotStableTier(main)).toContain('schedule_create');
+
+ expect(buildBotStableTier(input())).not.toContain('你能看、能管主人的任务');
+ main.capabilities.botModeEnabled = false;
+ expect(buildBotStableTier(main)).not.toContain('你能看、能管主人的任务');
+ expect(buildBotStableTier(main)).not.toContain('schedule_create');
+ });
+
it('挂了 docs 就点名文档工具,并写清 PDF 要自检', () => {
const stable = buildBotStableTier(
input({
diff --git a/apps/desktop/src/main/maker-ipc/__tests__/botTurnAuthority.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/botTurnAuthority.test.ts
new file mode 100644
index 0000000000..4e06ebe32a
--- /dev/null
+++ b/apps/desktop/src/main/maker-ipc/__tests__/botTurnAuthority.test.ts
@@ -0,0 +1,298 @@
+import Database from 'better-sqlite3';
+import { drizzle } from 'drizzle-orm/better-sqlite3';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import type { DbClient } from '../../localDb/client/DbClient.js';
+import { createBotToolCallAuthorizer, resolveBotCallerAuthority } from '../botToolCallAuthorizer.js';
+import {
+ decideBotToolCall,
+ resolveBotTurnAuthority,
+ type BotTurnAuthority,
+ type BotTurnExecution,
+} from '../botTurnAuthority.js';
+
+const OWNER_INPUT: BotTurnExecution = {
+ executing: true,
+ input: { clientId: 'owner-msg', authoredText: '帮我把旧任务都归档' },
+};
+const input = (clientId: string, originKind?: string): BotTurnExecution => ({
+ executing: true,
+ input: { clientId, ...(originKind ? { originKind } : {}) },
+});
+
+describe('decideBotToolCall', () => {
+ it('lets the owner own turn use everything, including tools not registered here', () => {
+ for (const [server, tool] of [
+ ['cindy_helper', 'archive_sessions'],
+ ['cindy_helper', 'some_future_tool'],
+ ['cindy_scheduler', 'schedule_create'],
+ ] as const) {
+ expect(decideBotToolCall(server, tool, {}, 'owner')).toEqual({ kind: 'allow' });
+ }
+ });
+
+ it.each<[string, BotTurnAuthority]>([
+ ['start_session_task', 'other'],
+ ['send_to_agent', 'other'],
+ ['list_sessions', 'other'],
+ ['search_chat_history', 'other'],
+ ['routine_history', 'other'],
+ ['get_workbench', 'arranged'],
+ ['continue_workbench_task', 'arranged'],
+ ['create_project', 'arranged'],
+ ['routine_save', 'arranged'],
+ ['find_teammate_capabilities', 'other'],
+ ])('allows %s in a %s turn', (tool, authority) => {
+ expect(decideBotToolCall('cindy_helper', tool, {}, authority)).toEqual({ kind: 'allow' });
+ });
+
+ it.each<[string, BotTurnAuthority]>([
+ ['add_task_tags', 'arranged'],
+ ['set_app_default_model', 'arranged'],
+ ['add_workbench_project', 'arranged'],
+ ['remove_workbench_project', 'arranged'],
+ ['move_session', 'arranged'],
+ ['some_future_tool', 'arranged'],
+ ['get_workbench', 'other'],
+ ['continue_workbench_task', 'other'],
+ ['routine_save', 'other'],
+ ['create_project', 'other'],
+ ['create_teammate', 'other'],
+ ['create_teammate', 'arranged'],
+ ['set_teammate_capability', 'arranged'],
+ ['update_teammate_profile', 'arranged'],
+ ['update_teammate_profile', 'other'],
+ ['set_teammate_capability', 'other'],
+ ['update_bot_profile', 'other'],
+ ['set_bot_capability', 'other'],
+ ])('keeps %s for the owner in a %s turn', (tool, authority) => {
+ expect(decideBotToolCall('cindy_helper', tool, {}, authority)).toMatchObject({
+ kind: 'deny',
+ errorCode: 'OWNER_TURN_REQUIRED',
+ });
+ });
+
+ it('checks the target of session control by tier, reads freely only when arranged', () => {
+ const args = { session_id: 'task-1' };
+ expect(decideBotToolCall('cindy_helper', 'get_session_runtime', args, 'arranged')).toEqual({ kind: 'allow' });
+ expect(decideBotToolCall('cindy_helper', 'get_session_runtime', args, 'other'))
+ .toEqual({ kind: 'targets', sessionIds: ['task-1'], scope: 'own' });
+ expect(decideBotToolCall('cindy_helper', 'stop_session_turn', args, 'arranged'))
+ .toEqual({ kind: 'targets', sessionIds: ['task-1'], scope: 'own-or-handed' });
+ expect(decideBotToolCall('cindy_helper', 'steer_session', args, 'other'))
+ .toEqual({ kind: 'targets', sessionIds: ['task-1'], scope: 'own' });
+ expect(decideBotToolCall('cindy_helper', 'stop_session_turn', {}, 'other'))
+ .toMatchObject({ kind: 'deny', errorCode: 'INVALID_ARGS' });
+ // Omitted session_id means the caller's own current task.
+ expect(decideBotToolCall('cindy_helper', 'get_session_runtime', {}, 'other')).toEqual({ kind: 'allow' });
+ expect(decideBotToolCall('cindy_helper', 'set_session_runtime', { effort: 'high' }, 'other')).toEqual({ kind: 'allow' });
+ });
+
+ it('checks every target of rename and archive batches by tier', () => {
+ expect(decideBotToolCall('cindy_helper', 'rename_sessions', {
+ changes: [{ session_id: 'a', title: 'x' }, { session_id: 'b', title: 'y' }, { session_id: 'a', title: 'z' }],
+ }, 'arranged')).toEqual({ kind: 'targets', sessionIds: ['a', 'b'], scope: 'own-or-handed' });
+ expect(decideBotToolCall('cindy_helper', 'archive_sessions', { session_ids: ['a'] }, 'other'))
+ .toEqual({ kind: 'targets', sessionIds: ['a'], scope: 'own' });
+ expect(decideBotToolCall('cindy_helper', 'unarchive_sessions', { session_ids: [] }, 'other'))
+ .toMatchObject({ kind: 'deny', errorCode: 'INVALID_ARGS' });
+ expect(decideBotToolCall('cindy_helper', 'rename_sessions', { changes: [{ title: 'x' }] }, 'arranged'))
+ .toMatchObject({ kind: 'deny', errorCode: 'INVALID_ARGS' });
+ });
+
+ it('opens a new ordinary task only on the owner turn, but can message an allowed one', () => {
+ expect(decideBotToolCall('cindy_helper', 'send_to_session', { message: 'go' }, 'arranged'))
+ .toMatchObject({ kind: 'deny', errorCode: 'OWNER_TURN_REQUIRED' });
+ expect(decideBotToolCall('cindy_helper', 'send_to_session', { target_session_id: 't', message: 'go' }, 'arranged'))
+ .toEqual({ kind: 'targets', sessionIds: ['t'], scope: 'own-or-handed' });
+ });
+
+ it('creates or changes automations only on the owner turn', () => {
+ expect(decideBotToolCall('cindy_scheduler', 'schedule_list', {}, 'arranged')).toEqual({ kind: 'allow' });
+ expect(decideBotToolCall('cindy_scheduler', 'schedule_notify_current_run', {}, 'other')).toEqual({ kind: 'allow' });
+ for (const authority of ['arranged', 'other'] as const) {
+ for (const tool of ['schedule_create', 'schedule_update', 'schedule_delete', 'schedule_run_now']) {
+ expect(decideBotToolCall('cindy_scheduler', tool, {}, authority)).toMatchObject({ kind: 'deny' });
+ }
+ }
+ expect(decideBotToolCall('cindy_scheduler', 'schedule_list', {}, 'other')).toMatchObject({ kind: 'deny' });
+ });
+});
+
+let sqlite: Database.Database;
+let db: Pick<DbClient, 'drizzle'>;
+let clock = 1_000;
+
+function message(sessionId: string, clientId: string, meta: object) {
+ sqlite.prepare('INSERT INTO messages (session_id, client_id, role, agent_meta, created_at) VALUES (?, ?, ?, ?, ?)')
+ .run(sessionId, clientId, 'user', JSON.stringify(meta), ++clock);
+}
+function delegation(id: string, parentSessionId: string, childSessionId: string | null = null) {
+ sqlite.prepare('INSERT INTO bot_delegations (id, requesting_bot_id, parent_session_id, child_session_id, created_at) VALUES (?, ?, ?, ?, ?)')
+ .run(id, 'bot-1', parentSessionId, childSessionId, ++clock);
+}
+const ownerMeta = { delivery: 'turn', autoReviewUserText: '帮我把这个项目跑起来' };
+const botDmMeta = { delivery: 'turn', origin: { kind: 'bot-dm' } };
+
+beforeEach(() => {
+ clock = 1_000;
+ sqlite = new Database(':memory:');
+ sqlite.exec(`
+ CREATE TABLE sessions (id TEXT PRIMARY KEY, source TEXT, status TEXT, remote_host_id TEXT, cleared_at INTEGER);
+ CREATE TABLE bot_session_links (id TEXT PRIMARY KEY, bot_id TEXT, session_id TEXT, role TEXT, archived_at INTEGER);
+ CREATE TABLE bot_delegations (id TEXT PRIMARY KEY, requesting_bot_id TEXT, parent_session_id TEXT, child_session_id TEXT, created_at INTEGER);
+ CREATE TABLE messages (session_id TEXT, client_id TEXT, role TEXT, agent_meta TEXT, created_at INTEGER, rewind_at INTEGER);
+ INSERT INTO sessions VALUES ('bot-main', 'bot', 'active', NULL, NULL);
+ INSERT INTO sessions VALUES ('bot-lane', 'bot', 'active', NULL, NULL);
+ INSERT INTO sessions VALUES ('bot-remote', 'bot', 'active', 'ssh-1', NULL);
+ INSERT INTO sessions VALUES ('child-1', 'desktop', 'active', NULL, NULL);
+ INSERT INTO sessions VALUES ('owner-task', 'desktop', 'active', NULL, NULL);
+ INSERT INTO sessions VALUES ('handed-task', 'desktop', 'active', NULL, NULL);
+ INSERT INTO bot_session_links VALUES ('l1', 'bot-1', 'bot-main', 'canonical', NULL);
+ INSERT INTO bot_session_links VALUES ('l2', 'bot-1', 'bot-lane', 'group', NULL);
+ INSERT INTO bot_session_links VALUES ('l3', 'bot-2', 'bot-remote', 'canonical', NULL);
+ `);
+ db = { drizzle: drizzle(sqlite) as unknown as DbClient['drizzle'] };
+});
+afterEach(() => sqlite.close());
+
+describe('resolveBotTurnAuthority', () => {
+ it('reads the owner, automation and unknown sources from the host input', async () => {
+ expect(await resolveBotTurnAuthority(db, 'bot-main', OWNER_INPUT)).toBe('owner');
+ expect(await resolveBotTurnAuthority(db, 'bot-main', input('schedule-run:1', 'scheduler'))).toBe('arranged');
+ expect(await resolveBotTurnAuthority(db, 'bot-main', input('bot-dm:abc'))).toBe('other');
+ });
+
+ it('treats a background-task report as arranged only when the owner or an automation started that task', async () => {
+ message('bot-main', 'owner-msg', ownerMeta);
+ delegation('d-owner', 'bot-main');
+ message('bot-main', 'bot-dm:1', botDmMeta);
+ delegation('d-dm', 'bot-main');
+ expect(await resolveBotTurnAuthority(db, 'bot-main', input('bot-delegation-completion:d-owner'))).toBe('arranged');
+ expect(await resolveBotTurnAuthority(db, 'bot-main', input('bot-delegation-interaction:d-owner:req-1'))).toBe('arranged');
+ // Started while another Bot was talking: its report must not lift the tier.
+ expect(await resolveBotTurnAuthority(db, 'bot-main', input('bot-delegation-completion:d-dm:2'))).toBe('other');
+ expect(await resolveBotTurnAuthority(db, 'bot-main', input('bot-delegation-completion:missing'))).toBe('other');
+ });
+
+ it('follows a chain of reports back to the turn that started it', async () => {
+ message('bot-main', 'owner-msg', ownerMeta);
+ delegation('d1', 'bot-main');
+ message('bot-main', 'bot-delegation-completion:d1', {});
+ delegation('d2', 'bot-main');
+ expect(await resolveBotTurnAuthority(db, 'bot-main', input('bot-delegation-completion:d2'))).toBe('arranged');
+
+ message('bot-main', 'bot-dm:2', botDmMeta);
+ delegation('d3', 'bot-main');
+ message('bot-main', 'bot-delegation-completion:d3', {});
+ delegation('d4', 'bot-main');
+ expect(await resolveBotTurnAuthority(db, 'bot-main', input('bot-delegation-completion:d4'))).toBe('other');
+ });
+
+ it('caps an authorization resume at the turn that asked for it', async () => {
+ message('bot-main', 'owner-msg', ownerMeta);
+ message('bot-main', 'bot-authorization-resume:r1', {});
+ expect(await resolveBotTurnAuthority(db, 'bot-main', input('bot-authorization-resume:r1'))).toBe('arranged');
+ message('bot-main', 'bot-dm:3', botDmMeta);
+ message('bot-main', 'bot-authorization-resume:r2', {});
+ expect(await resolveBotTurnAuthority(db, 'bot-main', input('bot-authorization-resume:r2'))).toBe('other');
+ });
+
+ it('drops to the lowest tier once another task or Bot steers into the turn', async () => {
+ message('bot-main', 'owner-msg', ownerMeta);
+ expect(await resolveBotTurnAuthority(db, 'bot-main', OWNER_INPUT)).toBe('owner');
+ // The owner's own composer steer carries no origin and keeps the tier.
+ message('bot-main', 'owner-steer', { delivery: 'steer', autoReviewUserText: '再加一句' });
+ expect(await resolveBotTurnAuthority(db, 'bot-main', OWNER_INPUT)).toBe('owner');
+ message('bot-main', 'foreign-steer', { delivery: 'steer', origin: { kind: 'session' } });
+ expect(await resolveBotTurnAuthority(db, 'bot-main', OWNER_INPUT)).toBe('other');
+ });
+
+ it('falls back to the latest root input when the coordinator has none', async () => {
+ message('bot-main', 'schedule-run:9', { origin: { kind: 'scheduler' } });
+ expect(await resolveBotTurnAuthority(db, 'bot-main', { executing: false, input: null })).toBe('arranged');
+ });
+});
+
+describe('createBotToolCallAuthorizer', () => {
+ function authorizer(execution: BotTurnExecution, handed: string[] = []) {
+ return createBotToolCallAuthorizer({
+ getDb: () => db,
+ readExecution: () => execution,
+ isWorkbenchProjectSession: vi.fn(async (_botId: string, sessionId: string) => handed.includes(sessionId)),
+ });
+ }
+ const call = (tool: string, args: unknown = {}, sessionId = 'bot-main', server: 'cindy_helper' | 'cindy_scheduler' = 'cindy_helper') =>
+ ({ sessionId, server, tool, args });
+
+ it('leaves ordinary tasks alone', async () => {
+ expect(await authorizer(input('bot-dm:1'))(call('archive_sessions', {}, 'owner-task'))).toEqual({ ok: true });
+ });
+
+ it('gives the owner turn the whole surface', async () => {
+ expect(await authorizer(OWNER_INPUT)(call('archive_sessions'))).toEqual({ ok: true });
+ expect(await authorizer(OWNER_INPUT)(call('schedule_create', {}, 'bot-main', 'cindy_scheduler'))).toEqual({ ok: true });
+ });
+
+ it('lets other turns act only on the Bot own tasks', async () => {
+ delegation('d1', 'bot-main', 'child-1');
+ const auth = authorizer(input('bot-dm:1'), ['handed-task']);
+ expect(await auth(call('stop_session_turn', { session_id: 'child-1' }))).toEqual({ ok: true });
+ expect(await auth(call('stop_session_turn', { session_id: 'handed-task' })))
+ .toMatchObject({ ok: false, errorCode: 'TASK_OUT_OF_SCOPE' });
+ expect(await auth(call('stop_session_turn', { session_id: 'owner-task' })))
+ .toMatchObject({ ok: false, errorCode: 'TASK_OUT_OF_SCOPE' });
+ });
+
+ it('lets arranged turns also act on tasks in handed-over projects', async () => {
+ const auth = authorizer(input('schedule-run:1', 'scheduler'), ['handed-task']);
+ expect(await auth(call('steer_session', { session_id: 'handed-task' }))).toEqual({ ok: true });
+ expect(await auth(call('steer_session', { session_id: 'owner-task' })))
+ .toMatchObject({ ok: false, errorCode: 'TASK_OUT_OF_SCOPE' });
+ });
+
+ it('judges a non-main Bot session at the lowest tier even if the owner typed', async () => {
+ expect(await resolveBotCallerAuthority(db, 'bot-lane', () => OWNER_INPUT))
+ .toEqual({ kind: 'bot', botId: 'bot-1', main: false, authority: 'other' });
+ expect(await authorizer(OWNER_INPUT)(call('set_app_default_model', {}, 'bot-lane')))
+ .toMatchObject({ ok: false, errorCode: 'OWNER_TURN_REQUIRED' });
+ expect(await authorizer(OWNER_INPUT)(call('archive_sessions', { session_ids: ['owner-task'] }, 'bot-lane')))
+ .toMatchObject({ ok: false, errorCode: 'TASK_OUT_OF_SCOPE' });
+ });
+
+ it('lets a non-owner turn archive only tasks the Bot owns', async () => {
+ delegation('d1', 'bot-main', 'child-1');
+ const auth = authorizer(input('bot-delegation-completion:missing'));
+ expect(await auth(call('archive_sessions', { session_ids: ['child-1'] }))).toEqual({ ok: true });
+ expect(await auth(call('archive_sessions', { session_ids: ['child-1', 'owner-task'] })))
+ .toMatchObject({ ok: false, errorCode: 'TASK_OUT_OF_SCOPE' });
+ });
+
+ it('keeps remote Bots on their old helper behavior, judging only local automations by turn', async () => {
+ expect(await authorizer(input('bot-dm:1'))(call('set_app_default_model', {}, 'bot-remote'))).toEqual({ ok: true });
+ expect(await authorizer(OWNER_INPUT)(call('schedule_create', {}, 'bot-remote', 'cindy_scheduler'))).toEqual({ ok: true });
+ expect(await authorizer(input('bot-dm:1'))(call('schedule_create', {}, 'bot-remote', 'cindy_scheduler')))
+ .toMatchObject({ ok: false, errorCode: 'OWNER_TURN_REQUIRED' });
+ });
+
+ it('refuses a call it cannot attribute to a task', async () => {
+ expect(await authorizer(OWNER_INPUT)({ sessionId: undefined, server: 'cindy_scheduler', tool: 'schedule_list', args: {} }))
+ .toMatchObject({ ok: false, errorCode: 'CAPABILITY_NOT_AVAILABLE' });
+ });
+
+ it('refuses while the account database is unavailable or switching', async () => {
+ const noDb = createBotToolCallAuthorizer({
+ getDb: () => null,
+ readExecution: () => OWNER_INPUT,
+ isWorkbenchProjectSession: async () => false,
+ });
+ expect(await noDb(call('archive_sessions'))).toMatchObject({ ok: false, errorCode: 'HOST_NOT_READY' });
+ const switching = createBotToolCallAuthorizer({
+ getDb: () => db,
+ readExecution: () => OWNER_INPUT,
+ isWorkbenchProjectSession: async () => false,
+ isScopeCurrent: () => false,
+ });
+ expect(await switching(call('archive_sessions'))).toMatchObject({ ok: false, errorCode: 'OWNER_SCOPE_CHANGED' });
+ });
+});
diff --git a/apps/desktop/src/main/maker-ipc/__tests__/botWorkbenchAccess.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/botWorkbenchAccess.test.ts
index bda0813dc4..84849e3d8f 100644
--- a/apps/desktop/src/main/maker-ipc/__tests__/botWorkbenchAccess.test.ts
+++ b/apps/desktop/src/main/maker-ipc/__tests__/botWorkbenchAccess.test.ts
@@ -4,6 +4,7 @@ import {
authorizeExternalCandidate,
authorizeWorkbenchTarget,
createBotWorkbenchAccess,
+ WORKBENCH_BRIEF_PROJECTS_MAX,
type BotWorkbenchAccessDeps,
type WorkbenchExternalCandidate,
type WorkbenchTargetFacts,
@@ -72,7 +73,6 @@ function setup(overrides: Partial<BotWorkbenchAccessDeps> = {}) {
deleteJudgment: vi.fn(async () => undefined),
notifyChanged: vi.fn(),
sendToSession: vi.fn(async () => ({ ok: true as const, wakeKind: 'queued', queuedMessageId: 'q-1' })),
- stopSessionTurn: vi.fn(async () => ({ ok: true as const, status: 'requested' as const })),
caseInsensitive: false,
...overrides,
};
@@ -348,15 +348,6 @@ describe('workbench continue / stop', () => {
.resolves.toMatchObject({ ok: false, errorCode: 'TASK_NOT_READABLE' });
});
- it('stops the current turn through the existing graceful stop path, but not an un-imported session', async () => {
- const { deps, access } = setup();
- await expect(access.stopTask({ callerSessionId: 'bot-main', taskId: 'task-1' }))
- .resolves.toEqual({ ok: true, taskId: 'task-1', status: 'requested' });
- expect(deps.stopSessionTurn).toHaveBeenCalledWith({ targetSessionId: 'task-1' });
- await expect(access.stopTask({ callerSessionId: 'bot-main', taskId: 'claude:abc' }))
- .resolves.toMatchObject({ ok: false, errorCode: 'TASK_NOT_RUNNING' });
- });
-
it('refuses a caller that is not a Bot main task and never touches the target', async () => {
const { deps, access } = setup({
resolveCaller: vi.fn(async () => ({
@@ -367,7 +358,6 @@ describe('workbench continue / stop', () => {
});
for (const call of [
() => access.continueTask({ callerSessionId: 'group-lane', taskId: 'task-1', message: 'hi' }),
- () => access.stopTask({ callerSessionId: 'group-lane', taskId: 'task-1' }),
() => access.read({ callerSessionId: 'group-lane', taskId: 'task-1' }),
() => access.set({ callerSessionId: 'group-lane', taskId: 'task-1', title: 't', verdict: 'done' }),
]) {
@@ -383,16 +373,13 @@ describe('workbench continue / stop', () => {
['a Bot hidden session', target({ botLinked: true }), 'TASK_NOT_ACCESSIBLE'],
['a remote task', target({ remoteHostId: 'ssh-1' }), 'TASK_REMOTE'],
['an archived task', target({ status: 'archived' }), 'TASK_ARCHIVED'],
- ])('denies %s without reading, sending or stopping', async (_label, facts, errorCode) => {
+ ])('denies %s without reading or sending', async (_label, facts, errorCode) => {
const { deps, access } = setup({ readTarget: vi.fn(async () => facts) });
await expect(access.continueTask({ callerSessionId: 'bot-main', taskId: 'task-1', message: 'hi' }))
.resolves.toMatchObject({ ok: false, errorCode });
- await expect(access.stopTask({ callerSessionId: 'bot-main', taskId: 'task-1' }))
- .resolves.toMatchObject({ ok: false, errorCode });
await expect(access.read({ callerSessionId: 'bot-main', taskId: 'task-1' }))
.resolves.toMatchObject({ ok: false, errorCode });
expect(deps.sendToSession).not.toHaveBeenCalled();
- expect(deps.stopSessionTurn).not.toHaveBeenCalled();
expect(deps.readSessionTranscript).not.toHaveBeenCalled();
});
@@ -412,13 +399,6 @@ describe('workbench continue / stop', () => {
.resolves.toMatchObject({ ok: false, errorCode: 'TASK_OUTSIDE_WORKBENCH' });
expect(deps.sendToSession).not.toHaveBeenCalled();
- vi.mocked(deps.readState)
- .mockResolvedValueOnce({ directories: [PROJECT], tasks: {} })
- .mockResolvedValue({ directories: [], tasks: {} });
- await expect(access.stopTask({ callerSessionId: 'bot-main', taskId: 'task-1' }))
- .resolves.toMatchObject({ ok: false, errorCode: 'TASK_OUTSIDE_WORKBENCH' });
- expect(deps.stopSessionTurn).not.toHaveBeenCalled();
-
vi.mocked(deps.readState)
.mockResolvedValueOnce({ directories: [PROJECT], tasks: {} })
.mockResolvedValue({ directories: [], tasks: {} });
@@ -544,6 +524,17 @@ describe('workbench snapshot', () => {
expect(result).toMatchObject({ ok: true, workbench: { projects: [{ path: PROJECT, brief: null }] } });
});
+ it('lists every handed-over project but only builds briefs for the most recent few', async () => {
+ const dirs = Array.from({ length: WORKBENCH_BRIEF_PROJECTS_MAX + 4 }, (_, index) => `/Users/me/Code/p${index}`);
+ const { deps, access } = setup({ readState: vi.fn(async () => ({ directories: dirs, tasks: {} })) });
+ const result = await access.get({ callerSessionId: 'bot-main' });
+ if (!result.ok) throw new Error('expected ok');
+ expect(result.workbench.projects).toHaveLength(dirs.length);
+ expect(deps.readBrief).toHaveBeenCalledTimes(WORKBENCH_BRIEF_PROJECTS_MAX);
+ expect(result.workbench.projects[0]!.brief).not.toBeNull();
+ expect(result.workbench.projects[WORKBENCH_BRIEF_PROJECTS_MAX]!.brief).toBeNull();
+ });
+
it('still lists the Bot own routines before any project is handed over', async () => {
const { deps, access } = setup({
readState: vi.fn(async () => ({ directories: [], tasks: {} })),
diff --git a/apps/desktop/src/main/maker-ipc/__tests__/botWorkbenchHandover.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/botWorkbenchHandover.test.ts
new file mode 100644
index 0000000000..09598ad615
--- /dev/null
+++ b/apps/desktop/src/main/maker-ipc/__tests__/botWorkbenchHandover.test.ts
@@ -0,0 +1,64 @@
+import { mkdir, mkdtemp, realpath, rm, symlink, writeFile } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+
+import { checkHandoverDirectory, findHandedProject, type HandoverDirectoryEnv } from '../botWorkbenchHandover.js';
+
+let root: string;
+let env: HandoverDirectoryEnv;
+
+beforeEach(async () => {
+ root = await realpath(await mkdtemp(path.join(os.tmpdir(), 'bot-handover-')));
+ const homeDir = path.join(root, 'home');
+ const userDataDir = path.join(root, 'userData');
+ await mkdir(path.join(homeDir, 'code', 'repo'), { recursive: true });
+ await mkdir(path.join(userDataDir, 'owners'), { recursive: true });
+ env = { homeDir, userDataDir, caseInsensitive: false };
+});
+afterEach(async () => {
+ await rm(root, { recursive: true, force: true });
+});
+
+describe('checkHandoverDirectory', () => {
+ it('accepts an existing project directory, including ~/ paths, and keeps the literal path', async () => {
+ const repo = path.join(env.homeDir, 'code', 'repo');
+ expect(await checkHandoverDirectory(`${repo}/`, env)).toEqual({ ok: true, path: repo });
+ expect(await checkHandoverDirectory('~/code/repo', env)).toEqual({ ok: true, path: repo });
+ const link = path.join(root, 'repo-link');
+ await symlink(repo, link);
+ expect(await checkHandoverDirectory(link, env)).toEqual({ ok: true, path: link });
+ });
+
+ it('rejects relative, missing and non-directory paths', async () => {
+ await writeFile(path.join(root, 'file.txt'), 'x');
+ expect(await checkHandoverDirectory('code/repo', env)).toMatchObject({ ok: false, errorCode: 'INVALID_PROJECT_PATH' });
+ expect(await checkHandoverDirectory(path.join(root, 'missing'), env)).toMatchObject({ ok: false, errorCode: 'NOT_A_DIRECTORY' });
+ expect(await checkHandoverDirectory(path.join(root, 'file.txt'), env)).toMatchObject({ ok: false, errorCode: 'NOT_A_DIRECTORY' });
+ });
+
+ it('rejects the filesystem root, the home directory and Cindy data, also through a symlink', async () => {
+ await symlink(env.homeDir, path.join(root, 'home-link'));
+ await symlink(path.join(env.userDataDir, 'owners'), path.join(root, 'data-link'));
+ for (const target of [path.parse(root).root, env.homeDir, '~', path.join(root, 'home-link'),
+ path.join(env.userDataDir, 'owners'), path.join(root, 'data-link')]) {
+ expect(await checkHandoverDirectory(target, env)).toMatchObject({ ok: false, errorCode: 'INVALID_PROJECT_PATH' });
+ }
+ });
+});
+
+describe('findHandedProject', () => {
+ it('finds the handed project through ~/, a trailing slash, case and symlinks, and nothing else', async () => {
+ const repo = path.join(env.homeDir, 'code', 'repo');
+ const link = path.join(root, 'repo-link');
+ await symlink(repo, link);
+ const dirs = [repo];
+ const opts = { homeDir: env.homeDir, caseInsensitive: true };
+ expect(await findHandedProject('~/code/repo/', dirs, opts)).toBe(repo);
+ expect(await findHandedProject(repo.toUpperCase(), dirs, opts)).toBe(repo);
+ expect(await findHandedProject(link, dirs, opts)).toBe(repo);
+ expect(await findHandedProject(path.join(env.homeDir, 'code'), dirs, opts)).toBeNull();
+ expect(await findHandedProject('code/repo', dirs, opts)).toBeNull();
+ });
+});
diff --git a/apps/desktop/src/main/maker-ipc/__tests__/botWorkbenchService.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/botWorkbenchService.test.ts
index 81175e4ebb..fdb87e5184 100644
--- a/apps/desktop/src/main/maker-ipc/__tests__/botWorkbenchService.test.ts
+++ b/apps/desktop/src/main/maker-ipc/__tests__/botWorkbenchService.test.ts
@@ -6,6 +6,7 @@ import { afterEach, describe, expect, it, vi } from 'vitest';
vi.mock('electron', () => ({ BrowserWindow: { getAllWindows: () => [] } }));
+import { BOT_WORKBENCH_MAX_DIRECTORIES } from '../../../shared/botWorkbench.js';
import { botProfileDir } from '../botProfileFolder.js';
import {
addBotWorkbenchDirectory,
@@ -50,13 +51,13 @@ describe('bot workbench storage', () => {
expect(await readBotWorkbenchDirectoryPaths(root, 'bot-2')).toEqual([]);
});
- it('rejects missing folders and more than six projects', async () => {
+ it('rejects missing folders and only stops at the sanity bound, well past six projects', async () => {
root = await mkdtemp(path.join(os.tmpdir(), 'bot-workbench-'));
expect(await addBotWorkbenchDirectory(root, 'bot-1', path.join(root, 'missing'))).toEqual({
ok: false,
errorCode: 'NOT_A_DIRECTORY',
});
- for (let index = 0; index < 6; index += 1) {
+ for (let index = 0; index < BOT_WORKBENCH_MAX_DIRECTORIES; index += 1) {
const dir = path.join(root, `p${index}`);
await mkdir(dir);
expect(await addBotWorkbenchDirectory(root, 'bot-1', dir)).toEqual({ ok: true });
@@ -104,10 +105,10 @@ describe('bot workbench storage', () => {
{ path: 'relative/path' },
{ path: '/a', addedAt: 7 },
{ path: '/a' },
- ...Array.from({ length: 8 }, (_, index) => ({ path: `/p${index}`, addedAt: 'x' })),
+ ...Array.from({ length: BOT_WORKBENCH_MAX_DIRECTORIES + 5 }, (_, index) => ({ path: `/p${index}`, addedAt: 'x' })),
],
});
- expect(normalized?.directories).toHaveLength(6);
+ expect(normalized?.directories).toHaveLength(BOT_WORKBENCH_MAX_DIRECTORIES);
expect(normalized?.directories[0]).toEqual({ path: '/a', addedAt: new Date(0).toISOString() });
});
});
diff --git a/apps/desktop/src/main/maker-ipc/botProfileRuntime.ts b/apps/desktop/src/main/maker-ipc/botProfileRuntime.ts
index 6859dd1f4b..73a861a73b 100644
--- a/apps/desktop/src/main/maker-ipc/botProfileRuntime.ts
+++ b/apps/desktop/src/main/maker-ipc/botProfileRuntime.ts
@@ -24,6 +24,7 @@ import {
import { clearBotAttention, noteBotAttention } from './botAttentionService.js';
import { createLogger } from '../logger.js';
import { PROVIDER_NAME_TO_PLUGIN_ID } from '../maker-host/plugins/builtin-plugins.js';
+import { BOT_BASELINE_PLUGIN_IDS } from '../maker-host/plugins/types.js';
const log = createLogger('maker-ipc:bot-profile-runtime');
@@ -774,9 +775,16 @@ export async function hydrateBotProfileRuntime(
toolsetMode === 'inherit' ? [...resolvedToolsets] : [...configuredToolsets];
// 工具集与内置 MCP 共用宿主映射;已选择的能力必须同轮进入 MCP allowlist。
// 显式挂载 docs 时提示词会承诺文档能力,其他工具集同样需要真正挂载。
- // 开头记录的那类事故:「提示词说有,运行时够不到」。
+ // 开头记录的那类事故:「提示词说有,运行时够不到」。伙伴基线工具集(如 scheduler)
+ // 不经用户选择也挂载,同样要写进 allowlist,否则插件挂上了 MCP 却够不到。
+ const mountedToolsets = new Set([
+ ...resolvedToolsets,
+ ...toolsetCatalog
+ .filter((item) => BOT_BASELINE_PLUGIN_IDS.has(item.id) && item.available !== false)
+ .map((item) => item.id),
+ ]);
for (const [serverName, toolsetId] of Object.entries(PROVIDER_NAME_TO_PLUGIN_ID)) {
- if (toolsetId === 'collab' || !resolvedToolsets.includes(toolsetId) || runtimeConfiguredMcpServers.includes(serverName)) continue;
+ if (toolsetId === 'collab' || !mountedToolsets.has(toolsetId) || runtimeConfiguredMcpServers.includes(serverName)) continue;
if (mcpCatalog.some((item) => item.name === serverName && item.available !== false)) {
runtimeConfiguredMcpServers.push(serverName);
}
@@ -808,6 +816,11 @@ export async function hydrateBotProfileRuntime(
// index must not hide the instructions for learning the first reusable method.
ownSkillsEnabled: row.role === 'canonical' && helperAvailable && !opts.remoteHostId,
botModeEnabled: row.role === 'canonical',
+ // Same condition as the `bot-main` helper surface (mcp-integrations/helperSurface.ts).
+ sessionControlEnabled: row.role === 'canonical' && helperAvailable && !opts.remoteHostId,
+ // scheduler 是伙伴基线工具(maker-host/plugins/types.ts),与挂载 allowlist 同一份目录判定。
+ automationEnabled: row.role === 'canonical' && !opts.remoteHostId
+ && toolsetCatalog.some((item) => item.id === 'scheduler' && item.available !== false),
};
/*
伙伴的家。读失败一律当"没有" —— 一次读不动不该让整个伙伴起不来,只是这一轮
diff --git a/apps/desktop/src/main/maker-ipc/botSystemPrompt.ts b/apps/desktop/src/main/maker-ipc/botSystemPrompt.ts
index b5cd6969a9..0484f60d5d 100644
--- a/apps/desktop/src/main/maker-ipc/botSystemPrompt.ts
+++ b/apps/desktop/src/main/maker-ipc/botSystemPrompt.ts
@@ -34,6 +34,13 @@ export interface BotPromptCapabilitySignals {
ownSkillsEnabled: boolean;
/** 是否为 Bot 的 canonical Chat;Bot Mode 协议只在这里生效。 */
botModeEnabled?: boolean;
+ /**
+ * 本机伙伴主任务拿到普通任务那一套 session 工具(宿主按本轮来源逐次判定,见 botTurnAuthority.ts)。
+ * 远程伙伴与群专线等非主任务没有。
+ */
+ sessionControlEnabled?: boolean;
+ /** 伙伴基线挂载了 cindy_scheduler(本机主任务);宿主仍按轮判定写操作。 */
+ automationEnabled?: boolean;
}
/** 技能索引的一行:名字 + 一句话描述(描述缺省时只列名字)。 */
@@ -141,6 +148,23 @@ const TASK_AND_TEAMMATE_GUIDANCE = [
'后台任务负责独立工作并回传结果;伙伴消息只负责沟通,不保证对方执行或交付。它们都不是命令对方,也不会改变对方是谁。用户如果要求"让某个伙伴听话",说明这条边界,然后直接给出可以协作的做法。',
].join('\n');
+/**
+ * 和普通任务同一套 session 能力,以及「这一轮是谁触发的」决定能做多少(宿主逐次核对,
+ * 提示词只负责让伙伴知道有这些能力、被拒时怎么办)。
+ */
+const SESSION_CONTROL_GUIDANCE = [
+ '## 你能看、能管主人的任务',
+ '你和主人开的普通任务用同一套工具(cindy_helper,先 `list_tools` 看类目再 `call_tool`):history 类的 `list_sessions` / `get_chat_history` / `search_chat_history` 看有哪些任务、它们在说什么;control 类的 `steer_session`、`stop_session_turn`、`set_session_runtime`、`rename_sessions`、`archive_sessions`、标签与项目工具管理任务;handoff 类的 `send_to_session` 给已有任务发话或开一条新的普通任务。',
+ '能做多少取决于这一轮是谁触发的,宿主每次调用都会核对:主人本人在这里发话的那一轮,这些都能用;自动化、例行任务、你开的后台任务回报这类主人事先安排的,能看全部,只能动交给你的项目里的任务和你自己开的任务;群聊、其他伙伴或别的任务转来的消息,只能动你自己开的任务。被拒(`OWNER_TURN_REQUIRED` / `TASK_OUT_OF_SCOPE`)就照实告诉主人,等主人自己说;不要换个工具、开后台任务、用命令行或请别的伙伴去做被拒的事。新建伙伴、改你自己的资料与能力只在主人本人发话的那一轮做。',
+ '停止、归档、改名、给正在跑的任务插话这类会影响主人工作的事,主人没开口就不做;做之前用一句话说清要动哪件、做什么。',
+ '主人让你接手一个项目时,用 `add_workbench_project` 记下它的目录;不再负责时用 `remove_workbench_project`。这两个只在主人本人发话的那一轮可用。',
+].join('\n');
+
+const AUTOMATION_GUIDANCE = [
+ '## 你能建普通自动化',
+ '主人要你给某个项目或任务设定时执行时,用 cindy_scheduler 建普通自动化(先 `list_tools`,再 `call_tool` 调 `schedule_create` 等);只和你自己有关的提醒仍用例行任务。新建、修改、暂停、立即运行和删除只在主人本人发话的那一轮可用,其余时候只能查看。建完读回核实名称、时间和是否启用,成功才说已安排。',
+].join('\n');
+
const BOT_CREATION_GUIDANCE = [
'## 你可以创建伙伴',
'用户要求新增、创建或添加一个伙伴时,直接调用 `create_teammate` 完成创建。只需要名字;用户已说明的职责和身份可以一起带上,没有说明的不要编造。第一句话由新伙伴自己的运行时和记忆生成,不代写、不预览;不要写资料包、模板文件,也不要让用户手动去设置页重做一遍。',
@@ -239,6 +263,10 @@ export function buildBotStableTier(input: BotSystemPromptInput): string {
if (botModeEnabled && input.capabilities.partnerActionsEnabled) {
capabilityParts.push(TASK_AND_TEAMMATE_GUIDANCE);
}
+ if (botModeEnabled && input.capabilities.sessionControlEnabled) {
+ capabilityParts.push(SESSION_CONTROL_GUIDANCE);
+ if (input.capabilities.automationEnabled) capabilityParts.push(AUTOMATION_GUIDANCE);
+ }
if (capabilityParts.length > 0) {
parts.push(['# 你会做什么', ...capabilityParts].join('\n\n'));
}
diff --git a/apps/desktop/src/main/maker-ipc/botToolCallAuthorizer.ts b/apps/desktop/src/main/maker-ipc/botToolCallAuthorizer.ts
new file mode 100644
index 0000000000..a76758a338
--- /dev/null
+++ b/apps/desktop/src/main/maker-ipc/botToolCallAuthorizer.ts
@@ -0,0 +1,118 @@
+/**
+ * 伙伴工具调用的宿主判定入口:把 `botTurnAuthority.ts` 的分档与规则接到真实数据上。
+ *
+ * - 不是伙伴的任务一律放行(普通任务、插件任务各有自己的能力面)。
+ * - 远程伙伴保持原有的窄能力面;只有经隧道挂到的本机自动化(远程 Pi)按同样的分档判定。
+ * - 伙伴的群专线、历史等非主任务一律按最低档(other)判定。
+ * - 「自己的任务」= 这个伙伴的 bot_session_links,或它开的后台任务(bot_delegations)。
+ * - 「已接手项目里的任务」与工作台继续同一判据(isWorkbenchProjectSession)。
+ */
+import { and, eq } from 'drizzle-orm';
+
+import type { ToolCallAuthorization, ToolCallAuthorizer } from '@cindy/mcps';
+
+import type { DbClient } from '../localDb/client/DbClient.js';
+import { botDelegations, botSessionLinks, sessions } from '../localDb/schema.js';
+import {
+ decideBotToolCall,
+ resolveBotTurnAuthority,
+ type BotTurnAuthority,
+ type BotTurnExecution,
+} from './botTurnAuthority.js';
+
+export type BotCallerAuthority =
+ | { kind: 'not-bot' }
+ | { kind: 'remote-bot'; botId: string; authority: BotTurnAuthority }
+ | { kind: 'bot'; botId: string; main: boolean; authority: BotTurnAuthority };
+
+export interface BotToolCallAuthorizerDeps {
+ getDb(): Pick<DbClient, 'drizzle'> | null;
+ readExecution(sessionId: string): BotTurnExecution;
+ isWorkbenchProjectSession(botId: string, sessionId: string): Promise<boolean>;
+ /** 账号切换中或数据库换了:拒绝,不在旧账号的数据上判定。 */
+ isScopeCurrent?(db: Pick<DbClient, 'drizzle'>): boolean;
+}
+
+export async function resolveBotCallerAuthority(
+ db: Pick<DbClient, 'drizzle'>,
+ sessionId: string,
+ readExecution: (sessionId: string) => BotTurnExecution,
+): Promise<BotCallerAuthority> {
+ const [row] = await db.drizzle
+ .select({
+ botId: botSessionLinks.botId,
+ role: botSessionLinks.role,
+ linkArchivedAt: botSessionLinks.archivedAt,
+ source: sessions.source,
+ status: sessions.status,
+ remoteHostId: sessions.remoteHostId,
+ })
+ .from(sessions)
+ .leftJoin(botSessionLinks, eq(botSessionLinks.sessionId, sessions.id))
+ .where(eq(sessions.id, sessionId))
+ .limit(1);
+ if (!row || (!row.botId && row.source !== 'bot')) return { kind: 'not-bot' };
+ // 伙伴来源但链接坏了:按伙伴最低档处理,绝不退回普通任务的能力。
+ if (!row.botId) return { kind: 'bot', botId: '', main: false, authority: 'other' };
+ const main = row.role === 'canonical' && row.linkArchivedAt === null && row.source === 'bot' && row.status === 'active';
+ const authority = main ? await resolveBotTurnAuthority(db, sessionId, readExecution(sessionId)) : 'other';
+ if (row.remoteHostId) return { kind: 'remote-bot', botId: row.botId, authority };
+ return { kind: 'bot', botId: row.botId, main, authority };
+}
+
+async function isOwnTask(db: Pick<DbClient, 'drizzle'>, botId: string, sessionId: string): Promise<boolean> {
+ if (!botId) return false;
+ const [[link], [delegation]] = await Promise.all([
+ db.drizzle.select({ id: botSessionLinks.id }).from(botSessionLinks)
+ .where(and(eq(botSessionLinks.sessionId, sessionId), eq(botSessionLinks.botId, botId))).limit(1),
+ db.drizzle.select({ id: botDelegations.id }).from(botDelegations)
+ .where(and(eq(botDelegations.childSessionId, sessionId), eq(botDelegations.requestingBotId, botId))).limit(1),
+ ]);
+ return Boolean(link || delegation);
+}
+
+const SCOPE_CHANGED: ToolCallAuthorization = {
+ ok: false,
+ errorCode: 'OWNER_SCOPE_CHANGED',
+ message: '账号正在切换,请稍后重试。',
+};
+
+export function createBotToolCallAuthorizer(deps: BotToolCallAuthorizerDeps): ToolCallAuthorizer {
+ const judge = async (
+ db: Pick<DbClient, 'drizzle'>,
+ { sessionId, server, tool, args }: Parameters<ToolCallAuthorizer>[0] & { sessionId: string },
+ ): Promise<ToolCallAuthorization> => {
+ const caller = await resolveBotCallerAuthority(db, sessionId, deps.readExecution);
+ if (caller.kind === 'not-bot') return { ok: true };
+ // Remote Bots keep their unchanged helper surface. Automations live on this
+ // computer (tunneled to remote Pi), so they follow the same per-turn rules.
+ if (caller.kind === 'remote-bot' && server !== 'cindy_scheduler') return { ok: true };
+ const decision = decideBotToolCall(server, tool, args, caller.authority);
+ if (decision.kind === 'allow') return { ok: true };
+ if (decision.kind === 'deny') return { ok: false, errorCode: decision.errorCode, message: decision.message };
+ for (const target of decision.sessionIds) {
+ if (await isOwnTask(db, caller.botId, target)) continue;
+ if (decision.scope === 'own-or-handed' && await deps.isWorkbenchProjectSession(caller.botId, target)) continue;
+ return {
+ ok: false,
+ errorCode: 'TASK_OUT_OF_SCOPE',
+ message: decision.scope === 'own-or-handed'
+ ? '这一轮只能操作你自己开的任务,或主人交给你的项目里的任务。'
+ : '这一轮只能操作你自己开的任务;动主人的其他任务要等主人本人发话。',
+ };
+ }
+ return { ok: true };
+ };
+ return async (input) => {
+ // 权限闸门:认不出调用方就拒绝。普通任务的自动化调用本来也要求 session(withAccountDataAccess)。
+ if (!input.sessionId) {
+ return { ok: false, errorCode: 'CAPABILITY_NOT_AVAILABLE', message: '认不出这次调用来自哪个任务,已拒绝。' };
+ }
+ const db = deps.getDb();
+ if (!db) return { ok: false, errorCode: 'HOST_NOT_READY', message: '本机数据还没准备好,请稍后重试。' };
+ const result = await judge(db, { ...input, sessionId: input.sessionId });
+ // 判定期间换了账号:不在旧账号的数据上放行。
+ if (result.ok && deps.isScopeCurrent && !deps.isScopeCurrent(db)) return SCOPE_CHANGED;
+ return result;
+ };
+}
diff --git a/apps/desktop/src/main/maker-ipc/botTurnAuthority.ts b/apps/desktop/src/main/maker-ipc/botTurnAuthority.ts
new file mode 100644
index 0000000000..d73d85a1d2
--- /dev/null
+++ b/apps/desktop/src/main/maker-ipc/botTurnAuthority.ts
@@ -0,0 +1,338 @@
+/**
+ * 伙伴主任务「按这一轮是谁触发的」分档(2026-10-01 产品裁决,见 cindy-bots-runtime.md 6.4)。
+ *
+ * 本机伙伴主任务和普通任务拿同一套 session 工具;工具列表在整个会话里保持稳定(前缀缓存规则),
+ * 每次调用时由这里按本轮来源决定放不放行:
+ *
+ * - owner:主人本人在伙伴聊天里的输入(桌面、手机、同账号设备,含工作台按钮代发)。由可信输入通道
+ * 盖章,判据与插件任务「真人接管」共用 `hasAcceptedUserTaskInput`。= 全套。
+ * - arranged:主人事先安排好的——自动化 / 例行任务、伙伴自己开的后台任务回报或等待交互、
+ * 授权卡确认后的续跑。= 读全部;只动已接手项目里的任务和自己开的任务;不新建自动化、不改账号设置。
+ * 后台任务回报与授权续跑不高于引出它们的那一轮:由 other 那一轮引出的仍是 other。
+ * - other:其余一切(伙伴群聊、其他伙伴的消息、别的任务转来的消息)以及认不出来的。= 只动自己开的
+ * 任务、只读自己的记录。
+ *
+ * 判档只看宿主持有的事实,不看模型说了什么。
+ */
+import { and, desc, eq, isNull, lt, sql } from 'drizzle-orm';
+
+import type { DbClient } from '../localDb/client/DbClient.js';
+import { botDelegations, messages, sessions } from '../localDb/schema.js';
+import { hasAcceptedUserTaskInput, isAcceptedUserInputRow, type AcceptedTaskInput } from './pluginTaskInput.js';
+
+export type BotTurnAuthority = 'owner' | 'arranged' | 'other';
+
+/**
+ * 宿主代发的续跑输入:后台任务完成回报、后台任务等待交互、账号授权完成后的续跑。
+ * 它们本身不是主人说的话,可信程度不高于引出它们的那一轮(见 continuationAuthority)。
+ */
+const CONTINUATION_CLIENT_ID_PREFIXES = [
+ 'bot-delegation-completion:',
+ 'bot-delegation-interaction:',
+ 'bot-authorization-resume:',
+] as const;
+const DELEGATION_CONTINUATION = /^bot-delegation-(?:completion|interaction):([^:]+)/;
+/** 续跑链(后台任务里又开后台任务……)最多回溯几层;更深按最低档。 */
+const MAX_CONTINUATION_HOPS = 4;
+
+const isContinuationClientId = (clientId: string | null | undefined): boolean =>
+ !!clientId && CONTINUATION_CLIENT_ID_PREFIXES.some((prefix) => clientId.startsWith(prefix));
+
+export interface BotTurnExecution {
+ executing: boolean;
+ input: AcceptedTaskInput | null;
+}
+
+type RootInput = { clientId: string; originKind: string | null; agentMeta: string | null };
+
+/**
+ * 一轮的起点:`before` 之前最近一条根用户输入(不含回滚、清空前、自动续跑与上下文重建的行)。
+ * 没有协调器输入(直接派发、或工具先于派发回执到达)时也用它判断这一轮的来源。
+ */
+async function rootUserInputBefore(
+ db: Pick<DbClient, 'drizzle'>,
+ sessionId: string,
+ before: number | null,
+): Promise<RootInput | null> {
+ const meta = sql`CASE WHEN json_valid(${messages.agentMeta}) THEN ${messages.agentMeta} ELSE '{}' END`;
+ const [row] = await db.drizzle
+ .select({
+ clientId: messages.clientId,
+ agentMeta: messages.agentMeta,
+ originKind: sql<string | null>`json_extract(${meta}, '$.origin.kind')`,
+ })
+ .from(messages)
+ .innerJoin(sessions, eq(sessions.id, messages.sessionId))
+ .where(and(
+ eq(messages.sessionId, sessionId),
+ eq(messages.role, 'user'),
+ isNull(messages.rewindAt),
+ before === null ? undefined : lt(messages.createdAt, before),
+ sql`${messages.createdAt} > COALESCE(${sessions.clearedAt}, 0)`,
+ sql`json_extract(${meta}, '$.parentUuid') IS NULL`,
+ sql`COALESCE(json_extract(${meta}, '$.autoResume'), 0) != 1`,
+ sql`COALESCE(json_extract(${meta}, '$.contextRebuild'), 0) != 1`,
+ ))
+ .orderBy(desc(messages.createdAt), desc(sql`messages.rowid`))
+ .limit(1);
+ return row ? { clientId: row.clientId, originKind: row.originKind ?? null, agentMeta: row.agentMeta ?? null } : null;
+}
+
+/** 续跑是哪一轮引出来的:后台任务看它被创建时伙伴那边的那一轮;授权续跑看授权卡之前的那一轮。 */
+async function continuationAnchor(
+ db: Pick<DbClient, 'drizzle'>,
+ sessionId: string,
+ clientId: string,
+): Promise<{ sessionId: string; before: number | null } | null> {
+ const delegation = DELEGATION_CONTINUATION.exec(clientId);
+ if (delegation) {
+ const [row] = await db.drizzle
+ .select({ parentSessionId: botDelegations.parentSessionId, createdAt: botDelegations.createdAt })
+ .from(botDelegations)
+ .where(eq(botDelegations.id, delegation[1]!))
+ .limit(1);
+ return row?.parentSessionId ? { sessionId: row.parentSessionId, before: row.createdAt } : null;
+ }
+ const [resume] = await db.drizzle
+ .select({ createdAt: messages.createdAt })
+ .from(messages)
+ .where(and(eq(messages.sessionId, sessionId), eq(messages.clientId, clientId)))
+ .limit(1);
+ // 续跑消息还没落库时,引出它的就是目前最近的那条根输入。
+ return { sessionId, before: resume?.createdAt ?? null };
+}
+
+/**
+ * 宿主续跑最多算「主人事先安排」,且不高于引出它的那一轮:主人本人或自动化引出的 → arranged;
+ * 群聊、其他伙伴、别的任务转来的消息引出的 → other(否则开个后台任务就能把档位抬上去)。
+ */
+async function continuationAuthority(
+ db: Pick<DbClient, 'drizzle'>,
+ sessionId: string,
+ clientId: string,
+ hops: number,
+): Promise<BotTurnAuthority> {
+ if (!isContinuationClientId(clientId) || hops >= MAX_CONTINUATION_HOPS) return 'other';
+ const anchor = await continuationAnchor(db, sessionId, clientId);
+ if (!anchor) return 'other';
+ const root = await rootUserInputBefore(db, anchor.sessionId, anchor.before);
+ if (!root) return 'other';
+ if (isAcceptedUserInputRow(root) || root.originKind === 'scheduler') return 'arranged';
+ return continuationAuthority(db, anchor.sessionId, root.clientId, hops + 1);
+}
+
+/**
+ * 这一轮开始后,有没有别的任务或伙伴用插话(steer)塞进来的输入。插话进来的内容和这一轮混在一起,
+ * 不能沿用这一轮起点的档位。主人自己在输入框里插话不带 origin,不算。
+ */
+async function hasForeignSteerSince(
+ db: Pick<DbClient, 'drizzle'>,
+ sessionId: string,
+ turnClientId: string,
+): Promise<boolean> {
+ const [start] = await db.drizzle
+ .select({ createdAt: messages.createdAt })
+ .from(messages)
+ .where(and(eq(messages.sessionId, sessionId), eq(messages.clientId, turnClientId)))
+ .limit(1);
+ if (!start) return false;
+ const meta = sql`CASE WHEN json_valid(${messages.agentMeta}) THEN ${messages.agentMeta} ELSE '{}' END`;
+ const [steer] = await db.drizzle
+ .select({ clientId: messages.clientId })
+ .from(messages)
+ .where(and(
+ eq(messages.sessionId, sessionId),
+ eq(messages.role, 'user'),
+ isNull(messages.rewindAt),
+ sql`${messages.createdAt} >= ${start.createdAt}`,
+ sql`json_extract(${meta}, '$.delivery') = 'steer'`,
+ sql`json_extract(${meta}, '$.origin') IS NOT NULL`,
+ ))
+ .limit(1);
+ return Boolean(steer);
+}
+
+export async function resolveBotTurnAuthority(
+ db: Pick<DbClient, 'drizzle'>,
+ sessionId: string,
+ execution: BotTurnExecution,
+): Promise<BotTurnAuthority> {
+ const authority = await resolveTurnStartAuthority(db, sessionId, execution);
+ const turnClientId = execution.input ? execution.input.retrySourceClientId ?? execution.input.clientId : null;
+ if (authority !== 'other' && turnClientId && await hasForeignSteerSince(db, sessionId, turnClientId)) return 'other';
+ return authority;
+}
+
+async function resolveTurnStartAuthority(
+ db: Pick<DbClient, 'drizzle'>,
+ sessionId: string,
+ execution: BotTurnExecution,
+): Promise<BotTurnAuthority> {
+ if (await hasAcceptedUserTaskInput(db, sessionId, execution.input)) return 'owner';
+ const input = execution.input;
+ const source = input
+ ? { clientId: input.retrySourceClientId ?? input.clientId, originKind: input.originKind ?? null }
+ : await rootUserInputBefore(db, sessionId, null);
+ if (!source) return 'other';
+ if (source.originKind === 'scheduler') return 'arranged';
+ return continuationAuthority(db, sessionId, source.clientId, 0);
+}
+
+// ── 每个工具的规则(纯函数,单测覆盖) ───────────────────────────────────────
+
+export type BotToolDecision =
+ | { kind: 'allow' }
+ | { kind: 'deny'; errorCode: string; message: string }
+ /** 宿主逐个核对目标任务:`own` 只认伙伴自己的任务;`own-or-handed` 另认已接手项目里的任务。 */
+ | { kind: 'targets'; sessionIds: string[]; scope: 'own' | 'own-or-handed' };
+
+const OWNER_TURN_REQUIRED = {
+ kind: 'deny',
+ errorCode: 'OWNER_TURN_REQUIRED',
+ message: '这一步只能在主人本人发话的那一轮里做;这一轮来自群聊、其他伙伴、自动化或后台任务回报。先告诉主人,等主人自己说了再做。',
+} as const satisfies BotToolDecision;
+
+/** 任何来源都能用:自省、登录、伙伴管理自己的后台任务与消息、沉淀技能,读取自己的资料、能力与例行任务。 */
+const ANY_TURN_TOOLS = new Set([
+ 'get_capabilities',
+ 'get_current_session_id',
+ 'start_grok_device_login',
+ 'get_grok_login_status',
+ 'cancel_grok_device_login',
+ 'start_session_task',
+ 'check_session_task',
+ 'inspect_session_task_route',
+ 'advance_session_task_route',
+ 'message_session_task',
+ 'stop_session_task',
+ 'list_agents',
+ 'send_to_agent',
+ 'check_agent_message',
+ 'save_teammate_skill',
+ 'list_teammate_skills',
+ 'get_teammate_state',
+ 'find_teammate_capabilities',
+ // 旧名别名(bot_capabilities.ts),行为同上。
+ 'get_bot_state',
+ 'find_bot_capabilities',
+ 'get_app_default_model',
+ 'routine_list',
+ 'routine_sources',
+ 'routine_history',
+ 'schedule_notify_current_run',
+ 'list_available_models',
+ // 历史读取:前两档不限范围,最低档由历史范围只给伙伴自己的记录(见 mcp-providers)。
+ 'list_workdirs',
+ 'list_sessions',
+ 'get_chat_history',
+ 'search_chat_history',
+]);
+
+/**
+ * 读全部、动已接手项目:主人本人与主人事先安排的那两档。例行任务的写入也在这里——例行任务跑起来
+ * 是 arranged,若 other 那一轮能建例行任务,就能借下一次运行把档位抬上去。
+ */
+const OWNER_OR_ARRANGED_TOOLS = new Set([
+ 'get_workbench',
+ 'read_workbench_task',
+ 'set_workbench_task',
+ 'set_workbench_tasks',
+ 'continue_workbench_task',
+ 'list_projects',
+ 'create_project',
+ 'routine_save',
+ 'routine_delete',
+ 'routine_run_now',
+ 'schedule_set_pre_run_hook',
+]);
+
+/**
+ * 按目标任务判定的会话控制工具。`read` = 只读;`currentByDefault` = 省略 session_id 时作用于
+ * 调用方自己的当前任务(伙伴自己的任务,任何档都可以)。
+ */
+const TARGETED_TOOLS = new Map<string, { read: boolean; currentByDefault?: boolean }>([
+ ['get_session_runtime', { read: true, currentByDefault: true }],
+ ['list_session_queue', { read: true }],
+ ['steer_session', { read: false }],
+ ['stop_session_turn', { read: false }],
+ ['set_session_runtime', { read: false, currentByDefault: true }],
+ ['update_session_queued_message', { read: false }],
+ ['cancel_session_queued_message', { read: false }],
+]);
+
+/** 批量整理任务的工具:从参数里取出全部目标任务,按同样的目标规则判定。 */
+const TARGETED_BATCH_TOOLS = new Map<string, (args: unknown) => unknown[] | null>([
+ ['rename_sessions', (args) => arrayArg(args, 'changes')?.map((change) => stringArg(change, 'session_id')) ?? null],
+ ['archive_sessions', (args) => arrayArg(args, 'session_ids')],
+ ['unarchive_sessions', (args) => arrayArg(args, 'session_ids')],
+]);
+
+/** 自动化里只读或只作用于本次运行的工具;其余(新建 / 改 / 删 / 暂停 / 立即跑)只在主人本人那一轮。 */
+const SCHEDULER_READ_TOOLS = new Set(['schedule_list', 'schedule_get', 'schedule_list_runs']);
+const SCHEDULER_CURRENT_RUN_TOOLS = new Set(['schedule_notify_current_run', 'schedule_silence_current_run']);
+
+function stringArg(args: unknown, key: string): string | null {
+ if (!args || typeof args !== 'object') return null;
+ const value = (args as Record<string, unknown>)[key];
+ return typeof value === 'string' && value.trim() ? value.trim() : null;
+}
+
+function arrayArg(args: unknown, key: string): unknown[] | null {
+ if (!args || typeof args !== 'object') return null;
+ const value = (args as Record<string, unknown>)[key];
+ return Array.isArray(value) ? value : null;
+}
+
+export function decideBotToolCall(
+ server: 'cindy_helper' | 'cindy_scheduler',
+ tool: string,
+ args: unknown,
+ authority: BotTurnAuthority,
+): BotToolDecision {
+ if (authority === 'owner') return { kind: 'allow' };
+
+ if (server === 'cindy_scheduler') {
+ if (SCHEDULER_CURRENT_RUN_TOOLS.has(tool)) return { kind: 'allow' };
+ if (authority === 'arranged' && SCHEDULER_READ_TOOLS.has(tool)) return { kind: 'allow' };
+ return OWNER_TURN_REQUIRED;
+ }
+
+ if (ANY_TURN_TOOLS.has(tool)) return { kind: 'allow' };
+ if (OWNER_OR_ARRANGED_TOOLS.has(tool)) {
+ return authority === 'arranged' ? { kind: 'allow' } : OWNER_TURN_REQUIRED;
+ }
+
+ const targeted = TARGETED_TOOLS.get(tool);
+ if (targeted) {
+ const sessionId = stringArg(args, 'session_id');
+ if (!sessionId) {
+ return targeted.currentByDefault
+ ? { kind: 'allow' }
+ : { kind: 'deny', errorCode: 'INVALID_ARGS', message: '缺少 session_id。' };
+ }
+ if (authority === 'arranged' && targeted.read) return { kind: 'allow' };
+ return { kind: 'targets', sessionIds: [sessionId], scope: authority === 'arranged' ? 'own-or-handed' : 'own' };
+ }
+
+ const batchTargets = TARGETED_BATCH_TOOLS.get(tool);
+ if (batchTargets) {
+ const ids = batchTargets(args);
+ const sessionIds = ids?.map((id) => (typeof id === 'string' ? id.trim() : '')) ?? [];
+ if (sessionIds.length === 0 || sessionIds.some((id) => !id)) {
+ return { kind: 'deny', errorCode: 'INVALID_ARGS', message: '缺少目标任务的 session id。' };
+ }
+ return { kind: 'targets', sessionIds: [...new Set(sessionIds)], scope: authority === 'arranged' ? 'own-or-handed' : 'own' };
+ }
+
+ if (tool === 'send_to_session') {
+ const target = stringArg(args, 'target_session_id');
+ // 新建任务只在主人本人那一轮;其余档用 start_session_task 开自己的后台任务。
+ if (!target) return OWNER_TURN_REQUIRED;
+ return { kind: 'targets', sessionIds: [target], scope: authority === 'arranged' ? 'own-or-handed' : 'own' };
+ }
+
+ // 其余一律只在主人本人那一轮:新建伙伴、改伙伴自己的资料与能力(持久生效,后台任务回报里可能夹带外部内容)/
+ // 标签 / 项目改名移除与移动任务 / 改应用默认模型 /
+ // 接手或移除项目 / 反馈 / 技能发布与学习 / 应用更新,以及将来新增、这里还没登记的工具。
+ return OWNER_TURN_REQUIRED;
+}
diff --git a/apps/desktop/src/main/maker-ipc/botWorkbenchAccess.ts b/apps/desktop/src/main/maker-ipc/botWorkbenchAccess.ts
index 542042dfa0..5cca9cdd93 100644
--- a/apps/desktop/src/main/maker-ipc/botWorkbenchAccess.ts
+++ b/apps/desktop/src/main/maker-ipc/botWorkbenchAccess.ts
@@ -1,9 +1,10 @@
/**
* 伙伴工作台的权限边界与工具服务(纯逻辑,依赖全部注入,便于单测)。
*
- * 产品裁决(2026-10-01):伙伴可以查看、继续、停止「主人明确交给它的项目」里的任务。
- * 授权来自主人在工作台里点「交给伙伴」的那一次,范围只限记在该伙伴
- * `workbench.json` 里的项目,主人随时可以移除;其它任务仍不可触达。
+ * 产品裁决(2026-10-01):伙伴可以查看、继续「主人明确交给它的项目」里的任务。
+ * 授权来自主人「交给伙伴」的那一次(工作台里点选,或主人本人那一轮让伙伴记下),范围只限记在
+ * 该伙伴 `workbench.json` 里的项目,主人随时可以移除。停止、插话等动作走通用会话工具,
+ * 由宿主按「这一轮是谁触发的」逐次判定(见 botTurnAuthority.ts)。
*
* 接手 = 理解,不是搬运:项目是目录。宿主先给每个项目一份有界的素材(文档清单、近期提交与
* 分支、我的 PR / issue)和近期会话的摘要(起始目的 + 最后几条),伙伴凭这些一次性写下判断
@@ -211,12 +212,6 @@ export interface BotWorkbenchAccessDeps {
message: string;
dispatcherSessionId: string;
}): Promise<{ ok: true; wakeKind: string; queuedMessageId?: string } | Failure>;
- stopSessionTurn(params: {
- targetSessionId: string;
- }): Promise<
- | { ok: true; status: 'no-active-turn' | 'waiting-for-safe-point' | 'requested' | 'unconfirmed' }
- | Failure
- >;
caseInsensitive: boolean;
now?(): number;
/** 账号切换守卫:返回 false 时中止,不做任何写入或投递。 */
@@ -229,6 +224,12 @@ function projectName(dir: string): string {
const scopeChanged: Failure = { ok: false, errorCode: 'OWNER_SCOPE_CHANGED', message: '账号已切换,请重试' };
+/**
+ * 项目数不再有产品上限,素材(brief:git、GitHub、文档清单)只给最近交代的前几个项目现算,
+ * 其余项目 brief 为 null,伙伴需要时用自己的文件工具看。防止一次 get_workbench 拉几十个仓库。
+ */
+export const WORKBENCH_BRIEF_PROJECTS_MAX = 8;
+
type ResolvedTarget =
| { ok: true; kind: 'session'; taskId: string; sessionId: string; projectDir: string }
| {
@@ -461,7 +462,9 @@ export function createBotWorkbenchAccess(deps: BotWorkbenchAccessDeps) {
deps.listRoutines(caller.botId),
projectDirs.length ? deps.listSchedules() : Promise.resolve([]),
Promise.all(projectDirs.map((dir) => deps.projectExists?.(dir) ?? Promise.resolve(true))),
- Promise.all(projectDirs.map((dir) => deps.readBrief(dir).catch(() => null))),
+ Promise.all(projectDirs.map((dir, index) => (index < WORKBENCH_BRIEF_PROJECTS_MAX
+ ? deps.readBrief(dir).catch(() => null)
+ : Promise.resolve(null)))),
]);
type Candidate = {
taskId: string;
@@ -722,19 +725,6 @@ export function createBotWorkbenchAccess(deps: BotWorkbenchAccessDeps) {
};
},
- async stopTask(params: { callerSessionId: string; taskId: string }) {
- const allowed = await authorize(params.callerSessionId, params.taskId);
- if (!allowed.ok) return allowed;
- if (allowed.target.kind !== 'session') {
- return { ok: false as const, errorCode: 'TASK_NOT_RUNNING', message: '这件事还没在 Cindy 里跑,没有可停的' };
- }
- const revoked = await stillGranted(allowed.botId, allowed.target.projectDir);
- if (revoked) return revoked;
- const stopped = await deps.stopSessionTurn({ targetSessionId: allowed.target.sessionId });
- if (!stopped.ok) return stopped;
- return { ok: true as const, taskId: allowed.target.sessionId, status: stopped.status };
- },
-
/**
* 渲染层详情视图读取同一份有界摘录。调用方是主人自己的界面(受信 renderer),
* 仍按该伙伴已接手的项目判定范围,不让详情视图成为读任意会话的入口。
diff --git a/apps/desktop/src/main/maker-ipc/botWorkbenchHandover.ts b/apps/desktop/src/main/maker-ipc/botWorkbenchHandover.ts
new file mode 100644
index 0000000000..dd2c05f470
--- /dev/null
+++ b/apps/desktop/src/main/maker-ipc/botWorkbenchHandover.ts
@@ -0,0 +1,80 @@
+/**
+ * 主人本人那一轮让伙伴记下的项目目录(add_workbench_project)的校验。
+ *
+ * 只收绝对路径(允许 `~/` 开头)且真实存在的目录;不收磁盘根目录、主目录,也不收 Cindy 自己的
+ * 数据目录——交出去的是项目,不是整台电脑。字面路径与符号链接指向的真实目录都要过这些规则,
+ * 链接不能绕开限制。记下的是字面路径,与工作台里点选目录的写法一致(任务的工作目录也按它匹配)。
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+
+export type HandoverDirectoryCheck =
+ | { ok: true; path: string }
+ | { ok: false; errorCode: 'INVALID_PROJECT_PATH' | 'NOT_A_DIRECTORY'; message: string };
+
+export interface HandoverDirectoryEnv {
+ homeDir: string;
+ userDataDir: string;
+ caseInsensitive: boolean;
+}
+
+function isInside(child: string, root: string, caseInsensitive: boolean): boolean {
+ const relative = path.relative(caseInsensitive ? root.toLowerCase() : root, caseInsensitive ? child.toLowerCase() : child);
+ return relative === '' || (!!relative && !relative.startsWith('..') && !path.isAbsolute(relative));
+}
+
+export async function checkHandoverDirectory(raw: string, env: HandoverDirectoryEnv): Promise<HandoverDirectoryCheck> {
+ const trimmed = raw.trim();
+ const expanded = trimmed === '~' || trimmed.startsWith('~/') ? path.join(env.homeDir, trimmed.slice(1)) : trimmed;
+ const invalid = (message: string): HandoverDirectoryCheck => ({ ok: false, errorCode: 'INVALID_PROJECT_PATH', message });
+ if (!path.isAbsolute(expanded)) return invalid('请给项目目录的绝对路径');
+ const resolved = path.resolve(expanded);
+ let real: string;
+ try {
+ if (!(await fs.stat(resolved)).isDirectory()) return { ok: false, errorCode: 'NOT_A_DIRECTORY', message: '这不是一个目录' };
+ real = await fs.realpath(resolved);
+ } catch {
+ return { ok: false, errorCode: 'NOT_A_DIRECTORY', message: '找不到这个目录' };
+ }
+ const home = path.resolve(env.homeDir);
+ const userData = path.resolve(env.userDataDir);
+ const [realHome, realUserData] = await Promise.all([
+ fs.realpath(home).catch(() => home),
+ fs.realpath(userData).catch(() => userData),
+ ]);
+ const same = (a: string, b: string) => (env.caseInsensitive ? a.toLowerCase() === b.toLowerCase() : a === b);
+ for (const candidate of [resolved, real]) {
+ if (path.parse(candidate).root === candidate || same(candidate, home) || same(candidate, realHome)) {
+ return invalid('不能把整个磁盘或主目录交给伙伴,请给具体的项目目录');
+ }
+ if (isInside(candidate, userData, env.caseInsensitive) || isInside(candidate, realUserData, env.caseInsensitive)) {
+ return invalid('这是 Cindy 自己的数据目录,不是项目');
+ }
+ }
+ return { ok: true, path: resolved };
+}
+
+/**
+ * 移除项目时找到工作台里对应的那一条:允许 `~/` 开头、尾斜杠、大小写不同(macOS / Windows 默认文件系统
+ * 不区分大小写),以及指向同一真实目录的符号链接。找不到返回 null。
+ */
+export async function findHandedProject(
+ raw: string,
+ directories: readonly string[],
+ env: Pick<HandoverDirectoryEnv, 'homeDir'> & { caseInsensitive: boolean },
+): Promise<string | null> {
+ const trimmed = raw.trim();
+ const expanded = trimmed === '~' || trimmed.startsWith('~/') ? path.join(env.homeDir, trimmed.slice(1)) : trimmed;
+ if (!path.isAbsolute(expanded)) return null;
+ const resolved = path.resolve(expanded);
+ const key = (value: string) => (env.caseInsensitive ? value.toLowerCase() : value);
+ const literal = directories.find((dir) => key(path.resolve(dir)) === key(resolved));
+ if (literal) return literal;
+ const real = await fs.realpath(resolved).catch(() => null);
+ if (!real) return null;
+ for (const dir of directories) {
+ const dirReal = await fs.realpath(dir).catch(() => null);
+ if (dirReal && key(dirReal) === key(real)) return dir;
+ }
+ return null;
+}
diff --git a/apps/desktop/src/main/maker-ipc/botWorkbenchTools.ts b/apps/desktop/src/main/maker-ipc/botWorkbenchTools.ts
index 1aec1437a3..504b4b857e 100644
--- a/apps/desktop/src/main/maker-ipc/botWorkbenchTools.ts
+++ b/apps/desktop/src/main/maker-ipc/botWorkbenchTools.ts
@@ -7,11 +7,14 @@
* - 本机 Claude Code / Codex / Pi 会话按固定的转录目录发现(`botWorkbenchSessionRoots.ts`),只看近期、
* 只读头尾;只有伙伴继续某一件时才经设置页同一条单条导入路径导入它(Pi 与导入不了的改开后台任务);
* - 项目素材 brief(文档路径、git、GitHub PR / issue)宿主现算、有界、带缓存;
- * - 继续 / 停止复用宿主已有的发消息与优雅停止路径(与 send_to_session、
- * stop_session_turn 同一条链路),由调用方注入。
+ * - 继续复用宿主已有的发消息路径(与 send_to_session 同一条链路),由调用方注入;停止走通用的
+ * stop_session_turn,不再有工作台专属的停止工具;
+ * - 主人本人那一轮可以让伙伴记下 / 移除一个已接手项目(add_workbench_project /
+ * remove_workbench_project),与工作台里「交给伙伴」写同一份记录。
*/
import { promises as fs } from 'node:fs';
import os from 'node:os';
+import path from 'node:path';
import { app } from 'electron';
@@ -35,9 +38,12 @@ import {
type WorkbenchDelegationStatus,
} from '../../shared/botWorkbench.js';
import {
+ addBotWorkbenchDirectory,
broadcastBotWorkbenchChanged,
deleteBotWorkbenchJudgment,
+ readBotWorkbenchDirectoryPaths,
readBotWorkbenchState,
+ removeBotWorkbenchDirectory,
rekeyBotWorkbenchJudgment,
setBotWorkbenchJudgment,
} from './botWorkbenchService.js';
@@ -48,9 +54,11 @@ import {
readSessionTranscript,
} from './botWorkbenchTranscripts.js';
import { workbenchSessionRoots } from './botWorkbenchSessionRoots.js';
+import { checkHandoverDirectory, findHandedProject } from './botWorkbenchHandover.js';
import { createBriefCache, type WorkbenchBriefGithubItem } from './botWorkbenchBrief.js';
import { readCanonicalSessionActivity } from './sessionActivityProjection.js';
import {
+ authorizeWorkbenchTarget,
createBotWorkbenchAccess,
type BotWorkbenchAccess,
type BotWorkbenchAccessDeps,
@@ -88,6 +96,17 @@ async function resolveWorkbenchCaller(callerSessionId: string): Promise<Workbenc
return { ok: true, botId: row.botId };
}
+/**
+ * 这件任务在不在主人交给该伙伴的项目里——与工作台继续同一判据。伙伴用通用会话工具
+ * 处理「主人事先安排」的一轮时,靠它决定能不能动这件任务(见 botTurnAuthority.ts)。
+ */
+export async function isWorkbenchProjectSession(botId: string, sessionId: string): Promise<boolean> {
+ const { directories } = await readBotWorkbenchState(ownerScopedUserDataPath(), botId);
+ if (directories.length === 0) return false;
+ const target = await readWorkbenchTarget(sessionId);
+ return authorizeWorkbenchTarget(target, directories, isCaseInsensitivePlatform(process.platform)).ok;
+}
+
async function readWorkbenchTarget(taskId: string): Promise<WorkbenchTargetFacts | null> {
const db = getDbClient().drizzle;
const [row] = await db
@@ -361,7 +380,7 @@ async function importExternalSession(
}
/** 投递、停止与开后台任务由调用方注入(与 send_to_session、stop_session_turn、start_session_task 同一条宿主路径)。 */
-export type BotWorkbenchSendDeps = Pick<BotWorkbenchAccessDeps, 'sendToSession' | 'stopSessionTurn' | 'startBackgroundTask'>;
+export type BotWorkbenchSendDeps = Pick<BotWorkbenchAccessDeps, 'sendToSession' | 'startBackgroundTask'>;
/**
* 按调用时的账号作用域组装一次工具服务:作用域在调用期间切换则中止,不做投递。
@@ -398,7 +417,6 @@ function createDesktopBotWorkbenchAccess(send: BotWorkbenchSendDeps): BotWorkben
listRoutines: listBotRoutines,
listSchedules: listProjectSchedules,
sendToSession: send.sendToSession,
- stopSessionTurn: send.stopSessionTurn,
caseInsensitive: isCaseInsensitivePlatform(process.platform),
isOwnerScopeCurrent: () => !isAppSessionBoundaryPending() && activeOwnerScopeKey() === scopeKey,
});
@@ -423,7 +441,6 @@ export async function runBotWorkbenchTool<T>(
const NO_SEND: BotWorkbenchSendDeps = {
sendToSession: async () => ({ ok: false, errorCode: 'UNSUPPORTED', message: 'read only' }),
- stopSessionTurn: async () => ({ ok: false, errorCode: 'UNSUPPORTED', message: 'read only' }),
startBackgroundTask: async () => ({ ok: false, errorCode: 'UNSUPPORTED', message: 'read only' }),
};
@@ -436,3 +453,81 @@ export async function readBotWorkbenchTaskForOwner(botId: string, taskId: string
export async function listBotWorkbenchCandidatesForOwner(botId: string) {
return runBotWorkbenchTool(NO_SEND, (access) => access.listCandidatesForOwner({ botId }));
}
+
+type ProjectFailure = { ok: false; errorCode: string; message: string };
+
+async function runProjectChange<T>(run: () => Promise<T | ProjectFailure>): Promise<T | ProjectFailure> {
+ if (isAppSessionBoundaryPending()) {
+ return { ok: false, errorCode: 'OWNER_SCOPE_CHANGED', message: '账号正在切换,请稍后重试' };
+ }
+ try {
+ return await run();
+ } catch (error) {
+ return { ok: false, errorCode: 'INTERNAL', message: error instanceof Error ? error.message : String(error) };
+ }
+}
+
+/**
+ * 伙伴按主人的话记下一个已接手项目。只认本机、在用的伙伴主任务;「只有主人本人那一轮能用」
+ * 由工具调用前的按轮判定保证(botTurnAuthority.ts 未列名的工具默认只放行主人本人那一轮)。
+ */
+export function addBotWorkbenchProjectForCaller(params: { callerSessionId: string; path: string }) {
+ return runProjectChange(async () => {
+ const scopeKey = activeOwnerScopeKey();
+ const userDataDir = ownerScopedUserDataPath();
+ const caller = await resolveWorkbenchCaller(params.callerSessionId);
+ if (!caller.ok) return caller;
+ const checked = await checkHandoverDirectory(params.path, {
+ homeDir: os.homedir(),
+ userDataDir: app.getPath('userData'),
+ caseInsensitive: isCaseInsensitivePlatform(process.platform),
+ });
+ if (!checked.ok) return checked;
+ if (isAppSessionBoundaryPending() || activeOwnerScopeKey() !== scopeKey) {
+ return { ok: false as const, errorCode: 'OWNER_SCOPE_CHANGED', message: '账号已切换,请重试' };
+ }
+ const added = await addBotWorkbenchDirectory(userDataDir, caller.botId, checked.path);
+ if (!added.ok) {
+ return {
+ ok: false as const,
+ errorCode: added.errorCode,
+ message: added.errorCode === 'TOO_MANY' ? '交给这个伙伴的项目已经太多了,先移除一些再加' : '这不是一个目录',
+ };
+ }
+ broadcastBotWorkbenchChanged(caller.botId);
+ const projectCount = (await readBotWorkbenchDirectoryPaths(userDataDir, caller.botId)).length;
+ return {
+ ok: true as const,
+ project: { name: path.basename(checked.path) || checked.path, path: checked.path },
+ projectCount,
+ };
+ });
+}
+
+/** 伙伴按主人的话移除一个已接手项目;项目里的任务、文件与伙伴写过的判断都不动。 */
+export function removeBotWorkbenchProjectForCaller(params: { callerSessionId: string; path: string }) {
+ return runProjectChange(async () => {
+ const scopeKey = activeOwnerScopeKey();
+ const userDataDir = ownerScopedUserDataPath();
+ const caller = await resolveWorkbenchCaller(params.callerSessionId);
+ if (!caller.ok) return caller;
+ const before = await readBotWorkbenchDirectoryPaths(userDataDir, caller.botId);
+ const matched = await findHandedProject(params.path, before, {
+ homeDir: os.homedir(),
+ caseInsensitive: process.platform === 'darwin' || isCaseInsensitivePlatform(process.platform),
+ });
+ if (!matched) {
+ return {
+ ok: false as const,
+ errorCode: 'PROJECT_NOT_IN_WORKBENCH',
+ message: `工作台里没有这个项目,没有移除任何东西。现在交给你的项目:${before.join('、') || '(无)'}`,
+ };
+ }
+ if (isAppSessionBoundaryPending() || activeOwnerScopeKey() !== scopeKey) {
+ return { ok: false as const, errorCode: 'OWNER_SCOPE_CHANGED', message: '账号已切换,请重试' };
+ }
+ await removeBotWorkbenchDirectory(userDataDir, caller.botId, matched);
+ broadcastBotWorkbenchChanged(caller.botId);
+ return { ok: true as const, path: matched, removed: true };
+ });
+}
diff --git a/apps/desktop/src/main/maker-ipc/pluginTaskInput.ts b/apps/desktop/src/main/maker-ipc/pluginTaskInput.ts
index 82bd072810..d98605620f 100644
--- a/apps/desktop/src/main/maker-ipc/pluginTaskInput.ts
+++ b/apps/desktop/src/main/maker-ipc/pluginTaskInput.ts
@@ -38,9 +38,15 @@ export async function hasAcceptedUserTaskInput(
AND COALESCE(json_extract(${meta}, '$.contextRebuild'), 0) != 1
AND (${isWorker ? 1 : 0} = 1 OR COALESCE(json_extract(${meta}, '$.origin.kind'), '') != 'orca')))`))
.orderBy(desc(messages.createdAt), desc(sql`messages.rowid`)).limit(1);
- if (!source || source.clientId.startsWith('plugin-task:')) return false;
+ return !!source && isAcceptedUserInputRow(source);
+}
+
+/** The persisted half of the evidence above: a root user row stamped by the trusted human input path. */
+export function isAcceptedUserInputRow(row: { clientId: string; agentMeta: string | null }): boolean {
+ if (row.clientId.startsWith('plugin-task:')) return false;
let evidence: Record<string, unknown> | null;
- try { evidence = JSON.parse(source.agentMeta ?? '{}'); } catch { return false; }
+ try { evidence = JSON.parse(row.agentMeta ?? '{}'); } catch { return false; }
+ const text = evidence?.autoReviewUserText;
return !!evidence && !evidence.origin && ['turn', 'steer'].includes(String(evidence.delivery))
- && authored(evidence.autoReviewUserText);
+ && typeof text === 'string' && !!text.trim() && !text.startsWith('[UI_ACTION_TRIGGER]');
}
diff --git a/apps/desktop/src/main/mcp-integrations/__tests__/helperSurface.test.ts b/apps/desktop/src/main/mcp-integrations/__tests__/helperSurface.test.ts
index edb1019543..0f0c414e78 100644
--- a/apps/desktop/src/main/mcp-integrations/__tests__/helperSurface.test.ts
+++ b/apps/desktop/src/main/mcp-integrations/__tests__/helperSurface.test.ts
@@ -11,6 +11,23 @@ describe('classifyHelperSurface', () => {
expect(classifyHelperSurface(source, hasBotLink)).toBe('bot');
});
+ it('gives only a local, active Bot main task the full gated surface', () => {
+ const main = { role: 'canonical', status: 'active', remoteHostId: null };
+ expect(classifyHelperSurface('bot', true, main)).toBe('bot-main');
+ for (const [source, link, patch] of [
+ ['bot', true, { role: 'group' }],
+ ['bot', true, { role: 'history' }],
+ ['bot', true, { role: null }],
+ ['bot', true, { status: 'archived' }],
+ ['bot', true, { remoteHostId: 'ssh-1' }],
+ ['bot', false, {}],
+ ['user', true, {}],
+ ] as const) {
+ expect(classifyHelperSurface(source, link, { ...main, ...patch })).toBe('bot');
+ }
+ expect(classifyHelperSurface('user', false, main)).toBe('default');
+ });
+
it('leaves ordinary tasks on the default surface', () => {
expect(classifyHelperSurface('user', false)).toBe('default');
expect(classifyHelperSurface(null, false)).toBe('default');
diff --git a/apps/desktop/src/main/mcp-integrations/__tests__/pluginTaskHelperScope.test.ts b/apps/desktop/src/main/mcp-integrations/__tests__/pluginTaskHelperScope.test.ts
index e048b3740f..5797827ec3 100644
--- a/apps/desktop/src/main/mcp-integrations/__tests__/pluginTaskHelperScope.test.ts
+++ b/apps/desktop/src/main/mcp-integrations/__tests__/pluginTaskHelperScope.test.ts
@@ -23,14 +23,14 @@ const wired = ts.transpileModule(`return {${callback}}.resolveSurface;`, {
function fixture() {
const sqlite = new Database(':memory:');
- sqlite.exec(`CREATE TABLE sessions(id TEXT PRIMARY KEY, source TEXT, cleared_at INTEGER DEFAULT 0);
+ sqlite.exec(`CREATE TABLE sessions(id TEXT PRIMARY KEY, source TEXT, cleared_at INTEGER DEFAULT 0, status TEXT DEFAULT 'active', remote_host_id TEXT);
CREATE TABLE messages(client_id TEXT, session_id TEXT, role TEXT, created_at INTEGER, agent_meta TEXT, rewind_at INTEGER);
- CREATE TABLE bot_session_links(session_id TEXT, bot_id TEXT);
+ CREATE TABLE bot_session_links(session_id TEXT, bot_id TEXT, role TEXT, archived_at INTEGER);
CREATE TABLE plugin_task_requests(id TEXT PRIMARY KEY, operation TEXT, payload TEXT);
CREATE TABLE orca_teams(id TEXT PRIMARY KEY, lead_session_id TEXT, status TEXT);
CREATE TABLE orca_workers(session_id TEXT PRIMARY KEY, team_id TEXT);
INSERT INTO sessions(id,source) VALUES ('lead','plugin'),('worker','orca'),('legacy','plugin'),('user','user'),('bot','bot');
- INSERT INTO bot_session_links VALUES ('bot','b');
+ INSERT INTO bot_session_links(session_id, bot_id) VALUES ('bot','b');
INSERT INTO plugin_task_requests VALUES ('lead','create','{}');
INSERT INTO orca_teams VALUES ('team','lead','completed');
INSERT INTO orca_workers VALUES ('worker','team');`);
@@ -46,7 +46,8 @@ function fixture() {
const searchStart = source.indexOf(' searchSessions:');
const search = source.slice(searchStart, source.indexOf(' logger:', searchStart));
const searchSessionsFn = vi.fn(async () => [{ sessionId: 'user', snippet: 'synthetic private message' }]);
- const searchDeps = { ...deps, searchSessionsFn };
+ // Production routes through the Bot-scope variant; ordinary and plugin callers never widen.
+ const searchDeps = { ...deps, searchSessionsWithBotScope: searchSessionsFn, botReadsAccountHistory: async () => false };
const searchWired = ts.transpileModule(`return {${search}}.searchSessions;`, {
compilerOptions: { target: ts.ScriptTarget.ES2022 },
}).outputText;
@@ -72,7 +73,7 @@ it.each(['lead', 'worker'])('restricts owned %s and preserves explicit revocatio
expect(await f.resolve({ sessionId: 'legacy' })).toBe('default');
expect(await f.resolve({ sessionId: 'user' })).toBe('default');
expect(await f.resolve({ sessionId: 'bot' })).toBe('bot');
- f.sqlite.exec(`INSERT INTO bot_session_links VALUES ('lead','b'); UPDATE plugin_task_requests SET payload='{}'`);
+ f.sqlite.exec(`INSERT INTO bot_session_links(session_id, bot_id) VALUES ('lead','b'); UPDATE plugin_task_requests SET payload='{}'`);
expect(await f.resolve({ sessionId })).toBe('restricted');
} finally { f.sqlite.close(); }
});
diff --git a/apps/desktop/src/main/mcp-integrations/helperSurface.ts b/apps/desktop/src/main/mcp-integrations/helperSurface.ts
index 02c79221ea..4f65cee559 100644
--- a/apps/desktop/src/main/mcp-integrations/helperSurface.ts
+++ b/apps/desktop/src/main/mcp-integrations/helperSurface.ts
@@ -5,12 +5,20 @@ import { hasAcceptedUserTaskInput, type AcceptedTaskInput } from '../maker-ipc/p
* Either legacy ownership signal is enough to keep a caller on the Bot surface.
* Requiring both lets a partial Bot record fall through to the full default
* surface, which includes Session control and history.
+ *
+ * A local, active Bot main task (`canonical` link on a `bot` source) is `bot-main`:
+ * it sees the ordinary surface plus Bot tools, and the host judges every call by
+ * who triggered the current turn (maker-ipc/botTurnAuthority.ts).
*/
export function classifyHelperSurface(
source: string | null | undefined,
hasBotLink: boolean,
-): 'bot' | 'default' {
- return source === 'bot' || hasBotLink ? 'bot' : 'default';
+ main?: { role: string | null | undefined; status: string | null | undefined; remoteHostId: string | null | undefined },
+): 'bot' | 'bot-main' | 'default' {
+ if (source !== 'bot' && !hasBotLink) return 'default';
+ return source === 'bot' && hasBotLink && main?.role === 'canonical' && main.status === 'active' && !main.remoteHostId
+ ? 'bot-main'
+ : 'bot';
}
/** Reuse the helper's existing runtime gate; plugin tasks need Orca, not account-wide helper tools. */
@@ -18,10 +26,15 @@ export async function resolveHelperSurface(
db: Pick<DbClient, 'queryOne' | 'drizzle'>,
sessionId: string,
readExecution: (sessionId: string) => { executing: boolean; input: AcceptedTaskInput | null },
-): Promise<'bot' | 'default' | 'restricted'> {
+): Promise<'bot' | 'bot-main' | 'default' | 'restricted'> {
const execution = readExecution(sessionId);
- const row = await db.queryOne<{ source: string; botId: string | null; pluginOwned: number; retainedPlugin: number; isWorker: number }>(
- `SELECT s.source AS source, b.bot_id AS botId, w.session_id IS NOT NULL AS isWorker,
+ const row = await db.queryOne<{
+ source: string; botId: string | null; botRole: string | null; status: string | null; remoteHostId: string | null;
+ pluginOwned: number; retainedPlugin: number; isWorker: number;
+ }>(
+ `SELECT s.source AS source, b.bot_id AS botId,
+ CASE WHEN b.archived_at IS NULL THEN b.role ELSE NULL END AS botRole, s.status AS status,
+ s.remote_host_id AS remoteHostId, w.session_id IS NOT NULL AS isWorker,
EXISTS (SELECT 1 FROM plugin_task_requests p
WHERE p.operation = 'create' AND p.id IN (s.id, t.lead_session_id)) AS retainedPlugin,
EXISTS (
@@ -52,5 +65,9 @@ export async function resolveHelperSurface(
|| (['clientId', 'autoResume', 'retrySourceClientId', 'authoredText', 'originKind'] as const)
.some(key => current.input?.[key] !== execution.input?.[key])) return 'restricted';
}
- return classifyHelperSurface(row.source, Boolean(row.botId));
+ return classifyHelperSurface(row.source, Boolean(row.botId), {
+ role: row.botRole,
+ status: row.status,
+ remoteHostId: row.remoteHostId,
+ });
}
diff --git a/apps/desktop/src/main/mcp-integrations/mcp-providers.ts b/apps/desktop/src/main/mcp-integrations/mcp-providers.ts
index d58d7c1761..692719550e 100644
--- a/apps/desktop/src/main/mcp-integrations/mcp-providers.ts
+++ b/apps/desktop/src/main/mcp-integrations/mcp-providers.ts
@@ -45,7 +45,7 @@ import { createLogger } from '../logger.js';
import { checkAppUpdateForAgent } from '../updateService.js';
import { getScheduler } from '../scheduler-host/index.js';
import { stabilizeHookCommand } from '../scheduler-host/hook-script-generator.js';
-import { searchSessionsFn } from '../maker-host/session-search.js';
+import { searchSessionsWithBotScope } from '../maker-host/session-search.js';
import { readLspModeSettings } from '../maker-host/lsp-mode-store.js';
import {
tryGetBotDelegationService,
@@ -71,7 +71,14 @@ import {
listBotSkillsForSession,
saveBotSkillForSession,
} from '../maker-ipc/botSkillService.js';
-import { runBotWorkbenchTool, type BotWorkbenchSendDeps } from '../maker-ipc/botWorkbenchTools.js';
+import {
+ addBotWorkbenchProjectForCaller,
+ isWorkbenchProjectSession,
+ removeBotWorkbenchProjectForCaller,
+ runBotWorkbenchTool,
+ type BotWorkbenchSendDeps,
+} from '../maker-ipc/botWorkbenchTools.js';
+import { createBotToolCallAuthorizer, resolveBotCallerAuthority } from '../maker-ipc/botToolCallAuthorizer.js';
import {
patchSessionMetaInDb,
renameSessionTitlesInDb,
@@ -179,12 +186,6 @@ export function createDesktopMcpProviders(deps: DesktopMcpProvidersDeps): LiziMc
}
: { ok: false as const, errorCode: result.errorCode, message: result.message };
}),
- stopSessionTurn: wrap(async (svc, params) => {
- const result = await svc.stopSessionTurn(params);
- return result.ok
- ? { ok: true as const, status: result.status }
- : { ok: false as const, errorCode: result.errorCode, message: result.message };
- }),
startBackgroundTask: async ({ callerSessionId, workingDir, title, objective }) => {
const svc = tryGetBotDelegationService();
if (!svc) return { ok: false, errorCode: 'HOST_NOT_READY', message: 'Session task service not initialized' };
@@ -195,6 +196,21 @@ export function createDesktopMcpProviders(deps: DesktopMcpProvidersDeps): LiziMc
},
};
+ // 伙伴主任务的每次调用按「这一轮是谁触发的」判定(maker-ipc/botTurnAuthority.ts)。
+ const authorizeBotToolCall = createBotToolCallAuthorizer({
+ getDb: () => (isAppSessionBoundaryPending() ? null : tryGetDbClient()),
+ readExecution: (sessionId) => getSessionInputProvenance(sessionId),
+ isWorkbenchProjectSession,
+ isScopeCurrent: (db) => !isAppSessionBoundaryPending() && db === tryGetDbClient(),
+ });
+ /** 伙伴主任务在主人本人或主人事先安排的那一轮里可以读全部历史;其余伙伴调用仍只读自己的记录。 */
+ const botReadsAccountHistory = async (callerSessionId: string | undefined): Promise<boolean> => {
+ const dbClient = tryGetDbClient();
+ if (!dbClient || !callerSessionId || isAppSessionBoundaryPending()) return false;
+ const caller = await resolveBotCallerAuthority(dbClient, callerSessionId, getSessionInputProvenance);
+ return caller.kind === 'bot' && caller.main && caller.authority !== 'other';
+ };
+
const withAccountDataAccess = async <T>(sessionId: string | undefined, operation: (assertCurrent: () => Promise<void>) => Promise<T>): Promise<T> => {
const dbClient = tryGetDbClient();
if (!dbClient || !sessionId) throw new Error('Account data caller unavailable');
@@ -331,6 +347,7 @@ export function createDesktopMcpProviders(deps: DesktopMcpProvidersDeps): LiziMc
},
scheduler: {
withAccountDataAccess,
+ authorizeCall: authorizeBotToolCall,
getScheduler: () => getScheduler(),
// 前置检查脚本统一安装服务:落盘路径/协议/自测与 UI「AI 生成」共用同一实现
// (hook-script-generator)。lazy import:该链上有 electron app 依赖,且 maker
@@ -411,7 +428,9 @@ export function createDesktopMcpProviders(deps: DesktopMcpProvidersDeps): LiziMc
throw new Error('Task history search is unavailable for plugin-managed tasks');
if (isAppSessionBoundaryPending() || dbClient !== tryGetDbClient())
throw new Error('Task history caller unavailable');
- const hits = await searchSessionsFn(query, opts);
+ const hits = await searchSessionsWithBotScope(query, opts, {
+ botAccountWide: await botReadsAccountHistory(opts.callerSessionId),
+ });
if (isAppSessionBoundaryPending() || dbClient !== tryGetDbClient())
throw new Error('Task history caller unavailable');
if (await resolveHelperSurface(dbClient, opts.callerSessionId, getSessionInputProvenance) === 'restricted')
@@ -485,7 +504,14 @@ export function createDesktopMcpProviders(deps: DesktopMcpProvidersDeps): LiziMc
},
},
sessionTags: async (callerSessionId, request) => {
- const result = await executeTaskTags(request, callerSessionId);
+ // 伙伴主任务只在主人本人那一轮能管标签(调用入口已按轮次放行,这里再核一次);
+ // 伙伴自己的会话仍不出现在标签里。
+ const dbClient = tryGetDbClient();
+ const caller = dbClient && callerSessionId && !isAppSessionBoundaryPending()
+ ? await resolveBotCallerAuthority(dbClient, callerSessionId, getSessionInputProvenance)
+ : null;
+ const ownerTurnBot = caller?.kind === 'bot' && caller.main && caller.authority === 'owner';
+ const result = await executeTaskTags(request, callerSessionId, { trustedBotOwnerTurn: ownerTurnBot });
return ['update', 'delete'].includes(request.action) ? { ...result, sessions: [] } : result;
},
createProject,
@@ -577,6 +603,8 @@ export function createDesktopMcpProviders(deps: DesktopMcpProvidersDeps): LiziMc
};
}
},
+ // 伙伴主任务的每次调用按本轮来源判定;放在 resolveSurface 之前,与工具面分类各自独立。
+ authorizeCall: authorizeBotToolCall,
resolveSurface: async ({ sessionId }) => {
const dbClient = tryGetDbClient();
if (!dbClient || isAppSessionBoundaryPending()) return 'restricted';
@@ -875,15 +903,17 @@ export function createDesktopMcpProviders(deps: DesktopMcpProvidersDeps): LiziMc
},
list: (params) => listBotSkillsForSession(params),
},
- // 工作台:伙伴继续 / 停止主人交给它的项目里的任务。授权在 botWorkbenchAccess 里逐次
- // 确定性校验;投递与停止复用 send_to_session / stop_session_turn 的同一条宿主路径。
+ // 工作台:伙伴继续主人交给它的项目里的任务,或按主人本人的话记下 / 移除项目。授权在
+ // botWorkbenchAccess 里逐次确定性校验;投递复用 send_to_session 的同一条宿主路径。
+ // 停止走通用的 stop_session_turn。
botWorkbench: {
get: (params) => runBotWorkbenchTool(workbenchSend, (access) => access.get(params)),
read: (params) => runBotWorkbenchTool(workbenchSend, (access) => access.read(params)),
set: (params) => runBotWorkbenchTool(workbenchSend, (access) => access.set(params)),
setMany: (params) => runBotWorkbenchTool(workbenchSend, (access) => access.setMany(params)),
continueTask: (params) => runBotWorkbenchTool(workbenchSend, (access) => access.continueTask(params)),
- stopTask: (params) => runBotWorkbenchTool(workbenchSend, (access) => access.stopTask(params)),
+ addProject: (params) => addBotWorkbenchProjectForCaller(params),
+ removeProject: (params) => removeBotWorkbenchProjectForCaller(params),
},
skillhub: createSkillhubAgentTools({
isCurrentSession: (context) => !!context.sessionId
@@ -893,6 +923,7 @@ export function createDesktopMcpProviders(deps: DesktopMcpProvidersDeps): LiziMc
history: {
resolveSessionScope: async ({ callerSessionId, callerMemoryScopeKey }) => {
try {
+ if (await botReadsAccountHistory(callerSessionId)) return { ok: true, sessionIds: null };
const sessionIds = await resolveBotHistorySessionIds(
callerSessionId,
callerMemoryScopeKey,
diff --git a/apps/desktop/src/preload/preload.ts b/apps/desktop/src/preload/preload.ts
index 849472e2dc..204cfba768 100644
--- a/apps/desktop/src/preload/preload.ts
+++ b/apps/desktop/src/preload/preload.ts
@@ -5516,6 +5516,8 @@ contextBridge.exposeInMainWorld('electronAPI', {
ipcRenderer.invoke('local-db:bots:workbench:read-task', botId, taskId),
candidates: (botId: string): Promise<unknown> =>
ipcRenderer.invoke('local-db:bots:workbench:candidates', botId),
+ followScopes: (): Promise<unknown> =>
+ ipcRenderer.invoke('local-db:bots:workbench:follow-scopes'),
},
listSkills: (botId: string): Promise<import('../shared/botSkill').BotSkillSummary[]> =>
ipcRenderer.invoke('local-db:bots:skills:list', botId),
diff --git a/apps/desktop/src/renderer/features/bots/BotCapabilitySettings.tsx b/apps/desktop/src/renderer/features/bots/BotCapabilitySettings.tsx
index 27b301e994..6ec64f77ac 100644
--- a/apps/desktop/src/renderer/features/bots/BotCapabilitySettings.tsx
+++ b/apps/desktop/src/renderer/features/bots/BotCapabilitySettings.tsx
@@ -165,7 +165,7 @@ export function BotCapabilitySettings({
}));
if (toolsetResult.status === 'fulfilled')
next.toolset = toolsetResult.value
- .filter((item) => !['memory', 'xdt_helper', 'collab'].includes(item.id))
+ .filter((item) => !['memory', 'xdt_helper', 'scheduler', 'collab'].includes(item.id))
.map((item) => ({
id: item.id,
name: item.name,
diff --git a/apps/desktop/src/renderer/features/bots/BotFollowMark.tsx b/apps/desktop/src/renderer/features/bots/BotFollowMark.tsx
new file mode 100644
index 0000000000..b93ffa8da2
--- /dev/null
+++ b/apps/desktop/src/renderer/features/bots/BotFollowMark.tsx
@@ -0,0 +1,27 @@
+import { Tip } from '@/components/ui/tooltip';
+import { useStableTranslation as useTranslation } from '@/hooks/useStableTranslation';
+import { BotAvatar } from './BotAvatar';
+import type { BotProfile } from './botStore';
+
+export { useSessionFollowers } from './botFollowScopes';
+
+/**
+ * 普通任务行上的「<伙伴>在跟进」:这件任务所在的项目交给了哪个伙伴。只显示第一位伙伴的
+ * 14px 头像(头像底色是伙伴身份,不是状态),悬停说明全部伙伴。没有伙伴跟进时不占位。
+ * 行组件用 `useSessionFollowers(session)` 取伙伴列表,自己决定要不要为标记让位。
+ */
+export function BotFollowMark({ followers }: { followers: readonly BotProfile[] }) {
+ const { t, i18n } = useTranslation();
+ const first = followers[0];
+ if (!first) return null;
+ const names = new Intl.ListFormat(i18n.language, { style: 'long', type: 'conjunction' })
+ .format(followers.map((bot) => bot.name));
+ const label = t('bots.workbench.followingMark', { names });
+ return (
+ <Tip text={label}>
+ <span role="img" aria-label={label} className="inline-flex shrink-0" data-testid="bot-follow-mark">
+ <BotAvatar bot={first} size="xs" className="h-3.5 w-3.5 text-10" />
+ </span>
+ </Tip>
+ );
+}
diff --git a/apps/desktop/src/renderer/features/bots/__tests__/botFollowMark.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/botFollowMark.test.tsx
new file mode 100644
index 0000000000..bafbe59210
--- /dev/null
+++ b/apps/desktop/src/renderer/features/bots/__tests__/botFollowMark.test.tsx
@@ -0,0 +1,107 @@
+// @vitest-environment jsdom
+
+import { act, cleanup, render, screen } from '@testing-library/react';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import type { Session } from '@/lib/ccAgent.types';
+
+const h = vi.hoisted(() => ({
+ profiles: [] as Array<Record<string, unknown>>,
+}));
+
+vi.mock('react-i18next', () => ({
+ useTranslation: () => ({
+ t: (key: string, options?: { names?: string }) => `${key}:${options?.names ?? ''}`,
+ i18n: { language: 'en' },
+ }),
+}));
+vi.mock('../botStore', () => ({
+ useBotProfiles: () => h.profiles,
+ hasLoadedBotProfiles: () => true,
+ ensureBotProfilesLoaded: vi.fn(async () => h.profiles),
+}));
+
+import { BotFollowMark, useSessionFollowers } from '../BotFollowMark';
+import { __testing } from '../botFollowScopes';
+
+function Row({ session: value }: { session: Session }) {
+ return <BotFollowMark followers={useSessionFollowers(value)} />;
+}
+
+const bot = (id: string, name: string, patch: Record<string, unknown> = {}) => ({
+ id, name, avatar: '', avatarColor: 'blue', enabled: true, status: 'active', hiddenAt: null, ...patch,
+});
+const session = (patch: Partial<Session> = {}) => ({
+ id: 's1', status: 'active', source: 'desktop', workingDir: '/Users/me/repo/packages/app', ...patch,
+}) as Session;
+
+let changed: (() => void) | null = null;
+const followScopes = vi.fn(async () => [{ botId: 'bot-1', directories: ['/Users/me/repo'] }]);
+
+beforeEach(() => {
+ __testing.reset();
+ h.profiles = [bot('bot-1', 'Dash'), bot('bot-2', 'Lizi')];
+ followScopes.mockClear();
+ (window as unknown as { electronAPI: unknown }).electronAPI = {
+ platform: 'darwin',
+ localDb: { bots: { workbench: { followScopes } } },
+ maker: { onBotWorkbenchChanged: (cb: () => void) => { changed = cb; return () => { changed = null; }; } },
+ };
+});
+afterEach(() => {
+ cleanup();
+ delete (window as unknown as { electronAPI?: unknown }).electronAPI;
+});
+
+describe('BotFollowMark', () => {
+ it('marks a task inside a handed-over project with its Bot, loading the scopes once for all rows', async () => {
+ await act(async () => {
+ render(<><Row session={session()} /><Row session={session({ id: 's2' })} /></>);
+ });
+ const marks = screen.getAllByTestId('bot-follow-mark');
+ expect(marks).toHaveLength(2);
+ expect(marks[0]!.getAttribute('aria-label')).toBe('bots.workbench.followingMark:Dash');
+ expect(followScopes).toHaveBeenCalledTimes(1);
+ });
+
+ it('stays empty outside the project, for Bot-owned or remote tasks, and for hidden Bots', async () => {
+ await act(async () => {
+ render(<>
+ <Row session={session({ workingDir: '/Users/me/repo-old' })} />
+ <Row session={session({ source: 'bot' })} />
+ <Row session={session({ remoteHostId: 'ssh-1' })} />
+ </>);
+ });
+ expect(screen.queryByTestId('bot-follow-mark')).toBeNull();
+
+ cleanup();
+ h.profiles = [bot('bot-1', 'Dash', { hiddenAt: 1 })];
+ await act(async () => { render(<Row session={session()} />); });
+ expect(screen.queryByTestId('bot-follow-mark')).toBeNull();
+ });
+
+ it('retries a failed first load instead of leaving the marker missing', async () => {
+ vi.useFakeTimers();
+ try {
+ followScopes.mockRejectedValueOnce(new Error('host not ready'));
+ await act(async () => { render(<Row session={session()} />); });
+ expect(screen.queryByTestId('bot-follow-mark')).toBeNull();
+ await act(async () => { await vi.advanceTimersByTimeAsync(2_000); });
+ expect(screen.getByTestId('bot-follow-mark')).toBeTruthy();
+ expect(followScopes).toHaveBeenCalledTimes(2);
+ } finally {
+ vi.useRealTimers();
+ }
+ });
+
+ it('reloads when a workbench changes', async () => {
+ await act(async () => { render(<Row session={session()} />); });
+ followScopes.mockResolvedValueOnce([
+ { botId: 'bot-1', directories: ['/Users/me/repo'] },
+ { botId: 'bot-2', directories: ['/Users/me'] },
+ ]);
+ await act(async () => { changed?.(); });
+ expect(screen.getByTestId('bot-follow-mark').getAttribute('aria-label'))
+ .toBe('bots.workbench.followingMark:Dash and Lizi');
+ });
+});
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 7fb41f5439..4dd7a2783b 100644
--- a/apps/desktop/src/renderer/features/bots/__tests__/botSettings.test.tsx
+++ b/apps/desktop/src/renderer/features/bots/__tests__/botSettings.test.tsx
@@ -225,7 +225,7 @@ beforeEach(() => {
mocks.listAgentSkills.mockReset().mockResolvedValue({ success: true, skills: [{ name: 'release-check' }] });
mocks.listToolsets.mockReset().mockResolvedValue([
{ id: 'docs', name: 'Documents', effectiveEnabled: true, available: true },
- { id: 'scheduler', name: 'Scheduler', effectiveEnabled: true, available: true },
+ { id: 'browser', name: 'Browser', effectiveEnabled: true, available: true },
{ id: 'contacts', name: 'Contacts', effectiveEnabled: true, available: false },
]);
mocks.listCustomMcpServers.mockReset();
@@ -1008,13 +1008,13 @@ describe('same-Bot capability updates while editing settings', () => {
const view = renderSettings({ capabilities: capabilities({ toolsetMode: 'allowlist' }) });
await openCapabilities();
fireEvent.change(screen.getByLabelText('bots.nameLabel'), { target: { value: 'Local name' } });
- fireEvent.click(screen.getByRole('checkbox', { name: 'Scheduler' }));
+ fireEvent.click(screen.getByRole('checkbox', { name: 'Browser' }));
view.rerender(<BotSettings bot={bot({ currentVersion: 2, capabilities: capabilities({ toolsetMode: 'allowlist', toolsets: ['docs'] }) })} onBack={view.onBack} onOpenSession={view.onOpenSession} />);
expect((screen.getByLabelText('bots.nameLabel') as HTMLInputElement).value).toBe('Local name');
expect((screen.getByRole('checkbox', { name: 'Documents' }) as HTMLInputElement).checked).toBe(true);
- expect((screen.getByRole('checkbox', { name: 'Scheduler' }) as HTMLInputElement).checked).toBe(true);
+ expect((screen.getByRole('checkbox', { name: 'Browser' }) as HTMLInputElement).checked).toBe(true);
await act(async () => { await vi.advanceTimersByTimeAsync(0); });
- expect(mocks.updateBotProfile).toHaveBeenLastCalledWith('bot-1', { name: 'Local name', capabilities: { toolsets: ['docs', 'scheduler'] }, capabilityBaseline: { toolsets: ['docs'] } });
+ expect(mocks.updateBotProfile).toHaveBeenLastCalledWith('bot-1', { name: 'Local name', capabilities: { toolsets: ['docs', 'browser'] }, capabilityBaseline: { toolsets: ['docs'] } });
});
it('explains a rename that collides with another teammate instead of a generic save failure', async () => {
diff --git a/apps/desktop/src/renderer/features/bots/botFollowScopes.ts b/apps/desktop/src/renderer/features/bots/botFollowScopes.ts
new file mode 100644
index 0000000000..c72b86edc1
--- /dev/null
+++ b/apps/desktop/src/renderer/features/bots/botFollowScopes.ts
@@ -0,0 +1,152 @@
+/**
+ * 侧栏「<伙伴>在跟进」的数据:每个在用的本机伙伴接手了哪些项目。
+ *
+ * 整个窗口共享一份:第一次有任务行订阅时读一次,之后只在伙伴工作台变化或换账号时重读。
+ * 任务行各自只做本地匹配(与工作台同一套项目归属规则 `findWorkbenchProject`),不各自发 IPC。
+ */
+import { useMemo, useSyncExternalStore } from 'react';
+
+import { getDataOwnerGeneration, isDataOwnerGenerationCurrent } from '@/contexts/dataOwnerGeneration';
+import type { Session } from '@/lib/ccAgent.types';
+import { createLogger } from '@/lib/logger';
+
+import {
+ findWorkbenchProject,
+ isCaseInsensitivePlatform,
+ isWorkbenchTaskSource,
+} from '../../../shared/botWorkbench';
+import { ensureBotProfilesLoaded, hasLoadedBotProfiles, useBotProfiles, type BotProfile } from './botStore';
+
+const log = createLogger('BotFollowScopes');
+
+export interface BotFollowScope {
+ botId: string;
+ directories: readonly string[];
+}
+
+const EMPTY: readonly BotFollowScope[] = [];
+
+let scopes: readonly BotFollowScope[] = EMPTY;
+let owner = getDataOwnerGeneration();
+let requested = false;
+let loadSeq = 0;
+let changeSubscribed = false;
+const listeners = new Set<() => void>();
+
+function emit(): void {
+ for (const listener of listeners) listener();
+}
+
+/** 读取失败(例如刚启动时本机数据还没就绪)时有限次退避重试,不让标记一直缺失。 */
+const RETRY_DELAYS_MS = [2_000, 5_000, 15_000, 30_000];
+let retryTimer: ReturnType<typeof setTimeout> | null = null;
+
+function load(attempt = 0): void {
+ const api = window.electronAPI?.localDb?.bots?.workbench?.followScopes;
+ if (!api) return;
+ if (retryTimer) {
+ clearTimeout(retryTimer);
+ retryTimer = null;
+ }
+ const seq = ++loadSeq;
+ const loadOwner = getDataOwnerGeneration();
+ void api()
+ .then((next) => {
+ if (seq !== loadSeq || !isDataOwnerGenerationCurrent(loadOwner)) return;
+ scopes = Array.isArray(next) ? next : EMPTY;
+ // 名字与头像来自伙伴列表;侧栏还没打开过伙伴页时顺带读一次。
+ if (scopes.length > 0 && !hasLoadedBotProfiles()) {
+ void ensureBotProfilesLoaded().catch((error: unknown) => log.warn('Bot profiles load failed', error));
+ }
+ emit();
+ })
+ .catch((error: unknown) => {
+ log.warn('Bot follow scopes load failed', error);
+ const delay = RETRY_DELAYS_MS[attempt];
+ if (seq !== loadSeq || delay === undefined) return;
+ retryTimer = setTimeout(() => {
+ retryTimer = null;
+ if (seq === loadSeq && isDataOwnerGenerationCurrent(loadOwner)) load(attempt + 1);
+ }, delay);
+ });
+}
+
+/** 换账号时清空并重读;快照读取里只重置,不同步发 IPC。 */
+function ensureOwner(): void {
+ if (isDataOwnerGenerationCurrent(owner)) return;
+ owner = getDataOwnerGeneration();
+ scopes = EMPTY;
+ requested = false;
+}
+
+function subscribe(listener: () => void): () => void {
+ listeners.add(listener);
+ if (!changeSubscribed) {
+ // 窗口级订阅,不随任务行挂载 / 卸载反复增删(侧栏滚动时行会频繁重建)。
+ const off = window.electronAPI?.maker?.onBotWorkbenchChanged?.(() => load());
+ changeSubscribed = off !== undefined;
+ }
+ ensureOwner();
+ if (!requested) {
+ requested = true;
+ load();
+ }
+ return () => {
+ listeners.delete(listener);
+ };
+}
+
+function getSnapshot(): readonly BotFollowScope[] {
+ if (!isDataOwnerGenerationCurrent(owner)) {
+ ensureOwner();
+ queueMicrotask(() => {
+ if (requested) return;
+ requested = true;
+ load();
+ });
+ }
+ return scopes;
+}
+
+/** 能被伙伴跟进的任务:本机、未归档、普通来源、不是伙伴自己的任务或 Orca worker。 */
+function isFollowableSession(session: Session): boolean {
+ if (session.status !== 'active' || !session.workingDir) return false;
+ if (session.remoteHostId || session.deviceLinkDeviceId) return false;
+ if (session.source === 'bot' || session.orcaRole === 'worker') return false;
+ return isWorkbenchTaskSource(session.source);
+}
+
+/** 正在跟进这件任务所在项目的伙伴(按名字排序;隐藏、停用的伙伴不显示)。 */
+export function useSessionFollowers(session: Session): BotProfile[] {
+ const followScopes = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+ const profiles = useBotProfiles();
+ const followable = isFollowableSession(session);
+ const workingDir = session.workingDir;
+ return useMemo(() => {
+ if (!followable || followScopes.length === 0) return [];
+ const caseInsensitive = isCaseInsensitivePlatform(window.electronAPI?.platform);
+ const following = new Set(
+ followScopes
+ .filter((scope) => findWorkbenchProject(workingDir, scope.directories, caseInsensitive) !== null)
+ .map((scope) => scope.botId),
+ );
+ if (following.size === 0) return [];
+ return profiles
+ .filter((bot) => following.has(bot.id) && bot.enabled && !bot.hiddenAt
+ && (bot.status === undefined || bot.status === 'active'))
+ .sort((a, b) => a.name.localeCompare(b.name));
+ }, [followable, followScopes, profiles, workingDir]);
+}
+
+export const __testing = {
+ reset(): void {
+ if (retryTimer) clearTimeout(retryTimer);
+ retryTimer = null;
+ scopes = EMPTY;
+ owner = getDataOwnerGeneration();
+ requested = false;
+ loadSeq = 0;
+ changeSubscribed = false;
+ listeners.clear();
+ },
+};
diff --git a/apps/desktop/src/renderer/features/cc-agent/sidebar/SessionCard.tsx b/apps/desktop/src/renderer/features/cc-agent/sidebar/SessionCard.tsx
index 668457b45e..105ff19587 100644
--- a/apps/desktop/src/renderer/features/cc-agent/sidebar/SessionCard.tsx
+++ b/apps/desktop/src/renderer/features/cc-agent/sidebar/SessionCard.tsx
@@ -84,6 +84,7 @@ import { useRemoteSessionActivity } from '@/features/device-link/remoteSessionAc
import { useSessionBoundSchedules } from '@/features/scheduler/lib/scheduleSessionBinding';
import { projectSidebarSessionActivity, resolveSidebarRightStatus } from './sidebarRightStatus';
import { Tip } from '@/components/ui/tooltip';
+import { BotFollowMark, useSessionFollowers } from '@/features/bots/BotFollowMark';
import { SidebarRightStatusIndicator } from './SidebarRightStatusIndicator';
import { shouldPrefetchSessionOnPointerDown } from './sessionSwitchPrefetch';
import { useCindyMakeActivity } from './useCindyMakeActivity';
@@ -157,6 +158,9 @@ export const SessionCard = withSidebarNavigation<SessionCardProps>(function Sess
sharedTaskRole,
}: SessionCardProps & SidebarNavigationProps) {
const { t } = useTranslation();
+ const followers = useSessionFollowers(session);
+ // 标题后常显的标记:任务标签色球与「伙伴在跟进」头像。浮出操作钮与归档确认胶囊按它让位。
+ const hasTitleMarks = !!session.tags?.length || followers.length > 0;
const cindyMakeActivity = useCindyMakeActivity(session);
const cindyMakePreparing = cindyMakeActivity === 'building' ? undefined : cindyMakeActivity;
// mod+1..9 序号徽标:模块 store 按 sessionId 精准订阅,非按住态恒为 null。
@@ -793,6 +797,7 @@ export const SessionCard = withSidebarNavigation<SessionCardProps>(function Sess
</SidebarTitleMarquee>
{/* 任务标签常显、紧跟标题,不属于任务信息复选。 */}
<TaskTagDots tags={session.tags} />
+ <BotFollowMark followers={followers} />
{remoteIconKind && (
<RemoteProjectIcon
kind={remoteIconKind}
@@ -960,7 +965,7 @@ export const SessionCard = withSidebarNavigation<SessionCardProps>(function Sess
!navigationOnly &&
!isEditing &&
!archivePending &&
- !!session.tags?.length &&
+ hasTitleMarks &&
(menuPos !== null
? 'pr-14'
: 'group-hover/card:pr-14 peer-focus-within/card-actions:pr-14'),
@@ -986,15 +991,16 @@ export const SessionCard = withSidebarNavigation<SessionCardProps>(function Sess
})
: displayTitle}
</div>
- {/* 任务标签常显、紧跟标题首行;标题两行截断时色球不被裁掉。 */}
- {!isEditing && session.tags?.length ? (
- <span className="flex h-[1.22em] shrink-0 items-center text-12">
+ {/* 任务标签与「伙伴在跟进」常显、紧跟标题首行;标题两行截断时不被裁掉。 */}
+ {!isEditing && hasTitleMarks ? (
+ <span className="flex h-[1.22em] shrink-0 items-center gap-1.5 text-12">
<TaskTagDots tags={session.tags} />
+ <BotFollowMark followers={followers} />
</span>
) : null}
{/* 归档确认胶囊的隐形同款占位:与胶囊同文案同样式,按实际宽度让位。
外包零高度容器只取宽度,不撑高单行标题,确认态卡片高度与瀑布流不动。 */}
- {!isEditing && canQuickArchive && archivePending && session.tags?.length ? (
+ {!isEditing && canQuickArchive && archivePending && hasTitleMarks ? (
<span aria-hidden className="h-0 shrink-0 overflow-hidden">
<Button
variant="secondary"
diff --git a/apps/desktop/src/renderer/features/cc-agent/sidebar/SessionItem.tsx b/apps/desktop/src/renderer/features/cc-agent/sidebar/SessionItem.tsx
index 0d392aac12..1730480f9a 100644
--- a/apps/desktop/src/renderer/features/cc-agent/sidebar/SessionItem.tsx
+++ b/apps/desktop/src/renderer/features/cc-agent/sidebar/SessionItem.tsx
@@ -81,6 +81,7 @@ import { SessionProjectMoveSubmenu } from './SessionProjectMoveSubmenu';
import type { SessionMoveTarget } from './sessionMoveTarget';
import type { FolderPickerOption } from '@/components/new-chat/FolderPickerPopover';
import { RemoteProjectIcon } from './RemoteProjectIcon';
+import { BotFollowMark, useSessionFollowers } from '@/features/bots/BotFollowMark';
import { SessionShareExportDialog } from './SessionShareExportDialog';
import { isRemoteSessionWriteBlocked } from '../lib/remoteSessionWriteGuard';
import { Tip } from '@/components/ui/tooltip';
@@ -344,6 +345,7 @@ export const SessionItem = withSidebarNavigation<SessionItemProps>(function Sess
sharedTaskRole,
}: SessionItemProps & SidebarNavigationProps) {
const { t } = useTranslation();
+ const followers = useSessionFollowers(session);
const cindyMakeActivity = useCindyMakeActivity(session);
const cindyMakePreparing = cindyMakeActivity === 'building' ? undefined : cindyMakeActivity;
const prRefs = usePrRefsForSession(session.id);
@@ -1064,6 +1066,8 @@ export const SessionItem = withSidebarNavigation<SessionItemProps>(function Sess
</SidebarTitleMarquee>
{/* 任务标签常显、紧跟标题,不属于任务信息复选;标题过长时标题截断让位。 */}
<TaskTagDots tags={session.tags} />
+ {/* 这件任务所在的项目交给了伙伴时,显示伙伴头像(伙伴在跟进)。 */}
+ <BotFollowMark followers={followers} />
{remoteIconKind && (
<RemoteProjectIcon
kind={remoteIconKind}
diff --git a/apps/desktop/src/renderer/i18n/locales/en/common.json b/apps/desktop/src/renderer/i18n/locales/en/common.json
index a922ae102e..78fded9734 100644
--- a/apps/desktop/src/renderer/i18n/locales/en/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/en/common.json
@@ -7899,6 +7899,7 @@
"message": "Follow up on “{{title}}”",
"aria": "Follow up on “{{title}}”"
},
+ "followingMark": "Looked after by {{names}}",
"olderCount_one": "{{count}} older",
"olderCount_other": "{{count}} older",
"kind": {
diff --git a/apps/desktop/src/renderer/i18n/locales/ja/common.json b/apps/desktop/src/renderer/i18n/locales/ja/common.json
index 14ae1eff0a..74f9c56cab 100644
--- a/apps/desktop/src/renderer/i18n/locales/ja/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/ja/common.json
@@ -7887,6 +7887,7 @@
"message": "「{{title}}」を進めて",
"aria": "「{{title}}」を進める"
},
+ "followingMark": "このプロジェクトの担当: {{names}}",
"olderCount_other": "さらに前の {{count}} 件",
"kind": {
"existing": "既存のセッション",
diff --git a/apps/desktop/src/renderer/i18n/locales/ko/common.json b/apps/desktop/src/renderer/i18n/locales/ko/common.json
index 236f5d01d3..8942f97359 100644
--- a/apps/desktop/src/renderer/i18n/locales/ko/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/ko/common.json
@@ -7887,6 +7887,7 @@
"message": "「{{title}}」 이어서 진행해 줘",
"aria": "「{{title}}」 진행하기"
},
+ "followingMark": "이 프로젝트 담당: {{names}}",
"olderCount_other": "이전 {{count}}개",
"kind": {
"existing": "기존 세션",
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 3140b1615c..64205d97d9 100644
--- a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
@@ -7887,6 +7887,7 @@
"message": "跟进「{{title}}」",
"aria": "跟进「{{title}}」"
},
+ "followingMark": "{{names}}在跟进这个项目",
"olderCount_other": "更早的 {{count}} 个",
"kind": {
"existing": "原有任务",
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 17a5ce7598..aef3be6cd4 100644
--- a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
@@ -7887,6 +7887,7 @@
"message": "跟進「{{title}}」",
"aria": "跟進「{{title}}」"
},
+ "followingMark": "{{names}}在跟進這個專案",
"olderCount_other": "更早的 {{count}} 個",
"kind": {
"existing": "原有任務",
diff --git a/apps/desktop/src/renderer/vite-env.d.ts b/apps/desktop/src/renderer/vite-env.d.ts
index cb223c9086..7b7a2ea61c 100644
--- a/apps/desktop/src/renderer/vite-env.d.ts
+++ b/apps/desktop/src/renderer/vite-env.d.ts
@@ -4812,6 +4812,8 @@ interface ElectronAPI {
}
| { ok: false; errorCode: string; message: string }
>;
+ /** 每个在用的本机伙伴接手的项目目录(侧栏「在跟进」标记用)。 */
+ followScopes: () => Promise<Array<{ botId: string; directories: string[] }>>;
};
listSkills: (botId: string) => Promise<import('../shared/botSkill').BotSkillSummary[]>;
memory: {
diff --git a/apps/desktop/src/shared/botWorkbench.ts b/apps/desktop/src/shared/botWorkbench.ts
index 2af5c6c414..3e48eb0062 100644
--- a/apps/desktop/src/shared/botWorkbench.ts
+++ b/apps/desktop/src/shared/botWorkbench.ts
@@ -8,8 +8,11 @@
*/
import { normalizeWorkingDirForGrouping, normalizeWorkingDirForStorage } from './workingDir';
-/** 主人最多交给一个伙伴几个项目;与存储层的上限同源。 */
-export const BOT_WORKBENCH_MAX_DIRECTORIES = 6;
+/**
+ * 交给一个伙伴的项目数的防护上限(不是产品限制):工作台是伙伴的负责范围,主人交多少都行;
+ * 这里只防一份失控的 workbench.json 拖垮读取与素材计算。与存储层的上限同源。
+ */
+export const BOT_WORKBENCH_MAX_DIRECTORIES = 50;
/** 主人交给伙伴的项目目录。目录本身由宿主记录,`exists` 是读取时现查的事实。 */
export interface BotWorkbenchDirectory {
diff --git a/docs/design-rules/design-inventory.md b/docs/design-rules/design-inventory.md
index dda5a0be76..25f5d362f6 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, BotGroupChatView, BotGroupCreateDialog, BotGroupSettingsDrawer, 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/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.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/GhostCardHostPrompts.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/UserAttachmentChip.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/messageNavigationProjection.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/streamingMessageProjection.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/ComposerAttachments.tsx, 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/LocalModelCatalogNotice.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/PluginWriteAccessRecovery.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/BotGroupAvatars.tsx, apps/desktop/src/renderer/features/bots/BotGroupChatView.tsx, apps/desktop/src/renderer/features/bots/BotGroupComposer.tsx, apps/desktop/src/renderer/features/bots/BotGroupCreateDialog.tsx, apps/desktop/src/renderer/features/bots/BotGroupPendingInteraction.tsx, apps/desktop/src/renderer/features/bots/BotGroupPlan.tsx, apps/desktop/src/renderer/features/bots/BotGroupSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotGroupSidebarSection.tsx, apps/desktop/src/renderer/features/bots/BotHistorySessionView.tsx, apps/desktop/src/renderer/features/bots/BotImportForm.tsx, apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx, apps/desktop/src/renderer/features/bots/BotLearningFooter.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/BotSessionTaskResultCard.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/BotTaskCardHeader.tsx, apps/desktop/src/renderer/features/bots/BotTaskModelEditor.tsx, apps/desktop/src/renderer/features/bots/BotWorkbench.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/RemoteBotSettings.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/botGroupAttachments.ts, apps/desktop/src/renderer/features/bots/botGroupLane.ts, apps/desktop/src/renderer/features/bots/botGroupMentions.ts, apps/desktop/src/renderer/features/bots/botGroupPresentation.ts, apps/desktop/src/renderer/features/bots/botGroupStore.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/botWorkbenchProjection.ts, apps/desktop/src/renderer/features/bots/cindyDeviceRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotSettingsData.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/useBotUnreadSync.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 | 280 | 41 | 492 |
+| `desktop.bots` | desktop | 伙伴(列表 / 对话 / 设置 / 历史 / 伙伴私聊 / 群聊) | hash `/bots`、`/bots/list`、`/bots/:botId`、`/bots/roster` 及伙伴当前/历史任务、伙伴私聊、伙伴群聊路由(BotsFeatureLayout) | BotBasicProfileFields, BotCollaborationCard, BotDirectMessageView, BotGroupChatView, BotGroupCreateDialog, BotGroupSettingsDrawer, 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/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.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/GhostCardHostPrompts.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/UserAttachmentChip.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/messageNavigationProjection.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/streamingMessageProjection.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/ComposerAttachments.tsx, 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/LocalModelCatalogNotice.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/PluginWriteAccessRecovery.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/BotFollowMark.tsx, apps/desktop/src/renderer/features/bots/BotGenerationLabel.tsx, apps/desktop/src/renderer/features/bots/BotGroupAvatars.tsx, apps/desktop/src/renderer/features/bots/BotGroupChatView.tsx, apps/desktop/src/renderer/features/bots/BotGroupComposer.tsx, apps/desktop/src/renderer/features/bots/BotGroupCreateDialog.tsx, apps/desktop/src/renderer/features/bots/BotGroupPendingInteraction.tsx, apps/desktop/src/renderer/features/bots/BotGroupPlan.tsx, apps/desktop/src/renderer/features/bots/BotGroupSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotGroupSidebarSection.tsx, apps/desktop/src/renderer/features/bots/BotHistorySessionView.tsx, apps/desktop/src/renderer/features/bots/BotImportForm.tsx, apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx, apps/desktop/src/renderer/features/bots/BotLearningFooter.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/BotSessionTaskResultCard.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/BotTaskCardHeader.tsx, apps/desktop/src/renderer/features/bots/BotTaskModelEditor.tsx, apps/desktop/src/renderer/features/bots/BotWorkbench.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/RemoteBotSettings.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/botFollowScopes.ts, apps/desktop/src/renderer/features/bots/botGeneratedArtifacts.ts, apps/desktop/src/renderer/features/bots/botGroupAttachments.ts, apps/desktop/src/renderer/features/bots/botGroupLane.ts, apps/desktop/src/renderer/features/bots/botGroupMentions.ts, apps/desktop/src/renderer/features/bots/botGroupPresentation.ts, apps/desktop/src/renderer/features/bots/botGroupStore.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/botWorkbenchProjection.ts, apps/desktop/src/renderer/features/bots/cindyDeviceRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotSettingsData.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/useBotUnreadSync.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 | 280 | 41 | 492 |
| `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/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.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/GhostCardHostPrompts.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/UserAttachmentChip.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/messageNavigationProjection.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/streamingMessageProjection.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/ComposerAttachments.tsx, 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/LocalModelCatalogNotice.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/PluginWriteAccessRecovery.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 | 41 | 357 |
diff --git a/docs/product-rules/cindy-bots-runtime.md b/docs/product-rules/cindy-bots-runtime.md
index e700832dee..eb29b7d515 100644
--- a/docs/product-rules/cindy-bots-runtime.md
+++ b/docs/product-rules/cindy-bots-runtime.md
@@ -262,12 +262,13 @@ harness + provider + model + effort + fastMode
交互迁移到 IM 后仍受同一暂停与取消边界约束;暂停期间收到的渠道回答或安全超时决定暂存,
恢复后只生效一次,取消优先撤销暂存回答。恢复依据宿主实际应用回执清理等待状态,
已应用的回答不再通知发起伙伴;确实未答的交互仍重新通知。渠道卡片的回答状态不表示引擎已恢复。
- 这些模式都只作用于调用伙伴拥有的后台任务;通用 Session control 类不因此开放给伙伴。
+ 这些模式都只作用于调用伙伴拥有的后台任务。本机伙伴主任务另外拿到和普通任务同一套通用 Session
+ 工具,能做多少由宿主按这一轮是谁触发的逐次判定,见 6.4。
主人通过工作台交给伙伴的项目里的原有任务,另走 6.3 的工作台工具,不经过这些后台任务入口。
伙伴可以登记、列出、重命名和隐藏账号项目,也可以把已有的非伙伴任务移入或移出项目。
移动任务必须已经持有该任务的 session id,不能按标题枚举其他任务。远程伙伴不获得这些工具。
- 这不包含停止、插话、改运行时、改名、归档、标签或读取其他任务的历史与输入队列;
- 唯一例外是 6.3:主人明确交给伙伴的项目里的任务可以查看、继续与停止当前轮。
+ 群专线、历史等伙伴非主任务与远程伙伴仍不包含停止、插话、改运行时、改名、归档、标签或读取其他任务的
+ 历史与输入队列;本机伙伴主任务按 6.4 获得这些能力。
`check_session_task.control.last_stop_request` 保留最近一次优雅停止请求的时间、返回状态和轮次;
它是历史回执,实际是否停稳仍看 `stop_status`,重启不会重放停止请求或冻结下一轮。
@@ -441,7 +442,8 @@ Session 任务遵守同一套机制与呈现契约:
### 6.3 工作台:主人交给伙伴的项目
-2026-10-01 产品裁决(用户已同意):伙伴可以查看、继续、停止「用户明确交给它的项目」里的任务。
+2026-10-01 产品裁决(用户已同意):伙伴可以查看、继续「用户明确交给它的项目」里的任务(停止走通用的
+`stop_session_turn`,按 6.4 逐轮判定)。2026-10-02 起工作台是伙伴的「负责范围」:不设项目数上限,主人可以口头交代。
同日用户实机试用后多次修订,最终口径:
1. **接手 = 理解,不是搬运**——伙伴先读懂项目里已有的工作,写下判断;主人点头(或点「跟进」)的那一件才
@@ -451,10 +453,12 @@ Session 任务遵守同一套机制与呈现契约:
3. **项目里的任务都是伙伴知道的项目事务**——已接手项目里的 Cindy 任务(包括主人之后自己开的)不论伙伴判断
过没有都在工作台上、也都在 `get_workbench` 里;只有还没导入的外部会话要等伙伴判断后才上工作台。
-- **授权来源**:只来自主人在伙伴工作台里点「交给<伙伴>」的那一次。宿主把项目目录记在该伙伴
- Home 的 `workbench.json`(`directories`,最多 6 个,去重),主人可以随时在工作台上移除,移除
- 即收回。模型不能自己添加项目,工具不接受 botId。移除在进行中的调用里同样生效:返回内容、投递、停止
- 之前宿主会再确认一次项目仍在。
+- **授权来源**:只来自主人的「交给<伙伴>」——在伙伴工作台里点选,或主人本人那一轮口头交代、伙伴用
+ `add_workbench_project` 记下(只在主人本人发话的那一轮可用,见 6.4;只收存在的绝对路径目录,不收磁盘根目录、
+ 主目录与 Cindy 数据目录,符号链接按它指向的真实目录同样判定)。宿主把项目目录记在该伙伴 Home 的 `workbench.json`(`directories`,去重;
+ 不设产品上限,只有 50 个的防护上限),主人可以随时在工作台上移除,或让伙伴用 `remove_workbench_project`
+ 移除,移除即收回,项目里的任务、文件与伙伴写过的判断都不动。工具不接受 botId。移除在进行中的调用里同样
+ 生效:返回内容、投递之前宿主会再确认一次项目仍在。
- **范围**:已接手项目里的普通本机任务(项目目录本身及其子目录,按目录边界比较;worktree 归到主仓库;
交了嵌套的项目时归到最深的那个);工作目录
落在已接手项目内的本机 Claude Code / Codex / Pi 会话;已接手项目 GitHub 远端上的 PR 与 issue;
@@ -488,7 +492,8 @@ Session 任务遵守同一套机制与呈现契约:
优先,最多 30 条,剩余名额给本机 Claude Code / Codex / Pi 会话,合计最多 40 条,每条带稳定的 `taskId`(Cindy 任务用 session id,本机会话用
`claude:<id>` / `codex:<id>` / `pi:<id>`)、来源、清洗过的标题、最近活动、运行状态(只有 Cindy 任务有)、
`digest`(起始目的 ≤ 200 字 + 最后 2–3 条各 ≤ 300 字)和伙伴之前写过的判断;伙伴写过的 PR / issue /
- 建议条目原样带回;另附 `olderCount`、伙伴自己的例行任务与项目里的自动化。
+ 建议条目原样带回;另附 `olderCount`、伙伴自己的例行任务与项目里的自动化。项目很多时只有最近交代的
+ 前 8 个现算 brief,其余项目 `brief` 为 null,伙伴需要时用自己的文件工具看。
- `read_workbench_task`:digest 不够判断时才用;只读一件会话最近的用户 / 助手文字(约 4000 字),
本机会话只读转录头尾,不写库、不导入。PR / issue / 建议没有对话记录,返回 `TASK_NOT_READABLE`。
- `set_workbench_task` / `set_workbench_tasks`(批量 1–30 条,逐条校验、一次广播):伙伴写下理解——
@@ -503,13 +508,13 @@ Session 任务遵守同一套机制与呈现契约:
Pi 会话、导入不了的会话(例如转录在另一个 Cindy profile 里)以及 PR / issue / 建议条目:宿主按条目
所属项目目录开一条伙伴后台任务(与 `start_session_task` 同一条服务端路径),目标 = 条目标题 + 伙伴的
话 + 参考与摘要,原条目从工作台移除,之后它就是一条普通的「你交代的」后台任务。没写过判断的 PR /
- issue / 建议不能继续。`stop_workbench_task` 请求优雅停止当前一轮,不删除任务。
+ issue / 建议不能继续。工作台不再有专用的停止工具:停止当前一轮用通用的 `stop_session_turn`。
- 工具说明写清做法:先 `get_workbench`,再用自己的文件工具读 brief 里最前面的一两份文档(README / DESIGN /
AGENTS 之类),然后看提交(非 git 目录看最近改过的文件)和 digest,用 `set_workbench_tasks` 一次写完,只对
拿不准的几件 `read_workbench_task`;判断要体现对项目的理解,不只复述会话;文档、最近的 PR 与 issue 同样是
素材。主人提到项目、让跟进或问进展时先看工作台。写完后在聊天里用几句话告诉主人没做完
的几件与值得做的几件,问主人接着做哪件,不自作主张开始做。只有本机、在用的伙伴主任务可以调用;远程
- 伙伴不提供工作台。
+ 伙伴不提供工作台。读写工作台与继续任务只在主人本人与主人事先安排的那两档可用(6.4)。
- **校验位置**:每次调用在 main 里确定性校验(`maker-ipc/botWorkbenchAccess.ts`),越权返回明确
错误码且不读、不写、不投递;工作台详情视图读同一份摘录时也按该伙伴已接手的项目判定范围。
- **工作台显示什么**:已接手项目里最近 30 天的 Cindy 任务一律列出——包括主人自己开的、伙伴还没判断过的;
@@ -546,10 +551,61 @@ Session 任务遵守同一套机制与呈现契约:
「已停用」。导入来的自动化
待适配的具体原因存于加密的导入环境里,工作台暂不单独呈现。
- 伙伴用 `start_session_task` 在已接手项目里开的任务照常是后台任务,同时出现在工作台的任务列表里。
+- **侧栏「在跟进」标记**:普通任务所在的项目交给了伙伴时,左侧任务行标题后(任务标签之后)显示该伙伴的
+ 14px 头像,悬停说明「<伙伴>在跟进这个项目」;有多个伙伴时显示按名字排第一的,悬停列出全部。只认本机、
+ 在用、未隐藏的伙伴;哪些任务算、项目怎么匹配与上面的「范围」同一套规则(`findWorkbenchProject`)。
+ 数据经 `local-db:bots:workbench:follow-scopes` 一次取回各伙伴的项目路径(只给路径,不带判断与会话内容),
+ 整个窗口共享一份,工作台变化或换账号时重读。
- 界面:工作台是本机伙伴主任务全局右侧栏里的一个标签(与文件、浏览器并列),首次进入时自动创建
并展开右侧栏;伙伴聊天头部常驻「工作台」入口,标签被关掉后可重新打开;伙伴页保留全局右侧栏的其它能力。
Mobile 与远程伙伴暂不提供。
+### 6.4 伙伴主任务的 session 能力:按这一轮是谁触发的判定
+
+2026-10-02 产品裁决(用户已同意):本机伙伴主任务和普通任务拿同一套 session 工具——查看全部任务并读全文,
+发消息、插话、停止,开新任务、选模型,归档、改名、打标签,建普通自动化。伙伴不再比普通任务「权限更低」。
+
+- **工具列表在整个会话里不变**(前缀缓存规则):本机伙伴主任务的 `cindy_helper` 是普通任务的全部类目加
+ `bots` 类目;伙伴基线挂载 `memory`、`xdt_helper` 与 `scheduler`(`maker-host/plugins/types.ts`)。
+ 能做多少不靠增删工具,而是每次调用时由宿主判定(`maker-ipc/botTurnAuthority.ts`、
+ `maker-ipc/botToolCallAuthorizer.ts`),判档只看宿主持有的事实,不看模型说了什么。
+- **三档**:
+ - **主人本人**:主人在伙伴聊天里的输入(桌面、手机、同账号设备,含工作台按钮代发),由可信输入通道盖章,
+ 判据与插件任务「真人接管」共用 `hasAcceptedUserTaskInput`。= 全套。
+ - **主人事先安排**:自动化 / 例行任务的运行、伙伴自己开的后台任务回报或等待交互、账号授权完成后的续跑。
+ = 读全部任务与历史;只动自己开的任务和已接手项目里的任务;不新建、不修改自动化,不改账号设置
+ (应用默认模型、项目改名移除与移动任务等),不接手或移除项目,不新建伙伴、不改自己的资料与能力(回报里可能
+ 夹带网页等外部内容,不能让它永久改变伙伴)。可以写例行任务与工作台判断、登记新项目。
+ - **其它**:其他伙伴的消息、别的任务转来的消息,以及认不出来的。= 只动自己开的任务、只读自己的记录
+ (伙伴的 session 与它开的后台任务);不新建伙伴,不改自己的资料与能力(这些持久生效,不能由别的来源引出)。
+- **插话不沿用档位**:这一轮开始后若有别的任务或伙伴用插话(steer)塞进输入,这一轮按「其它」判定;
+ 主人自己在输入框插话不算。伙伴私信、群消息、授权续跑一律排队成新的一轮,不会插进正在跑的那一轮。
+- **续跑不抬档**:后台任务回报、等待交互与授权续跑本身不是主人说的话,可信程度不高于引出它们的那一轮——
+ 由主人本人或自动化引出的算「主人事先安排」,由「其它」那一轮引出的仍是「其它」(否则开个后台任务就能
+ 抬档)。回溯最多 4 层,更深按「其它」。
+- **按目标判定的动作**:停止、插话、改运行时、改排队消息、给已有任务发话、改名、归档 / 取消归档,在后两档逐个
+ 核对目标任务(「主人事先安排」认自己的任务与已接手项目里的任务,「其它」只认自己的任务),批量里有一件越界就整批拒绝。
+ 开新任务、打标签、项目整理(改名 / 移除项目、移动任务)、改应用默认模型、接手或移除工作台项目、新建伙伴、
+ 改伙伴自己的资料与能力只在主人本人那一轮。
+- **默认拒绝**:判定表里没有登记的工具(含将来新增的)只在主人本人那一轮放行。被拒返回
+ `OWNER_TURN_REQUIRED` 或 `TASK_OUT_OF_SCOPE`,伙伴照实告诉主人、等主人自己说,不换工具绕过。
+- **「自己开的任务」**:该伙伴的 `bot_session_links` 与它开的后台任务(`bot_delegations.child_session_id`)。
+ 「已接手项目里的任务」与工作台继续同一判据(`isWorkbenchProjectSession`)。
+- **历史范围**:前两档读全部历史(`list_sessions` / `get_chat_history` / `search_chat_history` 与记忆的
+ 会话搜索);「其它」档只读自己的记录,含自己开的后台任务的转录。
+- **不变的部分**:远程伙伴、群专线与历史等伙伴非主任务保持原来的窄能力面且不按轮判定;唯一例外是自动化——
+ 它在这台电脑上(远程 Pi 经隧道挂到),远程伙伴调用时同样按本节分档。普通任务操作伙伴 session 的方式不变(标签仍不打到伙伴的任务上)。保留语义独特的伙伴工具
+ (`start/check/message/stop_session_task`、路由工具、`continue_workbench_task`、`read_workbench_task`、
+ `get_workbench`、`set_workbench_task(s)`),只删掉纯重复的 `stop_workbench_task`。
+- **这不是安全边界**:分档防的是伙伴误操作、以及别的来源借伙伴的会话工具动主人的任务;它不是沙箱。伙伴主任务
+ 本身有命令行等原生工具(沿用普通任务权限),开出的后台任务也是能力完整的普通任务(6.1),这些都不受本节分档
+ 约束。提示词明确要求伙伴被拒后不换工具、不开后台任务、不用命令行、不请别的伙伴去做被拒的事。判定入口认不出
+ 调用方(拿不到 session)时一律拒绝。
+- **范围是这台电脑**:伙伴看得到、管得了的是这台电脑上 Cindy 记录的任务;别的电脑上的任务看不到,远程伙伴(在别的
+ 电脑上运行的伙伴)没有这套能力;工作台不收 SSH 远程任务。跨电脑另行设计。
+- **提示词**:伙伴主任务的「你会做什么」里加「你能看、能管主人的任务」(三档与被拒怎么办)和
+ 「你能建普通自动化」(只在主人本人那一轮)两块,只在本机主任务注入。
+
## 7. 实现红线
- 生命周期、fallback、所有权和重放判定必须在宿主代码中确定性实现,不能只写进 prompt。
@@ -585,8 +641,11 @@ Codex 切模型重建时,线程索引里的路径不等于文件已经落盘
- 伙伴会话的上下文里没有项目 / 全局 AGENTS.md、CLAUDE.md 与 Cindy 产品提示词。
- `start_session_task` 能:任务卡实时更新到终态、挂起交互回到伙伴代答、完成唤醒信号对用户不可见;每次执行收口另存可展开的结果入口(按任务与执行轮次去重),历史原卡不移动。结果入口直接展示该次结果与文件,超时复用既有终态归一;当次失败原因随回执保存,桌面与手机仅在用户展开错误详情后显示,续跑不改写旧回执。忙时排队、过程收拢和重新打开不影响读取;阅读历史时沿用新消息提示,不强拉到底部。
父任务异常恢复后仍投递到当前主任务;check / message / stop 都只能控制它创建的 Session 任务。
- 主人交给伙伴的项目里的原有任务只能经 6.3 的工作台工具查看、继续与停止,越权(项目外、伙伴隐藏任务、
+ 主人交给伙伴的项目里的原有任务经 6.3 的工作台工具查看、继续,越权(项目外、伙伴隐藏任务、
非主任务调用、远程、归档)一律被宿主拒绝。
+- 本机伙伴主任务的通用 session 工具按 6.4 逐轮判定:主人本人那一轮全套可用;主人事先安排的那一轮只能动
+ 自己的任务与已接手项目里的任务、不能建自动化;其它来源只能动自己的任务、只读自己的记录;后台任务回报不高于
+ 引出它的那一轮;没登记的工具默认只在主人本人那一轮放行。
- 伙伴主聊天通知优先使用当前已完成轮次的最终回复纯文本摘要;Markdown 转为可读文字后才截断,遵守推送协议的 UTF-16 长度上限且不拆分代理对。无可用正文时使用本地化新回复兜底;沿用通知开关及系统预览隐私,静默自动化仍不外发。普通任务保留任务通知语义。
- 完成信号临时失败与 Host 重启后会幂等补投;等待事项在重启恢复期间保持可见且不消耗执行期限。
- `send_to_agent` 的同一伙伴对最多 12 条、单方最多连续 2 条;达到上限和空闲超时都会结束本轮。
diff --git a/packages/lizi-mcps/src/__tests__/botWorkbenchTool.test.ts b/packages/lizi-mcps/src/__tests__/botWorkbenchTool.test.ts
index d1b22b1c45..2a47591f7e 100644
--- a/packages/lizi-mcps/src/__tests__/botWorkbenchTool.test.ts
+++ b/packages/lizi-mcps/src/__tests__/botWorkbenchTool.test.ts
@@ -58,10 +58,15 @@ function setup(sessionId: string | null = 'bot-session') {
delivery: 'queued' as const,
queuedMessageId: 'q-1',
})),
- stopTask: vi.fn(async ({ taskId }: { taskId: string }) => ({
+ addProject: vi.fn(async ({ path }: { path: string }) => ({
ok: true as const,
- taskId,
- status: 'requested' as const,
+ project: { name: 'repo', path },
+ projectCount: 1,
+ })),
+ removeProject: vi.fn(async ({ path }: { path: string }) => ({
+ ok: true as const,
+ path,
+ removed: true,
})),
};
const reg = new XdtHelperToolRegistry();
@@ -80,7 +85,7 @@ describe('bot workbench tools', () => {
expect(callbacks.get).toHaveBeenCalledWith({ callerSessionId: 'bot-session' });
});
- it('continues and stops a task by id, never by a caller-supplied Bot or project', async () => {
+ it('continues a task by id, never by a caller-supplied Bot or project', async () => {
const { reg, callbacks } = setup();
expect(parse(await reg.call('continue_workbench_task', { task_id: 'task-1', message: '把剩下的导出做完' })))
.toMatchObject({ ok: true, task_id: 'task-1', delivery: 'queued', queued_message_id: 'q-1' });
@@ -89,9 +94,16 @@ describe('bot workbench tools', () => {
taskId: 'task-1',
message: '把剩下的导出做完',
});
- expect(parse(await reg.call('stop_workbench_task', { task_id: 'task-1' })))
- .toMatchObject({ ok: true, task_id: 'task-1', status: 'requested' });
- expect(callbacks.stopTask).toHaveBeenCalledWith({ callerSessionId: 'bot-session', taskId: 'task-1' });
+ });
+
+ it('hands projects over and back through the caller Session only', async () => {
+ const { reg, callbacks } = setup();
+ expect(parse(await reg.call('add_workbench_project', { path: '/Users/me/repo' })))
+ .toMatchObject({ ok: true, project: { name: 'repo', path: '/Users/me/repo' }, project_count: 1 });
+ expect(callbacks.addProject).toHaveBeenCalledWith({ callerSessionId: 'bot-session', path: '/Users/me/repo' });
+ expect(parse(await reg.call('remove_workbench_project', { path: '/Users/me/repo' })))
+ .toMatchObject({ ok: true, path: '/Users/me/repo', removed: true });
+ expect(callbacks.removeProject).toHaveBeenCalledWith({ callerSessionId: 'bot-session', path: '/Users/me/repo' });
});
it('reads a candidate and records a judgment for it', async () => {
@@ -179,16 +191,18 @@ describe('bot workbench tools', () => {
it('requires a bound Bot session', async () => {
const { reg, callbacks } = setup(null);
expect(parse(await reg.call('get_workbench', {}))).toMatchObject({ ok: false, errorCode: 'NOT_A_BOT_SESSION' });
- expect(parse(await reg.call('stop_workbench_task', { task_id: 'task-1' })))
+ expect(parse(await reg.call('add_workbench_project', { path: '/Users/me/repo' })))
.toMatchObject({ ok: false, errorCode: 'NOT_A_BOT_SESSION' });
expect(callbacks.get).not.toHaveBeenCalled();
- expect(callbacks.stopTask).not.toHaveBeenCalled();
+ expect(callbacks.addProject).not.toHaveBeenCalled();
});
- it('no longer offers the card-writing tool', () => {
+ it('no longer offers the card-writing or duplicate stop tool', () => {
const { reg } = setup();
expect(reg.has('update_workbench')).toBe(false);
- for (const name of ['get_workbench', 'read_workbench_task', 'set_workbench_task', 'set_workbench_tasks', 'continue_workbench_task', 'stop_workbench_task']) {
+ // Stopping goes through the general stop_session_turn, judged per turn by the host.
+ expect(reg.has('stop_workbench_task')).toBe(false);
+ for (const name of ['get_workbench', 'read_workbench_task', 'set_workbench_task', 'set_workbench_tasks', 'continue_workbench_task', 'add_workbench_project', 'remove_workbench_project']) {
expect(reg.has(name)).toBe(true);
}
});
diff --git a/packages/lizi-mcps/src/__tests__/cindy_schedulerMcpServer.test.ts b/packages/lizi-mcps/src/__tests__/cindy_schedulerMcpServer.test.ts
index c480bdc357..933d81ec43 100644
--- a/packages/lizi-mcps/src/__tests__/cindy_schedulerMcpServer.test.ts
+++ b/packages/lizi-mcps/src/__tests__/cindy_schedulerMcpServer.test.ts
@@ -281,6 +281,37 @@ describe('cindy_scheduler MCP server (in-process smoke)', () => {
await h.cleanup();
});
+ it('asks the host before each call and does not run a denied one', async () => {
+ await h.cleanup();
+ const storage = new InMemoryStorage();
+ const scheduler = new Scheduler({
+ storage, runner: noopRunner, clock: new FakeClock(), generateId: makeIdGen(), tickIntervalMs: 60_000_000,
+ });
+ const authorizeCall = vi.fn(async ({ tool }: { tool: string }) => (tool === 'schedule_create'
+ ? { ok: false as const, errorCode: 'OWNER_TURN_REQUIRED', message: 'owner only' }
+ : { ok: true as const }));
+ const server = createSchedulerMcpServer({ getScheduler: () => scheduler, authorizeCall });
+ const [clientTx, serverTx] = InMemoryTransport.createLinkedPair();
+ const client = new Client({ name: 'scheduler-gate', version: '0.0.0' });
+ await Promise.all([server.connect(serverTx), client.connect(clientTx)]);
+ try {
+ const denied = await client.callTool({
+ name: 'call_tool',
+ arguments: { name: 'schedule_create', args: baseCreate as unknown as Record<string, unknown> },
+ });
+ const deniedPayload = JSON.parse((denied.content as Array<{ text: string }>)[0]!.text) as Record<string, unknown>;
+ expect(deniedPayload).toMatchObject({ ok: false, errorCode: 'OWNER_TURN_REQUIRED' });
+ expect(await scheduler.list()).toHaveLength(0);
+ expect(authorizeCall).toHaveBeenCalledWith(expect.objectContaining({ server: 'cindy_scheduler', tool: 'schedule_create' }));
+
+ const listed = await client.callTool({ name: 'call_tool', arguments: { name: 'schedule_list', args: {} } });
+ expect(parseToolResult(listed as { content: unknown[]; isError?: boolean }).envelope).toMatchObject({ ok: true });
+ } finally {
+ await client.close();
+ await server.close();
+ }
+ });
+
it('call_tool(schedule_create) creates a schedule and call_tool(schedule_list) returns it (same payload as scheduler.list)', async () => {
// schedule_create
const created = await h.client.callTool({
diff --git a/packages/lizi-mcps/src/__tests__/lizi_xdtHelperMcpServer.test.ts b/packages/lizi-mcps/src/__tests__/lizi_xdtHelperMcpServer.test.ts
index 5273070247..4f9911b45a 100644
--- a/packages/lizi-mcps/src/__tests__/lizi_xdtHelperMcpServer.test.ts
+++ b/packages/lizi-mcps/src/__tests__/lizi_xdtHelperMcpServer.test.ts
@@ -843,6 +843,117 @@ describe("cindy_helper MCP server", () => {
}
});
+ it("gives a local Bot main task the ordinary surface and judges every call with the host", async () => {
+ const stopSessionTurn = vi.fn(async () => ({ ok: true as const, status: "requested" as const }));
+ const messageAgent = vi.fn(async () => ({
+ ok: true as const,
+ targetBotId: "bot-b",
+ targetBotName: "Dash Bot",
+ targetSessionId: "bot-b-main",
+ wakeKind: "queued" as const,
+ }));
+ const authorizeCall = vi.fn(async ({ tool }: { tool: string }) => (tool === "stop_session_turn"
+ ? { ok: false as const, errorCode: "TASK_OUT_OF_SCOPE", message: "not yours" }
+ : { ok: true as const }));
+ const server = createXdtHelperMcpServer(
+ {
+ resolveSurface: async () => "bot-main",
+ authorizeCall,
+ sessionControl: {
+ updateQueuedMessage: vi.fn(),
+ cancelQueuedMessage: vi.fn(),
+ steerSession: vi.fn(),
+ stopSessionTurn,
+ getSessionRuntime: vi.fn(),
+ setSessionRuntime: vi.fn(),
+ },
+ botMessaging: { messageAgent },
+ },
+ { agentKind: "pi", workingDir: "/bot", sessionId: "bot-a-main" },
+ );
+ const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+ const client = new Client({ name: "bot-main-surface", version: "0.0.0" });
+ await Promise.all([server.connect(serverTransport), client.connect(clientTransport)]);
+ try {
+ const overview = parsePayload(await client.callTool({ name: "list_tools", arguments: {} }));
+ const categories = (overview.categories as Array<{ name: string }>).map((category) => category.name);
+ expect(categories).toEqual(expect.arrayContaining(["control", "bots"]));
+
+ expect(parsePayload(await client.callTool({
+ name: "call_tool",
+ arguments: { name: "stop_session_turn", args: { session_id: TARGET_SESSION_ID } },
+ }))).toMatchObject({ ok: false, errorCode: "TASK_OUT_OF_SCOPE" });
+ expect(stopSessionTurn).not.toHaveBeenCalled();
+ expect(authorizeCall).toHaveBeenCalledWith({
+ sessionId: "bot-a-main",
+ server: "cindy_helper",
+ tool: "stop_session_turn",
+ args: { session_id: TARGET_SESSION_ID },
+ });
+
+ expect(parsePayload(await client.callTool({
+ name: "call_tool",
+ arguments: { name: "send_to_agent", args: { target_id: "bot-b", message: "hello" } },
+ }))).toMatchObject({ ok: true });
+ expect(messageAgent).toHaveBeenCalled();
+ } finally {
+ await client.close();
+ await server.close();
+ }
+ });
+
+ it("fails closed when the host authorizer throws", async () => {
+ const messageAgent = vi.fn();
+ const server = createXdtHelperMcpServer(
+ {
+ resolveSurface: async () => "bot-main",
+ authorizeCall: async () => { throw new Error("db gone"); },
+ botMessaging: { messageAgent },
+ },
+ { agentKind: "pi", workingDir: "/bot", sessionId: "bot-a-main" },
+ );
+ const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+ const client = new Client({ name: "bot-main-authorizer-throws", version: "0.0.0" });
+ await Promise.all([server.connect(serverTransport), client.connect(clientTransport)]);
+ try {
+ expect(parsePayload(await client.callTool({
+ name: "call_tool",
+ arguments: { name: "send_to_agent", args: { target_id: "bot-b", message: "hello" } },
+ }))).toMatchObject({ ok: false, errorCode: "CAPABILITY_NOT_AVAILABLE" });
+ expect(messageAgent).not.toHaveBeenCalled();
+ } finally {
+ await client.close();
+ await server.close();
+ }
+ });
+
+ it("keeps a remote Bot main task and other Bot sessions on the unchanged narrow, ungated surface", async () => {
+ const authorizeCall = vi.fn(async () => ({ ok: true as const }));
+ const createProject = vi.fn(async () => ({ ok: true as const, workingDir: "/repo" }));
+ for (const context of [
+ { agentKind: "codex" as const, workingDir: "/repo", sessionId: "bot-remote", remoteHostId: "ssh-host" },
+ { agentKind: "pi" as const, workingDir: "/repo", sessionId: "bot-lane" },
+ ]) {
+ const server = createXdtHelperMcpServer(
+ { resolveSurface: async () => (context.remoteHostId ? "bot-main" : "bot"), authorizeCall, createProject },
+ context,
+ );
+ const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+ const client = new Client({ name: "bot-narrow-surface", version: "0.0.0" });
+ await Promise.all([server.connect(serverTransport), client.connect(clientTransport)]);
+ try {
+ const overview = parsePayload(await client.callTool({ name: "list_tools", arguments: {} }));
+ const categories = (overview.categories as Array<{ name: string }>).map((category) => category.name);
+ expect(categories).not.toContain("history");
+ expect(categories).not.toContain("handoff");
+ } finally {
+ await client.close();
+ await server.close();
+ }
+ }
+ expect(authorizeCall).not.toHaveBeenCalled();
+ });
+
it("does not offer local project tools to a remote Bot", async () => {
const createProject = vi.fn(async () => ({ ok: true as const, workingDir: "/repo" }));
const server = createXdtHelperMcpServer(
@@ -966,6 +1077,34 @@ describe("direct Bot MCP tools", () => {
}
});
+ it.each(["claude-code", "codex"] as const)("judges direct Bot tools of a local Bot main task on %s", async (agentKind) => {
+ const messageAgent = vi.fn();
+ const authorizeCall = vi.fn(async () => ({ ok: false as const, errorCode: "OWNER_TURN_REQUIRED", message: "owner only" }));
+ const server = createXdtHelperMcpServer({
+ resolveSurface: async () => "bot-main",
+ authorizeCall,
+ botMessaging: { messageAgent },
+ }, {
+ agentKind,
+ workingDir: "",
+ getSessionContext: () => ({ agentKind, workingDir: "/bot", sessionId: "bot-main" }),
+ });
+ const [ct, st] = InMemoryTransport.createLinkedPair();
+ const client = new Client({ name: "direct-bot-gate", version: "0.0.0" });
+ await Promise.all([server.connect(st), client.connect(ct)]);
+ try {
+ expect(parsePayload(await client.callTool({
+ name: "send_to_agent",
+ arguments: { target_id: "bot-b", message: "hello" },
+ }))).toMatchObject({ ok: false, errorCode: "OWNER_TURN_REQUIRED" });
+ expect(authorizeCall).toHaveBeenCalledWith(expect.objectContaining({ sessionId: "bot-main", tool: "send_to_agent" }));
+ expect(messageAgent).not.toHaveBeenCalled();
+ } finally {
+ await client.close();
+ await server.close();
+ }
+ });
+
it("keeps ghost plugin guidance in Pi helper discovery on remote sessions", async () => {
const server = createXdtHelperMcpServer({
resolveSurface: async () => "bot",
diff --git a/packages/lizi-mcps/src/cindy_schedulerMcpServer.ts b/packages/lizi-mcps/src/cindy_schedulerMcpServer.ts
index 40c76dc906..b1befd6f06 100644
--- a/packages/lizi-mcps/src/cindy_schedulerMcpServer.ts
+++ b/packages/lizi-mcps/src/cindy_schedulerMcpServer.ts
@@ -41,6 +41,7 @@ import {
} from './scheduler/index.js';
import { resolveLiziMcpSessionContext } from './session-context.js';
import { withAccountDataAccess, type AccountDataAccess } from './account-data-access.js';
+import { withToolCallAuthority, type ToolCallAuthorizer } from './tool-call-authority.js';
import type { LiziMcpSessionContext, SchedulerMcpDeps } from './types.js';
/**
@@ -147,6 +148,7 @@ function registerCallToolEntry(
registry: SchedulerToolRegistry,
access: AccountDataAccess | undefined,
getSessionContext: () => LiziMcpSessionContext,
+ authorizeCall: ToolCallAuthorizer | undefined,
): void {
server.tool(
'call_tool',
@@ -157,7 +159,14 @@ function registerCallToolEntry(
.describe('工具名,从 list_tools 获取(如 schedule_create / schedule_list)'),
args: jsonObjectArg('工具参数(JSON 对象)。不确定 schema 时可先传 {} 触发错误反馈。'),
},
- async ({ name, args }) => withAccountDataAccess(access, getSessionContext().sessionId, () => registry.call(name, args)),
+ async ({ name, args }) => {
+ const sessionId = getSessionContext().sessionId;
+ return withToolCallAuthority(
+ authorizeCall,
+ { sessionId, server: 'cindy_scheduler', tool: name, args },
+ () => withAccountDataAccess(access, sessionId, () => registry.call(name, args)),
+ );
+ },
);
}
@@ -204,7 +213,7 @@ export function createSchedulerMcpServer(
registerScheduleDeleteTool(registry, deps, getSessionContext);
registerListToolsEntry(server, registry, deps.withAccountDataAccess, getSessionContext);
- registerCallToolEntry(server, registry, deps.withAccountDataAccess, getSessionContext);
+ registerCallToolEntry(server, registry, deps.withAccountDataAccess, getSessionContext, deps.authorizeCall);
return server;
}
diff --git a/packages/lizi-mcps/src/index.ts b/packages/lizi-mcps/src/index.ts
index 0c55df4dd1..d6a8d8ed76 100644
--- a/packages/lizi-mcps/src/index.ts
+++ b/packages/lizi-mcps/src/index.ts
@@ -10,6 +10,7 @@ export const VERSION = '0.0.0';
export * from './types.js';
export * from './providers.js';
+export type { ToolCallAuthorization, ToolCallAuthorizer } from './tool-call-authority.js';
// feishu/ OpenAPI MCP 模块已于 2026-07-22 整体退役:能力早已迁入插件
// xd-feishu(2026-07-16 摘壳),其直通面生成器 + vendored OpenAPI 数据源也已
diff --git a/packages/lizi-mcps/src/lizi_xdtHelperMcpServer.ts b/packages/lizi-mcps/src/lizi_xdtHelperMcpServer.ts
index d132663e63..de1c3c6c32 100644
--- a/packages/lizi-mcps/src/lizi_xdtHelperMcpServer.ts
+++ b/packages/lizi-mcps/src/lizi_xdtHelperMcpServer.ts
@@ -94,6 +94,7 @@ import type { SessionControlDeps } from './xdt-helper/session_control.js';
import type { ControlResult, LiziMcpLogger } from './types.js';
import { resolveLiziMcpSessionContext } from './session-context.js';
import { logToolResultErrorCode } from './tool-error-telemetry.js';
+import { withToolCallAuthority, type ToolCallAuthorizer } from './tool-call-authority.js';
import { errorPayload, okPayload } from './xdt-helper/_payload.js';
import {
registerCreateTeammateTool,
@@ -223,6 +224,8 @@ interface HelperSurfaceAllow {
categories: ReadonlySet<string> | null;
/** Named tools visible even when their category stays closed. */
extraTools: ReadonlySet<string>;
+ /** Bot callers: each call is also judged by the host's per-turn authority. */
+ gated?: boolean;
}
function toolAllowed(
@@ -322,6 +325,7 @@ function registerCallToolEntry(
telemetry: {
logger?: LiziMcpLogger;
getSessionId: () => string | undefined;
+ authorizeCall?: ToolCallAuthorizer;
},
allowedSurface: () => Promise<HelperSurfaceAllow>,
): void {
@@ -339,7 +343,11 @@ function registerCallToolEntry(
);
}
const result = definition
- ? await registry.call(name, args)
+ ? await withToolCallAuthority(
+ allowed.gated ? telemetry.authorizeCall : undefined,
+ { sessionId: telemetry.getSessionId(), server: 'cindy_helper', tool: name, args },
+ () => registry.call(name, args),
+ )
: errorPayload('UNKNOWN_TOOL', 'Unknown helper tool.', {
available: registry.list().filter((tool) => toolAllowed(allowed, tool)).map((tool) => tool.name),
});
@@ -729,10 +737,16 @@ export interface XdtHelperMcpDeps {
logger?: LiziMcpLogger;
appUpdate?: AppUpdateCallbacks;
grokLogin?: GrokLoginCallbacks;
- /** Host-owned runtime classification used to keep Bot tasks on a narrow surface. */
+ /**
+ * Host-owned runtime classification. `bot-main` is a local Bot's main task: it sees
+ * the ordinary task surface plus Bot tools, and every call is judged by `authorizeCall`.
+ * `bot` keeps the narrow Bot surface (group lanes, history, remote Bots).
+ */
resolveSurface?: (input: {
sessionId: string;
- }) => Promise<'default' | 'bot' | 'restricted'>;
+ }) => Promise<'default' | 'bot' | 'bot-main' | 'restricted'>;
+ /** Live per-call check for Bot tasks; the tool list itself never changes mid-session. */
+ authorizeCall?: ToolCallAuthorizer;
/**
* 历史聊天数据查询的回调集合(读本地 SQLite 的 sessions / messages 表)。host
* 注入后, history 类工具(list_workdirs / list_sessions / get_chat_history /
@@ -843,10 +857,16 @@ export function createXdtHelperMcpServer(
if (!sessionId) return allow(remoteBotOnly ? new Set() : defaultCategories);
if (!deps.resolveSurface) return allow(remoteBotOnly ? new Set(['auth']) : defaultCategories);
const surface = await deps.resolveSurface({ sessionId }).catch(() => 'restricted' as const);
- // Bots keep bots/cindy/auth. Project tools are named exceptions so a Bot can
- // register and organize projects without stop/steer/archive/history access.
- // handoff/feedback/skills stay out of the Bot's discovery loop.
- if (surface === 'bot') {
+ // A local Bot main task works like an ordinary task: the full surface plus Bot
+ // tools. What a given turn may actually do (owner / arranged / other) is
+ // decided per call by the host, so the tool list stays stable across turns.
+ if (surface === 'bot-main' && !context.remoteHostId) {
+ return { categories: new Set([...defaultCategories, 'bots']), extraTools: new Set(), gated: true };
+ }
+ // Other Bot sessions (group lanes, history, remote Bots) keep their unchanged
+ // narrow surface: bots/cindy/auth, with project tools as named exceptions so a
+ // Bot can register and organize projects without stop/steer/archive/history access.
+ if (surface === 'bot' || surface === 'bot-main') {
// Project tools run only on the local host. A remote Bot must keep its
// own tooling without being offered calls that always return unsupported.
return {
@@ -1015,6 +1035,7 @@ export function createXdtHelperMcpServer(
// per-call 解析:codex HTTP bridge 的 server factory 阶段 ctx 是空的,
// tool-call 阶段由 AsyncLocalStorage 恢复,所以 sessionId 必须调用时再取。
getSessionId: () => resolveLiziMcpSessionContext(sessionCtx).sessionId,
+ ...(deps.authorizeCall ? { authorizeCall: deps.authorizeCall } : {}),
}, allowedSurface);
// Pi already provides direct Bot tools through its native bridge. CC and Codex
@@ -1030,7 +1051,12 @@ export function createXdtHelperMcpServer(
if (!allowed.categories?.has('bots')) {
return errorPayload('CAPABILITY_NOT_AVAILABLE', '这个工具不属于当前任务的能力面。');
}
- const result = await registry.call(definition.name, args);
+ const sessionId = resolveLiziMcpSessionContext(sessionCtx).sessionId;
+ const result = await withToolCallAuthority(
+ allowed.gated ? deps.authorizeCall : undefined,
+ { sessionId, server: 'cindy_helper', tool: definition.name, args },
+ () => registry.call(definition.name, args),
+ );
logToolResultErrorCode({
logger: deps.logger, server: 'cindy_helper', tool: definition.name, result,
sessionId: resolveLiziMcpSessionContext(sessionCtx).sessionId,
diff --git a/packages/lizi-mcps/src/tool-call-authority.ts b/packages/lizi-mcps/src/tool-call-authority.ts
new file mode 100644
index 0000000000..c0d8ba4fbc
--- /dev/null
+++ b/packages/lizi-mcps/src/tool-call-authority.ts
@@ -0,0 +1,33 @@
+import { errorPayload } from './xdt-helper/_payload.js';
+
+/**
+ * Host decision for one tool call. Tool lists stay stable for a whole session
+ * (prompt-cache rule), so a turn-dependent limit is enforced when the call runs.
+ */
+export type ToolCallAuthorization =
+ | { ok: true }
+ | { ok: false; errorCode: string; message: string };
+
+export type ToolCallAuthorizer = (input: {
+ sessionId: string | undefined;
+ server: 'cindy_helper' | 'cindy_scheduler';
+ tool: string;
+ args: unknown;
+}) => Promise<ToolCallAuthorization>;
+
+/** Run `operation` only when the host allows this call; a failing host check denies it. */
+export async function withToolCallAuthority<T>(
+ authorize: ToolCallAuthorizer | undefined,
+ input: Parameters<ToolCallAuthorizer>[0],
+ operation: () => Promise<T>,
+): Promise<T | ReturnType<typeof errorPayload>> {
+ if (!authorize) return operation();
+ let decision: ToolCallAuthorization;
+ try {
+ decision = await authorize(input);
+ } catch {
+ decision = { ok: false, errorCode: 'CAPABILITY_NOT_AVAILABLE', message: '暂时无法确认这次调用的权限,请稍后重试。' };
+ }
+ if (!decision.ok) return errorPayload(decision.errorCode, decision.message);
+ return operation();
+}
diff --git a/packages/lizi-mcps/src/types.ts b/packages/lizi-mcps/src/types.ts
index 90185421d2..30f9926ef4 100644
--- a/packages/lizi-mcps/src/types.ts
+++ b/packages/lizi-mcps/src/types.ts
@@ -232,6 +232,8 @@ export interface RoutineToolService {
*/
export interface SchedulerMcpDeps {
withAccountDataAccess?: import('./account-data-access.js').AccountDataAccess;
+ /** Live per-call check (Bot main tasks may change automations only on their owner's own turn). */
+ authorizeCall?: import('./tool-call-authority.js').ToolCallAuthorizer;
getScheduler(): import('@cindy/maker-scheduler').Scheduler;
/**
* 前置检查脚本(preRunHook)统一安装服务(host 注入,desktop 实现为
diff --git a/packages/lizi-mcps/src/xdt-helper/bot_workbench.ts b/packages/lizi-mcps/src/xdt-helper/bot_workbench.ts
index e00b0b169d..adce2c3927 100644
--- a/packages/lizi-mcps/src/xdt-helper/bot_workbench.ts
+++ b/packages/lizi-mcps/src/xdt-helper/bot_workbench.ts
@@ -7,7 +7,8 @@ import { errorPayload, okPayload } from './_payload.js';
/**
* 伙伴工作台:主人把本机项目交给伙伴后,伙伴先读懂项目里的任务,再按主人的意思继续。
*
- * 权限只来自主人在工作台里的那次「交给伙伴」:宿主从 callerSessionId 反查伙伴
+ * 权限只来自主人的那次「交给伙伴」(工作台里点选,或主人本人那一轮让伙伴用 add_workbench_project
+ * 记下):宿主从 callerSessionId 反查伙伴
* (只认本机、在用的伙伴主任务),目标必须落在该伙伴已接手的项目里——Cindy 任务要是
* 普通本机任务、未归档删除、不是任何伙伴自己的隐藏任务;本机 Claude Code / Codex / Pi 会话的
* 工作目录要在已接手项目内;PR / issue 要属于已接手项目的 GitHub 远端;参考链接只认 https
@@ -139,12 +140,6 @@ export interface WorkbenchTranscriptWire {
truncated: boolean;
}
-export type WorkbenchStopStatusWire =
- | 'no-active-turn'
- | 'waiting-for-safe-point'
- | 'requested'
- | 'unconfirmed';
-
export interface BotWorkbenchCallbacks {
get(params: { callerSessionId: string }): Promise<ControlResult<{ workbench: BotWorkbenchSnapshotWire }, string>>;
read(params: {
@@ -182,10 +177,16 @@ export interface BotWorkbenchCallbacks {
string
>
>;
- stopTask(params: {
+ /** 主人在这一轮亲口交代时,把一个本机项目目录交给伙伴(与工作台里「交给伙伴」同一份记录)。 */
+ addProject(params: {
callerSessionId: string;
- taskId: string;
- }): Promise<ControlResult<{ taskId: string; status: WorkbenchStopStatusWire }, string>>;
+ path: string;
+ }): Promise<ControlResult<{ project: { name: string; path: string }; projectCount: number }, string>>;
+ /** 主人让伙伴别再管某个项目时,从工作台移除它;项目里的任务与文件都不动。 */
+ removeProject(params: {
+ callerSessionId: string;
+ path: string;
+ }): Promise<ControlResult<{ path: string; removed: boolean }, string>>;
}
export interface BotWorkbenchToolDeps {
@@ -247,7 +248,7 @@ export function registerBotWorkbenchTools(
name: 'get_workbench',
category: 'bots',
description:
- '读取你的工作台:主人交给你的项目,每个项目的素材(brief:文档路径、git 分支与最近 14 天提交、我打开的 PR 与 issue),'
+ '读取你的工作台:主人交给你的项目,每个项目的素材(brief:文档路径、git 分支与最近 14 天提交、我打开的 PR 与 issue;项目很多时只有最近交代的前 8 个带 brief,其余为 null,需要时用文件工具自己看),'
+ '项目里最近 30 天的会话(项目里的 Cindy 任务——包括主人自己开的——不管你判断过没有都在,最多 30 条;再补本机 Claude Code / Codex / Pi 会话,合计最多 40 条;更早的只给 olderCount),你写过的 PR / issue / 建议条目,你的例行任务与项目里的自动化。'
+ '主人提到这个项目、让你跟进或问进展时,先看工作台;主人自己在项目里开的任务也在里面,它们属于你知道的项目事务,不需要主人逐个告诉你。'
+ '每条会话带 digest:起始目的与最后几条对话,足够大多数判断,不用逐个读全文。'
@@ -370,19 +371,41 @@ export function registerBotWorkbenchTools(
});
registry.register({
- name: 'stop_workbench_task',
+ name: 'add_workbench_project',
category: 'bots',
description:
- '请求停止工作台上一件任务的当前一轮(优雅停止)。不删除任务,之后仍可用 continue_workbench_task 接着做。'
- + '只在主人要求,或任务明显走偏、在做重复无用的事时使用。status=requested / waiting-for-safe-point / unconfirmed 表示已请求但引擎可能还没停稳,不要说成已停止。'
- + '你自己开的后台任务用 stop_session_task。',
- inputShape: { task_id: TASK_ID },
- handler: async ({ task_id }) => {
+ '把主人这台电脑上的一个项目目录交给你跟进,工作台立刻多出这个项目;之后它就在你的负责范围里,主人事先安排的那几轮也能处理它里面的任务。'
+ + '只在主人本人这一轮明确说要交给你(例如「这个项目以后你盯着」「把 ~/code/foo 交给你」)时用;不要因为聊到某个项目就自己加。'
+ + 'path 填绝对路径;主人只说了项目名时先用 list_projects 找到它的路径。不能交整个磁盘根目录或主目录。'
+ + '加完先 get_workbench 接手,再用几句话告诉主人你看到了什么。',
+ inputShape: {
+ path: z.string().min(1).max(4096).describe('项目目录的绝对路径'),
+ },
+ handler: async ({ path }) => {
+ const sessionId = callerSessionId();
+ if (!sessionId) return missingSession();
+ const result = await deps.callbacks.addProject({ callerSessionId: sessionId, path });
+ return result.ok
+ ? okPayload({ project: result.project, project_count: result.projectCount })
+ : errorPayload(result.errorCode, result.message);
+ },
+ });
+
+ registry.register({
+ name: 'remove_workbench_project',
+ category: 'bots',
+ description:
+ '主人本人这一轮说不用你再管某个项目时,把它从你的工作台移除。项目里的任务、文件和你写过的判断都不会被删,只是不再归你跟进。'
+ + 'path 用 get_workbench 里该项目的 path(也可以写 ~/ 开头)。工作台里没有这个项目时返回 PROJECT_NOT_IN_WORKBENCH,什么都没移除,照实告诉主人。',
+ inputShape: {
+ path: z.string().min(1).max(4096).describe('要移除的项目路径'),
+ },
+ handler: async ({ path }) => {
const sessionId = callerSessionId();
if (!sessionId) return missingSession();
- const result = await deps.callbacks.stopTask({ callerSessionId: sessionId, taskId: task_id });
+ const result = await deps.callbacks.removeProject({ callerSessionId: sessionId, path });
return result.ok
- ? okPayload({ task_id: result.taskId, status: result.status })
+ ? okPayload({ path: result.path, removed: result.removed })
: errorPayload(result.errorCode, result.message);
},
});
diff --git a/packages/lizi-mcps/src/xdt-helper/index.ts b/packages/lizi-mcps/src/xdt-helper/index.ts
index 8efbf3d5f2..679472ec33 100644
--- a/packages/lizi-mcps/src/xdt-helper/index.ts
+++ b/packages/lizi-mcps/src/xdt-helper/index.ts
@@ -155,7 +155,6 @@ export {
type WorkbenchJudgmentWire,
type WorkbenchProjectBriefWire,
type WorkbenchProjectWire,
- type WorkbenchStopStatusWire,
type WorkbenchTaskStateWire,
type WorkbenchTaskWire,
type WorkbenchTranscriptWire,