dsh-llamacpp

DSH PLUGIN浏览器与联网

仓库 jwilson411/dsh-llamacpp

浏览器与联网 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

DSH plugin 将本地 llama.cpp 服务器接入 DeepSeek Harness,通过 OpenAI 兼容 API 提供模型适配,支持流式输出与配置覆盖。

一句话选型结论

按资料字段整理

dsh-llamacpp 是浏览器与联网类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,列出 4 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类浏览器与联网 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-09-01 创建于 2026-08-29
README 6.6 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:jwilson411/dsh-llamacpp
  1. 1
    确认版本与运行环境

    兼容的 DSH 版本为 0.2.0-rc.2 等 7 个;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本0.2.0-rc.2 等 7 个版本版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名未发布到 npm可用 npm view 查看包信息

能做什么

4 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-llamacpp:让 DeepSeek Harness 直接调用本地 llama.cpp 服务器的 LLM 适配器

  • 接入本地 llama.cpp
  • OpenAI 兼容适配
  • 流式输出支持
  • 环境变量配置

上游标签

deepseek-harnessdsh-pluginllama-cpp

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度稳定按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-10-08): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✓ 通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询
— · 其它检查项
  • L4_0_SANDBOX 沙盒安装判定 方式:沙盒安装执行

风险详情

  • 审查结论 通过
  • 结论说明 vet 静态分析未发现可疑行为,判定为干净(clean)。
  • 风险计数 严重 0 / 高 0 / 中 0
  • 风险详情 未发现严重或警告级问题。

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.2.0-rc.2 等 7 个),按版本装不容易报错。
  • 列出了 4 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在浏览器与联网场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-llamacpp当前 L5 · 运行验证通过 低风险 0 0.2.0-rc.2 等 7 个 有
dsh-our-free-model L3 · 安装规范通过 低风险 8,796 未标注 有
dsh-web L3 · 安装规范通过 低风险 8,549 未标注 无
BrowserSkill L4 · 沙盒安装通过 低风险 8,456 未标注 有
dsh-pocket L5 · 运行验证通过 低风险 1,656 0.2.0-rc.2 等 12 个 有
Browser4 L4 · 沙盒安装通过 中风险 1,152 未标注 有

仓库档案

浏览器与联网
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方jwilson411仓库 dsh-llamacpp · 默认分支 main
分类浏览器与联网network
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-08-29 · 2026-09-01最后推送 2026-09-01
本站收录2026-08-29首次进入本站目录的时间

README 全文

6.6 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-llamacpp

A DeepSeek Harness LLM adapter plugin for a local llama.cpp
server, spoken over its OpenAI-compatible /v1/chat/completions API.

This is llama.cpp, not Ollama. It talks to llama-server directly — the binary you build or
download from llama.cpp — and knows nothing about Ollama's model registry, its /api/* routes, or
its automatic model pulls. If you run Ollama, this is the wrong plugin.

It is also not a tool. It registers nothing on ctx.tools; it registers a provider on the
official LLM seam:

ctx.llm.registerAdapter(['llamacpp'], adapter)

Once registered, llamacpp is a provider route like any other, and the harness routes model calls
to it through ctx.llm.stream().

Install

dsh plugin --profile web add github:jwilson411/dsh-llamacpp

The package ships dsh.bundle.patch pointing at cordis.patch.yml, so adding
it inserts a configured llamacpp plugin row into the profile.

Pinned harness RC

Built against 0.1.1-rc.2 of the @deepseek-ai/dsh-* packages — the same RC as
jwilson411/dsh-plugin-kit and jwilson411/dsh-spend-receipt. Note that @deepseek-ai/dsh-llm's
latest dist-tag still points at 0.0.1-rc.1; the RC line lives under the next tag, which is why
the dev dependencies pin exact versions rather than tracking latest.

The seams used are LlmAdapter, LlmError, attributionHeaders, and errorChain from
@deepseek-ai/dsh-llm. If one of those names moves in a later RC, this package stays pinned to
0.1.1-rc.2 until it is updated deliberately.

Running llama.cpp

Start llama-server with the weights you already have. The flags that matter to this plugin:

