Pickful 社群朋友們，

用 AI 助理（Claude、Codex 等任何支援 MCP 的工具）或 REST API 發內容的朋友，回饋最多的是：文字能自動發，圖卻得另想辦法。書籍只能在網頁上傳，長文只能帶一張封面，內文的圖表、截圖只好另找圖床再貼連結。今天這兩件事一起解決了。

💡 先說一句：下面提到的打包、上傳、參數這些中間細節，AI 助理會自己查看工具說明，自動完成。你只要把需求說清楚就好，例如「把這個資料夾裡的書稿連同插圖發成一本書，定價 10 USDC，先存草稿」。

📚 書籍：一個 ZIP，整本書連圖帶封面

現在可以直接用 AI 助理或 API 發書了：

• 打包上傳：把書稿 book.md 和 images/ 資料夾打成一個 ZIP，根目錄放一張 cover.png 就是封面
• 自動排版：每個一級標題 # 章名 是一章，圖片依引用位置放進對應章節
• 容量夠大：每本書最多 200 張圖，ZIP 不超過 50MB
• 先審再發：預設建成草稿，用 get_book_status 核對章節數、圖片和封面，確認無誤再 publish_book；也可以用 published_at 定時上架
• 定價與署名：可設作者名和 USDC 價格，讀者付款直達作者錢包
• 改版方便：update_book 傳一個新的 ZIP，整本書重新解析，章節和圖片一起更新

相關工具：create_book_upload、create_book、update_book、get_book_status、publish_book。

✍️ 長文：內文配圖

寫稿時照常用 Markdown，在想放圖的位置寫一行 ![圖片說明](images/chart.png)，再任選一種方式交圖：

每篇最多 40 張圖，ZIP 不超過 30MB。update_post 同樣能補圖、換圖，只改文字時原本的圖照樣顯示；只傳文字和封面的舊用法完全不變。

🛡️ 兩邊共用的幾個細節

• 不會發出半成品：內文引用了卻沒上傳的圖，會直接報錯並列出缺哪幾張
• 多傳的圖會提醒：上傳了卻沒用到的圖，會在結果裡列出來
• 逾時重試不重複：網路中斷後用同一個 upload_id 再送一次，拿回的是已經建好的那本書或那篇文章

單張圖 5MB 以內，支援 PNG、JPEG、WebP。

💬 致社群

好的研究少不了圖：一張數據圖，往往比三段文字更有說服力。希望這次更新讓大家把完整的研究，連同每一張圖，原樣搬上 Pickful。使用上有任何問題，歡迎隨時告訴我們。

此功能已在 Web、iOS、Android 三端同步上線，無需更新 App 即可使用。

Pickful Team
10.16