HNCore v1.1.0

• 发布日期：2026-04-08
• 发布提交：3ee58b1
• 版本定位：把 HNCore 从"已有的基础核心插件"继续推进成一套更适合下游模块统一复用的公共基础设施层

版本定位

v1.1.0 这一轮，不是单点小修，而是把几组会被多个业务模块重复用到的公共能力一起补齐了：

• 授权接入与内部 SDK 发布链路
• 可复用的 GUI Flow / 会话 / 确认流程骨架
• 统一占位符服务
• 统一物品身份、匹配、定义、解析、发放、编解码能力
• 周期重置工具
• 序列号生成与 PlaceholderAPI 桥接

这意味着后续像 HNSignIn、HNWarehouse、HNAttribute、HNMail 这类模块，可以尽量围绕同一套 HNCore 协议来实现业务层，而不是各自重复维护一套底层逻辑。

本次重点新增 / 调整

1. 授权接入 SDK 与内部发布链路补齐

来源提交：30eacf0（2026-04-06，新增内部 SDK 发布与授权接入能力）

• 为 hncore-api 补齐 GitHub Packages Maven 发布配置
• 新增统一授权接入所需的公开类型、本地缓存与心跳 / 校验相关能力
• 让付费或内部模块可以围绕 HNCore 统一处理授权注册、启动校验和运行时状态

如果你在做付费模块、内部模块或需要统一授权接入，这一轮开始更适合直接依赖 HNCore 提供的授权基础设施。

2. GUI Flow 基础设施成型

来源提交：3f156dc（2026-04-07，新增可复用 GUI Flow 基础设施并补充接入示例）

• 新增统一的多页面 GUI 导航与会话状态管理
• 补齐确认对话框、基础屏幕抽象与接入示例
• 重点解决业务模块自己维护翻页、确认、返回、关闭清理时容易重复实现的问题

对下游模块来说，这一轮之后更适合把"多页面导航 + 会话状态 + 确认流程"交给 HNCore 的 GUI Flow 层处理。

3. 统一占位符服务打通消息与 GUI 渲染

来源提交：51465b7（2026-04-07，新增统一占位符服务并打通消息与 GUI 渲染）

• 统一 GUI 模板、消息文案与业务模块的占位符解析入口
• 减少各模块分别维护替换逻辑的重复劳动
• 为后续 PlaceholderAPI 桥接预留了稳定扩展点

这一步的意义不只是"多了一个工具类"，而是 HNCore 开始把 消息渲染、GUI 渲染、对外占位符暴露 放到同一条协议链路里处理。

4. 通用加权随机池开放 API 复用

来源提交：1ad63cd（2026-04-07，新增通用加权随机池并开放 API 复用）

• 新增统一的加权随机构建与抽取能力
• 适合签到、抽奖、奖励池、强化结果等场景复用
• 统一下游模块在权重池边界行为上的实现方式

这类能力虽然不一定直接面向服主，但对多个业务模块复用价值很高。

5. 统一物品协议从"识别"一路补到"发放"

来源提交：

• 037f547（2026-04-08，新增统一物品身份与匹配基础设施）
• 24681e6（2026-04-08，新增配置化物品定义与统一发放服务）
• 18ada17（2026-04-08，新增物品编解码与周期重置工具）

这一轮把物品相关公共能力补成了一整条链路：

• 身份与匹配层：统一 PDC、序列号、材质、文本特征等识别协议
• 配置定义层：支持从配置描述业务物品，并统一解析成可发放对象
• 发放层：统一背包投递、剩余处理与结果模型
• 编解码层：统一保存业务物品快照，减少各模块重复实现 ItemStack 持久化
• 周期工具层：补齐每日 / 每周 / 每月重置边界能力

这对签到、仓库、邮件、奖励、任务类模块尤其重要，因为它们经常同时涉及：

• 物品识别
• 物品生成
• 物品发放
• 物品保存
• 周期重置

现在这些底层问题开始可以由 HNCore 统一承接。

6. 1.1.0 发布收口：序列号与 PAPI 桥接补齐

来源提交：3ee58b1（2026-04-08，发布 HNCore 1.1.0 并补齐序列号与 PAPI 桥接）

• 新增统一序列号生成能力，方便业务模块围绕同一套唯一凭证规则工作
• 补齐 PlaceholderAPI 桥接层与对应测试覆盖
• 统一下游模块对唯一凭证和对外占位符暴露方式的接入协议
• 正式将本轮公共基础设施收口为 HNCore 1.1.0

如果你后面要做签到记录、仓库存储、属性识别、内部占位符暴露，这一轮的序列号与 PAPI 桥接会是很关键的基础能力。

下游接入建议

如果你是 HN 系列下游插件开发者，建议优先围绕下面这套公共骨架实现业务：

• GUI / 多页面流程：GuiNavigator、BaseChestScreen、ConfirmDialog
• 占位符：PlaceholderProvider、PlaceholderService
• 业务物品协议：ItemIdentityService、ItemMatcher
• 业务物品配置与发放：ItemSpecParser、ItemSpecResolver、ItemDeliveryService
• 业务物品持久化 / 快照：ItemCodec、ItemSnapshot
• 周期业务：ResetClock、ResetRule
• 唯一券 / 唯一装备 / 唯一道具：SerialGenerator

升级提醒

• 如果你是 服主，这次升级最重要的认知变化不是单个命令，而是 HNCore 开始承接更多"业务公共层"职责；后续下游模块会越来越依赖这些统一协议。
• 如果你是 下游模块开发者，优先考虑复用 HNCore 提供的占位符、GUI Flow、物品协议、序列号和周期重置能力，不要再为每个模块各写一套重复实现。
• 如果你的现有模块已经自带一套 PDC 键、物品匹配规则、序列号生成规则或占位符替换逻辑，升级到这轮后建议评估是否逐步迁移到 HNCore 的统一协议，避免多个模块并存时语义不一致。
• 如果你依赖 PlaceholderAPI，升级后应确认对应桥接已正常工作；否则下游基于 HNCore 协议暴露的占位符能力可能无法完整对外使用。
• 如果你在使用或准备接入 授权 / 内部 SDK，建议同步关注 HNCore 的授权配置与 hncore-api 发布方式，不要继续把授权逻辑散落到各业务模块内部。

升级后建议检查

建议升级到 v1.1.0 后优先做下面几类回归：

1. 核心状态检查

   • 执行 /hncore status
   • 确认核心服务、共享存储与依赖状态正常

2. GUI 与消息渲染检查

   • 检查使用 HNCore GUI 模板的页面是否还能正常打开、翻页、返回、确认、关闭
   • 检查消息文案和 GUI 文本里的占位符是否仍按预期渲染

3. 物品链路检查

   • 检查业务模块里的物品定义、识别、发放、背包溢出处理是否正常
   • 检查涉及物品快照保存 / 恢复的场景是否正常

4. 周期与重置检查

   • 检查签到、仓库、任务、奖励等涉及每日 / 每周 / 每月边界的业务是否仍按预期重置

5. 序列号与 PAPI 检查

   • 检查依赖唯一凭证的业务链路是否保持一致
   • 检查 PlaceholderAPI 相关占位符是否已成功桥接并能正常读取

6. 二开接入检查

   • 如果你自己有下游插件，建议重新对照这几页文档检查接入面是否仍合理：
     • 开发者 API 与集成指南
     • hncore-api 与运行时依赖说明
     • GUI Kit 与模板规范