MICRO-MULTI / 文档查看源码 ↗

从源码运行

源码模式适合开发,或在浏览器中使用界面。准备 Python 3.11+、Node.js 24+、npm 和 Git,并在仓库根目录操作。安装桌面包则参考安装指南。

安装与启动

先创建 Python 环境:

python -m venv .venv

Windows PowerShell 使用 .\.venv\Scripts\Activate.ps1 激活,Linux 使用 source .venv/bin/activate。然后安装 Python 包及锁定的 JavaScript 依赖:

python -m pip install -e ".[dev]"
npm ci

执行 npm run desktop 启动 Electron 应用。使用浏览器时,运行 python -m masp.cli serve,再访问 http://127.0.0.1:3080/。服务保持在本机,应用面向单用户使用。

配置

变量 用途
MASP_HOME 指定可写的数据目录,源码默认使用工作目录下的 .masp。
MASP_PORT 设置桌面后端端口,默认为 3080。
MASP_MODEL_BASE_URL 提供环境模型的接口地址。
MASP_MODEL_NAME 设置该模型的 ID。
MASP_MODEL_API_KEY 提供模型凭据,不应写入仓库文件。
MICRO_MULTI_NODE 指定原生宿主使用的 Node 运行时。

通过界面添加的模型配置将密钥保存在系统凭据库,具体步骤见模型配置。扩展可能另需自己的运行时、账号或环境配置。

数据与备份

安装版数据默认位于 Windows 的 %APPDATA%\Micro-Multi\data,或 Linux 的 ${XDG_CONFIG_HOME:-~/.config}/Micro-Multi/data,MASP_HOME 可覆盖。升级和卸载保留这些数据。

数据目录应与程序分开备份,最好先停止活动任务。模型凭据位于系统凭据库,因此复制数据目录并不等于备份密钥;关联到原目录的项目也需要独立备份。存储布局见架构,中断任务见恢复。