dsh-llm-codebuddy-power 1.2.0 → 1.3.0

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

@@ -2,7 +2,7 @@
  * CodeBuddy 设置分区:多账号登录页。
  *
  * 展示全部已登录账号(每个账号一个徽章),在此发起浏览器登录以**追加**账号、
- * 退出单个或选中的多个账号、指定或取消默认账号;下方是两种登录状态下都渲染的
+ * 退出单个或选中的多个账号、拖拽排序;下方是两种登录状态下都渲染的
  * 界面偏好行。退出是破坏性操作(会删除磁盘上的凭据),因此单个与批量都先弹确认框。
  * 弹窗可见性由 shell 拥有,故此处不需要关闭控件。
  */
@@ -22,7 +22,7 @@ export interface CodeBuddySectionInjected {
         /** 三个界面偏好的当前值,与对话输入区的控件组同源。 */
         prefs: HostObservable<CodeBuddyPrefs>;
     };
-    /** 重新读取账号集合与默认账号,并离开加载阶段。 */
+    /** 重新读取账号集合,并离开加载阶段。 */
     refreshAccounts: () => Promise<void>;
     /** 发起浏览器登录握手(在新标签页打开鉴权 URL);完成后账号被追加到列表。 */
     startLogin: () => Promise<void>;
@@ -49,12 +49,10 @@ export interface CodeBuddySectionInjected {
     /** 退出若干账号。 */
     logoutAccounts: (uids: string[]) => Promise<void>;
     /**
-     * 按给定顺序重排账号。顺序即展示顺序,并决定没有默认账号时用谁。
+     * 按给定顺序重排账号。顺序即展示顺序,并决定没有手动切换记录时用谁。
      * @param uids - 目标顺序上的全部账号 uid。
      */
     reorderAccounts: (uids: string[]) => Promise<void>;
-    /** 指定默认账号;`null` 表示取消默认账号。 */
-    setDefault: (uid: string | null) => Promise<void>;
     /** 写入一个界面偏好字段;该写入持久化到本入口的 profile patch。 */
     setPref: (field: keyof CodeBuddyPrefs, value: boolean | number) => void;
 }

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

@@ -7,9 +7,10 @@
  * 则渲染,无记录(非 CodeBuddy 轮)渲染为空。与官方 `TurnUsagePanel` 同构:
  * 图标 + 文字标签,点击无详情面板(仅展示一条合计)。
  *
- * 悬停提示附上本轮用过的账号:账号在扣分那一刻随记录写入(见 host 的
- * `recordCredit`),不是悬停时现查 —— 一轮里用户可以切换账号,现查会把整轮
- * 说成最后那个账号。
+ * 悬停提示附上本轮用过的账号与本轮请求 id:两者都在扣分那一刻随记录写入(见 host 的
+ * `recordCredit`),不是悬停时现查 —— 一轮里用户可以切换账号,而请求 id 每轮重铸,
+ * 现查会把整轮说成最后那个账号、或报出当前轮的 id。有 id 时点击 pill 复制它的完整值,
+ * 因为显示在提示里的那个值就是用户要拿去对账的东西。
  *
  * @module dsh-llm-codebuddy-power/client/TurnCreditPill
  */
@@ -27,7 +28,7 @@ export type TurnCreditPillProps = Pick<AssistantActionOwnerProps, 'messageId'> &
 /**
  * 每轮积分 pill。messageId 反查轮号后查该轮记录;无记录渲染为空(未用
  * CodeBuddy 模型即一轮 0 分也渲染,有记录即证明用了 CodeBuddy)。只显示
- * 积分,模型由 dsh 用量自带;悬停给出本轮用过的账号。
+ * 积分,模型由 dsh 用量自带;悬停给出本轮用过的账号与本轮请求 id。
  */
 export declare function TurnCreditPill(props: TurnCreditPillProps): ReactElement | null;
 //# sourceMappingURL=TurnCreditPill.d.ts.map

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

@@ -2,7 +2,7 @@
  * Web 客户端部分:一个 CodeBuddy 配置页(挂在侧边栏插件面板上),以及对话框输入区的账号控件。
  *
  * 在 `plugins.bundle.config` 中注册一个条目 —— 一个展示全部已登录账号、追加登录、
