Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
fix(plugin): confirm updates that leave host task settings
liugaoweicf2a921859e8
diff --git a/apps/desktop/src/main/cindy-brain/__tests__/ghostInstallConsent.test.ts b/apps/desktop/src/main/cindy-brain/__tests__/ghostInstallConsent.test.tsindex 9706b8f8d7..38692c26d6 100644--- a/apps/desktop/src/main/cindy-brain/__tests__/ghostInstallConsent.test.ts+++ b/apps/desktop/src/main/cindy-brain/__tests__/ghostInstallConsent.test.ts@@ -130,6 +130,36 @@ describe('obtainGhostInstallConsent', () => {).resolves.toEqual({ mode: 'unprompted' });});+ it('requires existing update consent before a plugin stops using host task preferences', async () => {+ const current = installed({ ...manifest(['api.weather.test']), agent: { tasks: true } });+ const next = { ...current.manifest, version: '1.1.0', taskPreferences: false };+ await expect(+ obtainGhostInstallConsent({ mode: 'automatic' }, current, next, reviewedDigest),+ ).rejects.toMatchObject({+ facts: { kind: 'update', added: [expect.objectContaining({ key: 'task-preferences:self-managed' })] },+ });+ expect(() => assertGhostInstallConsent({ mode: 'unprompted' }, current, next, reviewedDigest))+ .toThrow(/requires user confirmation/);+ await expect(+ obtainGhostInstallConsent(+ { mode: 'prompt', prompt: userPrompt(false), initiator: 'user', origin: 'market' },+ current, next, reviewedDigest,+ ),+ ).rejects.toMatchObject({ code: 'MUTATION_CANCELLED' });+ const prompt = userPrompt(true);+ const decision = await obtainGhostInstallConsent(+ { mode: 'prompt', prompt, initiator: 'user', origin: 'market' },+ current, next, reviewedDigest,+ );+ expect(prompt).toHaveBeenCalledOnce();+ expect(() => assertGhostInstallConsent(decision, current, next, reviewedDigest)).not.toThrow();+ await expect(+ obtainGhostInstallConsent(+ { mode: 'automatic' }, installed(next), { ...next, version: '1.2.0' }, reviewedDigest,+ ),+ ).resolves.toEqual({ mode: 'unprompted' });+ });+it('skips confirmation only for server default installs', async () => {await expect(obtainGhostInstallConsent(diff --git a/apps/desktop/src/main/cindy-brain/forge.ts b/apps/desktop/src/main/cindy-brain/forge.tsindex bb2f649435..344bf1a1ae 100644--- a/apps/desktop/src/main/cindy-brain/forge.ts+++ b/apps/desktop/src/main/cindy-brain/forge.ts@@ -3449,7 +3449,9 @@ tool-call 内轮询时记得定期发 tool-progress 心跳续命(见 §4"长任- 新普通任务初始权限为 ask、目录由宿主管理;目录选择仍走亲选记录和现有工作区 API。requestWriteAccess 仍须用户确认,但仅更新该任务,不为插件后续任务保存全局默认权限。后续发送和协同检查该任务自身已获授的权限及 Plan 状态,不再套用宿主逐插件权限上限。-此开关不关闭任务 API,也不授予额外权限;不要求声明 settingsHtml,没有相应能力也不会创建卡片。+此开关不关闭任务 API,也不直接授予更高任务权限;不要求声明 settingsHtml,没有相应能力也不会创建卡片。+退出宿主管理会取消既有任务上的插件默认权限上限,因此安装确认会单列说明。+从缺省/true 更新为 false 须经现有扩权更新确认,后台自动更新会等待用户确认;服务端默认安装沿用既有豁免。恢复为 \`true\` 或删除此字段后,宿主重新使用原来保存的配置;关闭期间不删除这些数据。旧客户端忽略此字段,继续使用原卡片及配置;依赖关闭语义的插件必须要求支持此字段的客户端版本。diff --git a/apps/desktop/src/renderer/i18n/locales/en/common.json b/apps/desktop/src/renderer/i18n/locales/en/common.jsonindex d40251fd09..2a45087b54 100644--- a/apps/desktop/src/renderer/i18n/locales/en/common.json+++ b/apps/desktop/src/renderer/i18n/locales/en/common.json@@ -6498,6 +6498,8 @@"agentTasksRequest": "Review task permission","agentTasks": "Can create and manage its own Cindy tasks","agentTasksDetail": "Can send messages, read results and stop its own executions. Tasks remain visible to you. Uses this plugin’s AI settings and may incur model charges; does not grant access to other tasks.",+ "selfManagedTaskPreferences": "Manages Its Own Model and Task Settings",+ "selfManagedTaskPreferencesDetail": "Stops using Cindy’s saved model, permission and working-directory defaults for this plugin. Existing tasks use their own grants without the plugin’s default permission limit. Does not grant new task permissions.","agentHiddenTasks": "Can create background tasks hidden from the task list","agentHiddenTasksDetail": "Tasks this plugin creates can stay out of the task list, search and notifications. You can always view, open or show them in the task list from Background Tasks on this plugin’s page; uninstalling the plugin shows them again.","agentErrand": "Create tasks, perform work, and read results",diff --git a/apps/desktop/src/renderer/i18n/locales/ja/common.json b/apps/desktop/src/renderer/i18n/locales/ja/common.jsonindex d2e29f5eeb..c7b2cde92e 100644--- a/apps/desktop/src/renderer/i18n/locales/ja/common.json+++ b/apps/desktop/src/renderer/i18n/locales/ja/common.json@@ -6469,6 +6469,8 @@"agentTasksRequest": "セッション権限を確認","agentTasks": "このプラグインの Cindy セッションを作成・管理できます","agentTasksDetail": "メッセージの送信、結果の読み取り、自身の実行の停止ができます。セッションはユーザーに表示されます。プラグインの AI 設定を使用し、モデル料金が発生する場合があります。他のセッションへのアクセスは許可されません。",+ "selfManagedTaskPreferences": "モデルとタスクの設定を独自に管理",+ "selfManagedTaskPreferencesDetail": "このプラグイン用に Cindy が保存したモデル、権限、作業ディレクトリの設定を使用しなくなります。既存タスクは自身に付与された権限で実行され、プラグインの既定の権限制限は適用されません。新たなタスク権限が自動的に付与されることはありません。","agentHiddenTasks": "セッションリストに表示されないバックグラウンドセッションを作成できます","agentHiddenTasksDetail": "このプラグインが作成したセッションを、セッションリスト・検索・通知に表示しないようにできます。プラグイン詳細の「バックグラウンドセッション」からいつでも確認したり開いたり、セッションリストに表示したりできます。プラグインをアンインストールすると再び表示されます。","agentErrand": "タスクを作成し、作業を実行して結果を取得できます",diff --git a/apps/desktop/src/renderer/i18n/locales/ko/common.json b/apps/desktop/src/renderer/i18n/locales/ko/common.jsonindex 2df6ac62e7..48f58684a1 100644--- a/apps/desktop/src/renderer/i18n/locales/ko/common.json+++ b/apps/desktop/src/renderer/i18n/locales/ko/common.json@@ -6469,6 +6469,8 @@"agentTasksRequest": "세션 권한 확인","agentTasks": "이 플러그인의 Cindy 세션을 만들고 관리할 수 있음","agentTasksDetail": "메시지를 보내고 결과를 읽으며 자신의 실행을 중지할 수 있습니다. 세션은 사용자에게 표시됩니다. 플러그인의 AI 설정을 사용하며 모델 비용이 발생할 수 있습니다. 다른 세션에 대한 접근 권한은 부여하지 않습니다.",+ "selfManagedTaskPreferences": "모델 및 작업 설정을 자체 관리",+ "selfManagedTaskPreferencesDetail": "Cindy에 저장된 이 플러그인의 모델, 권한, 작업 디렉터리 설정을 더 이상 사용하지 않습니다. 기존 작업은 자체적으로 부여받은 권한으로 실행되며 플러그인의 기본 권한 제한을 받지 않습니다. 새 작업 권한이 자동으로 부여되지는 않습니다.","agentHiddenTasks": "세션 목록에 표시되지 않는 백그라운드 세션을 만들 수 있음","agentHiddenTasksDetail": "이 플러그인이 만든 세션을 세션 목록, 검색, 알림에 표시하지 않을 수 있습니다. 플러그인 상세의 「백그라운드 세션」에서 언제든지 확인하고 열거나 세션 목록에 표시할 수 있으며, 플러그인을 제거하면 다시 표시됩니다.","agentErrand": "작업을 만들고 실행하며 결과를 읽을 수 있습니다",diff --git a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.jsonindex 8d2728ab3a..9e71c76b26 100644--- a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json+++ b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json@@ -6469,6 +6469,8 @@"agentTasksRequest": "确认任务权限","agentTasks": "可创建和管理本插件的 Cindy 任务","agentTasksDetail": "可发送消息、读取结果和停止本插件的执行,任务对你可见。沿用插件的 AI 配置,可能产生模型费用;不授予其他任务的访问权。",+ "selfManagedTaskPreferences": "自行管理模型与任务配置",+ "selfManagedTaskPreferencesDetail": "不再使用 Cindy 为此插件保存的模型、权限和工作目录设置。已有任务按自身授权执行,不再受插件默认权限限制;不会自动授予新的任务权限。","agentHiddenTasks": "可创建不显示在任务列表里的后台任务","agentHiddenTasksDetail": "本插件创建的任务可以不出现在任务列表、搜索和通知里。你可以随时在插件详情的「后台任务」中查看、打开,或显示到任务列表;卸载插件时这些任务会恢复显示。","agentErrand": "可以新建任务、执行工作并读取结果",diff --git a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.jsonindex 5b91d15761..1c2f74b026 100644--- a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json+++ b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json@@ -6469,6 +6469,8 @@"agentTasksRequest": "確認任務權限","agentTasks": "可建立和管理本插件的 Cindy 任務","agentTasksDetail": "可傳送訊息、讀取結果和停止本插件的執行,任務對你可見。沿用插件的 AI 配置,可能產生模型費用;不授予其他任務的存取權。",+ "selfManagedTaskPreferences": "自行管理模型與任務配置",+ "selfManagedTaskPreferencesDetail": "不再使用 Cindy 為此插件儲存的模型、權限和工作目錄設定。既有任務依自身授權執行,不再受插件預設權限限制;不會自動授予新的任務權限。","agentHiddenTasks": "可建立不顯示在任務列表裡的後臺任務","agentHiddenTasksDetail": "本插件建立的任務可以不出現在任務列表、搜尋和通知裡。你可以隨時在插件詳情的「後臺任務」中查看、開啟,或顯示到任務列表;解除安裝插件時這些任務會恢復顯示。","agentErrand": "可建立任務、執行工作並讀取結果",diff --git a/apps/desktop/src/shared/__tests__/ghost.test.ts b/apps/desktop/src/shared/__tests__/ghost.test.tsindex e7e3e98d31..335c6cacbd 100644--- a/apps/desktop/src/shared/__tests__/ghost.test.ts+++ b/apps/desktop/src/shared/__tests__/ghost.test.ts@@ -3779,7 +3779,11 @@ describe('ghost · settingsHtml 自绘设置区 + settingsHeight', () => {expect(result.manifest.taskPreferences).toBe(taskPreferences);expect(Object.hasOwn(result.manifest, 'taskPreferences')).toBe(taskPreferences !== undefined);expect(result.manifest.agent?.tasks).toBe(true);- expect(ghostPermissionItems(result.manifest)).toEqual(ghostPermissionItems(original.manifest));+ const permissions = ghostPermissionItems(result.manifest);+ expect(permissions.filter(item => item.key !== 'task-preferences:self-managed'))+ .toEqual(ghostPermissionItems(original.manifest));+ expect(permissions.some(item => item.key === 'task-preferences:self-managed'))+ .toBe(taskPreferences === false);expect(validateNormalizedGhostManifest(result.manifest)).toEqual(result);}for (const taskPreferences of [null, 0, 1, 'false', {}, []]) {diff --git a/apps/desktop/src/shared/__tests__/ghostInstallConsent.test.ts b/apps/desktop/src/shared/__tests__/ghostInstallConsent.test.tsindex fa95160c45..03765d1872 100644--- a/apps/desktop/src/shared/__tests__/ghostInstallConsent.test.ts+++ b/apps/desktop/src/shared/__tests__/ghostInstallConsent.test.ts@@ -51,6 +51,36 @@ describe('plugin install consent', () => {expect(ghostUpdateNeedsConsent(current, manifest({ version: '1.1.0' }))).toBe(false);});+ it.each([2, 3])('reviews opting out of host task preferences in schema v%s', (schemaVersion) => {+ const base = {+ schemaVersion,+ ...(schemaVersion === 2 ? { slots: ['agent'] } : {}),+ agent: { tasks: true },+ tools: undefined,+ network: undefined,+ };+ for (const previous of [undefined, true, false]) {+ const current = installed(manifest({ ...base, taskPreferences: previous }));+ for (const next of [undefined, true, false]) {+ const candidate = manifest({ ...base, version: '1.1.0', taskPreferences: next });+ const facts = evaluateGhostInstallConsent(current, candidate);+ if (next === false && previous !== false) {+ expect(facts?.kind).toBe('update');+ if (facts?.kind !== 'update') throw new Error('expected update facts');+ expect(facts.added.map(item => item.key)).toEqual(['task-preferences:self-managed']);+ expect(facts.removed).toEqual([]);+ expect(ghostUpdateNeedsConsent(current, candidate)).toBe(true);+ } else {+ expect(facts).toBeNull();+ expect(ghostUpdateNeedsConsent(current, candidate)).toBe(false);+ }+ }+ }+ const facts = evaluateGhostInstallConsent(null, manifest({ ...base, taskPreferences: false }));+ if (facts?.kind !== 'install') throw new Error('expected install facts');+ expect(facts.permissions.map(item => item.key)).toContain('task-preferences:self-managed');+ });+it('keeps an update silent when it only removes permissions or changes tools', () => {const current = installed(manifest({ network: { hosts: ['api.weather.test', 'maps.weather.test'] } }));expect(evaluateGhostInstallConsent(current, manifest({ version: '1.1.0' }))).toBeNull();diff --git a/apps/desktop/src/shared/ghost.ts b/apps/desktop/src/shared/ghost.tsindex 28b36da1a5..91976c0288 100644--- a/apps/desktop/src/shared/ghost.ts+++ b/apps/desktop/src/shared/ghost.ts@@ -1951,6 +1951,17 @@ export function ghostDeclaresHiddenTasks(manifest: Pick<GhostManifest, 'agent'>export function ghostPermissionItems(manifest: GhostManifest): GhostPermissionItem[] {const items: GhostPermissionItem[] = [];+ // Opting out also removes the host's per-plugin permission cap from existing+ // tasks. Keep this in the existing install/update consent projection so an+ // automatic update cannot silently restore an older task grant.+ if (manifest.taskPreferences === false) {+ items.push({+ key: 'task-preferences:self-managed',+ kind: 'agent',+ labelKey: 'selfManagedTaskPreferences',+ detailKey: 'selfManagedTaskPreferencesDetail',+ });+ }for (const [category, actions] of Object.entries(manifest.cindy ?? {})) {if (category === 'oneshotModel') continue; // 偏好模型是标量意图,不是能力键if (!Array.isArray(actions)) continue;diff --git a/docs/dev-rules/plugin-security-and-authoring.md b/docs/dev-rules/plugin-security-and-authoring.mdindex 2af92c21a3..df6bafd9da 100644--- a/docs/dev-rules/plugin-security-and-authoring.md+++ b/docs/dev-rules/plugin-security-and-authoring.md@@ -233,6 +233,9 @@ Library 请求同时绑定迁移代次和安装批准,根解析、排队及开全部条目。首次安装展示全部权限并确认;更新相对当前已装版本按 `diffInstalledGhostPermissionItems`比较,新增条目、同 key 条目内容变化或内置 OAuth 客户端变化才算权限变多,只删除不算;已装版本没有有效批准基线时按全部权限新增处理。+ 顶层 `taskPreferences: false` 以独立条目参与此投影:退出宿主管理会移除既有任务上的+ 插件默认权限上限,不能通过静默更新重新启用旧任务授权。缺省/`true` → `false`+ 需要扩权确认;保持 `false` 不重复确认,恢复宿主管理不算扩权。不新增独立批准状态。- 入口与确认界面:插件页、拖入、双击 `.cindy` 与设置页导入由发起窗口弹确认框(`GhostInstallConsentWindowBridge` → `GhostInstallConsentHost`,只投给、也只接受发起安装的那个 webContents);Agent 调用 `ghost_market_install`/`ghost_forge_install` 不论任务权限档diff --git a/docs/dev-rules/plugin-task-api-implementation.md b/docs/dev-rules/plugin-task-api-implementation.mdindex ecb8d6fd3a..2ef0fd360c 100644--- a/docs/dev-rules/plugin-task-api-implementation.md+++ b/docs/dev-rules/plugin-task-api-implementation.md@@ -92,6 +92,9 @@ if (capabilities.operations.includes('models')) {`ask`、宿主管理目录;已有任务按自身授权派发,Plan、归属和能力批准检查保持。省略声明或设为 `true` 保持旧行为,并可恢复使用原宿主配置;旧客户端忽略该字段,因此依赖此语义的插件须使用已支持该声明的客户端。+退出管理会移除既有任务上的逐插件默认权限上限,因此该声明进入现有安装权限投影。+首次安装会列出说明;缺省/`true` → `false` 的更新需要现有扩权确认,后台自动更新不代为确认。+已批准的 `false` → `false` 不重复确认,恢复宿主管理不算扩权;服务端默认安装保留既有豁免。| 入口 | 模型来源与复用 | 权限与结果 || --- | --- | --- |