@tencent-ai/agent-harness 0.2.0-beta.7 → 0.2.0-beta.8

package/cli/dist-server/types/node/stats/insights-report-service.d.ts

@@ -0,0 +1,17 @@
+import { InsightsReportService } from './insights-protocol';
+export declare class InsightsReportServiceImpl implements InsightsReportService {
+    generateReport(insightsData: Record<string, unknown>, language?: string): Promise<string>;
+    private buildHtml;
+    private esc;
+    /** Escape HTML then render basic markdown: **bold**, \n\n → paragraphs, \n → <br> */
+    private md;
+    private buildProjectAreas;
+    private buildBarChart;
+    private buildModelChart;
+    private buildBigWins;
+    private buildFrictionCategories;
+    private buildCodebuddyMdSection;
+    private buildFeatureCards;
+    private buildPatternCards;
+    private buildHorizonCards;
+}

package/cli/dist-server/types/node/stats/session-facet-service.d.ts

@@ -0,0 +1,46 @@
+import { Logger } from '../../workspace/telemetry/lib/common/index.js';
+import { PromptRenderer } from '../../vendor/cbc-core/node/index.js';
+import { SessionFacet, SessionFacetService, SessionAnalysisProgressCallback } from './insights-protocol';
+export declare class SessionFacetServiceImpl implements SessionFacetService {
+    protected readonly promptRenderer: PromptRenderer;
+    protected readonly logger: Logger;
+    getFacetsDir(): string;
+    analyzeAllSessions(language?: string, onProgress?: SessionAnalysisProgressCallback, signal?: AbortSignal): Promise<SessionFacet[]>;
+    /**
+     * 加载 facets 目录下所有已有的 facet JSON
+     */
+    private loadExistingFacets;
+    /**
+     * 分批处理需要分析的 session 文件
+     * 对每个文件：读取历史 → 构建 transcript → 分析 → 保存 facet
+     */
+    private analyzeFilesBatched;
+    /**
+     * 直接从文件读取 session 历史并分析
+     * 不需要完整的 Session 对象反序列化，只读取足够构建 transcript 的历史条目
+     */
+    private analyzeSessionFile;
+    /**
+     * 保存错误标记 facet，避免反复重试失败的 session
+     * 下次运行时如果 session 文件没被修改，就跳过
+     */
+    private saveErrorFacet;
+    /**
+     * 从历史条目构建可读的 transcript 文本
+     * 限制大小避免 prompt 过长
+     */
+    private buildTranscriptFromHistory;
+    /**
+     * 从 content 字段提取纯文本
+     */
+    private extractText;
+    /**
+     * 按行读取 .jsonl 文件，只解析前 maxLines 条有效记录
+     * 使用 readline 流式读取，避免将整个大文件加载到内存
+     */
+    private readHistoryLines;
+    /**
+     * 解析模型返回的 JSON
+     */
+    private parseJsonResponse;
+}

package/cli/dist-server/types/node/stats/stats-protocol.d.ts

