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

package/cli/dist-server/types/workspace/code-ratio/lib/common/code-ratio-protocol.d.ts

@@ -0,0 +1,124 @@
+import { ChangeType, CodeChangeSource, CommitDiffFile, VcsType } from '../../../telemetry/lib/common/index.js';
+/**
+ * AI 代码入库率统一采集入口。
+ *
+ * 业务侧（completion / NES / Inline Chat / Chat Apply / Agent / agent-cli 等）
+ * 在 AI 代码真正进入文件后调用本服务，由它统一完成：
+ *
+ *   1. 部署层 + 客户层能力开关判断（任一为否直接 return，零开销）；
+ *   2. 二进制、空变更过滤，大 diff 截断；
+ *   3. 用 oldContent / newContent 生成对外协议 v1.0 的 unified diff；
+ *   4. 组装并上报 `Events.CodeChangeEvent`（telemetry 通道，最终落 ClickHouse 的 change/codeDiff 行）。
+ *
+ * 后端归因（T16）只消费 `code_change_event.codeDiff` + `commit_observed.addedLines`，
+ * 不再需要端侧维护 ai_edit_log_entry / ai_edit_log_batch。
+ *
+ * 调用方约定：
+ *   - 失败由 reporter 内部吞掉（只打日志），绝不抛给业务，避免影响 AI 写代码的主流程。
+ *   - 入参允许只提供 newContent；oldContent 缺失时 reporter 会尝试用 fileReader 读取（工厂注入）。
+ *
+ * 参考：
+ *   - 实施方案 https://iwiki.woa.com/p/4020266859
+ *   - 任务拆分 https://iwiki.woa.com/p/4020267027 (T3)
+ *   - T16 归因算法 https://iwiki.woa.com/p/4020543962
+ */
+export declare const CodeRatioReporter: unique symbol;
+/**
+ * 业务侧上报 AI 代码变更时的入参。
+ *
+ * - `oldContent` 可省略，未提供时 reporter 会尝试通过注入的 fileReader 读取
+ *   accept 前的内容（CLI / 没有现成 before 缓存的场景）。
+ * - `filePath` 必须是仓库相对路径（POSIX 风格）；reporter 不做相对路径换算，
+ *   由调用方在已知仓库根目录下完成相对化。
+ */
+export interface RecordAIChangeInput {
+    /** 端侧 source 枚举，细粒度，最终由 reporter 映射到对外协议 genMethod */
+    source: CodeChangeSource;
+    /** 仓库相对路径（POSIX 风格），不接受绝对路径 */
+    filePath: string;
+    /** 文件变更类型，与 oldContent / newContent 的语义保持一致 */
+    changeType: ChangeType;
+    /** VCS 类型；缺省为 git，SVN 仓库填 svn。 */
+    vcsType?: VcsType;
+    /** 仓库远端 URL（已脱敏，无 token / 无凭据） */
+    repoUrl: string;
+    /** 当前分支名 */
+    repoBranch: string;
+    /** AI 写入前的文件内容；缺省时 reporter 会用 fileReader 兜底读取 */
+    oldContent?: string;
+    /** AI 写入后的文件内容（必填） */
+    newContent: string;
+    /** 是否被用户拒绝；reject 路径会被 reporter 直接跳过，不上报 */
+    rejected?: boolean;
+    /** 关联工具调用 ID（agent / chat apply / inline chat 等可填） */
+    toolCallId?: string;
+    /** 工具名（agent: writeToFile / replaceInFile / deleteFiles 等） */
+    toolName?: string;
+    /** 关联会话 ID */
+    conversationId?: string;
+    /** 模型 ID */
+    modelId?: string;
+    /** 模型名称 */
+    modelName?: string;
+    /** trace ID，用于跨事件关联 */
+    traceId?: string;
+}
+/**
+ * commit observer 输入。watcher 端在监听到 git commit 后调用本入口上报。
+ */
+export interface ObserveCommitInput {
+    /** VCS 类型；缺省为 git，SVN watcher 填 svn。 */
+    vcsType?: VcsType;
+    commitId: string;
+    /** ISO 8601 带时区，对外协议要求 */
+    committedAt: string;
+    repoUrl: string;
+    repoBranch: string;
+    /** 仓库稳定 ID（git first commit SHA） */
+    repoFirstCommit?: string;
+    files: CommitDiffFile[];
+    traceId?: string;
+}
+/**
+ * 单次 recordAIChange 的处理结果。reporter 会吞掉异常，但仍通过返回值告诉业务
+ * 是否真的上报，方便业务做行为漏斗 / 调试日志（不要求业务消费）。
+ */
+export interface RecordAIChangeResult {
+    /** 是否触发了实际上报；false 表示被开关、过滤或异常拦下 */
+    reported: boolean;
+    /** 跳过原因；reported=true 时为 undefined */
+    skipReason?: SkipReason;
+}
+export type SkipReason = 'feature-disabled' | 'binary-content' | 'empty-change' | 'invalid-input' | 'rejected' | 'internal-error';
+/**
+ * AI 代码入库率统一采集入口。
+ */
+export interface CodeRatioReporter {
+    /**
+     * AI 代码进入文件后立即调用，对应对外协议 `change/codeDiff` 行。
+     *
+     * 内部链路：
+     *   feature-gate 判断 → 过滤 → unified diff 生成 → 组装 telemetry payload →
+     *   上报 `Events.CodeChangeEvent`。
+     *
+     * 失败不抛错；业务可忽略返回值。
+     */
+    recordAIChange(input: RecordAIChangeInput): Promise<RecordAIChangeResult>;
+    /**
+     * commit 观察入口；T8 接入 git commit watcher 后由 watcher 调用。
+     */
+    observeCommit(input: ObserveCommitInput): Promise<void>;
+}
+/**
+ * 端侧文件读取器抽象。允许在不依赖 vscode / fs 的前提下让 reporter 读 oldContent。
+ * 业务能直接传 oldContent 时不会走到这里；只有 oldContent 缺失时 reporter
+ * 才会调用 readFile。
+ */
+export declare const CodeRatioFileReader: unique symbol;
+export interface CodeRatioFileReader {
+    /**
+     * 根据仓库相对路径读取当前文件内容；读失败返回 undefined（不抛错），
+     * reporter 会按 invalid-input 跳过。
+     */
+    readFile(filePath: string): Promise<string | undefined>;
+}

