@goodandready/dsh-model-sync

modeltested: passnpmMIT

Synchronizes the model catalog of API-key providers from the provider itself instead of maintaining the model list by hand.

下载量 / Downloads

4,383

依赖体积 / node_modules

11.79 MB

测试时间 / Tested

2026-11-06

DSH 版本 / Version

0.2.2-rc.1

Install

dsh plugin --profile web add @goodandready/dsh-model-sync

Sandbox test results

Stage	Result
1 install	✓
2 list	✓
3 mount	✓
4 boot	—

Four stages run in an isolated sandbox: install (network on) → list → mount → boot (last three with no network).

README

📦 @goodandready/dsh-model-sync

<h3>面向 DeepSeek Harness 的动态大模型目录同步与自动化余额监控插件</h3>

</p>

</p>

<a href="README.md"><b>🇬🇧 English</b></a> •

<a href="README.ru.md"><b>🇷🇺 Русский</b></a> •

</p>

<tr>

⭐ <strong>如果您喜欢这个插件，请在 GitHub 上为它点亮 Star</strong> — 这能让我知道插件对您有用，并鼓励我继续开发和维护它。

🐛 <strong>如果您发现 Bug 或希望增加功能</strong>，请使用任意语言在 GitHub 上提交 Issue — 我会评估您的建议，并在后续版本中实现有价值的改进。

</td>

</tr>

</table>

</div>

⚡ 插件概览

dsh-model-sync 保持您的 DeepSeek Harness 模型目录与上游各大 AI 服务商最新发布完全同步。

每当服务商推出新模型、调整上下文窗口上限或变更费率时，不再需要手动逐项编辑 YAML 配置文件。dsh-model-sync 能够自动发现新版本、更新模型能力元数据（vision、tools、reasoning、embeddings）、监控账户余额并在无需重启服务的情况下即时对齐模型目录。

graph LR
    subgraph Trigger [调度与手动触发]
        Cron[⏰ 后台轮询调度器] --> Engine[dsh-model-sync 核心引擎]
        WebUI[🖥️ 设置面板: 立即同步按钮] --> Engine
    end

    subgraph Providers [25+ 上游服务商]
        Engine --> Registry{适配器注册中心}
        Registry -->|Bearer 认证| P1[OpenAI / DeepSeek / OpenRouter / Groq]
        Registry -->|x-api-key 认证| P2[Anthropic Claude / 自定义网关]
        Registry -->|query-key 认证| P3[Google Gemini]
        Registry -->|本地探测| P4[本地 Ollama / vLLM / SGLang]
        Registry -->|CommandCode 接口| P5[Command Code / visibleModels]
        Registry -->|套餐检测| P6[ClineBot 订阅套餐]
    end

    subgraph Reconcile [目录对齐与审计追踪]
        P1 --> Normalizer[模型标准化器与能力打标]
        P2 --> Normalizer
        P3 --> Normalizer
        P4 --> Normalizer
        P5 --> Normalizer
        P6 --> Normalizer
        Normalizer --> Diff[差异跟踪: 新增 / 已废弃]
        Diff --> Catalog[当前可用 DSH 模型目录与 visibleModels]
    end

    style Trigger fill:#1e1e2e,stroke:#89b4fa,stroke-width:2px,color:#cdd6f4
    style Providers fill:#181825,stroke:#cba6f7,stroke-width:2px,color:#cdd6f4
    style Reconcile fill:#11111b,stroke:#a6e3a1,stroke-width:2px,color:#cdd6f4

✨ 核心特性

