# Alterful 精简文档
## 全局说明
- Alterful 唤醒热键：Alt + A
- 指令输入框按下 Alt 显示或隐藏回调框
- 快捷添加启动项：任意文件右键 -> 添加为 Alterful 启动项
- 补全状态下按 Tab 以确认补全并继续输入
- 指令框为空的状态下按下右方向键 ``→``，快速进入到命令行指令模式
- 键入`~`指令来退出 Alterful
## 宏指令
### 添加宏（@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 均可启动 Chrome
- 添加常引用：`@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 设置项 设置值`
> 例子：@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 启动名`
特别地，在单文件定位情况下宏定位法完全等价于启动后缀定位法，即`@locate item`等价于`item-f`，但区别在于定位宏可以支持多文件定位，如`@locate item1 item2 ...`
### 版本宏（@version）
- 检查当前本地版本：`@version`
### 重启 Alterful（@restart）
- 重新启动 Alterful
### 检查更新（@update）
- 检查新版本并更新（每次启动 Alterful 时会自动检查更新，若您平时不关电脑，可以使用该指令手动更新）
## 启动指令
### 单项启动
- 指令原型：`启动名`
### 多项启动
- 指令原型：`启动名1 启动名2 ... 启动名n`
### 参数启动
- 指令原型：`启动名/启动参数`
### 启动后缀
- 指令原型：`启动名-启动后缀-[启动后缀2]-...-[启动后缀n]`
预览版可选后缀：-f（文件定位）-o（打开文件）
## 命令行指令
使用热键 Alt + A 唤出 Alterful 指令框，键入 ``>`` + ``命令行`` 回车，即可直接在 Alterful 中执行同步 CMD 并取得返回文本。
也可直接在指令框为空的状态下按下右方向键 ``→``，快速进入到命令行指令模式。
例子：`> ipconfig`
效果：在 Alterful 输出信息中打印了 CMD 命令 ipconfig 的回显信息。
## 预设指令
尚未完成重构
