常见问题

通用问题

CLI Hub 是免费的吗？

CLI Hub 提供三个版本：

• 社区版（免费）— 包含基础代码补全和本地 AI 模型
• 专业版（¥99/月）— 高级 AI 能力、代码审查、智能重构
• 企业版（联系销售）— 私有部署、SSO、团队管理

CLI Hub 支持哪些编程语言？

目前支持 50+ 主流编程语言，包括但不限于： JavaScript/TypeScript、Python、Java、Go、Rust、C/C++、C#、Ruby、PHP、Swift、Kotlin 等。

我的代码会被上传到云端吗？

不会。 CLI Hub 采用本地优先架构：

• 默认所有代码分析在本地完成
• 使用云端增强功能时，仅发送必要的上下文片段
• 云端处理完成后不保留任何数据
• 支持完全离线使用（功能有所限制）

支持离线使用吗？

支持。使用本地 AI 模型时，核心功能可以离线使用：

• ✅ 代码补全
• ✅ 代码解释
• ✅ 基础代码审查
• ❌ 复杂推理任务（需要云端大模型）
• ❌ 团队协作功能

---

安装相关

安装后无法启动？

Windows：

• 确保已安装 Visual C++ Redistributable
• 尝试以管理员权限运行
• 检查杀毒软件是否拦截

macOS：

• 首次打开：右键点击 → 打开（绕过 Gatekeeper）
• 确保系统版本 ≥ macOS 12

Linux：

• 确保已安装 libssl 和 libstdc++
• AppImage 需要 FUSE 支持

编辑器插件安装失败？

1. 确保编辑器版本满足最低要求
2. 检查网络连接
3. 尝试手动安装 .vsix 文件（VS Code）
4. 查看 编辑器支持 获取详细步骤

---

使用相关

代码补全不工作？

排查步骤：

1. 确认 CLI Hub 服务正在运行（系统托盘/菜单栏图标）
2. 确认编辑器插件已安装并启用
3. 检查 .vibe/config.yml 中 completion.enabled 是否为 true
4. 尝试重启编辑器
5. 尝试重启 CLI Hub 服务

AI 建议不够准确？

提升建议质量的技巧：

• 添加项目文档：在项目中添加 README 和 API 文档
• 编写清晰注释：AI 会参考注释理解意图
• 使用类型系统：TypeScript/Python 类型注解帮助 AI 理解
• 增加上下文：在内联对话中提供更多背景信息
• 升级模型：专业版使用更大参数的模型

内存占用过高？

• 关闭不需要的项目索引
• 在配置中排除大型生成文件目录（如 node_modules、dist）
• 降低上下文窗口大小

# .vibe/config.yml
indexing:
  excluded_paths:
    - "node_modules/**"
    - "dist/**"
    - "**/*.min.js"
    - "**/*.map"

---

账号与付费

如何取消订阅？

1. 登录 账户中心
2. 进入 "订阅管理"
3. 点击 "取消订阅"
4. 当前周期内仍可使用

支持哪些付款方式？

• 支付宝
• 微信支付
• 信用卡（Visa / MasterCard）
• 银行转账（企业版）

可以开发票吗？

可以。在账户中心的"订单管理"中申请电子发票，支持增值税普通发票和专用发票。

---

更多帮助

• Discord 社区 — 与其他用户交流
• 邮件支持 — 专业版和企业版用户