pi-deepseek-web-search 0.1.0

package/schema/deepseek-web-search.config.schema.zh.json

@@ -0,0 +1,186 @@
+{
+  "type": "object",
+  "properties": {
+    "apiKey": {
+      "type": "string",
+      "minLength": 1,
+      "description": "DeepSeek API key（必填）。优先级：环境变量 DEEPSEEK_API_KEY > 本字段。"
+    },
+    "baseUrl": {
+      "type": "string",
+      "default": "https://api.deepseek.com",
+      "description": "API 基础地址（自建代理时修改）。环境变量 DEEPSEEK_BASE_URL 可覆盖。"
+    },
+    "model": {
+      "type": "string",
+      "default": "deepseek-v4-flash",
+      "minLength": 1,
+      "pattern": "^(?!\\s*$)",
+      "description": "模型名。Responses API 目前仅支持 deepseek-v4-flash；v4-pro 适配后改这里即切换（价格自动取 prices.models）。环境变量 DEEPSEEK_MODEL 可覆盖。"
+    },
+    "reasoningEffort": {
+      "type": "string",
+      "enum": [
+        "off",
+        "low",
+        "high",
+        "auto"
+      ],
+      "default": "low",
+      "description": "推理强度：off 关闭思考（省 token）、low/high 控制思考量、auto 用模型默认行为。环境变量 DEEPSEEK_REASONING_EFFORT 可覆盖。"
+    },
+    "maxOutputTokens": {
+      "type": "integer",
+      "minimum": 1,
+      "default": 4096,
+      "description": "回答最大输出 token 数。环境变量 DEEPSEEK_MAX_OUTPUT_TOKENS 可覆盖。"
+    },
+    "timeoutMs": {
+      "type": "integer",
+      "minimum": 1,
+      "default": 30000,
+      "description": "单次请求超时（毫秒）。环境变量 DEEPSEEK_TIMEOUT_MS 可覆盖。"
+    },
+    "cacheTtlMs": {
+      "type": "integer",
+      "minimum": 1,
+      "default": 300000,
+      "description": "搜索结果缓存 TTL（毫秒）。环境变量 DEEPSEEK_CACHE_TTL_MS 可覆盖。"
+    },
+    "maxResultChars": {
+      "type": "integer",
+      "minimum": 1,
+      "default": 50000,
+      "description": "返回给 LLM 的文本最大字符数（超出截断）。环境变量 DEEPSEEK_MAX_RESULT_CHARS 可覆盖。"
+    },
+    "prices": {
+      "type": "object",
+      "properties": {
+        "inputPerMillion": {
+          "type": "number",
+          "exclusiveMinimum": 0,
+          "default": 1,
+          "description": "输入单价（缓存未命中）。环境变量 DEEPSEEK_PRICE_INPUT 可覆盖。"
+        },
+        "cachedInputPerMillion": {
+          "type": "number",
+          "exclusiveMinimum": 0,
+          "default": 0.02,
+          "description": "输入单价（缓存命中）。环境变量 DEEPSEEK_PRICE_CACHED_INPUT 可覆盖。"
+        },
+        "outputPerMillion": {
+          "type": "number",
+          "exclusiveMinimum": 0,
+          "default": 2,
+          "description": "输出单价。环境变量 DEEPSEEK_PRICE_OUTPUT 可覆盖。"
+        },
+        "peak": {
+          "type": "object",
+          "required": [
+            "multiplier",
+            "hours"
+          ],
+          "properties": {
+            "multiplier": {
+              "type": "number",
+              "exclusiveMinimum": 0,
+              "description": "高峰单价倍率（官方规则为 2）。"
+            },
+            "hours": {
+              "type": "array",
+              "items": {
+                "type": "array",
+                "additionalItems": false,
+                "items": [
+                  {
+                    "type": "string",
+                    "pattern": "^(?:[01][0-9]|2[0-3]):[0-5][0-9]$"
+                  },
+                  {
+                    "type": "string",
+                    "pattern": "^(?:[01][0-9]|2[0-3]):[0-5][0-9]$"
+                  }
+                ],
+                "minItems": 2
+              },
+              "minItems": 1,
+              "description": "高峰时段列表，半开区间 [start, end)（09:00 计高峰、12:00 不计）。"
+            }
+          },
+          "additionalProperties": false,
+          "description": "峰谷定价：高峰时段价格 = 平峰 × multiplier（适用所有计费项）。官方定义高峰时段为北京时间每日 9:00-12:00 与 14:00-18:00。"
+        },
+        "models": {
+          "type": "object",
+          "patternProperties": {
+            "^.*$": {
+              "type": "object",
+              "properties": {
+                "inputPerMillion": {
+                  "type": "number",
+                  "exclusiveMinimum": 0,
+                  "description": "输入单价（缓存未命中）。"
+                },
+                "cachedInputPerMillion": {
+                  "type": "number",
+                  "exclusiveMinimum": 0,
+                  "description": "输入单价（缓存命中）。"
+                },
+                "outputPerMillion": {
+                  "type": "number",
+                  "exclusiveMinimum": 0,
+                  "description": "输出单价。"
+                },
+                "peak": {
+                  "type": "object",
+                  "required": [
+                    "multiplier",
+                    "hours"
+                  ],
+                  "properties": {
+                    "multiplier": {
+                      "type": "number",
+                      "exclusiveMinimum": 0,
+                      "description": "高峰单价倍率（官方规则为 2）。"
+                    },
+                    "hours": {
+                      "type": "array",
+                      "items": {
+                        "type": "array",
+                        "additionalItems": false,
+                        "items": [
+                          {
+                            "type": "string",
+                            "pattern": "^(?:[01][0-9]|2[0-3]):[0-5][0-9]$"
+                          },
+                          {
+                            "type": "string",
+                            "pattern": "^(?:[01][0-9]|2[0-3]):[0-5][0-9]$"
+                          }
+                        ],
+                        "minItems": 2
+                      },
+                      "minItems": 1,
+                      "description": "高峰时段列表，半开区间 [start, end)（09:00 计高峰、12:00 不计）。"
+                    }
+                  },
+                  "additionalProperties": false,
+                  "description": "峰谷定价：高峰时段价格 = 平峰 × multiplier（适用所有计费项）。官方定义高峰时段为北京时间每日 9:00-12:00 与 14:00-18:00。"
+                }
+              },
+              "additionalProperties": false,
+              "description": "单模型价格覆盖：缺省项回退顶层价格。"
+            }
+          },
+          "description": "按模型覆盖的价格表（key = 模型名，命中优先；整块替换默认表）。"
+        }
+      },
+      "additionalProperties": false,
+      "description": "价格配置，单位：元/百万 tokens。默认值为官方平峰价。"
+    }
+  },
+  "additionalProperties": false,
+  "description": "Generated by pnpm gen:schema from src/config-schema.ts — do not edit. 由 src/config-schema.ts 自动生成，请勿手改。",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "deepseek-web-search config (zh)"
+}

