dsh-freebuff 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；基本兼容但装前注意：未发布到 npm registry，仅可从源码安装

dsh-freebuff 兼容性怎么样？

基本兼容但装前注意：未发布到 npm registry，仅可从源码安装

dsh-freebuff 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-freebuff 还在维护吗？

GitHub 6 星。最近一次上游提交在 2026/8/17。

免费额度接入 liceses/dsh-freebuff

DeepSeek Harness

liceses79 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

把 Freebuff 免费模型额度接进对话界面

30.3/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/9/27 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

自动兼容检查有告警：未发布到 npm registry，仅可从源码安装。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add liceses/dsh-freebuff

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：已验证

是什么[目录]—

dsh 原生插件 · other

暂无时间戳·判据 →

装得上吗[实装验证]✓

本站已真实安装成功

非静态推断

L4 · 真实安装等级说明 →

数据截至 2026/09/27·判据 →

安全吗[自动扫描]—

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

数据截至 2026/11/04·判据 →

还在维护吗[仓库]—

更新放缓：最近一次提交在 79 天前

暂无时间戳·判据 →

图例：✓ 通过! 需注意— 未判定 / 无数据· 「未判定」= 本站尚无数据，不代表插件有问题

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

可信度证据

安装兼容性检查⚠ 装前注意

未发布到 npm registry，仅可从源码安装

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✗npm 包dsh-freebuff（未发布到 npm，仅可源码安装）

✓Node 引擎要求 >=20 · 基线 Node 22.19 满足

✓dsh CLI 依赖未声明 dsh 版本约束

✓入口文件main/exports/bin 已声明

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/7 10:39:38

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

可执行外部命令读写/删除本地文件发起外部网络请求

查看扫描证据（共 16 处，展示前 16 条）

