工件(Artifact)

Artifacts

工件(artifact)是你为用户构建的东西,也是交付任何大于聊天消息的内容的主要方式。有三种:

- 文档:生成的文件(PDF、Word、电子表格、幻灯片、markdown)。一旦下载,它们就归用户所有,可以像任何文件一样离线使用。

- 页面:从你的电脑实时托管的静态网站。用户设备上无需安装任何东西,也没有离线模式。

- 交互式应用:像页面一样实时托管,还可以存储自己的数据。页面和文档本身不持有实时状态。

工件及其数据存放在你的电脑上,即用户自己的 Muse 环境中:交互式应用把记录保存在它自己的数据库里,重启和更新后依然保留。在用户发布之前,任何东西都不会托管在别处;发布只提供静态快照(见“Sharing & Publishing”),因此应用存储的数据绝不会外流。

Artifacts are what you build for the user, and the main way to

deliver anything bigger than a chat message. There are three kinds:

- Documents: generated files (PDF, Word, spreadsheets, slide decks,

markdown). Once downloaded, they are the user's to keep and work

offline like any file.

- Pages: static websites hosted live from your computer. Nothing

installs on the user's device and there is no offline mode.

- Interactive apps: hosted live like pages, and they can also store

their own data. Pages and documents hold no live state of their own.

An artifact and its data live on your computer, in the user's own

Muse environment: an interactive app keeps its records in its own

database there, persisting across restarts and updates. Nothing is

hosted anywhere else until the user publishes, and publishing serves

only a static snapshot (see Sharing & Publishing), so an app's stored

data never leaves.

位置
Location

工件在所有平台都存放在资料库(Library)中。在网页端,可以通过 /artifacts URL 直接前往。资料库的机制(收集什么、下载如何工作)见 `~/docs/files-and-library.md`。各平台的界面布局见 `~/docs/client-surfaces.md`。

Artifacts live in the Library on every platform. On web, you can

navigate directly via the /artifacts URL.

Library mechanics (what collects there and how downloads work) are in

`~/docs/files-and-library.md`. Per-platform screen layouts are in

`~/docs/client-surfaces.md`.

分享与发布
Sharing & Publishing

分享工件意味着把它发布为一个公开可访问的链接。Share 控件在每个平台的工件菜单中(确切位置见 `~/docs/client-surfaces.md`)。在移动应用上,它只出现在可发布的工件上。规则:

- 只有静态工件可以发布。交互式应用不能公开。

- 每次发布,以及已发布链接的每次后续更新,都需要一次新的一键批准。批准是一次性的,绝不持久:没有自动发布,没有长期批准模式。已发布的页面不会自动更新。

- 在机密 VM 上,分享不可用。流程在任何内容被审核或发布之前就会失败。

未发布的工件只有创建它的用户能访问。

分享工件没有直达社交发布的路径。用户可以通过其平台的分享面板单独分享单条聊天消息。已连接账户能否发布内容,取决于该连接器(connector)自己的 skill 文档(见 `~/docs/connectors.md`)。

Sharing an artifact means publishing it to a publicly available link. The Share

control is in the artifact menu on every platform (exact locations:

`~/docs/client-surfaces.md`). On the mobile apps it appears only on artifacts that

can be published. Rules:

- Only static artifacts can be published. Interactive apps cannot be

made public.

- Every publish, and every later update to an already-published link,

needs a fresh one-tap approval. Approvals are one-time and never

persist: no auto-publish, no standing approval mode. Published pages

do not update automatically.

- On confidential VMs, sharing is unavailable. The flow fails before

anything is reviewed or published.

Artifacts that are not published are only accessible by the user that created it.

Sharing an artifact has no direct social-post path.

Users can separately share individual chat messages through their

platform's share sheet. Whether a connected account can post content

depends on that connector's own skill doc (see `~/docs/connectors.md`).

删除
Deletion

删除工件是永久性的:它会移除工件及其数据、拆除托管、撤销所有公开分享。工作区文件的 30 天回收站是独立的,不适用于工件。删除工件前务必警告用户。`artifact.list` 是判断存在什么的唯一真相来源;“什么都没删”的说法,只有在拿到最新列表时才成立。

Deleting an artifact is permanent: it removes the artifact and its data,

tears down hosting, and revokes any public share. The 30 day trash for

workspace files is separate and not available for Artifacts. Always warn the user before deleting an

artifact. `artifact.list` is the source of truth for what exists; a

claim that nothing was deleted is only as good as a fresh listing.