DeepEtherProxy

把 DeepSeek 网页版接成 MaiBot 的一个 LLM Provider，以 MaiBot 第三方插件 形式提供 （plugins/deepether-proxy/），不修改 MaiBot 主程序。

定位：省群聊 token 的补充通道，不是官方 API 的替代品。 一期只接 replyer + utils（纯文本、不吃工具调用）；planner 仍走官方模型。

快速开始

1. 从 Releases 下载最新版 deepether-proxy-<version>.zip

2. MaiBot WebUI → 插件页 → 上传 zip 安装 → 重启一次 MaiBot

3. WebUI → 插件 → DeepEther Proxy → 凭证，填入网页版 token：

   // 浏览器登录 chat.deepseek.com 后，F12 → Console 执行
   copy(JSON.parse(localStorage.getItem('userToken')).value)

4. 聊天里发 /deepether-status，看到「凭证：已就绪」即完成

插件加载时会自动把服务商与两个模型写进 config/model_config.toml 并接好任务列表， 不需要手动改配置（详见下文「自动注册」）。完整安装/授权/排查见 插件 README。

能力边界

能做	说明
replyer / utils 文本生成	纯文本、不需要工具调用；含思考内容回传
反封禁节奏控制	串行 + 抖动间隔 + 三级配额 + 会话复用 + 指纹自洽，详见 docs/ANTIBAN.md

做不到	原因
planner 工具调用	网页版没有 function calling；插件只能"翻译"调用请求，不能替宿主执行工具
视觉 / embedding / 语音	网页版没有对应接口，请把这三类任务指向官方模型
逐字流式	Host 侧插件 Provider 不支持流式回调，插件内部读完 SSE 后整体返回

文档

文档	内容
plugins/deepether-proxy/README.md	安装、授权、配置、排查（用户向）
plugins/deepether-proxy/docs/upstream-protocol.md	网页版协议实测记录（与文档的差异、混合帧 SSE、PoW 细节）
docs/FEASIBILITY.md	可行性分析报告：结论、能力差距、架构取舍、实施路线（§6.7 已被取代）
docs/TASK-SUITABILITY.md	各模型任务适配性：哪些能接、哪些永远别接（0.3.1 源码核查）
docs/SESSION-REUSE.md	网页版会话上下文复用的可行性分析（0.4 候选：同会话续聊，减少新建聊天）
docs/ANTIBAN.md	反封禁设计：封禁分层模型、措施矩阵、默认值依据、实现落点、排查对照表
docs/P2-ACCEPTANCE.md	P2 稳定性验收演练（0.2.x 历史：并发闸门、PoW 并发缺陷修复等）
CHANGELOG.md	版本更新记录

先看结论：docs/FEASIBILITY.md —— 技术可行，但 "反代网页版 = 拿到 DeepSeek 全部最新能力"不成立，核心缺口是工具调用（function calling）， 而它正是 MaiBot planner 的命脉。

自动注册（0.3.1）

装好插件、启动 MaiBot 即可，不用手改 model_config.toml：插件加载时会自动写入

• 服务商 deepether（client_type = com.ether.deepether、auth_type = none、timeout = 300、 max_retry = 1）：让 MaiBot 的模型调度与其它模型一致
• 两个模型：deepether-replyer（口语化风格、不思考）、deepether-utils（不思考）
• 把 deepether-replyer / deepether-utils 接到 replyer / utils 的 model_list 首位，并把 selection_strategy 固定为 sequential（只有按顺序优先才会先走网页版）

planner 需要工具调用（function calling），网页版做不到，因此不注册、也不接线；planner 继续用官方模型。

wire_tasks 可选纯文本任务（memory / mid_memory / fast_model / learner，都复用 deepether-utils 这一条模型）， 但 planner 需要工具调用、emoji 需要视觉，写进去会被忽略；详见 docs/TASK-SUITABILITY.md。

接线方式由插件配置 behavior.mode 决定：

behavior.mode	自动注册做什么
web_first（默认）	接线到任务 model_list 首位（网页版优先）
official_only	不接管网页版（自动注册把 deepether-* 模型移出任务 model_list）
web_only	已废弃，行为等同 web_first

自动注册结果里若提示「该任务 model_list 只有 deepether 模型」，按提示在该任务末尾补一个官方模型即可。

Host 对 model_config.toml 有文件监视 + 热重载，写完立即生效、不用二次重启。 写入前自动备份（最多 5 份），内容无变化时不落盘，避免反复触发热重载。 手动重跑用 /deepether-setup；关掉自动写入用插件配置 [provision] enabled = false。

反封禁（0.2.3）

上游账号因"行为特征"被风控是这套方案最大的运行风险（本项目实测被封过 3 天）。0.2.3 起把 "让这个账号看起来像一个人在正常用"做成可配置能力，完整设计见 docs/ANTIBAN.md：

• 节奏：同 token 串行（并发 1）+ 每次间隔 8~20 秒随机抖动，不是固定间隔
• 配额：3/分 · 30/时 · 200/天 三级滑动窗口，超限时本次调用直接失败（与其它模型失败一样由 MaiBot 调度处理）
• 冷却：429 → 静默 15 分钟；疑似封号 → 6 小时；连续 3 次风控信号升级长冷却，成功一次折半恢复
• 会话复用：同一上游会话连续用 8 次再换，避免"一堆一句话会话"这种机器特征
• 指纹自洽：补齐真实浏览器的 Accept-Language / sec-ch-ua* / sec-fetch-*；装了 h2 自动走 HTTP/2； 不伪造 x-client-* 私有头（取值随前端漂移，写错比不带更可疑）
• 状态可见：/deepether-status 的「反封禁节奏」段落给出间隔、用量、冷却剩余； 状态落盘到 runtime_dir/antiban_state.json，重启不重置配额、也不重算冷却

仓库结构

plugins/deepether-proxy/   插件本体（plugin.py + _manifest.json + deepether/ + tests/）
docs/                      设计与验收文档
scripts/build_package.py   打包脚本：读 _manifest.json 的 version → dist/<name>-<version>.zip

本地开发与测试

git clone https://github.com/Eetherrr/DeepEtherProxy.git
cd DeepEtherProxy/plugins/deepether-proxy
pip install maibot-plugin-sdk pytest httpx wasmtime deepseek-pow tomlkit
python -m pytest -q          # 当前：151 passed, 4 skipped
python ../../scripts/build_package.py   # 生成 dist/deepether-proxy-<version>.zip

把 plugins/deepether-proxy 放进 MaiBot 的 plugins/ 目录（开发期可用目录联接）即可联调。

版本基线

组件	版本
MaiBot	1.3.11
maibot-plugin-sdk	2.12.0
Python	3.12

免责声明

通过逆向网页版接口提供模型能力通常违反服务条款，可能导致账号限流或封禁。 本项目的反封禁措施只能降低概率，不能保证账号安全；本项目仅限个人学习与技术研究， 请自行评估风险。需要稳定合规的模型服务，请使用 DeepSeek 官方开放平台。