package/cli/dist-server/types/workspace/code-ratio/lib/common/code-ratio-reporter.d.ts

@@ -0,0 +1,57 @@
+import { Logger } from '@celljs/core';
+import { ProductManager } from '../../../product/lib/common/index.js';
+import { EventService, GenMethod } from '../../../telemetry/lib/common/index.js';
+import { CodeRatioFileReader, CodeRatioReporter, ObserveCommitInput, RecordAIChangeInput, RecordAIChangeResult } from './code-ratio-protocol.js';
+/**
+ * 入库率统一采集入口的实现。
+ *
+ * 设计原则：
+ *
+ *   1. **零开销关闭**：`isCodeAdoptionRateEnabled()` 为 false 时，所有入口
+ *      首检直接 return，不读文件、不生成 diff、不上报。
+ *   2. **绝不打扰主流程**：所有外部调用（fileReader / EventService）
+ *      都被 try/catch 包住，失败只记 logger 并返回 reported=false。
+ *   3. **类型对齐对外协议**：通过 `@genie/telemetry` 的 `buildCodeChangeEvent`
+ *      统一组装 telemetry payload + `genCodeDesc`，避免业务侧拼协议 JSON。
+ *
+ * T16/S6 之后，归因路径完全靠 `code_change_event.codeDiff` + `commit_observed.addedLines`：
+ * 端侧不再写任何 ai_edit_log_entry / ai_edit_log_batch，本类相应移除了 journal 入口。
+ */
+export declare class CodeRatioReporterImpl implements CodeRatioReporter {
+    protected readonly productManager: ProductManager;
+    protected readonly eventService: EventService;
+    protected readonly logger: Logger;
+    protected readonly fileReader?: CodeRatioFileReader;
+    /** unified diff 截断阈值；后续可由远端配置覆盖（T7+） */
+    protected readonly maxDiffBytes: number;
+    /**
+     * 已上报过的 commit 去重集合，key = `${repoUrl}::${commitId}`。
+     *
+     * 背景：fusion 原生宿主（Xcode/VS/JetBrains）下，同一个 commit 会经【两条路径】
+     * 各调一次 {@link observeCommit}：
+     *   1) native `$acceptDidCommit` 在 fusion 里的 direct 兜底上报；
+     *   2) `MainThreadVscodeGitService.fireDidCommit` → vscode.git `onDidCommit`
+     *      → plugin-core `GitCommitWatcher` 的上报。
+     * 这两条路径各自维护进程内去重 Set，互不知晓，导致 `commit_observed` 被重复上报。
+     * 由于所有路径（含 svn `SvnCommitWatcher`、observeCommit 命令）最终都汇聚到本
+     * 单例的 {@link observeCommit}，这里在统一出口按 (repoUrl, commitId) 收敛：
+     * 先到先报、后到的 skip，彻底消除多路径重复。
+     */
+    private readonly recentlyObservedCommits;
+    /** {@link recentlyObservedCommits} 的 LRU 上限，超出后淘汰最早的 key，避免无限增长。 */
+    private static readonly MAX_OBSERVED_COMMIT_CACHE;
+    protected init(): void;
+    /**
+     * 打印当前 isCodeAdoptionRateEnabled 判断使用到的全部字段。
+     *
+     * 仅日志用，不做任何业务判断。便于 SaaS 等部署场景下排查"为什么 /report
+     * 没有 code_change_event"——直接看 deploymentType 和 codeAdoptionRateFeature
+     * 即可定位是部署层关闭还是特性开关关闭。
+     */
+    private logFeatureGateState;
+    recordAIChange(input: RecordAIChangeInput): Promise<RecordAIChangeResult>;
+    observeCommit(input: ObserveCommitInput): Promise<void>;
+    /** 维持 {@link recentlyObservedCommits} 在 LRU 上限内，淘汰最早插入的 key。 */
+    private trimObservedCommitCache;
+}
+export { GenMethod };

