poi-plugin-kancolle-tasks 1.8.1 → 1.8.2

package/README.md

@@ -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,7 @@ node ./scripts/update-asset.js D:\path\to\任务.html
 
 ## 更新记录
 
+- **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 点名可能匹配不上的问题；新增 護/晓/响/电 等后缀与字形支持。

package/assets/tasks.html

@@ -924,7 +924,7 @@ body.dark .rsTip{color:#d8b56a}
 
     <h3>⑦ 数据说明</h3>
     <ul>
-      <li>页面与插件版本号 <b>v1.8.1</b>（显示在右上角标题旁），由插件 package.json 同一来源生成，改版不会漏同步。</li>
+      <li>页面与插件版本号 <b>v1.8.2</b>（显示在右上角标题旁），由插件 package.json 同一来源生成，改版不会漏同步。</li>
       <li>任务编号 / 名称 / 达成条件与前置数据参考自<b>舰娘百科（zh.kcwiki.cn「任务」页）</b>，出击海域推荐编成参考自<b>NGA「梦美的常规图带路 &amp; 出击配置 v3.0」</b>（快照日期见构建脚本）；游戏更新后新任务可能滞后出现，以游戏内为准。</li>
       <li>出击周常 10 个（Bw1～Bw10）仅收录“确实会在页面渲染”的任务，随 wiki 快照更新。</li>
     </ul>
@@ -1110,7 +1110,7 @@ body.dark .rsTip{color:#d8b56a}
   // 任何任务只要在页面上留下勾选 / 计数，就把“它所属的那个周期”记到 cyc[任务编号]；
   // 本机时间跨过日切后（该任务已进入新一期），自动清空它的旧记录 → 新一期可重新勾选，
   // 不必为了清周常而把月常 / 季常一起全量重置。
-  var APPVER='1.8.1';
+  var APPVER='1.8.2';
   var CLK={ now:null };                    // 测试可注入当前时间：CLK.now = new Date(...)
   function clockNow(){ return CLK.now ? new Date(CLK.now.getTime()) : new Date(); }
   function pad2(n){ return (n<10?'0':'')+n; }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poi-plugin-kancolle-tasks",
-  "version": "1.8.1",
+  "version": "1.8.2",
   "description": "在 POI 内一键打开《舰队Collection 定期任务总览》（出击含周常 / 演习 / 远征 / 工厂 / 改装；疲劳·破损一目了然的精简舰队面板 + 大破禁止出击警告 + 可拖动、可自动关闭的接取提示弹窗；夜间主题 + 自定义背景）",
   "main": "index.js",
   "author": "qy",