← Back to Home

ACM Scholar CLI
本地安装测试指南

Last Updated: 2026-01-03 | Tested on Windows 11, Python 3.13

📋 前置要求

Python 3.10+ 已安装
Git 已安装
pip 已安装

🚀 安装方式

方式 A：从 GitHub 安装（需网络）

pip install "git+https://github.com/hongping-zh/open-notebook.git"

方式 B：本地安装（推荐）

                # 1. 克隆仓库

                git clone https://github.com/hongping-zh/open-notebook.git

                cd open-notebook

                # 2. 本地安装

                pip install -e .

⚠️ PATH 配置

注意：安装后如果出现 acm 无法识别 错误，需要添加 Python Scripts 到 PATH。

临时添加（当前会话有效）

$env:PATH += ";C:\Users\14593\AppData\Roaming\Python\Python313\Scripts"

永久添加

                [Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";C:\Users\14593\AppData\Roaming\Python\Python313\Scripts", "User")
            

注：Python 版本目录可能不同（如 Python311），请根据实际情况调整路径。

✅ 验证安装

                # 查看版本

                acm --version

                # 预期输出: ACM Scholar CLI 版本: 0.1.0

                # 查看帮助

                acm --help

🔍 功能测试

1. 论文搜索

acm search "transformer attention"

2. ACM 专用搜索

acm search-acm "deep learning"

3. 交互式搜索

acm interactive

🐛 常见问题 (FAQ)

Q1: `acm` 无法识别

原因: Python Scripts 目录不在 PATH 中。
解决: 参考上方的 "PATH 配置" 章节添加环境变量。

Q2: Connection Error / Proxy Issues

解决: 清除 Git 代理配置：

                git config --global --unset http.proxy

                git config --global --unset https.proxy