package/cli/dist-server/types/workspace/code-ratio/lib/common/diff/unified-diff.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 生成对外协议 v1.0 要求的 unified diff 文本。
+ *
+ * 与 packages/core 里的 `PatchUtils.generatePatch` 不同，这里不加任何自定义
+ * 头（PatchUtils 会前置 `@@ Line range:` 标记），保证 ClickHouse 落库的
+ * `codeDiff` 是标准 unified format，便于客户报表直接消费。
+ *
+ * 说明：
+ *   - filePath 同时用于 unified diff 头部和 `--- a/` / `+++ b/` 标记，与
+ *     对外协议一致；调用方应当传入仓库相对路径（POSIX 风格）。
+ *   - 如果 oldContent 与 newContent 完全相同，returns ''（空串），调用方应
+ *     视为"无变更"并跳过上报。
+ */
+export declare function buildUnifiedDiff(filePath: string, oldContent: string, newContent: string): string;
+/**
+ * 在 unified diff 内容超过 maxBytes 时截断，并在末尾追加截断标记。
+ *
+ * 返回包含两个字段的对象，方便 reporter 同时上报"是否被截断"。
+ */
+export declare function truncateDiff(diff: string, maxBytes: number): {
+    content: string;
+    truncated: boolean;
+};
+/**
+ * 计算 oldContent → newContent 的净增/净减统计。
+ *
+ * 仅做"基于换行的简单统计"，不做 myers diff；用于 telemetry payload 的
+ * lineCount / characterCount 字段。这是聚合粗粒度数字，不参与对外协议
+ * `lineStats.summary`（那个由后端归因聚合器算）。
+ *
+ * 字符差按 codepoint length 计算（不做 grapheme cluster），与对外协议
+ * codeDiff 文本字节数无关，仅用于聚合维度。
+ */
+export declare function computeChangeStats(oldContent: string, newContent: string): {
+    addedLines: number;
+    addedCharacters: number;
+};

package/cli/dist-server/types/workspace/code-ratio/lib/common/feature-gate.d.ts

