dsh-deepseek-balance-widget 1.2.0 → 1.2.3

package/README.md

@@ -8,6 +8,8 @@
 
 ## 功能
 
+![DeepSeek 余额侧边栏展示](assets/screenshot.png)
+
 - 侧边栏常驻按钮：`余额`、`今日消费`、`今日Token` 三个数值，30 秒自动刷新
 - 点击弹出详情卡片：
   - 余额（`$`，来自 `api.deepseek.com/user/balance`）
@@ -43,36 +45,16 @@
 
 ## 安装
 
-插件已发布到 npm，包名 **`dsh-deepseek-balance-widget`**。一条命令安装（**不需要 git，不需要 GitHub 账号**）：
+插件已发布到 npm，包名 **`dsh-deepseek-balance-widget`**。一条命令安装：
 
 ```bash
 dsh plugin --profile web add dsh-deepseek-balance-widget
 ```
 
-安装成功后 dsh 会**自动把该包注册进 `dsh.profile.bundles`**（已实测验证），**无需手动改任何配置文件**。本包**没有构建脚本**，pnpm 不会拦截（无需在 `pnpm-workspace.yaml` 的 `allowBuilds` 里批准）。
+安装成功后 dsh 会**自动把该包注册进 `dsh.profile.bundles`**，**无需手动改任何配置文件**。本包**没有构建脚本**，pnpm 不会拦截（无需在 `pnpm-workspace.yaml` 的 `allowBuilds` 里批准）。
 
 完成后**重启 `dsh web`**，侧边栏出现余额按钮即可。
 
-> 旧版 dsh（不含自动注册机制）或绕过 `dsh plugin` 直接 `pnpm/npm install` 时，才需要手动在 `~/.dsh/profiles/web/package.json` 的 `dsh.profile.bundles` 末尾加入 `"dsh-deepseek-balance-widget"`。
-
-### 🤖 让 AI 帮你装
-
-2026年了，你有 Agent，让它自己装。打开 DeepSeek Harness，把下面这句丢给它：
-
-> 帮我安装 dsh-deepseek-balance-widget 插件：npm 包名 dsh-deepseek-balance-widget
-
-AI 会自动执行 `dsh plugin --profile web add dsh-deepseek-balance-widget`（从 npm 安装，无需 git）→ 验证 bundles 注册 → 提醒你重启。
-
-### 备选：GitHub 直装
-
-如果暂时连不上 npm registry，也可以从 GitHub 安装：
-
-```bash
-dsh plugin --profile web add github:crazy-L118/dsh-deepseek-balance-widget
-```
-
-（此方式需要电脑装了 git。）
-
 ## 配置凭据（关键一步）
 
 编辑 `~/.dsh/.credentials.yaml`：

package/README_EN.md

@@ -8,6 +8,8 @@ A small plugin that shows your DeepSeek balance in the DeepSeek Harness (dsh) we
 
 ## Features
 
+![DeepSeek balance sidebar](assets/screenshot.png)
+
 - Persistent sidebar widget: `余额` (balance), `今日消费` (today spend), `今日Token` (today tokens), auto-refresh every 30 s
 - Click for a detail card:
   - Balance (`$`, from `api.deepseek.com/user/balance`)
