羽云十六进制编辑器 WIKI

写在前面

本页面是对WingHexExplorer2的引导页面，通知用户当前的项目情况，提供帮助文档的指引。软件v2.3.6已在2026/4/26发布，v2.3.7已在2026/5/31发布。欢迎感兴趣的同志来参与和贡献代码。

目前该项目的 GitHub Pages 已初步上线，后续将逐步完善，该博客将作为国内快速访问的简介入口。

如果你对该软件感兴趣，欢迎加 QQ 群：795491946 ，我会尽快审核通过，请注意遵守群规。

简介

一个自由的强大免费的十六进制编辑器，基于 QT C++ 进行开发，作者是寂静的羽夏。

如有 Bug, 欢迎反馈到 Github 上，如果你访问这有困难的话，也可以反馈到 Gitee 上。如果实在不行，可以通过我的博客园上公告栏的任意一种联系方式来告诉我。不过我还是希望你反馈到 Github 上方便我写递交注释的。

开源不易，也欢迎赞助或者参与代码和文档贡献，我默认会将您放入鸣谢标签的内容进行鸣谢。

许可证：AGPL-3.0

该软件经过长时间的迭代，目前成为了一个高自定义性、功能强大的十六进制编辑器。它具有以下功能特点：

基础的十六进制编辑查看编辑功能
支持打开 TB 级别的超大文件 （仅 64 位程序）
支持 标注（颜色标记、书签标记） ，且可以保存为工程文件以下次打开
自由定义布局、保存和导出自己常用布局 ， 自由切换 不同布局用于不同分析目的
支持 克隆编辑 ，在 同一时刻对同一个文件 对不同的地方进行浏览和编辑
现代的 Ribbon 菜单 ，方便醒目的找到自己想要的功能
十六进制视图自由缩放（Ctrl+滚轮），对标题、地址栏和解码字符串栏可以自由显示和隐藏
对常见的数据类型进行实时解码
支持校验和计算
极速查找字节和字符串
友好的标注可视化
多选区支持 （按住 Shift 会增加选区，Alt 会裁剪选区。在含有多个选区的情况下，不按住任何键拖放的选区会在鼠标释放按键之后消失。按住 Ctrl 选区会取消原有的选择的内容，同时按住 Shift 和 Alt 视为 Ctrl 的操作）
强大的脚本系统 ，用于批量分析二进制数据（AngelScript）
强大的插件系统 ，实现对软件的较高自由度定制和增强，并提供组件注册和基础的脚本系统函数绑定
内置脚本编辑器 ，自带语言服务器，提供代码填充和调试功能，并且支持代码格式化
内置暗黑和浅色主题

更新内容

本次更新版本号为2.3.7，包含一些的 Bug 修复和功能调整优化，下面是更新日志：

【严重】修复频繁显示 Toast 导致程序的崩溃
【中等】修复优化元数据标注的合并错误
【轻微】撤销元数据标注编辑会有残留的问题
【轻微】日志打印未完全将打印内容作为普通字符的问题
【调整】撤销命令合并策略调整，除了十六进制编辑，只有最后效果完全相同的操作才会被合并
【调整】十六进制区支持多字节解码，废弃多余的“文本预览”功能
【调整】新增修改十六进制宽度：8、16、20、24、32，默认 16
【调整】新增十六进制编辑区表头双击可修改地址、十六进制宽度、字符串解码编码
【调整】状态栏的编辑区显示下划线可指示光标是覆写还是插入
【调整】支持双游标编辑，非活跃的游标若深色偏亮、浅色偏暗
【调整】插入游标更改为和覆写游标近似的设计，但它有下划线标记，避免与元数据标记的下划线冲突
【调整】优化十六进制编辑撤销相关的健壮性
【调整】优化工作区打开相关代码，增强健壮性并提供更好的报错日志
【调整】工作区对元数据标记（800个）和书签数量（100个）以及文本记录内容（100字符）做了上限限制

如果发现有 Bug 月更，如果没有充足热度和赞助将停止功能性更新。

已知问题或缺陷

软件有些是已知问题，由于影响不大且不好解决的或者不提供支持维护的，就会被列到这里面。我不会主动去尝试修复它，因为我只要列到这里面，对于很多问题，我已经做了大量的尝试，但没有很好的解决。如果是上游问题，等上游解决之后，我有时间的时候同步一下就解决了。如果不是，那就等热心大佬 PR 吧。

