Fish-plugin
August 26, 2026 · View on GitHub
适用于 TRSS-Yunzai / Yunzai-Bot 的独立钓鱼插件。
体验、反馈QQ群：1103772796
Fish-plugin 提供一套完整的群聊钓鱼玩法：每日钓鱼、鱼缸收藏、鱼市售鱼、鱼蛋商店、鱼竿鱼饵、传说鱼炼竿、每日鱼讯、钓鱼成就、放生回响、可切换钓鱼地图和图片面板。
功能概览
#钓鱼：每日抛竿钓鱼，有概率钓到不同稀有度的鱼。#钓鱼极速版：一次结算当前所有可用钓鱼次数，跳过演出并用图片汇总结果。#查看鱼缸：查看收藏的鱼，支持升级鱼缸容量。#放生鱼 1 2 3：一次放生多条鱼，让水域逐步形成回响；使用#放生回响查看当前水域回应。#鱼市：出售鱼获换鱼蛋，购买鱼饵、鱼竿和额外钓鱼券。#鱼竿 / #换竿：切换不同鱼竿，影响等待时间、上鱼率、失败保护和稀有鱼倾向。#鱼饵 / #换饵：切换不同鱼饵，鱼饵会在钓鱼时消耗。#炼竿：消耗鱼缸里的legendary鱼，炼成特殊鱼竿。#钓鱼祈愿：100 鱼蛋祈愿 1 次，可获得祈愿限定鱼竿、鱼饵和免费祈愿。#限时鱼讯：每天刷新高活跃鱼，钓中可获得额外鱼蛋。#地图：查看当前航线；熟悉初始鱼塘后可前往全新鱼池、演出和事件组成的深海裂谷。- 深海裂谷：下潜会消耗鱼蛋；深海鱼影、潮汐事件和炼制鱼竿会影响每日生命值，鱼缸与群渔港成长会扩大生存上限，深海鱼获还会带回额外鱼蛋。
#钓鱼成就：查看成就和奖励。#钓鱼管理：查看管理、维护和主人命令。
安装
进入你的 Yunzai-Bot 或 TRSS-Yunzai 根目录，然后执行：
git clone --depth=1 https://github.com/Selonite925/Fish-Plugin.git ./plugins/Fish-plugin
拉取完成后重启机器人。
通常不需要额外安装依赖，插件会使用 Yunzai 已有的运行环境和 puppeteer 图片渲染能力。
可选依赖
插件不安装额外依赖也能运行。需要增强时间处理或兼容老 Node 的网络请求兜底时，可以在插件目录执行：
cd ./plugins/Fish-plugin
pnpm install
当前可选依赖包括 luxon 和 node-fetch。没装时会自动回退，不影响日切、鱼讯、等待时间和普通面板发送。
更新
进入机器人根目录，执行：
git -C ./plugins/Fish-plugin pull
更新后重启机器人。
如果服务器直连 GitHub 不稳定，主人可以在机器人内为 #钓鱼更新 设置代理：
#钓鱼更新代理
#钓鱼更新代理 https://gh-proxy.com/
#钓鱼更新代理 https://gh-proxy.com/{url}
#钓鱼更新代理关闭
未设置代理时仍然使用 GitHub 直连；设置后 #钓鱼更新 的 fetch 和安全重装都会通过代理地址拉取。
卸载
停止机器人后删除插件目录：
rm -rf ./plugins/Fish-plugin
Windows PowerShell 可用：
Remove-Item -Recurse -Force .\plugins\Fish-plugin
第一次使用
在群里发送：
#钓鱼帮助
常用起步流程：
#钓鱼
#查看鱼缸
#鱼市
#售鱼 common
#鱼市购买 鱼饵1
#换饵 鱼饵1
#鱼市购买 鱼竿1
#换竿 鱼竿1
#钓鱼祈愿清单
常用命令
基础钓鱼
| 命令 | 说明 |
|---|---|
#钓鱼 | 抛竿钓鱼 |
#钓鱼极速版 | 一次钓完当前所有可用次数，并以图片汇总结果 |
#钓鱼帮助 | 查看帮助 |
#钓鱼次数 | 查看今日剩余次数、分段返还状态和钓鱼券 |
#查看鱼缸 | 查看鱼缸和收藏 |
#放生鱼 1 2 3 | 按鱼缸展示序号批量放生；锁定鱼不会被放生 |
#放生回响 | 查看水域回响阶段、当前回应和继续探索方式 |
#限时鱼讯 | 查看今日高活跃鱼 |
#钓鱼成就 | 查看钓鱼成就 |
#地图 | 查看当前航线和可前往海域 |
#地图 深海裂谷 | 前往深海裂谷；也可使用 #前往深海 |
#血瓶 / #使用血瓶 1 | 查看或使用祈愿获得的生命药剂 |
#深海保底 / #深海保底 1 / #深海保底 放生 1 | 查看、收回或放生血条保底暂存的逃脱鱼 |
#地图 鱼塘 | 返回初始鱼塘；也可使用 #返回鱼塘 |
鱼市和售鱼
| 命令 | 说明 |
|---|---|
#鱼市 | 查看商店、鱼饵、鱼竿和售鱼提示 |
#售鱼 1 | 卖出 #今日鱼获 里显示的第 1 条 |
#售鱼 common | 卖出今日所有 common 鱼 |
#售鱼 common 3 | 卖出今日 common 列表第 3 条 |
#售鱼 鱼缸3 | 卖出鱼缸展示列表第 3 条 |
#售鱼 全部 | 卖出今日所有可售鱼 |
legendary 和彩蛋鱼 ？ 不能出售。
放生不是出售的替代写法：它会把鱼的稀有度转成隐藏的水域亲和。亲和会依次唤醒不同的水域阶段，带来不打断日常钓鱼的小回应，并在阶段变化时送出钓鱼券或鱼饵。到达最高阶段后继续放生，海歌仍会周期性留下回礼；内部进度不会用明确的数值展示，玩家只需根据 #放生回响 的水域名称和描述决定是否继续。
#售鱼 1 这类“今日鱼获序号”按 #今日鱼获 展示出来的编号来认，不会再额外重排。
钓鱼地图
初始鱼塘仍是默认航线，原有鱼池、装备和活动不变。已经在鱼塘留下足够钓鱼经历的玩家会解锁 深海裂谷：这里使用完全独立的鱼种、每日潮汐信号、失手事件和高稀有演出，深海 epic、legendary 与彩蛋鱼还会按鱼种触发专属登场和揭示，不复用鱼塘的通用文案。深海鱼获仍会进入同一个鱼缸和鱼市体系。
初始鱼塘的老玩家会带着一段不可见的“熟手回声”进入裂谷。它只会轻微改变上鱼手感和偶发事件的回应，不会把旧鱼池复制到新地图，也不会让新地图变成固定收益路线。地图状态会随玩家保存，使用 #地图 可以随时查看并切换航线。
深海还有一条独立的生存线：每天重新恢复，深海鱼影、潮汐事件和炼制特殊鱼竿都可能让它出现缺口；生命线耗尽后，当天只能返航，不能继续下潜。鱼缸等级和当前群渔港等级会让这条生存线更宽裕，深海彩蛋鱼的收藏效果也会围绕减压、回航和鱼蛋回响发挥作用。深海鱼获会在普通结算之外带回额外鱼蛋，炼制特殊鱼竿的回响更丰厚，但也会持续承受深海压力。
每日钓鱼次数刷新时，深海会进入返航潮段，仍在裂谷的玩家会被统一遣返回初始鱼塘；开启推送的对应群会收到一条返航名单公告。刷新时间可由主人设置。若鱼影造成的本次冲击超过当前生存线，鱼会在收线前挣脱，按深海逃脱处理，不会进入鱼缸或图鉴。
深海返航名单推送默认关闭。群主人或管理员可在群内发送 #深海返航推送 开启，只让本群接收每日返航公告；发送 #深海返航推送 关闭 可停用，发送不带开关的 #深海返航推送 可查看状态。
祈愿普通愿品中新增六种血瓶：小/中/大型固定血瓶分别恢复 35/75/130 点生命值，小/中/大型百分比血瓶分别恢复生命上限的 10%/25%/45%。血瓶不会改变生命上限，可用 #血瓶 查看库存、#使用血瓶 1 按库存序号使用；即使生命值归零，也可以用血瓶恢复后继续当天航程。祈愿经济模型中的血瓶等价价值分别为 90、180、320、110、260、460 鱼蛋，六种愿品合计约占普通愿品权重的 7.7%，不会挤压鱼蛋和鱼饵到失去意义。
祈愿大奖新增 血条保底。获得后，深海上鱼时若本次所需生命值超过当前生命值，逃走的鱼会在次日以“深海逃鱼回声”暂存一天；发送 #深海保底 查看列表，按鱼蛋内部价值的 1.5 倍发送 #深海保底 1 收回，或用 #深海保底 放生 1 放回裂谷。鱼缸满且不愿替换较低价值鱼时，回声会保留到有效期结束。
售鱼价格会按鱼的稀有度、长度和重量综合计算：越稀有、体型越漂亮，通常越值钱；每个稀有度都有自己的价格区间，避免同类鱼价格浮动过大。legendary 和彩蛋鱼 ？ 不能出售，建议优先收藏或用于特殊玩法。
买东西
| 命令 | 说明 |
|---|---|
#鱼市购买 鱼饵1 | 购买鱼市里的第 1 种鱼饵 |
#鱼市购买 鱼饵1*5 | 批量购买 5 包鱼饵 |
#鱼市购买 鱼饵1 5包 | 同样是批量购买 5 包鱼饵 |
#鱼市购买 鱼竿1 | 购买鱼市里的第 1 根鱼竿 |
#鱼市购买 额外钓鱼券 | 购买额外钓鱼次数 |
#鱼市购买 自定义鱼饵 桂花酒糟 | 用文本定制一份鱼饵 |
#鱼市 自定义鱼饵 仙桃 | 自定义鱼饵购买简写；不会进入售鱼流程 |
鱼饵价格按“包”计算；每包会提供 packSize 次库存，例如 1 包 3 份的鱼饵可以在钓鱼时消耗 3 次。
额外钓鱼券只在基础次数用完后消耗，并单独记录为额外竿；鱼缸升级后新增的基础次数仍会按基础竿补给玩家。
鱼竿
| 命令 | 说明 |
|---|---|
#鱼竿 | 查看可见鱼竿列表 |
#换竿 0 | 换回默认的新手竹竿 |
#换竿 默认 | 换回默认的新手竹竿 |
#换竿 1 | 切换鱼竿列表第 1 根 |
#换竿 鱼竿1 | 切换鱼竿列表第 1 根 |
#换杆 鱼竿1 | 换杆 也可以识别 |
#换竿 疾风短竿 | 按鱼竿名切换 |
#鱼竿详情 鱼竿1 | 查看第 1 根鱼竿的属性值概览 |
#鱼竿属性 疾风短竿 | 按鱼竿名查看属性值概览 |
鱼竿列表里的 鱼竿1 和鱼市里的 鱼竿1 对齐。默认的新手竹竿单独用 0 或 默认 切回。
回收鱼竿
| 命令 | 说明 |
|---|---|
#鱼市回收 鱼竿 | 查看当前可回收鱼竿列表 |
#鱼市回收 鱼竿1 | 回收可回收列表里的第 1 根鱼竿 |
#鱼市回收 疾风短竿 | 按鱼竿名回收 |
回收列表里的 鱼竿1 是单独编号，不保证和 #鱼竿 面板里的 鱼竿1 一样。
鱼饵
| 命令 | 说明 |
|---|---|
#鱼饵 | 查看鱼饵列表和库存 |
#换饵 0 | 换回默认的清水团饵 |
#换饵 默认 | 换回默认的清水团饵 |
#换饵 清水 | 换回清水团饵 |
#换饵 1 | 切换鱼饵列表第 1 种 |
#换饵 鱼饵1 | 切换鱼饵列表第 1 种 |
#换饵 饵料1 | 切换鱼饵列表第 1 种 |
#换饵 沉流鱼饵 | 按鱼饵名切换 |
#自动续饵开 | 开启鱼饵用完后自动续到下一种持有鱼饵 |
#续饵关 | 关闭自动续饵 |
#鱼饵自动续 | 查看自动续饵当前状态和用法 |
鱼饵列表里的 鱼饵1 和鱼市里的 鱼饵1 对齐。默认的清水团饵单独用 0 或 默认 切回。自动续饵也支持 #自动续饵 开启、#自动续饵关、#续饵 开、#鱼饵自动续 关闭 等宽松写法。
炼竿
| 命令 | 说明 |
|---|---|
#炼竿预览 3 | 预览鱼缸展示列表第 3 条鱼会炼成什么鱼竿 |
#炼竿 3 | 用鱼缸展示列表第 3 条鱼炼竿 |
#炼竿神龙 | 用名为神龙的 legendary 鱼炼竿 |
#炼竿预览 神龙 | 预览名为神龙的 legendary 鱼会炼成什么鱼竿 |
#炼竿 神龙 2 | 有多条同名 legendary 时使用第 2 条 |
每种 legendary 鱼对应一根特殊鱼竿。已经拥有对应鱼竿时，不会重复炼成。
钓鱼祈愿
| 命令 | 说明 |
|---|---|
#钓鱼祈愿 | 花费 100 鱼蛋祈愿 1 次 |
#钓鱼祈愿10 | 连续祈愿 10 次，单次命令最多 10 连 |
#钓鱼十连 | 同样是 10 连写法 |
#钓鱼祈愿清单 | 查看祈愿清单、当前限定愿品和可能获得的普通愿品 |
#钓鱼祈愿概率 | 查看愿池内容、金线进度和各愿品概率 |
当前限定愿品包含 金满而谦虚之竿、鱼饵配送员 和 潮汐观测竿，不能在鱼市直接购买。玩家获得当前限定愿品后，界面会提示“当前限定愿品已获得”或“留些机会给没遇见它的钓友吧”，后续祈愿只会遇见普通愿品。潮汐观测竿会在同稀有度内尝试锁定当前赛季尚未收集的限定鱼，并强化该次记录体型；它不提供海皇竿式的鱼讯收益或泛用稀有度加成。
祈愿获得的鱼饵会明确区分“包”和“份”：祈愿限定鱼饵按包展示，实际进入背包后按份消耗。例如 渊金鱼饵 1包 和 冥潮逆饵 1包 都是 1 包 1 份，通常可钓 1 次；谦光素饵 1包 和 镜水留饵 1包 是 1 包 2 份，通常可钓 2 次。冥潮逆饵 是代价较重、专门追深层稀有鱼影的祈愿限定鱼饵，更适合收藏或冲图鉴时偶尔使用。再祈一愿 和 免费十连 会进入免费祈愿次数，结算时优先消耗。
金满而谦虚之竿 可以用 #金谦指定 鱼名 或 #金谦目标 rare 金龙鱼 指定单条目标鱼：钓到目标稀有度时，目标鱼在同稀有度里的出现感会大大增加，也会有同稀有度鱼影意外闯入。也可以用 #金谦指定 rare 指定整个稀有度，钓到该稀有度就算命中目标，但额外鱼蛋奖励会比指定单条鱼更低。命中目标会给鱼蛋奖励，但其它额外鱼蛋收益不会叠加；每天最多调整 1 次目标。装备金谦竿时，鱼饵、打窝、彩蛋、渔港和成就等外部钓鱼加成只按 50% 计算，金谦自身目标效果不受影响。清除目标需要发送 #金谦指定 确认清除，空指令只会显示确认提示，不会直接清空。
2026-06-18 到 2026-07-02 开放端午活动鱼饵 粽子：鱼市限时出售 120 鱼蛋/包，1 包 3 份，并限时加入钓鱼祈愿普通愿品池。活动期间每个账号每天第一次钓鱼会获得 1 包粽子。粽子每次使用会随机触发一种节令小效果；如果本竿没有上鱼，约 10% 概率触发端午奇遇，模仿 legendary 演出钓上屈原并获得 200-700 鱼蛋。端午限定鱼在 2026-07-03 00:00 起停止出现。
鱼缸升级
鱼缸每升 1 级增加 5 格容量，并让玩家本人每日基础钓数永久 +2；最高 10 级，最高容量 55 格，最多额外 +20 竿。升级消耗会随等级递增：升到第 N 级需要 N 条 legendary 鱼，或 3N 条 epic 鱼。
管理命令
| 命令 | 说明 |
|---|---|
#钓鱼管理 | 查看管理命令 |
#封竿 | 主人在当前群停用本插件 |
#同步鱼缸 | 同步和修正鱼缸数据 |
#修复鱼数据 | 修复用户数据结构 |
#补鱼 @某人 rare 鳗鱼 80 3.5 | 主人补发鱼获 |
#鱼蛋补偿 @某人 100 | 主人补发鱼蛋 |
#设置钓鱼刷新时间 6 | 主人设置每日钓鱼日刷新时间，24小时制 |
#钓鱼分段返还 开启 | 主人开启分段式返还基础钓鱼次数 |
#深海返航推送 开启 | 群主人或管理员开启本群的深海返航名单推送 |
每日刷新时间默认是 0:00。分段式返还默认关闭；开启后，基础次数会在刷新点返还 1/3，刷新点后 6 小时再返还 1/3，刷新点后 12 小时返还剩余全部次数，刷新点后 16 小时起才会使用额外钓鱼券。#钓鱼极速版 仍可提前消耗当天全部基础次数，用来减少同一时段刷屏。
玩法说明
稀有度
鱼的稀有度从低到高大致为：
common -> uncommon -> rare -> epic -> legendary -> ？
？ 是彩蛋稀有度，出现率非常低。
鱼竿怎么选
- 想钓得快：优先买
疾风短竿、柳影细竿。 - 想少空竿：优先买
稳钓重竿。 - 想追稀有鱼：优先买
猎珍长竿。 - 想守大鱼：优先买
阔鳞量竿、坠岩守竿。
鱼饵怎么选
- 想稳定上鱼：买
香谷鱼饵。 - 想多钓普通鱼攒鱼蛋：买
银鳞鱼饵或青苔鱼饵。 - 想追稀有鱼：买
沉流鱼饵、乌贼鱼饵、雷息鱼饵。 - 想玩随机效果：买
自定义鱼饵。
图片面板
以下命令会优先使用 TRSS/Yunzai 的 puppeteer 渲染图片面板：
#钓鱼帮助
#鱼市
#查看鱼缸
#钓鱼成就
#鱼竿
#鱼饵
#赛季鱼
#历史赛季鱼
#放生回响
#渔港
可选本地背景目录：
plugins/Fish-plugin/resources/backgrounds
仓库默认会附带 background1.png，下载后即可直接使用。
继续往里面放 .jpg、.jpeg、.png、.webp 文件时，图片面板会自动随机使用。
数据文件
插件数据主要保存在：
| 文件 | 说明 |
|---|---|
fishdata/fishData.json | 用户主数据、鱼缸、鱼蛋、鱼竿、鱼饵、成就 |
fishdata/fishConfig.json | 基础配置、封竿群 |
fishdata/baitData.json | 手动打窝数据 |
fishdata/lostItems.json | 失败事件掉落物 |
fishdata/worldState.json | 每日鱼讯和群渔港状态 |
这些运行时数据文件会在首次使用时自动生成，不跟随仓库发布，避免把现有玩家数据一起提交到 GitHub。保存时会先完整写入同目录临时文件并刷盘，再替换正式文件；同时保留 *.backup.json 和 *.backup-1.json 两代有效备份。多人命令交错结算时，fishData.json 只合并本次命令实际改动的玩家，避免旧快照覆盖其他玩家刚写入的鱼获、鱼缸和成就。正式文件因断电变为空文件、NUL 字节或无效 JSON 时，插件会自动选择最新有效副本恢复，并将损坏内容保留为 *.corrupt-时间戳.json 供排查。
更新插件前建议备份 fishdata/*.json。
赛季鱼与渔港
#赛季鱼：发送当前赛季限定鱼和个人赛季图鉴图片面板。赛季鱼单独统计，不计入永久图鉴；不提前展示后续赛季。#历史赛季鱼：发送已经结束的历史赛季鱼和个人历史收集进度图片面板；历史限定鱼不会重新进入当前鱼池。#渔港：发送当前群的共享渔港图片面板，展示等级、建设值、Buff 倒计时和贡献榜。#渔港建设 2000/#渔港捐蛋 2000：捐出鱼蛋并按 1:1 转为群建设值；单次捐赠每满 2000 鱼蛋，繁荣 Buff 延长 3 天。#渔港捐鱼 1/#渔港捐鱼 虹鳟2：先用#查看鱼缸确认序号或鱼名，再捐出指定的非锁定鱼；锁定鱼和彩蛋鱼不能捐赠。- 捐鱼建设值：
common 20、uncommon 50、rare 120、epic 350、legendary 1000。捐鱼只增加建设值，不延长繁荣 Buff。
群渔港数据保存在 fishdata/worldState.json 的 harbors 字段；玩家赛季收藏保存在 fishdata/fishData.json 的 seasonalCollections 字段。渔港捐赠使用待结算事务记录：如果进程在扣除鱼蛋/移除鱼和写入建设值之间中断，重启后的下一条钓鱼指令会自动完成或取消该笔事务。具体赛季只在开始后通过 #赛季鱼 面板展示，不提前公开后续活动。2026 夏潮赛季会在世界杯决赛潮结束后开启，并与七夕星河首尾相接；后续可在 lib/seasonal-fish.js 和 fishdata/fishpool.js 增加新赛季。
渔港升级会逐级解锁更好的常驻加成，当前最高为 Lv.8、累计 150 万建设值；繁荣 Buff 只提供额外收益。单次捐赠每满 2000 鱼蛋延长 3 天，最多保留未来 30 天；捐鱼只增加建设值，不延长时间。繁荣结束后，渔港等级提供的上鱼率、鱼讯鱼蛋和稀有鱼影倾向仍会继续生效。
自定义和二次修改
常改位置：
| 文件 | 内容 |
|---|---|
fishdata/fishpool.js | 初始鱼塘鱼池、鱼种、稀有度概率、随机事件 |
lib/maps.js | 地图目录、深海裂谷鱼池、地图事件和老玩家回声 |
lib/constants.js | 鱼竿、鱼饵、商店、成就、经济数值 |
lib/custom-bait.js | 自定义鱼饵生成规则 |
lib/signals.js | 每日鱼讯逻辑 |
resources/panel/panel.html | 图片面板模板 |
常见问题
安装后没有反应
先确认插件目录是：
plugins/Fish-plugin
然后重启机器人。不要把仓库套成 plugins/Fish-plugin/Fish-Plugin/Fish.js 这种多一层目录。
怎么切回默认鱼竿和鱼饵
#换竿 0
#换饵 0
也可以用：
#换竿 默认
#换饵 默认
鱼饵为什么会减少
非默认鱼饵是消耗品。装备后每次钓鱼会消耗库存。自动续饵关闭时，用完会回到清水团饵；开启后会按持有鱼饵列表顺序续到下一种，全部用完后再回到清水团饵。
特殊鱼竿怎么买
特殊鱼竿不能直接购买，需要钓到对应的 legendary 鱼，并把它放在鱼缸里执行 #炼竿。深海的 10 条 legendary 鱼各自对应一根专属鱼竿；在深海使用炼制鱼竿会承受额外生存压力，同时带来更丰厚的鱼蛋回响。