cortico-provider-deepseek 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Phantivia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,32 @@
+<!-- Owner: index.ts, pricing.ts, console/client.ts, console/server.ts, console/schedule-panel.ts, console/pricing-panel.ts, package.json -->
+
+# cortico-provider-deepseek
+
+`cortico-provider-deepseek` 是 Cortico 的 DeepSeek 模型供应商扩展，使用 DeepSeek Responses API。它是独立的 npm 包，不依赖 `cortico-bot-continuity`。
+
+## 安装
+
+要求 Cortico 模型供应商扩展 API 5。在 Cortico 仓库的 `extensions/` 目录安装：
+
+```powershell
+Set-Location "<Cortico 仓库路径>\extensions"
+corepack pnpm add --ignore-workspace cortico-provider-deepseek
+```
+
+在 Cortico 控制台中新建 DeepSeek 端点，填写 API 密钥。默认模型为 `deepseek-flash`。
+
+## 成本与计价
+
+插件为 `deepseek-flash` 提供人民币模块价目。“成本与计价”面板显示峰谷单价和当前计价档位。端点自定义报价可按模型覆盖模块价目；未设置时使用模块价目。
+
+| 每百万 tokens | 空闲时段 | 高峰时段 |
+| --- | ---: | ---: |
+| 输入，缓存命中 | ¥0.02 | ¥0.04 |
+| 输入，缓存未命中 | ¥1 | ¥2 |
+| 输出 | ¥4 | ¥8 |
+
+默认高峰时段为北京时间周一至周五（不含例外日期）的 09:00–12:00、14:00–18:00。周末和例外日期全天为空闲时段。时间区间包含开始时刻，不包含结束时刻。
+
+“当前计价时段”面板可调整两段高峰时间和例外日期；例外日期每行填写一个 `YYYY-MM-DD`。初始列表包含 2026 年中国法定节假日；后续年份需要按官方安排更新。保存后的时段设置用于新请求。
+
+价格可能变化，发布的单价以 [DeepSeek 中文价格页](https://api-docs.deepseek.com/zh-cn/quick_start/pricing/) 为准。

package/console/client.ts

@@ -0,0 +1,9 @@
+import type { ConsoleClientBundle } from 'cortico/web/shared/client-panel.ts';
+import compat from 'cortico/providers/openai-responses-compat/console/client.ts';
+import { pricingPanel } from './pricing-panel.ts';
+import { schedulePanel } from './schedule-panel.ts';
+
+export default {
+  ...compat,
+  panels: { ...compat.panels, schedule: schedulePanel, pricing: pricingPanel },
+} satisfies ConsoleClientBundle;

package/console/pricing-panel.ts

@@ -0,0 +1,130 @@
+import type { ConsolePanel, ConsolePanelContext } from 'cortico/web/shared/client-panel.ts';
+import { pricingEditor } from 'cortico/web/client/console-pages/builtins/llm-settings/pricing-panel.ts';
+import { currentPricingBand, type DeepSeekPricingSchedule } from '../pricing.ts';
+import type { PriceDefinition } from 'cortico/providers/pricebook.ts';
+
+interface PricingState {
+  name: string;
+  schedule: DeepSeekPricingSchedule;
+  band: 'peak' | 'offPeak';
+  official: PriceDefinition;
+  custom: unknown[];
+  editing: boolean;
+}
+
+interface PricingInstance { name: string }
+
+export const pricingPanel: ConsolePanel = {
+  mount: async (ctx: ConsolePanelContext) => {
+    const zh = ctx.language === 'zh';
+    const S = zh ? {
+      title: 'DeepSeek 官方价目', current: '当前计价档位', peak: '高峰', offPeak: '空闲', model: '模型',
+      meter: '用量', cached: '输入（缓存命中）', uncached: '输入（缓存未命中）', output: '输出',
+      custom: '端点自定义报价', customOn: '已设置覆盖', fallback: '未设置，使用模块价目',
+      save: '应用报价', saved: '报价已写入连接草稿；保存连接后生效', savedNow: '报价已保存',
+      choose: 'DeepSeek 端点',
+      loadError: '无法读取价目', noInstances: '没有可用的 DeepSeek 端点',
+    } : {
+      title: 'DeepSeek official rates', current: 'Active pricing band', peak: 'Peak', offPeak: 'Off-peak', model: 'Model',
+      meter: 'Usage', cached: 'Input (cache hit)', uncached: 'Input (cache miss)', output: 'Output',
+      custom: 'Endpoint-specific quote', customOn: 'Override configured', fallback: 'Unset; using module rates',
+      save: 'Apply quote', saved: 'Quote staged; save the connection to apply it', savedNow: 'Quote saved',
+      choose: 'DeepSeek endpoint',
+      loadError: 'Unable to load rates', noInstances: 'No DeepSeek endpoints are available',
+    };
+    const message = ctx.ui.msgline();
+    const selector = ctx.scope.instance ? null : ctx.ui.select({
+      options: [],
+      onChange: (name) => void load(name),
+    });
+    if (selector) ctx.root.append(ctx.ui.field(S.choose, selector));
+    ctx.root.append(message);
+    let currentCard: HTMLElement | null = null;
+
+    let endpointNames: string[] = [];
+    if (ctx.scope.instance) {
+      endpointNames = [ctx.scope.instance];
+    } else {
+      try {
+        const instances = await ctx.invoke<PricingInstance[]>('instances');
+        endpointNames = instances.map(({ name }) => name);
+      } catch (error) {
+        message.textContent = `${S.loadError}: ${String(error)}`;
+        return;
+      }
+      if (!endpointNames.length) {
+        message.textContent = S.noInstances;
+        return;
+      }
+      selector!.replaceChildren(...endpointNames.map((name) => {
+        const option = ctx.ui.h('option', null, name) as HTMLOptionElement;
+        option.value = name;
+        return option;
+      }));
+    }
+    if (ctx.signal.aborted) return;
+    await load(endpointNames[0]);
+
+    async function load(name: string): Promise<void> {
+      try {
+        const state = await ctx.invoke<PricingState>('state', [{ name }]);
+        if (ctx.signal.aborted) return;
+        render(state);
+        message.textContent = '';
+      } catch (error) {
+        message.textContent = `${S.loadError}: ${String(error)}`;
+      }
+    }
+
+    function render(state: PricingState): void {
+      const card = ctx.ui.sheet({ title: S.title });
+      const band = currentPricingBand(state.schedule, new Date());
+      card.body.append(ctx.ui.statgrid([
+        { k: S.model, v: state.official.models.join(', ') },
+        { k: S.current, v: band === 'peak' ? S.peak : S.offPeak, accent: true },
+      ]));
+      const table = ctx.ui.table({ head: [S.meter, S.peak, S.offPeak] });
+      const peakRules = state.official.timeWindows?.[0]?.rules ?? [];
+      const labels = new Map([
+        ['cachedInput', S.cached], ['uncachedInput', S.uncached], ['output', S.output],
+      ]);
+      for (const rule of state.official.rules) {
+        const peak = peakRules.find((item) => item.meter === rule.meter)?.perMillion ?? rule.perMillion;
+        const format = (rate: number) => `¥${rate.toFixed(2)} / 1M`;
+        table.addRow([
+          labels.get(rule.meter) ?? rule.meter,
+          band === 'peak' ? ctx.ui.chip(format(peak), 'accent') : format(peak),
+          band === 'offPeak' ? ctx.ui.chip(format(rule.perMillion), 'accent') : format(rule.perMillion),
+        ]);
+      }
+      card.body.append(table.el, ctx.ui.msgline(`${state.official.source} · Asia/Shanghai`));
+
+      const details = ctx.ui.foldSheet('deepseek-custom-pricing', { title: S.custom });
+      details.el.classList.add('deepseek-custom-pricing');
+      details.note.textContent = state.custom.length ? S.customOn : S.fallback;
+      let customPricing = state.custom;
+      const editor = pricingEditor(ctx.ui, state.custom, [], (value) => { customPricing = value; }, ctx.language);
+      details.body.append(editor.body);
+      const save = ctx.ui.button(S.save, { variant: 'primary', onClick: () => void savePricing() });
+      details.body.append(ctx.ui.actions().appendChild(save));
+      card.body.append(details.el);
+      if (currentCard) currentCard.replaceWith(card.el);
+      else ctx.root.insertBefore(card.el, message);
+      currentCard = card.el;
+
+      async function savePricing(): Promise<void> {
+        if (!editor.validate()) return;
+        const release = ctx.ui.disable(save);
+        try {
+          const updated = await ctx.invoke<PricingState>('save', [{ name: state.name, pricing: customPricing }]);
+          message.textContent = updated.editing ? S.saved : S.savedNow;
+          render(updated);
+        } catch (error) {
+          message.textContent = String(error);
+        } finally {
+          release.dispose();
+        }
+      }
+    }
+  },
+};

package/console/schedule-panel.ts

@@ -0,0 +1,97 @@
+import type { ConsolePanel, ConsolePanelContext } from 'cortico/web/shared/client-panel.ts';
+import { currentPricingBand, type DeepSeekPricingSchedule } from '../pricing.ts';
+
+interface ScheduleState {
+  name: string;
+  schedule: DeepSeekPricingSchedule;
+  band: 'peak' | 'offPeak';
+}
+
+export const schedulePanel: ConsolePanel = {
+  mount: async (ctx: ConsolePanelContext) => {
+    const zh = ctx.language === 'zh';
+    const S = zh ? {
+      current: '当前计价时段', peak: '高峰', offPeak: '空闲', timezone: '北京时间（Asia/Shanghai）',
+      windows: '高峰时段', weekday: '周一至周五；周末始终为空闲时段', exceptions: '例外日期（每行 YYYY-MM-DD）',
+      from: '开始', to: '结束',
+      save: '保存时段', saved: '峰谷设置已保存', invalid: '时段格式错误；请填写 HH:MM，例外日期每行填写 YYYY-MM-DD。',
+      refreshError: '无法读取峰谷设置',
+    } : {
+      current: 'Active pricing band', peak: 'Peak', offPeak: 'Off-peak', timezone: 'China Standard Time (Asia/Shanghai)',
+      windows: 'Peak windows', weekday: 'Monday to Friday; weekends are always off-peak', exceptions: 'Exception dates (one YYYY-MM-DD per line)',
+      from: 'From', to: 'To',
+      save: 'Save schedule', saved: 'Pricing schedule saved', invalid: 'Invalid time or date format. Use HH:MM and one YYYY-MM-DD date per line.',
+      refreshError: 'Unable to load pricing schedule',
+    };
+    const status = ctx.ui.foldSheet('deepseek-schedule', { title: S.current });
+    const message = ctx.ui.msgline();
+    ctx.root.append(status.el, message);
+
+    let state: ScheduleState;
+    try {
+      state = await ctx.invoke<ScheduleState>('state', [{ name: ctx.scope.instance }]);
+    } catch (error) {
+      message.textContent = `${S.refreshError}: ${String(error)}`;
+      return;
+    }
+    if (ctx.signal.aborted) return;
+
+    const updateStatus = (band = currentPricingBand(state.schedule, new Date())) => {
+      const now = new Date();
+      const time = new Intl.DateTimeFormat(zh ? 'zh-CN' : 'en-GB', {
+        timeZone: 'Asia/Shanghai', dateStyle: 'medium', timeStyle: 'short', hourCycle: 'h23',
+      }).format(now);
+      status.note.textContent = `${band === 'peak' ? S.peak : S.offPeak} · ${time} · ${S.timezone}`;
+    };
+    updateStatus(state.band);
+    ctx.interval(updateStatus, 30_000);
+
+    const starts = state.schedule.windows.map((window) => ctx.ui.input({ value: window.from, placeholder: '09:00', cls: 'mono' }));
+    const ends = state.schedule.windows.map((window) => ctx.ui.input({ value: window.to, placeholder: '12:00', cls: 'mono' }));
+    const windows = ctx.ui.rowbar();
+    windows.classList.add('deepseek-window-grid');
+    windows.style.alignItems = 'stretch';
+    state.schedule.windows.forEach((_, index) => {
+      const group = ctx.ui.h('div', 'deepseek-window');
+      group.style.flex = '1 1 280px';
+      group.style.minWidth = '0';
+      const times = ctx.ui.rowbar();
+      times.style.flexWrap = 'nowrap';
+      for (const [label, input] of [[S.from, starts[index]], [S.to, ends[index]]] as const) {
+        const field = ctx.ui.field(label, input);
+        field.style.flex = '1 1 0';
+        field.style.minWidth = '0';
+        times.append(field);
+      }
+      group.append(ctx.ui.h('div', 'fieldlabel', zh ? `时段 ${index + 1}` : `Window ${index + 1}`), times);
+      windows.append(group);
+    });
+    status.body.append(ctx.ui.section(S.windows), ctx.ui.msgline(S.weekday), windows);
+    const exceptionDates = ctx.ui.textarea({ rows: 6, value: state.schedule.exceptDates.join('\n'), cls: 'mono' });
+    status.body.append(ctx.ui.field(S.exceptions, exceptionDates));
+    const save = ctx.ui.button(S.save, { variant: 'primary', onClick: () => void saveSchedule() });
+    status.body.append(ctx.ui.actions().appendChild(save));
+
+    async function saveSchedule(): Promise<void> {
+      const schedule: DeepSeekPricingSchedule = {
+        windows: starts.map((input, index) => ({ from: input.value.trim(), to: ends[index].value.trim() })),
+        exceptDates: exceptionDates.value.split(/\r?\n/).map((date) => date.trim()).filter(Boolean),
+      };
+      if (schedule.windows.some(({ from, to }) => !/^\d{2}:\d{2}$/.test(from) || !/^\d{2}:\d{2}$/.test(to))
+        || schedule.exceptDates.some((date) => !/^\d{4}-\d{2}-\d{2}$/.test(date))) {
+        message.textContent = S.invalid;
+        return;
+      }
+      const release = ctx.ui.disable(save);
+      try {
+        state = await ctx.invoke<ScheduleState>('save', [{ name: state.name, schedule }]);
+        message.textContent = S.saved;
+        updateStatus(state.band);
+      } catch (error) {
+        message.textContent = String(error);
+      } finally {
+        release.dispose();
+      }
+    }
+  },
+};

package/console/server.ts

@@ -0,0 +1,63 @@
+import type { ConsolePageContribution } from 'cortico/web/shared/console-protocol.ts';
+import type { ProviderConsoleHost } from 'cortico/providers/console/types.ts';
+import type { LLMProviderEntry } from 'cortico/core/types.ts';
+import responsesCompat from 'cortico/providers/openai-responses-compat/index.ts';
+import { validatePrices } from 'cortico/providers/pricebook.ts';
+import { currentPricingBand, parsePricingSchedule, pricesForSchedule } from '../pricing.ts';
+
+function instanceName(args: unknown[], required: string): string {
+  const raw = args[0];
+  if (!raw || typeof raw !== 'object' || Array.isArray(raw) || typeof (raw as Record<string, unknown>).name !== 'string') throw new Error(required);
+  return (raw as { name: string }).name;
+}
+
+export function deepseekPricingConsole(host: ProviderConsoleHost): Partial<ConsolePageContribution> {
+  const base = responsesCompat.console?.(host) ?? {};
+  const labels = host.language === 'zh'
+    ? { title: '峰谷计价', description: '查看人民币单价、当前时段并调整峰时段与例外日期。', pricing: '成本与计价', pricingDescription: 'DeepSeek 官方价目与端点自定义报价。', required: '需要端点名', unknownMethod: '未知方法' }
+    : { title: 'Peak/off-peak pricing', description: 'View RMB rates, the active band, and edit peak hours and exception dates.', pricing: 'Cost and pricing', pricingDescription: 'DeepSeek official rates and endpoint-specific overrides.', required: 'Endpoint name required', unknownMethod: 'Unknown method' };
+  const stateFor = (name: string, entry: LLMProviderEntry) => {
+    const schedule = parsePricingSchedule(entry.options?.deepseekPricingSchedule);
+    return { name, schedule, band: currentPricingBand(schedule, new Date()), official: pricesForSchedule(schedule), custom: entry.pricing ?? [] };
+  };
+  const panels = (base.panels ?? []).map((panel) => panel.id === 'pricing'
+    ? { id: 'pricing', title: labels.pricing, description: labels.pricingDescription }
+    : panel);
+  return {
+    ...base,
+    config: [...(base.config ?? [])],
+    panels: [
+      ...panels,
+      { id: 'schedule', title: labels.title, description: labels.description },
+    ],
+    invoke: async (panel, method, args) => {
+      if (panel !== 'schedule' && panel !== 'pricing') return base.invoke?.(panel, method, args);
+      if (panel === 'pricing' && method === 'instances') {
+        return host.entries().map(({ name }) => ({ name }));
+      }
+      const name = instanceName(args, labels.required);
+      const entry = host.entries().find((item) => item.name === name)?.entry;
+      if (!entry) throw new Error(labels.required);
+      if (panel === 'pricing') {
+        if (method === 'state') return { ...stateFor(name, entry), editing: host.editing === true };
+        if (method === 'save') {
+          const raw = args[0] as Record<string, unknown>;
+          const pricing = validatePrices(raw.pricing, host.language);
+          const next = { ...entry, pricing };
+          host.save(name, next);
+          return { ...stateFor(name, next), editing: host.editing === true };
+        }
+        throw new Error(labels.unknownMethod);
+      }
+      if (method === 'state') return stateFor(name, entry);
+      if (method === 'save') {
+        const raw = args[0] as Record<string, unknown>;
+        const schedule = parsePricingSchedule(raw.schedule);
+        const next = { ...entry, options: { ...entry.options, deepseekPricingSchedule: JSON.stringify(schedule) } };
+        host.save(name, next);
+        return stateFor(name, next);
+      }
+      throw new Error(labels.unknownMethod);
+    },
+  };
+}