Skip to content

Installation zh

zhugecaomao edited this page Nov 17, 2026 · 9 revisions

English · 中文

安装与升级

系统要求

  • Windows 10 或 Windows 11 (64 位)
  • 用源码运行时需要 AutoHotkey v2 2.0 或更新版本; 发布的 exe 不需要
  • 不需要 .NET、Electron 或其他运行库; 程序约 2.5 MB

安装

ALTRun 是绿色软件, 不需要安装, 不写注册表。

  1. 从 Releases 下载最新版本, 解压到任意文件夹 (例如 D:\Apps\ALTRun)
    • 或者克隆仓库, 双击 ALTRun.ahk 用 AutoHotkey v2 运行
  2. 运行后托盘出现 ALTRun 图标, 按 Alt+Space 呼出搜索窗口
  3. 第一次运行会在后台建立应用索引, 几秒后就能搜到开始菜单里的程序

第一次运行时如果 Windows SmartScreen 提示 "Windows 已保护你的电脑", 点 更多信息 → 仍要运行; 杀毒软件误报见 常见问题。

建议放在自己能写入的文件夹里 (例如 D:\Apps\ALTRun), 设置和数据保存在程序目录的 Data\ 里, 整个文件夹可以直接带走。放在需要管理员权限才能写入的文件夹 (例如 C:\Program Files) 时, 设置和数据改为保存在 %APPDATA%\ALTRun\, 但一键更新不能替换程序文件, 要手动下载新版本。

用 winget 安装

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 安装

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 启动时会自动升级, 并先备份原文件。

从 2.x (v2026.08.12 及更早) 升级到 3.0

  1. 托盘图标 → 退出旧版本
  2. 把新版本的压缩包解压到原来的 ALTRun 文件夹, 覆盖 ALTRun.exe
  3. 运行 ALTRun.exe

第一次运行时, 旧版本的 ALTRun.ini 会自动导入 (设置、自定义命令、热键), 保存为新的 Data\ALTRun.json。ALTRun.ini 保持不变: 想退回旧版本, 放回旧的 ALTRun.exe 即可。开机启动、开始菜单、"发送到" 的快捷方式沿用同一个 ALTRun.exe, 不需要重新设置。

  • 保留: 呼出热键、开机启动等通用设置; 用户命令 (File / Dir / CMD / URL → 自定义命令, Clip → 文字片段); 索引目录、文件类型和深度; 结构计算开关; 对话框快速跳转; 一键加日期 (Ctrl+D); 条件热键
  • 不再保留: 内置命令列表 (由 系统命令 取代)、旧的索引 (会重新建立)、执行历史、使用统计、旧的列表外观选项

旧版本的 Res\ 文件夹已改名为 Resources\, 启动时会自动把 Res\ 里你自己放的文件移过去。

卸载

  1. 在 偏好设置 → 通用 里关闭 "开机自动启动"、"添加到开始菜单"、"添加到 '发送到' 菜单" (或者手动删除对应的快捷方式); 勾选过 偏好设置 → 自定义热键 → "在管理员窗口里也生效" 的, 也先取消勾选, 这样会删掉它建的计划任务
  2. 在 偏好设置 → 延迟启动 里删除所有项目, 点确定: ALTRun 会删除它在任务计划程序里建的任务 (文件夹 \ALTRun\<用户名>), 对被它关掉自己启动的程序, 逐个问要不要让它重新自己启动。不删除的话, 这些任务会留下并继续启动那些程序, 程序自己的启动也一直关着 (手动处理: 在任务计划程序里删掉 ALTRun 文件夹, 在 任务管理器 → 启动应用 里重新启用这些程序)
  3. 托盘菜单 → 退出
  4. 删除程序文件夹
  5. 想彻底删除的话, 再删掉 %LOCALAPPDATA%\ALTRun (剪贴板历史、图标缓存; 程序目录不能写入时设置在 %APPDATA%\ALTRun), %Temp%\ALTRun.log (调试日志, 打开过才有), 以及 %Temp%\ALTRun\ (文件夹同步的日志)。数据文件夹换过位置 (偏好设置 → 高级 → 数据) 的, 那个文件夹也要删。所有文件的位置见 数据文件

Clone this wiki locally