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 只包含供公開訪客使用的資訊。