package/src/cache.ts

@@ -0,0 +1,45 @@
+// 进程内 TTL 缓存：避免短时间内重复搜索相同 query 造成重复开销。
+
+interface CacheEntry<T> {
+  value: T;
+  expiresAt: number;
+}
+
+export class TtlCache<T> {
+  private readonly entries = new Map<string, CacheEntry<T>>();
+  private readonly ttlMs: number;
+
+  constructor(ttlMs: number) {
+    this.ttlMs = ttlMs;
+  }
+
+  /** 已过期条目视为未命中（惰性删除） */
+  get(key: string): T | undefined {
+    const entry = this.entries.get(key);
+    if (entry === undefined)
+      return undefined;
+    if (Date.now() >= entry.expiresAt) {
+      this.entries.delete(key);
+      return undefined;
+    }
+    return entry.value;
+  }
+
+  set(key: string, value: T): void {
+    this.entries.set(key, { value, expiresAt: Date.now() + this.ttlMs });
+  }
+
+  clear(): void {
+    this.entries.clear();
+  }
+
+  /** 当前有效条目数（惰性清理过期条目后统计） */
+  size(): number {
+    const now = Date.now();
+    for (const [key, entry] of this.entries) {
+      if (now >= entry.expiresAt)
+        this.entries.delete(key);
+    }
+    return this.entries.size;
+  }
+}

package/src/config-schema.ts

