builder-hud 有中文文档吗？

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

builder-hud 还在维护吗？

GitHub 1 星。最近一次上游提交在 2026/10/8。

魂系状态栏 tony1duan/builder-hud

Q: builder-hud 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；暂不能直接安装（需源码编译或环境不满足）：仓库根目录无 package.json，浅层子目录有 2 份 dsh 插件清单（plugins/builder-hud/package.json、plugins/souls-hud/package.json），无法唯一定位安装名。

Q: builder-hud 兼容性怎么样？

暂不能直接安装（需源码编译或环境不满足）：仓库根目录无 package.json，浅层子目录有 2 份 dsh 插件清单（plugins/builder-hud/package.json、plugins/souls-hud/package.json），无法唯一定位安装名。

DeepSeek Harness

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

在 GitHub 查看 ↗

在侧边栏用魂系状态条显示余额与上下文余量

30.8/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

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

自动兼容检查未通过：仓库根目录无 package.json，浅层子目录有 2 份 dsh 插件清单（plugins/builder-hud/package.json、plugins/souls-hud/package.json），无法唯一定位安装名。以下命令仍可尝试，但可能失败。

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

dsh plugin --profile web add tony1duan/builder-hud

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

状态速览

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

信任档位：需留意

是什么

dsh 原生插件 · browser

装得上吗

实装验证未通过（repo_missing），装前请到仓库确认最近更新与 issue

L4 · 真实安装等级说明 →

安全吗

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

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

还在维护吗

活跃：最近一次提交在 26 天前

档位由哪些信号合成

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

验证判据与等级说明 →

⚠︎ 实装验证未通过（repo_missing · 2026/10/31） ——可能是验证环境差异，装前建议到 GitHub 仓库确认最近更新与 issue。

社区实装还没有人打卡 · 装过的第一个就是你

安装兼容性检查需源码安装

仓库根目录无 package.json，浅层子目录有 2 份 dsh 插件清单（plugins/builder-hud/package.json、plugins/souls-hud/package.json），无法唯一定位安装名

展开查看检查明细 ↓

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

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

✓Node 引擎未声明 engines.node

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

✗入口文件缺少入口声明

源码安装时若 pnpm 拦截 prepare 脚本，按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑。

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

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

v2.7.0

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

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

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

读写/删除本地文件发起外部网络请求

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

