dsh-shlr-bilitoolkit 0.1.11 → 0.1.13

package/AGENTS.md

@@ -1,43 +1,10 @@
-# AGENTS.md — dsh-bili-toolkit 使用约定（Agent 必读）
+# AGENTS.md — dsh-bili-toolkit（Agent 必读）
 
-> 本文件面向使用本插件的 agent。**处理任何「B 站登录」相关请求前，必须先读这里，并按下面的规则执行。**
+## 登录（务必遵守）
+用户要登录 B 站，或任何操作返回未登录（`-101` / `未登录` / `CookieError`）时：
+**必须调用 `bili_gen_qr`，并把返回的二维码图片展示给用户扫码**——用 `qrDataUrl` 以 Markdown 图片 `![qr](<qrDataUrl>)` 渲染（或引用 `qrImageUrl` / `qrImagePath`）。
 
-## 登录（最重要，务必遵守）
+禁止：只给链接、用 ASCII/文本二维码、让用户自己跑命令。用户扫码确认后调用 `bili_login_status` 完成登录并保存 Cookie。
 
-当用户说「登录 B 站」「扫码登录」「登陆一下」，或任何需要登录的操作返回未登录
-（业务码 `-101` / `CookieError` / 提示「未登录 / 请先登录」）时，按顺序做：
-
-1. **必须调用 `bili_gen_qr`** —— 这是登录 B 站的唯一入口。它会返回二维码图片：
-   `qrDataUrl`（base64 data URL）、`qrImageUrl`（`file://` 链接）、`qrImagePath`（本地 PNG 绝对路径）。
-2. **必须把二维码图片原样展示给用户**：用 Markdown 图片 `![B站登录二维码](<qrDataUrl>)`
-   （或引用 `qrImageUrl` / `qrImagePath`），让用户能直接扫。
-3. 提示用户用「哔哩哔哩」App 扫描该二维码，并在手机上点「确认登录」。
-4. 用户确认后，调用 `bili_login_status` 轮询确认——成功后会自动把 Cookie 保存到
-   `bili_data/bili_cookies.json`。
-
-**禁止事项：**
-- 不要用 ASCII / 文本二维码代替图片。
-- 不要只扔一个链接给用户、不展示图片。
-- 不要让用户自己去终端跑 `npm run login`（除非明确处于终端 / CLI 环境）。
-- 不要在未展示二维码的情况下就回复「请登录」。
-
-## 数据位置
-
-统一放在数据目录（默认 `bili_data/`，相对 dsh 工作目录，可用 `BILI_DATA_DIR` 改）：
-
-| 文件 | 用途 |
-| --- | --- |
-| `bili_cookies.json` | 登录 Cookie（SESSDATA / bili_jct） |
-| `bili_cache.json` | WBI 签名密钥 + bvid→aid 缓存 |
-| `bili_qrcode.png` | 最近一次生成的登录二维码 |
-| `bili_device.json` | 私信设备号 dev_id（跨重启稳定，勿频繁变动） |
-
-## 写操作需确认
-
-点赞 / 收藏 / 投币 / 关注 / 评论 / 私信 / 三连 / 发动态 / 改资料等会**真实修改账号状态**，
-执行前应先与用户确认。投币不可退回。
-
-## 遇到签名失效
-
-若请求报 `-403` / `-352`（WBI 签名失效），可调用 `bili_cache_clear` 清空缓存后重试；
-不影响 Cookie / 登录态。
+## 其它
+全部能力见各 `bili_*` 工具描述；写操作会真实修改账号状态，执行前先与用户确认。

package/README.md

