dsh-llm-codebuddy-power 1.0.0

package/lib/types/client/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Web 客户端部分:一个 CodeBuddy 设置页,以及对话框输入区的账号控件。
+ *
+ * 在 `settings.section` 中注册一个条目 —— 一个展示全部已登录账号、追加登录、
+ * 退出单个或选中账号、指定默认账号的 “CodeBuddy” 页面 —— 再在
+ * `conversation.input.right` 中注册一个条目,在 CodeBuddy 模型按钮左侧渲染当前
+ * 会话的额度圆环与账号切换按钮。
+ *
+ * 两个条目处在**不同作用域**(设置页 root、输入区 session),而一个 store handle
+ * 只能绑一个作用域,因此它们不共用句柄:设置页持有 store,对话控件按会话经 RPC
+ * 自取账号集合与用量(见该处的注册注释)。
+ *
+ * @module dsh-llm-codebuddy-power/client
+ */
+import type { Context } from '@deepseek-ai/cordis';
+export type { CodeBuddySectionInjected, CodeBuddySectionProps, } from './CodeBuddySection.tsx';
+export type { ComposerControlsProps, CodeBuddyComposerControlsProps } from './ComposerControls.tsx';
+export type { AccountSwitcherInjected } from './AccountSwitcher.tsx';
+export type { CodeBuddyKey } from './locales.ts';
+export type { CodeBuddyPrefs } from '../prefs.ts';
+/** 必需服务:插槽注册表、locale 服务、wire、共享模型目录服务(该面板读取
+ *  与官方选择器相同的 store)、uiConversation(附件图片 URL),以及设置作用域
+ *  (界面偏好所在的命名空间)。
+ *
+ *  声明 `sessions`/`remote`/`remote.session` 是因为
+ *  `modelDirectories.directoryFor()` 在本插件的 Context 下运行,并在构建
+ *  会话目录时读取这些服务。 */
+export declare const inject: string[];
+/**
+ * 在插槽声明后注册 CodeBuddy 设置分区与对话内账号控件。
+ * @param ctx - 客户端根 context。
+ */
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/locales.d.ts

@@ -0,0 +1,90 @@
+/** CodeBuddy 设置分区与对话内账号控件的文案字典。 */
+/** 英文字符串(zh/en 键集合的事实来源)。 */
+export declare const en: {
+    nav: string;
+    intro: string;
+    loading: string;
+    notSignedIn: string;
+    waiting: string;
+    signIn: string;
+    signingIn: string;
+    copyLoginLink: string;
+    copyLoginLinkFailed: string;
+    copied: string;
+    cancelLogin: string;
+    timeout: string;
+    multiSelect: string;
+    multiSelectDone: string;
+    selectAccount: string;
+    logoutSelectedTip: string;
+    logoutTitle: string;
+    logoutSelectedTitle: string;
+    logoutDesc: string;
+    logoutSelectedDesc: string;
+    logoutConfirm: string;
+    cancel: string;
+    chooseDefault: string;
+    clearDefault: string;
+    defaultTag: string;
+    nickname: string;
+    uid: string;
+    loginExpires: string;
+    uin: string;
+    enterprise: string;
+    enterpriseId: string;
+    enterpriseUser: string;
+    department: string;
+    switchAccount: string;
+    showUsage: string;
+    showUsageDesc: string;
+    drawToolMinimal: string;
+    drawToolMinimalDesc: string;
+    dangerPct: string;
+    dangerPctDesc: string;
+    usageUsed: string;
+    usageMain: string;
+    usageGift: string;
+    usageResets: string;
+    drawGenerating: string;
+    drawGenerated: string;
+    drawImageLoading: string;
+    drawImageAlt: string;
+    drawImageOpen: string;
+    drawImagePreviewTitle: string;
+    drawImagePreviewClose: string;
+    turnCredit: string;
+    turnCreditTip: string;
+    turnCreditAccount: string;
+    modelPanelTrigger: string;
+    modelPanelTitle: string;
+    modelPanelEmpty: string;
+    modelPanelSelectError: string;
+    modelPanelContextWindow: string;
+    modelPanelMaxOutput: string;
+    modelPanelFeatures: string;
+    modelPanelSpendRate: string;
+    modelPanelUse: string;
+    modelPanelUpgrade: string;
+    modelPanelEdit: string;
+    modelPanelDescriptionMissing: string;
+    modelPanelSave: string;
+    modelPanelSaving: string;
+    modelPanelRestoreDefault: string;
+    modelPanelEffort: string;
+    modelPanelEffortDefault: string;
+    modelPanelFeatureImage: string;
+    modelPanelFeatureReasoning: string;
+};
+/** settings.codebuddy 命名空间的键联合。 */
+export type CodeBuddyKey = keyof typeof en;
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** CodeBuddy 设置页与对话内账号控件的文案。 */
+        'settings.codebuddy': CodeBuddyKey;
+    }
+}
+/** 中文字符串(键与 {@link en} 相同)。 */
+export declare const zh: {
+    [Key in keyof typeof en]: string;
+};
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/client/poll.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 参数化的轮询钩子:入参说明「查什么数据」「多久查一次」「这里是否需要它」。
+ *
+ * 抽成共享钩子而不是各组件自建定时器,是为了让计时器的建立与清理只写一次;节奏仍由
+ * 每个消费方按自己那份数据的更新速度给出 —— 两份数据的更新速度不同,不该被迫取同一个值。
+ *
+ * @module dsh-llm-codebuddy-power/client/poll
+ */
+/**
+ * 启用时立即读取一次数据源,其后每 `intervalMs` 重复;停用时不读取也不计时。
+ *
+ * `read` 经 ref 持有,因此调用方可以传内联闭包:轮询节奏只由 `intervalMs` 与
+ * `active` 决定,不会因为闭包每次渲染都是新身份而反复重建计时器。
+ * @param read - 每次轮询要读取的数据。
+ * @param intervalMs - 两次读取之间的间隔,单位 ms;由该数据自身的更新速度决定。
+ * @param active - 这里是否需要这份数据;为假时不读取也不轮询,由假转真会立即读取一次。
+ */
+export declare function usePolledRead(read: () => void, intervalMs: number, active: boolean): void;
+//# sourceMappingURL=poll.d.ts.map

