Update AI planner integration, docs, and config

src/services/travel-assistant/storage.ts

@@ -4,12 +4,14 @@ import {
   cloneTravelPreferences,
   normalizePlanResponse,
   normalizeTravelPreferences,
+  type PlanningRequest,
   type PlanResponse,
   type TravelPreferences,
 } from '@/domain/travel'
 
 export const PLAN_STORAGE_KEY = 'guangming:last-plan'
 export const PREFERENCES_STORAGE_KEY = 'guangming:last-preferences'
+export const PLANNING_REQUEST_STORAGE_KEY = 'guangming:last-planning-request'
 
 const STORAGE_SCHEMA_VERSION = 1
 
@@ -99,3 +101,68 @@ export function loadPreferences(): TravelPreferences | null {
     return null
   }
 }
+
+export function savePlanningRequest(request: PlanningRequest): void {
+  const repository = getPoiRepository()
+  const sanitized: PlanningRequest = {
+    mode: request.mode,
+    preferences: normalizeTravelPreferences(request.preferences),
+    durationMinutes: request.durationMinutes,
+    selectedPoiIds: [...request.selectedPoiIds],
+  }
+  if (sanitized.mode !== 'quick' && sanitized.mode !== 'custom')
+    throw new Error('无法保存规划条件：规划模式无效')
+  if (!Number.isInteger(sanitized.durationMinutes)
+    || sanitized.durationMinutes < 120
+    || sanitized.durationMinutes > 600
+    || sanitized.durationMinutes % 30 !== 0) {
+    throw new Error('无法保存规划条件：规划时长无效')
+  }
+  if (sanitized.mode === 'quick' && sanitized.selectedPoiIds.length > 0)
+    throw new Error('无法保存规划条件：快速规划不能预选点位')
+  if (sanitized.mode === 'custom'
+    && (sanitized.selectedPoiIds.length < 2 || sanitized.selectedPoiIds.length > 8)) {
+    throw new Error('无法保存规划条件：自选点位数量无效')
+  }
+  if (new Set(sanitized.selectedPoiIds).size !== sanitized.selectedPoiIds.length
+    || sanitized.selectedPoiIds.some(poiId => !repository.getPoiById(poiId))) {
+    throw new Error('无法保存规划条件：自选点位无效')
+  }
+  writeStorage(PLANNING_REQUEST_STORAGE_KEY, createEnvelope(sanitized))
+}
+
+export function loadPlanningRequest(): PlanningRequest | null {
+  const repository = getPoiRepository()
+  const envelope = readEnvelope(readStorage(PLANNING_REQUEST_STORAGE_KEY))
+  if (!envelope || envelope.datasetVersion !== repository.getDatasetMeta().datasetVersion || !isRecord(envelope.payload))
+    return null
+  try {
+    const payload = envelope.payload
+    const request: PlanningRequest = {
+      mode: payload.mode as PlanningRequest['mode'],
+      preferences: normalizeTravelPreferences(payload.preferences),
+      durationMinutes: Number(payload.durationMinutes),
+      selectedPoiIds: Array.isArray(payload.selectedPoiIds) ? payload.selectedPoiIds.map(String) : [],
+    }
+    if (request.mode !== 'quick' && request.mode !== 'custom')
+      return null
+    if (!Number.isInteger(request.durationMinutes)
+      || request.durationMinutes < 120
+      || request.durationMinutes > 600
+      || request.durationMinutes % 30 !== 0) {
+      return null
+    }
+    if (request.mode === 'quick' && request.selectedPoiIds.length > 0)
+      return null
+    if (request.mode === 'custom' && (request.selectedPoiIds.length < 2 || request.selectedPoiIds.length > 8))
+      return null
+    if (new Set(request.selectedPoiIds).size !== request.selectedPoiIds.length
+      || request.selectedPoiIds.some(poiId => !repository.getPoiById(poiId))) {
+      return null
+    }
+    return request
+  }
+  catch {
+    return null
+  }
+}