岁迹

KiHan ActFramework 详解 Lua 活动框架。1000+ 个 Act（限时运营活动）的统一写法。源码：Assets/Resources/LuaScript/KiHan/ActFramework/，五层结构（Base / Entity / Component / HFSM / Data） 0. 一句话总览：乐高类比 概念 类比 Entity 乐高底盘（选哪种底盘决定活动形态） Component 标准积木块（网络/UI事件/红点/定时器…插上就能用） ActLib 工具箱（通用函数库） HFSM 变速箱（分层状态机，桥接 C# StateMachineWrapper） 1. 五层目录结构 目录 内容 Base/ ActEntityBase（Component 容器+生命周期驱动）、ActComponentBase（CopyType 机制 + F2EE 拷贝）、ComponentDefine Entity/ 5 种核心 Entity + UI/...

KiHan Manager 台账速查 Assets/Scripts/Manager/ 下 78 个 *Manager.cs 的反查台账。查”某系统归哪个 Manager 管”从这里开始。 0. 单例形态（先认清，源码逐个核验过） 形态 代表 备注 普通类 + 手写静态单例 KHDataManager(getInstance)、KHMovieManager、KHEffectManager、KHAudioRecordManager、GVoiceManager、ExpandPackManager 事件靠内持/全局 dispatcher KHEventDispatcher + 静态单例 KHResManager、KHBattleManager、KHAudioManager、KHCityPlayerManager、VersionManager 自身即事件源，可 dispatchEvent Singleton<T>（MonoBehaviour） KHMultiCameraManager 靠 LateUpdate 轮询 SimpleSinglet...

KiHan Plugin 框架详解 KiHan 144 个 C# 业务模块（商城/公会/忍具/充值…）的统一写法。源码：Assets/Scripts/Plugin/Infrastructure/在架构中的位置：被状态机拉起 → KHGameFlow.BuildGame() → KHPluginManager.Instance.initializePlugins() 0. 一句话总览：部门类比 类 类比 职责 Plugin 部门经理 模块入口 / 开窗 / 资源 / 消息派发（Controller） Operation 办事员 按”事项名”接单干活（行为单元） Model 档案柜 存数据，网络回包自动归档 View(UIWindow) 对外柜台 界面展示 KHPluginManager 公司总机 按名字找部门、转接消息 核心约定：Plugin 是 Controller，Model 是数据，Operation 是行为。三者靠「消息字符串」解耦，不直接互调。 1. 核心概念 基类 数...

KiHan UI 框架详解 基于 NGUI 的自研 UI 框架。UIWindow 是所有视图基类（557 行），KHUIManager 是全局基础设施（~2630 行，95KB）。关联文档：ui-framework.md（全景）、tui-component-library.md（组件库）、ngui-framework.md（渲染层）、main-ui.md（主界面入口）、redpoint-framework.md（红点） 0. 一句话总览：剧院类比 层 类比 职责 NGUI 层 舞台灯光设备 UIPanel / UIWidget / UICamera（渲染+输入），KiHan 定制版 3.5.7，122 类 UIWindow 层 剧场管理制度 开关动画、层级、异形屏、Modal、音效（自研） View 层 具体剧目 业务 View（继承 UIWindow，嵌 ViewArg 输入模型） KHUIManager 剧院经理 所有 View 的生命周期/层级/事件 1. 核心机制双层级模型 WindowLayer（大...

KiHan 框架系列 · 阅读索引 本目录是基于 Others/AIDev/context/framework/ 主线 8 篇 + 源码核验整理的系列笔记。统一模板：定位 → 类比 → 概念表 → 链路 → 避坑 → 排查速查 → 口诀。 文件位置123456789101112Obsidian Vault/└── 火影海外/ └── Framework主线/ ├── KiHan 框架阅读索引.md ← 本文件（入口） ├── KiHan状态机架构详解.md ├── KiHan Manager台账速查.md ├── KiHan Plugin框架详解.md ├── KiHan ActFramework详解.md ├── KiHan UI框架详解.md ├── KiHan 网络框架详解.md ├── KiHan 资源加载框架详解.md └── KiHan热更双引擎详解.md 💡 Obsidian 的 [[双链]] 按文件名解析，不按路...