@@ -0,0 +1,145 @@
+/**
+ * 统计服务协议
+ * 定义会话统计计算和报告的接口
+ */
+export declare const StatsService: unique symbol;
+/**
+ * 连续活跃天数信息
+ */
+export interface StreakInfo {
+    /** 当前连续活跃天数（从今天往回算） */
+    currentStreak: number;
+    /** 历史最长连续活跃天数 */
+    longestStreak: number;
+    /** 当前连续活跃的起始日期（YYYY-MM-DD 格式），无当前连续则为 null */
+    currentStreakStart: string | null;
+    /** 最长连续活跃的起始日期（YYYY-MM-DD 格式），无活动记录则为 null */
+    longestStreakStart: string | null;
+    /** 最长连续活跃的结束日期（YYYY-MM-DD 格式），无活动记录则为 null */
+    longestStreakEnd: string | null;
+}
+/**
+ * 单日活动统计
+ */
+export interface DailyActivity {
+    /** 日期（YYYY-MM-DD 格式） */
+    date: string;
+    /** 消息总数（user、assistant、system 等） */
+    messageCount: number;
+    /** 当天有活动的会话数量 */
+    sessionCount: number;
+    /** 当天工具调用次数 */
+    toolCallCount: number;
+}
+/**
+ * 每日各模型的 token 使用量
+ */
+export interface DailyModelTokens {
+    /** 日期（YYYY-MM-DD 格式） */
+    date: string;
+    /** 模型名称到总 token 数（输入+输出）的映射 */
+    tokensByModel: Record<string, number>;
+}
+/**
+ * 工具使用统计
+ */
+export interface ToolUsageStats {
+    /** 工具名称（如 "Read"、"Write"、"Bash"、"TodoWrite"） */
+    toolName: string;
+    /** 该工具被调用的总次数 */
+    count: number;
+}
+/**
+ * 最长会话信息
+ */
+export interface LongestSession {
+    /** 会话唯一标识符 */
+    sessionId: string;
+    /** 会话时长（毫秒） */
+    duration: number;
+    /** 会话中的消息数量 */
+    messageCount: number;
+    /** 会话开始时间（ISO-8601 格式） */
+    timestamp: string;
+}
+/**
+ * 单个模型的聚合使用统计
+ */
+export interface ModelUsage {
+    /**
+     * 模型展示名（来源 providerData.requestModelName，对应用户在 product.json 中
+     * 配置的 displayName）。前端展示时优先使用此字段，避免直接展示 alias / 物理 endpoint id。
+     * 兼容旧数据：旧 session 没有 requestModelName 时为 undefined。
+     */
+    displayName?: string;
+    /** 该模型消耗的总输入 token 数 */
+    inputTokens: number;
+    /** 该模型生成的总输出 token 数 */
+    outputTokens: number;
+    /** 从缓存读取的 token 数（可降低 API 成本） */
+    cacheReadInputTokens: number;
+    /** 写入缓存供后续使用的 token 数 */
+    cacheCreationInputTokens: number;
+    /** 网络搜索请求次数（如适用） */
+    webSearchRequests: number;
+    /** 估算的美元成本（无法计算时为 0） */
+    costUSD: number;
+    /** 使用的上下文窗口大小（未跟踪时为 0） */
+    contextWindow: number;
+}
+/**
+ * StatsService.calculateStats() 返回的完整统计结果
+ */
+export interface StatsResult {
+    /** 会话总数 */
+    totalSessions: number;
+    /**
+     * 所有会话的有效消息总数
+     * 仅统计 type 为 message 且 role 为 user|assistant|system 的消息
+     * 且 isSidechain 不为 true
+     */
+    totalMessages: number;
+    /**
+     * 从首次会话到最后会话的总天数
+     * 计算方式：(lastTimestamp - firstTimestamp) / 每天毫秒数
+     */
+    totalDays: number;
+    /** 有至少一条消息的唯一日期数 */
+    activeDays: number;
+    /** 连续活跃天数信息 */
+    streaks: StreakInfo;
+    /** 每日活动统计数组，按日期升序排列 */
+    dailyActivity: DailyActivity[];
+    /** 每日各模型 token 使用量数组，按日期升序排列 */
+    dailyModelTokens: DailyModelTokens[];
+    /** 工具使用统计数组，按使用次数降序排列 */
+    toolUsage: ToolUsageStats[];
+    /** 时长最长的会话信息，无会话时为 null */
+    longestSession: LongestSession | null;
+    /** 平均会话时长（毫秒） */
+    averageSessionDuration: number;
+    /**
+     * 各模型聚合使用统计，以"请求模型 id"为键
+     * （即 providerData.requestModelId，对应 product.json 中配置的 model id；
+     * 兼容旧数据时 fallback 到 providerData.model 即 endpoint 返回的物理模型名）
+     */
+    modelUsage: Record<string, ModelUsage>;
+    /** 首次会话时间（ISO-8601 格式），无会话时为 null */
+    firstSessionDate: string | null;
+    /** 最后会话时间（ISO-8601 格式），无会话时为 null */
+    lastSessionDate: string | null;
+    /** 消息最多的日期（YYYY-MM-DD 格式），无活动时为 null */
+    peakActivityDay: string | null;
+    /** 消息最多的小时（0-23），无活动时为 null */
+    peakActivityHour: number | null;
+}
+/**
+ * 统计服务接口，用于计算会话统计数据
+ */
+export interface StatsService {
+    /**
+     * 计算所有存储会话的综合统计数据
+     * @returns Promise，解析为完整统计结果
+     */
+    calculateStats(): Promise<StatsResult>;
+}

package/cli/dist-server/types/node/stats/stats-service.d.ts

