docs(app): explain request and directory lifecycle boundaries

src/lib/workspace.ts

@@ -37,6 +37,7 @@ export async function loadWorkspaceHome(
   request: Request,
   signal?: AbortSignal,
 ) {
+  // 任一读取拒绝则整体拒绝，Promise.all 不会自动取消另一请求；共同 signal 由宿主管理。
   const [profile, result] = await Promise.all([
     request<Profile>("profile", { signal }),
     request<Workspace[] | { items: Workspace[] }>("workspaces", { signal }),
@@ -62,6 +63,7 @@ export async function createBoard(
       body: JSON.stringify({ name: "个人空间" }),
     });
     id = workspace.id;
+    // 回调在创建画布前同步执行；回调抛错也会阻止后续 POST，但已创建的空间仍存在。
     onWorkspaceCreated(workspace);
   }
   const name = title.trim() || DEFAULT_BOARD_TITLE;