dsh-llm-codebuddy-power 1.0.0 → 1.3.0

package/lib/types/prefs.d.ts

@@ -1,23 +1,25 @@
 /**
- * CodeBuddy 界面偏好的命名空间契约,Host 与 Client 两面共享。
+ * CodeBuddy 界面偏好的契约,Host 与 Client 两面共享。
  *
- * 这些偏好是**插件自己的设置命名空间**里的一段:`Config` 提供部署级 base,
- * 用户在 Web 设置页的写入落在 harness 的用户设置文档里,因此换浏览器、重启
- * harness 后仍然生效 —— 其中「极简模式画图工具」还会被宿主读取来决定
- * `codebuddy-draw` 对模型是否可见,存在浏览器里会让同一次部署因浏览器而异。
+ * 这些偏好是**插件自己的 volatile 配置字段**:`Config` 里声明为 volatile 后,
+ * 设置表单按入口 id 把它们投影成可读写的表单,宿主在每次操作时读取当前值,因此
+ * 换浏览器、重启 harness 后仍然生效。其中「极简模式画图工具」还会被宿主读取来
+ * 决定 `codebuddy-draw` 对模型是否可见。
  *
- * 本文件必须保持零依赖:两面都会编译它,而 Client 面若因此引入 schemastery
+ * 本文件必须保持零运行时依赖:两面都会编译它,而 Client 面若因此引入 schemastery
  * 就会把它打进浏览器产物(校验 schema 是宿主面的事,见 `./settings.ts`)。
+ * `Volatile` 是纯类型导入,擦除后不留依赖。
  *
  * @module dsh-llm-codebuddy-power/prefs
  */
-/** 本插件拥有的设置命名空间,与插件名一致。 */
+import type { Volatile } from '@deepseek-ai/cordis';
+/** 本插件的设置入口 id,与插件名一致。 */
 export declare const CODEBUDDY_SETTINGS_NAMESPACE = "llm-codebuddy-power";
 /** 告警百分比的下界(含)。 */
 export declare const DANGER_PCT_MIN = 1;
 /** 告警百分比的上界(含)。 */
 export declare const DANGER_PCT_MAX = 100;
