dsh-shlr-bilitoolkit 0.1.19 → 0.1.21

package/AGENTS.md

@@ -6,5 +6,4 @@
 禁止只给链接、用 ASCII、让用户自己跑命令。用户确认后调 bili_login_status 完成登录。
 
 ## 其它
-- 非常驻的 B 站能力懒加载：`bili_open()` 看分组，`bili_open({ group })` 打开（下一轮生效）。
-- 写操作会真实修改账号状态，执行前先与用户确认。
+写操作（点赞 / 收藏 / 投币 / 关注 / 评论 / 私信 / 三连 / 发动态 / 改资料）会真实修改账号状态，执行前先与用户确认。

package/README.md

@@ -1,98 +1,129 @@
 # dsh-shlr-bilitoolkit
 
-B 站（哔哩哔哩）接口封装的 **TypeScript** 移植版，作为 [dsh](https://dshmp.com)（DeepSeek Harness）插件提供「视频 / 搜索 / 空间 / 专栏 / 动态 / 评论 / 关注 / 消息中心」等读取能力，以及点赞、收藏、投币、关注、评论、私信、三连、发动态等写操作。
+0.1.15-0.1.19为工具懒加载版，
 
-> 本项目从原 Python 工具箱（`bili/`）完整移植而来，并作为 dsh（cordis 体系）插件提供上述能力。
+B 站（哔哩哔哩）接口封装的 **TypeScript** 移植版，作为 [dsh](https://dshmp.com)（DeepSeek Harness）插件提供「视频 / 搜索 / 空间」等读取能力。
 
-## 安装
+> 本项目从原 Python 工具箱（`bili/`）完整移植而来，覆盖视频、搜索、空间、评论、私信、互动（点赞/收藏/投币/关注/三连）、动态、专栏、关注关系、消息中心、个人资料与扫码登录，并作为 [dsh](https://dshmp.com)（DeepSeek Harness）插件提供上述能力。
 
-```bash
-# 已发布到 npm
-dsh plugin --profile <name> add dsh-shlr-bilitoolkit@latest
+## 目录结构
 
-# 本地开发 / 试运行
-npm install
-npm run build
+```
+dsh-shlr-bilitoolkit/
+├── src/
+│   ├── client.ts        # BiliClient：Session / Cookie / 请求 / 节流 / 重试 / 风控 / 表单编码
+│   ├── wbi.ts           # WbiSigner：w_rid / wts 签名（含官方 mixin_key 算法）
+│   ├── errors.ts        # BiliApiError / CaptchaRequired / CookieError
+│   ├── models.ts        # Video / Article / Comment / PrivateMessage / RelationUser /
+│   │                    #   Dynamic / Notice / User / Page / PlayInfo / Subtitle / Collection
+│   ├── formatting.ts    # 播放量、时长、HTML 清理等展示格式化
+│   ├── pagination.ts    # iterPages：统一翻页异步生成器
+│   ├── endpoints.ts     # 所有接口 URL 常量
+│   ├── apis/
+│   │   ├── video.ts     # 推荐流 / 详情 / 分P / 播放地址 / 字幕
+│   │   ├── search.ts    # 搜索视频 / 用户
+│   │   ├── space.ts     # 空间信息 / 投稿 / 合集
+│   │   ├── comment.ts   # 评论：视频/动态/专栏 的读取与发表/回复/删除
+│   │   ├── message.ts   # 私信：发送 / 撤回 / 记录 / 未读
+│   │   ├── interact.ts  # 点赞 / 收藏 / 投币 / 关注 / 三连
+│   │   ├── dynamic.ts   # 动态：关注流 / 空间 / 发布 / 转发 / 点赞 / 删除
+│   │   ├── article.ts   # 专栏：详情 / UP 主列表
+│   │   ├── relation.ts  # 关注 / 粉丝 / 统计
+│   │   ├── notify.ts    # 消息中心：未读 / 回复我的 / @我的 / 收到的赞
+│   │   ├── profile.ts   # 个人资料：读取 / 改签名 / 改昵称性别生日
+│   │   ├── auth.ts      # 扫码登录（generate / poll / wait / login）
+│   │   └── download.ts  # 下载与 ffmpeg 合并工具
+│   ├── dsh.ts           # dsh 插件入口：apply(ctx) + 工具列表
+│   └── index.ts         # 对外导出
+├── tests/               # 离线单测（wbi 签名、格式化、模型）
+├── cordis.patch.yml     # dsh bundle 的配置补丁
+├── dsh-manifest.json    # 市场目录收录清单（schema v1）
+├── package.json         # 含 dsh.bundle.patch 声明
+└── tsconfig.json
 ```
 
-本地登录（独立获取 Cookie，终端打印 ASCII 二维码）：
+## 构建与测试
 
 ```bash
-npm install && npm run login
-# 或指定 Cookie 文件
-BILI_COOKIE_FILE=./my_cookies.json npm run login
+npm install
+npm run typecheck      # tsc --noEmit
+npm test               # 离线单测（node --test + tsx）
+npm run build          # 产出 dist/
 ```
 
-## 插件入口
-
-对齐官方 cordis 规范：`src/dsh.ts` 导出 `name` / `inject = ["tools"]` / `apply(ctx)`，在 `apply` 内用官方 `ctx.tools.register(defineTool({ name, description, parameters, output, execute }))` 注册每个工具。`defineTool` 来自 `@deepseek-ai/dsh-tools`，由宿主提供、插件不打包（保证单实例），已在 `peerDependencies` 声明。`cordis.patch.yml` 为组合包配置层（`- insert: - id: bili  name: dsh-shlr-bilitoolkit`，按包名解析到 `main`）。较旧、没有 `ctx.tools` 的 dsh 仍保留 `ctx.registerTool` / `ctx.services.tools.register` 回退。
+> 说明：`tsconfig` 使用 `moduleResolution: Bundler`，相对导入不带扩展名，适合被 dsh 运行时（基于打包器的 cordis 应用）消费。若要在原生 Node ESM 下直接 `node dist/index.js`，需改用 `NodeNext` 并补 `.js` 扩展名。
 
-## 工具清单
+## 当作库用
 
-同类能力已用参数合并（`type` / `target` / `action` / `list`），**功能未减少**。
+```ts
+import { BiliClient } from "dsh-shlr-bilitoolkit";
 
-- **读取**：
-  `bili_recommend` · `bili_video_detail` · `bili_video_subtitle` · `bili_search` · `bili_space_info` · `bili_space_videos` · `bili_article_view` · `bili_article_list` · `bili_dynamic_feed` · `bili_dynamic_space` · `bili_comment_list` · `bili_relation_list` · `bili_notify_unread` · `bili_notify_list` · `bili_fav_folders` · `bili_video_pagelist` · `bili_video_playurl` · `bili_video_status` · `bili_space_collections` · `bili_space_collection` · `bili_fav_folder_videos` · `bili_dynamic_detail` · `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_message` · `bili_triple` · `bili_dynamic_publish` · `bili_dynamic_repost` · `bili_coin` · `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`
-- **辅助**：`bili_login_status`（查登录态）· `bili_gen_qr`（生成登录二维码）· `bili_cache_clear`（清空本地缓存）
+const client = new BiliClient({ cookieFile: "bili_cookies.json" });
+await client.loadCookies();
 
-合并工具的公共参数约定：
-
-| 工具 | 参数 |
-| --- | --- |
-| `bili_search` | `type=video\|user`，`order`（仅视频） |
-| `bili_relation_list` | `type=followings\|followers` |
-| `bili_notify_list` | `type=replies\|ats\|likes` |
-| `bili_favorite` | `action=add\|remove` |
-| `bili_video_subtitle` | `list=true` 时列字幕轨，否则取正文 |
-| `bili_comment_*` | `target=video\|dynamic\|article`，`id`（bvid / 动态 id / 专栏 cv 号） |
-| `bili_profile_update` | `uname` / `sex` / `birthday` / `sign`（至少一项） |
+const videos = await client.video.recommend(2, 10);
+const detail = await client.video.detail("BV1xx411c7mD");
+const text   = await client.video.subtitleText("BV1xx411c7mD"); // 字幕纯文本
+const [videos2, total] = await client.search.videos("孤独摇滚");
+const info = await client.space.info(574115689);
+const [ups, _] = await client.space.videos(574115689, 1, 10);
+```
 
-## 数据目录
+## 作为 dsh 插件
 
-Cookie / 缓存 / 二维码 / 设备号统一放在一个目录，默认 `bili_data/`（相对 dsh 工作目录），避免散落污染工作目录：
+- 包名 `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_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`）有，会继续沿用旧的。
+- **扫码登录（独立获取 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 / 登录态）。
+- **计费 / 缓存与懒加载**：默认**稳定注册全部工具**，让 prompt 前缀保持不变、最大化 DeepSeek 前缀缓存命中（未命中价 ≈ 命中价 50 倍，中途改工具列表反而更贵）。列表类工具默认**精简返回**（`full=true` 取全量）。如确认提供商不做前缀缓存、想极致压缩每轮 schema，设 `BILI_LAZY=1` 开启懒加载（常驻核心 + `bili_open` 按需开组，下一轮生效）。
 
-| 文件 | 用途 |
-| --- | --- |
-| `bili_cookies.json` | 登录 Cookie（`SESSDATA` / `bili_jct`） |
-| `bili_cache.json` | WBI 签名密钥 + `bvid→aid` 缓存（原子写、损坏自愈） |
-| `bili_qrcode.png` | 最近一次生成的登录二维码 |
-| `bili_device.json` | 私信设备号 `dev_id`（跨重启稳定，降低风控） |
+> **给 Agent 的约定**：仓库根目录的 [`AGENTS.md`](./AGENTS.md) 写明了登录流程——需要登录时必须调用 `bili_gen_qr` 并把二维码**图片**展示给用户，而不是只给链接或 ASCII。把这份 `AGENTS.md` 放到 dsh 的工作目录（或确保你的 dsh 会读取它），agent 就会按约定输出登录二维码。
 
-可用环境变量：`BILI_DATA_DIR`（改目录）、`BILI_COOKIE_FILE` / `BILI_CACHE_FILE` / `BILI_QR_FILE` / `BILI_DEVICE_FILE`（精确指定单个文件）。兼容旧版：若新目录还没有 Cookie、而旧位置 `./bili_cookies.json` 有，会继续沿用。
+安装到 dsh（任选其一，取决于你的发行方式）：
 
-## 给 Agent 的约定
+```bash
+dsh plugin --profile <name> add dsh-shlr-bilitoolkit          # 已发布到 npm
+dsh plugin --profile <name> add github:your-name/dsh-shlr-bilitoolkit#<ref>
+```
 
-仓库根目录的 [`AGENTS.md`](./AGENTS.md) 约定：需要登录时必须调用 `bili_gen_qr` 并把二维码**图片**展示给用户（而非只给链接或 ASCII）。把该 `AGENTS.md` 放到 dsh 工作目录，agent 即会遵守。
+> 插件入口已对齐 **官方 DeepSeek Harness（cordis 体系）** 的约定：模块导出 `name` / `inject = ["tools"]` / `apply(ctx)`，并在 `apply` 内用官方 `ctx.tools.register(defineTool({ name, description, parameters, output, execute }))` 注册每个工具（`defineTool` 来自 `@deepseek-ai/dsh-tools`，由宿主提供、插件不打包，保证单实例）。`parameters` 用官方简化 schema（`{ 参数名: { type, required, description, enum? } }`），工具返回规范 JSON 值，由 `output.render` 转成面向模型的文本。`cordis.patch.yml` 是官方组合包配置层（`- insert: - id: bili  name: dsh-shlr-bilitoolkit`，按包名解析到 `main` 入口）。若你的 dsh 版本较旧、没有 `ctx.tools`，`apply` 仍保留了 `ctx.registerTool` / `ctx.services.tools.register` 的回退路径。
 
-## 目录结构
+## 与原 Python 版的对应关系
 
-```
-src/
-  client.ts      BiliClient：Session / Cookie / 请求 / 节流 / 重试 / 风控 / 表单编码
-  wbi.ts         WbiSigner：w_rid / wts 签名（官方 mixin_key 算法，密钥落盘缓存 6h）
-  cache.ts       JsonCache：本地 JSON 缓存（TTL / 原子写 / 损坏自愈）
-  errors.ts      BiliApiError / CaptchaRequired / CookieError
-  models.ts      纯数据模型 + toDict()
-  formatting.ts  播放量 / 时长 / HTML 清理等展示格式化
-  pagination.ts  iterPages：统一分页异步生成器
-  endpoints.ts   所有接口 URL 常量
-  apis/          video / search / space / comment / message / interact / dynamic /
-                 article / relation / notify / profile / auth / download
-  dsh.ts         dsh 插件入口：apply(ctx) + 工具清单
-  index.ts       对外导出
-tests/           离线单测（wbi 签名、格式化、缓存、lossless JSON 等）
-cordis.patch.yml dsh 组合包配置层
-scripts/login.ts npm run login 扫码登录脚本
-```
+| Python | TS |
+| --- | --- |
+| `bili/client.py` | `src/client.ts` |
+| `bili/wbi.py` | `src/wbi.ts` |
+| `bili/video.py` | `src/apis/video.ts` |
+| `bili/search.py` | `src/apis/search.ts` |
+| `bili/space.py` | `src/apis/space.ts` |
+| `bili/comment.py` | `src/apis/comment.ts` |
+| `bili/message.py` | `src/apis/message.ts` |
+| `bili/interact.py` | `src/apis/interact.ts` |
+| `bili/dynamic.py` | `src/apis/dynamic.ts` |
+| `bili/article.py` | `src/apis/article.ts` |
+| `bili/relation.py` | `src/apis/relation.ts` |
+| `bili/notify.py` | `src/apis/notify.ts` |
+| `bili/profile.py` | `src/apis/profile.ts` |
+| `bili/auth.py` | `src/apis/auth.ts` |
+| `bili/download.py` | `src/apis/download.ts` |
+| `bili/models.py` | `src/models.ts` |
+| `bili/formatting.py` | `src/formatting.ts` |
+| `bili/pagination.py` | `src/pagination.ts` |
+
+约定保持一致：`client.xxx.yyy()` 调用风格、`iter_*` 异步生成器、`toDict()` 导出、WBI 签名算法与密钥 6 小时缓存（已落地到 `bili_cache.json`，跨进程复用）。
 
 ## 与原 Python 版的差异 / 已知限制
 
-- **写接口为表单编码**：`client.post` 默认把对象编码为 `application/x-www-form-urlencoded`，仅动态点赞等少数接口显式走 JSON（`jsonBody=true`）。
-- **动态仅支持纯文字**：带图 / 投票 / 预约的富动态需额外图片上传流程，暂未实现。
-- **下载 / ffmpeg**：`src/apis/download.ts` 为纯工具函数，未接入 dsh 工具。
+- **写接口为表单编码**：原 Python 用 `requests` 的 `data=` 默认表单；本包的 `client.post` 默认把对象编码为 `application/x-www-form-urlencoded`，仅动态点赞等少数接口显式走 JSON（`jsonBody=true`）。
+- **图文动态**：`bili_dynamic_publish` 支持「文字 + 本地图片」（先上传 B 站动态图床拿到 url/尺寸，再带 `pictures` 以 type=2 创建）。上传 / pictures 组装按社区通用接口实现，**未在真实账号验证**；若失败请把报错码反馈回来校准。
+- **下载 / ffmpeg**：`src/apis/download.ts` 提供 `downloadUrl` / `mergeWithFfmpeg`，为纯工具函数，未接入 dsh 工具（下载行为在 dsh 里通常不合适）。
 
 ## 风控说明
 
-内置与原 Python 版一致的基础降风控策略：请求节流（默认 0.6s + 0~0.4s 抖动）、GET 退避重试、写操作不重试、HTTP 412 / `-412` 立即停手、WBI 签名。但单账号操作量上限、避免短时间切 IP/UA 等仍需使用习惯配合。设备号 `dev_id` 已落盘保持稳定。
+本包内置与原 Python 版一致的基础降风控策略：请求节流（默认 0.6s + 0~0.4s 抖动）、GET 退避重试、写操作不重试、HTTP 412 / `-412` 立即停手、WBI 签名。但单账号操作量上限、避免短时间切 IP/UA 等仍需使用习惯配合。

package/dist/apis/dynamic.d.ts

@@ -15,6 +15,13 @@ export declare class DynamicAPI {
     iterFeed(maxPages?: number, type?: string): AsyncGenerator<Dynamic>;
     iterSpace(uid: number, maxPages?: number): AsyncGenerator<Dynamic>;
     publish(text: string, atUids?: number[], ctrl?: any[], closeComment?: boolean): Promise<string>;
+    /** 上传单张图片到 B 站动态图床，返回 pictures 需要的一段信息。 */
+    private uploadImage;
+    /** 发布图文动态（文字 + 最多若干张图片）。图片可以是本地路径或 Buffer。 */
+    publishWithImages(text: string, images: Array<string | Buffer>, opts?: {
+        atUids?: number[];
+        closeComment?: boolean;
+    }): Promise<string>;
     repost(dynamicId: string | number, text?: string): Promise<string>;
     thumb(dynamicId: string | number, liked?: boolean): Promise<void>;
     delete(dynamicId: string | number): Promise<void>;

package/dist/apis/dynamic.js

@@ -3,9 +3,13 @@
 读取走网页版 polymer 接口，需要登录态。写操作（publish / repost / thumb /
 delete）都是公开行为，受风控和人机验证限制，使用前请自行确认。
 */
+import { readFile } from "node:fs/promises";
+import { basename } from "node:path";
+import FormData from "form-data";
 import * as endpoints from "../endpoints.js";
 import { BiliApiError } from "../errors.js";
 import { Dynamic } from "../models.js";
+import { guessImageType } from "../util.js";
 const FEATURES = "itemOpusStyle";
 const REFERER = "https://t.bilibili.com/";
 export class DynamicAPI {
@@ -106,6 +110,70 @@ export class DynamicAPI {
         const payload = await this.client.post(endpoints.DYNAMIC_CREATE, form, { Referer: REFERER });
         return DynamicAPI.dynamicId(payload);
     }
+    /** 上传单张图片到 B 站动态图床，返回 pictures 需要的一段信息。 */
+    async uploadImage(img) {
+        let bytes;
+        let name = "image.png";
+        if (Buffer.isBuffer(img)) {
+            bytes = img;
+        }
+        else {
+            bytes = await readFile(String(img));
+            name = basename(String(img));
+        }
+        // 动态图床上传是 multipart，用 form-data 包（Node 下 axios 靠它正确序列化二进制）
+        const form = new FormData();
+        form.append("biz", "draw");
+        form.append("csrf", this.client.csrf);
+        form.append("file_up", bytes, { filename: name, contentType: guessImageType(name) });
+        const resp = await this.client.http.post(endpoints.DYNAMIC_IMAGE_UPLOAD, form, {
+            headers: { ...form.getHeaders(), Referer: REFERER },
+            maxContentLength: Infinity,
+            maxBodyLength: Infinity,
+        });
+        const data = resp?.data ?? {};
+        const raw = data.data;
+        const url = typeof raw === "string" ? raw : raw?.url;
+        if (data.code !== 0 || !url) {
+            throw new BiliApiError(`图片上传失败: ${data.message ?? "接口未返回 url"}`, data.code, raw);
+        }
+        const meta = raw && typeof raw === "object" ? raw : {};
+        return {
+            img_src: String(url),
+            img_width: Number(meta.image_width ?? meta.width ?? 0),
+            img_height: Number(meta.image_height ?? meta.height ?? 0),
+            // 接口有时不返回体积，用字节数兜底（KB）
+            img_size: Number(meta.img_size ?? Math.round(bytes.length / 1024)),
+        };
+    }
+    /** 发布图文动态（文字 + 最多若干张图片）。图片可以是本地路径或 Buffer。 */
+    async publishWithImages(text, images, opts = {}) {
+        text = (text || "").trim();
+        const pics = [];
+        for (const img of images ?? []) {
+            pics.push(await this.uploadImage(img));
+        }
+        if (!text && !pics.length)
+            throw new Error("动态内容不能为空");
+        const extension = { emoji_type: 1, from: { emoji_type: 1 }, flag_cfg: {} };
+        const form = {
+            dynamic_id: 0,
+            type: pics.length ? 2 : 4, // 2 = 图文，4 = 纯文字
+            rid: 0,
+            content: text,
+            up_choose_comment: 0,
+            up_close_comment: opts.closeComment ? 1 : 0,
+            extension: JSON.stringify(extension),
+            at_uids: (opts.atUids ?? []).map(String).join(","),
+            ctrl: JSON.stringify([]),
+            csrf: this.client.csrf,
+            csrf_token: this.client.csrf,
+        };
+        if (pics.length)
+            form["pictures"] = JSON.stringify(pics);
+        const payload = await this.client.post(endpoints.DYNAMIC_CREATE, form, { Referer: REFERER });
+        return DynamicAPI.dynamicId(payload);
+    }
     async repost(dynamicId, text = "") {
         const form = {
             dynamic_id: String(Math.floor(Number(dynamicId))),

package/dist/apis/profile.d.ts

@@ -12,4 +12,8 @@ export declare class ProfileAPI {
     avatarUrl(): Promise<string>;
     updateSign(sign: string): Promise<void>;
     updateProfile(uname?: string, sex?: string, birthday?: string): Promise<void>;
+    /** 上传头像图片到 B 站图床，返回可用的图片 URL。 */
+    private uploadFaceUrl;
+    /** 更换头像：先上传图片拿 URL，再调 face/update。img 为本地路径或 Buffer。 */
+    changeAvatar(img: string | Buffer): Promise<void>;
 }

package/dist/apis/profile.js

@@ -4,7 +4,12 @@
 - updateSign 用的是 x/member/web/sign/update，改完进入审核队列。
 - updateProfile 用的是 x/member/web/update，只支持昵称、性别、生日。
 */
+import { readFile } from "node:fs/promises";
+import { basename } from "node:path";
+import FormData from "form-data";
 import * as endpoints from "../endpoints.js";
+import { BiliApiError } from "../errors.js";
+import { guessImageType } from "../util.js";
 const SEX_VALUES = ["男", "女", "保密"];
 const MAX_SIGN_LENGTH = 70;
 export class ProfileAPI {
@@ -56,4 +61,41 @@ export class ProfileAPI {
         }
         await this.client.post(endpoints.MEMBER_PROFILE_UPDATE, form);
     }
+    /** 上传头像图片到 B 站图床，返回可用的图片 URL。 */
+    async uploadFaceUrl(img) {
+        let bytes;
+        let name = "avatar.png";
+        if (Buffer.isBuffer(img)) {
+            bytes = img;
+        }
+        else {
+            bytes = await readFile(String(img));
+            name = basename(String(img));
+        }
+        const form = new FormData();
+        form.append("biz", "draw");
+        form.append("csrf", this.client.csrf);
+        form.append("file_up", bytes, { filename: name, contentType: guessImageType(name) });
+        const resp = await this.client.http.post(endpoints.DYNAMIC_IMAGE_UPLOAD, form, {
+            headers: { ...form.getHeaders(), Referer: "https://space.bilibili.com/" },
+            maxContentLength: Infinity,
+            maxBodyLength: Infinity,
+        });
+        const data = resp?.data ?? {};
+        const raw = data.data;
+        const url = typeof raw === "string" ? raw : raw?.url;
+        if (data.code !== 0 || !url) {
+            throw new BiliApiError(`头像图片上传失败: ${data.message ?? "接口未返回 url"}`, data.code, raw);
+        }
+        return String(url);
+    }
+    /** 更换头像：先上传图片拿 URL，再调 face/update。img 为本地路径或 Buffer。 */
+    async changeAvatar(img) {
+        const face = await this.uploadFaceUrl(img);
+        await this.client.post(endpoints.MEMBER_FACE_UPDATE, {
+            face,
+            csrf: this.client.csrf,
+            csrf_token: this.client.csrf,
+        });
+    }
 }

package/dist/dsh.js

@@ -474,11 +474,15 @@ export const TOOLS = [
     // ---- 动态（写操作，需登录，会公开展示在主页） ----
     {
         id: "bili_dynamic_publish",
-        description: "发布一条文字动态（写操作，需登录，会公开展示在你的主页）。返回动态 id 与链接。",
+        description: "发布动态：纯文字，或文字+图片（写操作，需登录，会公开展示在你的主页）。图片传本地文件路径（多个用逗号 / 换行分隔）。返回动态 id 与链接。",
         parameters: {
             type: "object",
             properties: {
-                content: { type: "string", description: "动态正文文字内容" },
+                content: { type: "string", description: "动态正文（可与图片同时，也可仅发图片）" },
+                images: {
+                    type: "string",
+                    description: "本地图片路径，多个用逗号 / 换行分隔（可选，带图即发图文动态）",
+                },
                 atUids: {
                     type: "string",
                     description: "要 @ 的用户 uid，多个用逗号分隔（可选）",
@@ -489,7 +493,6 @@ export const TOOLS = [
                     description: "是否关闭评论",
                 },
             },
-            required: ["content"],
         },
         handler: async (a) => {
             const c = await getClient();
@@ -497,7 +500,20 @@ export const TOOLS = [
                 .split(/[,，\s]+/)
                 .map((s) => Number(s.trim()))
                 .filter((n) => Number.isFinite(n) && n > 0);
-            const id = await c.dynamic.publish(String(a.content ?? ""), atUids, undefined, Boolean(a.closeComment ?? false));
+            const images = String(a.images ?? "")
+                .split(/[,，\n]+/)
+                .map((s) => s.trim())
+                .filter(Boolean);
+            const content = String(a.content ?? "");
+            if (!content.trim() && !images.length) {
+                throw new Error("动态内容不能为空：至少提供正文或图片");
+            }
+            const id = images.length
+                ? await c.dynamic.publishWithImages(content, images, {
+                    atUids,
+                    closeComment: Boolean(a.closeComment ?? false),
+                })
+                : await c.dynamic.publish(content, atUids, undefined, Boolean(a.closeComment ?? false));
             return { ok: true, dynamicId: id, url: `https://t.bilibili.com/${id}` };
         },
     },
@@ -955,7 +971,7 @@ export const TOOLS = [
     },
     {
         id: "bili_profile_update",
-        description: "修改我的昵称 / 性别 / 生日 / 签名（写操作，需登录，至少改一项）。",
+        description: "修改我的昵称 / 性别 / 生日 / 签名 / 头像（写操作，需登录，至少改一项）。头像传本地图片路径。",
         parameters: {
             type: "object",
             properties: {
@@ -963,19 +979,24 @@ export const TOOLS = [
                 sex: { type: "string", enum: ["男", "女", "保密"] },
                 birthday: { type: "string", description: "YYYY-MM-DD" },
                 sign: { type: "string", description: "个性签名（≤70 字）" },
+                avatar: { type: "string", description: "新头像的本地图片路径" },
             },
         },
         handler: async (a) => {
             const c = await getClient();
             const hasProfile = a.uname != null || a.sex != null || a.birthday != null;
-            if (a.sign == null && !hasProfile) {
-                throw new Error("至少修改一项：uname / sex / birthday / sign");
+            const hasSign = a.sign != null;
+            const hasAvatar = a.avatar != null && String(a.avatar).trim() !== "";
+            if (!hasSign && !hasProfile && !hasAvatar) {
+                throw new Error("至少修改一项：uname / sex / birthday / sign / avatar");
             }
-            if (a.sign != null)
+            if (hasSign)
                 await c.profile.updateSign(String(a.sign));
             if (hasProfile) {
                 await c.profile.updateProfile(a.uname != null ? String(a.uname) : undefined, a.sex != null ? String(a.sex) : undefined, a.birthday != null ? String(a.birthday) : undefined);
             }
+            if (hasAvatar)
+                await c.profile.changeAvatar(String(a.avatar));
             return { ok: true };
         },
     },
@@ -1276,21 +1297,23 @@ function registerOne(ctx, tool) {
     }
 }
 export function apply(ctx) {
-    // 捕获工具注册表，供 bili_open 动态注册 / bili_close 卸载
+    // 捕获工具注册表，供懒加载模式下的 bili_open 动态注册
     toolsRegistry =
         ctx?.tools && typeof ctx.tools.register === "function" ? ctx.tools : null;
-    // 懒加载机制工具始终注册
-    for (const t of lazyTools)
-        registerOne(ctx, t);
-    // BILI_LAZY=0 可强制关闭懒加载（全部注册），用于兜底
-    const lazyDisabled = process.env.BILI_LAZY === "0" || process.env.BILI_LAZY === "false";
-    if (!toolsRegistry || lazyDisabled) {
-        // 运行时不支持动态注册 / 手动关闭：退化为全部注册（功能完整，但不省 token）
+    // 默认：稳定注册全部工具——让 prompt 前缀保持不变、最大化 DeepSeek 前缀缓存命中。
+    // （缓存未命中价 ≈ 命中价 50 倍；工具 schema 在前缀里是命中价、成本可忽略，
+    //   中途改工具列表反而造成未命中、更贵。）只有确认提供商不做前缀缓存、
+    //   想极致压缩每轮 schema 时，才用 BILI_LAZY=1 开启懒加载。
+    const lazyEnabled = !!toolsRegistry &&
+        (process.env.BILI_LAZY === "1" || process.env.BILI_LAZY === "true");
+    if (!lazyEnabled) {
         for (const t of TOOLS)
             registerOne(ctx, t);
         return;
     }
-    // 仅注册常驻核心，其余按需通过 bili_open 打开
+    // 懒加载模式：注册机制工具 + 常驻核心，其余按需 bili_open 打开
+    for (const t of lazyTools)
+        registerOne(ctx, t);
     for (const id of CORE_IDS) {
         const t = TOOL_BY_ID.get(id);
         if (t)

package/dist/endpoints.d.ts

@@ -39,6 +39,7 @@ export declare const MEMBER_ACCOUNT = "https://api.bilibili.com/x/member/web/acc
 export declare const MEMBER_MYINFO = "https://api.bilibili.com/x/space/myinfo";
 export declare const MEMBER_SIGN_UPDATE = "https://api.bilibili.com/x/member/web/sign/update";
 export declare const MEMBER_PROFILE_UPDATE = "https://api.bilibili.com/x/member/web/update";
+export declare const MEMBER_FACE_UPDATE = "https://api.bilibili.com/x/member/web/face/update";
 export declare const DYNAMIC_FEED_ALL = "https://api.bilibili.com/x/polymer/web-dynamic/v1/feed/all";
 export declare const DYNAMIC_FEED_SPACE = "https://api.bilibili.com/x/polymer/web-dynamic/v1/feed/space";
 export declare const DYNAMIC_DETAIL = "https://api.bilibili.com/x/polymer/web-dynamic/v1/detail";
@@ -46,6 +47,7 @@ export declare const DYNAMIC_CREATE = "https://api.vc.bilibili.com/dynamic_svr/v
 export declare const DYNAMIC_REPUBLISH = "https://api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/republish";
 export declare const DYNAMIC_DELETE = "https://api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/rm_dynamic";
 export declare const DYNAMIC_THUMB = "https://api.bilibili.com/x/dynamic/feed/dyn/thumb";
+export declare const DYNAMIC_IMAGE_UPLOAD = "https://api.bilibili.com/x/dynamic/feed/draw/upload_bfs";
 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";

package/dist/endpoints.js

@@ -50,6 +50,7 @@ export const MEMBER_ACCOUNT = `${API_BASE}/x/member/web/account`;
 export const MEMBER_MYINFO = `${API_BASE}/x/space/myinfo`;
 export const MEMBER_SIGN_UPDATE = `${API_BASE}/x/member/web/sign/update`;
 export const MEMBER_PROFILE_UPDATE = `${API_BASE}/x/member/web/update`;
+export const MEMBER_FACE_UPDATE = `${API_BASE}/x/member/web/face/update`;
 // ---- 动态 ----
 export const DYNAMIC_FEED_ALL = `${API_BASE}/x/polymer/web-dynamic/v1/feed/all`;
 export const DYNAMIC_FEED_SPACE = `${API_BASE}/x/polymer/web-dynamic/v1/feed/space`;
@@ -58,6 +59,7 @@ export const DYNAMIC_CREATE = `${VC_BASE}/dynamic_svr/v1/dynamic_svr/create`;
 export const DYNAMIC_REPUBLISH = `${VC_BASE}/dynamic_svr/v1/dynamic_svr/republish`;
 export const DYNAMIC_DELETE = `${VC_BASE}/dynamic_svr/v1/dynamic_svr/rm_dynamic`;
 export const DYNAMIC_THUMB = `${API_BASE}/x/dynamic/feed/dyn/thumb`;
+export const DYNAMIC_IMAGE_UPLOAD = `${API_BASE}/x/dynamic/feed/draw/upload_bfs`;
 // ---- 评论 ----
 export const REPLY_LIST = `${API_BASE}/x/v2/reply`;
 export const REPLY_ADD = `${API_BASE}/x/v2/reply/add`;

package/dist/util.d.ts

@@ -1,2 +1,4 @@
 /** 小工具函数。 */
 export declare function sleep(ms: number): Promise<void>;
+/** 根据文件名猜图片 MIME，用于 multipart 上传（缺省按 jpeg）。 */
+export declare function guessImageType(name: string): string;

package/dist/util.js

@@ -2,3 +2,16 @@
 export function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
+const IMAGE_TYPES = {
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    gif: "image/gif",
+    webp: "image/webp",
+    bmp: "image/bmp",
+};
+/** 根据文件名猜图片 MIME，用于 multipart 上传（缺省按 jpeg）。 */
+export function guessImageType(name) {
+    const ext = (name.toLowerCase().split(".").pop() ?? "").trim();
+    return IMAGE_TYPES[ext] ?? "image/jpeg";
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-shlr-bilitoolkit",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "description": "深海猎人专用B站接口工具箱 dsh 插件。",
   "type": "module",
   "main": "dist/dsh.js",
@@ -23,10 +23,11 @@
   },
   "dependencies": {
     "axios": "^1.7.0",
+    "form-data": "^4.0.6",
     "qrcode": "^1.5.4"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "0.0.1-rc.1",
+    "@deepseek-ai/cordis": "^4.0.5",
     "@deepseek-ai/dsh-tools": "0.0.1-rc.1",
     "@types/node": "^22.0.0",
     "@types/qrcode": "^1.5.5",