dsh-sensenova-freeapi：非官方 SenseNova 插件介绍

前言¶

DeepSeek Harness (DSH) 采用「一切皆插件」的架构。在接入第三方模型（如 SenseNova）时，渠道限流（429）是常态。多数插件在遇到连续限流时会陷入「全池短路」的死锁，导致服务不可用。

dsh-sensenova-freeapi 是一个非官方的 DSH LLM 提供商插件。它注册了 sensenova 路由，对接 SenseNova 的 OpenAI 兼容 API。该插件通过多账户 API-Key 轮换、运行态/阻塞态双列表状态机等机制，将渠道限流转化为稳定的运行状态，避免因单 Key 失效导致服务中断。

核心功能¶

多账户轮换：支持 1 个默认账户 + 多个额外账户。通过环回轮换和配额类 429 粘性换 Key，分散单 Key 的限流压力。
状态机管理：内置运行态 / 阻塞态双列表。连续限流时 Key 进入阻塞态并退避；401 错误永久禁用 Key；429 错误不冷却、不禁用。
安全性：Key 原文存储在 DSH 凭据服务中，绝不落盘、绝不出境。错误日志中仅记录 Key 的哈希指纹。
监控与诊断：提供错误记录表（异步写入）、当前模型及参数面板、Key 状态管理（相位、strikes、blockedSince 等）。

安装与启用¶

在终端中执行以下命令之一：

# 1. 本地路径安装（推荐用于验证）
dsh plugin --profile <name> add /path/to/dsh-sensenova-freeapi

# 2. GitHub 仓库安装
dsh plugin --profile <name> add github:modesthub/dsh-sensenova-freeapi

# 3. npm 发布后安装
dsh plugin --profile <name> add dsh-sensenova-freeapi

安装完成后，DSH 会自动注册 sensenova 路由。

配置与使用¶

1. 准备工作¶

注册 SenseNova 账号并申请 API Key。
配置默认凭据环境变量：
- SENSENOVA_API_KEY
- https://token.sensenova.cn/v1（base URL）

2. 配置多账户¶

进入 DSH 的 Models 页，在配置面板中设置 accounts[]。该插件支持双账户轮换，建议按账户交替排列 Key（例如 A1, B1, A2, B2），以降低单账户触顶概率。

3. 推荐模型¶

deepseek-v4-flash：日常、代码、Agent 处理的首选。
sensenova-6.8-flash-lite：读图/视觉任务的首选，搭配 dsh-sensenova-vision-aid 插件使用。
注意：不建议使用 deepseek-flash（V4.1 版本）。

适用场景与注意事项¶

适用场景：需要稳定调用 SenseNova 模型的开发者，或希望处理高频 429 错误以保持服务连续性的场景。
非官方声明：本插件由社区维护，与 DeepSeek / 幻方无官方从属关系。
功能裁剪：登录流程、用量面板、套餐窗口、命令行工具等功能已被裁剪。
Key 管理：Key 仅存储在 DSH 凭据服务中，不写入本地文件。
限流认知：SenseNova 的 429 限流是常态，不代表账号异常。遇到 429 时，插件会自动进行 Key 轮换或进入阻塞等待状态。

总结¶

dsh-sensenova-freeapi 解决了第三方模型接入中常见的限流与死锁问题。通过精细化的 Key 状态管理和自动轮换机制，它能让 DSH 在高并发限流环境下保持稳定运行。

更多详情可参考：GitHub | 插件目录