v2.5.2026.0804 新增在线 IP 对接，支持离线/在线双数据源切换，默认 ip-api.com 免费接口；支持腾讯/高德/百度国内厂商对接，响应多格式自动解析；新增 DB-IP CSV 转纯真格式转换器；在线查询内置缓存与容错；修复 IpDatabase 普通记录地址解析与视图释放缺陷

Author: nnhy

ChangeLog.md

@@ -0,0 +1,23 @@
+# NewLife.IP 版本更新记录
+
+## v2.5.2026.0804 (2026-08-04)
+
+### 在线 IP 对接
+- **离线/在线双数据源**：新增 `OnlineIp` 在线解析器，`IpResolver.Online` 一键切换，默认离线保持本地查询
+- **国内厂商对接**：支持腾讯 / 高德 / 百度 IP 定位（需免费 Key），响应多格式自动解析，中国境内省市区县高精度
+- **在线缓存与容错**：查询结果 MemoryCache 缓存，网络失败 / 限流返回空不阻断业务
+
+### 多数据源适配
+- **DB-IP CSV 转换**：新增 `IpCsv` 转换器，将 DB-IP 免费 CSV 数据转换为纯真兼容数据库文件
+
+### 测试与质量
+- **测试全覆盖**：15 个功能三维（实现/测试/注释）全部完成，42 个自动化测试通过
+
+### Bug 修复
+- **[fix]** 修复 `IpDatabase.ReadString` 未跳过 0 终止符导致普通记录地址读取为空
+- **[fix]** 修复 `IpDatabase.OnDispose` 未释放 MMF 视图导致 gz 临时文件无法删除
+
+### 文档与协作
+- 新增需求文档、功能清单、架构设计、竞品分析文档体系
+
+---

NewLife.IP/NewLife.IP.csproj

@@ -5,7 +5,7 @@
     <Description>高性能本地IPv4归属地查询库，基于MMF二分检索并支持IP库自动更新。</Description>
     <Company>新生命开发团队</Company>
     <Copyright>©2002-2026 新生命开发团队</Copyright>
-    <VersionPrefix>2.4</VersionPrefix>
+    <VersionPrefix>2.5</VersionPrefix>
     <VersionSuffix>$([System.DateTime]::Now.ToString(`yyyy.MMdd`))</VersionSuffix>
     <Version>$(VersionPrefix).$(VersionSuffix)</Version>
     <FileVersion>$(Version)</FileVersion>
@@ -27,8 +27,8 @@
     <PackageIcon>leaf.png</PackageIcon>
     <RepositoryUrl>https://github.com/NewLifeX/NewLife.IP</RepositoryUrl>
     <RepositoryType>git</RepositoryType>
-    <PackageTags>新生命团队;X组件;NewLife;$(AssemblyName)</PackageTags>
-    <PackageReleaseNotes>使用MMF访问数据库文件，避免内存缓存造成内存浪费</PackageReleaseNotes>
+    <PackageTags>新生命团队;X组件;NewLife;$(AssemblyName);在线IP;IP定位</PackageTags>
+    <PackageReleaseNotes>新增在线 IP 对接，支持离线/在线双数据源切换，默认 ip-api.com 免费接口；支持腾讯/高德/百度国内厂商对接，响应多格式自动解析；新增 DB-IP CSV 转纯真格式转换器；在线查询内置缓存与容错；修复 IpDatabase 普通记录地址解析与视图释放缺陷</PackageReleaseNotes>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>
     <PublishRepositoryUrl>true</PublishRepositoryUrl>
     <EmbedUntrackedSources>true</EmbedUntrackedSources>