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(provider-share): 按授权共享剩余额度和用量明细

fmfsaisai0775da8d1292
diff --git a/apps/desktop/scripts/fixtures/provider-share-insights/provider-share-insights-fixture.tsx b/apps/desktop/scripts/fixtures/provider-share-insights/provider-share-insights-fixture.tsx
new file mode 100644
index 0000000000..327761fbbd
--- /dev/null
+++ b/apps/desktop/scripts/fixtures/provider-share-insights/provider-share-insights-fixture.tsx
@@ -0,0 +1,249 @@
+import { AppFrame, forbid, mountPage, subscription } from '../../ui-page/harness';
+import { ProviderShareManagePage } from '../../../src/renderer/features/provider-share/ProviderShareManagePage';
+import { ProviderShareReceivedDetail } from '../../../src/renderer/features/provider-share/ProviderShareReceivedRail';
+import type {
+ ProviderShareInsights,
+ ProviderShareQuotaAccount,
+} from '../../../src/shared/providerShareInsights';
+import type { ProviderShareReceived } from '@cindy/device-link';
+
+const now = Date.parse('2026-10-19T12:00:00Z');
+const share: ProviderShareReceived = {
+ shareId: 'fixture-share',
+ memberId: 'fixture-member',
+ providerId: 'xd',
+ providerLabel: 'Cindy AI',
+ hostDeviceId: 'fixture-host',
+ deviceName: 'Private device name',
+ owner: { displayName: '林晓', avatarUrl: null, region: 'global' },
+ status: 'active',
+ hostOnline: true,
+ hostCapable: true,
+};
+const days = (model: string, tokens: number) =>
+ [0, 1, 2, 4, 6, 10, 12, 17, 23].map((offset) => ({
+ day: new Date(now - offset * 86_400_000).toISOString().slice(0, 10),
+ kind: 'claude-code',
+ model,
+ turns: 5,
+ inputTokens: tokens + offset * 180,
+ outputTokens: 3_000,
+ cacheReadTokens: 15_000,
+ cacheCreateTokens: 1_000,
+ amount: { amount: 0.42, currency: 'USD' as const },
+ }));
+const usage: NonNullable<ProviderShareInsights['usage']> = {
+ todayKey: '2026-10-19',
+ coverageStart: null,
+ parties: [
+ {
+ key: 'owner',
+ displayName: '林晓',
+ avatarUrl: null,
+ isOwner: true,
+ isYou: false,
+ isRelay: false,
+ lastUsedAt: now,
+ days: days('claude-sonnet-4-6', 42_000),
+ },
+ {
+ key: 'member',
+ displayName: 'Alex',
+ avatarUrl: null,
+ isOwner: false,
+ isYou: true,
+ isRelay: false,
+ lastUsedAt: now,
+ days: days('claude-opus-4-6', 28_000),
+ },
+ {
+ key: 'relay',
+ displayName: '',
+ avatarUrl: null,
+ isOwner: false,
+ isYou: false,
+ isRelay: true,
+ lastUsedAt: now,
+ days: days('claude-sonnet-4-6', 6_000),
+ },
+ ],
+};
+const account = {
+ state: 'ready' as const,
+ updatedAt: now,
+ windows: [],
+ balance: {
+ remaining: 64.8,
+ total: 100,
+ currency: 'USD' as const,
+ resetsAt: null,
+ pools: [
+ { kind: 'plan' as const, remaining: 24.8, total: 60 },
+ { kind: 'purchased' as const, remaining: 30, total: 30 },
+ { kind: 'promotional' as const, remaining: 10, total: 10 },
+ ],
+ },
+};
+const history = {
+ providerId: 'xd',
+ todayKey: usage.todayKey,
+ coverageStart: null,
+ self: {
+ lastUsedAt: now,
+ days: usage.parties[0].days.map((day) => ({ ...day, providerId: 'xd', memberKey: 'local' })),
+ },
+ relays: [],
+ members: [],
+};
+
+void mountPage({
+ host: (ctx) => {
+ const quota = ctx.case !== 'closed' && ctx.case !== 'usage-only';
+ const allowUsage = ctx.case !== 'closed' && ctx.case !== 'quota-only';
+ const subscriptionAccount: ProviderShareQuotaAccount = {
+ state: 'ready',
+ updatedAt: now,
+ balance: null,
+ windows: [
+ {
+ kind: 'session',
+ label: null,
+ windowMinutes: 300,
+ remainingPercent: 43,
+ resetsAt: now + 7_200_000,
+ },
+ {
+ kind: 'week',
+ label: null,
+ windowMinutes: 10080,
+ remainingPercent: 72,
+ resetsAt: now + 86_400_000,
+ },
+ ],
+ };
+ const displayedAccount: ProviderShareQuotaAccount =
+ ctx.case === 'subscription'
+ ? subscriptionAccount
+ : ['organization', 'unknown', 'zero'].includes(ctx.case)
+ ? {
+ ...account,
+ balance: {
+ ...account.balance,
+ pools: [],
+ remaining: ctx.case === 'zero' ? 0 : 64.8,
+ total: ctx.case === 'unknown' ? null : 100,
+ },
+ }
+ : account;
+ let visibility = { quota, usage: allowUsage };
+ const command = async (cmd: {
+ action: string;
+ visibility?: Partial<typeof visibility>;
+ favoriteRecovery?: { ownerStamp: unknown };
+ }) => {
+ switch (cmd.action) {
+ case 'get-visibility':
+ return visibility;
+ case 'set-visibility':
+ visibility = { ...visibility, ...cmd.visibility };
+ return visibility; // fixture memory only
+ case 'insights':
+ return {
+ version: 1,
+ capabilities: visibility,
+ status: {
+ quota: quota ? 'ready' : 'disabled',
+ usage: allowUsage ? 'ready' : 'disabled',
+ },
+ quota: quota
+ ? {
+ group: ctx.case === 'group',
+ partial: ctx.case === 'group',
+ accounts:
+ ctx.case === 'group' ? [account, subscriptionAccount] : [displayedAccount],
+ }
+ : null,
+ usage: allowUsage ? usage : null,
+ } satisfies ProviderShareInsights;
+ case 'received':
+ return [share];
+ case 'received-snapshot':
+ return {
+ ownerStamp: cmd.favoriteRecovery?.ownerStamp,
+ received: [share],
+ confirmedRegions: [],
+ };
+ case 'get-credential-consent':
+ return { skip: false };
+ case 'owned':
+ return {
+ ready: true,
+ shares: [
+ {
+ shareId: share.shareId,
+ providerId: 'xd',
+ providerLabel: 'Cindy AI',
+ createdAt: '2026-10-01T00:00:00Z',
+ members: [],
+ requests: [],
+ },
+ ],
+ };
+ case 'usage-history':
+ return history;
+ case 'own-usage':
+ return { providerId: 'xd', local: null, devices: [], relays: [] };
+ case 'get-run-limits':
+ return {
+ value: { perDevice: 16, total: 64 },
+ defaults: { perDevice: 16, total: 64 },
+ isCustomized: false,
+ customizedKeys: [],
+ usage: { total: 0, devices: 0, largestDevice: 0 },
+ };
+ default:
+ return forbid(`providerShare.${cmd.action}`)();
+ }
+ };
+ return {
+ deviceLink: {
+ getState: async () => ({ linkStatus: 'online' }),
+ listDevices: async () => ({ devices: [] }),
+ onPresenceChanged: subscription('presence'),
+ onStatusChanged: subscription('linkStatus'),
+ onControlTargetChanged: subscription('controlTarget'),
+ },
+ providerGroup: {
+ command: async (cmd: { action: string }) => (cmd.action === 'list' ? {} : null),
+ onChanged: subscription('groupChanged'),
+ },
+ providerShare: {
+ command,
+ onOwnedChanged: subscription('ownedShares'),
+ onReceivedChanged: subscription('receivedShares'),
+ },
+ };
+ },
+ render: (ctx) => (
+ <AppFrame>
+ <div className="flex h-full min-h-0 flex-col">
+ <p className="shrink-0 px-5 py-2 text-12 text-[var(--text-secondary)]">
+ UI fixture · 测试数据 · Test data
+ </p>
+ {ctx.case === 'owner' ? (
+ <div className="min-h-0 flex-1 overflow-auto px-5 pb-5">
+ <ProviderShareManagePage
+ providerId="xd"
+ providerName="Cindy AI"
+ providerIcon={<span>C</span>}
+ gate="on"
+ onBack={() => {}}
+ />
+ </div>
+ ) : (
+ <ProviderShareReceivedDetail share={share} />
+ )}
+ </div>
+ </AppFrame>
+ ),
+});
diff --git a/apps/desktop/scripts/fixtures/provider-share-insights/ui-page.mjs b/apps/desktop/scripts/fixtures/provider-share-insights/ui-page.mjs
new file mode 100644
index 0000000000..fce4a81dcb
--- /dev/null
+++ b/apps/desktop/scripts/fixtures/provider-share-insights/ui-page.mjs
@@ -0,0 +1,123 @@
+import assert from 'node:assert/strict';
+
+export default {
+ name: 'provider-share-insights',
+ entry: './provider-share-insights-fixture.tsx',
+ viewport: { width: 1220, height: 900 },
+ real: 'ProviderShareManagePage, ProviderShareReceivedDetail, visibility switches, quota cards, ProviderUsageSection, translations and themes',
+ notCovered:
+ 'Live cross-account transport, persisted permissions, real upstream quota, Windows. All numbers and names are fixture data.',
+ stubs: {
+ 'src/renderer/hooks/useProviders': {
+ partial: 'export const useProviders = () => ({ providers: [], loading: false });',
+ },
+ 'src/renderer/hooks/useDeviceProviders': {
+ partial: `export const useDeviceProviders = () => ({ providers: [{ id: 'xd', name: 'Cindy AI', routing: {}, models: { 'claude-code': [{ id: 'claude-sonnet-4-6', name: 'Claude Sonnet 4.6' }, { id: 'claude-opus-4-6', name: 'Claude Opus 4.6' }], codex: [{ id: 'gpt-5.5', name: 'GPT-5.5' }] } }], loading: false, error: null, unsupported: false });`,
+ },
+ },
+ cases: {
+ owner: {
+ about: 'Owner detail with two independent switches; writes affect fixture memory only',
+ },
+ default: { about: 'Both capabilities; usage collapsed, models visible at desktop height' },
+ expanded: {
+ about: 'Explicitly expanded usage with charts by person and model',
+ viewport: { width: 1220, height: 2100 },
+ },
+ subscription: { about: 'Read-only subscription windows with existing remaining bars' },
+ organization: { about: 'Organization remaining balance and known budget' },
+ unknown: { about: 'Unknown total has no fabricated percentage' },
+ zero: { about: 'True zero balance has a zero progress bar' },
+ 'quota-only': { about: 'Only remaining allowance shared' },
+ 'usage-only': { about: 'Only usage details shared' },
+ closed: { about: 'Both permissions disabled without disabling model use' },
+ group: { about: 'Two anonymous own accounts; borrowed accounts excluded' },
+ },
+ async ready(page) {
+ await page
+ .getByTestId('provider-share-visibility')
+ .or(page.getByTestId('provider-share-insights'))
+ .waitFor();
+ },
+ async check(page, ui) {
+ if (ui.case === 'owner') {
+ const quota = page.getByRole('switch', {
+ name: await ui.t('providerShare.insights.allowQuota'),
+ exact: true,
+ });
+ const usage = page.getByRole('switch', {
+ name: await ui.t('providerShare.insights.allowUsage'),
+ exact: true,
+ });
+ await quota.waitFor();
+ const descriptionId = await usage.getAttribute('aria-describedby');
+ assert.ok(descriptionId);
+ const description = page.locator(`[id="${descriptionId}"]`);
+ assert.equal(
+ await description.textContent(),
+ await ui.t('providerShare.insights.allowUsageDescription'),
+ );
+ assert.equal(await description.isVisible(), true);
+ assert.equal(await quota.getAttribute('aria-describedby'), null);
+ assert.equal(await quota.isEnabled(), true);
+ await quota.click();
+ assert.equal(await quota.getAttribute('aria-checked'), 'false');
+ assert.equal(await usage.getAttribute('aria-checked'), 'true');
+ await quota.click();
+ await ui.capture('owner-switches');
+ } else {
+ const body = await page.getByTestId('provider-share-insights').textContent();
+ assert.ok(!body.includes('Private device name'));
+ const models = page.getByTestId('provider-share-received-models');
+ assert.equal(await models.getByRole('listitem').count(), 3);
+ if (ui.case === 'default') {
+ const bounds = await models.getByRole('listitem').last().boundingBox();
+ assert.ok(
+ bounds && bounds.y + bounds.height <= ui.viewport.height,
+ 'Default view shows models without scrolling',
+ );
+ await ui.capture('collapsed-models');
+ }
+ const progress = page.getByRole('progressbar');
+ if (ui.case === 'default') {
+ assert.equal(await progress.count(), 3);
+ assert.ok(
+ Math.abs(
+ Number(await progress.first().getAttribute('aria-valuenow')) - (24.8 / 60) * 100,
+ ) < 0.01,
+ );
+ }
+ if (ui.case === 'organization')
+ assert.equal(await progress.first().getAttribute('aria-valuenow'), '64.8');
+ if (ui.case === 'group') assert.equal(await progress.count(), 5);
+ if (ui.case === 'unknown') assert.equal(await progress.count(), 0);
+ if (ui.case === 'zero')
+ assert.equal(await progress.first().getAttribute('aria-valuenow'), '0');
+ if (ui.case === 'subscription') {
+ assert.equal(await progress.count(), 2);
+ assert.equal(await progress.first().getAttribute('aria-valuenow'), '43');
+ }
+ if (!['closed', 'quota-only'].includes(ui.case)) {
+ const toggle = page.getByRole('button', {
+ name: await ui.t('providerShare.insights.usageTitle'),
+ exact: true,
+ });
+ assert.equal(await toggle.getAttribute('aria-expanded'), 'false');
+ const tabs = page.getByRole('tablist', { name: await ui.t('providerGroup.usage.title') });
+ assert.equal(await tabs.count(), 0);
+ if (ui.case === 'expanded') {
+ await toggle.click();
+ await tabs.waitFor();
+ assert.equal(await toggle.getAttribute('aria-expanded'), 'true');
+ assert.equal(await tabs.getByRole('tab').count(), 2);
+ await ui.capture('by-person');
+ await tabs
+ .getByRole('tab', { name: await ui.t('providerGroup.usage.stack.model') })
+ .click();
+ assert.equal(await page.getByTestId('provider-usage-model').count(), 2);
+ await ui.capture('by-model');
+ }
+ }
+ }
+ },
+};
diff --git a/apps/desktop/src/main/device-link/__tests__/providerShareDispatch.test.ts b/apps/desktop/src/main/device-link/__tests__/providerShareDispatch.test.ts
index c052b25f49..d77a9beea3 100644
--- a/apps/desktop/src/main/device-link/__tests__/providerShareDispatch.test.ts
+++ b/apps/desktop/src/main/device-link/__tests__/providerShareDispatch.test.ts
@@ -1,3 +1,4 @@
+import { createProviderShareInsightsReader } from '../providerShareInsights';
/**
* 被控端对供应商分享受邀者(另一个账号)的入口:只建后台链路、只放行远程 Agent 与过滤后的供应商列表,
* 订阅与其他通道一律拒绝;撤权后迟到的结果不再带出数据;撤权只会命中受邀者对端。
@@ -369,3 +370,43 @@ describe('provider share revoke', () => {
expect(purgeControllers).toHaveBeenCalledTimes(1);
});
});
+
+/* 新只读通道的实际发送边界:开关变化不会撤销成员关系,但必须阻止重放旧数据。
+ * 原有测试只覆盖关系撤销。unit;注入 reader,无外网或真实等待。 */
+describe('provider share insights delivery', () => {
+ function setup() {
+ state.access = ACCESS;
+ const visibility = { quota: true, usage: false, revision: 0 };
+ const insights = createProviderShareInsightsReader({
+ captureScope: () => () => undefined, scopeKey: () => 'owner', access: () => state.access,
+ revision: () => 0, visibility: () => ({ ...visibility }),
+ shares: () => [{ ...ACCESS, hostDeviceId: 'host', providerLabel: 'Provider', createdAt: '', requests: [], members: [] }],
+ owner: () => ({ displayName: 'Owner', avatarUrl: null }),
+ history: vi.fn(), quota: async () => ({ group: false, partial: false, accounts: [] }),
+ });
+ setProviderShareAccess({ guestAccess: () => state.access, ensureKnown: async () => undefined, hasShares: () => true, insights, insightsCurrent: insights.isCurrent });
+ const client = fakeClient(); __testing.setActiveClient(client);
+ const payload = { channel: 'provider-share:insights:v1', args: [{ version: 1 }] };
+ return { visibility, client, payload };
+ }
+ it.each([false, true])('refuses outbox data after closing permissions (reopened=%s)', async (reopened) => {
+ const { visibility, client, payload } = setup();
+ vi.mocked(client.sendInvokeResult).mockImplementationOnce(() => { throw new Error('temporary backpressure'); });
+ await __testing.handleInvoke(client, GUEST, 'insights', payload);
+ expect(vi.mocked(client.sendInvokeResult).mock.calls[0]?.[2]).toMatchObject({ ok: true, result: { capabilities: { quota: true } } });
+ expect(__testing.remoteInvokeResultOutboxSize()).toBe(1);
+ visibility.quota = reopened; visibility.revision += reopened ? 2 : 1;
+ __testing.flushRemoteInvokeResultOutbox(GUEST);
+ expect(vi.mocked(client.sendInvokeResult).mock.calls.at(-1)?.[2]).toMatchObject({ ok: false });
+ });
+ it('re-reads a reused request id and never opens a remote agent', async () => {
+ const { visibility, client, payload } = setup();
+ const handle = vi.fn(); setRemoteAgentHandler({ handle, abortAll: vi.fn() });
+ await __testing.handleInvoke(client, GUEST, 'same-request', payload);
+ expect(vi.mocked(client.sendInvokeResult).mock.calls.at(-1)?.[2]).toMatchObject({ ok: true, result: { capabilities: { quota: true } } });
+ visibility.quota = false; visibility.revision++;
+ await __testing.handleInvoke(client, GUEST, 'same-request', payload);
+ expect(vi.mocked(client.sendInvokeResult).mock.calls.at(-1)?.[2]).toMatchObject({ ok: true, result: { capabilities: { quota: false }, quota: null } });
+ expect(handle).not.toHaveBeenCalled();
+ });
+});
diff --git a/apps/desktop/src/main/device-link/__tests__/providerShareInsights.test.ts b/apps/desktop/src/main/device-link/__tests__/providerShareInsights.test.ts
new file mode 100644
index 0000000000..5fb7ff4369
--- /dev/null
+++ b/apps/desktop/src/main/device-link/__tests__/providerShareInsights.test.ts
@@ -0,0 +1,208 @@
+import { describe, expect, it, vi } from 'vitest';
+import type { ProviderShareOwned } from '@cindy/device-link';
+import type { ProviderUsageHistoryView } from '../../../shared/providerShare';
+import { parseProviderShareInsights } from '../../../shared/providerShareInsights';
+import { createProviderShareInsightsReader } from '../providerShareInsights';
+
+/* 测试价值:通过新只读 reader 验证四种能力组合、匿名投影、独立失败和撤权时序。
+ * 依据:provider-sharing 的最小范围及账号隔离;旧 dispatch/management 测试没有新 reader。
+ * 最小失败输入:一项查询失败、在途关闭后重开、同 providerId 换账号、转来的一行用量。
+ * tier: unit;依赖注入,无 Electron/外网/真实等待。单文件耗时见执行报告。 */
+const day = {
+ day: '2026-10-19',
+ kind: 'codex',
+ model: 'model',
+ providerId: 'private-provider',
+ memberKey: 'private-device',
+ turns: 1,
+ inputTokens: 10,
+ outputTokens: 2,
+ cacheReadTokens: 0,
+ cacheCreateTokens: 0,
+ amount: { amount: 1, currency: 'USD' as const },
+};
+function fixture() {
+ const state = {
+ owner: 'a',
+ revision: 0,
+ visibility: { quota: true, usage: true, revision: 0 },
+ active: true,
+ };
+ const access = { shareId: 'share', memberId: 'member', providerId: 'provider' };
+ const share: ProviderShareOwned = {
+ shareId: 'share',
+ providerId: 'provider',
+ hostDeviceId: 'private-host',
+ providerLabel: 'Provider',
+ createdAt: '',
+ requests: [],
+ members: [
+ {
+ memberId: 'member',
+ displayName: 'Alice',
+ avatarUrl: null,
+ region: 'global',
+ status: 'active',
+ joinedAt: '',
+ },
+ ],
+ };
+ const history: ProviderUsageHistoryView = {
+ providerId: 'provider',
+ todayKey: '2026-10-19',
+ coverageStart: null,
+ self: { lastUsedAt: 1, days: [day] },
+ members: [
+ { shareId: 'share', memberId: 'member', lastUsedAt: 2, days: [day] },
+ { shareId: 'share', memberId: 'deleted', lastUsedAt: 3, days: [day] },
+ ],
+ relays: [
+ { deviceId: 'private-device', deviceName: 'Secret Computer', lastUsedAt: 3, days: [day] },
+ { deviceId: 'other-device', deviceName: 'Other Computer', lastUsedAt: 4, days: [day] },
+ ],
+ };
+ const deps = {
+ captureScope: () => {
+ const owner = state.owner;
+ return () => {
+ if (owner !== state.owner) throw new Error('account changed');
+ };
+ },
+ scopeKey: () => state.owner,
+ access: () => (state.active ? access : null),
+ revision: () => state.revision,
+ visibility: () => ({ ...state.visibility }),
+ shares: () => [share],
+ owner: () => ({ displayName: 'Owner', avatarUrl: null }),
+ history: vi.fn(async () => history),
+ quota: vi.fn(async () => ({
+ group: false,
+ partial: false,
+ accounts: [
+ {
+ state: 'ready' as const,
+ updatedAt: 1,
+ windows: [],
+ balance: {
+ remaining: 0,
+ total: 100,
+ currency: 'USD' as const,
+ resetsAt: null,
+ pools: [],
+ },
+ },
+ ],
+ })),
+ };
+ return { state, deps, read: createProviderShareInsightsReader(deps) };
+}
+const request = { version: 1 };
+describe('provider share insights', () => {
+ it.each([
+ [false, false],
+ [true, false],
+ [false, true],
+ [true, true],
+ ])('honors quota=%s usage=%s independently', async (quota, usage) => {
+ const { state, deps, read } = fixture();
+ state.visibility = { quota, usage, revision: 0 };
+ const view = await read('peer', request);
+ expect(view.capabilities).toEqual({ quota, usage });
+ expect(view.quota !== null).toBe(quota);
+ expect(view.usage !== null).toBe(usage);
+ expect(deps.quota).toHaveBeenCalledTimes(Number(quota));
+ expect(deps.history).toHaveBeenCalledTimes(Number(usage));
+ });
+ it('includes relayed totals without topology, private notes, or deleted members', async () => {
+ const { read } = fixture();
+ const view = await read('peer', request);
+ expect(
+ view.usage?.parties.map((p) => [
+ p.key === 'relay' ? 'relay' : p.displayName,
+ p.days[0]?.inputTokens,
+ ]),
+ ).toEqual([
+ ['Owner', 10],
+ ['Alice', 10],
+ ['relay', 20],
+ ]);
+ expect(view.usage?.parties[1].isYou).toBe(true);
+ expect(JSON.stringify(view)).not.toMatch(
+ /private-|Secret Computer|Other Computer|deleted|memberId|deviceId|memberKey|providerId/,
+ );
+ expect(parseProviderShareInsights(view)).toEqual(view);
+ });
+ it.each(['quota', 'usage'] as const)('keeps the other capability when %s fails', async (key) => {
+ const { deps, read } = fixture();
+ if (key === 'quota') deps.quota.mockRejectedValue(new Error('upstream failed'));
+ else deps.history.mockRejectedValue(new Error('ledger failed'));
+ const view = await read('peer', request);
+ expect(view.status[key]).toBe('unavailable');
+ expect(view[key]).toBeNull();
+ expect(view[key === 'quota' ? 'usage' : 'quota']).not.toBeNull();
+ });
+ it.each(['visibility', 'membership', 'owner'] as const)(
+ 'rejects in-flight results after %s changes',
+ async (change) => {
+ const { state, deps, read } = fixture();
+ let finish!: () => void;
+ const wait = new Promise<void>((resolve) => {
+ finish = resolve;
+ });
+ const history = await deps.history();
+ deps.history.mockImplementation(async () => {
+ await wait;
+ return history;
+ });
+ const pending = read('peer', request);
+ if (change === 'visibility') state.visibility.revision += 2;
+ if (change === 'membership') state.revision += 2;
+ if (change === 'owner') state.owner = 'b';
+ finish();
+ await expect(pending).rejects.toThrow();
+ },
+ );
+ it('invalidates completed results after closing/reopening and never trusts foreign objects', async () => {
+ const { read, state } = fixture();
+ const view = await read('peer', request);
+ expect(read.isCurrent('peer', view)).toBe(true);
+ expect(read.isCurrent('other-peer', view)).toBe(false);
+ expect(read.isCurrent('peer', { ...view })).toBe(false);
+ state.visibility.revision += 2;
+ expect(read.isCurrent('peer', view)).toBe(false);
+ });
+ it('shares cached history within an owner but reloads for another owner with the same provider id', async () => {
+ const { read, deps, state } = fixture();
+ await read('peer', request);
+ await read('peer', request);
+ expect(deps.history).toHaveBeenCalledTimes(1);
+ state.owner = 'b';
+ await read('peer', request);
+ expect(deps.history).toHaveBeenCalledTimes(2);
+ });
+ it('rejects unauthorized members and a guest-supplied provider id', async () => {
+ const { read, state } = fixture();
+ await expect(read('peer', { version: 1, providerId: 'other' })).rejects.toThrow(
+ 'INVALID_PARAMS',
+ );
+ state.active = false;
+ await expect(read('peer', request)).rejects.toThrow('PERMISSION_DENIED');
+ });
+ it('strips unknown fields and ignores data for disabled capabilities on the receiving boundary', async () => {
+ const { read } = fixture();
+ const view = await read('peer', request);
+ expect(parseProviderShareInsights({ ...view, version: 2 })).toBeNull();
+ expect(parseProviderShareInsights({ version: 1, capabilities: view.capabilities })).toBeNull();
+ const parsed = parseProviderShareInsights({
+ ...view,
+ secret: 'no',
+ capabilities: { quota: false, usage: false },
+ });
+ expect(parsed).toMatchObject({
+ quota: null,
+ usage: null,
+ status: { quota: 'disabled', usage: 'disabled' },
+ });
+ expect(parsed).not.toHaveProperty('secret');
+ });
+});
diff --git a/apps/desktop/src/main/device-link/__tests__/providerShareManagement.test.ts b/apps/desktop/src/main/device-link/__tests__/providerShareManagement.test.ts
index ceee60c1e6..895e3dddba 100644
--- a/apps/desktop/src/main/device-link/__tests__/providerShareManagement.test.ts
+++ b/apps/desktop/src/main/device-link/__tests__/providerShareManagement.test.ts
@@ -14,6 +14,9 @@ const identityCard = vi.hoisted(() => vi.fn());
const remember = vi.hoisted(() => vi.fn());
const usageStores = vi.hoisted(() => ({ ownHistory: vi.fn(), memberHistory: vi.fn(), pricing: vi.fn() }));
const memberNotes = vi.hoisted(() => ({ read: vi.fn(), set: vi.fn() }));
+vi.mock('../providerShareQuota.js', () => ({ readProviderShareQuota: vi.fn(), readProviderShareQuotaAccount: vi.fn() }));
+const visibility = vi.hoisted(() => ({ read: vi.fn(), set: vi.fn() }));
+vi.mock('../providerShareVisibility.js', () => ({ providerShareVisibility: visibility }));
vi.mock('../providerShareMemberNotes.js', () => ({ providerShareMemberNotes: memberNotes }));
vi.mock('../../appSessionState.js', () => ({
@@ -54,11 +57,12 @@ vi.mock('../providerShareHost.js', () => ({
startProviderShareHost: vi.fn(), stopProviderShareHost: vi.fn(),
refreshProviderShareHost: host.refresh, getProviderShareHostSnapshot: host.snapshot,
clearProviderShareRequestQuiet: vi.fn(),
- providerShareGuestAccess: vi.fn(), providerShareGuestDenial: vi.fn(), ensureProviderSharePeerKnown: vi.fn(),
+ providerShareAccessRevision: vi.fn(), providerShareGuestAccess: vi.fn(), providerShareGuestDenial: vi.fn(), ensureProviderSharePeerKnown: vi.fn(),
quietProviderShareRequests: host.quiet, markProviderShareHostActive: host.active,
applyLocalRequestDecision: host.decision, applyLocalMemberChange: host.member,
}));
-vi.mock('../providerShareGuest.js', () => ({ startProviderShareGuest: vi.fn(), stopProviderShareGuest: vi.fn() }));
+const guest = vi.hoisted(() => ({ revision: 0, share: null as unknown }));
+vi.mock('../providerShareGuest.js', () => ({ startProviderShareGuest: vi.fn(), stopProviderShareGuest: vi.fn(), findReceivedShare: () => guest.share, providerShareReceivedRevision: () => guest.revision }));
vi.mock('../providerShareGuestPrefs.js', () => ({ configureProviderShareGuestPrefs: vi.fn(), invalidateProviderShareGuestPrefsCache: vi.fn() }));
vi.mock('../providerShareGuestPrefsIpc.js', () => ({ setProviderShareCredentialConsentFromIpc: vi.fn() }));
@@ -333,3 +337,32 @@ describe('same-account share management during account transitions', () => {
expect(remember).not.toHaveBeenCalled();
});
});
+
+/* 分享可见性:生产管理/IPC入口补足远程设置与受邀者在途撤权、旧端返回差异。tier: unit。 */
+describe('share visibility management and guest query', () => {
+ it('saves only the requested switch via the same-account management entry', async () => {
+ visibility.set.mockImplementation(async (_id, patch, assertCurrent) => { assertCurrent(); return { quota: false, usage: true, ...patch }; });
+ const result = await executeProviderShareManagementCommand(parseProviderShareCommand({ action: 'set-visibility', providerId: 'anthropic', visibility: { quota: true } }) as ProviderShareManagementCommand);
+ expect(result).toMatchObject({ quota: true, usage: true });
+ expect(visibility.set).toHaveBeenCalledWith('anthropic', { quota: true }, expect.any(Function));
+ expect(() => parseProviderShareCommand({ action: 'set-visibility', providerId: 'anthropic', visibility: { quota: 'true' } })).toThrow('INVALID_PARAMS');
+ });
+ it.each(['revision', 'owner', 'removed', 'old-version'])('rejects a stale or unsupported guest response: %s', async (change) => {
+ guest.share = { shareId: 's', memberId: 'm', status: 'active', hostOnline: true };
+ guest.revision = 0;
+ const invoke = vi.fn(async () => {
+ if (change === 'revision') guest.revision += 2; // pause then resume: same current share, different generation
+ if (change === 'owner') state.owner = 'owner-b';
+ if (change === 'removed') guest.share = null;
+ return { ok: true, result: {} } as const;
+ });
+ stopProviderShareRuntime(); startProviderShareRuntime(vi.fn(), { invoke });
+ const handle = vi.spyOn(ipcMain, 'handle');
+ registerProviderShareIpc();
+ const handler = handle.mock.calls.find(([channel]) => channel === 'provider-share:command')![1];
+ handle.mockRestore();
+ await expect(handler({} as Electron.IpcMainInvokeEvent, { action: 'insights', shareId: 's' })).rejects.toThrow(
+ change === 'old-version' ? 'UNSUPPORTED_CAPABILITY' : change === 'owner' ? 'PRECONDITION_FAILED' : 'PERMISSION_DENIED');
+ expect(invoke).toHaveBeenCalledWith('share:s', 'provider-share:insights:v1', [{ version: 1 }], expect.any(Object));
+ });
+});
diff --git a/apps/desktop/src/main/device-link/__tests__/providerShareQuota.test.ts b/apps/desktop/src/main/device-link/__tests__/providerShareQuota.test.ts
new file mode 100644
index 0000000000..c0e7f7e696
--- /dev/null
+++ b/apps/desktop/src/main/device-link/__tests__/providerShareQuota.test.ts
@@ -0,0 +1,168 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const state = vi.hoisted(() => ({
+ owner: 0,
+ group: null as unknown,
+ providers: [] as unknown[],
+ snapshot: null as unknown,
+ personal: false,
+}));
+const remote = vi.hoisted(() => vi.fn());
+const readers = vi.hoisted(() => ({ claude: vi.fn(), xai: vi.fn(), codex: vi.fn() }));
+vi.mock('../../appSessionState.js', () => ({
+ activeOwnerScopeKey: () => String(state.owner),
+ isAppSessionBoundaryPending: () => false,
+}));
+vi.mock('../../authManager.js', () => ({
+ getAuthState: () => ({
+ mode: 'cloud',
+ user: { membershipKind: state.personal ? 'personal' : 'organization' },
+ }),
+}));
+vi.mock('../../clientEndpointsService.js', () => ({ getClientEndpoint: vi.fn() }));
+vi.mock('../../maker-host/createDesktopProviderService.js', () => ({
+ getDesktopProviderService: () => ({ listProviders: async () => state.providers }),
+}));
+vi.mock('../../maker-ipc/usage.js', () => ({
+ readClaudeSubscriptionUsageSnapshotForDeviceLink: readers.claude,
+ readXaiSubscriptionUsageSnapshotForDeviceLink: readers.xai,
+ readCodexRateLimitsForHost: readers.codex,
+}));
+vi.mock('../../provider-group/managementClient.js', () => ({ invokeProviderManagement: remote }));
+vi.mock('../../provider-group/store.js', () => ({ readProviderGroup: () => state.group }));
+const creditUsage = vi.hoisted(() => vi.fn());
+vi.mock('../../serverApiClient.js', () => ({ serverApiFetch: creditUsage }));
+vi.mock('../../usage/claudeAccountUsage.js', () => ({
+ readClaudeAccountUsageSnapshot: () => state.snapshot,
+ readClaudeAccountQuotaClear: () => null,
+ triggerClaudeAccountUsageRefresh: async () => {},
+}));
+vi.mock('../index.js', () => ({ remoteBackgroundInvoke: vi.fn() }));
+import { readProviderShareQuota, readProviderShareQuotaAccount } from '../providerShareQuota';
+/* 测试价值:通过真实额度读入口验证组来源边界、展示白名单、0/缺失区分与共享缓存。
+ * 旧订阅读取测试未覆盖跨账号投影;最小输入含自有+借来账号、远端多余字段、在途改组。
+ * tier: unit;宿主依赖mock,无外网/Agent。单文件耗时见执行报告。 */
+const ready = {
+ state: 'ready',
+ updatedAt: 1,
+ windows: [],
+ balance: { remaining: 0, total: 100, currency: 'USD', resetsAt: null, pools: [] },
+};
+beforeEach(() => {
+ state.owner++;
+ state.personal = false;
+ state.group = null;
+ state.providers = [{ id: 'xd', connected: true, auth: { method: 'apiKey' } }];
+ state.snapshot = null;
+ remote.mockReset().mockResolvedValue(ready);
+});
+describe('share quota projection', () => {
+ it('distinguishes real zero from unavailable and unsupported sources', async () => {
+ state.snapshot = { fetchedAt: 1, maxBudget: 100, spend: 100, currency: 'USD' };
+ expect(await readProviderShareQuotaAccount('xd')).toMatchObject({
+ state: 'ready',
+ balance: { remaining: 0 },
+ });
+ state.owner++;
+ state.snapshot = null;
+ expect(await readProviderShareQuotaAccount('xd')).toMatchObject({
+ state: 'unavailable',
+ balance: null,
+ });
+ state.providers = [{ id: 'custom', connected: true, auth: { method: 'apiKey' } }];
+ expect(await readProviderShareQuotaAccount('custom')).toMatchObject({
+ state: 'unsupported',
+ balance: null,
+ });
+ });
+ it('projects personal Cindy credit pools without grants or account details', async () => {
+ state.personal = true;
+ creditUsage.mockResolvedValue({
+ available: '7',
+ scale: 9,
+ observedAt: '2026-10-19T00:00:00Z',
+ ledgerUpdatedAt: null,
+ plan: { remaining: '4', used: '6', total: '10' },
+ purchased: { remaining: '3', used: null, total: null },
+ promotional: { remaining: '0', used: '0', total: '0' },
+ promotionalGrants: [],
+ promotionalGrantsComplete: true,
+ promotionalGrantConsistency: 'OBSERVED',
+ email: '[email protected]',
+ });
+ const result = await readProviderShareQuotaAccount('xd');
+ expect(result).toMatchObject({
+ state: 'ready',
+ balance: {
+ remaining: 7,
+ total: null,
+ pools: [
+ { kind: 'plan', remaining: 4, total: 10 },
+ { kind: 'purchased', remaining: 3, total: null },
+ { kind: 'promotional', remaining: 0, total: 0 },
+ ],
+ },
+ });
+ expect(JSON.stringify(result)).not.toMatch(/email|promotionalGrants|private/);
+ });
+ it('uses the existing subscription window reader without forwarding account identity', async () => {
+ state.providers = [
+ {
+ id: 'anthropic',
+ connected: true,
+ source: 'builtin',
+ auth: { method: 'oauth', native: 'claude' },
+ },
+ ];
+ readers.claude.mockResolvedValue({
+ fiveHour: { utilization: 100, resetsAt: Date.now() + 60_000 },
+ updatedAt: 123,
+ accountFingerprint: 'secret',
+ });
+ const result = await readProviderShareQuotaAccount('anthropic');
+ expect(result).toMatchObject({
+ state: 'ready',
+ updatedAt: 123,
+ windows: [{ kind: 'session', remainingPercent: 0, windowMinutes: 300 }],
+ });
+ expect(JSON.stringify(result)).not.toContain('secret');
+ });
+ it('excludes borrowed accounts and strips remote identity fields while coalescing repeated queries', async () => {
+ state.group = {
+ members: [
+ { kind: 'device', agentDeviceId: 'own-device', providerId: 'xd' },
+ { kind: 'share', agentDeviceId: 'share:borrowed', providerId: 'xd' },
+ ],
+ };
+ remote.mockResolvedValue({
+ ...ready,
+ deviceId: 'secret',
+ email: '[email protected]',
+ balance: { ...ready.balance, credential: 'secret' },
+ });
+ const [first, second] = await Promise.all([
+ readProviderShareQuota('xd'),
+ readProviderShareQuota('xd'),
+ ]);
+ expect(first).toEqual({ group: true, partial: true, accounts: [ready] });
+ expect(second).toEqual(first);
+ expect(remote).toHaveBeenCalledTimes(1);
+ expect(remote.mock.calls[0][1]).toBe('own-device');
+ expect(JSON.stringify(first)).not.toMatch(/secret|email|deviceId|credential/);
+ });
+ it.each([
+ ['[UNSUPPORTED_CAPABILITY]', 'needs-update'],
+ ['[DEVICE_LINK_DEVICE_OFFLINE]', 'offline'],
+ ])('keeps a distinct state for %s', async (message, expected) => {
+ state.group = { members: [{ kind: 'device', agentDeviceId: 'd', providerId: 'xd' }] };
+ remote.mockRejectedValue(new Error(message));
+ expect((await readProviderShareQuota('xd')).accounts[0].state).toBe(expected);
+ });
+ it('discards group results when membership changes in flight', async () => {
+ state.group = { members: [{ kind: 'device', agentDeviceId: 'd', providerId: 'xd' }] };
+ remote.mockImplementation(async () => {
+ state.group = { members: [] };
+ return ready;
+ });
+ await expect(readProviderShareQuota('xd')).rejects.toThrow('PRECONDITION_FAILED');
+ });
+});
diff --git a/apps/desktop/src/main/device-link/__tests__/providerShareVisibility.test.ts b/apps/desktop/src/main/device-link/__tests__/providerShareVisibility.test.ts
new file mode 100644
index 0000000000..f26d1143c1
--- /dev/null
+++ b/apps/desktop/src/main/device-link/__tests__/providerShareVisibility.test.ts
@@ -0,0 +1,64 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+vi.mock('../../appSessionState.js', () => ({
+ activeOwnerScopeKey: vi.fn(),
+ ownerScopedUserDataPath: vi.fn(),
+}));
+vi.mock('../../logger.js', () => ({ createLogger: () => ({ info: vi.fn(), warn: vi.fn() }) }));
+import * as locks from '../crossProcessLock';
+import { createProviderShareVisibilityStore } from '../providerShareVisibility';
+/* 测试价值:新权限文件默认关闭、独立保存、重启与账号隔离、损坏不覆盖;旧备注测试没有此schema。
+ * 最小输入:两个供应商及两个账号、锁等待切号、无效JSON。unit;独立临时目录并清理。耗时见执行报告。 */
+let root: string;
+let owner: string;
+const file = () => path.join(root, owner, 'visibility.json');
+const make = () => createProviderShareVisibilityStore({ filePath: file, scopeKey: () => owner });
+beforeEach(() => {
+ root = fs.mkdtempSync(path.join(os.tmpdir(), 'cindy-share-visibility-'));
+ owner = 'a';
+});
+afterEach(() => {
+ vi.restoreAllMocks();
+ fs.rmSync(root, { recursive: true, force: true });
+});
+describe('share visibility persistence', () => {
+ it('defaults off, independently updates both permissions and preserves other providers across restarts', async () => {
+ const store = make();
+ expect(store.read('p')).toEqual({ quota: false, usage: false, revision: 0 });
+ await store.set('p', { quota: true }, () => {});
+ await store.set('q', { usage: true }, () => {});
+ await store.set('p', { usage: true }, () => {});
+ await store.set('p', { quota: false }, () => {});
+ expect(make().read('p')).toEqual({ quota: false, usage: true, revision: 3 });
+ expect(make().read('q')).toEqual({ quota: false, usage: true, revision: 1 });
+ });
+ it('isolates matching provider ids and cache across owners', async () => {
+ const store = make();
+ await store.set('p', { quota: true }, () => {});
+ owner = 'b';
+ expect(store.read('p').quota).toBe(false);
+ await store.set('p', { usage: true }, () => {});
+ owner = 'a';
+ expect(store.read('p')).toMatchObject({ quota: true, usage: false });
+ });
+ it('refuses writes crossing an owner boundary while waiting for a lock', async () => {
+ vi.spyOn(locks, 'withCrossProcessLock').mockImplementationOnce(
+ async (_file, _options, task) => {
+ owner = 'b';
+ return task({ held: true });
+ },
+ );
+ await expect(make().set('p', { quota: true }, () => {})).rejects.toThrow();
+ expect(fs.existsSync(file())).toBe(false);
+ });
+ it('keeps unreadable permission files intact and defaults to no access', async () => {
+ fs.mkdirSync(path.dirname(file()), { recursive: true });
+ fs.writeFileSync(file(), '{broken');
+ const store = make();
+ expect(store.read('p')).toMatchObject({ quota: false, usage: false });
+ await expect(store.set('p', { quota: true }, () => {})).rejects.toThrow();
+ expect(fs.readFileSync(file(), 'utf8')).toBe('{broken');
+ });
+});
diff --git a/apps/desktop/src/main/device-link/dispatch.ts b/apps/desktop/src/main/device-link/dispatch.ts
index 187ef3737f..c216da19b3 100644
--- a/apps/desktop/src/main/device-link/dispatch.ts
+++ b/apps/desktop/src/main/device-link/dispatch.ts
@@ -1,3 +1,4 @@
+import { PROVIDER_SHARE_INSIGHTS_CHANNEL } from '../../shared/providerShareInsights.js';
import { hasRichAnswer, compactRichAnswer, richAnswerText } from '@cindy/maker-shared/rich-answer';
import type { RemoteAgentLimitUsage } from '../../shared/remoteAgentLimits.js';
import { executeTaskTags, TASK_TAG_CHANNEL } from '../localDb/ipc/taskTags.js';
@@ -383,6 +384,8 @@ export function setRemoteReviewInputGuard(guard: RemoteReviewInputGuard | null):
* 都被拒绝(fail-closed),也让本模块不必静态依赖账号与分享运行时。
*/
export interface ProviderShareAccessPort {
+ insights?(controller: string, request: unknown): Promise<unknown>;
+ insightsCurrent?(controller: string, result: unknown): boolean;
guestAccess(controller: string): { shareId: string; memberId: string; providerId: string } | null;
/** 不认识的受邀者连进来时按需刷新一次分享快照。 */
ensureKnown(controller: string): Promise<void>;
@@ -3460,7 +3463,7 @@ function sendInvokeResultSafe(
// 不能把缓存留在原始大对象上,否则缓存可能自淘汰且重复 requestId 会再次执行。
// 远程 Agent 的每个 op 自带幂等(poll 按游标、其余按各自 id 去重),高频的事件流结果不进
// 全局去重缓存,免得冲掉其它控制端非幂等调用的去重记录。
- if (fingerprint !== undefined && channel !== REMOTE_AGENT_CHANNEL) {
+ if (fingerprint !== undefined && channel !== REMOTE_AGENT_CHANNEL && channel !== PROVIDER_SHARE_INSIGHTS_CHANNEL) {
rememberRemoteInvokeResult(key, fingerprint, attempt.result);
}
if (attempt.sent) {
@@ -3499,6 +3502,9 @@ function trySendInvokeResult(
}
// 撤权后迟到的结果(含 outbox 重发)不再带出数据。
if (isProviderSharePeer(src) && !providerShareGuestAccess(src)) result = PROVIDER_SHARE_ACCESS_FAILURE;
+ // 开关撤销和关后重开都使旧投影失效;关系仍有效不代表可继续发送旧额度。
+ if (isProviderSharePeer(src) && channel === PROVIDER_SHARE_INSIGHTS_CHANNEL && result.ok
+ && !providerShareAccess?.insightsCurrent?.(src, result.result)) result = PROVIDER_SHARE_ACCESS_FAILURE;
let candidate = result;
try {
client.sendInvokeResult(src, requestId, candidate);
@@ -4210,6 +4216,7 @@ const PROVIDER_SHARE_ACCESS_FAILURE: InvokeResultPayload = {
* available agents, agent readiness), each narrowed to the shared provider below.
*/
const PROVIDER_SHARE_CHANNELS: ReadonlySet<string> = new Set([
+ PROVIDER_SHARE_INSIGHTS_CHANNEL,
REMOTE_AGENT_CHANNEL,
'maker:provider:list',
'maker:get-capabilities',
@@ -4368,6 +4375,17 @@ async function runProviderShareInvoke(
return { ok: false, error: { code: 'CHANNEL_NOT_ALLOWED', message: `channel '${payload.channel}' not allowed for shared providers` } };
}
const args = Array.isArray(payload.args) ? payload.args : [];
+ if (payload.channel === PROVIDER_SHARE_INSIGHTS_CHANNEL) {
+ if (!providerShareAccess?.insights) return { ok: false, error: { code: 'CHANNEL_NOT_ALLOWED', message: 'Provider share insights are not supported' } };
+ try {
+ if (args.length !== 1) throw new Error('[INVALID_PARAMS] Expected one insights request');
+ const result = await providerShareAccess.insights(src, args[0]);
+ if (!providerShareGuestAccess(src)) return PROVIDER_SHARE_ACCESS_FAILURE;
+ return { ok: true, result };
+ } catch {
+ return { ok: false, error: { code: 'IPC_ERROR', message: '[PERMISSION_DENIED] Provider share insights are unavailable or access changed' } };
+ }
+ }
if (PROVIDER_SHARE_AGENT_ARG_CHANNELS.has(payload.channel) && !PROVIDER_SHARE_AGENT_KINDS.has(String(args[0]))) {
return { ok: false, error: { code: 'IPC_ERROR', message: '[INVALID_PARAMS] unknown agent' } };
}
@@ -4917,6 +4935,7 @@ export const __testing = {
sessionActivityStageMaxKeys: SESSION_ACTIVITY_STAGE_MAX_KEYS,
sessionActivityDrainRetryMs: SESSION_ACTIVITY_DRAIN_RETRY_MS,
handleLinkOpen,
+ handleInvoke,
handleSubscriptionFrame,
purgeRevokedController,
setActiveClient(c: DeviceLinkClient | null): void {
diff --git a/apps/desktop/src/main/device-link/providerShareGuest.ts b/apps/desktop/src/main/device-link/providerShareGuest.ts
index 56dc229581..41a5e99aa1 100644
--- a/apps/desktop/src/main/device-link/providerShareGuest.ts
+++ b/apps/desktop/src/main/device-link/providerShareGuest.ts
@@ -88,6 +88,10 @@ interface ResolvedLink {
}
let runtime: Runtime | null = null;
+let receivedRevision = 0;
+let receivedFingerprint = '';
+/** 用于只读分享投影的在途校验;暂停后恢复也不能复用旧回包。 */
+export function providerShareReceivedRevision(): number { return receivedRevision; }
function current(rt: Runtime): boolean {
return runtime === rt && !rt.stopped && getAuthState().isAuthenticated && !isAppSessionBoundaryPending()
@@ -115,6 +119,8 @@ function confirmedRegions(rt: Runtime): Region[] {
function emitChanged(rt: Runtime): Promise<void> | void {
if (!current(rt)) return;
const received = allReceived(rt);
+ const fingerprint = JSON.stringify(received);
+ if (fingerprint !== receivedFingerprint) { receivedFingerprint = fingerprint; receivedRevision++; }
// 分享被分享者删除后,它在这台电脑上的本机偏好一起清掉;还没加载的区域不动。
const pruning = pruneProviderShareGuestPrefs(new Set(received.map((share) => share.shareId)), confirmedRegions(rt));
const notify = () => {
@@ -228,6 +234,7 @@ export function startProviderShareGuest(events: ProviderShareGuestEvents, option
}
export function stopProviderShareGuest(): void {
+ receivedRevision++; receivedFingerprint = '';
stopProviderShareCrossRegion();
const rt = runtime;
if (!rt) return;
diff --git a/apps/desktop/src/main/device-link/providerShareHost.ts b/apps/desktop/src/main/device-link/providerShareHost.ts
index ec8a4444ac..4a61ce93ea 100644
--- a/apps/desktop/src/main/device-link/providerShareHost.ts
+++ b/apps/desktop/src/main/device-link/providerShareHost.ts
@@ -119,6 +119,8 @@ interface RetainedRemoteLinkState {
}
let runtime: Runtime | null = null;
+let accessRevision = 0;
+export function providerShareAccessRevision(): number { return accessRevision; }
/** 分享快照变化的旁听者(见 onProviderShareHostChanged)。 */
const snapshotListeners = new Set<() => void>();
@@ -215,6 +217,7 @@ function schedule(rt: Runtime): void {
function applySnapshot(rt: Runtime, next: ProviderShareOwned[]): void {
const previous = rt.shares;
+ if (JSON.stringify(previous) !== JSON.stringify(next)) accessRevision++;
rt.shares = next;
rt.fetchedAt = Date.now();
// 原来 active 的成员不再 active:结束任务、断开连接。成员从快照里消失(删除、退出)时,不论之前
@@ -357,6 +360,7 @@ export function startProviderShareHost(events: ProviderShareHostEvents, options:
}
export function stopProviderShareHost(): void {
+ accessRevision++;
const rt = runtime;
if (!rt) return;
rt.stopped = true;
diff --git a/apps/desktop/src/main/device-link/providerShareInsights.ts b/apps/desktop/src/main/device-link/providerShareInsights.ts
new file mode 100644
index 0000000000..507d40a507
--- /dev/null
+++ b/apps/desktop/src/main/device-link/providerShareInsights.ts
@@ -0,0 +1,217 @@
+import { createHash } from 'node:crypto';
+import type { ProviderShareOwned } from '@cindy/device-link';
+import type { ProviderUsageHistoryView } from '../../shared/providerShare.js';
+import type {
+ ProviderShareInsights,
+ ProviderShareQuotaAccount,
+ ProviderShareUsageDay,
+ ProviderShareUsageDetails,
+ ProviderShareVisibility,
+} from '../../shared/providerShareInsights.js';
+import type { ProviderShareGuestAccess } from './providerShareHost.js';
+import { throwIpcError } from '../utils/ipcValidate.js';
+
+export interface ProviderShareInsightsDeps {
+ captureScope(): () => void;
+ scopeKey(): string;
+ access(peer: string): ProviderShareGuestAccess | null;
+ revision(): number;
+ visibility(providerId: string): ProviderShareVisibility & { revision: number };
+ shares(): readonly ProviderShareOwned[];
+ owner(): { displayName: string; avatarUrl: string | null };
+ history(providerId: string): Promise<ProviderUsageHistoryView>;
+ quota(
+ providerId: string,
+ ): Promise<{ group: boolean; partial: boolean; accounts: ProviderShareQuotaAccount[] }>;
+}
+
+function publicDays(days: ProviderUsageHistoryView['self']['days']): ProviderShareUsageDay[] {
+ const merged = new Map<string, ProviderShareUsageDay>();
+ for (const row of days) {
+ const key = JSON.stringify([row.day, row.kind, row.model]);
+ const previous = merged.get(key);
+ const amount = row.amount ? { amount: row.amount.amount, currency: row.amount.currency } : null;
+ if (!previous) {
+ merged.set(key, {
+ day: row.day,
+ kind: row.kind,
+ model: row.model,
+ turns: row.turns,
+ inputTokens: row.inputTokens,
+ outputTokens: row.outputTokens,
+ cacheReadTokens: row.cacheReadTokens,
+ cacheCreateTokens: row.cacheCreateTokens,
+ amount,
+ });
+ } else {
+ previous.turns += row.turns;
+ previous.inputTokens += row.inputTokens;
+ previous.outputTokens += row.outputTokens;
+ previous.cacheReadTokens += row.cacheReadTokens;
+ previous.cacheCreateTokens += row.cacheCreateTokens;
+ previous.amount =
+ previous.amount && amount && previous.amount.currency === amount.currency
+ ? { amount: previous.amount.amount + amount.amount, currency: amount.currency }
+ : null;
+ }
+ }
+ return [...merged.values()];
+}
+
+function publicUsage(
+ history: ProviderUsageHistoryView,
+ share: ProviderShareOwned,
+ viewer: string,
+ owner: ReturnType<ProviderShareInsightsDeps['owner']>,
+): ProviderShareUsageDetails {
+ return {
+ todayKey: history.todayKey,
+ coverageStart: history.coverageStart,
+ parties: [
+ {
+ key: 'owner',
+ displayName: owner.displayName,
+ avatarUrl: owner.avatarUrl,
+ isYou: false,
+ isOwner: true,
+ isRelay: false,
+ lastUsedAt: history.self.lastUsedAt,
+ days: publicDays(history.self.days),
+ },
+ ...share.members.map((member) => {
+ const usage = history.members.find(
+ (item) => item.shareId === share.shareId && item.memberId === member.memberId,
+ );
+ return {
+ key: createHash('sha256')
+ .update(JSON.stringify([share.shareId, member.memberId]))
+ .digest('hex')
+ .slice(0, 24),
+ displayName: member.displayName,
+ avatarUrl: member.avatarUrl,
+ isYou: member.memberId === viewer,
+ isOwner: false,
+ isRelay: false,
+ lastUsedAt: usage?.lastUsedAt ?? null,
+ days: publicDays(usage?.days ?? []),
+ };
+ }),
+ ...(history.relays.length
+ ? [
+ {
+ key: 'relay',
+ displayName: '',
+ avatarUrl: null,
+ isYou: false,
+ isOwner: false,
+ isRelay: true,
+ lastUsedAt: history.relays.reduce<number | null>(
+ (last, relay) =>
+ relay.lastUsedAt === null ? last : Math.max(last ?? 0, relay.lastUsedAt),
+ null,
+ ),
+ days: publicDays(history.relays.flatMap((relay) => relay.days)),
+ },
+ ]
+ : []),
+ ],
+ };
+}
+
+/** 最小只读投影;权限检查保留到实际发送,包括背压队列重发。 */
+export function createProviderShareInsightsReader(deps: ProviderShareInsightsDeps) {
+ const checks = new WeakMap<object, { peer: string; assertCurrent(): void }>();
+ let cached: {
+ owner: string;
+ providerId: string;
+ revision: number;
+ expiresAt: number;
+ read: Promise<ProviderUsageHistoryView>;
+ } | null = null;
+ const read = async (peer: string, raw: unknown): Promise<ProviderShareInsights> => {
+ if (
+ !raw ||
+ typeof raw !== 'object' ||
+ Array.isArray(raw) ||
+ Object.keys(raw).length !== 1 ||
+ (raw as { version?: unknown }).version !== 1
+ ) {
+ throwIpcError('INVALID_PARAMS', 'Invalid provider share insights request');
+ }
+ const assertOwner = deps.captureScope();
+ const owner = deps.scopeKey();
+ const access = deps.access(peer);
+ if (!access) throwIpcError('PERMISSION_DENIED', 'Provider share is not available');
+ const visibility = deps.visibility(access.providerId);
+ const revision = deps.revision();
+ const assertCurrent = () => {
+ assertOwner();
+ const latest = deps.access(peer);
+ if (
+ deps.scopeKey() !== owner ||
+ !latest ||
+ latest.providerId !== access.providerId ||
+ latest.memberId !== access.memberId ||
+ latest.shareId !== access.shareId ||
+ deps.revision() !== revision ||
+ deps.visibility(access.providerId).revision !== visibility.revision
+ ) {
+ throwIpcError('PERMISSION_DENIED', 'Provider share access changed');
+ }
+ };
+ assertCurrent();
+ if (
+ visibility.usage &&
+ (!cached ||
+ cached.owner !== owner ||
+ cached.providerId !== access.providerId ||
+ cached.revision !== revision ||
+ cached.expiresAt <= Date.now())
+ ) {
+ const read = deps.history(access.providerId);
+ cached = {
+ owner,
+ providerId: access.providerId,
+ revision,
+ expiresAt: Date.now() + 15_000,
+ read,
+ };
+ void read.catch(() => {
+ if (cached?.read === read) cached = null;
+ });
+ }
+ const [historyResult, quotaResult] = await Promise.allSettled([
+ visibility.usage ? cached!.read : null,
+ visibility.quota ? deps.quota(access.providerId) : null,
+ ]);
+ assertCurrent();
+ const share = deps.shares().find((item) => item.shareId === access.shareId);
+ if (!share) throwIpcError('PERMISSION_DENIED', 'Provider share is not available');
+ const history = historyResult.status === 'fulfilled' ? historyResult.value : null;
+ const quota = quotaResult.status === 'fulfilled' ? quotaResult.value : null;
+ const result: ProviderShareInsights = {
+ version: 1,
+ capabilities: { quota: visibility.quota, usage: visibility.usage },
+ status: {
+ quota: !visibility.quota ? 'disabled' : quota ? 'ready' : 'unavailable',
+ usage: !visibility.usage ? 'disabled' : history ? 'ready' : 'unavailable',
+ },
+ quota,
+ usage: history ? publicUsage(history, share, access.memberId, deps.owner()) : null,
+ };
+ checks.set(result, { peer, assertCurrent });
+ return result;
+ };
+ return Object.assign(read, {
+ isCurrent(peer: string, result: unknown): boolean {
+ const check = result && typeof result === 'object' ? checks.get(result) : undefined;
+ if (!check || check.peer !== peer) return false;
+ try {
+ check.assertCurrent();
+ return true;
+ } catch {
+ return false;
+ }
+ },
+ });
+}
diff --git a/apps/desktop/src/main/device-link/providerShareQuota.ts b/apps/desktop/src/main/device-link/providerShareQuota.ts
new file mode 100644
index 0000000000..089dbe552e
--- /dev/null
+++ b/apps/desktop/src/main/device-link/providerShareQuota.ts
@@ -0,0 +1,296 @@
+import type { ProviderView } from '@cindy/model-providers';
+import type { ProviderShareQuotaAccount } from '../../shared/providerShareInsights.js';
+import { providerWeeklyQuotaSource } from '../../shared/providerQuotaSource.js';
+import { CURRENT_CINDY_REGION } from '../../shared/brandRegion.js';
+import { activeOwnerScopeKey } from '../appSessionState.js';
+import { getAuthState } from '../authManager.js';
+import { projectModelAccessCreditUsage } from '../billing/projection.js';
+import { getClientEndpoint } from '../clientEndpointsService.js';
+import { getDesktopProviderService } from '../maker-host/createDesktopProviderService.js';
+import { codexSource, claudeSource, xaiSource } from '../menubar/collect.js';
+import { captureProviderManagementScope } from '../provider-group/managementScope.js';
+import { invokeProviderManagement } from '../provider-group/managementClient.js';
+import { readProviderGroup } from '../provider-group/store.js';
+import { serverApiFetch } from '../serverApiClient.js';
+import {
+ readClaudeAccountUsageSnapshot,
+ readClaudeAccountQuotaClear,
+ triggerClaudeAccountUsageRefresh,
+} from '../usage/claudeAccountUsage.js';
+import { throwIpcError } from '../utils/ipcValidate.js';
+import {
+ readClaudeSubscriptionUsageSnapshotForDeviceLink,
+ readXaiSubscriptionUsageSnapshotForDeviceLink,
+ readCodexRateLimitsForHost,
+} from '../maker-ipc/usage.js';
+import { remoteBackgroundInvoke } from './index.js';
+
+const FRESH_MS = 30_000;
+const empty = (state: ProviderShareQuotaAccount['state']): ProviderShareQuotaAccount => ({
+ state,
+ updatedAt: null,
+ windows: [],
+ balance: null,
+});
+let cacheOwner = '';
+const cache = new Map<string, { until: number; pending: Promise<ProviderShareQuotaAccount> }>();
+
+async function readAccount(provider: ProviderView): Promise<ProviderShareQuotaAccount> {
+ if (!provider.connected || provider.removed || provider.suspended) return empty('unavailable');
+ const source = providerWeeklyQuotaSource(provider);
+ if (source) {
+ const now = Date.now();
+ const value =
+ source === 'claude'
+ ? claudeSource(
+ provider,
+ await readClaudeSubscriptionUsageSnapshotForDeviceLink(provider.id),
+ now,
+ )
+ : source === 'xai'
+ ? xaiSource(
+ provider,
+ await readXaiSubscriptionUsageSnapshotForDeviceLink(provider.id),
+ now,
+ )
+ : codexSource(
+ provider,
+ (await readCodexRateLimitsForHost(provider.id))?.rateLimits ?? null,
+ now,
+ );
+ const windows = value.windows.map((window) => ({
+ kind: window.kind,
+ label: window.label ?? null,
+ remainingPercent: Math.max(0, 100 - window.usedPercent),
+ resetsAt: window.resetsAtMs,
+ windowMinutes: window.windowMinutes,
+ }));
+ return {
+ state: windows.length ? 'ready' : 'unavailable',
+ updatedAt: value.updatedAtMs,
+ windows,
+ balance: null,
+ };
+ }
+ if (provider.id !== 'xd') return empty('unsupported');
+ const auth = getAuthState();
+ if (auth.mode === 'cloud' && auth.user?.membershipKind === 'personal') {
+ const usage = projectModelAccessCreditUsage(
+ await serverApiFetch<unknown>('/api/model-access/credit-usage', {
+ timeoutMs: 20_000,
+ redactErrorDetails: true,
+ baseUrl: () => getClientEndpoint('modelAccessApiBaseUrl'),
+ }),
+ );
+ const pools = (['plan', 'purchased', 'promotional'] as const).map((kind) => ({
+ kind,
+ remaining: Number(usage[kind].remaining),
+ total: usage[kind].total === null ? null : Number(usage[kind].total),
+ }));
+ return {
+ state: 'ready',
+ updatedAt: Date.parse(usage.observedAt),
+ windows: [],
+ balance: {
+ remaining: Number(usage.available),
+ total: pools.every((pool) => pool.total !== null)
+ ? pools.reduce((sum, pool) => sum + pool.total!, 0)
+ : null,
+ currency: CURRENT_CINDY_REGION === 'cn' ? 'CNY' : 'USD',
+ resetsAt: null,
+ pools,
+ },
+ };
+ }
+ await triggerClaudeAccountUsageRefresh(false);
+ const snapshot = readClaudeAccountUsageSnapshot();
+ if (!snapshot)
+ return empty(
+ readClaudeAccountQuotaClear()?.quotaState === 'unlimited' ? 'unlimited' : 'unavailable',
+ );
+ return {
+ state: 'ready',
+ updatedAt: snapshot.fetchedAt,
+ windows: [],
+ balance: {
+ remaining: Math.max(0, snapshot.maxBudget - snapshot.spend),
+ total: snapshot.maxBudget,
+ currency: snapshot.currency,
+ resetsAt: snapshot.budgetResetAt ? Date.parse(snapshot.budgetResetAt) : null,
+ pools: [],
+ },
+ };
+}
+
+export async function readProviderShareQuotaAccount(
+ providerId: string,
+): Promise<ProviderShareQuotaAccount> {
+ const assertCurrent = captureProviderManagementScope();
+ const provider = (
+ await getDesktopProviderService().listProviders({ allowSideEffects: false })
+ ).find((item) => item.id === providerId);
+ assertCurrent();
+ if (!provider) return empty('unavailable');
+ const owner = activeOwnerScopeKey();
+ if (owner !== cacheOwner) {
+ cacheOwner = owner;
+ cache.clear();
+ }
+ const key = JSON.stringify(provider);
+ for (const [entry, value] of cache) if (value.until <= Date.now()) cache.delete(entry);
+ let pending = cache.get(key);
+ if (!pending) {
+ pending = {
+ until: Date.now() + FRESH_MS,
+ pending: readAccount(provider).catch(() => empty('unavailable')),
+ };
+ cache.set(key, pending);
+ }
+ const result = await pending.pending;
+ assertCurrent();
+ const latest = (
+ await getDesktopProviderService().listProviders({ allowSideEffects: false })
+ ).find((item) => item.id === providerId);
+ assertCurrent();
+ return JSON.stringify(latest) === key ? result : empty('unavailable');
+}
+
+async function readGroupQuota(providerId: string) {
+ const assertCurrent = captureProviderManagementScope();
+ const group = readProviderGroup(providerId);
+ if (!group)
+ return {
+ group: false,
+ partial: false,
+ accounts: [await readProviderShareQuotaAccount(providerId)],
+ };
+ const accounts: ProviderShareQuotaAccount[] = [];
+ const ownMembers = group.members.filter((member) => member.kind !== 'share');
+ for (let offset = 0; offset < ownMembers.length; offset += 3) {
+ assertCurrent();
+ accounts.push(
+ ...(await Promise.all(
+ ownMembers.slice(offset, offset + 3).map(async (member) => {
+ if (member.kind === 'local' || !member.agentDeviceId)
+ return readProviderShareQuotaAccount(member.providerId);
+ try {
+ const raw = (await invokeProviderManagement(
+ remoteBackgroundInvoke,
+ member.agentDeviceId,
+ {
+ action: 'manage-share',
+ command: { action: 'quota-account', providerId: member.providerId },
+ },
+ )) as ProviderShareQuotaAccount;
+ return sanitizeQuotaAccount(raw);
+ } catch (error) {
+ const message = error instanceof Error ? error.message : '';
+ return empty(
+ /UNSUPPORTED_CAPABILITY|CHANNEL_NOT_ALLOWED/.test(message)
+ ? 'needs-update'
+ : /OFFLINE|NOT_CONNECTED|LINK_NOT_OPEN/.test(message)
+ ? 'offline'
+ : 'unavailable',
+ );
+ }
+ }),
+ )),
+ );
+ }
+ assertCurrent();
+ if (JSON.stringify(group) !== JSON.stringify(readProviderGroup(providerId)))
+ throwIpcError('PRECONDITION_FAILED', 'Provider group changed');
+ return { group: true, partial: ownMembers.length !== group.members.length, accounts };
+}
+
+function sanitizeQuotaAccount(raw: ProviderShareQuotaAccount): ProviderShareQuotaAccount {
+ if (
+ !raw ||
+ !['ready', 'unsupported', 'unavailable', 'offline', 'needs-update', 'unlimited'].includes(
+ raw.state,
+ ) ||
+ !Array.isArray(raw.windows)
+ )
+ return empty('unavailable');
+ const finite = (value: unknown): value is number =>
+ typeof value === 'number' && Number.isFinite(value);
+ const balance = raw.balance;
+ return {
+ state: raw.state,
+ updatedAt: finite(raw.updatedAt) ? raw.updatedAt : null,
+ windows: raw.windows
+ .slice(0, 32)
+ .filter(
+ (window) =>
+ window &&
+ ['session', 'week', 'scoped'].includes(window.kind) &&
+ finite(window.remainingPercent),
+ )
+ .map((window) => ({
+ kind: window.kind,
+ label: typeof window.label === 'string' ? window.label.slice(0, 128) : null,
+ remainingPercent: Math.min(100, Math.max(0, window.remainingPercent)),
+ resetsAt: finite(window.resetsAt) ? window.resetsAt : null,
+ windowMinutes: finite(window.windowMinutes) ? window.windowMinutes : null,
+ })),
+ balance:
+ balance && finite(balance.remaining) && ['USD', 'CNY'].includes(balance.currency)
+ ? {
+ remaining: balance.remaining,
+ total: finite(balance.total) ? balance.total : null,
+ currency: balance.currency,
+ resetsAt: finite(balance.resetsAt) ? balance.resetsAt : null,
+ pools: Array.isArray(balance.pools)
+ ? balance.pools
+ .slice(0, 3)
+ .filter(
+ (pool) =>
+ pool &&
+ ['plan', 'purchased', 'promotional'].includes(pool.kind) &&
+ finite(pool.remaining),
+ )
+ .map((pool) => ({
+ kind: pool.kind,
+ remaining: pool.remaining,
+ total: finite(pool.total) ? pool.total : null,
+ }))
+ : [],
+ }
+ : null,
+ };
+}
+
+/** 同一账号/组配置共享在途与短缓存,受邀者人数不会放大组内查询频率。 */
+const groupCache = new Map<string, { until: number; pending: ReturnType<typeof readGroupQuota> }>();
+let groupCacheOwner = '';
+export async function readProviderShareQuota(providerId: string) {
+ const assertCurrent = captureProviderManagementScope();
+ const owner = activeOwnerScopeKey();
+ if (owner !== groupCacheOwner) {
+ groupCacheOwner = owner;
+ groupCache.clear();
+ }
+ const config = JSON.stringify(readProviderGroup(providerId));
+ const key = JSON.stringify([providerId, config]);
+ for (const [entry, value] of groupCache) if (value.until <= Date.now()) groupCache.delete(entry);
+ let cached = groupCache.get(key);
+ if (!cached) {
+ const pending = readGroupQuota(providerId);
+ cached = { until: Infinity, pending };
+ groupCache.set(key, cached);
+ const entry = cached;
+ void pending.then(
+ () => {
+ entry.until = Date.now() + 15_000;
+ },
+ () => {
+ if (groupCache.get(key) === entry) groupCache.delete(key);
+ },
+ );
+ }
+ const result = await cached.pending;
+ assertCurrent();
+ if (config !== JSON.stringify(readProviderGroup(providerId)))
+ throwIpcError('PRECONDITION_FAILED', 'Provider group changed');
+ return result;
+}
diff --git a/apps/desktop/src/main/device-link/providerShareRuntime.ts b/apps/desktop/src/main/device-link/providerShareRuntime.ts
index 308e7c9471..fc15d30e3c 100644
--- a/apps/desktop/src/main/device-link/providerShareRuntime.ts
+++ b/apps/desktop/src/main/device-link/providerShareRuntime.ts
@@ -34,7 +34,12 @@ import {
type ProviderUsageDayView,
type ProviderUsageHistoryView,
} from '../../shared/providerShare.js';
-import { getDeviceId } from '../authManager.js';
+import { getAuthState, getDeviceId } from '../authManager.js';
+import { parseProviderShareInsights, PROVIDER_SHARE_INSIGHTS_CHANNEL } from '../../shared/providerShareInsights.js';
+import { isProviderGroupProviderId } from '../../shared/providerGroup.js';
+import { providerShareVisibility } from './providerShareVisibility.js';
+import { createProviderShareInsightsReader } from './providerShareInsights.js';
+import { readProviderShareQuota, readProviderShareQuotaAccount } from './providerShareQuota.js';
import { isDataOwnerPushStamp } from '../../shared/dataOwnerPush.js';
import { t } from '../i18n.js';
import { createLogger } from '../logger.js';
@@ -45,7 +50,7 @@ import { currentLedgerCurrency } from '../usage/ledgerCurrency.js';
import { getGatewayModelPricing, getModelPriceQuote } from '../usage/modelPricing.js';
import { computePriceQuoteTurnMoney, normalizeModelIdForPricing } from '../usage/turnCostCalculator.js';
import { rememberIssuedClipboardText } from '../textClipboard.js';
-import { ownerScopedUserDataPath } from '../appSessionState.js';
+import { activeOwnerScopeKey, ownerScopedUserDataPath } from '../appSessionState.js';
import { normalizeProviderShareMemberNote, PROVIDER_SHARE_MEMBER_NOTE_MAX_LENGTH } from '../../shared/providerShareMemberNote.js';
import { providerShareMemberNotes } from './providerShareMemberNotes.js';
import { captureProviderManagementScope } from '../provider-group/managementScope.js';
@@ -64,6 +69,7 @@ import { fetchIdentityCard, providerShareApi, providerShareLinkFor, sha256Hex }
import { configureProviderShareApprovalWindows } from './providerShareApprovalWindows.js';
import {
findReceivedShare,
+ providerShareReceivedRevision,
getReceivedShares,
isReceivedSharesReady,
getReceivedSharesSnapshot,
@@ -92,6 +98,7 @@ import {
getProviderShareWatchedRequests,
markProviderShareHostActive,
providerShareGuestAccess,
+ providerShareAccessRevision,
providerShareGuestDenial,
providerShareMemberMatcher,
quietProviderShareRequests,
@@ -336,6 +343,22 @@ export function parseProviderShareCommand(raw: unknown): ProviderShareCommand {
if (!raw || typeof raw !== 'object' || Array.isArray(raw)) throwIpcError('INVALID_PARAMS', 'Invalid command');
const value = raw as Record<string, unknown>;
switch (value.action) {
+ case 'get-visibility':
+ case 'quota-account':
+ if (!isProviderGroupProviderId(value.providerId)) throwIpcError('INVALID_PARAMS', 'Invalid providerId');
+ return { action: value.action, providerId: value.providerId };
+ case 'set-visibility': {
+ if (!isProviderGroupProviderId(value.providerId)) throwIpcError('INVALID_PARAMS', 'Invalid providerId');
+ const patch = value.visibility;
+ if (!patch || typeof patch !== 'object' || Array.isArray(patch)
+ || Object.keys(patch).length === 0 || Object.entries(patch).some(([key, entry]) =>
+ !['quota', 'usage'].includes(key) || typeof entry !== 'boolean')) {
+ throwIpcError('INVALID_PARAMS', 'Invalid share visibility');
+ }
+ return { action: 'set-visibility', providerId: value.providerId, visibility: patch };
+ }
+ case 'insights':
+ return { action: 'insights', shareId: text(value.shareId, 'shareId', 128) };
case 'get-run-limits':
case 'reset-run-limits':
return { action: value.action };
@@ -687,6 +710,43 @@ async function createLink(
async function execute(command: ProviderShareCommand, assertCurrent: () => void = () => undefined): Promise<unknown> {
assertCurrent();
switch (command.action) {
+ case 'get-visibility':
+ return providerShareVisibility.read(command.providerId);
+ case 'set-visibility': {
+ const assertOwner = captureProviderManagementScope();
+ const result = await providerShareVisibility.set(command.providerId, command.visibility, () => { assertCurrent(); assertOwner(); });
+ emit(PROVIDER_SHARE_IPC.OWNED_CHANGED, null);
+ return result;
+ }
+ case 'quota-account':
+ return readProviderShareQuotaAccount(command.providerId);
+ case 'insights': {
+ const assertOwner = captureProviderManagementScope();
+ const share = findReceivedShare(command.shareId);
+ const revision = providerShareReceivedRevision();
+ if (!share || share.status !== 'active') throwIpcError('PERMISSION_DENIED', 'Provider share is not available');
+ if (!share.hostOnline) throwIpcError('DEVICE_LINK_DEVICE_OFFLINE', 'Provider share host is offline');
+ if (!shareInvoke) throwIpcError('DEVICE_LINK_NOT_CONNECTED', 'Provider share connection is not ready');
+ const assertShare = () => {
+ assertOwner();
+ const latest = findReceivedShare(command.shareId);
+ if (providerShareReceivedRevision() !== revision || !latest || latest.memberId !== share.memberId || latest.status !== 'active' || !latest.hostOnline) {
+ throwIpcError('PERMISSION_DENIED', 'Provider share changed');
+ }
+ };
+ const response = await shareInvoke(`share:${command.shareId}`, PROVIDER_SHARE_INSIGHTS_CHANNEL, [{ version: 1 }], { preSend: assertShare });
+ assertShare();
+ if (!response.ok) {
+ throwIpcError(response.error.code === 'CHANNEL_NOT_ALLOWED' ? 'UNSUPPORTED_CAPABILITY'
+ : response.error.code === 'DEVICE_OFFLINE' ? 'DEVICE_LINK_DEVICE_OFFLINE'
+ : response.error.code === 'INVOKE_TIMEOUT' ? 'DEVICE_LINK_TIMEOUT'
+ : response.error.code === 'NOT_CONNECTED' || response.error.code === 'LINK_NOT_OPEN' ? 'DEVICE_LINK_NOT_CONNECTED'
+ : 'PERMISSION_DENIED', 'Provider share insights are not available');
+ }
+ const result = parseProviderShareInsights(response.result);
+ if (!result) throwIpcError('UNSUPPORTED_CAPABILITY', 'Provider share insights require an update');
+ return result;
+ }
case 'get-run-limits':
case 'set-run-limits':
case 'reset-run-limits': {
@@ -868,7 +928,20 @@ async function receivedCatalogs(args: unknown[]): Promise<{ ready: boolean; shar
export function registerProviderShareIpc(): void {
// 受邀者对每个分享的本机偏好(「信任 {分享者}」):按当前账号存放,读写时解析。
configureProviderShareGuestPrefs({ resolvePath: () => ownerScopedUserDataPath('provider-share-guest-prefs.json') });
+ const insights = createProviderShareInsightsReader({
+ scopeKey: activeOwnerScopeKey,
+ captureScope: captureProviderManagementScope,
+ access: providerShareGuestAccess,
+ revision: providerShareAccessRevision,
+ visibility: (providerId) => providerShareVisibility.read(providerId),
+ shares: getProviderShareHostSnapshot,
+ owner: () => ({ displayName: getAuthState().user?.name ?? '', avatarUrl: getAuthState().user?.avatar ?? null }),
+ history: usageHistory,
+ quota: readProviderShareQuota,
+ });
setProviderShareAccess({
+ insights,
+ insightsCurrent: insights.isCurrent,
guestAccess: providerShareGuestAccess,
ensureKnown: ensureProviderSharePeerKnown,
hasShares: () => getProviderShareHostSnapshot().length > 0,
diff --git a/apps/desktop/src/main/device-link/providerShareVisibility.ts b/apps/desktop/src/main/device-link/providerShareVisibility.ts
new file mode 100644
index 0000000000..b732870de3
--- /dev/null
+++ b/apps/desktop/src/main/device-link/providerShareVisibility.ts
@@ -0,0 +1,96 @@
+import { throwIpcError } from '../utils/ipcValidate.js';
+import { activeOwnerScopeKey, ownerScopedUserDataPath } from '../appSessionState.js';
+import { createLogger } from '../logger.js';
+import { createOverrideSettingsFile } from '../maker-host/override-settings-file.js';
+import { captureProviderManagementScope } from '../provider-group/managementScope.js';
+import type { ProviderShareVisibility } from '../../shared/providerShareInsights.js';
+
+interface VisibilitySettings {
+ providers: Record<string, Partial<ProviderShareVisibility> & { revision: number }>;
+}
+
+export function createProviderShareVisibilityStore(options: {
+ filePath(): string;
+ scopeKey(): string;
+}) {
+ const store = createOverrideSettingsFile<VisibilitySettings>({
+ ...options,
+ defaults: () => ({ providers: {} }),
+ normalize(raw) {
+ const providers = (raw as Partial<VisibilitySettings> | null)?.providers;
+ return {
+ providers: Object.fromEntries(
+ Object.entries(
+ providers && typeof providers === 'object' && !Array.isArray(providers)
+ ? providers
+ : {},
+ )
+ .filter(([id, value]) => id.length > 0 && value && typeof value === 'object')
+ .map(([id, value]) => [
+ id,
+ {
+ ...(value.quota === true ? { quota: true } : {}),
+ ...(value.usage === true ? { usage: true } : {}),
+ revision: Number.isSafeInteger(value.revision) ? value.revision : 0,
+ },
+ ]),
+ ),
+ };
+ },
+ log: createLogger('provider-share:visibility'),
+ label: 'provider-share-visibility',
+ maxBytes: 1024 * 1024,
+ preserveUnreadableFile: true,
+ logLoadedValue: false,
+ logReadErrorDetails: false,
+ });
+ return {
+ read(providerId: string): ProviderShareVisibility & { revision: number } {
+ store.invalidateIfChanged();
+ const value = store.read().providers[providerId];
+ return {
+ quota: value?.quota === true,
+ usage: value?.usage === true,
+ revision: value?.revision ?? 0,
+ };
+ },
+ async set(
+ providerId: string,
+ patch: Partial<ProviderShareVisibility>,
+ assertCurrent: () => void,
+ ) {
+ assertCurrent();
+ try {
+ await store.updateAtomic(({ value }) => {
+ assertCurrent();
+ const previous = value.providers[providerId];
+ const quota = patch.quota ?? previous?.quota ?? false;
+ const usage = patch.usage ?? previous?.usage ?? false;
+ return {
+ providers: {
+ ...value.providers,
+ [providerId]: {
+ ...(quota ? { quota: true } : {}),
+ ...(usage ? { usage: true } : {}),
+ revision: (previous?.revision ?? 0) + 1,
+ },
+ },
+ };
+ });
+ } catch {
+ assertCurrent();
+ throwIpcError('PRECONDITION_FAILED', 'Could not save provider share visibility');
+ }
+ assertCurrent();
+ return this.read(providerId);
+ },
+ };
+}
+
+export const providerShareVisibility = createProviderShareVisibilityStore({
+ filePath: () => ownerScopedUserDataPath('provider-share-visibility.json'),
+ scopeKey: () => {
+ captureProviderManagementScope();
+ return activeOwnerScopeKey();
+ },
+});
diff --git a/apps/desktop/src/main/provider-group/management.ts b/apps/desktop/src/main/provider-group/management.ts
index b53ab1f797..46f7781119 100644
--- a/apps/desktop/src/main/provider-group/management.ts
+++ b/apps/desktop/src/main/provider-group/management.ts
@@ -20,7 +20,7 @@ export function parseProviderManagementRequest(raw: unknown): ProviderManagement
return { action: 'manage-group', command: command as ProviderGroupManagementCommand };
}
const command = parseProviderShareCommand(raw.command);
- if (!['owned', 'own-usage', 'usage-history', 'create-link', 'approve', 'reject', 'set-member', 'set-member-note', 'reshare-decide', 'get-run-limits', 'set-run-limits', 'reset-run-limits'].includes(command.action)) {
+ if (!['owned', 'own-usage', 'usage-history', 'create-link', 'approve', 'reject', 'set-member', 'set-member-note', 'reshare-decide', 'get-run-limits', 'set-run-limits', 'reset-run-limits', 'get-visibility', 'set-visibility', 'quota-account'].includes(command.action)) {
throwIpcError('PERMISSION_DENIED', 'Only owner operations are available through management');
}
return { action: 'manage-share', command: command as ProviderShareManagementCommand };
diff --git a/apps/desktop/src/renderer/features/billing/BillingPage.tsx b/apps/desktop/src/renderer/features/billing/BillingPage.tsx
index fe508b0a57..abf9539ccf 100644
--- a/apps/desktop/src/renderer/features/billing/BillingPage.tsx
+++ b/apps/desktop/src/renderer/features/billing/BillingPage.tsx
@@ -48,6 +48,7 @@ import type {
ModelAccessCreditUsage,
ModelAccessPromotionalGrantState,
} from '../../../shared/modelAccess';
+import { CreditPoolRowView } from './CreditPoolRowView';
import { PlanComparison } from './PlanComparison';
import { AlipayIcon } from './AlipayIcon';
import { billingApi } from './api';
@@ -1732,31 +1733,12 @@ function CreditPoolRow({
? t('billing.usage.noPlanCredits')
: t('billing.usage.historyUnavailable');
return (
- <div className="grid grid-cols-[minmax(0,1fr)_minmax(160px,30%)] items-baseline gap-x-6 gap-y-1 px-5 py-3.5">
- <p className="min-w-0 text-13 font-medium text-[var(--text-primary)]">{label}</p>
- <p className="flex items-baseline justify-end gap-1.5 whitespace-nowrap text-11 text-[var(--text-tertiary)]">
- {t('billing.usage.remaining')}
- <span className="text-13 font-medium tabular-nums text-[var(--text-primary)]">
- {formatMoney(pool.remaining, BILLING_CURRENCY, billingLocale)}
- </span>
- </p>
- <p className="min-w-0 text-11 leading-4 text-[var(--text-tertiary)]">{detail}</p>
- <div
- className="h-1 w-full self-center overflow-hidden rounded-full bg-[var(--surface-chip)]"
- role={percent === null ? undefined : 'progressbar'}
- aria-label={t('billing.usage.progressLabel', { label })}
- aria-valuemin={percent === null ? undefined : 0}
- aria-valuemax={percent === null ? undefined : 100}
- aria-valuenow={percent ?? undefined}
- >
- {percent !== null && (
- <div
- className="ml-auto h-full rounded-full bg-[var(--text-primary)]"
- style={{ width: `${percent}%` }}
- />
- )}
- </div>
- </div>
+ <CreditPoolRowView
+ label={label}
+ remaining={formatMoney(pool.remaining, BILLING_CURRENCY, billingLocale)}
+ detail={detail}
+ percent={percent}
+ />
);
}
diff --git a/apps/desktop/src/renderer/features/billing/CreditPoolRowView.tsx b/apps/desktop/src/renderer/features/billing/CreditPoolRowView.tsx
new file mode 100644
index 0000000000..9519c19913
--- /dev/null
+++ b/apps/desktop/src/renderer/features/billing/CreditPoolRowView.tsx
@@ -0,0 +1,43 @@
+import { useTranslation } from 'react-i18next';
+
+/** 计费页和分享详情共用的只读余额行;未知总额不显示百分比。 */
+export function CreditPoolRowView({
+ label,
+ remaining,
+ detail,
+ percent,
+}: {
+ label: string;
+ remaining: string;
+ detail: string;
+ percent: number | null;
+}) {
+ const { t } = useTranslation();
+ return (
+ <div className="grid grid-cols-[minmax(0,1fr)_minmax(160px,30%)] items-baseline gap-x-6 gap-y-1 px-5 py-3.5">
+ <p className="min-w-0 text-13 font-medium text-[var(--text-primary)]">{label}</p>
+ <p className="flex items-baseline justify-end gap-1.5 whitespace-nowrap text-11 text-[var(--text-tertiary)]">
+ {t('billing.usage.remaining')}
+ <span className="text-13 font-medium tabular-nums text-[var(--text-primary)]">
+ {remaining}
+ </span>
+ </p>
+ <p className="min-w-0 text-11 leading-4 text-[var(--text-tertiary)]">{detail}</p>
+ <div
+ className="h-1 w-full self-center overflow-hidden rounded-full bg-[var(--surface-chip)]"
+ role={percent === null ? undefined : 'progressbar'}
+ aria-label={t('billing.usage.progressLabel', { label })}
+ aria-valuemin={percent === null ? undefined : 0}
+ aria-valuemax={percent === null ? undefined : 100}
+ aria-valuenow={percent ?? undefined}
+ >
+ {percent !== null && (
+ <div
+ className="ml-auto h-full rounded-full bg-[var(--text-primary)]"
+ style={{ width: `${percent}%` }}
+ />
+ )}
+ </div>
+ </div>
+ );
+}
diff --git a/apps/desktop/src/renderer/features/provider-share/ProviderShareInsightsSection.tsx b/apps/desktop/src/renderer/features/provider-share/ProviderShareInsightsSection.tsx
new file mode 100644
index 0000000000..f41002d480
--- /dev/null
+++ b/apps/desktop/src/renderer/features/provider-share/ProviderShareInsightsSection.tsx
@@ -0,0 +1,355 @@
+import { ChevronRight } from 'lucide-react';
+import { Collapse } from '@/components/ui/collapse';
+import { QuotaHoverCard } from '@/components/status/QuotaHoverCard';
+import { CreditPoolRowView } from '@/features/billing/CreditPoolRowView';
+import { formatBillingAmount } from '@/features/billing/money';
+import { useEffect, useId, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import type { ProviderShareReceived } from '@cindy/device-link';
+import { useOptionalAuthUser } from '@/contexts/AuthContext';
+import {
+ getDataOwnerGeneration,
+ isDataOwnerGenerationCurrent,
+} from '@/contexts/dataOwnerGeneration';
+import { extractIpcError } from '@/utils/ipcError';
+import type {
+ ProviderShareInsights,
+ ProviderShareQuotaAccount,
+ ProviderShareUsageDetails,
+} from '../../../shared/providerShareInsights';
+import { quotaWindowLabel } from '@/components/status/usageCardModel';
+import { ProviderUsageSection } from './ProviderUsageSection';
+import { useShareTimeFormat } from './useShareTimeFormat';
+
+/** 可见页面每五秒复核权限;不持久化数据,身份变化、失败与隐藏都丢弃旧结果。 */
+export function ProviderShareInsightsSection({ share }: { share: ProviderShareReceived }) {
+ const { t, i18n } = useTranslation();
+ useOptionalAuthUser();
+ const owner = getDataOwnerGeneration();
+ const identity = JSON.stringify([
+ share.shareId,
+ share.memberId,
+ share.status,
+ share.hostOnline,
+ share.hostCapable,
+ ]);
+ const [result, setResult] = useState<{
+ identity: string;
+ owner: typeof owner;
+ view: ProviderShareInsights | null;
+ error: string | null;
+ } | null>(null);
+ const available = share.status === 'active' && share.hostOnline && share.hostCapable;
+ useEffect(() => {
+ let alive = true;
+ let generation = 0;
+ let reading = false;
+ let valid = available;
+ const clear = (error: string | null) => setResult({ identity, owner, view: null, error });
+ clear(null);
+ const load = async () => {
+ if (!alive || !valid || reading || document.visibilityState === 'hidden') return;
+ reading = true;
+ const current = ++generation;
+ try {
+ const view = await window.electronAPI.providerShare.command({
+ action: 'insights',
+ shareId: share.shareId,
+ });
+ if (alive && current === generation && isDataOwnerGenerationCurrent(owner))
+ setResult({ identity, owner, view, error: null });
+ } catch (reason) {
+ if (!alive || current !== generation || !isDataOwnerGenerationCurrent(owner)) return;
+ const code = extractIpcError(reason)?.code;
+ clear(
+ code === 'UNSUPPORTED_CAPABILITY'
+ ? 'needs-update'
+ : code === 'PERMISSION_DENIED' || code === 'REMOTE_AGENT_SHARE_UNAVAILABLE'
+ ? 'denied'
+ : code === 'DEVICE_LINK_DEVICE_OFFLINE' || code === 'DEVICE_LINK_NOT_CONNECTED'
+ ? 'offline'
+ : 'unavailable',
+ );
+ } finally {
+ reading = false;
+ }
+ };
+ void load();
+ const off = window.electronAPI.providerShare.onReceivedChanged((shares) => {
+ const latest = shares.find((item) => item.shareId === share.shareId);
+ const next =
+ latest &&
+ JSON.stringify([
+ latest.shareId,
+ latest.memberId,
+ latest.status,
+ latest.hostOnline,
+ latest.hostCapable,
+ ]);
+ if (next !== identity) {
+ valid = false;
+ generation++;
+ clear('denied');
+ } else if (!valid) {
+ valid = available;
+ void load();
+ }
+ });
+ const visibility = () => {
+ generation++;
+ clear(null);
+ if (document.visibilityState !== 'hidden') void load();
+ };
+ document.addEventListener('visibilitychange', visibility);
+ const timer = window.setInterval(() => {
+ void load();
+ }, 5_000);
+ return () => {
+ alive = false;
+ generation++;
+ off();
+ window.clearInterval(timer);
+ document.removeEventListener('visibilitychange', visibility);
+ };
+ }, [available, identity, owner, share.shareId]);
+ const current =
+ result?.identity === identity && isDataOwnerGenerationCurrent(result.owner) ? result : null;
+ const view = available ? current?.view : null;
+ const error = !available
+ ? !share.hostOnline
+ ? 'offline'
+ : !share.hostCapable
+ ? 'needs-update'
+ : 'denied'
+ : current?.error;
+ const stamp = (value: number) =>
+ new Intl.DateTimeFormat(i18n.language, { dateStyle: 'medium', timeStyle: 'short' }).format(
+ value,
+ );
+ return (
+ <section
+ className="shrink-0 border-t border-[var(--border-default)] px-5 py-4"
+ data-testid="provider-share-insights"
+ >
+ <h3 className="text-13 font-medium leading-[1.5] text-[var(--text-primary)]">
+ {t('providerShare.insights.quotaTitle')}
+ </h3>
+ <p className="mt-1 text-12 leading-[1.5] text-[var(--text-secondary)]">
+ {t('providerShare.insights.quotaNote')}
+ </p>
+ {error ? (
+ <p role="status" className="mt-3 text-12 text-[var(--text-secondary)]">
+ {t(`providerShare.insights.${error}`)}
+ </p>
+ ) : view ? (
+ <>
+ {view.status.quota !== 'ready' || !view.quota ? (
+ <p className="mt-3 text-12 text-[var(--text-secondary)]">
+ {t(`providerShare.insights.${view.capabilities.quota ? 'unavailable' : 'notShared'}`)}
+ </p>
+ ) : (
+ <div className="mt-3 space-y-3">
+ {view.quota.group && (
+ <p className="text-12 leading-[1.5] text-[var(--text-secondary)]">
+ {t('providerShare.insights.groupNote')}
+ </p>
+ )}
+ {view.quota.accounts.map((account, index) => (
+ <QuotaAccount
+ key={index}
+ account={account}
+ title={
+ view.quota!.group
+ ? t('providerShare.insights.account', { number: index + 1 })
+ : null
+ }
+ stamp={stamp}
+ />
+ ))}
+ {view.quota.accounts.length === 0 && (
+ <p className="text-12 text-[var(--text-secondary)]">
+ {t('providerShare.insights.noOwnAccounts')}
+ </p>
+ )}
+ </div>
+ )}
+ {view.capabilities.usage && view.status.usage === 'ready' && view.usage ? (
+ <SharedUsageDetails
+ key={JSON.stringify([share.shareId, share.memberId, owner])}
+ providerId={share.providerId}
+ usage={view.usage}
+ />
+ ) : (
+ <p className="mt-6 text-12 leading-[1.5] text-[var(--text-secondary)]">
+ {t(
+ view.capabilities.usage
+ ? 'providerShare.insights.usageUnavailable'
+ : 'providerShare.insights.usageNotShared',
+ )}
+ </p>
+ )}
+ </>
+ ) : null}
+ </section>
+ );
+}
+
+function SharedUsageDetails({
+ providerId,
+ usage,
+}: {
+ providerId: string;
+ usage: ProviderShareUsageDetails;
+}) {
+ const { t } = useTranslation();
+ const time = useShareTimeFormat();
+ const [expanded, setExpanded] = useState(false);
+ const id = useId();
+ return (
+ <div className="mt-4 border-t border-[var(--border-default)] pt-2">
+ <button
+ type="button"
+ id={`${id}-trigger`}
+ aria-expanded={expanded}
+ aria-controls={`${id}-content`}
+ onClick={() => setExpanded((value) => !value)}
+ className="flex min-h-9 w-full items-center gap-1.5 text-left text-13 font-medium text-[var(--text-primary)] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-[var(--focus-ring)]"
+ >
+ <ChevronRight
+ className={`h-3.5 w-3.5 shrink-0 ${expanded ? 'rotate-90' : ''}`}
+ aria-hidden="true"
+ />
+ {t('providerShare.insights.usageTitle')}
+ </button>
+ <Collapse
+ open={expanded}
+ id={`${id}-content`}
+ role="region"
+ aria-labelledby={`${id}-trigger`}
+ >
+ <p className="mt-2 text-12 leading-[1.5] text-[var(--text-secondary)]">
+ {t('providerShare.insights.usageNote')}
+ </p>
+ {usage.parties.some((party) => party.isRelay) && (
+ <p className="mt-1 text-12 leading-[1.5] text-[var(--text-secondary)]">
+ {t('providerShare.insights.relayNote')}
+ </p>
+ )}
+ <ProviderUsageSection
+ providerId={providerId}
+ sharedUsage={usage}
+ history={null}
+ status="ready"
+ legacyOwn={null}
+ members={[]}
+ selfDeviceName={null}
+ groupConfig={null}
+ time={time}
+ />
+ </Collapse>
+ </div>
+ );
+}
+
+function QuotaAccount({
+ account,
+ title,
+ stamp,
+}: {
+ account: ProviderShareQuotaAccount;
+ title: string | null;
+ stamp(value: number): string;
+}) {
+ const { t, i18n } = useTranslation();
+ const money = (value: number, currency: string) =>
+ formatBillingAmount(String(value), currency, i18n.resolvedLanguage ?? i18n.language);
+ const balance = account.balance;
+ const balanceRow = (label: string, remaining: number, total: number | null) => {
+ const percent =
+ total === null || total < 0 || remaining < 0
+ ? null
+ : total === 0
+ ? remaining === 0
+ ? 0
+ : null
+ : Math.min(100, (remaining / total) * 100);
+ return (
+ <CreditPoolRowView
+ key={label}
+ label={label}
+ remaining={money(remaining, balance!.currency)}
+ percent={percent}
+ detail={
+ total === null
+ ? t('billing.usage.historyUnavailable')
+ : t('billing.usage.poolDetail', {
+ used: money(Math.max(0, total - remaining), balance!.currency),
+ total: money(total, balance!.currency),
+ })
+ }
+ />
+ );
+ };
+ return (
+ <div className="overflow-hidden rounded-xl border border-[var(--settings-theme-card-border)] bg-[var(--settings-theme-card-bg)]">
+ {title && (
+ <h4 className="px-5 pt-3 text-13 font-medium text-[var(--text-primary)]">{title}</h4>
+ )}
+ {account.state !== 'ready' ? (
+ <p className="px-5 py-3 text-12 text-[var(--text-secondary)]">
+ {t(`providerShare.insights.${account.state}`)}
+ </p>
+ ) : (
+ <>
+ {balance && (
+ <>
+ {balance.pools.length > 0 ? (
+ <>
+ <p className="px-5 pt-3 text-20 font-medium leading-[1.3] tracking-[-0.02em] tabular-nums text-[var(--text-primary)]">
+ {money(balance.remaining, balance.currency)}
+ </p>
+ {balance.pools.map((pool) =>
+ balanceRow(t(`billing.balance.${pool.kind}`), pool.remaining, pool.total),
+ )}
+ </>
+ ) : (
+ balanceRow(t('billing.balance.title'), balance.remaining, balance.total)
+ )}
+ {balance.resetsAt !== null && (
+ <p className="px-5 pb-2 text-12 text-[var(--text-secondary)]">
+ {t('providerShare.insights.resets', { time: stamp(balance.resetsAt) })}
+ </p>
+ )}
+ </>
+ )}
+ {account.windows.length > 0 && (
+ <QuotaHoverCard
+ variant="embedded"
+ hideIdentity
+ account={{
+ windows: account.windows.map((window, index) => ({
+ key: String(index),
+ title:
+ window.label ||
+ (window.windowMinutes
+ ? quotaWindowLabel(window.windowMinutes, t)
+ : t(`providerShare.insights.${window.kind}`)),
+ showRemaining: true,
+ window: {
+ utilization: 100 - window.remainingPercent,
+ resetsAt: window.resetsAt === null ? null : window.resetsAt / 1000,
+ },
+ })),
+ }}
+ />
+ )}
+ </>
+ )}
+ {account.updatedAt !== null && (
+ <p className="px-5 pb-3 text-11 leading-[1.5] text-[var(--text-tertiary)]">
+ {t('providerShare.insights.updated', { time: stamp(account.updatedAt) })}
+ </p>
+ )}
+ </div>
+ );
+}
diff --git a/apps/desktop/src/renderer/features/provider-share/ProviderShareManagePage.tsx b/apps/desktop/src/renderer/features/provider-share/ProviderShareManagePage.tsx
index 0ec63ba950..a7f76e14d3 100644
--- a/apps/desktop/src/renderer/features/provider-share/ProviderShareManagePage.tsx
+++ b/apps/desktop/src/renderer/features/provider-share/ProviderShareManagePage.tsx
@@ -1,3 +1,4 @@
+import { ProviderShareVisibilitySection } from './ProviderShareVisibilitySection';
import { RemoteAgentLimitsSection } from './RemoteAgentLimitsSection';
/**
* 「{供应商} · 远程与分享」页(供应商分享 §7.2;供应商组 §10)。从设置 → 模型供应商「允许被远程调用」一行的
@@ -505,6 +506,8 @@ export function ProviderShareManagePage({
initialConfig={initialGroup} remoteProvider={remoteProvider} onConfigChange={setRemoteGroup}
/>
+ <ProviderShareVisibilitySection key={`${deviceId ?? 'local'}:${providerId}`} providerId={providerId} deviceId={deviceId} />
+
<RemoteAgentLimitsSection key={deviceId ?? 'local'} deviceId={deviceId} />
<ProviderUsageSection
diff --git a/apps/desktop/src/renderer/features/provider-share/ProviderShareReceivedRail.tsx b/apps/desktop/src/renderer/features/provider-share/ProviderShareReceivedRail.tsx
index bc11b8fe37..690135d757 100644
--- a/apps/desktop/src/renderer/features/provider-share/ProviderShareReceivedRail.tsx
+++ b/apps/desktop/src/renderer/features/provider-share/ProviderShareReceivedRail.tsx
@@ -1,3 +1,4 @@
+import { ProviderShareInsightsSection } from './ProviderShareInsightsSection';
/**
* 设置 → 模型供应商里「分享给我的」(受邀者)。别人分享给我的供应商与自己的供应商同在左栏,
* 单独成组(没有分享时整组不显示)、用分享者头像标明来自谁;点开后右栏显示状态、「凭证操作不再
@@ -342,6 +343,8 @@ export function ProviderShareReceivedDetail({ share }: { share: ProviderShareRec
<SharedProviderGroupStatus key={catalogDeviceId} deviceId={catalogDeviceId} providerId={share.providerId} initialSize={groupSize} />
)}
+ <ProviderShareInsightsSection key={share.shareId} share={share} />
+
<div className="flex min-h-40 flex-1 flex-col">
<ReadOnlyProviderModelSection
title={t('providerShare.received.modelsTitle')}
diff --git a/apps/desktop/src/renderer/features/provider-share/ProviderShareVisibilitySection.tsx b/apps/desktop/src/renderer/features/provider-share/ProviderShareVisibilitySection.tsx
new file mode 100644
index 0000000000..571ef80f97
--- /dev/null
+++ b/apps/desktop/src/renderer/features/provider-share/ProviderShareVisibilitySection.tsx
@@ -0,0 +1,157 @@
+import { useEffect, useId, useRef, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { Switch } from '@/components/ui/switch';
+import {
+ getDataOwnerGeneration,
+ isDataOwnerGenerationCurrent,
+} from '@/contexts/dataOwnerGeneration';
+import { useOptionalAuthUser } from '@/contexts/AuthContext';
+import { toast } from '@/lib/toast';
+import type { ProviderShareVisibility } from '../../../shared/providerShareInsights';
+import {
+ providerShareManagementCommand,
+ isProviderManagementOutdated,
+} from '../provider-group/providerManagement';
+
+/** 两个权限保存在供应商所在电脑;旧端不支持时不退回控制端保存。 */
+export function ProviderShareVisibilitySection({
+ providerId,
+ deviceId,
+}: {
+ providerId: string;
+ deviceId?: string;
+}) {
+ const { t } = useTranslation();
+ const usageDescriptionId = useId();
+ useOptionalAuthUser();
+ const owner = getDataOwnerGeneration();
+ const [view, setView] = useState<ProviderShareVisibility | null>(null);
+ const viewOwner = useRef(owner);
+ const currentView = isDataOwnerGenerationCurrent(viewOwner.current) ? view : null;
+ const [error, setError] = useState<string | null>(null);
+ const [busy, setBusy] = useState(false);
+ const saving = useRef(false);
+ const sequence = useRef(0);
+ const writes = useRef(0);
+ useEffect(() => {
+ let reading = false;
+ const generation = ++sequence.current;
+ setView(null);
+ const load = async () => {
+ if (reading || saving.current || document.visibilityState === 'hidden') return;
+ reading = true;
+ const write = writes.current;
+ try {
+ const next = await providerShareManagementCommand(
+ { action: 'get-visibility', providerId },
+ deviceId,
+ );
+ if (
+ generation !== sequence.current ||
+ write !== writes.current ||
+ !isDataOwnerGenerationCurrent(owner)
+ )
+ return;
+ viewOwner.current = owner;
+ setView(next);
+ setError(null);
+ } catch (reason) {
+ if (
+ generation !== sequence.current ||
+ write !== writes.current ||
+ !isDataOwnerGenerationCurrent(owner)
+ )
+ return;
+ setView(null);
+ setError(isProviderManagementOutdated(reason) ? 'needs-update' : 'unavailable');
+ } finally {
+ reading = false;
+ }
+ };
+ void load();
+ const off = window.electronAPI.providerShare.onOwnedChanged(() => {
+ void load();
+ });
+ const timer = window.setInterval(() => {
+ void load();
+ }, 5_000);
+ return () => {
+ sequence.current++;
+ off();
+ window.clearInterval(timer);
+ };
+ }, [providerId, deviceId, owner]);
+
+ const save = async (key: keyof ProviderShareVisibility, value: boolean) => {
+ if (saving.current || !currentView) return;
+ saving.current = true;
+ writes.current++;
+ setBusy(true);
+ const generation = sequence.current;
+ try {
+ const next = await providerShareManagementCommand(
+ { action: 'set-visibility', providerId, visibility: { [key]: value } },
+ deviceId,
+ );
+ if (generation === sequence.current && isDataOwnerGenerationCurrent(owner)) {
+ viewOwner.current = owner;
+ setView(next);
+ setError(null);
+ }
+ } catch (reason) {
+ if (generation === sequence.current && isDataOwnerGenerationCurrent(owner)) {
+ toast.error(
+ t(
+ isProviderManagementOutdated(reason)
+ ? 'providerShare.insights.needs-update'
+ : 'providerShare.insights.saveFailed',
+ ),
+ );
+ }
+ } finally {
+ saving.current = false;
+ setBusy(false);
+ }
+ };
+ return (
+ <section className="mt-6 shrink-0" data-testid="provider-share-visibility">
+ <h3 className="text-13 font-medium leading-[1.5] text-[var(--settings-section-title)]">
+ {t('providerShare.insights.visibilityTitle')}
+ </h3>
+ <p className="mt-1 text-12 leading-[1.5] text-[var(--text-secondary)]">
+ {t('providerShare.insights.visibilityNote')}
+ </p>
+ <div className="mt-3 divide-y divide-[var(--border-default)] rounded-xl border border-[var(--settings-theme-card-border)] bg-[var(--settings-theme-card-bg)] px-4">
+ {(['quota', 'usage'] as const).map((key) => (
+ <div key={key} className="flex items-center justify-between gap-4 py-3">
+ <div className="min-w-0 flex-1">
+ <p className="text-13 leading-[1.5] text-[var(--text-primary)]">
+ {t(`providerShare.insights.allow${key === 'quota' ? 'Quota' : 'Usage'}`)}
+ </p>
+ {key === 'usage' && (
+ <p
+ id={usageDescriptionId}
+ className="mt-1 text-12 leading-[1.5] text-[var(--text-secondary)]"
+ >
+ {t('providerShare.insights.allowUsageDescription')}
+ </p>
+ )}
+ </div>
+ <Switch
+ aria-describedby={key === 'usage' ? usageDescriptionId : undefined}
+ checked={currentView?.[key] === true}
+ disabled={!currentView || busy}
+ aria-label={t(`providerShare.insights.allow${key === 'quota' ? 'Quota' : 'Usage'}`)}
+ onCheckedChange={(value) => void save(key, value)}
+ />
+ </div>
+ ))}
+ </div>
+ {error && (
+ <p role="status" className="mt-2 text-12 leading-[1.5] text-[var(--text-secondary)]">
+ {t(`providerShare.insights.${error}`)}
+ </p>
+ )}
+ </section>
+ );
+}
diff --git a/apps/desktop/src/renderer/features/provider-share/ProviderUsageSection.tsx b/apps/desktop/src/renderer/features/provider-share/ProviderUsageSection.tsx
index 0ef473dbc8..f34f6c5bba 100644
--- a/apps/desktop/src/renderer/features/provider-share/ProviderUsageSection.tsx
+++ b/apps/desktop/src/renderer/features/provider-share/ProviderUsageSection.tsx
@@ -1,3 +1,4 @@
+import type { ProviderShareUsageDetails } from '../../../shared/providerShareInsights';
import { ErrorNotice } from '@/components/ui/error-notice';
/**
* 「远程与分享」页的「用量」块(供应商组 §7、§10):与设置 → 用量同一套版式(2026-10-17 用户确认原型)——
@@ -101,6 +102,7 @@ interface ComputerLabel {
export function ProviderUsageSection({
providerId,
+ sharedUsage,
history,
status,
legacyOwn,
@@ -112,13 +114,14 @@ export function ProviderUsageSection({
time,
}: {
providerId: string;
+ sharedUsage?: ProviderShareUsageDetails;
/** 按天明细;还没读到、读失败或旧版本时为 null。 */
history: ProviderUsageHistoryView | null;
status: ProviderUsageStatus;
/** 旧版本电脑:你自己所有时间的合计(own-usage)。 */
legacyOwn: ProviderOwnUsageView | null;
members: readonly ProviderShareMemberView[];
- memberActions: ProviderShareMemberActions;
+ memberActions?: ProviderShareMemberActions;
selfDeviceName: string | null;
ownerDeviceId?: string;
/** 远程管理时由页面传入建组电脑上的组;不传时读本机组设置。 */
@@ -153,9 +156,10 @@ export function ProviderUsageSection({
const [stackChoice, setStack] = useState<StackBy>('party');
const stack: StackBy = !group && stackChoice === 'computer' ? 'party' : stackChoice;
const [heatmapWeeks, setHeatmapWeeks] = useState(20);
- const todayKey = history?.todayKey ?? '';
+ const todayKey = sharedUsage?.todayKey ?? history?.todayKey ?? '';
const rows = useMemo<ProviderUsageRow[]>(() => {
+ if (sharedUsage) return sharedUsage.parties.flatMap((party) => party.days.map((day) => ({ ...day, providerId: null, memberKey: null, computer: null, party: party.key })));
if (history) {
// owned 刷新比按日历史快;成员删除后先从旧快照排除,避免总量和页面上的成员行短暂不一致。
const activeMemberIds = new Set(members.map((member) => member.memberId));
@@ -166,9 +170,16 @@ export function ProviderUsageSection({
}
if (legacy) return rowsFromLegacy(legacyOwn, members, aliases);
return [];
- }, [aliases, history, legacy, legacyOwn, members]);
+ }, [aliases, history, legacy, legacyOwn, members, sharedUsage]);
const parties = useMemo<UsageParty[]>(() => {
+ if (sharedUsage) return sharedUsage.parties.map((party) => ({
+ key: party.key,
+ name: party.isRelay ? t('providerShare.insights.relay') : party.displayName,
+ tag: party.isYou ? t('providerShare.insights.you') : party.isOwner ? t('providerShare.insights.owner') : '',
+ person: party.isRelay ? undefined : { displayName: party.displayName, avatarUrl: party.avatarUrl },
+ lastUsedAt: party.lastUsedAt,
+ }));
const selfName = user?.name?.trim() || t('settings.userProfile.local.name');
const legacySelfLast = [legacyOwn?.local, ...(legacyOwn?.devices ?? [])]
.reduce<number | null>((latest, part) => (part ? Math.max(latest ?? 0, part.lastUsedAt) : latest), null);
@@ -207,7 +218,7 @@ export function ProviderUsageSection({
});
}
return list;
- }, [devices, history, legacyOwn, members, t, user?.avatar, user?.name]);
+ }, [devices, history, legacyOwn, members, sharedUsage, t, user?.avatar, user?.name]);
const computerLabel = useCallback(
(key: string | null): ComputerLabel => {
@@ -281,7 +292,7 @@ export function ProviderUsageSection({
...parties.map((item) => ({
value: item.key,
label: item.name,
- detail: item.key === SELF_PARTY
+ detail: sharedUsage ? item.tag : item.key === SELF_PARTY
? t('providerGroup.usage.filter.selfDetail')
: item.member
? item.member.status === 'paused'
@@ -327,7 +338,7 @@ export function ProviderUsageSection({
);
const heatDays = useMemo(() => usageRowsByDay(chartRows).map((day) => ({ ...day, money: ZERO_MONEY })), [chartRows]);
- const charts = Boolean(history) && rows.length > 0;
+ const charts = Boolean(history || sharedUsage) && rows.length > 0;
const stackOptions = [
{ value: 'party' as const, label: t('providerGroup.usage.stack.party') },
...(group ? [{ value: 'computer' as const, label: t('providerGroup.usage.stack.computer') }] : []),
@@ -392,7 +403,7 @@ export function ProviderUsageSection({
</div>
</div>
- {status === 'loading' && !history ? (
+ {status === 'loading' && !history && !sharedUsage ? (
<p role="status" className="-mt-1 mb-3 inline-flex items-center gap-1.5 text-12 text-[var(--text-tertiary)]">
<Spinner icon={RefreshCw} size={11} className="opacity-70" />
{t('providerShare.manage.loading')}
@@ -403,9 +414,9 @@ export function ProviderUsageSection({
<p role="status" className="-mt-1 mb-3 text-12 text-[var(--text-tertiary)]">
{t('providerGroup.usage.legacyNote', { device: selfDeviceName ?? t('providerGroup.usage.unknownDevice') })}
</p>
- ) : history?.coverageStart ? (
+ ) : (sharedUsage ?? history)?.coverageStart ? (
<p className="-mt-1 mb-3 text-12 text-[var(--text-tertiary)]">
- {t('providerGroup.usage.coverage', { date: time.date(Date.parse(`${history.coverageStart}T12:00:00`)) })}
+ {t('providerGroup.usage.coverage', { date: time.date(Date.parse(`${(sharedUsage ?? history)!.coverageStart}T12:00:00`)) })}
</p>
) : null}
@@ -501,7 +512,7 @@ export function ProviderUsageSection({
</div>
</UsageCard>
- {history && rows.length === 0 && (
+ {(history || sharedUsage) && rows.length === 0 && (
<p className="mb-3.5 text-center text-13 text-[var(--text-tertiary)]">{t('usageHistory.empty')}</p>
)}
@@ -609,7 +620,7 @@ function PartyTable({
colorOf: (key: string) => string;
selected: string;
onToggle: (key: string) => void;
- memberActions: ProviderShareMemberActions;
+ memberActions?: ProviderShareMemberActions;
time: ShareTimeFormat;
}) {
const { t } = useTranslation();
@@ -731,7 +742,7 @@ function PartyTable({
{actionColumn && (
// 行尾菜单的点击(含 portal 里的菜单项)不当成「只看这个人」。
<td className={cn(tdClass, 'w-10 pl-1')} onClick={(event) => event.stopPropagation()}>
- {member && (
+ {member && memberActions && (
<ShareMemberMenu
member={member}
disabled={memberActions.busy(member.memberId)}
@@ -743,7 +754,7 @@ function PartyTable({
</td>
)}
</tr>
- {member && hasReshares && (
+ {member && memberActions && hasReshares && (
<tr data-usage-party-extra={party.key}>
{/* 与昵称一列左对齐:色块 8 + gap 10 + 头像 28 + gap 10 = 56px。 */}
<td colSpan={columns} className="border-b border-[var(--border-default)] pb-3 pl-14 pr-3">
diff --git a/apps/desktop/src/renderer/features/provider-share/__tests__/ProviderShareManagePage.test.tsx b/apps/desktop/src/renderer/features/provider-share/__tests__/ProviderShareManagePage.test.tsx
index ec9ab39874..e3fcd6e9c4 100644
--- a/apps/desktop/src/renderer/features/provider-share/__tests__/ProviderShareManagePage.test.tsx
+++ b/apps/desktop/src/renderer/features/provider-share/__tests__/ProviderShareManagePage.test.tsx
@@ -8,6 +8,7 @@ import { toast } from '@/lib/toast';
import type { ProviderGroupConfig } from '../../../../shared/providerGroup';
import type { ProviderOwnUsageView, ProviderShareOwnerState, ProviderUsageHistoryView } from '../../../../shared/providerShare';
import { __testing as localGroupsTesting } from '../../provider-group/useLocalProviderGroups';
+import { ProviderShareVisibilitySection } from '../ProviderShareVisibilitySection';
import { ProviderShareManagePage } from '../ProviderShareManagePage';
import {
getProviderSharePendingRequests,
@@ -196,6 +197,7 @@ beforeEach(() => {
vi.mocked(toast.success).mockClear();
command.mockReset();
command.mockImplementation(async (cmd: { action: string }) => {
+ if (cmd.action === 'get-visibility') return { quota: false, usage: false };
if (cmd.action === 'owned') return owned();
if (cmd.action === 'own-usage') return ownUsage();
if (cmd.action === 'usage-history') return usageHistory();
@@ -224,7 +226,7 @@ beforeEach(() => {
if (action === 'owned') return owned();
if (action === 'own-usage') return ownUsage();
if (action === 'usage-history') return usageHistory();
- if (action === 'get-run-limits') return command(cmd.request?.command);
+ if (action === 'get-run-limits' || action === 'get-visibility') return command(cmd.request?.command);
if (action === 'approve' || action === 'reject') return { ok: true };
}
return { providerId: cmd.providerId, config: null, members: [] };
@@ -852,3 +854,32 @@ describe('ProviderShareManagePage', () => {
expect(screen.getByTestId('provider-share-claude-email-callout')).toBeTruthy();
});
});
+
+/* 可见性保存要到供应商所在电脑;旧读不能覆盖刚写成功的开关。tier: unit。 */
+describe('share visibility switches', () => {
+ it('saves through remote management without changing the control computer', async () => {
+ const remote = vi.spyOn(window.electronAPI.providerGroup, 'command').mockImplementation(async (raw) => {
+ if (raw.action !== 'remote-manage' || raw.request.action !== 'manage-share') throw new Error('unexpected route');
+ return raw.request.command.action === 'set-visibility' ? { quota: true, usage: false } : { quota: false, usage: false };
+ });
+ await act(async () => { render(<ProviderShareVisibilitySection providerId="xd" deviceId="studio" />); });
+ await act(async () => { fireEvent.click(screen.getByRole('switch', { name: 'providerShare.insights.allowQuota' })); });
+ expect(remote).toHaveBeenCalledWith({ action: 'remote-manage', deviceId: 'studio', request: { action: 'manage-share', command: { action: 'set-visibility', providerId: 'xd', visibility: { quota: true } } } });
+ expect(command).not.toHaveBeenCalledWith(expect.objectContaining({ action: 'set-visibility' }));
+ expect(screen.getByRole('switch', { name: 'providerShare.insights.allowQuota' }).getAttribute('aria-checked')).toBe('true');
+ });
+ it('keeps the saved value when an older poll completes afterwards', async () => {
+ vi.useFakeTimers();
+ try {
+ command.mockResolvedValue({ quota: false, usage: false });
+ await act(async () => { render(<ProviderShareVisibilitySection providerId="xd" />); });
+ let finish!: (value: { quota: boolean; usage: boolean }) => void;
+ command.mockImplementation(async (cmd) => cmd.action === 'get-visibility'
+ ? new Promise((resolve) => { finish = resolve; }) : { quota: true, usage: false });
+ await act(async () => { await vi.advanceTimersByTimeAsync(5_000); });
+ await act(async () => { fireEvent.click(screen.getByRole('switch', { name: 'providerShare.insights.allowQuota' })); });
+ await act(async () => { finish({ quota: false, usage: false }); });
+ expect(screen.getByRole('switch', { name: 'providerShare.insights.allowQuota' }).getAttribute('aria-checked')).toBe('true');
+ } finally { vi.useRealTimers(); }
+ });
+});
diff --git a/apps/desktop/src/renderer/features/provider-share/__tests__/ProviderShareReceivedRail.test.tsx b/apps/desktop/src/renderer/features/provider-share/__tests__/ProviderShareReceivedRail.test.tsx
index 0baff316ac..4dc1bf0a97 100644
--- a/apps/desktop/src/renderer/features/provider-share/__tests__/ProviderShareReceivedRail.test.tsx
+++ b/apps/desktop/src/renderer/features/provider-share/__tests__/ProviderShareReceivedRail.test.tsx
@@ -4,6 +4,9 @@ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
import type { ProviderShareReceived } from '@cindy/device-link';
+import { setDataOwnerGeneration } from '@/contexts/dataOwnerGeneration';
+import type { ProviderShareInsights } from '../../../../shared/providerShareInsights';
+import { ProviderShareInsightsSection } from '../ProviderShareInsightsSection';
import { toast } from '@/lib/toast';
import { ProviderSharePasteButton } from '../ProviderSharePasteDialog';
@@ -11,12 +14,14 @@ import { ProviderShareReceivedDetail, ProviderShareReceivedRailGroup } from '../
import { resetProviderShareStoreForTests } from '../providerShareStore';
vi.mock('react-i18next', () => ({
+ initReactI18next: { type: '3rdParty', init: () => undefined },
useTranslation: () => ({
t: (key: string, options?: Record<string, unknown>) =>
options && Object.keys(options).length > 0 ? `${key}:${JSON.stringify(options)}` : key,
i18n: { language: 'en' },
}),
}));
+vi.mock('@/hooks/useReducedMotion', () => ({ useReducedMotion: () => true }));
vi.mock('@/lib/toast', () => ({ toast: { success: vi.fn(), error: vi.fn(), info: vi.fn() } }));
const refreshCatalog = vi.hoisted(() => vi.fn(async () => undefined));
vi.mock('@/lib/remoteCatalogSnapshot', () => ({ refreshRemoteCatalogSnapshot: refreshCatalog }));
@@ -35,6 +40,9 @@ vi.mock('@/hooks/useDeviceProviders', () => ({
},
}));
+vi.mock('@/features/device-link/useDeviceLinkDeviceList', () => ({ useDeviceLinkDeviceList: () => [] }));
+vi.mock('@/features/provider-group/useLocalProviderGroups', () => ({ useLocalProviderGroups: () => ({}) }));
+
const share: ProviderShareReceived = {
shareId: 'share-1',
memberId: 'mem-1',
@@ -72,7 +80,7 @@ beforeEach(() => {
});
});
-afterEach(() => cleanup());
+afterEach(() => { cleanup(); vi.useRealTimers(); });
describe('ProviderSharePasteButton', () => {
it('hands an entered link to the apply dialog', async () => {
@@ -166,7 +174,7 @@ describe('ProviderShareReceivedDetail', () => {
expect(confirmSpy).toHaveBeenCalledWith(expect.objectContaining({ confirmVariant: 'destructive' }));
});
- it('lists the shared models the owner left visible', () => {
+ it('lists the shared models the owner left visible', async () => {
catalog.value = {
providers: [{
id: 'xd', name: 'Cindy AI', agents: ['claude-code', 'codex'], connected: true, routing: {},
@@ -180,30 +188,30 @@ describe('ProviderShareReceivedDetail', () => {
error: null,
unsupported: false,
} as typeof catalog.value;
- render(<ProviderShareReceivedDetail share={{ ...share, status: 'active' }} />);
+ await act(async () => { render(<ProviderShareReceivedDetail share={{ ...share, status: 'active' }} />); });
expect(catalogDeviceIds).toContain('share:share-1');
const list = screen.getByTestId('provider-share-received-models');
expect(Array.from(list.querySelectorAll('li')).map((item) => item.textContent)).toEqual(['Opus 5.5', 'GPT-5.5']);
expect(screen.getByRole('button', { name: 'settings.providers.models.refreshBuiltinAria' })).toBeTruthy();
});
- it('says why the models cannot be read and offers a reload', () => {
+ it('says why the models cannot be read and offers a reload', async () => {
catalog.value = {
providers: [], loading: false, error: '[DEVICE_LINK_TIMEOUT] timed out', unsupported: false,
};
- render(<ProviderShareReceivedDetail share={{ ...share, status: 'active' }} />);
+ await act(async () => { render(<ProviderShareReceivedDetail share={{ ...share, status: 'active' }} />); });
expect(screen.getByText('providerShare.received.modelsFailedWithCode:{"code":"DEVICE_LINK_TIMEOUT"}')).toBeTruthy();
expect(screen.getByRole('button', { name: 'settings.providers.models.refreshBuiltinAria' })).toBeTruthy();
fireEvent.click(screen.getByRole('button', { name: 'providerShare.received.retryModels' }));
expect(refreshCatalog).toHaveBeenCalledWith('share:share-1');
});
- it('tells a refusal by the owner computer apart from a failed read', () => {
+ it('tells a refusal by the owner computer apart from a failed read', async () => {
catalog.value = {
providers: [], loading: false,
error: 'Error invoking remote method: Error: [REMOTE_AGENT_SHARE_UNAVAILABLE] not available', unsupported: false,
};
- render(<ProviderShareReceivedDetail share={{ ...share, status: 'active' }} />);
+ await act(async () => { render(<ProviderShareReceivedDetail share={{ ...share, status: 'active' }} />); });
expect(screen.getByText('providerShare.received.modelsRefused')).toBeTruthy();
});
@@ -350,3 +358,137 @@ describe('ProviderShareReceivedDetail', () => {
expect(toggle.getAttribute('aria-checked')).toBe('false');
});
});
+
+/* 真实详情组件验证两开关组合及轮询/身份切换时清空;不覆盖已有模型目录测试。tier: unit。 */
+const insights = (quota = true, usage = true): ProviderShareInsights => ({
+ version: 1, capabilities: { quota, usage }, status: { quota: quota ? 'ready' : 'disabled', usage: usage ? 'ready' : 'disabled' },
+ quota: quota ? { group: false, partial: false, accounts: [{ state: 'ready', updatedAt: null, windows: [], balance: { remaining: 12.34, total: null, currency: 'USD', resetsAt: null, pools: [] } }] } : null,
+ usage: usage ? { todayKey: '2026-10-19', coverageStart: null, parties: [{ key: 'owner', displayName: 'Shared Owner', avatarUrl: null, isYou: false, isOwner: true, isRelay: false, lastUsedAt: null, days: [] }] } : null,
+});
+describe('shared read-only insights', () => {
+ it.each([[false, false], [true, false], [false, true], [true, true]])('renders independent quota=%s usage=%s permissions', async (quota, usage) => {
+ const original = command.getMockImplementation()!;
+ command.mockImplementation((cmd) => cmd.action === 'insights' ? Promise.resolve(insights(quota, usage)) : original(cmd));
+ await act(async () => { render(<ProviderShareReceivedDetail share={{ ...share, status: 'active' }} />); });
+ expect(Boolean(screen.queryByText('$12.34'))).toBe(quota);
+ expect(screen.queryByText('Shared Owner')).toBeNull();
+ if (usage) fireEvent.click(screen.getByRole('button', { name: 'providerShare.insights.usageTitle' }));
+ expect(Boolean(screen.queryByText('Shared Owner'))).toBe(usage);
+ expect(screen.queryByText('providerGroup.usage.stack.computer')).toBeNull();
+ expect(screen.queryByTestId('share-member-menu')).toBeNull();
+ });
+ it('clears the previous display when polling observes closed permissions', async () => {
+ vi.useFakeTimers();
+ command.mockImplementation(async (cmd) => cmd.action === 'insights' ? insights() : []);
+ await act(async () => { render(<ProviderShareInsightsSection share={{ ...share, status: 'active' }} />); });
+ expect(screen.getByText('$12.34')).toBeTruthy();
+ fireEvent.click(screen.getByRole('button', { name: 'providerShare.insights.usageTitle' }));
+ expect(screen.getByText('Shared Owner')).toBeTruthy();
+ command.mockImplementation(async (cmd) => cmd.action === 'insights' ? insights(false, false) : []);
+ await act(async () => { await vi.advanceTimersByTimeAsync(5_000); });
+ expect(screen.queryByText('$12.34')).toBeNull(); expect(screen.queryByText('Shared Owner')).toBeNull();
+ });
+ // 默认收起不挡模型;轮询不改变用户选择,切换身份不能继承展开状态。tier: unit。
+ it('keeps usage collapsed by default and preserves explicit toggles across polling', async () => {
+ vi.useFakeTimers();
+ command.mockImplementation(async (cmd) => cmd.action === 'insights' ? insights() : []);
+ await act(async () => { render(<ProviderShareInsightsSection share={{ ...share, status: 'active' }} />); });
+ const toggle = screen.getByRole('button', { name: 'providerShare.insights.usageTitle' });
+ expect(toggle.getAttribute('aria-expanded')).toBe('false');
+ expect(screen.queryByText('Shared Owner')).toBeNull();
+ expect(screen.getByText('$12.34')).toBeTruthy();
+ await act(async () => { await vi.advanceTimersByTimeAsync(5_000); });
+ expect(toggle.getAttribute('aria-expanded')).toBe('false');
+ fireEvent.click(toggle);
+ expect(toggle.getAttribute('aria-expanded')).toBe('true');
+ expect(screen.getByText('Shared Owner')).toBeTruthy();
+ await act(async () => { await vi.advanceTimersByTimeAsync(5_000); });
+ expect(toggle.getAttribute('aria-expanded')).toBe('true');
+ fireEvent.click(toggle);
+ expect(toggle.getAttribute('aria-expanded')).toBe('false');
+ expect(screen.queryByText('Shared Owner')).toBeNull();
+ expect(screen.getByText('$12.34')).toBeTruthy();
+ });
+ it.each(['share', 'account'])('resets expanded usage after %s changes', async (change) => {
+ command.mockImplementation(async (cmd) => cmd.action === 'insights' ? insights() : []);
+ let view!: ReturnType<typeof render>;
+ await act(async () => { view = render(<ProviderShareInsightsSection share={{ ...share, status: 'active' }} />); });
+ fireEvent.click(screen.getByRole('button', { name: 'providerShare.insights.usageTitle' }));
+ expect(screen.getByText('Shared Owner')).toBeTruthy();
+ await act(async () => {
+ if (change === 'account') setDataOwnerGeneration('new-owner');
+ view.rerender(<ProviderShareInsightsSection share={{ ...share, status: 'active', shareId: change === 'share' ? 'new-share' : share.shareId }} />);
+ });
+ expect(screen.getByRole('button', { name: 'providerShare.insights.usageTitle' }).getAttribute('aria-expanded')).toBe('false');
+ expect(screen.queryByText('Shared Owner')).toBeNull();
+ setDataOwnerGeneration(null);
+ });
+ // 额度真实 0 与未知总额区分;订阅复用同一剩余比例展示。tier: unit。
+ it.each([
+ { remaining: 25, total: 100, expected: '25' },
+ { remaining: 0, total: 0, expected: '0' },
+ { remaining: 25, total: null, expected: null },
+ ])('renders known balance progress without inventing unknown totals: %j', async ({ remaining, total, expected }) => {
+ const data = insights(true, false);
+ data.quota!.accounts[0].balance = { remaining, total, currency: 'USD', resetsAt: null, pools: [] };
+ command.mockResolvedValue(data);
+ await act(async () => { render(<ProviderShareInsightsSection share={{ ...share, status: 'active' }} />); });
+ expect(screen.queryByRole('progressbar')?.getAttribute('aria-valuenow') ?? null).toBe(expected);
+ });
+ it('uses remaining subscription progress without reset or management actions', async () => {
+ const data = insights(true, false);
+ data.quota!.accounts[0].balance = null;
+ data.quota!.accounts[0].windows = [{ kind: 'week', label: null, windowMinutes: 10080, remainingPercent: 72, resetsAt: Date.now() + 86_400_000 }];
+ command.mockResolvedValue(data);
+ await act(async () => { render(<ProviderShareInsightsSection share={{ ...share, status: 'active' }} />); });
+ expect(screen.getByRole('progressbar').getAttribute('aria-valuenow')).toBe('72');
+ expect(screen.queryByRole('button')).toBeNull();
+ expect(screen.getByText('quotaCard.remainingPercent:{"percent":72}')).toBeTruthy();
+ });
+ // 新只读通道的旧版/离线错误必须清旧数据并显示原因,不能看起来仍有额度。tier: unit。
+ it.each([
+ ['UNSUPPORTED_CAPABILITY', 'needs-update'],
+ ['DEVICE_LINK_DEVICE_OFFLINE', 'offline'],
+ ])('clears the previous display when polling returns %s', async (code, message) => {
+ vi.useFakeTimers();
+ command.mockImplementation(async (cmd) => cmd.action === 'insights' ? insights() : []);
+ await act(async () => { render(<ProviderShareInsightsSection share={{ ...share, status: 'active' }} />); });
+ fireEvent.click(screen.getByRole('button', { name: 'providerShare.insights.usageTitle' }));
+ expect(screen.getByText('Shared Owner')).toBeTruthy();
+ command.mockRejectedValue(new Error(`[${code}] unavailable`));
+ await act(async () => { await vi.advanceTimersByTimeAsync(5_000); });
+ expect(screen.getByRole('status').textContent).toBe(`providerShare.insights.${message}`);
+ expect(screen.queryByText('$12.34')).toBeNull();
+ expect(screen.queryByText('Shared Owner')).toBeNull();
+ });
+ it('resumes fresh reads after batched pause/resume events without accepting the old response', async () => {
+ vi.useFakeTimers();
+ let finish!: (value: ProviderShareInsights) => void;
+ command.mockImplementationOnce(() => new Promise((resolve) => { finish = resolve; }));
+ let listener!: (value: ProviderShareReceived[]) => void;
+ window.electronAPI.providerShare.onReceivedChanged = (next) => { listener = next; return () => {}; };
+ await act(async () => { render(<ProviderShareInsightsSection share={{ ...share, status: 'active' }} />); });
+ await act(async () => { listener([{ ...share, status: 'paused' }]); listener([{ ...share, status: 'active' }]); finish(insights()); });
+ expect(screen.queryByText('$12.34')).toBeNull();
+ command.mockImplementation(async (cmd) => cmd.action === 'insights' ? insights() : []);
+ await act(async () => { await vi.advanceTimersByTimeAsync(5_000); });
+ expect(screen.getByText('$12.34')).toBeTruthy();
+ });
+ it.each(['share', 'account', 'removed'])('discards in-flight results after %s changes', async (change) => {
+ let resolve!: (value: ProviderShareInsights) => void;
+ command.mockImplementation(() => new Promise<ProviderShareInsights>((done) => { resolve = done; }));
+ let receivedListener!: (value: ProviderShareReceived[]) => void;
+ window.electronAPI.providerShare.onReceivedChanged = (listener) => { receivedListener = listener; return () => {}; };
+ let view!: ReturnType<typeof render>;
+ await act(async () => { view = render(<ProviderShareInsightsSection share={{ ...share, status: 'active' }} />); });
+ const late = resolve;
+ await act(async () => {
+ if (change === 'share') view.rerender(<ProviderShareInsightsSection share={{ ...share, shareId: 'different', status: 'active' }} />);
+ if (change === 'account') { setDataOwnerGeneration('another-owner'); view.rerender(<ProviderShareInsightsSection share={{ ...share, status: 'active' }} />); }
+ if (change === 'removed') receivedListener([]);
+ late(insights());
+ });
+ expect(screen.queryByText('$12.34')).toBeNull(); expect(screen.queryByText('Shared Owner')).toBeNull();
+ setDataOwnerGeneration(null);
+ });
+});
diff --git a/apps/desktop/src/renderer/features/provider-share/__tests__/providerShareInsightsFlow.test.tsx b/apps/desktop/src/renderer/features/provider-share/__tests__/providerShareInsightsFlow.test.tsx
new file mode 100644
index 0000000000..b88e4889af
--- /dev/null
+++ b/apps/desktop/src/renderer/features/provider-share/__tests__/providerShareInsightsFlow.test.tsx
@@ -0,0 +1,313 @@
+// @vitest-environment jsdom
+/**
+ * 跨模块集成:真实 renderer → IPC handler → guest runtime → host dispatch → insights
+ * reader/文件权限 → wire DTO → renderer。现有单段测试没有覆盖这条接线。
+ * 最小失败输入:一份有效分享,开启后读取,再关闭用量并刷新。unit runner;集成场景。
+ * Electron、传输、账号关系快照、上游额度和账本为替身,不是真实跨账号/跨电脑 E2E。
+ */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { act, cleanup, fireEvent, render, screen } from '@testing-library/react';
+import { afterEach, expect, it, vi } from 'vitest';
+import { ipcMain } from 'electron';
+import {
+ providerShareGuestPeer,
+ type DeviceLinkClient,
+ type InvokeResultPayload,
+ type ProviderShareReceived,
+} from '@cindy/device-link';
+
+const state = vi.hoisted(() => ({ root: '', active: true }));
+vi.mock('electron-store', () => ({ default: class {} }));
+vi.mock('electron', () => ({
+ app: { getAppPath: () => state.root, getPath: () => state.root, getVersion: () => '0.0.0-test' },
+ ipcMain: { handle: vi.fn() },
+ BrowserWindow: { getAllWindows: () => [] },
+ Notification: { isSupported: () => false },
+ powerSaveBlocker: { start: () => 0, stop: () => {}, isStarted: () => false },
+ nativeImage: { createFromPath: () => ({ isEmpty: () => true }) },
+}));
+vi.mock('../../../../main/appSessionState.js', () => ({
+ activeOwnerScopeKey: () => 'isolated-owner',
+ isAppSessionBoundaryPending: () => false,
+ ownerScopedUserDataPath: (file: string) => `${state.root}/${file}`,
+}));
+vi.mock('../../../../main/maker-host/createDesktopProviderService.js', () => ({
+ getDesktopProviderService: () => ({ listProviders: async () => [] }),
+}));
+vi.mock('../../../../main/maker-host/remote-provider-access-store.js', () => ({
+ isRemoteProviderInvocationAllowed: () => true,
+}));
+vi.mock('../../../../main/i18n.js', () => ({ t: (key: string) => key }));
+vi.mock('../../../../main/textClipboard.js', () => ({ rememberIssuedClipboardText: vi.fn() }));
+// 额度查询不经过 Agent 启动面,隔离其与调度器的全局装配。
+// 其它 IPC 服务不是本链路的依赖,不装配文件传输、桌面捕获、语音和插件宿主。
+vi.mock('../../../../main/localDb/ipc/taskTags.js', () => ({
+ TASK_TAG_CHANNEL: 'local-db:task-tags:execute',
+}));
+vi.mock('../../../../main/device-link/mediaFetch', () => ({}));
+vi.mock('../../../../main/task-migration/service', () => ({}));
+vi.mock('../../../../main/device-link/filePeer', () => ({}));
+vi.mock('../../../../main/remote-desktop', () => ({}));
+vi.mock('../../../../main/device-link/sharedTaskFileAccess.js', () => ({}));
+vi.mock('../../../../main/voice-input/index.js', () => ({}));
+vi.mock('../../../../main/cindy-brain/ghostSetupInteractionBridge.js', () => ({}));
+vi.mock('../../../../main/maker-host/index.js', () => ({}));
+vi.mock('../../../../main/maker-ipc/register.js', () => ({}));
+vi.mock('../../../../main/device-link/index.js', () => ({ remoteBackgroundInvoke: vi.fn() }));
+vi.mock('../../../../main/device-link/providerShareApi.js', () => ({
+ providerShareApi: {},
+ fetchIdentityCard: vi.fn(),
+ sha256Hex: (v: string) => v,
+}));
+vi.mock('../../../../main/authManager.js', () => ({
+ getDeviceId: () => 'isolated-host',
+ getAuthState: () => ({ user: { name: 'Shared Owner', avatar: null } }),
+}));
+vi.mock('../../../../main/logger.js', () => ({
+ createLogger: () => ({ info: vi.fn(), debug: vi.fn(), warn: vi.fn(), error: vi.fn() }),
+}));
+vi.mock('../../../../main/security/trustedAppRenderer.js', () => ({
+ assertTrustedAppRendererEvent: vi.fn(),
+}));
+vi.mock('../../../../main/device-link/settings-store.js', async (original) => ({
+ ...(await original<typeof import('../../../../main/device-link/settings-store.js')>()),
+ readDeviceLinkSettings: () => ({
+ remoteControlEnabled: true,
+ keepAwake: false,
+ revokedControllers: [],
+ disabledControlDeviceIds: [],
+ }),
+ readLastKnownDeviceNames: () => ({}),
+}));
+vi.mock('../../../../main/device-link/providerShareHost.js', () => ({
+ startProviderShareHost: vi.fn(),
+ stopProviderShareHost: vi.fn(),
+ providerShareAccessRevision: () => 1,
+ providerShareGuestAccess: () =>
+ state.active ? { shareId: 'flow', memberId: 'guest', providerId: 'anthropic' } : null,
+ ensureProviderSharePeerKnown: async () => {},
+ providerShareGuestDenial: () => null,
+ getProviderShareHostSnapshot: () => [
+ {
+ shareId: 'flow',
+ providerId: 'anthropic',
+ members: [
+ { memberId: 'guest', displayName: 'Guest Alice', avatarUrl: null, status: 'active' },
+ ],
+ requests: [],
+ },
+ ],
+}));
+vi.mock('../../../../main/device-link/providerShareGuest.js', () => ({
+ startProviderShareGuest: vi.fn(),
+ stopProviderShareGuest: vi.fn(),
+ findReceivedShare: () => ({
+ shareId: 'flow',
+ memberId: 'guest',
+ status: 'active',
+ hostOnline: true,
+ }),
+ providerShareReceivedRevision: () => 1,
+ refreshReceivedShares: async () => {},
+ getReceivedShares: () => [],
+}));
+vi.mock('../../../../main/device-link/providerShareGuestPrefs.js', () => ({
+ configureProviderShareGuestPrefs: vi.fn(),
+ invalidateProviderShareGuestPrefsCache: vi.fn(),
+}));
+vi.mock('../../../../main/device-link/providerShareQuota.js', () => ({
+ readProviderShareQuota: async () => ({
+ group: false,
+ partial: false,
+ accounts: [
+ {
+ state: 'ready',
+ updatedAt: null,
+ windows: [],
+ balance: { remaining: 25, total: 100, currency: 'USD', resetsAt: null, pools: [] },
+ },
+ ],
+ }),
+}));
+vi.mock('../../../../main/usage/providerPartyUsageStore.js', () => ({
+ currentProviderPartyUsageStore: () => ({
+ history: () => ({
+ self: {
+ lastUsedAt: null,
+ days: [
+ {
+ day: '2026-10-19',
+ kind: 'codex',
+ model: 'model-a',
+ memberKey: 'private-device',
+ turns: 1,
+ inputTokens: 10,
+ outputTokens: 2,
+ cacheReadTokens: 0,
+ cacheCreateTokens: 0,
+ },
+ ],
+ },
+ relays: [],
+ }),
+ }),
+}));
+vi.mock('../../../../main/device-link/providerShareUsageStore.js', () => ({
+ getProviderShareUsageStore: () => ({
+ history: () => [
+ {
+ shareId: 'flow',
+ memberId: 'guest',
+ lastUsedAt: null,
+ days: [
+ {
+ day: '2026-10-19',
+ kind: 'codex',
+ model: 'model-b',
+ providerId: 'anthropic',
+ memberKey: 'private-guest',
+ turns: 1,
+ inputTokens: 20,
+ outputTokens: 3,
+ cacheReadTokens: 0,
+ cacheCreateTokens: 0,
+ },
+ ],
+ },
+ ],
+ }),
+ providerUsageLocalDay: () => '2026-10-19',
+}));
+vi.mock('../../../../main/usage/modelPricing.js', () => ({
+ getGatewayModelPricing: async () => null,
+ getModelPriceQuote: () => null,
+}));
+vi.mock('../../../../main/usage/ledgerCurrency.js', () => ({ currentLedgerCurrency: () => 'USD' }));
+vi.mock('react-i18next', () => ({
+ initReactI18next: { type: '3rdParty', init: () => {} },
+ useTranslation: () => ({ t: (key: string) => key, i18n: { language: 'en' } }),
+}));
+vi.mock('@/features/device-link/useDeviceLinkDeviceList', () => ({
+ useDeviceLinkDeviceList: () => [],
+}));
+vi.mock('@/features/provider-group/useLocalProviderGroups', () => ({
+ useLocalProviderGroups: () => ({}),
+}));
+vi.mock('@/hooks/useReducedMotion', () => ({ useReducedMotion: () => true }));
+
+import {
+ registerProviderShareIpc,
+ startProviderShareRuntime,
+ stopProviderShareRuntime,
+} from '../../../../main/device-link/providerShareRuntime';
+import {
+ __testing as dispatch,
+ setProviderShareAccess,
+ setRemoteAgentHandler,
+} from '../../../../main/device-link/dispatch';
+import { createProviderShareVisibilityStore } from '../../../../main/device-link/providerShareVisibility';
+import { ProviderShareInsightsSection } from '../ProviderShareInsightsSection';
+
+const share: ProviderShareReceived = {
+ shareId: 'flow',
+ memberId: 'guest',
+ providerId: 'anthropic',
+ providerLabel: 'Anthropic',
+ hostDeviceId: 'host',
+ deviceName: 'private-host',
+ owner: { displayName: 'Shared Owner', avatarUrl: null, region: 'global' },
+ status: 'active',
+ hostOnline: true,
+ hostCapable: true,
+};
+afterEach(() => {
+ cleanup();
+ stopProviderShareRuntime();
+ dispatch.reset();
+ setProviderShareAccess(null);
+ vi.restoreAllMocks();
+ vi.useRealTimers();
+ if (state.root) fs.rmSync(state.root, { recursive: true, force: true });
+});
+it('round-trips permissions, private projection and live revocation through the real query stack', async () => {
+ state.root = fs.mkdtempSync(path.join(os.tmpdir(), 'cindy-share-flow-'));
+ const peer = providerShareGuestPeer('flow', 'guest', 'test-device');
+ const received: InvokeResultPayload[] = [];
+ const client = {
+ getConnectionEpoch: () => 1,
+ getStatus: () => 'online',
+ sendInvokeResult: (_peer: string, _id: string, value: InvokeResultPayload) => {
+ received.push(JSON.parse(JSON.stringify(value)) as InvokeResultPayload);
+ },
+ } as unknown as DeviceLinkClient;
+ dispatch.reset();
+ dispatch.setActiveClient(client);
+ const agent = vi.fn();
+ setRemoteAgentHandler({ handle: agent, abortAll: vi.fn() });
+ let request = 0;
+ startProviderShareRuntime(vi.fn(), {
+ invoke: async (_target, channel, args, options) => {
+ options?.preSend?.();
+ await dispatch.handleInvoke(client, peer, `query-${request++}`, { channel, args });
+ return received.at(-1)!;
+ },
+ });
+ const registration = vi.spyOn(ipcMain, 'handle');
+ registerProviderShareIpc();
+ const handler = registration.mock.calls.find(
+ ([channel]) => channel === 'provider-share:command',
+ )![1];
+ const command = (input: unknown) => handler({} as Electron.IpcMainInvokeEvent, input);
+ const save = (quota: boolean, usage: boolean) =>
+ command({ action: 'set-visibility', providerId: 'anthropic', visibility: { quota, usage } });
+ Object.assign(window, {
+ electronAPI: { providerShare: { command, onReceivedChanged: () => () => {} } },
+ });
+ await expect(
+ command({ action: 'get-visibility', providerId: 'anthropic' }),
+ ).resolves.toMatchObject({ quota: false, usage: false });
+ await save(true, true);
+ await act(async () => {
+ render(<ProviderShareInsightsSection share={share} />);
+ });
+ expect(screen.getByRole('progressbar').getAttribute('aria-valuenow')).toBe('25');
+ expect(screen.queryByText('Guest Alice')).toBeNull();
+ fireEvent.click(screen.getByRole('button', { name: 'providerShare.insights.usageTitle' }));
+ expect(screen.getByText('Guest Alice')).toBeTruthy();
+ expect(screen.getByText('Shared Owner')).toBeTruthy();
+ fireEvent.click(screen.getByRole('tab', { name: 'providerGroup.usage.stack.model' }));
+ expect(screen.getAllByTestId('provider-usage-model')).toHaveLength(2);
+ fireEvent.click(screen.getByRole('tab', { name: 'providerGroup.usage.stack.party' }));
+ fireEvent.click(screen.getByRole('button', { name: 'Guest Alice' }));
+ fireEvent.click(screen.getByRole('tab', { name: 'providerGroup.usage.stack.model' }));
+ expect(screen.getAllByTestId('provider-usage-model')).toHaveLength(1);
+ expect(screen.getByTestId('provider-usage-model').textContent).toContain('model-b');
+ fireEvent.change(screen.getByLabelText('usageHistory.range.date'), {
+ target: { value: '2026-10-18' },
+ });
+ expect(screen.queryAllByTestId('provider-usage-model')).toHaveLength(0);
+ fireEvent.change(screen.getByLabelText('usageHistory.range.date'), {
+ target: { value: '2026-10-19' },
+ });
+ expect(screen.getAllByTestId('provider-usage-model')).toHaveLength(1);
+ expect(JSON.stringify(received)).not.toMatch(
+ /private-device|private-guest|memberKey|hostDeviceId/,
+ );
+ const reopened = createProviderShareVisibilityStore({
+ filePath: () => path.join(state.root, 'provider-share-visibility.json'),
+ scopeKey: () => 'isolated-owner',
+ });
+ expect(reopened.read('anthropic')).toMatchObject({ quota: true, usage: true });
+ // 重新挂载触发同一真实查询;不依赖真实时间等待,也不以伪造响应替代撤权。
+ cleanup();
+ await save(true, false);
+ await act(async () => {
+ render(<ProviderShareInsightsSection share={share} />);
+ });
+ expect(screen.getByRole('progressbar')).toBeTruthy();
+ expect(screen.queryByRole('button', { name: 'providerShare.insights.usageTitle' })).toBeNull();
+ expect(screen.queryByText('Guest Alice')).toBeNull();
+ expect(agent).not.toHaveBeenCalled();
+});
diff --git a/apps/desktop/src/renderer/i18n/locales/en/common.json b/apps/desktop/src/renderer/i18n/locales/en/common.json
index 8059012e83..6b2b995863 100644
--- a/apps/desktop/src/renderer/i18n/locales/en/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/en/common.json
@@ -1,5 +1,26 @@
{
- "mailReader": {"markReadFailed":"Could not sync read status. Check mailbox authorization and reopen this email.","title":"Mail","openMailbox":"Open in mailbox","loading":"Loading email…","failed":"Could not load this email. Check the connected mailbox account, retry, or open it in your mailbox.","retry":"Retry","to":"To","cc":"Cc","bcc":"Bcc","subject":"Subject","currentMessage":"Current email","messageCount_other":"{{count}} emails","messageCount_one":"{{count}} email","showMessages_other":"Show {{count}} emails","showMessages_one":"Show {{count}} email","expandMessage":"Expand email from {{from}}","collapseMessage":"Collapse email from {{from}}","conversationFailed":"Other emails in this conversation could not be loaded.","messageCount":"{{count}} emails","showMessages":"Show {{count}} emails"},
+ "mailReader": {
+ "markReadFailed": "Could not sync read status. Check mailbox authorization and reopen this email.",
+ "title": "Mail",
+ "openMailbox": "Open in mailbox",
+ "loading": "Loading email…",
+ "failed": "Could not load this email. Check the connected mailbox account, retry, or open it in your mailbox.",
+ "retry": "Retry",
+ "to": "To",
+ "cc": "Cc",
+ "bcc": "Bcc",
+ "subject": "Subject",
+ "currentMessage": "Current email",
+ "messageCount_other": "{{count}} emails",
+ "messageCount_one": "{{count}} email",
+ "showMessages_other": "Show {{count}} emails",
+ "showMessages_one": "Show {{count}} email",
+ "expandMessage": "Expand email from {{from}}",
+ "collapseMessage": "Collapse email from {{from}}",
+ "conversationFailed": "Other emails in this conversation could not be loaded.",
+ "messageCount": "{{count}} emails",
+ "showMessages": "Show {{count}} emails"
+ },
"logSupport": {
"title": "Logs and Feedback",
"localFiles": "Choose logs from the day of the problem. Review unredacted files before sharing.",
@@ -479,6 +500,40 @@
"saved": "Remote session limits saved",
"retry": "Reload",
"loading": "Loading…"
+ },
+ "insights": {
+ "visibilityTitle": "Shared Information",
+ "visibilityNote": "Applies to everyone using this shared provider. Turning off viewing permissions does not affect model use.",
+ "allowQuota": "Allow Viewing Remaining Allowance",
+ "allowUsage": "Allow Viewing Usage Details",
+ "saveFailed": "Could not save sharing permissions",
+ "quotaTitle": "Remaining Allowance",
+ "quotaNote": "This allowance is shared by the account, not reserved for you.",
+ "groupNote": "Accounts are shown separately; percentages are not added. Some accounts may be omitted. Accounts borrowed from others are excluded, and the same account on multiple computers may appear more than once.",
+ "account": "Account {{number}}",
+ "noOwnAccounts": "This group has no owned accounts whose allowance can be shared",
+ "usageNote": "Historical usage includes the owner and current users. Amounts are estimates.",
+ "relayNote": "Relayed usage is grouped separately because the end users are unknown. It is not counted as the owner’s own usage.",
+ "relay": "Relayed Usage",
+ "you": "You",
+ "owner": "Owner",
+ "notShared": "The owner has not shared the remaining allowance",
+ "usageNotShared": "The owner has not shared usage details",
+ "usageUnavailable": "Usage details are temporarily unavailable",
+ "denied": "This share cannot be viewed right now",
+ "unsupported": "Allowance reading is not supported for this provider",
+ "unavailable": "Allowance or usage is temporarily unavailable",
+ "offline": "The owner’s computer is offline or disconnected",
+ "needs-update": "The owner needs to update Cindy to share this information",
+ "unlimited": "No personal limit set",
+ "session": "Current Period",
+ "week": "Weekly",
+ "scoped": "Separate Period",
+ "remaining": "{{percent}}% remaining",
+ "resets": "Resets: {{time}}",
+ "updated": "Updated {{time}}",
+ "usageTitle": "Usage Details",
+ "allowUsageDescription": "When enabled, everyone using this shared provider can view the sharer's and every other user's display names and detailed usage history."
}
},
"providerGroup": {
diff --git a/apps/desktop/src/renderer/i18n/locales/ja/common.json b/apps/desktop/src/renderer/i18n/locales/ja/common.json
index dfdc6ea1e0..62bf7b702b 100644
--- a/apps/desktop/src/renderer/i18n/locales/ja/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/ja/common.json
@@ -1,5 +1,26 @@
{
- "mailReader": {"markReadFailed":"既読状態を同期できませんでした。メールボックスの認証を確認して開き直してください。","title":"メール","openMailbox":"メールボックスで開く","loading":"メールを読み込み中…","failed":"メールを読み込めませんでした。接続したアカウントを確認して再試行するか、メールボックスで開いてください。","retry":"再試行","to":"宛先","cc":"Cc","bcc":"Bcc","subject":"件名","currentMessage":"現在のメール","messageCount_other":"{{count}} 件のメール","messageCount_one":"{{count}} 件のメール","showMessages_other":"{{count}} 件のメールを表示","showMessages_one":"{{count}} 件のメールを表示","expandMessage":"{{from}} からのメールを展開","collapseMessage":"{{from}} からのメールを折りたたむ","conversationFailed":"前後のメールを読み込めませんでした。","messageCount":"{{count}} 件のメール","showMessages":"{{count}} 件のメールを表示"},
+ "mailReader": {
+ "markReadFailed": "既読状態を同期できませんでした。メールボックスの認証を確認して開き直してください。",
+ "title": "メール",
+ "openMailbox": "メールボックスで開く",
+ "loading": "メールを読み込み中…",
+ "failed": "メールを読み込めませんでした。接続したアカウントを確認して再試行するか、メールボックスで開いてください。",
+ "retry": "再試行",
+ "to": "宛先",
+ "cc": "Cc",
+ "bcc": "Bcc",
+ "subject": "件名",
+ "currentMessage": "現在のメール",
+ "messageCount_other": "{{count}} 件のメール",
+ "messageCount_one": "{{count}} 件のメール",
+ "showMessages_other": "{{count}} 件のメールを表示",
+ "showMessages_one": "{{count}} 件のメールを表示",
+ "expandMessage": "{{from}} からのメールを展開",
+ "collapseMessage": "{{from}} からのメールを折りたたむ",
+ "conversationFailed": "前後のメールを読み込めませんでした。",
+ "messageCount": "{{count}} 件のメール",
+ "showMessages": "{{count}} 件のメールを表示"
+ },
"logSupport": {
"title": "ログとフィードバック",
"localFiles": "問題が発生した日のログを選択してください。未マスキングのため、共有前に内容を確認してください。",
@@ -475,6 +496,40 @@
"saved": "リモートセッション数を保存しました",
"retry": "再読み込み",
"loading": "読み込み中…"
+ },
+ "insights": {
+ "visibilityTitle": "共有する情報",
+ "visibilityNote": "この共有プロバイダーのすべての利用者に適用されます。閲覧をオフにしてもモデルの利用には影響しません。",
+ "allowQuota": "残りの利用枠の閲覧を許可",
+ "allowUsage": "使用量の詳細の閲覧を許可",
+ "saveFailed": "共有情報の閲覧権限を保存できませんでした",
+ "quotaTitle": "残りの利用枠",
+ "quotaNote": "アカウント全体で共有する利用枠です。あなた専用の枠ではありません。",
+ "groupNote": "アカウント別に表示し、割合は合算しません。一部のアカウントのみ表示される場合があります。他の人から共有されたアカウントは対象外です。同じアカウントを複数のコンピューターで使っている場合、別々に表示されることがあります。",
+ "account": "アカウント {{number}}",
+ "noOwnAccounts": "このグループには利用枠を公開できる所有アカウントがありません",
+ "usageNote": "共有者と現在の利用者の過去の使用量を表示します。金額は推定値です。",
+ "relayNote": "中継された使用量は最終利用者を特定できないため、共有者本人の使用量とは分けて集計します。",
+ "relay": "中継された使用量",
+ "you": "あなた",
+ "owner": "共有者",
+ "notShared": "共有者は残りの利用枠を公開していません",
+ "usageNotShared": "共有者は使用量の詳細を公開していません",
+ "usageUnavailable": "使用量の詳細を一時的に取得できません",
+ "denied": "現在この共有情報を閲覧できません",
+ "unsupported": "このプロバイダーの利用枠の取得には対応していません",
+ "unavailable": "利用枠または使用量を一時的に取得できません",
+ "offline": "共有者のコンピューターがオフラインか接続が切れています",
+ "needs-update": "閲覧するには共有者が Cindy を更新する必要があります",
+ "unlimited": "個人の上限は設定されていません",
+ "session": "現在の期間",
+ "week": "毎週",
+ "scoped": "個別の期間",
+ "remaining": "残り {{percent}}%",
+ "resets": "リセット:{{time}}",
+ "updated": "更新:{{time}}",
+ "usageTitle": "使用量の詳細",
+ "allowUsageDescription": "オンにすると、この共有のすべての利用者が、共有元と他のすべての利用者の表示名および過去の使用量の詳細を閲覧できます。"
}
},
"providerGroup": {
diff --git a/apps/desktop/src/renderer/i18n/locales/ko/common.json b/apps/desktop/src/renderer/i18n/locales/ko/common.json
index f06b817167..9729c0480f 100644
--- a/apps/desktop/src/renderer/i18n/locales/ko/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/ko/common.json
@@ -1,5 +1,26 @@
{
- "mailReader": {"markReadFailed":"읽음 상태를 동기화하지 못했습니다. 메일함 인증을 확인하고 다시 여세요.","title":"메일","openMailbox":"메일함에서 열기","loading":"메일 읽는 중…","failed":"메일을 읽지 못했습니다. 연결된 계정을 확인하고 다시 시도하거나 메일함에서 여세요.","retry":"다시 시도","to":"받는 사람","cc":"참조","bcc":"숨은 참조","subject":"제목","currentMessage":"현재 메일","messageCount_other":"메일 {{count}}개","messageCount_one":"메일 {{count}}개","showMessages_other":"메일 {{count}}개 펼치기","showMessages_one":"메일 {{count}}개 펼치기","expandMessage":"{{from}}의 메일 펼치기","collapseMessage":"{{from}}의 메일 접기","conversationFailed":"앞뒤 메일을 불러오지 못했습니다.","messageCount":"메일 {{count}}개","showMessages":"메일 {{count}}개 펼치기"},
+ "mailReader": {
+ "markReadFailed": "읽음 상태를 동기화하지 못했습니다. 메일함 인증을 확인하고 다시 여세요.",
+ "title": "메일",
+ "openMailbox": "메일함에서 열기",
+ "loading": "메일 읽는 중…",
+ "failed": "메일을 읽지 못했습니다. 연결된 계정을 확인하고 다시 시도하거나 메일함에서 여세요.",
+ "retry": "다시 시도",
+ "to": "받는 사람",
+ "cc": "참조",
+ "bcc": "숨은 참조",
+ "subject": "제목",
+ "currentMessage": "현재 메일",
+ "messageCount_other": "메일 {{count}}개",
+ "messageCount_one": "메일 {{count}}개",
+ "showMessages_other": "메일 {{count}}개 펼치기",
+ "showMessages_one": "메일 {{count}}개 펼치기",
+ "expandMessage": "{{from}}의 메일 펼치기",
+ "collapseMessage": "{{from}}의 메일 접기",
+ "conversationFailed": "앞뒤 메일을 불러오지 못했습니다.",
+ "messageCount": "메일 {{count}}개",
+ "showMessages": "메일 {{count}}개 펼치기"
+ },
"logSupport": {
"title": "로그 및 피드백",
"localFiles": "문제가 발생한 날짜의 로그를 선택하세요. 민감 정보가 가려지지 않았으므로 공유 전에 확인하세요.",
@@ -475,6 +496,40 @@
"saved": "원격 세션 수 제한을 저장했습니다",
"retry": "새로고침",
"loading": "불러오는 중…"
+ },
+ "insights": {
+ "visibilityTitle": "공유 정보",
+ "visibilityNote": "이 공유 제공자의 모든 사용자에게 적용됩니다. 조회 권한을 꺼도 모델 사용에는 영향을 주지 않습니다.",
+ "allowQuota": "남은 사용 한도 조회 허용",
+ "allowUsage": "사용량 상세 조회 허용",
+ "saveFailed": "공유 조회 권한을 저장하지 못했습니다",
+ "quotaTitle": "남은 사용 한도",
+ "quotaNote": "계정 전체가 함께 사용하는 한도이며, 나에게만 배정된 한도가 아닙니다.",
+ "groupNote": "계정별로 표시하며 백분율은 합산하지 않습니다. 일부 계정만 표시될 수 있습니다. 다른 사람에게 공유받은 계정은 제외되며, 여러 컴퓨터에서 사용하는 같은 계정이 따로 표시될 수 있습니다.",
+ "account": "계정 {{number}}",
+ "noOwnAccounts": "이 그룹에는 한도를 공개할 수 있는 소유 계정이 없습니다",
+ "usageNote": "공유자와 현재 사용자의 이전 사용량을 표시합니다. 금액은 추정치입니다.",
+ "relayNote": "전달된 사용량은 최종 사용자를 알 수 없어 별도로 집계하며, 공유자 본인의 사용량에 포함하지 않습니다.",
+ "relay": "전달된 사용량",
+ "you": "나",
+ "owner": "공유자",
+ "notShared": "공유자가 남은 사용 한도를 공개하지 않았습니다",
+ "usageNotShared": "공유자가 사용량 상세를 공개하지 않았습니다",
+ "usageUnavailable": "일시적으로 사용량 상세를 읽을 수 없습니다",
+ "denied": "현재 이 공유 정보를 볼 수 없습니다",
+ "unsupported": "이 제공자는 사용 한도 조회를 지원하지 않습니다",
+ "unavailable": "일시적으로 한도 또는 사용량을 읽을 수 없습니다",
+ "offline": "공유자의 컴퓨터가 오프라인이거나 연결이 끊어졌습니다",
+ "needs-update": "공유자가 Cindy를 업데이트해야 볼 수 있습니다",
+ "unlimited": "개인 한도가 설정되지 않았습니다",
+ "session": "현재 기간",
+ "week": "매주",
+ "scoped": "별도 기간",
+ "remaining": "{{percent}}% 남음",
+ "resets": "초기화: {{time}}",
+ "updated": "업데이트: {{time}}",
+ "usageTitle": "사용량 세부 정보",
+ "allowUsageDescription": "켜면 이 공유 제공자의 모든 사용자가 공유자와 다른 모든 사용자의 표시 이름 및 과거 사용량 상세 내역을 볼 수 있습니다."
}
},
"providerGroup": {
diff --git a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
index 92263d3a19..896d30141d 100644
--- a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
@@ -1,5 +1,26 @@
{
- "mailReader": {"markReadFailed":"未能同步已读状态,请检查邮箱授权后重新打开。","title":"邮件","openMailbox":"在邮箱中打开","loading":"正在读取邮件…","failed":"未能读取这封邮件。请检查连接的邮箱账号后重试,或在邮箱中打开。","retry":"重试","to":"收件人","cc":"抄送","bcc":"密送","subject":"主题","currentMessage":"当前邮件","messageCount_other":"共 {{count}} 封邮件","messageCount_one":"共 {{count}} 封邮件","showMessages_other":"展开 {{count}} 封邮件","showMessages_one":"展开 {{count}} 封邮件","expandMessage":"展开来自 {{from}} 的邮件","collapseMessage":"收起来自 {{from}} 的邮件","conversationFailed":"暂时无法读取前后邮件。","messageCount":"共 {{count}} 封邮件","showMessages":"展开 {{count}} 封邮件"},
+ "mailReader": {
+ "markReadFailed": "未能同步已读状态,请检查邮箱授权后重新打开。",
+ "title": "邮件",
+ "openMailbox": "在邮箱中打开",
+ "loading": "正在读取邮件…",
+ "failed": "未能读取这封邮件。请检查连接的邮箱账号后重试,或在邮箱中打开。",
+ "retry": "重试",
+ "to": "收件人",
+ "cc": "抄送",
+ "bcc": "密送",
+ "subject": "主题",
+ "currentMessage": "当前邮件",
+ "messageCount_other": "共 {{count}} 封邮件",
+ "messageCount_one": "共 {{count}} 封邮件",
+ "showMessages_other": "展开 {{count}} 封邮件",
+ "showMessages_one": "展开 {{count}} 封邮件",
+ "expandMessage": "展开来自 {{from}} 的邮件",
+ "collapseMessage": "收起来自 {{from}} 的邮件",
+ "conversationFailed": "暂时无法读取前后邮件。",
+ "messageCount": "共 {{count}} 封邮件",
+ "showMessages": "展开 {{count}} 封邮件"
+ },
"logSupport": {
"title": "日志与反馈",
"localFiles": "选择问题当天的日志。文件未脱敏,请先检查。",
@@ -475,6 +496,40 @@
"saved": "远程任务数量设置已保存",
"retry": "重新加载",
"loading": "正在加载…"
+ },
+ "insights": {
+ "visibilityTitle": "分享可见内容",
+ "visibilityNote": "对当前供应商的所有受邀者生效。关闭查看权限不影响模型使用。",
+ "allowQuota": "允许查看剩余额度",
+ "allowUsage": "允许查看用量明细",
+ "saveFailed": "未能保存分享查看权限",
+ "quotaTitle": "剩余额度",
+ "quotaNote": "这是账号共用额度,不是分配给你的专属额度。",
+ "groupNote": "按账号分别显示,不合计百分比。可能只显示部分账号,不包含从他人分享借来的账号;同一账号在多台电脑登录时也可能分列。",
+ "account": "账号 {{number}}",
+ "noOwnAccounts": "此组没有可公开额度的自有账号",
+ "usageNote": "可查看分享者与当前使用者的历史用量,金额为估算值。",
+ "relayNote": "转来的用量无法识别最终使用者,单独汇总,不计入分享者本人。",
+ "relay": "转来的用量",
+ "you": "你",
+ "owner": "分享者",
+ "notShared": "分享者尚未开放剩余额度",
+ "usageNotShared": "分享者尚未开放用量明细",
+ "usageUnavailable": "暂时无法读取用量明细",
+ "denied": "此分享暂不可查看",
+ "unsupported": "此供应商暂不支持读取额度",
+ "unavailable": "暂时无法读取额度或用量",
+ "offline": "分享者电脑离线或连接已断开",
+ "needs-update": "分享者的 Cindy 更新后才能查看",
+ "unlimited": "未设置个人限额",
+ "session": "当前周期",
+ "week": "每周",
+ "scoped": "独立周期",
+ "remaining": "剩余 {{percent}}%",
+ "resets": "重置时间:{{time}}",
+ "updated": "更新于 {{time}}",
+ "usageTitle": "用量明细",
+ "allowUsageDescription": "开启后,此分享的所有使用者都能查看分享者及其他所有使用者的昵称和历史用量明细。"
}
},
"providerGroup": {
diff --git a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
index 41c838463c..eaaef12753 100644
--- a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
@@ -1,5 +1,26 @@
{
- "mailReader": {"markReadFailed":"未能同步已讀狀態,請檢查信箱授權後重新開啟。","title":"郵件","openMailbox":"在信箱中開啟","loading":"正在讀取郵件…","failed":"未能讀取這封郵件。請檢查連接的信箱帳號後重試,或在信箱中開啟。","retry":"重試","to":"收件人","cc":"副本","bcc":"密件副本","subject":"主旨","currentMessage":"目前郵件","messageCount_other":"共 {{count}} 封郵件","messageCount_one":"共 {{count}} 封郵件","showMessages_other":"展開 {{count}} 封郵件","showMessages_one":"展開 {{count}} 封郵件","expandMessage":"展開來自 {{from}} 的郵件","collapseMessage":"收起來自 {{from}} 的郵件","conversationFailed":"暫時無法讀取前後郵件。","messageCount":"共 {{count}} 封郵件","showMessages":"展開 {{count}} 封郵件"},
+ "mailReader": {
+ "markReadFailed": "未能同步已讀狀態,請檢查信箱授權後重新開啟。",
+ "title": "郵件",
+ "openMailbox": "在信箱中開啟",
+ "loading": "正在讀取郵件…",
+ "failed": "未能讀取這封郵件。請檢查連接的信箱帳號後重試,或在信箱中開啟。",
+ "retry": "重試",
+ "to": "收件人",
+ "cc": "副本",
+ "bcc": "密件副本",
+ "subject": "主旨",
+ "currentMessage": "目前郵件",
+ "messageCount_other": "共 {{count}} 封郵件",
+ "messageCount_one": "共 {{count}} 封郵件",
+ "showMessages_other": "展開 {{count}} 封郵件",
+ "showMessages_one": "展開 {{count}} 封郵件",
+ "expandMessage": "展開來自 {{from}} 的郵件",
+ "collapseMessage": "收起來自 {{from}} 的郵件",
+ "conversationFailed": "暫時無法讀取前後郵件。",
+ "messageCount": "共 {{count}} 封郵件",
+ "showMessages": "展開 {{count}} 封郵件"
+ },
"logSupport": {
"title": "日誌與回饋",
"localFiles": "選擇問題當天的日誌。檔案未經去識別化處理,請先檢查。",
@@ -475,6 +496,40 @@
"saved": "遠端任務數量設定已儲存",
"retry": "重新載入",
"loading": "正在載入…"
+ },
+ "insights": {
+ "visibilityTitle": "分享可見內容",
+ "visibilityNote": "對目前供應商的所有受邀者生效。關閉查看權限不影響模型使用。",
+ "allowQuota": "允許查看剩餘額度",
+ "allowUsage": "允許查看用量明細",
+ "saveFailed": "無法儲存分享查看權限",
+ "quotaTitle": "剩餘額度",
+ "quotaNote": "這是帳號共用額度,不是分配給你的專屬額度。",
+ "groupNote": "按帳號分別顯示,不合計百分比。可能只顯示部分帳號,不包含向他人分享借來的帳號;同一帳號在多台電腦登入時也可能分列。",
+ "account": "帳號 {{number}}",
+ "noOwnAccounts": "此群組沒有可公開額度的自有帳號",
+ "usageNote": "可查看分享者與目前使用者的歷史用量,金額為估算值。",
+ "relayNote": "轉來的用量無法識別最終使用者,單獨彙總,不計入分享者本人。",
+ "relay": "轉來的用量",
+ "you": "你",
+ "owner": "分享者",
+ "notShared": "分享者尚未開放剩餘額度",
+ "usageNotShared": "分享者尚未開放用量明細",
+ "usageUnavailable": "暫時無法讀取用量明細",
+ "denied": "此分享暫時無法查看",
+ "unsupported": "此供應商暫不支援讀取額度",
+ "unavailable": "暫時無法讀取額度或用量",
+ "offline": "分享者電腦離線或連線已中斷",
+ "needs-update": "分享者的 Cindy 更新後才能查看",
+ "unlimited": "未設定個人限額",
+ "session": "目前週期",
+ "week": "每週",
+ "scoped": "獨立週期",
+ "remaining": "剩餘 {{percent}}%",
+ "resets": "重置時間:{{time}}",
+ "updated": "更新於 {{time}}",
+ "usageTitle": "用量明細",
+ "allowUsageDescription": "開啟後,此分享的所有使用者都能查看分享者及其他所有使用者的暱稱和歷史用量明細。"
}
},
"providerGroup": {
diff --git a/apps/desktop/src/shared/providerManagement.ts b/apps/desktop/src/shared/providerManagement.ts
index e2b7f770ce..07178caed7 100644
--- a/apps/desktop/src/shared/providerManagement.ts
+++ b/apps/desktop/src/shared/providerManagement.ts
@@ -12,7 +12,7 @@ export type ProviderGroupManagementCommand = Extract<
export type ProviderShareManagementCommand = Extract<
ProviderShareCommand,
- { action: 'owned' | 'own-usage' | 'usage-history' | 'create-link' | 'approve' | 'reject' | 'set-member' | 'set-member-note' | 'reshare-decide' | 'get-run-limits' | 'set-run-limits' | 'reset-run-limits' }
+ { action: 'owned' | 'own-usage' | 'usage-history' | 'create-link' | 'approve' | 'reject' | 'set-member' | 'set-member-note' | 'reshare-decide' | 'get-run-limits' | 'set-run-limits' | 'reset-run-limits' | 'get-visibility' | 'set-visibility' | 'quota-account' }
>;
export type ProviderManagementRequest =
diff --git a/apps/desktop/src/shared/providerShare.ts b/apps/desktop/src/shared/providerShare.ts
index e3e9c4039e..c41b371a38 100644
--- a/apps/desktop/src/shared/providerShare.ts
+++ b/apps/desktop/src/shared/providerShare.ts
@@ -12,6 +12,7 @@ import type {
ProviderShareRequestState,
} from '@cindy/device-link';
import type { DataOwnerPushStamp } from './dataOwnerPush';
+import type { ProviderShareInsights, ProviderShareQuotaAccount, ProviderShareVisibility } from './providerShareInsights';
/** 本机收藏清理依据。未加载、断线和账号切换的空列表不能用于撤权清理。 */
export interface ProviderShareReceivedSnapshot {
@@ -190,6 +191,10 @@ export interface ProviderShareSettledEvent {
}
export type ProviderShareCommand =
+ | { action: 'get-visibility'; providerId: string }
+ | { action: 'set-visibility'; providerId: string; visibility: Partial<ProviderShareVisibility> }
+ | { action: 'quota-account'; providerId: string }
+ | { action: 'insights'; shareId: string }
| { action: 'get-run-limits' }
| { action: 'reset-run-limits' }
| { action: 'set-run-limits'; limits: Partial<RemoteAgentLimits> }
@@ -221,6 +226,10 @@ export interface ProviderShareCredentialConsentView {
}
export interface ProviderShareCommandResult {
+ 'get-visibility': ProviderShareVisibility;
+ 'set-visibility': ProviderShareVisibility;
+ 'quota-account': ProviderShareQuotaAccount;
+ insights: ProviderShareInsights;
'get-run-limits': RemoteAgentLimitsView;
'set-run-limits': RemoteAgentLimitsView;
'reset-run-limits': RemoteAgentLimitsView;
diff --git a/apps/desktop/src/shared/providerShareInsights.ts b/apps/desktop/src/shared/providerShareInsights.ts
new file mode 100644
index 0000000000..c2661f96d6
--- /dev/null
+++ b/apps/desktop/src/shared/providerShareInsights.ts
@@ -0,0 +1,151 @@
+import { z } from 'zod';
+import type { ProviderUsageDayView } from './providerShare';
+
+export const PROVIDER_SHARE_INSIGHTS_CHANNEL = 'provider-share:insights:v1';
+
+export interface ProviderShareVisibility {
+ quota: boolean;
+ usage: boolean;
+}
+
+export interface ProviderShareQuotaAccount {
+ state: 'ready' | 'unsupported' | 'unavailable' | 'offline' | 'needs-update' | 'unlimited';
+ updatedAt: number | null;
+ windows: Array<{
+ kind: 'session' | 'week' | 'scoped';
+ label: string | null;
+ remainingPercent: number;
+ resetsAt: number | null;
+ windowMinutes: number | null;
+ }>;
+ balance: {
+ remaining: number;
+ total: number | null;
+ currency: 'USD' | 'CNY';
+ resetsAt: number | null;
+ pools: Array<{
+ kind: 'plan' | 'purchased' | 'promotional';
+ remaining: number;
+ total: number | null;
+ }>;
+ } | null;
+}
+
+export type ProviderShareUsageDay = Omit<ProviderUsageDayView, 'providerId' | 'memberKey'>;
+
+export interface ProviderShareUsageDetails {
+ todayKey: string;
+ coverageStart: string | null;
+ parties: Array<{
+ key: string;
+ displayName: string;
+ avatarUrl: string | null;
+ isYou: boolean;
+ isOwner: boolean;
+ isRelay: boolean;
+ lastUsedAt: number | null;
+ days: ProviderShareUsageDay[];
+ }>;
+}
+
+export interface ProviderShareInsights {
+ version: 1;
+ capabilities: ProviderShareVisibility;
+ status: {
+ quota: 'disabled' | 'ready' | 'unavailable';
+ usage: 'disabled' | 'ready' | 'unavailable';
+ };
+ quota: { group: boolean; partial: boolean; accounts: ProviderShareQuotaAccount[] } | null;
+ usage: ProviderShareUsageDetails | null;
+}
+
+// 对端返回值只保留展示字段;未知版本或缺字段不当成零额度。
+const number = z.number().finite();
+const money = z.object({ amount: number, currency: z.enum(['USD', 'CNY']) });
+const quotaAccount = z.object({
+ state: z.enum(['ready', 'unsupported', 'unavailable', 'offline', 'needs-update', 'unlimited']),
+ updatedAt: number.nullable(),
+ windows: z
+ .array(
+ z.object({
+ kind: z.enum(['session', 'week', 'scoped']),
+ label: z.string().max(128).nullable(),
+ remainingPercent: number.min(0).max(100),
+ resetsAt: number.nullable(),
+ windowMinutes: number.nullable(),
+ }),
+ )
+ .max(32),
+ balance: z
+ .object({
+ remaining: number,
+ total: number.nullable(),
+ currency: z.enum(['USD', 'CNY']),
+ resetsAt: number.nullable(),
+ pools: z
+ .array(
+ z.object({
+ kind: z.enum(['plan', 'purchased', 'promotional']),
+ remaining: number,
+ total: number.nullable(),
+ }),
+ )
+ .max(3),
+ })
+ .nullable(),
+});
+const status = z.enum(['disabled', 'ready', 'unavailable']);
+const schema = z.object({
+ version: z.literal(1),
+ capabilities: z.object({ quota: z.boolean(), usage: z.boolean() }),
+ status: z.object({ quota: status, usage: status }),
+ quota: z
+ .object({ group: z.boolean(), partial: z.boolean(), accounts: z.array(quotaAccount).max(512) })
+ .nullable(),
+ usage: z
+ .object({
+ todayKey: z.string(),
+ coverageStart: z.string().nullable(),
+ parties: z.array(
+ z.object({
+ key: z.string(),
+ displayName: z.string(),
+ avatarUrl: z.string().nullable(),
+ isYou: z.boolean(),
+ isOwner: z.boolean(),
+ isRelay: z.boolean(),
+ lastUsedAt: number.nullable(),
+ days: z
+ .array(
+ z.object({
+ day: z.string(),
+ kind: z.string(),
+ model: z.string(),
+ turns: number,
+ inputTokens: number,
+ outputTokens: number,
+ cacheReadTokens: number,
+ cacheCreateTokens: number,
+ amount: money.nullable(),
+ }),
+ )
+ .max(5000),
+ }),
+ ),
+ })
+ .nullable(),
+});
+
+export function parseProviderShareInsights(raw: unknown): ProviderShareInsights | null {
+ const parsed = schema.safeParse(raw);
+ if (!parsed.success) return null;
+ const value = parsed.data;
+ // 权限关闭时即使对端错误地附带数据,也不能让它进入本机展示缓存。
+ for (const key of ['quota', 'usage'] as const) {
+ if (!value.capabilities[key]) {
+ value[key] = null;
+ value.status[key] = 'disabled';
+ } else if (value.status[key] !== 'ready') value[key] = null;
+ }
+ return value;
+}
diff --git a/docs/dev-rules/credentials-and-local-storage.md b/docs/dev-rules/credentials-and-local-storage.md
index 2a25f6c652..4ecd73e960 100644
--- a/docs/dev-rules/credentials-and-local-storage.md
+++ b/docs/dev-rules/credentials-and-local-storage.md
@@ -208,6 +208,7 @@ refresh 与 relay 自救节流。在途 refresh 尚未返回时收到的恢复
| 旧版 worktree 回收器兼容锁 | 不再创建新的跨 profile Git 锁;保留旧回执对 `<commonGitDir>/worktrees/<id>/locked` 及更早 `.worktree-keep` 的清理。仅当最后一个共享借用结束且自建文件身份和内容仍匹配时删除,不覆盖用户锁;失败沿用 `.release` 重试。支持精确的 `bigint:dev:ino:birthtimeNs` 身份;旧数字编号为 0 或超过安全整数范围时无法证明归属,保留锁但仍释放已结束的租约,避免 Windows 编号精度丢失误删用户替换文件 |
| 跨 profile 的 worktree 回收日志位置 | `app.getPath('appData')/Cindy/shared-worktree-recycle-journals`,仍按日志目录哈希发布原 profile 日志位置,兼容可能同时运行的旧客户端;新客户端不再读取其他 profile 的日志来借用工程。不复制恢复状态、不代替 owner 执行恢复 |
| 供应商分享:分享者电脑上的受邀者用量 | `userData/remote-agent/provider-share-usage.json`,按(日期、分享、成员、Agent、供应商、模型)聚合 token 与轮次,行内 `byMember` 按组内电脑的键再分(2026-10-11 加;行键与合计不变,旧版本照常累计并原样写回,合计多出各台之和的部分算没区分电脑),原子替换写入,保留 400 天;只含服务端生成的分享与成员 id,不含昵称、对话或凭证。成员删除后保留(管理页不再显示),同一人重新加入时接续 |
+| 供应商分享:额度/用量可见性 | `userData/owners/<账号>/provider-share-visibility.json`,按供应商记录独立 quota/usage 开关覆盖与撤销代次;默认关闭。复用 override settings 跨进程锁、原子写和损坏保留,读写核对当前账号。只存布尔设置及代次,不存额度、身份或凭证;见 `device-link/providerShareVisibility.ts` 及同名单测 |
| 供应商分享:分享者的用户备注 | `userData/owners/<账号>/provider-share-member-notes.json`,`notes` 按服务端成员 id 保存非空单行备注(最多 80 个 UTF-16 单元),空白保存删除对应 override;复用设置文件跨进程锁、现读与原子替换,写入前后核对账号。仅管理页及同账号管理的 `owned` 投影读取,不进入服务端、受邀者目录或日志;未显示的成员记录保留,按原成员 id 接续。损坏文件保留并拒绝覆写。实现与回归见 `device-link/providerShareMemberNotes.ts` 及其同名单测 |
| 供应商分享:转分享的同意 | `userData/owners/<账号>/provider-share-reshare.json`,分享者电脑上记下受邀者的组所在电脑报来的、请求经组使用的人(`provider-sharing.md` §4.3):服务端生成的分享与成员 id、那台组所在电脑的设备 id、组所在电脑给的不透明键、主人的决定与时间,以及组所在电脑转述的昵称与头像地址(只用于管理页认人,不进日志)。不含对话或凭证。原子替换写入;成员被删除或退出、启动后核对已不在这台的分享与成员时删除对应记录 |
| 供应商分享:短期审批弹窗归属 | `userData/owners/<账号>/provider-share-approval-windows.json`,只记供应商 id、生成端关注的供应商所在电脑 id、非秘密链接标识 `linkId`(随机邀请口令的 SHA-256 摘要)与七分钟截止时刻,不含链接口令、申请、配对码或身份。复用设置文件跨进程锁与原子替换;生成链接返回前完成保存,静默与关注均按链接区分。本机新链接仅清除旧版按供应商静默的窗口,不影响其它链接的精确归属。旧记录仍可读,无标识的旧关注只接无标识申请。完整应用重启的第一轮快照前恢复;远端读取使用新运行时的同账号只读管理通道,不恢复旧回调或重放写操作。过期记录读时忽略、下次写入清理;账号切换隔离,损坏文件保留且拒绝覆写。见 `device-link/providerShareApprovalWindows.ts`、`providerShareHost.ts` 与 `__tests__/providerShareApprovalWindows.test.ts` |
diff --git a/docs/dev-rules/protocol-compatibility.md b/docs/dev-rules/protocol-compatibility.md
index 1fb6948600..012701ca77 100644
--- a/docs/dev-rules/protocol-compatibility.md
+++ b/docs/dev-rules/protocol-compatibility.md
@@ -1618,6 +1618,23 @@ G 与 O 之间不变。受邀者能调用的 channel 不变(仍是 `maker:remote
`device-link/__tests__/providerShareDispatch.test.ts`、`provider-group/__tests__/remoteHandler.test.ts`、`directory.test.ts`、
`packages/device-link/src/__tests__/providerShare.test.ts`。
+## 供应商分享:按授权查看额度与用量(2026-10-19)
+
+- 新只读通道 `provider-share:insights:v1` 仅接受分享身份,参数严格为 `{ version: 1 }`,供应商由已验证身份决定。
+ 返回 `{ version, capabilities, status, quota, usage }`,结构和接收端白名单解析在 `shared/providerShareInsights.ts`;
+ 两项能力默认关闭,未开放无数据,读取失败分别标 unavailable。无版本/能力/状态或未知版本提示更新,不降为管理通道。
+- 同账号 `manage-share` 追加 `get-visibility`、`set-visibility`(按供应商,仅 quota/usage 布尔补丁)、`quota-account`。
+ 写入仍只在供应商所在电脑执行;旧端的 Unknown command 映射为 UNSUPPORTED_CAPABILITY,不改存控制端、不重放写入。
+ 受邀者不能调用这些管理动作,也不能指定另一个 providerId 或借通道读取全量账本。
+- 最终发送、重复请求与 outbox 重发核对读取时的账号、成员和可见性代次;开关关闭再开启使旧投影失效。
+ 新通道不进入通用 completed 结果缓存;受邀端白名单重建响应并丢弃未授权字段,账号/分享变动拒绝在途回包。
+ 只读请求不调用远程 Agent,不占任务名额。历史和额度分别合并短期在途读取,缓存不跨账号。
+- 普通额度为一项,组额度仅返回自有账号匿名数组及 partial 标记,不含设备、上游身份、凭证或第三方分享账号额度。
+ 用量按天/模型/公开昵称头像投影,合并设备维度,转来用量匿名汇总;历史裁剪口径沿用 usage-history。
+- 旧受邀端不发新请求,模型使用不变;新受邀端收到 CHANNEL_NOT_ALLOWED 或不完整能力时显示需要更新。
+ relay 信封、服务端、数据库与 Mobile 均不变;完整查看需要双方 Desktop 更新。
+ 实现与回归:`device-link/providerShareInsights.ts`、`dispatch.ts`、同目录 `__tests__/providerShareInsights.test.ts`、`providerShareDispatch.test.ts`。
+
## 供应商分享:按需查看匿名组状态(2026-10-12)
产品规则见 [`provider-groups.md`](../product-rules/provider-groups.md) §8、§9.7、§10。
diff --git a/docs/product-rules/provider-groups.md b/docs/product-rules/provider-groups.md
index 5abc1b489b..3b3292fb59 100644
--- a/docs/product-rules/provider-groups.md
+++ b/docs/product-rules/provider-groups.md
@@ -485,6 +485,11 @@
`apps/desktop/src/main/provider-group/usageReporter.ts`;按天明细 `apps/desktop/src/main/device-link/providerShareRuntime.ts`
(`usageHistory`),界面 `apps/desktop/src/renderer/features/provider-share/ProviderUsageSection.tsx` 与 `providerUsageStats.ts`。
+组的剩余额度公开沿用所属供应商同一分享入口的两个开关([供应商分享 §7.5](provider-sharing.md#75-剩余额度与用量明细的可见性2026-10-19))。
+受邀者详情可按匿名账号分别查看自有账号额度,不合并百分比,也不把组内第三方分享账号的额度再公开。
+按人/模型用量复用本组账本,转来且身份不可知的用量单独匿名汇总;不公开组拓扑或私人备注。
+下述匿名 `groupStatus` 合同不变;新增内容只经独立授权的 `provider-share:insights:v1` 查询。
+
## 8. 告知与隐私
- **组对受邀者透明,不打扰。** 分享者建组、加减组内电脑都是分享者的运维操作,受邀者不收到弹窗或提示,
diff --git a/docs/product-rules/provider-sharing.md b/docs/product-rules/provider-sharing.md
index cd3f83519a..b412be2971 100644
--- a/docs/product-rules/provider-sharing.md
+++ b/docs/product-rules/provider-sharing.md
@@ -327,7 +327,29 @@ Desktop「设置 → 模型供应商」的左栏(2026-10-08 用户裁决):
`lastAt` 重新计算,跨时区边界由前后两天的增量缓冲覆盖。
- **受邀者自己的运行数**(2026-10-10):分享者电脑在给受邀者的供应商目录里带上这个受邀者账号(它的每台电脑)
此刻在这个分享上正在运行一轮的任务数,供受邀者的[供应商组](provider-groups.md) §5 统计。只是受邀者自己的数,
- 不含分享者本人和其他受邀者,不泄露分享者电脑上的其他使用情况;不是用量,§12「受邀者查看自己的用量」仍未做。
+ 不含分享者本人和其他受邀者,不泄露分享者电脑上的其他使用情况;不是用量;受邀者查看历史用量须由分享者另外开放,见 §7.5。
+
+### 7.5 剩余额度与用量明细的可见性(2026-10-19)
+
+- 当前供应商的「远程与分享」详情提供「允许查看剩余额度」「允许查看用量明细」两个独立开关,默认关闭。
+ 设置按账号、电脑与供应商保存,对当前和未来所有受邀者统一生效;同账号其他电脑经既有管理通道写入供应商所在电脑。
+ 关闭查看权限不关闭模型调用、不终止任务,不承诺追回已读取的数据。
+- 受邀者只在对应分享详情查看获准的数据;不扩展模型菜单、任务额度条、手机管理或组调度。
+ 额度是账号共用额度,复用已有订阅窗口、个人 Cindy AI 余额池或组织/网关周期额度及对应只读展示;已知总额用进度条,未知值不推算成零或百分比。
+ 不显示充值、重置次数等管理操作信息。
+ 组内自有账号匿名逐项显示,不相加百分比、不声称同账号多设备可合并;从他人借来的账号不继续公开额度。
+ 页面说明可能只显示部分账号、同一账号多设备可能分列;不可读取、不支持、离线、旧端、未开放分别显示。
+- 用量明细默认收起,主动展开后显示筛选、概览、图表和明细,避免遮挡模型列表;轮询不改变展开状态,换分享或账号重置,不保存偏好。
+ 用量复用现有账本、时间范围与图表,开放分享者本人和当前成员昵称/头像、按人/模型/时间的历史统计,金额标为估算。
+ 已删除成员沿用现有不展示规则;经同账号组转来的用量汇入匿名「转来的用量」,不暴露设备、不归入分享者本人。
+ 私人备注、真实设备身份、凭证、登录邮箱、任务/文件内容与转分享审批细节不进入展示 DTO。
+- 分享者电脑按验证过的分享身份决定供应商,前后核对账号、关系与两个开关的代次;最终发送与背压重发再次校验。
+ 关闭后重开不恢复旧回包。专用只读结果不进入通用完成缓存,不启动/接回远程 Agent。
+ 页面可见时最多每五秒复核,隐藏/换分享/账号/关系变化或查询失败清除旧展示;额度和用量失败分别处理。
+ 本机历史缓存十五秒、额度读取短缓存并合并在途查询,按账号隔离。
+
+实现:`device-link/providerShareInsights.ts`、`providerShareQuota.ts`、`providerShareVisibility.ts` 与 renderer 同名功能组件;
+回归:`device-link/__tests__/providerShareInsights.test.ts`、`providerShareDispatch.test.ts`、`providerShareQuota.test.ts`、`providerShareVisibility.test.ts`。
## 8. 跨区域分享
@@ -352,7 +374,7 @@ Desktop「设置 → 模型供应商」的左栏(2026-10-08 用户裁决):
## 9. 安全不变量
1. **只开放远程 Agent**:来自受邀者的请求,分享者电脑只放行远程 Agent 运行、按该受邀者权限过滤后
- 的供应商列表,以及 Agent 能力查询;其他设备互联能力一律拒绝,绝不降级为整台电脑的远程控制。
+ 的供应商列表,以及 Agent 能力查询、按 §7.5 独立授权的额度/用量只读查询;其他设备互联能力一律拒绝,绝不降级为整台电脑的远程控制。
2. **凭证不出分享者电脑**:模型请求只由分享者电脑上的 Agent 用分享者的登录与供应商发出。
3. **权威划分**:服务端是成员关系的权威(谁是成员、是否已删除);分享者电脑是使用范围与用量的
权威,在开启运行、发送消息和换模型时逐次核对,是最终裁决方。
@@ -547,4 +569,4 @@ Desktop「设置 → 模型供应商」的左栏(2026-10-08 用户裁决):
- 在手机上审批申请与管理分享;
- 按人设置用量上限或可用模型子集;
- 分享有效期;
-- 受邀者查看自己在某个分享上的用量。
+- 按人定制额度与用量可见范围(当前按供应商对全部受邀者统一开放,见 §7.5)。