AgentOS-K

AgentOS-K 是一个本地产品工作台，用于浏览会话档案、管理已接入产品的运行状态，并通过独立适配扩展连接产品。

功能

• 本地网页控制台，可在未接入产品时独立启动。
• 会话归档、来源分类、会话筛选与详情查看。
• SQLite 档案备份和恢复到新目录。
• 通用后台同步、服务启动状态与进程管理能力，供产品扩展接入。
• 已接入产品在新标签页打开，控制台继续保留。

安装与启动

在 Linux 或 WSL2 Ubuntu 中准备 Python 3.12 及 uv，进入项目目录：

uv sync --frozen
uv run aos serve

打开 本地控制台。默认仅监听本机回环地址。

main 分支提供通用工作台，不依赖产品目录、模型密钥或容器服务。尚未接入产品时显示本地档案页面；使用产品扩展分支后，可使用对应的启动和自动同步功能。

分支选择

• main：通用核心，不包含具体产品适配。
• rag：在 main 基础上增加 RAG-AGENT 适配，使用方法见该分支的说明。

需要使用 RAG-AGENT 时，在没有未提交修改的工作区切换：

git switch rag
uv sync --frozen
uv run aos serve

本地数据与配置

默认数据目录为 var/，会话档案保存在 var/archive.db。可指定其他本地目录或端口：

uv run aos serve --data-dir ./local-data --port 7777

也可通过 AOS_DATA_DIR 环境变量指定数据目录。自定义数据目录应加入本地 Git 忽略规则。凭据、数据库、日志和 human/ 文档仅保留在本地。

按 Ctrl+C 停止控制台；已由产品扩展启动且就绪的产品服务继续运行。

备份与恢复

uv run python -m aos.backup var/archive.db backups/archive.db
uv run python -m aos.backup backups/archive.db restored/archive.db
uv run aos serve --data-dir restored

备份和恢复的目标文件必须不存在。这些命令只处理 AgentOS 会话档案，产品原始文件和其他数据库需由对应产品单独备份。