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