独立手动配装器数据与计算模块说明

阅读顺序：末尾“固定构建数值对照版”是当前实现状态；前面的逐次记录为历史说明。涉及“仅研究未执行”“旧版适配预览”“随从未计算”等描述，已由末尾记录更新，不能用于判断本版功能。

上游：Diablo III Planner，d07RiV 及其贡献者
仓库：https://github.com/d07RiV/d3planner
固定提交：898918b5c754eee7c86e10ee55b7901e379c4563
许可证：Apache License, Version 2.0；完整原文见 planner-LICENSE.txt。
上游该提交未提供独立 NOTICE 文件。本文件是本项目新增说明，不冒充上游 NOTICE。

初版静态词典的修改说明：以 catalog 的精确代码关联中文名称、资源ID与词条文本；排除 Legacy、Retro、随从专属物品；在构建阶段展开装备词条继承及三种品质范围进行校验，导出纯 JSON，删除函数与计算回调。后续随从扩展与2026-10-14计算模块的范围见下文；不加载上游 UI、框架或网络模块。
原样上游文件保存在 vendor/d3planner-data；构建脚本固定校验 Git blob 哈希，控制台报告输出 SHA256。

Blizzard Entertainment 的游戏名称、文本、图标及其他游戏素材的权利仍属于各自权利人。Apache-2.0 授权不构成对 catalog 或游戏素材的重新许可。另以Maxroll公开数据核对缺失说明、无形70级模板、随从数值范围及宝石上限；来源：
https://assets-ng.maxroll.gg/d3planner/data.json?61a2a151
SHA256 01ce12100af01f4695d1072ee3bacd1509f7bc0d1f33615c084656760fc4ed19
https://assets-ng.maxroll.gg/d3planner/locale/zhCN.json?e1cce36f
SHA256 a0c34d96371da67eca1ef44b75d7b33b45b535d1d84c8f0f58e5ee27e694791c
https://assets-ng.maxroll.gg/d3planner/static/js/main.js?ver=run-de3c810
SHA256 4a2df739b6d2b6a8ae1439f7514f71ffcf78c4f99cfeff1ba260e65bbab1822e
仅使用游戏资料，不加载或发布Maxroll程序、界面或伤害引擎，没有访问游戏进程。Maxroll参考快照不属于上述旧上游Apache授权的重新声明。

范围与验证限制：
1. 这是固定上游提交与现有 catalog 的交集，不是当前赛季完整数据库；catalog 同名或旧版本代码不会推测合并。
2. 仅提供等级70普通传奇/套装的规则。上游 Legacy、Retro、随从专属物品不收录；季节扩展规则在独立模块planner-seasons.mjs中配置。
3. 套装与传奇特效的数值来自旧上游，中文来自 catalog 快照，两者不保证当前版本完全一致；不能作为伤害计算或服务器合法性验证依据。
4. 技能缺失说明及律法错位符文已对照2026-10-13 Maxroll中英文数据补全；这些是70级基础说明，治疗等属性相关效果仍按正文加成变化，不是角色实战计算。
5. 按现有词典的a=0至e=4编号映射中文符文。解析器只在离线构建研究时处理白名单运算；多个Tag区块必须独立得出相同常量。页面不执行HUD公式，也不假定动态等级或玩家属性。百裂拳仅合并完全相同的展示，不选运行时SNO。
6. 传奇宝石上限采用Maxroll明确值或其代码规定的150默认上限；宝石第二效果按25级解锁，普通宝石代码已含等级，保存rank=0。
7. 21把无形使用Maxroll专用70级词条与白字基数，随机威能候选仍沿用HUD证据；两种来源均不冒充本次国服实测。随从数值显示基础到25000主属性的参考范围，不运行角色属性引擎。
8. 装备 slots 是候选部位，双手与盾牌/箭袋及天堂之力资格由planner-model独立校验，包含装备附带被动。
9. 浏览器文件不包含逐装备limits；planner-model按部位、类型、装备合并范围，检查职业、互斥、数量、步长与太古最优值；不模拟附魔过程或证明每件物品的历史生成合法性。
10. augment 独立于普通词条，不使用上游过时的卡德山上限。地狱火额外被动保存为extraPassive字符串，不放入纯数字stats。
11. 图标仅保留 catalog 的资源ID，不复制图片，不声明 Blizzard 素材获得 Apache 授权。

未映射技能：

