WebTools/CHANGELOG.md

Changelog

本文档记录面向使用者和维护者的重要变更。版本号以 package.json 为准。

0.0.6 - 2026-08-08

Added

• 增加统一的 Windows PowerShell 启动与更新脚本，提供固定的生产配置、Git 快进更新、锁定依赖重装和构建后启动流程。
• 增加 Windows Server 非 Docker 部署、启动和更新说明。
• 增加独立的固件 Hash 工具，计算 Intel HEX 总有效数据和各 block 的 SHA-256 / SHA-512。
• 增加 8 字节二进制 Block 校验头模式，头部包含 32 位绝对起始地址和 32 位数据长度，默认 Big Endian，并支持 Little Endian。

Fixed

• Intel HEX 解析器增加全部非空记录上限、显式 uint32 地址空间检查和无符号扩展地址运算，拒绝越过 0xFFFFFFFF 的数据。
• 固件 Hash 在普通 HTTP 局域网访问时增加本地 SHA-256/SHA-512 回退，不再依赖 SubtleCrypto 必须可用。
• 生产服务在监听端口前检查 dist/index.html，缺少构建产物时立即给出构建命令，不再启动后按请求重复返回 500。
• 修复固件 Hash 和安全随机数模式选择框宽度过大，以及 801-1040 像素中间宽度下 CRC 参数区可能横向溢出的问题。
• 修复 Windows 脚本无参数运行时直接启动旧 dist、容易被误认为已完成更新的问题；现在交互启动会明确选择启动、更新并启动、仅更新或退出。

Documentation

• 补充 dist/index.html 缺失、Node 进程未重启、浏览器页面未刷新和前台 PowerShell 退出等启动故障排查说明。
• 将 Node、Docker Compose、容器健康检查、Windows 脚本和示例配置的生产默认端口统一为 9000。
• 增加通用 README.md 入口并强化 AGENTS.md 新会话接手流程，便于其他 AI 在不依赖历史对话的情况下继续维护。
• 完善英文项目入口与中文权威文档，补充核心工具行为、异步竞态、版本文件、Windows 单 EXE 评估和发布边界。
• 扩充 AGENTS.md 的工具扩展、Intel HEX 安全、响应式 UI、部署发布和 Git 操作约束。

Verification

• 74 条 Vitest 测试通过，新增标准 SHA 向量、Block 头大小端、地址绑定、最高 uint32 地址、地址溢出、控制记录边界、无 Web Crypto 回退、生产构建预检和部署配置一致性覆盖。
• Vue/TypeScript 类型检查和生产构建通过。

0.0.5 - 2026-08-07

Changed

• CRC 文件读取、Intel HEX 解析和 CRC 计算统一放入独立 Web Worker，页面只保留文件摘要和结果。
• 设置页排序操作提取为可测试的纯函数，并增加加载就绪状态。
• 工具目录、默认导航、图标注册和懒加载组件增加运行时及自动化一致性检查。
• Node.js 最低版本明确为 22.12.0，增加 typecheck 和统一的 npm run check 门禁。
• 补全生产依赖版本与许可证说明。

Fixed

• 修复 CRC 更换文件、重新计算及旧 Worker 响应覆盖当前状态的竞态问题。
• Intel HEX 增加文件、记录数和 block 数限制，并降低记录合并时的内存占用。
• PNG 在浏览器解码前校验签名、IHDR、文件大小、尺寸和总像素；清空或更换图片后忽略旧转换结果。
• ICO 在创建 Canvas 前校验并规范化尺寸。
• 修复设置页首次加载时保存按钮可能被错误启用的问题。
• 修复缺失 JS/CSS 被错误返回 index.html 和 200 状态的问题。
• 修复导航原子写入失败后可能残留临时文件的问题。
• Base64 解码拒绝非规范尾部填充位。
• 大型 JSON/XML 结果在语法 token 过多时降级为纯文本，避免创建过量 DOM 节点。
• 移动端菜单增加正确的展开状态、动态标签和路由切换自动关闭行为。

Verification

• 49 条 Vitest 测试通过，覆盖算法、边界、目录一致性、排序逻辑和真实 HTTP 服务。
• Vue/TypeScript 类型检查和 Vite 生产构建通过。
• npm 依赖审计结果为 0 个已知漏洞。
• 桌面端和 390 x 844 移动端完成浏览器验收，9 个工具路由无横向溢出或控制台错误。