2D GAME ENGINE & RUNTIME

用 FCC 脚本构建 2D 世界

FancyBox2D 是面向 2D 游戏与交互式应用的运行时框架:以 Go 实现核心,以 Ebiten 负责图形呈现,并提供类 C 语法的 FCC 脚本开发体验。

DOWNLOAD

FancyWorld 演示程序

Windows 64 位 · 安装包版本 1.8.3.2 · 发布于 2026-11-17 02:33 · 133.6 MB

由 FancyBox2D 引擎驱动的完整 2D 游戏演示世界,下载安装后即可进入在线广场体验。

下载安装包

DEVELOPER TOOL

FBStudio 工作台

Windows 64 位 · 安装包版本 1.8.3.12 · 发布于 2026-11-17 02:53 · 30.3 MB

面向开发者的本地图形工作台:脚本编辑与诊断、构建打包、场景预览,安装后以独立窗口启动;内置客户端与服务端运行时,打开任意脚本目录即可预览,新建项目即可构建并运行服务端程序。

下载 FBStudio

SERVER RUNTIME

Linux 服务端部署包

Linux 64 位(amd64) · 版本 1.8.2 · 压缩包 14.9 MB

包含 fbserver 与 fwdemon 两个静态链接程序,解压即可在 Linux 上启动服务端,适合自建服务器部署。

下载服务端

CAPABILITIES

为脚本驱动的 2D 应用准备

从对象、脚本到绘制命令,FancyBox2D 将运行时的核心环节组合在一起。

FCC 脚本语言

支持类、继承、函数、宏、条件和循环,让游戏逻辑以熟悉的类 C 语法表达。

对象与方法系统

以 Root 对象树组织窗口、文本、图像、地图与人物,并通过参数和方法组合交互行为。

命令流渲染

对象系统生成设备无关的 DrawCmd 绘制命令,由 Ebiten 后端执行 GPU 呈现。

独立启动器

使用 launcher.exe 直接运行 FCC 脚本,适合快速预览、演示与 Windows 开发流程。

嵌入式运行时

objsys.dll 以 c-shared 产物提供宿主集成入口,与独立启动器共享同一引擎核心。

编辑器扩展

VS Code / Qoder 插件提供 FCC 语法高亮与补全、F5 一键运行、运行时追踪面板,以及 ALE 动画资源预览与编辑(偏移十字线、播放速度、帧内脚本、帧序调整)。

完整学习手册

浏览 FCC 语法、内置函数、对象属性、系统方法与事件参考。

进入手册

WORKFLOW

从脚本到画面

FCC 源文件经过扫描、宏处理和语法解析后由解释器执行;对象树生成绘制命令,Ebiten 在屏幕上完成渲染。

  1. 编写使用 FCC 定义对象、事件和游戏逻辑。
  2. 运行由 launcher.exe 加载脚本并启动运行时。
  3. 呈现对象系统生成命令流,Ebiten 绘制最终画面。

DOCUMENTATION

从 FCC 学习手册开始

现有手册收录 900 余条语法、对象、方法、函数与事件参考,覆盖脚本开发的常用入口。

打开学习手册

RELEASE NOTES

最新更新

按日期罗列各次更新的内容,新的在上、历史的在下。

2026-11-17 · FBStudio 1.8.3.12:内置运行时升级 1.8.3,修复独立窗口位置问题

  1. 更新内容FBStudio 安装包更新为 fbstudio_setup_1.8.3.12.exe(Windows 64 位,30.3 MB);首页下载按钮已指向新版本,已安装用户重新下载覆盖安装即可获得更新。
  2. 运行时升级工作台内置的客户端运行时(独立启动器与引擎)升级到 1.8.3,与服务端运行时一起随包分发,新建项目即用最新引擎构建与预览。
  3. 修正的问题上一版内置的独立启动器存在与桌面客户端 1.8.3.1 相同的问题:从工作台独立运行脚本时窗口可能跑到屏幕外。本版已随引擎修复,窗口恢复到默认位置正常显示。
  4. 版本安装包版本 1.8.3.12 —— 前三段是引擎版本(1.8.3),第四段是工作台修订号。
  5. 验证安装包静默安装实测:窗口位置在屏幕内、标题自报 FBStudio · 1.8.3.12,内置运行时与桌面客户端 1.8.3.2 同源;下载地址已核验与本地安装包逐字节一致。

2026-11-17 · FancyWorld 1.8.3.2:窗口位置修复,网页在线体验同步升级

  1. 更新内容桌面客户端更新为 fwsetup_1.8.3.2.exe(Windows 64 位,133.6 MB);首页下载按钮已指向新版本,已安装用户重新下载覆盖安装即可获得更新。
  2. 修正的问题上一版 1.8.3.1 启动后窗口可能跑到屏幕外:任务栏图标亮起、音乐正常播放,但看不到游戏窗口。本版已修复,窗口恢复到默认位置正常显示。
  3. 引擎升级引擎版本升级到 1.8.3;本次修复仅涉及窗口初始位置,画质与玩法无任何变化。
  4. 网页在线体验在线体验页同步升级到 1.8.3,与桌面客户端同源。
  5. 版本安装包版本 1.8.3.2 —— 前三段是引擎版本(1.8.3),第四段是脚本修订号。
  6. 验证安装包静默安装实测:入口脚本运行正常,窗口位置在屏幕内;网页在线体验页实测自报 1.8.3、示例运行无报错。

2026-11-16 · FBStudio 1.8.2.11:预览嵌窗,真实引擎窗口嵌入面板

  1. 更新内容FBStudio 安装包更新为 fbstudio_setup_1.8.2.11.exe(Windows 64 位,30.2 MB);首页下载按钮已指向新版本,已安装用户重新下载覆盖安装即可获得更新。
  2. 嵌窗工作台与场景页的预览新增「嵌窗」勾选:把真实引擎窗口(SetParent)嵌进预览面板,画面即点即交互,Esc 或「停止」结束;嵌入期间脚本侧的窗口动作(改尺寸、全屏、置顶等)被屏蔽,子窗始终钉在面板区域。
  3. 组合语义嵌窗与 等比缩放/平铺 正交组合:平铺+嵌窗=引擎铺满面板并实时跟随尺寸;等比+嵌窗=按脚本桌面尺寸 1:1 居中,面板装不下时钉左上并裁剪到面板边界,不遮挡相邻面板。
  4. 版本安装包版本 1.8.2.11 —— 前三段是引擎版本(1.8.2,本次未变),第四段是工作台修订号。
  5. 验证隔离实例实测:平铺+嵌窗内容与面板逐像素重合;等比 400×300 恰好居中、2000×1400 超大桌面裁剪后可见内容严格在面板内;取消勾选或按 Esc 后宿主窗口隐藏、进程干净退出;勾选下切换显示模式宿主随模式重落位。安装包静默覆盖安装后启动正常,接口自报 studio 1.8.2.11。

2026-11-16 · FBStudio 1.8.2.10:desktop 完整接口,预览锁定100%,输出彩色可点击

  1. 更新内容FBStudio 安装包更新为 fbstudio_setup_1.8.2.10.exe(Windows 64 位,30.2 MB);首页下载按钮已指向新版本,已安装用户重新下载覆盖安装即可获得更新。
  2. desktop 接口层级树选中 desktop 根节点时,属性面板返回完整接口信息:58 项属性(窗口标题 caption、置顶 topmost、更新间隔 updatedelay、帧率 fps、对象数 objnum、启动参数 startagv 等)与 40 个引擎函数(Exit、ReStart、FullScreen、Shell、热键注册、跨进程共享参数、系统错误报告等),并可像其它脚本函数一样查看定义;此前选中 desktop 只有空提示。
  3. 锁定100%工作台与场景页的预览在等比缩放模式下新增「锁定100%」勾选:勾选后帧按渲染尺寸 1:1 显示,调整面板大小画布不再缩放,超出部分滚动查看(装得下仍居中);平铺模式本身即 1:1,勾选自动置灰。
  4. 输出彩色输出面板按引擎行协议分色渲染:脚本 ? 调试输出与正常信息为绿色、警告黄色、错误红色,其余灰色;带源码位置的行点击后直接在代码面板打开并定位到对应行列。
  5. 版本安装包版本 1.8.2.10 —— 前三段是引擎版本(1.8.2,本次未变),第四段是工作台修订号。
  6. 验证浏览器实测:desktop 属性 58 项、函数 40 个全部显示;800×600 渲染帧勾选锁定后保持 100% 显示,压缩面板画布不变并出现滚动条;脚本调试输出在输出面板显示为绿色并可点击跳转源码。安装包静默覆盖安装后启动正常,标题栏显示「FBStudio · 1.8.2.10」。

2026-11-16 · FBStudio 1.8.2.9:编辑并入工作台,界面整体改直角

  1. 更新内容FBStudio 安装包更新为 fbstudio_setup_1.8.2.9.exe(Windows 64 位,30.2 MB);首页下载按钮已指向新版本,已安装用户重新下载覆盖安装即可获得更新。
  2. 编辑并入工作台顶栏「编辑」页签取消:脚本过滤与全文搜索移入工作台的「资源」面板(输入过滤词或搜索词时脚本结果树自动换下资源树,清空即恢复);「代码」面板内嵌完整编辑器,层级创建点、资源里的脚本、属性定义、搜索命中与诊断提示全部就地打开编辑,不再跳转。检查、保存并构建、保存并校验、保存四个按钮移到代码面板右上。
  3. Tab 修复脚本编辑区按 Tab 键不再丢失焦点,正确插入 4 个空格的跳格。
  4. 切换刷新切换工作目录或构建目标后,各面板不再残留旧目录的内容,资产、层级、预览、日志与代码一并按新目录刷新;打开工作目录时若目标配了入口脚本,预览面板自动渲一帧。
  5. 界面直角卡片、按钮、输入框、顶栏胶囊等全部改为直角风格,预览画布同步直角(仅状态圆点保持圆形)。
  6. 版本安装包版本 1.8.2.9 —— 前三段是引擎版本(1.8.2,本次未变),第四段是工作台修订号。
  7. 验证浏览器实测:过滤与搜索换树恢复正常、命中打开并定位到行、Tab 插 4 空格、保存落盘后磁盘内容一致、切换目标/目录面板即时刷新、打开目录 303 ms 自动出预览帧、卡片圆角读回 0;控制台无报错。安装包静默覆盖安装后启动正常,标题栏显示「FBStudio · 1.8.2.9」。

2026-11-16 · FBStudio 1.8.2.8:窗口标题显示工作台版本,场景页可直接改对象属性

  1. 更新内容FBStudio 安装包更新为 fbstudio_setup_1.8.2.8.exe(Windows 64 位,30.2 MB);首页下载按钮已指向新版本,已安装用户重新下载覆盖安装即可获得更新。
  2. 标题栏窗口标题原来显示引擎版本,现在改为 FBStudio 自身的版本号(如「FBStudio · 1.8.2.8」);反馈问题时一眼就能看出工作台是哪一版。
  3. 场景属性写回场景页选中对象树里的节点或画面里的对象框后,属性面板按该对象的创建点列出属性、函数、事件、样式和方法;带虚线下划线的值双击即可修改,未赋值的引擎参数可点击插入一条内联赋值。修改只写入编辑缓冲,保存前不会改动磁盘上的脚本文件;保存后场景自动重新渲染。
  4. 保存快捷键补上窗口级 Ctrl+S:焦点不在代码编辑器里时也能直接保存当前脚本。
  5. 已知限制由构造函数、样式或运行期表达式设置的参数不能直接在面板里改;同一对象已有同名内联赋值时不会重复插入,会提示改用修改。
  6. 版本安装包版本 1.8.2.8 —— 前三段是引擎版本(1.8.2,本次未变),第四段是工作台修订号。
  7. 验证在示例项目上选中 clt/index.fcc:34,改掉面板里的属性值并插入一条参数赋值,确认只脏编辑缓冲、磁盘文件未变;Ctrl+S 后落盘并自动重渲染,无脚本错误。安装包静默覆盖安装后启动正常,标题栏显示「FBStudio · 1.8.2.8」。

2026-11-16 · FBStudio 1.8.2.7:场景预览「平铺」改为 1:1 实时跟随面板尺寸

  1. 更新内容FBStudio 安装包更新为 fbstudio_setup_1.8.2.7.exe(Windows 64 位,30.2 MB);首页下载按钮已指向新版本,已安装用户重新下载覆盖安装即可获得更新。
  2. 平铺预览场景页「平铺」改为与引擎窗口拖边一致的手感:拖动预览面板的分割线时,画面宽高连续跟着面板尺寸变化,缩放比例始终 100%、不拉伸;每一步约 5–10 毫秒出帧,不再先拉伸旧帧等待整帧重渲染。
  3. 工作机制后端复用正在运行的渲染引擎,按新尺寸直接取帧并以原始像素返回,省去每帧约 50 毫秒的图像编码;引擎空闲 20 秒自动回收,运行或构建作业期间暂停跟随,作业结束后自动补一帧。
  4. 细节拖动停手约 0.2 秒后补齐对象框选与层级信息;等比缩放模式不受影响。
  5. 版本安装包版本 1.8.2.7 —— 前三段是引擎版本(1.8.2,本次未变),第四段是工作台修订号。
  6. 验证拖拽分割线实测画面尺寸逐步跟随(如 871→719→669→619 像素)且始终 100%,无空白帧;安装包在独立目录静默安装、启动、场景预览与跟随端点均正常。

2026-11-16 · FBStudio 1.8.2.6:编辑器与工作台代码面板支持语法着色

  1. 更新内容FBStudio 安装包更新为 fbstudio_setup_1.8.2.6.exe(Windows 64 位,30.2 MB);首页下载按钮已指向新版本,已安装用户重新下载覆盖安装即可获得更新。
  2. 语法着色代码编辑区按类别上色:属性、函数、事件、样式、方法、基本函数、宏、数字、标点各有颜色,字符串与注释单独区分;当前脚本里刚敲下的宏名与自定义样式名即时生效。工作台的代码面板同样着色。
  3. 工作台布局工作台重排为五列:层级与资源、预览与代码、调试焦点与输出、AI、属性;列宽可拖拽、自动记住,工具条与顶栏按钮改为图标。
  4. 调试焦点与输出运行客户端后按「·」键拾取对象,调试焦点面板显示对象摘要;点类名在层级树定位创建点并跳到对应代码,同类多个创建点可左右切换。输出面板实时显示运行、构建、打包日志,可一键停止。
  5. 搜索与属性脚本面板支持全文搜索,结果按文件分组,点命中直接跳到行列;属性面板可直接改写字面量、给未赋值参数插入内联参数,层级树可按名称或类筛选。
  6. 版本安装包版本 1.8.2.6 —— 前三段是引擎版本(1.8.2),第四段是工作台修订号。
  7. 验证编辑区与工作台代码面板的分类着色、即时刷新均通过实测;五列拖拽、图标按钮、输出日志与停止、调试焦点摘要与定位、全文搜索、属性改写均正常;安装包在独立目录静默安装、启动与卸载均正常。

2026-11-15 · FBStudio 1.8.2.5:修复启动时的命令窗口,项目说明改为每次打开补齐

  1. 更新内容FBStudio 安装包更新为 fbstudio_setup_1.8.2.5.exe(Windows 64 位,30.1 MB);首页下载按钮已指向新版本,使用 1.8.2.4 的用户建议重新下载覆盖安装。
  2. 命令窗口1.8.2.4 启动时会同时出现一个黑色的命令窗口,关掉它会连工作台一起退出;1.8.2.5 恢复正常,只打开工作台窗口,不再出现命令窗口。
  3. 项目说明doc 目录下的 README.md 改为每次打开工作目录时检查:没有就补上一份,已经有就保持不动;以前只有新建项目才会写,老项目里不会出现。doc 目录不存在时也会一并建好。
  4. 版本安装包版本 1.8.2.5 —— 前三段是引擎版本(1.8.2),第四段是工作台修订号。
  5. 验证装好的程序启动时不再带命令窗口;新建项目会生成 README.md,删掉后重新打开会补回,手动改过的内容重新打开保持不变;安装包在独立目录静默安装、启动与卸载均正常。

2026-11-15 · FBStudio 1.8.2.4:新建项目自带一份项目说明

  1. 更新内容FBStudio 安装包更新为 fbstudio_setup_1.8.2.4.exe(Windows 64 位,30.1 MB);首页下载按钮已指向新版本,已安装用户重新下载覆盖安装即可获得更新。
  2. 项目说明选择一个空目录建项目时,除了自动生成配置与目录,还会在 doc 目录下写一份 README.md:说明各目录的用途、配置文件每个字段的含义、构建与运行的命令、把服务端部署到 Linux 的步骤,以及脚本该放哪个目录的开发方式。
  3. 不覆盖已有说明这份 README.md 只在建项目时生成一次;文件已经存在就跳过,自己改过的内容不会被覆盖。
  4. 版本安装包版本 1.8.2.4 —— 前三段是引擎版本(1.8.2),第四段是工作台修订号。
  5. 验证用安装好的程序打开一个空目录,doc 目录下的 README.md 自动出现且内容与内置模板一致;把它改成自定义内容后重新建项目,文件保持不变;安装包在独立目录静默安装、启动与卸载均正常。

2026-11-15 · FBStudio 1.8.2.3:还没构建的项目不再提示清单错误

  1. 更新内容FBStudio 安装包更新为 fbstudio_setup_1.8.2.3.exe(Windows 64 位,30.1 MB);首页下载按钮已指向新版本,已安装用户重新下载覆盖安装即可获得更新。
  2. 新建项目提示刚建好、还没构建过的项目,打开资产列表不再出现「清单不可读」一类的错误提示。列表与目录树会直接说明还没有构建产物,构建一次即可;清单真的损坏或读不出来时仍会提示。
  3. 退出确认点右上角「退出」时只问一次是否确认退出,不再附带说明文字。
  4. 版本安装包版本 1.8.2.3 —— 前三段是引擎版本(1.8.2),第四段是工作台修订号。
  5. 验证以空项目启动,资产列表与目录树均显示空态提示、没有错误提示;退出确认只出现一句询问;安装包在独立目录静默安装、启动与卸载均正常。

2026-11-15 · FBStudio 1.8.2.2:空目录直接开项目,内置服务端运行时

  1. 更新内容FBStudio 安装包更新为 fbstudio_setup_1.8.2.2.exe(Windows 64 位,30.1 MB);体积明显变大,是因为安装包同时带上了 Windows 服务端运行时。首页下载按钮已指向新版本,已安装用户重新下载覆盖安装即可获得更新。
  2. 直接开新项目选择一个空目录作为工作目录时不再提示缺少配置,会自动生成一份最小项目配置,并建好 cas、clt、svr、arc、out、doc 六个目录;内置运行时同时复制到项目的 runtime 目录,打开即可预览。
  3. 服务端开发安装包内置 Windows 服务端程序(fbserver.exe、fwdb.exe、fwdemon.exe),新建项目的服务端目标默认指向 runtime/server/,编译出的服务端脚本使用随包的服务端程序运行,不必另外准备运行时。
  4. 目录选择点击「选择目录」时不再附带一个空白的命令行窗口。
  5. 版本安装包版本 1.8.2.2 —— 前三段是引擎版本(1.8.2),第四段是工作台修订号。
  6. 验证以空目录启动会自动生成配置、六个目录与内置运行时;服务端目标能识别 runtime/server/ 下的服务端程序(单元测试核对);目录选择不再出现命令行窗口;安装包在独立目录静默安装并启动正常。

2026-11-15 · FBStudio 1.8.2.1:独立窗口启动,内置运行时

  1. 更新内容FBStudio 安装包更新为 fbstudio_setup_1.8.2.1.exe(Windows 64 位,13.0 MB),引擎由 1.8.0 升到 1.8.2;首页下载按钮已指向新版本,已安装用户重新下载覆盖安装即可获得更新。
  2. 启动方式双击不再弹出黑色控制台窗口,改为独立的原生窗口,关闭窗口即退出;启动失败时弹窗说明原因,运行日志写入用户目录下的 FBStudio\studio.log。
  3. 单实例与退出重复启动会提示工作台已在运行后直接退出,不再多开;页面右上角新增「退出」按钮,命令行也可用 -stop 结束正在运行的实例。
  4. 内置运行时安装包自带 runtime 目录(启动器、引擎与渲染 DLL);打开尚未构建运行时的脚本目录时自动改用内置运行时启动,不必先在工作区里准备 bin/win。
  5. 版本安装包版本 1.8.2.1 —— 前三段是引擎版本(1.8.2),第四段是工作台修订号。
  6. 验证安装包在独立目录静默安装并启动:窗口正常显示、关闭后进程退出;页面「退出」按钮与 -stop 均能结束进程并清理实例记录;工作区缺少启动器时会改用内置 runtime 启动(单元测试与实机核对);程序为窗口子系统,无控制台窗口。

2026-11-15 · 桌面客户端 1.8.2.1:文字与三角绘制改由显卡直接完成

  1. 更新内容桌面安装包更新为 fwsetup_1.8.2.1.exe(Windows 64 位,133.6 MB),引擎由 1.8.1 升到 1.8.2;首页下载按钮已指向新版本,已安装用户重新下载覆盖安装即可获得更新。
  2. 文字绘制界面与场景中的文字改为按字形整批提交,由显卡直接绘制,常规文字画面不再回退到软件逐像素绘制;新增字符的首帧也会立即走上显卡路径,不会短暂退回软件绘制。
  3. 三角绘制三角网格与自由三角形绘制改为可由显卡完整重放,画面结果与软件绘制逐像素一致;更多场景保持全程显卡绘制。
  4. 版本安装包版本 1.8.2.1 —— 前三段是引擎版本(1.8.2),第四段是脚本修订号;本次客户端的游戏脚本没有变化,修订号沿用 1。
  5. 验证引擎导出接口与 1.8.1 完全一致,安装包静默安装后 7523 个文件与发布树逐字节一致,启动显示 1.8.2、控制台无报错;逐字增长文字的长时间实测未再出现绘制回退。

2026-11-14 · 桌面客户端 1.8.1.1:底部关于入口与水印移除,FBStudio 下载上架

  1. 更新内容桌面安装包更新为 fwsetup_1.8.1.1.exe(Windows 64 位,133.5 MB),引擎由 1.8.0 升到 1.8.1;首页下载按钮已指向新版本,已安装用户重新下载覆盖安装即可获得更新。网页在线体验同步升级到 1.8.1。
  2. 关于入口精简取消窗口右下角的隐藏点击区与其上的 FCBOX 水印,界面更干净;关于对话框仍可按 F1 呼出,内容与操作不变。
  3. FBStudio 上架首页新增 FBStudio 工作台下载:面向开发者的本地图形工作台,支持脚本编辑与诊断、构建打包与场景预览,安装后打开浏览器即可使用。
  4. 版本安装包版本 1.8.1.1 —— 前三段是引擎版本(1.8.1),第四段是脚本修订号;本次客户端的游戏脚本没有变化,修订号沿用 1。
  5. 验证引擎导出接口与 1.8.0 完全一致,安装包静默安装后 7523 个文件与发布树逐字节一致,启动显示 1.8.1、控制台无报错;网页在线体验的示例运行正常。

2026-11-14 · 桌面客户端 1.8.0.1:脚本新增 vec4 向量与 dic 字典,绘制批处理提速

  1. 更新内容桌面安装包更新为 fwsetup_1.8.0.1.exe(Windows 64 位,133.5 MB),引擎由 1.7.12 升到 1.8.0;首页下载按钮已指向新版本,已安装用户重新下载覆盖安装即可获得更新。网页在线体验同步升级到 1.8.0。
  2. 四维向量脚本新增 vec4(x, y, z, w) 构造,生成四个分量的向量值;.x / .y / .z / .w 可读可写,.len 取长度、.str 取紧凑文本形式、.type 返回 "vec4"。同维向量支持加减与取反,可与数值乘除缩放,也可以直接拼进字符串。
  3. 字典类型脚本新增 dic() 空字典:用 d['key'] = v 或 d.set('key', v) 写入,用 d['key'] 或 d.get('key') 读取(可附带默认值),d.has 判断是否存在、d.del 删除;.size / .len 取条目数、.keys 取排序后的键列表、.str 取文本形式。字典是引用类型,赋值给别的变量后指向同一份内容,适合当配置表或映射表在多个对象之间共享。
  4. 绘制提速同一层内的矩形填充与图片绘制会先合并成批次再统一提交,界面元素较多的场景每帧绘制开销下降;基准测试中大量矩形填充的耗时约降低一成七,逐个像素对照画面结果与合并前完全相同。
  5. 版本安装包版本 1.8.0.1 —— 前三段是引擎版本(1.8.0),第四段是脚本修订号;本次只更新引擎、客户端的游戏脚本没有变化,修订号按新引擎从 1 起算。
  6. 验证新引擎与 1.7.12 用同一场景对照运行,画面逐像素一致、重启流程与日志输出一致,控制台无报错;vec4 与字典功能在脚本示例中逐项核对结果;安装包在独立目录静默安装(7523 个文件)并启动运行,版本显示 1.8.0、控制台无报错。网页在线体验的 Hello World 与烈火英雄示例运行正常,Hello World 画面与本地逐位一致。

2026-11-14 · 桌面客户端 1.7.12.1:GPU 直绘路径上线,画质与 CPU 路径一致

  1. 更新内容桌面安装包更新为 fwsetup_1.7.12.1.exe(Windows 64 位,133.5 MB),引擎由 1.7.11 升到 1.7.12;首页下载按钮已指向新版本,已安装用户重新下载覆盖安装即可获得更新。
  2. 新的绘制路径渲染 DLL 在原有的整帧 CPU 合成之外新增一条 GPU 直绘通道:引擎照旧在 CPU 上合成整帧作为基准,同时把这一帧的绘制任务清单交给渲染 DLL,由显卡直接完成清屏、矩形填充、纹理绘制与裁剪。遇到调试面板、跳帧、逐像素回读等特殊帧时自动退回原来的 CPU 路径,不会出现两边各画各的。
  3. 画质一致每一帧 GPU 输出都要与 CPU 基准逐像素对照:完整登录场景 800×600 中 382,295 个像素完全相同、其余像素差异不超过 2 级色阶(8 位颜色),没有超限像素;矩形与贴图测试场景则逐像素完全一致。
  4. 修正的问题调试中发现带透明区域的贴图(人物、场景图等)在 GPU 通道下会以黑色方块盖住背景;现已固定纹理绘制始终按透明度混合,与 CPU 路径处理一致。
  5. 版本安装包版本 1.7.12.1 —— 前三段是引擎版本(1.7.12),第四段是脚本修订号;本次只更新引擎、客户端的游戏脚本没有变化,修订号按新引擎从 1 起算。
  6. 验证新引擎与 1.7.11 用同一登录场景对照运行,GPU 输出无超限像素、控制台 0 报错;不可直绘的帧按预期回退到 CPU 路径并计数;安装包在独立目录静默安装并启动运行,从安装目录加载引擎与渲染 DLL,控制台无报错。

2026-11-14 · 桌面客户端 1.7.11.1:渲染流程内部重构,画面不变

  1. 更新内容桌面安装包更新为 fwsetup_1.7.11.1.exe(Windows 64 位,133.5 MB),引擎由 1.7.10 升到 1.7.11;首页下载按钮已指向新版本,已安装用户重新下载覆盖安装即可获得更新。网页在线体验同步升级到 1.7.11。
  2. 底层调整引擎内部的绘制流程改为先把每一帧的绘制整理成一份「绘制任务」清单,再由统一执行器按顺序完成;本次先在不使用独立渲染 DLL 的 CPU 绘制路径落地,为后续的合并绘制与性能优化打基础。
  3. 画面不变这是一次内部结构调整,画面、动画与场景切换的显示结果与 1.7.10 完全相同:同一场景 800×600 画面逐像素对照无差异。
  4. 版本安装包版本 1.7.11.1 —— 前三段是引擎版本(1.7.11),第四段是脚本修订号;本次只更新引擎、客户端的游戏脚本没有变化,修订号按新引擎从 1 起算。
  5. 验证新引擎与 1.7.10 用同一场景对照运行,画面逐像素一致、重启流程与日志输出一致,控制台无报错;安装包在独立目录静默安装(7525 个文件)并启动运行,版本显示 1.7.11、控制台无报错。网页在线体验的 5 个示例全部跑通。

2026-11-13 · 桌面客户端 1.7.10.2:调试与拾取浮层刷新收尾

  1. 更新内容桌面安装包更新为 fwsetup_1.7.10.2.exe(Windows 64 位,133.5 MB),引擎由 1.7.9 升到 1.7.10;首页下载按钮已指向新版本,已安装用户重新下载覆盖安装即可获得更新。网页在线体验同步升级到 1.7.10。
  2. 修正的问题F7 调试信息框关闭后,画面上会残留一圈 1 像素宽的细边;现在关闭信息框时会把它的边框一起纳入重绘,收尾干净,不再留下残影。
  3. 对象拾取面板按 · 键调出的对象拾取面板此前没有把自己占用的区域标记为需要重绘,面板出现、变化或收起时可能留下旧画面;现在面板显示、切换模式与关闭都会即时刷新,五颗按钮的状态变化也能立刻看到。
  4. 影响范围两处改动都只涉及调试信息框与对象拾取面板这两块浮层,正常游戏画面、动画与场景切换的重绘行为与 1.7.9 完全相同。
  5. 版本安装包版本 1.7.10.2 —— 前三段是引擎版本(1.7.10),第四段是脚本修订号;本次只更新引擎、客户端的游戏脚本没有变化,修订号保持 2。
  6. 验证新引擎与 1.7.9 用同一场景对照运行,800×600 第 3 帧画面逐像素一致、重启流程与日志输出一致,控制台无报错;安装包在独立目录静默安装(7526 个文件)并启动运行,版本显示 1.7.10、控制台无报错。网页在线体验的 5 个示例全部跑通。

2026-11-13 · 桌面客户端 1.7.9.2:脚本新增 vec2 / vec3 向量类型

  1. 更新内容桌面安装包更新为 fwsetup_1.7.9.2.exe(Windows 64 位,133.5 MB),引擎由 1.7.8 升到 1.7.9;首页下载按钮已指向新版本,已安装用户重新下载覆盖安装即可获得更新。网页在线体验同步升级到 1.7.9。
  2. 构造与取值脚本里新增 vec2(x, y) 与 vec3(x, y, z) 两个构造内建,生成二维 / 三维向量值;用 .x / .y / .z 读取分量,也可以直接赋值改写(如 p.x = 10)。.len 取向量长度,.str 取紧凑文本形式 "(x, y)",.type 返回 "vec2" 或 "vec3"。
  3. 运算同维向量支持加减(如 p + vec2(1, 1))与取反,向量与数值支持乘法缩放(如 2 * q,写在数值或向量的任意一侧均可)。vec2 与 vec3 混算、或把向量当整数参与其它运算时会在出错位置明确报错,不再悄悄算成 0;向量也可以直接拼进字符串,如 "pos=" + p。
  4. 版本安装包版本 1.7.9.2 —— 前三段是引擎版本(1.7.9),第四段是脚本修订号;本次只更新引擎、客户端的游戏脚本没有变化,修订号保持 2。
  5. 验证新引擎与 1.7.8 用同一场景对照运行,画面逐像素一致、重启流程与日志输出一致,控制台无报错;安装包在独立目录静默安装并启动运行,版本显示 1.7.9、控制台无报错。网页在线体验的 5 个示例全部跑通。

2026-11-13 · 桌面客户端 1.7.8.2:只重绘变化的区域,静态画面不再空转

  1. 更新内容桌面安装包更新为 fwsetup_1.7.8.2.exe(Windows 64 位,133.5 MB),引擎由 1.7.7 升到 1.7.8;首页下载按钮已指向新版本,已安装用户重新下载覆盖安装即可获得更新。
  2. 现在的做法每帧只重绘画面中真正发生变化的区域;整屏没有任何变化时(例如停在静态场景、没有动画也没有面板交互)直接跳过这一帧的绘制与上传,空闲时更省 CPU 与显卡占用。窗口尺寸变化、重开面板、切换场景等整屏刷新的场合不受影响。
  3. 变动区域的合并一帧里有多个对象各自变化时,先把这些小区域合并成少量矩形再统一重绘;相互重叠、彼此相邻的变动会自动归并,不容易退化成整屏重绘。单帧可跟踪的变动区域上限也由 32 个提高到 64 个,对象较多的场景下同样走局部重绘。
  4. 版本安装包版本 1.7.8.2 —— 前三段是引擎版本(1.7.8),第四段是脚本修订号;本次只更新引擎、客户端的游戏脚本没有变化,修订号保持 2。
  5. 验证新引擎与 1.7.7 用同一场景对照运行,画面逐像素一致(800×600 第 3 帧校验完全相同),重启流程与日志输出一致、控制台无报错;安装包在独立目录静默安装并逐文件比对(7523 个载荷文件全部一致)。