@@ -72,7 +72,7 @@ const [ups, _] = await client.space.videos(574115689, 1, 10);
 - 包名 `dsh-shlr-bilitoolkit`（符合 `dsh-` 前缀约定），`package.json` 里声明了 `dsh.bundle.patch: ./cordis.patch.yml`，因此会被 dsh 识别为插件而非普通库。
 - 入口 `src/dsh.ts` 导出 `apply(ctx)`，注册一组工具（读取为主，写操作明确标注「需登录 / 谨慎」）：
   - 读取：`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_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_comment_like` / `bili_message_recall` / `bili_profile_update_sign` / `bili_profile_update`（均会真实修改账号状态，需登录）
   - 辅助：`bili_login_status`（查登录态）/ `bili_gen_qr`（生成扫码登录二维码）/ `bili_cache_clear`（清空本地缓存）
 - 工具读取 `BILI_COOKIE_FILE`（默认 `bili_data/bili_cookies.json`）作为登录态。
 - **数据目录**：Cookie / 缓存 / 二维码 / 设备号统一放在一个目录里，默认 `bili_data/`（相对 dsh 工作目录），避免散落污染工作目录。可用 `BILI_DATA_DIR` 改目录；`BILI_COOKIE_FILE` / `BILI_CACHE_FILE` / `BILI_QR_FILE` / `BILI_DEVICE_FILE` 可精确指定单个文件。设备号（私信 `dev_id`）会落盘到 `bili_data/bili_device.json`，跨重启保持稳定，避免被 B 站当成新设备触发风控。兼容旧版：若新目录还没有 Cookie、而旧位置（`./bili_cookies.json`）有，会继续沿用旧的。

package/dist/apis/comment.d.ts

@@ -19,19 +19,23 @@ export declare class CommentAPI {
     private send;
     private replies;
     private delete;
+    private like;
     listVideo(bvid: string, page?: number, pageSize?: number, sort?: string | number): Promise<[Comment[], number]>;
     iterVideo(bvid: string, pageSize?: number, sort?: string | number, maxPages?: number): AsyncGenerator<Comment, any, any>;
     sendVideo(bvid: string, message: string, root?: number | null, parent?: number | null): Promise<Comment>;
     replyVideo(bvid: string, rootRpid: number, message: string, parentRpid?: number | null): Promise<Comment>;
     repliesVideo(bvid: string, rootRpid: number, page?: number, pageSize?: number): Promise<[Comment[], number]>;
     deleteVideo(bvid: string, rpid: number): Promise<void>;
+    likeVideo(bvid: string, rpid: number, liked?: boolean): Promise<void>;
     listDynamic(dynamicId: string | number, page?: number, pageSize?: number, sort?: string | number): Promise<[Comment[], number]>;
     iterDynamic(dynamicId: string | number, pageSize?: number, sort?: string | number, maxPages?: number): AsyncGenerator<Comment, any, any>;
     sendDynamic(dynamicId: string | number, message: string, root?: number | null, parent?: number | null): Promise<Comment>;
     repliesDynamic(dynamicId: string | number, rootRpid: number, page?: number, pageSize?: number): Promise<[Comment[], number]>;
     deleteDynamic(dynamicId: string | number, rpid: number): Promise<void>;
+    likeDynamic(dynamicId: string | number, rpid: number, liked?: boolean): Promise<void>;
     listArticle(articleId: unknown, page?: number, pageSize?: number, sort?: string | number): Promise<[Comment[], number]>;
     sendArticle(articleId: unknown, message: string, root?: number | null, parent?: number | null): Promise<Comment>;
     repliesArticle(articleId: unknown, rootRpid: number, page?: number, pageSize?: number): Promise<[Comment[], number]>;
     deleteArticle(articleId: unknown, rpid: number): Promise<void>;
+    likeArticle(articleId: unknown, rpid: number, liked?: boolean): Promise<void>;
 }

package/dist/apis/comment.js

