@deepseek-harness-tui/dsh-tui 0.9.2 → 0.9.3

package/lib/types/components/Whale.d.ts

@@ -1,11 +1,21 @@
 import React from 'react';
 import { type WhaleFrame } from './whaleFrames.js';
 /**
- * Render a frame to 13 ANSI rows (one per sprite row pair). Consecutive
- * cells sharing one style are run-length encoded; trailing transparent
- * cells are dropped so the rows measure exactly the whale's bounding box.
+ * The DeepSeek pixel whale from the hand-drawn Excel art (whale_frames.zip):
+ * a 40×25 sprite in four true-color tones (deep-navy outline, DeepSeek-blue
+ * body, ice-blue belly, white mouth). Rendered with the half-block
+ * technique — each terminal cell packs two vertical pixels into one `▀`/`▄`
+ * glyph (foreground = upper pixel, background = lower), so the whale shows
+ * at 40 columns × 13 rows with visually square pixels.
  */
-export declare function renderWhaleRows(frame: WhaleFrame): string[];
+type Rgb = readonly [number, number, number];
+/**
+ * Render one frame to ANSI rows (one per sprite row pair) under its own
+ * palette. Consecutive cells sharing one style are run-length encoded;
+ * trailing transparent cells are dropped so the rows measure exactly the
+ * sprite's bounding box.
+ */
+export declare function renderSpriteRows(frame: WhaleFrame, palette: Record<string, Rgb | undefined>): string[];
 /** Index of the `standard` frame — the settled header's static pose. */
 export declare const STANDARD_FRAME_INDEX = 0;
 /**
@@ -19,4 +29,5 @@ export declare function WhaleArt({ frameIndex, width, }: {
     frameIndex?: number;
     width?: number;
 }): React.ReactNode;
+export {};
 //# sourceMappingURL=Whale.d.ts.map

package/lib/types/components/Whale.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Whale.d.ts","sourceRoot":"","sources":["../../../src/components/Whale.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAyBhE;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,CAwC3D;AAKD,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAErC;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,EACvB,UAAiC,EACjC,KAAK,GACN,EAAE;IACD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,GAAG,KAAK,CAAC,SAAS,CAWlB"}
+{"version":3,"file":"Whale.d.ts","sourceRoot":"","sources":["../../../src/components/Whale.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAEhE;;;;;;;GAOG;AAEH,KAAK,GAAG,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAc5C;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,SAAS,CAAC,GAAG,MAAM,EAAE,CAwCtG;AAMD,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAErC;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,EACvB,UAAiC,EACjC,KAAK,GACN,EAAE;IACD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,GAAG,KAAK,CAAC,SAAS,CAWlB"}

package/lib/types/components/Whale.js

@@ -12,11 +12,12 @@ const fg = (rgb) => `\x1b[38;2;${rgb[0]};${rgb[1]};${rgb[2]}m`;
 const bg = (rgb) => `\x1b[48;2;${rgb[0]};${rgb[1]};${rgb[2]}m`;
 const RESET = '\x1b[0m';
 /**
- * Render a frame to 13 ANSI rows (one per sprite row pair). Consecutive
- * cells sharing one style are run-length encoded; trailing transparent
- * cells are dropped so the rows measure exactly the whale's bounding box.
+ * Render one frame to ANSI rows (one per sprite row pair) under its own
+ * palette. Consecutive cells sharing one style are run-length encoded;
+ * trailing transparent cells are dropped so the rows measure exactly the
+ * sprite's bounding box.
  */
