@xzxzzx/bilibili-mcp 1.13.0 → 1.13.1

package/README.md

@@ -10,7 +10,6 @@ Bilibili MCP 是一个本地 MCP server，让 AI Agent 读取 Bilibili 内容。
 
 <p align="center">
   <a href="./README_EN.md">English</a> ·
-  <a href="#快速了解一个-up-主">快速了解 UP 主</a> ·
   <a href="./docs/client-setup.md">客户端配置指南</a> ·
   <a href="./docs/tool-reference.md">工具参考</a> ·
   <a href="#本地-asr可选">本地 ASR（可选）</a> ·
@@ -56,7 +55,7 @@ Bilibili MCP 是一个本地 MCP server，让 AI Agent 读取 Bilibili 内容。
    npx -y @xzxzzx/bilibili-mcp@latest check
    npx -y @xzxzzx/bilibili-mcp@latest doctor --json
    doctor --json 只检查本机配置状态，不能代替后面的实时登录验证。
-   setup 会询问是否安装可选的本地 ASR 模型，选否即可。自动化环境可用 setup --non-interactive（凭据来自已有的环境变量或全局配置，绝不提示、也绝不从 stdin/argv 读取凭据值）；加 --asr-model <tiny|base|small> 可同时安装指定模型。
+   setup 会询问是否安装可选的本地 ASR 模型，选否即可。自动化环境可用 setup --non-interactive（凭据来自已有的环境变量或全局配置，绝不提示、也绝不从 stdin/argv 读取凭据值）；加 --asr-model <tiny|base|small> 可同时安装指定模型，--asr-device <auto|cpu|cuda> 选择设备偏好（默认 auto）。
 5. 让我重启或重连客户端。你无法代替我完成这一步时，请明确让我操作。
 6. 重连后调用 MCP 工具 check_bilibili_credentials。
    只有 configured: true 且 logged_in: true 才报告成功。
@@ -169,11 +168,13 @@ Bilibili 会把部分视频的 AI 识别字幕标为 `ai-zh`、`ai-en`、`ai-ja`
 
 | 模型 | 大小 | 说明 |
 |---|---|---|
-| tiny | ~78 MB | 最小占用 |
-| base | ~148 MB | 折中选择 |
-| small | ~486 MB | 推荐，Enter 默认选中 |
+| tiny | ~78 MB | 速度优先：适合快速提取和长视频初筛；准确率相对较低 |
+| base | ~148 MB | 均衡：兼顾速度、质量和资源占用 |
+| small | ~486 MB | 质量优先：耗时和内存占用更高；推荐，Enter 默认选中 |
 
-Runtime 固定为 `faster-whisper==1.2.1`，模型存放在用户目录 `~/.bilibili-mcp/asr/`，通过 CPU INT8 加载验证后才算就绪，不需要系统 FFmpeg；同一目录仅保留一个活跃模型。`doctor --json` 的 `asr.status` 和 `asr.model` 报告就绪状态与已选模型（纯信息字段，不影响凭证退出状态）。
+Runtime 固定为 `faster-whisper==1.2.1` 与 `ctranslate2==4.8.0`，模型存放在用户目录 `~/.bilibili-mcp/asr/`，不需要系统 FFmpeg；同一目录仅保留一个活跃模型。选择模型后还需选择设备偏好：`auto`（默认）先用程序生成的固定短 WAV 完整验证 `cuda/float16`，失败时说明脱敏原因并验证、保存 `cpu/int8`；`cpu` 跳过 GPU；`cuda` 验证失败则报错且不回退。`doctor --json` 会报告实际生效的 `device`、`compute_type`、readiness 与脱敏失败类别。
+
+项目不会安装或修改 NVIDIA 驱动、CUDA、cuBLAS、cuDNN、系统 `PATH`、`LD_LIBRARY_PATH` 或全局 Python。GPU 验证失败后，你可以继续使用已经验证的 CPU，也可以自行修复 GPU 环境后重新运行 `setup`；每次重新运行都会再次验证设备。
 
 **边界：**本地转录始终被约束在安全范围内——显式选择、资源受限、Cookie 隔离：
 

package/README_EN.md

@@ -57,7 +57,7 @@ Please help me install the Bilibili MCP server: @xzxzzx/bilibili-mcp.
    npx -y @xzxzzx/bilibili-mcp@latest check
    npx -y @xzxzzx/bilibili-mcp@latest doctor --json
    doctor --json checks local configuration only; it does not replace the live login verification below.
-   setup will ask about installing the optional local ASR model; choosing no is fine. Automated environments can run setup --non-interactive (credentials come from existing environment variables or the global config file; no prompts, and credential values are never read from stdin/argv); add --asr-model <tiny|base|small> to also install a given model.
+   setup will ask about installing the optional local ASR model; choosing no is fine. Automated environments can run setup --non-interactive (credentials come from existing environment variables or the global config file; no prompts, and credential values are never read from stdin/argv); add --asr-model <tiny|base|small> to install a model and --asr-device <auto|cpu|cuda> to choose the device preference (default: auto).
 5. Ask me to restart or reconnect the client. When you can't do it for me,
    tell me explicitly to do it myself.
 6. After reconnect, call the MCP tool check_bilibili_credentials.
