简言简语

快速上手

第一次上手最需要的内容。目标很直接：先把脚本写出来、跑起来、改起来。

简言简语是什么

你可以把 简言简语 理解成“让人和机器都能稳定看懂的脚本写法”。

它不像传统代码那么硬，也不像聊天文本那么散。你写的是一行一行的步骤，系统再按这些步骤去执行。

第一次先跑起来

先别追求复杂，先用最小脚本确认你已经能写出一段可执行的简言简语：

# 简言简语 v1

打印 内容="你好，世界"
等待 1
打印 内容="动作流执行完成"

你通常只需要改：两句提示内容和等待秒数。

这一段的目标：只确认脚本能跑，不追求一步到位。

正式脚本怎么开头

如果你把脚本保存成 .txt，首个非空行必须写：

# 简言简语 v1

最常见的正式写法是：

# 简言简语 v1

打印 内容="你好，世界"

.txt 是主推格式

适合大多数普通用户、入门用户和对外发送的脚本。

.jy 是专业格式

适合工程化管理、IDE 识别和语法高亮。当前不强制要求文件头。

最常见任务

从这里挑一个最接近你需求的任务块直接抄，再按“你通常只需要改这些地方”去改。

显示提示并等待

先确认脚本真的能跑，再继续往后加步骤。

# 简言简语 v1

打印 内容="你好，世界"
等待 1
打印 内容="动作流执行完成"

你通常只需要改这些地方

  • 把两句提示内容改成你自己想显示的话。
  • 把 1 改成你想等待的秒数。

容易写错什么

  • 保存成 .txt 时，文件头不要漏。
  • 带空格的内容尽量加引号。

处理一批文件

先拿到一批文件，再一个个处理。

# 简言简语 v1

设置 源目录 "D:/素材"
查看目录内容 目录路径={源目录} 保存为=文件列表
遍历 {文件列表.条目} 存入=文件
  打印 内容={文件.路径}
结束

你通常只需要改这些地方

  • 通常只改源目录。
  • 后面想做复制、移动、改名，就把遍历里面那一行换成对应动作。
  • 文件列表、文件 这两个名字第一次可以先不用改。

容易写错什么

  • 不要漏掉最后的结束。
  • 第一次调试时，优先先输出路径看看结果对不对。

读取并修改文本

把文件内容读出来，改掉旧文字，再写回去。

# 简言简语 v1

读取文本文件 文件路径="D:/demo.txt" 保存为=文件内容
替换文本 原文本={文件内容} 要查找的文字="旧标题" 替换成="新标题" 保存为=替换结果
写入文本文件 文件路径="D:/demo.txt" 写入内容={替换结果.内容} 追加写入=false

你通常只需要改这些地方

  • 通常只改文件路径、查找内容、替换内容。
  • 如果要处理另一份文件，把文件路径换掉就行。

容易写错什么

  • 不想越写越长时，记得保留 追加写入=false。
  • 替换文本不会自动写回文件，后面那一步不要删。

按条件决定做不做

满足条件才继续，不满足就走另一条路。

# 简言简语 v1

如果 {数量} > 0
  打印 内容="有数据，继续处理"
否则
  打印 内容="没有数据，先停在这里"
结束

你通常只需要改这些地方

  • 通常只改条件和两段提示内容。
  • 你也可以把提示换成别的动作，比如写文件、打开程序。

容易写错什么

  • 如果、否则、结束要成套出现。
  • 条件里用到的变量，要先在前面准备好。

打开程序、文件或网页

先把目标打开，再继续后面的操作。

# 简言简语 v1

启动程序 程序="记事本"
等待 1
打开网页 网页地址="https://example.com"

你通常只需要改这些地方

  • 程序名换成你要打开的程序。
  • 网址换成你要访问的网页。

容易写错什么

  • 路径或网址里有空格时记得加引号。
  • 程序刚打开时，可以先等 1 秒再继续。

桌面点击与输入

点一下某个位置，再把文字输入进去。

# 简言简语 v1

点击 坐标="100,200"
等待 0.5
输入文本 文本内容="你好，世界"

你通常只需要改这些地方

  • 通常只改坐标和输入文本。
  • 如果想先保守测试，可以先把输入文本换成打印。

容易写错什么

  • 坐标不确定时不要直接在正式界面上试。
  • 输入前先确认光标已经在正确位置。

最容易写错的地方

保存成 .txt 却没写文件头

错误写法

打印 内容="你好，世界"

为什么错：当前 .txt 脚本首个非空行必须是 # 简言简语 v1。

正确写法

# 简言简语 v1

打印 内容="你好，世界"

少了结束

错误写法

如果 {数量} > 0
  打印 内容="有数据"

为什么错：这段判断还没收尾。

正确写法

如果 {数量} > 0
  打印 内容="有数据"
结束

遍历里没给当前项起名字

错误写法

遍历 {文件列表.条目}
  打印 内容={文件.路径}
结束

为什么错：后面的 {文件.路径} 没有对应的当前项名字。

正确写法

遍历 {文件列表.条目} 存入=文件
  打印 内容={文件.路径}
结束

想打开网址却没写完整链接

错误写法

打开网页 网页地址="example.com"

为什么错：有些场景下不写完整协议头，行为会不稳定。

正确写法

打开网页 网页地址="https://example.com"

推荐写法

先跑通，再加复杂逻辑

先确认最小脚本能跑，再加判断、批量处理、写回动作。

先复制，再移动

批量处理文件刚开始调试时，优先先用复制流程，确认结果没问题后再改成移动。

先读，再改，再写回

处理文本最稳的顺序通常是：读取文本文件 -> 替换文本 -> 写入文本文件。

第一次别急着改变量名

像“文件列表”“文件”这种名字，第一次照着抄时通常可以先保留，先把流程跑通。