Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
Merge remote-tracking branch 'upstream/main' into watch/pr-7472
Praise826ffefb51de
diff --cc apps/desktop/resources/system-skills/cindy-plugin-creator/references/plugin-agent-models.mdindex 1f1ad33974,517520752a..603a08e59b--- a/apps/desktop/resources/system-skills/cindy-plugin-creator/references/plugin-agent-models.md+++ b/apps/desktop/resources/system-skills/cindy-plugin-creator/references/plugin-agent-models.md@@@ -1,8 -1,59 +1,58 @@@## 4.0.3a 只读 Agent 模型目录-设置页、panel、mainView 和电子脑均可 GET 同源 `/agent-models`(不接受参数)。-返回 `{ok:true,models:[{id,name,agent,providerId,providerName,efforts,defaultEffort,visible}]}`。-visible 跟随当前账号模型选择器;建议默认显示可见项,隐藏项由用户展开。旧 Host 缺此字段时兼容原列表。+设置页、panel、mainView 和电子脑均可 GET 同源 `/agent-models`。无参时返回本机已连接且可用于新任务的模型,并追加 `locations:[{agentDeviceId,name}]`(同账号其他电脑与生效中的供应商分享,不含本机;读不到位置时省略该字段)。可选查询参数只有 `agent_device_id`:带上后只投影那台位置允许远程调用的来源,响应回显 `agentDeviceId`。同一模型在不同来源下是多项。+返回 `{ok:true,models:[{id,name,agent,providerId,providerName,efforts,defaultEffort,visible}],agentDeviceId?,locations?}`。+无参时 visible 跟随当前账号模型选择器;带参时 visible 用模型目录默认值,不套本机开关。建议默认显示可见项,隐藏项由用户展开。旧 Host 缺这些字段时兼容原列表。每项为独立的模型×框架×来源;空 efforts 与 null defaultEffort 表示未声明,不得猜测。-只包含本机已连接且可用于新任务的模型,不代表远程 SSH 目录。读取不调用模型、-不触发凭证认领或上游发现,不返回凭证、账号 identity 或 endpoint;不需要新增 manifest 权限。-旧 Host 可能返回 404,插件应明确提示升级;503 时提供重试。运行前再次核验选定来源。+不代表远程 SSH 目录。读取不调用模型、不触发凭证认领或上游发现,不返回凭证、账号 identity 或 endpoint;不需要新增 manifest 权限。- 格式非法、重复参数或其他查询参数返回 400。格式合法但那台离线、未知或没开远程控制时返回 503 且 `errorCode` 为 `NOT_AVAILABLE`,响应里没有本机条目。旧 Host 带任何参数都返回 400。旧 Host 可能返回 404,插件应明确提示升级;503 时提供重试。运行前再次核验选定来源。++格式非法、重复参数、空或超过 128 字符的设备 ID,或其他查询参数返回 400。格式合法但那台离线、未知或没开远程控制时返回 503 且 `errorCode` 为 `NOT_AVAILABLE`,响应里没有本机条目。旧 Host 带任何参数都返回 400;旧 Host 可能返回 404,插件应明确提示升级;503 时提供重试。运行前再次核验选定来源。++ ## 4.0.3b 宿主统一模型选择器(新增接口,尚未发布)++ 不想自行绘制选模界面时,电子脑调用 `cindy.pickModel(options?)`。+ Host 打开与 Cindy 共用的模型选择器,用户确认后返回完整配置;取消、关闭页面或超时不返回配置。+ 不需要新增 manifest 权限,不改应用默认、插件默认或现有任务,不调用模型。++ ```js+ if (typeof cindy.pickModel !== 'function') {+ // 当前 Host 不支持,请提示用户升级;不要改为维护一份硬编码名单。+ return;+ }+ const selected = await cindy.pickModel({+ // initial: savedRoute, // 可选,必须是下面的完整 route+ ...(msg.mobilePageId ? { mobilePageId: msg.mobilePageId } : {}),+ });+ if (selected.ok) {+ // 自行保存 selected.route;创建普通任务时可原样作为 cindy.tasks.create 的 route。+ // 任务创建和执行仍需 agent.tasks 的正常批准,选模本身不授予执行权限。+ }+ ```++ 成功:`{ok:true,route:{agentKind,providerId,model,effort,fastMode}}`。+ `agentKind` 为 `cc | codex | pi`,`effort` 为空串表示未指定,+ `fastMode` 为布尔值或 `"ultrafast"`。保留完整组合,不根据模型名重新猜来源或引擎。+ 失败:`{ok:false,errorCode,message}`;`CANCELLED` 表示本次选择已取消,+ `BUSY` / `RATE_LIMITED` 表示已有选择器或请求过频,`UNAVAILABLE` 表示没有可用宿主页面,+ `PERMISSION_DENIED` 表示来源插件或账号已变化,`INVALID_REQUEST` 表示参数不合法。+ 用户确认时 Host 重新校验真实来源、模型、档位和 Fast;不可用时保留选择器供用户改选。++ 桌面插件的 settings、panel、mainView 还可直接发起同源请求:++ ```js+ const response = await fetch('/model-picker', {+ method: 'POST',+ headers: { 'Content-Type': 'application/json' },+ body: JSON.stringify({ /* initial: savedRoute */ }),+ });+ const selected = await response.json();+ ```++ 该端点仅接受 `initial`,只支持 POST、无查询参数。旧 Host 404 时提示升级,+ 503 时提示稍后重试;正常受理的取消与错误使用上述结构化结果。+ 手机与远程桌面设置页通过业务频道交给电子脑调用 `pickModel`,必须原样转交 Host 附加的+ `mobilePageId`,选择器才会显示在发起操作的设备,并读取插件执行电脑的目录。+ 不要把 `mobilePageId` 存成全局最近设备;不传时只在插件运行电脑打开。+ 同一 Host 同时只有一个插件选模请求,等待上限 90 秒;不要后台循环弹窗或自动重试取消。+ 窗口、页面、连接、账号或安装版本变化后,旧回执不能交给替代实例。+ 此接口不选择执行电脑或 SSH 工作区,也不提供凭证、endpoint 或完整 ProviderView。+ 依赖此接口的插件应在接口正式发布后填入实际的首个 `minCindyVersion`,并保留运行时能力检查。diff --cc apps/desktop/src/main/cindy-brain/index.tsindex 1eb9f8daf2,65d2c74ccb..f29e6f7f7a--- a/apps/desktop/src/main/cindy-brain/index.ts+++ b/apps/desktop/src/main/cindy-brain/index.ts@@@ -77,11 -75,8 +75,12 @@@ async function resolveMobilePluginMediareturn file && /^[a-f0-9]{64}\.[a-z0-9]+$/.test(file) ? { path: `/media/${file}`, mediaKind: result.kind } : null;}import { getModelVisibilityOverride, waitForModelVisibilityMirror } from '../maker-host/model-visibility-mirror.js';-import { projectGhostAgentModels } from './ghostAgentModels.js';+import {+ createGhostAgentModelsCache,+ projectGhostAgentModels,+ type GhostAgentLocationsReadResult,+} from './ghostAgentModels.js';+ import { GhostModelPicker, getPluginModelPickerAgents, isPluginModelPickerRouteAvailable } from './ghostModelPicker.js';import { getDesktopProviderService } from '../maker-host/createDesktopProviderService.js';import { PluginDownloadSlot } from './downloadSlot.js';import { createDownloader } from '../downloader/index.js';@@@ -8316,8 -8324,9 +8342,9 @@@ export function registerGhostIpc(): voiipcMain.handle(LEGACY_GHOST_RECOVERY_RETRY_CHANNEL, legacyRecoveryIpc.retry);setGhostSandboxDevToolsDisabled(app.isPackaged);setGhostAppContextProvider(currentGhostAppContext);+ setGhostModelPickerProvider((id, options, current, signal) => getGhostModelPicker().request(id, options, current, signal));setGhostMediaModelsProvider(getGhostConfigurableMediaModels);- setGhostAgentModelsProvider(async (instanceId) => {+ setGhostAgentModelsProvider(async (instanceId, agentDeviceId) => {const owner = activeOwnerScopeKey();if (!findGhostForInstanceId(instanceId)?.enabled) {return { ok: false, errorCode: 'NOT_AVAILABLE', message: 'Plugin unavailable' };diff --cc apps/desktop/src/main/cindy-brain/runtime/__tests__/electronSandboxAdapter.ownerPartition.test.tsindex 462553984d,7ebfc8c8a9..cfe6115c91--- a/apps/desktop/src/main/cindy-brain/runtime/__tests__/electronSandboxAdapter.ownerPartition.test.ts+++ b/apps/desktop/src/main/cindy-brain/runtime/__tests__/electronSandboxAdapter.ownerPartition.test.ts@@@ -799,8 -798,49 +800,50 @@@ describe('electronSandboxAdapter owner});});+ describe('Host model picker endpoint', () => {+ beforeEach(() => {+ kvEndpoint.readBoundedBodyText.mockImplementation((request: Request) => request.text());+ });+ // New interactive route: catalog tests cover GET only. Minimal POST must use the+ // physical plugin identity; author-supplied remote origins must be rejected. Tier: unit.+ it('opens only from a same-instance POST and returns a credential-free selection', async () => {+ const route = { agentKind: 'codex', providerId: 'provider', model: 'model', effort: '', fastMode: false };+ const provider = vi.fn().mockResolvedValue({ ok: true, route });+ setGhostModelPickerProvider(provider);+ ensureGhostProtocolRegistered(ghost('model-picker'));+ const handler = harness.sessions.get(approvedPartition('cindy-ghost-owner:cloud:opaque-owner-a:model-picker'))!.protocolHandler!;+ for (const [url, method, body, status] of [+ ['model-picker/model-picker', 'GET', undefined, 405],+ ['other/model-picker', 'POST', '{}', 403],+ ['model-picker/model-picker?owner=b', 'POST', '{}', 400],+ ['model-picker/model-picker', 'POST', '{"mobilePageId":"other"}', 400],+ ['model-picker/model-picker', 'POST', '{', 400],+ ] as const) {+ const result = await handler(new Request('cindy-ghost://' + url, { method, body }));+ expect(result.status).toBe(status);+ }+ expect(provider).not.toHaveBeenCalled();+ const result = await handler(new Request('cindy-ghost://model-picker/model-picker', { method: 'POST', body: '{}' }));+ expect(await result.json()).toEqual({ ok: true, route });+ expect(result.headers.get('cache-control')).toBe('no-store');+ expect(provider.mock.calls[0][0]).toBe('model-picker');+ });++ it('withholds an interactive result when the originating installation changes while the picker is open', async () => {+ let finish!: (value: import('../../../../shared/pluginModelPicker').PluginModelPickerResult) => void;+ setGhostModelPickerProvider(() => new Promise(resolve => { finish = resolve; }));+ ensureGhostProtocolRegistered(ghost('model-picker-owner'));+ const handler = harness.sessions.get(approvedPartition('cindy-ghost-owner:cloud:opaque-owner-a:model-picker-owner'))!.protocolHandler!;+ const pending = handler(new Request('cindy-ghost://model-picker-owner/model-picker', { method: 'POST', body: '{}' }));+ await vi.waitFor(() => expect(finish).toBeTypeOf('function'));+ harness.activeOwner = { mode: 'cloud', dataOwnerId: 'owner-b', generation: 2 };+ finish({ ok: true, route: { agentKind: 'codex', providerId: 'provider', model: 'model', effort: '', fastMode: false } });+ expect((await pending).status).toBe(403);+ });+ });+describe('read-only agent model directory', () => {+ // 测试价值:生产入口 protocolHandler GET /agent-models;#7452 远程位置/400/503/60s 缓存;原用例只覆盖无参。tier=unitit('identifies the organization instance when a root plugin has the same id', async () => {const provider = vi.fn().mockResolvedValue({ ok: true, models: [] });setGhostAgentModelsProvider(provider);diff --cc apps/desktop/src/main/cindy-brain/runtime/electronSandboxAdapter.tsindex b2c22e6d6d,4a4861d09a..0c790e52a6--- a/apps/desktop/src/main/cindy-brain/runtime/electronSandboxAdapter.ts+++ b/apps/desktop/src/main/cindy-brain/runtime/electronSandboxAdapter.ts@@@ -279,9 -269,13 +269,13 @@@ export function setGhostMediaModelsProvghostMediaModelsProvider = provider;}-let ghostAgentModelsProvider: ((ghostId: string) => Promise<GhostAgentModelsResult>) | null = null;+let ghostAgentModelsProvider: ((ghostId: string, agentDeviceId?: string) => Promise<GhostAgentModelsResult>) | null = null;+ let ghostModelPickerProvider: ((id: string, options: unknown, current: () => boolean, signal: AbortSignal) => Promise<import('../../../shared/pluginModelPicker.js').PluginModelPickerResult>) | null = null;+ export function setGhostModelPickerProvider(provider: NonNullable<typeof ghostModelPickerProvider>): void {+ ghostModelPickerProvider = provider;+ }export function setGhostAgentModelsProvider(- provider: (ghostId: string) => Promise<GhostAgentModelsResult>,+ provider: (ghostId: string, agentDeviceId?: string) => Promise<GhostAgentModelsResult>,): void {ghostAgentModelsProvider = provider;}diff --cc docs/dev-rules/plugin-security-and-authoring.mdindex ef7550899f,05ea8d84fe..79f59a2403--- a/docs/dev-rules/plugin-security-and-authoring.md+++ b/docs/dev-rules/plugin-security-and-authoring.md@@@ -920,19 -925,31 +925,36 @@@ IPC 时追加对应专项规则要求�### 只读 Agent 模型目录插件自己的同源 `GET /agent-models` 面向 settings、panel、mainView 与电子脑。-无需新增 manifest 权限,不改变存量批准状态。仅投影已连接来源中可用于新任务的本机-`id/name/agent/providerId/providerName/efforts/defaultEffort/visible`,来源级强度不能被跨来源合并。-visible 复用当前账号模型选择器的用户开关与目录默认值;隐藏项保留供显式展开,偏好未就绪不伪造默认。-使用 ProviderService 的 `allowSideEffects:false` 读取,不主动发现或认领凭证,不调用模型。-不暴露 ProviderView、auth、账号 identity 或 endpoint;响应 no-store、仅 GET、无参数,-检查插件在装启用与 owner 归属,异步返回前复核。旧 Host 404 时插件应明确提示升级。-此端点不覆盖远程 SSH 模型,执行前仍需核验真实路由。+无需新增 manifest 权限,不改变存量批准状态。无参时投影已连接来源中可用于新任务的本机+`id/name/agent/providerId/providerName/efforts/defaultEffort/visible`,并追加 `locations`+(同账号其他电脑与生效中的供应商分享,不含本机;读失败则省略)。可选查询参数只有+`agent_device_id`:带上后读那台允许远程调用的来源并回显 `agentDeviceId`,不查 `locations`。+来源级强度不能被跨来源合并。无参 visible 复用当前账号模型选择器的用户开关与目录默认值;+带参 visible 只用模型目录默认值,不套本机开关。隐藏项保留供显式展开,偏好未就绪不伪造默认。+使用 ProviderService 的 `allowSideEffects:false` 读取本机清单;带参经 `readDeviceProviderViews`+跨设备读取。不主动发现或认领凭证,不调用模型。不暴露 ProviderView、auth、账号 identity 或 endpoint;+响应 no-store、仅 GET。其他参数、重复参数、空或超过 128 字符的 id 返回 400;格式合法但读不到+(离线、未知、没开远程控制)返回 503 且 `errorCode` 为 `NOT_AVAILABLE`,响应里没有本机条目。+旧 Host 带任何参数都返回 400。检查插件在装启用与 owner 归属,异步返回前复核。+旧 Host 404 时插件应明确提示升级。此端点不覆盖远程 SSH 模型,执行前仍需核验真实路由。+ ### 宿主统一模型选择器(新增接口,尚未发布)++ 电子脑 `cindy.pickModel({initial?,mobilePageId?})` 与桌面页面同源 `POST /model-picker`+ 复用 Cindy 的统一模型选择器,返回完整 `PluginTaskRoute`(来源、模型、引擎、思考档位、Fast)。+ 选模不需要新的 manifest 权限、不改变存量批准,不修改默认或现有任务、不执行模型调用。+ 任务创建仍走原任务能力批准。仅返回显式配置字段,不返回凭证、endpoint 或 ProviderView。++ Main 按真实逻辑页或专属协议分区定位物理实例,绑定当前 owner 与安装批准版本;+ 只接受目标宿主窗口或目标页面的回答,验证输入形状与实际可用路由,异步校验后再次复核绑定。+ 同一 Host 仅一单,重复打开沿用目录选择的限速。取消、90 秒超时、窗口/页面关闭、账号边界、+ 插件停止均撤销等待并收起界面;不可用的来源保持选择器可编辑,不能静默换模型。+ 手机与远程桌面设置页保留显式 mobilePageId,展示端读取执行电脑目录,缺失/失效来源不回退另一设备。+ 旧 Host 通过函数检查/404 明确升级;旧控制端忽略新增可选 modelPickers,超时取消,不产生执行。++ 实现见 `ghostModelPicker.ts`、`PluginModelPickerHost.tsx`、`mobilePageService.ts`;+ 作者契约见 `cindy-plugin-creator/references/plugin-agent-models.md`,回归见 `ghostModelPicker.test.ts`。+### 同账号插件资料同步