@@ -0,0 +1,59 @@
+import { ProductConfiguration, ProductManager } from '../../../product/lib/common/index.js';
+/**
+ * 基于已有的 ProductConfiguration 判断入库率能力是否启用（同步）。
+ *
+ * 适合已经持有 configuration 的调用方，例如业务入口已经走过
+ * `productManager.waitConfiguration()` 或拿到 `getCurrentConfiguration()`。
+ */
+export declare function isCodeAdoptionRateEnabledFromConfig(configuration: ProductConfiguration | undefined): boolean;
+/**
+ * 从 ProductManager 获取当前瞬时配置（同步），判断入库率能力是否启用。
+ *
+ * 如果 ProductManager 尚未加载完成，`getCurrentConfiguration()` 可能返回 undefined，
+ * 此时视为"未启用"，避免在配置就绪前误采集。
+ */
+export declare function isCodeAdoptionRateEnabled(productManager: ProductManager): boolean;
+/**
+ * 异步等待 ProductManager 完成最终配置后，判断入库率能力是否启用。
+ *
+ * 适合在端侧初始化链路中使用，确保拿到最终生效配置后再决定是否启用采集。
+ *
+ * 注意：`productManager.waitConfiguration()` 的实现只要 BehaviorSubject 推出
+ * 一个 truthy 值就 resolve，但在 cold start 早期会先推出 cache 占位配置（往往
+ * 没有 productFeatures），导致这里拿到的可能是中间态，判断为 false。如果你的
+ * 调用方是"一次性挂订阅"（例如 GitCommitWatcher 这种 mount 后不再重试），请
+ * 改用 {@link waitCodeAdoptionRateEnabledStrict}。
+ */
+export declare function waitCodeAdoptionRateEnabled(productManager: ProductManager): Promise<boolean>;
+/**
+ * 严格等待 ProductManager 推出"真实可用"的配置后再判断入库率能力是否启用。
+ *
+ * 与 {@link waitCodeAdoptionRateEnabled} 的差异：
+ *   - 直接订阅 `productManager.configuration` BehaviorSubject；
+ *   - 跳过 cache 占位 / 没有 `productFeatures` 字段的中间态，只在第一次拿到
+ *     `productFeatures` 时才 resolve；
+ *   - 带超时兜底（默认 30s），超时返回 false（视为未启用），避免一次性
+ *     mount 链路无限挂起。
+ *
+ * 适用场景：**一次性挂订阅**的初始化路径，例如：
+ *   - `GitCommitWatcher.mountWhenReady()`：cold start 期间 waitConfiguration
+ *     可能拿到只含 endpoint 的 cache 占位，feature gate 判断为 false 后
+ *     `return`，后续即使配置加载完整也不会重试，git commit 永远不上报。
+ *   - 其它 lifecycle activate 一次定型的订阅器。
+ *
+ * 对于 **可重入** 的判断点（例如每次 `recordAIChange` / `observeCommit` 调用
+ * 前都查一次开关），用同步的 {@link isCodeAdoptionRateEnabled} 即可，不需要
+ * 走这条路径。
+ *
+ * 实现细节：手写 subscribe + Promise + setTimeout，避免依赖 rxjs ≥7 才有
+ * 的 `firstValueFrom`/`timeout` 操作符（cell 容器内置的 rxjs 版本可能更老）。
+ */
+export declare function waitCodeAdoptionRateEnabledStrict(productManager: ProductManager, timeoutMs?: number): Promise<boolean>;
+/**
+ * 等到 `productManager.configuration` 推出第一个"含 productFeatures"的非空值。
+ *
+ * 失败（超时）时 reject，调用方按"未启用"处理。导出以便上层在拿不到入库率
+ * 开关时也能拿到完整配置做其它判断；普通调用方优先用
+ * {@link waitCodeAdoptionRateEnabledStrict}。
+ */
+export declare function waitForRealConfiguration(productManager: ProductManager, timeoutMs?: number): Promise<ProductConfiguration>;

package/cli/dist-server/types/workspace/code-ratio/lib/common/filters/file-filter.d.ts

@@ -0,0 +1,41 @@
+/**
+ * AI 代码变更过滤器。
+ *
+ * T3 阶段按 T3 前置确认走"方案 A"：只过滤二进制文件和超大 diff。lockfile /
+ * generated 目录等扩展过滤留到后续任务，需要按客户反馈再调，避免一上来过
+ * 度过滤导致漏数据。
+ */
+/**
+ * 默认 unified diff 最大字节数；超过后截断而不是丢弃，由 reporter 决定如何处理。
+ *
+ * 2026-05-21 由 64KB 调到 1MB（见 iWiki 4020543962 §16.6）。
+ *
+ * 根因：case4 (commit 4a381ddc) 一次 AI 多轮优化产生约 817 行 Java 大文件，
+ * 单次 code_change_event 的 unified diff ≈ 70KB，超过原 64KB 阈值被截断。
+ * 后果是 commit 后 304 行（约 37%）在 code_change_event 里根本没上报到后端，
+ * 后端 Pass 1 exact-text 无命中、Pass 2 退化按相似度匹配 → 误判 Partial
+ * （146 行 partial，用户期望 0 行）。
+ *
+ * 1MB 覆盖率分析：
+ *   - 典型源码单文件几百 KB（含注释 + 多语言时偏大）
+ *   - 1MB 覆盖 99%+ 的实际单文件场景
+ *   - 后端 ClickHouse codeDiff 列无上限，传输无瓶颈
+ *
+ * 仍保留截断兜底（不是无限大），防止用户误传 build 产物 / 巨型 JSON 配置。
+ * 超 1MB 时 reporter 会带 codeDiffTruncated=true 上报，后端可观测。
+ */
+export declare const DEFAULT_MAX_DIFF_BYTES: number;
+/**
+ * 检测内容是否是二进制。
+ *
+ * 检查策略：扫描文本前 8 KB（已经足够覆盖 PE / ELF / PNG / PDF 等常见格式
+ * 的 magic 区域），出现 NUL 字节即认为是二进制。
+ *
+ * 注：Windows 下 UTF-16 文件首字节是 BOM（FF FE / FE FF），不会含 NUL 字节，
+ * 所以可能误判为文本；这是 T3 阶段的可接受风险，后续可加 BOM 检查再细化。
+ */
+export declare function isBinaryContent(content: string | undefined): boolean;
+/**
+ * 判断 oldContent / newContent 之一是否会让 reporter 走"二进制跳过"路径。
+ */
+export declare function shouldSkipForBinary(oldContent: string | undefined, newContent: string): boolean;

