dsh-opendesign-corouter 0.1.1 → 0.1.3

package/README.md

@@ -32,7 +32,7 @@ dsh plugin --profile web add dsh-opendesign-corouter
 也可打开 [Actions → CI](https://github.com/KouzakiUmi/dsh-opendesign-corouter/actions/workflows/ci.yml)，从成功构建下载 **`dsh-opendesign-corouter-build`** artifact。登录 GitHub 后解压 ZIP，取得 `.tgz` 与 `.sha256`，再安装本地包：
 
 ```console
-dsh plugin --profile web add /absolute/path/to/dsh-opendesign-corouter-0.1.1.tgz
+dsh plugin --profile web add /absolute/path/to/dsh-opendesign-corouter-0.1.2.tgz
 ```
 
 `web` 只是示例，请替换为目标 Profile。Desktop 使用桌面安装器提供的 `dsh` 入口；独立公共 CLI 不能代管保留的 `desktop` Profile。安装后的启用与重载按目标 DSH 的管理流程进行。
@@ -48,14 +48,16 @@ dsh plugin --profile web add /absolute/path/to/dsh-opendesign-corouter-0.1.1.tgz
 
 ## 功能预览
 
-### 两个 Provider，目录分开
+### 两个 Provider，逐模型配置
 
 | Provider | 模型数 | 用途 |
 | --- | ---: | --- |
 | `opendesign-corouter-plan` | 12 | 官网 Design Plan 套餐赠送模型 |
 | `opendesign-corouter-paid` | 21 | 其余公开对话模型 |
 
-模型 ID 来自 [CoRouter 官方目录](https://corouter.open-design.ai/zh/models/)。媒体生成接口不在对话目录中；缺乏可靠证据的能力字段保持未知。
+上表为内置目录。模型页可从 OpenAI `/models` 端口刷新，逐个启用或停用模型，并配置温度、top-p、默认输出上限、上下文预算及思考深度。停用同时影响模型选择器和直接调用；参数会保存并应用到实际请求。媒体生成接口不在对话目录中，未知能力不按名称猜测。
+
+推理协议可选 **OpenAI Chat Completions、OpenAI Responses、Anthropic Messages**。模型发现始终使用 OpenAI 端口，不随推理协议切换。
 
 > **分组不等于计费隔离。** 赠送额度耗尽后是否转扣套餐余额或钱包，由服务端和账号权益决定。选择“套餐赠送”不能保证绝不消耗钱包余额。
 
@@ -66,7 +68,7 @@ dsh plugin --profile web add /absolute/path/to/dsh-opendesign-corouter-0.1.1.tgz
 - **充值 / 赠送金额**：钱包中对应池的可用金额。
 - **总额度**：接口报告的总余额，不再与分池数字重复相加。
 
-接口缺失或权限不足时显示未知 / 部分可用，不补成 0。桌面通道权限较窄时可能只读到窗口与总额；独立登录可补充控制台分池读取。额度属于当前登录身份，插件未核对它与推理 Key 的账号 / 工作区是否一致。
+接口缺失或权限不足时显示未知 / 部分可用，不补成 0。窗口重置、订阅账期结束和下次自动刷新分别显示。桌面通道只有部分额度且已有完整独立会话时，会整体切换到独立会话并标明来源，不拼接账号数据。额度身份与推理 Key 的账号 / 工作区仍需保持一致。
 
 ### 桌面优先，也能独立登录
 

package/lib/adapter.d.ts

@@ -1,8 +1,10 @@
 import { LlmAdapter, type GenerateOptions, type LlmModelInfo, type LlmResolvedModelInfo, type PreparedAdapterCall, type StreamChunk } from '@deepseek-ai/dsh-llm';
 import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
+import { type CatalogModel } from './catalog.js';
 import { type RuntimeConfig } from './config.js';
 export interface AdapterOptions {
     config(): RuntimeConfig;
+    models?(): readonly CatalogModel[];
     apiKey(ref: string): Promise<string | undefined>;
     imageDataUrl?(image: ImageAttachmentRef, signal: AbortSignal): Promise<string | undefined>;
     onEmptyTurn?(): void;
@@ -17,6 +19,7 @@ export declare class CoRouterAdapter extends LlmAdapter {
         id: string;
         name: string;
     };
+    private modelOf;
     listModels(provider: string): Promise<readonly LlmModelInfo[]>;
     resolveModel(provider: string, model: string, signal?: AbortSignal): Promise<LlmResolvedModelInfo>;
     prepareCall(provider: string, model: string, signal?: AbortSignal): Promise<PreparedAdapterCall>;

package/lib/client.d.ts

@@ -1,7 +1,10 @@
 import * as React from 'react';
 import openDesignCoRouterRemote, { type CoRouterRemote } from './generated/typert.remote-client.js';
 import type { TypertClientRemote } from '@deepseek-ai/dsh-typert-protocol';
-import type { QuotaSnapshot } from './quota.js';
+import { type Status, type StatusModel } from './remote.js';
+import type { QuotaSnapshot, QuotaWindow } from './quota.js';
+import { type ApiProtocol } from './protocol-options.js';
+import type { ModelSettings, ModelSettingsMap } from './model-settings.js';
 declare const TABS: readonly [{
     readonly id: "overview";
     readonly label: "概览";
@@ -17,37 +20,42 @@ declare const TABS: readonly [{
 }];
 type TabId = typeof TABS[number]['id'];
 export type RpcCaller = <T>(method: keyof CoRouterRemote, request?: unknown) => Promise<T>;
-interface FormValues {
+export interface FormValues {
     emptyTurnGuard?: boolean;
     useDesktopCredential?: boolean;
     baseURL?: string;
     apiKeyEnv?: string;
+    apiProtocol?: ApiProtocol;
+    modelSettings?: ModelSettingsMap;
+    quotaRefreshSeconds?: number;
+    requestTimeoutMs?: number;
+    streamIdleTimeoutMs?: number;
 }
-interface FormSnapshot {
+export interface FormSnapshot {
     status: 'loading' | 'ready' | 'unavailable';
     value: FormValues | undefined;
     writable: boolean;
 }
-interface ConfigForm {
+export interface ConfigForm {
     getSnapshot(): FormSnapshot;
     subscribe(listener: () => void): () => void;
     set(field: string, value: unknown): Promise<boolean>;
 }
-interface ConfigForms {
+export interface ConfigForms {
     get(namespace: string): ConfigForm;
 }
-interface SlotDescriptor<P> {
+export interface SlotDescriptor<P> {
     name: 'settings.section';
     id: string;
     order: number;
     label: () => string;
     inject: () => P;
 }
-interface Slots {
+export interface Slots {
     inject(name: 'settings.section', register: () => void | (() => void)): void | (() => void);
     register<P>(descriptor: SlotDescriptor<P>, component: React.ComponentType<P>): void | (() => void);
 }
-interface ClientContext {
+export interface ClientContext {
     remote: TypertClientRemote & {
         $mount(contribution: typeof openDesignCoRouterRemote): Promise<() => void>;
     };
@@ -55,11 +63,11 @@ interface ClientContext {
     inject(services: ['configForms'], apply: (ctx: ConfigScope) => void): void;
     inject(services: ['remote.openDesignCoRouter'], apply: (ctx: RemoteScope) => void): void;
 }
-interface RemoteScope {
+export interface RemoteScope {
     remote: TypertClientRemote;
     effect(effect: () => void | (() => void), label?: string): void;
 }
-interface ConfigScope {
+export interface ConfigScope {
     configForms: ConfigForms;
     slots: Slots;
     effect(effect: () => void | (() => void), label?: string): void;
@@ -68,15 +76,113 @@ export interface SettingsProps {
     caller: RpcCaller;
     form: ConfigForm;
 }
+interface Notice {
+    kind: 'status' | 'error';
+    text: string;
+}
 export declare function formatUsd(value: number | undefined): string;
-export declare function QuotaView({ quota }: {
+export declare function formatTime(value: string | undefined): string;
+/** Token capacities use the same zh-CN grouping as amounts so large windows stay readable. */
+export declare function formatTokens(value: number | undefined): string;
+export interface QuotaViewProps {
     quota: QuotaSnapshot | undefined;
-}): React.DetailedReactHTMLElement<{
+    nextAutoRefreshAt?: string | undefined;
+    refreshIntervalSeconds?: number | undefined;
+}
+/** Earliest still-future window reset; quota recovery comes only from `windows[].resetsAt`. */
+export declare function nextWindowResetAt(windows: readonly QuotaWindow[], now: number): string | undefined;
+export declare function QuotaView({ quota, nextAutoRefreshAt, refreshIntervalSeconds }: QuotaViewProps): React.DetailedReactHTMLElement<{
     className: string;
     role: "status";
 }, HTMLElement> | React.FunctionComponentElement<{
     children?: React.ReactNode | undefined;
 }>;
+/** Whole-map model settings writer: absent entry means "inherit every default". */
+export declare function writeModelSettings(map: ModelSettingsMap | undefined, id: string, next: ModelSettings | undefined): ModelSettingsMap;
+/** One model's explicit settings; unknown ids read as "no overrides". */
+export declare function modelSettingsEntry(map: ModelSettingsMap | undefined, id: string): ModelSettings;
+/**
+ * Explicit settings always win. When the settings map is authoritative (a ready form snapshot or
+ * the Host's mirror), an absent entry means "enabled"; only a non-authoritative view falls back to
+ * `Status.models[].enabled`, which can lag one refresh behind a reset.
+ */
+export declare function modelEnabled(model: StatusModel, settings: ModelSettings | undefined, authoritative?: boolean): boolean;
+export interface NumberInputSpec {
+    label: string;
+    min: number;
+    max: number;
+    integer?: boolean;
+    allowEmpty?: boolean;
+}
+export type NumberInputResult = {
+    ok: true;
+    value: number | undefined;
+} | {
+    ok: false;
+    message: string;
+};
+/** Parse a label-bound numeric setting; an empty string means "inherit" when allowed. */
+export declare function parseNumberInput(raw: string, spec: NumberInputSpec): NumberInputResult;
+/** Absolute endpoint of the selected protocol; the gateway itself stays read-only. */
+export declare function protocolEndpoint(baseURL: string, protocol: ApiProtocol): string;
+export declare function normaliseQuotaRefreshSeconds(value: number | undefined): number | undefined;
+export interface QuotaAutoRefresh {
+    delayMs: number;
+    at: string;
+    intervalSeconds: number;
+}
+/**
+ * Schedule the next quota refresh: the automatic interval normally, or earlier when the Host's
+ * cache policy reports its next planned read (`nextRefreshAt`, which is never a quota reset).
+ * During failure backoff the host plan wins, even when the normal interval is shorter.
+ * A timestamp that is already past must not create a 0 ms retry loop, so it falls back to the
+ * regular interval instead of hammering the console.
+ */
+export declare function quotaAutoRefresh(secondsRaw: number | undefined, nextRefreshAt: string | undefined, now: number, backingOff?: boolean): QuotaAutoRefresh | undefined;
+export interface OverviewProps {
+    status: Status | undefined;
+    busy: boolean;
+    onRefresh: () => void;
+    nextAutoRefreshAt?: string | undefined;
+    refreshIntervalSeconds?: number | undefined;
+    onConnection?: (() => void) | undefined;
+}
+export declare function Overview({ status, busy, onRefresh, nextAutoRefreshAt, refreshIntervalSeconds, onConnection }: OverviewProps): React.FunctionComponentElement<{
+    children?: React.ReactNode | undefined;
+}>;
+export interface ModelRowProps {
+    model: StatusModel;
+    settings: ModelSettings;
+    /** Whether an absent settings entry means enabled rather than the host catalog flag. */
+    authoritative: boolean;
+    writable: boolean;
+    pending: boolean;
+    onCommit: (next: ModelSettings | undefined) => Promise<boolean>;
+}
+export declare function ModelRow({ model, settings, authoritative, writable, pending, onCommit }: ModelRowProps): React.DetailedReactHTMLElement<{
+    className: string;
+}, HTMLElement>;
+export interface ModelsProps {
+    status: Status | undefined;
+    formSnapshot: FormSnapshot;
+    setFormField: (field: string, value: unknown) => Promise<boolean>;
+    pendingField: readonly string[];
+    onRefreshModels: () => void;
+    refreshingModels: boolean;
+    notice: Notice | null;
+}
+export declare function Models({ status, formSnapshot, setFormField, pendingField, onRefreshModels, refreshingModels, notice }: ModelsProps): React.FunctionComponentElement<{
+    children?: React.ReactNode | undefined;
+}>;
+export interface AdvancedProps {
+    status: Status | undefined;
+    formSnapshot: FormSnapshot;
+    setFormField: (field: string, value: unknown) => Promise<boolean>;
+    pendingField: readonly string[];
+}
+export declare function Advanced({ status, formSnapshot, setFormField, pendingField }: AdvancedProps): React.FunctionComponentElement<{
+    children?: React.ReactNode | undefined;
+}>;
 export declare function tabAfter(current: TabId, key: string): TabId | undefined;
 export declare function SettingsPage({ caller, form }: SettingsProps): React.DetailedReactHTMLElement<{
     className: string;