package/lib/types/client/store.d.ts

@@ -0,0 +1,59 @@
+/**
+ * CodeBuddy 页面 store:设置分区共享的账号快照。
+ *
+ * 客户端插件在设置页条目下挂载本句柄,因此在设置分区里完成的登录、退出或改
+ * 默认账号无需跨组件接线即可到达同一页面的各个徽章。
+ *
+ * **界面偏好不在这里**:它们是 harness 用户设置文档里的一段(见 `../prefs.ts`),
+ * 由 `./index.ts` 经 `ctx.settingsScope.bind()` 读取,并以一个派生的活快照经
+ * 注入面的 `hooks` 隔舱同时下发给设置页与对话输入区的控件组 —— 后者处在另一个
+ * 作用域,共享不了本句柄。偏好此前存在 `localStorage` 并由输入区按 5 秒轮询
+ * 读取,导致开关与圆环之间有最多一个轮询周期的延迟。
+ *
+ * @module dsh-llm-codebuddy-power/client/store
+ */
+import { type EngineStoreHandle } from '@deepseek-ai/dsh-client-store';
+import type { CodeBuddyAccountView, CodeBuddyAccountsResult } from './wire.ts';
+/** 该分区循环经历的 UI 阶段。 */
+export type CodeBuddyPhase = 'loading' | 'idle' | 'error';
+/** 一次进行中的浏览器登录握手。 */
+export interface PendingLogin {
+    /** 宿主发起的握手 id,轮询时回传。 */
+    state: string;
+    /**
+     * 发起时刻(epoch ms)。截止时间据此计算并存进 store —— 放在组件的 effect 里会让
+     * 每次重新挂载(关闭再打开设置页)都把计时归零,于是反复开关就能把"登录中…"
+     * 无限延长。
+     */
+    startedAt: number;
+}
+/** 设置分区共享的页面快照。 */
+export interface CodeBuddyState {
+    phase: CodeBuddyPhase;
+    /** 整页失败文案;行级 RPC 失败留在调用方。 */
+    error: string | null;
+    /** 已存账号;加载中或未登录时为空数组。 */
+    accounts: CodeBuddyAccountView[];
+    /** 用户显式指定的默认账号 uid;未指定时为 null。 */
+    defaultUid: string | null;
+    /** 正在轮询浏览器登录握手时非 null。 */
+    loginState: PendingLogin | null;
+}
+/** 声明的 action 结构,为导出的工厂提供稳定的返回类型。 */
+type CodeBuddyActions = {
+    /** 进入加载阶段并丢弃先前的状态/错误。 */
+    start: (draft: CodeBuddyState) => void;
+    /** 发布账号集合与默认账号,并离开加载阶段。 */
+    setAccounts: (draft: CodeBuddyState, result: CodeBuddyAccountsResult) => void;
+    /** 发布页面级失败。 */
+    fail: (draft: CodeBuddyState, message: string) => void;
+    /** 跟踪进行中的浏览器登录握手(null 表示没有)。 */
+    setLoginState: (draft: CodeBuddyState, state: PendingLogin | null) => void;
+};
+/**
+ * 声明 CodeBuddy 页面状态与写入接口。
+ * @returns store 句柄(在 apply 中挂载于设置页条目下)。
+ */
+export declare function createCodeBuddyStore(): EngineStoreHandle<CodeBuddyState, CodeBuddyActions>;
+export {};
+//# sourceMappingURL=store.d.ts.map