package/cli/dist-server/types/workspace/code-ratio/lib/common/index.d.ts

@@ -0,0 +1,6 @@
+export * from './code-ratio-protocol.js';
+export * from './code-ratio-reporter.js';
+export * from './diff/unified-diff.js';
+export * from './feature-gate.js';
+export * from './filters/file-filter.js';
+export * from './vcs-repo-resolver-protocol.js';

package/cli/dist-server/types/workspace/code-ratio/lib/common/vcs-repo-resolver-protocol.d.ts

@@ -0,0 +1,50 @@
+import { VcsType } from '../../../telemetry/lib/common/index.js';
+/**
+ * `CodeRatioRepoResolver` 协议（DI Symbol + 接口 + 工具函数）。
+ *
+ * 设计目标：
+ *   - 把 IDE / CLI 各自的实现统一到一个协议下，避免每个调用方再各自重新声明 Symbol
+ *     （不同 Symbol 会导致 DI 容器解析失败）。
+ *   - 协议本身只依赖 Node 标准库（path），不依赖 vscode / fs，可放在最底层的
+ *     `@genie/code-ratio` 包里被任何 IDE / CLI / Web 实现共享。
+ *
+ * 历史背景：
+ *   - 协议最初放在 `packages/agent-craft/src/common/code-ratio/`（T4）。
+ *   - T6 调整为 plugin-core，由 plugin-completion / plugin-chat / agent-craft 共用。
+ *   - 之后引入 plugin-core ⇄ chat-sdk ⇄ agent-sdk ⇄ agent-craft 的项目引用环，
+ *     因此再次下沉到 `@genie/code-ratio` 这一最干净的下层包，作为公共协议。
+ *     IDE 侧（plugin-core 的 `VCSRepoResolver`）和 CLI 侧（agent-cli 的
+ *     `CwdRepoResolver`）继续各自 `@Component(CodeRatioRepoResolver)` 注册。
+ */
+export interface CodeRatioRepoContext {
+    /** VCS 类型；旧实现未返回时调用方按 git 兼容。 */
+    vcsType?: VcsType;
+    /** 仓库远端 URL（已脱敏） */
+    repoUrl: string;
+    /** 当前分支名 */
+    repoBranch: string;
+    /** 文件相对仓库根目录的 POSIX 相对路径 */
+    relativeFilePath: string;
+}
+export declare const CodeRatioRepoResolver: unique symbol;
+export interface CodeRatioRepoResolver {
+    /**
+     * 把绝对文件路径解析到 repo 上下文。
+     * 失败（非绝对路径、文件不在任何仓库内、仓库信息不完整）返回 undefined。
+     */
+    resolve(absoluteFilePath: string): CodeRatioRepoContext | undefined;
+    /**
+     * 返回当前 workspace 对应仓库的根目录绝对路径（fsPath）。
+     * 多仓库场景下返回 `currentRepository` 的 root；没有则 undefined。
+     *
+     * 主要给 fs-file-reader 做相对路径 → 绝对路径的兜底使用。
+     */
+    getCurrentRepoRoot(): string | undefined;
+}
+/**
+ * 把绝对路径转成相对仓库根的 POSIX 相对路径。
+ *
+ * - 如果绝对路径在仓库根之外，返回 undefined，让上层跳过上报。
+ * - 统一使用 POSIX 分隔符，符合对外协议 `filePath` 的 POSIX 风格要求。
+ */
+export declare function toPosixRelative(repoRoot: string, absoluteFilePath: string): string | undefined;

