正式分发成型:三入口(CLI pa、stdio MCP、pa serve/pa web)统一在
panelagent 0.2.0 发行物中。本地构建、干净环境验证与文档同步完成,
未公网发布。
- 版本单一来源
panelagent.__version__,pyproject 动态读取;全线统一 0.2.0。 - 可选 extras:
mcp(不变)、backend(镜像backend/requirements.txt: FastAPI/uvicorn/pandas/numpy/scipy/openai/xlrd(.xls 上传)等)、dev。 CLI 与 MCP 不依赖 backend/Node。 - wheel 无条件附带
backend包与根级领域模块 (data_preprocessing、panel_generator、llm_api_client、spectral_viewer),供 backend extra 惰性加载;开发脚本不打包。 - package-data:既有 seed 快照 + 新增
panelagent/data/skills/(用户 skill);config/仍为仓库编辑源,不进 wheel。 - CLI 发现命令齐备:
pa library list、pa instrument list、pa marker list --library(--limit/--offset分页),dye/channel查询 支持--instrument-id过滤;CLI 与 MCP 对零仪器统一以no_instruments拒绝;失败输出机器可读信封{"code","error"}(database_missing/ no_instruments/backend_dependency_missing/web_unavailable/skill_resources_missing 等)。 - 服务与分发入口:
pa serve(uvicorn 起 FastAPI 后端并注入PANELAGENT_DB)、pa web(转调panelagent.web,启动独立构建的 Next standalone 产物,需[backend,mcp],库缺失时自动初始化)、pa skill install --dest(分发用户 skill)。 - 新增
scripts/build-release.py:可复现 wheel+sdist+skill 档案(可选--with-web归档平台相关的 Web 产物;--verify-dir可持久保留干净房 venv 供下游验证);内置反-editable 掩盖的发行检查——wheel/sdist 内容 审计、双干净房功能验证(seed 来自包、发现/生成/诊断、stdio MCP 握手 10 工具、pa skill install、backend import 矩阵、pip check、版本一 致性);必需组件(skill/web.py)缺失即构建失败。 - 新增
MANIFEST.in与docs/distribution.md(分发、验证、发布准备与 公网发布的人工边界、安装指南)。 - Web 与 FastAPI 统一使用 SQLite 库存、仪器、质量和历史;支持 CSV/XLSX/XLS 导入、管理员行内质量维护、手动候选历史保存。旧质量 API 退休为 410, 提供默认 dry-run 的迁移脚本。
pa web --env-file为 Next、API、MCP 注入统一配置;设置页显示实际模型, 密钥仅服务端可见。支持无模型手动工作流及独立 Next standalone 分发。- 整合验收:314 项 Python、36 项浏览器测试通过;wheel 与搬迁 Web 包的
真实库存/质量/MCP/历史链路、模拟模型工具调用及独立
pa serve验证通过。
SQLite 内核成型:CLI pa、十工具只读 MCP 服务器、CSV 导入硬化、
亮度别名归一、生成激光负载均衡(详见 git 历史与 docs/panelagent-core.md)。