Formerly KrillinAI, VideoTranslation and Dubbing Tool for 120+ Languages. Open-source AI workspace for creators, powered by Codex. Video downloader, video translation, create videos, images, audios, and edits with Agents in one place. For your Social Media like YouTube, TikTok, Instagram, etc.
TypeScript agent-skillscodex-clideskop-appdubbingimage-generationlocalizationskillsttsvideo-editingvideo-generationvideo-transcriptionvideo-translation
feat: implement anonymous desktop usage reporting
hbxugang995e71fee43b
diff --git a/apps/desktop/e2e/desktop.spec.ts b/apps/desktop/e2e/desktop.spec.tsindex 1bf93c4e..4be774a9 100644--- a/apps/desktop/e2e/desktop.spec.ts+++ b/apps/desktop/e2e/desktop.spec.ts@@ -18,6 +18,8 @@ import {} from 'node:path';import { execFileSync } from 'node:child_process';import { DatabaseSync } from 'node:sqlite';+import { createServer } from 'node:http';+import type { AddressInfo } from 'node:net';import { fileURLToPath } from 'node:url';import {expect,@@ -72,6 +74,60 @@ test('打包 App 将旧 Electron 数据当作无关数据且不迁移', async ()}});+test('实际 Desktop 包发送匿名日使用数据且不包含创作内容', async () => {+ const reports: Array<Record<string, unknown>> = [];+ const server = createServer((request, response) => {+ let body = '';+ request.setEncoding('utf8');+ request.on('data', chunk => {+ body += chunk;+ });+ request.on('end', () => {+ reports.push(JSON.parse(body) as Record<string, unknown>);+ response.writeHead(200, { 'Content-Type': 'application/json' });+ response.end('{"accepted":true}');+ });+ });+ await new Promise<void>((resolve, reject) => {+ server.once('error', reject);+ server.listen(0, '127.0.0.1', resolve);+ });+ const address = server.address() as AddressInfo;+ let fixture: DesktopFixture | undefined;++ try {+ fixture = await launchPackagedDesktop('success', {+ telemetryUrl: `http://127.0.0.1:${address.port}/api/v1/public/desktop-usage`+ });+ await expect.poll(() => reports.at(-1)).toMatchObject({+ usage_date: expect.stringMatching(/^\d{4}-\d{2}-\d{2}$/),+ launch_count: 1,+ active_minutes: 0,+ app_version: '3.1.0',+ operating_system: process.platform,+ architecture: process.arch,+ install_id: expect.stringMatching(/^[0-9a-f-]{36}$/)+ });+ expect(Object.keys(reports.at(-1) ?? {}).sort()).toEqual([+ 'active_minutes',+ 'app_version',+ 'architecture',+ 'install_id',+ 'launch_count',+ 'operating_system',+ 'usage_date'+ ]);+ expect(await fixture.page.evaluate(+ () => window.opencreatorDesktop?.readDesktopPreferences()+ )).toMatchObject({ telemetryEnabled: true });+ } finally {+ if (fixture !== undefined) await closeFixture(fixture);+ await new Promise<void>((resolve, reject) => {+ server.close(error => error === undefined ? resolve() : reject(error));+ });+ }+});+test('bundled 模式在最小 PATH 下忽略 nvm 安装的 Codex', async () => {const fixture = await launchPackagedDesktop('success', {codexLocation: 'nvm',@@ -981,6 +1037,7 @@ async function launchPackagedDesktop(runtimeMode?: 'bundled' | 'external';seedLegacyData?: boolean;writeCurrentConfig?: boolean;+ telemetryUrl?: string;} = {}): Promise<DesktopFixture> {const root = mkdtempSync(join(tmpdir(), 'opencreator-desktop-e2e-'));@@ -1037,6 +1094,9 @@ async function launchPackagedDesktop(OPENCREATOR_E2E_FAKE_CODEX_MODE: mode,OPENCREATOR_E2E_NODE_BINARY: process.execPath,OPENCREATOR_E2E_FAKE_CODEX_SCRIPT: fakeCodexScript,+ ...(options.telemetryUrl === undefined+ ? {}+ : { OPENCREATOR_TELEMETRY_URL: options.telemetryUrl }),...(mode === 'workspace-failure'? {OPENCREATOR_E2E_IGNORE_FIRST_WORKSPACE_READY: '1',diff --git a/apps/desktop/scripts/verify-package.mjs b/apps/desktop/scripts/verify-package.mjsindex b3ed3f54..fce7db46 100644--- a/apps/desktop/scripts/verify-package.mjs+++ b/apps/desktop/scripts/verify-package.mjs@@ -146,6 +146,7 @@ function assertAsarContents() {const entries = normalizedAsarEntries();const required = ['/dist/main/main.js',+ '/dist/main/telemetry.js','/dist/preload/index.cjs','/dist/bootstrap/index.html','/dist/shared/ipc.js'diff --git a/apps/desktop/src/main/main.ts b/apps/desktop/src/main/main.tsindex e082ec11..ff6fd81b 100644--- a/apps/desktop/src/main/main.ts+++ b/apps/desktop/src/main/main.ts@@ -30,6 +30,10 @@ import {registerPrivilegedSchemes} from './protocol-handler.js';import { createSettingsStore } from './settings-store.js';+import {+ startDesktopTelemetry,+ type DesktopTelemetryController+} from './telemetry.js';import { TrayManager } from './tray-manager.js';import { startUpdater } from './updater.js';import { WindowManager } from './window-manager.js';@@ -160,6 +164,15 @@ async function launchDesktop(): Promise<void> {),requestQuit: () => app.quit()});+ const telemetry = startDesktopTelemetry({+ path: join(dataDir, 'desktop-telemetry.json'),+ settings,+ logger,+ appVersion: app.getVersion(),+ isPackaged: app.isPackaged,+ isWindowActive: () => windowManager?.isActive() === true,+ endpointOverride: process.env.OPENCREATOR_TELEMETRY_URL+ });const navigate = (route: string) => {if (!workspaceLoaded) {pendingRoutes.push(route);@@ -213,6 +226,7 @@ async function launchDesktop(): Promise<void> {notifications,windowManager,settings,+ telemetry,dataDir,logDir,quit: () => app.quit(),@@ -253,6 +267,7 @@ async function launchDesktop(): Promise<void> {notifications.stop();windowManager?.flushState();settings.flush();+ await telemetry.reportNow();await logger.flush();await bootstrap?.stop();},@@ -284,6 +299,7 @@ async function launchDesktop(): Promise<void> {updater.dispose();tray.destroy();void Promise.all([+ telemetry.stop(),bootstrap?.stop() ?? Promise.resolve(),loginShellTask?.cancel() ?? Promise.resolve()])@@ -308,6 +324,7 @@ function registerIpcHandlers(input: {notifications: NotificationManager;windowManager: WindowManager;settings: ReturnType<typeof createSettingsStore>;+ telemetry: DesktopTelemetryController;dataDir: string;logDir: string;quit(): void;@@ -358,7 +375,8 @@ function registerIpcHandlers(input: {: failed(input.bootstrap.currentState.error?.message ?? 'Dashboard 加载失败');});handle(desktopIpc.readPreferences, input.development, () => ({- closeBehavior: input.settings.read().closeBehavior+ closeBehavior: input.settings.read().closeBehavior,+ telemetryEnabled: input.settings.read().telemetryEnabled}));handle(desktopIpc.updatePreferences, input.development, (_event, value: unknown) => {if (@@ -368,16 +386,25 @@ function registerIpcHandlers(input: {&& value.closeBehavior !== 'hide'&& value.closeBehavior !== 'quit')+ || (+ value.telemetryEnabled !== undefined+ && typeof value.telemetryEnabled !== 'boolean'+ )) {throw new Error('Desktop preferences are invalid');}const updated = input.settings.update({...(value.closeBehavior === undefined? {}- : { closeBehavior: value.closeBehavior })+ : { closeBehavior: value.closeBehavior }),+ ...(value.telemetryEnabled === undefined+ ? {}+ : { telemetryEnabled: value.telemetryEnabled })});+ if (value.telemetryEnabled === true) void input.telemetry.enable();return {- closeBehavior: updated.closeBehavior+ closeBehavior: updated.closeBehavior,+ telemetryEnabled: updated.telemetryEnabled};});handle(desktopIpc.openExternal, input.development, async (_event, url: unknown) => {diff --git a/apps/desktop/src/main/settings-store.ts b/apps/desktop/src/main/settings-store.tsindex 6115109f..64b54310 100644--- a/apps/desktop/src/main/settings-store.ts+++ b/apps/desktop/src/main/settings-store.ts@@ -10,7 +10,8 @@ import type { DesktopSettings } from '../shared/types.js';const defaultSettings: DesktopSettings = {closeBehavior: 'hide',- notificationsEnabled: true+ notificationsEnabled: true,+ telemetryEnabled: true};export type SettingsStore = {@@ -43,6 +44,10 @@ export function createSettingsStore(desktop: {closeBehavior: current.closeBehavior,notificationsEnabled: current.notificationsEnabled,+ telemetryEnabled: current.telemetryEnabled,+ ...(current.telemetryInstallId === undefined+ ? {}+ : { telemetryInstallId: current.telemetryInstallId }),...(current.codexBin === undefined ? {} : { codexBin: current.codexBin }),...(current.successfulCodexBin === undefined? {}@@ -73,7 +78,8 @@ function readSettings(...document,desktop: {closeBehavior: defaultSettings.closeBehavior,- notificationsEnabled: defaultSettings.notificationsEnabled+ notificationsEnabled: defaultSettings.notificationsEnabled,+ telemetryEnabled: defaultSettings.telemetryEnabled},runtime: {codexMode: 'bundled'@@ -96,8 +102,15 @@ function normalizeSettings(value: unknown): DesktopSettings {const closeBehavior = value.closeBehavior === 'quit' ? 'quit' : 'hide';const settings: DesktopSettings = {closeBehavior,- notificationsEnabled: value.notificationsEnabled !== false+ notificationsEnabled: value.notificationsEnabled !== false,+ telemetryEnabled: value.telemetryEnabled !== false};+ if (+ typeof value.telemetryInstallId === 'string'+ && /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value.telemetryInstallId)+ ) {+ settings.telemetryInstallId = value.telemetryInstallId;+ }if (typeof value.codexBin === 'string' && value.codexBin.length > 0) {settings.codexBin = value.codexBin;}diff --git a/apps/desktop/src/main/telemetry.ts b/apps/desktop/src/main/telemetry.tsnew file mode 100644index 00000000..aceb969d--- /dev/null+++ b/apps/desktop/src/main/telemetry.ts@@ -0,0 +1,280 @@+import { randomUUID } from 'node:crypto';+import { mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';+import { dirname } from 'node:path';+import type { DesktopLogger } from './logger.js';+import type { SettingsStore } from './settings-store.js';++const DEFAULT_TELEMETRY_URL = 'https://admin.clawee.work/api/v1/public/desktop-usage';+const ACTIVE_INTERVAL_MS = 60_000;+const REPORT_INTERVAL_MS = 6 * 60 * 60 * 1000;++type TelemetryDay = {+ date: string;+ launchCount: number;+ activeMinutes: number;+};++type TelemetryState = {+ days: TelemetryDay[];+};++export type TelemetryPersistence = {+ read(path: string): string;+ writeAtomic(path: string, contents: string): void;+};++export type DesktopTelemetryController = {+ enable(): Promise<void>;+ reportNow(): Promise<void>;+ stop(): Promise<void>;+ dispose(): void;+};++export function startDesktopTelemetry(input: {+ path: string;+ settings: SettingsStore;+ logger: DesktopLogger;+ appVersion: string;+ isPackaged: boolean;+ isWindowActive(): boolean;+ endpointOverride?: string;+ platform?: NodeJS.Platform;+ architecture?: string;+ now?(): Date;+ fetchImpl?: typeof fetch;+ persistence?: TelemetryPersistence;+ activeIntervalMs?: number;+ reportIntervalMs?: number;+}): DesktopTelemetryController {+ const now = input.now ?? (() => new Date());+ const store = createTelemetryStore(input.path, input.persistence);+ const endpoint = resolveTelemetryEndpoint(input.endpointOverride, input.isPackaged);+ const fetchImpl = input.fetchImpl ?? fetch;+ let launchRecorded = false;+ let stopped = false;+ let reportQueue = Promise.resolve();++ const installId = () => {+ const existing = input.settings.read().telemetryInstallId;+ if (existing !== undefined) return existing;+ const created = randomUUID();+ input.settings.update({ telemetryInstallId: created });+ return created;+ };+ const recordLaunch = () => {+ if (launchRecorded || !input.settings.read().telemetryEnabled) return;+ launchRecorded = true;+ store.incrementLaunch(usageDate(now()));+ };+ const sendReports = async () => {+ if (!input.settings.read().telemetryEnabled || endpoint === undefined) return;+ const currentInstallId = installId();+ const today = usageDate(now());+ for (const day of store.readDays(today)) {+ try {+ const response = await fetchImpl(endpoint, {+ method: 'POST',+ headers: {+ Accept: 'application/json',+ 'Content-Type': 'application/json'+ },+ body: JSON.stringify({+ install_id: currentInstallId,+ usage_date: day.date,+ launch_count: day.launchCount,+ active_minutes: day.activeMinutes,+ app_version: input.appVersion,+ operating_system: input.platform ?? process.platform,+ architecture: input.architecture ?? process.arch+ }),+ signal: AbortSignal.timeout(5_000)+ });+ if (!response.ok) {+ input.logger.warnRateLimited(+ 'desktop-telemetry-report',+ 'Desktop telemetry report was rejected',+ { status: response.status },+ REPORT_INTERVAL_MS+ );+ return;+ }+ store.removeReportedHistory(day.date, today);+ } catch (error) {+ input.logger.warnRateLimited(+ 'desktop-telemetry-report',+ 'Desktop telemetry report failed',+ { message: error instanceof Error ? error.message : String(error) },+ REPORT_INTERVAL_MS+ );+ return;+ }+ }+ };+ const reportNow = () => {+ const work = reportQueue.then(sendReports);+ reportQueue = work.catch(() => undefined);+ return work;+ };+ const clearTimers = () => {+ clearInterval(activeTimer);+ clearInterval(reportTimer);+ };++ recordLaunch();+ void reportNow();+ const activeTimer = setInterval(() => {+ if (!input.settings.read().telemetryEnabled || !input.isWindowActive()) return;+ store.incrementActiveMinute(usageDate(now()));+ }, input.activeIntervalMs ?? ACTIVE_INTERVAL_MS);+ activeTimer.unref();+ const reportTimer = setInterval(() => void reportNow(), input.reportIntervalMs ?? REPORT_INTERVAL_MS);+ reportTimer.unref();++ return {+ async enable() {+ recordLaunch();+ await reportNow();+ },+ reportNow,+ async stop() {+ if (!stopped) {+ stopped = true;+ clearTimers();+ }+ await reportNow();+ },+ dispose() {+ if (stopped) return;+ stopped = true;+ clearTimers();+ }+ };+}++export function resolveTelemetryEndpoint(+ override: string | undefined,+ isPackaged: boolean+): string | undefined {+ const value = override?.trim() || (isPackaged ? DEFAULT_TELEMETRY_URL : '');+ if (value === '') return undefined;+ try {+ const url = new URL(value);+ const localDevelopment = url.hostname === '127.0.0.1' || url.hostname === 'localhost';+ if (url.protocol !== 'https:' && !(localDevelopment && url.protocol === 'http:')) {+ return undefined;+ }+ return url.toString();+ } catch {+ return undefined;+ }+}++export function createTelemetryStore(+ path: string,+ persistence: TelemetryPersistence = fileTelemetryPersistence+) {+ let state = readTelemetryState(path, persistence);+ const write = () => persistence.writeAtomic(path, `${JSON.stringify(state, null, 2)}\n`);+ const updateDay = (+ date: string,+ update: (value: TelemetryDay) => TelemetryDay+ ) => {+ const existing = state.days.find(item => item.date === date);+ const updated = update(existing ?? { date, launchCount: 0, activeMinutes: 0 });+ state = {+ days: existing === undefined+ ? [...state.days, updated]+ : state.days.map(item => item.date === date ? updated : item)+ };+ };+ const prune = (today: string) => {+ const minimum = new Date(`${today}T00:00:00Z`);+ minimum.setUTCDate(minimum.getUTCDate() - 31);+ const minimumDate = minimum.toISOString().slice(0, 10);+ state = {+ days: state.days.filter(item => item.date >= minimumDate && item.date <= today)+ };+ };+ return {+ incrementLaunch(date: string) {+ updateDay(date, value => ({+ ...value,+ launchCount: value.launchCount + 1+ }));+ prune(date);+ write();+ },+ incrementActiveMinute(date: string) {+ updateDay(date, value => ({+ ...value,+ activeMinutes: Math.min(1440, value.activeMinutes + 1)+ }));+ prune(date);+ write();+ },+ readDays(today: string): TelemetryDay[] {+ prune(today);+ return state.days+ .filter(item => item.launchCount > 0)+ .sort((a, b) => a.date.localeCompare(b.date))+ .map(item => ({ ...item }));+ },+ removeReportedHistory(date: string, today: string) {+ if (date >= today) return;+ const remaining = state.days.filter(item => item.date !== date);+ if (remaining.length === state.days.length) return;+ state = { days: remaining };+ write();+ }+ };+}++function usageDate(now: Date): string {+ return new Date(now.getTime() + 8 * 60 * 60 * 1000).toISOString().slice(0, 10);+}++function readTelemetryState(+ path: string,+ persistence: TelemetryPersistence+): TelemetryState {+ try {+ const value = JSON.parse(persistence.read(path)) as unknown;+ if (!isRecord(value) || !Array.isArray(value.days)) return { days: [] };+ return {+ days: value.days.flatMap(item => {+ if (+ !isRecord(item)+ || typeof item.date !== 'string'+ || !/^\d{4}-\d{2}-\d{2}$/.test(item.date)+ || !Number.isInteger(item.launchCount)+ || (item.launchCount as number) < 0+ || !Number.isInteger(item.activeMinutes)+ || (item.activeMinutes as number) < 0+ ) {+ return [];+ }+ return [{+ date: item.date,+ launchCount: Math.min(10_000, item.launchCount as number),+ activeMinutes: Math.min(1440, item.activeMinutes as number)+ }];+ })+ };+ } catch {+ return { days: [] };+ }+}++const fileTelemetryPersistence: TelemetryPersistence = {+ read: path => readFileSync(path, 'utf8'),+ writeAtomic(path, contents) {+ mkdirSync(dirname(path), { recursive: true, mode: 0o700 });+ const temporaryPath = `${path}.${process.pid}.tmp`;+ writeFileSync(temporaryPath, contents, { mode: 0o600 });+ renameSync(temporaryPath, path);+ }+};++function isRecord(value: unknown): value is Record<string, unknown> {+ return typeof value === 'object' && value !== null && !Array.isArray(value);+}diff --git a/apps/desktop/src/shared/types.ts b/apps/desktop/src/shared/types.tsindex 1b3b3e46..b96d6330 100644--- a/apps/desktop/src/shared/types.ts+++ b/apps/desktop/src/shared/types.ts@@ -55,6 +55,8 @@ export type DesktopSettings = {externalCodexBin?: string;closeBehavior: 'hide' | 'quit';notificationsEnabled: boolean;+ telemetryEnabled: boolean;+ telemetryInstallId?: string;window?: {x?: number;y?: number;@@ -66,6 +68,7 @@ export type DesktopSettings = {export type DesktopPreferences = {closeBehavior: DesktopSettings['closeBehavior'];+ telemetryEnabled: boolean;};export const DESKTOP_TITLE_BAR_HEIGHT = 38;diff --git a/apps/desktop/test/settings-store.test.ts b/apps/desktop/test/settings-store.test.tsindex 87d367fe..a72e35a3 100644--- a/apps/desktop/test/settings-store.test.ts+++ b/apps/desktop/test/settings-store.test.ts@@ -27,7 +27,8 @@ describe('SettingsStore', () => {expect(store.read()).toMatchObject({closeBehavior: 'hide',- notificationsEnabled: true+ notificationsEnabled: true,+ telemetryEnabled: true});});@@ -42,7 +43,8 @@ describe('SettingsStore', () => {version: 1,desktop: {closeBehavior: 'hide',- notificationsEnabled: true+ notificationsEnabled: true,+ telemetryEnabled: true}},configured: {@@ -54,11 +56,19 @@ describe('SettingsStore', () => {};const store = createSettingsStore('/virtual/config.toml', persistence);- store.update({ closeBehavior: 'quit' });+ store.update({+ closeBehavior: 'quit',+ telemetryEnabled: false,+ telemetryInstallId: '123e4567-e89b-42d3-a456-426614174000'+ });expect(update).toHaveBeenCalledOnce();const apply = update.mock.calls[0]![1];expect(apply({ version: 1 }).desktop?.closeBehavior).toBe('quit');+ expect(apply({ version: 1 }).desktop).toMatchObject({+ telemetryEnabled: false,+ telemetryInstallId: '123e4567-e89b-42d3-a456-426614174000'+ });expect(store.read().closeBehavior).toBe('quit');});@@ -76,12 +86,14 @@ describe('SettingsStore', () => {expect(store.read()).toMatchObject({closeBehavior: 'hide',- notificationsEnabled: true+ notificationsEnabled: true,+ telemetryEnabled: true});const initialized = update.mock.calls[0];expect(initialized.desktop).toMatchObject({closeBehavior: 'hide',- notificationsEnabled: true+ notificationsEnabled: true,+ telemetryEnabled: true});expect(initialized.runtime).toMatchObject({codexMode: 'bundled'diff --git a/apps/desktop/test/telemetry.test.ts b/apps/desktop/test/telemetry.test.tsnew file mode 100644index 00000000..e410ca36--- /dev/null+++ b/apps/desktop/test/telemetry.test.ts@@ -0,0 +1,277 @@+import { describe, expect, it, vi } from 'vitest';+import { createServer } from 'node:http';+import type { AddressInfo } from 'node:net';+import type { DesktopLogger } from '../src/main/logger.js';+import type { SettingsStore } from '../src/main/settings-store.js';+import {+ createTelemetryStore,+ resolveTelemetryEndpoint,+ startDesktopTelemetry,+ type TelemetryPersistence+} from '../src/main/telemetry.js';+import type { DesktopSettings } from '../src/shared/types.js';++function memoryPersistence(initial = '') {+ let contents = initial;+ return {+ persistence: {+ read: () => {+ if (contents === '') throw new Error('missing');+ return contents;+ },+ writeAtomic: (_path: string, value: string) => {+ contents = value;+ }+ },+ read: () => contents+ };+}++function memorySettings(+ initial: Partial<DesktopSettings> = {}+): SettingsStore {+ let settings: DesktopSettings = {+ closeBehavior: 'hide',+ notificationsEnabled: true,+ telemetryEnabled: true,+ ...initial+ };+ return {+ read: () => structuredClone(settings),+ update: patch => {+ settings = { ...settings, ...patch };+ return structuredClone(settings);+ },+ flush: () => undefined+ };+}++function logger(): DesktopLogger {+ return {+ info: vi.fn(),+ warn: vi.fn(),+ error: vi.fn(),+ warnRateLimited: vi.fn(),+ flush: vi.fn(async () => undefined)+ };+}++describe('desktop telemetry', () => {+ it('keeps daily launch and active-minute counters', () => {+ const memory = memoryPersistence();+ const store = createTelemetryStore(+ '/virtual/telemetry.json',+ memory.persistence as TelemetryPersistence+ );++ store.incrementLaunch('2026-09-07');+ store.incrementActiveMinute('2026-09-07');+ store.incrementActiveMinute('2026-09-07');++ expect(JSON.parse(memory.read())).toEqual({+ days: [{ date: '2026-09-07', launchCount: 1, activeMinutes: 2 }]+ });+ });++ it('reports only the anonymous daily usage contract', async () => {+ const telemetryMemory = memoryPersistence();+ const settings = memorySettings();+ const requests: Array<{ url: string; body: Record<string, unknown> }> = [];+ const fetchImpl: typeof fetch = async (url, init) => {+ requests.push({+ url: String(url),+ body: JSON.parse(String(init?.body)) as Record<string, unknown>+ });+ return new Response('{}', { status: 200 });+ };+ const controller = startDesktopTelemetry({+ path: '/virtual/telemetry.json',+ settings,+ logger: logger(),+ appVersion: '3.0.1',+ isPackaged: false,+ endpointOverride: 'http://127.0.0.1:8790/api/v1/public/desktop-usage',+ platform: 'darwin',+ architecture: 'arm64',+ now: () => new Date('2026-09-07T02:00:00Z'),+ isWindowActive: () => false,+ fetchImpl,+ persistence: telemetryMemory.persistence as TelemetryPersistence+ });++ await controller.reportNow();+ controller.dispose();++ expect(requests.length).toBeGreaterThan(0);+ expect(requests.at(-1)?.url).toBe(+ 'http://127.0.0.1:8790/api/v1/public/desktop-usage'+ );+ expect(requests.at(-1)?.body).toMatchObject({+ usage_date: '2026-09-07',+ launch_count: 1,+ active_minutes: 0,+ app_version: '3.0.1',+ operating_system: 'darwin',+ architecture: 'arm64'+ });+ expect(requests.at(-1)?.body.install_id).toMatch(/^[0-9a-f-]{36}$/);+ expect(requests.at(-1)?.body).not.toHaveProperty('source_ip');+ expect(requests.at(-1)?.body).not.toHaveProperty('project');+ expect(requests.at(-1)?.body).not.toHaveProperty('conversation');+ });++ it('only permits HTTPS and local HTTP endpoints', () => {+ expect(resolveTelemetryEndpoint('https://admin.example.com/report', false))+ .toBe('https://admin.example.com/report');+ expect(resolveTelemetryEndpoint('http://127.0.0.1:8790/report', false))+ .toBe('http://127.0.0.1:8790/report');+ expect(resolveTelemetryEndpoint('http://public.example.com/report', false))+ .toBeUndefined();+ expect(resolveTelemetryEndpoint(undefined, false)).toBeUndefined();+ expect(resolveTelemetryEndpoint(undefined, true))+ .toBe('https://admin.clawee.work/api/v1/public/desktop-usage');+ });++ it('sends the report through a real local HTTP connection', async () => {+ const bodies: Array<Record<string, unknown>> = [];+ const server = createServer((request, response) => {+ let body = '';+ request.setEncoding('utf8');+ request.on('data', chunk => {+ body += chunk;+ });+ request.on('end', () => {+ bodies.push(JSON.parse(body) as Record<string, unknown>);+ response.writeHead(200, { 'Content-Type': 'application/json' });+ response.end('{"accepted":true}');+ });+ });+ await new Promise<void>((resolve, reject) => {+ server.once('error', reject);+ server.listen(0, '127.0.0.1', resolve);+ });+ const address = server.address() as AddressInfo;+ const telemetryMemory = memoryPersistence();+ const controller = startDesktopTelemetry({+ path: '/virtual/telemetry.json',+ settings: memorySettings(),+ logger: logger(),+ appVersion: '3.0.1',+ isPackaged: false,+ endpointOverride: `http://127.0.0.1:${address.port}/api/v1/public/desktop-usage`,+ now: () => new Date('2026-09-07T02:00:00Z'),+ isWindowActive: () => false,+ persistence: telemetryMemory.persistence as TelemetryPersistence+ });++ try {+ await controller.reportNow();+ } finally {+ controller.dispose();+ await new Promise<void>((resolve, reject) => {+ server.close(error => error === undefined ? resolve() : reject(error));+ });+ }++ expect(bodies.at(-1)).toMatchObject({+ usage_date: '2026-09-07',+ launch_count: 1,+ active_minutes: 0,+ app_version: '3.0.1'+ });+ });++ it('does not create an identifier or send while telemetry is disabled', async () => {+ const telemetryMemory = memoryPersistence();+ const settings = memorySettings({ telemetryEnabled: false });+ const fetchImpl = vi.fn<typeof fetch>();+ const controller = startDesktopTelemetry({+ path: '/virtual/telemetry.json',+ settings,+ logger: logger(),+ appVersion: '3.0.1',+ isPackaged: true,+ isWindowActive: () => true,+ fetchImpl,+ persistence: telemetryMemory.persistence as TelemetryPersistence+ });++ await controller.reportNow();+ controller.dispose();++ expect(fetchImpl).not.toHaveBeenCalled();+ expect(settings.read().telemetryInstallId).toBeUndefined();+ expect(telemetryMemory.read()).toBe('');+ });++ it('removes reported history while retaining the current daily counters', async () => {+ const telemetryMemory = memoryPersistence(JSON.stringify({+ days: [+ { date: '2026-09-06', launchCount: 1, activeMinutes: 20 },+ { date: '2026-09-07', launchCount: 1, activeMinutes: 5 }+ ]+ }));+ const reportedDates: string[] = [];+ const controller = startDesktopTelemetry({+ path: '/virtual/telemetry.json',+ settings: memorySettings(),+ logger: logger(),+ appVersion: '3.0.1',+ isPackaged: true,+ now: () => new Date('2026-09-07T02:00:00Z'),+ isWindowActive: () => false,+ fetchImpl: async (_url, init) => {+ const body = JSON.parse(String(init?.body)) as { usage_date: string };+ reportedDates.push(body.usage_date);+ return new Response('{}', { status: 200 });+ },+ persistence: telemetryMemory.persistence as TelemetryPersistence+ });++ await controller.reportNow();+ controller.dispose();++ expect(reportedDates).toEqual([+ '2026-09-06',+ '2026-09-07',+ '2026-09-07'+ ]);+ expect(JSON.parse(telemetryMemory.read())).toEqual({+ days: [{ date: '2026-09-07', launchCount: 2, activeMinutes: 5 }]+ });+ });++ it('reports active minutes again while stopping', async () => {+ vi.useFakeTimers();+ try {+ const telemetryMemory = memoryPersistence();+ const requests: Array<Record<string, unknown>> = [];+ const controller = startDesktopTelemetry({+ path: '/virtual/telemetry.json',+ settings: memorySettings(),+ logger: logger(),+ appVersion: '3.0.1',+ isPackaged: true,+ isWindowActive: () => true,+ now: () => new Date('2026-09-07T02:00:00Z'),+ fetchImpl: async (_url, init) => {+ requests.push(JSON.parse(String(init?.body)) as Record<string, unknown>);+ return new Response('{}', { status: 200 });+ },+ persistence: telemetryMemory.persistence as TelemetryPersistence,+ activeIntervalMs: 10,+ reportIntervalMs: 100_000+ });+ await controller.reportNow();+ requests.length = 0;++ await vi.advanceTimersByTimeAsync(10);+ await controller.stop();++ expect(requests).toHaveLength(1);+ expect(requests[0]).toMatchObject({ active_minutes: 1 });+ } finally {+ vi.useRealTimers();+ }+ });+});diff --git a/apps/web/src/app/AppController.tsx b/apps/web/src/app/AppController.tsxindex e75a38c0..933c27bd 100644--- a/apps/web/src/app/AppController.tsx+++ b/apps/web/src/app/AppController.tsx@@ -585,6 +585,9 @@ export function AppController(props: AppControllerProps) {const [desktopCloseBehavior, setDesktopCloseBehavior] = useState<'hide' | 'quit' | undefined>(undefined);+ const [desktopTelemetryEnabled, setDesktopTelemetryEnabled] = useState<+ boolean | undefined+ >(undefined);const [unreadTaskIds, setUnreadTaskIds] = useState<Set<string>>(() => notificationService.getUnreadIds());@@ -866,6 +869,7 @@ export function AppController(props: AppControllerProps) {|| hostBridge.readDesktopPreferences === undefined) {setDesktopCloseBehavior(undefined);+ setDesktopTelemetryEnabled(undefined);return () => {active = false;};@@ -874,6 +878,7 @@ export function AppController(props: AppControllerProps) {.then(preferences => {if (active) {setDesktopCloseBehavior(preferences.closeBehavior);+ setDesktopTelemetryEnabled(preferences.telemetryEnabled);}}).catch(() => undefined);@@ -4400,6 +4405,16 @@ export function AppController(props: AppControllerProps) {.then(preferences => setDesktopCloseBehavior(preferences.closeBehavior)).catch(() => setDesktopCloseBehavior(previous));}}+ desktopTelemetryEnabled={desktopTelemetryEnabled}+ onDesktopTelemetryEnabledChange={(enabled: boolean) => {+ const update = hostBridge.updateDesktopPreferences;+ if (update === undefined) return;+ const previous = desktopTelemetryEnabled;+ setDesktopTelemetryEnabled(enabled);+ void update({ telemetryEnabled: enabled })+ .then(preferences => setDesktopTelemetryEnabled(preferences.telemetryEnabled))+ .catch(() => setDesktopTelemetryEnabled(previous));+ }}profileService={profileService}profileData={codexProfiles}onProfileDataChange={setCodexProfiles}diff --git a/apps/web/src/features/settings/OpenCreatorSettingsView.test.tsx b/apps/web/src/features/settings/OpenCreatorSettingsView.test.tsxindex f2e723e6..c399536f 100644--- a/apps/web/src/features/settings/OpenCreatorSettingsView.test.tsx+++ b/apps/web/src/features/settings/OpenCreatorSettingsView.test.tsx@@ -217,6 +217,25 @@ describe('OpenCreatorSettingsView', () => {expect(onDesktopCloseBehaviorChange).toHaveBeenCalledWith('quit');});+ it('shows the anonymous telemetry scope and allows Desktop users to disable it', () => {+ const onDesktopTelemetryEnabledChange = vi.fn();+ render(+ <OpenCreatorSettingsView+ runtimeStatus={runtimeStatus}+ desktopCloseBehavior="hide"+ desktopTelemetryEnabled+ onDesktopTelemetryEnabledChange={onDesktopTelemetryEnabledChange}+ onBack={vi.fn()}+ />+ );++ const telemetry = screen.getByRole('switch', { name: /发送匿名使用数据/ });+ expect(telemetry).toBeChecked();+ fireEvent.click(telemetry);+ expect(onDesktopTelemetryEnabledChange).toHaveBeenCalledWith(false);+ expect(screen.getByText(/不包含项目、文件或对话内容/)).toBeInTheDocument();+ });+it('does not show Codex CLI version on the initial general tab', () => {render(<OpenCreatorSettingsView runtimeStatus={runtimeStatus} onBack={vi.fn()} />);diff --git a/apps/web/src/features/settings/OpenCreatorSettingsView.tsx b/apps/web/src/features/settings/OpenCreatorSettingsView.tsxindex 76bbdece..bdd317bf 100644--- a/apps/web/src/features/settings/OpenCreatorSettingsView.tsx+++ b/apps/web/src/features/settings/OpenCreatorSettingsView.tsx@@ -57,6 +57,8 @@ export type OpenCreatorSettingsViewProps = {onCustomAccentColorChange?(color: string): void;desktopCloseBehavior?: 'hide' | 'quit';onDesktopCloseBehaviorChange?(behavior: 'hide' | 'quit'): void;+ desktopTelemetryEnabled?: boolean;+ onDesktopTelemetryEnabledChange?(enabled: boolean): void;profileService?: ProfileSettingsService | null;profileData?: CodexProfileListResponse;onProfileDataChange?(data: CodexProfileListResponse): void;@@ -148,6 +150,8 @@ export function OpenCreatorSettingsView(props: OpenCreatorSettingsViewProps) {onCustomAccentColorChange={props.onCustomAccentColorChange}desktopCloseBehavior={props.desktopCloseBehavior}onDesktopCloseBehaviorChange={props.onDesktopCloseBehaviorChange}+ desktopTelemetryEnabled={props.desktopTelemetryEnabled}+ onDesktopTelemetryEnabledChange={props.onDesktopTelemetryEnabledChange}/>) : null}{activeTab === 'ai-services' ? (@@ -212,6 +216,8 @@ function GeneralSettings(props: {onCustomAccentColorChange?(color: string): void;desktopCloseBehavior?: 'hide' | 'quit';onDesktopCloseBehaviorChange?(behavior: 'hide' | 'quit'): void;+ desktopTelemetryEnabled?: boolean;+ onDesktopTelemetryEnabledChange?(enabled: boolean): void;}) {const { language, preference, setPreference, t } = useAppLanguage();const confirm = useConfirmDialog();@@ -298,6 +304,24 @@ function GeneralSettings(props: {</select></label>)}+ {props.desktopTelemetryEnabled === undefined ? null : (+ <label className="settings-row settings-control-row" htmlFor="settings-desktop-telemetry">+ <span>+ {t('settings.telemetry')}+ <small className="settings-row-description">+ {t('settings.telemetryDescription')}+ </small>+ </span>+ <input+ id="settings-desktop-telemetry"+ className="settings-switch"+ type="checkbox"+ role="switch"+ checked={props.desktopTelemetryEnabled}+ onChange={event => props.onDesktopTelemetryEnabledChange?.(event.target.checked)}+ />+ </label>+ )}</div>{props.defaultPermissionError ? (<p className="settings-error" role="alert">{props.defaultPermissionError}</p>diff --git a/apps/web/src/host/bridge.ts b/apps/web/src/host/bridge.tsindex 9b706dc9..9240e0d4 100644--- a/apps/web/src/host/bridge.ts+++ b/apps/web/src/host/bridge.ts@@ -16,6 +16,7 @@ export type BackgroundNotificationConfiguration =export type DesktopPreferences = {closeBehavior: 'hide' | 'quit';+ telemetryEnabled: boolean;};export type HostWindowChrome = {diff --git a/apps/web/src/host/desktop-bridge.ts b/apps/web/src/host/desktop-bridge.tsindex 75120bd6..4a55db98 100644--- a/apps/web/src/host/desktop-bridge.ts+++ b/apps/web/src/host/desktop-bridge.ts@@ -22,11 +22,14 @@ type DesktopApi = {workspaceReady(): void;readDesktopPreferences(): Promise<{closeBehavior: 'hide' | 'quit';+ telemetryEnabled: boolean;}>;updateDesktopPreferences(preferences: {closeBehavior?: 'hide' | 'quit';+ telemetryEnabled?: boolean;}): Promise<{closeBehavior: 'hide' | 'quit';+ telemetryEnabled: boolean;}>;selectProjectDirectory(): Promise<string | null>;resolveDroppedFilePath(file: File): string | null;diff --git a/apps/web/src/i18n/LanguageProvider.tsx b/apps/web/src/i18n/LanguageProvider.tsxindex 8a7f29d3..b4dc1dea 100644--- a/apps/web/src/i18n/LanguageProvider.tsx+++ b/apps/web/src/i18n/LanguageProvider.tsx@@ -64,6 +64,8 @@ const messages = {'settings.closeWindow': '关闭窗口时','settings.hideToMenuBar': '隐藏到菜单栏','settings.quit': '退出 OpenCreator',+ 'settings.telemetry': '发送匿名使用数据',+ 'settings.telemetryDescription': '发送启动次数、活跃时长、版本和系统信息;服务端会记录请求来源 IP,不包含项目、文件或对话内容。','settings.accent.neutral': '默认灰','settings.accent.blue': '蓝色','settings.accent.cyan': '青色',@@ -308,6 +310,8 @@ const messages = {'settings.closeWindow': 'When closing the window','settings.hideToMenuBar': 'Hide in menu bar','settings.quit': 'Quit OpenCreator',+ 'settings.telemetry': 'Send anonymous usage data',+ 'settings.telemetryDescription': 'Send launch count, active time, version, and system information. The server records the request IP; projects, files, and conversations are not included.','settings.accent.neutral': 'Neutral','settings.accent.blue': 'Blue','settings.accent.cyan': 'Cyan',diff --git a/packages/config/src/index.test.ts b/packages/config/src/index.test.tsindex 19ce0fa2..691d3da8 100644--- a/packages/config/src/index.test.ts+++ b/packages/config/src/index.test.ts@@ -1,5 +1,6 @@import {mkdtempSync,+ readFileSync,rmSync} from 'node:fs';import { tmpdir } from 'node:os';@@ -7,8 +8,10 @@ import { join } from 'node:path';import { afterEach, describe, expect, it } from 'vitest';import {readOpenCreatorConfig,+ resolveDesktopConfig,resolveOpenCreatorPaths,resolveUiSettings,+ updateOpenCreatorConfig,updateOpenCreatorUiSettings} from './index.js';@@ -63,4 +66,29 @@ describe('OpenCreator config', () => {expect(resolveUiSettings(readOpenCreatorConfig(path)).colorMode).toBe('light');});++ it('persists anonymous telemetry preferences and the install identifier', () => {+ const root = mkdtempSync(join(tmpdir(), 'opencreator-config-'));+ tempDirs.push(root);+ const path = join(root, 'config.toml');+ const telemetryInstallId = '123e4567-e89b-42d3-a456-426614174000';++ updateOpenCreatorConfig(path, document => ({+ ...document,+ desktop: {+ closeBehavior: 'hide',+ notificationsEnabled: true,+ telemetryEnabled: false,+ telemetryInstallId+ }+ }));++ const source = readFileSync(path, 'utf8');+ expect(source).toContain('telemetry_enabled = false');+ expect(source).toContain(`telemetry_install_id = "${telemetryInstallId}"`);+ expect(resolveDesktopConfig(readOpenCreatorConfig(path))).toMatchObject({+ telemetryEnabled: false,+ telemetryInstallId+ });+ });});diff --git a/packages/config/src/index.ts b/packages/config/src/index.tsindex c95cadf4..c6dda357 100644--- a/packages/config/src/index.ts+++ b/packages/config/src/index.ts@@ -35,6 +35,8 @@ export type OpenCreatorRuntimeChannel = 'production' | 'development';export type OpenCreatorDesktopConfig = {closeBehavior: 'hide' | 'quit';notificationsEnabled: boolean;+ telemetryEnabled: boolean;+ telemetryInstallId?: string;codexBin?: string;successfulCodexBin?: string;window?: {@@ -79,7 +81,8 @@ const defaultUiSettings: OpenCreatorUiSettings = {const defaultDesktopConfig: OpenCreatorDesktopConfig = {closeBehavior: 'hide',- notificationsEnabled: true+ notificationsEnabled: true,+ telemetryEnabled: true};const defaultRuntimeConfig: OpenCreatorRuntimeConfig = {@@ -264,6 +267,14 @@ function normalizeDesktopConfig(value: unknown): OpenCreatorDesktopConfig {return {closeBehavior: (source.closeBehavior ?? source.close_behavior) === 'quit' ? 'quit' : 'hide',notificationsEnabled: (source.notificationsEnabled ?? source.notifications_enabled) !== false,+ telemetryEnabled: (source.telemetryEnabled ?? source.telemetry_enabled) !== false,+ ...(validUuid(source.telemetryInstallId ?? source.telemetry_install_id) === undefined+ ? {}+ : {+ telemetryInstallId: validUuid(+ source.telemetryInstallId ?? source.telemetry_install_id+ )+ }),...(nonEmptyString(source.codexBin ?? source.codex_bin) === undefined? {}: { codexBin: nonEmptyString(source.codexBin ?? source.codex_bin) }),@@ -328,6 +339,10 @@ function serializeDesktop(value: OpenCreatorDesktopConfig): Record<string, unknoreturn {close_behavior: value.closeBehavior,notifications_enabled: value.notificationsEnabled,+ telemetry_enabled: value.telemetryEnabled,+ ...(value.telemetryInstallId === undefined+ ? {}+ : { telemetry_install_id: value.telemetryInstallId }),...(value.codexBin === undefined ? {} : { codex_bin: value.codexBin }),...(value.successfulCodexBin === undefined? {}@@ -393,6 +408,16 @@ function nonEmptyString(value: unknown): string | undefined {return typeof value === 'string' && value.trim().length > 0 ? value : undefined;}+function validUuid(value: unknown): string | undefined {+ if (+ typeof value !== 'string'+ || !/^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value)+ ) {+ return undefined;+ }+ return value;+}+function isRecord(value: unknown): value is Record<string, any> {return typeof value === 'object' && value !== null && !Array.isArray(value);}