atrium-pi-modelprovider-manager

Atrium - Pi Model Provider Manager

Atrium (Atrium - Pi Model Provider Manager) 是专为 Pi (pi-coding-agent) 打造的下一代现代化多模型、多中转站可视化管理与评测工作台。

它同时具备双重产品形态：

1. Pi Agent 运行时扩展 (Extension)：无缝挂载至 Pi Agent，提供底层请求钩子（Hooks）、多协议适配器（Adapters）、上下文溢出自动恢复、链路追踪以及终端快速切换器（TUI）；
2. 桌面原生可视化工作台 (Tauri + Vue 3 + Tailwind CSS + Pinia)：采用 Apple 极简设计范式，提供全流程模型管理、动态模型探测（/v1/models）、以及多模型同台竞技的测试工作台（Test Arena）。

🌐 在线文档站 (Docsify)
📖 访问高清交互式官方文档（支持全局检索与侧边栏目录）：https://zhaowendao2005.github.io/Atrium-pi-modelprovider-manager/#/

✨ 核心特性

• 现代 Apple 美学界面：折叠侧边栏、细腻平滑过渡、卡片化布局与自定义 Apple 滚动条。
• 本地优先（Local-First）与 SQLite 存储：彻底弃用难以维护的冗长 YAML，所有配置、密钥与历史会话均持久化于本地 SQLite（manager.db），保障数据隐私与秒级加载。
• 多协议原生适配（9 种协议）：深度兼容 OpenAI、Anthropic、Grok (xAI)、Ollama、Google Gemini、DeepSeek、Mistral、OpenRouter 等，支持 Thinking Level 智能映射与参数清洗。
• 海量内置预设与动态发现：出厂自带 39+ 官方厂商规范与 1300+ 模型元数据，支持从中转站 /v1/models 端点一键自动拉取并分类挂载。
• 模型测试竞技场（Benchmark Arena）：
  • 真实沙箱环境：每个测试卡片运行在完全隔离的工作空间；
  • 评测指标全景图：首字延迟（TTFT）、生成耗时、双轨 TPS 吞吐、工具调用（Tool Calls）成功率与网络时序拆解。
• 无感单实例桌面唤起：在 Pi Agent 中输入 /model-manager 或直接运行桌面程序，支持单实例智能置顶聚焦，不重复弹出多余窗口。

📚 用户手册与文档导览

项目提供详尽的模块化使用手册与深入指南，无论是在本地 Markdown 浏览，还是通过 GitHub Pages 在线查阅均可快速定标：

💡 在线查阅：你也可以直接访问官方文档站进行全站检索与深度阅读：👉 Atrium 官方文档站 (GitHub Pages)。

🧭 架构与设计规范

• 📖 前端设计规范与范式：参见 dev_docs/rules/前端设计规范和范式.md。
• 📖 底层协议与规范分析：参见 dev_docs/analysis_result/模型与提供商规范分析.md。
• 📖 快捷键支持：Pi Agent 内键入 /models 或按下 Alt+P 即可呼出模型快速切换选择器。

📦 打包产物结构 (dist/)

运行 pnpm build 命令将一键构建并将 独立插件包 输出到 dist/atrium-pi-modelprovider-manager/：

dist/atrium-pi-modelprovider-manager/
├── index.js                     # Pi Extension 插件入口代码
├── index.d.ts                   # TypeScript 类型声明定义
├── adapters/                    # 运行时多协议适配模块（如 grok-core 等）
│   ├── grok-core.js
│   └── grok-core.d.ts
├── bin/                         # Tauri 桌面端二进制程序（前端已静态内嵌）
│   └── atrium-pi-modelprovider-manager.exe
├── templates/                   # 内置基准评测任务集（供测试竞技场动态加载）
│   └── test_tasks/
│       ├── 01_site_availability/
│       ├── 02_deep_reasoning/
│       ├── 03_multi_tool_pipeline/
│       └── ...
├── README.md                    # 随包说明文档
└── package.json                 # 专为插件单元独立运行设计的元数据

⚙️ 常用构建与开发命令

🚀 安装与使用方式

方式 1：通过 npm / Pi 插件命令安装（推荐）

本包已正式发布到 npm：atrium-pi-modelprovider-manager

你可以直接通过 pi install 命令一键安装：

# 推荐：使用 Pi CLI 直接安装 npm 包
pi install atrium-pi-modelprovider-manager

# 或使用 npm / pnpm 全局/本地安装
npm install atrium-pi-modelprovider-manager

安装完成后，Pi Agent 将自动识别并启用本扩展。

方式 2：使用本地构建产物直接加载

pi -e ./dist/atrium-pi-modelprovider-manager/index.js

方式 3：全局放入 Pi 扩展自动加载目录（支持 /reload）

• 全局路径：~/.pi/agent/extensions/atrium-pi-modelprovider-manager/
• 项目级路径：.pi/extensions/atrium-pi-modelprovider-manager/

方式 4：打开桌面可视化管理器

• 在 Pi Agent 内部：键入命令 /model-manager
• 独立运行：直接双击运行 ./dist/atrium-pi-modelprovider-manager/bin/atrium-pi-modelprovider-manager.exe

🛡️ 环境与持久化隔离

• 生产环境：默认读写 ~/.pi/atrium-pi-modelprovider-manager-data/（自动兼容历史 pi-modelprovider-manager-data/，保障数据无缝过渡）。
• 开发调试：开发环境自动隔离至 dev-cache/ 子目录，拥有独立数据库与模板，绝不污染生产密钥与日常配置。
• 最近使用记录：自动按最近调用模型智能排序，支持最多 100 条使用轨迹记录。