poi-plugin-kancolle-tasks 1.8.1

package/README.md

@@ -0,0 +1,113 @@
+# poi-plugin-kancolle-tasks
+
+把《舰队Collection 定期任务总览》做成 POI 插件：**在 POI 的插件菜单里点一下，就弹出一个独立窗口显示总览表**，边打边查，不占侧边栏。
+
+页面内容与工作区的 `任务.html` 完全一致（出击 47＝**周常 10**＋海域链 37 / 演习 22 / 远征 11 / 工厂 28 / 改装 4，共 **112** 个任务），包括：
+
+- 五大类折叠 + 按海域 / 周期分层（出击含「出击周常」独立速览表，海域链按世界→图→任务三级折叠；演习/远征/工厂/改装按 月常→周常→季常→年常·X月 分周期）
+- **出击周常 Bw1–Bw10**：あ号 / い号 / ろ号、海上护卫战、敌东方·北方·珊瑚诸岛等每周一 04:00（北京时间）重置（= 日本时间周一 05:00）的周常出击任务，单独成表，可整组「本周期全标记」，勾选计入出击大类进度
+- 「可一并完成 / 续作链 / 此编成可顺带完成」关联
+- **任务编号点击跳转定位**（蓝字编号，点了自动展开并高亮；可定位到周常行）
+- 逐任务 / 逐海域勾选，进度本地保存
+- **折叠 / 展开状态、大类展开状态、舰队卡折叠状态、使用说明折叠状态全部本地保存**（关掉重开不重置）
+- **🌙 夜间护眼主题**：顶栏「🌙 夜间 / ☀ 日间」一键切换，整页（含舰队卡 / 徽标 / 表格）转深色，自动记住
+- **🖼 自定义背景图片**：顶栏「背景」选一张本地图片作页面背景，自动记住；可随时「✕ 清除背景」（图片存浏览器本地，建议 <2MB）
+- **年常任务按月份显示**：默认只显示当月刷新的年常任务，顶部「年常月份」可切换 1–12 月或「全部」；出击周常不受月份过滤影响
+- **工厂「准备材料总计」随月份联动 + 完成扣减 + 仓库核对**：
+  - 勾选完成某个工厂任务后，它消耗的资源 / 特殊材料 / 装备会自动从合计中扣除，全部扣完该行自动隐藏，避免重复准备
+  - 插件连接游戏后与仓库实时核对：合计中某材料标绿「已备齐」＝仓库里**未上锁**装备或当前资源已够用；标橙「还差 N」＝还没备足（**上锁装备不能作为任务消耗材料，已自动剔除不计**）
+  - 普通浏览器离线打开时只显示需要准备的数量，不做库存判断
+- 出击海域链内联 **NGA 推荐编成**（已去重精简：任务官方编成要求统一显示在表格「编成要求」列；NGA 块的通用「制空略高」与重复「与某图同图」套话不显示；高速/低速/索敌等硬性要求只在编成串内红色标出、不另行重复）。任务行**行首海域列**把海域编号做成金色高亮胶囊（v1.8.1，如 `2-4`），NGA 单元格内不再重复该编号
+- **使用说明在页面底部**（默认收起），完整介绍销账 / 计数 / 折叠 / 搜索跳转 / 月份筛选 / 游戏联动各功能；不带插件的纯 HTML 打开也能用全部手动功能
+- 窗口大小 / 位置记忆（拖到哪、拉到多大，下次打开原样恢复）；插件窗口挂为 **POI 主窗口的子窗口**，POI 主程序 / 主窗口关闭时会一起关闭，不会残留独立窗口
+- **与游戏实时关联**（需在 POI 里打开游戏并进母港一次）：
+  - 每个任务名后自动挂状态徽标：`受注中(带 n/m 合计进度)` / `已达成·待报告` / `可接取` / `未开放或已清`，行底色同步（周常任务同样实时挂徽标）
+  - 徽标计数按**全部子目标合计**显示：单目标任务如 `受注中 1/3`；多海域 / 多次数任务如 Bq8＝`受注中 3/12`（4 个海域各 3 次，POI 自动累计到哪一格都算在内）
+  - **逐场自动计数**：每打完一场战斗，POI 的任务计数会自动同步进页面对应海域的 `0/3` 格子与徽标（只增不减，绝不覆盖你手动勾选的更高进度）；多海域任务按 `@地图码` 子目标精确对应，单图任务（如 Bq1＝2-4 S×2）同样自动同步（v1.8.1）
+  - **接取提示（弹小窗）**：在游戏内**新接取任务**时，右下角弹出小窗提示可「一并接取 / 顺带完成」的相关任务，**全部显示任务名**（游戏内只显示名字，不显示编号）——例如接取月常 Bm8 会提示一并接取 Bq9「投入空母战力进行补给线的战斗警戒」、Bq11「南西诸岛方面“海上警备行动”发令！」等，并附本任务要出击的**海域与编成要求**（含“同图另一套编成需分两趟”标注）；年常仅对应月份刷新时提示，**已接取不会重复提示；已完成的任务同样不再提示**（「已完成」以页面进度为准——游戏报告后任务记录会被清空，只要页面各格已勾满就仍能识别，如 Bm8 完成后再接取 Bq11 不会建议你接 Bm8）。点任务名可跳转定位；**弹窗可按住标题栏在插件窗口内拖动到任意位置**（位置自动记住，**双击标题栏**复位右下角）；顶栏「🔔 接取提示」可整体开 / 关并自动记住。**弹窗会按情况自动关闭**：把当前任务**取消接取**（或达成 / 报告）时自动关；把「可一并接取」的关联任务**全部接取 / 完成后**也自动关；仍有关联任务未接时才需要手动 ✕ /「知道了」
+  - 顶部同步条：提督 Lv、总任务数、已接 / 待报 / 可接 / 未开放统计
+  - 游戏内达成（任务变可报告）→ 页面**自动勾满**该任务（含多海域），报告后不丢
+  - 第 1–4 舰队实时卡片，每舰**单行：Lv + 舰种缩写（DD/CL/CVL…）+ 舰名**，悬停可看完整舰种 / 疲劳 / HP / 入渠 / 基础速力。**疲劳度 = 舰名颜色**（≥50 战意高昂金色、越高越亮；30-49 正常；20-29 疲劳橙；<20 极疲劳红加粗）；**破损 = 舰名残缺**（血量 ≤75%/50%/25% 时，小破/中破/大破把名字右端用卡片底色遮掉 1/4 / 1/2 / 3/4，无伤名字不变；大破剩余名字转红加粗）；入渠中的船斜体灰。第 1～4 舰队头部都显示**速力档位（基础速力估算，不计提速装备）与舰队索敌**（插件读得到才显示）。每支舰队头部条可折叠 / 展开（自动记住）；远征中舰队橙底显示远征编号
+  - **大破禁止出击警告（弹窗）**：任一舰队舰娘 **HP≤25% 且未入渠**时，弹出**红色警告窗**（默认左下角）列出第几舰队 / 舰名 / HP，提示大破状态出击可能在海域内被击沉、请先入渠修复；所有大破舰**入渠修满 HP 后弹窗自动关闭**，修复前只能手动关闭且同一批不反复打扰（全部修好后复位，新大破会再次提醒）。**弹窗可按住标题栏在插件窗口内拖动到任意位置**（位置自动记住，**双击标题栏**复位左下角）
+  - **编成核对**：第 1 舰队空闲时，对每个「已接出击任务」做**结构化编成自动核对**——
+    - 点名舰必带 / 任选（如「第五战队」缺妙高/那智/羽黑；中文点名自动匹配日文舰名，同基础名任形态均算命中：时雨→時雨改三）
+    - 舰种数量 / 旗舰位 / 总数上限 / 禁则（如 Bm4 战舰≥3 限定家族+轻巡1+厌战不可、Bm3 轻巡旗舰+其余驱逐、By2 海防3且全队≤5、By16 二号舰须吹雪型）
+    - 全绿显示「编成满足本任务 ✓」；不满足逐条红字列出缺什么；含无法归类的舰种时提示「判定可能不全」；
+      「任意编成」任务显示绿行「任意编成 · 无舰队硬性要求，当前舰队可直接出击 ✓」（如 Bq8 战果扩张季常，4DE/4DD 属推荐周回而非硬性）；「队名 / 国籍」等语义存疑任务显示灰色提示不武断判定（见任务行完整要求）
+    - **核对行开头为蓝色任务编号**（如 Bm3），点击整行即可**跳转定位**到对应任务
+    - **任务行「编成要求」徽标**：连接游戏且第 1 舰队空闲时，出击海域链每行的「编成要求」文字后会直接挂小徽标「编成满足 ✓ / 编成不满足 / 任意编成 ✓」，悬停可见原因；**已完成（已勾满）的海域行不显示**——不用在舰队面板与任务详情之间来回翻
+    - **「可同队一趟兼顾」提示**：被当前第 1 舰队满足的多个已接出击任务之间，会在面板核对行标出**剩余（未完成）海域的重叠部分**，例如同接 Bm8 与 Bq9 且编成含空母系时提示「可与 Bq9：1-3、1-4、2-1 同队一趟兼顾」（含空母系则 Bq9 不满足、不与 Bm3 一组；水雷系舰队则显示 Bm3 与 Bm8 在 1-4 顺带）；已完成海域一律排除。v1.8.0 起每行另直接标出「**可出击海域：…**」高亮标签（free / 编成满足任务可见，bad 不标），与「可同队一趟兼顾」合并在一行，勾满某海域后即时剔除
+  - **受注中行按编成满足度同色**（v1.7.7）：受注中（浅蓝）的任务行，若当前第 1 舰队编成满足会**整行转青绿色高亮**，与编成不满足的受注中行一眼区分——例如空母队同时接 Bm3 / Bm8 / Bq9 时，Bm8 与 Bq9 同色、Bm3 保持受注中浅蓝；换水雷舰队则 Bm3 与 Bm8 同色。任意编成任务同样高亮；已完成海域所在行不高亮
+  - **类目包含约定 + 点名形态下限**（v1.7.9）：舰种类目按舰娘任务习惯归并——「航空母舰」计 正航 / 装母 / **轻母**（Bm6 用 2 轻母也满足），By8 / By10 / By11 的「空母」同理含轻母；Bm7（航巡不可）、By4（航空巡洋艦含まず）按原文仍排除航巡；点名舰默认**任意改造形态都算**（要求朝霜改、带朝霜改二 / 改二补也通过），仅当任务原文点名具体形态（绫波改二 / 长波改二 / 吹雪改三等）才要求对应下限：By1 / By12 需改二、By13 需改（素体不可）、Bq6 长波改二 + 其余任一改以上、Bq13 旗舰需夕张改二型且由良需改二、By16 旗舰需吹雪改三（含改三護）；By16 二号舰为**特Ⅰ型＝吹雪型驱逐**（吹雪/白雪/初雪/深雪/丛云/薄云/白云/矶波/浦波，v1.8.0 口径）
+  - **周期自动刷新 + 按类型重置**（v1.7.7）：游戏周期在**日本时间 05:00 = 北京时间 04:00** 日切（日常每天 / 周常周一 / 月常每月 1 号 / 季常每季首月 3、6、9、12 月 1 号 / 年常各任务对应月份 1 号；季常＝春 3~5 月 / 夏 6~8 月 / 秋 9~11 月 / 冬 12~2 月）。页面顶部「周期刷新」条实时显示各周期下次刷新时间与倒计时；**跨过日切点后，上一周期勾选 / 计数的任务会自动清空**（顶部短暂提示），已完成的周常 / 月常 / 季常到期后自动恢复为未完成，新一期可直接重新勾选；「重置进度」改为弹窗，可**只勾选某一类周期**（周常 / 月常 / 季常 / 年常…）清空，也可「重置全部记录」——想清周常不再连累月常 / 季常
+  - 第 2–4 舰队空闲时列出「已接远征任务」需要的远征名。点击任一行可跳转定位到该任务
+  - 出击海域链的**小海域（图）行**（如「1-2　南西诸岛近海　本图 5 个任务」）也实时显示「已完成 X / Y」，不用展开就能看出该图还剩哪些任务没完成
+  - 同图"顺带完成"关系经**编成可行性核对**补全/纠正（详见《编成互联研究》）：1-4 双线路（轻巡旗舰+5DD 可 Bm3+Bm8+Bq11 一队，轻母路带 Bq9 系）、2-1 一条龙 By7+Bm8+Bq9+Bq11、2-2/2-3 By8 并入、3-1/3-3 By9+Bq5、1-2/1-3 By6+By2 并入；并清除若干"超 6 舰/旗舰互斥"的误标关系
+
+---
+
+## 安装（分享给其他玩家）
+
+插件是纯拷贝式安装，**不需要 npm install / 编译（零依赖）**。
+
+通用安装路径是 POI 的插件目录：
+
+```
+%APPDATA%\poi\plugins\node_modules\
+```
+
+（Windows 下通常就是 `C:\Users\你的用户名\AppData\Roaming\poi\plugins\node_modules\`）
+
+1. 把整个 **`poi-plugin-kancolle-tasks` 文件夹**拷进上面的 `node_modules` 目录，最终结构应为：
+   ```
+   %APPDATA%\poi\plugins\node_modules\poi-plugin-kancolle-tasks\
+   ├── package.json
+   ├── index.js
+   ├── assets\tasks.html
+   ├── scripts\update-asset.js
+   └── README.md
+   ```
+2. **完全退出并重启 POI**（不是刷新页面，是关掉 POI 再开）。
+3. 进「设置 → 插件」，确认「定期任务总览」已启用（默认自动启用）。
+4. 回到主界面，在**插件菜单**（右侧 / 左上角的插件下拉）里点「定期任务总览」，弹出独立窗口即成功。
+
+> 分发时请连同 `assets\tasks.html` 一起给（页面本体），单独拷 `index.js` 不会出现窗口内容。
+> 重启后若插件列表里没出现，请检查目录层级是否为 `node_modules\poi-plugin-kancolle-tasks\package.json`（少了一层会读不到）。
+
+## 使用
+
+1. 插件菜单点「定期任务总览」弹出窗口（可拖动 / 缩放 / 拖副屏，关掉释放内存，再点重开）。
+2. 平时：打开「出击 / 演习 / 远征 / 工厂 / 改装」逐项勾选销账即可；想边打边看任务状态，先确保游戏内进过一次母港 / 任务界面。
+3. 页面底部有「使用说明」，所有功能（含游戏联动）都写在那里（默认收起，可展开查看）。
+
+## 更新页面内容
+
+工作区里的 `任务.html` 改动后，在插件目录执行：
+
+```bash
+npm run update
+```
+
+它会把 `任务.html` 复制成 `assets/tasks.html`。也可以直接指定源路径：
+
+```bash
+node ./scripts/update-asset.js D:\path\to\任务.html
+```
+
+## 进度保存在哪
+
+- 默认用浏览器 `localStorage`（键名 `kancolle_tasks_all_v2`）。
+- POI 是 `file://` 打开页面的，个别环境下 `localStorage` 会被禁用。此时插件自带的兜底脚本会自动改用**插件目录下的 `progress.json`** 落盘，进度照样不丢；`localStorage` 正常时这段脚本直接跳过，不做任何事。
+- 页面右上角的「导出 / 导入」可以把进度存成 JSON 文件。若你在浏览器里已经勾过一批进度，可以在浏览器版导出，再在插件窗口里导入。
+
+> `game-state.json` / `window-state.json` / `debug.log` 是运行期自动生成的临时文件（同步数据 / 窗口记忆 / 日志），可随时删除，不影响插件。
+
+## 更新记录
+
+- **v1.8.1**：① 主表任务行**行首海域列的海域编号改为金色高亮胶囊**（与接取弹窗同一视觉语言，一眼看到每行要打哪张图），同时 **NGA 推荐编成单元格里不再重复显示该海域编号**（此前该格有一个与行首相同的蓝色小块，删掉避免同排"2-4 2-4 2CVL…"式重复）；② **单图任务逐场计数兜底**：像 Bq1（冲之岛 2-4 S×2，quest 822）这类单图任务的游戏记录子目标不带 `@地图码` 尾缀，此前"达成条件"格的 `0/2` 一直不走、只有任务名后的徽标在动——现在页面只有 1 个海域格且记录只有 1 个计数子目标时会把计数同步进该格（打一场自动变 `1/2`、满 `2/2` 自动勾绿；多图任务仍按 `@尾缀` 精确对应，不受影响）。
+- **v1.8.0**：① By16「吹雪改三拔锚」二号舰口径修正为**特Ⅰ型＝吹雪型驱逐 9 艘**（吹雪/白雪/初雪/深雪/丛云/薄云/**白云**/矶波/浦波；旗舰占吹雪故剩 8 选 1），不再把绫波/晓型算入；② 舰队面板「编成核对」对每行任务直接标出**「可出击海域」**高亮（任意编成 / 编成满足的任务列出剩余未勾满海域，随勾选实时剔除已完成的；bad 任务不标），并把原来的「可同队一趟兼顾」并入同一标签；③ **接取提示弹窗内任务海域改为金色高亮胶囊**（含"这任务怎么打"与每条可一并接取建议），一眼可辨；④ 顶栏**「隐藏已完成」勾选状态持久化**（localStorage，重启自动恢复）。
+- **v1.7.9**：编成判定体系修正——① Bm6「航空母舰2」按社区实测改为计入轻母（正航/装母/轻母均可，2 轻母配置通过）；② 引擎新增**点名形态下限**（素体不再误判满足）：By1/By12 需绫波·敷波等改二、By13 需改以上、Bq6 需长波改二 + 高波/冲波/朝霜改以上、Bq13 旗舰需夕张改二型（特/丁）、由良需改二、By16 旗舰需吹雪改三（含改三護/六式）；③ By16 二号舰名单补全为特型驱逐（吹雪/绫波/晓型，按 enwiki 实测口径，后续 v1.8.0 修正为特Ⅰ型仅吹雪型）；④ 补 比叡(睿→叡) 字形映射，修正 By15 点名可能匹配不上的问题；新增 護/晓/响/电 等后缀与字形支持。
+- **v1.7.8**：修正 Bq13「扩张『六水战』，向最前线！」的编成判定——引擎新增「任一备选方案」原子（anyOf），该任务此前只按「夕张改二（特/丁）旗舰 + 六水战驱逐2（睦月/如月/弥生/卯月/菊月/望月选2）」核对，漏了官方任务原文同等的「+由良改二」方案；现在「夕张旗舰+由良改二」或「夕张旗舰+六水战驱逐2」任一满足即判「编成满足」，任务行徽标 / 舰队面板编成核对 / 受注中行同色高亮均同步生效。
+- **v1.7.7**：页面右上角新增版本徽标（与插件 package.json 同源，窗口标题同步带版本）；受注中的任务行按「当前第 1 舰队是否满足编成」同色区分（满足→青绿高亮，例：空母队下 Bm8 与 Bq9 同色、Bm3 保持受注中浅蓝）；周期自动刷新与按类型重置（见上方功能说明；日切=日本时间 05:00／北京时间 04:00，跨周期自动清空上一周期记录；重置弹窗可只清周常 / 月常 / 季常 / 年常）。
+- **v1.7.6**：① 已完成任务不再出现在「可一并接取」建议；② 出击小海域（图）行新增「已完成 X/Y」；③ 移除已截止的 2026 夏季期间限定任务 2606Bm1 / 2606Bm2（任务总数 114→112）；④ 任务行「编成要求」新增当前第 1 舰队满足度徽标，舰队面板对满足的已接任务标出可「同队一趟兼顾」的重叠海域（已完成海域除外）。
+- **v1.7.5**：多海域徽标「海域 X/Y」悬停浮层（列出全部海域与目标、已完成海域绿 ✓）。