poi-plugin-kancolle-tasks 1.8.1 → 1.8.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 qy240
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -2,7 +2,7 @@
 
 把《舰队Collection 定期任务总览》做成 POI 插件：**在 POI 的插件菜单里点一下，就弹出一个独立窗口显示总览表**，边打边查，不占侧边栏。
 
-页面内容与工作区的 `任务.html` 完全一致（出击 47＝**周常 10**＋海域链 37 / 演习 22 / 远征 11 / 工厂 28 / 改装 4，共 **112** 个任务），包括：
+页面内容与工作区的 `任务.html` 完全一致（出击 49＝**周常 10**＋海域链 39 / 演习 22 / 远征 11 / 工厂 28 / 改装 4，共 **114** 个任务），包括：
 
 - 五大类折叠 + 按海域 / 周期分层（出击含「出击周常」独立速览表，海域链按世界→图→任务三级折叠；演习/远征/工厂/改装按 月常→周常→季常→年常·X月 分周期）
 - **出击周常 Bw1–Bw10**：あ号 / い号 / ろ号、海上护卫战、敌东方·北方·珊瑚诸岛等每周一 04:00（北京时间）重置（= 日本时间周一 05:00）的周常出击任务，单独成表，可整组「本周期全标记」，勾选计入出击大类进度
@@ -46,33 +46,60 @@
 
 ---
 
-## 安装（分享给其他玩家）
+## 安装
 
-插件是纯拷贝式安装，**不需要 npm install / 编译（零依赖）**。
+**推荐：在 POI 里从 npm 安装（不需要命令行、不需要编译）。**
 
-通用安装路径是 POI 的插件目录：
+1. POI →「设置」→「插件」；
+2. 找到「**输入插件的包名**」输入框，填：
 
-```
-%APPDATA%\poi\plugins\node_modules\
+   ```
+   poi-plugin-kancolle-tasks
+   ```
+
+3. 点「**安装**」，等它跑完（会从 npm 下载，约 600 KB）；
+4. **完全退出并重启 POI**（不是刷新页面，是关掉 POI 再开，含右下角托盘图标）；
+5. 回到主界面，在**插件菜单**（右侧 / 左上角的插件下拉）里点「定期任务总览」，弹出独立窗口即成功。
+
+> 走 npm 安装的另一个好处：POI 开启「自动更新插件」后，插件有新版本会自动提示「有新版本。请更新插件。」，在设置 → 插件 里点「更新」即可。
+
+### 网络慢 / 连不上 npm
+
+- **换镜像源**：「设置」→「插件」→「选择 npm 服务器」→ 选 `npmmirror`（淘宝源）后重试；
+- **或离线安装**：下载安装包
+  [`poi-plugin-kancolle-tasks-1.8.2.tgz`](https://registry.npmjs.org/poi-plugin-kancolle-tasks/-/poi-plugin-kancolle-tasks-1.8.2.tgz)，
+  然后在「设置」→「插件」里把它拖到「将插件安装包拖至此处安装」。
+
+### 命令行安装（可选）
+
+在 POI 的插件目录（`%APPDATA%\poi\plugins\`）下执行：
+
+```bash
+npm install poi-plugin-kancolle-tasks
 ```
 
-（Windows 下通常就是 `C:\Users\你的用户名\AppData\Roaming\poi\plugins\node_modules\`）
+然后重启 POI。
 
-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. 回到主界面，在**插件菜单**（右侧 / 左上角的插件下拉）里点「定期任务总览」，弹出独立窗口即成功。
+### 手动拷贝安装（旧方式，⚠️ 不推荐）
+
+早期版本通过"把文件夹拷进 `%APPDATA%\poi\plugins\node_modules\`"安装。**这个方式现在不推荐**：POI 开着「自动更新插件」时，插件安装 / 更新会执行一次 npm 依赖整理，**手动拷贝进去、没有登记在 `plugins/package.json` 依赖清单里的插件会被当成多余包删除**（表现为"插件突然不见了"）。如果确实需要这样装，装完请把 `poi-plugin-kancolle-tasks` 一并加进 `%APPDATA%\poi\plugins\package.json` 的 `dependencies` 里，或干脆用上面的 npm 方式。
+
+<details>
+<summary>手动拷贝时的目录结构（供排查用）</summary>
+
+```
+%APPDATA%\poi\plugins\node_modules\poi-plugin-kancolle-tasks\
+├── package.json
+├── index.js
+├── assets\tasks.html
+├── scripts\update-asset.js
+└── README.md
+```
+
+分发时请连同 `assets\tasks.html` 一起给（页面本体），单独拷 `index.js` 不会出现窗口内容。
+重启后若插件列表里没出现，请检查目录层级是否为 `node_modules\poi-plugin-kancolle-tasks\package.json`（少了一层会读不到）。
 
-> 分发时请连同 `assets\tasks.html` 一起给（页面本体），单独拷 `index.js` 不会出现窗口内容。
-> 重启后若插件列表里没出现，请检查目录层级是否为 `node_modules\poi-plugin-kancolle-tasks\package.json`（少了一层会读不到）。
+</details>
 
 ## 使用
 
@@ -104,6 +131,8 @@ node ./scripts/update-asset.js D:\path\to\任务.html
 
 ## 更新记录
 
+- **v1.8.3**：**收录 2026-09-10 游戏更新新增的 2 个出击年常**（任务总数 112→114，出击海域链 37→39）——① **By17「第九战队」拔锚！向前线展开！**（年常·9月，quest 1050）：北上改二/改三 与 大井改二（旗舰及随伴舰）+ 驱逐舰 2，出击 1-4 / 2-1 / 2-2 / 2-3 BOSS 各 1 次 S 胜，行内含编成核对（北上/大井需改二以上，素体不放行）；② **By18 改装「1YB3H」旗舰，突破敌阵！**（年常·8月，quest 1051）：山城改二补 旗舰 + 扶桑或时雨 + 最上/满潮/朝云/山云 中 2 只，出击 1-5 / 2-3 / 2-5 / 4-3 BOSS 各 1 次 A 胜以上 + 1-6 到达终点，已接入编成核对；③ 引擎支持 2026 新增的「改二补」形态后缀（如 山城改二补 / 凉波改二补）正确解析为基础名 + 改二档，年常月份选择器新增 8 月分组（默认当月 9 月时该组自动收起，切「8 月」或「全部」可见）。注：同年更新的常驻单次任务 B217（改装多用途搭载母舰「北上改三」出击）与 F143（既存装备活用·对空兵装开发，工厂）非周期任务，未纳入本表。
+- **v1.8.2**：**安装方式更新**（插件功能无改动）——以上「安装」章节改为以**从 npm 安装**为主（POI 设置 → 插件 → 输入包名 `poi-plugin-kancolle-tasks` → 安装），并补充换 npmmirror 源与离线 `.tgz` 安装两条备用路径；原「手动拷文件夹」方式标注为**不推荐**，因为 POI 开着「自动更新插件」时会做一次 npm 依赖整理，把未登记在 `plugins/package.json` 依赖清单里的手拷插件当成多余包删除（表现为"插件突然不见了"）。本插件已发布到 npm：<https://www.npmjs.com/package/poi-plugin-kancolle-tasks>。
 - **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 点名可能匹配不上的问题；新增 護/晓/响/电 等后缀与字形支持。