文本与文件
插入文字到指定行数
将文字或变量内容插入到文本文件的指定行数，可选实时落盘，适用于在现有记录中插入新条目或补写内容。
命令用途
InsertLine 用于把文字或变量内容插入到指定文件的某一行。
它和 WriteLine 的区别在于：WriteLine 是覆盖原有行，InsertLine 是把新内容插入进去，原来的内容会整体后移一行。
命令名
InsertLine
调用格式
InsertLine <文件路径> <行数> <插入内容> [HardDisk]
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
文件路径 | 是 | 目标文本文件路径。 |
行数 | 是 | 需要插入到的行号，可以是固定数字，也可以是变量表达式。 |
插入内容 | 是 | 要插入的新文字或变量内容。 |
HardDisk | 否 | 实时读写物理硬盘；省略时优先操作当前内存中的文本内容。 |
返回或影响
- 该命令会把新内容插入到目标行位置。
- 原有该行及其后的内容会整体后移一行。
- 带
HardDisk时，会优先对物理文件执行插入。 - 不带
HardDisk时，通常操作当前内存中的文本状态。
示例
基础用法
#ACT
InsertLine ..\QuestDiary\排行榜\个人充值记录.ini 1 <$USERNAME>
这段写法会把当前角色名插入到排行文件第 1 行，原来的首行内容会顺延到后面。
常见变体
#ACT
InsertLine ..\QuestDiary\安抚系统\安抚数据分析.ini 1 <$STR(S10)> HardDisk
这段写法会把 S10 中的内容插入到文件开头，并立即写回硬盘，适合需要把最新结果推到最前面的场景。
注意事项
InsertLine不是覆盖写入；如果需要保留原位置，只是改掉这一行，请改用 WriteLine。- 如果要判断“是否真的插入成功”，建议在插入前确认行号和目标文件内容结构，避免把内容插到错误位置。
- 文本操作命令本身比较消耗资源，频繁对大文件做插入操作时要控制调用频率。