Method parseProjectFile

app/src/core/Project.tsx:238–295

* 解析项目文件（ZIP格式），提取所有数据 * @returns 解析后的数据对象

()

   * @returns 解析后的数据对象
   */
  private async parseProjectFile(): Promise<{
    serializedStageObjects: any[];
    tags: string[];
    references: { sections: Record<string, string[]>; files: string[] };
    metadata: PrgMetadata;
    readme?: string;
  }> {
    const fileContent = await this.fs.read(this.uri);
    const reader = new ZipReader(new Uint8ArrayReader(fileContent));
    const entries = await reader.getEntries();

    let serializedStageObjects: any[] = [];
    let tags: string[] = [];
    let references: { sections: Record<string, string[]>; files: string[] } = { sections: {}, files: [] };
    let metadata: PrgMetadata = createDefaultMetadata("2.0.0");
    let readme: string | undefined = undefined;

    for (const entry of entries) {
      if (!entry.directory) {
        if (entry.filename === "stage.msgpack") {
          const stageRawData = await entry.getData!(new Uint8ArrayWriter());
          serializedStageObjects = this.decoder.decode(stageRawData) as any[];
        } else if (entry.filename === "tags.msgpack") {
          const tagsRawData = await entry.getData!(new Uint8ArrayWriter());
          tags = this.decoder.decode(tagsRawData) as string[];
        } else if (entry.filename === "reference.msgpack") {
          const referenceRawData = await entry.getData!(new Uint8ArrayWriter());
          references = this.decoder.decode(referenceRawData) as { sections: Record<string, string[]>; files: string[] };
        } else if (entry.filename === "metadata.msgpack") {
          const metadataRawData = await entry.getData!(new Uint8ArrayWriter());
          const decodedMetadata = this.decoder.decode(metadataRawData) as any;
          // 验证并规范化 metadata
          if (isValidMetadata(decodedMetadata)) {
            metadata = decodedMetadata;
          } else {
            // 如果格式不正确，使用默认值
            metadata = createDefaultMetadata("2.0.0");
          }
        } else if (entry.filename === "README.md") {
          const readmeRawData = await entry.getData!(new Uint8ArrayWriter());
          readme = new TextDecoder().decode(readmeRawData);
        } else if (entry.filename.startsWith("attachments/")) {
          const match = entry.filename.trim().match(/^attachments\/([a-zA-Z0-9-]+)\.([a-zA-Z0-9]+)$/);
          if (!match) {
            console.warn("[Project] 附件文件名不符合规范: %s", entry.filename);
            continue;
          }
          const uuid = match[1];
          const ext = match[2];
          const type = mime.getType(ext) || "application/octet-stream";
          const attachment = await entry.getData!(new BlobWriter(type));
          this.attachments.set(uuid, attachment);
        }
      }
    }

    return { serializedStageObjects, tags, references, metadata, readme };
  }