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(desktop): 分享来的供应商在模型列表底部也显示「配置模型」,直达设置里这条分享

fmfsaisaia5a75dc397f9
diff --git a/apps/desktop/src/renderer/__tests__/modelSelectorSharedProviderSettingsEntry.test.tsx b/apps/desktop/src/renderer/__tests__/modelSelectorSharedProviderSettingsEntry.test.tsx
new file mode 100644
index 0000000000..7bd17872e8
--- /dev/null
+++ b/apps/desktop/src/renderer/__tests__/modelSelectorSharedProviderSettingsEntry.test.tsx
@@ -0,0 +1,191 @@
+// @vitest-environment jsdom
+/**
+ * 模型面板底部「配置模型」:本机目录与分享来的供应商显示,点分享来的供应商时带上分享 id,
+ * 设置页直接选中那一条(provider-sharing.md §5.2)。自己其他电脑与被控电脑上的目录要到那台电脑上改,不显示。
+ */
+import { act, cleanup, fireEvent, render, screen } from '@testing-library/react';
+import React from 'react';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+vi.mock('react-i18next', async (importOriginal) => ({
+ ...(await importOriginal<typeof import('react-i18next')>()),
+ useTranslation: () => ({
+ t: (key: string, options?: Record<string, string>) =>
+ key === 'newChat.modelSelector.unified.railRemoteProvider'
+ ? `${options?.provider ?? ''} · ${options?.device ?? ''}`
+ : options?.defaultValue ?? key,
+ }),
+}));
+
+vi.mock('@/lib/scrollbarAutoHide', () => ({ flashScrollbar: vi.fn() }));
+
+vi.mock('@/hooks/useAgentCapabilities', () => ({
+ evictDeviceCapabilities: vi.fn(),
+ prefetchDeviceCapabilities: vi.fn(async () => {}),
+ useAgentCapabilities: () => ({
+ capabilities: { hasFastMode: false, effortLevels: [], availableModels: [] },
+ loading: false,
+ error: null,
+ }),
+}));
+vi.mock('@/hooks/useApiKey', () => ({ useApiKey: () => ({ hasSavedKey: true }) }));
+vi.mock('@/hooks/useConnectedSource', () => ({
+ useConnectedSource: () => ({ hasConnectedSource: true, loading: false }),
+}));
+vi.mock('@/hooks/useModelPricing', () => ({
+ useGatewayModelPricing: () => null,
+ useReferenceModelPricing: () => null,
+}));
+
+const catalogs = vi.hoisted(() => {
+ const provider = (id: string, name: string, modelId: string, extra: Record<string, unknown> = {}) => ({
+ id,
+ name,
+ source: 'user',
+ agents: ['claude-code'],
+ auth: { method: 'api-key' },
+ routing: { 'claude-code': {} },
+ connected: true,
+ models: {
+ 'claude-code': [
+ { id: modelId, name: modelId, contextWindow: 200000, efforts: ['high'], defaultEffort: 'high' },
+ ],
+ },
+ ...extra,
+ });
+ return {
+ local: [provider('a-local', 'A Local', 'a-model')] as unknown[],
+ byDevice: {
+ 'device-b': [provider('b-main', 'B Main', 'b-model')],
+ 'device-c': [provider('c-open', 'C Open', 'c-model', { remoteInvocationEnabled: true })],
+ 'share:abc': [provider('s-shared', 'S Shared', 's-model', { remoteInvocationEnabled: true })],
+ } as Record<string, unknown[]>,
+ };
+});
+
+vi.mock('@/hooks/useProviders', () => ({
+ useProviders: () => ({ providers: catalogs.local, providerOrder: [] }),
+}));
+vi.mock('@/hooks/useDeviceProviders', () => ({
+ evictDeviceProviders: vi.fn(),
+ prefetchDeviceProviders: vi.fn(async () => {}),
+ useDeviceProviders: (deviceId?: string) => ({
+ providers: deviceId ? (catalogs.byDevice[deviceId] ?? []) : [],
+ loading: false,
+ error: null,
+ unsupported: false,
+ }),
+}));
+vi.mock('@/hooks/useDevicesProviders', () => ({
+ useDevicesProviders: (deviceIds: readonly string[]) =>
+ new Map(
+ deviceIds.map((deviceId) => [
+ deviceId,
+ { providers: catalogs.byDevice[deviceId] ?? [], loading: false, error: null },
+ ]),
+ ),
+}));
+vi.mock('@/state/modelVisibilityPrefs', () => ({
+ isModelEnabled: () => true,
+ useModelVisibilityVersion: () => 0,
+}));
+vi.mock('@/state/deviceLinkModelMirror', () => ({
+ useDeviceLinkModelMirrorVersion: () => 0,
+}));
+vi.mock('@/hooks/useRemoteDeviceUsage', () => ({
+ useRemoteCodexAccountUsage: () => null,
+ useRemoteXaiSubscriptionUsage: () => null,
+}));
+vi.mock('@/hooks/useRemoteClaudeSubscriptionUsage', () => ({
+ useRemoteClaudeSubscriptionUsage: () => null,
+}));
+
+import { ModelSelectorContent } from '@/components/new-chat/ModelSelector';
+import { __resetForTest as resetEnginePrefs } from '@/state/modelEnginePrefs';
+import { __resetForTest as resetFavorites } from '@/state/modelFavorites';
+
+const studio = { deviceId: 'device-c', name: 'Studio' };
+const share = { deviceId: 'share:abc', name: '来自 Magi 的分享' };
+const SHARE_CELL = 'S Shared · 来自 Magi 的分享';
+const ENTRY = 'newChat.modelSelector.source.connect';
+
+type Props = React.ComponentProps<typeof ModelSelectorContent>;
+
+function renderPanel(
+ remoteAgent: Partial<NonNullable<Props['remoteAgent']>> = {},
+ props: Partial<Props> = {},
+) {
+ const onNavigateToProviders = vi.fn();
+ render(
+ React.createElement(ModelSelectorContent, {
+ modelId: 'a-model',
+ effort: 'high',
+ onModelChange: vi.fn(),
+ onEffortChange: vi.fn(),
+ currentProviderId: 'a-local',
+ onProviderChange: vi.fn(),
+ onUnifiedSelect: vi.fn(async () => true),
+ vendorKey: 'cc',
+ onNavigateToProviders,
+ remoteAgent: { devices: [studio, share], selectedDeviceId: null, ...remoteAgent },
+ ...props,
+ }),
+ );
+ return { onNavigateToProviders };
+}
+
+async function browse(name: string) {
+ await act(async () => {
+ fireEvent.click(screen.getByRole('button', { name }));
+ });
+}
+
+beforeEach(() => {
+ resetEnginePrefs();
+ resetFavorites();
+});
+
+afterEach(() => {
+ cleanup();
+});
+
+describe('模型面板底部「配置模型」', () => {
+ it('本机目录照旧显示,打开供应商页不带目标', () => {
+ const { onNavigateToProviders } = renderPanel();
+ fireEvent.click(screen.getByRole('button', { name: ENTRY }));
+ expect(onNavigateToProviders).toHaveBeenCalledOnce();
+ expect(onNavigateToProviders).toHaveBeenCalledWith(undefined);
+ });
+
+ it('浏览分享来的供应商时显示,点击带上这条分享', async () => {
+ const { onNavigateToProviders } = renderPanel();
+ await browse(SHARE_CELL);
+ fireEvent.click(screen.getByRole('button', { name: ENTRY }));
+ expect(onNavigateToProviders).toHaveBeenCalledWith({ shareId: 'abc' });
+ });
+
+ it('Agent 已在分享上:打开时停在分享的目录,同样带上这条分享', () => {
+ const { onNavigateToProviders } = renderPanel(
+ { selectedDeviceId: 'share:abc' },
+ { modelId: 's-model', currentProviderId: 's-shared' },
+ );
+ fireEvent.click(screen.getByRole('button', { name: ENTRY }));
+ expect(onNavigateToProviders).toHaveBeenCalledWith({ shareId: 'abc' });
+ });
+
+ it('自己其他电脑上的远程供应商不显示(要到那台电脑上改)', async () => {
+ renderPanel();
+ await browse('C Open · Studio');
+ expect(screen.queryByRole('button', { name: ENTRY })).toBeNull();
+ });
+
+ it('被控电脑上的任务:浏览分享来的供应商也不显示(本机设置管不到那台电脑)', async () => {
+ renderPanel(
+ { homeDeviceId: 'device-b' },
+ { deviceId: 'device-b', modelId: 'b-model', currentProviderId: 'b-main' },
+ );
+ expect(screen.queryByRole('button', { name: ENTRY })).toBeNull();
+ await browse(SHARE_CELL);
+ expect(screen.queryByRole('button', { name: ENTRY })).toBeNull();
+ });
+});
diff --git a/apps/desktop/src/renderer/__tests__/providersSectionDeepLink.test.tsx b/apps/desktop/src/renderer/__tests__/providersSectionDeepLink.test.tsx
index 2cb7c929b9..17405c7245 100644
--- a/apps/desktop/src/renderer/__tests__/providersSectionDeepLink.test.tsx
+++ b/apps/desktop/src/renderer/__tests__/providersSectionDeepLink.test.tsx
@@ -13,6 +13,7 @@ import React from 'react';
import { MemoryRouter, Route, Routes, useLocation } from 'react-router-dom';
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import type { ProviderShareReceived } from '@cindy/device-link';
import type { ProviderView } from '@cindy/model-providers';
const {
@@ -133,6 +134,7 @@ import { updateCustomProvider } from '@/lib/customProviders';
import { ProvidersSection } from '@/components/settings/ProvidersSection';
import { useProviderSubscriptionCard } from '@/components/settings/useProviderSubscriptionCard';
import { __testing as localProviderGroupsTesting } from '@/features/provider-group/useLocalProviderGroups';
+import { resetProviderShareStoreForTests } from '@/features/provider-share/providerShareStore';
vi.mock('@/components/settings/useProviderSubscriptionCard', () => ({
useProviderSubscriptionCard: vi.fn(() => null),
@@ -1068,3 +1070,49 @@ describe('ProvidersSection — 允许被远程调用与供应商组', () => {
expect(command).not.toHaveBeenCalledWith(expect.objectContaining({ action: 'get' }));
});
});
+
+// 模型面板底部「配置模型」在分享来的供应商上带 receivedShare,设置页直接选中那一条。
+describe('ProvidersSection — 分享来的供应商深链', () => {
+ const share: ProviderShareReceived = {
+ shareId: 'share-1',
+ memberId: 'mem-1',
+ providerId: 'anthropic',
+ providerLabel: 'Anthropic',
+ hostDeviceId: 'host-1',
+ deviceName: "Magi's Mac Mini",
+ owner: { displayName: 'Magi', avatarUrl: null, region: 'global' },
+ // 暂停中的分享不读对方目录,详情页不依赖 device-link。
+ status: 'paused',
+ hostOnline: true,
+ hostCapable: true,
+ };
+
+ function stubReceived(received: ProviderShareReceived[]) {
+ resetProviderShareStoreForTests();
+ const command = vi.fn(async (cmd: { action: string }) => {
+ if (cmd.action === 'received') return received;
+ throw new Error(`unexpected ${cmd.action}`);
+ });
+ Object.assign(window.electronAPI, {
+ providerShare: { command, onReceivedChanged: () => () => undefined },
+ });
+ }
+
+ afterEach(() => resetProviderShareStoreForTests());
+
+ it('receivedShare=<shareId> → 选中那条分享来的供应商;参数消费后清除', async () => {
+ stubReceived([share]);
+ renderAt('?tab=providers&receivedShare=share-1');
+
+ await screen.findByTestId('provider-share-received-detail');
+ await waitFor(() => expect(screen.getByTestId('search').textContent).toBe('?tab=providers'));
+ });
+
+ it('这条分享已不在列表里 → 只停在供应商页,参数同样清除', async () => {
+ stubReceived([]);
+ renderAt('?tab=providers&receivedShare=share-gone');
+
+ await waitFor(() => expect(screen.getByTestId('search').textContent).toBe('?tab=providers'));
+ expect(screen.queryByTestId('provider-share-received-detail')).toBeNull();
+ });
+});
diff --git a/apps/desktop/src/renderer/components/new-chat/ChatInput.tsx b/apps/desktop/src/renderer/components/new-chat/ChatInput.tsx
index 2319f2fdbb..e97960b3e9 100644
--- a/apps/desktop/src/renderer/components/new-chat/ChatInput.tsx
+++ b/apps/desktop/src/renderer/components/new-chat/ChatInput.tsx
@@ -125,6 +125,7 @@ import {
resolveModelSelectorAgentIdentity,
type EffortChangeOptions,
type ModelMemoryAccessors,
+ type ProvidersNavigationTarget,
type RemoteAgentSelectorOptions,
type UnifiedSelectionAgentDevice,
} from './ModelSelector';
@@ -414,6 +415,7 @@ import { appendMentionChip } from './mentionChipInsertion';
// device-link 远程会话:设置变更不落本地 DB(会 404),改写远程内存层 + 运行时隧道。
import { getSessionDeviceId } from '@/features/device-link/remoteProjectsStore';
import { readSessionProviderGroup } from '@/features/provider-group/sessionProviderGroup';
+import { providersSettingsPath } from '@/features/provider-share/providerShareNavigation';
import { makerApiFor, makerApiForDevice, makerApiForSticky, subscribeRemoteCredentialSwitchOutcome } from '@/lib/makerTransport';
import { SESSION_LINK_DROP_MIME } from '@/lib/sessionLinkDrop';
@@ -8372,8 +8374,8 @@ export function ChatInput({
byModel: (modelId, expectedRevision) => performModelChange(modelId, expectedRevision),
};
- const handleNavigateToProviders = useCallback(() => {
- navigate('/settings?tab=providers');
+ const handleNavigateToProviders = useCallback((target?: ProvidersNavigationTarget) => {
+ navigate(providersSettingsPath(target));
}, [navigate]);
const handleReconnectSource = useCallback(() => {
diff --git a/apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx b/apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx
index e03ff02cc9..d4190d975a 100644
--- a/apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx
+++ b/apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx
@@ -116,7 +116,7 @@ import {
} from '@/lib/providerModels';
import type { Effort } from '@/lib/userPreferences.types';
import type { SessionRuntimeProfileProjection } from '@/lib/ccAgent.types';
-import { isProviderShareAgentDeviceId } from '../../../shared/providerShare';
+import { isProviderShareAgentDeviceId, providerShareIdOfAgentDeviceId } from '../../../shared/providerShare';
import {
CHATGPT_MODEL_PREFIX,
XAI_MODEL_PREFIX,
@@ -657,6 +657,12 @@ export function resolveModelSelectorAgentIdentity(
/** 远程 Agent 草稿里一次行选中的落点电脑;null = Agent 在本机。 */
export type UnifiedSelectionAgentDevice = { deviceId: string; name: string } | null;
+/** 「配置模型」打开设置 → 模型供应商时直接选中的一项;不传 = 只打开供应商页。 */
+export interface ProvidersNavigationTarget {
+ /** 分享来的供应商:选中「分享给我的供应商」里的这一条(provider-sharing.md §5.2)。 */
+ shareId: string;
+}
+
/** 已建任务里选中了另一台电脑(或本机)目录里的一行:连 Agent 的运行位置一起换。 */
export interface RemoteAgentRelocation {
providerId: string;
@@ -735,7 +741,8 @@ interface ModelSelectorProps {
* - currentProviderId:本会话当前显式选定的供应商 id(null = 跟随默认路由)。
* - onProviderChange:选某行(供应商, 模型)时调用,第 2 参为该行模型 id,第 3 参为该来源该模型的
* 当前 effort(无 effort 档时为空串),由各调用方一次性落下 provider/model/effort。
- * - onNavigateToProviders:0 个可连来源时空态 CTA / 列表底部「连接来源」跳设置→供应商页。
+ * - onNavigateToProviders:0 个可连来源时空态 CTA / 列表底部「配置模型」跳设置→供应商页;
+ * 正在看分享来的供应商时带上它(ProvidersNavigationTarget),设置页直接选中那一条。
* 三者都不传 → 单栏纯列表(无供应商分段),选行只 onModelChange(老入口 / CreateWorkerPopover)。
*/
currentProviderId?: string | null;
@@ -751,7 +758,7 @@ interface ModelSelectorProps {
reconciledEffort?: Effort,
reconciledFast?: boolean,
) => void | boolean | Promise<void | boolean>;
- onNavigateToProviders?: () => void;
+ onNavigateToProviders?: (target?: ProvidersNavigationTarget) => void;
/**
* 会话显式选中的来源已断开(由 ChatInput 按 sessionId / deviceLink scoping 计算,见
* isSelectedSourceDisconnected)。true → trigger 显示**真实选中来源** + 「已断开」错误态,
@@ -974,7 +981,7 @@ interface ModelSelectorContentProps {
reconciledEffort?: Effort,
reconciledFast?: boolean,
) => void | boolean | Promise<void | boolean>;
- onNavigateToProviders?: () => void;
+ onNavigateToProviders?: (target?: ProvidersNavigationTarget) => void;
/**
* 可选「跟随会话」行(opt-in)。仅 scheduler 的 heartbeat(绑定会话)任务传入:
* 在模型列表顶部加一行,选中 = model 留空(跟随绑定会话的模型 / 来源)。
@@ -1270,6 +1277,13 @@ function ModelSelectorContentView({
: remoteBrowse
? remoteAgent.deviceModelMemory?.(remoteBrowse.deviceId)
: remoteAgent.localModelMemory;
+ // 列表底部「配置模型」:本机目录照旧;分享来的供应商在本机设置里有详情页(provider-sharing.md §5.2),
+ // 带上分享直达那一条。被控电脑与自己其他电脑上的目录要到那台电脑上改,不显示。
+ const browsingShareId =
+ remoteAgent && !homeDeviceId ? providerShareIdOfAgentDeviceId(deviceId) : null;
+ const showProvidersEntry = !!onNavigateToProviders && (!deviceId || browsingShareId !== null);
+ const navigateToProviders = () =>
+ onNavigateToProviders?.(browsingShareId ? { shareId: browsingShareId } : undefined);
// 列表样式试用开关(本机偏好):footer 的切换按钮 + 面板行样式共用。
const constrainedListMaxHeight = modelListMaxHeightForRows(maxVisibleModelRows);
const [paneElement, setPaneElement] = useState<HTMLDivElement | null>(null);
@@ -3187,7 +3201,7 @@ function ModelSelectorContentView({
<button
type="button"
disabled={interactionDisabled}
- onClick={onNavigateToProviders}
+ onClick={() => onNavigateToProviders()}
className={cn(
'flex h-[34px] w-full items-center justify-center rounded-[8px]',
'bg-[var(--accent-cta-bg)] transition-opacity hover:opacity-90',
@@ -3734,13 +3748,13 @@ function ModelSelectorContentView({
? { overlayClassName: overlayContentClassName }
: {})}
/>
- {/* 连接来源入口只对本机展示。 */}
- {onNavigateToProviders && !deviceId && (
+ {/* 「配置模型」只对本机目录与分享来的供应商展示(见 showProvidersEntry)。 */}
+ {showProvidersEntry && (
<div className="flex shrink-0 items-center justify-between gap-2 border-t border-[var(--model-dropdown-border)] px-3.5 py-[9px]">
<button
type="button"
disabled={interactionDisabled}
- onClick={onNavigateToProviders}
+ onClick={navigateToProviders}
className={cn(
'flex min-w-0 items-center gap-1.5 text-13 text-[var(--text-secondary)]',
'transition-colors hover:text-[var(--text-primary)]',
@@ -3914,15 +3928,15 @@ function ModelSelectorContentView({
</div>
)}
- {/* 连接来源入口只对本机展示。 */}
- {onNavigateToProviders && !deviceId && (
+ {/* 「配置模型」只对本机目录与分享来的供应商展示(见 showProvidersEntry)。 */}
+ {showProvidersEntry && (
<>
<div className="mx-1 h-px bg-[var(--model-dropdown-border)]" />
<div className="flex items-center justify-between gap-2">
<button
type="button"
disabled={interactionDisabled}
- onClick={onNavigateToProviders}
+ onClick={navigateToProviders}
className={cn(
COMPOSER_MENU_ROW,
'flex min-w-0 items-center gap-1.5 px-3 py-2',
diff --git a/apps/desktop/src/renderer/components/settings/ProvidersSection.tsx b/apps/desktop/src/renderer/components/settings/ProvidersSection.tsx
index 3a672791e2..577e0ee55c 100644
--- a/apps/desktop/src/renderer/components/settings/ProvidersSection.tsx
+++ b/apps/desktop/src/renderer/components/settings/ProvidersSection.tsx
@@ -125,7 +125,10 @@ import {
pendingRequestCountByProvider,
providerShareGate,
} from '@/features/provider-share/providerShareFormat';
-import { PROVIDER_SHARE_MANAGE_PARAM } from '@/features/provider-share/providerShareNavigation';
+import {
+ PROVIDER_SHARE_MANAGE_PARAM,
+ PROVIDER_SHARE_RECEIVED_PARAM,
+} from '@/features/provider-share/providerShareNavigation';
import {
useProviderSharePendingRequests,
useProviderShareReceived,
@@ -2444,7 +2447,7 @@ export function ProvidersSection() {
// 选中本机供应商或登录引导时清空。
const [selectedShareId, setSelectedShareId] = useState<string | null>(null);
const [selectedRemoteKey, setSelectedRemoteKey] = useState<string | null>(null);
- const { received: receivedShares } = useProviderShareReceived();
+ const { received: receivedShares, loaded: receivedSharesLoaded } = useProviderShareReceived();
const selectedShare = selectedShareId
? receivedShares.find((share) => share.shareId === selectedShareId) ?? null
: null;
@@ -2761,6 +2764,20 @@ export function ProvidersSection() {
next.delete(PROVIDER_SHARE_MANAGE_PARAM);
setSearchParams(next, { replace: true });
}, [searchParams, setSearchParams]);
+ // 分享来的供应商深链(?receivedShare=<shareId>,来自模型选择器底部「配置模型」):等分享列表到了再消费
+ // 并从 URL 摘除;这条分享已不在列表里(刚被撤销或退出)时只停在供应商页。
+ useEffect(() => {
+ const target = searchParams.get(PROVIDER_SHARE_RECEIVED_PARAM);
+ if (!target || !receivedSharesLoaded) return;
+ if (receivedShares.some((share) => share.shareId === target)) {
+ setShareManageProviderId(null);
+ setFocusedModel(null);
+ selectShare(target);
+ }
+ const next = new URLSearchParams(searchParams);
+ next.delete(PROVIDER_SHARE_RECEIVED_PARAM);
+ setSearchParams(next, { replace: true });
+ }, [searchParams, setSearchParams, receivedSharesLoaded, receivedShares, selectShare]);
useEffect(() => {
if (loading) return;
const connect = searchParams.get('connect');
diff --git a/apps/desktop/src/renderer/features/cc-agent/CreateWorkerPopover.tsx b/apps/desktop/src/renderer/features/cc-agent/CreateWorkerPopover.tsx
index 50af31345f..fb728979d2 100644
--- a/apps/desktop/src/renderer/features/cc-agent/CreateWorkerPopover.tsx
+++ b/apps/desktop/src/renderer/features/cc-agent/CreateWorkerPopover.tsx
@@ -25,6 +25,7 @@ import { remoteAgentProviders } from '@/components/new-chat/unifiedModelSelectio
import { PermissionSelector } from '@/components/new-chat/PermissionSelector';
import { VendorSegmentedSwitcher } from '@/components/new-chat/VendorSegmentedSwitcher';
import { agentKindToVendor } from '@/components/sidebar/VendorIcon';
+import { providersSettingsPath } from '@/features/provider-share/providerShareNavigation';
import { useAgentCapabilities } from '@/hooks/useAgentCapabilities';
import { useDeviceProviders } from '@/hooks/useDeviceProviders';
import { useProviders } from '@/hooks/useProviders';
@@ -1032,9 +1033,9 @@ export function CreateWorkerPopover({
onNavigateToProviders={
deviceId || isSidebarWindow()
? undefined
- : () => {
+ : (target) => {
onClose();
- navigate('/settings?tab=providers');
+ navigate(providersSettingsPath(target));
}
}
modelMemory={modelMemory}
diff --git a/apps/desktop/src/renderer/features/provider-share/providerShareNavigation.ts b/apps/desktop/src/renderer/features/provider-share/providerShareNavigation.ts
index e36598d6a8..8445f52354 100644
--- a/apps/desktop/src/renderer/features/provider-share/providerShareNavigation.ts
+++ b/apps/desktop/src/renderer/features/provider-share/providerShareNavigation.ts
@@ -4,7 +4,17 @@
*/
export const PROVIDER_SHARE_MANAGE_PARAM = 'shareProvider';
+/** 打开「分享给我的供应商」里的某一条:一次性参数 `receivedShare=<shareId>`,消费方式同上。 */
+export const PROVIDER_SHARE_RECEIVED_PARAM = 'receivedShare';
+
export function providerShareManagePath(providerId: string): string {
const params = new URLSearchParams({ tab: 'providers', [PROVIDER_SHARE_MANAGE_PARAM]: providerId });
return `/settings?${params.toString()}`;
}
+
+/** 设置 → 模型供应商;给了分享 id 就直接选中那条分享来的供应商。 */
+export function providersSettingsPath(target?: { shareId: string }): string {
+ const params = new URLSearchParams({ tab: 'providers' });
+ if (target) params.set(PROVIDER_SHARE_RECEIVED_PARAM, target.shareId);
+ return `/settings?${params.toString()}`;
+}
diff --git a/apps/desktop/src/shared/providerShare.ts b/apps/desktop/src/shared/providerShare.ts
index 79bd5b7cf6..d5b6d1c990 100644
--- a/apps/desktop/src/shared/providerShare.ts
+++ b/apps/desktop/src/shared/providerShare.ts
@@ -165,3 +165,9 @@ export const PROVIDER_SHARE_AGENT_DEVICE_PREFIX = 'share:';
export function isProviderShareAgentDeviceId(value: string | null | undefined): boolean {
return typeof value === 'string' && value.startsWith(PROVIDER_SHARE_AGENT_DEVICE_PREFIX);
}
+
+/** 这个设备 id 指向的分享 id;不是分享时为 null。只拆前缀,不校验格式。 */
+export function providerShareIdOfAgentDeviceId(value: string | null | undefined): string | null {
+ if (typeof value !== 'string' || !value.startsWith(PROVIDER_SHARE_AGENT_DEVICE_PREFIX)) return null;
+ return value.slice(PROVIDER_SHARE_AGENT_DEVICE_PREFIX.length) || null;
+}
diff --git a/docs/product-rules/provider-sharing.md b/docs/product-rules/provider-sharing.md
index 979b801272..323e0d3a81 100644
--- a/docs/product-rules/provider-sharing.md
+++ b/docs/product-rules/provider-sharing.md
@@ -123,6 +123,10 @@
Desktop 与 Mobile 使用同一写法。
+Desktop 模型列表底部的「配置模型」在看分享来的供应商时同样显示,点开直接进入设置里这条分享的详情
+(§5.2;2026-10-15 用户确认)。同账号其他电脑上的远程供应商与远程控制的电脑上的任务不显示,它们的设置
+要到那台电脑上改。
+
### 5.2 供应商设置
Desktop「设置 → 模型供应商」的左栏(2026-10-08 用户裁决):