@@ -0,0 +1,48 @@
+import { Logger } from '@celljs/core';
+import { SessionStore } from '../../vendor/cbc-core/node/index.js';
+import { StatsResult, StatsService } from './stats-protocol';
+export declare class StatsServiceImpl implements StatsService {
+    protected readonly logger: Logger;
+    protected readonly sessionStore: SessionStore;
+    /**
+     * 计算所有存储会话的综合统计数据（跨所有项目）
+     */
+    calculateStats(): Promise<StatsResult>;
+    /**
+     * 获取空的统计结果
+     */
+    private getEmptyStatsResult;
+    /**
+     * 获取默认的模型使用量条目
+     */
+    private getDefaultModelUsage;
+    /**
+     * 检查 item 是否为有效的消息（过滤掉特殊 type）
+     */
+    private isValidMessage;
+    /**
+     * 检查 session 是否为老对话
+     * 如果所有 assistant 类型的消息都没有 providerData.requestModelId 也没有 providerData.model 字段，则认为是老对话
+     */
+    private isLegacySession;
+    /**
+     * 检查 item 是否为助手消息
+     */
+    private isAssistantMessage;
+    /**
+     * 检查 item 是否为工具调用
+     */
+    private isToolCall;
+    /**
+     * 从 item 中提取时间戳（毫秒）
+     */
+    private getTimestampMs;
+    /**
+     * 将时间戳转换为 YYYY-MM-DD 格式
+     */
+    private getDateFromTimestamp;
+    /**
+     * 从活跃日期集合中计算连续天数信息
+     */
+    private calculateStreaks;
+}

package/cli/dist-server/types/node/telemetry/cost-protocol.d.ts

@@ -0,0 +1,67 @@
+import { Event } from '@celljs/core';
+export declare const CostService: unique symbol;
+export interface FileChangeStats {
+    totalAddedLines: number;
+    totalDeletedLines: number;
+    totalAddedCharacters: number;
+    totalDeletedCharacters: number;
+}
+export interface TokenUsageByModel {
+    [modelId: string]: {
+        inputTokens: number;
+        outputTokens: number;
+        cachedReadTokens: number;
+        cachedWriteTokens: number;
+        modelName: string;
+    };
+}
+export interface CostStatistics {
+    startupTime: number;
+    apiDuration: number;
+    runningTime: number;
+    fileChangeStats: FileChangeStats;
+    tokenUsageByModel: TokenUsageByModel;
+}
+export interface CostService {
+    onDidChangeCost: Event<void>;
+    /**
+     * 获取应用启动时间
+     */
+    getStartupTime(): number;
+    /**
+     * 获取当前运行时长（毫秒）
+     */
+    getRunningTime(): number;
+    /**
+     * 记录文件变更统计
+     */
+    recordFileChange(addedLines: number, deletedLines: number, addedChars: number, deletedChars: number): void;
+    /**
+     * 获取文件变更统计
+     */
+    getFileChangeStats(): FileChangeStats;
+    /**
+     * 记录Token使用统计
+     */
+    recordTokenUsage(modelId: string, modelName: string, inputTokens: number, outputTokens: number, cachedReadTokens: number, cachedWriteTokens: number): void;
+    /**
+     * 获取按模型分组的Token使用统计
+     */
+    getTokenUsageByModel(): TokenUsageByModel;
+    /**
+     * 记录 API 调用时长
+     */
+    recordAPIDuration(duration: number): void;
+    /**
+     * 获取完整的使用统计
+     */
+    getAllStatistics(): CostStatistics;
+    /**
+     * 重置统计数据
+     */
+    resetStatistics(): void;
+    /**
+     * 格式化成本信息
+     */
+    formatCostInfo(): string;
+}

package/cli/dist-server/types/node/telemetry/cost-service.d.ts

@@ -0,0 +1,21 @@
+import { CostService, CostStatistics, FileChangeStats, TokenUsageByModel } from './cost-protocol';
+export declare class CostServiceImpl implements CostService {
+    private readonly _onDidChangeCost;
+    readonly onDidChangeCost: import("@celljs/core").Event<void>;
+    private startupTime;
+    private apiDuration;
+    private fileChangeStats;
+    private tokenUsageByModel;
+    init(): void;
+    getStartupTime(): number;
+    getRunningTime(): number;
+    recordFileChange(addedLines: number, deletedLines: number, addedChars: number, deletedChars: number): void;
+    getFileChangeStats(): FileChangeStats;
+    recordTokenUsage(modelId: string, modelName: string, inputTokens: number, outputTokens: number, cachedReadTokens: number, cachedWriteTokens: number): void;
+    getTokenUsageByModel(): TokenUsageByModel;
+    recordAPIDuration(duration: number): void;
+    getAllStatistics(): CostStatistics;
+    resetStatistics(): void;
+    private getModelCostText;
+    formatCostInfo(): string;
+}