@@ -90,6 +90,15 @@ export class CommentAPI {
     async delete(oid, type, rpid, headers) {
         await this.client.post(endpoints.REPLY_DEL, { type, oid, rpid, csrf: this.client.csrf }, headers);
     }
+    async like(oid, type, rpid, liked = true, headers) {
+        await this.client.post(endpoints.REPLY_ACTION, {
+            oid,
+            type,
+            rpid: Number(rpid),
+            action: liked ? 1 : 2, // 1 点赞 / 2 取消
+            csrf: this.client.csrf,
+        }, headers);
+    }
     // ------------------------------------------------------------------ 视频
     async listVideo(bvid, page = 1, pageSize = 20, sort = "time") {
         CommentAPI.sortValue(sort); // 先校验，避免参数错误时还去请求 aid
@@ -117,6 +126,10 @@ export class CommentAPI {
         const aid = await this.client.video.resolveAid(bvid);
         await this.delete(aid, 1, rpid, CommentAPI.videoHeaders(bvid));
     }
+    async likeVideo(bvid, rpid, liked = true) {
+        const aid = await this.client.video.resolveAid(bvid);
+        await this.like(aid, 1, rpid, liked, CommentAPI.videoHeaders(bvid));
+    }
     // ------------------------------------------------------------------ 动态
     async listDynamic(dynamicId, page = 1, pageSize = 20, sort = "time") {
         CommentAPI.sortValue(sort);
@@ -141,6 +154,10 @@ export class CommentAPI {
         const [commentType, oid] = await this.dynamicTarget(dynamicId);
         await this.delete(Number(oid), commentType, rpid, CommentAPI.dynamicHeaders(dynamicId));
     }
+    async likeDynamic(dynamicId, rpid, liked = true) {
+        const [commentType, oid] = await this.dynamicTarget(dynamicId);
+        await this.like(Number(oid), commentType, rpid, liked, CommentAPI.dynamicHeaders(dynamicId));
+    }
     // ------------------------------------------------------------------ 专栏
     async listArticle(articleId, page = 1, pageSize = 20, sort = "time") {
         CommentAPI.sortValue(sort);
@@ -161,4 +178,8 @@ export class CommentAPI {
         const cvid = parseArticleId(articleId);
         await this.delete(cvid, 12, rpid, CommentAPI.articleHeaders(cvid));
     }
+    async likeArticle(articleId, rpid, liked = true) {
+        const cvid = parseArticleId(articleId);
+        await this.like(cvid, 12, rpid, liked, CommentAPI.articleHeaders(cvid));
+    }
 }

package/dist/dsh.js

@@ -854,6 +854,35 @@ export const TOOLS = [
             return { ok: true };
         },
     },
+    {
+        id: "bili_comment_like",
+        description: "给一条评论点赞或取消点赞（写操作，需登录）。",
+        parameters: {
+            type: "object",
+            properties: {
+                target: { type: "string", enum: ["video", "dynamic", "article"], default: "video" },
+                id: { type: "string" },
+                rpid: { type: "integer" },
+                liked: { type: "boolean", default: true },
+            },
+            required: ["id", "rpid"],
+        },
+        handler: async (a) => {
+            const c = await getClient();
+            const target = String(a.target ?? "video");
+            const rpid = Number(a.rpid);
+            const liked = Boolean(a.liked ?? true);
+            if (target === "video")
+                await c.comment.likeVideo(a.id, rpid, liked);
+            else if (target === "dynamic")
+                await c.comment.likeDynamic(a.id, rpid, liked);
+            else if (target === "article")
+                await c.comment.likeArticle(a.id, rpid, liked);
+            else
+                throw new Error("target 只支持 video / dynamic / article");
+            return { ok: true };
+        },
+    },
     // ---- 消息中心补充 ----
     {
         id: "bili_notify_ats",

package/dist/endpoints.d.ts

@@ -50,6 +50,7 @@ export declare const REPLY_LIST = "https://api.bilibili.com/x/v2/reply";
 export declare const REPLY_ADD = "https://api.bilibili.com/x/v2/reply/add";
 export declare const REPLY_DEL = "https://api.bilibili.com/x/v2/reply/del";
 export declare const REPLY_REPLY = "https://api.bilibili.com/x/v2/reply/reply";
+export declare const REPLY_ACTION = "https://api.bilibili.com/x/v2/reply/action";
 export declare const IM_SEND = "https://api.vc.bilibili.com/web_im/v1/web_im/send_msg";
 export declare const IM_FETCH = "https://api.vc.bilibili.com/svr_sync/v1/svr_sync/fetch_session_msgs";
 export declare const IM_UNREAD = "https://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread";

package/dist/endpoints.js

@@ -63,6 +63,7 @@ export const REPLY_LIST = `${API_BASE}/x/v2/reply`;
 export const REPLY_ADD = `${API_BASE}/x/v2/reply/add`;
 export const REPLY_DEL = `${API_BASE}/x/v2/reply/del`;
 export const REPLY_REPLY = `${API_BASE}/x/v2/reply/reply`;
+export const REPLY_ACTION = `${API_BASE}/x/v2/reply/action`;
 // ---- 私信 ----
 export const IM_SEND = `${VC_BASE}/web_im/v1/web_im/send_msg`;
 export const IM_FETCH = `${VC_BASE}/svr_sync/v1/svr_sync/fetch_session_msgs`;

package/package.json

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