类对象支持库（不是扁平命令）。路径：支持库 → 扩展类库 → 日志类。
类型名必须写完整「日志类」。声明时自动创建，一般无需再调 创建*。
硬约束
- 类型名必须写「日志类」。
- 写文件/控制台日志；级别与路径以方法为准。
- 方法调用必须带括号。
快速开始
日志类 log
log.置路径("logs/app.log")
log.信息("启动")
log.错误("失败原因")
日志类/创建
共 1 条。
创建日志
- 签名：
通用 创建日志() - 说明：日志会话。一般直接写「日志类 log」，不必先调本命令。
日志类/方法
共 23 条。
打开
- 签名：
逻辑 打开(文本 路径, [整数 追加=1], [整数 级别=1]) - 说明：打开日志文件。失败返回假，可用取错误()查看原因。
- 参数一│文本 路径: 日志文件路径（可相对工程或绝对路径）
- 参数二│[整数 追加=1]: 1=追加写，0=覆盖新建
- 参数三│[整数 级别=1]: 最低输出级别：0调试 1信息 2警告 3错误 4致命
关闭
- 签名：
逻辑 关闭() - 说明：关闭日志文件。已关闭再调也返回真。
是否已打开
- 签名：
逻辑 是否已打开() - 说明：当前是否已成功打开日志文件。
重置
- 签名：
无 重置() - 说明：关闭文件并恢复默认选项（级别/控制台/时间戳/滚动等）。
置级别
- 签名：
逻辑 置级别(整数 级别) - 说明：设置最低输出级别；低于此级的写会被丢弃。
- 参数一│整数 级别: 0调试、1信息、2警告、3错误、4致命
取级别
- 签名：
整数 取级别() - 说明：取当前最低输出级别（0～4）。
写
- 签名：
逻辑 写(整数 级别, 文本 内容) - 说明：按指定级别写一行；级别不够则跳过仍返回成功。末尾无换行时自动补换行。
- 参数一│整数 级别: 0调试、1信息、2警告、3错误、4致命
- 参数二│文本 内容: 要写入的一行文本
调试
- 签名：
逻辑 调试(文本 内容) - 说明：写调试级（0）日志。
- 参数一│文本 内容: 日志正文
信息
- 签名：
逻辑 信息(文本 内容) - 说明：写信息级（1）日志。
- 参数一│文本 内容: 日志正文
警告
- 签名：
逻辑 警告(文本 内容) - 说明：写警告级（2）日志。
- 参数一│文本 内容: 日志正文
错误
- 签名：
逻辑 错误(文本 内容) - 说明：写错误级（3）日志。
- 参数一│文本 内容: 日志正文
致命
- 签名：
逻辑 致命(文本 内容) - 说明：写致命级（4）日志。
- 参数一│文本 内容: 日志正文
置控制台
- 签名：
逻辑 置控制台(整数 开启) - 说明：是否同时输出到控制台（stdout）。
- 参数一│整数 开启: 1=同时输出到 stdout，0=仅写文件
取控制台
- 签名：
整数 取控制台() - 说明：取当前是否输出到控制台：1 开、0 关。
置时间戳
- 签名：
逻辑 置时间戳(整数 开启) - 说明：是否在每行行首加本地时间。
- 参数一│整数 开启: 1=加时间戳，0=不加
取时间戳
- 签名：
整数 取时间戳() - 说明：取当前是否加时间戳：1 开、0 关。
置最大字节
- 签名：
逻辑 置最大字节(整数 字节数) - 说明：单文件超过该字节数时轮转；≤0 表示不按大小滚动。
- 参数一│整数 字节数: >0 启用滚动；0 或不调则不按大小轮转
取最大字节
- 签名：
整数 取最大字节() - 说明：取当前滚动阈值字节数（0 表示未启用）。
置备份数
- 签名：
逻辑 置备份数(整数 个数) - 说明：滚动时保留的备份文件个数。
- 参数一│整数 个数: ≥1；小于 1 时运行时会按至少 1 处理
取备份数
- 签名：
整数 取备份数() - 说明：取当前保留备份个数。
刷新
- 签名：
逻辑 刷新() - 说明：立即把缓冲刷到磁盘。
取路径
- 签名：
文本 取路径() - 说明：取最近一次打开() 传入的路径；未打开过则为空。
取错误
- 签名：
文本 取错误() - 说明：取最近一次失败原因；成功操作后一般为空。
易错对照
| 错误 | 正确 |
|---|---|
| 类型写成「日志」 | 必须「日志类」 |
| 路径未创建目录 | 先保证目录存在或看方法是否自动创建 |