2026-11-12 · 桌面客户端 1.7.7.2:登录卡住问题修复

  1. 更新内容桌面安装包更新为 fwsetup_1.7.7.2.exe(Windows 64 位,133.5 MB),引擎仍为 1.7.7,本次只重新打包客户端脚本;首页下载按钮已指向新版本,已安装用户重新下载覆盖安装即可获得更新。
  2. 问题与背景1.7.7 / 1.7.7.1 的安装包在输入账号密码后一直停在连接界面,进不了游戏;而在开发目录里直接用同一套脚本启动则一切正常。
  3. 原因新格式把游戏脚本改为预先编译,编译时每个脚本是分开处理的,入口脚本里声明的账号服地址没能延续到后续脚本。于是登录流程仍指向开发环境的本机地址(127.0.0.1),连接被拒绝后界面只停在重试提示、没有进一步提示,看起来就是卡死。
  4. 现在的做法打包时先按客户端启动顺序加载入口脚本,把它留下的公共设置作为后续所有脚本的起点,与运行时行为保持一致;登录相关脚本里的账号服地址也随之恢复为公网地址。
  5. 版本安装包版本 1.7.7.2 —— 前三段是引擎版本(1.7.7),第四段是脚本修订号,本次修订号由 1 升到 2。引擎没有变化,已安装用户直接覆盖安装即可。
  6. 验证重新编译后逐脚本比对:1327 个预编译脚本中只有 24 个登录相关脚本的地址发生变化,其余完全一致;安装包在独立目录静默安装并逐文件比对(7523 个载荷文件全部一致)。

2026-11-12 · 桌面客户端 1.7.7.1:客户端脚本归档升级为预编译格式

  1. 更新内容桌面安装包更新为 fwsetup_1.7.7.1.exe(Windows 64 位,133.6 MB),引擎由 1.7.4 升到 1.7.7;首页下载按钮已指向新版本,已安装用户重新下载覆盖安装即可获得更新。
  2. 现在的做法随包发布的游戏脚本改为预先编译好的归档,客户端启动时直接加载,不再在现场逐个编译脚本,冷启动更直接;归档格式同时把字符串长度上限与数字范围放宽,此前装不进包的超长文本与地图字面量现已可正常打包。
  3. 体积说明归档内容经过压缩与掩码处理,安装包内不再是可直接阅读的脚本明文,体积由 114.0 MB 增至 133.6 MB。掩码只是提高成品的传播门槛,不提供保密;需要保护的内容仍以服务端下发为准。
  4. 版本安装包版本 1.7.7.1 —— 前三段是引擎版本(1.7.7),第四段是脚本修订号,本次修订号保持 1。新格式脚本需要 1.7.7 及以上引擎,旧版客户端请以本次安装包覆盖安装。
  5. 验证安装包在独立目录静默安装并逐文件比对(7525 件全部一致);装出的引擎自报 1.7.7;安装目录直接启动客户端,标题、界面、背景音乐与动画均正常,控制台无报错。

2026-11-12 · 桌面客户端 1.7.4.1:F1/F2 面板关闭后的画面残留修复上线

  1. 更新内容桌面安装包更新为 fwsetup_1.7.4.1.exe(Windows 64 位,114.0 MB),引擎由 1.7.2 升到 1.7.4,包含 1.7.3 的 F1 关于面板残留修复与 1.7.4 的 F2 帧率面板残留修复;首页下载按钮已指向新版本,已安装用户重新下载覆盖安装即可获得更新。
  2. 问题与背景游戏中按 F1 打开再关闭关于面板、或按 F2 打开再关闭帧率面板后,面板所在区域会留下一块旧画面,背后的场景不再刷新。
  3. 现在的做法面板关闭时把面板占用的区域标记为待刷新,关闭后该区域的画面能正常重绘,不再残留。
  4. 版本安装包版本 1.7.4.1 —— 前三段是引擎版本(1.7.4),第四段是脚本修订号;本次只更新引擎、客户端的游戏脚本没有变化,修订号保持 1。
  5. 验证安装包在独立目录静默安装并逐文件比对(7525 件全部一致);装出的引擎为 1.7.4;F1/F2 面板反复开关后画面无残留,控制台无报错。

2026-11-11 · 桌面客户端 1.7.2.1:骨骼动画裁剪与缩小显示修复上线

  1. 更新内容桌面安装包更新为 fwsetup_1.7.2.1.exe(Windows 64 位,114.0 MB),引擎由 1.7.0 升到 1.7.2,包含 1.7.1 的骨骼动作裁剪修复与 1.7.2 的缩小显示平滑;首页下载按钮已指向新版本,已安装用户重新下载覆盖安装即可获得更新。
  2. 问题与背景Spine 角色部分动作(例如抬起的双手)会被对象原来的矩形范围裁掉;角色缩小显示时边缘锯齿明显。
  3. 现在的做法绘制裁剪范围改为包含当前动作姿势的范围,超出原始尺寸的动作不再被裁;缩小绘制时按当前缩放缓存的低一级纹理取样,边缘更平滑。
  4. 版本安装包版本 1.7.2.1 —— 前三段是引擎版本(1.7.2),第四段是脚本修订号;本次只更新引擎、客户端的游戏脚本没有变化,修订号保持 1。
  5. 验证安装包在独立目录静默安装并逐文件比对,装出的文件与发布内容一致;启动后关于面板显示 1.7.2;骨骼示例的动作可完整播放、缩小显示平滑,控制台无报错。

2026-11-11 · 网页在线体验 1.7.2:Spine 完整角色示例上线,缩小显示更平滑

  1. 新增内容网页在线体验「学习」页新增「Spine 骨骼动画」示例:一个完整角色资产(495 骨骼 / 325 槽位,待机、入场与六段互动共 8 段动画),下方按钮切换动作,一次性动画播完自动回到待机;滚轮以光标为中心缩放,按住右键拖动角色,还可一键镜像。角色纹理约 13 MB,首次运行需要下载。
  2. 问题与背景此前在线体验没有骨骼动画示例;Spine 角色缩小显示时边缘锯齿明显,部分动作里抬起的双手会被对象原来的矩形范围裁掉。
  3. 现在的做法缩小绘制时按当前缩放缓存的低一级纹理取样,边缘更平滑;绘制裁剪范围改为包含当前动作姿势的范围,超出原始尺寸的手部动作不再被裁;网页在线体验引擎同步更新到 1.7.2。
  4. 版本网页在线体验引擎 1.7.0 → 1.7.2,包含 1.7.1 的动作裁剪修复与 1.7.2 的缩小平滑;桌面安装包已同步更新为 1.7.2.1(见上一条)。
  5. 验证新示例的 8 段动画均可播放并自动回到待机,缩放、右键拖动与镜像操作正常,控制台无报错;与更新前对照,同一缩放档位下角色边缘的锯齿明显减少。

2026-11-11 · 引擎 1.7.0:内置 Spine 骨骼动画,脚本可直接加载、播放与混合

  1. 问题与背景角色与特效动作此前只能靠逐帧序列图或外部实现,资源体积大、动作切换生硬,脚本里也拿不到动画播到某一帧时的事件(脚步声、打击点等),很难做精确的动作与音效配合。
  2. 现在的做法引擎内置 Spine 2D 骨骼动画运行时,直接读取 Spine 导出的图集(.atlas 与页图)和骨架文件(.json,另支持二进制 .skel)。脚本新增 spine 类:加载与释放资源、按名称播放动画、停止、设置循环、播放速度与时间,按名称切换皮肤;支持骨骼、IK、变换与路径约束,网格、裁剪附件、亮部/暗部双色着色和四象限镜像;多个动画可以混合过渡,动画事件会回调到脚本并携带整数、浮点与字符串参数。同一份图集与骨架可被多个对象共享,关闭后还能重新加载,不必每帧重复解码。
  3. 版本引擎版本号 1.6.10 → 1.7.0,安装包沿用四段号 1.7.0.1;本次为客户端与网页在线体验更新,服务端无需替换。
  4. 下载桌面安装包已更新为 fwsetup_1.7.0.1.exe(Windows 64 位,114.0 MB);已安装用户重新下载覆盖安装即可获得更新。
  5. 验证与官方 Spine 运行时的骨骼矩阵、顶点、纹理坐标与颜色逐帧对拍一致,不同缩放档位的渲染结果像素级相同;示例脚本演示了待机、行走、挥手三套动画切换、换皮肤、镜像与事件回调,均按预期播放。网页在线体验已同步更新到 1.7.0。

2026-11-10 · 安装包 1.6.10.1:台球房离场更自然,场景导航条改为按需显示

  1. 问题与背景台球房点「返回大厅」时面板一下消失,显得生硬;瞄准白球蓄力时,出球方向总有轻微随机偏移;GM 玩家的场景导航条一进游戏就常驻画面顶部,挡住视线;窗口较小时打开版权页,图片右侧会被裁掉一部分;背包等界面里带发光的文字边缘发糊、出现硬边。
  2. 原因台球房面板关闭时直接销毁,没有过渡动作;瞄准方向在每次蓄力时会叠加一个随机扰动角;导航条固定为默认显示;版权图片按原始尺寸绘制,超宽时会溢出内容区;文字发光此前用简单的颜色叠加,半透明部分没有经过模糊处理。
  3. 现在的做法台球房离场改为先滑落收起再关闭;瞄准扰动归零,出球方向与蓄力方向一致;场景导航条默认隐藏,GM 在聊天栏输入 /shownav 显示、输入 /hidenav 隐藏并给出提示;版权图超宽时按内容区等比缩放;文字发光改走掩膜模糊,恢复柔和半透明光晕。
  4. 版本安装包版本改为四段号 1.6.10.1 —— 前三段是引擎版本(1.6.10),第四段是脚本修订号;今后引擎不变、只更新脚本时,安装包也会递增第四段,便于区分不同批次的脚本版本。服务端、网页在线体验与桌面安装包同步更新。
  5. 下载桌面安装包已更新为 fwsetup_1.6.10.1.exe(Windows 64 位,113.7 MB);已安装用户重新下载覆盖安装即可获得更新。
  6. 验证台球房点返回大厅,面板先滑落再关闭;瞄准方向稳定,不再随机偏移;GM 账号在聊天栏输入 /shownav 出现导航条、输入 /hidenav 收起并提示;缩小窗口打开版权页图片完整显示;背包等界面文字光晕边缘柔和。

2026-11-09 · 引擎 1.6.9:亲密互动恢复正常,装备支持右键一键穿戴

  1. 问题与背景在广场里靠近其他玩家做亲吻、拥抱时,角色常常停在对方一两步外,反复点击也贴不近,提示「咫尺天涯,不能执行邀请」;装备面板里用右键换装,鞋子等部位会提示无法装备,只能手动拖进对应槽位。
  2. 原因角色移动路径中,每一步的坐标会被压缩成一串字符;这串字符所用的取值表与坐标校验所用的取值表不是同一套,大多数五位组合对不上,服务端按末点坐标核对距离时就会判定角色没有走到;装备面板的右键快捷穿装也只覆盖了部分部位。
  3. 现在的做法路径字符与坐标校验统一为同一套取值表,寻路末点也保证落在请求的位置上;装备面板右键统一支持全部 8 个部位,直接穿到对应槽位,槽位已有物品或部位不匹配时会给出提示。
  4. 版本引擎版本号 1.6.8 → 1.6.9;服务端、网页在线体验与桌面安装包同步更新。客户端与服务端需要同一版本,旧客户端会出现互动位置不同步。
  5. 下载桌面安装包已更新为 fwsetup_1.6.9.exe(Windows 64 位,113.7 MB);已安装用户重新下载覆盖安装即可获得更新。
  6. 验证广场内靠近其他角色可正常贴近并完成亲吻、拥抱邀请;背包右键布鞋等装备可直接穿到脚部槽位,人物属性随之变化,槽位中的装备也能拖回背包。

2026-11-09 · 客户端脚本更新:场景计数更清晰、警察不再跑出地图

  1. 问题与背景场景计数器里的四段数字在浅色画面上不够醒目;部分巡逻警察与特警走到地图边缘附近时会跑到界外,场景里找不到、小地图上也看不到。
  2. 原因计数器文字用了浅色描边,与字色对比不足;巡逻目标点在地图左上边缘附近允许取到负数,越界后位置无法被客户端正确还原。
  3. 现在的做法计数器描边改为 1 像素黑色,四段数字更易分辨;巡逻移动与特警瞬移统一限制在地图范围内,并给警察补上小地图绿点标记。
  4. 版本引擎版本号 1.6.6 → 1.6.7;本次为客户端脚本更新,服务端修复已在线上生效,网页在线体验同步更新到 1.6.7。
  5. 下载桌面安装包已更新为 fwsetup_1.6.7.exe(Windows 64 位,113.8 MB);已安装用户重新下载覆盖安装即可获得更新后的脚本。
  6. 验证在黄林 1 区等场景确认警察出现在图内并在小地图显示绿点;四段计数在浅色背景下清晰可读。

2026-11-09 · 引擎 1.6.6:大窗口与全屏下的画面更流畅

  1. 问题与背景把窗口放大到 1080p 或全屏后,帧率明显下降、画面发涩;窗口越大,卡顿越明显,长时间使用体验较差。
  2. 原因引擎在 CPU 上合成整帧画面再交给显示层。旧实现逐像素清屏、逐像素填充、逐像素拷贝纹理,而且每次呈现还要把整帧再复制一遍,画面越大这部分开销越重。
  3. 现在的做法清屏与填充改为按整行处理,纹理拷贝改为按行批量进行;帧缓冲直接交给显示层读取,省去每帧一次整帧复制。画面内容与旧版逐像素一致,脚本与资源无需任何改动。
  4. 版本引擎版本号 1.6.5 → 1.6.6;1.6.5 的九球房顶部面板、瞄准光圈显示与光圈节奏修正也包含在本安装包内。网页在线体验同步更新到 1.6.6。
  5. 下载桌面安装包已更新为 fwsetup_1.6.6.exe(Windows 64 位,113.7 MB),内含 1.6.6 引擎,首页下载按钮已指向新版本。
  6. 验证1080p 下清屏约快 10 倍,常见场景的渲染帧数约提升到 5 倍;与旧版截图逐像素比对一致;桌面门禁脚本与网页在线体验均无报错。

2026-11-09 · 引擎 1.6.4:台球悬停提示里的中文恢复正常显示

  1. 问题与背景安装了完整客户端后,鼠标停在台球上,提示框里的「N号球」仍会显示成方块:数字正常,汉字缺失。
  2. 原因提示文字优先使用一款只包含西文字形的字体。旧逻辑只在完全找不到字体时才改用中文字体;现在字体找到了、但里面没有汉字,就没有再回退,于是汉字被画成方块。
  3. 现在的做法文字绘制改为逐字判断:当前字体有这个字就用它,没有就自动换用中文字体补上,字号与位置保持一致。英文和数字的外观不变,其他界面文字与台球、方块脚本都无需改动。
  4. 版本引擎版本号 1.6.3 → 1.6.4;1.6.3 的台球桌图片按桌面尺寸拉伸、固定尺寸窗口边框修正也包含在本安装包内。网页在线体验同步更新到 1.6.4。
  5. 下载桌面安装包已更新为 fwsetup_1.6.4.exe(Windows 64 位,113.7 MB),内含 1.6.4 引擎,首页下载按钮已指向新版本。
  6. 验证桌面客户端在台球桌实测悬停提示显示「9号球」等中文;门禁脚本运行无脚本错误;网页在线体验启动与示例运行正常、无报错。
  1. 问题与背景在台球桌上按住鼠标左键蓄力时,蓄力条始终不动,看不出这一杆的力度;鼠标停在球上时,本该显示「N号球」的提示里却出现两个方块。
  2. 原因蓄力条不动是因为力度数据在传递时读错了参数名,取到的值一直是 0;提示里的方块则是客户端目录缺少字体文件时没有回退到系统中文字体,汉字画不出来。
  3. 现在的做法力度改为按完整参数名传递,按住左键即可看到蓄力条随力度增长;字体加载增加了系统中文字体回退,即使没有附带字体也能正常显示中文。已有的台球桌、俄罗斯方块等脚本无需改动。
  4. 版本引擎版本号 1.6.1 → 1.6.2,网页在线体验同步更新到 1.6.2。
  5. 下载桌面安装包已更新为 fwsetup_1.6.2.exe(Windows 64 位,113.7 MB),内含 1.6.2 引擎,首页下载按钮已指向新版本。
  6. 验证蓄力测试脚本在桌面引擎实测力度数值随按键正确变化;中文提示在仅有系统字体的环境下截图核对正常;网页在线体验复验启动与示例运行正常、无报错。

2026-11-08 · 引擎 1.6.1:台球桌与俄罗斯方块成为内置模块,脚本参考新增 97 条说明

  1. 问题与背景写台球小游戏或俄罗斯方块的旧脚本,要加载一个只提供 32 位桌面版的扩展动态库;64 位引擎和网页在线体验都加载不了它,手册里也查不到这些类该怎么用。
  2. 现在的做法台球桌、台球、台球规则,以及俄罗斯方块的棋盘(block)与下一块预览(blockone)都已内置进引擎:台球桌负责摆球、开球、瞄准、蓄力击球与进袋判定,棋盘负责方块下落、旋转、消行与计分。脚本直接写类名继承即可(例如 class MyTable:台球桌),不需要写任何导入语句;沿用旧导入写法的脚本也照常可用。
  3. 手册「扩展模块」新增 5 节共 97 条参考:台球规则 16 条、台球桌 50 条、台球 11 条、block 17 条、blockone 3 条,属性、方法与事件都带说明和可运行的示例片段;网页在线体验同步更新到 1.6.1。
  4. 版本引擎版本号 1.6.0 → 1.6.1。
  5. 下载桌面安装包已更新为 fwsetup_1.6.1.exe(Windows 64 位,111.4 MB),内含 1.6.1 引擎,首页下载按钮已指向新版本。
  6. 验证台球桌与俄罗斯方块示例脚本在桌面引擎与网页在线体验里均正常运行、无脚本报错;手册逐节核对后部署上线,页面共 917 条参考,五个新小节与示例渲染正常。

2026-11-08 · 引擎进入 1.6.0:脚本参考新增「扩展模块」章节,粒子与台球模块补全属性、方法与事件

  1. 问题与背景脚本参考旧版把扩展能力归在「扩展动态库」章节,但里面只登记了一个尚未实现的 dll_MapNet;引擎实际已经内置了雪花/花瓣粒子(原 showdown.dll)与台球(原 pool.dll)两个模块,脚本开发者却查不到它们的属性、方法和事件,只能翻旧脚本猜用法。
  2. 现在的做法章节更名为「扩展模块」并移除 dll_MapNet;新增三节共 26 条参考:dll_showdown(size 属性,LinkBig1 / LinkSmall1 / LinkBig2 / LinkSmall2 / start / DelShow / GoUp 方法)、dll_PoolDesk(InitDesk / LinkBall / DelBall / AddLine / AddHole / FireBall / MoveBall 方法与 OnAllStop / OnBallHit / OnBallIn 事件)、dll_PoolBall(SetBall / BallSize / Rotate 方法与 OnStop / OnSetBallPos / OnHit 事件),每条都带说明和示例片段。两个模块均由引擎内置注册,新脚本无需 #import,旧脚本里的 userdll 导入继续由内置别名接住。
  3. 版本引擎版本号从 0.5.x 升到 1.6.0,作为内置模块整合阶段的版本基线。
  4. 下载桌面安装包已更新为 fwsetup_1.6.0.exe(Windows 64 位,111.3 MB),内含 1.6.0 引擎与内置粒子、台球模块;首页下载按钮已指向新版本。
  5. 验证手册在本地逐节核对:章节名、三节导航、26 条方法与事件条目及示例均正常渲染,旧 dll_MapNet 条目不再出现;首页公告与下载卡片结构核对无误。部署后以版本参数强刷缓存复验。

2026-11-07 · 安装包更新至 0.5.126:金币与经验即时同步、跑动的怪物能打中、新账号进场景正常出角色

  1. 问题与背景演示世界近期收到几类反馈:捡到金币后数量不变,重新登录才更新;打怪升级的进度重新登录后会回退;追击移动中的怪物时经常不掉血;新注册的账号登录成功后停在场景里,看不到自己的角色;黄林、红林地图里没有怪物,商人也没有商品可买。
  2. 根因网络协议按函数名查找调用目标,而本地实现把函数名当作大小写不敏感,金币与经验同步的调用被同名不同大小写的函数抢走;战斗经验缺少对应的数据表,每次登录都按空记录重建;命中判定按渲染帧计数、子弹按采样点判定位置,跑得快的怪物会在两次采样之间被跨过;服务器数据库在查不到记录时返回的提示文字与脚本的判断条件不一致,新账号登录被服务端当成数据库错误主动断开;场景服启动时注册了错误的场景描述,黄林/红林的刷怪表因而不生效,商品库也不存在。
  3. 现在的做法函数名按大小写精确匹配,金币与经验在服务端下发时立即刷新;补齐战斗经验数据表;命中判定改为毫秒级的连续扫掠,子弹从上一位置扫到当前位置,移动中的怪物也能命中;数据库「查不到记录」的提示改成脚本预期的文字,新账号按默认属性建档并正常进入场景;修正场景注册顺序,补齐商品库,并新增黄林、红林与战斗行会场景。
  4. 下载桌面安装包已更新为 fwsetup_0.5.126.exe(Windows 64 位,111.2 MB),首页下载按钮已指向新版本,旧版安装包链接不再提供。
  5. 验证服务端八个进程全部运行正常,端口监听与数据库连接齐全;修复后的数据库回包已按真实协议在线上核对,引擎的单元测试与端到端用例全部通过。

2026-11-04 · 线上服务器修复:双人互动动作、场景天气与 GM 证书链恢复(服务端语料修复)

  1. 问题与背景演示世界服务器语料重整上线后,陆续收到三个问题:两名玩家站在一起发起互动动作(如拥抱)时提示「咫尺天涯」、直接失败;场景天气指令没有响应;管理员证书链断裂,GM 指令不可用。
  2. 根因前一轮语料按客户端/服务端拆分整理时,恢复旧版脚本把三段内容整段带丢:GM 证书链(登录发卡与权限校验)、天气链(场景天气状态与后进玩家同步)、以及管理员指令注册。恢复过程还冲掉了此前的一次路径大小写修复——服务端运行在 Linux 上,路径大小写敏感,部分脚本与贴图因此加载失败。至于「咫尺天涯」,逐行比对与实机追踪证明它是原版既有的距离门禁:两人之间寻路超过 9 个拐点即判定太远并拒绝,近距离互动一直正常,并非本轮改动引入的回归。
  3. 现在的做法恢复 GM 证书链与天气链的全部脚本段并重新注册管理员指令,回修全部路径大小写,重新部署服务端语料并重启全部六个服务;同时留下一份寻路回归测试,防止将来再把「距离门禁」误诊成缺陷。
  4. 验证实机确认:场景天气恢复正常(下雪指令生效),双人互动动作在可达距离内可正常完成;广场服务重启后日志零报错。服务端文件与仓库逐一核对校验和一致。

2026-11-03 · 首页新增 FancyWorld 演示程序下载入口(官网更新)

  1. 背景FancyWorld 是由 FancyBox2D 引擎驱动的完整 2D 游戏演示世界,此前官网只有浏览器体验页,没有桌面安装包的下载入口。
  2. 现在的做法首页大蓝条下方新增下载卡片:FancyWorld 标志图、Windows 64 位标注、当前引擎版本(0.5.120)、发布时间(2026-11-03 22:28:06)与安装包大小(113.4 MB),按钮直达 OSS 安装包直链。
  3. 验证本地页面结构、样式与图片加载核对无误;部署上线后文件 md5 三方一致,标志图直链返回 200。

2026-11-03 · 小地图与实际地图对不上、地图下半截空白:地图世界高度回到参考实现(引擎 0.5.120 + 扩展 0.6.38)

  1. 问题与背景进入广场后,角色实际行走的地图与右上角小地图画面对不上:小地图里的场景只占方框一半宽,走动时也不对齐。镜头还能一直往下拉进一大片什么都没画的区域,看起来像「地图下半截没有内容」。编辑器扩展的地图预览同样被画成「很长、下半段全空」的长图;服务端的巡逻 NPC 也会走出作者画好的区域。
  2. 根因等距地图每一行在屏幕上只占 12 像素,参考实现把地图世界高度定为「行数 × 6」,恰好是作者实际绘制的那一半,每张地图文件头里声明的尺寸、小地图贴图的长宽比也都按这个高度制作。移植版此前(0.5.110 修右下黑边时)把高度算成「最后一行的中线」,约为「行数 × 12」,比实际多出一倍:镜头可以滚进作者从未绘制的填充行;小地图按这个高度缩放,把场景图压到一半宽,于是框和画错位;离线预览也随之拉长一倍。
  3. 现在的做法地图世界高度改回「行数 × 6」,与参考实现及地图文件头一致;宽度保持上一轮修好的铺砖内部矩形,底边正好切在某一行的中线上,每一列都有覆盖,右下黑边的修复不受影响。离线预览与运行时共用同一套尺寸。以广场为例,世界尺寸从 4392 × 6708 回到文件头声明的 4392 × 3360。
  4. 编辑器扩展 0.6.38随扩展内置的离线地图工具换成本版构建,地图预览不再出现下半段空白;预览缓存随该工具更新自动失效,安装后重载编辑器窗口即可。
  5. 验证地图尺寸、离线预览、镜头滚动上限等相关测试同步更新,全量测试通过;语料中绝大多数地图的文件头尺寸都满足「高度 = 行数 × 6」,与新算法吻合。广场地图离线探测得到 4392 × 3360,半尺寸预览铺满无空白。服务端已换上本版并只重启了广场服务,服务端 NPC 的活动范围随之按同一套地图尺寸计算。
  6. 网页体验版说明这一版改动的是桌面运行时、服务端与编辑器预览的地图尺寸,浏览器体验页暂未重建,自报版本仍为 0.5.108。

2026-11-03 · 聊天栏手柄拖不动、窗口拖不起来:跟随鼠标补上光标来源(引擎 0.5.119)

  1. 问题与背景聊天栏右上角有个凸起的小手柄,按住左键上下拖动可以调整聊天区高度,但实际按住拖动毫无反应。同一处缺陷还让所有「按住拖动」的交互一起失效:对话框标题栏拖动、滚动区域与地图拖动、拖动窗口、以及读取鼠标位置的脚本参数,都是按下有反应、一动就不动。
  2. 根因鼠标跟随这类行为需要每帧读取光标当前位置,再据此派发拖动事件。移植版把「读取光标」做成一个可替换的函数入口,但运行时创建这些行为时没有接上默认实现,只有测试代码里接过;于是跟随行为每帧一开始就判定「拿不到光标」直接返回,拖动事件永远发不出去。参考实现是直接向系统读取光标,不存在这一步。
  3. 现在的做法新增统一的鼠标位置读取入口,从引擎根对象取当前光标位置(窗口客户区坐标,拖动期间移动消息持续送达)。跟随行为创建时默认接上该入口,聊天栏手柄、窗口拖动、滚动与地图拖动、鼠标位置参数一并恢复。脚本端按位移使用(本次位置减按下位置),客户区与屏幕坐标的原点差异在差值中抵消,行为与参考实现一致。
  4. 顺带调整角色进入场景时不再弹出「公告」模态框(防骗提示与活动文案那一张,按钮还压在正文上)。该公告的文本与广场地图里的公告栏都保留,赠券记录等提示不受影响。
  5. 验证新增脚本级回归用例,复刻聊天栏手柄「按下记高度、拖动按位移改高度、松手停止」的流程:未接默认实现时首条断言即失败,接线后全部通过;全量测试通过;脚本静态体检仍为零文件级错误、零未知类引用。客户端实机连服务端进广场,拖动聊天栏手柄高度随之变化并停在上下限内,进场不再弹公告框。
  6. 网页体验版说明这一版只改动桌面运行时的鼠标跟随与客户端脚本,浏览器体验页暂未重建,自报版本仍为 0.5.108。

2026-11-03 · 新手教师对话框弹出后整屏点不动:置顶改为调整兄弟顺序(引擎 0.5.118)

  1. 问题与背景在广场左键点白衣 NPC,弹出「新手教师」对话框后,整个画面像被一层看不见的遮罩盖住:点哪里都没有反应,对话框自己的标题栏关闭按钮和「关闭」按钮也点不动,只能强制退出。
  2. 根因这类对话框打开时会先铺一张全屏透明挡板吃掉背景点击,再把对话框自己「提到最上层」。参考实现的「提到最上层」只调整兄弟对象在队列中的先后次序,移植版却把它写成了直接抬高绘制层级。挡板比对话框后创建、层级又被显式对齐成同一个值,而命中测试在同一层级时取队列里靠后的那个,于是挡板始终压在对话框之上,把包括对话框按钮在内的所有点击都吞掉。
  3. 现在的做法「提到最上层」改回参考实现的语义:把自己从父对象的子队列里摘出、再追加到末尾,绘制层级保持不变。这样后建的挡板让位给对话框,同时在对话框之外仍然照常拦截背景点击,模态行为不变。
  4. 验证新增三个回归用例,分别覆盖同一层级下命中应落到对话框、置顶后对象确实排在队尾、没有父对象时不做任何改动;另有一条脚本级用例复刻该对话框结构,确认点对话框上的按钮能收到事件、点画面其它区域仍被挡板拦住。全量测试通过;客户端实机连服务端进广场,点 NPC 弹窗后「关闭」与标题栏按钮都能关闭,菜单项可点击,世界恢复可操作。
  5. 网页体验版说明这一版只改动桌面运行时的对象层叠与命中顺序,浏览器体验页暂未重建,自报版本仍为 0.5.108。

2026-11-03 · 在地图里右键角色弹出动作菜单:鼠标命中补上镜头偏移(引擎 0.5.117)

  1. 问题与背景在广场里右键自己或其他玩家,本应弹出「坐下 / 躺下 / 摆摊儿 / 表情 / 回家」等动作选项,实际右键没有任何反应;点在角色身上还会被当成点在地面,角色朝该处走去。
  2. 根因屏幕坐标换算到对象局部坐标要逐级进行,其中「地图 → 视图」这一跳必须加上相机滚动量。引擎有三处旧实现只做了父链减法:命中链没有经过相机,被观察的地图又因为自身不可见而不参与命中测试,于是所有点击都停在视口对象上;鼠标位置参数与「鼠标是否悬停在对象上」同样少了滚动量。
  3. 现在的做法新增统一的坐标换算入口,对齐参考实现「逐级换算、遇地图交给当前视图补滚动」的链路;地图对象记录正在观察它的视图,视图命中时先把屏幕点加上相机偏移,再到地图里找角色。鼠标坐标参数与悬停判断全部走同一条换算。角色脚下与半透明像素仍按像素级不透明度判定,落空即交给地图行走,走位行为不变。
  4. 验证新增三组回归测试:相机偏移换算、视口能命中被观察地图里的子对象、样式继承链上的右键处理器只派发一次;全量测试通过。客户端实机在广场右键自己弹出动作菜单,右键移动照旧可用;另经人工复测确认。
  5. 网页体验版说明这一版只改动桌面运行时的鼠标命中链路,浏览器体验页暂未重建,自报版本仍为 0.5.108。

