把 AI 编程工作区装进 U 盘,按需使用云端 API 或本地模型。
PortableAI 提供持续交互的命令行编程工作区与浏览器聊天入口。你可以填写自己的 API 地址、模型和密钥,也可以使用电脑或 U 盘中的 Ollama 聊天模型。开启自动降级后,云端请求失败会转用本地模型,继续当前任务。
当前版本:v0.3.6 · 预览版。已验证 Windows x64;仓库发布源码,不包含模型权重、个人配置或完整便携运行环境。
| 设计 | 使用体验 |
|---|---|
| 云端优先,本地接续 | 支持 Anthropic API 和兼容 Chat Completions 的接口;可以开启失败后自动降级,或直接指定本地模型 |
| 持续编程工作区 | 完成一轮后继续输入,保留当前上下文;支持读取项目、修改文件、运行命令和根据测试结果继续修复 |
| 按存储条件准备模型 | 检查文件系统、权重布局与可用空间;完整权重优先直接读取,必要时使用已有电脑权重或缓存 |
| 会话随设备携带 | 从 U 盘版本启动时,会话、配置与文件修改记录保存在 U 盘的 data/ 中,可恢复已有会话 |
| 清晰的终端层级 | 正文跟随终端前景色,边框和辅助信息使用灰色,状态少量用色;支持中文、输入历史和对话回看 |
| 可选择的使用入口 | CLI 面向编程任务,网页入口面向聊天;两者共用连接配置 |
需要 Node.js 22 或更新版本。使用电脑模型时,还需要运行 Ollama 并准备可用的聊天模型。
git clone https://github.com/YUshire/Portable-AI.git
cd Portable-AI
npm ci
node cli.mjs --connect连接菜单可以选择云端 API、U 盘模型、电脑模型或已保存设置。选择云端后填写接口类型、基础地址、模型 ID 和密钥,再选择项目目录开始任务。源码本身不包含 U 盘模型;准备好完整便携运行包后,才能使用随盘模型入口。
浏览器聊天入口:
node server.mjs --open准备好对应平台的运行程序和自行导入的模型后,将整个目录放到 U 盘:
Start-Agent-Windows.cmd:打开编程工作区。Start-Windows.cmd:打开浏览器聊天入口。Safe-Exit-Windows.cmd:保存并关闭此目录的 PortableAI 实例,请求 Windows 安全弹出。
网页也可点击“退出并安全弹出”,CLI 输入 /eject。请等待结果窗口明确显示“已安全弹出”再拔出。若其他程序占用 U 盘,会提示原因;程序不会强制结束其他应用。关闭 CLI 窗口或最后一个网页会退出后台,但仍需使用安全弹出入口。
Windows x64 是目前经过验证的平台。准备说明见 便携部署指南。
- 云端优先:使用自有 API;请求成功时无需加载本地模型。
- 自动降级:云端请求失败后,按设置选择电脑模型或随盘模型;当前轮继续使用已选定的本地模型。
- 仅用 U 盘模型:跳过云端与电脑 Ollama 服务,启动随盘运行环境;权重读取位置仍按实际存储能力判断。
- 仅用电脑模型:使用电脑 Ollama 服务中的可用聊天模型,找不到时明确提示。
API 地址填写基础地址,兼容接口通常以 /v1 结尾。密钥默认仅在内存中使用,也可选择密码加密保存;下次启动需要解锁。
| 命令 | 用途 |
|---|---|
/connect |
修改 API、模型和降级设置 |
/model cloud、/model usb、/model host |
切换使用方式 |
/status |
查看当前连接、模型与会话 |
/new |
新建会话 |
/sessions、/resume <ID> |
查看或恢复已有会话 |
/diff |
查看文件工具产生的修改 |
/eject |
保存、退出 PortableAI 并请求 Windows 安全弹出 U 盘 |
/help、/exit |
帮助或退出 |
Enter 提交,↑↓ 查看输入历史,PgUp/PgDn 回看;Esc 或 Ctrl+C 取消当前任务。详见 Agent 使用指南。
模型名称与大小由导入的模型决定,没有固定的“首次必回迁 4.7 GB”要求。exFAT、NTFS 等支持大文件的文件系统可以直接存放完整权重。FAT32 单文件上限是 4 GiB−1 字节,超过上限的完整权重需要使用电脑上的完整文件;程序优先寻找并校验可复用权重,找不到时才还原到缓存。程序不会格式化 U 盘。
CLI 会话保存在程序所在目录的 data/agent-sessions/,网页聊天保存在 data/history.json。从 U 盘启动时,这些记录在 U 盘;从源码目录启动时,则在源码目录。恢复目前要求项目路径与原记录一致。
当前支持会话持久化与恢复,尚未提供跨会话长期记忆、自动摘要或无限上下文。聊天记录是明文保存,API 密钥的加密保存与会话存储是独立功能。
本仓库及源码发布包包含程序源码、启动入口、使用文档、测试与许可证。模型权重、个人会话、API 密钥、个人配置、日志、Node/Ollama 运行程序和依赖安装目录不随发布提供。
- Windows x64 已验证;macOS、Linux、ARM64 和手机暂无经过验证的完整运行包。
- 本地效果取决于模型能力、设备内存与 CPU/GPU;支持聊天不代表可靠完成复杂编程任务。
- 命令默认逐条确认;命令使用当前用户的系统权限,不是操作系统沙箱。
- 服务只监听本机。同一目录的网页服务重复启动会复用已有实例。
本版通过 58 项自动化测试,覆盖原有功能、退出、取消请求、重复启动及进程清理;此前已验证真实本地代码修复、模拟云端故障后的本地接续和跨进程会话恢复。这些结果不等同于完整榜单成绩或全设备兼容性保证。
便携使用思路参考 Claude-Portable。PortableAI 是独立项目,需要用户自行配置 API 或模型,使用 MIT 许可。第三方依赖许可见 THIRD-PARTY-NOTICES.md。