前言¶
在 DeepSeek Harness（DSH）里做智能体或 Web 对话，模型来源通常要自己配 API Key、计费账号，或维护本地推理栈。若你只想在 DSH 模型选择器里换一组可用模型、又不愿先绑信用卡，社区里会出现另一条路：把第三方「广告资助的免费推理」接成 DSH 的 provider 插件。
下面介绍维护者 wawaTuna 发布的 dsh-free-pi（npm 包名 dsh-free-pi，GitHub：wawaTuna/dsh-free-pi）。它把 free-pi 的 OpenAI 兼容端点注册进 DSH，通过一次 GitHub 登录拿到 JWT，无需自备 API Key。资料中称当前可免费、不限量使用 DeepSeek V4.1 Flash、DeepSeek V4 Flash、GLM 5.3 Flash、Particle 等（以 free-pi 线上目录为准，会变动）。分类上属于 模型推理 类 DSH 插件。
这是什么¶
dsh-free-pi 是 DSH 的 provider 插件：在进程内注册 free-pi 适配器，向 DSH 暴露一组可从模型选择器选用的模型。上游为 POST https://api.freepi.ai/v1/chat/completions，由 JWT、x-session-id、x-client-version 等头做鉴权；插件不额外监听本地端口。
插件版本（package.json）为 0.2.2，许可证 MIT。运行环境要求 Node ^22.19.0 || >=24.0.0。仓库说明标明：非 free-pi、DeepSeek 或模型方的官方产品。
核心功能¶
依据 README 与 package 描述，可核对的能力如下。
- Free Unlimited 模型：资料列举 DeepSeek V4.1 Flash、DeepSeek V4 Flash、GLM 5.3 Flash、Particle 为 free-pi 标记的 Free Unlimited，不计入个人预算（促销性质，可能随时调整）。
- 按日预算的计量模型：其余模型按账户每日 15,000 credits（约 1.125 美元）扣费，UTC 00:00 重置；目录中的计量模型按上游成本与倍数扣 credits。
- 活目录：模型列表从 free-pi 目录接口刷新，增删模型不必改插件版本。
- 多账户轮询：可将多个 GitHub 账户写入
~/.free-pi/agent/accounts.json（与credentials.json并列），插件按配额做 round-robin；流式请求中途不换账户。 - 配置项：
jwt（可选单 token）、hiddenModels（隐藏选择器中的模型 id，热生效）。
安装与启用¶
插件面向 web profile。安装步骤以仓库 Quick start 为准。
1、安装插件
dsh plugin --profile web add github:wawaTuna/dsh-free-pi
当前 DSH 会从包元数据注册 bundle。可用下面命令确认配置里出现 # == dsh-free-pi 段，然后重启 dsh-web：
dsh --profile web --dump-config
2、登录 free-pi
登录即表示接受 free-pi 条款（含隐私与数据使用，见文末「适用场景与注意」）。任选一种方式写入凭证（权限 0600）：
npx free-pi-cli@latest
凭证默认路径：~/.free-pi/agent/credentials.json。也可在插件配置里设 jwt，或设置环境变量 FREEPI_JWT。README 说明 token 在每次请求时重读，重新登录后不必重启 DSH。
3、验证
在模型选择器的 free-pi 分组中选 DeepSeek V4.1 Flash，发送一条消息即可完成冒烟验证。
典型用法¶
单账户日常对话¶
完成「安装 → 登录 → 重启 web → 选 free-pi 模型」后，用法与 DSH 其他 provider 相同：在 Web 界面选模型、正常对话。计量模型消耗当日 credits；Free Unlimited 条目按 free-pi 当前策略不计预算。
隐藏部分模型¶
若不想在选择器里看到某些 id，可在插件配置中设置 hiddenModels（无需重启）。
多账户与配额查看¶
在 free-pi-plugins monorepo 中可用：
node core/login.mjs --label work
为池内增加第二个 GitHub 账户。两账户时，计量模型日额度约为 2 × 15,000 credits。查看余额可在同 monorepo 运行 node core/quota.mjs；README 亦提到兄弟项目 magpie-free-pi 的 magpie quota 可展示同类数据。
Token 有效期约 90 天；过期后用原登录方式重新登录即可。
适用场景与注意¶
适合谁：已在用 DSH Web、愿意用 GitHub 登录 free-pi、并接受其商业模式（广告资助 + 会话数据用于训练等条款）的开发者；想快速试用 DeepSeek V4.1 Flash 等 Free Unlimited 模型，或在不买主站 API 的情况下用计量模型凑日额度。
运行与信任边界：插件以当前 dsh 进程权限 运行，会读取本机 ~/.free-pi/agent/ 下凭证并向外网 api.freepi.ai 发请求。安装前建议自行查阅 GitHub 仓库 源码与 MIT 许可证；勿在未审阅的情况下在生产敏感代码库上登录。
隐私：README 明确 free-pi 除广告外会对会话（提示、代码、文件、模型回复）留痕并可能用于训练或第三方共享；广告侧会收到近期对话摘录。完整条款见 https://freepi.ai/terms 。仅在你能接受该交换的对象与代码上使用。
稳定性：后端主要服务 free-pi 官方终端客户端；本插件走相同协议，但 free-pi 可能加强校验（例如要求实时广告会话）。Free Unlimited 非永久承诺。
生态说明：DSH 奉行「一切皆插件」；SkillHub 目录页 为社区收录，与 DeepSeek / 幻方无官方应用商店从属关系。
结尾¶
dsh-free-pi 把 free-pi 的 JWT 鉴权推理接到 DSH 的 free-pi 模型组：一条官方安装命令、一次 GitHub 登录，即可在 Web 端选用 DeepSeek V4.1 Flash 等模型，并可选多账户轮询扩展计量额度。
- 目录页：https://www.skillhub.cn/plugins/wawaTuna/dsh-free-pi
- 源码与文档：https://github.com/wawaTuna/dsh-free-pi
