@xrkseek/harness-cli 0.0.11 → 0.1.0

package/node_modules/@xrkseek/server-face/dist/cost-meter-coding-plans.d.ts

@@ -0,0 +1,284 @@
+/**
+ * Coding Plan 额度查询 adapter 框架(多厂商)。
+ *
+ * 每家厂商一个 adapter:固定官方端点白名单 + Key 发现线索(env/CLI 文件)+
+ * 响应解析器。解析器为纯函数(可单测);网络与凭据解析在宿主侧(index.js)。
+ *
+ * 归一化输出:windows = { [name]: { percent: 0-100, resetsAt: ISO 字符串 } }。
+ * 凭证安全:每个 adapter 的 URL 均为硬编码官方域名,Key 永不发往其它域。
+ *
+ * 实测确认(2026-08):
+ *  - Anthropic OAuth usage 端点存活(未授权返回限流/401);
+ *  - Z.ai / 智谱 Coding Plan usage 端点存活(401「token expired or incorrect」);
+ *  - MiniMax Token Plan remains 端点存活(1004 需 Authorization);
+ *  - Kimi PAYG 余额端点 api.moonshot.cn/v1/users/me/balance 存活(401 incorrect_api_key,官方文档明确);
+ *    Kimi Code 订阅周窗/5小时窗暂无 API-Key 化公开端点(仅 kimi.com 控制台),以余额窗口接入;
+ *  - OpenRouter credits 端点 openrouter.ai/api/v1/credits 存活(401,官方文档明确);
+ *  - SiliconFlow 用户信息端点 api.siliconflow.cn/v1/user/info 存活(30014 Token is invalid);
+ *  - CommandCode(commandcode.ai)billing credits 端点存活(401 unauthorized;issue #30):
+ *    GET api.commandcode.ai/alpha/billing/credits,窗口(fiveHour/weekly)+ 月度 Credits 余额;
+ *  - SCNet(超算互联网)Token Plan 仅有 sk-tp- 专属推理端点(api.scnet.cn),额度用量只在控制台
+ *    「模型服务 → Token Plan → 我的订阅/Token 用量」可见,无 API-Key 化查询端点——以本地
+ *    Credits 计量接入(官方抵扣表折算,见 SCNET_CREDIT_RATES;issue #26);
+ *  - 百炼 Coding Plan / OpenAI Codex / Gemini Code Assist / GitHub Copilot 个人版暂无 API-Key 化公开用量端点(仅控制台/组织级 API),不接入。
+ */
+export declare const CODING_PLAN_PROVIDERS: {
+    anthropic: {
+        label: string;
+        credentialEnvs: string[];
+        keyHint: string;
+    };
+    zai: {
+        label: string;
+        credentialEnvs: string[];
+        keyHint: string;
+    };
+    minimax: {
+        label: string;
+        credentialEnvs: string[];
+        keyHint: string;
+    };
+    kimi: {
+        label: string;
+        credentialEnvs: string[];
+        keyHint: string;
+    };
+    openrouter: {
+        label: string;
+        credentialEnvs: string[];
+        keyHint: string;
+    };
+    siliconflow: {
+        label: string;
+        credentialEnvs: string[];
+        keyHint: string;
+    };
+    commandcode: {
+        label: string;
+        credentialEnvs: string[];
+        keyHint: string;
+    };
+    scnet: {
+        label: string;
+        credentialEnvs: never[];
+        keyHint: string;
+    };
+};
+export declare const CODING_PLAN_PROVIDER_IDS: string[];
+/** 归一化百分比:0-1 视为小数,>=1 视为已是百分数;非法 → null。 */
+export declare function normalizePercent(value: any): number | null;
+/** 归一化重置时刻:unix 秒 / unix 毫秒 / ISO 字符串 → ISO 字符串;非法 → ''。 */
+export declare function normalizeResetAt(value: any): string;
+/**
+ * 解析 Anthropic OAuth 用量响应(GET https://api.anthropic.com/api/oauth/usage)。
+ * 形如 { five_hour: { utilization, resets_at }, seven_day: {...}, seven_day_sonnet: {...}, extra_usage: {...} }。
+ * utilization 为 0-100 百分数,resets_at 为 unix 秒。
+ */
+export declare function parseAnthropicUsage(data: any): {} | null;
+/**
+ * 解析 Z.ai / 智谱 GLM Coding Plan 用量响应。
+ * 兼容三种已见形态(按优先级):
+ *  - { data: { limits: [{ type, unit, number, percentage, nextResetTime, usage,
+ *      currentValue, ... }], level } }(2026-08 起的监控端点
+ *      /api/monitor/usage/quota/limit,issue #42;TOKENS_LIMIT 为 token 窗口(Pro/Max),
+ *      CREDIT_LIMIT 为 Credit 计费窗口(Lite,percentage/currentValue 语义与
+ *      TOKENS_LIMIT 一致,issue #44),两者均按 unit 3=小时档、6=周档映射;
+ *      TIME_LIMIT 为 MCP/工具调用月度额度、量纲不同不纳入;unit 缺失时按
+ *      nextResetTime 排序兜底——0% 用量的滚动窗口不返回重置时间,排最前)
+ *  - { plans: [{ status, total_units, used_units, available_units, period_end, capabilities }] }
+ *    (旧计费端点;period_end 语义按数值大小推断:重置跨度 >1 天视为周档,否则为 5 小时档)
+ *  - { five_hour: { utilization|percent, resets_at }, weekly|week|seven_day: {...} }
+ */
+export declare function parseZaiUsage(data: any): {} | null;
+/**
+ * 解析 MiniMax 用量响应。兼容四种官方形态:
+ *  - Token Plan(2026-08 现行,model_remains):GET https://www.minimaxi.com|io/v1/token_plan/remains
+ *    { model_remains: [{ model_name, current_interval_remaining_percent, current_weekly_remaining_percent, ... }] }
+ *    total_count 常为 0,以 remaining_percent 为准;取 general(或 MiniMax-M*)一行抽出 5h/7d,不按模型拆条;
+ *  - Token Plan 平铺结构(issue #20):根节点(或 data.data)直含 current_interval_* 与 current_weekly_*;
+ *  - Token Plan 旧数组形态:窗口数组字段,条目含 total/used/remain 与 interval 标签;
+ *  - Coding Plan 旧计数制:model_remains 仅有 total/used、无 remaining_percent 时汇总。
+ */
+export declare function parseMiniMaxRemains(data: any): {} | null;
+/**
+ * 解析 Kimi / Moonshot 余额响应(GET https://api.moonshot.cn/v1/users/me/balance)。
+ * 官方返回形如 { available_balance: <分> }(人民币分),兼容 cached/total 变体与元单位形态。
+ * 输出文本窗口(余额无总量,不适合百分比进度条)。
+ */
+export declare function parseKimiBalance(data: any): {
+    balance: {
+        resetsAt: string;
+        text: string;
+    };
+} | null;
+/**
+ * 解析 OpenRouter 额度响应(GET https://openrouter.ai/api/v1/credits)。
+ * 官方返回 { data: { total_credits, total_usage } }(美元);输出已用% 窗口。
+ */
+export declare function parseOpenRouterCredits(data: any): {
+    credits: {
+        percent: number;
+        resetsAt: string;
+    };
+} | null;
+/**
+ * 解析 SiliconFlow 用户信息响应(GET https://api.siliconflow.cn/v1/user/info)。
+ * 余额字段容错(balance/amount/remain),输出文本窗口(人民币)。
+ */
+export declare function parseSiliconFlowInfo(data: any): {
+    balance: {
+        resetsAt: string;
+        text: string;
+    };
+} | null;
+/**
+ * 解析 CommandCode(commandcode.ai)额度响应(issue #30,
+ * GET https://api.commandcode.ai/alpha/billing/credits)。
+ * 官方返回 { credits: { monthlyCredits, ... }, windowLimits: { fiveHour: { used, cap, resetAt },
+ * weekly: {...} } }:窗口按 used/cap 输出已用%(resetAt 为 epoch 毫秒);月度 Credits 为
+ * 余额池(1 credit ≈ $1 用量,无总量字段),以文本窗口展示(与 Kimi/SiliconFlow 余额同形态)。
+ */
+export declare function parseCommandCodeCredits(data: any): {} | null;
+/**
+ * 官方 Credits 抵扣表(2026-08-11 起生效;来源:
+ * https://ax.ac.sugon.com/ac/openapi/doc/2.0/moduleapi/plans/token-plan.html)。
+ * 单位:Credits / 百万 tokens;input=未命中缓存输入,cachedInput=命中缓存输入,output=输出。
+ */
+export declare const SCNET_CREDIT_RATES: {
+    'GLM-5.2': {
+        input: number;
+        cachedInput: number;
+        output: number;
+    };
+    'GLM-5.1': {
+        input: number;
+        cachedInput: number;
+        output: number;
+    };
+    'GLM-5': {
+        input: number;
+        cachedInput: number;
+        output: number;
+    };
+    'DeepSeek-V4-Pro': {
+        input: number;
+        cachedInput: number;
+        output: number;
+    };
+    'DeepSeek-V4-Flash': {
+        input: number;
+        cachedInput: number;
+        output: number;
+    };
+    'DeepSeek-V4-Flash-0731': {
+        input: number;
+        cachedInput: number;
+        output: number;
+    };
+    'Kimi-K3': {
+        input: number;
+        cachedInput: number;
+        output: number;
+    };
+    'Kimi-K2.7-Code': {
+        input: number;
+        cachedInput: number;
+        output: number;
+    };
+    'Kimi-K2.6': {
+        input: number;
+        cachedInput: number;
+        output: number;
+    };
+    'Kimi-K2.5': {
+        input: number;
+        cachedInput: number;
+        output: number;
+    };
+    'MiniMax-M3': {
+        input: number;
+        cachedInput: number;
+        output: number;
+    };
+    'MiniMax-M2.7': {
+        input: number;
+        cachedInput: number;
+        output: number;
+    };
+    'MiniMax-M2.5': {
+        input: number;
+        cachedInput: number;
+        output: number;
+    };
+    'Qwen3.8-max': {
+        input: number;
+        cachedInput: number;
+        output: number;
+    };
+};
+/** 套餐档位预设(月度 Credits 额度)。 */
+export declare const SCNET_TOKEN_PLANS: {
+    id: string;
+    credits: number;
+}[];
+/** SCNet 模型名归一:小写并剔除非字母数字(GLM-5.2 → glm52;大小写/连接符差异等价)。 */
+export declare function scnetCanonModelId(modelId: any): string;
+/** 按抵扣表折算一组 token 桶的 Credits(cacheWrite 计入未命中输入;reasoning 已含于 output 不重复计)。 */
+export declare function scnetModelCredits(tokens: any, rate: any): number;
+/**
+ * 计算当前计费周期(本地时区):套餐自 planStart(YYYY-MM-DD)起算、每月重置,有效期至
+ * 次月对应日 23:59:59;planStart 缺省时按自然月。返回 { fromKey, toKeyInclusive, resetsAt }。
+ */
+export declare function scnetPlanPeriod(nowMs: any, planStart: any): {
+    fromKey: string;
+    toKeyInclusive: string;
+    resetsAt: string;
+};
+/**
+ * 汇总本地账本当前计费周期的 SCNet Credits 用量(按模型名匹配抵扣表;跨 provider 归并,
+ * 未匹配模型不计)。entry 为 codingPlans.scnet 配置(planCredits 必填、planStart 可选)。
+ * 返回 null(planCredits 非法)或 { used, total, percent, resetsAt, byModel, windows }。
+ */
+export declare function scnetTokenPlanWindows(days: any, entry: any, nowMs: any): {
+    used: number;
+    total: number;
+    percent: number;
+    resetsAt: string;
+    byModel: {};
+    windows: {
+        monthly: {
+            percent: number;
+            resetsAt: string;
+        };
+        credits: {
+            resetsAt: string;
+            text: string;
+        };
+    };
+} | null;
+/** 各家固定官方端点(硬编码白名单;region 变体按序尝试)。 */
+export declare const CODING_PLAN_ENDPOINTS: {
+    anthropic: string[];
+    zai: string[];
+    minimax: string[];
+    kimi: string[];
+    openrouter: string[];
+    siliconflow: string[];
+    commandcode: string[];
+    scnet: never[];
+};
+/**
+ * 查询单家 coding plan 额度。按 CODING_PLAN_ENDPOINTS 顺序尝试官方端点:
+ * 认证失败(401/403)与解析成功立即返回;其余错误尝试下一个端点。
+ * 预期场景(未找到 Key / 无订阅)抛出 error.soft = true 的软错误。
+ * @param provider - anthropic | zai | minimax | kimi | openrouter | siliconflow。
+ * @param key - 已解析出的 API Key / OAuth token;null 表示未找到。
+ * @param locale - 消息语言(zh/en)。
+ * @param t - 服务端文案函数 tmsg(locale, code, vars)。
+ * @returns {Promise<{ windows: object, endpoint: string }>}
+ */
+export declare function queryCodingPlan(provider: any, key: any, locale: any, t: any): Promise<{
+    windows: any;
+    endpoint: any;
+}>;
+//# sourceMappingURL=cost-meter-coding-plans.d.ts.map

