- 迁移 10:tool(注册表:风险级/审批声明/输入 Schema)、tool_call(六态含 pending_approval、幂等唯一约束)、run.max_tool_calls(RunBudget 硬上限) - 内置工具三件:get-current-time/calculate(AST 白名单四则,只读循律)、record-note(真实副作用:写入记忆候选,必须请命) - 四维裁决(能力/数据/后果/情境→autonomy_level):read_only 循律直接执行;side_effect/high_impact 进入 pending_approval 请命;禁用工具 forbidden - 审批流(朱批):approve → 执行并落审计;deny → 拒绝且不可逆(重复审批 409);副作用工具产物走既有记忆审核通道 - 工具入参按不可信模型输出处理:JSON Schema 子集校验(required/type/未知字段拒绝);RunBudget 超限 422 不静默放行 - 幂等:同 (run, tool, Idempotency-Key) 重放返回 200 原调用 - 测试 67 项全绿(+7):循律即执行、请命→朱批→真实候选产物、拒绝不可逆与不执行、Schema 三类拒绝、未注册 404、幂等重放、预算硬上限
49 lines
1.7 KiB
Python
49 lines
1.7 KiB
Python
"""FastAPI 应用工厂。"""
|
|
|
|
from fastapi import FastAPI
|
|
|
|
from app.auth.routes import router as auth_router
|
|
from app.characters.routes import router as characters_router
|
|
from app.conversations.routes import message_router, run_router
|
|
from app.conversations.routes import router as conversations_router
|
|
from app.core.config import get_settings
|
|
from app.core.errors import install_error_handlers
|
|
from app.core.middleware import RequestContextMiddleware, configure_logging
|
|
from app.db.session import init_engine
|
|
from app.memories.routes import cycle_router
|
|
from app.memories.routes import router as memories_router
|
|
from app.tools.routes import calls_router, tools_router
|
|
|
|
|
|
def create_app() -> FastAPI:
|
|
settings = get_settings()
|
|
configure_logging(settings.log_level)
|
|
app = FastAPI(
|
|
title="Hunjing API",
|
|
version="0.1.0",
|
|
# 公共契约位于 docs/contracts 与 openapi/;本服务 docs 仅供开发调试。
|
|
docs_url="/_dev/docs",
|
|
openapi_url="/_dev/openapi.json",
|
|
)
|
|
install_error_handlers(app)
|
|
init_engine(app)
|
|
app.add_middleware(RequestContextMiddleware)
|
|
app.include_router(auth_router)
|
|
app.include_router(conversations_router)
|
|
app.include_router(run_router)
|
|
app.include_router(message_router)
|
|
app.include_router(cycle_router) # 先于 characters:避免通配生命周期路由拦截
|
|
app.include_router(characters_router)
|
|
app.include_router(memories_router)
|
|
app.include_router(tools_router)
|
|
app.include_router(calls_router)
|
|
|
|
@app.get("/healthz", tags=["ops"])
|
|
async def healthz() -> dict[str, str]:
|
|
return {"status": "ok", "env": settings.env}
|
|
|
|
return app
|
|
|
|
|
|
app = create_app()
|