package/cli/dist-server/types/workspace/product/lib/common/index.d.ts

@@ -25,4 +25,5 @@ export * from './abtest-service.js';
 export * from './tool-control-catalog.js';
 export * from './static-resource-url.js';
 export * from './tencent-docs-endpoint.js';
+export * from './repo-params.js';
 export { AUTO_MODEL_ID, AUTO_MODEL_IDS, AUTO_TIER_MODEL_IDS, AUTO_TIER_MODELS, expandAutoModelIds, isAutoModelId, replaceAutoModelInList, replaceAutoWithTierModels, shouldReplaceAutoWithTierModels, } from './auto-tier-models.js';

package/cli/dist-server/types/workspace/product/lib/common/repo-params.d.ts

@@ -0,0 +1,14 @@
+import { GitInfo } from './repository-protocol.js';
+export declare function stripGitCredentials(rawUrl: string): string;
+/**
+ * 构造 /v3/config 的 `repos` 参数：去凭据 -> 按 URL 去重。
+ *
+ * 去重按 URL 而不是本地路径：同一远端仓库在多个 checkout / worktree 下本地路径不同，
+ * 但 URL 相同，服务端只需要按仓库维度判定一次安全等级。
+ *
+ * 注意：这里绝不做数量截断。服务端 CheckRepositoriesAllowAICoding 的语义是
+ * 「任一仓库禁止即整体拒绝」，在安全判定之前丢仓库等于让被丢弃的仓库绕过检查
+ * （P1 安全问题）。仓库数多的工作区必须完整上报，query 体积由去重收敛，
+ * 服务端已有批量缓存读 + worker pool + 总耗时预算兜底。
+ */
+export declare function buildRepoParams(repositories: GitInfo[] | undefined): string[];

package/cli/dist-server/types/workspace/product/lib/common/types/features.d.ts