package/cli/dist-server/types/node/telemetry/extension-info-processor.d.ts

@@ -0,0 +1,13 @@
+import { ClientInfoProvider } from '../../workspace/product/lib/common/index.js';
+import { EventProcessContext, EventProcessor } from '../../workspace/telemetry/lib/common/index.js';
+/**
+ * 扩展插件相关信息
+ */
+export declare class ExtensionInfoEventProcessor implements EventProcessor {
+    protected clientInfoProvider: ClientInfoProvider;
+    process({ event }: EventProcessContext): Promise<void>;
+}
+export declare class ExtensionInfoModelEventProcessor implements EventProcessor {
+    protected clientInfoProvider: ClientInfoProvider;
+    process({ event }: EventProcessContext): Promise<void>;
+}

package/cli/dist-server/types/node/telemetry/friction-analysis.d.ts

@@ -0,0 +1,54 @@
+import { ProductManager } from '../../workspace/product/lib/common/index.js';
+import { EventService, Logger } from '../../workspace/telemetry/lib/common/index.js';
+import { ChatRequestSendTelemetry } from '../../workspace/telemetry/lib/common/event/types/craft.js';
+import { Session } from '../../vendor/cbc-core/node/index.js';
+import { FrictionRecallClient } from './friction-recall-client';
+export declare const FrictionAnalysisService: unique symbol;
+export declare const CHAT_PROMPT_FRICTION_ANALYSIS_EVENT = "chat_prompt_friction_analysis";
+export type FrictionSeverity = 'high' | 'medium' | 'low';
+export type FrictionType = 'error_tool_failure' | 'performance_friction' | 'repeated_rephrasing' | 'escalation_tone' | 'platform_confusion' | 'abandoned_tool_flow' | 'backtracking_revert' | 'context_churn' | 'quality_disappointment' | 'trust_degradation' | 'communication_mismatch' | 'specification_drift' | 'unexpected_side_effect' | 'data_loss_risk' | 'no_progress_looping' | 'unclear_status' | 'safety_privacy_concern' | 'approval_fatigue' | 'insufficient_evidence';
+export type FrictionRootCauseCandidate = 'tool_reliability' | 'model_runtime' | 'product_ux' | 'latency' | 'model_understanding' | 'context_retrieval' | 'output_quality' | 'permission_or_policy' | 'workflow_orchestration' | 'specification_drift' | 'user_requirement_ambiguity' | 'communication_mismatch';
+export interface FrictionAnalysisService {
+    capturePrompt(session: Session, userPrompt: string): void;
+    tryReportOnRequestSend(session: Session, requestTelemetry: ChatRequestSendTelemetry): void;
+}
+export interface FrictionAnalysisResult {
+    frictionType: FrictionType;
+    severity: FrictionSeverity;
+    evidenceText: string;
+    rootCauseCandidate: FrictionRootCauseCandidate;
+}
+export interface ChatPromptFrictionAnalysisTelemetry {
+    conversationId: string;
+    requestId: string;
+    requestModelId: string;
+    requestModelName: string;
+    presentAt: number;
+    userPrompt: string;
+    linkedPreviousRequestId?: string;
+    frictionType: FrictionType;
+    severity: FrictionSeverity;
+    evidenceText: string;
+    linkedExecutionSignal?: string;
+    rootCauseCandidate: FrictionRootCauseCandidate;
+}
+export declare function extractVisibleUserPromptFromAcpPrompt(prompt: unknown): string;
+export declare function extractVisibleUserPromptFromAgentInput(input: unknown): string;
+export declare function buildFrictionTelemetryPayload(session: Session, requestTelemetry: ChatRequestSendTelemetry, userPrompt: string, result: FrictionAnalysisResult, linkedPreviousRequestId?: string, linkedExecutionSignal?: string): ChatPromptFrictionAnalysisTelemetry;
+export declare class FrictionAnalysisServiceImpl implements FrictionAnalysisService {
+    protected readonly eventService: EventService;
+    protected readonly logger: Logger;
+    protected readonly frictionRecallClient: FrictionRecallClient;
+    protected readonly productManager: ProductManager;
+    private readonly pendingPromptBySession;
+    private readonly pendingAnalysisByRequest;
+    private readonly reportedKeys;
+    capturePrompt(session: Session, userPrompt: string): void;
+    tryReportOnRequestSend(session: Session, requestTelemetry: ChatRequestSendTelemetry): void;
+    private flushPending;
+    private isFeatureEnabledForReport;
+    private getRequestKey;
+    private extractLinkedPreviousRequestId;
+    private findRequestId;
+    private extractLinkedExecutionSignal;
+}