发起网络请求
plugins/souls-hud/lib/client.js:1129
fetch(CONFIG, { credentials: "same-origin", cache: "no-store" })
发起网络请求
plugins/souls-hud/lib/client.js:1143
return fetch(DEVICE_PATH, { credentials: "same-origin", cache: "no-store" })
发起网络请求
plugins/souls-hud/lib/client.js:1166
return fetch(CONFIG, {
发起网络请求
plugins/souls-hud/lib/client.js:1212
return fetch(DEVICE_PATH, {
发起网络请求
plugins/souls-hud/lib/client.js:1239
fetch(DEVICE_PATH, { method: "DELETE", credentials: "same-origin" })
发起网络请求
plugins/souls-hud/lib/client.js:1636
fetch(BASE + "/holidays.json", { method: "POST", credentials: "same-origin" })
发起网络请求
plugins/souls-hud/lib/holidays.js:298
const doFetch = options.fetchImpl || ((...args) => fetch(...args))
读取本地文件
plugins/souls-hud/lib/host.js:187
return readFileSync(new URL(`./${file}`, import.meta.url), 'utf8')
读取本地文件
plugins/souls-hud/lib/host.js:255
body = readFileSync(join(supportDir(), name))
读取本地文件
plugins/souls-hud/lib/host.js:490
bundled = JSON.parse(readFileSync(new URL('../data/holidays-cn.json', import.meta.url), 'utf8'))
读取本地文件
plugins/souls-hud/lib/host.js:496
cached = JSON.parse(readFileSync(holidayCachePath(), 'utf8'))
读取本地文件
plugins/souls-hud/lib/host.js:752
const parsed = JSON.parse(readFileSync(file, 'utf8'))
写入本地文件
plugins/souls-hud/lib/host.js:794
writeFileSync(tmp, JSON.stringify(next, null, 2) + '\n')
写入本地文件
plugins/souls-hud/lib/host.js:795
renameSync(tmp, SETTINGS_FILE)
读取本地文件
plugins/souls-hud/lib/host.js:807
const info = statSync(DEVICE_FILE)
写入本地文件
plugins/souls-hud/lib/host.js:1138
writeFileSync(holidayCachePath(), JSON.stringify(merged, null, 2) + '\n')
删除本地文件
plugins/souls-hud/lib/host.js:1401
rmSync(DEVICE_FILE, { force: true })
写入本地文件
plugins/souls-hud/lib/host.js:1444
writeFileSync(tmp, scrubbed.svg)
写入本地文件
plugins/souls-hud/lib/host.js:1445
renameSync(tmp, DEVICE_FILE)
发起网络请求
plugins/souls-hud/lib/hud.js:1572
fetch(BASE + "/device.svg", { credentials: "same-origin", cache: "no-store" })
发起网络请求
plugins/souls-hud/lib/hud.js:1696
fetch(BASE + "/beacon", {
发起网络请求
plugins/souls-hud/lib/hud.js:2146
fetch(BASE + "/beacon", {
发起网络请求
plugins/souls-hud/lib/hud.js:2584
request = fetch(url, {
发起网络请求
plugins/souls-hud/lib/hud.js:2641
fetch(BASE + "/health", { credentials: "same-origin", cache: "no-store" })
发起网络请求
plugins/souls-hud/lib/hud.js:2715
fetch(BASE + "/health", { credentials: "same-origin", cache: "no-store" })

扫描于 2026/11/3（0 天前） · 范围全包扫描 · 来源 GitHub 仓库

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

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

用户评分

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

广告精选好物

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

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

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

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

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

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

查 MCP 兼容性→

功能亮点

侧边栏显示余额
显示上下文余量
实时token燃烧仪表

DSH 侧边栏的非官方第三方生命体征集群皮肤——三条状态条、一枚刻纹契约徽章，外加实时 token 燃烧仪表

README

由 DeepSeek 最新模型翻译生成

BuilderHUD 为 DSH 侧边栏定制的状态栏皮肤。内置一款： Souls Style —— 三条 Dark Souls 风格的状态条，旁边是一枚雕刻的誓约徽章，它的形状、图案、金属材质、明暗切工都是可配置项，边缘还兼作 token 消耗计量条。状态栏：一枚雕刻的誓约徽章，旁边是三条状态条 | 状态条 | 含义 | 颜色 | | HP | API 余额 —— 账户的充值钱包 | 深红 | | FP | 赠送/奖励钱包余额，与前者同为 ¥ 计价 | 深蓝 | | Stamina | 屏幕上这个会话仍可用的上下文窗口 | 黄绿 | 徽章是运行时构建的扁平 SVG：每个图案都用与边框相同的金属铸造，明暗两种切工都有，图案也可以是你上传的 SVG。环绕它的圆环是实时的 token 消耗计量条，颜色取决于当前小时是否落在 DeepSeek 的错峰时段内 —— 包括中国法定节假日和调休补班日。

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

BuilderHUD

为 DSH 侧边栏定制的状态栏皮肤。内置一款： Souls Style —— 三条 Dark Souls 风格的状态条，旁边是一枚雕刻的誓约徽章，它的形状、图案、金属材质、明暗切工都是可配置项，边缘还兼作 token 消耗计量条。

状态栏：一枚雕刻的誓约徽章，旁边是三条状态条

| 状态条 | 含义 | 颜色 |
| HP | API 余额 —— 账户的充值钱包 | 深红 |
| FP | 赠送/奖励钱包余额，与前者同为 ¥ 计价 | 深蓝 |
| Stamina | 屏幕上这个会话仍可用的上下文窗口 | 黄绿 |

徽章是运行时构建的扁平 SVG：每个图案都用与边框相同的金属铸造，明暗两种切工都有，图案也可以是你上传的 SVG。环绕它的圆环是实时的 token 消耗计量条，颜色取决于当前小时是否落在 DeepSeek 的错峰时段内 —— 包括中国法定节假日和调休补班日。

目录结构

| 路径 | 说明 |
| plugins/builder-hud | bundle：Plugins 页面列出的卡片，以及在其上放一行的补丁层 |
| plugins/souls-hud | 皮肤：宿主部分（状态、设置、捐赠入口）、客户端部分（设置表单），以及渲染器（hud.js + hud.css） |

bundle 里刻意不放任何运行时代码，原因很关键：卡片上的名字来自 dsh.profile.bundles 里列出的包，行上的名字来自该行指向的包 —— 所以两个名字需要两个包。Souls Style README 才是真正的文档：安装、每一项设置、美术资源、计费规则、节假日日历和测试套件。从那里开始读。

安装

bundle 已发布到 npm。在你的配置档里运行下面这条命令，并把它的名字加进配置档的 bundle 列表：

cd ~/.dsh/profiles/desktop
pnpm add dsh-plugin-builder-hud

{ "dsh": { "profile": { "bundles": ["…", "dsh-plugin-builder-hud"] } } }

它会把皮肤作为自己的依赖一并带入 —— 两个包，原因见 Souls Style README。

如果从本地检出安装，则在配置档的 cordis.patch.yml 里放一行，指向皮肤的宿主入口：

- insert:
- id: souls-hud
name: "/absolute/path/to/plugins/souls-hud/lib/host.js"
config:
hpTargetCny: 100
fpTargetCny: 50
shape: round
device: whale
material: bronze

完整说明 —— 包括两包布局，以及为什么这一行不能在配置档层重复 —— 见 Souls Style README。

验证

node plugins/souls-hud/test/harness.mjs # offline: fakes the Cordis context + services
node plugins/souls-hud/test/form.mjs # 在 Node 里渲染设置页
node plugins/souls-hud/test/upload.mjs # 上传路径，跑在无头 Chrome 里
node plugins/souls-hud/test/preview.mjs # 重新构建 preview/preview.html
node plugins/builder-hud/test/icon.mjs --check # 卡面图与渲染器是否一致
node plugins/builder-hud/test/icon.mjs --shape octagon --device sun \
--out plugins/souls-hud/icon.svg --check # 皮肤的行内图标
node test/repo.mjs # .github 里的文件，以及文档里的每一条链接

harness.mjs 用一份真实请求匹配器的副本跑通各条路由，设置表单挂载三次（已发布、已配置、空），上传路径则拿恶意 SVG 来试。repo.mjs 守住仓库自己的元数据：issue 表单、赞助按钮，以及文档交给读者的每一条链接、锚点和命令。零依赖——只用纯 Node，浏览器端的测试再加一个本地 Chrome。

支持

插件免费：没有付费版，没有许可证密钥，也没有任何要解锁的东西。

如果它在你侧边栏里占住了位置，打赏入口就在应用里，在 BuilderHUD 的卡片页——国内读者用微信赞赏码，其他地方用 Ko-fi。打赏换不来任何东西；许可证反正都是 MIT。

无关联声明

这是独立的第三方插件，不隶属于 DeepSeek，也不获得其背书或支持，并且不附带他们的任何美术素材：徽章、上面的图案和那条鲸鱼都是本项目自己画的。

「Dark Souls」是 FromSoftware, Inc. 和 Bandai Namco Entertainment Inc. 的商标；这里只是描述性地使用，用来说明这张图画起来像什么，就像字体说自己「Gothic」一样。本项目不隶属于 FromSoftware 或 Bandai Namco，也不获得其背书或支持，不附带他们的任何美术素材或数据，也不是他们的产品。圣约勋章风格是致敬，不是主张。

许可证

MIT——见 LICENSE。