对于第 2-3 问题，你可以通过非安全的注册方式来实现，但是，你需要很清楚 AngelScript 的通用调用机制，并且确保你对类型的转化和解引用操作都是正确的，确保返回值指针有效性，因为这个模式下不会有任何检查，否则指针会让你飞起来（感兴趣可以阅读WingAngelAPI::script_call相关代码）。

32 位程序不再提供支持，如需支持请联系我提供付费支持。
脚本安全注册方式返回值不支持数组和列表：是这样的，这个实现太麻烦了，如果要支持，我只能支持 QVariantList 作为返回值容器，但是，我不一定知道 QVariantList 装的东西是什么，进一步校验和转化也是很麻烦的问题。
脚本安全注册方式不支持引用：是这样的，实现方式不支持引用，要引用就需要指针，但我没有提供这个机制，反射也反射不出来。

后面更新

我将会根据知名度我会酌情偏向更新文档内容（目前没啥知名度和赞助，暂停）。

下次功能完善和修复版本号为2.3.8，下面是修复变更日志：

【轻微】Toast 消息在某些情况下会一闪而过的问题

下一次含有大功能更新版本号为2.4.0，该更新内容的完成度将会与用户量和赞助密切相关，目前没啥知名度和赞助，不实现：

实现脚本的帮助系统？
调试器支持 DAP ？
实现单独的 Headless 模式运行脚本进行批量分析？
支持 bundle 插件加载器，让单一插件文件支持多外部依赖自动加载打包和跨操作系统以及跨 CPU 平台加载？

FAQ

为啥不在搜索结果增加筛选排列功能（其他表格类控件同理）：
答：功能很好，但是在数据量很大的情况下，很卡，但我没有精力和经验来处理这个事情。
该软件和 WingHexExplorer 有什么区别，我还可以继续使用 WingHexExplorer 这个软件吗？
答：新版软件具有更强大的布局组件、跨平台和 UI 统一性。功能上自带 AngelScript 脚本引擎，相比于 Python 可能会有更好的 API 兼容性和速度（未测试），并且可以具有更好的 API 权限管控，会更安全一些。还有它更擅长处理多文件编辑，你可以对同一个文件同时在不同位置进行预览/编辑，这就是“克隆”功能。十六进制编辑器还增加了 Ctrl + 鼠标滚轮原生缩放支持。该软件对任意编辑中的文件窗体隐藏，哈希值计算，对书签更好的可视化以及标记的可视化和更好的插件支持，以及进一步的 Bug 修复。在 v2.0.0 规划完成发布之后，还会有深度配合的代码编辑器和调试器，正好是一个小型的 AngelScript IDE。这些都是 WingHexExplorer 软件所不具备的功能，这里还有很多小细节没说，这个软件会更加专业，也会更加好用。
WingHexExplorer 这个软件仍旧是能用的，但还是有点小 Bug，只要你不是深度使用是不会有问题的，比如预览和简单的编辑普通文件。但它有 Bug，我也不会去修了。
该软件和 WingHexExplorer 兼容吗？
答：项目文件是可以兼容的，但插件还是按照老约定，采用不兼容处理，因为变化太大了。

版本规划

当收到的指定赞助金额满足一定程度来开发以下列出的功能时，我将主动花费我的业余时间来完成这件事情。当然 PR 也是可以算作“赞助内容”，毕竟是贡献代码，以下所有的功能都接受 PR 。如果你想要通过赞助金额来支持该项目来开发功能的话，请注明备注该任务名称，我将会在该篇日志更新，金额达到之后就开始进入排队开发。如果注明仅 PR 的，则不接受金额赞助开发。一旦受赞助的功能开始开发，原则上不退款。这些赞助内容将会以 AGPL-3.0 开源发布。 目前考虑到的内容如下：

尝试增加 AngelScript 对 QT 用户界面组件的绑定尝试，可以通过脚本实现插件。（若指明赞助该功能 450 RMB，增加窗体、标签、按钮、文本框支持，其他暂不支持，除非 PR）
为脚本解释器增加 JIT。（目前仅 PR）
外部可自定义主题以及可更换图标。（100 RMB）
提供完全的 Generic Call 支持。（100 RMB）
脚本编辑器的代码片段管理器支持。（100 RMB）

当然也可以通过赞助来让我开发插件，插件可以选择开源和闭源，但如果赞助低于 500 RMB的，插件仅可选择开源，但可以自选开源基金会认可的开源协议。