Files
ClassHelper/packages/shared/src/ai.ts
T
LoveChengke 9351203deb feat: 完善 AI 对话、每日作息与课件目录体验
新增持久化对话、追问卡片和轮次导航;支持每日子时间表、切换保留课程与自动课间;完善课件逐层目录、学期周次同步及两端自适应。同步迁移、文档和回归截图。

验证:后端 262/262、AI 55 项、Web 81/81、桌面 71/71、授权 23 项;构建、类型、Lint 与文档检查通过。
2026-11-08 09:07:10 +08:00

81 lines
2.1 KiB
TypeScript

export interface AiAttachment {
id: string;
name: string;
size: number;
sha256: string;
}
export interface AiOperation {
action: string;
target?: Record<string, string>;
params?: Record<string, unknown>;
query?: Record<string, unknown>;
attachmentId?: string;
}
export interface AiCapability {
action: string;
label: string;
kind: 'read' | 'write';
dangerous: boolean;
schema: Record<string, unknown>;
sensitiveFields: string[];
}
export interface AiExecutionRequest {
method: 'POST' | 'PUT' | 'PATCH' | 'DELETE';
path: string;
query: Record<string, unknown>;
body: Record<string, unknown>;
attachmentId?: string;
sha256?: string;
}
export interface AiPlanStep extends AiOperation {
id: string;
label: string;
status: 'draft' | 'prepared' | 'confirmed' | 'running' | 'succeeded' | 'failed' | 'blocked';
summary: string;
dangerous: boolean;
sensitiveFields: string[];
before?: unknown;
preview?: unknown;
result?: unknown;
error?: string;
request?: AiExecutionRequest;
}
export interface AiConversationRequest {
supersedesTaskId?: string;
conversationId?: string;
text: string;
classId?: string;
messages?: { role: 'user' | 'assistant'; content: string }[];
attachments?: AiAttachment[];
}
export interface AiConversationResult {
questions?: { id: string; text: string; options?: string[] }[];
planId: string | null;
message: string;
steps: AiPlanStep[];
results: { action: string; label: string; data: unknown; operation?: AiOperation }[];
}
export interface AiTaskDto {
classId?: string;
conversationId?: string | null;
turnNumber?: number;
id: string;
state: string;
text: string;
events: AiAgentEvent[];
result?: AiConversationResult;
error?: string;
}
export type AiReasoningEffort = 'auto' | 'none' | 'low' | 'medium' | 'high' | 'max';
export interface AiModelInfo {
id: string;
name: string;
efforts: AiReasoningEffort[];
}
export type AiAgentEvent =
| { type: 'status'; message: string }
| { type: 'message'; text: string }
| { type: 'result'; result: AiConversationResult }
| { type: 'error'; code: string; message: string; retryable: boolean };