dsh-shlr-bilitoolkit 0.1.8 → 0.1.9

package/README.md

@@ -74,9 +74,10 @@ const [ups, _] = await client.space.videos(574115689, 1, 10);
   - 读取：`bili_recommend` / `bili_video_detail` / `bili_video_subtitle` / `bili_search_video` / `bili_search_user` / `bili_space_info` / `bili_space_videos` / `bili_article_view` / `bili_article_list` / `bili_dynamic_feed` / `bili_dynamic_space` / `bili_comment_list` / `bili_relation_followings` / `bili_relation_followers` / `bili_notify_unread` / `bili_notify_replies` / `bili_fav_folders` / `bili_video_pagelist` / `bili_video_subtitles` / `bili_video_playurl` / `bili_video_status` / `bili_space_collections` / `bili_space_collection` / `bili_fav_folder_videos` / `bili_dynamic_detail` / `bili_notify_ats` / `bili_notify_likes` / `bili_message_unread` / `bili_message_history` / `bili_relation_stat` / `bili_user_following` / `bili_profile_info` / `bili_comment_replies`
   - 写操作：`bili_like` / `bili_follow` / `bili_favorite` / `bili_send_comment` / `bili_send_message` / `bili_triple` / `bili_dynamic_publish` / `bili_dynamic_repost` / `bili_coin` / `bili_unfavorite` / `bili_fav_folder_create` / `bili_fav_folder_delete` / `bili_dynamic_like` / `bili_dynamic_delete` / `bili_comment_send` / `bili_comment_reply` / `bili_comment_delete` / `bili_message_recall` / `bili_profile_update_sign` / `bili_profile_update`（均会真实修改账号状态，需登录）
   - 辅助：`bili_login_status`（查登录态）/ `bili_gen_qr`（生成扫码登录二维码）/ `bili_cache_clear`（清空本地缓存）
-- 工具读取 `BILI_COOKIE_FILE`（默认 `bili_cookies.json`）作为登录态。
-- **扫码登录（独立获取 Cookie）**：运行 `npm run login`，终端会打印 ASCII 二维码，用「哔哩哔哩」App 扫码并确认后，Cookie 自动写入 `bili_cookies.json`。也可在对话里先调 `bili_login_status` 查登录态、调 `bili_gen_qr` 拿二维码链接与可直接展示的 `ascii` 二维码。写操作（点赞 / 收藏 / 投币 / 关注 / 评论 / 私信 / 三连）都依赖该 Cookie 中的 `SESSDATA` / `bili_jct`。
-- **缓存持久化**：除 Cookie 外，客户端还会把 WBI 签名密钥（`B 站每天轮换`）、`bvid→aid` 映射这类稳定 / 带 TTL 的数据写入本地 JSON 缓存（`BILI_CACHE_FILE`，默认 `bili_cache.json`），用临时文件 + 原子替换落盘、文件损坏会自动自愈。冷启动或跨进程时直接复用，避免每次都请求 `nav` 接口；密钥过期或失效时 `refresh()` 会重新拉取并覆盖缓存。若签名反复报 `-403/-352`，可调用 `bili_cache_clear` 强制清空缓存后重试（不影响 Cookie / 登录态）。
+- 工具读取 `BILI_COOKIE_FILE`（默认 `bili_data/bili_cookies.json`）作为登录态。
+- **数据目录**：Cookie / 缓存 / 二维码统一放在一个目录里，默认 `bili_data/`（相对 dsh 工作目录），避免散落污染工作目录。可用 `BILI_DATA_DIR` 改目录；`BILI_COOKIE_FILE` / `BILI_CACHE_FILE` / `BILI_QR_FILE` 可精确指定单个文件。兼容旧版：若新目录还没有 Cookie、而旧位置（`./bili_cookies.json`）有，会继续沿用旧的。
+- **扫码登录（独立获取 Cookie）**：运行 `npm run login`，终端会打印 ASCII 二维码，用「哔哩哔哩」App 扫码并确认后，Cookie 自动写入 `bili_data/bili_cookies.json`。也可在对话里先调 `bili_login_status` 查登录态、调 `bili_gen_qr` 拿二维码链接与可直接展示的 `ascii` 二维码。写操作（点赞 / 收藏 / 投币 / 关注 / 评论 / 私信 / 三连）都依赖该 Cookie 中的 `SESSDATA` / `bili_jct`。
+- **缓存持久化**：除 Cookie 外，客户端还会把 WBI 签名密钥（`B 站每天轮换`）、`bvid→aid` 映射这类稳定 / 带 TTL 的数据写入本地 JSON 缓存（`BILI_CACHE_FILE`，默认 `bili_data/bili_cache.json`），用临时文件 + 原子替换落盘、文件损坏会自动自愈。冷启动或跨进程时直接复用，避免每次都请求 `nav` 接口；密钥过期或失效时 `refresh()` 会重新拉取并覆盖缓存。若签名反复报 `-403/-352`，可调用 `bili_cache_clear` 强制清空缓存后重试（不影响 Cookie / 登录态）。
 
 安装到 dsh（任选其一，取决于你的发行方式）：
 

