yz-yuki-plugin v2.0.5-13

YUKI-PLUGIN

• 一个适用于 Yunzai 系列机器人框架 的B站动态和微博动态订阅推送的插件

• 支持 群聊/私聊 订阅B站动态和微博动态，支持定时推送，支持手动触发推送，支持简单查询B站/微博用户信息。

🌰一、安装插件

选择安装方式

按照网络情况以及使用的bot框架是Yunzaijs还是Yunzai-V3，选择对应的安装方式。

（一）YunzaiJS

选择其中一种方式安装插件：

1. npm包安装到yunzaijs/node_modules的方式，仅YunzaiJS支持：

 yarn add yz-yuki-plugin -W

选择启用插件方式：

• 方式1（推荐）：

手动新建 yunzaijs/yunzai.config.json 文件，输入如下内容，applications字段添加的 "yz-yuki-plugin"即为启用本插件：

{
  "applications": ["@yunzaijs/system", "yz-yuki-plugin"],
  "middlewares": ["@yunzaijs/mys/message", "@yunzaijs/mys/runtime"]
}

• 方式2：

修改 yunzaijs/yunzai.config.js：

import { defineConfig } from 'yunzaijs'
export default defineConfig({
  applications: ["@yunzaijs/system", "yz-yuki-plugin"], //该行添加 'yz-yuki-plugin'
  middlewares: ["@yunzaijs/mys/message", "@yunzaijs/mys/runtime"]
})

2. 安装到 yunzaijs/plugins 的方式：

仅支持Yunzai-Next的分支，选择仓库：

gitee仓库：

git clone --branch main https://gitee.com/snowtafir/yuki-plugin.git ./plugins/yuki-plugin

github仓库：

git clone --branch main https://github.com/snowtafir/yuki-plugin.git ./plugins/yuki-plugin

• 依赖安装：

yarn install

（二）Yunzai-V3

仅支持Yunzai-V3（TRSS/Miao）的分支，选择仓库，安装到 yunzai/plugins：

gitee仓库：

git clone --branch main3 https://gitee.com/snowtafir/yuki-plugin.git ./plugins/yuki-plugin

github仓库：

git clone --branch main3 https://github.com/snowtafir/yuki-plugin.git ./plugins/yuki-plugin

• 安装依赖

pnpm install --filter=yuki-plugin

📦二、插件配置

!IMPORTANT 统一的配置文件路径：

Yunzai/data/yuki-plugin/config/，启动一次后，即可查看配置文件。

（一）B站动态功能：

使用前建议先绑定B站账号或配置cookie，绑定后即可使用相关功能。

CK优先级： #添加B站CK ＞ #扫码B站登录 ＞ 自动ck。只有删除前一个，后一个才生效，删除方法见功能指令。

1）绑定账号（推荐）：

#扫码B站登录，获取B站登录CK。取消使用登录则发送：#删除B站登录

2）手动配置本地Cookie（可选）：

私聊/私信 Bot下发送#添加B站CK: xxx 添加本地浏览器 无痕模式下 登录b站 获取的B站cookie。

注意事项：

你平常使用浏览器访问 b 站为普通模式，cookie会定期自动刷新而导致复制的旧ck一段时间就失效，你应该使用隐私窗口/无痕式窗口重新登录b站，并获取新的 cookie。

成功复制cookie文本后应该直接点击X关闭 浏览器窗口，而不是账号的 退出登录，否则 cookie 会立马失效。

步骤：

• ①在浏览器打开的无痕/隐私窗口中登录自己的b站账号
• ②如示例图操作：处于bilibili首页 -> 按 F12 （或者右键 --> 检查）打开开发者工具，切换到网络 ( network )点击 重新载入（或者按 F5，Ctrl + R 等）刷新页面，接着点击某一个请求（通常为 nav ），选中Cookie项的文本并 Ctrl + C 复制（不是 复制值）（包含SESSDATA）得到cookie。

!TIP 保存目录：Yunzai/data/yuki-plugin/biliCookie.yaml，如需更换/更新cookie 使用新的cookie发送#添加B站CK: xxx覆盖绑定即可。停用手动本地ck则发送命令：#删除B站ck

（二）微博动态功能：

• 获取微博博主uid：

博主主页如：

https://m.weibo.cn/u/6593199887 # 6593199887 为原神博主uid
https://m.weibo.cn/u/7643376782 # 7643376782 为崩坏星穹铁道博主uid

或打开微博app，进入博主主页，右上角点击分享，复制分享链接，在链接里找到相应uid。

微博限制，可能连续获取动态会出现获取连接中断报错，待定时任务自动重试即可。

🌈 三、功能列表

请使用 #优纪帮助或 /yuki帮助 获取完整帮助

• B站动态
• 微博动态

🚀 四、指令列表

!TIP 指令前缀：#优纪、#yuki、/优纪、/yuki，

示例：#优纪订阅B站推送uid、#yuki订阅B站推送uid、/优纪订阅B站推送uid、/yuki订阅B站推送uid。

🧩 五、支持与贡献

如果你喜欢这个项目，请不妨点个 Star🌟，这是对开发者最大的动力，呜咪~❤️

有意见或者建议也欢迎提交 Issues 和 Pull requests。

!TIP

• main、main3分支为编译分支，请勿直接在该分支上进行开发，请使用dev、dev3、npm分支进行同步开发，并提交Pull requests。
• 提交PR后由管理员审核，审核成功并合并后会自动进行github actions编译，最终提交编译好的代码到main、main3分支以及发布到npm。
• 根据喜好，可使用 vscode编辑器 或其他 IDE 辅助开发

1. Fork 项目到自己的仓库。
2. clone Fork 后的项目到本地。
3. 进入clone后的项目目录，打开终端或 git bash 执行 git checkout xxx 切换到xxx分支（请依次切换到dev3、dev、npm分支进行同步开发）。
4. 准备环境：

npm config set registry https://registry.npmmirror.com
npm install yarn@1.19.2 -g
yarn install

5. 开发并推送到Fork的仓库，接着仓库页面提交pull requests。

🌟 六、license/声明

• this project is inspired by trss-xianxin-plugin
• 基于 MIT 协议开源，但有如下额外限制：

1. 其中resources/img/icon/目录下的素材来源于网络，不保证商业使用，请遵守相关版权法律，如有侵权请联系本人删除。
2. 其中resources/img/background/ 以及 resources/img/readme/的图片素材仅供学习交流使用，禁止用于任何商业用途。
3. 严禁用于非法行为

🔗 七、链接/致谢