2026-11-02 · 客户端红字清零:块尾分号、文件级作用域、调色板回落、批量派发载荷(引擎 0.5.113 – 0.5.116)

  1. 问题与背景进入广场后控制台持续刷「'.'前不是对象」「设置数组失败」「设置属性 palette 失败」一类红字,部分界面元素因此显示不全。这些报错分别来自解析器的语句边界、变量作用域、对象属性路由与批量事件派发四处。
  2. 语句块最后一句可以省略分号(0.5.113)参考实现允许语句块末尾的句子不写分号,解析器此前会把整句丢掉,导致紧随其后的「链接表」始终为空。现在与参考实现一致:块内最后一句不要求分号,其余位置照旧严格。
  3. 文件顶层变量只属于该文件(0.5.114)文件体里定义的变量应当留在文件体作用域内,此前会泄漏到全局、被另一个同名变量顶替,拆分结果于是只有 2 个元素、下标 0 报越界。现在按定义时的层级隔离;顺带修正空字符串执行拆分应返回 0 个元素。
  4. 人类对象的调色板属性(0.5.115)人类对象曾把 palette / linkpalette 与素材源一起拦截,颜色设置永远失败。现在只拦素材源,调色板交回基类对象处理,与参考实现相同。
  5. 批量派发带上实参(0.5.116)CallSubAll 此前只转发事件名、丢掉后面的实参,接收方拿不到对象,于是又出现「'.'前不是对象」。现在事件名之后的实参按个数打包成单值或数组随事件一起送出。
  6. 服务端同步服务端脚本同样受文件级作用域问题影响,服务端二进制已换到 0.5.116 并重启六服;广场日志中的脚本报错降为 0 条。
  7. 验证每处修复都有对应回归用例,反证在旧实现下会失败;全量测试通过。客户端实机登录进广场后红字从 5 类降为 0 条。
  8. 网页体验版说明这一批属于桌面运行时与客户端的脚本执行修复,浏览器体验页暂未重建,自报版本仍为 0.5.108。

2026-11-02 · 四处显示问题:雪花被裁、右下黑边、小地图箭头、编辑器预览黑边(引擎 0.5.109 – 0.5.112)

  1. 站着不动时雪花被裁掉(0.5.109)桌面客户端只把「这一帧发生变化的区域」重新上传给显卡。雪花特效每帧都在推进,却没有报告自己变了,所以只要角色站着不动,雪花就被留在上一帧的纹理里,看上去像被一块看不见的方框裁掉;一走动整张地图变脏,雪花又跟着出现。现在雪花每帧主动标记变更,停雪时补一帧清屏。
  2. 镜头推到最右下时露出黑边(0.5.110)地图的滚动上限此前按「锯齿外圈包围盒」计算,相机可以停在真正铺砖范围之外约半个地块,右侧和下方于是露出背景黑边。现在可滚动区域收到完全铺满的内部矩形,相机停在最后一格之内;四个边角的实机截图都验证无黑边。
  3. 小地图收起箭头不翻转(0.5.111)小地图收起靠一段路径动画完成,动画结束时要用「事件名」回调切换箭头方向。引擎曾把这个槽位当整数读取,字符串事件名被读成 0,回调永远不触发:箭头不翻转,每点一次导航条继续上移,最终移出屏幕。现在按字符串解析事件名,收起 / 展开两态稳定,连点不再漂移。
  4. 地图编辑器预览右下黑边(0.5.112)离线预览此前仍按旧的铺砖包围盒取图,最外半格只有奇数行的菱形尖角能够覆盖,右下于是留下锯齿状空隙。现在预览与运行时使用同一个内部矩形,四边黑像素为 0。随扩展内置的离线地图工具同步更新,并使预览缓存随该工具更新自动失效。
  5. 验证各修复均带像素级断言或实机 A/B 截图,全量测试通过;雪花与镜头的修复还分别用「去掉修复」的对照构建复现了旧问题。
  6. 网页体验版说明这一段主要是桌面呈现与编辑器预览的修复,浏览器体验页暂未重建,自报版本仍为 0.5.108。

2026-11-02 · 角色与 NPC 脚下重新有影子:ALE 影子层按参考实现绘制(引擎 0.5.108)

  1. 问题与背景进入广场后,玩家角色和广场里的 NPC(例如女警)脚下都没有影子,而地图覆盖层、静态图片显示正常。角色和 NPC 都走同一条网络同步路径,但影子缺失与网络无关。
  2. 影子数据其实一直都在动画文件里除了画面像素,还单独存了一条「影子」通道:一片只标出哪里该压暗的掩膜。解码器一直把它解出来了,但对象绘制只画画面、从不画影子——整条链路里只有地图覆盖层的渲染会用这一层。
  3. 参考实现怎么画影子它按帧的不透明度算出「背景保留多少个档位」:不透明时保留约 5/8 的亮度,也就是压暗三成多;帧越透明,影子越浅;不透明度低于 8/255 时干脆不画。这个系数是逐帧算的,不是写死的纯黑。
  4. 现在的做法在画面之前按同一系数叠一层黑:不透明帧约压暗 37%,半透明帧同比例变浅,低于门限不画。角色和 NPC 共用同一条绘制路径,所以一次修好两边;换帧、换素材时影子纹理随画面一起重建和释放,不额外占内存。
  5. 顺带对齐的一处地图覆盖层的影子此前直接把解码时烘死的强度当成不透明度,比参考实现黑了一倍多,这次统一走同一个换算。
  6. 验证新增影子强度换算、影子先画、无影子帧不画等单测,全量回归全绿。客户端实机跑登录 → 广场:玩家和 NPC 脚下的影子都正常出现;采样影子内与旁边草地的像素,亮度比约 0.56–0.63,与「不透明帧压暗约 37%」的预期一致。
  7. 网页体验版同步浏览器版引擎重建到 0.5.108,与桌面版同源,体验页中的动画对象同样会显示影子。

2026-11-02 · 走动不再重影、不再抖动:脏矩形补镜头偏移,行走改按帧采样(引擎 0.5.107)

  1. 问题与背景客户端在广场里走动时有两处观感问题:镜头跟着角色滚动时,角色形象、头顶昵称、血条会在前进方向上拖出一串重影,停下才消失;同时每一步的间隔忽长忽短,看上去一顿一顿地抖。两处都与服务器位置校验无关。
  2. 重影从哪来桌面客户端为了省显卡上传,每帧只把「这一帧变了的矩形区域」重新传给显卡(脏矩形局部上传),其余画面沿用上一帧。这些矩形是按地图坐标记录的,上传却用屏幕坐标;镜头滚动之后两者差了相机偏移量,新画面被贴到错误的位置、旧画面又没被覆盖,于是留下一串拖影。
  3. 现在的做法(重影)收集脏矩形时,先按「被观察的那张地图」把相机偏移(ViewX − 地图自身 Xpos)减掉,再换算成屏幕坐标;主视、小地图等多张被观察地图各自按自己的相机计算,两边回到同一个屏幕坐标系。局部上传的收益保留,重影消失。
  4. 抖动从哪来行走对象内部有一个「多久采样一次位置」的门限,参考实现按 512 ÷ 帧率 推导(18fps 动画约 28 毫秒,上限 50 毫秒)。在 50fps 的渲染节奏下这个门限每两帧才开一次,角色一次跳约 6 像素,再被镜头跟随的整数追赶放大成左右 5–7 像素的摆动。
  5. 现在的做法(抖动)默认门限改为 0,即每帧采样一次位置。位置本身是「速度 × 已用时间」的纯函数,改为每帧取值只影响平滑度、不改变行走结果;脚本显式写了步间隔参数时仍按原意节流,老脚本行为不变。
  6. 验证新增脏矩形坐标与行走采样两组单测,全量回归全绿。客户端实机跑登录 → 波赛敦广场:诊断日志的 14 条既有脚本报错与上一版逐字相同、零崩溃;连续抓取 150 帧与 320 帧行走画面,血条始终只有一条、位置在几帧内收敛后保持稳定,镜头平移量均匀(每帧 3 或 6 像素),没有再出现第二份血条或拖影。线上六服只读核查全部 running + healthy,日志无崩溃。
  7. 网页体验版说明本版两处改动分别属于桌面客户端的局部上传链路与行走采样节奏,浏览器体验页无需重建,自报版本仍为 0.5.106。

2026-11-01 · 定长串编解码按 64 进制还原:物品串、证书、队伍坐标不再解错(引擎 0.5.106)

  1. 问题与背景旧版脚本用 SplitAsInt64 / UniteAsInt64 把一串紧凑字符拆成整数数组、再拼回去:物品串、领奖证书、队伍战场的坐标串都走这条路。函数名里的「Int64」指的是64 进制定长编码,不是十进制整数串,引擎此前按十进制实现,还把「拆几个元素」的参数错当成「每块几个字符」,于是物品栏、证书、坐标一读出来就是错的数值。
  2. 参考实现是怎么编码的字母表 64 个字符:0-9 表示 0..9、A-Z 表示 10..35、_ 36、重音符 37、a-z 表示 38..63;不足位数用字符 0 左补齐(不是空格)。两个字符就能表示 0..4095,五个字符能装下一对地图坐标。
  3. 现在的做法四个函数全部按参考实现重写:SplitAsInt64(串, 元素数, 缺省值, 每块字符数) 按每块字符数切分(末块不足按实际长度),块数不够用缺省值补齐,元素数给小了就按「总长 ÷ 每块字符数」;UniteAsInt64(数组, 每块字符数) 把每个元素钳到该位宽的上限再逐块拼接;GetFromInt64 / FormatInt64 走同一套 64 进制编解码。
  4. 细节对齐解码沿用参考实现的两个怪癖:首字节是空格的块按数字 0 处理并继续扫描,之后遇到空格才停;6 字符块的累加在 32 位里回绕,所以结果可能是负数(例如 "3zzzzz" 解出 −1)。每块字符数只接受 1..6,越界现在是明确的报错,而不再静默按默认值处理。
  5. 验证新增的用例覆盖 "ZZ"→2275、"gh"→2861、5 位随机坐标往返 2008 组、6 位回绕为负、越界报错,以及真引擎跑脚本的端到端断言(证书串拆开再拼回原样、物品串 "0102zZ" 解出 1 / 2 / 4067,零报错);反证在旧实现下这些断言全红。语料里 1260 处调用点逐类核对过,没有出现 1..6 之外的位宽。
  6. 服务端同步证书、物品、队伍这几处是服务端脚本拆包的,只换客户端不生效;服务端二进制与线上六服已同步到 0.5.106,重启后全部健康。
  7. 已知的行为变化按旧格式写进库里的定长串解出来会变;线上证书表当前为空,没有存量数据需要迁移。
  8. 网页体验版同步浏览器版引擎重建到 0.5.106,体验页自报 0.5.106,Hello World 示例零报错。

2026-11-01 · 类定义跟着对象走,嵌套类不再跨实例泄漏(引擎 0.5.105)

  1. 问题与背景旧版语料里同名类遍地:同一个 wnd_bk 在客户端上百处、t_btn 有 6 处。此前引擎全进程只维护一张类表,后写的定义覆盖先写的;更麻烦的是,类体里嵌着定义的类(class A { class B { … } })对兄弟对象、对文件级代码同样可见,别处可以 new B 出来,拿到的却是另一份定义。运行期因此一直刷「类被新的同名类替换」,偶发拿错实现。
  2. 参考实现是怎么做的原版把类表挂在对象实例上:class 语句执行时才把定义注册进当前执行的那个实例,new 时从该实例开始沿父对象链逐级查找,走到根还没有就失败。也就是说,类定义只对「声明它的实例 + 它的子孙对象」可见。
  3. 现在的做法每个对象自带一张类表:查找顺序是对象自己 → 父对象 → 祖父 …… 一直到根,最近的一层优先(近层遮蔽祖先);对象销毁时类表随之释放。根对象(系统脚本、index.fcc/login2.fcc 这类文件级脚本)上的类仍然对所有对象可见,所以文件级公共类不需要改写。
  4. 脚本可见的变化类体内的嵌套类只对该实例及其子孙可见;<A>{ class B { … } } 这种块体写法把 B 注册进新建的那个实例,可以覆盖 A 类体里的同名 B;同一实例里重复定义同名类仍是后写覆盖,与以前一致。
  5. 已知的行为变化以前靠「全局泄漏」在兄弟对象或根上下文直接 new 某个嵌套类的写法,现在会失败并报 new语句错误:无法创建对象类X——这与旧版的表现一致。语料静态排查出的 96 处跨作用域引用逐条核对过,绝大多数属于「样式体在声明它的实例上执行」「父链解析」「Run() 共享调用者作用域」的正常用法,只剩 3 处是复制粘贴导致的真错(原版同样失败)。
  6. 日志更安静逐实例重复注册同名类不再打印「被新的同名类替换」(这是 <X>{…} 的正常行为);只有根级替换系统类时仍会提示。同一段客户端流程的诊断日志从 287 行降到 61 行。
  7. 验证新增 4 个作用域用例(兄弟看不到嵌套类、孙对象能看到祖先类、根级类全局可见、同一外层类两次实例化各自独立)与全量回归全绿;客户端 A/B(登录 → 波赛敦广场)改动前后 #RE 各 14 行且内容完全相同、新增的类未找到 0 条;ECS 上六服实跑两侧同为 7 条既有报错。
  8. 网页体验版同步浏览器版引擎重建到 0.5.105(wasm 22,414,778 字节 / 压缩后 5,290,837 字节),体验页自报 0.5.105,Hello World 示例零报错。

2026-11-01 · 同名脚本类不再串用事件处理器(引擎 0.5.104)

  1. 问题与背景跑旧版登录窗时,鼠标划过提示条,对话框底板就只剩一圈绿框——原本 round4_3 的半透明底色换成了一条 3 像素边框,背后的画面直接透上来;移开鼠标也不再恢复。
  2. 根因事件派发在对象自己的函数表里没找到处理器时,还会按「类名」去一份共享的全局表再查一遍。类域编号由类名派生,于是 misc.fcc 里 wnd_dlg 内嵌的 class wnd_bk(底板,画 round4_3)与 login2.fcc 顶层的同名 wnd_bk(两条提示条,悬停时把 bk:= 改成 rect)共用一个域,后定义的那份把前一份顶掉:底板悬停时跑的是提示条的 OnMouseIn。
  3. 现在的做法事件派发只查实例自己的函数表——继承来的处理器在实例化时已经随整条类链写进实例自表,运行期不需要也不应该再回落。这与参考实现的 FObj::CallUserFun 一致。显式的 Class::Method() 调用与 obj.Method() 的解析链不受影响。
  4. 顺带修复对话框底板(bk)改颜色、改图案时补上变更标记,bk:= 的改动能真正进入脏矩形——此前这类改动要等别的事件碰巧刷新才显示。
  5. 验证新增「同名类的 OnMouseIn/OnMouseOut 不串用」用例,并把登录对话框用例扩展成逐帧脏矩形统计;实机悬停提示条:绿框 0→1136 像素、底板 #0066AA 前后都是 845 像素且包围盒一致,移开不再透底。
  6. 写脚本提醒仍然不建议在不同文件里重复定义同名类——类域按类名派生,obj.Method() 这类显式调用仍可能解析到另一份定义。事件处理器现在不会再串用了。

2026-11-01 · 对象方法调用不再串到别的文件的同名函数(引擎 0.5.103)

  1. 问题与背景跑旧版登录窗时,鼠标掠过提示区就往控制台刷一行 表达式运行错误:'.'前不是对象:src(login2.fcc:65);界面没崩,但提示框里的文字再也不更新。
  2. 根因对象.方法() 在对象自己的方法表和类域链都没找到时,还会落到一份「所有文件共享的全局函数槽」。类域编号由类名派生,misc.fcc 里 wnd_dlg 内嵌的 class wnd_bk 与 login2.fcc 顶层的同名类共用一个类域,于是对话框里 new wnd_bk 的实例解析到了另一份定义里的 OnMouseIn/Out;它对 pid 调 OnTip(0),这个调用又被全局槽里 login2.fcc 的文件级 OnTip 接走,在错误的接收者上解引用 m_pTip。
  3. 现在的做法方法调用只查三处:该对象自己的方法表(类体与样式体注入的方法都在里面)→ 脚本类域链(含基类)→ 内建方法/接口。三处都不命中就静默返回空值,不再回落到文件级同名函数——与参考实现一致(FObj::OnCallFun 只走 CallFun 与「对象自己的函数表」两条路,找不到即 FUN_NOTFIND)。
  4. 影响面整轮登录压测记录到 150 次「方法未命中」,其中只有 4 次(全部是 OnTip,也就是这个缺陷)原本靠全局槽兜住,其余都是内建派发,行为不变。裸函数调用(foo())完全不受影响。
  5. 顺带修复对象销毁时清掉根窗口记录里的鼠标悬停对象,避免对话框关闭后下一次鼠标移动把 OnMouseOut 派发到已销毁对象上、在已释放的脚本状态里执行。
  6. 验证新增两组引擎级用例:一组复现「外文件类调 p.OnTip()、本文件级 OnTip 解引用 m_pTip」并断言零报错(去掉修复即复现同一句报错),一组覆盖对话框销毁后悬停槽归零。实机点「登录」:login2.fcc:65 的报错消失,流程走到 index.fcc:584-587(m_sName = scale、m_nID = 12)并进入广场。
  7. 写脚本提醒不要在不同文件里重复定义同名类——类域按类名派生,两个同名定义会共享同一套方法域,obj.方法() 可能解析到另一份定义里的实现。

2026-11-01 · 输入框的 bkcolor=0 变回透明、光标默认改白(引擎 0.5.102)

  1. 问题与背景语料里 edit 写 bkcolor=0(regman.fcc 等处十余例)本该不画底色,实际是一块不透明黑矩形把父面板遮住;插入符默认也是黑色,落在黑底上完全看不见。
  2. 根因参考实现把颜色参数按 RGB565 打包,bkcolor=0 的打包值就是 0,绘制时直接跳过底色矩形;Go 侧把 0 当成「不透明黑」画了出来。光标默认值参考实现是白色,Go 侧写成了黑。
  3. 现在的做法颜色参数先做 RGB565 打包判定:打包值为 0 视为「不画」(透明),其余颜色照常绘制。构造默认值对齐参考实现:底色 RGB565(25,85,150)、文字近白、光标白。文字色与选中文字色不做这项判定(参考实现对这两项本来就不打包)。
  4. 验证新增颜色语义用例 6 例与默认值用例;启动器实机注册/登录窗的输入框恢复透明底、白色光标。

2026-10-30 ~ 11-01 · fc102 全链路跑通:客户端进世界、守护与库服上线(引擎 0.5.80 – 0.5.101)

  1. 这一段的总体结果旧版网络版语料 corpus/fc102 从「脚本跑不起来」推进到「中心/登录/主服/广场/账号服加库服同时在线,客户端登录后可进入广场移动、聊天、右键转镜头」。以下按主题列出这一段的主要改动。
  2. 解释器与序列化0.5.80 字符串按完整 UTF-8 汉字前进、日期按本地时区、变量赋值写时复制(v[i]=rec 不再让各槽共享同一块数组);0.5.81 Split 默认逗号、OnRestart 只查对象自有方法表、_MAIN 跟随调用深度;0.5.82 数组的 .str 成员与实参求值失败如实报错;0.5.83 Class::Method() 作用域限定调用(139 个服务端入口体检,70 个零报错,其余全部归因到语料缺分号/缺库表/部署宏/32 位 DLL);0.5.86–0.5.87 CallSubAll 派发与逗号启动串修复;0.5.92 宏别名链递归展开(此前只展开一层,connect 恒 0 卡在「连接中...」)。
  3. 脚本可见的语义补齐0.5.91 普通 text 支持内联颜色转义 \#RRGGBB(此前把标记画成方框、再把色号当正文);0.5.97 IsPress 接上真实按键状态(广场 Shift+右键奔跑);0.5.99 ==/!= 按参考实现逐类型比较(此前任意两个对象都相等,双客户端聊天与头顶名字全变成「我」);0.5.100 GetStrWord 剥掉两侧引号(昵称显示成 'scale')。
  4. 客户端进世界0.5.85 三处叠加:TimerCall 可变参、网络对象引用编码、DB 回包函数 id 换算——登录服连不上世界、注册事件配不上的问题一并解决,客户端首次渲染出「奇域(绿色世界)→波赛敦→波赛敦广场」。
  5. 客户端体验0.5.94 CPU 渲染器按「源+渲染世代」缓存纹理(此前每帧重传且不释放)并给动画/图片加字节预算缓存,广场角色与生命/精力/金钱面板不再空白;0.5.95 补 hitid 取参与帧命令管线,广场 NPC 的累积泄漏收敛(ECS 上 12 分钟内存净降 6.4 MB);0.5.96 delthis 补发 OnDestroy,广场右键不再被残留全屏遮罩吞掉;0.5.98 核实并补测鼠标单击/双击的合成与悬停刷新。
  6. 服务端与运维0.5.88 引擎可无头运行并提供 fbserver 宿主(心跳、优雅停机),fwdemon 负责把它当守护进程管起来;0.5.89 守护加令牌鉴权与 HTTPS,引擎补「大小写不敏感 + 反斜杠分隔符」的只读路径垫层(ECS 上 130 条语料路径全部命中,语料零改动);0.5.90 移植 DBM2 库服 fwdb,10012 端口闭环;0.5.93 账号服查库取真实 uid、库错误帧带回请求事件 id。
  7. 外部插件0.5.101 用 Go 实现 ext/particle 顶替 showdown.dll(雪花/花瓣四路特效),老脚本里的 #import userdll "bin/showdown.dll" 不再飘红,类已编进引擎、导入直接短路成功;语料中 12 处导入随之下线。
  8. 网页体验版说明这一段没有重建浏览器版引擎,play/ 体验页仍为 0.5.79;上述改动目前只在桌面版 launcher.exe / objsys.dll 与 Linux 服务端二进制中生效。

2026-10-29 · 引擎不再有授权门禁,服务端对象开箱可用(引擎 0.5.79)

  1. 问题与背景原版引擎带证书授权:只有授权环境里 ISDEVMODE 才为真,数据库连接套接字(dbsocket / dbsocket2)与服务器套接字在非授权环境下会被直接拒绝——设置连接参数返回失败、发起连接直接报错。一批旧版服务端脚本在开头给数据库套接字赋 gamename / login / connect 时因此报错。
  2. 现在的做法本项目的 Go 引擎不做任何授权限制,原版凡是按 ISDEVMODE 分岔的地方一律走「已授权」那条路:数据库套接字的连接参数随时可设,connect 不再返回失败;服务器套接字的用户上限固定为 2048(原版非授权环境只给 8),同时取消了非授权环境下的流量看门狗(原版累计写入超 8KB/s 或第 4 个连接进来就直接销毁对象)。
  3. 脚本可见的变化系统宏 _DEV 现在恒为已定义。老脚本里用 #ifdef _DEV / #ifndef _DEV 二选一的地方(例如只有未授权环境才弹的提示、兜底跳转官网的分支)从此一律走授权版。
  4. 顺带清掉开发模式开关旧的开发模式判定——环境变量 FANCYBOX_DEV、配置里的调试级别、可执行目录的 dev.txt 标记文件——已整体删除。跑服务端脚本不需要再设置任何环境变量。
  5. 验证全量单元测试通过;新增两组用例(无开发环境时数据库套接字参数可设、服务器套接字上限恒为 2048);启动器实机复跑探针脚本,三条连接参数全部成功,零脚本报错。
  6. 网页体验版同步浏览器版引擎已重建到 0.5.79(wasm 21,819,940 字节 / 压缩后 5,180,787 字节),体验页自报 0.5.79,Hello World 示例零报错。

2026-10-29 · 服务端脚本连 MySQL 再无障碍(引擎 0.5.78)

  1. 问题与背景上一版把老脚本里的 SELECT TOP、[表名]、GETDATE() 等改成了 MySQL 能认的写法,但还有两类没处理:CONVERT(…,style)(把时间转成指定格式的字符串)与 DATEADD(按小时/天偏移时间)。少数节日、婚礼类活动服务用到它们,连 MySQL 仍然报语法错。
  2. 补齐两类改写CONVERT 转日期类型时变成 CAST;带样式码转字符串时变成 DATE_FORMAT,常见的 101/111/120/126 等样式都按原格式出串。DATEADD 变成 DATE_ADD(…, INTERVAL n 单位),单位支持年/季/月/周/日/时/分/秒及其缩写。
  3. 宁可报错也不给错值样式码或时间单位不在支持的范围内时,这句原样下发——让 MySQL 明确报错,而不是悄悄返回一个错误的日期。这类缺口只会在真用到时才暴露,不会污染正常查询。
  4. 不误伤的细节只改写真正的函数调用:字符串字面量里写着的 'CONVERT(varchar,d,111)' 不动,名字里含这几个字母的标识符(如 CONVERTED)也不动。嵌套写法(DATEADD 里套 DATEADD 再套 CONVERT)由内向外逐层改写。
  5. 全服启动体检把服务端七个进程逐个拉起:中心服、登录服、主服三服零报错并互连成功;其余服务的报错逐条归位——是脚本自己漏了分号、缺少库表,或本地没给部署配置里的连接参数,没有一条是引擎缺陷。
  6. 一个容易踩的行为提醒脚本里写 del=1 会把这个对象连同它的子对象一起销毁,对象上已注册的接口也随之失效,后续注册同名接口一律查不到。这是旧版引擎就有的行为,移植后保持一致;数据库连不上时的兜底分支容易撞上它。
  7. 网页体验版同步浏览器版引擎重建到 0.5.78(wasm 21,824,077 字节 / 压缩后 5,179,605 字节),体验页自报 0.5.78,Hello World 示例零报错。

2026-10-29 · 跨行写的语句不再被丢弃(引擎 0.5.77)

  1. 问题与背景老脚本里常有把一条长语句折成几行写的习惯,例如存盘时拼一长串 "icon="+icon+";sex="+sex+…,每行末尾或行首放一个 +。此前这种写法在换行处就被判成语法错,整条语句被丢掉——脚本看着没报错,实际那段动作从未执行过。
  2. 现在的判定换行只有在「句子还没写完」时才继续:本行以运算符结尾(x = 1 + 换行),或下一行以运算符开头(换行 +";city="+…)。括号里的实参、下标、条件本来就可以随便折行。
  3. 缺分号报在句子开头其余情况按「这一句忘了写分号」处理,错误标记打在句子开头那一行,而不是像以前那样打在换行处,让人能直接找到该补分号的位置。
  4. 刻意的写法限制以 ?(调试输出)或 : 开头的下一行不算续行——这类行在语料里大量作为独立语句存在,当成续行会把真正的漏分号错误一起吞掉。
  5. 与参考实现的差异旧版引擎对「跨行语句」同样直接报错并整句丢弃,所以那批存盘串在原版里也没有生效。本项目有意放宽,让它们真正执行;这是一个明确的取舍,已记录在更新日志里。
  6. 语料体检结果全语料扫描:换行/缺分号类报错由 888 处(395 个文件)降到 480 处(243 个文件),有语法错误的文件由 529 降到 383,文件级解析中断仍为 0,其余错误类别数量不变;减少的部分正是原先被误判的 408 条跨行语句。
  7. 网页体验版同步浏览器版引擎重建到 0.5.77(wasm 21,797,018 字节 / 压缩后 5,174,411 字节)。

2026-10-29 · 老服务端脚本可直接连 MySQL(引擎 0.5.76)

  1. 问题与背景一批旧版服务端脚本是按 SQL Server / ADO 的口味写的:SELECT TOP 1 …、GETDATE()、[表名] 方括号标识符、WITH (UPDLOCK) 表提示。这类语句交给 MySQL 会直接语法错,而引擎的数据库层走标准的 MySQL 驱动,没有兼容层。
  2. 方言改写连接 MySQL 时自动改写五类写法:SELECT TOP n / TOP (n) 改成语句尾的 LIMIT n、[标识符] 改成反引号标识符、N'…' 改成 '…'、GETDATE() 改成 NOW()、删掉 WITH (UPDLOCK/ROWLOCK/NOLOCK…) 之类的表提示。
  3. 不误伤的细节替换前先把引号串里的内容遮住,字符串字面量里写着的 'select top 1' 不会被当成语法;TOP 只在 FROM 之前才改成 LIMIT,已经带 LIMIT 的语句、派生表里的 TOP 都原样保留;多条语句按分号逐句处理。
  4. 只对 MySQL 生效判断依据是连接串的驱动类型,非 MySQL 连接一字不改;重查同一句时用改写前的原文再改一次,不会叠加改写。
  5. 顺带修掉网络回调的数组实参把数组当作单个参数发给对端时,此前会被摊平成多个标量,接收方声明的是 void OnRev(var v) 就报「函数没有找到」。现在按参数表达式里有没有顶层逗号判断:单个数组参数原样包成一个数组实参,真正的逗号参数表保持原样。
  6. 验证新增方言改写与网络实参两组测试;在 MySQL 5.6 实库上跑 SELECT TOP 1 …(实际下发 … LIMIT 1),客户端收到 8 个字段且逐项与库内数据一致,随后干净退出。
  7. 网页体验版同步浏览器版引擎重建到 0.5.76 并已上线(wasm 21,794,276 字节 / 压缩后 5,172,619 字节)。0.5.70–0.5.75 的改动一并带上:战斗与 IP 测试对象、样式注入的方法、数据库/HTTP/套接字方法派发、默认字面统一 TTF。
  8. 已知限制CONVERT(…,style) 与 DATEADD 这两类写法尚未改写,命中它们的脚本(少数节日/婚礼活动服务)在 MySQL 上仍会报错。

2026-10-29 · 恢复系统脚本的启动时间变量(引擎 0.5.75)

  1. 问题与背景系统脚本里记录「本次启动时间」的那一行被注释掉了,而服务端脚本拿它算每日定时重启与玩家在线时长;取回来是空值,每次读它的成员都报「'.'前不是对象:day」。
  2. 改动恢复这一行(date m_dStartDate=GetLocalTime();),与参考实现一致;紧随其后的发行期限弹窗属于演示版逻辑,仍保持注释。
  3. 结果fc102 的本地联调链路跑通:本地中心服替身 + 登录服务 + 主服务三进程并存,登录后无自动重启循环,初始化标志为 1,无运行错误。

2026-10-29 · 英文数字与汉字统一字面(引擎 0.5.74)

  1. 问题与背景纯英文与数字走的是另一套位图字体(固定 7 像素推进、无抗锯齿),含中文才用内置 TTF。于是同一行里 Port:10004 比旁边汉字更宽更粗,与旧版的观感不一致——原版只有一个字体句柄,中英文本就同款。
  2. 改动去掉按内容分流的捷径,默认字面统一为内置 TTF,脚本显式指定字体时仍优先;随之删掉一批只为绕开该捷径而存在的专用绘制函数,多行文本语义不变(整串选一个字体,再按换行分行)。
  3. 刻意偏差原版关掉了字体平滑,Go 的 TTF 光栅始终抗锯齿,不透明像素峰值是 247 而不是 255,属于已知差异。
  4. 验证全套测试通过(一处像素断言按上述偏差放宽);启动器跑登录脚本自报 0.5.74,截图与旧版放大对比确认英文数字已与汉字同款,剩余告警都是既有的脚本跨行/缺参两类。

2026-10-29 · 数据库 / HTTP / 套接字方法能被脚本调用(引擎 0.5.73)

  1. 问题与背景七个对象——HTTP 请求、HTTP 服务、数据库银行、两种数据库套接字、两种套接字服务——的方法分发拿原版源码里的函数编号常量做比较,而脚本调用传进来的是解释器自己分配的编号,两套编号永不相交。结果 Post、ClockLink、SendHtml、Call、connect、Close 全是死分支,调用静默落到基类,脚本还以为成功了。
  2. 改动这七类方法的编号分支同时接受两套编号,未驻留的编号直接返回「未找到」;HTTP 服务的点击事件同样修正(事件派发用的是事件编号,不是函数哈希)。
  3. 另一处构造缺陷new 类名(参数) 的构造函数原先直接读全局槽,而全局槽按「最后写入者赢」,同名的构造函数可能跑到别的类的实现。改为先查新对象自己的函数表,再沿类继承链查找。
  4. 验证新增方法派发测试(构造与真实运行时编号不相交的 id,逐条断言七个类的返回值;编号为 0 时全部落空)与端到端测试(脚本直接调用无运行错误);fc102 主服务实机启动自报 0.5.73、初始化标志为 1,运行错误计数为 0。

2026-10-29 · 样式注入的方法真正生效(引擎 0.5.72)

  1. 问题与背景fc102 主脚本残留 5 条「'.'前不是对象」,全部出在样式(style:)注入的刷新方法里。样式注入本身没问题,错在方法派发:类体执行期间 new 出来的子对象会回调父对象,此刻父对象还没登记自己的类,派发落到全局槽,跑的是最后注册的同名方法——而那份实现来自另一个类,它引用的成员在该对象上是空的。
  2. 改动方法派发改为先查接收者自己的函数表,没有再走全局(对齐原版「一个对象一张函数表、最后写的那份赢」)。类体与样式体都在实例内执行,函数都落在该实例上,所以样式注入的方法自然盖过类体里的同名方法。
  3. 验证新增测试锁住「自有表里的方法必须赢过全局槽后注册的同名函数」;同一样本实机运行,运行错误从 5 条降到 0,只剩几条良性的「同名类替换」提示。