package/dist/dsh.d.ts

@@ -13,6 +13,7 @@ import { BiliClient } from "./client.js";
 import { Collection, Page, PlayInfo, Subtitle, User, Video } from "./models.js";
 export declare const name = "bili-toolkit";
 export declare const inject: string[];
+export declare function dataDir(): string;
 export interface DshTool {
     id: string;
     description: string;

package/dist/dsh.js

@@ -11,8 +11,8 @@
 */
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import QRCode from "qrcode";
-import { writeFileSync } from "node:fs";
-import { resolve } from "node:path";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 import { BiliClient } from "./client.js";
 import { Collection, Page, PlayInfo, Subtitle, User, Video } from "./models.js";
@@ -23,10 +23,26 @@ export const inject = ["tools"];
 let cached = null;
 // 最近一次生成、等待扫码确认的二维码 key（登录完成链路用）
 let pendingQrKey = null;
+// 统一的数据目录：Cookie / 缓存 / 二维码都放这里，避免散落在工作目录里。
+// BILI_DATA_DIR 可改目录；BILI_COOKIE_FILE / BILI_CACHE_FILE / BILI_QR_FILE 可精确指定单个文件。
+export function dataDir() {
+    return process.env.BILI_DATA_DIR ?? "bili_data";
+}
+function resolveCookieFile() {
+    if (process.env.BILI_COOKIE_FILE)
+        return process.env.BILI_COOKIE_FILE;
+    const primary = resolve(dataDir(), "bili_cookies.json");
+    const legacy = resolve("bili_cookies.json");
+    // 兼容旧版：新目录还没有 cookie、但旧位置有，就继续用旧的
+    if (!existsSync(primary) && existsSync(legacy))
+        return legacy;
+    return primary;
+}
 async function getClient() {
     if (!cached) {
         cached = new BiliClient({
-            cookieFile: process.env.BILI_COOKIE_FILE ?? "bili_cookies.json",
+            cookieFile: resolveCookieFile(),
+            cacheFile: process.env.BILI_CACHE_FILE ?? resolve(dataDir(), "bili_cache.json"),
         });
         // 没有 Cookie 文件（或为空 / 损坏）= 未登录（匿名）。
         // 不能因此让所有工具崩掉——公开接口、以及最关键的扫码登录入口都依赖这里。
@@ -1011,7 +1027,8 @@ export const TOOLS = [
                     width: 320,
                 });
                 qrDataUrl = `data:image/png;base64,${png.toString("base64")}`;
-                qrImagePath = resolve(process.cwd(), "bili_qrcode.png");
+                qrImagePath = resolve(process.env.BILI_QR_FILE ?? resolve(dataDir(), "bili_qrcode.png"));
+                mkdirSync(dirname(qrImagePath), { recursive: true });
                 writeFileSync(qrImagePath, png);
             }
             catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-shlr-bilitoolkit",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "深海猎人专用B站接口工具箱 dsh 插件。",
   "type": "module",
   "main": "dist/dsh.js",