# 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 的回显信息。 ## 预设指令 尚未完成重构