Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
feat(plugins): 插件任务新增 archive,归档自有的空闲任务
Dashebffbcc853d3
diff --git a/apps/desktop/resources/system-skills/cindy-plugin-creator/references/plugin-agent-tasks.md b/apps/desktop/resources/system-skills/cindy-plugin-creator/references/plugin-agent-tasks.mdindex 7e9a207a48..af2c1ac1c4 100644--- a/apps/desktop/resources/system-skills/cindy-plugin-creator/references/plugin-agent-tasks.md+++ b/apps/desktop/resources/system-skills/cindy-plugin-creator/references/plugin-agent-tasks.md@@ -270,7 +270,8 @@ text 与 context 合计不超过 64000;tasks.send 的 text 上限仍为 32768不接受自报 confirmed。权限参与幂等摘要,同键修改返回冲突;缺省旧请求可重放,旧 Host 未声明支持时不发新参数。原有 `cindy.tasks` 的归属限制不变。先调用 `capabilities()` 获取实际支持操作。当前仅支持本插件创建的本机普通任务:-`models`、`create`、`get`、`setModel`、`list`、`send`、`getRun`、`listRuns`、`readMessages`、`cancel`、`setHidden`。+`models`、`create`、`get`、`setModel`、`list`、`send`、`getRun`、`listRuns`、`readMessages`、`cancel`、`setHidden`、`archive`。+`archive({taskId})` 归档自有的空闲任务(执行中或有排队输入时 `TASK_BUSY`),用户可随时恢复;没有删除接口。按视频、按文档等开新任务的插件,切换时归档上一条,避免后台任务堆积。可对自有任务调用 `startTeam({taskId})` 启用 Orca 主任务,并用 `getTeam({taskId})` 读取实际协同状态。协调主任务需经用户授权 Auto,Worker 自动沿用 Auto。这些任务及其 Worker 不提供 `cindy_helper` 的账号级历史或跨任务控制能力,`cindy_memory.session_search` 也拒绝历史检索;协调使用独立 Orca 工具,结果由插件通过 `readMessages/getTeam` 读取。旧 errand/workspace 不因来源标记受到限制;明确卸载撤销归属后,调用方已无正在执行的输入或已接受新真人输入时,保留的用户任务恢复普通 helper 与历史检索能力;仍执行旧插件输入时继续受限,自动回报和插件输入重试不构成真人接管。这不恢复插件控制权,也不保证停止已接受执行,不构成通用执行沙箱。在首次派发前调用 `setTeamPlan({taskId,plan:{concurrency,task,items}})`,每项包含diff --git a/apps/desktop/src/main/cindy-brain/__tests__/taskSlot.test.ts b/apps/desktop/src/main/cindy-brain/__tests__/taskSlot.test.tsindex f5fa829897..89dcdb4a82 100644--- a/apps/desktop/src/main/cindy-brain/__tests__/taskSlot.test.ts+++ b/apps/desktop/src/main/cindy-brain/__tests__/taskSlot.test.ts@@ -190,6 +190,19 @@ describe('background tasks (agent.hiddenTasks)', () => {expect(validPluginTaskRequest({ type: 'tasks-request', kind: 'get', taskId: 'own', hidden: true })).toBe(false);});+ it('validates the archive operation shape and advertises it to every tasks plugin', async () => {+ // Rule: archive is reversible housekeeping for a plugin's own tasks; no hiddenTasks declaration needed. tier: unit.+ expect(validPluginTaskRequest({ type: 'tasks-request', kind: 'archive', taskId: 'own' })).toBe(true);+ expect(validPluginTaskRequest({ type: 'tasks-request', kind: 'archive' })).toBe(false);+ expect(validPluginTaskRequest({ type: 'tasks-request', kind: 'archive', taskId: 'own', hidden: true })).toBe(false);+ const handler = vi.fn(async () => ({ taskId: 'own', status: 'archived' }));+ const deps = { getGhost: () => undeclared, handler, isCurrent: () => true };+ expect(await handlePluginTaskRequest('p', { type: 'tasks-request', kind: 'archive', taskId: 'own' }, deps))+ .toEqual({ ok: true, data: { taskId: 'own', status: 'archived' } });+ const caps = await handlePluginTaskRequest('p', { type: 'tasks-request', kind: 'capabilities' }, deps);+ expect((caps as { data: { operations: string[] } }).data.operations).toContain('archive');+ });+it('denies hidden creation and setHidden without the declaration, before reaching the handler', async () => {const handler = vi.fn(async () => ({ taskId: 't' }));const deps = { getGhost: () => undeclared, handler, isCurrent: () => true };diff --git a/apps/desktop/src/main/cindy-brain/taskSlot.ts b/apps/desktop/src/main/cindy-brain/taskSlot.tsindex 64634304bb..375b3c7977 100644--- a/apps/desktop/src/main/cindy-brain/taskSlot.ts+++ b/apps/desktop/src/main/cindy-brain/taskSlot.ts@@ -23,6 +23,7 @@ export const PLUGIN_TASK_OPERATIONS = ['cancel','readMessages','setHidden',+ 'archive',] as const;export type PluginTaskHandler = (pluginId: string, request: PluginTaskRequest) => Promise<unknown>;const object = (v: unknown): v is Record<string, unknown> =>@@ -49,6 +50,7 @@ export function validPluginTaskRequest(value: unknown): value is PluginTaskRequereadMessages: ['taskId', 'after', 'limit'],cancel: ['runId', 'requestKey'],setHidden: ['taskId', 'hidden'],+ archive: ['taskId'],};if (typeof value.kind !== 'string' || !Object.hasOwn(allowed, value.kind)) return false;const kind = value.kind;@@ -58,7 +60,7 @@ export function validPluginTaskRequest(value: unknown): value is PluginTaskRequeif (kind === 'requestWriteAccess' && value.mode !== undefined && !['acceptEdits', 'auto'].includes(String(value.mode))) return false;const requires = (key: string) => text(value[key], 128);if (['create', 'send', 'cancel'].includes(value.kind) && !requires('requestKey')) return false;- if (['get', 'setModel', 'send', 'listRuns', 'readMessages', 'requestWriteAccess', 'startTeam', 'getTeam', 'setTeamPlan', 'releaseWorker', 'setHidden'].includes(value.kind) && !requires('taskId'))+ if (['get', 'setModel', 'send', 'listRuns', 'readMessages', 'requestWriteAccess', 'startTeam', 'getTeam', 'setTeamPlan', 'releaseWorker', 'setHidden', 'archive'].includes(value.kind) && !requires('taskId'))return false;if (kind === 'setHidden' && typeof value.hidden !== 'boolean') return false;if (value.hidden !== undefined && typeof value.hidden !== 'boolean') return false;diff --git a/apps/desktop/src/main/maker-ipc/__tests__/pluginTaskService.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/pluginTaskService.test.tsindex 2c86e6b484..abf818ee54 100644--- a/apps/desktop/src/main/maker-ipc/__tests__/pluginTaskService.test.ts+++ b/apps/desktop/src/main/maker-ipc/__tests__/pluginTaskService.test.ts@@ -1438,6 +1438,25 @@ it('an open plugin selection without a source session follows the auxiliary chaiawait expect(run([{ agentKind: 'codex', providerId: f.route.providerId, model: 'cheap' }], { model: 'next' })).resolves.toMatchObject({ model: 'next' });});+it('archives only its own idle task through the host writer and treats archived tasks as done', async () => {+ // Rule: plugins rotate per-video tasks and archive the previous one; a working task is never cut off. tier: unit.+ const f = fixture(), task = await f.create();+ f.deps.archive = vi.fn(async (taskId: string, assertAllowed: () => void) => {+ assertAllowed();+ f.tasks.set(taskId, { ...f.tasks.get(taskId)!, status: 'archived' });+ });+ (f.deps.inspect as ReturnType<typeof vi.fn>).mockResolvedValueOnce({ execution: f.execution, pending: [] });+ await expect(f.service.archive('p', { taskId: task.taskId })).rejects.toMatchObject({ code: 'TASK_BUSY' });+ expect(f.deps.archive).not.toHaveBeenCalled();+ expect((await f.service.archive('p', { taskId: task.taskId })).status).toBe('archived');+ expect((await f.service.archive('p', { taskId: task.taskId })).status).toBe('archived');+ expect(f.deps.archive).toHaveBeenCalledTimes(1);+ await expect(f.service.archive('other', { taskId: task.taskId })).rejects.toMatchObject({ code: 'TASK_NOT_FOUND' });+ await expect(f.service.send('p', { taskId: task.taskId, requestKey: 'late', expectedRevision: task.revision, text: 'x' })).rejects.toMatchObject({ code: 'TASK_BUSY' });+ const bare = fixture(), plain = await bare.create();+ await expect(bare.service.archive('p', { taskId: plain.taskId })).rejects.toMatchObject({ code: 'HOST_NOT_READY' });+});+it.each([['provider', 'reset'], ['provider', 'partial'],['mutation', 'reset'], ['mutation', 'partial'],diff --git a/apps/desktop/src/main/maker-ipc/pluginTaskService.ts b/apps/desktop/src/main/maker-ipc/pluginTaskService.tsindex d0451b07be..421ef2c339 100644--- a/apps/desktop/src/main/maker-ipc/pluginTaskService.ts+++ b/apps/desktop/src/main/maker-ipc/pluginTaskService.ts@@ -173,6 +173,8 @@ export interface PluginTaskServiceDeps {setHidden?(taskId: string, hidden: boolean, assertAllowed: () => void): Promise<void>;/** Uninstall fallback: reveal this plugin's background tasks before ownership is revoked. */revealPluginTasks?(pluginId: string): Promise<void>;+ /** Host archive writer (same path as the sidebar); `assertAllowed` runs right before the write. */+ archive?(taskId: string, assertAllowed: () => void): Promise<void>;setModel?(taskId: string, route: PluginTaskRoute, assertCurrent: () => Promise<void>): Promise<{ status: string }>;readSession(taskId: string): Promise<PluginTaskView | null>;readLiveSession(taskId: string): Pick<Session, 'instanceId' | 'stablePlanModeState'> | undefined;@@ -507,6 +509,22 @@ export function createPluginTaskService(deps: PluginTaskServiceDeps) {}return ownTask(pluginId, request.taskId);}),+ /**+ * Archive this plugin's own idle local task. Reversible by the user (unarchive) and never a+ * delete; a task with live execution or queued input stays active so nothing is cut off.+ */+ archive: (pluginId: string, request: { taskId: string }) => exclusive(async () => {+ const task = await ownTask(pluginId, request.taskId);+ if (task.status === 'archived') return task;+ if (!deps.archive) return fail('HOST_NOT_READY', 'Task archive service is not ready');+ const observed = await deps.inspect(request.taskId);+ if (observed.execution || observed.pending.length) return fail('TASK_BUSY', 'The task is still working');+ await deps.archive(request.taskId, () => {+ deps.assertCurrent();+ deps.assertAuthorized(pluginId);+ });+ return ownTask(pluginId, request.taskId);+ }),list: (pluginId: string, after = '', limit = 50) =>exclusive(async () => {deps.assertAuthorized(pluginId);diff --git a/apps/desktop/src/main/maker-ipc/register.ts b/apps/desktop/src/main/maker-ipc/register.tsindex 38d5a1fee5..95bead7903 100644--- a/apps/desktop/src/main/maker-ipc/register.ts+++ b/apps/desktop/src/main/maker-ipc/register.ts@@ -1336,7 +1336,7 @@ import {closeRejectedRuntimeAndRestoreControlStores,isRemoteModelSwitchRouteChangeError,} from './runtimeSetModel.js';-import { updateSessionInDb } from '../localDb/ipc/sessions.js';+import { patchSessionMetaInDb, updateSessionInDb } from '../localDb/ipc/sessions.js';import { codexThreadTransferSourcePredicate, commitCodexThreadTransfer, relinkCodexProviderThread } from './codexProviderThreadRelink.js';import {codexCustomProviderConfigSignature,@@ -14316,6 +14316,10 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)setHidden: async (taskId, hidden, assertAllowed) => {await setSessionHidden({ sessionId: taskId, hidden, db: snapshot.client, assertCurrent: assertAllowed });},+ // Same archive path as the sidebar and remote archive: status persisted plus sessions:patched broadcast.+ archive: async (taskId, assertAllowed) => {+ await patchSessionMetaInDb(taskId, { status: 'archived' }, { beforeWrite: assertAllowed });+ },revealPluginTasks: async pluginId => {// 不受详情页列表的展示上限约束:分批恢复全部,避免卸载撤销归属后仍有任务隐藏。await revealAllPluginHiddenTasks(snapshot.client, pluginId, taskId =>@@ -14680,6 +14684,7 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)case 'create': return service.create(pluginId, request);case 'get': return service.get(pluginId, request.taskId);case 'setHidden': return service.setHidden(pluginId, request);+ case 'archive': return service.archive(pluginId, request);case 'list': return service.list(pluginId, request.after, request.limit);case 'send': return service.send(pluginId, request);case 'readMessages': {diff --git a/apps/desktop/src/preload/ghostPreload.ts b/apps/desktop/src/preload/ghostPreload.tsindex 847830b453..82e7f290b1 100644--- a/apps/desktop/src/preload/ghostPreload.ts+++ b/apps/desktop/src/preload/ghostPreload.ts@@ -81,7 +81,7 @@ contextBridge.exposeInMainWorld('cindy', {},])),tasks: Object.fromEntries(- ['capabilities', 'models', 'setModel', 'requestWriteAccess', 'startTeam', 'getTeam', 'setTeamPlan', 'releaseWorker', 'create', 'list', 'get', 'send', 'getRun', 'listRuns', 'cancel', 'readMessages', 'setHidden'].map(kind => [+ ['capabilities', 'models', 'setModel', 'requestWriteAccess', 'startTeam', 'getTeam', 'setTeamPlan', 'releaseWorker', 'create', 'list', 'get', 'send', 'getRun', 'listRuns', 'cancel', 'readMessages', 'setHidden', 'archive'].map(kind => [kind, async (req: Record<string, unknown> = {}): Promise<unknown> => {const result = await ipcRenderer.invoke('ghost-pipe:send', { ...req, type: 'tasks-request', kind });if (result?.ok === true) return result.data;diff --git a/apps/desktop/src/shared/pluginTasks.ts b/apps/desktop/src/shared/pluginTasks.tsindex 408a338844..28edc992a5 100644--- a/apps/desktop/src/shared/pluginTasks.ts+++ b/apps/desktop/src/shared/pluginTasks.ts@@ -101,6 +101,8 @@ export type PluginTaskRequest = (hidden?: boolean;}| { type: 'tasks-request'; kind: 'setHidden'; taskId: string; hidden: boolean }+ /** Archive this plugin's own idle task; the user can unarchive it from the task list or plugin page. */+ | { type: 'tasks-request'; kind: 'archive'; taskId: string }| { type: 'tasks-request'; kind: 'list'; after?: string; limit?: number }| { type: 'tasks-request'; kind: 'get'; taskId: string }| { type: 'tasks-request'; kind: 'startTeam' | 'getTeam'; taskId: string }diff --git a/docs/dev-rules/plugin-task-api-implementation.md b/docs/dev-rules/plugin-task-api-implementation.mdindex 1b5bfe6fb6..2f5ea2da6d 100644--- a/docs/dev-rules/plugin-task-api-implementation.md+++ b/docs/dev-rules/plugin-task-api-implementation.md@@ -183,7 +183,8 @@ Claude Code 适配层 `toSdkModelString` 会按目录窗口自动追加 `[1m]`## 已接入-- `capabilities/models/create/list/get/setModel/send/getRun/listRuns/readMessages/cancel/setHidden`。+- `capabilities/models/create/list/get/setModel/send/getRun/listRuns/readMessages/cancel/setHidden/archive`。+- `archive({taskId})` 归档本插件自建的空闲本地任务(有执行中或排队输入时返回 `TASK_BUSY`),走与侧栏归档相同的 `patchSessionMetaInDb` 路径;可逆(用户可恢复),不提供删除。归档后的任务由「存储空间 → 数据库清理」按既有规则处理。- create 可传 `hidden:true`、`setHidden({taskId, hidden})` 切换,`get`/`list` 快照恒返回 `hidden` 布尔值;仅身份卡声明 `agent.hiddenTasks: true`(必须同时 `agent.tasks: true`)时可用,见下文「后台任务」。- create 可传 isolatedWorkspace:true,由宿主分配独立空作答目录;返回本任务 workingDir 与实际 permissionMode,按次选择不得超过用户授予插件的权限。- 默认创建用户可见的普通本地 Session(声明 hiddenTasks 后可在同一次 INSERT 中创建后台任务);工作目录及权限来自用户配置,不接受插件传入绕过权限、任意目录或另一插件身份。普通任务创建前复用 Worker 的目录身份判据:配置路径必须仍为原规范路径,改链、缺失或非目录拒绝;异步解析后复核账号、tasks 批准及配置。缺省/isolatedWorkspace 仍由宿主分配目录,旧 errand 路径不变。旧别名配置没有原目标证据,不自动授权当前目标;这不解决校验后的目录置换窗口。