2026-10-28 · 文本文档与地砖对象的方法能被脚本调用(引擎 0.5.71)

  1. 问题与背景与 0.5.73 同源的编号不一致:文本文档对象与地砖对象的方法分支比的是原版哈希常量,脚本调用传的是驻留 id,GetLine 之类的函数恒报「未找到」。
  2. 改动两个类的方法分支同时接受两种编号,内部投递继续走哈希;编号为 0 时直接返回未找到,避免未驻留时误匹配。单元测试两种编号各跑一遍。
  3. 验证全套对象层测试通过;fc102 主脚本不再报 function "GetLine" not found,同次运行暴露的 5 条样式错误由 0.5.72 修复。

2026-10-28 · 战斗判定与 IP 测试对象移植(引擎 0.5.70)

  1. 问题与背景fc102 服务端在初始化时就 new FightFunc / new IPTest。这两个不是外部插件——原版把它们的注册放在主对象系统里,Go 侧缺类,脚本直接停在这两个名字上。
  2. 战斗判定对象21 个方法全量移植:命中对象与命中矩形、谁打了我、按类别取物品、距离判定、命中点、奖励与分组、标记物、行走标志与分隔线、HTTP 串解码、位置换算等。与常见的「以自己为中心」不同,这些方法一律以「调用者」对象为基准计算,与原版一致;FindSubPos / FindSubNear 按接收者类型分流。
  3. IP 测试对象三个方法:按分组加入 IP、判断 IP 是否在组内、取 IP 分组;点分 IPv4 按 ip[3]+(ip[2]<<8)+(ip[1]<<16)+(ip[0]<<24) 打包成 32 位整数。
  4. 补齐一处基础表半格表对象补上 Set:只更新已有项、不插入新项,缺项返回失败,与原版一致。
  5. 验证新增单元测试覆盖命中判定、网格标志、用户数据、距离回调与 IP 分组;fc102 主脚本实机跑起,后续 0.5.71/0.5.72 的残留错误都在这条基线上收敛到 0。

2026-10-28 · 调色板换色真正生效(引擎 0.5.69)

  1. 问题与背景调色板能加载、参数与函数也能调通,画面颜色却不变。两处断点:ALE 帧解码时直接把带索引的像素展开成 RGBA,下标一丢,绘制阶段就无从知道「这个像素原本该取第几号颜色」;new palette(src) 没有构造参数,img.palette / img.linkpalette 也不接收调色板对象。旧实现里「img.palette 接受数组」是移植时臆造的,原版只认对象。
  2. 逐像素索引镜像解码 ALE 调色板帧(kind=1)时同步记录每个像素的调色板下标,0xFF 表示「无索引」——阴影、背景与未赋值像素都属于此类;镜像随帧一起深拷贝,动画复制、灰度帧处理都不会丢。RGB565 真彩帧(kind=3)本来没有索引,保持原样。
  3. 换色规则有索引的像素取新表的颜色,无索引的像素保留解码出的原色;新颜色按源像素的 alpha 预乘后再写入,半透明边缘不会偏亮。扇形填充也先换色再生成遮罩,避免填充区与本体颜色不一致。
  4. 对象侧的两种绑定img.palette= 拷一份整表(256 项)存到对象上——传 nil 表示清空,源调色板还没加载完则拒绝并保持旧表;img.linkpalette= 只记引用,绘制时实时取用,且跟随调色板的修改版本。调色板内容被改(重新加载、改单项、渐变填充、从动画取表)都会让纹理缓存失效并重传,不会画出旧颜色。私有拷贝优先于链接,与原版一致。
  5. 构造与原版对齐原版调色板类没有单独的构造分支——new palette("res$/def.act")、palette=、Load 落到同一段实现,只要求字符串参数,然后按名字加载。Go 照此实现:文件读不到在两边都算调用成功,只是对象状态标为错误。恢复 768 字节 RGB 块的读写与 565 镜像同步。
  6. 刻意偏离原版用「对象指针 + 创建号」校验链接是否还有效,Go 的对象变量不带创建号,改为用调色板的状态与修改版本判断;原版加载失败会打印「调色板没有准备好!」,Go 的对象层没有统一的错误输出设施,这里只返回失败。另有一处既有缺口未动:human 的 src/palette/linkpalette 参数仍归尚未移植的装备逻辑,角色贴图今天只能经内部的图像对象换色。
  7. 验证新增五组测试:索引镜像的取值与深拷贝、new palette(src) 的构造参数(只加载一次、名字统一小写、缺参或类型不符失败、加载失败仍算成功、非调色板对象不认领)、上传时的换色与缓存失效、链接调色板跟随修改版本与状态、human 走同一条绘制路径。全套 Go 测试通过;启动器冒烟自报 0.5.69,八次 CPU/GPU 位精确校验一致。
  8. 网页体验版同步浏览器版引擎重建到 0.5.69 并上线(wasm 20,983,096 字节 / 压缩后 5,009,380 字节)。此前 0.5.66–0.5.68 三版未单独重建,这次一并带上:MIDI 合成、参数哈希、调色板与弹出菜单的方法通道都在浏览器版可用。
  9. 待验收与范围换色的实际观感需要在带调色板的语料上确认(例如 fw2 的角色脚本先给图设私有表、再用调色板的 GetFormImg 生成图像);单元测试只能证明上传的像素字节正确。本轮只动调色板数据链,不涉及其它渲染语义。

2026-10-28 · 调色板与弹出菜单的方法能被脚本调用(引擎 0.5.68)

  1. 问题与背景参数写对了,方法却报「函数没有找到」:m_pPal.GetFormImg(pman)、菜单的 AddItem 全都不响应。根因是两套编号——对象类里按原版的函数编号常量分发,而脚本调用传进来的是解释器自己分配的字符串编号,两者永不相交;单元测试也照抄同一批常量,所以测试一直是绿的。
  2. 改法删掉这两个类的编号分发,改为按名字注册的对象内建,处理器先看接收者类型,不是自己的就交还给后续查找(等价于原版的「未找到」)。脚本名相撞的按类型分流:Get/Set 与数据库记录集同名,走数据库入口再分派;Load 与用户 DLL 同名,走原入口再分派。同一个名字只能注册一次,后注册会静默覆盖,所以冲突名字必须靠入口分派而不是重复注册。
  3. 删除不存在的 Clear原版弹出菜单只有 Popup、AddItem、AddLine 三项,旧实现里的 Clear 把一个「左键抬起」的编号误标成了方法名。删掉之后,脚本里的 Clear 回到全局画布的 Clear,与原版行为一致——文档里列过不等于原版实现过,移植以原版源码的调用分支为准。
  4. 调色板对象补齐真实语义768 字节 RGB 块的加载与保存(保存时由 565 镜像回写)、单项读写、逐字节整数插值的渐变填充(与原版一致,刻意不用浮点版本)、从 ALE 动画取表;状态枚举顺序按原版修正为「无 / 就绪 / 载入中 / 错误」。
  5. 资源加载res$名字 与磁盘路径统一走资源加载器,并带加载跟踪;768 字节的格式校验留在对象层。没有装加载钩子(单元测试、浏览器版)时按失败处理,不会静默当成空表。
  6. 刻意偏离原版是异步下载加就绪回调,Go 改为同步读;弹出菜单的 Win32 菜单仍未接(参数校验与返回值已对齐:没有菜单时 Popup 报错,缺省坐标用鼠标位置顶替系统光标位置)。
  7. 验证新增函数通道测试:两条真实调用链、同名冲突时对其它接收者返回「未找到」、全局 GlintFill 不被调色板版本遮蔽、参数错误如实上报;对象层测试按新接口重写(565 截断、渐变逐字节插值、保存往返、名字小写化)。参数通道另由 0.5.67 的哈希修正打通。全套测试通过。

2026-10-28 · 对象参数赋值不再静默失效(引擎 0.5.67)

  1. 问题与背景六个对象——原子系统、下雪、光效、调色板、弹出对话框、弹出菜单——脚本给参数赋值后毫无反应:颜色不换、数量不变、窗口不动。原因是两套哈希:这些类按原版源码里的函数编号常量(由另一套哈希算出)比较,而运行时的参数投递走的是 Go 侧的哈希,两边永不相等,赋值全部落到基类。
  2. 为什么不报错参数名没匹配上是「不是我的参数」,对象层安静地返回失败,脚本也不检查返回值,于是表现为「写了没效果」。更要命的是单元测试直接照抄了同一批常量,自己证明自己,所以一直在绿。
  3. 改法六个类的参数分支统一改用与运行时一致的哈希,原版常量只作注释保留;同步修正各自的测试(原子系统 13 处、光效 7 处、弹出对话框 8 处、下雪 3 处、调色板 2 处、弹出菜单 2 处)。方法调用的编号分发属另一条通道,本轮未动。
  4. 回归锁新增从脚本参数投递一路断言到对象字段的测试,六个子测试各自覆盖一个类,把「名字 → 哈希 → 参数分支」这条链锁住;以后再出现照抄原版常量的写法会立刻变红。
  5. 验证全套 Go 测试通过,静态检查只剩项目里既有的 unsafe 指针提示;启动器冒烟自报 0.5.67,CPU/GPU 位精确校验一致。

2026-10-28 · MIDI 对象真正发声(引擎 0.5.66)

  1. 问题与背景音乐播放对象此前只存参数:src 记个名字,play/stop 只翻转一个标志位,「播放结束」事件从不派发。原版靠 Windows 的软波表直接喂 MIDI 流,Go 侧要能发声,先得自己把标准 MIDI 文件解析成 PCM。
  2. 合成路径复用引擎内置的标准 MIDI 解析与简易合成器(纯 Go,无外部依赖),产物交给与 .gsm/.adm 音效完全相同的那条混音输出链——因此与其他音效共用一个出口,也能在无界面环境下推进播放时钟。
  3. 播放状态机暂停时记下已播帧数并停声,恢复时从该帧重新开一段;按实际经过的毫秒推进进度,暂停期间冻结;播完派发「播放结束」事件(脚本常在事件里重建播放对象,行为与原版一致)。销毁对象时先停声。
  4. 解码缓存脚本常在结束事件里重建同一段音乐,逐对象解码等于每轮重跑整段合成,因此按源名缓存合成结果;失败不缓存,下次会重试。
  5. 顺带修正参数通道该类的参数分支同样按原版常量比较,脚本赋值静默失效(与 0.5.67 是同一类问题,这里先修)。改为与运行时一致的哈希,并补一条从脚本参数到音频回调的测试。
  6. 刻意偏离同步解码替代原版的异步下载加就绪回调;循环开关只存值(原版存下后立刻清零,行为等同);音量只对下一次播放生效(混音器没有运行时单片段增益);速度只存值(不复刻原版把速度误当音量传入的缺陷);浏览器版没有音频出口,播放静音但计时与结束事件照常。
  7. 验证播放参数测试 13 处同步修正,另加主机路径测试;全套 Go 测试通过。音频类改动无法靠自动听声验证,需用启动器实际试听确认。

2026-10-28 · 写错位置时的诊断更准确(引擎 0.5.65)

  1. 问题与背景string ?msg = "x"; 只报「变量声明缺少名字」(variable declaration missing name),作者看不出真正原因是 ? 写错了位置。原版扫描器只在句子开头接受调试前缀,名字这一格读到的是 ?,而旧诊断只会说「期望一个名字」——Hello World 示例一度就是这么写的,靠人工比对才发现。
  2. 同一条消息下的第二种成因string script,cname;(fw2 的 pubuser_s.fcc:117)把类型关键字 script 当变量名,扫描器返回的是关键字 token,落到同一个名字槽,同样报「缺名字」。作者会以为自己漏写了名字,实际是名字非法。
  3. 实现解析器新增名字读取的统一入口,先照旧要求一个标识符;失败时再看当前 token 到底是什么:? 提示「调试输出前缀必须位于句子开头,改成 ?<类型> <名字> = ...,或先声明再 ?<名字>;」;关键字提示「"xxx" 是关键字,这里不能当名字」;其余情况保留调用方原来的措辞。变量声明、类名、基类、<> 与 <A:B>、style、方法名、:= 函数名、<< 网络调用名共 10 处全部接上。
  4. 定位到出错的 token错误位置锚在真正出问题的那个 token 上,控制台 #RE{文件,行,列} 直接指向 ? 本身或那个关键字,不再笼统落在句子起点。
  5. 不改语法接受范围句首 ? 照旧合法,关键字照旧不能当名字——只改提示,不改规则;真正漏写名字的写法仍然报原来的「缺少名字」。
  6. 语料体检验证重跑 cmd/fccaudit 扫全部 4056 个 .fcc:variable declaration missing name 由 7 次 / 6 文件变为 6 次 / 6 文件,新增 "script" is a keyword and cannot be used as a name here 1 次 / 1 文件(正是 pubuser_s.fcc:117,10);文件级中断仍为 0,出错文件仍 529 个。报告附录补了这一行的判读。
  7. 网页体验版同步浏览器版引擎重建到 0.5.65 并上线(wasm 20,897,861 字节 / 压缩后 4,988,590 字节)。在体验页里写错位置时,控制台会直接给出改法而不是一句「缺名字」。
  8. 范围只影响解析器的错误措辞与定位,不动运行时语义;新增 5 项测试(含「句首 ? 不受影响」的回归),go vet 干净、全套 Go 测试通过,launcher 冒烟自报 0.5.65 且 CPU/GPU 位精确校验一致。

2026-10-28 · 损坏 $PKH 数据块非致命降级(引擎 0.5.64)

  1. 问题与背景上一轮语料体检留下的最后一项:三份 temple.fcc(GAME100 / fc102 / smallqiyu 同一份老地图,旧版 MapEdit 1.03)在 overdata=$PKH{750:…} 处整文件解析中断,报 bad uncompressed length 1075060480 (payload 750 bytes)。这一项既可能是引擎读错偏移,也可能是语料本身损坏,需要取证分辨。
  2. 取证结论:语料损坏,不是移植缺陷$PKH 载荷的结构是「4 字节小端未压缩长度 + FZip 12 位 LZW 流」,Go 读长度头的位置与字节序和原版一致(LittleEndian.Uint32 等价于原版的 *((int *)ptr)),不存在偏移错。坏块的前 4 字节是 00 1F 14 40 = 1075060480,而语料里另外 25 个 overdata=$PKH 块的长度头都是合理的小数值。把 750 字节从偏移 0 直接解 LZW,得到完整的 825 字节(165 条 5 字节 TileAniNode 记录,首码就是 CLEAR)——正文完好,丢的只是那 4 字节长度头。
  3. 真正的缺陷:中断方式与原版不一致原版 FCodeNode::SetData 遇到长度头异常只打一行 _TR 跟踪,节点保留原始打包字节后继续扫描,文件照旧载入;Go 却把整文件扫描直接中断。改为「保留打包字节 + 定位告警继续解析」,与 C++ 行为对齐:脚本侧告警进 ParseErrors 并以 #RE{文件,行,列} 打到控制台,地图离线/编辑器侧告警进清单的 warnings。
  4. 一处实现两处复用把宽容解码收成 DecodePKHPayload 单一实现,脚本扫描器与地图扫描器共用,避免两条路径的容错策略再次分叉。长度头合理但解压尺寸对不上时同样降级为告警,不再中断。
  5. 语料体检验证重跑 cmd/fccaudit 扫全部 4056 个 .fcc:文件级解析中断由 3 清零,句子级错误由 13 类变为 14 类(新增的正是 $PKH payload unusable,出现在同样的 3 处),出错文件数 526 → 529,正好是三份原先被中断的文件。报告 docs/corpus_audit.md 已重新生成,判读附录补记了这一行。
  6. 地图工具链验证mapdump probe corpus/GAME100/map/temple.fcc 由退出码 1 变为 0,输出完整清单(format 8、usermap/bktile、35×200、1681×2401、indexData 21000 字节、overData 750 字节)并附一条告警;原先断言「探测报错即正确」的测试已按 C++ 语义改写。
  7. 网页体验版同步浏览器版引擎重建到 0.5.64 并上线(wasm 20,900,261 字节 / 压缩后 4,990,253 字节)。本地与公网体验页均自报 0.5.64,四个示例零解析错误,烈火英雄示例可选中运行。
  8. 范围只改 $PKH 块的错误处理策略与语料体检报告,不动解码算法与地图渲染语义;坏块保留原始字节,与原版一样呈现原样数据。全套 Go 测试通过,launcher 冒烟自报 0.5.64、CPU/GPU 位精确校验一致。

