# **宏指令**
本篇为进阶篇，通过学习本篇，你可以掌握 Alterful 的增强功能即宏指令的使用。
宏指令可以说是整个 Alterful 中相当精彩的一章，通过宏指令不仅能完成对 Alterful 自身的一些设置，还能实现许多让人感到舒爽的快捷操作，具体请看下面的详解。
---
### 宏原型
**``@``** + **``宏指令``** + **``···``**
### 宏指令表
| 宏指令 | 功能 |
| --- | --- |
| @add a b | 添加启动项a，指向路径为b |
| @add a b | 添加启动项a，路径为启动项b所指向的路径 |
| @del a | 删除启动项a |
| @add #a b | 添加常引用a，引用值为b |
| @del #a | 删除常引用a |
| @new file in directory | 在某位置中新建一个文件并打开（含后缀） |
| @locate a | 定位到启动项a所在目录 |
| @set [prop] [value] | 查看可选设置 / 查看设置值 / 设置 |
| @restart | 重新启动 Alterful |
| @update | 检查新版本并更新 |
| @locate a b ... | 在资源管理器中定位启动项 a, b, ... |
| @version | 检查本地当前版本 |
## **添加宏（@add）**
- 添加启动项：`@add 自定义启动名 文件路径`
例子：`@add chrome C:\Program Files (x86)\Google\Chrome\Application\chrome.exe`
作用：将 Chrome 添加为 Alterful 启动项，启动名为 chrome。
效果：使用热键 Alt + A 唤出 Alterful 指令框，键入 chrome 回车，Chrome 被打开。
> 扩展语法：
> 创建启动别名：@add 自定义启动名 源启动名
> 例子：`@add llq chrome`
> 作用：创建 llq 启动名，指向 chrome 所指向的启动项路径
> 效果：在 Alterful 指令框中键入 chrome 或 llq 均可启动 Alterful
- 添加常引用：`@add #常引用名 常引用内容`
例子：`@add #bing chrome/bing.com`
作用：将 chrome/bing.com 添加为 Alterful 常引用项，引用名为 bing。
效果：使用热键 Alt + A 唤出 Alterful 指令框，键入 `#bing` 回车，必应在 Chrome 中被打开。
> 常引用扩展：
> 使用加号进行常引用衔接：[指令段1 + ] #常引用 [ + 指令段2]
> 例子：`@add #fy chrome/fanyi.baidu.com/#zh/en/`
> 使用：`#fy+键盘增强`
> 效果：在 Chrome 中打开了百度翻译，并显示“键盘增强”的中译英结果
- 添加常指令：`@add 常指令名([可选参数1], [可选参数2], ..., [可选参数n])`
例子：@add CreateDirectoryC(DirName)，回车后键入以下 cmd 代码，使用热键 Alt + S 确认编辑
```
> cd c:\
> mkdir DirName
```
作用：创建并存储自定义常指令 CreateDirectoryC，用于在 C 盘创建一个文件夹
效果：使用热键 Alt + A 唤出 Alterful 指令框，键入 CreateDirectoryC(TestDir) 回车，C 盘下创建了 TestDir 文件夹
## **删除宏（@del）**
- 删除启动项：`@del 启动名`
例子：`@del chrome`
作用：删除启动名 chrome
> 扩展语法：
> 同时删除多个启动名：@del 启动名1 启动名2 ... 启动名n
> 例子：@del chrome llq
> 作用：同时删除启动名 chrome 和 llq
- 删除常引用：`@del #常引用名`
例子：`@del #bing`
作用：删除常引用 bing
- 删除常指令：`@del 常指令名(\[参数签名\])`
例子：`@del CreateDirectoryC(p1)`
作用：删除带有一个参数的 CreateDirectoryC 常指令
## **设置宏（@set）**
- 查询可设置项：`@set`
- 查询设置项的现行值和可选值：`@set 设置项`
例子：@set Theme
作用：查看 Alterful 可选主题及现行主题
- 设置设置项的现行值：`@set 设置项 设置值`
例子：@set Theme Docks
作用：将 Alterful 主题设置为 Docks
## **新建宏（@new）**
- 创建临时文件并打开：`@new 文件名.文件扩展名`
例子：`@new Demo.docx`
作用：在 Alterful\\ATemp 文件夹下创建并打开了临时文档 Demo.docx
- 在指定目录下创建临时文件并打开：`@new 文件名.文件扩展名 in 创建路径`
其中创建路径可以是具体路径，也可以是任意启动名。对于以启动名作为启动路径的，若启动项是目录则在相应目录下创建文件，若启动项是特定文件则在启动项同级目录下创建文件
例子：`@new wallpaper.psd in psd`，其中 psd 是目录启动项
作用：在 psd 目录下创建并打开了文档 wallpaper.psd
## **定位宏（@locate）**
- 定位到启动项目录：`@locate 启动名1 [启动名2 ...]`
## **版本宏（@version）**
- 检查当前本地版本：`@version`
## **预设指令**
尚未完成重构