发起网络请求
lib/client.js:39
return await (await fetch("/freebuff/api" + path, {
发起网络请求
lib/adapter.js:73
const iterator = this.request(options, watchdog.signal, connection)[Symbol.asyncIterator]();
读取本地文件
lib/credentials.js:37
const raw = JSON.parse(await readFile(file, 'utf8'));
执行外部命令固定命令
lib/proxy-source.js:53
execFile('reg', ['query', key, '/v', name], { timeout: 3000, windowsHide: true }, (error, stdout) => {
发起网络请求
lib/tunnel.js:73
const connectReq = http.request({
发起网络请求
lib/tunnel.js:92
activeReq = https.request({
发起网络请求
lib/tunnel.js:107
activeReq = http.request({
发起网络请求
lib/tunnel.js:117
activeReq = transport.request({
发起网络请求
src/adapter.ts:116
const iterator = this.request(options, watchdog.signal, connection)[Symbol.asyncIterator]()
发起网络请求
src/client.ts:57
const response = await fetch('/freebuff/api' + path, {
读取本地文件
src/credentials.ts:48
const raw = JSON.parse(await readFile(file, 'utf8')) as Record<string, unknown>
执行外部命令固定命令
src/proxy-source.ts:49
execFile('reg', ['query', key, '/v', name], { timeout: 3000, windowsHide: true }, (error, stdout) => {
发起网络请求
src/tunnel.ts:86
const connectReq = http.request({
发起网络请求
src/tunnel.ts:105
activeReq = https.request({
发起网络请求
src/tunnel.ts:119
activeReq = http.request({
发起网络请求
src/tunnel.ts:128
activeReq = transport.request({

扫描于 2026/11/4（0 天前） · 范围入口闭包 + 发布文件清单 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块

@deepseek-ai/cordis@deepseek-ai/dsh-anonymous-user-id@deepseek-ai/dsh-llm@deepseek-ai/dsh-settings@deepseek-ai/dsh-timeout@deepseek-ai/schemastery

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

功能亮点

接入免费模型额度

README

由 DeepSeek 最新模型翻译生成

dsh-freebuff 将 freebuff（CodebuffAI 的免费 AI 助手）的免费 DeepSeek V4 Flash 额度，以 DSH 模型提供方（provider）的形式接入 DeepSeek Harness —— 在 Web 的模型设置页里直接选用 Freebuff 提供商，免费对话。 ⚠️ 风险声明：本项目逆向并代理了 freebuff 的桌面/CLI 协议，违反 freebuff 服务条款（ToS）。存在账号封禁（终态、不可恢复）风险。仅供个人学习与测试使用，请勿商业化、勿大规模滥用，使用者自行承担全部后果。工作原理 freebuff 官方没有公开 API，只有 CLI / Desktop / Chat。本插件在 DSH 进程内重实现官方客户端的 HTTP 协议（协议事实，非代码搬运）： session(POST /api/v1/freebuff/session) → agent-runs(START 主 agent + context-pruner) → chat/completions(强制流式 SSE) 并实现 @deepseek-ai/dsh-llm 的 LlmAdapter，注册为 ctx.llm 的 freebuff 提供商。DSH 对话/会话标题/上下文压缩全部走流式，天然契合上游强制流式。

展开完整文档（README 剩余 1 节）

dsh-freebuff

将 freebuff（CodebuffAI 的免费 AI 助手）的免费 DeepSeek V4 Flash 额度，以 DSH 模型提供方（provider）的形式接入 DeepSeek Harness —— 在 Web 的模型设置页里直接选用 Freebuff 提供商，免费对话。

⚠️ 风险声明：本项目逆向并代理了 freebuff 的桌面/CLI 协议，违反 freebuff 服务条款（ToS）。存在账号封禁（终态、不可恢复）风险。仅供个人学习与测试使用，请勿商业化、勿大规模滥用，使用者自行承担全部后果。

工作原理

freebuff 官方没有公开 API，只有 CLI / Desktop / Chat。本插件在 DSH 进程内重实现官方客户端的 HTTP 协议（协议事实，非代码搬运）：

session(POST /api/v1/freebuff/session) → agent-runs(START 主 agent + context-pruner) → chat/completions(强制流式 SSE)

并实现 @deepseek-ai/dsh-llm 的 LlmAdapter，注册为 ctx.llm 的 freebuff 提供商。DSH 对话/会话标题/上下文压缩全部走流式，天然契合上游强制流式。

安装

前提：已安装 DeepSeek Harness，Node ≥ 20，PATH 中有 dsh 与 pnpm。

方式 A：GitHub 直装（推荐，零构建）

1) 从 GitHub 安装依赖（仓库内已带编译产物 lib/，无需构建）
dsh plugin --profile web add github:liceses/dsh-freebuff

2) 写入 bundle 装配（幂等）+ 打印重启指引
node /scripts/install.mjs --profile web
或手动：把 "dsh-freebuff" 加进 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles

3) 重启 dsh web

dsh plugin add 会把参数转发给 profile 目录里的 pnpm：安装本包并自动解析全部 @deepseek-ai/* peer 依赖（已用 pnpm 11 实测：+13 依赖，加载验证通过）。若 registry 下载报错（UND_ERR_DESTROYED 等），给 pnpm 显式指定代理：

dsh plugin --profile web add github:liceses/dsh-freebuff --proxy http://127.0.0.1:10808 --https-proxy http://127.0.0.1:10808

scripts/install.mjs 用法：node scripts/install.mjs [--profile ] [--tgz ]（自动把 dsh-freebuff 幂等写入 dsh.profile.bundles）。
包内的 dsh.bundle.patch 指向 cordis.patch.yml，装配时会自动插入 llm-freebuff 插件行。

方式 B：克隆构建（自编译 / 二次开发）

git clone https://github.com/liceses/dsh-freebuff
cd dsh-freebuff
npm install
npm run build # 产出 lib/ 与 dsh-freebuff-.tgz

用构建出的 tgz 安装：
dsh plugin --profile web add ./dsh-freebuff-0.1.0.tgz
node scripts/install.mjs --profile web

方式 C：注入式开发（本机 dsh-super-injector 环境）

npm install
npm run build
dev_inject_plugin

安装后

1. 重启 dsh web
2. 打开 Web 模型设置页 → 提供商 Freebuff → deepseek/deepseek-v4-flash
3. 发一条消息验证（无需额外配置：凭证自动复用官方 CLI 的 ~/.config/manicode/credentials.json；或按下方「账号配置」三选一）

排障

| 现象 | 处理 |
| 请求失败 ECONNREFUSED | 看日志中 llm-freebuff: upstream proxy source=... url=... 行确认走的是哪个代理；系统残留 HTTPS_PROXY 可能导致走错端口 → 在 设置 → Freebuff → upstreamProxy 显式填写（如 http://127.0.0.1:10808） |
| MISSING_CREDENTIAL | 未找到账号：设置里填 accounts，或导出 FREEBUFF_TOKEN，或用官方 CLI 登录 |
| 提示账号被 ban / 额度耗尽 | 免费账号额度按「session」计（标准池每天 6 次、1 小时/次）；该账号被冷却 retryAfterMs；改用多账号（FREEBUFF_TOKEN 逗号分隔） |
| 免费模型须 US 出口 IP | 确保代理节点在完整模式国家；否则为受限模式（每天 6 个 session） |

卸载

dsh plugin --profile web remove dsh-freebuff # 移除依赖
并把 dsh-freebuff 从 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 中删掉

账号配置（三选一，按优先级）

1. 插件设置：设置 → Freebuff → accounts（{token, email?} 数组；界面自动生成）
2. 环境变量：FREEBUFF_TOKEN=tok1,tok2（逗号分隔多账号）
3. 自动读取官方 CLI 凭证：默认读取 ~/.config/manicode/credentials.json（本机若装过 freebuff CLI 并登录过，开箱即用）

Token 获取：运行官方 CLI 登录后自动写入 ~/.config/manicode/credentials.json；或参考 research/freebuff2api/freebuff_tools/extract_freebuff.py 的设备码流程。

配置项（Settings > Freebuff，llm-freebuff）

| 字段 | 默认 | 说明 |
| accounts | [] | 显式 token 列表（优先于 env/文件） |
| tokenEnv | FREEBUFF_TOKEN | 环境变量名 |
| tokenFile | ~/.config/manicode/credentials.json | CLI 凭证文件 |
| baseURL | https://www.codebuff.com | 上游地址 |
| upstreamProxy | '' | 显式 http(s) 代理；空 = 自动读 DSH_PROXY_HTTPS → HTTPS_PROXY → HTTP_PROXY。免费模型要求 US 出口 IP，请确保代理节点在完整模式国家 |
| models | 5 个官方模型 | 目录（id/session/agent/contextWindow/maxTokens） |
| maxTokens / defaultContextWindow | 65536 / 393216 | 输出上限与上下文窗口 |
| reasoningEffort | high | 默认推理档位（flash 支持 low/high/max） |
| streamIdleTimeoutMs | 300000 | 流空闲超时 |
| retryPolicy | — | 重试策略 |

默认模型

| 模型 | 上游 agent | 额度池 |
| deepseek/deepseek-v4-flash | base2-free-deepseek-flash | 非 Premium（STD 池，每天 6 次 session，1 小时/次） |
| deepseek/deepseek-v4-pro | base2-free-deepseek | Premium 池 6 次/天 |
| minimax/minimax-m3 | base2-free-minimax-m3 | Premium 池 6 次/天 |
| openai/gpt-5.6-luna | base2-free-luna | Premium 池 6 次/天 |
| mimo/mimo-v2.5 | base2-free-mimo | 非 Premium（STD 池） |

配额按「创建 session」扣减：一个 session 约 1 小时，期内多轮对话不重复扣；插件复用活跃 session，不浪费额度。多账号（FREEBUFF_TOKEN 逗号分隔）自动轮换 + 冷却。

注意事项 / 已知限制

- 单账号同时只能一个在线客户端：插件内全局串行队列 + 每账号流锁，避免顶号（428 waiting_room_required / 409 session_superseded）。
- 免费通道对并发敏感：上游短请求 300ms 间隔串行。
- OpenRouter 式并发桶：Flash/MiMo 每用户最多 3 个并发 tab —— DSH 单会话串行已天然满足。
- 上游 system 消息必须以 You are Buffy, the strategic coding assistant. 开头（插件自动注入前缀，不影响 harness 提示词）。
- 工具调用：自动混入官方 end_turn 签名工具，规避 foreign_toolset 校验。
- 账号被封（status: banned）为终态，插件会以 AUTH 错误提示。

冒烟测试

UPSTREAM_PROXY=http://127.0.0.1:10808 node test/smoke.mjs "Reply with exactly: OK"
通过 = session/agent-runs/chat 全链路可用（会占用一次 session 额度）

许可与免责

Apache License 2.0。代码为独立实现：协议事实来源于官方 CodeBuffAI/freebuff 源码（MIT）与社区 freebuff2api-wokers（AGPL-3.0，仅作协议对照、未复制代码；参考代码不入库）；DSH 适配结构参考官方 @deepseek-ai/dsh-llm-deepseek（MIT）。详细调研见 docs/调研报告.md。

风险与合规：本项目逆向并代理了 freebuff 的桌面/CLI 协议，违反 freebuff 服务条款（ToS），存在账号封禁（终态、不可恢复）风险。本项目按 Apache-2.0 的免责条款以 "AS IS" 提供，不提供任何担保，作者对任何账号损失、法律纠纷或使用后果不承担任何责任。请仅供个人学习研究使用，切勿商业化或大规模滥用。