-
Notifications
You must be signed in to change notification settings - Fork 6
Installation
- Windows 10 或 Windows 11 (64 位)
- 用源码运行时需要 AutoHotkey v2 2.0 或更新版本; 发布的 exe 不需要
ALTRun 是绿色软件, 不需要安装, 不写注册表。
- 从 Releases 下载最新版本, 解压到任意文件夹 (例如
D:\Apps\ALTRun)- 或者克隆仓库, 双击
ALTRun.ahk用 AutoHotkey v2 运行
- 或者克隆仓库, 双击
- 运行后托盘出现 ALTRun 图标, 按
Alt+Space呼出搜索窗口 - 第一次运行会在后台建立应用索引, 几秒后就能搜到开始菜单里的程序
不要放在需要管理员权限才能写入的文件夹 (例如 C:\Program Files), ALTRun 需要在自己的目录里保存设置。
Scoop 是 Windows 的命令行软件管理工具。ALTRun 的仓库本身就是一个 Scoop bucket:
scoop bucket add altrun https://github.com/zhugecaomao/ALTRun
scoop install altrun- 安装后开始菜单里有 "Scoop Apps → ALTRun", 程序在
scoop\apps\altrun\current - 升级: 先退出 ALTRun, 再运行
scoop update altrun。设置和数据 (Data\, 包括Data\ALTRun.json)、Themes\都会保留 - 卸载:
scoop uninstall altrun, 设置留在scoop\persist\altrun, 重新安装后自动恢复; 连设置一起删除用scoop uninstall altrun --purge - 用 Scoop 安装时, "检查更新" 发现新版本会提示用
scoop update altrun升级, 不要手动解压覆盖
winget 清单已经准备好 (packaging\winget), 等 winget 官方仓库 收录后就可以:
winget install zhugecaomao.ALTRun
winget upgrade zhugecaomao.ALTRun # 以后升级 (先退出 ALTRun)- 程序在
%LOCALAPPDATA%\Microsoft\WinGet\Packages\zhugecaomao.ALTRun_..., 命令行里可以直接输入altrun启动 - winget 本身不创建开始菜单快捷方式: 第一次用
altrun启动后, ALTRun 会自己添加到开始菜单 (偏好设置 → 通用 → "添加到开始菜单") - 卸载前先在 偏好设置 → 通用 里关闭 "开机自动启动"、"添加到开始菜单"、"添加到 '发送到' 菜单", 否则这些快捷方式会留下
- 第一次运行时 Windows 可能提示 "无法验证发布者" (程序是从网上下载的), 选择 "运行" 即可
- 升级和卸载都保留设置、
Data\、Themes\; 卸载后想彻底删除, 手动删掉上面的文件夹
| 文件 / 文件夹 | 说明 | 升级时 |
|---|---|---|
ALTRun.ahk 或 ALTRun.exe
|
主程序 | 替换 |
Lib\ Src\
|
程序代码 (源码版) | 替换 |
Resources\ |
随程序发布的数据: 简繁对照表、内置主题 | 覆盖 |
Data\ALTRun.json |
你的全部设置和自定义命令、片段 | 保留 (自动升级格式) |
Data\ 里的其它文件 |
应用索引、文件索引、学习记录、剪贴板历史、使用统计 | 保留 (删掉会重新生成) |
Themes\ |
你自己的主题 | 保留 |
在 偏好设置 → 通用 里设置:
- 开机自动启动: 在 "启动" 文件夹里创建快捷方式
- 添加到开始菜单: 可以从开始菜单打开 ALTRun
- 添加到 "发送到" 菜单: 在资源管理器里右键文件 → 发送到 → ALTRun, 把它加为自定义命令 (1 个时弹出编辑对话框, 多个时直接全部添加)
ALTRun 在后台到 GitHub 检查新版本 (启动时和之后每 6 小时一次) (偏好设置 → 通用 → "自动检查更新")。和 Alfred 一样不弹窗: 发现新版本后, 呼出搜索窗口时空搜索框下面会显示一条 "发现新版本: ALTRun x" (下面一行是当前版本和按键说明) (输入 更新 / update 也能找到):
-
Enter: 安装更新。下载新版本, 核对 SHA256 校验值, 替换程序文件后自动重新启动。Data\(设置和数据)、Themes\不会改动 -
→: 更新说明 (打开 GitHub 上这个版本的说明), 或 跳过此版本 (有更新的版本时再提醒)
开机后先等 1 分钟 (网络可能还没连上), 离上次检查满 1 小时就检查, 所以每天开机就能发现前一天发布的版本; 之后每小时看一下离上次检查是否满 6 小时。检查的时间和跳过的版本记在 Data\Update.json, 改完设置重新载入 ALTRun 不会反复检查。网络不通时只写日志, 一小时后再试。
想马上检查: 托盘菜单 → "检查更新", 或搜索 "检查更新" (CheckUpdate)。手动检查总会弹出结果: 已是最新版本, 或 "ALTRun 有可用的更新" 对话框: 安装更新 / 更新说明 / 稍后。
更新过程中出现任何问题 (网络、校验、写入权限), 原来的程序保持不变, 并提示打开下载页面手动更新。命令行 ALTRun.exe -Update 会直接检查并安装更新, 不询问。
以下情况不能一键更新, 搜索窗口里的那一条会说明怎么做:
- 用 Scoop / winget 安装:
Enter复制升级命令 (scoop update altrun/winget upgrade zhugecaomao.ALTRun), 退出 ALTRun 后在终端里运行 - 运行源码
ALTRun.ahk: 用git pull更新, 或Enter打开下载页面 - 程序放在没有写入权限的文件夹里:
Enter打开下载页面
把新版本复制覆盖到程序目录即可, 设置和数据不受影响。设置文件的格式有变化时, ALTRun 启动时会自动升级, 并先备份原文件。
- 托盘图标 → 退出旧版本
- 把新版本的压缩包解压到原来的 ALTRun 文件夹, 覆盖
ALTRun.exe - 运行
ALTRun.exe
第一次运行时, 旧版本的 ALTRun.ini 会自动导入 (设置、自定义命令、热键), 保存为新的 Data\ALTRun.json。ALTRun.ini 保持不变: 想退回旧版本, 放回旧的 ALTRun.exe 即可。开机启动、开始菜单、"发送到" 的快捷方式沿用同一个 ALTRun.exe, 不需要重新设置。
- 保留: 呼出热键、开机启动等通用设置; 用户命令 (File / Dir / CMD / URL → 自定义命令, Clip → 文字片段); 索引目录、文件类型和深度; 结构计算开关; 对话框快速跳转; 一键加日期 (Ctrl+D); PT 工具箱设置; 条件热键
- 不再保留: 内置命令列表 (由 系统命令 取代)、旧的索引 (会重新建立)、执行历史、使用统计、旧的列表外观选项
旧版本的 Res\ 文件夹已改名为 Resources\, 启动时会自动把 Res\ 里你自己放的文件移过去。
- 托盘菜单 → 退出
- 在 偏好设置 → 通用 里先关闭 "开机自动启动"、"添加到开始菜单"、"添加到 '发送到' 菜单" (或者手动删除对应的快捷方式)
- 删除程序文件夹