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 仅包含面向公众访客的信息。
