Quasar

简体中文 | English

Quasar 是供宿主显式装配的通用 Python AI 运行时。公共 API 位于 quasar：提供生命周期、能力协议、工具注册、事件封装、技能与插件机制。模型调用、网络 API、具体存储和业务执行由宿主实现并注入。

安装与验证

Python 3.10+。在 Quasar 仓库根目录（作为子模块时先进入 Quasar/）：

python -m pip install -e .
python -m pip install -e ".[skills]"
python -m pip install -e ".[dev]"
python -m pytest tests -q
python examples/cli_chat.py

核心运行时无第三方依赖。skills 为文件技能的 YAML frontmatter 提供 PyYAML；dev 提供测试所需的 pytest 与 PyYAML。示例是离线宿主处理器演示，不调用模型。

显式装配

from quasar import QuasarApp, RuntimeBuilder, StreamEvent

runtime = RuntimeBuilder().build()
runtime.register_entrance_handler(
    "handle_integrated_entrance_stream",
    lambda payload: iter([StreamEvent.content(payload["message"]).to_sse()]),
)
app = QuasarApp(runtime)
try:
    for event in app.chat_stream({"message": "hello"}):
        print(event, end="")
finally:
    app.shutdown()

运行时不会自动选择供应商或发起模型请求。use_model() 是能力注入，宿主处理器负责实际执行。没有配置处理器时，调用流入口会明确失败。

目录

Quasar/
  src/quasar/   通用运行时、协议、工具、能力、插件和技能
  docs/         当前 API 与宿主装配说明
  examples/     不依赖服务端或模型凭证的装配示例
  tests/        核心行为及分发边界测试
  pyproject.toml
  requirements.txt
  README.md
  README_EN.md

公共导入路径统一为 quasar；源码不再保留旧 ai_*、具体 adapters 或 compat.v1 包。不会将旧实现迁往隐藏归档或换名继续分发。

通用能力边界

• RuntimeBuilder：注入模型、会话/产物/向量存储以及自定义能力，装配工具和插件。
• QuasarRuntime：依赖排序、启动/flush/关闭、结构化错误和健康状态。
• ToolSpec / CapabilityToolRegistry：工具工厂、必需/可选能力检查、显式替换。
• 会话、对话、产物、向量和事件协议；默认仅提供内存会话/对话/产物和进程内事件总线。
• ChatRequest / StreamEvent：请求和流事件封装。宿主现有报文转换方法保留，它们不接入任何供应商 API。
• QuasarPlugin / PluginManager：显式注册插件；不扫描旧业务模块。
• SkillLoader / SkillRegistry / SkillRouter：文件技能声明、校验和用户消息授权判断。

具体数据库、文件持久化、HTTP/WebSocket 服务、模型客户端及工具业务实现均放在宿主自己的代码中，通过接口注入。

从旧版本迁移

旧 Quasar.ai_*、Quasar.adapters.*、Quasar.compat.v1、load_module_settings()、LegacyModulePlugin 及 LegacyConfigAdapter 已删除。安装依赖组 providers/media/langchain/workflow/redis/mongo/sql/web/object-recognition/all/cabbage/plugins 已删除；原 quasar-chat 命令因没有独立宿主配置入口而移除。

新代码直接使用 RuntimeConfig、RuntimeBuilder 与宿主实现。需要模型或持久化时，在宿主包声明相应依赖并通过 use_model()、use_session_store() 等方法注入。当前课件宿主已使用 quasar，无需这些旧包。

详细说明：API · 宿主装配。

命名迁移

采用标准src布局和小写Python包名：Quasar/src/quasar/。统一从quasar导入；Quasar.cai及CAIApp/CAIRuntime/CAIPlugin已更名为QuasarApp/QuasarRuntime/QuasarPlugin，不保留旧别名。宿主须先安装本地包（项目根requirements.txt已声明），不依赖修改sys.path或当前工作目录。