Files
hunjing/backend/app/domains/kouxin/api.py
T
chenxin c63b75152a M8:天工阁、叩心与辰正——受托任务后台并行、叩心四约束、时态感知投影
- 天工阁域 domains/tiangong:backstage_tasks(委托包+验收标准+结果证据);有限分解(parent 链)与受控并行(各自后台 Run);子任务全终态级联父任务进入待验收;按证据 accept/reject
- kernel.start_backstage_run(kind=background_task):loop 后台分支不占前台席位、与前台对话并行;断言放宽容纳无人物功能任务;结果只经回调回呈任务——无身份写入路径
- 叩心域 domains/kouxin:knocking_candidates(event/time_anchor/manual 触发 + 草稿 + 裁决快照);四约束裁决(总开关→静默窗口【本地时区判定】→24h 频率→预算),dispatch 未过 429 且快照留痕;候选默认不自动发送;expire_stale 过期推进不触碰缘契
- 辰正 domains/zhengchen:temporal_context() 复用 time_sense 计算核(快照/农历/季节),产出【时态感知】投影段接入镜树生成 prompt(客观时间语境,不附情绪臆测——守一纪律)
- 退役:modules/goal_orchestrator|planner|perception|big_cycle、application/planning、services/governance|goal_persist、candidates 表链(imports 候选抽取 API 面)、goals/plans/agent_roster/perception_channels/big_cycles/旧候选表(迁移 009);前端 admin goals/plans/agents/perception/world 页与六组件;governance 只留 GenerationPreferences;admin 治理面收敛为司命+百工两枢;pivots 健康以域表计数重建
- 验收(test_m8_tiangong 五用例):后台任务无身份写入(记忆/魂籍/缘契零新增);后台与前台并行;分解级联;叩心四约束逐项;不回应不降低关系(缘契维度/状态/版本零变化)
- 四套件:后端 345、前端 203、BFF 4、神识 5 包全绿(2 个预存环境失败不变);迁移 009 净库干净
2026-08-28 09:13:39 +08:00

64 lines
1.9 KiB
Python

"""叩心 API:候选生成、约束裁决与派发。"""
from fastapi import APIRouter, Depends
from pydantic import BaseModel, Field
from app.api.v1.deps import get_current_user
from app.domains.kouxin import service
from app.schemas.auth import CurrentUser
knock_router = APIRouter(prefix="/knocking", tags=["kouxin"])
class CandidateCreateRequest(BaseModel):
character_id: str
trigger: str = "manual"
draft: str = Field(min_length=1, max_length=2000)
class DispatchRequest(BaseModel):
draft_override: str | None = None
@knock_router.post("/candidates", status_code=201)
async def create_candidate_api(
payload: CandidateCreateRequest, user: CurrentUser = Depends(get_current_user)
) -> dict:
return await service.create_candidate(
character_id=payload.character_id,
owner_scope=user.owner_scope,
trigger=payload.trigger,
draft=payload.draft,
)
@knock_router.get("/candidates")
async def list_candidates_api(
user: CurrentUser = Depends(get_current_user)
) -> list[dict]:
return await service.list_candidates(user.owner_scope)
@knock_router.get("/ruling/{character_id}")
async def ruling_api(
character_id: str, user: CurrentUser = Depends(get_current_user)
) -> dict:
"""约束裁决预检(总开关/静默/频率/预算)。"""
return await service.rule(character_id, user.owner_scope)
@knock_router.post("/candidates/{candidate_id}/dispatch")
async def dispatch_api(
candidate_id: str, payload: DispatchRequest, user: CurrentUser = Depends(get_current_user)
) -> dict:
return await service.dispatch(
candidate_id, user.owner_scope, draft_override=payload.draft_override
)
@knock_router.post("/candidates/{candidate_id}/dismiss")
async def dismiss_api(
candidate_id: str, user: CurrentUser = Depends(get_current_user)
) -> dict:
return await service.dismiss(candidate_id, user.owner_scope)