dsh-kenari-plugin 0.1.1

package/lib/catalog-view.js

@@ -0,0 +1,113 @@
+/**
+ * 浏览器侧模型浏览器的数据端点：`GET /api/kenari.models`。
+ *
+ * 为什么需要它：浏览器只装得下已经存在的 Remote 命名空间，而 dsh 没有任何一个
+ * 能承载"每模型能力标签 + 套餐归属"的命名空间（新增一个要动 dsh 的 api-remotes 装配）。
+ * 但 dsh 的 Connection 服务给了插件一个**同源 Fetch 路由**注册点，
+ * 于是浏览器可以直接读本端点的 JSON——数据仍全部在 Host 侧算，浏览器不解析 Kenari。
+ *
+ * 鉴权由 dsh 的 Connection 层负责（Host/Origin 围栏 + 浏览器会话），
+ * 所以这里假定"能到达本处理器就是可信的同源页面"。
+ * @module dsh-kenari-plugin/catalog-view
+ */
+import { CAPABILITY_TAGS, capabilityTagsOf, displayNameOf, isChatCapable, isFreeModel, toModelProfile, } from './catalog.js';
+import { coverageOf } from './plans.js';
+/** 浏览器读取模型视图的路径（Connection 的 Fetch 路由要求落在 `/api/` 下）。 */
+export const KENARI_MODEL_VIEW_PATH = '/api/kenari.models';
+/** 目录行 → 浏览器视图行。 */
+function toView(model, coverage) {
+    const covered = coverageOf(coverage, model.id);
+    return {
+        id: model.id,
+        name: displayNameOf(model),
+        ...(model.owned_by === undefined ? {} : { ownedBy: model.owned_by }),
+        ...(typeof model.context_length === 'number' ? { contextWindow: model.context_length } : {}),
+        free: isFreeModel(model),
+        beta: model.beta === true,
+        ...(typeof model.sunset_at === 'number' && model.sunset_at > 0 ? { sunsetAt: model.sunset_at } : {}),
+        chatCapable: isChatCapable(model),
+        endpoints: model.endpoints ?? [],
+        input: model.modalities?.input ?? [],
+        tags: capabilityTagsOf(model),
+        plans: covered.plans,
+        freeCachePlans: covered.freeCachePlans,
+        profile: toModelProfile(model),
+    };
+}
+/**
+ * 组装一次完整视图。
+ *
+ * 目录是必需事实（失败即端点失败）；套餐表是可选事实（失败只标记 `plansError`），
+ * 因为模型目录公开且稳定，而套餐表是站点路由、形状随时可能变。
+ */
+export async function buildCatalogView(deps, signal) {
+    const [catalogModels, embeddingModels] = await Promise.all([
+        deps.catalog.list(undefined, signal),
+        deps.catalog.list('embedding', signal),
+    ]);
+    const seen = new Set();
+    const models = [];
+    for (const model of [...catalogModels, ...embeddingModels]) {
+        if (seen.has(model.id))
+            continue;
+        seen.add(model.id);
+        models.push(model);
+    }
+    let plans = [];
+    let plansError;
+    let coverage = new Map();
+    try {
+        const listed = await deps.plans.list(signal);
+        coverage = await deps.plans.coverage(signal);
+        plans = listed.map((plan) => ({
+            id: plan.id,
+            name: plan.name,
+            ...(plan.priceIdr === undefined ? {} : { priceIdr: plan.priceIdr }),
+            modelCount: plan.scopeModels.length,
+        }));
+    }
+    catch (err) {
+        plansError = err instanceof Error ? err.message : String(err);
+        deps.http.logger?.warn(`kenari: 套餐表读取失败，模型视图只显示能力标签：${plansError}`);
+    }
+    return {
+        generatedAt: Date.now(),
+        plans,
+        ...(plansError === undefined ? {} : { plansError }),
+        tags: CAPABILITY_TAGS,
+        models: models.map((model) => toView(model, coverage)),
+    };
+}
+/** 一次 GET/HEAD 的响应；HEAD 只回头部（路由契约要求同时支持两者）。 */
+async function viewResponse(deps, request) {
+    let body;
+    try {
+        body = await buildCatalogView(deps, request.signal);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        deps.http.logger?.warn(`kenari: 模型视图端点失败：${message}`);
+        return Response.json({ error: message }, { status: 502 });
+    }
+    const headers = { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' };
+    if (request.method === 'HEAD')
+        return new Response(null, { status: 200, headers });
+    return new Response(JSON.stringify(body), { status: 200, headers });
+}
+/**
+ * 注册模型视图路由。
+ *
+ * `connection` 是 web profile 才有的服务，所以在缺它的部署里静默跳过——
+ * 插件其余能力（工具、web provider、设置节）不依赖浏览器。
+ */
+export function registerCatalogView(ctx, deps) {
+    ctx.inject(['connection'], (connectionCtx) => {
+        connectionCtx.connection.fetch.register({
+            path: KENARI_MODEL_VIEW_PATH,
+            methods: ['GET', 'HEAD'],
+            requestBody: 'buffered',
+            fetch: (request) => viewResponse(deps, request),
+        });
+    });
+}
+//# sourceMappingURL=catalog-view.js.map

package/lib/catalog-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-view.js","sourceRoot":"","sources":["../src/catalog-view.ts"],"names":[],"mappings":"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"}

package/lib/catalog.d.ts

@@ -0,0 +1,239 @@
+/**
+ * Kenari 模型目录：`GET /v1/models` 同步 + TTL 缓存 + dsh 模型元数据映射。
+ *
+ * Kenari 目录是**唯一**的模型事实来源（价格、上下文窗口、模态、推理档位、下线时间）。
+ * 所有消费方（工具、设置卡片、LlmAdapter）都从这里取，避免各自解析 rc 期字段。
+ * 端点与字段名变动只改本文件。
+ * @module dsh-kenari-plugin/catalog
+ */
+import type { KenariHttpDeps } from './http.js';
+/** 专用能力目录的 modality 取值（`GET /v1/models?modality=`）。 */
+export type KenariModality = 'embedding' | 'rerank' | 'moderation';
+/** `pricing` 块：token 计价（micro-IDR per 1M tokens）。 */
+export interface KenariPricing {
+    input?: number | null;
+    output?: number | null;
+    cache_read?: number | null;
+    cache_write?: number | null;
+    free?: boolean;
+    varies?: boolean;
+    currency?: string;
+    unit?: string;
+}
+/** `pricing_lines` 行：按端点的计费明细（图像/秒/千字符/请求等非 token 单位）。 */
+export interface KenariPricingLine {
+    endpoint?: string;
+    billable?: string | null;
+    unit?: string;
+    variant?: string | null;
+    micro_idr?: number;
+}
+/** 目录模型行（字段宽松解析，rc 期缺字段不报错）。 */
+export interface KenariModel {
+    id: string;
+    object?: string;
+    owned_by?: string;
+    name?: string;
+    /** epoch 秒；非空表示将下线（到期前仍正常服务）。 */
+    sunset_at?: number | null;
+    context_length?: number;
+    modalities?: {
+        input?: string[];
+        output?: string[];
+    };
+    reasoning?: boolean;
+    reasoning_options?: string[];
+    reasoning_toggle?: boolean;
+    tool_call?: boolean;
+    pricing?: KenariPricing;
+    pricing_lines?: KenariPricingLine[];
+    endpoints?: string[];
+    modality?: string;
+    beta?: boolean;
+    voices?: string[];
+    formats?: string[];
+    max_input_chars?: number;
+    max_prompt_chars?: number;
+    max_lyrics_chars?: number;
+    max_duration_secs?: number;
+}
+/** 解析后的模型条目：目录行 + 派生判断，消费方不再重复判定。 */
+export interface ResolvedModel {
+    model: KenariModel;
+    id: string;
+    /** 是否免费（`:free` 后缀或 `pricing.free`）。 */
+    free: boolean;
+    /** 可用于会话（endpoints 含 chat）。 */
+    chatCapable: boolean;
+    /** 别名列表（含 `kenari/<id>` 限定形式与配置别名）。 */
+    aliases: string[];
+    /** 需要提示的警告（beta、即将下线）。 */
+    warnings: string[];
+}
+/** 目录解析失败时的可读原因（供工具与设置卡片展示）。 */
+export declare class CatalogError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/** 免费判定：`:free` 后缀或 `pricing.free`。 */
+export declare function isFreeModel(model: KenariModel): boolean;
+/** 会话可用判定：endpoints 含 `chat`；目录未给 endpoints 时按 modality 兜底。 */
+export declare function isChatCapable(model: KenariModel): boolean;
+/** dsh 只声明 text/image 两种输入模态；Kenari 的 audio/video/pdf 输入不映射（避免过度声明）。 */
+export declare function inputModalitiesOf(model: KenariModel): ('text' | 'image')[];
+/** 设置界面用来筛选与标注的能力标签；值就是标签文案本身。 */
+export type CapabilityTag = 'image' | 'audio' | 'video' | 'pdf' | 'embedding';
+/** 标签展示顺序（固定，避免每次渲染顺序漂移）。 */
+export declare const CAPABILITY_TAGS: readonly CapabilityTag[];
+/**
+ * 目录行 → 能力标签。
+ *
+ * 判定用的是**输入**能力与端点两处事实，因为 Kenari 对同一件事只在一处给字段：
+ * - 生成类（图像/视频/语音合成）只有 `endpoints`，`modalities.input` 仍是 text
+ * - 理解类（看图/听音频/读 PDF）只有 `modalities.input`
+ * - embedding 模型只在 `?modality=embedding` 目录里，带 `modality: 'embedding'`
+ * 所以两个来源都要看，且都只看事实、不猜（缺字段就不打标签）。
+ */
+export declare function capabilityTagsOf(model: KenariModel): CapabilityTag[];
+/**
+ * Kenari `reasoning_options` → pi-ai `reasoningEfforts`。
+ * Kenari 用 `none` 表示"支持但不发参数"，dsh 的对应键是 `off`；其余同名直通。
+ * 两侧都不认识的取值直接丢弃——写进设置会让 schemastery 校验整节失败。
+ */
+export declare function reasoningEffortsOf(model: KenariModel): Record<string, string> | undefined;
+/**
+ * 一个模型的展示名。
+ *
+ * 目录里只有 8 个模型自带 `name`，而且**都不是会话模型**（语音、图像、视频那几个），
+ * 所以会话模型的展示名必须能从 id 还原。这里的推导不是猜：Kenari 给出 `name` 的那 8 个
+ * 模型与本函数的输出**逐字一致**（Veo 3.1 Lite、MiniMax Speech 2.8 Turbo、
+ * Nano Banana Pro…），`test/catalog-view.mjs` 用它们反测。
+ *
+ * dsh 的「显示名称」是纯展示字段（不参与请求），所以还原值即使不完美也只是可改的默认值。
+ */
+export declare function displayNameOf(model: KenariModel): string;
+/**
+ * 每请求最大输出 token 的推荐值。
+ *
+ * 目录里**没有**这个字段：对全部 76 行实测过，只有 `context_length`，没有
+ * `max_output_tokens` / `max_completion_tokens` / `top_provider`。所以它是推出来的：
+ *
+ * - **窗口的 1/4**：一次回答最多占多少窗口的常见取法，给提示词留 3/4，请求才不会被
+ *   自己的上限顶出窗口。厂商公开的比例落在 6%（Gemini 2.5 的 65k / 1M）到
+ *   32%（Claude 的 64k / 200k）之间，取 1/4 偏宽——写代码时"被截断"比"留得多"更常见。
+ * - **不设下限**：下限看着无害，其实会算错小窗口的模型。目录里 `bge-m3` 的窗口只有 8192，
+ *   若按 8192 兜底就等于把整个窗口都推荐成输出。（全部会话模型的窗口都 ≥128K，所以
+ *   真正的会话模型从来用不到下限。）
+ * - **向下取整到 1K**：窗口不都是 2 的幂（有 128000、255976 这种），直接算会得到
+ *   32000 / 63994 这类数字。向下取整同时保证推荐值不超过窗口的 1/4。
+ * - **上限 65536**：主流厂商公开的单次输出上限最大就在这一档，再大不代表任何真实能力。
+ *   实测网关自己不做这个校验（`max_tokens` 给到 262144 仍返回 200），dsh 也不会把它从
+ *   输入预算里扣掉，所以这个上限是"别写没有意义的数"，不是"写了会出错"。
+ *
+ * 目录不公布窗口的模型（18 个，其中只有 `qwen3-8-max` 是会话模型）不写这个字段：
+ * 没有窗口可依据时，任何数值都是编的，不如沿用 pi-ai 自己的默认值。
+ */
+export declare function recommendedMaxTokens(contextWindow: number | undefined): number | undefined;
+/**
+ * 目录行 → pi-ai provider profile 的 model 条目。
+ *
+ * 这是「把目录里的模型加进 `llm-pi-ai` 路由」时写进用户设置的形状，
+ * 字段必须逐个来自目录：pi-ai 的 schema 会拒绝多余或拼错的键。
+ *
+ * `name` 与 `maxTokens` 都写：前者是 dsh 模型目录里那个「显示名称」框（不写就空着），
+ * 后者是每请求输出上限（不写则整条路由共用 pi-ai 的 `defaultMaxTokens` 32768，
+ * 于是每个模型看到的都是同一个数）。两者的推导见上面两个函数。
+ */
+export declare function toModelProfile(model: KenariModel): {
+    id: string;
+    name: string;
+    contextWindow?: number;
+    maxTokens?: number;
+    input?: ('text' | 'image')[];
+    reasoningEfforts?: Record<string, string>;
+};
+/** micro-IDR → IDR/1M tokens 的十进制字符串（整数不带小数点）。 */
+export declare function microToIdrPerMillion(micro: number): string;
+/** token 价格行：免费与浮动单列，缺失如实说"未公布"。 */
+export declare function formatTokenPrice(model: KenariModel): string;
+/** 非 token 端点单价行；无常驻行时返回空数组。 */
+export declare function formatPricingLines(model: KenariModel): string[];
+/** 端点 → 命中的计费行（variant 优先精确匹配，缺失取第一档）。 */
+export declare function priceLineOf(model: KenariModel, endpoint: string, variant?: string): KenariPricingLine | undefined;
+/** 端点 → 可读单价（micro-IDR）；variant 优先精确匹配，缺失取第一档。 */
+export declare function unitPriceMicro(model: KenariModel, endpoint: string, variant?: string): number | undefined;
+/** 计费单位的人读名称（回显口径用）。 */
+export declare function unitLabel(unit: string | undefined): string;
+/** 需要的计费单位（用于按量预估）：单位与数量的语义由调用方声明。 */
+export type BillingUnit = 'token_1m' | 'image' | 'second' | '1k_chars' | 'request' | 'megapixel' | 'song';
+/** 按计费行单价 × 数量（数量以该行 unit 为单位）预估费用（micro-IDR）。 */
+export declare function estimateMicro(model: KenariModel, endpoint: string, quantity: number, variant?: string): number | undefined;
+/** 模型体检：beta 标注与下线告警（到期前仍服务，故只提示不拒绝）。 */
+export declare function warningsOf(model: KenariModel, now?: number): string[];
+/** 模型别名：`kenari/<id>` 限定形式 + 配置别名 + 去除限定后的裸 id。 */
+export declare function aliasesOf(model: KenariModel, configured: Record<string, string>): string[];
+/** 别名归一：去掉 `kenari/` 或 `kenari:` 限定前缀，再查配置别名表。 */
+export declare function normalizeModelId(raw: string, configured: Record<string, string>): string;
+/**
+ * 目录客户端：进程内 TTL 缓存（目录是公开端点，无需 key）。
+ * 并发请求合并到同一次抓取，避免工具族同时冷启动打爆目录端点。
+ */
+export declare class KenariCatalog {
+    private readonly deps;
+    private cache;
+    private inflight;
+    constructor(deps: KenariHttpDeps);
+    /** 缓存有效期取自实时配置：设置页改完下一次读取即生效。 */
+    private get ttlMs();
+    /** 模型别名表取自实时配置。 */
+    private get aliases();
+    /** 目录抓取（公开端点）：TTL 内直接命中缓存。 */
+    list(modality?: KenariModality, signal?: AbortSignal): Promise<KenariModel[]>;
+    /** 会话模型目录（endpoints 含 chat），缓存与 list 共用。 */
+    chatModels(signal?: AbortSignal): Promise<KenariModel[]>;
+    /**
+     * 目录解析：别名归一 → 精确匹配 → 大小写不敏感兜底。
+     *
+     * 默认（无 modality）目录只含 chat 与生成类模型；embedding / rerank /
+     * moderation 只在 `?modality=` 目录里。给了 modality 就只多查那一本，
+     * 没给则三本都查（各自的响应都走 TTL 缓存，故代价一次性）。
+     */
+    resolve(rawId: string, modality?: KenariModality, signal?: AbortSignal): Promise<ResolvedModel | undefined>;
+    /** 目录行 → 解析后条目。 */
+    describe(model: KenariModel): ResolvedModel;
+    /** 免费会话模型（`新账户默认 step-3-7-flash:free` 的选型依据）。 */
+    freeModels(signal?: AbortSignal): Promise<KenariModel[]>;
+    /** 清空缓存（测试与强制刷新用）。 */
+    invalidate(): void;
+}
+/** 目录行 → dsh `LlmModelInfo` 形状（adapter 的 listModels 与设置卡片共用）。 */
+export declare function toLlmModelInfo(model: KenariModel, provider: string): {
+    provider: string;
+    id: string;
+    name: string;
+    description?: string;
+    inputModalities: ('text' | 'image')[];
+};
+/**
+ * 目录行 → dsh `LlmResolvedModelInfo` 形状：上下文窗口 + reasoning 档位 + 默认输出上限。
+ * `reasoning_options` 的每个值既是 dsh 的 effort id 也是 Kenari 线上的写法，故一一对应。
+ */
+export declare function toResolvedModelInfo(model: KenariModel, provider: string): {
+    provider: string;
+    id: string;
+    name: string;
+    description?: string;
+    inputModalities: ('text' | 'image')[];
+    context?: {
+        contextWindow: number;
+    };
+    reasoning?: {
+        efforts: {
+            id: string;
+            name: string;
+        }[];
+        defaultEffort?: string;
+    };
+};
+//# sourceMappingURL=catalog.d.ts.map

package/lib/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"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"}