@@ -6,6 +6,11 @@ export declare enum ProductFeature {
     BrowserUse = "BrowserUse",
     /** Computer Use 产品准入开关；缺省关闭。 */
     ComputerUse = "ComputerUse",
+    /**
+     * 远程遥控产品准入开关；缺省关闭。
+     * 只控制设置页入口。不要写入本地 product.json，否则会盖过 /v3/config 的灰度结果。
+     */
+    RemoteDesktop = "RemoteDesktop",
     /**
      * 聊天功能
      */
@@ -607,6 +612,8 @@ export declare enum ProductFeature {
      * @default false（默认隐藏，命中远端灰度后开启）
      */
     EnableTeamIm = "enableTeamIm",
+    /** 频道 Buddy 是否允许选择模型；缺省关闭，关闭时优先使用账号授权的 Hy4。 */
+    EnableChannelBuddyModelSelection = "EnableChannelBuddyModelSelection",
     /**
      * 是否禁用「更多」菜单中的「灵感」入口
      * 设置为 true 时隐藏会话列表「更多」菜单里的灵感（探索）项，
@@ -749,12 +756,12 @@ export declare enum ProductFeature {
      * @default false
      */
     DisableWecomBotIntegration = "DisableWecomBotIntegration",
-    /**
-     * 是否启用微信文件分享（shareFile）路径。
-     * 启用后，放开分享文件到微信的按钮；
-     * @default false
-     */
-    EnableWechatShareFile = "EnableWechatShareFile",
+    /** 总开关：允许分享实体文件；启用后再由渠道开关分别控制微信/企微。 */
+    EnableShareFile = "EnableShareFile",
+    /** 允许发送实体文件到微信。 */
+    EnableShareFileToWechat = "EnableShareFileToWechat",
+    /** 允许发送实体文件到企业微信。 */
+    EnableShareFileToWecom = "EnableShareFileToWecom",
     /**
      * 禁用登录页底部的法务链接（隐私政策、服务条款）
      * 设置为 true 时，LoginView 不渲染隐私政策和服务条款链接。
@@ -915,6 +922,12 @@ export declare enum ProductFeature {
      * @default false
      */
     Artifact = "Artifact",
+    /**
+     * 是否开启资料库上传（把本地单个文件上传为资料库节点）能力。
+     * 关闭时工具不注册，模型看不到；endpoint / 登录态等其它前置条件由工具自身再校验。
+     * @default false
+     */
+    LibraryUpload = "LibraryUpload",
     /**
      * 是否开启 ShareLink（本地 HTML → 上传 → 可分享公网链接）能力
      * @deprecated 兼容保留，请改用 Artifact key（新 key 优先，本 key 兜底）。
@@ -1095,21 +1108,10 @@ export declare enum ProductFeature {
      */
     ConversationEngine = "ConversationEngine",
     /**
-     * TencentDesignX 设计能力开关
-     * 设置为 true 时，启用 TencentDesignX 相关功能入口。
-     *
-     * 版本说明：5.4.0 之前的客户端版本仍使用 `TencentDesignX` 开关控制 Ardot 设计入口；
-     * 5.4.0 版本之后 `TencentDesignX` 开关作废，改为使用 `EnableArdot` 开关控制 Ardot 设计入口。
-     * @deprecated 新版客户端改用 `EnableArdot` 控制 Ardot 设计入口；本 key 不再参与门控，
-     * 仅为兼容历史下发保留 enum 登记。
-     * @default false
-     */
-    TencentDesignX = "TencentDesignX",
-    /**
-     * Ardot 设计入口特性开关（unleash / product feature flag）。
-     * 取代旧的 `TencentDesignX` 成为新版客户端 Ardot「设计创意」入口的唯一门控 key：
+     * Ardot 族（画布设计）能力开关（unleash / product feature flag）。
      * 客户端 product.json 写默认值，后端 `/v3/config` 下发覆盖。
-     * 设置为 true 时启用 Ardot 设计入口；缺省 / false 关闭（opt-in）。
+     * 设置为 true 时向设计会话暴露 ardot MCP（含其静默授权）、展示 Ardot 场景胶囊并自动注入 ardot skill；缺省 / false 关闭（opt-in）。
+     * 「设计创意」Tab 不再由本开关决定：Miora 能力恒可用，Tab 始终展示。
      * 各版本默认值：SaaS（个人版 / 旗舰版）= true；专享版 / 专享版私有化 / 海外版 = false。
      *
      * 版本说明：5.4.0 之前的客户端版本仍使用 `TencentDesignX` 开关控制 Ardot 设计入口；
@@ -1117,6 +1119,15 @@ export declare enum ProductFeature {
      * @default false
      */
     EnableArdot = "EnableArdot",
+    /**
+     * Miora 族（AI 生图 / 生视频）能力开关，**仅打包期生效**，运行时没有任何代码读取。
+     * 定制版构建由 `apps/workbuddy-desktop/scripts/apply-brand-patch.js` 读取：显式 false 时
+     * 从产物中裁掉 Miora 设计胶囊、前端路由入口、四个 miora skill 与 mcp-miora，出包即固定，
+     * 后端 `/v3/config` 下发也无法重新打开。
+     * 各版本默认值：缺省 = 可用；专享版 / 专享版私有化（workbuddy-custom）= false。
+     * @default true
+     */
+    EnableMiora = "EnableMiora",
     /**
      * HTML 预览分享按钮开关
      * 启用后，HTML 文件预览面板的 actionbar 中展示分享按钮
@@ -1329,6 +1340,31 @@ export declare enum ProductFeature {
      * @default false（未配置默认不启用云端专家能力）
      */
     EnableExpertToCloud = "EnableExpertToCloud",
+    /**
+     * 客户端是否消费企业「专家页」装配布局（Issue #100136）。
+     *
+     * 开启后客户端专家页的三个区域（顶部推荐槽 / Tab 条 / 分类 chip 栏）
+     * 按 admin 装配的布局渲染；关闭时全部回落客户端本地默认布局。
+     *
+     * 「专享版 / 私有化」的判定依据：该形态下 `enterpriseId` 可能为空或不可靠，
+     * 仅靠 `enterpriseId` 判定会把专享版误判成个人版而丢失企业配置
+     * （与 skill 侧 `EnableSkillPageLayout` 同款实测结论）。故本 flag 随
+     * **专享版包**注入 true，客户端判定为：
+     *
+     * ```
+     * 消费 layout = 本 flag === true
+     *            || (enterpriseId 存在 && !isTencentSSO(enterpriseId))   // 旗舰版
+     * ```
+     *
+     * 只在 `build/patches/workbuddy-custom/product.json`（专享版）置 true，
+     * **其余产品配置不写** —— 缺失即 false，判定回落到 enterpriseId 分支。
+     *
+     * ⚠️ 同一变量也决定 admin 侧是否展示「客户端页面装配 / 推荐位 / 分类管理」
+     * 三个 Tab，两端共用同一源以避免判定漂移（对齐 skill 侧 §7.1.2 的结论）。
+     *
+     * @default false（缺省即关闭；仅专享版 product.json 置 true）
+     */
+    EnableExpertPageLayout = "EnableExpertPageLayout",
     /**
      * 禁用对话框中的语音输入（ASR）入口
      * 设置为 true 时，隐藏聊天输入框中的麦克风按钮，
@@ -1421,21 +1457,6 @@ export declare enum ProductFeature {
      * @default false
      */
     EnableClawChannelControl = "EnableClawChannelControl",
-    /**
-     * 是否隐藏设置面板「助理设置 → 远程渠道」整个区块（含微信助理 / 企微机器人 /
-     * QQ 机器人等通道卡片与定时任务企微 bot 推送卡片）。
-     *
-     * 仅隐藏 UI 入口，不影响「上下文管理」（Session Management）等其他区块。
-     * 专享版（Cloud-Hosted）与私有化（Self-Hosted）定制渠道不支持远程助理渠道，
-     * 在 workbuddy-custom base 的 productFeatures 配置 true（私有化构建自动继承）；
-     * 运行期也可经 /v3/config 下发覆盖（如放开某个已部署网关的租户）。
-     *
-     * - 旗舰版（标准渠道）：不配置该 key → 不禁用，远程渠道照常展示（fail-open）
-     * - 专享版 / 私有化：配置 true → 隐藏区块；缺省（未配置）同旗舰版展示
-     *
-     * @default false
-     */
-    DisableClawRemoteChannels = "DisableClawRemoteChannels",
     /**
      * 是否启用 AI 代码入库率统计能力
      *
@@ -1650,14 +1671,6 @@ export declare enum ProductFeature {
      * @default false（未配置默认不启用云端 Skill 能力）
      */
     EnableSkillToCloud = "EnableSkillToCloud",
-    /**
-     * 是否禁用侧边栏扩展菜单入口（disable 语义）。#114901
-     * 设置为 true 时，侧边栏与「更多」下拉均不渲染扩展（extension）菜单入口。
-     * 用于无需暴露扩展导航栏的发行版（如海外版 workbuddy-ai）。
-     * 缺省 / false 时行为不变（正常展示扩展入口）。
-     * @default false
-     */
-    DisableExtensionMenuEntries = "DisableExtensionMenuEntries",
     /**
      * 是否禁用「存储扩容/升级」入口（disable 语义）。#73830 #73721
      *
@@ -1915,7 +1928,19 @@ export declare enum ProductFeature {
      * productFeatures 下发（消费方 skill-subscription-gate.isEnabled）。
      * @default true
      */
-    SkillSubscriptionGate = "SkillSubscriptionGate"
+    SkillSubscriptionGate = "SkillSubscriptionGate",
+    /**
+     * 是否隐藏 Office 独立窗标题栏「AI 对话」按钮内的官方品牌图标。
+     *
+     * 该图标是 WorkBuddy 吉祥物轮廓，专享版自定义品牌后属于残留的官方标识。
+     * 开启后仅去掉图标，按钮与「AI 对话」文案保留。
+     *
+     * 只作用于这一个图标，不影响登录页 / 聊天页品牌 logo（那些由
+     * `HideCustomBrandingLogos` 控制）。
+     *
+     * @default false
+     */
+    HideOfficeChatBrandIcon = "HideOfficeChatBrandIcon"
 }
 /**
  * 功能配置开关

package/cli/dist-server/types/workspace/product/lib/common/types/language-model.d.ts

@@ -104,7 +104,12 @@ export interface ModelReasoning {
 export type ModelPromotionKind = 'discount' | 'new_model' | 'recommendation' | 'free_trial';
 export interface ModelPromotionBadge {
     readonly label: string;
-    readonly color: string;
+    readonly shortLabel?: string;
+    /** 英文 badge 文案；缺省回退 label */
+    readonly labelEn?: string;
+    readonly shortLabelEn?: string;
+    readonly icon?: string;
+    readonly color?: string;
     readonly display?: 'always' | 'activeOnly';
 }
 export interface ModelPromotionDailyWindow {