2026-10-13 装备界面补充：
从上述固定提交的 css/paperdoll、css/images、external/bnet/images 原样保存13张装备底纹、空镶孔与太古边框静态图；不运行上游界面脚本。
逐文件源地址、字节数与SHA256见 gear-assets/style/sources.json。游戏美术仍归Blizzard Entertainment等权利人所有，不因上游Apache许可证变更归属。
本项目独立编写共用布局与组合样式，移除了本地草拟的简化太古角饰；不使用循环光效。

2026-10-13 装备格背景修正：
新增8张完整纸娃娃背景：普通/太古、传奇/套装分别使用长格与首饰短格底图。太古兽脸暗纹覆盖整块背景，不再将详情框角饰用于装备格。
来源为Maxroll公开静态样式与图片；逐图URL、原样图片SHA256及样式快照SHA256见 gear-assets/style/paper-sources.json。
美术权利归原权利人，未复制或运行参考站界面、账号及配装逻辑。

2026-10-13 词条排序与共用模板：
依据上述Maxroll固定数据和公开脚本的词条优先级，离线生成331个模拟器词条与306个上传属性编号的共用排序表；只交付排序数据，不加载或执行参考站脚本。
gear-ui.mjs为本项目独立编写的装备格、品质分类、详情头部、白字和宝石区模板，两页共用；模拟器与实装数据读取、数值计算仍分离。未映射上传属性保留原词典顺序，不声称全部历史属性已核对。
白字字体参考Maxroll公开main.css的Palatino Linotype、Times、serif回退栈；不下载或嵌入商业字体。


保存协议暂不支持：

2026-10-13 换装与词条编辑：
本项目独立实现可搜索、品质分色的换装下拉及逐行词条替换；参考公开配装器的主次数量和告警方式，不加载参考站界面程序。
传奇特效计入次要总数，基础白字/卡德山不计入，武器打孔不占主要名额。普通副手等使用各自数量上限，无形保留固定词条。
参考同日Maxroll精确ID资料：黑棘的决斗锁甲护腿为5主/1次，堕落的灰烬使者为4主/2次；后者新建模板不再附加旧预设的击杀回复。只调整新建和编辑规则，不删除旧分享/账户中的词条；异常旧配置会提示。
次要满额后不再新增，仍可替换或删除；主要允许强行追加并立即显示过量警告，原有保存校验继续生效。

2026-10-14 套装效果与黑棘词条：
gear-assets/set-details.json包含上述2026-10-13固定哈希参考快照中的61套套装，覆盖物品别名；编辑器与实装共用gear-sets.mjs模板。中文缺失/过期内容按同份英文规则翻译和校正，整理过程见tools/build-set-details.mjs，不执行上游脚本。
套装按不重复部件计数，皇家华戒支持穿戴/魔盒，至少实际穿戴两件；随从只计算自身装备。这里只展示套装激活状态，不计算实战伤害。
黑棘的决斗锁甲护腿补齐元素伤害15–20%候选和新建预设；原有配装数值不被覆盖。

2026-10-14 三栏工作台与开源计算模块：
planner-upstream.mjs由tools/build-planner-engine.mjs从上述Apache-2.0固定提交的40个源文件生成；逐文件SHA256、许可证和提交号见planner-engine-sources.json。保留上游版权及许可证，不将Maxroll现行程序重新声明为开源。
本项目新增隔离适配层，提供装备、宝石、卡德山、技能、被动、魔盒、巅峰、部分祭坛与团队增益输入，并将结果用于右侧属性面板与技能明细。账号、分享、纸娃娃和编辑界面仍为本项目实现。
上游字符串公式的eval已替换为仅支持数值、属性路径和白名单运算符的解析器；不执行任意JavaScript，不放宽页面CSP，不加载远程脚本。
旧版String.format及format.apply调用改为模块内函数，并显式声明技能攻速局部变量，以兼容严格模式；没有修改这部分原始技能伤害倍率。
计算条件随各方案保存；服务器只校验条件，不接受客户端计算结果作为可信数据。已有旧配装没有计算条件时按原引擎默认状态计算，不改动原装备词条。
当前为适配预览，不能视为2026年Maxroll数值完全等同：旧版装备/套装/技能公式未逐一核对；随从及发散、圣化特效、魔王宝石、无形附加威能尚未完整适配；尹娜新版幻身技能明细不展示未经核对的结果。
尹娜四件套按每幻身5%减伤、六件套按每幻身900%幻身技能伤害适配；最多10个幻身，实际数量由使用者设置。
祭坛目前计入D/E/F/G/I/J/K/L/Q/R/W/Y的数值效果；其他节点保存状态，但护盾、免控、暴击回能、药水触发和掉落效果没有战斗模拟。团队增益需手动勾选，尚不自动检查同类来源重复。
属性变化图仅记录本次页面编辑得到的实际面板数值，不是战斗时间线或模拟输出。七职业批量有限数值测试用于发现运行错误，不等于所有公式已经和当前游戏逐项验证。

