dsh-shlr-bilitoolkit 0.1.12 → 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/package.json

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