把 DeepSeek 余额搬上 KDE 面板：Command Output 小部件实践

2026-09-13 2026-09-13 约 949 字预计阅读 2 分钟

之前给 Omarchy 的状态栏写过 DeepSeek 余额小部件（Quickshell/QML）。换了 Fedora + KDE 之后，Quickshell 没了，余额也就看不见了。本文记录怎么用 KDE 的「Command Output」小部件 + 一个采集脚本，把余额重新钉到面板上。

1. 背景：Omarchy 那套搬不过来

Omarchy 的余额小部件是 Quickshell 插件：manifest.json + collector.sh + BalanceWidget.qml。KDE Plasma 用的是完全不同的插件体系，QML 直接搬不过来。而 KDE 自带面板里并没有「显示一条命令输出」的现成组件——需要从 KDE Store 装一个。

2. 采集脚本：读 opencode 的 key，输出一行文本

核心就一个脚本，从 opencode 的 auth.json 取 DeepSeek key，查余额接口，输出形如 ¥78.9：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
#!/usr/bin/env bash
# ~/.local/bin/deepseek-balance.sh
set -uo pipefail
AUTH_JSON="${OPENCODE_AUTH_JSON:-$HOME/.local/share/opencode/auth.json}"
URL="https://api.deepseek.com/user/balance"

key=$(jq -r '.deepseek.key // empty' "$AUTH_JSON" 2>/dev/null || true)
[ -z "$key" ] && { echo "DS?"; exit 0; }

out=$(curl -sS -m 10 -w $'\n%{http_code}' \
  -H "Authorization: Bearer $key" -H "Accept: application/json" "$URL" 2>/dev/null)
code=${out##*$'\n'}; body=${out%$'\n'*}
[ "$code" != "200" ] && { echo "DS·err"; exit 0; }

total=$(jq -r '.balance_infos[0].total_balance // empty' <<<"$body")
currency=$(jq -r '.balance_infos[0].currency // "CNY"' <<<"$body")
[ -z "$total" ] && { echo "DS·?"; exit 0; }

sym="¥"; [ "$currency" = "USD" ] && sym="$"
printf '%s%.1f\n' "$sym" "$total"

失败时返回一个短占位符（DS? / DS·err）而不是报错崩掉，这样面板不会突然变空。

3. 装「Command Output」小部件

Fedora 默认没打包它。它来自 KDE Store 的 com.github.zren.commandoutput，源码在 GitHub，可直接装：

1
2
git clone --depth 1 https://github.com/Zren/plasma-applet-commandoutput.git
kpackagetool6 --type Plasma/Applet --install plasma-applet-commandoutput/package

它的配置项里，关键是 command（要跑的命令）和 interval（毫秒）。

4. 脚本化地把它加进面板

不想手点，可以用 Plasma 的脚本接口直接加。先找面板 id：

1
2
busctl --user call org.kde.plasmashell /PlasmaShell org.kde.PlasmaShell evaluateScript s \
  'print(panelIds.join(","))'

再加小部件并写配置（注意 evaluateScript 只有用 print() 才有回显）：

1
2
3
4
5
6
7
8
busctl --user call org.kde.plasmashell /PlasmaShell org.kde.PlasmaShell evaluateScript s '
var p = panelById(panelIds[0]);
var w = p.addWidget("com.github.zren.commandoutput");
w.currentConfigGroup = ["General"];
w.writeConfig("command", "/home/me/.local/bin/deepseek-balance.sh");
w.writeConfig("interval", 120000);
print("added id=" + w.id);
'

再配一个点击动作，弹通知显示详情（clickCommand 指向一个包了 notify-send 的脚本）。

5. 效果与小结

面板右侧就会出现 ¥78.9，每 2 分钟自动刷新，点击弹出余额详情。截图里它挨着时钟，存在感和原来的 Omarchy 状态栏差不多。

组件	作用
`deepseek-balance.sh`	查 API，输出一行余额
Command Output 小部件	定时跑脚本、把输出渲染到面板
`clickCommand` + notify-send	点击看详情

要点：KDE 缺什么组件，就去 KDE Store 找对应的 plasmoid，再用 evaluateScript 脚本化装配——比手动拖拽可复现得多。而「脚本采集 + 组件展示」这个模式，从 Quickshell 换到 Plasma 依然通用。

目录