2026-10-14 纸娃娃原图比例：
模拟器改用300×426的游戏背景与原始图标坐标，取消纸娃娃逐件透明裁边和手套额外放大。详情与实装模板不变。
新增的职业/随从背景、头像、装备底框、技能/被动/魔盒边框从已固定哈希的公开main.css引用图片中原样保存。37张图片的源地址、CSS选择器、尺寸、字节数及SHA256见gear-assets/paperdoll/sources.json；提取脚本为tools/build-planner-paperdoll.mjs。
游戏美术权利仍属于原权利人，不将这些图像或Maxroll现行程序声明为Apache授权。
本轮仅研究现行程序的公开源码映射，未执行、打包或发布其计算代码；计算差距清单保存在部署目录外的test/planner-calculation-audit-20261014.json，不能视为计算结果对齐证明。

2026-10-14 固定构建数值对照版（更新以上历史状态）：
计算核心仍来自Apache-2.0固定提交；在本项目适配层中补齐当前数学规则，不发布Maxroll现行程序、源码映射或框架。
私人离线参考运行于部署目录外的tools/reference-runtime：使用固定SHA256源码映射、装备数据和英文词典，在隔离上下文里计算相同输入，仅用于差分验证。运行环境不提供网络、账号或文件访问。该验证不构成现行程序的再发布许可。
参考固定于run-de3c810构建和本文件所列data.json；不是“任何未来版本”或“游戏实测值”的保证。

当前接入范围：
- 七职业技能与符文、被动、技能开关与层数、物品特效、传奇宝石、魔盒、套装和皇家华戒。
- 巅峰、卡德山、目标精英/首领/种族、随从自身属性、主属性缩放、技能与发散、圣坛和晶塔、三名队友及团队物品/魔王宝石增益。
- 天使坩埚、魔王宝石、无形武器附加威能与被动，自由萃取和四萃取输入。
- 属性面板、技能/效果伤害明细、DPS、消耗、冷却/覆盖率、攻击帧数，以及动态参数范围与显示条件。
planner-current-data.mjs按精确ID补充840件物品及58套套装规则，旧已保存物品ID与实际词条不自动重写。
祭坛按中文效果含义映射；参考站的显示编号重排与逻辑编号并不完全一致，离线输入适配器明确记录该映射。
祭坛三张原样静态美术的来源、字节数和SHA256见gear-assets/altar/sources.json；美术仍归原权利人所有。

验证方法：tools/compare-planner-calculation.mjs逐项比较原始数值，不以“没有报错”代替数值相等。另比较攻击帧数、增益开关、参数上下限/默认值/是否可无限增加和文本数值舍入。测试报告在部署目录外test/planner-calculation-*-parity-20261014.json；综合验收见test/planner-parity-acceptance-20261014.json。
后续交互修正版：默认未设置的祭坛全亮；显式保存的空/部分节点保留。技能明细使用现有计算核心的解释输出。978个技能符文组合的明细开启/关闭数值对比通过，未重跑此前138004例全量差分；历史综合报告只适用于其中记录的源码哈希。本次交互验证见部署目录外test/planner-usability-acceptance-20261014.md。
测试覆盖有限输入组合，不能据此声明穷尽所有合法配装、触发顺序或未来补丁。

明确边界与参考行为：
- 增益、附近敌人数、距离、层数与命中条件由使用者设置；不模拟战斗循环、走位、实际命中与概率。图表记录本次编辑的真实面板变化，不是时间轴战斗模拟。
- 随从传奇宝石保留镶嵌和孔数，但固定参考的随从计算不执行传奇宝石效果。本实现保持该行为，不据此断言游戏里全部传奇宝石都无效。
- 固定参考的寅剑“单独冷却行”与“覆盖率行”对固定秒数缩减采用不同括号位置。本版分别保持参考结果，相关配装会显示提示；不可据此断言游戏内冷却必然相同。
- 药水触发、祭坛护盾/拾取/掉落、黄道戒命中削减冷却等非静态效果不擅自折算进面板；提供说明与适用的独立开关。
- 旧配装、人工超额词条和不合法重复物品仍可能触发校验提示。参考数值一致性不等于游戏物品生成合法性证明。

部署只包含d3rank静态目录及本项目Worker。不要上传tools、test、vendor、backups或参考引擎缓存；不放宽CSP，不增加远程脚本或外部计算服务。