package/lib/types/client/wire.d.ts

@@ -0,0 +1,147 @@
+/**
+ * CodeBuddy 鉴权 RPC 通道的客户端 wire 契约。
+ *
+ * host 的 `CodeBuddyAuthService` 在 Connection 通道 `/codebuddy` 上注册这些
+ * endpoint;此处的 payload 结构是 host 自身应答类型的客户端投影。仅纯 JSON
+ * 数据 —— 浏览器标签页可以调用它们,但永远看不到 host 对象。
+ */
+import type { ClientConnectionRpc, ConnectionRpcResult } from '@deepseek-ai/dsh-client-connection/client';
+/** host 鉴权服务监听的 RPC 通道(与 host 常量保持一致)。 */
+export declare const AUTH_CHANNEL = "/codebuddy";
+/**
+ * host `accounts` endpoint 上报的一个账号。
+ *
+ * 字段按"可能缺失"声明,尽管宿主侧同名字段是必填:两个编译面**不是**原子部署的 ——
+ * 客户端插件可以经 HMR 单独重载,而宿主仍在跑旧的 `lib/index.js`。旧宿主不带新字段,
+ * 按必填声明会让缺失悄悄变成 `Invalid Date` 而不是一处类型错误。
+ */
+export interface CodeBuddyAccountView {
+    uid: string;
+    nickname: string;
+    /** 刷新令牌的绝对过期时刻(epoch ms);旧宿主不提供时缺省。 */
+    loginExpiresAt?: number;
+    uin?: string;
+    enterpriseId?: string;
+    enterpriseName?: string;
+    enterpriseUserName?: string;
+    departmentFullName?: string;
+}
+/** host `accounts` endpoint 返回的结构。 */
+export interface CodeBuddyAccountsResult {
+    accounts: CodeBuddyAccountView[];
+    /** 用户显式指定的默认账号;未指定时缺省。 */
+    defaultUid?: string;
+}
+/** `startLogin` 的结果结构。 */
+export interface CodeBuddyLoginStart {
+    authUrl: string;
+    state: string;
+}
+/** `pollLogin` 的结果结构。 */
+export interface CodeBuddyLoginPoll {
+    done: boolean;
+    nickname?: string;
+}
+/** `sessionAccount` 的结果结构。 */
+export interface CodeBuddySessionAccount {
+    /** 该会话此刻生效的账号 uid;一个账号也没有时缺省。 */
+    uid?: string;
+}
+/** host `usage` endpoint 上报的一个计量窗口。 */
+export interface CodeBuddyUsageWindow {
+    name: string;
+    used?: number;
+    limit?: number;
+    resetsAt?: string;
+}
+/** 一个聚合后的额度池。 */
+export interface CodeBuddyUsagePool {
+    used: number;
+    limit: number;
+}
+/** 赠送额度的汇总,以及其提示框中最快到期部分的明细。 */
+export interface CodeBuddyUsageGift extends CodeBuddyUsagePool {
+    /** 生效中的赠送窗口,按最快到期排序,最多 5 个。 */
+    soonest: CodeBuddyUsageWindow[];
+}
+/** host `usage` endpoint 返回的用量结果结构。 */
+export interface CodeBuddyUsageResult {
+    loggedIn: boolean;
+    /** 首个计量窗口的重置时刻;圆环的提示把它与额度数值显示在一起。 */
+    primaryResetsAt?: string;
+    /** 可续期的主额度池。 */
+    main?: CodeBuddyUsagePool;
+    /** 一次性的赠送额度池及其最快到期明细。 */
+    gift?: CodeBuddyUsageGift;
+}
+/** 一条促销的面向前端展示信息(与 host 投影保持一致)。 */
+export interface CodeBuddyPromotionView {
+    label: string;
+    color: string;
+    discountedCredits?: string;
+    displayMode?: string;
+    textZh?: string;
+    textEn?: string;
+    action?: {
+        type?: string;
+        labelZh?: string;
+        labelEn?: string;
+    };
+}
+/** 一个模型档位的面向前端展示信息。 */
+export interface CodeBuddyTierView {
+    label: string;
+    textZh?: string;
+    textEn?: string;
+    action?: {
+        type?: string;
+        labelZh?: string;
+        labelEn?: string;
+    };
+}
+/** 供面板使用的一条增强后的 CodeBuddy 模型记录。 */
+export interface CodeBuddyModelRow {
+    id: string;
+    name: string;
+    credits?: string;
+    promotion?: CodeBuddyPromotionView;
+    tier?: CodeBuddyTierView;
+    supportsImages?: boolean;
+    supportsReasoning?: boolean;
+    supportsToolCall?: boolean;
+    contextWindow?: number;
+    maxOutputTokens?: number;
+    /** 目录公布的容量上限,不受用户覆写影响;编辑时用它限制可输入的上限。 */
+    contextWindowCap?: number;
+    /** 目录公布的最大输出上限;与 `contextWindowCap` 同理。 */
+    maxOutputTokensCap?: number;
+    descriptionZh?: string;
+    descriptionEn?: string;
+}
+/** `models` 返回给客户端的结构。 */
+export interface CodeBuddyModelsResult {
+    models: CodeBuddyModelRow[];
+}
+/** 按模型的用户上限,与 host 覆写表条目保持一致。 */
+export interface CodeBuddyModelOverrides {
+    contextWindow?: number;
+    maxOutputTokens?: number;
+}
+/** `creditOf` 上报的一个账号。 */
+export interface CodeBuddyTurnCreditAccountView {
+    nickname: string;
+    /** 账号 uid 的前段,只用于区分同名账号。 */
+    uidPrefix: string;
+}
+/** `creditOf` 返回的每轮积分记录;该轮没有记录时缺省。 */
+export interface CodeBuddyTurnCreditRecord {
+    credit: number;
+    /** 本轮扣分用过的账号,按首次使用排序;一轮里切换过账号时会有多个。 */
+    accounts: CodeBuddyTurnCreditAccountView[];
+}
+/**
+ * 在共享通道上调用一个鉴权 endpoint。该通道调用按设计不做类型约束;
+ * endpoint 所记录的 payload 结构在此唯一的 wire 边界处恢复。
+ */
+export declare function authCall<T>(rpc: ClientConnectionRpc, endpoint: string, payload?: unknown): Promise<ConnectionRpcResult<T>>;
+//# sourceMappingURL=wire.d.ts.map