package/node_modules/@xrkseek/server-face/dist/cost-meter-coding-plans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-meter-coding-plans.d.ts","sourceRoot":"","sources":["../src/cost-meter-coding-plans.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2CjC,CAAA;AAED,eAAO,MAAM,wBAAwB,UAAqC,CAAA;AAE1E,6CAA6C;AAC7C,wBAAgB,gBAAgB,CAAC,KAAK,KAAA,iBAKrC;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,KAAK,KAAA,UAWrC;AAeD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,KAAA,aASvC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,IAAI,KAAA,aAsEjC;AA4ED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,KAAA,aA+DvC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,KAAA;;;;;SAUpC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,KAAA;;;;;SAQ1C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,KAAA;;;;;SAQxC;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,KAAA,aAoB3C;AASD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAe9B,CAAA;AAED,6BAA6B;AAC7B,eAAO,MAAM,iBAAiB;;;GAI7B,CAAA;AAED,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,OAAO,KAAA,UAExC;AAMD,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,MAAM,KAAA,EAAE,IAAI,KAAA,UAO7C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,KAAA,EAAE,SAAS,KAAA;;;;EA0B/C;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,KAAA,EAAE,KAAK,KAAA,EAAE,KAAK,KAAA;;;;;;;;;;;;;;;;SA+BvD;AAED,sCAAsC;AACtC,eAAO,MAAM,qBAAqB;;;;;;;;;CAwBjC,CAAA;AAYD;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,QAAQ,KAAA,EAAE,GAAG,KAAA,EAAE,MAAM,KAAA,EAAE,CAAC,KAAA;;;GAgE7D"}