docs(canvas): clarify entry and migration lifecycle

This commit is contained in:
2026-11-12 16:01:25 +08:00
parent 84c50fe595
commit 5803787910
5 changed files with 16 additions and 1 deletions
+2
View File
@@ -10,7 +10,9 @@ import { matchesRef, type Board } from "./workspace.ts";
* 返回数据不直接更新UI,导航是否仍有效由调用方控制。 */
export async function loadBoardCanvas(request: CanvasRequest, workspaceRef: string, boardRef: string, signal?: AbortSignal) {
const path = `workspaces/${encodeURIComponent(workspaceRef)}/materials/${encodeURIComponent(boardRef)}`;
// 两次请求同时启动;没有结果发布,也不会因一个失败主动取消另一个。
const [board, snapshot] = await Promise.all([request<Board>(path, { signal }), request<CanvasSnapshot>(path + "/canvas", { signal, headers: { Accept: CANVAS_ACCEPT } })]);
if (board.kind !== "board" || !matchesRef(board, boardRef) || typeof board.workspace_id !== "string" || !board.workspace_id) throw new Error("invalid_reference");
// decodeSnapshot 验证旧协议快照;此函数不另做 await 后取消检查或 canonical 迁移状态探测。
return { board, snapshot: decodeSnapshot(snapshot) };
}