🏷️ 智能集合与模型自动标签：同步时自动识别并标记模型分类标签（coding 编程、reasoning 思考推理、fast 极速轻量、vision 多模态、long-context 128k+ 长上下文），支持 UI 药丸胶囊快速筛选与一键精选顶级旗舰预设（"⭐ 精选最佳"）。
⚡ 延迟雷达 (TTFT) 与火花线可视化：实时测量模型响应时间与首字延迟 (TTFT)，提供火花线走势（ ▂▃▂ ）及 4 档速度徽章（⚡ < 300ms、🟢 < 1.2s、🟡 1.5 - 3.0s、🔴 > 3.0s），并开放 GET /dsh-model-sync/health/latency 路由接口。
💸 实时价格动态后台同步与提示词缓存：定期从 OpenRouter 和 LiteLLM 获取最新模型单价，支持本地磁盘降级缓存，支持提示词缓存读写定价（cacheReadPerToken、cacheWritePerToken），并提供 GET /dsh-model-sync/pricing 和 POST /dsh-model-sync/pricing/sync 端点。
💰 内置基准价格数据库：自动为 OpenAI、Anthropic、Groq、Mistral、xAI 和 DeepSeek 模型补充 Token 价格数据，即使服务商接口未返回价格，也可无缝支持成本上限过滤与 @cheap 别名解析。
🎯 动态智能虚拟别名与故障转移：支持 @fast、@cheap、@best-code 等虚拟别名及故障转移链，在熔断器打开或健康检查失败时自动切换至备用模型。
📏 真实上下文限制与边界安全 (contextWindow / maxOutputTokens)：精确区分输入与输出令牌限制，通过自动限制防止 400 max_tokens 错误，并在 Web UI 中显示 输入: 128k | 输出: 8k 徽章。
🧠 统一的深度思考与推理配置 (Reasoning & Thinking)：自动检测参数格式 (effort, budget_tokens, boolean) 并转换推理预算，自动屏蔽不兼容参数（如 o1/o3 的 temperature）。
🔔 外部差异通知 Webhook 与事件分发：支持 HMAC-SHA256 签名验证的实时 Webhook 通知与 Cordis model-sync/diff 事件，可在新模型上线、模型废弃或价格变更时即时推送。
⚡ 高性能模型策略过滤：在未配置过滤策略时，filterModels 采用快速路径直接返回模型目录，避免不必要的正则表达式编译和数组遍历。
🔄 一键检查与更新：内置设置面板更新检查，在手动刷新时通过 ?fresh=1 或 Cache-Control: no-cache 绕过 npm 缓存，即时获取最新版本。
🔄 自动化目录同步：自动对齐 25+ 服务商的模型清单、别名、上下文窗口及能力标签（vision、tools、reasoning、embeddings）。
🛡️ Minijinja 聊天模板与角色兼容性保障：自动为 Groq 开源模型（Qwen、Llama、Mistral、Gemma、DeepSeek）及 DeepSeek API 注入 compat.supportsDeveloperRole: false，避免推理模型报 400 Unexpected message role 错误，同时保留用户自定义配置。
🌐 内置 25+ 服务商适配器：预置支持 OpenAI、Anthropic、Google、DeepSeek、xAI、OpenRouter、Groq、Mistral、Cerebras、Fireworks、HuggingFace、Moonshot、NVIDIA、Qwen、Together、Xiaomi MiMo、SiliconFlow、Command Code、ClineBot 以及本地 Ollama。
🎛️ Command Code 模型精细管理：完整发现 Command Code 模型目录，在 Web 界面提供勾选过滤，自动同步 visibleModels 至 llm-commandcode 设置中。
🎯 ClineBot 订阅套餐精准匹配：专属适配器直接调用 GET /users/me/plan，只拉取当前有效订阅套餐包含的模型，彻底解决全量拉取 400+ 外部模型导致的混淆。
🔌 通用与自定义适配器扩展：支持接入任意兼容 OpenAI /v1/models 规范的网关，支持多种认证方式（bearer、x-api-key、query-key、none）。
📊 余额与用量监控：实时查询上游计费端点，精准反馈账户额度并防止因欠费导致任务中断。
📜 同步历史与变更审计：完整记录新模型上线、旧模型废弃及能力变更的时间线与详细差异。
🖥️ 全功能 Web 管理面板 (设置 → 模型同步)：
每个服务商的卡片化状态展示与模型计数；
一键即时同步（Sync Now）；
模型勾选过滤与显示控制；
服务商启用开关及自定义 Endpoint 地址输入。

🛠️ 支持的服务商列表

服务商标识符 · 认证机制 · 能力自检与特性说明

openai · Bearer Token · vision, tools, reasoning, embeddings

anthropic · x-api-key 请求头 · vision, tools, reasoning

google · Query 参数 / 密钥 · vision, tools, reasoning, embeddings

deepseek · Bearer Token · tools, reasoning

xai · Bearer Token · vision, tools, reasoning

openrouter · Bearer Token · 多厂商汇聚模型目录，包含计费与上下文规格

groq · Bearer Token · tools, reasoning, vision, supportsDeveloperRole: false

mistral · Bearer Token · tools, reasoning, vision

commandcode · Bearer Token · 对接 https://api.commandcode.ai/provider/v1/models，同步勾选至 llm-commandcode 的 visibleModels

…(truncated)

Rendered from the README published on npm. Formatted only, not edited.

Versions

Published on npm:：70，最后更新 2026-11-05

Links

GitHub · Homepage · npm

@goodandready/dsh-model-sync

Install

Sandbox test results

README

📦 @goodandready/dsh-model-sync

⚡ 插件概览

✨ 核心特性

🛠️ 支持的服务商列表

Versions

Links

Same category