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。

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.ts
new file mode 100644
index 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.ts
index 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.ts
new file mode 100644
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.md
index 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 模型,执行前仍需核验真实路由。