package/cli/dist-server/types/node/telemetry/friction-recall-client.d.ts

@@ -0,0 +1,15 @@
+import { RestOperations } from '@celljs/http';
+import { ProductManager } from '../../workspace/product/lib/common/index.js';
+import { Logger } from '../../workspace/telemetry/lib/common/index.js';
+import type { FrictionAnalysisResult } from './friction-analysis';
+export declare const FrictionRecallClient: unique symbol;
+export interface FrictionRecallClient {
+    recall(userPrompt: string): Promise<FrictionAnalysisResult | undefined>;
+}
+export declare function parseFrictionRecallResponse(payload: unknown): FrictionAnalysisResult | undefined;
+export declare class FrictionRecallClientImpl implements FrictionRecallClient {
+    protected readonly restOperations: RestOperations;
+    protected readonly productManager: ProductManager;
+    protected readonly logger: Logger;
+    recall(userPrompt: string): Promise<FrictionAnalysisResult | undefined>;
+}

package/cli/dist-server/types/node/telemetry/host-ide-info-processor.d.ts

@@ -0,0 +1,11 @@
+import { ClientInfoProvider } from '../../workspace/product/lib/common/index.js';
+import { EventProcessContext, EventProcessor } from '../../workspace/telemetry/lib/common/index.js';
+/**
+ * 宿主 IDE 相关信息
+ */
+export declare class HostIDEInfoEventProcessor implements EventProcessor {
+    protected clientInfoProvider: ClientInfoProvider;
+    process({ event }: EventProcessContext): Promise<void>;
+    private ensureLocalCliFeatureModule;
+    private isCliIdentity;
+}

package/cli/dist-server/types/node/telemetry/index.d.ts

@@ -0,0 +1,21 @@
+export * from './startup-profiler-protocol';
+export * from './cost-protocol';
+export * from './telemetry-protocol';
+export * from './plugin-telemetry-protocol';
+export * from './sandbox-telemetry-protocol';
+export * from './startup-profiler';
+export * from './cost-service';
+export * from './logger';
+export * from './status-reporter';
+export * from './friction-recall-client';
+export * from './friction-analysis';
+export * from './telemetry-service';
+export * from './plugin-telemetry-service';
+export * from './host-ide-info-processor';
+export * from './extension-info-processor';
+export * from './telemetry-client-info-event-processor';
+export * from './telemetry-client-carrier';
+export * from './turn-baggage-processor';
+export * from './vcs-event-processor';
+export * from './qimei-env-detector';
+export * from './sandbox-telemetry-service';

package/cli/dist-server/types/node/telemetry/logger/index.d.ts

@@ -0,0 +1 @@
+export * from './storage-path-provider';

package/cli/dist-server/types/node/telemetry/logger/storage-path-provider.d.ts

@@ -0,0 +1,4 @@
+import { LoggerStoragePathProvider } from '../../../workspace/telemetry/lib/common/index.js';
+export declare class LoggerStoragePathProviderImpl implements LoggerStoragePathProvider {
+    provide(): string;
+}

package/cli/dist-server/types/node/telemetry/plugin-telemetry-protocol.d.ts