2026-10-28 · FCC 解析器换行容忍与嵌套错误上报(引擎 0.5.63)

  1. 问题与背景类体里参数表折行的方法声明会被整句静默丢弃:解析器逐个 token 期望「类型 名字 , 类型 名字 )」,一遇到换行就报错返回,非严格模式下整句被跳过——方法既没进类里,也不报错。fw2 语料里 GAME100/bout/chess/gobang/ChessClientUser.fcc:160 的 void StepDelaySet(int delay, 换行 overtime) 正是这个形态。另一处盲区是:类体、函数体、switch 子块各自持有一份脚本代码对象,解析错误写进去后没有人读取,因此类里写错一行,运行时完全静默。
  2. 括号内换行容忍表达式解析拆出「括号内」模式:方法定义的实参表、<< 网络调用实参、:player、if/while/for 三段、switch 头这些括号内的换行一律当空白处理;语句级表达式、变量初始化、表达式语句仍按原版规则把换行视为错误。这对应原版行为——括号内可以折行,语句跨行不行。
  3. 嵌套错误上报解析状态新增错误汇聚点,类体、方法体、子块、内联块都继承同一份,脚本加载器的三处解析点全部接上。非严格模式照旧跳过坏句子继续解析,但错误现在会以 #RE{文件,行,列}消息 的格式打到控制台,不再静默吞掉。
  4. 跳过语义对齐跳过坏句子时改为跳到括号深度 0 的 ; 或 },与原版 FCodeScaner::SkipSentenceCode 一致;跨行的坏句子整句丢弃,其后续行不会再被当成新句子重复报错。
  5. 顺带修复宏预处理里 #if 条件的循环变量在 Go 的 case 作用域内被局部变量遮蔽,导致条件 token 漏回代码流;改为预声明后赋值。
  6. 语料体检验证新增静态体检工具 cmd/fccaudit,扫描 fw2 全部 4056 个 .fcc:13 类句子级错误全部可解释、无一为移植缺陷(缺分号或运算符后换行、方法体内 #include 类文件等均与原版同语义,键:值 数据文件属单文件审计失真),文件级中断只剩三份 temple.fcc 的同一处资源长度异常。出错文件数由 82 升至 526 不是回归——是此前埋在子块里的错误这次浮出了水面。
  7. 网页体验版同步浏览器版引擎重建到 0.5.63 并上线。Hello World 示例里的 string ?msg = ... 把调试前缀 ? 写在类型关键字之后(原版只认句子开头的 ?),此前一直静默,本版本开始在控制台报错,示例已改为先声明再用 ?msg; 输出,四个示例现均零解析错误;示例取数加入时间戳参数,改完示例不会再被浏览器旧缓存挡住。
  8. 范围只影响脚本解析器与示例脚本,不改运行时语义;括号外的跨行语句仍按原版规则报错。新增测试覆盖折行参数表、折行实参、条件头折行、嵌套错误上报与跳过语义五项,全套测试通过。

2026-10-27 · ALE 预览角落信息固定(扩展 0.6.35)

  1. 问题与背景动画预览编辑器的左上角帧信息(帧尺寸/帧号等)与右下角帧进度原本挂在画布节点内部,而画布本身是可滚动的。放大或平移画布后,两块信息会跟着画面一起跑出视口角落,看不清也点不到。缩放倍数越高越明显。
  2. 改法新增一层预览容器承接窗口伸缩并裁掉溢出(position: relative + overflow: hidden),画布改为绝对定位铺满容器后继续承担滚动;帧信息与帧进度提升为容器的直接子节点并改为绝对定位——左上 10/8 像素、右下 24/24 像素(留出 24 像素避开原生滚动条),层级压在画布之上。只调整定位与层级,颜色、字号、圆角等视觉样式一律未动。
  3. 测试验证无头浏览器对 1x/2x/4x/8x/16x 五档缩放、四向平移、窗口改尺寸共 14 种状态逐项断言:两块信息相对容器的像素间距恒为 10/8 与 24/24,父节点恒为容器,字号保持 12px;TypeScript 编译通过,扩展语法回归 26 项全通过。
  4. 用户验收2026-10-27 重载编辑器窗口后实测确认:角落的帧信息与帧进度不再随缩放、平移移动。
  5. 范围本次只改 VS Code 扩展的预览页面布局,不涉及引擎、ALE/AEX 解码器与素材,已装扩展 0.6.35 后重载窗口生效。

2026-10-27 · PlayAni 脚本内建与烈火英雄示例(引擎 0.5.62)

  1. 问题与背景示例脚本里 PlayAni("stand") 报「函数未找到」,而紧邻的 anikind="stand" 写法正常。根因是对象方法表按函数名算出的固定编号分发,脚本调用传进来的是解释器驻留的字符串编号,两套编号空间并不相交,于是本来存在的分支永远不会命中,最终回落到「函数未找到」。
  2. 修复把 PlayAni、PlayAniCmd 注册为对象内建,参数面与原版对齐:PlayAni(动画类型, 步进毫秒=33, 结束事件名="", 结束帧),步进为每步间隔毫秒,动画播完时以指定名字触发事件;脚本调用路径与对象调用路径都落到同一份实现,行为一致。
  3. 网页体验示例换成烈火英雄原「扫雷」示例下线——触摸屏没有右键与悬停,标雷根本玩不了。换成「烈火英雄」:38 个素材(34 张图 + 4 个音,约 882K),打开体验页即自动选中并运行。同时修正示例里的图片路径多写了一层 ../ 的问题(浏览器版的虚拟工作目录下取不到,改为相对工作目录直接取)。
  4. 示例脚本调整被火喷到一次掉 40–50 随机血量,血量归零走原有死亡与扣分逻辑;掉血后进入一秒无敌(半透明显示并免疫伤害),计时结束自动恢复,出生时重置无敌状态。
  5. 浏览器版构建修复网络层里有一处 Windows 专属调用被无条件编译,经图片加载链被拉进浏览器版构建,导致 wasm 直接编译失败。把这一处按平台拆成两个文件后,原生与浏览器两侧都能构建。
  6. 验证与验收本地与公网双端实测:引擎自报 0.5.62,示例列表只剩烈火英雄且选中即自动运行;点「开始」后倒计时启动,点地面人物走动、喷火动画正常;控制台零运行错误,只有一条与桌面端一致的良性提示(同名类替换)。2026-10-27 用户确认本地与公网体验页运行正常。
  7. 已知限制浏览器体验版没有声音、网络、本机文件与真实窗口能力,示例中的音效会被静默忽略,属预期行为。

2026-10-27 · img 填充功能完整实现(引擎 0.5.61)

  1. 目标与背景原版图片对象的填充属性此前只登记了名字,设了也不出效果:血条、进度条、蓄力条这类靠「按比例显示一部分图」的画法全部失效。本轮把四个填充参数与渲染管线一起补齐。
  2. 四个参数imgtype 选填充方向,fillmethod 选填充方法(水平 0 / 垂直 1 / 90° 扇形 2 / 180° 扇形 3 / 360° 扇形 4),fillorigin 选起点(0–3,越界按 0 处理),fillamount 是 0–1 的填充比例。比例可写小数(如 fillamount:=0.5),脚本解析器新增浮点字面量支持;比例达到 1.0 时直接走正常绘制,与遮罩结果等价。
  3. 水平与垂直填充按比例裁剪出可见的矩形区域,支持左右/上下四个方向;裁剪与视口求交后绘制,对象部分出屏时也不会画到视口外。
  4. 扇形填充90°/180°/360° 三种扇形用逐像素角度遮罩实现:90° 以角为圆心、180° 以边中点为圆心、360° 以中心为圆心,四个起点沿顺时针方向扫掠。修复了起点角度错位——此前 90°/180° 只有一半起点能出图,360° 的起扫方向还与注释相反;现按「起点角 + 扇区宽度」查表并用取模统一顺时针,同时把 atan2 结果按 1e-6 度取整回绕,避免恰好落在扇区边界时忽隐忽现。
  5. 手册与语法高亮四个参数已录入公网学习手册(系统开发 › 基本对象 › img)并加入语法词表,网页与编辑器扩展共用同一份着色配置;扇形起点的语义按实测结果记录为顺时针扫掠(360° 的 0/1/2/3 依次为 6 点、9 点、12 点、3 点)。
  6. 测试验证与验收新增角度表、每个起点的像素探针(起点方向必填、越界方向必空)、覆盖率随比例单调增长且满额覆盖整幅、非法起点退化等回归测试,覆盖三种扇形的全部起点;全套 Go 测试、构建与静态检查均通过。2026-10-27 用户在 sample 中实测水平填充渐变显示正常。
  7. 已知限制90°/180° 扇形以角或边中点为圆心,遮罩面积随角度非线性增长,fillamount 只在 360°(中心圆心)时近似等于可见面积占比;按比例做扇形进度条时需注意这一点。

2026-10-25 · 调试模式拖拽与方框显示优化(引擎 0.5.60)

  1. 拖拽移动对象调试模式下(按 · 键开启),左键点击选中的对象或其子对象可直接拖拽移动位置,松开鼠标完成移动。拖拽过程中自动抑制焦点切换,防止误选其他对象。支持通过点击子对象拖拽父对象。
  2. 方向键像素调节选中对象后,方向键可逐像素微调位置(上/下/左/右各移动 1 像素),实时推送位置更新到 VS Code 调试面板。按住 Shift 时隐藏选中方框,松开 Shift 恢复显示,便于精确观察对象边缘细节。
  3. 方框显示策略优化拖拽开始时自动隐藏白色选中方框,避免拖拽过程中方框残影;拖拽结束时恢复显示。半透明白色外框(50% 透明度)+ 不透明黑色内框,既能清晰标识选中对象,又不完全遮挡对象内容。Root 对象不可拖拽或调节,保护根节点安全。
  4. Dirty Rect 修复修复拖拽时白色方框在背景上留下残影的问题:为选中对象的当前和旧位置各扩展 2 像素的脏区,确保方框区域被正确标记为需要重绘。
  5. 测试验证新增 6 项端到端测试全部通过:完整拖拽流程、方向键调节、子对象跟随父对象移动、点击子对象拖拽父对象、拖拽时抑制焦点切换、Root 对象保护。实机运行 corpus/sgame/Game/oneplusone/index.fcc 验证拖拽功能正常。

2026-10-24 · HTTP 客户端与服务器对象移植(引擎 0.5.60)

  1. 目标与背景完成 ServerExt 扩展库的最后两个网络对象:HTTP 客户端(HttpQuest)和 HTTP 服务器(HttpSvr)。这两个对象让 FCC 脚本能够发起 HTTP 请求和搭建简易 Web 服务,是引擎网络能力的最后一块拼图。
  2. HTTP 客户端新增 HttpQuest 对象,支持异步 HTTP 请求。用 Go goroutine 和缓冲 channel 替代原版的 Win32 线程/事件句柄,URL 编码和解码完整复刻(空格转加号、特殊字符转百分号编码)。提交请求后在引擎帧循环里排空结果 channel,通过事件回调把状态码和响应正文送回脚本。仅 HTTP 200 且正文大小在合理范围内时返回内容,其他情况返回空。忙碌状态下拒绝新请求。可见模式下显示「H:Post」或「H:Idle」。
  3. HTTP 服务器新增 HttpSvr 对象,嵌入监听 socket 并为每个连接创建独立的 HTTP 状态机。遵循原版的连接管理模式:头部累积直到空行,解析请求行和 headers;GET 请求拆分路径和查询参数,POST 请求检查 Content-Length(过小按 GET 处理、过大断开连接、否则准备接收正文)。按 action 名称哈希查找已注册的处理器,解析表单数据到键值表,通过事件回调派发给脚本。支持发送 HTML 响应(自动换行转 br 标签)和主动关闭连接。连接引用用单调递增的 token 和 map 查找,避免直接传递指针。
  4. 修复 POST 正文解析连接对象的 action 路径字段遮蔽了底层 socket 的同名字段,导致接收 POST 正文时读取到空值。新增显式的设置和读取方法,确保正文数据能正确传递给处理器。
  5. 测试验证新增 20 项测试全部通过:URL 编码往返、客户端 GET/POST/忙碌拒绝/非 200 状态、服务器启停、处理器注册、HTML 发送、连接关闭、查询参数访问、头部解析边界。集成测试用真实 HTTP 客户端对本地端口验证完整流程:GET 请求解析查询参数、POST 请求接收、未注册 action 返回 404、处理器注册与回调、连接 token 查找、主动关闭连接。全套 Go 测试通过。构建产物 objsys.dll 0.5.60(21MB),launcher 冒烟测试加载成功、引擎初始化正常、CPU/GPU 位精确校验通过。
  6. 已知限制协议级验证完成,未与真实数据库服务联调。DBK 对象在语料中零引用、零样本,无需求暂不移植。

2026-10-24 · 数据库网络对象移植(引擎 0.5.59)

  1. 目标与背景移植 ServerExt 扩展库的三个数据库网络对象:DBBank(数据库银行)、DBSocket2(数据库 socket 第二版)、DBSocket(数据库 socket 遗留版)。这些对象让 FCC 脚本能够连接远程数据库服务、执行查询和接收回调,是游戏联网功能的核心基础设施。
  2. 共享网络层新增数据库对象的共享网络层,嵌入 socket 主机基类并转发连接、命令行、断开、超时、发送等回调。对象引用用 CreateID token 通过全局表查找,不传递 Go 指针。参数读取只实现数据库对象需要的格式,不泛化整个运行时。ID 空间用哈希函数,脚本函数和事件用驻留 ID。
  3. DBBank 对象按原版逐条复刻握手协议:发送种子和加密标记,接收异或混淆的确认,然后发送登录信息。连接成功后设置加密种子,后续通信全部加密。支持登录、游戏名、连接、发送、发送缓冲等参数,以及是否已连接查询。调用时按对象引用和函数名组帧,接收时验证 token 和 cid 后派发事件。心跳保持连接,断线自动重连。
  4. DBSocket2 对象握手协议与 DBBank 类似但用不同的混淆常量,不调用加密。支持开发模式门控的参数面,连接时可按配置覆盖主机地址。接收成功响应的格式校验精确到字节位置,错误分支按消息类型分发。数据库查询、更新、新增操作按原版帧格式组装,条件字段支持整数和字符串(字符串内单引号双写)。断线时查询操作延迟回调错误,更新操作进入离线队列。
  5. DBSocket 遗留版握手发送登录信息和在线标记,心跳用 active 标记。成功响应格式与 DBSocket2 相同但对象 token 用十六进制。五个数据库操作按原版帧格式组装,占位符超过八个时用字母扩展。所有发送走缓冲队列。
  6. SafeStr 编码新增网络安全的变量序列化:整数用 XOR 混淆后十进制,指针用十六进制加标记,字符串引号转义,数组用括号包围,浮点数固定三位小数。解析只接受空白、数组、指针、引号、整数,不承诺所有输出类型均可反解。用于数据库通信的帧编码。
  7. 测试验证真实 loopback TCP mock 验证三条握手协议逐字节正确:登录、心跳、确认。查询、更新、新增操作的帧格式和回调派发。token 往返、伪造 token 拒绝、cid 不匹配拒绝。SafeStr 编码与 C++ 向量一致。全套 Go 测试通过。
  8. 已知限制协议级验证完成,未与真实数据库服务联调。DBK 对象在语料中零引用、零样本,无需求暂不移植。

2026-10-24 · 数据表对象移植(引擎 0.5.58)

  1. 目标与背景数据表(原版 datatable)是语料里使用最广的对象之一:两百多个脚本、八百多处调用依赖它读取道具、技能、NPC 等表格数据。此前的重写版只登记了名字,取记录、按字段查询、枚举等能力全部静默失效;资源库里还有 254 个 .tab 表格文件等待读取。本轮把它完整补齐。
  2. 数据表对象新增数据表对象,支持读取表格文件、按主键取整条记录、按主键查某个字段、新增/覆盖/删除记录、修改非主键字段、按内容查找记录下标,以及遍历全部记录(可带序号)。记录始终按主键降序保存,与原始实现的内部顺序一致,因此按序号取记录的结果也相同。新增时会严格校验字段数量和类型,重复主键不会被覆盖(覆盖需用另一接口)。
  3. 表格文件读写按原版格式读取:首行标记、第二行声明字段名与类型并用星号标出主键、第三行字段名、之后是数据行;读取时会自动按内容加宽列,空行与注释行跳过,重复主键只记日志不中断。保存时按同一格式写回,字段名加引号、每列后带逗号。资源路径同样支持内置资源与磁盘文件。
  4. 显示与交互数据表可以作为可见控件显示:标题行中主键列用亮黄色、其余用浅黄白色,数据自标题下方逐行绘制,列宽按读取时算出的宽度排布。支持视口位置与偏移参数,改动尺寸或视口时会通知脚本更新(仅在实际变化时触发一次)。与原版一致,纵向滚动会在绘制前自动夹紧,横向的夹紧方向与原版的特殊写法保持相同,未作「修正」。
  5. 顺带修复文本取词函数在处理中文等多字节字符时按固定两字节跳步,遇到三字节的中文字符会把后面的逗号一并吞掉,导致个别表格首次读取时字段名报错。现改为按字符实际字节宽度前进,非法序列仍沿用两字节兜底(兼容旧的 GBK 资源)。
  6. 测试验证新增对象测试 15 项(默认值、参数面、文件读写往返、各方法边界、枚举回调、渲染像素、变化通知次数、注册)。语料回归遍历全部 254 个 .tab:248 个标准表格全部读取成功且行列数与源一致、保存后可等价重开,6 个非标准文件按预期拒绝,零失败。全套 Go 测试通过。实机冒烟:读表后记录数、字段数、按主键取值、未命中返回 notfind、按内容查下标、取整条记录(含中文)全部正确;可见模式下正常出图、64 帧无异常、Esc 干净退出。
  7. 已知限制保存时不转义引号,字段名或字符串里含裸引号时重新打开会在引号处截断——这是原版取词规则决定的行为,未作改动。

2026-10-24 · 文字简介对象移植与脚本调用派发修正(引擎 0.5.57)

  1. 目标与背景老游戏「烈火英雄」右上角的简介面板一直空白。这里的简介对象(原版 textdoc)是语料里最后一类缺失的常用对象:它自带多行富文本排版,此前重写版没有对应实现。本轮把排版与对象一起移植,并顺带挖出面板空白的真因——引擎脚本调用派发的一处移植遗漏。
  2. 文字简介对象新增 textdoc 对象,支持文字颜色、行距、字体、最大行数、起始位置与缩进、视口偏移、水平对齐等参数,以及取行数、取视口位置、取行内容、清空/删除行/替换行、读写文件等方法。内容超出可视区域时可用滚轮上下滚动;滚动范围允许为负以实现底对齐,与原始行为一致。
  3. 排版引擎按原版逐条复刻:只按回车换行分行、按可用宽度折行(中文按整字走,不会把双字节字符拆开)、行高与行距累计总高、按纵坐标反查行号;文本中的链接标记与颜色标记也照原样解析。参数改动后整篇重新排版。
  4. 调用派发修复原版表达式里的裸函数名,按「本对象函数表 → 脚本类继承链 → 文件级全局函数」的顺序查找。重写版此前直接查全局函数表,同名函数以最后定义者为准:游戏把简介对象内嵌进外层面板类之后,外层构造函数里调用的同名方法实际跑到了窗口对象上——窗口被误改尺寸,简介始终是零行,面板于是空白。现已改为按执行对象派发,全局只作兜底。
  5. 测试验证新增对象层 9 项、排版层 6 项与引擎级端到端 2 项(逐行颜色与缩进、折行不越界、滚轮步进与上下夹紧;以及复刻游戏嵌套调用场景,断言外层尺寸不被污染、内容正常渲染)。全套 Go 测试通过。实机运行 sgame:简介面板出现黄色中文,点击开始后文本逐帧上滚并循环回开头,全程零运行错误,Esc 干净退出。
  6. 已知限制替换行时重写版会直接重排被替换的行,原版则会留下过期的行高缓存——这是有意的修正偏差。

2026-10-22 · 龙喷火只出第一帧修复(引擎 0.5.56)

  1. 目标与背景用户实机试玩 sgame 时发现,龙喷火只有嘴部一小簇火焰,本应是一道向下延伸到底的火柱。
  2. 根因与修复火焰脚本用「循环播放第 0 帧到最后一帧(framemax - 1)」的方式驱动动画,而重写版 img 对象缺少 framemax 取参:脚本取不到就得到 0,播放范围变成 0 → -1,只显示第一帧便自我销毁。原版规则是无动画时返回 1、有动画时返回实际帧数,现按原版补齐。这一缺口影响 fw2 全部使用同一写法的脚本,属于引擎参数面遗漏而非脚本问题。
  3. 测试验证新增回归三项(无动画返回 1、4 帧返回 4、24 帧返回 24);全套 Go 测试通过。实机连拍 30 张:点击开始后火焰从右侧龙头嘴部逐帧向下延伸至场地底部再收回(约 0.45 秒),随后消失,音效同步播放,Esc 干净退出。

2026-10-22 · 不限帧模式输入无响应修复(引擎 0.5.55)

  1. 目标与背景上一版引入帧率上限配置后,用户实机反馈 sgame 画面持续刷新,但窗口完全不响应鼠标和键盘。
  2. 根因与修复上一版用一个独立步进线程持续向窗口投递「该画下一帧了」的消息。Win32 只有在消息队列为空时才会把鼠标键盘输入送进队列;默认不限帧时帧消息永远排队,输入被彻底饿死。现改为在消息泵内部按截止时间调度:等待「到达下一帧时刻」或「有新输入」,谁先到就处理谁,不再需要帧消息。不限帧时排空消息后立即跑帧,队列空出后系统可正常合成输入;限帧时仍按微秒级截止推进,卡顿后重新锚定,节奏不乱。退出也改由显式标志兜住。
  3. 测试验证限帧 60(53/59/59 帧)、不限帧(179/213/214 帧)、脚本间隔 100 毫秒(稳定 9 帧)三种配置均自然退出;不限帧下注入鼠标移动与 Esc 后立即干净退出;sgame 实机加载 22 秒、渲染 1118 帧,注入鼠标移动、左键与 Esc 后正常退出并打印退出信息。

2026-10-22 · 引擎帧率上限配置与按时间补帧(引擎 0.5.54)

  1. 目标与背景引擎此前固定约 40 帧(25 毫秒定时器),既无法表达 60 帧,也不支持不限帧,动画速度还会随机器性能漂移。
  2. 帧率配置配置文件新增 engine.fps:默认 0 表示不限帧,N 大于 0 表示每秒最多 N 次更新与呈现,负数按 0 处理。启动器在引擎初始化后读取该值。
  3. 调度重写实测本机 Win32 定时器被量化到 15.6 毫秒左右(1 毫秒与 10 毫秒定时器都只有 63–66 次/秒),因此改为按高精度计时器的截止时刻驱动,单帧在途防堆积;长跑按固定周期推进,拖动或卡顿后从当前时刻重新锚定,不会突发补帧。脚本级 updatedelay 仍只在帧率上限之上放慢,不能提速。
  4. 退出与补帧不限帧模式下持续排队的帧消息曾让退出消息浮不出来,现增加显式退出标志并先停调度再退出,Esc、窗口动作 0 与关闭窗口统一走这条路径。普通 img 的自动换帧改为按经过时间补跳帧,播放速度不再随帧率漂移。
  5. 测试验证全套 Go 测试通过。CPU 渲染器实测:限帧 60 得 53/59/59 帧(首个采样窗口含启动开销),不限帧得 200/251/248 帧;GL 呈现约 50 帧,为既有的呈现带宽限制,未变。脚本间隔 100 毫秒时两种模式都约 9–10 帧,确认脚本间隔优先。Esc 与窗口关闭均干净退出。

2026-10-22 · ALE 标签切换播放速度稳定(扩展 0.6.34)

  1. 目标与背景用户反馈同一个 ALE 在标签间来回切换播放时忽快忽慢:标称 15 帧的资源,有时约每秒只推进一帧。
  2. 根因与修复问题出在定时器回调受限,而不是帧脚本或解码耗时。现改用浏览器动画帧回调,按真实经过时间计算该显示第几帧;播放意图与调度句柄分开,面板隐藏时取消调度,返回时重置时钟——不追赶隐藏期间的时间,也不会把用户手动暂停变成自动播放。
  3. 测试验证回归覆盖延迟回调、单循环、暂停恢复、调速、隐藏/返回、单帧与 1/15/60 帧;真实 IDE 五文件连续切换 15 轮稳定在约 14.5–14.9 帧(目标 15),后台不再累积播放帧;真实 IDE 控件 21 项通过,未捕获页面运行错误。
  4. 用户验收用户实测确认「经测试正常了,怎么切换都播放的很流畅了」。

2026-10-22 · 半透明边缘彩点修复(引擎 0.5.53 + 扩展 0.6.33)

  1. 目标与背景用户报告一个技能素材图(AEX 格式)的上边缘与左边缘出现彩色脏点。
  2. 根因与修复该格式由 JPEG 颜色图与 GIF 透明图组合而成。解码时把未预乘的颜色直接写入输出图像,导出 PNG 时反预乘造成颜色溢出——例如原本淡黄、透明度 194 的像素被导出成青色杂点。真 ALE 分支此前已做预乘,此次补齐 AEX:写入帧像素时按透明度缩放颜色,保留透明度、阴影点、裁剪与偏移,不改动原素材。目标四帧共 364 个像素恢复,透明度与不透明像素逐字节不变。
  3. 测试验证新增回归先红后绿;全套 Go 测试与扩展编译通过;PNG 往返与缓存五场景通过;真实预览页 11 项断言通过(四帧切换、边缘像素、播放推进、缩放与 1:1),控制台无错误,仅有无害的性能提示。
  4. 缓存说明扩展会检查源文件与解码器的修改时间,解码器升级后旧缓存会自动重建,无需手动清理。

2026-10-22 · MIDI 声音预览(引擎 0.5.52 + 扩展 0.6.32)

  1. 目标与背景编辑器已能预览 .gsm 与 .adm 音效,用户接着要求 .mid 背景音乐也能双击试听。浏览器原生不支持 MIDI,标准音源库动辄数 MB,与「零外部依赖」相悖,因此改为引擎侧离线合成。
  2. 离线合成器新增纯 Go 的标准 MIDI 文件解析器与简易合成器:支持多轨、变速与跨事件的运行状态;用七类基础音色(钢琴、钟、风琴、拨弦、弦乐、铜管、长笛)加包络合成,通道 10 映射为打击乐;渲染成标准 WAV 后交给扩展既有的播放管线,播放、暂停、停止、循环与拖动进度全部复用上一版能力。解析与合成共新增 6 项测试。
  3. 命令行与扩展解码命令行工具新增 .mid 识别与 WAV 导出,并可处理整包语料;扩展的声音预览新增 .mid 匹配,信息行注明「离线合成器渲染(非 GM 音源)」。
  4. 运行时行为引擎运行时不对 .mid 解码,与原版一致——原版也从不把 MIDI 解成波形播放。脚本对象 FMidPlay 未移植,语料中的 .mid 均由编辑器预览消费。
  5. 测试验证解析与合成测试全部通过;fw2 语料 46 个 .mid 全部渲染成功、零失败;扩展编译通过;无头浏览器自断言 10 项中 9 项通过(播放推进受无头浏览器媒体时钟冻结所限,同一份控件代码在上一版已实机验收)。
  6. 用户验收2026-10-24 用户实测 .mid 双击试听正常,并确认「目前功能测试正常」。
  7. 已知限制合成器为近似音色,并非标准 GM 音源。

2026-10-22 · 编辑器音效预览与 ADM 解码修正(引擎 0.5.51 + 扩展 0.6.31)

  1. 目标与背景用户点单:在 VS Code / Qoder 扩展里双击打开 .gsm 与 .adm 音效文件时,要能播放、循环播放、暂停和停止。落地前冒烟测试发现一处上一版的遗留问题——0.5.49 宣称支持的 ADM(IMA-ADPCM)解码其实从未生效,所有真实 .adm 文件一直在走「当作无头 GSM」的兜底路径,放出来的是错误波形。本轮功能与修正一并交付。
  2. 声音预览编辑器双击 .gsm / .adm 现在直接进入播放页:页头显示容器类型、采样率、样本数与文件字节数;居中四个控件——播放、暂停、停止、循环(循环为开关态,点亮即开启,播完自动从头再来);下方进度条可拖拽定位,时间显示随播放推进;空格键等价于播放/暂停切换;非循环播完自动回到开头。解码由扩展自带的命令行工具完成(新增 snd 子命令,把两种老容器统一转成标准 WAV),结果缓存在系统临时目录——源文件没改过就直接复用,不重复解码。
  3. ADM 识别常量修正根因是容器识别常量的字节序写反了:老游戏 .adm 文件头的四个字节是反序存放的,原版 C++ 引擎用原生小端数值比较恰好命中;重写版照字面直写常量后永不匹配,于是全部落入兜底分支。更隐蔽的是,当初用来生成逐样本比对固件的参照程序带着同一个错误常量——固件本身就是兜底路径的输出,等于测试在自我印证,ADM 解码从未被真正验证过。本轮把引擎与参照程序两侧常量一起修正、重新生成比对固件后,ADM 解码路径首次通过逐样本位精确比对;解码算法本体逐行核对无误,错的一直只是识别开关。
  4. 测试验证GSM/ADM 黄金比对与新增的 WAV 头字段、容器嗅探、命令行往返、用法退出码测试全部通过;扩展编译通过;真实语料冒烟转换正常;另以独立页面逐字复刻播放器脚本做浏览器断言——加载时长正确、播放中时间推进、暂停与停止归零、循环开关生效、进度拖到正中后定位精确落在时长中点。声音本身机器听不到,由用户在编辑器里实测 .gsm 与 .adm 的四组控件,确认「测试正常」。
  5. 已知限制预览页为只读播放,暂无音量与变速控制;音频侧其余限制与 0.5.49 相同(无编码写回、混音直加钳位、设备固定 44.1kHz 立体声)。

2026-10-22 · 接口系统两处移植遗漏修复:信息面板动态计数与积分恢复(引擎 0.5.50)

  1. 目标与背景老游戏右侧信息面板的动态计数与积分在跑通当日报「表达式运行错误」,当时的发布记录判断为「原版即死功能、非引擎问题」。用户指出游戏脚本里明明注册了信息接口,这个判断不对。复核原版源码后确认:接口注册本身一直成功,是引擎移植时漏掉了接口系统的两条查询规则;旧记录的判断已予更正。
  2. 隐式接口前缀原版引擎规定:凡是以固定前缀开头的参数名,一律按「查找同名已注册接口」处理,且这一步发生在任何普通变量查找之前——查不到就直接失败,绝不会拿一个同名的普通变量冒充。重写版漏掉了这条规则,脚本里的接口调用名落进了普通变量查找,自然什么都找不到。现按原版补上:按接口名精确查找、命中即返回接口对象、查不到如实报失败。
  3. 父对象链查询原版查找接口时,本对象没有就沿父对象逐级向上问,直到根。重写版只查本对象一张表,于是挂在窗口里的子对象永远看不到注册在桌面层的接口。现补成本对象命中即返、未命中沿父链向上递归;就近的有效绑定优先,绑定目标已失效时跳过它继续向上,不查无关的兄弟分支。两个显式查询接口(按名查找 / 判断是否实现)走同一条函数,祖先可见性一并恢复。
  4. 测试验证两条对象层回归钉住语义:同名的普通变量不能掩盖缺失的接口;父链逐级查找的优先序与失效跳过。另用真实游戏脚本做集成验证:从根和子窗口两个方向都能解析到同一个信息面板对象;游戏加分时面板积分文字同步刷新;直接调用面板的计数与积分方法输出正确。全套 Go 测试通过。实机跑老游戏:吃到两组金币后计数 0→2→4,面板与底部数码管积分 0→200→400 同步刷新,全程零运行错误、零警告。用户实测确认「sgame测试一切正常」。
  5. 已知限制「文字简介」对象与行内换色转义仍未实现,与上一版相同。

2026-10-22 · 音效播放落地、启动黑屏与文字换行三项修复(引擎 0.5.49)

  1. 目标与背景上一版把 fw2 老游戏「烈火英雄」跑通之后,用户实机反馈三处体验缺陷:整局没有任何声音;从启动到出画面要黑屏几十秒;游戏结束对话框的说明文字里本该换行的地方显示成一个个方框。本轮三项一起修完,用户实测确认「之前的问题测试都正常了」。
  2. 音效解码老游戏的音效不是标准 WAV,而是两种自研压缩容器——GSM(RPE-LTP 语音编码)与 ADM(IMA-ADPCM 自适应差分)。运行时此前只认标准 WAV,遇到这两种一律打印警告后跳过,所以全程无声。本轮把开源 libgsm 1.0.10 的解码路径完整移植成 Go(长时预测滤波、反射系数、网格激励、短时合成滤波,定点运算的截断与舍入位置逐处照抄),并按容器头识别 GSM / ADM / 无头 GSM,统一解出单声道 PCM 与采样率;ADM 部分按原版逐字节、高半字节先行的规则还原。播放链路分三段接通:运行时解码后把 PCM 交给宿主程序,宿主按名字缓存并在缓存时重采样到 44.1kHz 立体声。旧宿主没有这条通路、或解码失败时自动回落到原来的按文件名播放,行为不变。
  3. 播放卡顿与静音卡顿的根因是每播一个音就打开一个音频设备、把整段声音一次性排队,而且开设备与拷贝数据都发生在界面线程上,多路并发时驱动混音器抖动。改成一个设备 + 独立混音线程 + 八块约 46 毫秒的环形缓冲(约 370 毫秒余量):声音在缓存时就完成重采样,混音只做直加与每路音量/声像衰减,界面线程只登记一个很小的声部节点,停止播放在临界区内立即摘链(残留尾音不超过一块)。改完却出现全程静音——新的混音器漏掉了「把缓冲块交给设备预备」这一步,导致每次写入都被设备拒绝、一个样本也没送出去。补上预备步骤后恢复,并加了两道保险:写入失败会打印警告,退出时打印「已写入 / 已回放」的块数统计作为设备级证据。
  4. 启动黑屏脚本里「延时若干毫秒后调用某函数」的延时,此前被当成帧数逐帧递减,500 毫秒变成了 500 帧,于是要等几十秒才进游戏。对照原版语义改为绝对毫秒截止时刻:投递事件时记下「当前引擎毫秒 + 延时」,每帧扫描只触发已到期的事件,未到期的原样留在队列里。
  5. 文字换行脚本字符串里的 \r\n 此前既不换行、又把控制字符画成方框(字体没有对应字形)。本轮按原版逐字符走串的规则移植:遇到回车换行先把当前段画出去、纵坐标下移一行、横坐标回到左缘;量尺寸时宽度取各行最宽、高度为各行之和;空行只占一行高度不画任何字;末尾多写的分隔符不会凭空多出一行。选择字体前先剥掉控制符,方框随之消失。文本对象的自动尺寸与水平/垂直对齐都从同一处量取,因此多行排版自动正确。
  6. 测试验证全套 Go 测试通过。文字换行新增三层测试:尺寸(两行 / 三行 / 末尾分隔符)、像素(首行墨迹不超出自身宽度即无方框、空行带零亮点、第三行落在自己行内)、对象层(自动尺寸与实际绘制逐行断言)。音频解码与开源实现做了逐样本位精确比对——用 libgsm 原版源码另编一个参照程序生成 PCM 固件,再逐样本核对;另有容器头语义、定点边界与坏帧容错测试。实机运行老游戏:秒出画面、整局 36 次播放、零写入失败,正常退出时统计为「写入 605 块、设备回放 597 块」(约 28 秒音频,8 块仍在队列)。复刻缺陷文案的独立夹具截图为三行文字、两处空行间隔、零方框。顺带修好一个既有测试的时间敏感阈值:截图横幅用的是墙钟时间,未改动像素数随时间戳数字在 815–848 之间浮动,旧阈值在凌晨必然误报,已放宽并注明理由(真出现底色条时仍会响亮失败)。
  7. 已知限制音频只支持这两种老容器与标准 WAV,未移植编码(写回);混音为直加钳位,没有压缩或限幅;设备固定 44.1kHz 立体声。文字的行内换色转义(反斜杠 b + 六位十六进制)与「文字简介」对象仍未实现。

2026-10-21 · fw2 老游戏「烈火英雄」单机全程跑通(引擎 0.5.47 + 0.5.48)

  1. 目标与背景把 fw2 语料当作查漏补缺的基准,首个目标是自带完整资源的小游戏「烈火英雄」。此前运行只有黑屏、且不报任何错误,看不出断在哪一环。
  2. 实现两轮引擎修复。①根对象的事件派发:顶层定时器与顶层每帧回调此前落在一个空实现上被静默丢弃,补齐后入口脚本的定时器才能触发。②脚本文件被 Run 载入时,顶层定义的变量应当落到全局作用域(原版按「第 0 层」执行脚本文件、类体与样式体同理),此前沿当前作用域执行,游戏主窗口对象随事件函数返回一起被回收——窗口刚建就消失,于是黑屏。改为把定义写入最底层作用域,并用计数器而非布尔值保证嵌套 Run 正确退栈;函数内部的局部变量不受影响,所有 Run 入口(脚本文件、构造体、样式体、对象上执行、脚本文本)统一受益,与原版各条路径一一对应。
  3. 测试验证三条针对性回归测试钉住整条链路:定时器派发、入口函数解析、Run 文件载入与顶层执行。实机跑完整局:入口脚本 → 载入游戏脚本 → 主窗口与右侧面板渲染 → 点开始 → 金币宝石生成 + 180 秒倒计时 → 点地行走 → 吃到金币加分(数码管 00000000→00000100)→ 撞火死亡(扣分、墓碑、3 秒后原地重生)→ 时间到结束 → 「体验结束」对话框 → 关闭后可重开新局;全程零运行错误(当时 5 条接口访问提示曾误判为「原版死功能」,实为引擎移植遗漏,已在 2026-10-22 的 0.5.50 版修复,见上方条目)。
  4. 已知限制当时的无声、启动黑屏与对话框文字方框三项,已在下一版 0.5.49 全部解决;「文字简介」对象仍缺。

2026-10-21 · 调试器体验四项:状态留存、调试宏、不抢焦点、按需显示输出(扩展 0.6.27→0.6.30 + 引擎 0.5.46)

  1. 目标与背景连续四轮针对脚本调试面板的实用性与焦点问题,均由用户实际操作中反馈。
  2. 实现①切换文件后跟踪记录被清空:面板隐藏时视图连同内容一起被销毁,重新显示时重建出空页面。改为保留视图内容,并在重建时把已有记录与选中项全量回放,换文件、换容器都不再丢。②面板顶部新增一排调试宏复选框(先放 LOC、TEST):勾选后运行脚本先定义同名宏再执行,等同在脚本开头写 #define,不污染脚本即可用条件编译做分支调试;宏在加载启动脚本之前应用,系统脚本不受影响,取消勾选不会残留,重启后仍生效。③运行脚本不再自动跳到输出面板抢焦点,跟踪记录照常写入调试面板。④新增「显示运行输出」命令与标题栏按钮,按需把运行日志提到输出面板,同时把「开始运行 / 已退出 / 启动失败」三条生命周期行镜像进跟踪面板,隐藏输出面板也不丢信息。改动只涉及本扩展自己的输出通道,其他扩展的日志互不干扰。
  3. 测试验证TypeScript 编译通过;模拟宿主与真实浏览器两套断言覆盖状态回放、宏拼装出的运行参数、运行期零焦点抢占、命令与按钮注册等十余项。引擎侧新增宏应用测试(无宏→一个→两个→清空),全套 Go 测试通过;实机分别验证零个 / 一个 / 两个宏以及地图运行按钮的宏透传。四个版本均已安装,需手动重载编辑器窗口生效。
  4. 使用要点编辑器对从未显示过的输出通道不渲染内容,重载后点一次「显示运行输出」选中该通道即可,此后运行实时写入。用户实测确认通过。

2026-10-21 · 动画预览编辑增强:攻击判定点、占地叠加层与帧脚本转码(引擎 0.5.45 + 扩展 0.6.23→0.6.25)

  1. 目标与背景用户点单六项,围绕 .ale 动画的预览与编辑:看不清攻击判定位置与占地范围,帧脚本里的汉字是乱码。
  2. 实现①预览背景默认改为青灰 #428284 并加入背景选单;②帧脚本里带 dx/dy + fight 的攻击判定点用红色小叉标出,位置相对帧偏移原点(即十字线交点);③w/h 占地用黄色阴影线菱形铺出,格子从帧原点起算、相邻格共边贴合;④两个复选框默认勾选,改帧脚本即时重绘;⑤帧脚本里的汉字乱码自动按 GBK 转成 UTF-8——fw2 时代的资源把字符串存成 GBK 字节并带尾部填充空字符,转码必须在运行时一侧完成,因为导出成 JSON 时非法字节已被替换掉,编辑器侧无从挽回;⑥附带处理空字符尾巴、前导分号容错、帧条徽标与叠加层扩界。占地轴向经用户两次实机指正后定稿:w 轴斜向右上、h 轴斜向右下,格心按等轴网格计算,与地图格同构。
  3. 测试验证全套 Go 测试通过(含 GBK 转码与 UTF-8 原样透传两项,并以真实语料复核解码结果)。三份真实语料在浏览器里逐条断言:攻击点徽标的数量与位置、编辑后即时移位、1×3 与 2×2 占地的菱形顶点与共边关系、背景回退、控制台零错误;放大截图目检阴影线与红十字渲染正确。实机运行渲染校验逐位一致、零错误。扩展三个版本已安装,需手动重载窗口生效。
  4. 已知限制攻击判定点语义按真实语料的八方扫帧实证;占地按 48×24 的等距格,与地图编辑器的通行格同构。超大的 w/h 只钳制显示尺寸、不改脚本值。

2026-10-21 · 地图 3×3 / 5×5 笔刷改斜轴足迹(扩展 0.6.26)

  1. 目标与背景用户指正:大笔刷的范围应是斜轴(等轴网格轴)足迹,而不是索引空间的正方形——后者投到屏幕上歪成不与地砖贴合的形状。
  2. 实现笔刷范围定义为世界坐标下的 (2a+1)×(2a+1) 方块,投影到屏幕即为菱形,轴向与动画占地一致(w 斜右上、h 斜右下);由屏幕偏移反解格坐标的映射是单射,因此 5×5 恒为 25 格。悬停描边、落笔与按住轮换三处共用同一套计算,提示与实际修改永远一致;地形过渡的邻格判定仍按世界共边格,不受影响。
  3. 测试验证从编译产物取真实函数在隔离环境运行的校验脚本 485,028 条断言全绿;独立页面在真实浏览器里解析菱形顶点、探针描边像素,并用真实鼠标涂抹后核对足迹恰为路径菱形的并集,控制台零错误。已安装,需手动重载窗口生效。

2026-10-19 · 地图编辑器交互批次:拖动过渡、笔刷提示、新作/清空地形、右键手势与缩放、通行条纹(扩展 0.6.17→0.6.21)

  1. 目标与背景五轮连续的编辑器手感修正,全部由用户实机反馈驱动:拖动绘制后出现尖三角、大笔刷只提示一格、「清空」语义混淆、删除与平移手势冲突、四个通行复选框勾选后毫无反应。
  2. 实现①过渡方向此前读取了并不相接的角,把不相干的地形带进新样式,改为只读邻格面向当前格的那个象限;并在每一笔的焦点开始时清理轮换状态,防止定时器把已画实的格子覆盖回过渡。②3×3 / 5×5 笔刷的悬停提示改为按落笔的同一套索引范围与边界裁剪逐格描边(1 / 9 / 25 格),奇偶行错位与缩放都按格中心计算,不是简单放大一个菱形。③原「清空」改名「新作」(整图重建、走建图向导、保留首次备份),另加「清空地形」:所有格子回到默认编号与标记,保留地图尺寸、覆盖层、物件、资源库、mask 与过渡对;两者都合并成一条撤销记录。④右键在未拖动时用于删除覆盖 / 物件节点,移动超过 4 像素即锁定为平移,拖回原点或在边界外释放都不删;普通滚轮与 Ctrl+滚轮均以鼠标为锚连续缩放(5%–800%,每帧合并一次),顶部百分比只显示已生效的比例。⑤工具栏「行进 / 放置 / 显示 / 通行1」四个复选框现在勾选即时用隔行条纹菱形标出缺少该位的格子(红=不可行进、蓝=不可放置、青=不可显示、橙棕=不可通行1),与运行时同款条纹;条纹按地图像素烘焙到离屏画布,缩放平移零重烘,绘制期间按格增量维护。
  3. 测试验证每轮都有两套验证:从编译产物取真实函数运行的校验脚本(最高 485,664 条断言,覆盖融合、轮换、笔刷、清空、手势阈值、缩放锚点与上下限、条纹烘焙格集与门控),以及真实浏览器独立页(真实点击与鼠标事件、撤销重做对称复原、保存字节比对、控制台零错误)。通行标记修改经真实宿主保存重开:只有目标格的一个字节变化(0x40→0xC1),地形、覆盖层、物件、资源与备份逐字节不变。五个版本均已安装,需手动重载窗口生效。
  4. 已知限制条纹颜色是本项目自定(原版无参考色);浏览器合成事件验证不等同于原生手感验收;超大地图的条纹烘焙会按比例降到浏览器画布尺寸上限内,属一次性成本。

2026-10-19 · 地图运行时右半缺失修复(引擎 0.5.44)

  1. 目标与背景用户实机反馈地图「只有左边图像,缺失右边」,切口是干净的竖直线;测试人物在不可达域测试里表现正常,说明数据没错、错在显示范围。
  2. 核对结果与实现上一版把等距菱形的屏幕包围盒锚到了存储索引坐标上,而对象按这个矩形裁剪子对象,于是实际绘制宽度的一半被整块裁黑。改为按交错网格的真实绘制范围计算矩形(宽 = 格数×48+25、高 = 格数×12+13),推导来自每格中心的屏幕坐标与地砖缓冲以格心为中心贴画的方式。这个矩形是裁剪、命中判定、相机钳制、子对象剔除、小地图与光照拉伸的共同数据源,一处修正全链路生效。行走此前正常,是因为寻路用世界 / 存储坐标、不经渲染矩形。上一版的菱形公式作废;它当时修好的「下半幅不显示」由新公式同样覆盖,而且不再吞掉左侧一列。
  3. 测试验证先写复现测试钉住失败现象,再修正实现;新增回归测试确保经裁剪后仍满幅绘制。全套 Go 测试通过,编辑器校验脚本 485,664 条断言全绿。实机两套夹具做像素断言:行走场景满幅出图;20×40 地图在旧切口右侧的三个采样点均为地砖色。
  4. 已知限制原版固有的裁剪行为(只罩上半)仍是接受的偏离;超大地图的滚动钳制语义随新矩形变化,属上一版已接受的范围。

2026-10-19 · 地图运行时完整显示、可通行区域判定修复与四种占地标记说明(引擎 0.5.43 + 扩展 0.6.22)

  1. 目标与背景用户用测试地图实机验收时反馈两个现象:同一张地图在编辑器里显示完整,运行时却只渲染出上半截;测试人物能直接走进编辑器里标红的「不可走」区域。另要求说明工具栏「行进 / 放置 / 显示 / 通行1」四种占地标记的定义:地图为每个格子用四个二进制位分别记录——0x80 行进(能否走进该格)、0x40 放置(能否把东西放在上面)、0x10 显示(格子内容是否显示)、0x01 通行1(附加通行档);编辑器里勾选后出现的彩色条纹,标出的恰恰是缺少对应位的格子——红色=不可行进、蓝色=不可放置、青色=不可显示、土黄色=不可通行1,勾选某框无反应即表示全图都不缺该位。
  2. 实现引擎侧修正 bktile 地图的世界矩形:旧矩形按对象矩形裁剪子对象的逻辑只罩住等距菱形的上半部分,超出部分整块丢失,改为覆盖整张菱形(宽 (X+Y)×24+1、高 (X+Y)×12+1,经确认有意偏离旧版行为)。新建地图的默认格子标记对齐旧版编辑器内存默认 0x51(行进+放置+通行1)——此前新格写成 0xD0,运行时寻路把整张地图判为不可走,人物退回无视墙体的直线行走,红色禁区形同虚设;建图向导模板同时补上 pathfinder:=astar() 语句启用 astar 寻路。扩展 0.6.22 配套重建内置 mapdump.exe,编辑器其余行为不变。
  3. 测试验证桌面实机运行 0.5.43 引擎三项验证全部通过:寻路测试地图中人物按 astar 路线绕行、十点像素采样与基线逐点一致;用户测试地图的两座教堂完整渲染、不再齐切上半;41×560 大地图 CPU/GPU 渲染校验逐位一致、无诊断错误。命令行转换工具冒烟通过(新建 12 格地图默认标记全为 0x51),扩展 0.6.22 已安装(重载编辑器窗口生效)。
  4. 已知限制早期用地形刷刷过的格子在磁盘上仍是 fw2 历史约定的 0xD0/0x40 标记,编辑器「显示 / 通行1」条纹会继续点亮这些格子,属数据约定差异而非缺陷;寻路测试桩缺少 Break 事件时不会上报中途坐标,与旧版行为一致。

2026-10-18 · 地形过渡融合回到四共边格,并修复覆盖层缺帧时地图打不开(扩展 0.6.16)

  1. 目标与背景用户验收上一版后带截图反馈:单独画一块菱形地块时,四条边的融合很自然,但菱形对着的四个角显得很突兀。本轮先回到原版编辑器源码核对「单独一个格子时这四个角到底有没有过渡、方向怎样」,再据实修正。
  2. 核对结果原版画下一格地形后只调整与它共用一条边的四个格子——四次调用、四个方向,没有任何针对共顶点(对角)格子的处理;源码里另有一段形状相同的调用,整段躺在注释里,是废弃代码。原因在于每块地砖的四个角各自只描述「跨过某一条边的邻格是什么地形」,14 种过渡样式全部由西/东/北/南四邻查表得出,对角方向根本不存在过渡图案。上一版按等距几何推理硬写对角格,拿到的样式与该方向无关,屏幕上就是一个指向虚空的硬菱形,正是截图里那四个突兀的角。
  3. 实现融合范围收回四个共边邻格,与原版逐次调用对齐。拖拽语义随之回到原版:焦点格移走后,先前那格已是纯色的新地形、四个角里没有旧地形可匹配,天然保持固定,因此一笔之内参与随机轮换的是当前格加它的三个邻格。过渡地砖仍在所属样式的四个变体里按每秒 15 帧轮换,松开鼠标或焦点移开即定稿。
  4. 顺带修复另修一个真实缺陷:当地图的覆盖层动画一帧都读不出来时,转换工具把帧列表导成空值,预览页面直接崩溃,整张地图退化成「地图渲染失败」的错误页;更麻烦的是保存后的预览刷新会静默失效,旧画面留在屏上,看起来像没保存成功。现在空帧列表按零帧覆盖层正常渲染,只有元数据的退化帧不再取图。
  5. 测试验证专用校验脚本重写为四格模型,从编译产物里取出真实融合函数在隔离环境运行,537 条断言全部通过:单独画一格恰好产生四个过渡格、样式依次为 12/6/10/13,四个对角格逐字节未变;拖一格后原格编号固定、只新增三格;同地形零写入;第三种地形不覆盖既有编号;无过渡对时零写入;并用真实语料的角表核对 5 组过渡、每组 14 种样式的位模式与变体形状。独立页面用真实鼠标事件复现:在均质地形区画上一对过渡关系里的第二种地形,四个共边格实测样式为 1/7/3/0,正是直接方样式 12/6/10/13 的镜像(原版「镜像方取 13 减样式」的规则在真页面上复现);对角格保持纯地形;松开鼠标后整幅地图零字节变化;1 倍、4 倍、8 倍放大截图确认四条边融合自然、无硬菱形角。测试脚本自身也做了加固:清掉按路径命名的转储缓存后,同一套端到端测试可反复运行而不再报「源文件已被外部修改」,并新增断言防止错误页被当成正常页面通过——上面那个覆盖层缺陷正是这样暴露出来的。扩展升级至 0.6.16(已安装,重载编辑器窗口生效);引擎与转换工具本轮未改动。
  6. 已知限制对角方向在原版就没有过渡图案,菱形的四个尖角由相邻格子的边方向融合间接收口;若要真正支持对角融合,需要先扩展角信息的语义与地砖库布局,属于格式变更。融合仍是单遍处理,不级联回改更早画好的格子。

2026-10-17 · 地形过渡融合扩到八邻格(扩展 0.6.15,已被 0.6.16 回退)

  1. 本条已作废八邻格模型是几何推理跑在原版源码前面的结果:对角方向并不存在过渡图案,硬写反而在菱形尖角留下突兀的硬角(用户截图实证)。下文保留作过程记录,「八格 / 七格 / 共边先算共顶点后算」等结论一律不再成立,现状见上条 0.6.16。
  2. 目标与背景上一版过渡只处理被画格子共边的四个邻格,实测单独画一块时对角方向仍留硬角。等距菱形地图里每个顶点由四块地砖共用,只刷共边四格等于漏掉了只在顶点相接的四个格子。本轮按用户验收意见把融合范围扩到八个邻格:单独画一块时周围八格全部换成过渡地砖;往旁边拖一格后只有七格参与,先前画好的那格保持固定。
  3. 实现每块地砖的四个角对应四个象限,每个象限显示跨过那条边的邻格地形,因此过渡方向可以逐格精确判定。融合顺序是先算共边四格、再算共顶点四格——后者要读前者刚写好的角信息才能看见新地形,顺序颠倒会什么都刷不出来。过渡地砖与笔刷地砖一样,在所属样式的四个变体里按每秒十五帧随机切换,直到焦点格移开或松开鼠标才定稿;同一样式的四个变体形状完全相同,随机切换不会改变融合轮廓。
  4. 测试验证新增专用校验脚本,从编译产物里取出真实融合函数在隔离环境跑合成地砖库,五百四十四条断言全部通过:单独绘制八格且每格过渡方向与期望象限完全一致、拖拽后七格且原格地砖编号不变、同地形零写入、第三种地形不被覆盖、无过渡对时零写入,并用真实语料的角表核对每组过渡十四种样式的变体形状与位模式。独立页面用真实鼠标事件复现整条交互:按下八格、拖动七格且原格冻结、按住期间过渡格持续翻动而样式不漂移、松开后整幅地图零字节变化;放大八倍截图确认融合边平滑无硬角。桌面实机运行引擎,地图正常启动、渲染校验逐位一致。扩展升级至 0.6.15(已安装,重载编辑器窗口生效);引擎与转换工具本轮未改动。
  5. 已知限制融合仍是单遍处理、不级联回改更早画好的格子:先画一片再回头补边时,早先的过渡不会自动更新。因资源被移除而显示为纯黑的格子仍会参与过渡配对。

2026-10-17 · 地形过渡融合:mask 图可选、过渡对可管理(扩展 0.6.14 + 引擎 0.5.42)

  1. 目标与背景此前在地图上刷地形,格子之间是硬拼的:草地旁边直接接泥土,边界一条直线,看上去像贴图而不像地形。原版编辑器用一张 mask 过渡图把两种地形在边界处互相咬合,本轮把这套机制完整搬进地图编辑器——画上的地形如果和邻格不同、且两者登记为一对过渡关系,周围四个格子会自动换成融合地砖。同时修掉两个手感问题:新加地形资源后列表图例多半是黑的,以及按住鼠标拖拽时已经离开笔刷的格子还在闪。
  2. 实现地图转换工具按地砖编号导出每块地砖四个角所属的地形,以及每组过渡关系在地砖库中的位置与前后顺序;预览页面据此复刻原版的融合规则:按「西/东/北/南是否与目标地形同类」四种组合查出一共 14 种过渡样式,镜像方向取反,再从该样式的 4 个随机变体里挑一块换上。相同地形只替换自身,不会波及邻格;因资源被移除而显示为纯黑的格子按「无地形」处理,不会把过渡拉进空洞。地形库的「编辑」面板新增两处:一是 mask 图下拉,自动扫描地形资源目录与地图目录下所有以 mask 命名的图片,首项为「不使用过渡」,选中后写回脚本;硬边 mask 只用两种地形原色、过渡锐利,柔边 mask 会生成中间色、过渡自然。二是过渡对列表,两列下拉选择地形后增删,按顺序写回脚本——顺序决定每组占用的地砖槽位,前者为直接方、后者为镜像方;重复对、同地形对、缺一侧、未选 mask 都会就地报错而不改动文件。
  3. 测试验证引擎与转换工具全套 Go 测试通过,扩展编译通过。模拟编辑器环境的端到端测试做了三轮往返:基线地图带 5 组过渡与一张柔边 mask;第一轮换成硬边 mask 并把最后一对过渡的前后地形调换,写回后新组的位置与角信息符合预期,地砖图集随之改变;第二轮还原,角表与图集与基线逐字节相同;第三轮清空 mask 与全部过渡对,地砖数从 756 降到 476,导出清单不再声明过渡信息,残留的角表文件被删除。另做资源编辑回归,覆盖移除地形标黑、覆盖层与物件语句删除、备份保留与只读属性处理。像素级探针确认每组过渡的 56 块地砖全部同时含两种地形色,换 mask 时基础地形砖完全不变、过渡砖全部改变,中间色数量在柔边 mask 下为 8 种、硬边 mask 下为 0 种。桌面实机运行 0.5.42 引擎,地图正常启动,CPU/GPU 渲染校验逐帧逐位一致。扩展升级至 0.6.14(已安装,重载编辑器窗口生效)。
  4. 已知限制过渡对按位置绑定地砖槽位,删掉中间一组会使其后各组前移,需要整体重建地砖库(编辑器确认后自动重新转储)。本版一次绘制只融合被画格子周围共边的四格,与原版一致(0.6.15 曾试扩为八邻格,因对角方向没有过渡图案、实机留下硬角,0.6.16 已回退,见上两条);不会级联回改更早画好的格子,所以先画一片再回头补边时,早先的过渡不会自动更新。mask 图候选按文件名前缀 mask 匹配,其他命名的过渡图不会出现在下拉里。

2026-10-17 · 地形图集按行展开、真实地砖绘制与按住轮换(扩展 0.6.13 + 引擎 0.5.41)

  1. 目标与背景地图编辑器此前的笔刷一次只使用地形图里的第一个 48×25 小块,且画过的格子会盖着一层橙色标记,看不到实际地形;新加入的地形图如果横向排了多个变体,也不会出现在地形列表中。本轮让一张地形图按 25 像素高的每条横带自动生成一个地形条目(每条最多 4 个变体),绘制时按住鼠标期间整条笔画在地形变体之间以 15fps 随机切换,松开才定稿;画过的格子直接显示真实地砖。
  2. 实现资源写回工具按图片实际宽高计算每条横带的变体数与行数,为每个缺失的行补一条地形定义(名称自动递增去重),重复应用只补缺行;旧版本写入的单变体定义会把末尾数量改成图集列数,其余字节不动。地图转换工具新增全量地砖图集导出(按地砖编号排列,含全部变体),预览页面据此按编号取图。编辑时不再绘制橙色待保存标记和悬停填充,悬停只留菱形描边且在按住时隐藏;按住左键起笔后,每个触及的格子先随机取一个变体,随后每 67 毫秒重新随机整条笔画的所有格子,松开、失焦或取消时停止并保留最终结果,整条笔画仍只产生一条撤销记录。
  3. 测试验证引擎与转换工具全套 Go 测试通过,扩展编译通过。命令行往返验证:重设地形资源后按行生成 14 条新定义并使原有首行扩为 4 变体,转储得到 16 个地形条目、64 块地砖与 784×100 的全量图集;页面交互验证连续绘制 5 格时地砖编号在多次采样间持续变化,松开后编号冻结、撤销记录为 1 条,保存写回后的地砖编号与定稿完全一致。桌面实机运行 0.5.41 引擎,示例脚本与地图均正常启动,CPU/GPU 渲染校验逐帧逐位一致。扩展升级至 0.6.13(已安装,重载编辑器窗口生效)。
  4. 已知限制地形列表缩略图固定取每行第一个变体,以保证重新转储后封面稳定;按住时的轮换由 67 毫秒定时器驱动,与显示器刷新率无关;资源移除仍保留地形定义槽位,对应图块显示为纯黑。

2026-10-17 · 地图编辑器:资源库路径编辑、清空重建、文本切换(扩展 0.6.12 + 引擎 0.5.40)

  1. 目标与背景地图里引用的地形库、覆盖帧和物件精灵过去只能通过手改脚本调整。本轮把资源管理搬进编辑器面板:三个资源库各自可以查看并增删路径;另加「清空」回到空文件建图向导,以及「文本 / 编辑」在脚本与地图界面之间一键切换。
  2. 实现地形库、覆盖帧、物件库面板右上角新增「编辑」,弹出路径列表:逐条移除,或输入新路径添加(自动去空白、去重,覆盖帧限制一条来源)。确认后作为资源补丁随保存写回——地形移除保留原 addkind 槽位(地砖编号按位置绑定),预览中该地形填黑、图例以红框标注「已移除」;覆盖帧移除会删掉整层来源与节点数据;物件路径移除会删除所有引用该精灵的放置语句。所有改动以文件末尾的元数据注释记录,保存仍走哈希守卫、自动备份与临时文件事务。「清空」确认后先备份原文件,再把源文件截断为零字节并清除转储缓存,回到建图向导;截断与重新建图都会临时解除并恢复只读属性,兼容语料中常见的只读地图。「文本」按钮切到文本编辑器,文本编辑器标题栏的「编辑地图」命令切回地图界面,有未保存编辑时先确认。
  3. 测试验证引擎与转换工具全套 Go 测试通过,扩展编译通过。模拟编辑器环境的端到端测试覆盖:文本方式打开、三层资源移除与地形恢复、清空后按原格数重建、只读属性保留、原文件备份内容、末尾元数据;页面交互测试覆盖三个对话框的增删去重、脏状态确认、被移除地形的黑格与红色图例。桌面实机冒烟日志版本 0.5.40,CPU/GPU 渲染校验逐帧逐位一致。扩展升级至 0.6.12(已安装,重载编辑器窗口生效)。
  4. 已知限制地形移除不删除 addkind 定义,只从生效列表摘除并标黑;覆盖层最多一个来源;移除物件路径会删掉该精灵的全部放置语句;清空只保留首次原文件的备份。

2026-10-17 · 空地图文件可从零建图:wholemap / tilemap 向导(扩展 0.6.11)

  1. 目标与背景此前打开一张空的 .fcm 只会得到「不是受支持的地图」提示,想单独测试地图功能必须手写脚本或复制旧地图再改。本轮让空文件直接进入建图向导:选择整图族(wholemap)或瓦片族(tilemap),设定尺寸、格子大小与可选资源路径,一键生成结构完整、可预览可运行的地图,便于从零搭建和单独针对地图做测试。
  2. 实现转换工具新增建图命令:瓦片族按格数生成地图类体,写入地砖尺寸、黑色地形变体、建库清单与压缩后的逐格索引,并生成每格 3 字节的地砖数据文件;整图族按总宽高、格宽高与可选逐格图片格式生成 init 声明。由于系统脚本里的地图基类会在生成类体之后再次赋值整图资源,生成器还会在地图实例体中补一次资源绑定,确保最终生效。资源路径留空时优先复用地图目录下已有的纯黑贴图,没有才自动生成一张并引用;目标文件非空时拒绝覆盖。空文件探测新增「empty」标记,编辑器据此渲染向导弹窗,参数在页面与服务端各校验一次,创建成功后自动重新载入并切换到正常编辑界面。
  3. 测试验证转换工具单元测试与全套回归通过。模拟编辑器环境的端到端测试覆盖:向导页渲染、非法参数拒绝、两种地图族生成后的类体与数据文件、BOM/纯空白文件识别、空 .fcm 正确打开为地图编辑器、非空文件拒绝覆盖。用户提供的空测试地图在两种模式下均生成成功,测试后已恢复为空文件。桌面实机分别运行两张生成图:整图族 48 万像素中 475709 点为纯黑,瓦片族 474403 点为纯黑,中心与采样点全部为 (0,0,0),运行日志零错误。扩展升级至 0.6.11(已安装,重载编辑器窗口生效)。
  4. 已知限制整图族的格网按总宽高除以格宽高向下取整,尺寸不能整除时余量不参与格网;空文件判定只覆盖零字节与纯空白/BOM,含注释但没有地图类体的文件仍按不支持处理。

2026-10-17 · 修复协作阴影 ALE 预览的一圈黑影(扩展 0.6.10 + 引擎 0.5.39)

  1. 问题与背景地图素材 coop_shadows.ale 在 ALE 预览里,阴影块边缘出现一圈明显的深色描边,与中间平滑的半透明渐变对不上。
  2. 实现该文件实际是 AEX 容器(alphatrue,33 帧)。原引擎加载时会识别「半透明且足够暗」的像素,把它们标记为自动阴影点,渲染时对背景做精确 50% 变暗;旧解码器把这个标记当成普通透明度输出,结果在渐变里挖出一圈近乎透明的缝隙。现在解码器直接把阴影点烘焙成 50% 黑(纯黑、alpha 128),并忽略源像素颜色——与桌面引擎的渲染结果逐像素等价。
  3. 测试验证新增解码单元测试覆盖阴影点重映射,全套 Go 测试通过。重新导出 33 帧后黑圈消失,4 倍棋盘格合成显示平滑阴影。桌面实机把测试地图的覆盖层换成该文件直跑:日志零错误、渲染校验逐位一致,截图中的协作阴影为连续灰块,无深色描边圈。
  4. 已知限制ALE 预览与运行时共用同一解码器,因此该修复同时作用于预览和地图覆盖层;已安装扩展的用户需重载编辑器窗口后生效。

2026-10-17 · 地图编辑器支持整图族地图:预览与物件编辑全链路(扩展 0.6.9 + 引擎 0.5.38)

  1. 目标与背景上一轮让整图族(wholemap)地图在桌面引擎里跑通,但编辑器对它仍然「不认」:转换阶段直接报不支持。本轮把这类地图接入地图编辑器——能生成完整整图预览,也能像普通地图一样移动、删除、新增装饰物件并写回脚本,使整图族地图获得与瓦片地图同等的编辑能力。
  2. 实现转换工具按地图类的直接基类判定族别:瓦片地图走原有瓦片管线,整图族走新管线。整图族的探测会严格校验 init 声明(总宽高、格宽高、图片命名格式串、格网至少一格),校验规则与引擎运行时同源——探测通过即引擎也能加载。预览按声明的像素尺寸渲染整张地砖层(整图切片 + 逐格房间图片),大图按整数比例降采样、分条带渲染以控制内存。装饰物件按整图族的参数顺序(x、y 在前,后接图源、层号、播放间隔、类名、扩展脚本)解析成可编辑节点:移动只改坐标两个数字、其余字符原样保留;删除折掉整行;新增按整图族格式追加在物件区末尾(没有数据块时锚定到最后一条地图参数语句),写完重新扫描自检,不符即不落盘。转换清单格式升级到第 5 版并新增「地图族」字段:整图族不再输出瓦片库、逐格数据与覆盖层,物件层照常导出;写回时明确拒绝整图族的地砖与覆盖层补丁,物件补丁照常生效,源文件哈希守卫与自动备份不变。
  3. 测试验证引擎与转换工具新增 13 项测试全绿(整图族 init 解析、族判定、离线构建、预览渲染、物件投影、移动写回、无数据块插入锚点、真实语料投影与写回;转换工具的整图族探测、转换、物件写回、拒绝地砖/覆盖补丁),全套回归通过。三张真实语料地图转换成功,预览均为 1:1(832×640、2432×1808、3600×2000)。自动化浏览器加载独立测试页:元信息正确显示整图族与格网尺寸,鼠标悬停按矩形格命中并显示「整图族格(无逐格 ID)」,命中框四角有描边(证明是矩形而非瓦片地图的菱形),铅笔、橡皮、地形、通行、吸管、覆盖六个工具与两个面板开关被正确禁用,物件库列出 4 个精灵、6 个物件且物件画笔可用。桌面实机直接运行三张地图:运行日志零错误、渲染校验逐位一致;截图与离线预览做偏移搜索与点探针——家具店在最佳偏移处 8 个区块平均绝对差为 0,6 个采样点中 5 个逐像素相等(另 1 个为动态元素);两张对战地图在最佳偏移处 8 个区块与 6 个采样点全部逐像素相等。引擎升级至 0.5.38,转换工具同步重建并与扩展内置副本一致;扩展升级至 0.6.9(已安装,重载编辑器窗口生效)。
  4. 已知限制整图族地图没有逐格地砖 ID 与覆盖层,编辑器对它只开放「选择」与「物件」两支工具,地形/通行/覆盖编辑不适用。预览只含地砖层,水面与动画、物件层均由编辑器页面另行叠加或暂不显示。整图族每格的遮挡图与画刷图仍未移植(沿用上一轮边界)。

2026-10-17 · 整图族(wholemap)地图现在能正常运行:补齐 init / src 参数与逐格背景图(引擎 0.5.37)

  1. 目标与背景用真实语料的整图族地图(家具店 furnitureshop.fcm)做实测时发现:这类地图在 Go 重写版里只渲染出一帧纯黑画面。整图族地图不用瓦片库铺地,而是在脚本里声明整张地图的像素尺寸、每格尺寸与一套「逐格图片」命名规则,引擎按格加载对应的房间图片拼出整个场景;同时可以给一张整图作为底图。Go 版此前没有实现这两个参数,地图格数停留在 0,绘制直接提前返回,于是全黑。旧测试脚本用的是另一条自带默认格网的基类路径,恰好掩盖了这个缺陷。
  2. 实现按旧版 C++ 语义补齐地图对象的两个参数:init 接收「总宽、总高、格宽、格高、图片命名格式串」五项(数组元素个数与类型校验对齐原版的格式扫描规则——数值槽接受整数或小数并向下取整、格式串必须是字符串,缺项或类型不符即报错;格宽高小于 1 一并挡下),src 接收整张底图路径。绘制时逐格物化背景:先按整图比例切出该格对应的区域,再查找该格自己的图片(命名规则按「行优先、序号从 1 开始」展开)并以 1:1 贴到格内左上角,图片比格子小则只覆盖对应部分、其余保留底图切片;两者都没有的格子画统一的占位色而不是留黑。每格的图片数据与显存纹理各自缓存,缺失的文件只探测一次,重复绘制不再读盘。
  3. 测试验证新增 6 项单元测试全绿:init 正例(格网尺寸、格宽高、地图矩形、命名格式、遮挡与通行数据一并核对)、六条非法 init 拒绝路径与小数截断、src 参数、逐格图片加载(钉死「行优先、从 1 开始」的文件名展开顺序,并覆盖整图切片被格图全覆盖、缓存命中不重复加载、格图小于瓦片时的裁剪贴合、缺格图时保留底图切片、整图与格图都缺时返回空且只探测一次、换 src 后按新命名规则取图)、绘制层逐格出图与越界行为,以及「只有 init、没有任何图片时画占位色」这条黑屏回归护栏。另有一条端到端测试:临时目录写入三张真实 JPEG(第四格故意缺)后用整图族脚本类跑完整管线,断言三个格子的画面像素贴近各自的 JPEG 颜色、缺图格子的画面与整图对应区域逐像素相等。全套回归通过。引擎升级至 0.5.37,桌面实机直接运行语料的家具店地图:黑帧变为完整的店内场景,运行日志零错误、渲染校验逐位一致;把该地图 130 张逐格图片合成为一张 832×640 的参照底图后与截图做视口偏移搜索比对,最佳偏移处 9126 个非黑采样点中 8394 个逐像素吻合(92%),其余差异来自人物、NPC 与光晕;再用点探针与「去掉全部装饰物件」的对照运行确认物件层与人物确实绘制在场景之上。
  4. 已知限制整图族每格还可以配一张同名的遮挡图(让物件走到家具后面时被遮住),本轮未移植;画刷图(brushimg)同样未移植。加载策略与原版有偏差:原版用后台线程分阶段异步加载,Go 版改为同步加载加缓存,最终状态一致,代价是首次进入大地图时可能有一帧卡顿。地图编辑器暂不支持整图族地图的转换与编辑(探测阶段即报错),留作后续轮次。语料中该家具店的房间图片本身已把家具画进背景,装饰物件重画一遍在视觉上看不出差别,属语料特性。

2026-10-17 · 地图编辑器物件层工具:放置 / 拖动 / 删除装饰物件(扩展 0.6.8 + 引擎 0.5.36)

  1. 目标与背景地图编辑器第三支画笔。bktile 地图的装饰物件(房屋、路灯、招牌等)是地图脚本类体里一行一条的 AddImg / AddImgEx 语句:每条记录精灵文件、地图坐标、层号、播放间隔、可选类名与提示文本,引擎在加载地图时逐条创建对象并按「层号+坐标」公式排定前后遮挡。此前编辑器只能整体预览这些物件、改一个位置就得手工编辑脚本文本。本轮语义对齐旧版 C++ MapEdit 的 OBJ_EDIT:命中判定用精灵首帧矩形加不透明像素探针(透明区域不挡点击),并按遮挡顺序令最上层者先命中。
  2. 实现地图编辑器新增「物件」画笔与右侧「物件库」面板:面板列出该地图已用到的全部精灵(缩略图 + 尺寸 + 使用次数),点选后左键在地图上放置物件(新语句的层号、播放间隔、类名、提示文本自动沿用该精灵在本地图的首次用法)、按住拖动移动(带抓取偏移)、右键删除命中的物件;「显示物件」开关可整层隐藏以便查看地砖,悬停显示物件信息。物件不烘进预览底图,而由编辑器页面在独立图层上自行绘制,因此拖动即时可见、无需等待重新转换。保存时按「移动 / 删除 / 新增」三种操作逐条写回脚本:移动只改坐标数字本身,未触及的语句逐字节保留原有格式与字段;删除折掉整行;新增按编辑器格式追加到物件区末尾;写完重新扫描自检,结果与请求不符即报错不落盘,沿用源文件哈希冲突守卫与自动备份。物件笔画与地砖、覆盖层编辑共用同一撤销/重做栈与保存门控。
  3. 测试验证引擎侧新增 8 项测试全绿(语句投影、移动、删除+新增、空补丁、地图无物件时的插入位置、四类非法补丁拒绝、真实语料地图的投影与写回),全套回归通过。自动化浏览器实操独立测试页:命中与悬停、拖动偏移、右键删除、放置继承默认参数、撤销/重做逐笔回放、保存请求在「有物件改动」时携带操作表而「无改动」时不触碰该层、转换失败时整层丢弃并禁用工具(防止按过期序号误拖)。命令行写回工具对真实语料地图(360 个物件)同批应用「移动一个 + 删除一个 + 新增一个」:回读逐字节比对——恰好三行变化、其余全部字节(含地砖数据块)完全未动,重新转换往返一致;源文件哈希冲突、坐标越界、序号越界、自相矛盾的操作四条失败路径下源文件分毫未动。引擎升级至 0.5.36(DLL 与命令行转换工具同步重建),桌面实机直接运行编辑后的地图:脚本正常启动、渲染逐位一致、截图确认物件层出图。扩展升级至 0.6.8(已安装,重载编辑器窗口生效)。
  4. 已知限制物件库目前只列出该地图已用到的精灵,尚未提供从地图资源库全量浏览选取——因此一张没有物件的地图还无法凭空放下第一个物件(后续轮次候选)。整图族(wholemap)地图的 AddImg 物件参数顺序不同,本轮只列出、不参与编辑(原样保留)。对齐 C++ 原版的取舍沿用覆盖层一轮:右键删除命中节点(C++ 是删除当前激活节点,右键更直接)。

2026-10-17 · wholemap 族地图 AddImg 运行时补齐(引擎 0.5.35)

  1. 目标与背景fw2 语料的 wholemap 族地图(整图背图模式)在类体和实例上调用 AddImg(x,y,src,层,播放间隔,类名,扩展脚本) 往地图上铺装饰物件;Go 重写版此前只有 bktile 族的同名方法(参数顺序与坐标含义都不同),wholemap 族调用全部落空。这是上一轮已预告的「物件层编辑器工具」的前置补账:先把运行时补齐,编辑器工具才有对象可画。
  2. 实现C++ 参考实现里这是两个同名方法:bktile 族 src 在前、按块内坐标、自动层序;wholemap 族 x,y 在前、按地图绝对坐标、层序由「层号+坐标」公式算出(无自动层序)。Go 版按接收者类型在同名入口内分派,两族语义各自完整移植:整图族含 7 参数签名与缺省值(多余参数忽略、在场类型错误报错)、整调重入门控、类名创建(脚本类优先、失败兜底内建 img 类)、位置/图源/层序/播放间隔写入、扩展脚本迷你解析(赋值语句与函数调用两种形态,含引号内逗号、花括号嵌套等取词规则);编辑器专用的 modi 分支(强制物件类)一并移植。
  3. 测试验证新增 12 项单元/集成测试全绿(全参数/缺省/门控/错误参数/参数面往返/脚本类创建与兜底/扩展脚本三种形态/非字面量值的 C++ 级联行为/分派器双向),全套回归通过。引擎版本号升级至 0.5.35,DLL 重建后桌面实机跑 wholemap 族脚本:日志零错误,截图逐像素复核——两张纯色夹具图在地图坐标 (64,64) 与 (300,200) 处的显示位置、尺寸与颜色完全吻合(其中一张经脚本类 + 扩展脚本路径创建,证明类解析与扩展脚本赋值在真管线上同样生效)。
  4. 已知限制本轮只补运行时,不含编辑器工具——物件层(AddImg)的地图编辑器工具是后续轮次。fw2 语料中没有任何脚本使用编辑器专用的 modi 分支,该分支按 C++ 原样移植但仅单测覆盖。

2026-10-17 · 地图编辑器覆盖层工具:放置 / 拖动 / 删除覆盖节点(扩展 0.6.7)

  1. 目标与背景继续完善 bktile 地图编辑器,本轮做覆盖层(Sur)工具——对齐旧版 C++ MapEdit 的 SUR_EDIT 语义。覆盖层是地图上一组「精灵引用节点」:每个节点记录坐标(x, y)与动画帧号(no),指向 oversrc 指定的 ALE 动画里的一帧,由引擎叠加绘制在地砖与地形之上(树、石像、火把等摆件多在此层)。磁盘格式为 5 字节定长记录(两个 int16 坐标 + 一个 byte 帧号),此前编辑器只能整体预览、不能改。
  2. 实现地图编辑器新增「覆盖」画笔与右侧「覆盖帧」面板:列出 oversrc 动画的全部帧(合成缩略图 + 尺寸 @ 锚点偏移),点选帧后左键在地图上放置节点、按住拖动移动节点、右键删除命中的节点(最后绘制的节点优先命中,与 C++ 拾取顺序一致);编辑中的节点以半透明精灵加青色锚点直接画在预览上,被移动/删除节点的旧影保留到保存后重转——与地砖编辑的橙色标记同一套「先本地、保存生效」契约。覆盖层笔画与地砖编辑共用同一撤销/重做栈与保存门控;保存时整组节点一次性写回地图文件的 overdata 语句(空数组=删除该层、原本没有则在数据末尾插入),沿用源文件哈希冲突守卫与自动备份。
  3. 测试验证自动化浏览器实操独立测试页 26 项断言全部通过:17 帧面板齐全、点选切覆盖工具、放置节点坐标精确(±1 像素内)、拖动 +100 显示像素后坐标精确平移、右键删除、撤销/重做逐笔回放、保存请求在「有覆盖改动」时携带整组节点、「全部撤销后」正确回归不改动。命令行写回工具对真实语料地图应用「移动一个节点」补丁:回读逐字节比对——恰好一个字节变化(该节点 x 坐标 260→267)、地砖数据完全未动、备份正确。桌面实机直接运行编辑后的地图文件:脚本正常启动、零错误、渲染逐位一致。扩展升级至 0.6.7(已安装,重载编辑器窗口生效);引擎本次零改动(版本保持 0.5.34)。
  4. 已知限制对齐 C++ 原版的取舍:右键删除命中节点(C++ 是删除当前激活节点,右键更直接);覆盖帧面板不显示帧动画播放(缩略图足够选型,需要看动画可用 ALE 预览)。后续轮次计划做物件层(AddImg)工具——需要先把引擎的 wholemap 族 map::AddImg 运行时补齐。

2026-10-16 · 地图编辑器地形层绘制工具(扩展 0.6.6)

  1. 目标与背景继续完善 bktile 地图编辑器,本轮先做地形层绘制工具——对齐旧版 C++ MapEdit 的 KDF_EDIT 语义:右键刷地形时在 4 连块内随机取变体图、通行标志随地形可行走性整格重写。随机变体现按面板所选 kind(地形种类)自己的变体区间取随机数;通行标志全量写 0xD0(可行走)/ 0x40(阻挡),与磁盘上全部 fw2 语料地图的主导值一致(0x01 由引擎加载时自动补、0x02 仅为旧编辑器内部使用)。
  2. 实现地图编辑器新增「地形」画笔与右侧「地形库」面板:列出地图 .tle 库的全部地形种类(缩略图 + 图块 id 区间 + 可行走性红点/绿点标记),点选即用左键刷地形——每格自动随机该种类的一款变体图,通行标志随种类可行走性整格重写;与铅笔/橡皮一样支持 1×1/3×3/5×5 笔刷、拖动连续笔画、撤销重做与保存写回。配套地图转换工具升级(额外导出地形库元数据与拼图),旧缓存自动失效重转储。顺带:吸管取样到某地形时自动选中该种类、格悬停读数附地形名。
  3. 测试验证自动化浏览器实操独立测试页:7 个地形种类面板齐全、点选即切地形刷(状态栏提示 id 区间与随机变体语义)、画格正确上报编辑、撤销/重做回环、吸管自动选中、悬停显示地形名。命令行转换工具对 9 格(土0 变体 + 可行走标志)写回后字节级回读全对、与原图逐格比对仅该 9 格变化。桌面实机直接运行编辑后的地图文件:资源加载零错误、渲染校验逐位一致、截图正常。扩展升级至 0.6.6(已安装,重载编辑器窗口生效);引擎本次零改动(版本保持 0.5.34)。
  4. 已知限制对齐 C++ 原版:刷地形不自动重算边界过渡块、也不提供矩形/洪泛填充;需要时用 3×3/5×5 笔刷手工铺。后续轮次计划做覆盖层与物件层工具。

2026-10-16 · 真彩 ALE 动画(kind=3)解码支持,修复 blood.ale 打不开(引擎 0.5.34)

  1. 目标与背景用编辑器打开 fw2 语料里的 blood.ale(打雪仗界面受击血光动画)报错打不开。排查发现它属于 ALE 容器里的 kind=3「真彩」族——颜色不做成调色板、而是以 16 位 RGB565 色字内联在压缩数据里;Go 重写版此前只实现了 kind=1(调色板)解码,遇到 kind=3 直接报不支持。语料普查 kind=3 共有 902 个文件(占真 ALE 的 29%),不是孤例。
  2. 实现对照 C++ 参考实现(FDraw_AleRGB.cpp)补齐真彩路径:行/块压缩结构与调色板版相同,literal 块改为读取内联 RGB565 色字;阴影、单点半透明、链式半透明等块类型逐一移植(半透明强度 = 块头低 5 位 × 8)。引擎侧加载该格式的动画资源自动走新路径,渲染层零改动;编辑器预览对真彩文件自动隐藏调色板栏(该格式本就没有调色板),帧网格/播放/帧脚本编辑照常。
  3. 健壮性顺带修复一个隐患:个别早期文件的帧头宽高是负数或零(一个极端样本宽 -123 万),旧逻辑会按此申请内存直接崩溃;现对非法尺寸的帧改用 1×1 全透明占位帧,帧序号不漂移,行为与 C++ 参考实现一致(画不出内容但不受影响)。
  4. 测试验证新增合成样本单测(纯色/阴影/单点半透明/链式半透明全路径,含「565 色不做位复制」的逐通道断言),全套回归 12 包全绿;fw2 全部 3,113 个 ALE 文件扫描零失败(调色板族 2211 + 真彩族 902)。编辑器独立测试页 10 帧全部正常渲染、元信息正确。桌面实机用脚本直接加载 blood.ale:对象尺寸 83×16 与离线导出完全一致,截图像素采样复核——不透明像素与源逐位相等、半透明像素按 alpha 合成桌面底色后的结果与理论值完全一致。引擎版本号升级至 0.5.34。

2026-10-16 · 动画与地图编辑器默认按 1:1 实际像素显示(扩展 0.6.4)

  1. 目标与背景用编辑器打开 .ale 动画或 .fcc/.fcm 地图时,初始显示比例此前一个是默认放大 4 倍、一个默认缩放到适应窗口——想核对单帧像素或地图细部时总要多点一次「1:1」。现按用户要求,两类编辑器打开即按 100% 实际像素显示。
  2. 实现纯编辑器调整、引擎零改动:动画预览初始缩放由 4x 改为 1x;地图编辑器首帧加载由「适应窗口」改为 1:1,且窗口尺寸变化时保持 1:1 不再自动重缩(工具栏「适应窗口」按钮仍可随时一键适配)。缩放加减、1:1 按钮等行为不变。
  3. 测试验证TypeScript 编译通过;真实数据烹饪页面语法检查(动画 56 帧、地图 41×560 格)双双通过;自动化浏览器实操核对——地图编辑器缩放指示 100%、画面尺寸与离线渲染原图逐像素一致(旧行为约缩到 24%),动画首帧显示尺寸等于原始像素 26×40、56 个帧缩略图齐全、页面无任何脚本错误。扩展升级至 0.6.4(已安装,重载编辑器窗口生效)。
  4. 已知限制大地图在 1:1 下超出视口,需用滚动条/拖拽平移查看全貌;缩略概览可按「适应窗口」。

2026-10-16 · 地图动画对象播放提速(引擎 0.5.33)

  1. 目标与背景地图上以 AddImgEx 放置的动画物件(灯柱光晕等)此前播放明显偏慢。脚本里给这些物件设置的播放间隔数值(91/100/121 毫秒)在 C++ 参考实现中是真实毫秒——即原设计约 8~11 帧/秒的呼吸闪烁节奏。
  2. 根因与修复Go 重写版把该间隔误当成「更新次数」来计数——每 25 毫秒才加 1,于是 100 毫秒实际要等约 2.5 秒才播下一帧(0.4 帧/秒),比原设计慢 25 倍。已对照 C++ 参考实现(FObjImg.cpp:347-355)修正为毫秒语义:以真实运行毫秒数为基准,到达间隔即推进帧并回卷。角色动画(Human)走的本就是同款毫秒语义、不受影响;地图覆盖层逐节点画固定帧,本就静态。
  3. 测试验证相关单元测试改写通过(直接操纵运行毫秒数断言 进帧/不进帧/回卷 三态),全套回归全绿。桌面实机连拍 7 张截图比对:每间隔 700 毫秒的一对画面均有上万像素差异,且全部集中在灯柱光晕动画带——相机与其余画面逐像素不动,证实差异纯来自动画按新节奏推进(按旧慢速行为三对连续命中变化的概率仅约 2%)。引擎版本号升级至 0.5.33。
  4. 已知限制同日应用户要求,全部语料地图(525 个 .fcc + 1 个 .fcm,共 26,063 个动画物件)的播放间隔已统一改为 67 毫秒(恰 15 帧/秒,含原慢速氛围效果一并提速),改前原件逐文件备份;引擎自身不做统一改写,新建地图想精确 15 帧/秒仍把脚本播放间隔设为 67 毫秒。

2026-10-16 · 修复地图窗口右上角小地图全红(引擎 0.5.32)

  1. 目标与背景运行地图时右上角的小地图面板此前总是显示成一条红色占位块。按资源约定,每张地图自己的小地图缩略图应放在地图目录的 smap 子目录下(以地图名命名);引擎会优先加载这张专属缩略图,没有时才退回绘制示意草图。
  2. 根因与修复缩略图查找链路本身工作正常,真正的问题出在图像装配环节:无透明通道的纯色缩略图(如 jpg)被误当作「以左上角颜色为透明色」处理,整张图变成全透明,面板于是露出底下的红色占位条。已对照 C++ 参考实现修正——没有显式透明指令时,这类图像按不透明帧装配;仅当图像确实带透明通道时才保留其透明信息。顺带修正了一处被旧行为掩盖的测试用例像素假设(该用例的位图左上角实为蓝色而非白色)。
  3. 测试验证相关单元测试与整链路测试通过,全套 12 个包测试全绿。桌面实机运行真实项目地图 1+1.fcm 并截图核对:小地图区域显示的是 smap 目录里该地图自己的缩略图色调(深色蓝绿),不再是红色占位条;系统冒烟脚本的草图小地图回归正常,未受修复影响。引擎版本号升级至 0.5.32。
  4. 已知限制缩略图绘制在小地图面板左上角而非几何居中——这与 C++ 参考实现的调用顺序一致,属忠实行为。

2026-10-16 · 同名类的后定义覆盖替换 + 编辑器地图「▶ 运行」按钮(引擎 0.5.31 + 扩展 0.6.3)

  1. 目标与背景脚本中后定义的同名类现在会直接覆盖替换之前的定义、不再报重复定义错误(与 C++ 参考实现一致),并在运行时提示里输出一行替换记录。这解决了一个实际困扰:地图文件重定义系统脚本里的地图类后,按地图类实例化出的地图对象此前仍显示系统自带的旧地图,现在会正确显示地图文件自己的画面。
  2. 实现同名类替换静默生效,运行时提示给出「脚本类 X 替换同名内建类」或「class X 被新的同名类替换」一行记录(可点击跳转源码位置)。连同「多跳基类链」解析一起落地:子类先找到链条最底部的基类再逐层执行,实例化时会先执行基类脚本、再执行子类脚本,层级再深也正确(含防环保护)。编辑器地图窗口新增「▶ 运行」按钮——写完地图直接在引擎窗口里跑起来检查行走可达域与遮挡,有未保存编辑时会弹窗提醒。
  3. 测试验证新增单元测试覆盖基类链解析(多跳 / 防环 / 执行顺序)与三个整链路场景:地图文件重定义系统地图类后实例化显示新地图、同名类两次定义只保留最新一次、显式基类兜底。全套测试通过。桌面实机直接运行真实项目地图 1+1.fcm——运行时正确输出「脚本类 usermap 替换同名内建类」一行、无任何错误;截图核对显示的是该地图自己的石砖场景(火把灯柱、石像摆件)而非系统默认地图,逐点采样颜色特征也证实与系统地图完全不同。扩展「▶ 运行」按钮在自动化环境完成整链路验证(消息 → 启动引擎 → 完整运行日志输出)。引擎版本号升级至 0.5.31,扩展升级至 0.6.3(已安装)。
  4. 已知限制扩展升级后需重载编辑器窗口生效。「替换同名内建类」的文字仅在覆盖引擎内建类名时出现;覆盖脚本里其他同名类时显示另一条文案。显式基类写法仅在主名类不存在时兜底,与 C++ 参考实现一致。

2026-10-16 · 地图文件新增 .fcm 扩展名与编辑器「另存为」(扩展 0.6.2)

  1. 目标与背景地图文件此前与普通脚本共用 .fcc 扩展名,只能以文本方式打开,容易混淆。本轮为地图引入专属扩展名 .fcm——在编辑器里把地图「另存为」.fcm 文件后,双击即可直接进入地图编辑器。引擎按文件内容识别格式、不看扩展名,因此这次升级不需要动引擎。
  2. 实现编辑器新增「另存为」(Ctrl+Shift+S):把当前编辑内容完整写到新文件(典型用法:把老地图 .fcc 另存为 .fcm),原文件保持不动;写入前同样经过文件指纹校验与完整重编码自检,且不产生额外备份文件。VS Code 扩展把 .fcm 注册为「默认进入地图编辑器」,.fcc 保持「可选打开方式」不改变现有习惯;.fcm 同时获得语法高亮与脚本运行支持。
  3. 测试验证自动化测试 28 项断言全部通过——覆盖「有编辑另存为」(目标文件与手工写回工具输出逐字节一致、源文件不动、目录不残留临时文件)、「无编辑另存为」字节级一致、「源文件被外部修改时拒绝另存」、原地保存回归;另存出的 .fcm 可被编辑器打开、也可被引擎直接运行。桌面实机冒烟:以 .fcm 为主脚本并加载一张 .fcm 地图运行,画面与既有 .fcc 基线逐像素零差异(467200 像素全等)。已在真实项目地图上实测验收:把地图文件重命名为 .fcm 后双击直接进入地图编辑器;在编辑器中修改并保存后核对——仅被编辑的格子数据发生变化,原内容自动备份为 .bak,其余内容逐字节不变。扩展版本升级至 0.6.2。
  4. 已知限制扩展升级后需重载编辑器窗口生效。.fcm 与 .fcc 在引擎里完全等价,.fcm 仅为「这是地图」的提示约定。

2026-10-16 · 地图编辑器第二步:地砖与通行标志编辑写回(引擎 0.5.30 + 扩展 0.6.1)

  1. 目标与背景上一轮把老地图搬进了 VS Code 可视化预览,本轮把编辑器闭环为「可编辑保存」:直接替换地砖编号、修改通行标志(可走 / 可放 / 可显示 / 归一),保存时写回真实的 .fcc 地图文件——包括其中内嵌压缩的数据块,且只动被编辑的格子,其余字节逐位保留。至此「地图编辑器」大项完成第二轮。
  2. 实现地图工具 mapdump 新增 apply 写回命令:带文件指纹校验(防止覆盖他人修改)、按补丁文件批量应用格子编辑(换图块编号 / 改通行标志位)、用与原版一致的压缩算法重新编码数据块并重扫描自检(格数与尺寸往返一致、非目标块内容全等);所有编辑之外的文件内容(换行、缩进、其他语句)逐位不动。落盘走安全事务:首次保存留下原件备份、临时文件原子替换、只读文件自动处理;若编辑无实际变化则不写文件、不产生备份。扩展编辑器补齐全套编辑工具:选择 / 铅笔 / 橡皮 / 通行刷 / 吸管五种模式、图块编号输入、四个通行标志开关、笔刷尺寸、拖动绘制、撤销重做、未保存格数提示、Ctrl+S 保存,文件被外部改动时给出冲突提示。
  3. 测试验证写回往返测试在 8 张真实语料地图上进行:无改动保存与原文件字节级完全一致且不留备份;单格地砖 + 单格通行编辑只影响目标两格,备份与原件逐字节一致,块外字节前缀后缀全保留。桌面实机三场景截图对比:无改动往返副本与原图逐像素零差异;编辑副本的差异恰好 783 像素、全部集中在两个目标格(新地砖的 48×24 菱形面积 576 像素 + 通行标志清除后出现的红色虚线标记 207 像素),其余画面无任何变化。全套测试通过,引擎版本号升级至 0.5.30,扩展升级至 0.6.1。
  4. 已知限制当前支持地砖编号与四个通行标志位的编辑;覆盖动画层 / 光照层 / 物件层的编辑、旧版 .blk 地图格式、超大地图的 1:1 视口分片为后续轮次内容;含多段地图数据的文件暂固定编辑第一段。扩展升级后需重载编辑器窗口生效。

2026-10-16 · 地图编辑器第一步:老地图在 VS Code 里可视化预览(引擎 0.5.29 + 扩展 0.6.0)

  1. 目标与背景fw2 老项目的地图是「内嵌压缩数据的脚本文件」:地砖索引、覆盖动画、光照遮罩都编码在 .fcc 文本里,过去只能把地图跑起来才知道长什么样。本轮把地图渲染搬进 VS Code——直接打开地图文件即可看到整张地图的离线渲染图,并支持缩放、平移与逐格信息查看,是「地图编辑器」大项的第一轮。
  2. 实现新增地图工具 mapdump(识别 / 离线渲染 / 后续写回)与扩展自带的地图预览编辑器:静态解析脚本中的地图参数并复用引擎渲染管线,按条带渲染整图(峰值内存受控,超大地图自动等比缩小)叠加地砖、覆盖动画与光照三层;预览页支持适应窗口、1:1、缩放平移,鼠标悬停显示所在格的坐标、图块编号与通行标志(可走 / 可放 / 可显示)。编辑器以「可选打开方式」注册,不影响 .fcc 默认按文本编辑。
  3. 测试验证新增单元测试覆盖压缩编码往返、脚本扫描、离线回放与整图渲染;全套测试通过,引擎版本号升级至 0.5.29。预览保真:离线渲染图与桌面实机截图同区域逐点对比——无物件区域色差不超过 1 个色阶,差异全部集中在尚未支持的物件层区域(属本轮范围外,非引擎偏差)。扩展在独立环境完成打开、缩放、平移、悬停取格、重新转换等实操验证;扩展版本号升级至 0.6.0。
  4. 已知限制预览暂不含地图上的家具/装饰物件层(后续轮次补上);本轮为只读预览,地砖与通行的编辑写回为下一轮内容。

2026-10-16 · 等距瓦片地图管线 P6:光照遮罩层 lightmask / lightmaskfull(引擎 0.5.28)

  1. 目标与背景fw2 老图在瓦片层、覆盖动画、物件层之外还有第四层「光照遮罩」:地图脚本指定一张光照图,引擎在其上按网格平铺(lightmask)或整体拉伸(lightmaskfull)以半透明方式叠加,形成整图明暗氛围。这是地图编辑参数链在引擎侧的最后一块拼图。
  2. 实现bktile 新增 lightmask / lightmaskfull 两参数:前者取光照图首帧按帧尺寸与地图网格对齐平铺,后者把首帧拉伸到整张地图尺寸只画一次;两者都以约 49% 透明度叠在瓦片与覆盖层之上,与原版层序一致;光照图纹理按需上传复用,不随帧重建。
  3. 测试验证新增用例覆盖 64×64 网格对齐、半透明混合、右/下边缘忠实缝隙与整图拉伸;全套测试通过,引擎版本号升级至 0.5.28。桌面实机三轮对照(无光照 / 平铺光照 / 整图光照):14 个采样点两轮全部符合「亮图 = 底图 +(255−底图)×125/255」的混合公式,平铺轮可见光照网格对齐痕迹、整图轮无网格痕迹。

2026-10-16 · 等距瓦片地图物件层 AddImg / AddImgEx(引擎 0.5.27)

  1. 目标与背景fw2 老图在瓦片层与覆盖动画之外还有家具、装饰等「物件」:由地图脚本在加载时逐个把图片或脚本类对象摆进地图,按像素位置参与纵深排序。最小样例地图就有 183 处此类调用、全语料 716 张地图在用。本轮把这条物件层移植进引擎,是 fw2 地图大项的第五步。
  2. 实现bktile 新增 AddImg(图片 + 像素坐标或压缩位置串)与 AddImgEx(扩展六、七参形态:自定义类名、层级、动画播放间隔、鼠标提示)两类脚本函数。物件按原版层级公式参与 z 序排序;扩展形态可指定脚本类作为接收者(如老项目的银行人物类),其初始化完成事件在全部属性配置之后才触发,与原版时序一致;位置串沿用原版 5 字符压缩编码。同类调用按「物件等级」门控:等级不足时静默跳过,与原版语义相同。
  3. 测试验证新增八项用例覆盖层级公式、两种坐标形态、扩展参数、脚本类接收者的初始化时序与各类门控/参数错误;全套测试通过,引擎版本号升级至 0.5.27。桌面实机:真实脚本在瓦片地图上同时摆放普通物件、带鼠标提示的扩展物件与压缩位置物件,三个物件全部正确出图、层级正确,日志零错误。

2026-10-15 · 等距瓦片地图管线 P4:无 .tle 资源现场建库(引擎 0.5.26)

  1. 目标与背景老图使用的 .tle 图块库并非必须分发的资源——原版引擎在首次加载时会从 JPG 瓦片条现场重建它并写入缓存,之后每次启动直接读缓存。本轮把这条「建库链」移植进引擎,fw2 语料中 705 张 MapEdit 老图在没有任何 .tle 文件的情况下即可直接渲染,是 fw2 地图大项的第四步。
  2. 实现loadtle 打不开时先查缓存目录(路径折叠为八位十六进制短名),命中即载;未命中则触发脚本类的 OnMakeCmd 事件——类体中的 addkind(瓦片条切块)、link(过渡瓦片生成)、importile(整图导入)逐条进入队列,每帧消费一条建入库中,全部完成后写回缓存。期间修复一处关键缺陷:OnMakeCmd 事件原先用对象层哈希派发,与脚本函数表的字符串表编号不在同一编号空间,事件永远无法命中,现归入系统事件表统一初始化。
  3. 测试验证新增端到端用例覆盖「类体触发器 → OnMakeCmd → 队列逐帧消费 → 库就绪 → 缓存落盘」全链;全套测试通过,引擎版本号升级至 0.5.26。桌面实机:在无任何 .tle 的环境下直接运行真实老图——引擎现场建成 919KB 图块库并渲染出完整的等距石板地图(土块补丁、石板纹路逐像素呈现);重启后缓存复用,画面帧哈希与首次建库逐位一致。

2026-10-15 · 等距瓦片地图管线 P3:通行标志与行走(引擎 0.5.25)

  1. 目标与背景老图的格子除了显示,还要回答「能不能走」。原版以每格一字节通行标志驱动行走与寻路:0x80 可走、0x40 可放置、0x10 可显示、0x01 二级可走,四项全部置位的格子才可通行;加载时引擎会对每格强制补上二级可走位。本轮把通行判定与行走链路移植进引擎,是 fw2 地图大项的第三步。
  2. 实现bktile 新增屏幕像素到存储格的两层坐标变换,以及取点标志、取点区块等查询接口;脚本函数补齐六项通行能力(随机可走点、寻路、二级可走位读写、通行查询、像素吸附格心)。行走方法每步对父地图做通行探测,阻挡时再探测前方短路点后触发中断事件;A* 与直线两种寻路器的代价函数接入同一通行判定。父对象不是地图时按原版语义视作可通行。
  3. 测试验证新增用例从实机脚本的压缩数据出发,验证墙格、可走格的标志位与逐点通行判定;全套测试通过,引擎版本号升级至 0.5.25。桌面实机:40×40 合成地图全屏红海中竖一列透底色的墙,小人从墙左直行目标必穿墙——实际经由 A* 绕行墙侧走廊抵达终点,墙、走廊、小人落点等十个采样像素全部命中,两帧画面完全一致(静止于终点)。

2026-10-15 · 等距瓦片地图管线 P2:oversrc / overdata 覆盖动画层(引擎 0.5.24)

  1. 目标与背景fw2 MapEdit 老图约六成在瓦片层之上另有覆盖动画层:oversrc 指定动画文件(如 1+1.fcc 的 1+1yingzi_over.ale),overdata 以二进制常量存放逐点覆盖节点。本轮把该层移植进引擎,是 fw2 地图大项的第二步(P3 通行与行走随后)。
  2. 实现bktile 新增 oversrc / overdata 参数:节点按原版布局每 5 字节一组(横、纵、帧号),长度不整除即拒收并与原版一致报错;动画文件经统一加载器接入 ALE 动画解码(按文件头自动识别格式,影子行解码为独立阴影层)。渲染层序为瓦片层之后逐节点绘制覆盖动画帧(帧号越界静默跳过),帧坐标带原版帧偏移。
  3. 测试验证新增覆盖节点解析(负坐标往返、坏长度拒收)、动画文件加载、覆盖层渲染像素(含阴影半透明叠加精确值)等用例,全套测试通过,引擎版本号升级至 0.5.24。桌面实机:真实老图 harness 的 76 个覆盖节点正确落位,窗口内阴影叠加像素与理论值误差不超过 ±1,阴影外区域零回归,GPU / CPU 渲染逐帧一致;老图直跑编译运行零错、既有画面零回归。

2026-10-15 · new 类解析修复:脚本类优先于同名内建(引擎 0.5.23)

  1. 问题与根因真实老图 1+1.fcc 首验时发现:脚本定义 class usermap:bktile 后执行 new usermap,实例化的是内建方格地图而非脚本类,类体(loadtle / indexdata 等参数与方法)从不生效。根因是 new 的类解析先查内建注册表、命中即返回,而引擎为早期测试脚本自加的 "usermap" 内建注册(原版引擎并无此注册名)抢跑了同名脚本类。
  2. 修复方案类解析改为脚本类优先:new X 时先查脚本类表,命中则以脚本类声明的基类实例化并执行类体、标记脚本类身份;未命中才走内建注册。与原版引擎对照确认:语料中脚本类与内建注册名同名冲突仅 usermap 一例(usermap 本身就不是内建名),此改动不改变任何原版可观察行为;socketc 等常见路径(无同名脚本类)行为不变。
  3. 测试验证新增回归用例:new usermap 实例化为 bktile 且携带脚本类标记;全套测试通过(含相机演示脚本 class mymap:usermap 等内建基类路径零回归)。桌面实机:老图 harness 改回真名 new usermap 后正确走 bktile 渲染管线(图块库缺失时全屏绿色占位格逐像素精确命中);老图直跑编译运行零错;此前地图管线验收的七点像素基准全部保持通过。引擎版本号升级至 0.5.23。

2026-10-15 · 等距瓦片地图管线 P1:bktile 老图加载与渲染(引擎 0.5.22)

  1. 目标与背景fw2 语料 720 张地图中 705 张为同一族(MapEdit 3.00 生成)的 bktile 等距菱形瓦片地图:loadtle 指定 .tle 图块库、indexdata 以 $PKH 压缩存放逐格图块索引、约六成另有 overdata 覆盖动画层。本轮完成加载与渲染最小闭环,是 fw2 地图大项的第一步(P2 覆盖动画层、P3 通行与行走随后)。
  2. 自研 LZW 与 $PKH 求值逐行移植旧版自研 12-bit LZW 压缩(与标准 LZW 不互通);脚本层 $PKH / $HEX 二进制常量在扫描期解码:hex 还原、未压缩长度校验、LZW 解压,直接产物为二进制常量节点。用真实老图 1+1.fcc 做金测,解压字节数与网格规模精确吻合。
  3. .tle 图块库与 bktile 类解析 .tle 图块库格式(种类表 + 图块表,每图块 602 个 RGB565 采样按菱形扫描线还原为 49×25 位图);新增原生 bktile 对象类,支持 loadtle / tilesize / indexdata / showgoflag 参数:按视口裁剪逐格绘制、图块纹理按编号缓存复用、索引越界画绿色占位格、60000 编号跳格。
  4. 测试验证LZW 往返与真实语料金测、.tle 解析(菱形形状与坏输入)、bktile 坐标变换 / 参数链 / 渲染像素 / 通行标志覆盖、$HEX / $PKH 求值全链路等新增用例,全套测试通过,引擎版本号升级至 0.5.22。桌面实机:30×100 合成地图红海无缝铺满全屏,蓝图块、越界绿格、跳格透底色七点逐像素命中。

2026-10-14 · 系统默认文本字号与按钮统一:12px 对齐原版(引擎 0.5.21)

  1. 问题与根因纯文本对象与 MakeImg 画布(按钮文字)的默认字号此前分别为 14px 与 13px,均大于旧版的 12px(FObjText 构造默认 FontWidth 6 / FontHeight 12,画布默认字体 CreateFont(12,6))。字号偏大导致按原版尺寸固定宽度的旧脚本文字超出边界,如 fw2 语料 Snowfight/server.fcc 的 70px 面板标题压住右边框。
  2. 统一修复文本对象默认字号与画布默认字体(font 参数为 0 时)统一为 12px,逐一对应原版两处默认值;系统内所有默认文本从此与按钮文字一致。显式指定的字号(font= / fontsize=)不受影响。
  3. fontsize 参数补全补齐原版 fontsize 参数的读写:写 int 时字号=该值、字宽=该值的一半;写两元素的数组时按 [高, 宽] 设置;读回的数组宽在前(与原版 "dd" 顺序一致),旧脚本对 fontsize 的赋值与读取(如按字号计算布局宽度)原样可用。
  4. 测试验证新增 4 条回归用例:默认字号为 12 且构造值与原版一致、画布默认与显式 12px 度量相同、Snowfight 面板五个文本全部不超边界、fontsize 读写与非法值拒绝。全套测试通过,引擎版本号升级至 0.5.21。桌面实机:F7 截图前后对比——修复前「雪仗服务器」标题压过面板右边框,修复后收进框内且留有余量。

2026-10-14 · wnd OnSize 事件分发修复:脚本类内 autopos 生效(引擎 0.5.20)

  1. 问题与根因旧脚本在 wnd 子类中写 `void OnSize(int w,int h){ autopos:=vert(3,3,3); }` 后子项不重排(如 fw2 语料 Snowfight/server.fcc 的自动布局面板)。根因是旧版引擎每帧绘制前由 FObj::CheckShowStatus 向尺寸变化的对象派发 OnSize 事件,这一机制此前未移植到 Go 引擎,脚本类内的 OnSize 从未被调用。
  2. 修复实现按原版语义补上逐帧 OnSize 分发:对象尺寸发生变化且类内定义了 OnSize 时派发事件、参数为宽高两个整数(对齐原版 "dd" 参数);处理函数不存在时回退为无参调用,仍不成功则停止对其派发;事件为单帧边沿触发,处理完即清除变化标志。根窗口沿用窗口尺寸变化时的即时派发、不参与逐帧分发,避免重复触发。
  3. 测试验证新增 2 条回归用例:脚本类 OnSize 在子窗口尺寸变化时触发且参数正确、autopos 竖排后子项 x 对齐且 y 递增;Snowfight 形状的多面板布局端到端断言。全套测试通过,引擎版本号升级至 0.5.20。桌面实机:用 0.5.20 DLL 跑真实 corpus/Snowfight/server.fcc,F7 截图前后对比——修复前各子项全部重叠在面板左上角,修复后两个面板并排(5,5)与(80,5)落位、行按竖排规则堆叠。

2026-10-14 · FCBOX 标题角标回归:右下角标志与关于对话框并存(引擎 0.5.19)

  1. 右下角 FCBOX 标志窗口标题栏开启时,Root 窗口右下角恢复绘制原版的 32×12 FCBOX 标志位图(对齐旧版 m_imgFcFlag 行为:Show 末尾以 w-32-1, h-12-1 贴角、无透明通道原样拷贝),此前该区域为空白;标志随窗口尺寸自适应贴角,标题栏关闭时不绘制。
  2. 热角与关于对话框鼠标点击右下角热区弹出关于对话框的既有行为不变,标志与对话框同时可见;关于对话框的图片纹理缓存改用渲染后端身份判定——切换 CPU / GPU 渲染时不会误释放新后端上复用同纹理编号的角标纹理。
  3. 测试验证新增 3 条像素级回归用例:标志矩形逐像素等于解码后的 fancy.gif、外圈 1 像素边框为纯背景、标题栏关闭时该区域为空、渲染后端切换后稳态仍绘制;6 个既有像素精确测试夹具同步适配;全套测试通过,引擎版本号升级至 0.5.19。桌面实机:F7 截图角标 384 像素逐字节一致,点击热角弹出关于面板落位正确,CPU / GPU 渲染哈希逐帧一致。

2026-10-13 · 网络层:sockets / socketc 对象家族全栈移植(引擎 0.5.18)

  1. 网络对象家族按旧版 C++ 网络层全栈移植五个对象类:服务端 sockets、客户端 socketc,以及无握手协议族的 socketsd / socketcd / socketuser;自定义子类、组注册、玩家登录回调等原版脚本写法原样可用。
  2. 完整通信链路从 TCP 连接、版本握手、加密协商,到组注册(RegWebGroup)、玩家登录解析、登录回调 OnWebPlayerCreate、对象远程调用(client<< / server<< / tos<< 等目标关键字)与组播,全部按原版协议与语义实现;文本行与二进制块、可选压缩与加密、空闲超时与断线清理一并移植。
  3. 旧脚本零改动旧版语料的典型写法——`new sockets` 配端口、RegWebGroup 注册组、`class X:socketc{ RegClientGroup(); defcreatewnd=this; ... }` 手工登录——无需修改即可运行。
  4. 测试验证传输层 54 条用例覆盖加密向量、行与二进制帧、空闲超时与真实 TCP 环回;对象层单进程全链路环回测试跑通「握手→登录→建玩家对象→注册镜像→双向远程调用」;桌面版 launcher 实机单进程环回:约 175 毫秒内全条件达成、截图结果窗 36000 像素逐像素纯绿零杂色,GPU 渲染 bit-exact;全套测试通过,引擎版本号升级至 0.5.18。
  5. 已知限制socketsd / socketcd / socketuser 协议族已完成类面与单元测试,暂未做桌面实机演练;组定位(RegWebGroupLoc)走简化路径,完整定位表列为后续计划。

2026-10-13 · 数据库层:DBConnection / DBRecordset 换装 MySQL 后端(引擎 0.5.17)

  1. MySQL 后端新增 DBConnection / DBRecordset 两个对象类(按原版 ServerExt 的 C++ 实现全量移植),数据库后端从 ADO / 微软 SQL Server 换成 MySQL:连接、查询、行读写与逐帧遍历全部经 MySQL 驱动完成,单文件发布形态不变。
  2. 旧脚本零改动原版连接串(Data Source=xxx、driver={SQL Server};…)自动转换为 MySQL 连接参数,旧版脚本语料中的数据库代码无需修改即可改用 MySQL;主机、端口、库名、账号亦可用环境变量分别覆盖,便于部署配置。
  3. 遍历语义对齐游标移动与 EOF 行为按 ADO 钳制语义复刻(越界回钳、空表保护),老脚本 `while(nPos!=EOF)` 式遍历原样可用;Enum 同步回调与 EnumDelay 逐帧延迟回调(含跳过数量、结束回调)全部移植。
  4. 测试验证单元测试覆盖连接串转换与环境变量覆盖;嵌入式假驱动逐条核对生成的 SQL 语句形态;端到端脚本测试跑通「连接→查询→同步枚举→循环遍历→逐帧枚举」全链路;并在隔离 MySQL 实例上完成真库联调——旧连接串+环境变量覆盖、直连连接串两条配置路径均通过,launcher 实机脚本跑通建表、增删改查、同步与逐帧枚举及中文数据往返,负向对照正确报红;全套测试通过,引擎版本号升级至 0.5.17。
  5. 已知限制服务器端索引定位(PutIndex/Seek)在行缓存模型下降级(仅校验状态);删除仅支持当前行;DBBank / dbsocket2 等其余数据库相关对象列为后续计划。

2026-10-13 · 测试地图交互修复:地形开关与点击标记完整帧(引擎 0.5.16)

  1. 地形可行走开关测试地图工具栏的显示地形按钮生效:usermap 新增 gomask(可行走遮罩图,亮像素=可走)与 showgoflag(叠加开关)两个参数;开启后地图上以半透明黄色覆盖层实时标出全部可行走格——河流、湖泊与岩石格保持原样,一眼可辨通路。测试地图自带新绘制的遮罩资源(桥梁缺口、湖岸圆角与零散巨石)。
  2. 布尔运算语义对齐修复脚本 `!`/比较/逻辑与或的取值类型:与 C++ 原版一致落为整数 0/1。此前取反等运算产出布尔值,被 showgoflag 这类整数参数的类型检查拒绝——这正是「按钮点了没效果」的第二层根因;开关取反脚本 `showgoflag=!showgoflag` 现在可以直接工作。
  3. 点击标记完整帧修复点击地图时落点的扩散动画只显示右下角的问题:动画各帧自带负的绘制偏移(帧原点在左上方),此前帧矩形漏算该偏移导致左上象限被视口裁掉;现在动画帧的完整画面(含偏移区域)全部可见。
  4. 实测验证桌面版 launcher 实测:地形开关三张截图逐像素核对(关闭=纯草地零偏差、开启=可走格混合色逐点吻合且水域原样、再关=零偏差);定时点击后截图核对标记覆盖区与动画帧矩形逐像素吻合,标记明显延伸到点击点左上方(修复前不可见);引擎版本号升级至 0.5.16。

2026-10-13 · 测试地图草地:格子贴图与 1:1 原像素平铺(引擎 0.5.15)

  1. 格子贴图管线usermap 新增 wholemap 参数:一张整图作地图背图,每个格子按比例裁取自己的贴图块(忠实复刻 C++ 逐格拉伸语义),无图格保留灰蓝底块;同时修正旧版资源名笔误 def_glass → def_grass(旧名保留兼容)。
  2. 1:1 原像素平铺用户反馈草地被拉伸、颗粒大而模糊——逐格拉伸把 64 像素小图放大到整格所致。新增预平铺整图资源(小纹理按原像素 1:1 平铺成整图尺寸),测试地图改用它:每格取到的恰好是纹理原像素,画面锐利无拉伸。
  3. 实测验证桌面版 launcher 全屏逐像素核对:相机偏移下屏幕每个像素与预平铺整图对应像素完全相等(两轮均零偏差)——真实渲染管线确为 1:1 无拉伸;引擎版本号升级至 0.5.15。

2026-10-13 · tooltips 提示气泡:背景三段错位修复(引擎 0.5.14)

  1. 问题与根因鼠标悬停出的 ToolTips 提示气泡背景三段错位(最左侧铺成了最右段、中间没有平铺中段)。逐行核对 C++/Go 双方 himgtile 三段绘制代码完全一致,根因不在代码:嵌入资源 ToolTips.ale 曾被一次重打包实验替换,帧矩形表被旋转,同字节数、仅帧序不同,于是三段图块被按新顺序错位分配。
  2. 修复与回归恢复原版资源(md5 与参考源一致),并新增两条回归测试防止复发:帧序测试(3 帧 19×27 / 8×21 / 12×21 加尾尖像素钉死帧表顺序)、段位绘制测试(8 个采样点钉死左帽轮廓/填充/尾尖、中段平铺、右帽各自落位)。
  3. 实测验证桌面版 launcher 实测悬停气泡:17 个采样点与 CPU 预测逐位一致——左帽黑边、圆角、小尾尖、中段平铺填充、右帽、阴影、文字混合全部恢复原版样式;引擎版本号升级至 0.5.14。
  4. 教训重打包/帧序类实验不得拿嵌入资源当试验田:嵌入资源与参考源必须保持 md5 一致。

2026-10-13 · roundhalf 圆角半透明背景:五项脚本功能收官(引擎 0.5.13)

  1. 圆角半透明背景roundhalf 移植原版圆角半透明填充:圆角矩形按半径裁剪、填充与描边做半透明混合;lastW/lastH 负内缩允许框画出对象矩形之外(名牌配方所需的忠实行为)。
  2. alpha 语义对齐填充强度不随对象 alpha 缩放——与 C++ 原版一致(纯色 color 填充从不读对象 alpha,需要 alpha 感知的背景用 colorex);roundbar / round4_3 圆角族同步对齐修复。
  3. 实测验证四窗口对比实测:roundhalf alpha=100 与 alpha=0 同为半混合、纯色 color 两档均不透明、colorex 随 alpha 变化——与 C++ 语义逐点一致;测试地图 demo 零回归;引擎版本号升级至 0.5.13。
  4. 五项收官脚本功能五项顺序 usermap → view 相机 → human → 小地图 → roundhalf 全部完成并通过验收。

2026-10-13 · 小地图面板:地图缩略图、相机框与点击操作(引擎 0.5.12)

  1. 小地图绘制系统脚本「测试地图」右上角的小地图面板从占位变为真实缩略图:地图整体按比例缩到面板内(默认深红底条、贴图底图二选一),黄色角标实时框出当前相机看向的地图区域,相机滚动时同步移动。
  2. 人物标记地图对象可用 mapshowmode/mapshowcolor 声明小地图标记样式(脉动十字、星形、斜十字、斜十字加圆圈等):角色在地图上的位置以品红叉形标记实时跟随,测试人物移动/瞬移后标记同步。
  3. 点击操作左键点击小地图移动相机到点击处(可按住拖拽扫图),右键点击把小地图上的目标点交给脚本处理——测试 demo 中为角色瞬移(再走起带飞行动画),与地图脚本原有语义一致。
  4. 实测验证桌面版 launcher 实测:小地图三截图逐像素核对(底条色 RGB(100,0,0)、角框色 RGB(232,232,0)、标记色 #FF00FF)——左键点击后相机精确跳到地图 (245,181)、右键点击后角色瞬移 (640,480) 且标记精确落在点击位;桌面版引擎版本号升级至 0.5.12。
  5. 已知边界脚本功能五项顺序仅剩 roundhalf(圆角半透明背景)一轮。

2026-10-13 · 行走人物精灵:8 方向图集与地图行走(引擎 0.5.11)

  1. 多方向精灵新增 human 人物对象:一张图集按方向乘帧数切分(如 8 方向 × 每向多帧),行走、转向、站立自动换帧;也可以配置多套图集(multisrc)按 anikind 切换,朝向可用 forward 指定角度或 forwardto 直接指向目标点自动换算。
  2. 行走链路与行为系统打通:gotopos 行走自动朝目标方向、迈步动画循环,抵达后触发 OnStop(demo 中复位站立帧);行走中可被打断切换到传送(多段飞行动画)。
  3. 测试地图联动「测试地图」demo 中的人物可直接行走/转向/站立:左键点击地图走向点击点、右键点击瞬移,名牌跟随人物,小地图标记同步(配合上一轮小地图功能可实时观察)。
  4. 实测验证桌面版 launcher 干净复跑逐阶段验证:行走终点、相机跟随双向夹紧、8 方向帧槽位与图集像素逐位一致(东南向行走帧 740/740 像素全等);桌面版引擎版本号升级至 0.5.11。
  5. 已知边界装备/换装层(FHumanEquip)不在本轮移植范围。

2026-10-12 · 视口相机滚动:view 相机偏移与滚轮联动(引擎 0.5.10)

  1. 相机渲染view 视口对象移植原版相机:把地图按滚动偏移(viewpos/viewx/viewy)平移后绘制,窗口外的地图部分自动裁剪;挂接地图时自动排除其在普通绘制队列中的重复绘制,换绑或释放时恢复,滚动过程画面无重影。
  2. 平滑滚动与跟随滚动目标位置(toviewpos/toviewx/toviewy)与当前滚动位置分离,按 movestep 每帧逼近实现平滑滚动;viewcenterpos 将指定点对准视口中心(自动钳位不出地图边界),viewfollow 跟随目标对象,mousescroll 开启鼠标贴边自动滚动。
  3. 滚轮联动鼠标滚轮在视口上滚动地图:滚轮增量换算为滚动步长,经平滑滚动收敛到目标位置;实测 3 个滚轮刻度精确移动 30 像素、无重影。地图宽高参数 mapwidth/mapheight 改为只读,由所挂地图自动同步。
  4. 实测验证测试地图 demo 画面与上一版逐像素一致(相机接线无回归);新增相机演示脚本(红方块标记随 viewpos 偏移精确落位、滚轮实时滚动),桌面版 GPU 渲染管线全程逐位一致;桌面版引擎版本号升级至 0.5.10。
  5. 已知边界行走人物精灵与精灵多方向图集为下一轮内容;小地图画面绘制再后一轮。

2026-10-12 · 测试地图 demo 落地:usermap 瓦片绘制与脚本解析修复(引擎 0.5.9)

  1. usermap 地图瓦片usermap 地图对象移植原版瓦片绘制:默认 20×15 格、每格 64 像素(1280×960,大于窗口供滚动),空格子以原版同色蓝紫填充,按视口自动剔除屏外格、透明格跳过不画。
  2. 脚本跨行大括号修复<对象> 语句后换行再写 { 代码块 } 时,代码块此前会脱离语句、错误地作用到外层窗口(系统脚本「测试地图」的小地图参数因此泄漏到主视口,画面缩成一条);现与原版一致跨行挂接,style/class 声明同理。
  3. 实测验证测试地图 demo(testmap.fcc)在桌面版 GPU 渲染管线下实测通过:满屏瓦片铺底、左上角 6 个工具条按钮,像素级校验与引擎内测试完全一致;桌面版引擎版本号升级至 0.5.9。
  4. 已知边界本轮为地图底格与小地图布局:小地图画面绘制、行走人物精灵为后续轮次内容。

2026-10-12 · 椭圆轨迹背景(ellipse)实测通过

  1. ellipse 实测通过bk:=ellipse 椭圆轨迹背景在桌面版 GPU 渲染管线下实测通过:两段中心对称的淡出尾迹沿椭圆逆时针旋转,每帧前进 10°;尾迹起点最亮、逐点变暗,像素级采样与原版引擎行为一致。
  2. 内缩与外扩轨迹椭圆的半径参数为正时向内收缩、为负时向外扩出窗口范围,扩出部分仍正常绘制不裁剪;要黑色底衬可在下层叠加一个纯色窗口(同一窗口只保留最后一个背景方法)。
  3. 零构建验证轮本轮为实测验证、无代码改动,桌面版引擎版本保持 0.5.7;已知差异:轨迹起始角度为固定值,原版为随机起始角(仅影响起始位置观感)。

2026-10-12 · dotcolor 格点背景修复(引擎 0.5.7)

  1. dotcolor 棋盘格修复bk:=dotcolor 格点背景修复为与原版一致的 50% 棋盘格点阵:1 像素点隔行交错铺满,此前只有 25% 密度、每隔一行就整行空缺。
  2. 相位锁定格点相位与屏幕坐标对齐:窗口移动、被裁剪或部分遮挡时,点阵花纹不会突然翻转;桌面版引擎版本号升级至 0.5.7。
  3. round4_3 复核圆角矩形背景在 GPU 渲染管线下复核:四个圆角描边连续完整,无通透斜线,显示正常。

2026-10-08 · 脚本支持小数(float)与 Esc 键行为修复

  1. 脚本支持小数FCC 脚本语言新增 float(浮点数)基本类型:现在代码中可直接书写小数字面量,如 3.75、0.5(最多 6 位小数);此前出现小数点会报错,导致含小数参数的调用(如 MixLine(5.5, 8.5))无法运行。
  2. float 变量与成员可声明 float 变量、在类中声明 float 成员变量(约定以 m_f 开头,如 m_fv);与其它基本类型一致,可用 .str 属性取得小数的十进制文本。
  3. Esc 键行为修复版权信息面板打开时按 Esc 现在只关闭面板、不再连带退出程序;脚本注册的 Esc 热键处理按键后事件不再继续传播,不再意外触发程序退出。
  4. 学习手册更新手册「基本类型」章节由七种类型扩为八种,新增 float 浮点数:声明写法、小数字面量规则、成员变量前缀约定(m_f)与可用属性均有说明与示例。
  5. 在线体验页更新体验页引擎升级至 0.5.6,同步支持小数等最新特性;「能力边界」清单补充说明:触摸屏环境下的点击仅被解释为鼠标左键按下。

2026-10-07 · 在线体验页上线(浏览器里跑 FCC)

  1. 浏览器直接运行新增「在线体验」页面:无需安装任何程序,浏览器里直接运行 FCC 脚本。左侧是引擎模拟屏幕、右侧是代码编辑器,内置多个示例可一键切换,点「运行」即刻看到效果,随时「停止」。
  2. 虚拟工作目录与控制台页面自带运行控制台与虚拟工作目录:可上传本机文件供脚本读取、把脚本生成的文件(如 F7 截图)下载回本机;内容只存在浏览器内存中,刷新即清空,代码不会上传服务器。
  3. 能力边界说明页面附「能力边界」清单:浏览器版为软件渲染,没有真实窗口、系统托盘、声音、网络与 DLL 扩展,也不能读写本机文件;要开发完整产品请在桌面使用发布版引擎。
  4. 网站入口调整网站导航改为「学习」(在线体验)与「手册」(脚本参考)双入口,主页按钮同步提供「开始学习 FCC」,从首页一步进入体验页。

2026-10-07 · 扫雷示例完善与页面导航

  1. 扫雷示例升级示例中的扫雷更换为更完整的版本:支持右键标雷并实时显示剩余雷数,右击「新游戏」可设置限时、棋盘格数与雷数。
  2. 显示区域加大扫雷的显示区域扩大到与其它示例一致,棋盘自动居中显示在画面中央。
  3. 设置对话框输入修复右击「新游戏」弹出的设置对话框中,四个输入框不再同时闪烁光标——此前每个输入框都获得了输入焦点、导致没法修改内容;现在点击哪个输入框,哪个才获得光标,可直接键入数值。
  4. 页面导航按钮学习手册首页与手册正文页新增「返回首页」「FancyBox2D 主页」按钮,正文页另有「返回手册」按钮,手册与网站之间往返更顺手。

2026-10-06 · GPU 外部渲染器(render.dll)

  1. GPU 外部渲染器新增 render.dll:程序启动时若发现该文件,自动启用 OpenGL 外部渲染通道,整帧画面经 GPU 纹理上传直接上屏;未放置该文件时照常使用内置渲染,行为完全不变。
  2. 渲染一致性校验运行中自动抽样回读画面、逐位比对 GPU 与内置渲染结果,两者位精确一致(RGB 零差异);图片背景等画面内容在 GPU 通道下正确上屏。

2026-10-06 · 小项修复与下载器补全

  1. view 背景色与背景动画模式view 对象的 bkcolor(背景色)与 anibkmode(动画背景模式)现在真正生效,此前设置被静默丢弃;未连接地图的 view 也会按背景色填满空区域。
  2. new img(x,y,src) 构造参数以坐标与图片路径三个参数创建图像对象时参数正确应用,此前构造实参全部丢失(对象落在原点且无图)。
  3. 键盘消息完整路由宿主键盘消息带真实键码进入完整按键管线:内置快捷键、脚本注册热键与焦点对象的按键事件均正常响应,此前数字键码在入口处被丢弃。
  4. 系统错误状态上报长时间画面卡顿与网络断线现在会真实写入系统错误状态,脚本经 GetSysErr 系列可查询到、恢复后自动清除;此前该状态恒为 0。
  5. 下载器补全新增 DownLoadFile / DownLoadPath / DefFileSwap 三个脚本函数:按远程清单把文件下载并换算为本地目标文件,本地已有匹配文件时直接复用;下载更新链路的消费端由此补齐。

2026-10-06 · 版权信息对话框修正与版本规范

  1. 平台页版式重排开发平台页的 banner 按面板宽度等比缩放、不再出界;各行文本自动选用适配字号并水平居中,行距舒展、不再相互粘连。
  2. 布局与描边访问网址页脚在产品版权页与开发平台页都常驻显示;面板加高 20 像素获得更大呼吸空间;分页标签左右居中;面板四周增加 1px 黑线外框。
  3. 版本号规范版本行改为「版本号 + 8 位构建日期」形式(如「版本: 0.5.2 (20261006)」),不再显示旧的「2.0.0-golang」字样。
  4. 面板外点击不再关闭对话框打开时点击面板之外的区域不再将它关闭,且面板外的画面照常响应鼠标;关闭请用 F1 或 Enter。

2026-10-06 · 插件 0.5.22:编辑器内光标文件预览

  1. 光标文件预览VS Code / Qoder 扩展 0.5.22 新增 .cur 光标文件预览:打开文件即解码并放大显示光标图形(默认 8 倍),右下角实时标注热点坐标,十字线与外框辅助对齐观察。
  2. 预览工具工具条支持缩放(1:1 / ×2 / ÷2 / 适配窗口)、背景切换(棋盘格 / 白 / 黑 / 灰 / 深蓝)与十字线开关;多条目光标文件可用方向键切换显示。

2026-10-06 · 学习手册新增「快捷键」章节

  1. 快捷键章节脚本参考手册新增独立的「快捷键」章节,与 FCC 语法、辅助工具、系统开发、扩展动态库并列:收录 Esc、F1、F2、F3、F5、F7、· 键调试拾取、Ctrl 拾取、右下角版权热区等全部内置快捷键的用途与行为细节。
  2. 脚本热键注册同章节整理脚本自定义热键的注册方法:RegHotKeyDown / Up 等 7 个接口的用法、可用键名全表与 ctrl_ / shift_ 组合键前缀规则。
  3. 手册首页入口学习手册首页新增「快捷键」入口卡片,一键直达新章节。

2026-10-05 · 脚本声明修复与示例修正

  1. 一行声明多个变量int a,b,c; 现在全部正确创建(此前只有第一个名字生效,其余被静默跳过)。
  2. 后缀自增自减真正生效i++ / i-- 不再被静默忽略,依赖计数递增的循环可以正常结束,不再死循环。
  3. 未初始化变量不再跳过构造声明后未赋初值的变量(如 int vol;)参与创建对象时构造函数正常执行、成员正常赋值,不再出现“对象像没创建一样”的情况。
  4. 类内方法互相调用更稳修复脚本中调用同类方法偶发报 “function not found” 的问题(扫雷示例点击空格后自动连锁翻开即受此影响)。
  5. 文字直接写数字正确显示文字对象的 src 直接赋数字(src=数量)现在正确显示为数字文本,不再空白。
  6. 默认文字色调整文字默认颜色调整为奶油色,在浅色背景上清晰可读(此前默认白色在浅青等浅色底上几乎不可见)。
  7. 扫雷示例修正格子数字改为在文字对象自身的方法里设置,数字正确居中显示,不再贴在格子左上角。

2026-10-05 · 宏系统与脚本扩展补全

  1. 宏系统补全补齐 #push/#pop 宏压栈出栈与 #system 系统指令;条件宏 #ifdef/#if 的边界行为与原引擎对齐,写错的宏指令会报出具体位置并继续执行后续脚本;几十层以上的条件宏嵌套不再导致引擎异常退出。
  2. 系统默认宏补齐全部系统默认宏(__FILE__、__PATH__、$、_MAIN、_OBJVER、_CHARSET、_LOC 等),在主文件与被包含文件中按规则自动展开。
  3. #import 引入外部扩展库支持 #import 的 system / userdll / perload 三种形态;引入后可直接以 new 创建 dll_ 开头的扩展类对象,PerUserDll 可按需预载扩展库。

2026-10-04 · 脚本函数大批量补全

  1. 真实点击事件 OnClick修复左键弹起不触发 OnClick 的问题;并补齐原引擎的按键捕获语义——按下时消息若被别的对象消费,弹起仍会送达按下时所在的对象。
  2. 鼠标钩子与滚轮事件hookmouse=1 现在真正生效:OnLBDownHook / OnLBUpHook / OnRBDownHook / OnRBUpHook 及对应 HookEnd 事件会先于普通消息送达,设 0 取消;补齐 OnMouseWheel 滚轮事件。
  3. wnd 函数与属性补全补齐 posex("x,y" 坐标串定位)、pcaller(方法调用者对象)、IsUserFunc、IsMouseOver、Exec(延迟执行,flag=1 时销毁本对象再运行脚本)。
  4. 绘制函数补全补齐 Line / MixLine / FlashLine / LightLine / AlphaLine / Bar / Circle / CircleLight / Sphere 等绘图函数与视区、原点控制共 15 项,绘制目标为 MakeImg / AddFrame 期间正在制作的图像表面。
  5. 异形窗口新增 SetWinMaskFun 与 8 个区域函数(椭圆、圆角矩形、矩形、多边形、图像掩模的加减组合),窗口可按回调中组合出的任意形状显示。
  6. 声音与命令通道新增 PlaySndPos 按屏幕位置自动平衡音量与左右声道播放;新增 SendCommand / GetWndHandle 命令通道与窗口句柄查询;pdesktop.updatedelay 现在真正生效(最小 10 毫秒)。
  7. 系统函数补全补齐 ShellExecute / PostWindowMessage / SimWndEvent / ShowDutyBar / GetHostPath / BinCreateFrom,昵称禁用词三件(DisableNickStr / LoadNickDisableTxt / SaveNickDisableTxt),下载器三件(DefLocMaping / CtrlFilesDir / RegDownLoadProgress)。
  8. 脚本报错更友好语法错误精确定位到行、列;宏指令错误带位置报告后继续执行;写错的语句只吞到行尾,不再连带跳过下一行正确代码;修复若干表达式报错与原引擎不一致的问题。

2026-10-04 · 窗口事件与激活状态

  1. 窗口激活状态实时查询pdesktop.active 读取时实时反映窗口是否处于激活状态:窗口在前台读 1,最小化或切到后台读 0(此前读取恒为 0);赋非零值激活本窗口,赋 0 不做任何操作,与原引擎语义一致。
  2. desktop 窗口事件补全新增 OnActive(窗口获得/失去焦点)、OnCommand(宿主命令消息)、OnUserMessage(用户自定义消息)、OnMiscWM(其他未处理窗口消息)四个事件,desktop 五类窗口事件全部可用。

2026-10-03 · 图标、字体与系统函数补全

  1. 窗口图标与系统托盘pdesktop.SetIcon 设置窗口标题栏/任务栏图标(支持 res: 内置资源与本地图片文件);pdesktop.SetTaskIcon 添加/修改/删除系统托盘图标并可带悬浮提示文字,托盘上的鼠标点击经 OnTaskLBDown / OnTaskLBUp / OnTaskRBDown / OnTaskRBUp / OnTaskDBClick 五个事件回调到脚本。
  2. 进程启动函数补齐 Shell / ShellMin(以普通/最小化方式重启宿主实例)、ShellOpen(用系统默认浏览器打开网址)、RunExe(启动外部程序)。
  3. 字体名真实生效font=名称,宽,高,粗细 中的字体名现在按系统已安装字体解析(如 隶书、Webdings),符号字体自动按符号编码映射;此前名称被静默忽略、一律用默认字体。
  4. 悬浮提示鼠标悬停在带 tooltips 文字的对象上时,自动触发 ToolTipsObj 的 OnShowTips / OnHide 事件,提示内容随悬浮对象自动切换。
  5. 背景图片平铺三模式补齐 himgtile 横向平铺、vimgtile 纵向平铺、imgscale 按原始尺寸贴图三个背景图片模式。
  6. OnEdit 事件修复修复编辑框 OnEdit 事件永不触发的问题,编辑回调现在正常进入脚本。

2026-10-03 · 系统控件修复批次

  1. SysBtn 按钮文字不显示修复 new SysBtn(...) 大尺寸按钮背景、边框正常但文字不显示的问题:按钮内部的尺寸变量被其他控件实例污染,文字被画到按钮表面之外;现已隔离修复,文字正常显示。
  2. SysBtn 字号与居中按钮文字字号固定为与 CmdBtn 一致,不再随按钮尺寸缩放(此前 160×20 的按钮会显示 19px 大字);文字改为水平、垂直双向居中,此前固定绘制在左上角。
  3. SysDlg 标题垂直居中对话框标题文字按对话框最终尺寸精确垂直居中,此前整体偏上 8px。
  4. _T 文字悬停异常修复鼠标划过 _T 文字时文字被加亮加粗的问题,悬停不再误触发其他控件的高亮样式。
  5. SysDlg 悬停背景消失修复鼠标划过 SysDlg 对话框时背景纹理消失、移开后不再恢复的问题,控件间的事件处理不再相互串扰。

2026-10-02 · 拾取操作面板与系统补全

  1. 拾取操作面板调试拾取模式新增画面内操作面板:选父、删除、显示/隐藏、子对象列表、对象树五个按钮,选中对象后可直接在运行画面上查看与操作。
  2. 面板自动退避按住 Ctrl 拾取时手势滑入面板区域,面板自动退避到左上角,不阻挡对右上角对象的拾取;松开 Ctrl 后面板留在原地,拾取位置离开默认区域时自动回位。
  3. 拾取信息自动刷新选中对象的信息每 500ms 自动刷新;脚本删除已选对象后描边与面板信息自动清除,不残留。
  4. 脚本报错可见化脚本运行错误以单行帧输出到插件运行时面板,包含文件、行、列与错误信息;此前被静默吞掉的错误现在可见,重复错误自动去重防刷屏。
  5. 绘制内建补全补齐 Clear / PutPixel / Rectangle / DrawObj 四个绘制内建函数,SysBtn 标题栏小按钮的自绘管线打通,按钮可以正常画出。
  6. 系统函数补全补齐 CenterWindow(对话框屏幕居中)、ptxt.anti 属性与 m_pSysPtText 机制,系统脚本启动不再报「函数/属性未找到」。

2026-10-02 · 对象调试拾取(新功能)

  1. · 键对象调试按 · 键开启/关闭对象调试模式;开启后按住 Ctrl 悬停对象,引擎以白框黑边描出选中对象,插件 RT 面板实时显示其类名、pid、位置、尺寸、显示状态等信息,悬停空白处显示 desktop 本身。
  2. 切换状态提示按 · 切换时 RT 面板显示「· 对象调试已开启 / 已关闭」,关闭时自动擦除描边并清空信息区。
  3. 中文输入法 · 键修复修复中文输入法下按 · 键无法切换调试模式的问题:输入法对 ANSI 窗口经 WM_IME_CHAR 以 GBK 内码提交字符,此前只处理了 WM_CHAR 通道;现在两条通道都会映射为切换键,并去重防双发。
  4. 插件 0.5.21RT 面板新增拾取信息区块与模式提示,trace 列表与拾取信息分区显示。

2026-10-01 · 功能键与 About 对话框

  1. F1 About 对话框F1 呼出关于对话框(此前按了无反应),再按 F1 或 Esc/Enter 关闭;支持 pdesktop.SetAbout / SetAboutImg 自定义文字与图片;caption 模式右下角热区也可呼出。
  2. F2 诊断面板补齐帧率、光标、显示/更新时间、错误数、对象数、方法数、绘制命令数、内存等信息面板;统一 12px 字号竖排「名称:值」,修复前几行文字错位重叠。
  3. F3 显示冻结F3 冻结/恢复画面:冻结时画面停在最后一帧,对象更新照常进行,鼠标消息暂停派发。
  4. F5 重启F5 或脚本 pdesktop.ReStart() 触发进程内重载:销毁全部对象并于下一帧重跑启动脚本,修复此前「按了没重启」的问题。
  5. F7 截图截图格式由 JPEG 改为 PNG,保存到启动脚本目录的 screenshots/ 文件夹;水印改为 FcBox 半透明文字,去掉背景圆角矩形。
  6. 其他修复补齐 pdesktop.SetWindowText() 函数(此前脚本调用静默失败);About 对话框横线左右留白对称。

2026-09-30 · 启动器与运行时修复批次

  1. CmdBtn 系统按钮修复补齐按钮依赖的 10 个绘制内建函数与 frame 三态贴图参数,脚本类成员变量改为每实例独立,new CmdBtn(...) 可正常绘制并响应点击。
  2. 按钮圆角四角透明修复 CmdBtn 圆角处被渐变方块填充的缺陷,圆弧外的区域恢复透明。
  3. 按钮文字垂直居中文本绘制基线对齐 Windows GDI 语义,修复按钮文字整体偏低、不居中的问题。
  4. launcher 窗口行为修复 caption=1 时窗口内容不显示;修复 fixed 属性双向缺陷:fixed=0 恢复可调尺寸,fixed=1 不再丢失边框。
  5. 背景绘制修复roundbar 支持真圆角与可选描边,underline 下划线位置归位,roundhalf 半圆配色修正。
  6. 颜色解析修复RGB() 返回类型与 11 处颜色参数站点重打包,btnup/btndown/dotcolor 颜色不再串色,bk:=color(RGB(..)) 正常绘制。
  7. 热键触发修复增加虚拟键码与键名翻译,脚本按名字注册的热键在 launcher 中可以正常触发。
  8. pdesktop.fps帧率属性统一为小写 fps,旧的大写写法 FPS 仍兼容。

2026-09-19 · 运行时 0.1.0

  1. round4_3 圆角矩形背景bk:=round4_3 按半径绘制圆角矩形:填充色 2/3 强度源覆盖、可选描边、内缩/外扩边距均正常;修复负内缩整体不显示与正内缩四角通透斜线(圆弧描边 alpha 溢出)两个缺陷,已经用户验收。
  2. imgtile 图像平铺bk:=imgtile 按帧尺寸在对象矩形内平铺,9 帧自动九宫格贴图;方法与对象透明度相乘,支持 BMP/PNG/GIF,加载失败用背景色兜底;图片背景已在 Windows 原生 CPU 启动器验证,GPU 图片背景尚未验收,himgtile/vimgtile/imgscale 仍为占位。
  3. _T 文本居中与动画恢复半透明加亮、向上飘出和淡出删除;以整段文本居中,中文缺字时回退到 TTF 字体。
  4. 窗口缩放与运行版本绘制前同步客户区尺寸与布局,缩放不再重建或叠加 _T,已有动画保持进度;launcher 与 objsys 统一使用 0.1.0 三段式版本号并输出启动日志。
  5. colorex 与 glowcolorex 正确使用对象透明度与 RGB 颜色;glow 修复颜色偏差并恢复持续闪烁,flashspeed 表示闪烁速度而非次数。
  6. ellipse 动态尾迹将“椭圆环绕”统一命名为 ellipse,恢复两段对称的渐隐尾迹;支持负边距向外扩展,并遵守父容器裁剪。
  7. rect 双颜色边框上边和左边使用第一色,下边和右边使用第二色;修复 RGB 转换、默认第二色及边距绘制。
  8. dlg 图片背景支持 res$dlgbk.gif 与 res$defbk.gif 内置资源、9/10 图块平铺和顶部居中装饰;方法与对象透明度相乘,透明区域、裁剪及缩放后显示正确,并释放不再使用的纹理。