-/** 本插件在用户设置文档里持久化的界面偏好。 */
+/** 本插件的界面偏好;设置表单投影出的就是这个结构。 */
 export interface CodeBuddyPrefs {
     /** 对话输入区是否显示额度圆环。 */
     showUsage: boolean;
@@ -29,15 +31,17 @@ export interface CodeBuddyPrefs {
 /** 未覆盖任何一层时使用的偏好默认值。 */
 export declare const DEFAULT_CODEBUDDY_SETTINGS: CodeBuddyPrefs;
 /**
- * 插件配置里可覆盖的偏好字段。三者都是部署级默认值,用户设置文档中的写入
- * 覆盖它们。
+ * `Config` 里的界面偏好字段。
+ *
+ * 三者都声明为 volatile:设置表单只能读写 volatile 字段,而 volatile 引用在原地
+ * 更新,所以宿主每次 `.get()` 都拿到当前值,不必重挂插件。
  */
 export interface CodeBuddyPrefsConfig {
     /** 对话输入区是否显示额度圆环。 */
-    showUsage?: boolean;
+    showUsage: Volatile<boolean>;
     /** 圆环填充变为告警颜色的已用百分比。 */
-    dangerPct?: number;
+    dangerPct: Volatile<number>;
     /** 极简模式会话是否注入 codebuddy-draw 工具。 */
-    drawToolInMinimal?: boolean;
+    drawToolInMinimal: Volatile<boolean>;
 }
 //# sourceMappingURL=prefs.d.ts.map

package/lib/types/serialize.d.ts

@@ -2,28 +2,35 @@
  * 把 harness 消息序列化为 CodeBuddy(OpenAI 兼容)chat 请求。
  *
  * 用户文本被拼接,助手文本成为 `content`,工具调用成为
- * `tool_calls`,每个工具结果成为其自身的 `role: 'tool'` 消息 →
- * harness 把工具结果放在用户消息内部,而这条 wire 路由
- * 不接受这种形式。对于支持图像的模型,图像以 OpenAI 兼容的
- * `image_url` 部件(`data:<type>;base64,...`)出现在用户或工具 content
- * 数组中,与官方 CLI 的发送方式完全一致。工具结果的图只对 `read_image`
- * 这类"看图"工具发送,生成图工具的结果仍走纯文本信封。
+ * `tool_calls`,每个工具结果是一条 `role: 'tool'` 的 harness 消息,直接映射为
+ * 同名 wire 条目。对于支持图像的模型,用户消息里的图**不内联**:改为给出一段
+ * 引导模型自行用 `read_image` 读取的提示词(附件服务解析出的只读绝对路径);
+ * 解析不出路径时退回内联,以免模型既拿不到图也拿不到路径。`read_image` 的工具
+ * 结果仍内联图片本身 —— 那是像素交给模型的唯一途径。生成图工具的结果继续走
+ * 纯文本信封。
  *
  * @module dsh-llm-codebuddy-power/serialize
  */
-import type { GenerateOptions, Message } from '@deepseek-ai/dsh-llm';
+import type { GenerateOptions, ImageAttachmentAccessResolver, RequestMessage } from '@deepseek-ai/dsh-llm';
 import type { RequestImageAttachment } from '@deepseek-ai/dsh-attachment';
 import type { WireMessage, WireRequest } from './types.ts';
 /** 请求中每个图像已解析的请求版本,以 attachment id 为键。 */
 export type RequestImages = ReadonlyMap<RequestImageAttachment['attachment']['attachmentId'], RequestImageAttachment>;
 /**
  * 按顺序序列化整个对话。
+ *
+ * 工具结果在 harness 里是**独立的 `role: 'tool'` 消息**(`ToolResultMessage`),
+ * 因此这里逐条映射,而不是按块从 user 消息里筛选。
+ * developer 消息由运行时在 `projectToolUpdates` 中剥离(本 adapter 未声明
+ * `toolUpdate`),因此不会到达这里;万一到达即明确拒绝,而不是静默丢弃。
  * @param messages - harness 会话。
  * @param supportsImages - 所选模型是否声明支持图像输入。
  * @param images - 请求中每个图像已解析的请求版本。
- * @returns wire 消息,每个工具结果展开为独立条目。
+ * @param resolveAccess - 解析单张图在当前执行世界中的只读路径。
+ * @param route - 本请求的读图形态。
+ * @returns wire 消息,工具结果各自成为独立条目。
  */
-export declare function serializeMessages(messages: readonly Message[], supportsImages: boolean, images?: RequestImages): WireMessage[];
+export declare function serializeMessages(messages: readonly RequestMessage[], supportsImages: boolean, images?: RequestImages, resolveAccess?: ImageAttachmentAccessResolver, route?: 'direct' | 'ptc' | 'none'): WireMessage[];
 /**
  * 构建 chat-completions 请求体。始终流式并上报 usage;
  * 缺省的选项被省略而非以 null 发送,以便应用
@@ -31,7 +38,9 @@ export declare function serializeMessages(messages: readonly Message[], supports
  * @param options - 组装好的 harness 请求。
  * @param supportsImages - 所选模型是否声明支持图像输入。
  * @param images - 请求中每个图像已解析的请求版本。
+ * @param resolveAccess - 解析单张图在当前执行世界中的只读路径。
+ * @param route - 本请求的读图形态,由工具目录决定;写入前由调用方计算一次。
  * @returns 请求体。
  */
-export declare function serializeRequest(options: GenerateOptions, supportsImages: boolean, images?: RequestImages): WireRequest;
+export declare function serializeRequest(options: GenerateOptions, supportsImages: boolean, images?: RequestImages, resolveAccess?: ImageAttachmentAccessResolver): WireRequest;
 //# sourceMappingURL=serialize.d.ts.map

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
@@ -30,7 +31,7 @@ interface Catalog {
     promotions: readonly CodeBuddyModelPromotion[];
     tiers: readonly CodeBuddyModelTier[] | undefined;
 }
-/** 设置页与账号切换按钮读取的账号投影。 */
+/** 配置页与账号切换按钮读取的账号投影。 */
 export interface CodeBuddyAccountInfo {
     uid: string;
     nickname: string;
@@ -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,17 +413,17 @@ export declare class CodeBuddySession {
      * 目录及其推广/档位;读不到时返回空值 —— 供面板使用的
      * {@link catalogData} 建议性读取孪生体。
      * @param signal - 可选取消信号。
-     * @param sessionId - 用哪个会话的账号;缺省时用默认账号。
+     * @param sessionId - 用哪个会话的账号;缺省时按账号级兜底解析。
      * @returns 目录与活动,或空列表。
      */
     catalogDataOrEmpty(signal?: AbortSignal, sessionId?: string): Promise<Catalog>;
     /**
      * 目录;读不到时返回空列表。
      *
-     * 列出模型是设置页上的浏览动作,所以失败必须降级为“没有可显示的内容”,
+     * 列出模型是配置页上的浏览动作,所以失败必须降级为“没有可显示的内容”,
      * 而不是让页面崩掉。请求路径直接使用 {@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/settings.d.ts

@@ -1,9 +1,9 @@
 /**
- * 本插件设置命名空间的宿主 schema。
+ * 本插件的 `Config` schema —— 连接事实与界面偏好合一。
  *
- * 校验只在宿主发生:浏览器面若也引入 schemastery,它会连同校验器一起被打进
- * `lib/client.js`,而客户端本来就把服务端返回的数据当作已校验结果接收。因此
- * schema 只在此文件出现,浏览器面经 `./prefs.ts` 取同一份类型与默认值。
+ * 设置表单只投影**入口自己的 `Config`** 里声明为 `.volatile()` 的字段(入口 id
+ * 即命名空间),因此界面偏好字段与连接字段同在 `Config` 中,只有偏好那三个是
+ * volatile。
  *
  * 字段的默认值一律取自 `DEFAULT_CODEBUDDY_SETTINGS`,不在此重复字面量 ——
  * 两处各写一份时,改了一处就会出现「宿主默认 90、界面显示 80」这种只有用户
@@ -12,7 +12,10 @@
  * @module dsh-llm-codebuddy-power/settings
  */
 import z from '@deepseek-ai/schemastery';
-import type { CodeBuddyPrefs } from './prefs.ts';
-/** 用户设置文档中本插件命名空间的 schema。 */
-export declare const CodeBuddySettingsSchema: z<CodeBuddyPrefs>;
+/** `Config.showUsage` 的 schema。 */
+export declare const ShowUsageField: z<boolean, boolean, "volatile-defined">;
+/** `Config.dangerPct` 的 schema。 */
+export declare const DangerPctField: z<number, number, "volatile-defined">;
+/** `Config.drawToolInMinimal` 的 schema。 */
+export declare const DrawToolInMinimalField: z<boolean, boolean, "volatile-defined">;
 //# sourceMappingURL=settings.d.ts.map

package/lib/types/storage.d.ts

@@ -5,7 +5,7 @@
  * (`$DSH_HOME/data/plugins/llm-codebuddy-power/`,通过 harness 所用的同一个
  * `@deepseek-ai/dsh-home-paths` 解析),而不放在插件包内,因此重装不会让
  * 用户退出登录。写入经 [atomic-file.ts](./atomic-file.ts) 做原子替换并按路径串行化:
- * 多个账号的令牌刷新、设置页的增删与 CLI 的调用都在改同一份文件,不串行化时
+ * 多个账号的令牌刷新、配置页的增删与 CLI 的调用都在改同一份文件,不串行化时
  * 两个并发写入会各自基于自己读到的旧内容覆盖对方。残缺文件会让用户手里只有
  * 一份读不出的凭据,还无法与“从未登录过”区分开。
  *
@@ -37,12 +37,10 @@ export interface CodeBuddyStoredAccount {
 }
 /** 持久化的账号集合。 */
 export interface CodeBuddyStorage {
-    /** 账号列表,顺序即展示顺序。 */
+    /** 账号列表,顺序即展示顺序;列表第一个在没有 `lastUid` 时兜底。 */
     accounts: CodeBuddyStoredAccount[];
-    /** 用户显式指定的默认账号;未指定时缺省。 */
-    defaultUid?: string;
     /**
-     * 最后一次被手动切换到(按会话)的账号;没有默认账号时作为兜底,所以存在这里
+     * 最后一次被手动切换到的账号,作为未选用账号的会话的兜底;所以存在这里
      * 而不是某个会话的文件里 —— 它是账号级的事实,不是某个会话的事实。
      */
     lastUid?: string;
@@ -80,7 +78,7 @@ export declare function updateStorage(change: (current: CodeBuddyStorage) => Cod
  * 插入一个账号,或替换同 uid 账号的凭据。
  *
  * 同 uid 视为重新登录同一个账号:令牌被替换而不是追加成第二个条目,否则
- * 设置页会出现两个同名徽章,退出其中一个还会留下另一个。
+ * 配置页会出现两个同名徽章,退出其中一个还会留下另一个。
  * @param entry - 刚登录得到的账号。
  */
 export declare function upsertAccount(entry: CodeBuddyStoredAccount): Promise<void>;
@@ -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,8 @@
 {
   "name": "dsh-llm-codebuddy-power",
-  "description": "Tencent CodeBuddy plugin for DeepSeek Harness (dsh).",
-  "version": "1.0.0",
+  "description": "A full-featured CodeBuddy (WorkBuddy) provider plugin.",
+  "version": "1.3.0",
+  "icon": "./icon.svg",
   "license": "MIT",
   "contributors": [
     "pgnqukezrdxmhjso"
@@ -19,7 +20,8 @@
     "dsh-plugin",
     "cordis",
     "llm",
-    "codebuddy"
+    "codebuddy",
+    "workbuddy"
   ],
   "type": "module",
   "main": "lib/index.js",
@@ -39,6 +41,7 @@
     "./package.json": "./package.json"
   },
   "files": [
+    "icon.svg",
     "cordis.patch.yml",
     "lib/index.js",
     "lib/client.js",
@@ -49,11 +52,11 @@
     "LICENSE"
   ],
   "peerDependencies": {
-    "@deepseek-ai/dsh-home-paths": "^0.1.5-rc.2",
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
-    "@deepseek-ai/schemastery": "^3.18.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"
   },
   "devDependencies": {
     "@types/node": "^22.15.0",
@@ -62,28 +65,30 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "typescript": "^6.0.3",
-    "@deepseek-ai/dsh-agent": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.2",
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-chat": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-store": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-attachment": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-model-selection": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-tool": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-home-paths": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-settings": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
-    "@deepseek-ai/schemastery": "^3.18.2"
+    "@deepseek-ai/dsh-client-locale": "^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-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-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-llm": "^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-tools": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-settings": "^0.1.7-rc.2",
+    "@deepseek-ai/schemastery": "^3.18.4"
   },
   "dependencies": {
     "eventsource-parser": "^3.1.0"
@@ -99,6 +104,7 @@
         "@deepseek-ai/dsh-client-connection",
         "@deepseek-ai/dsh-client-locale",
         "@deepseek-ai/dsh-client-ui-model-selection",
+        "@deepseek-ai/dsh-client-ui-plugin-manager",
         "@deepseek-ai/dsh-client-ui-settings",
         "@deepseek-ai/dsh-client-ui-renderer"
       ]
@@ -110,6 +116,7 @@
     "verify": "node ../dsh-pgnqukezrdxmhjso-base/verify.mjs",
     "pub": "pnpm run build && pnpm login --registry=https://registry.npmjs.org && pnpm publish --registry=https://registry.npmjs.org --no-git-checks",
     "pack": "pnpm run build && pnpm pack --pack-destination lib",
+    "link-test-i": "pnpm run build && (pnpm dsh plugin --profile pkgtest remove %npm_package_name% & pnpm dsh plugin --profile pkgtest add link:./)",
     "pack-test-i": "pnpm run pack && (pnpm dsh plugin --profile pkgtest remove %npm_package_name% & pnpm dsh plugin --profile pkgtest add ./lib/%npm_package_name%-%npm_package_version%.tgz)",
     "npm-test-i": "pnpm dsh plugin --profile pkgtest remove %npm_package_name% & pnpm dsh plugin --profile pkgtest add --registry=https://registry.npmjs.org %npm_package_name%@%npm_package_version%",
     "test-create": "pnpm dsh --profile pkgtest --from-default-profile web",

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

@@ -1,21 +0,0 @@
-/**
- * 渲染在侧边栏底部 Settings 触发项上方的用量指示器。
- *
- * 宽列在赠送剩余额度的纯文本行上方显示主池的进度条(可续期额度 —— 自定义配额
- * 上限与危险阈值仅作用于该进度条);赠送行的 tooltip 列出五个最早过期的有效赠送
- * 窗口及其剩余/总量数值。未登录的账号、计量服务故障或空池都不渲染任何内容 ——
- * 该提示纯属附加。窄栏列为主池保留单个圆环,其下是赠送剩余的裸数值。
- */
-import type { ReactElement } from 'react';
-import type { PropsLocale, PropsRuntime, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
-import { createCodeBuddyStore } from './store.ts';
-import type { CodeBuddySectionInjected } from './CodeBuddySection.tsx';
-/** 完整组件 props:footer-action 运行时份额 + store + locale + 注入 face。 */
-export type CodeBuddyUsageIndicatorProps = PropsRuntime<'sidebar.footer.action'> & PropsStore<ReturnType<typeof createCodeBuddyStore>> & PropsLocale<'settings.codebuddy'> & CodeBuddySectionInjected;
-/**
- * 两条用量进度条(宽列)或主池圆环(窄栏),仅在存在可用池时渲染。
- * @param props - 组合后的 slot props。
- * @returns 指示器元素;无内容显示时为 null。
- */
-export declare function UsageIndicator(props: CodeBuddyUsageIndicatorProps): ReactElement | null;
-//# sourceMappingURL=UsageIndicator.d.ts.map

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

@@ -1,19 +0,0 @@
-/**
- * 参数化的轮询钩子:入参说明「查什么数据」「多久查一次」「这里是否需要它」。
- *
- * 抽成共享钩子而不是各组件自建定时器,是为了让计时器的建立与清理只写一次;节奏仍由
- * 每个消费方按自己那份数据的更新速度给出 —— 两份数据的更新速度不同,不该被迫取同一个值。
- *
- * @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