@@ -43,36 +45,16 @@ Browser (dsh web frontend)  ──GET /deepseek-balance──▶  dsh host (your
 
 ## Install
 
-The plugin is published to npm as **`dsh-deepseek-balance-widget`**. Install with a single command (**no git, no GitHub account needed**):
+The plugin is published to npm as **`dsh-deepseek-balance-widget`**. Install with a single command:
 
 ```bash
 dsh plugin --profile web add dsh-deepseek-balance-widget
 ```
 
-After a successful `dsh plugin` install, dsh **automatically registers the package in `dsh.profile.bundles`** (verified end-to-end), so **no manual config editing is needed**. This package has **no build script**, so pnpm does not block it (no `allowBuilds` approval needed).
+After a successful `dsh plugin` install, dsh **automatically registers the package in `dsh.profile.bundles`**, so **no manual config editing is needed**. This package has **no build script**, so pnpm does not block it (no `allowBuilds` approval needed).
 
 Then **restart `dsh web`** — the balance button appears in the sidebar.
 
-> Only for older dsh versions (without the auto-registration mechanism) or when bypassing `dsh plugin` with raw `pnpm/npm install`: manually append `"dsh-deepseek-balance-widget"` to the `dsh.profile.bundles` array in `~/.dsh/profiles/web/package.json`.
-
-### 🤖 Let the AI install it
-
-You have an Agent — let it install itself. Open DeepSeek Harness and drop this sentence in:
-
-> Install the dsh-deepseek-balance-widget plugin for me (npm package: dsh-deepseek-balance-widget)
-
-The agent will run `dsh plugin --profile web add dsh-deepseek-balance-widget` (from npm, no git needed), verify the bundle registration, then tell you to restart.
-
-### Alternative: GitHub install
-
-If the npm registry is unreachable, install straight from GitHub instead:
-
-```bash
-dsh plugin --profile web add github:crazy-L118/dsh-deepseek-balance-widget
-```
-
-(Note: this requires git on the machine.)
-
 ## Configure credentials (important)
 
 Edit `~/.dsh/.credentials.yaml`:

package/lib/index.js

@@ -1,5 +1,5 @@
 import { launchEnvironmentOf } from "@deepseek-ai/dsh-launch-environment";
-import { readFile } from "node:fs/promises";
+import { readFile, stat } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
 import { dirname, resolve } from "node:path";
 import { spawn } from "node:child_process";
@@ -101,17 +101,43 @@ async function queryNpmVersion() {
   return { ok: true, local: LOCAL_VERSION, latest, updateAvailable };
 }
 
+/** @returns {Promise<boolean>} whether the given path exists. */
+async function fileExists(path) {
+  try {
+    await stat(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Detect the package manager used by UPDATE_CWD.
+ * @returns {Promise<"pnpm" | "npm">}
+ */
+async function detectPackageManager() {
+  const pnpmLock = resolve(UPDATE_CWD, "pnpm-lock.yaml");
+  const pnpmLockYml = resolve(UPDATE_CWD, "pnpm-lock.yml");
+  if (await fileExists(pnpmLock) || await fileExists(pnpmLockYml)) return "pnpm";
+  return "npm";
+}
+
 /**
- * Run `npm install <pkg>@latest` in the discovered project root.
+ * Run the package-manager update command for this package in the discovered project root.
+ * Uses shell mode on Windows so that .cmd scripts (npm.cmd / pnpm.cmd) can actually spawn.
  * @returns {Promise<{ok:boolean, output:string, error?:string}>}
  */
-async function runNpmUpdate() {
-  const cmd = process.platform === "win32" ? "npm.cmd" : "npm";
-  const args = ["install", "dsh-deepseek-balance-widget@latest"];
+async function runPackageUpdate() {
+  const pm = await detectPackageManager();
+  const isWin = process.platform === "win32";
+  const cmd = isWin ? (pm === "pnpm" ? "pnpm.cmd" : "npm.cmd") : pm;
+  const args = pm === "pnpm"
+    ? ["add", "dsh-deepseek-balance-widget@latest"]
+    : ["install", "dsh-deepseek-balance-widget@latest"];
   return new Promise((resolve) => {
     const child = spawn(cmd, args, {
       cwd: UPDATE_CWD,
-      shell: false,
+      shell: isWin,
       env: { ...process.env, NPM_CONFIG_FUND: "false", NPM_CONFIG_AUDIT: "false" }
     });
     let stdout = "";
@@ -126,7 +152,7 @@ async function runNpmUpdate() {
       if (code === 0) {
         resolve({ ok: true, output: output.slice(-800) });
       } else {
-        resolve({ ok: false, output, error: `npm install exited with code ${code}` });
+        resolve({ ok: false, output, error: `${pm} ${args.join(" ")} exited with code ${code}` });
       }
     });
   });
@@ -533,7 +559,7 @@ function apply(ctx) {
             res.end(JSON.stringify({ ok: true, noOp: true, local: before.local, latest: before.latest, message: "已是最新版本" }));
             return;
           }
-          const result = await runNpmUpdate();
+          const result = await runPackageUpdate();
           if (result.ok) {
             res.writeHead(200, { "content-type": "application/json; charset=utf-8" });
             res.end(JSON.stringify({ ok: true, message: "更新成功，请彻底重启 dsh 以加载新版本", output: result.output }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-deepseek-balance-widget",
-  "version": "1.2.0",
+  "version": "1.2.3",
   "type": "module",
   "description": "DeepSeek API balance widget for the dsh web sidebar: a live, auto-refreshing balance pill (balance / today spend / today tokens) with a detail popover (cumulative spend, monthly usage, request count). Every user sees only their own balance — keys are resolved per-machine from the local credential seam, never hardcoded.",
   "keywords": [