package/lib/types/codebuddy.d.ts

@@ -0,0 +1,187 @@
+/**
+ * CodeBuddy 控制面客户端:浏览器 OAuth 握手、令牌刷新,
+ * 以及非 OpenAI 模型目录。
+ *
+ * 这里的每次调用都以 `{code, msg, data}` 信封而非仅 HTTP 状态码
+ * 表达结果,因此返回 200 却带有非零 `code` 即为失败,并
+ * 按失败上报。本模块只负责传输:不持有状态,也不做
+ * 策略决策,因此登录流程、适配器与 CLI 得以共用
+ * 同一份实现。
+ *
+ * @module dsh-llm-codebuddy-power/codebuddy
+ */
+import type { Account, AuthState, AuthToken, CodeBuddyConfig } from './types.ts';
+/** CodeBuddy 在每个已认证请求上要求的身份信息。 */
+export interface CodeBuddyIdentity {
+    accessToken: string;
+    domain: string;
+    uid: string;
+    enterpriseId?: string;
+    departmentFullName?: string;
+}
+/**
+ * 官方 CodeBuddy CN 4.11.3 客户端在其 CustomFetch 面(chat、catalog)上
+ * 发送的组合 IDE `User-Agent`。实测抓包为 `CodeBuddyIDE/4.11.3 CodeBuddy/4.11.3`。
+ * @returns IDE user-agent 字符串。
+ */
+export declare function ideUserAgent(): string;
+/**
+ * 官方 IDE 主进程的认证/计费客户端发送的 `User-Agent`。
+ *
+ * `main.js` 在一个裸 axios 实例上发起登录与计量请求(无拦截器
+ * 链),因此它们携带 axios 默认 UA —— 实测在 `/v2/plugin/auth/*` 与
+ * `/v2/billing/meter/*` 上抓到的值为 `axios/1.15.0`。
+ * @returns axios user-agent 字符串。
+ */
+export declare function axiosUserAgent(): string;
+/**
+ * 登录握手与计量共用的 axios 面请求头:
+ * axios 默认的 `Accept` 与 `User-Agent`,外加每次调用各自的头。
+ *
+ * 在官方 IDE 中这两个面运行在同一个裸 axios 客户端上,
+ * 因此尽管各自的额外头不同,帧结构仍相同。
+ * @param extra - 请求专属头(`X-No-*`、`Authorization` 等)。
+ * @returns 请求头。
+ */
+export declare function axiosRequestHeaders(extra: Record<string, string>): Record<string, string>;
+/**
+ * 发起一次浏览器登录握手。
+ * @param signal - 可选取消。
+ * @returns 握手状态,以及用户必须打开的 URL。
+ * @throws Error 服务拒绝或返回不可用的响应体时。
+ */
+export declare function requestAuthState(signal?: AbortSignal): Promise<AuthState>;
+/**
+ * 轮询,直到用户在浏览器中完成登录。
+ *
+ * 服务用 code {@link AUTH_PENDING_CODE} 表示“尚未完成”,
+ * 它是唯一让循环继续的 code;其他任何 code 都是已决结果,循环
+ * 就此结束。传输错误同样结束循环,因为状态可能已被消耗的
+ * 握手不得静默重试。
+ * @param state - 来自 {@link requestAuthState} 的握手 id。
+ * @param signal - 可选取消。
+ * @returns 签发的令牌;登录失败或超时时为 `undefined`。
+ */
+export declare function pollAuthToken(state: string, signal?: AbortSignal): Promise<AuthToken | undefined>;
+/**
+ * 读取已登录账号,其 uid 与企业 id 会成为之后每个请求的必需
+ * 请求头。
+ * @param state - 令牌所对应的握手 id。
+ * @param accessToken - 刚签发的 access token。
+ * @param domain - 令牌所对应的租户 domain。
+ * @returns 账号信息。
+ * @throws Error 服务拒绝或返回不可用的响应体时。
+ */
+export declare function getLoginAccount(state: string, accessToken: string, domain: string): Promise<Account>;
+/**
+ * 用 refresh token 换取新的 access token。
+ * @param identity - 当前身份,包含正被替换的 access token。
+ * @param refreshToken - 要使用的 refresh token。
+ * @returns 新令牌;刷新被拒绝时为 `undefined`。
+ */
+export declare function refreshAccessToken(identity: CodeBuddyIdentity, refreshToken: string): Promise<AuthToken | undefined>;
+/**
+ * 一个新的无连字符 uuid;CodeBuddy 各面用作请求 id 与
+ * 会话 id 的紧凑形式。
+ * @returns 32 个十六进制字符的 id。
+ */
+export declare function compactUuid(): string;
+/**
+ * 一个新的 trace id:32 个小写十六进制字符,即官方客户端的
+ * OpenTelemetry span 为 `x-trace-id` / `x-b3-traceid` 生成的形态
+ * (16 个随机字节的十六进制)。
+ * @returns 32 个十六进制字符的 trace id。
+ */
+export declare function traceId(): string;
+/**
+ * 一个新的 span id:16 个小写十六进制字符,即官方客户端的
+ * OpenTelemetry span 为 `x-b3-spanid` / 父 id 生成的形态
+ * (8 个随机字节的十六进制)。
+ * @returns 16 个十六进制字符的 span id。
+ */
+export declare function spanId(): string;
+/**
+ * 每个 CustomFetch 面请求(chat、catalog)都携带的共享客户端身份
+ * 头,与官方 IDE 4.11.3 的抓包一致:
+ * IDE user-agent、SaaS 产品标记、XMLHttpRequest 来源,以及
+ * 每个请求一个新生成的紧凑 `X-Request-ID`。
+ *
+ * CodeBuddy 的安全策略会拒绝任何它不认作自家客户端的 User-Agent
+ * (实测:带 harness 标识的 User-Agent 会被以 HTTP 400 / code 11128
+ * 拒绝)。提供方自身的产品身份是唯一被接受的载体,因此本函数是
+ * chat 与 catalog 两条传输上该身份的唯一来源。
+ * @returns 共享身份头,其中 request id 为新生成。
+ */
+export declare function clientIdentityHeaders(): Record<string, string>;
+/**
+ * 一次 chat 请求的 b3 / X-B3 trace 头,外加 CustomFetch 面同步
+ * 的原始 trace id 头。所有 id 每次调用都重新生成,
+ * 与官方客户端的每请求 span 一致。
+ * @returns trace 头,其中 trace/span id 为新生成。
+ */
+export declare function traceHeaders(): Record<string, string>;
+/**
+ * 一次图像生成请求的参数,与官方 IDE 的 `image_gen`
+ * 工具所接受的一致。
+ */
+export interface ImageGenArgs {
+    /** 要生成图像的文字描述。 */
+    prompt: string;
+    /** 输出尺寸;省略时 wire 上默认为 `1024x1024`。 */
+    size?: string;
+    /** 质量提示(`low`/`medium`/`high`);原样透传。 */
+    quality?: string;
+    /** 风格提示;原样透传。 */
+    style?: string;
+    /** 图像数量;服务最多只接受模型每次调用的上限。 */
+    n?: number;
+}
+/** 图像生成响应中有用的部分。 */
+export interface GeneratedImage {
+    /** 携带 PNG 字节的签名对象存储 URL(schema 允许为 null)。 */
+    url?: string;
+    /** 服务返回 base64 而非 URL 时的图像数据。 */
+    b64_json?: string;
+}
+/** 解析后的图像生成结果:图像以及计费的 credits。 */
+export interface ImageGenResult {
+    images: GeneratedImage[];
+    /** 本批次服务计费的 credits(`usage.credit`)。 */
+    usedCredits: number;
+}
+/**
+ * 通过 CodeBuddy 的图像模型生成图像。
+ *
+ * 复刻官方 IDE 的 `ImageGenTool` wire 调用(`POST
+ * /v2/images/generations`,模型 `hunyuan-image-alpha`),并发送完整的
+ * IDE 身份头,从而让计费控制台按给定的会话 id 将调用方
+ * 记为 IDE 客户端。服务收取的 credits 通过 `usage.credit` 带出。
+ * @param identityHeaders - 已认证的身份头(`requestIdentity`)。
+ * @param model - 文生图模型 id,例如 `hunyuan-image-alpha`。
+ * @param args - 生成提示词与选项。
+ * @param conversationIds - 为本次请求生成的会话/轮次/消息 id
+ *   (`X-Conversation-ID`、`X-Conversation-Request-ID`、
+ *   `X-Conversation-Message-ID`)。
+ * @param signal - 可选取消。
+ * @returns 生成的图像与计费的 credits。
+ * @throws Error 服务拒绝或返回不可用的响应体时。
+ */
+export declare function generateImage(identityHeaders: Record<string, string>, model: string, args: ImageGenArgs, conversationIds: {
+    conversationId: string;
+    requestId: string;
+    messageId: string;
+}, signal?: AbortSignal): Promise<ImageGenResult>;
+/**
+ * 读取 CodeBuddy 模型目录。
+ *
+ * 这是该服务中非 OpenAI 兼容的那一半,也是本插件无法被通用
+ * OpenAI 兼容路由取代的原因:该响应会披露每个模型的能力标记与
+ * 尺寸,而 `GET /models` 列表不会。
+ * @param identityHeaders - 已认证的身份头,由会话构建一次
+ *   (`requestIdentity()`),使 chat 与目录共用同一套。
+ * @param signal - 可选取消。
+ * @returns 目录。
+ * @throws Error 服务拒绝或返回不可用的响应体时。
+ */
+export declare function getConfig(identityHeaders: Record<string, string>, signal?: AbortSignal): Promise<CodeBuddyConfig>;
+//# sourceMappingURL=codebuddy.d.ts.map

