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。

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.md
index 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.ts
index 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 resolveMobilePluginMedia
return 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(): voi
ipcMain.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.ts
index 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=unit
it('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.ts
index 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 setGhostMediaModelsProv
ghostMediaModelsProvider = 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.md
index 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`。
+
### 同账号插件资料同步