README.zht.md

June 6, 2026 · View on GitHub

Aether（以太）

Autonomous Engine for Theoretical & Hands-on Exploration in Research

面向科研人員的 AI 研究助手，基於 OpenCode 深度定制。

🌐 aether.aiphys.cn

English | 简体中文 | 繁體中文

專案簡介

Aether 是一個功能豐富的 AI 研究助手平台，基於本機客戶端/伺服器架構運行。提供兩種使用方式：

Web 瀏覽器版：在本機啟動 HTTP 服務，透過瀏覽器存取完整互動介面，更穩定
Electron 桌面版：原生桌面視窗，使用體驗更流暢（可能仍有不穩定之處）

兩種方式共享同一套本機資料和工作階段。此外支援行動端（微信 / 飛書 / QQ）接入。

核心特性

開箱即用：既可從官網下載安裝腳本執行安裝，也可下載 Releases 中的壓縮包安裝，內建預設模型配置
完整程式設計能力：完全繼承 OpenCode 的編碼能力，支援程式碼執行、LSP 程式碼感知、檔案和終端機操作，覆蓋日常開發全流程
25+ AI 提供商：支援 Anthropic、OpenAI、Google Gemini、AIhubmix、DeepSeek、Z.AI、Kimi、Qwen 等主流平台，以及任何 OpenAI 相容介面
20+ 個內建 Skills：文獻綜述、論文寫作、深度研究、arXiv 搜尋、同行評審、研究基金撰寫、文件產生等，開箱即用
Skill 自進化：Agent 在完成任務後自動評審對話歷史，將成功經驗固化為可複用的 Skill（copy-on-write 寫入、安全掃描、版本快照），形成持續學習閉環
MCP 協定支援：整合 Model Context Protocol，可連接本機或遠端 MCP 伺服器擴充工具集
知識庫（RAG）：將 PDF 和文字文件向量化索引，支援語義搜尋，按相關性注入上下文，大幅節省 Token
PDF 閱讀模式：在 Web 介面中直接閱讀 PDF，支援高亮標注、書籤、筆記，以及 AI 輔助翻譯和問答
PDF 轉 Markdown：AI 驅動的多階段處理流水線，將 PDF 論文高品質轉換為可編輯的 Markdown（含公式和圖片提取）
Markdown 翻譯：AI 翻譯 Markdown 文件，自動保護 LaTeX 公式不被破壞
語音輸入：基於多模態模型的語音轉文字，自動去除語氣詞並糾正專業術語
Git 整合：在介面中檢視分支、提交歷史、Diff 和檔案變更等
定時任務：支援 Cron 表示式、固定間隔和一次性定時任務，可自動執行研究流程
Memory 機制：AI 自動將使用者偏好和互動經驗持久化到本機記憶檔案，跨工作階段複用，無需重複說明
工作階段分享：產生分享連結，即時同步對話內容

安裝與啟動

Installer 腳本安裝（推薦）

從官網下載對應平台的 Installer 腳本，一鍵安裝並享受自動更新。安裝完成後直接從系統應用程式中點擊執行即可。

手動安裝

從 Releases 頁面下載對應平台的壓縮包。

Web 瀏覽器版

解壓後目錄結構：

aether              ← CLI 二進位（Windows 為 aether.exe）
web/                ← 前端靜態資源（必須與二進位同目錄）
install.sh/.command/.bat  ← 安裝腳本（‼️建立桌面捷徑、應用程式入口等）
Aether.sh / .command / .vbs  ← 啟動器
aether-icon.*       ← 應用程式圖示

推薦先執行安裝腳本，安裝完成後即可從系統應用程式中啟動 Aether：

Windows：右鍵 install.bat → 以系統管理員身分執行（或在終端機中執行）。安裝後從桌面捷徑或開始功能表啟動。

macOS：在解壓後的目錄下：

chmod +x install.command   # 首次需要
./install.command

若提示「無法驗證開發者」或「已損毀」：

xattr -cr ./install.command ./aether ./Aether.command

然後再右鍵點擊 install.command 選擇「開啟」進行安裝。安裝後從 /Applications/Aether.app 或 Launchpad 啟動。

Linux：

chmod +x install.sh   # 首次需要
./install.sh

