Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
feat(plugins): 提供只读模型目录与可见性
Dash3780ebbb7930
diff --git a/apps/desktop/src/main/cindy-brain/__tests__/ghostAgentModels.test.ts b/apps/desktop/src/main/cindy-brain/__tests__/ghostAgentModels.test.tsnew file mode 100644index 0000000000..266c8500b2--- /dev/null+++ b/apps/desktop/src/main/cindy-brain/__tests__/ghostAgentModels.test.ts@@ -0,0 +1,97 @@+import { describe, expect, it } from 'vitest';+import type { ProviderView } from '@cindy/model-providers';+import { projectGhostAgentModels } from '../ghostAgentModels.js';++const provider = (id: string, efforts: string[]) =>+ ({+ id,+ name: id,+ source: 'user',+ connected: true,+ agents: ['codex'],+ routing: { codex: { enabled: true } },+ models: {+ codex: [+ { id: 'model', name: 'Model', mode: 'chat', efforts, defaultEffort: efforts[0] ?? null },+ ],+ },+ auth: { apiKey: 'secret' },+ endpoint: 'private',+ subscriptionAccount: { identity: 'private' },+ }) as unknown as ProviderView;++describe('plugin model projection', () => {+ it('uses per-route user visibility before catalog defaults without removing hidden models', () => {+ const a = provider('a', ['high']);+ a.models.codex![0]!.defaultEnabled = false;+ const b = provider('b', ['high']);+ const result = projectGhostAgentModels([a,b], (_, id) => id === 'a' ? true : false);+ expect(result.ok && result.models.map(m => m.visible)).toEqual([true,false]);+ const defaults = projectGhostAgentModels([a,b]);+ expect(defaults.ok && defaults.models.map(m => m.visible)).toEqual([false,true]);+ });+ it('preserves per-provider efforts and exposes only explicit metadata fields', () => {+ const result = projectGhostAgentModels([+ provider('a', ['low', 'high']),+ provider('b', ['medium']),+ ]);+ expect(result).toEqual({+ ok: true,+ models: [+ {+ visible: true,+ id: 'model',+ name: 'Model',+ agent: 'codex',+ providerId: 'a',+ providerName: 'a',+ efforts: ['low', 'high'],+ defaultEffort: 'low',+ },+ {+ visible: true,+ id: 'model',+ name: 'Model',+ agent: 'codex',+ providerId: 'b',+ providerName: 'b',+ efforts: ['medium'],+ defaultEffort: 'medium',+ },+ ],+ });+ });+ it('excludes disconnected, suspended, disabled, retired, paid-locked and non-chat routes', () => {+ const a = provider('a', []);+ a.models.codex!.push(+ ...['disabled', 'retired', 'locked', 'image'].map((id) => ({+ ...a.models.codex![0]!,+ id,+ disabled: id === 'disabled',+ status: id === 'retired' ? ('retired' as const) : undefined,+ availability: id === 'locked' ? ('requires_payment' as const) : undefined,+ mode: id === 'image' ? 'image' : 'chat',+ })),+ );+ const result = projectGhostAgentModels([+ a,+ { ...provider('offline', []), connected: false },+ { ...provider('paused', []), suspended: true },+ ]);+ expect(result).toEqual({+ ok: true,+ models: [+ {+ visible: true,+ id: 'model',+ name: 'Model',+ agent: 'codex',+ providerId: 'a',+ providerName: 'a',+ efforts: [],+ defaultEffort: null,+ },+ ],+ });+ });+});diff --git a/apps/desktop/src/main/cindy-brain/forge.ts b/apps/desktop/src/main/cindy-brain/forge.tsindex 10cddcd277..215bc6ea9f 100644--- a/apps/desktop/src/main/cindy-brain/forge.ts+++ b/apps/desktop/src/main/cindy-brain/forge.ts@@ -2507,6 +2507,16 @@ const r = await cindy.send({- 同步返回,没有异步单;每插件在途上限与媒体代办共用;详情页会单列一行「可把文字送去算成向量」并写明单次条数上限。+## 4.0.3a 只读 Agent 模型目录++设置页、panel、mainView 和电子脑均可 GET 同源 \`/agent-models\`(不接受参数)。+返回 \`{ok:true,models:[{id,name,agent,providerId,providerName,efforts,defaultEffort,visible}]}\`。+visible 跟随当前账号模型选择器;建议默认显示可见项,隐藏项由用户展开。旧 Host 缺此字段时兼容原列表。+每项为独立的模型×框架×来源;空 efforts 与 null defaultEffort 表示未声明,不得猜测。+只包含本机已连接且可用于新任务的模型,不代表远程 SSH 目录。读取不调用模型、+不触发凭证认领或上游发现,不返回凭证、账号 identity 或 endpoint;不需要新增 manifest 权限。+旧 Host 可能返回 404,插件应明确提示升级;503 时提供重试。运行前再次核验选定来源。+## 4.0.4 媒体模型配置与调用边界媒体上层能力由插件定义,Cindy Core 只提供两项低级能力:diff --git a/apps/desktop/src/main/cindy-brain/ghostAgentModels.ts b/apps/desktop/src/main/cindy-brain/ghostAgentModels.tsnew file mode 100644index 0000000000..47ae871f4a--- /dev/null+++ b/apps/desktop/src/main/cindy-brain/ghostAgentModels.ts@@ -0,0 +1,31 @@+import {+ connectedProvidersForAgent,+ isModelVisible,+ isModelSelectableForNewRoute,+ type ProviderView,+} from '@cindy/model-providers';+import type { GhostAgentModelsResult } from '../../shared/ghost.js';++/** Project each provider separately: the same model can support different efforts per route. */+export function projectGhostAgentModels(views: ProviderView[], visibilityOverride: (agent: 'codex' | 'claude-code' | 'pi', providerId: string, modelId: string) => boolean | undefined = () => undefined): GhostAgentModelsResult {+ const models: Extract<GhostAgentModelsResult, { ok: true }>['models'] = [];+ for (const agent of ['codex', 'claude-code', 'pi'] as const) {+ for (const provider of connectedProvidersForAgent(views, agent)) {+ for (const model of provider.models[agent] ?? []) {+ if (!isModelSelectableForNewRoute(model, { userProvider: provider.source === 'user' }))+ continue;+ models.push({+ visible: isModelVisible(visibilityOverride(agent, provider.id, model.id), model.defaultEnabled),+ id: model.id,+ name: model.name,+ agent,+ providerId: provider.id,+ providerName: provider.name,+ efforts: [...model.efforts],+ defaultEffort: model.defaultEffort,+ });+ }+ }+ }+ return { ok: true, models };+}diff --git a/apps/desktop/src/main/cindy-brain/index.ts b/apps/desktop/src/main/cindy-brain/index.tsindex 8c46a25c73..b565558d87 100644--- a/apps/desktop/src/main/cindy-brain/index.ts+++ b/apps/desktop/src/main/cindy-brain/index.ts@@ -1,3 +1,6 @@+import { getModelVisibilityOverride, waitForModelVisibilityMirror } from '../maker-host/model-visibility-mirror.js';+import { projectGhostAgentModels } from './ghostAgentModels.js';+import { getDesktopProviderService } from '../maker-host/createDesktopProviderService.js';import { registerGhostCardRemoteProvider, persistGhostCardWithRemoteChange } from './cardRemoteResource.js';import { openDeviceAuthorizationCard, openPluginAuthorizationCard } from '../plugin-oauth/deviceCard.js';import { t as authorizationText } from '../i18n.js';@@ -141,6 +144,7 @@ import {setGhostConnectionsHandler,setGhostKvStore,setGhostMediaModelsProvider,+ setGhostAgentModelsProvider,setGhostOauthHandler,setGhostSandboxDevToolsDisabled,setGhostSecretsHandler,@@ -6642,6 +6646,19 @@ export function registerGhostIpc(): void {setGhostSandboxDevToolsDisabled(app.isPackaged);setGhostAppContextProvider(currentGhostAppContext);setGhostMediaModelsProvider(getGhostConfigurableMediaModels);+ setGhostAgentModelsProvider(async (ghostId) => {+ const owner = activeOwnerScopeKey();+ if (!findAvailableGhost(ghostId)?.enabled) {+ return { ok: false, errorCode: 'NOT_AVAILABLE', message: 'Plugin unavailable' };+ }+ const views = await getDesktopProviderService().listProviders({ allowSideEffects: false });+ if (owner !== activeOwnerScopeKey() || !findAvailableGhost(ghostId)?.enabled) {+ return { ok: false, errorCode: 'NOT_AVAILABLE', message: 'Plugin unavailable' };+ }+ await waitForModelVisibilityMirror();+ if (owner !== activeOwnerScopeKey() || !findAvailableGhost(ghostId)?.enabled) return { ok: false, errorCode: 'NOT_AVAILABLE', message: 'Plugin unavailable' };+ return projectGhostAgentModels(views, getModelVisibilityOverride);+ });// 面板唤醒电子脑(cindy-ghost://<id>/wake 供片分支):面板零桥,唤醒经它// 自己的协议通道进来。只对"已装且唤醒"的意识放行;熔断态不清账(重载 /// 重新唤醒才 resetFuse),spawn 幂等所以重复唤醒零成本。diff --git 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.tsindex cbb5ee3fac..898045fc85 100644--- 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@@ -107,6 +107,7 @@ import {electronSandboxAdapter,ensureGhostProtocolRegistered,setGhostAppContextProvider,+ setGhostAgentModelsProvider,setGhostKvStore,setGhostMediaModelsProvider,} from '../electronSandboxAdapter';@@ -395,3 +396,40 @@ describe('electronSandboxAdapter owner partition', () => {handle.destroy();});});++describe('read-only agent model directory', () => {+ it('serves no-store metadata without accepting writes or query overrides', async () => {+ const provider = vi.fn().mockResolvedValue({ ok: true, models: [] });+ setGhostAgentModelsProvider(provider);+ ensureGhostProtocolRegistered(ghost('agent-directory'));+ const handler = harness.sessions.get('cindy-ghost-owner:cloud:opaque-owner-a:agent-directory')!.protocolHandler!;+ for (const [url, method, status] of [+ ['agent-directory/agent-models', 'GET', 200],+ ['agent-directory/agent-models', 'POST', 405],+ ['agent-directory/agent-models?owner=other', 'GET', 400],+ ['other/agent-models', 'GET', 403],+ ] as const) {+ const response = await handler(new Request('cindy-ghost://' + url, { method }));+ expect(response.status).toBe(status);+ }+ expect(provider).toHaveBeenCalledExactlyOnceWith('agent-directory');+ const response = await handler(new Request('cindy-ghost://agent-directory/agent-models'));+ expect(response.headers.get('cache-control')).toBe('no-store');+ expect(await response.json()).toEqual({ ok: true, models: [] });+ provider.mockRejectedValue(new Error('secret upstream details'));+ const failed = await handler(new Request('cindy-ghost://agent-directory/agent-models'));+ expect(failed.status).toBe(503);+ expect(await failed.text()).not.toContain('secret');+ });+ it('does not deliver an in-flight catalog after owner changes', async () => {+ let finish!: (value: { ok: true; models: [] }) => void;+ setGhostAgentModelsProvider(() => new Promise(resolve => { finish = resolve; }));+ ensureGhostProtocolRegistered(ghost('agent-owner'));+ const handler = harness.sessions.get('cindy-ghost-owner:cloud:opaque-owner-a:agent-owner')!.protocolHandler!;+ const pending = handler(new Request('cindy-ghost://agent-owner/agent-models'));+ harness.activeOwner = { mode: 'cloud', dataOwnerId: 'owner-b', generation: 2 };+ finish({ ok: true, models: [] });+ expect((await pending).status).toBe(403);+ expect((await handler(new Request('cindy-ghost://agent-owner/agent-models'))).status).toBe(403);+ });+});diff --git a/apps/desktop/src/main/cindy-brain/runtime/electronSandboxAdapter.ts b/apps/desktop/src/main/cindy-brain/runtime/electronSandboxAdapter.tsindex bb546ffd20..e7fce9e561 100644--- a/apps/desktop/src/main/cindy-brain/runtime/electronSandboxAdapter.ts+++ b/apps/desktop/src/main/cindy-brain/runtime/electronSandboxAdapter.ts@@ -9,6 +9,7 @@ import { createLogger } from '../../logger.js';import {GHOST_SCHEME,type GhostAppContextResult,+ type GhostAgentModelsResult,type GhostMediaModelsResult,type GhostMediaModelType,type InstalledGhost,@@ -151,6 +152,13 @@ export function setGhostMediaModelsProvider(ghostMediaModelsProvider = provider;}+let ghostAgentModelsProvider: ((ghostId: string) => Promise<GhostAgentModelsResult>) | null = null;+export function setGhostAgentModelsProvider(+ provider: (ghostId: string) => Promise<GhostAgentModelsResult>,+): void {+ ghostAgentModelsProvider = provider;+}+/*** 意识自定义参数 KV 存储(index.ts 注入,同 ghostWakeHandler 模式避免* adapter 反向依赖)。注入的是带"在装态守卫"的包装层——卸下后分区里@@ -363,6 +371,25 @@ function registerGhostProtocol(},});}+ if (url.pathname === '/agent-models') {+ const headers = { 'Content-Type': 'application/json; charset=utf-8', 'Cache-Control': 'no-store' };+ if (request.method !== 'GET') return new Response(null, { status: 405, headers });+ if (url.search) return new Response(null, { status: 400, headers });+ if (!ghostAgentModelsProvider) return new Response(null, { status: 503, headers });+ try {+ const result = await ghostAgentModelsProvider(ghostId);+ if (!isGhostProtocolOwnerActive(owner)) return new Response(null, { status: 403, headers });+ return new Response(JSON.stringify(result), {+ status: result.ok ? 200 : result.errorCode === 'PERMISSION_DENIED' ? 403 : 503,+ headers,+ });+ } catch {+ return new Response(+ JSON.stringify({ ok: false, errorCode: 'NOT_AVAILABLE', message: 'Model catalog unavailable' }),+ { status: 503, headers },+ );+ }+ }// /media-models?type=image|video:插件自己的设置页 / 面板读取当前客户端可执行// 模型及 Gateway modalities。兼容判定由 Host provider 完成;端点仍不发起生成,// 也不返回凭证、endpoint、Guide 或内部判定细节。diff --git a/apps/desktop/src/shared/ghost.ts b/apps/desktop/src/shared/ghost.tsindex afe3f378a5..48514c0602 100644--- a/apps/desktop/src/shared/ghost.ts+++ b/apps/desktop/src/shared/ghost.ts@@ -6776,6 +6776,23 @@ export interface GhostAppContextResult {};}+/** Read-only local agent routes. No credentials or provider configuration. */+export type GhostAgentModelsResult =+ | {+ ok: true;+ models: Array<{+ visible?: boolean;+ id: string;+ name: string;+ agent: 'codex' | 'claude-code' | 'pi';+ providerId: string;+ providerName: string;+ efforts: string[];+ defaultEffort: string | null;+ }>;+ }+ | { ok: false; errorCode: 'PERMISSION_DENIED' | 'NOT_AVAILABLE'; message: string };+/** 插件设置页 / 面板可读取的 Cindy Core 媒体模型类型。 */export const GHOST_MEDIA_MODEL_TYPES = ['image', 'video'] as const;export type GhostMediaModelType = (typeof GHOST_MEDIA_MODEL_TYPES)[number];diff --git a/docs/dev-rules/plugin-security-and-authoring.md b/docs/dev-rules/plugin-security-and-authoring.mdindex 2432605e5b..fa84ef5c67 100644--- a/docs/dev-rules/plugin-security-and-authoring.md+++ b/docs/dev-rules/plugin-security-and-authoring.md@@ -635,3 +635,14 @@ pnpm --filter desktop typecheck其余按 [`desktop-development.md`](desktop-development.md) 的分层验证选择;命中媒体、协议或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 模型,执行前仍需核验真实路由。