@@ -0,0 +1,68 @@
+import { Marketplace, MarketplaceType, PluginInfo, PluginInstallScope } from '../../workspace/cbc-plugins/lib/node/index.js';
+/**
+ * 插件市场埋点服务
+ * 负责上报插件市场相关的埋点事件
+ */
+export declare const PluginTelemetryService: unique symbol;
+export interface PluginTelemetryService {
+    /**
+     * 上报市场操作事件 (plugin_marketplace_action)
+     * 用户添加/删除/刷新市场时调用
+     */
+    reportMarketplaceAction(data: MarketplaceActionData): void;
+    /**
+     * 上报市场页面曝光事件 (plugin_marketplace_page_show)
+     * 用户进入插件市场页面时调用
+     */
+    reportMarketplacePageShow(data: MarketplacePageShowData): void;
+    /**
+     * 上报插件操作事件 (plugin_action)
+     * 用户安装/卸载/启用/禁用插件时调用
+     */
+    reportPluginAction(data: PluginActionData): void;
+}
+/**
+ * 市场操作埋点数据
+ */
+export interface MarketplaceActionData {
+    /** 市场信息（操作失败时可能为 undefined） */
+    marketplace?: Marketplace;
+    /** 市场名称（操作失败时如果没有 marketplace 则使用此字段） */
+    marketplaceName?: string;
+    /** 市场来源（操作失败时如果没有 marketplace 则使用此字段） */
+    marketplaceSource?: string;
+    /** 市场类型（操作失败时如果没有 marketplace 则使用此字段） */
+    marketplaceType?: MarketplaceType;
+    /** 用户操作 */
+    action: 'add' | 'remove' | 'refresh';
+    /** 操作是否成功 */
+    actionSuccessful: boolean;
+    /** 错误代码（操作失败时） */
+    errorCode?: string;
+    /** 错误信息（操作失败时） */
+    errorMessage?: string;
+}
+/**
+ * 市场页面曝光埋点数据
+ */
+export interface MarketplacePageShowData {
+    /** 当前选中的市场名称 */
+    marketplaceName?: string;
+    /** 可用市场总数 */
+    marketplaceCount: number;
+    /** 已安装插件总数 */
+    installedPluginCount: number;
+}
+/**
+ * 插件操作埋点数据
+ */
+export interface PluginActionData {
+    /** 插件信息 */
+    plugin: PluginInfo;
+    /** 所属市场 */
+    marketplace: Marketplace;
+    /** 用户操作 */
+    action: 'install' | 'uninstall' | 'enable' | 'disable' | 'update';
+    /** 安装作用域 */
+    scope: PluginInstallScope;
+}

package/cli/dist-server/types/node/telemetry/plugin-telemetry-service.d.ts

@@ -0,0 +1,31 @@
+import { EventService, Logger } from '../../workspace/telemetry/lib/common/index.js';
+import { MarketplaceActionData, MarketplacePageShowData, PluginActionData, PluginTelemetryService } from './plugin-telemetry-protocol';
+export declare class PluginTelemetryServiceImpl implements PluginTelemetryService {
+    protected readonly eventService: EventService;
+    protected readonly logger: Logger;
+    reportMarketplaceAction(data: MarketplaceActionData): void;
+    reportMarketplacePageShow(data: MarketplacePageShowData): void;
+    reportPluginAction(data: PluginActionData): void;
+    /**
+     * 获取市场来源字符串
+     */
+    private getMarketplaceSource;
+    /**
+     * 映射市场类型到埋点定义的类型
+     * directory -> local
+     * github/git/url -> github
+     */
+    private mapMarketplaceType;
+    /**
+     * 映射安装作用域到埋点定义的类型
+     */
+    private mapScope;
+    /**
+     * 获取插件能力标志
+     */
+    private getPluginCapabilities;
+    /**
+     * 判断能力是否存在
+     */
+    private hasCapability;
+}

package/cli/dist-server/types/node/telemetry/qimei-env-detector.d.ts

@@ -0,0 +1,16 @@
+import { Logger } from '@celljs/core';
+import { QimeiDetector } from '../../workspace/telemetry/lib/common/index.js';
+/**
+ * agent-cli 侧 QIMEI36 探测器。
+ *
+ * WorkBuddy Desktop/app-server 负责 native SDK 探测，agent-cli 子进程只从环境变量
+ * 动态读取已探测到的值，避免在 CLI 进程里再次加载 native SDK。
+ */
+export declare class EnvQimeiDetector implements QimeiDetector {
+    protected readonly logger: Logger;
+    /** env 缺失只 warn 一次，避免每次遥测上报都刷日志。 */
+    private missingWarned;
+    getSync(): string | undefined;
+    getAsync(): Promise<string | undefined>;
+    protected readEnv(): string | undefined;
+}