package/lib/types/constants.d.ts

@@ -0,0 +1,67 @@
+/**
+ * CodeBuddy 服务的固定事实。
+ *
+ * 这些是协议常量而非用户配置:endpoint 同时承载 OAuth 握手与模型目录,
+ * 版本字符串则是服务期望插件客户端用于表明自身身份的内容。
+ *
+ * @module dsh-llm-codebuddy-power/constants
+ */
+/** 本插件在 `ctx.llm` 上注册的 provider 路由。 */
+export declare const CODEBUDDY_PROVIDER = "codebuddy";
+/** 在模型选择器与设置界面中展示的显示名。 */
+export declare const CODEBUDDY_DISPLAY_NAME = "CodeBuddy";
+/** CodeBuddy 服务根地址;认证握手与 `/v3/config` 都在此处。 */
+export declare const CODEBUDDY_ENDPOINT = "https://copilot.tencent.com";
+/**
+ * 兼容 OpenAI 的对话基础地址。只有对话 wire 路由兼容;`/v3/config` 处的
+ * 模型目录并不兼容,这就是本插件自带目录读取器、而不使用 OpenAI
+ * `GET /models` 列表的原因。
+ */
+export declare const CODEBUDDY_CHAT_BASE = "https://copilot.tencent.com/v2";
+/** 在对话与模型目录请求中上报的 IDE 版本,与官方 CodeBuddy CN 4.11.3 客户端一致。 */
+export declare const CODEBUDDY_IDE_VERSION = "4.11.3";
+/** 官方 IDE 的产品段名称,用于拼接后的 `User-Agent`。 */
+export declare const CODEBUDDY_PRODUCT_NAME = "CodeBuddy";
+/**
+ * 官方 IDE 主进程 auth/billing 客户端发送的 User-Agent。
+ *
+ * 登录与计量请求在 `main.js` 中使用裸 axios 实例(没有拦截器链),因此携带
+ * 的是 axios 默认 UA,而不是 CustomFetch 平面使用的 IDE 身份 UA。
+ * 实测抓包:`/v2/plugin/auth/*` 与 `/v2/billing/meter/*` 都发送 `axios/1.15.0`。
+ */
+export declare const CODEBUDDY_AXIOS_USER_AGENT = "axios/1.15.0";
+/**
+ * 目录完全未描述的模型所假定的上下文容量。
+ *
+ * 这是约定值,不是 CodeBuddy 提供的数字:服务按模型披露 `maxAllowedSize`,
+ * 不提供可回退的全局默认值。因此已列出的模型绝不会按此定尺寸——隐去容量的
+ * 条目会直接从头列表中丢弃。它只适用于目录未列出、却被显式指名的 id,
+ * 此时必须有假定值才能解析出路由。
+ */
+export declare const DEFAULT_CONTEXT_WINDOW = 128000;
+/** 未列出模型所假定的输出上限;同上的约定值。 */
+export declare const DEFAULT_MAX_TOKENS = 8192;
+/** 有一次流读取尚未完成时,provider 的默认最大空闲时间。 */
+export declare const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 300000;
+/**
+ * 单张请求图片在 base64 膨胀前的编码字节目标。
+ *
+ * 这是本插件对请求图片的唯一硬性约束:源图未超过它就不做任何转换。取值与
+ * 官方 CodeBuddy IDE 的拖放路径一致(`TARGET_SIZE_MB = 1`)。
+ */
+export declare const REQUEST_IMAGE_MAX_BYTES: number;
+/**
+ * 源图超过字节目标时逐档收紧的长边档位。
+ *
+ * 档位取自官方 CodeBuddy IDE 拖放路径的 `COMPRESS_ATTEMPTS`(1920、1440、1080)。
+ * 需要逐档重试是因为附件服务的编码阶梯只降质量、不再降尺寸,单靠一档无法保证
+ * 落到字节目标。
+ */
+export declare const REQUEST_IMAGE_DIMENSION_LADDER: readonly [1920, 1440, 1080];
+/** 浏览器登录流程等待用户完成的时长,单位 ms。 */
+export declare const LOGIN_TIMEOUT_MS: number;
+/** 等待浏览器登录完成时的轮询间隔,单位 ms。 */
+export declare const LOGIN_POLL_INTERVAL_MS = 1000;
+/** 含义为“浏览器登录尚未完成”的服务码。 */
+export declare const AUTH_PENDING_CODE = 11217;
+//# sourceMappingURL=constants.d.ts.map