KiHan 热更双引擎详解 两套热更通道：Lua 脚本（xLua）+ C# 代码（ILRuntime），加上资源 bundle，构成完整更新体系。“我这个改动能不能热更”看这一篇。 0. 三个破除谣言的澄清 ★（源码核验） 只有一个引擎：xLua。没有”V1=SLua / V2=xLua 双引擎” 全工程 using SLua 命中 0 次；SLua 只是腾讯 Pandora 运营 SDK 残留 Lua 框架核心不在 Assets/Scripts/，在 Packages/khengine/Runtime/Lua/ LuaVirtualMachine / LuaClass / RuntimeLuaProxy / LuaCodec 全在 khengine 包内 V1 与 V2 共享同一个 xLua VM 全工程 new LuaEnv() 只出现一处（LuaVirtualMachine.cs:39）；RuntimeLuaProxy 是 V1↔V2 桥梁 1. 三语三层运行时 层 载体 能否热更 判定 ...

KiHan 资源加载框架详解 全项目资源加载的唯一底座。加载失败 / 黑图 / 卡顿 / OOM / 内存泄露类问题的机制根源都在这里。 0. 一句话总览：图书馆类比 层 类比 职责 门面层 KHResManager 服务台 静态单例，全局唯一入口，按环境选 Loader 策略层 IResLoader 三种借阅方式 Editor 直读 / Resources 内置 / AB 加载（线上主路径） 调度层 KHLoadTaskManager 借阅排队系统 Asset/Bundle 双队列 + 并发上限 + 依赖编排 缓存层 CachePool 还书暂存架 引用计数 + backup 队列 = 软 LRU 卸载 IO 线程 FileLoader 后台仓库管理员 worker 线程异步读磁盘/APK 1. 六层分层全景12345678910业务层 LoadRes / LoadBundle 调用方（UI / 战斗 / 数据 / 特效）门面层 KHRe...

KiHan 网络框架详解 自研网络框架，底层 GCloud SDK（TCP）+ 自研 FSP/KCP（UDP）。对外唯一入口 NetworkManager。网络断连 / 收不到包 / 重连 / PVP 卡顿问题的第一落点。 0. 一句话总览：邮局类比 层 类比 职责 L5 NetworkManager 营业窗口 业务唯一 API：Send / Register / Callback L4 KiHanProxy 分拣中心 多连接管理、多线程 PB 解析、消息队列分发 L3 Connection 运输车队 ApolloConnection(GCloud TCP) / KiHanUDPConnection2(FSP+KCP) L2 MessageRouter 地址分拣员 CmdId 路由、Serial 匹配、超时检测 L1 Thread & Queue 夜间装卸工 KHThreadReadBody 后台反序列化 / NetworkMessageQueue 1. 9 种连接类型（CON...

-–title: KiHan 新人知识库阅读路线 tags: [KiHan, 新人入门, 知识库, 阅读路线] source: Others/AIDev/context/{framework,domains,entities} created: 2026-09-18-– KiHan 新人知识库阅读路线 适用对象：刚接手 KiHan 项目的开发/策划/测试新人 知识库根目录：Others/AIDev/（SVN 管理），本文所有相对路径均以此为基准 0. 先记住一句话不要一头扎进 entities/ 的 1043 篇 Act 文档。 正确顺序是： 1234建坐标系（overview + 路由 + 规则） → 读框架（framework/，最稳定） → 用领域文档串联（domains/） → entities/ 只按任务按需检索 配套认知：全库 1862 篇文档中约 2/3 是 AI 生成未经人工核实。每篇文档头部都有 confidence 字段，它决定你能信几分。 confidence 含义 检索权重...

KiHan 项目认知清单 对应知识库 AIDev/context/ 的三层核心（截图红框）： 层 回答的问题 谁写的 认知目标 framework/ 用什么造——框架/库怎么用 人工通读源码 懂机制 entities/ 造了什么——单个模块是什么 工具批量 + 人工深度 会检索 domains/ 怎么串起来——跨模块规律 人/AI 二次提炼 通链路 用法：Obsidian 里直接点击方框打勾。每条尽量附”自验标准”——能讲给别人听才算过。 A. framework 层认知（懂机制）🏗️A1. 调度主干 状态机四层：能画出 Context → Workflow → Phase → Adapter 的层级图，并说出各层职责 → [[KiHan状态机架构详解]] 15 种 Context：能说出 Boot/Game/Duplicate/PKNS 各是什么玩法，SwitchTargetList 白名单是干嘛的 Boot 语义：知道 Boot = 启动期（版本检查→启动7步→服务器登录），不是...