-export function renderWhaleRows(frame) {
+export function renderSpriteRows(frame, palette) {
     const sprite = frame.rows;
     const rows = [];
     for (let r = 0; r < sprite.length; r += 2) {
@@ -25,8 +26,8 @@ export function renderWhaleRows(frame) {
         let out = '';
         let current = '';
         for (let x = 0; x < upper.length; x++) {
-            const up = PALETTE[upper[x]];
-            const lo = PALETTE[lower[x]];
+            const up = palette[upper[x]];
+            const lo = palette[lower[x]];
             let seq;
             let ch;
             if (up !== undefined && lo !== undefined) {
@@ -61,8 +62,8 @@ export function renderWhaleRows(frame) {
     }
     return rows;
 }
-/** Pre-rendered ANSI rows for every frame, computed once at module load. */
-const RENDERED = WHALE_FRAMES.map(renderWhaleRows);
+/** Pre-rendered ANSI rows for every whale frame, computed once at module load. */
+const RENDERED = WHALE_FRAMES.map(frame => renderSpriteRows(frame, PALETTE));
 /** Index of the `standard` frame — the settled header's static pose. */
 export const STANDARD_FRAME_INDEX = 0;
 /**

package/lib/types/components/messages/AssistantToolUseMessage.d.ts

@@ -39,6 +39,12 @@ type Props = {
      * the row's own fold-toggle does not fire.
      */
     onOpenFile?: (path: string) => void;
+    /**
+     * Terminal-card header folding (settings `dsh-tui.foldTerminalCommand`):
+     * collapsed cards keep the command title's first source line plus a
+     * `+N lines` hint; verbose/expanded cards render the full title.
+     */
+    foldTerminalCommand?: boolean;
 };
 export declare function toolNameColor(raw: string): keyof Theme;
 /**
@@ -47,6 +53,6 @@ export declare function toolNameColor(raw: string): keyof Theme;
  * output, read content — instead of the raw result dump (mirroring Claude Code's `AssistantToolUseMessage.tsx` + the dsh-tools presentation views the
  * channel captures per call).
  */
-export declare function AssistantToolUseMessage({ tool, addMargin, verbose, isSelected, isExpanded, onClick, footnote, diffLayout, toolBackground, onOpenFile, }: Props): React.ReactNode;
+export declare function AssistantToolUseMessage({ tool, addMargin, verbose, isSelected, isExpanded, onClick, footnote, diffLayout, toolBackground, onOpenFile, foldTerminalCommand, }: Props): React.ReactNode;
 export {};
 //# sourceMappingURL=AssistantToolUseMessage.d.ts.map

package/lib/types/components/messages/AssistantToolUseMessage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantToolUseMessage.d.ts","sourceRoot":"","sources":["../../../../src/components/messages/AssistantToolUseMessage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,OAAO,KAAK,EAA8C,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAKvG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAEjE,KAAK,KAAK,GAAG;IACX,IAAI,EAAE,OAAO,CAAA;IACb,4DAA4D;IAC5D,SAAS,EAAE,OAAO,CAAA;IAClB,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAA;IAChB,wCAAwC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,sEAAsE;IACtE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;OAIG;IACH,OAAO,CAAC,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IACjC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;IACzC,2EAA2E;IAC3E,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CACpC,CAAA;AAsFD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,KAAK,CAKtD;AAsMD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,IAAI,EACJ,SAAS,EACT,OAAO,EACP,UAAkB,EAClB,UAAkB,EAClB,OAAO,EACP,QAAQ,EACR,UAAmB,EACnB,cAAuB,EACvB,UAAU,GACX,EAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CAkMzB"}
+{"version":3,"file":"AssistantToolUseMessage.d.ts","sourceRoot":"","sources":["../../../../src/components/messages/AssistantToolUseMessage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,OAAO,KAAK,EAA8C,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAKvG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAEjE,KAAK,KAAK,GAAG;IACX,IAAI,EAAE,OAAO,CAAA;IACb,4DAA4D;IAC5D,SAAS,EAAE,OAAO,CAAA;IAClB,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAA;IAChB,wCAAwC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,sEAAsE;IACtE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;OAIG;IACH,OAAO,CAAC,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IACjC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;IACzC,2EAA2E;IAC3E,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC9B,CAAA;AAsFD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,KAAK,CAKtD;AAuOD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,IAAI,EACJ,SAAS,EACT,OAAO,EACP,UAAkB,EAClB,UAAkB,EAClB,OAAO,EACP,QAAQ,EACR,UAAmB,EACnB,cAAuB,EACvB,UAAU,EACV,mBAA2B,GAC5B,EAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CA6MzB"}

package/lib/types/components/messages/AssistantToolUseMessage.js

@@ -200,12 +200,34 @@ function clipHeaderArgs(args) {
         return args;
     return `${args.slice(0, HEADER_ARGS_BUDGET)}…`;
 }
-function HeaderTitle({ name, title, isTerminal, displayArgs, argsLanguage, nameColor, filePath, onOpenFile }) {
+/** Fold a multi-line terminal command title to its first SOURCE line.
+ *  Counts '\n' separators in place instead of materializing a line array —
+ *  running cards re-render every second and a streamed command can reach
+ *  hundreds of KB, and the exact cost the HEADER_ARGS_BUDGET comment above
+ *  keeps out of the header must not sneak back in through folding. (Lone-\r
+ *  titles are not a thing presentCall produces; CRLF is normalized on the
+ *  first line only.) Single-line titles return undefined: nothing to fold,
+ *  rendering stays byte-identical to the unfolded card. */
+function foldTerminalTitle(title) {
+    const firstEnd = title.indexOf('\n');
+    if (firstEnd === -1)
+        return undefined;
+    let separators = 1;
+    for (let at = title.indexOf('\n', firstEnd + 1); at !== -1; at = title.indexOf('\n', at + 1))
+        separators++;
+    // Same trailing-newline rule as sideLines: a terminator is not a line.
+    const hidden = separators - (title.endsWith('\n') ? 1 : 0);
+    if (hidden <= 0)
+        return undefined;
+    const first = title.slice(0, title.charCodeAt(firstEnd - 1) === 13 ? firstEnd - 1 : firstEnd);
+    return { first, hidden };
+}
+function HeaderTitle({ name, title, isTerminal, folded, displayArgs, argsLanguage, nameColor, filePath, onOpenFile }) {
     if (title === undefined) {
         return (_jsxs(_Fragment, { children: [_jsx(Box, { flexShrink: 0, children: _jsx(Text, { bold: true, color: nameColor, wrap: "truncate-end", children: name }) }), displayArgs !== '' && (_jsxs(Box, { flexWrap: "nowrap", children: [_jsx(Text, { children: "(" }), _jsx(SyntaxText, { text: clipHeaderArgs(displayArgs), sourceText: displayArgs, language: argsLanguage }), _jsx(Text, { children: ")" })] }))] }));
     }
     if (isTerminal) {
-        return (_jsxs(_Fragment, { children: [_jsx(Box, { flexShrink: 0, children: _jsx(Text, { bold: true, color: nameColor, wrap: "truncate-end", children: name }) }), _jsx(Box, { flexWrap: "nowrap", children: _jsxs(Text, { children: ["(", title, ")"] }) })] }));
+        return (_jsxs(_Fragment, { children: [_jsx(Box, { flexShrink: 0, children: _jsx(Text, { bold: true, color: nameColor, wrap: "truncate-end", children: name }) }), _jsx(Box, { flexWrap: "nowrap", children: folded === undefined ? (_jsxs(Text, { children: ["(", title, ")"] })) : (_jsxs(_Fragment, { children: [_jsxs(Text, { children: ["(", folded.first, ")"] }), _jsx(Text, { dimColor: true, children: ` … +${folded.hidden} lines (ctrl+o to expand)` })] })) })] }));
     }
     const trimmed = title.trim();
     if (trimmed === '') {
@@ -236,7 +258,7 @@ function HeaderTitle({ name, title, isTerminal, displayArgs, argsLanguage, nameC
  * output, read content — instead of the raw result dump (mirroring Claude Code's `AssistantToolUseMessage.tsx` + the dsh-tools presentation views the
  * channel captures per call).
  */
-export function AssistantToolUseMessage({ tool, addMargin, verbose, isSelected = false, isExpanded = false, onClick, footnote, diffLayout = 'auto', toolBackground = 'none', onOpenFile, }) {
+export function AssistantToolUseMessage({ tool, addMargin, verbose, isSelected = false, isExpanded = false, onClick, footnote, diffLayout = 'auto', toolBackground = 'none', onOpenFile, foldTerminalCommand = false, }) {
     const isRunning = tool.status === 'running';
     const isError = tool.status === 'error';
     const displayArgs = verbose ? tool.argsFull ?? tool.argsText : tool.argsText;
@@ -254,6 +276,14 @@ export function AssistantToolUseMessage({ tool, addMargin, verbose, isSelected =
     // command) — then the call view's title stands.
     const headerTitle = tool.resultView?.title ?? tool.callView?.title;
     const headerIsTerminal = view?.card === 'terminal';
+    // Fold only the terminal header: multi-line command script, folding on,
+    // and the card not verbose/expanded (Ctrl+O and row click both land in
+    // `verbose`, so expansion reuses the existing state machine). Memoized on
+    // the title reference: settled titles never change, so the 1s
+    // useAnimationFrame tick of a running card re-renders without rescanning.
+    const foldedHeader = React.useMemo(() => headerIsTerminal && foldTerminalCommand && !verbose && headerTitle !== undefined
+        ? foldTerminalTitle(headerTitle)
+        : undefined, [headerIsTerminal, foldTerminalCommand, verbose, headerTitle]);
     // Live elapsed clock while the call runs (CC's bash elapsed timer): the
     // 1s tick re-renders the card; elapsed derives from wall-clock refs.
     const [viewportRef] = useAnimationFrame(isRunning ? 1000 : null);
@@ -314,7 +344,7 @@ export function AssistantToolUseMessage({ tool, addMargin, verbose, isSelected =
     return (_jsx(Box, { ref: viewportRef, flexDirection: "row", justifyContent: "space-between", marginTop: addMargin ? 1 : 0, width: "100%", onClick: onClick, 
         // Only selection paints a highlight; the configured treatment applies
         // to an ordinary card. Diff line tints stay - they are content, not chrome.
-        backgroundColor: isSelected ? 'messageActionsBackground' : hoverTint ? 'toolCardBackground' : ordinaryBackground, onMouseEnter: interactive ? () => setHovered(true) : undefined, onMouseLeave: interactive ? () => setHovered(false) : undefined, children: _jsxs(Box, { flexDirection: "column", flexGrow: 1, children: [_jsxs(Box, { flexDirection: "row", flexWrap: "nowrap", minWidth: minWidth, children: [_jsx(ToolUseLoader, { shouldAnimate: isRunning, isUnresolved: isRunning, isError: isError, toolName: tool.name }), _jsx(HeaderTitle, { name: name, title: headerTitle, isTerminal: headerIsTerminal, displayArgs: displayArgs, argsLanguage: argsLanguage, nameColor: toolNameColor(tool.name), filePath: filePath, onOpenFile: onOpenFile }), !isRunning && (_jsx(Box, { flexWrap: "nowrap", children: _jsx(Text, { dimColor: !hovered, children: elapsedText }) })), hovered && (_jsx(Box, { flexShrink: 0, children: _jsx(Text, { dimColor: true, children: isExpanded ? '▴' : '▾' }) }))] }), useSplitDiff && view?.card === 'diff' ? (_jsxs(Box, { flexDirection: "row", children: [_jsx(Box, { width: 3, flexShrink: 0, children: _jsx(Text, { dimColor: true, children: GUTTER_FIRST }) }), _jsx(SplitDiffView, { diffs: view.diffs, width: columns - 4, maxRows: DIFF_BODY_MAX_LINES, verbose: verbose, toolBackground: ordinaryToolBackground })] })) : (rendered.map((line, index) => (_jsxs(Box, { flexDirection: "row", children: [_jsx(Box, { width: 3, flexShrink: 0, children: _jsx(Text, { color: line.tone === 'add'
+        backgroundColor: isSelected ? 'messageActionsBackground' : hoverTint ? 'toolCardBackground' : ordinaryBackground, onMouseEnter: interactive ? () => setHovered(true) : undefined, onMouseLeave: interactive ? () => setHovered(false) : undefined, children: _jsxs(Box, { flexDirection: "column", flexGrow: 1, children: [_jsxs(Box, { flexDirection: "row", flexWrap: "nowrap", minWidth: minWidth, children: [_jsx(ToolUseLoader, { shouldAnimate: isRunning, isUnresolved: isRunning, isError: isError, toolName: tool.name }), _jsx(HeaderTitle, { name: name, title: headerTitle, isTerminal: headerIsTerminal, folded: foldedHeader, displayArgs: displayArgs, argsLanguage: argsLanguage, nameColor: toolNameColor(tool.name), filePath: filePath, onOpenFile: onOpenFile }), !isRunning && (_jsx(Box, { flexWrap: "nowrap", children: _jsx(Text, { dimColor: !hovered, children: elapsedText }) })), hovered && (_jsx(Box, { flexShrink: 0, children: _jsx(Text, { dimColor: true, children: isExpanded ? '▴' : '▾' }) }))] }), useSplitDiff && view?.card === 'diff' ? (_jsxs(Box, { flexDirection: "row", children: [_jsx(Box, { width: 3, flexShrink: 0, children: _jsx(Text, { dimColor: true, children: GUTTER_FIRST }) }), _jsx(SplitDiffView, { diffs: view.diffs, width: columns - 4, maxRows: DIFF_BODY_MAX_LINES, verbose: verbose, toolBackground: ordinaryToolBackground })] })) : (rendered.map((line, index) => (_jsxs(Box, { flexDirection: "row", children: [_jsx(Box, { width: 3, flexShrink: 0, children: _jsx(Text, { color: line.tone === 'add'
                                     ? 'diffAddedWord'
                                     : line.tone === 'del'
                                         ? 'diffRemovedWord'

package/lib/types/deepseekBalance.d.ts

@@ -0,0 +1,53 @@
+/**
+ * DeepSeek 官方账户余额查询（`GET /user/balance`）。
+ *
+ * 纯函数模块：只负责"用 key 换余额"，密钥由调用方（channel 的 credentials
+ * seam → 环境变量兜底）解析，绝不在此打印或持久化。查询接口本身是只读的，
+ * 不消耗 API 额度（社区插件均按秒/分钟级轮询使用）。
+ *
+ * 响应结构（官方文档）：
+ *   { "is_available": true, "balance_infos": [
+ *       { "currency": "CNY", "total_balance": "110.00",
+ *         "granted_balance": "10.00", "topped_up_balance": "100.00" } ] }
+ * 余额字段是字符串数字；`granted` 为赠送余额，`topped_up` 为充值余额，
+ * 扣费优先扣赠送余额。
+ */
+/** 单个币种的余额快照（元）。 */
+export interface BalanceInfo {
+    currency: string;
+    /** 总余额 = granted + toppedUp。 */
+    total: number;
+    /** 赠送余额。 */
+    granted: number;
+    /** 充值余额。 */
+    toppedUp: number;
+}
+export type BalanceResult = {
+    readonly ok: true;
+    /** 账户是否可用（是否有可用额度）。 */
+    readonly isAvailable: boolean;
+    readonly balances: readonly BalanceInfo[];
+} | {
+    readonly ok: false;
+    /** 失败分类：无 key / 网络或超时 / 认证失败 / 非 2xx / 响应结构非法。 */
+    readonly reason: 'no-key' | 'network' | 'unauthorized' | 'http' | 'invalid';
+    /** 非 2xx 时的 HTTP 状态码（其余分类无）。 */
+    readonly status?: number;
+};
+/** 查询选项；fetchImpl 供无头回归注入。 */
+export interface BalanceQueryOptions {
+    /** 覆盖全局 fetch（测试注入）。 */
+    fetchImpl?: typeof fetch;
+    /** 覆盖 API 根地址（测试或镜像）。 */
+    baseUrl?: string;
+    /** 超时毫秒数，默认 8000。 */
+    timeoutMs?: number;
+}
+export declare const DEEPSEEK_BALANCE_ENDPOINT = "https://api.deepseek.com/user/balance";
+/**
+ * 查询 DeepSeek 官方账户余额。
+ * @param apiKey - `DEEPSEEK_API_KEY` 值；空字符串返回 no-key。
+ * @param options - 查询选项。
+ */
+export declare function fetchBalance(apiKey: string, options?: BalanceQueryOptions): Promise<BalanceResult>;
+//# sourceMappingURL=deepseekBalance.d.ts.map

package/lib/types/deepseekBalance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepseekBalance.d.ts","sourceRoot":"","sources":["../../src/deepseekBalance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,oBAAoB;AACpB,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,YAAY;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,YAAY;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,MAAM,aAAa,GACrB;IACA,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;IACjB,uBAAuB;IACvB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAA;CAC1C,GACC;IACA,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAA;IAClB,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,cAAc,GAAG,MAAM,GAAG,SAAS,CAAA;IAC3E,gCAAgC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAEH,8BAA8B;AAC9B,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;IACxB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,eAAO,MAAM,yBAAyB,0CAA0C,CAAA;AAIhF;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,aAAa,CAAC,CA4BxB"}

package/lib/types/deepseekBalance.js

@@ -0,0 +1,86 @@
+/**
+ * DeepSeek 官方账户余额查询（`GET /user/balance`）。
+ *
+ * 纯函数模块：只负责"用 key 换余额"，密钥由调用方（channel 的 credentials
+ * seam → 环境变量兜底）解析，绝不在此打印或持久化。查询接口本身是只读的，
+ * 不消耗 API 额度（社区插件均按秒/分钟级轮询使用）。
+ *
+ * 响应结构（官方文档）：
+ *   { "is_available": true, "balance_infos": [
+ *       { "currency": "CNY", "total_balance": "110.00",
+ *         "granted_balance": "10.00", "topped_up_balance": "100.00" } ] }
+ * 余额字段是字符串数字；`granted` 为赠送余额，`topped_up` 为充值余额，
+ * 扣费优先扣赠送余额。
+ */
+export const DEEPSEEK_BALANCE_ENDPOINT = 'https://api.deepseek.com/user/balance';
+const DEFAULT_TIMEOUT_MS = 8000;
+/**
+ * 查询 DeepSeek 官方账户余额。
+ * @param apiKey - `DEEPSEEK_API_KEY` 值；空字符串返回 no-key。
+ * @param options - 查询选项。
+ */
+export async function fetchBalance(apiKey, options = {}) {
+    if (apiKey === '')
+        return { ok: false, reason: 'no-key' };
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const endpoint = options.baseUrl === undefined
+        ? DEEPSEEK_BALANCE_ENDPOINT
+        : `${options.baseUrl.replace(/\/+$/, '')}/user/balance`;
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetchImpl(endpoint, {
+            headers: { authorization: `Bearer ${apiKey}` },
+            signal: controller.signal,
+        });
+        if (response.status === 401 || response.status === 403) {
+            return { ok: false, reason: 'unauthorized', status: response.status };
+        }
+        if (!response.ok) {
+            return { ok: false, reason: 'http', status: response.status };
+        }
+        const payload = await response.json().catch(() => undefined);
+        const parsed = parseBalancePayload(payload);
+        return parsed ?? { ok: false, reason: 'invalid' };
+    }
+    catch {
+        return { ok: false, reason: 'network' };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function parseBalancePayload(payload) {
+    if (payload === null || typeof payload !== 'object' || Array.isArray(payload))
+        return undefined;
+    const record = payload;
+    const infos = record.balance_infos;
+    if (!Array.isArray(infos))
+        return undefined;
+    const balances = [];
+    for (const raw of infos) {
+        if (raw === null || typeof raw !== 'object' || Array.isArray(raw))
+            return undefined;
+        const info = raw;
+        const currency = info.currency;
+        const total = parseCny(info.total_balance);
+        const granted = parseCny(info.granted_balance);
+        const toppedUp = parseCny(info.topped_up_balance);
+        if (typeof currency !== 'string' || currency === '' || total === undefined || granted === undefined || toppedUp === undefined) {
+            return undefined;
+        }
+        balances.push({ currency, total, granted, toppedUp });
+    }
+    return {
+        ok: true,
+        isAvailable: record.is_available === true,
+        balances,
+    };
+}
+function parseCny(value) {
+    if (typeof value !== 'string' && typeof value !== 'number')
+        return undefined;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}

package/lib/types/deepseekPricing.d.ts

@@ -0,0 +1,82 @@
+/**
+ * DeepSeek 官方定价与"本会话花费"估算（人民币口径）。
+ *
+ * 数据来源：DeepSeek 官方文档「模型 & 价格」页（2026-08 快照），单位为人民
+ * 币/百万 tokens。DeepSeek 官方 API 只返回 token 用量、不返回金额，本模块按
+ * 官方公开单价把会话累计 token 换算成金额 —— 这是**估算**，不是账单：
+ * 定价可能变动，且余额扣费发生在 DeepSeek 侧（以平台账单为准）。
+ *
+ * 计价规则（来自官方页面）：
+ *  - 扣减费用 = token 消耗量 × 模型单价；
+ *  - 缓存命中的输入按命中价计费，其余输入（含写入缓存）按未命中价计费；
+ *  - 高峰时段为北京时间周一至周五 9:00-12:00、14:00-18:00，其余为空闲时段
+ *    （空闲价为高峰价的一半）。
+ */
+/** 单价对：`[空闲价, 高峰价]`，单位 元/百万 tokens。 */
+export type CnyPerMillion = readonly [number, number];
+/** 一个官方模型的完整价目（人民币/百万 tokens）。 */
+export interface DeepSeekModelPrice {
+    /** 输入（缓存未命中，含写入缓存部分）。 */
+    inputMiss: CnyPerMillion;
+    /** 输入（缓存命中）。 */
+    inputHit: CnyPerMillion;
+    /** 输出。 */
+    output: CnyPerMillion;
+}
+/**
+ * 在售模型价目表，按 API model id 前缀匹配（最长前缀优先）。
+ * 新模型上线而本表未收录时，估算返回 undefined，界面不显示金额（只显示
+ * token 用量），不会给出错误数字。
+ */
+export declare const DEEPSEEK_MODEL_PRICES: Readonly<Record<string, DeepSeekModelPrice>>;
+/**
+ * DeepSeek 官方 API key 路由（余额/花费估算只对它们有意义）。参考社区
+ * dsh-balance 的 provider 判定：DSH 自带官方路由 `deepseek-official`
+ * （modelRoute.ts 默认路由），另兼容裸 `deepseek` 与 dsh-vision-router
+ * 的 `deepseek-vision` 包装路由。
+ */
+export declare const DEEPSEEK_OFFICIAL_PROVIDERS: readonly string[];
+/** 是否 DeepSeek 官方 provider（余额与定价只适用于官方计费口径）。 */
+export declare function isDeepSeekOfficialProvider(provider: string): boolean;
+/**
+ * 是否处于高峰计费时段：北京时间周一至周五 9:00-12:00、14:00-18:00。
+ * 北京时间为 UTC+8 固定偏移（无夏令时），用 UTC 时刻加偏移换算。
+ */
+export declare function isPeakHour(date?: Date): boolean;
+/** 按前缀匹配模型价目，最长前缀优先；未收录返回 undefined。 */
+export declare function priceForModel(model: string): DeepSeekModelPrice | undefined;
+/** 会话累计 token（与 Channel.tokens 同构，含缓存分项）。 */
+export interface CostTokenTotals {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+}
+/**
+ * 按计价时段分桶的会话 token：每笔 usage 按其发生时刻（event.time）落入
+ * 高峰或空闲桶，估算时各按对应单价——跨时段会话不会整段按当前时段计价。
+ */
+export interface CostTokenBuckets {
+    peak: CostTokenTotals;
+    idle: CostTokenTotals;
+}
+/**
+ * 估算本会话花费拆分（人民币，元）：高峰桶按高峰价、空闲桶按空闲价。
+ * 公式（每桶）：(input − cacheRead) × 输入未命中价 + cacheRead × 输入命中价
+ * + output × 输出价；cacheWrite 不单独计价（写入缓存的 token 已计入 input
+ * 的未命中部分）。模型未收录或所有 token 均为零时返回 undefined（调用方
+ * 不显示金额）。这是**估算**，不是账单——定价可能变动，以 DeepSeek 平台
+ * 账单为准。
+ * @param tokens - 按计价时段分桶的会话累计 token。
+ * @param model - 当前模型 id（前缀匹配价目）。
+ */
+export declare function estimateSessionCostSplitCny(tokens: CostTokenBuckets, model: string): {
+    total: number;
+    peak: number;
+    idle: number;
+} | undefined;
+/**
+ * 估算本会话花费（人民币，元）——estimateSessionCostSplitCny 的总价捷径。
+ */
+export declare function estimateSessionCostCny(tokens: CostTokenBuckets, model: string): number | undefined;
+//# sourceMappingURL=deepseekPricing.d.ts.map

package/lib/types/deepseekPricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepseekPricing.d.ts","sourceRoot":"","sources":["../../src/deepseekPricing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,uCAAuC;AACvC,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAErD,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC,yBAAyB;IACzB,SAAS,EAAE,aAAa,CAAA;IACxB,gBAAgB;IAChB,QAAQ,EAAE,aAAa,CAAA;IACvB,UAAU;IACV,MAAM,EAAE,aAAa,CAAA;CACtB;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAgB9E,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,EAAE,SAAS,MAAM,EAIxD,CAAA;AAED,gDAAgD;AAChD,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,IAAiB,GAAG,OAAO,CAM3D;AAED,wCAAwC;AACxC,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAU3E;AAED,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,eAAe,CAAA;IACrB,IAAI,EAAE,eAAe,CAAA;CACtB;AAiCD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,MAAM,GACZ;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAc3D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,SAAS,CAEpB"}

package/lib/types/deepseekPricing.js

@@ -0,0 +1,133 @@
+/**
+ * DeepSeek 官方定价与"本会话花费"估算（人民币口径）。
+ *
+ * 数据来源：DeepSeek 官方文档「模型 & 价格」页（2026-08 快照），单位为人民
+ * 币/百万 tokens。DeepSeek 官方 API 只返回 token 用量、不返回金额，本模块按
+ * 官方公开单价把会话累计 token 换算成金额 —— 这是**估算**，不是账单：
+ * 定价可能变动，且余额扣费发生在 DeepSeek 侧（以平台账单为准）。
+ *
+ * 计价规则（来自官方页面）：
+ *  - 扣减费用 = token 消耗量 × 模型单价；
+ *  - 缓存命中的输入按命中价计费，其余输入（含写入缓存）按未命中价计费；
+ *  - 高峰时段为北京时间周一至周五 9:00-12:00、14:00-18:00，其余为空闲时段
+ *    （空闲价为高峰价的一半）。
+ */
+/**
+ * 在售模型价目表，按 API model id 前缀匹配（最长前缀优先）。
+ * 新模型上线而本表未收录时，估算返回 undefined，界面不显示金额（只显示
+ * token 用量），不会给出错误数字。
+ */
+export const DEEPSEEK_MODEL_PRICES = {
+    'deepseek-v4-flash': {
+        inputMiss: [1.5, 3.0],
+        inputHit: [0.05, 0.10],
+        output: [4.5, 9.0],
+    },
+    'deepseek-v4-pro': {
+        inputMiss: [4.5, 9.0],
+        inputHit: [0.15, 0.30],
+        output: [13.5, 27.0],
+    },
+    'deepseek-v4-flash-vision-exp': {
+        inputMiss: [1.5, 3.0],
+        inputHit: [0.05, 0.10],
+        output: [4.5, 9.0],
+    },
+};
+/**
+ * DeepSeek 官方 API key 路由（余额/花费估算只对它们有意义）。参考社区
+ * dsh-balance 的 provider 判定：DSH 自带官方路由 `deepseek-official`
+ * （modelRoute.ts 默认路由），另兼容裸 `deepseek` 与 dsh-vision-router
+ * 的 `deepseek-vision` 包装路由。
+ */
+export const DEEPSEEK_OFFICIAL_PROVIDERS = [
+    'deepseek',
+    'deepseek-official',
+    'deepseek-vision',
+];
+/** 是否 DeepSeek 官方 provider（余额与定价只适用于官方计费口径）。 */
+export function isDeepSeekOfficialProvider(provider) {
+    return DEEPSEEK_OFFICIAL_PROVIDERS.includes(provider);
+}
+/**
+ * 是否处于高峰计费时段：北京时间周一至周五 9:00-12:00、14:00-18:00。
+ * 北京时间为 UTC+8 固定偏移（无夏令时），用 UTC 时刻加偏移换算。
+ */
+export function isPeakHour(date = new Date()) {
+    const shifted = new Date(date.getTime() + 8 * 3_600_000);
+    const weekday = shifted.getUTCDay(); // 0 = Sunday
+    const hour = shifted.getUTCHours();
+    if (weekday === 0 || weekday === 6)
+        return false;
+    return (hour >= 9 && hour < 12) || (hour >= 14 && hour < 18);
+}
+/** 按前缀匹配模型价目，最长前缀优先；未收录返回 undefined。 */
+export function priceForModel(model) {
+    let best;
+    let bestLength = 0;
+    for (const [prefix, price] of Object.entries(DEEPSEEK_MODEL_PRICES)) {
+        if (model.startsWith(prefix) && prefix.length > bestLength) {
+            best = price;
+            bestLength = prefix.length;
+        }
+    }
+    return best;
+}
+/** 空桶（防御 tokens.peak/idle 缺失的旧数据/测试桩）。 */
+const EMPTY_TOTALS = Object.freeze({
+    input: 0,
+    output: 0,
+    cacheRead: 0,
+    cacheWrite: 0,
+});
+/** 按高峰/空闲单价分别计价，返回 [高峰元, 空闲元]（未除 1e6）。 */
+function costSplit(tokens, price) {
+    // 分桶字段在真实 Channel 上恒有（emptyTokenUsage 初始化），但旧快照与
+    // 测试桩可能缺桶——缺失时按空桶计，绝不抛错。
+    const peak = tokens.peak ?? EMPTY_TOTALS;
+    const idle = tokens.idle ?? EMPTY_TOTALS;
+    const costOf = (bucket, rateIndex) => {
+        const input = Math.max(0, bucket.input);
+        const output = Math.max(0, bucket.output);
+        const cacheRead = Math.max(0, Math.min(input, bucket.cacheRead));
+        return (input - cacheRead) * price.inputMiss[rateIndex]
+            + cacheRead * price.inputHit[rateIndex]
+            + output * price.output[rateIndex];
+    };
+    return {
+        peak: costOf(peak, 1),
+        idle: costOf(idle, 0),
+    };
+}
+/**
+ * 估算本会话花费拆分（人民币，元）：高峰桶按高峰价、空闲桶按空闲价。
+ * 公式（每桶）：(input − cacheRead) × 输入未命中价 + cacheRead × 输入命中价
+ * + output × 输出价；cacheWrite 不单独计价（写入缓存的 token 已计入 input
+ * 的未命中部分）。模型未收录或所有 token 均为零时返回 undefined（调用方
+ * 不显示金额）。这是**估算**，不是账单——定价可能变动，以 DeepSeek 平台
+ * 账单为准。
+ * @param tokens - 按计价时段分桶的会话累计 token。
+ * @param model - 当前模型 id（前缀匹配价目）。
+ */
+export function estimateSessionCostSplitCny(tokens, model) {
+    const price = priceForModel(model);
+    if (price === undefined)
+        return undefined;
+    const split = costSplit(tokens, price);
+    const peak = tokens.peak ?? EMPTY_TOTALS;
+    const idle = tokens.idle ?? EMPTY_TOTALS;
+    const totalTokens = peak.input + peak.output + idle.input + idle.output;
+    if (totalTokens <= 0)
+        return undefined;
+    return {
+        total: split.peak / 1_000_000 + split.idle / 1_000_000,
+        peak: split.peak / 1_000_000,
+        idle: split.idle / 1_000_000,
+    };
+}
+/**
+ * 估算本会话花费（人民币，元）——estimateSessionCostSplitCny 的总价捷径。
+ */
+export function estimateSessionCostCny(tokens, model) {
+    return estimateSessionCostSplitCny(tokens, model)?.total;
+}