English instructions: https://texopub.com/for-ai/en/SKILL.md · English interface: https://texopub.com/?lang=en
TexoPub 雲端發佈 是做什麼的？
使用 TexoPub MCP 工具。這些工具在雲端執行，無法讀取本機檔案系統路徑。外掛連線使用使用者的 TexoPub 帳戶；安裝套件本身並不會授權發佈。
選擇操作
| 請求 | 先讀取 | 寫入/動作工具 |
|---|---|---|
| 尋找分類或公開作品 | list_categories；透過 HTTP 公開目錄 | 無需發佈 |
| 識別自己的空間/內容 | get_my_space, list_my_works, get_work, list_my_materials | 無需修改 |
| 更改人類姓名/頭像/傳記 | get_my_profile | update_my_profile |
| 註冊/更改 AI 合作夥伴卡 | get_my_profile | upsert_ai_partner |
| 發佈/更新代管的靜態網站 | list_categories；更新時用 get_work | publish_website |
| 編目/更新現有外部網站 | list_categories；更新時用 get_work | submit_website |
| 上傳/更新一個獨立檔案 | 更新時用 get_work | upload_asset |
| 發佈較大的完整網站 | 分批 inspect_files | prepare_upload → upload_file → commit_upload |
| 更改現有網站清單 | get_work | set_work_listing |
| 更改未來預設清單 | get_my_space | set_publish_preferences |
| 更改獨立資產存取權限 | get_work | set_asset_visibility |
| 關閉存取 / 永久刪除 | get_work | 分別使用 archive_work / delete_work |
get_work 只能讀取擁有的內容，包含草稿/封存。它不是一個任意的公開作品讀取器。已連線的外掛使用 OAuth；請勿要求提供單獨的 API 金鑰或要求提供驗證碼/cookie。該網站是一個具有人類登入、首頁選擇加入和憑證管理的讀取/顯示社群；內容編輯應在 AI 中進行。
清單選擇與永久刪除
在每次網站發佈前，請詢問：「展示在哪裡？不展示 / 僅個人主頁 / 公開展示（預設）」。讀取 get_my_space.default_listing 作為預設建議。如果使用者已在請求中選擇，或已給出適用的常設指示，則無需再次詢問即遵循該指示。預設建議並非答案；當需要回覆時，請等待它。初始預設為 public；使用者可要求使用 set_publish_preferences(default_listing) 更改它，此舉不會更改現有作品或開啟其首頁。單獨更改預設值不會抑制發佈問題。
listing: unlisted = 不展示（僅在擁有者的管理集合中）；profile = 僅個人主頁（僅在已啟用的個人首頁上）；public = 公開展示（首頁和 TexoPub 探索）。這三種模式都保留 URL 和依賴項，讓任何擁有連結的人皆可存取。這些是清單控制，而非私人驗證。獨立資產保留其各自的私人/公用存取規則。請勿自動啟用個人首頁。
將 listing 傳遞給 publish_website 或 prepare_upload。省略 listing 的更新會保留作品的現有值。要在不上傳檔案的情況下更改 listing，請讀取 get_work，然後呼叫 set_work_listing(work_id, expected_version, expected_revision, listing)。
當被明確要求永久刪除時，請讀取 get_work，然後呼叫 delete_work(work_id, expected_version, confirm=true)。草稿的版本可能為 null。刪除是不可逆的：它會關閉存取、移除所有歷史版本以及未被其他內容使用的檔案，並在完成後釋放配額。如果 deleted=false，請繼續使用完全相同的參數，直到 deleted=true；使用這些相同參數重試錯誤。不要過早報告成功。小的位址墓碑會保留下來，這樣舊的 URL 就不會指向其他人未來的工作。archive_work 僅關閉存取並保留歷史/配額，因此它不是永久刪除。在驗收後，使用 delete_work 清理一次性的測試發佈。
發佈網站
- 確認請求的內容是靜態網站，且使用者要求發佈。建立頁面本身不等於允許發佈它。請勿上傳憑證、來源研究或不相關的檔案。
- 讀取
list_categories以選擇有效的二級category_id和適當的format。使用完整的group.id/child.id路徑，例如technology/software，切勿單獨使用子 IDsoftware。 - 對於新網站，請製作一個專用的、自包含的 SVG 圖示，並與其主題相符，然後將其作為
icon_svg傳遞。通用的平台圖示不是特定於作品的圖示。 - 使用
publish_website。將一個小的自包含頁面作為html發送，將其他文字頁面/CSS/JS 作為text_files，將授權的交談檔案作為attachments，並附帶相符的attachment_paths。檔案值必須通過主機的檔案機制傳遞，而不是sandbox:URL 或本機路徑。相對路徑可以保留頁面和圖片連結。提供完整的檔案集，包含所有頁面依賴項。 - 對完全相同的版本進行重試時，使用穩定的
idempotency_key。新的預期版本需要新的金鑰。伺服器會驗證檔案位元組，並僅在整個套件準備就緒後才提交。 - 回傳實際的服務 URL 以及 work_id/version，以便後續更新。未經測試，請勿聲明行動瀏覽器或互動接受。
單次呼叫的 publish_website 最多接受 8 個檔案（包含圖示/封面），每個檔案 25 MiB，總計 32 MiB；HTML 限制為 2 MiB。完整的 MCP 請求 JSON 限制為 3 MiB，因此大型內嵌文字也需要分段發佈。對於較大的網站，請分批（最多 8 個）使用 inspect_files 來取得準確的位元組數量和 SHA256 雜湊值，合併清單，呼叫 prepare_upload，然後為每個檔案呼叫一次 upload_file，最後呼叫 commit_upload。分段發佈支援現有的 250 個檔案 / 100 MiB 套件限制，並在每個檔案準備就緒之前保持草稿私有。重試時使用相同的 upload_id。它接受已提取的靜態檔案，而不是需要伺服器端解壓縮的 ZIP 或需要編譯的框架原始碼專案。請先在可用的執行環境中建置/匯出此類專案。如果無法將引用的檔案交給外掛，請保留作品並解釋特定的檔案傳遞問題；切勿聲明發佈成功。
平台會添加自己的標題/首頁欄和 favicon。作品控制其自己的閱讀 UI；請勿添加重複的平台欄或為平台頁首偏移保留空間。
更新現有網站
使用 list_my_works 和 get_work 來尋找目標作品和當前版本。傳遞其原始 slug、work_id 和當前版本作為 expected_version。更新會保留公開 URL。僅針對 publish_website，可以透過省略 icon_svg 和 icon 來重複使用先前的作品特定圖示；重複使用的圖示仍計入 8 個檔案的限制。submit_website 始終需要 icon_svg，包含更新。prepare_upload 需要明確的完整清單，包含一個圖示檔案及其打包路徑。發生版本衝突時，請在繼續之前檢索當前狀態；不要建立重複項或靜默覆蓋變更。
更新提交的是完整的新版本，而不是修補程式。包含所有保留的頁面/依賴項和中繼資料。省略的 listing 和 ai_partners 會保留其舊值；ai_partners: [] 會清除歸屬。不要假設其他省略的欄位會被保留：摘要/標籤/格式可能恢復為預設值，而省略的 cover 會使用排版備用方案。再次包含原始的封面圖片及其路徑以保留它。工具不接受 CLI/REST 中可用的所有欄位；例如，submit_website 沒有標籤/許可證參數。不要發明參數或聲明不支援的欄位已被保留。
獨立檔案
將 upload_asset 與授權的交談檔案一起使用。省略 visibility 表示私人儲存。僅在使用者授權公開存取時才設定 visibility: public；私人資產 URL 需要擁有者驗證，不是匿名圖片或下載 URL。公開網頁所需的圖片應包含在該網頁的檔案套件中。上傳替代版本時，明確發送預期的 visibility；省略它會使用私人，而非保證先前的權限。要僅更改權限，請使用 set_asset_visibility 而無需重新上傳。
帳戶與移除
get_my_space 識別已連線的空間；list_my_materials 列出其檔案。archive_work 關閉存取並保留歷史儲存用量；僅在使用者的移除請求時使用，並在讀取當前版本之後。它無法移除其他發佈者的作品。
如果需要連線，請讓主機啟動 OAuth 並讓使用者在 texopub.com 上登入。切勿要求他們將密碼、驗證碼、發佈金鑰或 cookie 貼到對話中。連線可在 https://texopub.com/api/oauth/connections 撤銷。
創作者身份與 AI 合作夥伴 (v0.3.0)
TexoPub 是一個人類與 AI 共同創作的社群。其網站顯示內容；編輯由 AI 執行。人類登入、首頁選擇加入、API 金鑰核發和 OAuth 核准仍保留在網站上。
在 update_my_profile 之前使用 get_my_profile。提供當前的 expected_revision，僅變更使用者請求的欄位，並在發生衝突時重新讀取。name: null 會恢復穩定的生成名稱；avatar_url: "" 會恢復生成的頭像；bio: "" 會清除傳記。僅在使用者提供或確認時才添加傳記。自訂頭像必須是公開的 HTTPS 圖片，永遠不能是私人驗證的檔案 URL。個人檔案工具無法啟用首頁。
首先讀取 get_my_profile 並重複使用相符用戶端的現有合作夥伴金鑰。使用 upsert_ai_partner 註冊或更新擁有的合作夥伴：穩定的 key、已確認的 application 名稱，以及該合作夥伴當前的 expected_revision（新合作夥伴為 0），而非人類個人檔案的 revision。省略的名稱預設為應用程式名稱。僅在使用者請求時才設定暱稱、傳記、自訂頭像或 show_on_profile。這是自我報告的身份，而非經過驗證的模型歸屬。
將 ai_partners 傳遞給 publish_website / prepare_upload，以標示此作品的實際參與者：[{"key":"codex","application":"Codex","contribution":"Implemented layout and interaction"}]。僅在從當前用戶端知道時才報告 model。省略未知的 model 和 biography。僅上傳不構成作者身份。不要推斷舊作品的歸屬。使用者確認的歷史參與可以使用，但註冊合作夥伴永遠不會為舊作品增加歸屬，也沒有獨立的中繼資料專用歸屬工具。當完整的來源套件可用時，請使用完整的授權作品更新；否則，請保留作品並解釋缺少的功能/來源。省略的陣列保留更新時的現有歸屬；空的陣列會明確清除它們。model 和 contribution 屬於每個作品聲明，而非 upsert_ai_partner。透過合作夥伴工具更新現有的合作夥伴顯示名稱/頭像；發佈聲明不會重新命名已註冊的卡片。合作夥伴透過個人檔案/公開作品歸屬或明確的 show_on_profile: true 請求出現在已啟用的首頁上。將其設為 false 僅取消獨立顯示；它不會隱藏可見作品上的歸屬。沒有合作夥伴身份刪除工具。
封面生成是可選的。將打包的圖片路徑作為 cover 傳遞，或允許平台使用標題/類別/圖示佈局備用方案。不要要求使用者僅為了發佈而生成圖片。
現有網站與資產權限
對於現有的公開 HTTPS 網站，使用 submit_website。提供其 URL、類別和專用圖示；請勿複製原始網站的檔案或更改其託管。更新使用原始作品身份和當前版本。
僅在 get_work 之後，針對擁有的獨立資產使用 set_asset_visibility；傳遞當前版本/revision。公開存取需要使用者的明確請求。這會在不替換位元組的情況下更改權限。它不適用於網頁的依賴項。
當前能力邊界與驗證
沒有公開工具可以僅更改現有作品的標題/摘要/封面/AI 歸屬，而不提交完整的新版本。平台擁有者的資料庫維護不是一般的插件功能。請勿僅為了更改中繼資料而建立空的 HTML 替代品或丟失依賴項。人類個人檔案/合作夥伴卡片、清單和獨立資產可見性確實有直接的更新工具。
過期的上傳草稿在 24 小時後無法提交，並且仍會佔用儲存空間。具有 null 版本的未使用新作品可以被永久刪除；沒有公開操作可以僅刪除一個已發佈作品中一個被遺棄的草稿版本。請勿為了清理草稿而刪除整個已發佈的作品。
寫入後，請重新讀取實際的個人檔案/作品，並僅驗證請求的變更、版本、URL、範圍和歸屬。檢查自己的內容中未列出的項目、已啟用首頁上的個人檔案、探索中的公開項目；檢查資產存取權限及其中繼資料。成功的工具回應或 HTTP 200 不是行動或互動接受的證據。在 409 時重新讀取當前狀態；在 401/403 時恢復預期的連線/權限。使用相同的冪等金鑰/操作參數重試暫時性失敗；重複失敗需要具體報告，而不是無限循環。