Repository navigation
v0.2.0
这一版把存储换成了 SQLite,不再需要 PostgreSQL 和 Redis,并推出 macOS 桌面版。从 v0.1.0 升级要做一次数据导入,见下文"从 v0.1.0 升级"。
桌面版(macOS Apple Silicon)
- 一个 DMG 里带着服务端、控制台、Node 24.21 和 Pi 1.4.0,不需要另装任何东西。下载
loop-now-desktop-<版本>-mac-arm64.dmg,拖进"应用程序"即可。 - 菜单栏图标显示运行状态,可以打开窗口、在浏览器中打开、设置登录时启动、查看日志、重启和退出。关掉窗口时服务端和 Agent 继续在后台运行。
- 页面的提醒以系统通知和 Dock 未读数显示;外部链接在系统浏览器中打开。
- 数据与源码安装分开:数据库和每日备份在
~/Library/Application Support/Loop Now/default/data,Agent 工作区在/Users/Shared/loop-now-desktop/default,日志在~/Library/Logs/Loop Now/default。用open -a "Loop Now" --args --profile=<名字>可以另用一套独立的数据。 - 安装包尚未经过 Apple 公证:第一次打开时,到"系统设置 › 隐私与安全性"点"仍要打开"。菜单栏的"检查更新"只提示新版本并打开下载页,不会自动安装。
- 目前只有 Apple Silicon 版。外部身份和
loopctl需要的对外 TLS 端口,桌面版暂时还不能开启。
存储只用 SQLite
- 运行只需要一个
loop-server和一个数据目录(LOOP_NOW_DATA_DIR,默认~/.loop_now)。数据库在其中的db/下,首次启动时自动创建。 - 每天自动备份到
<数据目录>/backups,保留最近 7 份(LOOP_NOW_BACKUP_DIR、LOOP_NOW_BACKUP_KEEP可改);loop-server backup <目录>可以随时手动备份,服务运行中也可以。 - 凭证仍以明文保存在数据目录的数据库文件里,同一用户的其他进程可以直接读取。请保护好数据目录和备份。
发行包
- 每个版本在 GitHub Releases 提供服务端发行包,平台有 macOS(Apple Silicon、Intel)和 Linux(x86_64、ARM64)。包里有内嵌控制台的
loop-server、loopctl、插件宿主、官方插件,以及 Node 24.21.0 和 Pi 1.4.0,解开后不用另装 Node 和 Pi。控制台就在服务端口的根路径(默认http://127.0.0.1:8780/)。 - 全部文件的校验和在
SHA256SUMS里。
控制台
- 项目设置 › 模型账号:提供方改为可搜索的选择面板。按用途分组,显示名称、别名和地区版本;已有账号的提供方排在前面。只需 API Key 的提供方直接打开填写表单,Codex 直接进入登录。账号行显示提供方名称、id 和认证方式,更新时间按控制台的语言格式显示。
- 插件详情页和安装、更新前的预览会显示插件的 README(按控制台语言选择);来自 git 的插件显示仓库链接。官方插件都有中英文 README。
- 控制台支持英文:默认跟随浏览器语言,可以在"全局设置"里切换,也可以用
?lang=指定。 - 全局设置 › 模型配置可以编辑固定版本 Pi 的原生
models.json,添加自定义 Provider 或覆盖内置 Provider。apiKey和headers只接受$NAME形式的环境变量引用,真实凭证仍在项目的模型账号里配置。
插件与工具
- 插件清单的
mcpServers支持 streamable HTTP 条目(http://或https://地址)。 - 插件的
displayName、description可以按语言分别写,控制台按当前语言显示。 - Agent 在插件的线索里回复时可以带选项提问,插件用 SDK 的
api.channels.answer作答;插件拿到的config.projects只包含启用了它的项目。 - mysql、gcloud 两个 CLI 工具支持 Linux/arm64。
- 新增 Docker Compose 一体化运行,端口只绑定本机回环地址。
从 v0.1.0 升级
v0.1.0 的数据在 PostgreSQL 里,v0.2.0 要一次性导入到 SQLite。导入只读旧库、不改动它,需要回退时旧版本仍可以用旧库运行(切换后产生的数据不会回到旧库)。
- 导入要求旧库已经迁移到 PostgreSQL 版的最后一个迁移,而 v0.1.0 还差两个迁移。先检出 tag
pg-final(PostgreSQL 版的最后一个提交),从源码构建,用原来的配置启动一次,迁移完成后停掉服务。 - 用 v0.2.0 的
loop-server:让LOOP_NOW_DATA_DIR指向一个还没有数据库的数据目录(默认的~/.loop_now里只要还没有db/就可以),把LOOP_NOW_DATABASE_URL设为旧库,运行一次loop-server import-postgres。它在一个一致的快照里复制全部数据,核对行数、外键与完整性,并打印每张表的行数;任何一步失败都不会留下新库。 - 保持原来的
LOOP_NOW_WORK_ROOT,在这个数据目录上启动 v0.2.0。之后不再需要 Redis。
不兼容的变化
- 不再使用 PostgreSQL 和 Redis。
LOOP_NOW_REDIS_URL、LOOP_NOW_REDIS_KEY_PREFIX、LOOP_NOW_LOCK_TTL、LOOP_NOW_LOCK_RENEW_INTERVAL、LOOP_NOW_RUN_TEXT_TTL已删除,设置了也不再读取;LOOP_NOW_DATABASE_URL只在loop-server import-postgres导入时读取。 - 健康接口
GET /api/v1/health改为{ok, database}:去掉了postgres、redis字段,database里带数据库状态、WAL 大小和告警。loopctl health也改为显示数据库状态。 - 一个数据目录、一个工作根同时只能由一个服务端使用。启动失败的退出码固定为:2 配置错误,3 数据目录或工作根被另一个服务端占用,4 监听地址被占用,其他错误为 1。
- 进行中的回复只保存在内存里:正常停止服务时,回复以已经生成的内容结束并标为中断;服务端崩溃时这部分内容会丢失(以前保存在 Redis 里)。
- 生命周期事件、工具调用事件和审计日志只保留最近 90 天,每天清理一次。
- 新安装创建的默认组织和默认项目都叫
default(原来是"默认组织""默认项目"),已有数据不受影响。