poi-plugin-equips-farm 1.0.2

package/README.md

@@ -0,0 +1,206 @@
+# 装备养殖助手 / Equipment Farming Assistant
+
+由Antigravity强力驱动
+Coding by Antigravity
+
+一个帮助舰队Collection玩家追踪和养殖特定装备的 POI 插件。
+
+A POI plugin to assist Kantai Collection players in tracking and farming specific equipment from ship remodels.
+
+[English](#english) | [中文](#中文)
+
+---
+
+## 中文
+
+### 功能特性
+
+- 📋 **装备追踪**: 设置需要养殖的装备目标数量
+- 🚢 **舰娘信息**: 查看哪些舰娘可以提供目标装备及其改造等级
+- 📊 **进度显示**: 实时显示当前拥有量与目标数量的对比
+- 🔔 **掉落提醒**: 当获得有用的舰娘时自动弹出提示（格式：🔒{舰娘}可获得{装备}⚙️）
+- 🔍 **多语言搜索**: 支持中文、日文、平假名、罗马音搜索
+  - 中文：五十铃、长门
+  - 日文：五十鈴、長門
+  - 平假名：いすず、ながと
+  - 罗马音：isuzu、nagato
+- 🎯 **智能过滤**: 按装备类型、名称、标记状态筛选
+- 💾 **自动保存**: 目标设置自动保存，重启后保留
+
+### 安装方法
+
+#### 方法一：通过 NPM（推荐）
+```bash
+npm install poi-plugin-equips-farm
+```
+
+#### 方法二：通过 POI 插件商店
+1. 打开 POI
+2. 进入 设置 → 插件
+3. 搜索 "poi-plugin-equips-farm"
+4. 点击安装
+
+#### 方法三：手动安装
+1. 下载最新版本的插件
+2. 解压到 POI 插件目录：
+   - Windows: `%APPDATA%\poi\plugins\node_modules\`
+   - macOS/Linux: `~/.config/poi/plugins/node_modules/`
+3. 重启 POI
+
+### 使用说明
+
+#### 1. 设置目标装备
+- 在"Equipments"标签页中找到需要的装备
+- 使用 `+` `-` 按钮或直接输入数字设置目标数量
+- 点击装备可展开查看提供该装备的舰娘列表
+
+#### 2. 查看舰娘
+- 切换到"Ships"标签页
+- 查看每艘舰娘可以提供哪些装备
+- 按改造等级排序显示
+
+#### 3. 搜索功能
+- **装备搜索**：支持中文、日文、罗马音
+  - 示例：搜索 "12cm单装炮" 或 "12cm単装砲" 或 "tansouhou"
+- **舰娘搜索**：支持中文、日文、平假名、罗马音
+  - 示例：搜索 "五十铃" 或 "五十鈴" 或 "いすず" 或 "isuzu"
+
+#### 4. 过滤功能
+- 使用搜索框按名称筛选
+- 点击装备类型图标筛选特定类型
+- 使用 All/Marked/Unmarked 切换显示状态
+
+### 数据来源
+
+本插件使用 [WhoCallsTheFleet (WCTF)](https://github.com/TeamFleet/WhoCallsTheFleet) 数据库提供装备获取信息和多语言名称支持。
+
+### 开发
+
+```bash
+# 克隆仓库
+git clone https://github.com/Lanyangzhi/poi-plugin-equips-farm.git
+cd poi-plugin-equips-farm
+
+# 安装依赖
+npm install
+
+# 链接到 POI 插件目录（Windows）
+cd %APPDATA%\poi\plugins\node_modules
+mklink /J poi-plugin-equips-farm "D:\path\to\poi-plugin-equips-farm"
+
+# 链接到 POI 插件目录（macOS/Linux）
+cd ~/.config/poi/plugins/node_modules
+ln -s /path/to/poi-plugin-equips-farm poi-plugin-equips-farm
+
+# 重启 POI 进行测试
+```
+
+### 更新日志
+
+#### v4.2.1
+- ✨ 新增多语言搜索支持（中文、日文、平假名、罗马音）
+- 🔧 优化通知格式，显示舰娘和装备名称
+- 🐛 修复 WCTF 数据结构访问问题
+- 🧹 清理未使用的 i18n 依赖
+
+### 许可证
+
+MIT License
+
+---
+
+## English
+
+### Features
+
+- 📋 **Equipment Tracking**: Set target quantities for equipment you want to farm
+- 🚢 **Ship Information**: View which ships provide target equipment and their remodel levels
+- 📊 **Progress Display**: Real-time comparison of current inventory vs target quantity
+- 🔔 **Drop Notifications**: Automatic alerts when you acquire useful ships (Format: 🔒{ship}可获得{equipment}⚙️)
+- 🔍 **Multi-language Search**: Search in Chinese, Japanese, Hiragana, and Romaji
+  - Chinese: 五十铃, 长门
+  - Japanese: 五十鈴, 長門
+  - Hiragana: いすず, ながと
+  - Romaji: isuzu, nagato
+- 🎯 **Smart Filtering**: Filter by equipment type, name, or marked status
+- 💾 **Auto-save**: Target settings are automatically saved and persist across restarts
+
+### Installation
+
+#### Method 1: Via NPM (Recommended)
+```bash
+npm install poi-plugin-equips-farm
+```
+
+#### Method 2: Via POI Plugin Store
+1. Open POI
+2. Go to Settings → Plugins
+3. Search for "poi-plugin-equips-farm"
+4. Click Install
+
+#### Method 3: Manual Installation
+1. Download the latest release
+2. Extract to POI plugins directory:
+   - Windows: `%APPDATA%\poi\plugins\node_modules\`
+   - macOS/Linux: `~/.config/poi/plugins/node_modules/`
+3. Restart POI
+
+### Usage
+
+#### 1. Set Target Equipment
+- Find the equipment you need in the "Equipments" tab
+- Use `+` `-` buttons or type directly to set target quantity
+- Click on equipment to expand and view ships that provide it
+
+#### 2. View Ships
+- Switch to "Ships" tab
+- See what equipment each ship can provide
+- Sorted by remodel level
+
+#### 3. Search Functionality
+- **Equipment Search**: Supports Chinese, Japanese, and Romaji
+  - Example: Search "12cm单装炮" or "12cm単装砲" or "tansouhou"
+- **Ship Search**: Supports Chinese, Japanese, Hiragana, and Romaji
+  - Example: Search "五十铃" or "五十鈴" or "いすず" or "isuzu"
+
+#### 4. Filtering
+- Use search box to filter by name
+- Click equipment type icons to filter by type
+- Use All/Marked/Unmarked to toggle display status
+
+### Data Source
+
+This plugin uses the [WhoCallsTheFleet (WCTF)](https://github.com/TeamFleet/WhoCallsTheFleet) database for equipment acquisition information and multi-language name support.
+
+### Development
+
+```bash
+# Clone repository
+git clone https://github.com/Lanyangzhi/poi-plugin-equips-farm.git
+cd poi-plugin-equips-farm
+
+# Install dependencies
+npm install
+
+# Link to POI plugins directory (Windows)
+cd %APPDATA%\poi\plugins\node_modules
+mklink /J poi-plugin-equips-farm "D:\path\to\poi-plugin-equips-farm"
+
+# Link to POI plugins directory (macOS/Linux)
+cd ~/.config/poi/plugins/node_modules
+ln -s /path/to/poi-plugin-equips-farm poi-plugin-equips-farm
+
+# Restart POI for testing
+```
+
+### Changelog
+
+#### v4.2.1
+- ✨ Added multi-language search support (Chinese, Japanese, Hiragana, Romaji)
+- 🔧 Improved notification format to display ship and equipment names
+- 🐛 Fixed WCTF data structure access issues
+- 🧹 Cleaned up unused i18n dependencies
+
+### License
+
+MIT License

package/assets/ships.json

@@ -0,0 +1,180 @@
+[
+    {
+        "shipId": 110,
+        "farming": [
+            {
+                "equipId": 13,
+                "level": 12,
+                "remodel": true
+            }
+        ]
+    },
+    {
+        "shipId": 120,
+        "name": "Mikuma",
+        "farming": [
+            {
+                "equipId": 50,
+                "level": 30,
+                "remodel": true
+            }
+        ]
+    },
+    {
+        "shipId": 123,
+        "name": "Kinugasa",
+        "farming": [
+            {
+                "equipId": 50,
+                "level": 55,
+                "remodel": true
+            }
+        ]
+    },
+    {
+        "shipId": 460,
+        "name": "Hayashimo",
+        "farming": [
+            {
+                "equipId": 101,
+                "level": 30,
+                "remodel": true
+            },
+            {
+                "equipId": 88,
+                "level": 30,
+                "remodel": true
+            }
+        ]
+    },
+    {
+        "shipId": 414,
+        "name": "Kiyoshimo",
+        "farming": [
+            {
+                "equipId": 88,
+                "level": 30,
+                "remodel": true
+            },
+            {
+                "equipId": 106,
+                "level": 30,
+                "remodel": true
+            }
+        ]
+    },
+    {
+        "shipId": 453,
+        "name": "Kazagumo",
+        "farming": [
+            {
+                "equipId": 129,
+                "level": 30,
+                "remodel": true
+            }
+        ]
+    },
+    {
+        "shipId": 424,
+        "name": "Takanami",
+        "farming": [
+            {
+                "equipId": 129,
+                "level": 30,
+                "remodel": true
+            }
+        ]
+    },
+    {
+        "shipId": 183,
+        "name": "Ooyodo",
+        "farming": [
+            {
+                "equipId": 101,
+                "level": 35,
+                "remodel": true
+            },
+            {
+                "equipId": 106,
+                "level": 35,
+                "remodel": true
+            }
+        ]
+    },
+    {
+        "shipId": 90,
+        "name": "Souryuu",
+        "farming": [
+            {
+                "equipId": 100,
+                "level": 78,
+                "remodel": true
+            }
+        ]
+    },
+    {
+        "shipId": 91,
+        "name": "Hiryuu",
+        "farming": [
+            {
+                "equipId": 94,
+                "level": 77,
+                "remodel": true
+            }
+        ]
+    },
+    {
+        "shipId": 24,
+        "name": "Ooi",
+        "farming": [
+            {
+                "equipId": 58,
+                "level": 10,
+                "remodel": true
+            },
+            {
+                "equipId": 15,
+                "level": 50,
+                "remodel": true
+            }
+        ]
+    },
+    {
+        "shipId": 25,
+        "name": "Kitakami",
+        "farming": [
+            {
+                "equipId": 58,
+                "level": 10,
+                "remodel": true
+            },
+            {
+                "equipId": 15,
+                "level": 50,
+                "remodel": true
+            }
+        ]
+    },
+    {
+        "shipId": 19,
+        "name": "Kiso",
+        "farming": [
+            {
+                "equipId": 15,
+                "level": 65,
+                "remodel": true
+            }
+        ]
+    },
+    {
+        "shipId": 409,
+        "name": "Maruyu",
+        "farming": [
+            {
+                "equipId": 32,
+                "level": 20,
+                "remodel": true
+            }
+        ]
+    }
+]

package/index.es

@@ -0,0 +1,107 @@
+import { syncConfig } from './redux/actions'
+import { targetsSelector, wctfDataSelector, userEquipsSelector, userShipsSelector, masterShipsSelector, masterEquipmentsSelector } from './redux/selectors'
+import { getFarmingMap, checkQuota } from './lib/data-processor'
+
+// Export Redux Reducer
+export { reducer } from './redux'
+
+// Export UI
+export { reactClass } from './views'
+
+const EXTENSION_KEY = 'poi-plugin-equips-farm'
+
+// Config Observer
+let unsubscribeObserver = null
+const configPath = `${EXTENSION_KEY}.targets`
+
+// Event Handler for Game Response
+const handleGameResponse = (e) => {
+  const { path, body } = e.detail
+  
+  let gotShipId = -1
+
+  if (path === '/kcsapi/api_req_sortie/battleresult') {
+      if (body.api_get_ship) {
+          gotShipId = body.api_get_ship.api_ship_id
+      }
+  } else if (path === '/kcsapi/api_req_kousyou/getship') {
+      gotShipId = body.api_ship_id 
+  }
+
+  if (gotShipId > 0 && window.store) {
+      const state = window.store.getState()
+      const targets = targetsSelector(state)
+      const wctf = wctfDataSelector(state)
+      const userEquips = userEquipsSelector(state)
+      const userShips = userShipsSelector(state)
+      const $ships = masterShipsSelector(state)
+      const $equipments = masterEquipmentsSelector(state)
+
+      const farmingMap = getFarmingMap(wctf)
+      const shipInfo = farmingMap[gotShipId]
+
+      if (shipInfo && shipInfo.provides) {
+          const hits = []
+          
+          shipInfo.provides.forEach(p => {
+              const targetCount = targets[p.equipId] || 0
+              if (targetCount > 0) {
+                  const quota = checkQuota(targetCount, p.equipId, userEquips, userShips, farmingMap)
+                  
+                  if (!quota.isSatisfied) {
+                       const equipMaster = $equipments[p.equipId]
+                       const eqName = equipMaster ? equipMaster.api_name : `#${p.equipId}`
+                       hits.push(`${eqName} (Lv.${p.level})`)
+                  }
+              }
+          })
+
+          if (hits.length > 0) {
+              // Get ship name
+              const shipMaster = $ships[gotShipId]
+              const shipName = shipMaster ? shipMaster.api_name : `Ship#${gotShipId}`
+              
+              // Format: 🔒{ship}可获得{equip}⚙️
+              const equipList = hits.join('、')
+              window.toast(`🔒${shipName}可获得${equipList}⚙️`, { type: 'success' })
+          }
+      }
+  }
+}
+
+export function pluginDidLoad() {
+  const savedTargets = window.config.get(configPath, {})
+  
+  if (window.store) {
+      // Initialize state with saved config
+      window.store.dispatch(syncConfig(savedTargets))
+
+      // Use store.subscribe for persistence with proper comparison
+      let currentTargetsJson = JSON.stringify(savedTargets)
+      
+      unsubscribeObserver = window.store.subscribe(() => {
+          try {
+              const state = window.store.getState()
+              const newTargets = targetsSelector(state)
+              const newTargetsJson = JSON.stringify(newTargets)
+              
+              // Only save if targets actually changed (deep comparison via JSON)
+              if (newTargetsJson !== currentTargetsJson) {
+                  window.config.set(configPath, newTargets)
+                  currentTargetsJson = newTargetsJson
+              }
+          } catch (error) {
+              console.error('[Farming Assistant] Error in store subscription:', error)
+          }
+      })
+  }
+
+  window.addEventListener('game.response', handleGameResponse)
+}
+
+export function pluginWillUnload() {
+  if (unsubscribeObserver) {
+    unsubscribeObserver()
+  }
+  window.removeEventListener('game.response', handleGameResponse)
+}