安裝後從系統啟動台點擊 Aether 圖示啟動。（⚠️注意：舊版本會在桌面上建立的 sh 腳本已棄用）

如果不透過安裝腳本，也可直接執行啟動器（不推薦）：

Windows：雙擊 Aether.vbs。若被防毒軟體攔截，請選擇允許執行。

macOS：雙擊 Aether.command（需先 chmod +x）。

Linux：執行 ./Aether.sh 或 ./aether web。

aether web 啟動後會顯示本機和區域網路存取位址，瀏覽器自動開啟。

（如安裝過程中遇到其他問題，請先檢視常見問題，或透過官網聯繫）

Electron 桌面版

從 Releases 頁面下載對應平台的安裝包（注意選擇 Desktop 版本，而非 Web 版壓縮包）。

平台	檔案
Windows	`aether-desktop-win-x64.exe`（NSIS 安裝程式）
macOS Apple Silicon	`aether-desktop-mac-arm64.dmg`
macOS Intel	`aether-desktop-mac-x64.dmg`
Linux	`.AppImage` / `.deb` / `.rpm`

Windows：雙擊 .exe 安裝包，按安裝精靈完成。安裝後從開始功能表或桌面捷徑啟動。若防毒軟體提示風險，確認檔案來自官方 GitHub Release 後選擇保留並繼續。

macOS：開啟 .dmg，將 Aether Desktop.app 拖入 Applications。若提示無法驗證開發者，需要在「設定─安全性與隱私權」中，找到有關 Aether Desktop 的提示，點擊選擇「仍要開啟」。若提示「已損毀」，在終端機執行：

xattr -cr /Applications/Aether\ Desktop.app

Linux：

AppImage：

chmod +x ./aether-*.AppImage
./aether-*.AppImage

deb：

sudo dpkg -i ./aether-desktop*.deb

rpm：

sudo dnf install ./aether-desktop*.rpm

說明：桌面版與 Web/CLI 共享同一套資料目錄（~/.local/share/aether），已有使用者可無縫切換。桌面版目前未做程式碼簽章，macOS 更新為手動模式（檢查後開啟 GitHub Release 頁面下載），Windows 和 Linux AppImage 支援應用程式內更新。Linux deb 和 rpm 包暫不支援自動更新，類似 macOS，也需在彈窗提醒後手動下載最新安裝包覆蓋安裝。

從原始碼執行

適用於開發除錯。依賴： Bun 1.3+

bun install

Web UI 開發模式

需要兩個終端機分別啟動後端和前端：

# 終端機 1：啟動 API Server
bun dev serve

# 終端機 2：啟動前端（然後開啟顯示的 http://localhost:xxxx）
bun run --cwd packages/app dev

網頁開啟後如果發現資源載入失敗，可以手動新增終端機 1 中顯示的 http://localhost:xxxx 到伺服器列表中。

桌面版開發模式

# 終端機 1：啟動 API Server
bun dev serve

# 終端機 2：啟動桌面端
bun run --cwd packages/desktop-electron dev

設定 AI 提供商

可使用預建免費提供商，也可透過設定介面新增 AI 提供商（推薦）。

功能詳解

內建 Skills

Aether 預建了 20+ 個面向科研和日常場景的 Skills，透過描述自動觸發，無需手動呼叫：

類別	Skill	功能
開發工具	`skill-creator`	建立和最佳化 Agent Skills
	`skill-manager`	掃描、分類和管理 Skills 集合
	`skill-security-auditor`	AI Skill 安全稽核與漏洞掃描
	`code-reviewer`	程式碼審查（安全、效能、最佳實踐）
	`project-signpost`	產生專案目錄導航檔案
	`prepare-for-git-commit`	Git commit 前的程式碼檢查與訊息撰寫
學術研究	`academic-researcher`	文獻綜述、論文分析、公式推導
	`literature-review`	多資料庫系統文獻綜述
	`peer-review`	同行評審工具包
	`write-paper`	從研究專案檔案產生 LaTeX 論文
	`deep-research`	多源綜合深度研究
	`arxiv-search`	搜尋 arXiv 預印本
	`read-arxiv-paper`	閱讀和分析 arXiv 論文
	`research-grants`	撰寫研究基金申請書
	`research-grants-ch`	撰寫中國科研基金申請書（國自然、博後基金等）
	`scientific-critical-thinking`	科學證據品質評估
	`scientific-brainstorming`	科研假設產生與跨學科探索
	`response-to-referee`	逐條回覆審稿人意見
