Dokki Docs logo

生成與編輯

Dokki 可以根據描述建立 Artifact,並透過後續指示來完善它。

開始新的 Artifact

  • 選擇 建立 → Artifact

  • 選擇空白起點或 Artifact 模板。

  • 描述目標、受眾、要包含的資訊,以及重要的互動。

  • 生成第一版,然後在分享或發布前檢視預覽。

提出有用的請求

具體說明變更和原因。例如:「將關鍵指標移到圖表上方,新增日期範圍控制,並讓行動版保持單欄。」小巧、可測試的請求比在一個提示中進行全面重新設計更容易審查。

了解狀態

  • 生成中 — Dokki 正在建立新版本。

  • 就緒 — 最新版本可以預覽和編輯。

  • 錯誤 — 請求未完成;檢視訊息,如有需要調整請求,然後重試。

儲存為模板

當 Artifact 超出目前任務仍有用的時候,開啟其設定並選擇 儲存為模板。先為它命名並提供說明,並移除專案特定或敏感資訊。

讀取即時工作區資料

在 Dokki 內執行的 Artifact 程式碼可以使用唯讀的 window.dokki 橋接:

const table = await window.dokki.readTable("<table-resource-id>")
const document = await window.dokki.readDocument("<document-resource-id>")

Artifact 作者和目前檢視者都必須被允許讀取目標,且目標必須與 Artifact 位於相同的工作區。橋接僅支援文件和表格讀取,限制並發請求,並限制表格輸出供渲染,而非批次匯出。

已發布的 Artifact 快照無法讀取即時的 Dokki 資料。設計公開 Artifact 時,請使用凍結或嵌入的資料,並處理被拒絕的即時資料請求,而不是讓頁面無限期等待。

發布前

  • 測試每個控制和連結。

  • 檢查桌面和窄螢幕版面。

  • 確認 Artifact 只包含供公開訪客使用的資訊。