@@ -0,0 +1,176 @@
+import type { Static } from "typebox";
+import type { ReasoningEffort } from "./provider.js";
+// config-schema.ts —— 配置文件结构的单一事实来源（TypeBox）。
+// 派生：① ConfigFileShape 类型（config.ts 经 Static）② 运行时校验（Check/Errors）③ 中/英两份 JSON Schema（pnpm gen:schema）。
+// 双语注释约定：descriptionZh（中文）/ descriptionEn（英文），生成时映射为标准 description。
+// 说明：reasoningEffort 用 Type.Unsafe 而非 StringEnum（StringEnum 不透传自定义注释键；配置 schema 无 Gemini 兼容约束）。
+import { Type } from "typebox";
+
+/** HH:MM 24 小时制（00:00-23:59） */
+const TIME_PATTERN = "^(?:[01][0-9]|2[0-3]):[0-5][0-9]$";
+
+/** 峰谷定价覆盖（可选）。官方定义：高峰 = 平峰 × multiplier，时段为北京时间每日 */
+export const peakSchema = Type.Object({
+  multiplier: Type.Number({
+    exclusiveMinimum: 0,
+    descriptionZh: "高峰单价倍率（官方规则为 2）。",
+    descriptionEn: "Peak multiplier; official value is 2.",
+  }),
+  hours: Type.Array(
+    Type.Tuple([
+      Type.String({ pattern: TIME_PATTERN }),
+      Type.String({ pattern: TIME_PATTERN }),
+    ]),
+    {
+      minItems: 1,
+      descriptionZh: "高峰时段列表，半开区间 [start, end)（09:00 计高峰、12:00 不计）。",
+      descriptionEn: "Peak hour ranges, half-open [start, end).",
+    },
+  ),
+}, {
+  additionalProperties: false,
+  descriptionZh: "峰谷定价：高峰时段价格 = 平峰 × multiplier（适用所有计费项）。官方定义高峰时段为北京时间每日 9:00-12:00 与 14:00-18:00。",
+  descriptionEn: "Peak pricing; official peak hours are daily 09:00-12:00 and 14:00-18:00 Beijing time.",
+});
+
+/** 单模型价格覆盖（部分覆盖：缺省项回退顶层价格；无 models 键 + additionalProperties:false 天然禁止嵌套） */
+export const modelPriceSchema = Type.Object({
+  inputPerMillion: Type.Optional(Type.Number({
+    exclusiveMinimum: 0,
+    descriptionZh: "输入单价（缓存未命中）。",
+    descriptionEn: "Input price, cache miss.",
+  })),
+  cachedInputPerMillion: Type.Optional(Type.Number({
+    exclusiveMinimum: 0,
+    descriptionZh: "输入单价（缓存命中）。",
+    descriptionEn: "Input price, cache hit.",
+  })),
+  outputPerMillion: Type.Optional(Type.Number({
+    exclusiveMinimum: 0,
+    descriptionZh: "输出单价。",
+    descriptionEn: "Output price.",
+  })),
+  peak: Type.Optional(peakSchema),
+}, {
+  additionalProperties: false,
+  descriptionZh: "单模型价格覆盖：缺省项回退顶层价格。",
+  descriptionEn: "Per-model price override; missing fields fall back to top-level prices.",
+});
+
+/** 价格配置（元/百万 tokens，依据官方定价页 2026-08） */
+export const pricesSchema = Type.Object({
+  inputPerMillion: Type.Optional(Type.Number({
+    exclusiveMinimum: 0,
+    default: 1,
+    descriptionZh: "输入单价（缓存未命中）。环境变量 DEEPSEEK_PRICE_INPUT 可覆盖。",
+    descriptionEn: "Input price, cache miss. Overridable via DEEPSEEK_PRICE_INPUT.",
+  })),
+  cachedInputPerMillion: Type.Optional(Type.Number({
+    exclusiveMinimum: 0,
+    default: 0.02,
+    descriptionZh: "输入单价（缓存命中）。环境变量 DEEPSEEK_PRICE_CACHED_INPUT 可覆盖。",
+    descriptionEn: "Input price, cache hit. Overridable via DEEPSEEK_PRICE_CACHED_INPUT.",
+  })),
+  outputPerMillion: Type.Optional(Type.Number({
+    exclusiveMinimum: 0,
+    default: 2,
+    descriptionZh: "输出单价。环境变量 DEEPSEEK_PRICE_OUTPUT 可覆盖。",
+    descriptionEn: "Output price. Overridable via DEEPSEEK_PRICE_OUTPUT.",
+  })),
+  peak: Type.Optional(peakSchema),
+  models: Type.Optional(Type.Record(Type.String(), modelPriceSchema, {
+    descriptionZh: "按模型覆盖的价格表（key = 模型名，命中优先；整块替换默认表）。",
+    descriptionEn: "Per-model price overrides, keyed by model name.",
+  })),
+}, {
+  additionalProperties: false,
+  descriptionZh: "价格配置，单位：元/百万 tokens。默认值为官方平峰价。",
+  descriptionEn: "Pricing in CNY per million tokens; defaults are the official off-peak prices.",
+});
+
+/** 配置文件结构（所有字段可选，按优先级合并）——单一事实来源 */
+export const configFileSchema = Type.Object({
+  apiKey: Type.Optional(Type.String({
+    minLength: 1,
+    descriptionZh: "DeepSeek API key（必填）。优先级：环境变量 DEEPSEEK_API_KEY > 本字段。",
+    descriptionEn: "DeepSeek API key (required). Env DEEPSEEK_API_KEY takes precedence.",
+  })),
+  baseUrl: Type.Optional(Type.String({
+    default: "https://api.deepseek.com",
+    descriptionZh: "API 基础地址（自建代理时修改）。环境变量 DEEPSEEK_BASE_URL 可覆盖。",
+    descriptionEn: "API base URL; change when using a proxy. Overridable via DEEPSEEK_BASE_URL.",
+  })),
+  model: Type.Optional(Type.String({
+    default: "deepseek-v4-flash",
+    minLength: 1,
+    pattern: "^(?!\\s*$)",
+    descriptionZh: "模型名。Responses API 目前仅支持 deepseek-v4-flash；v4-pro 适配后改这里即切换（价格自动取 prices.models）。环境变量 DEEPSEEK_MODEL 可覆盖。",
+    descriptionEn: "Model name; switch to deepseek-v4-pro once supported. Overridable via DEEPSEEK_MODEL.",
+  })),
+  reasoningEffort: Type.Optional(Type.Unsafe<ReasoningEffort>({
+    type: "string",
+    enum: ["off", "low", "high", "auto"],
+    default: "low",
+    descriptionZh: "推理强度：off 关闭思考（省 token）、low/high 控制思考量、auto 用模型默认行为。环境变量 DEEPSEEK_REASONING_EFFORT 可覆盖。",
+    descriptionEn: "Reasoning effort: off disables thinking; auto uses model default. Overridable via DEEPSEEK_REASONING_EFFORT.",
+  })),
+  maxOutputTokens: Type.Optional(Type.Integer({
+    minimum: 1,
+    default: 4096,
+    descriptionZh: "回答最大输出 token 数。环境变量 DEEPSEEK_MAX_OUTPUT_TOKENS 可覆盖。",
+    descriptionEn: "Max output tokens. Overridable via DEEPSEEK_MAX_OUTPUT_TOKENS.",
+  })),
+  timeoutMs: Type.Optional(Type.Integer({
+    minimum: 1,
+    default: 30_000,
+    descriptionZh: "单次请求超时（毫秒）。环境变量 DEEPSEEK_TIMEOUT_MS 可覆盖。",
+    descriptionEn: "Request timeout in ms. Overridable via DEEPSEEK_TIMEOUT_MS.",
+  })),
+  cacheTtlMs: Type.Optional(Type.Integer({
+    minimum: 1,
+    default: 300_000,
+    descriptionZh: "搜索结果缓存 TTL（毫秒）。环境变量 DEEPSEEK_CACHE_TTL_MS 可覆盖。",
+    descriptionEn: "Search result cache TTL in ms. Overridable via DEEPSEEK_CACHE_TTL_MS.",
+  })),
+  maxResultChars: Type.Optional(Type.Integer({
+    minimum: 1,
+    default: 50_000,
+    descriptionZh: "返回给 LLM 的文本最大字符数（超出截断）。环境变量 DEEPSEEK_MAX_RESULT_CHARS 可覆盖。",
+    descriptionEn: "Max result chars before truncation. Overridable via DEEPSEEK_MAX_RESULT_CHARS.",
+  })),
+  prices: Type.Optional(pricesSchema),
+}, {
+  additionalProperties: false,
+  descriptionZh: "deepseek-web-search 扩展配置文件（.pi/deepseek-web-search.json）。校验规则与运行时一致；峰谷定价按官方文档（北京时间每日 9:00-12:00 / 14:00-18:00，即将执行）。",
+  descriptionEn: "Config file for the deepseek-web-search extension. Peak pricing per official docs (daily 09:00-12:00 / 14:00-18:00 Beijing time, pending).",
+});
+
+/** 配置文件结构类型（由 configFileSchema 派生，单一来源） */
+export type ConfigFileShape = Static<typeof configFileSchema>;
+
+/** 生成某语言版本的 schema 文档（localize 双语注释键 → 标准 description，并补 $schema/title） */
+export function buildSchemaDoc(lang: "zh" | "en"): Record<string, unknown> {
+  const doc = localize(JSON.parse(JSON.stringify(configFileSchema)), lang) as Record<string, unknown>;
+  doc.$schema = "http://json-schema.org/draft-07/schema#";
+  doc.title = `deepseek-web-search config (${lang})`;
+  doc.description = `Generated by pnpm gen:schema from src/config-schema.ts — do not edit. 由 src/config-schema.ts 自动生成，请勿手改。`;
+  return doc;
+}
+
+/** 深度遍历：把 descriptionZh/descriptionEn 映射为标准 description（按语言），删除另一个语言键 */
+function localize(node: unknown, lang: "zh" | "en"): unknown {
+  if (Array.isArray(node))
+    return node.map(item => localize(item, lang));
+  if (node == null || typeof node !== "object")
+    return node;
+  const out: Record<string, unknown> = {};
+  for (const [key, value] of Object.entries(node)) {
+    if (key === "descriptionZh" || key === "descriptionEn") {
+      if (key === (lang === "zh" ? "descriptionZh" : "descriptionEn"))
+        out.description = value;
+    } else {
+      out[key] = localize(value, lang);
+    }
+  }
+  return out;
+}