如何使用Pinata服务向IPFS已有文件夹添加文件

首先明确核心逻辑：IPFS是内容寻址系统，不存在“修改已存在文件夹内容”的原生能力，常规原生IPFS文件夹追加文件操作，本质都是生成包含原有内容+新增内容的全新文件夹CID，Pinata的实现逻辑和这个底层规则完全对齐，有两种成熟方案可以实现需求：

• 方案1：本地重组目录重传（零门槛，适合小体量文件夹）
  先把Pinata上已固定的目标文件夹完整拉取到本地，把需要新增的文件放到对应目录位置，再把整个重组后的文件夹重新上传到Pinata即可。Pinata底层会自动做块去重，已经存过的文件不会重复占用存储配额，上传完成后会直接返回新的文件夹CID。
  *小提示：如果需要保持访问地址不变，可以给新旧两个CID绑定同一个IPNS记录，更新IPNS指向新CID后，所有访问原IPNS地址的用户都会自动拿到包含新文件的最新目录，不需要更换访问链接。
• 方案2：API 增量更新（适合大体量文件夹，不用拉取全量内容）
  不用下载整个原有文件夹，直接通过Pinata接口分三步操作即可：
  1. 先单独上传需要新增的文件，拿到新文件对应的CID
  2. 调用接口拉取已有文件夹的目录元数据，把新文件的CID和存放路径插入到目录结构里
  3. 把更新后的完整目录结构提交给Pinata做固定，就能拿到包含新文件的新文件夹CID
     核心操作示例代码：

  // 填入你自己的参数
  const OLD_FOLDER_CID = "目标已有文件夹的CID"
  const NEW_FILE_CID = "单独上传新文件后拿到的CID"
  const NEW_FILE_SAVE_PATH = "docs/新文件名.pdf" // 新文件在文件夹里的存放路径
  
  // 拉取旧目录结构
  const oldDirStructure = await pinata.listByCid(OLD_FOLDER_CID)
  // 插入新文件条目
  oldDirStructure[NEW_FILE_SAVE_PATH] = NEW_FILE_CID
  // 提交新目录固定，拿到新的文件夹CID
  const newFolderCid = await pinata.pinDirectory(oldDirStructure)
  

补充说明：操作完成后旧文件夹的CID依然存在且可访问，如果你不需要保留旧版本，可以在Pinata后台手动取消旧CID的固定，释放对应存储配额。

内容的提问来源于stack exchange，提问作者Edreldor