GEO Wiki Pro 提供命令行工具 `geo`，用于管理知识库的文档、分类、标签、用户等内容。 ## 安装 ### 环境要求 - Node.js >= 18 - npm >= 9 ### 检查版本 安装前先检查当前是否已安装以及版本信息： ```bash geo --version ``` - 如果提示 `command not found`：说明未安装，直接跳到下方安装 - 如果显示版本号：对比当前最新版本，判断是否需要更新 > Agent 提示用户："当前安装的是 X.X.X，最新版本是 X.X.X，是否需要更新？" 由用户确认后再操作。 ### 更新版本 如需更新旧版本，先卸载再重新安装（`npm uninstall -g` 只会卸载 `geowiki-cli`，不影响其他全局包）： ```bash npm uninstall -g geowiki-cli ``` 验证卸载： ```bash geo --version # 应提示 command not found，表示已卸载干净 ``` > 注意：如遇权限错误，可使用 `sudo npm uninstall -g geowiki-cli`。 ### 安装 Node.js（如未安装） GEO Wiki CLI 依赖 Node.js，如果系统中没有 `node` 和 `npm` 命令，请按以下方式安装： | 平台 | 安装命令 | 说明 | |:----:|---------|------| | 🍎 macOS | `brew install node` | 推荐；或下载 nodejs.org 的 `.pkg` | | 🐧 Ubuntu/Debian | `sudo apt install nodejs npm` | | | 🐧 Fedora | `sudo dnf install nodejs npm` | | | 🪟 Windows | `winget install OpenJS.NodeJS.LTS` | 推荐；或下载 nodejs.org 的 `.msi` | ```bash # 安装后验证 node --version npm --version ``` ### 全局安装 ```bash npm install -g geowiki-cli ``` 验证安装： ```bash geo --version # 期望输出: geowiki-cli v1.0.7+ geo --help ``` ### 权限问题 如果遇到权限错误： ```bash # 方式 1：使用 sudo sudo npm install -g geowiki-cli # 方式 2：修改 npm 全局目录 mkdir ~/.npm-global npm config set prefix '~/.npm-global' export PATH=~/.npm-global/bin:$PATH npm install -g geowiki-cli ``` ## 登录 ### Token 登录（推荐） ```bash geo login --url https://geowiki.pro --token geo_xxxxx ``` | 参数 | 缩写 | 说明 | 必需 | |------|------|------|------| | `--url` | `-u` | 服务器地址 | 是 | | `--token` | `-t` | API Token | 是 | Token 登录无需 CAPTCHA，有效期 90 天，在管理面板「设置 -> API Token」中生成。 ## 登录状态 ```bash geo status # 查看当前连接状态 geo logout # 清除本地凭证并登出 ``` 登录成功后，Token 会自动保存到 `~/.geowiki/config.json`，后续命令自动携带认证信息。 ## 常见问题 **Q: 安装后找不到 `geo` 命令？** 确认 npm 全局 bin 目录在系统 PATH 中。运行 `npm config get prefix` 查看全局目录路径。 **Q: 之前安装的旧版本与新版本冲突？** 先运行 `npm uninstall -g geowiki-cli` 卸载旧版，再重新安装最新版。 **Q: Token 过期了怎么办？** 在管理面板「设置 -> API Token」生成新 Token，然后运行 `geo login --url ... --token <新Token>` 重新登录。 **Q: 如何确认当前登录的用户？** 运行 `geo status` 查看当前服务器连接信息和用户信息。 ## 下一步 - [CLI 快速参考](/docs/cli-quick-reference) -- 快速掌握常用命令 - [CLI 命令参考](/docs/cli-reference) -- 全部命令参数详解 - [GEO Wiki Agent Skill 使用指南](/docs/agent-skill) -- AI Agent 集成模式和工作流