> For the complete documentation index, see [llms.txt](https://chaoses-ib.gitbook.io/directory-opus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chaoses-ib.gitbook.io/directory-opus/guan-fang-shou-ce/readme.zh-6/readme.zh-1/ms-dos_batch_commands.zh.md).

# MS-DOS 批处理命令

Opus 按钮或热键功能可以设置为 *MS-DOS 批处理功能* 模式。此模式中的一个功能的运行方式就像 **.bat** 批处理文件一样，它可以使用 MS-DOS 命令、分支和逻辑指令，还可以运行仅设计为从命令行运行的外部程序。您还可以在批处理功能中包含常规 Opus 内部命令（请注意，当尝试使用 **Set** 或 **Copy** 等与内部命令冲突的外部命令时，可能会造成混乱 - 使用下面描述的 **@externalonly** 修饰符解决此问题）。

![](https://3597805814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3XSZSwWow0fDf6fQJobd%2Fuploads%2Fgit-blob-20cf435e08a959e547747c4dbbf68487d780f731%2Fdos_batch_function.png?alt=media)

上面的屏幕截图演示了一个简单的 MS-DOS 批处理功能示例。它使用 MS-DOS **dir** 指令生成当前源文件夹的目录列表。使用 **>** 重定向符号，目录列表将保存到目标路径中，文件名以当前源文件夹命名。

分解该功能：

* 使用 **Function** 下拉菜单将类型设置为 **MS-DOS Batch Function**。这对于使用 **dir** 指令是必要的 - **dir** 不是一个真正的程序或命令，它是一个仅由 MS-DOS 命令解释器理解的指令。
* 命令的第一行 **cd {sourcepath}** 将批处理脚本的当前目录设置为当前源文件夹。这是 **dir** 将生成其列表的文件夹。
* 第二个命令调用 **dir** 指令（\*\* /w\*\* 标志打开“宽”模式）。**>** 字符会重定向该命令的输出，在 **>** 后面，外部控制代码的组合会提供输出文件名。
  * **{destpath}** - 当前目标目录的路径
  * **{sourcepath|nopath|noterm}** - 当前源目录，不含路径或尾随终止符（即目录的名称）
  * **.txt** - 输出文件的扩展名。

当您运行 MS-DOS 批处理功能时，Opus 实际上会创建磁盘上的一个临时批处理文件，并在调用它之前将指令写入其中。如果您查看由上述功能创建的批处理文件，您将看到类似以下内容：

```
@echo off
chcp 1252 > nul
C:
cd "\Users\Jon\Documents"
dir /w > "C:\Test\Documents.txt"
```

这些指令会根据该功能的参数和定义自动写入到 **.bat** 文件。

* **@echo off** 是一个标准的 MS-DOS 指令，它可以防止在批处理文件运行时将每个命令都回显到提示窗口
* **chcp 1252 > nul** 初始化命令提示符的代码页（1252 是标准的 Windows 代码页）。
* **C:** 设置命令提示符的当前驱动器 - 这是从命令定义中的 **cd {sourcepath}** 指令自动生成的。
* **cd "\Users\Jon\Documents"** 设置当前驱动器上的当前目录 - 同样，这是从 **cd {sourcepath}** 指令自动生成的。
* **dir /w > "C:\Test\Documents.txt"** 负责生成实际的目录列表。在这个示例中，源文件夹名为 Documents，目标文件夹为 C:\Test\* - 所以由 **{destpath}{sourcepath|nopath|noterm}.txt** 生成的输出文件名为 C:\Test\Documents.txt。

[命令修饰符](/directory-opus/guan-fang-shou-ce/readme.zh-6/readme.zh-1/command_modifiers.zh.md) 中有几个与 MS-DOS 批处理功能特别相关：

* **@leavedoswindowopen** 可用于强制 DOS 提示窗口在函数完成之后保持打开（让您看到任何输出或错误消息）。
* **@codepage** 可用于将 DOS 提示符的代码页更改为默认值 *1252*。
* **@externalonly** 告诉 Opus 忽略可能与内部命令重合的任何命令名称（例如 Set 或 Copy）。通常情况下，内部命令会覆盖外部命令。
* **@nocall** 用于调用批处理文件而不将控制权返回给父函数。
* **@runbatch** 和 **@norunbatch** 控制外部程序和内部命令如何在 MS-DOS 批处理功能中进行交互
* **@runmode:hide** 可用于防止 DOS 提示窗口短暂闪烁。

有关命令修饰符的完整描述，请参见 [命令修饰符参考](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-2/command_modifier_reference.zh.md)。