- * 退出单个或选中账号、指定默认账号的页面,按本包名派发到插件页本插件自己的卡片上 ——
+ * 退出单个或选中账号的页面,按本包名派发到插件页本插件自己的卡片上 ——
  * 再在 `conversation.input.right` 中注册一个条目,在 CodeBuddy 模型按钮左侧渲染当前
  * 会话的额度圆环与账号切换按钮。
  *

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

@@ -23,9 +23,6 @@ export declare const en: {
     logoutSelectedDesc: string;
     logoutConfirm: string;
     cancel: string;
-    chooseDefault: string;
-    clearDefault: string;
-    defaultTag: string;
     nickname: string;
     uid: string;
     loginExpires: string;
@@ -55,6 +52,11 @@ export declare const en: {
     turnCredit: string;
     turnCreditTip: string;
     turnCreditAccount: string;
+    turnCreditRequestId: string;
+    turnCreditCopy: string;
+    turnCreditCopyTip: string;
+    turnCreditCopied: string;
+    turnCreditCopiedTip: string;
     modelPanelTrigger: string;
     modelPanelTitle: string;
     modelPanelEmpty: string;

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

@@ -1,8 +1,8 @@
 /**
  * CodeBuddy 页面 store:配置页共享的账号快照。
  *
- * 客户端插件在配置页条目下挂载本句柄,因此在该页完成的登录、退出或改
- * 默认账号无需跨组件接线即可到达同一页面的各个徽章。
+ * 客户端插件在配置页条目下挂载本句柄,因此在该页完成的登录、退出或排序
+ * 无需跨组件接线即可到达同一页面的各个徽章。
  *
  * **界面偏好不在这里**:它们是插件自己的 volatile 配置字段(见 `../prefs.ts`),
  * 由 `./index.ts` 经 `ctx.configForms.get()` 读取,并以一个派生的活快照经
@@ -33,8 +33,6 @@ export interface CodeBuddyState {
     error: string | null;
     /** 已存账号;加载中或未登录时为空数组。 */
     accounts: CodeBuddyAccountView[];
-    /** 用户显式指定的默认账号 uid;未指定时为 null。 */
-    defaultUid: string | null;
     /** 正在轮询浏览器登录握手时非 null。 */
     loginState: PendingLogin | null;
 }
@@ -42,7 +40,7 @@ export interface CodeBuddyState {
 type CodeBuddyActions = {
     /** 进入加载阶段并丢弃先前的状态/错误。 */
     start: (draft: CodeBuddyState) => void;
-    /** 发布账号集合与默认账号,并离开加载阶段。 */
+    /** 发布账号集合,并离开加载阶段。 */
     setAccounts: (draft: CodeBuddyState, result: CodeBuddyAccountsResult) => void;
     /** 发布页面级失败。 */
     fail: (draft: CodeBuddyState, message: string) => void;

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

@@ -29,8 +29,6 @@ export interface CodeBuddyAccountView {
 /** host `accounts` endpoint 返回的结构。 */
 export interface CodeBuddyAccountsResult {
     accounts: CodeBuddyAccountView[];
-    /** 用户显式指定的默认账号;未指定时缺省。 */
-    defaultUid?: string;
 }
 /** `startLogin` 的结果结构。 */
 export interface CodeBuddyLoginStart {
@@ -150,6 +148,8 @@ export interface CodeBuddyTurnCreditRecord {
     credit: number;
     /** 本轮扣分用过的账号,按首次使用排序;一轮里切换过账号时会有多个。 */
     accounts: CodeBuddyTurnCreditAccountView[];
+    /** 本轮的 CodeBuddy 请求 id(完整值);记录写于该字段存在之前时为缺省。 */
+    requestId?: string;
 }
 /**
  * 在共享通道上调用一个鉴权 endpoint。该通道调用按设计不做类型约束;

package/lib/types/constants.d.ts

@@ -72,4 +72,11 @@ export declare const LOGIN_POLL_INTERVAL_MS = 1000;
 export declare const LOGIN_RESULT_RETENTION_MS: number;
 /** 含义为“浏览器登录尚未完成”的服务码。 */
 export declare const AUTH_PENDING_CODE = 11217;
+/**
+ * 一次性赠送活动所用的子产品编码。
+ *
+ * "裂变包"与"拉新权益包"两类赠送活动各有自己的 `PackageCode`,却共用这一个子产品
+ * 编码,而可续期主套餐用的是另一个,因此它是区分赠送与主体的稳定依据。
+ */
+export declare const CODEBUDDY_GIFT_SUB_PRODUCT_CODE = "sp_tcaca_codebuddyide_bonus_pack";
 //# sourceMappingURL=constants.d.ts.map

package/lib/types/index.d.ts

@@ -22,7 +22,7 @@ export { CodeBuddySession, NotLoggedInError } from './session.ts';
 export type { CodeBuddyAccountInfo, TurnCreditAccount, TurnCreditAccountView, TurnCreditRecord, TurnCreditRecordView, } from './session.ts';
 export { login } from './login.ts';
 export type { LoginHooks, LoginResult } from './login.ts';
-export { getStoragePath, loadStorage, removeAccounts, setDefaultAccount, setLastAccount, updateStorage, upsertAccount, } from './storage.ts';
+export { getStoragePath, loadStorage, removeAccounts, setLastAccount, updateStorage, upsertAccount, } from './storage.ts';
 export type { CodeBuddyStorage, CodeBuddyStoredAccount } from './storage.ts';
 export { loadSessionInfo, updateSessionInfo } from './session-store.ts';
 export type { SessionAccountRef, SessionInfo } from './session-store.ts';

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

@@ -28,7 +28,7 @@ export interface SessionAccountRef {
 }
 /** 一个会话的持久化信息。 */
 export interface SessionInfo {
-    /** 该会话选用的账号 uid;未选用时缺省,按默认账号解析。 */
+    /** 该会话选用的账号 uid;未选用时缺省,按账号级兜底解析。 */
     uid?: string;
     /** 本会话用过的账号,以文件内部序号为键;每轮记录里的账号引用指向这里。 */
     accounts: Record<string, SessionAccountRef>;

package/lib/types/session.d.ts

@@ -7,7 +7,8 @@
  * 并发调用会互相取到对方的刷新结果,其中一个的 token 永远停留过期。
  *
  * 账号由会话决定:某个会话显式选了账号就用它,否则顺延到派生它的会话(子代理、
- * fork)、默认账号、最后一次手动切换的账号,最后落到列表第一个。目录与计量快照
+ * fork),再落到账号级兜底(最后一次手动切换的账号,其次是列表第一个)。会话在
+ * 第一次真正发请求时把解析到的账号固定下来,此后不再跟随兜底。目录与计量快照
  * 也按账号分别缓存,因为不同账号的可用模型与额度本就可以不同。
  *
  * @module dsh-llm-codebuddy-power/session
@@ -64,7 +65,7 @@ export interface TurnCreditAccount {
     nickname: string;
 }
 /**
- * 每轮积分记录,即文件里的形状:消耗值,以及本轮用过的账号。
+ * 每轮积分记录,即文件里的形状:消耗值,本轮用过的账号,以及本轮请求 id。
  *
  * 账号只存账号表里的序号(见 `session-store.ts`),完整 uid 与昵称在表里各存一份。模型
  * 由 dsh 用量自带,插件不再存。
@@ -77,6 +78,15 @@ export interface TurnCreditRecord {
      * 每一个,事后悬停才不会把整轮说成最后那个账号。
      */
     accounts: string[];
+    /**
+     * 本轮的 CodeBuddy 请求 id。
+     *
+     * 一条记录一个,轮内所有请求共用,因此直接内联而不建表 —— 账号需要表是因为同一账号
+     * 在几十轮里反复出现,而请求 id 每轮都不同,没有可去重的重复。
+     *
+     * 可选是为了读出本字段存在之前写下的记录:那些轮次照常显示积分,只是拿不出 id。
+     */
+    requestId?: string;
 }
 /**
  * 解析出的一个账号:界面需要的两个事实。
@@ -91,6 +101,8 @@ export interface TurnCreditAccountView {
 export interface TurnCreditRecordView {
     credit: number;
     accounts: TurnCreditAccountView[];
+    /** 本轮请求 id;读到的记录早于该字段时为缺省。 */
+    requestId?: string;
 }
 /**
  * 把一条文件记录里的账号引用按账号表展开。
@@ -118,7 +130,7 @@ export declare class CodeBuddySession {
     private readonly logger?;
     /**
      * `listModels` 或 `resolveModel` 报出的内容可能变化时触发一次:账号集合变化
-     * (登录、退出、改默认账号)或各账号已读到的目录并集变大。
+     * (登录、退出)或各账号已读到的目录并集变大。
      */
     private readonly onModelsChanged?;
     private storage;
@@ -143,7 +155,7 @@ export declare class CodeBuddySession {
      *
      * 集合只由**带会话身份的**读取填充(聊天请求、模型面板),并供拿不到会话身份的
      * 调用方({@link knownModel}、`listModels`)查询:那些调用方无法知道该用哪个账号
-     * 的目录,主动读取只能落在默认账号上 —— 而当前会话用的可能正是另一个账号。
+     * 的目录,主动读取只能落在账号级兜底上 —— 而当前会话用的可能正是另一个账号。
      */
     private readonly knownCatalog;
     /** 按账号 uid 单飞的目录读取。 */
@@ -164,7 +176,7 @@ export declare class CodeBuddySession {
     constructor(logger?: SessionLogger | undefined, 
     /**
      * `listModels` 或 `resolveModel` 报出的内容可能变化时触发一次:账号集合变化
-     * (登录、退出、改默认账号)或各账号已读到的目录并集变大。
+     * (登录、退出)或各账号已读到的目录并集变大。
      */
     onModelsChanged?: (() => void) | undefined);
     /**
@@ -242,7 +254,7 @@ export declare class CodeBuddySession {
     /**
      * 由当前缓存的各账号目录重建合并目录。
      *
-     * 账号退出后的处理必须是"重建"而不是"清空":清空会让官方列表塌回默认账号,
+     * 账号退出后的处理必须是"重建"而不是"清空":清空会让官方列表塌回账号级兜底,
      * 而其余仍登录账号的目录本来就在手上 —— 继续并着才是"退出后重新合并当前已有的
      * 列表"。重建同时确定性地解决同 id 的归属:只剩下仍在的账号参与竞争。
      */
@@ -265,7 +277,7 @@ export declare class CodeBuddySession {
      * 或每记一次“最后切换的账号”都会被当成账号变更,从而丢掉按账号缓存的计量快照并
      * 广播一次模型变更 —— 那些都不是账号增删。真的增删时才会丢弃已退出账号的缓存并
      * 重建合并目录:退出一个账号后官方列表应当继续并着其余账号已读到的目录,而不是
-     * 塌回默认账号一个。
+     * 塌回账号级兜底那一个。
      */
     private refreshIfChanged;
     /** 账号条目,按 uid 查。 */
@@ -274,24 +286,41 @@ export declare class CodeBuddySession {
      * 该会话自身及其派生祖先显式选用的账号,由近及远。读取某个会话的信息可能要碰盘,
      * 因此本方法是异步的。
      *
-     * 走到祖先是因为子代理与 fork 出来的会话在界面上没有自己的账号按钮:它们若不
-     * 沿用父会话,就会静默改用默认账号,把一次派发记到另一个账号头上。
+     * 走到祖先是因为子代理与 fork 出来的会话在**固定之前**还没有自己的账号:子代理
+     * 界面上从来就没有账号按钮,若不沿用父会话就会静默改用账号级兜底,把一次派发记到
+     * 另一个账号头上;fork 有自己的按钮,但它在被切换之前也应当跟着父会话走。
      */
     private accountChain;
     /**
      * 该会话此刻生效的账号 uid。
      *
-     * 顺序:会话(或其派生祖先)显式选用的账号 → 默认账号 → 最后一次手动切换的
-     * 账号 → 列表第一个。指向已退出账号的选择会被跳过,而不是当成“没有账号”;
-     * 全部落空时返回 `undefined`,调用方据此报未登录。
+     * 顺序:会话(或其派生祖先)显式选用的账号 → 最后一次手动切换的账号 → 列表第一个。
+     * 指向已退出账号的选择会被跳过,而不是当成“没有账号”;全部落空时返回
+     * `undefined`,调用方据此报未登录。
      */
     private accountUidFor;
+    /**
+     * 把该会话此刻解析到的账号写进它自己的文件,使它从此不再跟随账号级兜底。
+     *
+     * 已有选择就不再动它。那有两种可能,而两种都不该被覆盖:早已固定的会话重写只是
+     * 同一份事实的重复落盘;而记录指向一个已退出账号时,读取侧按"没有选择"处理它,
+     * 磁盘上的记录则只增不删 —— 覆盖掉它会让该账号重新登录后不再回到这个会话。
+     * @param sessionId - dsh 会话身份。
+     * @param uid - 本次请求实际使用的账号 uid。
+     */
+    private pinAccount;
     private identityOf;
     /** 把刷新后的账号写回内存,并尽力落盘(写不进去也不影响本进程继续使用)。 */
     private persist;
     /**
      * 已存账号条目,在首次使用、失效之后以及文件被外部改动时从磁盘读取。
-     * @param sessionId - 用哪个会话的账号;会话未选用时按默认账号解析。
+     *
+     * 解析出的账号在返回前固定进该会话自己的文件,因此"这个会话用哪个账号"只在它
+     * 第一次真正发请求时从全局兜底取一次;此后用户别处切换账号不会再改变它。固定
+     * 挂在这里而不是账号解析处(见 {@link accountUidFor}),是因为本方法只被
+     * {@link requestIdentity} 调用,即只有真实请求经过 —— 界面上打开一个空会话所
+     * 触发的用量与目录读取不会落下任何记录。
+     * @param sessionId - 用哪个会话的账号;会话未选用时按账号级兜底解析。
      * @throws NotLoggedInError 未存有任何凭据时。
      */
     private require;
@@ -312,7 +341,7 @@ export declare class CodeBuddySession {
      * 两者在**同一次**身份解析中一起给出:分开解析会有两次账号选择,而账号是每次请求
      * 解析的(用户可在同一步里切换),两次解析可能落到不同账号上 —— 那样记进这一轮的
      * 账号名就与实际发出去的请求不符。缩写由落盘侧按同一规则算出,故此处给出完整账号。
-     * @param sessionId - 请求所属的会话;决定用哪个账号,缺省时用默认账号。
+     * @param sessionId - 请求所属的会话;决定用哪个账号,缺省时按账号级兜底。
      * @returns 身份请求头与发起该请求的账号。
      */
     requestIdentity(sessionId?: string): Promise<CodeBuddyRequestIdentity>;
@@ -322,21 +351,22 @@ export declare class CodeBuddySession {
      */
     isLoggedIn(): Promise<boolean>;
     /**
-     * 已存账号及其默认账号,供配置页与会话切换按钮展示。
-     * @returns 账号列表(顺序与磁盘一致)与默认账号 uid;未登录时列表为空。
+     * 已存账号,供配置页与会话切换按钮展示。
+     * @returns 账号列表(顺序与磁盘一致);未登录时列表为空。
      */
-    accountList(): Promise<{
-        accounts: CodeBuddyAccountInfo[];
-        defaultUid?: string;
-    }>;
+    accountList(): Promise<CodeBuddyAccountInfo[]>;
     /**
      * 某会话此刻生效的账号 uid。
-     * @param sessionId - dsh 会话身份;缺省时用默认账号。
+     * @param sessionId - dsh 会话身份;缺省时按账号级兜底。
      * @returns 账号 uid;一个账号也没有时为 `undefined`。
      */
     activeUid(sessionId?: string): Promise<string | undefined>;
     /**
      * 把某会话的账号切换为指定账号,并把它记为最后一次手动切换的账号。
+     *
+     * 该会话已有持久记录才写它自己的文件;一个还从未落过盘的新会话只更新账号级的
+     * `lastUid` —— 它可能永远不会被发过第一条消息,为它建文件会在磁盘上留下无人
+     * 认领的残留文件。这类会话在真正发请求时由 {@link require} 固定下来。
      * @param sessionId - dsh 会话身份。
      * @param uid - 要使用的账号 uid。
      * @returns 该 uid 是已存账号时为 true;否则不做任何改动并返回 false。
@@ -345,7 +375,7 @@ export declare class CodeBuddySession {
     /**
      * CodeBuddy 模型目录,短暂缓存,并在并发读取者之间共享。
      * @param signal - 底层读取的可选取消信号。
-     * @param sessionId - 用哪个会话的账号;缺省时用默认账号。
+     * @param sessionId - 用哪个会话的账号;缺省时按账号级兜底解析。
      * @returns 目录中的模型,按服务自身的顺序。
      */
     models(signal?: AbortSignal, sessionId?: string): Promise<readonly CodeBuddyModel[]>;
@@ -353,7 +383,7 @@ export declare class CodeBuddySession {
      * 目录及其推广与档位,在同一个 TTL 下按账号一起缓存,并按账号单飞,使列表与
      * 面板富化共享同一次读取。
      * @param signal - 底层读取的可选取消信号。
-     * @param sessionId - 用哪个会话的账号;缺省时用默认账号。
+     * @param sessionId - 用哪个会话的账号;缺省时按账号级兜底解析。
      * @returns 模型、推广与档位。
      */
     catalogData(signal?: AbortSignal, sessionId?: string): Promise<Catalog>;
@@ -362,7 +392,7 @@ export declare class CodeBuddySession {
      * 从各账号已读到的目录的并集里查一个模型,**不发起任何请求**。
      *
      * 供拿不到会话身份的调用方使用(适配器的 `resolveModel`):它无法知道该用哪个
-     * 账号的目录,主动读取只能落在默认账号上,而当前会话用的可能正是另一个账号 ——
+     * 账号的目录,主动读取只能落在账号级兜底上,而当前会话用的可能正是另一个账号 ——
      * 那会把一个账号独有的模型解析成保守的默认能力(上下文窗口、输出上限、图片输入
      * 全部按最保守处理)。并集由带会话身份的读取填充,因此这个查询零成本、也不改变
      * "谁在读目录"这件事。
@@ -383,7 +413,7 @@ export declare class CodeBuddySession {
      * 目录及其推广/档位;读不到时返回空值 —— 供面板使用的
      * {@link catalogData} 建议性读取孪生体。
      * @param signal - 可选取消信号。
-     * @param sessionId - 用哪个会话的账号;缺省时用默认账号。
+     * @param sessionId - 用哪个会话的账号;缺省时按账号级兜底解析。
      * @returns 目录与活动,或空列表。
      */
     catalogDataOrEmpty(signal?: AbortSignal, sessionId?: string): Promise<Catalog>;
@@ -393,7 +423,7 @@ export declare class CodeBuddySession {
      * 列出模型是配置页上的浏览动作,所以失败必须降级为“没有可显示的内容”,
      * 而不是让页面崩掉。请求路径直接使用 {@link models} 并保留真实失败。
      * @param signal - 可选取消信号。
-     * @param sessionId - 用哪个会话的账号;缺省时用默认账号。
+     * @param sessionId - 用哪个会话的账号;缺省时按账号级兜底解析。
      * @returns 目录,或空列表。
      */
     modelsOrEmpty(signal?: AbortSignal, sessionId?: string): Promise<readonly CodeBuddyModel[]>;
@@ -405,7 +435,7 @@ export declare class CodeBuddySession {
      * 其他每种失败(传输、解析、刷新过期)都在一条警告之后解析为
      * `undefined`。身份通过与聊天请求相同的按账号单飞刷新解析,所以并发的计量
      * 读取绝不会消耗两次刷新 token。
-     * @param sessionId - 用哪个会话的账号;缺省时用默认账号。
+     * @param sessionId - 用哪个会话的账号;缺省时按账号级兜底解析。
      * @param signal - 可选取消信号。
      * @returns 该快照;未存有任何凭据或计量平面不可达时为 `undefined`。
      */

package/lib/types/storage.d.ts

@@ -37,12 +37,10 @@ export interface CodeBuddyStoredAccount {
 }
 /** 持久化的账号集合。 */
 export interface CodeBuddyStorage {
-    /** 账号列表,顺序即展示顺序。 */
+    /** 账号列表,顺序即展示顺序;列表第一个在没有 `lastUid` 时兜底。 */
     accounts: CodeBuddyStoredAccount[];
-    /** 用户显式指定的默认账号;未指定时缺省。 */
-    defaultUid?: string;
     /**
-     * 最后一次被手动切换到(按会话)的账号;没有默认账号时作为兜底,所以存在这里
+     * 最后一次被手动切换到的账号,作为未选用账号的会话的兜底;所以存在这里
      * 而不是某个会话的文件里 —— 它是账号级的事实,不是某个会话的事实。
      */
     lastUid?: string;
@@ -94,17 +92,12 @@ export declare function upsertAccount(entry: CodeBuddyStoredAccount): Promise<vo
  */
 export declare function reorderAccounts(uids: readonly string[]): Promise<void>;
 /**
- * 移除若干账号,并清掉指向它们的默认账号与“最后一次手动切换”的账号。
+ * 移除若干账号,并清掉指向它们的“最后一次手动切换”的账号。
  * @param uids - 要移除的账号 uid。
  */
 export declare function removeAccounts(uids: readonly string[]): Promise<void>;
 /**
- * 指定或取消默认账号。
- * @param uid - 默认账号的 uid;传 `undefined` 取消默认账号。
- */
-export declare function setDefaultAccount(uid: string | undefined): Promise<void>;
-/**
- * 记下最后一次被手动切换到的账号(没有默认账号时作为兜底)。
+ * 记下最后一次被手动切换到的账号,作为未选用账号的会话的兜底。
  * @param uid - 被切换到的账号 uid。
  */
 export declare function setLastAccount(uid: string): Promise<void>;

package/lib/types/usage.d.ts

@@ -23,6 +23,8 @@ export interface UsageWindow {
     limit?: number;
     /** 窗口重置时刻的 ISO 风格时间戳,当披露了它时。 */
     resetsAt?: string;
+    /** 窗口是否为一次性赠送 `true`;可续期主套餐为 `false`。 */
+    gift: boolean;
 }
 /** 设置界面所渲染的已解析用量。 */
 export interface UsageSnapshot {
@@ -41,8 +43,8 @@ export interface UsageSnapshot {
      */
     main?: UsagePool;
     /**
-     * 一次性赠送池(推荐/裂变套餐):它自己的聚合进度条,其提示框列出最早过期的
-     * 有效赠送。
+     * 一次性赠送池("裂变包"/"拉新权益包"):它自己的聚合进度条,其提示框列出最早
+     * 过期的有效赠送。
      */
     gift?: GiftUsage;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-llm-codebuddy-power",
   "description": "A full-featured CodeBuddy (WorkBuddy) provider plugin.",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "icon": "./icon.svg",
   "license": "MIT",
   "contributors": [
@@ -52,8 +52,8 @@
     "LICENSE"
   ],
   "peerDependencies": {
-    "@deepseek-ai/dsh-home-paths": "^0.1.7-rc.2",
     "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-home-paths": "^0.1.7-rc.2",
     "@deepseek-ai/dsh-llm": "^0.1.7-rc.2",
     "@deepseek-ai/dsh-tools": "^0.1.7-rc.2",
     "@deepseek-ai/schemastery": "^3.18.4"
@@ -65,29 +65,29 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "typescript": "^6.0.3",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-agent": "^0.1.7-rc.2",
-    "@deepseek-ai/cordis": "^4.0.4",
-    "@deepseek-ai/dsh-attachment": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.7-rc.2",
     "@deepseek-ai/dsh-client-locale": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-store": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-attachment": "^0.1.7-rc.2",
+    "@deepseek-ai/cordis": "^4.0.4",
     "@deepseek-ai/dsh-client-ui-conversation": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-store": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-connection": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-model-selection": "^0.1.7-rc.2",
     "@deepseek-ai/dsh-client-ui-chat": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-agent": "^0.1.7-rc.2",
     "@deepseek-ai/dsh-client-ui-settings": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-plugin-manager": "^0.1.7-rc.2",
     "@deepseek-ai/dsh-client-ui-slots": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-model-selection": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-home-paths": "^0.1.7-rc.2",
     "@deepseek-ai/dsh-client-ui-tool": "^0.1.7-rc.2",
     "@deepseek-ai/dsh-fs": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-home-paths": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.7-rc.2",
     "@deepseek-ai/dsh-llm": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-plugin-manager": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.7-rc.2",
     "@deepseek-ai/dsh-session": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-settings": "^0.1.7-rc.2",
     "@deepseek-ai/dsh-tools": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-settings": "^0.1.7-rc.2",
     "@deepseek-ai/schemastery": "^3.18.4"
   },
   "dependencies": {