通用	`brainstorming`	在實作之前將想法轉化為設計方案
	`clawhub`	從 ClawHub 搜尋和安裝 Agent Skills
	`docx`	建立和編輯 Word 文件
	`excel-analysis`	分析 Excel 試算表
	`ppt-generation`	產生 PowerPoint 簡報

學術 Skills 可串聯使用：arxiv-search → read-arxiv-paper → literature-review → write-paper

知識庫

將 PDF 論文或文字文件（.md、.txt、.json、.yaml、.csv、.tex）批次向量化索引：

三種嵌入方式：OpenAI API、本機模型 all-MiniLM-L6-v2（無需 API Key）、自訂介面
語義搜尋：基於餘弦相似度檢索最相關段落，只注入必要的上下文，而非整篇文獻
自動同步：偵測檔案增刪改，自動更新索引

PDF 閱讀模式

在 Web 介面中直接閱讀 PDF：

標注系統：高亮（四種顏色）、書籤、筆記
AI 輔助翻譯：保留專業術語的英中翻譯
AI 問答：基於目前頁及上下文頁面的內容回答問題
首次閱讀摘要：開啟文件時自動產生全文摘要

PDF 轉 Markdown

AI 驅動的多階段處理流水線：

頁面渲染 → 文字提取 → 圖片定位 → 公式辨識
LaTeX 語法驗證和內容完整性檢查
自動修復和跨頁面品質校驗

MCP 工具整合

支援連接外部 MCP（Model Context Protocol）伺服器擴充 AI 能力：

aether mcp add <name> <command>    # 新增本機 MCP 伺服器
aether mcp list                     # 列出已設定的伺服器
aether mcp auth <name>              # OAuth 認證
aether mcp debug                    # 除錯 MCP 連線

行動端

透過微信、飛書、QQ 機器人從手機端與 Aether 對話。在設定中配置對應平台的憑證即可啟用（Web 版和桌面版均支援）。

其他指令

aether web            # 啟動 Web 服務並開啟瀏覽器
aether serve          # 啟動無頭 API 伺服器
aether run <message>  # 非互動式執行指令
aether models         # 列出可用模型
aether providers      # 檢視提供商
aether mcp            # 管理 MCP 伺服器
aether session        # 工作階段管理
aether stats          # 檢視使用統計
aether upgrade        # 自更新
aether debug config   # 檢視目前設定

常見問題

API 回傳 404：檢查 baseURL 是否遺漏了 /v1。

API 回傳 429：Key 填錯，或被舊的 auth.json 覆蓋。刪除 ~/.local/share/opencode/auth.json 後重試。

瀏覽器未自動開啟：手動存取終端機中顯示的 URL（依賴 xdg-open）。

提示找不到前端資源：確認 aether 二進位和 web/ 目錄在同一目錄下。

模型列表為空：檢查環境變數 OPENCODE_CONFIG 路徑是否正確。

macOS 提示「無法開啟，因為無法驗證開發者」：應用程式未簽章。右鍵點擊應用程式選擇「開啟」，在「設定─安全性與隱私權」中找到相關提示，選擇「仍要開啟」。之後應用程式會被記為信任，不再提示。（每次更新後需要重複此操作）

macOS 提示「已損毀，無法開啟」：這是 macOS 隔離屬性導致的誤報。在終端機執行 xattr -cr /Applications/Aether\ Desktop.app（桌面版）或 xattr -cr ./aether ./Aether.command（Web 版）即可。

Linux Web 版安裝後找不到啟動入口：執行解壓目錄中的 install.sh（需先 chmod +x），安裝完成後可在系統啟動台中找到 Aether 圖示。原先在桌面上的 Aether.sh 啟動腳本已棄用。

桌面版和 Web 版可以同時安裝嗎？：可以。兩者共享同一套資料和工作階段。但是應避免同時執行兩個版本，以免競爭資源導致不穩定。