安装与系统要求
支持平台、系统要求、安装步骤与自动更新说明。
CodeMama Desktop 基于 Electron 构建,支持 Windows、macOS 与 Linux 三大平台。
系统要求
| 平台 | 最低要求 |
|---|---|
| Windows | Windows 10 及以上(64 位) |
| macOS | macOS 12 及以上(Apple Silicon / Intel) |
| Linux | 主流发行版(Debian / Ubuntu / Fedora 等,64 位) |
| 通用 | 4 GB 内存、2 GB 可用磁盘、可访问公网 |
说明
应用内置 AI 编程引擎(本地 sidecar 进程),首次启动时会自动完成初始化,耗时约 10~30 秒,请耐心等待。
Windows 安装
- 从官网下载页获取
codemama-desktop-windows-x64.exe - 双击安装包,按向导提示完成安装
- 安装完成后从桌面快捷方式或开始菜单启动 CodeMama
注意
如果安装时被系统 SmartScreen 或杀毒软件拦截,请选择"仍要运行"。应用是官方签名的安装程序,如对来源有疑虑,可在官网核对下载地址。
macOS 安装
- 下载
.dmg安装包 - 打开后将 CodeMama 图标拖入"应用程序"文件夹
- 首次启动如在"系统设置 → 隐私与安全性"提示无法打开,点击"仍要打开"
Linux 安装
根据发行版选择安装包:
# Debian / Ubuntu
sudo dpkg -i codemama-desktop_*.deb
# Fedora / RHEL
sudo rpm -i codemama-desktop-*.rpm
# 通用
chmod +x codemama-desktop-*.AppImage
./codemama-desktop-*.AppImage自动更新
应用默认启用自动更新:
- 有新版本时,应用内会提示并下载更新
- 更新完成后需重启应用生效
- 更新失败时可在设置中"检查更新"重试
提示
更新不会清除你的登录状态、本地小说与项目数据,可放心升级。
卸载与数据
- Windows:设置 → 应用 → CodeMama → 卸载
- 卸载仅移除程序本体,个人数据(登录凭证、本地配置、
novels/小说文件)保留在用户目录
常见安装问题
| 问题 | 解决办法 |
|---|---|
| 安装包无法运行 | 确认系统为 64 位,且 Windows 版本不低于 10 |
| 提示缺少运行库 | 安装 Microsoft Visual C++ Redistributable |
| 启动后白屏 | 关闭硬件加速重试(设置中可关闭),或重启电脑后再次启动 |
| 杀毒软件误报 | 将 CodeMama 加入信任列表,并从官网重新下载安装包 |
仍有问题?查看常见问题或联系客服。