package/lib/data-processor.es

@@ -0,0 +1,168 @@
+// lib/data-processor.es
+// Handles WCTF Data Processing and Inventory Quota Logic
+
+let cachedFarmingMap = null
+let cachedWctfShips = null
+
+// --- 1. WCTF Processing ---
+
+export function getFarmingMap(wctf) {
+    if (!wctf || !wctf.ships) return {}
+    if (cachedFarmingMap && cachedWctfShips === wctf.ships) return cachedFarmingMap
+
+    const map = {}
+    const ships = wctf.ships
+
+    // 1st Pass: Identify direct providers (Who comes with what stock eq)
+    // Map<ShipId, { level, stock: [] }>
+    
+    // Pre-Pass: Build Level Requirements Map (Child -> Level to reach from Parent)
+    const levelMap = {}
+    Object.keys(ships).forEach(sId => {
+        const ship = ships[sId]
+        if (ship.remodel && ship.remodel.next && ship.remodel.next_lvl) {
+             const nextId = parseInt(ship.remodel.next) // Target ID
+             const nextLvl = parseInt(ship.remodel.next_lvl)
+             levelMap[nextId] = nextLvl
+        }
+    })
+
+    const directProvision = {} 
+
+    Object.keys(ships).forEach(sId => {
+        const ship = ships[sId]
+        // Try multiple known keys for stock equipment
+        const rawEquip = ship.equip || ship.slots || ship.init_equip
+        
+        if (!rawEquip || !Array.isArray(rawEquip)) return
+        
+        const myStock = []
+        rawEquip.forEach(slot => {
+            let eId = -1
+            if (typeof slot === 'number') eId = slot
+            else if (slot && slot.id) eId = slot.id
+            
+            if (eId > 0) {
+                 myStock.push(eId)
+            }
+        })
+
+        if (myStock.length > 0) {
+            // Get the level required to BECOME this ship
+            const pId = parseInt(sId)
+            const requiredLevel = levelMap[pId] || 1 // Default to 1 if no parent req (Base)
+            
+            directProvision[pId] = {
+                shipId: pId,
+                stock: myStock,
+                level: requiredLevel
+            }
+        }
+    })
+
+    // 2nd Pass: Build Parent Map (Child -> Parent) for fast lookups
+    const parentMap = {}
+    Object.keys(ships).forEach(sId => {
+        const ship = ships[sId]
+        if (ship.remodel && ship.remodel.prev) {
+            parentMap[sId] = parseInt(ship.remodel.prev)
+        }
+    })
+
+    // Helper: Find Base Ancestor
+    const findRoot = (id) => {
+        let curr = id
+        let steps = 0
+        // Walk up until no parent found
+        while(parentMap[curr] && steps < 20) {
+            curr = parentMap[curr]
+            steps++
+        }
+        return curr
+    }
+
+    // 3rd Pass: Group by Base Ancestor
+    Object.keys(directProvision).forEach(providerIdStr => {
+        const providerId = parseInt(providerIdStr)
+        const providerData = directProvision[providerId]
+        
+        const rootId = findRoot(providerId)
+        
+        // Initialize Root Entry
+        if (!map[rootId]) {
+            map[rootId] = {
+                baseId: rootId,
+                provides: []
+            }
+        }
+
+        // Add items to Root
+        providerData.stock.forEach(eqId => {
+            // No Deduplication: Show ALL forms that provide the item.
+            // This ensures intermediate forms (like Tan Yang) appear in the Ship List
+            // even if they provide the same equipment as an earlier form.
+            
+            map[rootId].provides.push({
+                equipId: eqId,
+                providerId: providerId,
+                level: providerData.level,
+            })
+        })
+    })
+
+    cachedFarmingMap = map
+    cachedWctfShips = wctf.ships
+    return map
+}
+
+// --- 2. Inventory Check ---
+
+export function checkQuota(targetCount, equipId, userEquips, userShips, farmingMap) {
+    if (targetCount <= 0) return { isSatisfied: true, current: 0 }
+
+    let holding = 0
+    Object.values(userEquips).forEach(item => {
+        if (item.api_slotitem_id === equipId) {
+            holding++
+        }
+    })
+
+    let potential = 0
+    // Check Potential: Do I have a ship that is an ancestor of a Provider?
+    Object.values(userShips).forEach(ship => {
+        const masterId = ship.api_ship_id
+        
+        // farmingMap is Keyed by BASE ID.
+        // If masterId is in farmingMap, it is a Base ship match.
+        // What if masterId is an intermediate form (e.g. Kai), but not yet Provider (Kai Ni)?
+        // Our farmingMap keys are ROOTS. 
+        // We need to know if `masterId` belongs to the tree of a Root that provides `equipId`.
+        
+        // Simplification for v4: 
+        // We check if `masterId` matches the 'baseId' of a group.
+        // (This assumes we keep Base copies. If we have intermediate, this check might fail.)
+        // Ideally we check: findRoot(masterId) -> match map Key.
+        // But `wctf` is needed for findRoot. We closed over it? No.
+        
+        // Let's rely on the fact that most farming involves keeping Base ships.
+        // Or, we can do a quick lookup if we exported the parentMap or findRoot logic.
+        // For now, strict Base ID match is "Safe" (undercounts rather than overcounts).
+        
+        const info = farmingMap[masterId]
+        if (info && info.provides) {
+             const useful = info.provides.some(p => p.equipId === equipId && p.providerId !== masterId)
+             // If I have the Base, and Base != Provider, it's potential.
+             if (useful) {
+                 potential++
+             }
+        }
+    })
+
+    const current = holding + potential
+    return {
+        current,
+        holding,
+        potential,
+        isSatisfied: current >= targetCount
+    }
+}