Flag Why it matters here
--port 8080 The port in the default baseURL (http://127.0.0.1:8080/v1).
--alias qwen The model name the server accepts and this plugin sends. Set it to match model, or set model to match it.
--api-key If set, every request must carry Authorization: Bearer …. Configure apiKey (or DSH_LLAMACPP_API_KEY) to the same value.
-c / --ctx-size The context window. Requests that exceed it fail at the server; this plugin surfaces that failure rather than truncating.

Example:

llama-server -m qwen.gguf --port 8080 --alias qwen -c 32768 --api-key $DSH_LLAMACPP_API_KEY

Offload flags (-ngl, tensor split, and friends) are between you and your hardware — they change
nothing about the wire protocol, so this plugin has no opinion about them.

Configuration

Key Env fallback Default
baseURL DSH_LLAMACPP_BASE_URL http://127.0.0.1:8080/v1
model DSH_LLAMACPP_MODEL qwen
apiKey DSH_LLAMACPP_API_KEY (unset — no Authorization header is sent)
provider — ['llamacpp']

The patch row wins over the environment; the environment fills in whatever the row leaves out. An
exported-but-empty variable counts as unset.

baseURL already includes /v1, and requests go to ${baseURL}/chat/completions — the /v1 is
never doubled. If your server sits behind a proxy that strips the prefix, set baseURL to the base
the proxy actually serves.

Cordis overlay

To point the plugin at a different server, model, or credential, target the llamacpp id in your
profile overlay. An id-targeted patch replaces the whole config object, so repeat every field
you want, not just the one you are changing:

- id: llamacpp
config:
baseURL: http://127.0.0.1:9090/v1
model: qwen3-coder
apiKey: change-me

What it sends

Per model call, one POST ${baseURL}/chat/completions with stream: true. Every request merges
attributionHeaders() from @deepseek-ai/dsh-llm (a User-Agent identifying the harness — a
public product fact, no secrets) and forwards options.signal, so an aborted turn aborts the HTTP
request.

Request mapping:

  • options.system is prepended as a system message.
  • options.messages become OpenAI { role, content } messages; text blocks are concatenated.
  • options.tools become the OpenAI tools array.
  • options.temperature, options.stop pass through.
  • options.maxTokens maps to max_tokens — llama.cpp's server does not read
    max_completion_tokens.
  • options.model is used when the request carries one, otherwise the configured model.

What it yields

The harness StreamChunk protocol, in order:

  1. block-start, index 0, blockType text
  2. one text-delta per choices[0].delta.content string
  3. block-end carrying the full assembled { type: 'text', text }
  4. usage, when the server reported any (prompt_tokens → inputTokens, completion_tokens →
    outputTokens; llama.cpp has no cache split, so no cache fields are invented)
  5. finish, last

A response that produced no text opens no block, so every block-start still has its block-end.

finish_reason maps to { kind: 'stop' }, { kind: 'tool-calls' } for tool_calls, and
{ kind: 'max-tokens' } for length — a truncated answer is not reported as a complete one.

Some builds and proxies ignore stream: true and answer with a single JSON chat.completion. That
is translated into exactly the same chunk sequence.

Failures are loud

Nothing is swallowed into an empty stream. Every failure is an LlmError with a stable code:

Code When
PROVIDER_UNREACHABLE Connection refused, DNS failure, reset mid-stream — usually llama-server is not running.
PROVIDER_HTTP_ERROR Non-2xx answer; carries the HTTP status and quotes the body.
PROVIDER_ERROR The server reported its own failure in-band, as an error payload.
PROVIDER_PROTOCOL_ERROR A stream frame that is not JSON.
UNSUPPORTED_CONTENT A message carried an image, tool-call, or tool-result block.

A caller-driven abort is re-thrown unchanged, so the runtime reports it as an aborted finish
rather than a dead server.

Text only

This is a thin adapter. It sends text and streams text back. Image blocks are refused, not
quietly dropped, because dropping one hands the model a conversation the caller never wrote; the
same holds for tool-call and tool-result blocks, so a full tool round-trip is out of scope here even
though options.tools is forwarded and a tool_calls finish is reported.

Development

npm install
npm test

The tests mock an OpenAI-compatible server with Node's http and node:test. No GPU, no weight
download, no real llama.cpp process, and no network beyond loopback.

License

MIT © 2026 jwilson411

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
dsh-llamacpp 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:jwilson411/dsh-llamacpp` 即可。

dsh-llamacpp 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-llamacpp 安全吗?

低风险。vet 静态分析未发现可疑行为,判定为干净(clean)。

dsh-llamacpp 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-llamacpp 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.0-rc.2、0.2.0-rc.1、0.1.7-rc.2、0.1.6-alpha.2、0.1.6-alpha.1、0.1.5-rc.2、0.1.3-alpha.2。

dsh-llamacpp 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-llamacpp 有哪些功能?

接入本地 llama.cpp、OpenAI 兼容适配、流式输出支持、环境变量配置。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

浏览器与联网
按星标排序,可作替代方案

dsh-our-free-model

dsh-our-free-model

在 DeepSeek Harness 中装上这个 DSH plugin,无需登录、注册或填 API Key,即可直接调用 DeepSeek

L3 · 安装规范通过 8,796 星

dsh-web

dsh-web

侧边栏多列任务看板:卡片交给真实 DSH 智能体会话执行,支持 cron 定时(Host 侧到点执行,关浏览器也生效)。

L3 · 安装规范通过 8,549 星

BrowserSkill

BrowserSkill

BrowserSkill 的 DeepSeek Harness 浏览器自动化桥接插件,通过原生浏览器工具控制可见的 Chrome 和 Edg

L4 · 沙盒安装通过 8,456 星

dsh-pocket

dsh-pocket

DSH Pocket 让 DeepSeek Harness 装进口袋:电脑跑 dsh web,手机扫码即实时同步访问(局域网+公网),人在外

L5 · 运行验证通过 1,656 星

Browser4

Browser4

L4 · 沙盒安装通过 1,152 星

agentrq

agentrq

L4 · 沙盒安装通过 1,140 星

jwilson411 的其它插件

6 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-10-08。