【$模块名/$模块名.h】

/**@ModuleTitle:

*  @version:     1.0
*  @platform:    win32(x86|x64)
*  @compiler:    source
*  @author:
*  @datetime:
*  @description:
*/
...

在每一个模块的入口头文件顶部都应当有的规范注释内容(否则会被白易插件"软性"认定为非法模块)

注:有特殊用途的会直接在表格最开始来标记并给出说明其效果机制,如无标记的则表示仅作示意参考。

字段名称

说明与规范

@ModuleTitle

模块的显示标题(可选,特殊用途)
在白易插件中将导入的模块显示为“$显示标题($模块名)”
仅作显示,不参与语义解析、不侵入源代码
不填时则模块显示名称为“$模块名”

@version

采用主次版本号规范(必填且严格规范,特殊用途)
格式:$主版本号.$次版本号
小数点为分隔符且仅限一个

示例

逻辑说明

1.01 == 1.1

小数点后数字视为同一级,1.01 与 1.1 等价

1.10 == 1.010

末尾补零不改变主次版本逻辑

1.01 > 1.0.1

第二个小数点及其后数字仅作开发参考,不作为有效版本比对(这里1.01=1.1,1.0.1=1.0,故1.1>1.0)


此外你还可以输入其他表示特殊版本含义的字符内容,
如:beta、rc、alpha(仅作示意,白易插件对版本检测机制会默认过滤掉非数字部分)
关于版本号匹配的作用详情=》系统模块版本管理问题.mht

@platform

指定目标运行平台及架构
格式:$平台($CPU架构)

平台

 CPU 架构(多个用 | 分隔)

 win32

 x86|x64


默认为win32(x86|x64),系统不区分平台填anysys,CPU不区分架构填anyarc,用户需按情况手动填写。

@compiler

源码(source)或特定的编译器版本(如 msvc140, msvc141)
默认为source,白易插件在生成时会依据菜单编译项自动填写

@author

$作者(可选)

@datetime

$发布日期(可选,如:2026-03-20),可再选含具体时间

@description

$该模块的简单功能用途描述(可选)