package/lib/types/credit-store.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 插件自有的每轮积分持久化:按会话存到独立文件,绕过 dsh 会话日志白名单。
+ *
+ * 每会话一个 JSON 文件,内容为 `{ [turn]: { credit } }`(轮次号 → 该轮扣分)。
+ * 文件是纯增量记录:缺文件等价于空记录,写入是合并回写(原子替换)。模型不存
+ * ——dsh 用量自带。文件只增不删:会话被销毁(一次性子代理跑完即如此)不等于
+ * 用户删除了会话,此时删除会让那一轮的扣分永远查不到。
+ *
+ * @module dsh-llm-codebuddy-power/credit-store
+ */
+import type { TurnCreditRecord } from './session.ts';
+/**
+ * 读取一个会话的全部积分记录。
+ * @param sessionId - dsh 会话 id。
+ * @returns 轮次号 → 记录的映射;缺文件或损坏返回空对象(纯增量记录,无文件=无记录)。
+ */
+export declare function loadCredits(sessionId: string): Promise<Record<string, TurnCreditRecord>>;
+/**
+ * 合并写入一个会话某轮的积分(原子替换,文件不存在则新建)。
+ * @param sessionId - dsh 会话 id。
+ * @param turn - 轮次号。
+ * @param record - 该轮消耗的积分。
+ */
+export declare function saveCredit(sessionId: string, turn: number, record: TurnCreditRecord): Promise<void>;
+//# sourceMappingURL=credit-store.d.ts.map

