docs: 更新协议文档,删除废弃计划文档

- 更新 http-error-codes, user-points-chat-data-protocol
- 更新 divination-run-protocol, profile-protocol
- 删除废弃的后端和前端设计计划文档
This commit is contained in:
qzl
2026-04-08 17:23:02 +08:00
parent 49fc9a116f
commit e80a82bef4
57 changed files with 4117 additions and 2269 deletions
+16 -1
View File
@@ -7,6 +7,7 @@ from uuid import UUID
from pydantic import BaseModel, ConfigDict, Field
from schemas.agent.runtime_models import ErrorInfo
from schemas.domain.divination import DerivedDivinationData
@@ -21,6 +22,8 @@ class AgentRepositoryLike(Protocol):
async def rollback(self) -> None: ...
async def delete_session(self, *, session_id: str) -> None: ...
async def get_history_day(
self,
*,
@@ -29,6 +32,13 @@ class AgentRepositoryLike(Protocol):
visibility_mask: int | None = None,
) -> dict[str, object] | None: ...
async def get_session_messages(
self,
*,
session_id: str,
visibility_mask: int | None = None,
) -> list[dict[str, object]]: ...
async def get_latest_session_id_for_user(self, *, user_id: str) -> str | None: ...
async def get_latest_assistant_messages_by_user_sessions(
@@ -186,6 +196,7 @@ class HistoryMessage(BaseModel):
model_config = ConfigDict(populate_by_name=True, serialize_by_alias=True)
id: str = Field(description="Message UUID")
thread_id: str = Field(alias="threadId", description="Owning session UUID")
seq: int = Field(description="Message sequence number")
role: Literal["user", "assistant"] = Field(
description="Message role: user | assistant"
@@ -213,6 +224,7 @@ class HistoryAgentOutput(BaseModel):
advice: list[str] = Field(default_factory=list)
keywords: list[str] = Field(default_factory=list)
answer: str | None = None
error: ErrorInfo | None = None
divination_derived: DerivedDivinationData | None = None
@@ -221,7 +233,10 @@ class HistorySnapshotResponse(BaseModel):
model_config = ConfigDict(populate_by_name=True, serialize_by_alias=True)
scope: str = Field(default="history_day")
scope: str = Field(
default="history_session_full",
description="history_session_full | history_sessions_latest_assistant",
)
thread_id: str | None = Field(default=None, alias="threadId")
day: str | None = None
has_more: bool = Field(default=False, alias="hasMore")