快速开始
下载、首次扫描，以及必须先搞清的三件事：中央仓库、链接、计划。
更新于 · 2026-11-02
AgentHub 是一个纯本地的桌面应用。它不接管你的账号，不上传任何文件，所有写入都发生在你能看见的路径下。
安装
从 GitHub Releases 下载对应平台的安装包：
- macOS：
.dmg，支持 Apple Silicon 与 Intel，要求 macOS 12 或更高。 - Windows：
.msi，x64，要求 Windows 10 1809 或更高。
首次启动会自动执行一次全量扫描，耗时取决于本机 skills 目录的文件数量，通常在几百毫秒到两秒之间。
第一次打开会看到什么
- 总览：一张资源图谱，中央仓库连向你已安装的各个 agent，连线颜色代表状态（青绿＝已接管、铜金＝有待收敛的副本、珊瑚＝存在失效链接）。
- 技能库：按技能名分组，同名多份会被标出来，底栏实时计算「已选 N 项 · 预计节省 X」。
- Agent 环境：检测结果，列出每个 agent 的 CLI、应用包与配置目录是否命中。
三个必须先搞清的概念
中央仓库
一份技能只保留一个真身，放在仓库目录（默认在 ~/.agenthub 下）。其他位置不再保存副本，只保留指向它的链接。
链接
按平台选择链接方式，优先级：单条覆盖 > 全局默认 > 平台默认。
| 平台 | 默认方式 | 退路 |
|---|---|---|
| macOS / Linux | 符号链接 | 硬链接 → 复制 |
| Windows | 目录联接（junction） | 硬链接 → 复制 |
计划
任何写操作都不会直接落盘。你会先看到一份计划，逐条列出将新增、覆盖、删除的文件与 diff；确认后才执行，执行前自动备份，批次可整体回滚。
只读区（例如 agent 自带的只读技能）默认不参与接管，也不会被改写。