@@ -176,11 +176,13 @@ Some videos ship without any subtitle. Once you install a local ASR model, `get_
 
 | Model | Size | Notes |
 |---|---|---|
-| tiny | ~78 MB | smallest footprint |
-| base | ~148 MB | middle ground |
-| small | ~486 MB | recommended, selected on Enter |
+| tiny | ~78 MB | Speed-first: suited to quick extraction and initial review of long videos; relatively lower accuracy |
+| base | ~148 MB | Balanced: balances speed, quality, and resource use |
+| small | ~486 MB | Quality-first: higher runtime and memory use; recommended, selected on Enter |
 
-The runtime is pinned to `faster-whisper==1.2.1`. Models live under `~/.bilibili-mcp/asr/`, are verified by a CPU INT8 load before being marked ready, and do not require system FFmpeg; only one active model is kept per directory. `doctor --json` reports readiness and the selected model via `asr.status` and `asr.model` (informational fields that never affect credential exit codes).
+The runtime is pinned to `faster-whisper==1.2.1` and `ctranslate2==4.8.0`. Models live under `~/.bilibili-mcp/asr/`, do not require system FFmpeg, and only one active model is kept per directory. After choosing a model, choose a device preference: `auto` (default) performs a complete `cuda/float16` check with a generated fixed short WAV, explains a sanitized failure and verifies/saves `cpu/int8` when CUDA is not ready; `cpu` skips GPU probing; `cuda` fails without CPU fallback. `doctor --json` reports the effective device, compute type, readiness, and sanitized failure category.
+
+The project never installs or modifies NVIDIA drivers, CUDA, cuBLAS, cuDNN, the system `PATH`, `LD_LIBRARY_PATH`, or global Python. After a GPU failure, you decide whether to keep the verified CPU profile or repair the GPU environment and rerun `setup`; every setup rerun rechecks device readiness.
 
 **Boundaries:** local transcription stays within safe bounds — opt-in, resource-capped, Cookie-isolated:
 

package/dist/asr/installer.d.ts

@@ -1,15 +1,22 @@
 import fs from "fs";
-import { type AsrModelKey, type AsrModelSpec, type AsrPaths } from "./state.js";
+import { type AsrExecutionProfile, type AsrDevicePreference, type AsrFailureCategory, type AsrModelKey, type AsrModelSpec, type AsrPaths } from "./state.js";
 export declare const PYTHON_MIN_MAJOR = 3;
 export declare const PYTHON_MIN_MINOR = 9;
-export declare const COMPUTE_TYPE = "int8";
-export declare const DEVICE = "cpu";
+export declare const COMPUTE_TYPE: "int8";
+export declare const DEVICE: "cpu";
 export interface PythonCommand {
     executable: string;
     prefixArgs: string[];
 }
+export declare class AsrReadinessError extends Error {
+    readonly category: AsrFailureCategory;
+    readonly device?: AsrExecutionProfile["device"] | undefined;
+    readonly gpuFailureCategory?: AsrFailureCategory | undefined;
+    readonly allowFallback: boolean;
+    constructor(category: AsrFailureCategory, device?: AsrExecutionProfile["device"] | undefined, gpuFailureCategory?: AsrFailureCategory | undefined, allowFallback?: boolean);
+}
 export declare function buildAsrChildEnv(source: Record<string, string | undefined>): Record<string, string | undefined>;
-declare function execFile(file: string, args: string[]): Promise<{
+declare function execFile(file: string, args: string[], signal?: AbortSignal): Promise<{
     code: number | null;
     stdout: string;
     stderr: string;
@@ -23,13 +30,21 @@ export declare function validateModelInstallTree(modelPath: string, maxBytes: nu
     files: number;
 };
 export declare function downloadModel(venvPython: PythonCommand, modelPath: string, modelId: string, revision: string, spawnFn?: typeof execFile, mkdirSyncFn?: typeof fs.mkdirSync, maxBytes?: number): Promise<void>;
-export declare function verifyModel(venvPython: PythonCommand, modelPath: string, spawnFn?: typeof execFile): Promise<void>;
+export declare function verifyModel(venvPython: PythonCommand, modelPath: string, executionProfile?: AsrExecutionProfile, spawnFn?: typeof execFile): Promise<void>;
 export interface InstallResult {
     success: boolean;
     error?: string;
     pythonPath?: string;
+    executionProfile?: AsrExecutionProfile;
+    failureCategory?: AsrFailureCategory;
+    failureDevice?: AsrExecutionProfile["device"];
+    gpuFailureCategory?: AsrFailureCategory;
     asrPaths: AsrPaths;
 }
+export declare function verifyInstalledDeviceReadiness(paths: Pick<AsrPaths, "venv" | "model">, preference?: AsrDevicePreference, signal?: AbortSignal, spawnFn?: typeof execFile): Promise<{
+    executionProfile: AsrExecutionProfile;
+    failureCategory?: AsrFailureCategory;
+}>;
 export declare function runAsrInstallation(options?: {
     fsMkdirSync?: typeof fs.mkdirSync;
     fsLstatSync?: typeof fs.lstatSync;
@@ -37,6 +52,7 @@ export declare function runAsrInstallation(options?: {
     asrBase?: string;
     pythonOverride?: string;
     modelKey?: AsrModelKey;
+    devicePreference?: AsrDevicePreference;
     spawnFn?: typeof execFile;
     onStage?: (stage: string) => void;
 }): Promise<InstallResult>;

package/dist/asr/installer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/asr/installer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/asr/installer.ts"],"names":[],"mappings":"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"}