package/lib/types/image-tool.d.ts

@@ -0,0 +1,34 @@
+/**
+ * codebuddy-draw 工具:调用 CodeBuddy 文生图模型生成图片,通过标准附件服务
+ * 持久化,并在对话中内联展示。
+ *
+ * 与官方 IDE 的 image_gen 工具一致:聊天模型用提示词调用它,请求携带全套 IDE
+ * 身份头(后台计费按 IDE 客户端与会话请求 id 记录)。生成的字节走
+ * attachments.saveImage 提交到标准附件仓库(content-addressed、归一化、
+ * 回放安全),轨迹/详情按标准 ImageBlock 渲染;对话卡片由浏览器半的
+ * DrawToolCard 经 uiConversation.imageUrl 标准附件通道读取展示。
+ *
+ * @module dsh-llm-codebuddy-power/image-tool
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { AttachmentStore, ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
+import type { CodeBuddySession } from './session.ts';
+/** 工具名;注册前检查唯一性。 */
+export declare const CODEBUDDY_DRAW_TOOL = "codebuddy-draw";
+/**
+ * 工具的标准输出:持久化图片引用 + 实际扣分 + 提示词。浏览器卡片按
+ * attachment 渲染,回放无需外部存储。
+ */
+export interface CodeBuddyDrawValue {
+    prompt: string;
+    usedCredits: number;
+    images: ImageAttachmentRef[];
+}
+/**
+ * 注册 codebuddy-draw 工具。
+ * @param ctx - 注册作用域;执行时使用 session 与 attachments。
+ * @param session - 已登录的 CodeBuddy 会话(身份头 + 会话 id)。
+ * @param attachments - 图片持久化所用的标准附件仓库。
+ */
+export declare function applyImageTool(ctx: Context, session: CodeBuddySession, attachments: AttachmentStore): void;
+//# sourceMappingURL=image-tool.d.ts.map