Repository navigation
Installation zh
English · 中文
- Windows 10 或 Windows 11 (64 位)
- 用源码运行时需要 AutoHotkey v2 2.0 或更新版本; 发布的 exe 不需要
- 不需要 .NET、Electron 或其他运行库; 程序约 2.5 MB
ALTRun 是绿色软件, 不需要安装, 不写注册表。
- 从 Releases 下载最新版本, 解压到任意文件夹 (例如
D:\Apps\ALTRun)- 或者克隆仓库, 双击
ALTRun.ahk用 AutoHotkey v2 运行
- 或者克隆仓库, 双击
- 运行后托盘出现 ALTRun 图标, 按
Alt+Space呼出搜索窗口 - 第一次运行会在后台建立应用索引, 几秒后就能搜到开始菜单里的程序
第一次运行时如果 Windows SmartScreen 提示 "Windows 已保护你的电脑", 点 更多信息 → 仍要运行; 杀毒软件误报见 常见问题。
建议放在自己能写入的文件夹里 (例如 D:\Apps\ALTRun), 设置和数据保存在程序目录的 Data\ 里, 整个文件夹可以直接带走。放在需要管理员权限才能写入的文件夹 (例如 C:\Program Files) 时, 设置和数据改为保存在 %APPDATA%\ALTRun\, 但一键更新不能替换程序文件, 要手动下载新版本。
ALTRun 已经收录在 winget 官方仓库 里 (Windows 10 / 11 自带 winget)。新版本要经过微软审核才会出现在 winget 里, 一般在发布后 1–3 天:
winget install zhugecaomao.ALTRun
winget upgrade zhugecaomao.ALTRun # 以后升级 (先退出 ALTRun)- 程序在
%LOCALAPPDATA%\Microsoft\WinGet\Packages\zhugecaomao.ALTRun_..., 命令行里可以直接输入altrun启动 - 升级和卸载只删除 zip 里原有的文件, 设置和数据 (
Data\、Themes\) 会保留;winget uninstall --purge才会连同它们一起删除, 或者卸载后手动删掉上面的文件夹 - winget 本身不创建开始菜单快捷方式: 第一次用
altrun启动后, ALTRun 会自己添加到开始菜单 (偏好设置 → 通用 → "添加到开始菜单") - 卸载前先在 偏好设置 → 通用 里关闭 "开机自动启动"、"添加到开始菜单"、"添加到 '发送到' 菜单", 否则这些快捷方式会留下; 延迟启动的各项也要先删除, 见 卸载
- 第一次运行时 Windows 可能提示 "无法验证发布者" (程序是从网上下载的), 选择 "运行" 即可
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升级, 不要手动解压覆盖
| 文件 / 文件夹 | 说明 | 升级时 |
|---|---|---|
ALTRun.ahk 或 ALTRun.exe
|
主程序 | 替换 |
Lib\ Src\
|
程序代码 (源码版) | 替换 |
Resources\ |
随程序发布的数据: 简繁对照表、内置主题、界面语言、图标 | 覆盖 |
Data\ALTRun.json |
你的全部设置和自定义命令、片段 | 保留 (自动升级格式) |
Data\ 里的其它文件 |
应用索引、文件索引、学习记录、剪贴板历史、使用统计 | 保留 (删掉会重新生成) |
Themes\ |
你自己的主题 | 保留 |
Scripts\ |
你自己的脚本 | 保留 |
在 偏好设置 → 通用 里设置:
- 开机自动启动: 在 "启动" 文件夹里创建快捷方式。新安装 (还没有设置文件) 第一次启动时会问 "开机时自动启动 ALTRun?", 点 "是" 之前不写 "启动" 文件夹; 没回答就关掉了算关, 以后不再问。升级的保留原来的设置, 不问。它会出现在 任务管理器 → 启动应用 里; 在那里禁用后, 偏好设置里这一项显示为关闭, 重新勾选时也会在任务管理器里启用
- 添加到开始菜单: 可以从开始菜单打开 ALTRun
- 添加到 "发送到" 菜单: 在资源管理器里右键文件 → 发送到 → ALTRun, 把它加为自定义命令 (1 个时弹出编辑对话框, 多个时直接全部添加)
- 一键升级: 托盘图标 → 检查更新 → 安装更新
- 用 winget 安装的:
winget upgrade zhugecaomao.ALTRun - 用 Scoop 安装的:
scoop update altrun
下面是详细说明。
ALTRun 在后台到 GitHub 检查新版本 (启动时和之后每 6 小时一次) (偏好设置 → 通用 → "自动检查更新")。和 Alfred 一样不弹窗: 发现新版本后, 呼出搜索窗口时空搜索框下面会显示一条 "发现新版本: ALTRun x" (下面一行是当前版本和按键说明) (输入 更新 / update 也能找到):
-
Enter: 安装更新。在后台下载新版本 (下载时 ALTRun 照常响应; 进度窗口里点 取消 或按Esc可以停止), 核对 SHA256 校验值, 替换程序文件后自动重新启动。Data\(设置和数据)、Themes\不会改动 -
→: 更新说明 (打开 GitHub 上这个版本的说明), 或 跳过此版本 (有更新的版本时再提醒)
开机后先等 1 分钟 (网络可能还没连上), 离上次检查满 1 小时就检查, 所以每天开机就能发现前一天发布的版本; 之后每小时看一下离上次检查是否满 6 小时。检查的时间和跳过的版本记在 Data\Update.json, 改完设置重新载入 ALTRun 不会反复检查。网络不通时只写日志, 一小时后再试。
想马上检查: 托盘菜单 → "检查更新", 或搜索 "检查更新" (CheckUpdate)。手动检查总会弹出结果: 已是最新版本, 或 "ALTRun 有可用的更新" 对话框: 安装更新 / 更新说明 / 稍后。
更新过程中出现任何问题 (网络、校验、写入权限), 原来的程序保持不变, 并提示打开下载页面手动更新。命令行 ALTRun.exe -Update 在 ALTRun 还没运行时直接检查并安装更新, 不询问; ALTRun 已经在运行时会先询问, 和托盘菜单里检查更新一样。
以下情况不能一键更新, 搜索窗口里的那一条会说明怎么做:
- 用 winget / Scoop 安装:
Enter复制升级命令 (winget upgrade zhugecaomao.ALTRun/scoop update 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); 条件热键
- 不再保留: 内置命令列表 (由 系统命令 取代)、旧的索引 (会重新建立)、执行历史、使用统计、旧的列表外观选项
旧版本的 Res\ 文件夹已改名为 Resources\, 启动时会自动把 Res\ 里你自己放的文件移过去。
- 在 偏好设置 → 通用 里关闭 "开机自动启动"、"添加到开始菜单"、"添加到 '发送到' 菜单" (或者手动删除对应的快捷方式); 勾选过 偏好设置 → 自定义热键 → "在管理员窗口里也生效" 的, 也先取消勾选, 这样会删掉它建的计划任务
- 在 偏好设置 → 延迟启动 里删除所有项目, 点确定: ALTRun 会删除它在任务计划程序里建的任务 (文件夹
\ALTRun\<用户名>), 对被它关掉自己启动的程序, 逐个问要不要让它重新自己启动。不删除的话, 这些任务会留下并继续启动那些程序, 程序自己的启动也一直关着 (手动处理: 在任务计划程序里删掉ALTRun文件夹, 在 任务管理器 → 启动应用 里重新启用这些程序) - 托盘菜单 → 退出
- 删除程序文件夹
- 想彻底删除的话, 再删掉
%LOCALAPPDATA%\ALTRun(剪贴板历史、图标缓存; 程序目录不能写入时设置在%APPDATA%\ALTRun),%Temp%\ALTRun.log(调试日志, 打开过才有), 以及%Temp%\ALTRun\(文件夹同步的日志)。数据文件夹换过位置 (偏好设置 → 高级 → 数据) 的, 那个文件夹也要删。所有文件的位置见 数据文件
ALTRun · GPL-3.0 · Something wrong or unclear? Open an issue or edit docs/wiki · 文档有误或不清楚? 欢迎提交 Issue 或修改 docs/wiki
English
- Getting started
- Installation and upgrades
- Search and shortcuts
- Pinned and recent items
- File search
- Browser bookmarks
- Web search
- Window switching
- Custom commands
- Snippets
- Clipboard history
- Calculator
- System commands and terminal
- Scripts
- Custom hotkeys
- Delayed start
- Folder sync
- Themes
- Quick Switch
- Dialog Folder Panel
- Date Stamp
- PT Tools
- Extensions
- Settings reference
- Data files
- Privacy and network access
- FAQ
- Development guide
- Contributing
- 5 分钟上手
- 安装与升级
- 搜索与快捷键
- 置顶和最近使用
- 文件搜索
- 浏览器书签
- 网页搜索
- 窗口切换
- 自定义命令
- 文字片段
- 剪贴板历史
- 计算器
- 系统命令和终端
- 脚本扩展
- 自定义热键
- 延迟启动
- 文件夹同步
- 主题
- 对话框快速跳转
- 对话框文件夹面板
- 一键加日期
- PT 工具箱
- 扩展功能
- 设置文件参考
- 数据文件
- 隐私与网络访问
- 常见问题
- 开发指南
- 参与贡献