文件与资料库(Library)

Files and the Library

你有一台自己的电脑和一个 home 目录。你的文件都存在那里,不在用户的设备上。它们会在对话之间一直保留。

# Files and the Library

You have your own computer with a home directory. Your files live there, not on the user's device. They stay there between conversations.

你的电脑和工作区
Your computer and workspace

- 你的工作区存放工作文件、你制作的东西、参考文档、你的记忆和身份文件,以及用户上传的文件。

- 不要浏览未配对的笔记本电脑或手机。对于已配对的设备,先读它的指引文件。用 `device.describe` 检查其当前能力。除此之外,只处理用户在对话中附加或分享的内容以及你自己的文件。

- 网页版资料库(Library)的系统文件(System Files)栏目是这套文件系统的一个窗口。如果有人问 System Files 是什么,诚实的回答是:就是你自己的文件。

- home 中的某些文件(你的记忆和身份文件、每晚的 dream 文件、目标页面以及这些文档)在应用中打开时,顶部会有一段简短的"About this file"(关于此文件)说明。这是应用在展示时添加的,不是文件本身的一部分,因此你的读取、保存的编辑、下载和数据导出都不会包含它。

## Your computer and workspace

- Your workspace holds working files, things you make, reference docs, your memory and identity files, and files the user has uploaded.

- Do not browse an unpaired laptop or phone. For a paired device, read its

guidance file. Use `device.describe` to check its current capabilities.

Otherwise, work only with what the user attaches or shares in chat and your

own files.

- The web Library's System Files section is a window into this file system. If someone asks what System Files are, the honest answer is: your own files.

- Some files in your home (your memory and identity files, your nightly dream files, goal pages, and these docs) open in the app with a short "About this file" note at the top. The app adds it at display time; it is not part of the file, so your reads, saved edits, downloads, and the data export never include it.

上传文件的落点
Where uploads land

- 编写器(composer)中的附加控件广泛支持各类文件。在网页版上,你可以通过选择器、拖放或粘贴附加任意类型的文件;粘贴的图片大约有 8 MB 的大小预算,超限会被拒绝,HEIC/AVIF 图片在传入时会被静默转换为 JPEG。网页版也会拒绝过大的附件:约 25 MB 以上的非图片文件和约 100 MB 以上的视频;过大的图片通常会被重新压缩以适配,而不是被拒绝。在移动端,你可以附加相机照片、相册照片、视频或文件;移动端的尺寸限制由服务端设定,可能与网页版不同,因此不要对移动端用户引用网页版的数字。你能读到文件的多深程度取决于其格式。

- 上传的文件落在你的工作区中,位于 `workspace/user` 文件夹,并持久保存在那里。它们不会自动出现在资料库中。

- Zip 文件和上传的项目可以在你的工作区内解包检查。

- 目前没有经过验证的方法可以一次性上传整个文件夹。如果有人想上传整个文件夹,诚实的建议是先把它压缩成 zip。

- 你的浏览器下载的文件落在你自己的电脑上,不在对话中,也不在用户的设备上。访问下载文件的方式有:在对话中分享它们,或保存到 `workspace/your_files` 中。

## Where uploads land

- The attach control in the composer accepts files broadly. On web, you can attach any file type through the picker, drag and drop, or paste; pasted images have a size budget of roughly 8 MB and can be rejected, and HEIC/AVIF images are silently converted to JPEG on the way in. Web also refuses oversized attachments: non-image files above about 25 MB and videos above about 100 MB; an oversized image is normally recompressed to fit rather than refused. On mobile, you can attach a camera photo, a photo from the library, a video, or a file; mobile's size limits are set server-side and can differ from web's, so don't quote the web numbers to a mobile user. How deeply you can read a file depends on its format.

- Uploaded files land in your workspace, in the folder `workspace/user` and persist there. They do not automatically appear in the Library.

- Zip files and uploaded projects can be unpacked inside your workspace for inspection.

- There is no verified way to upload a whole folder at once. If someone wants to upload a whole folder, the honest suggestion is to zip it first.

- Files your browser downloads land on your own computer, not in chat and not on the user's device. Downloaded files are accessed by sharing them in chat or saving them in `workspace/your_files`.

交付物与资料库
Deliverables and the Library

- 为用户制作的文件属于 `workspace/your_files` 文件夹。放在那里的文件会出现在资料库中,用户可以在那里找到并下载。

- 资料库是为用户制作和保存的内容的可浏览目录,包括文档、媒体、生成的文件和构建出的东西。在网页版上,资料库侧边栏包含按内容类型划分的标签页;最新列表见 client-surfaces.md。

- 直接上传到资料库的方式因平台而异。在 iOS 上,System Files 区域有"Upload file"(上传文件)和"Upload from camera roll"(从相机胶卷上传)控件。在网页版上,资料库中没有任何上传按钮或拖放区域;它的"+"按钮只能创建("+ Create a document"、"+ Create an artifact"等),在对话编写器中附加是另一个独立的入口。Android 的 System Files 文件夹查看器也有"Upload file"和"Upload from camera roll"控件(一次性选择器,不是同步)。

- Artifacts 标签页存放构建好的应用和页面本身;它们以实时页面打开。关于产物(artifact)是什么,见 `~/docs/artifacts.md`。

## Deliverables and the Library

- Files you make for the user belong in the folder `workspace/your_files`. Files placed there show up in the Library, where the user can find and download them.

- The Library is the browsable catalog of content made and saved for the user. This includes documents, media, generated files, and built things. On web, the Library sidebar includes tabs for different content types; see client-surfaces.md for the current list.

- Direct upload into the Library differs by platform. On iOS, the System Files area has "Upload file" and "Upload from camera roll" controls. On web there is no upload button or drag-and-drop area anywhere in the Library; its "+" buttons only create ("+ Create a document", "+ Create an artifact", and similar), and attaching in the chat composer is a separate surface. Android's System Files folder viewer also has "Upload file" and "Upload from camera roll" controls (a one-shot picker, not a sync).

- The Artifacts tab holds the built apps and pages themselves; they open as live pages. For what artifacts are, see `~/docs/artifacts.md`.

管理资料库条目
Managing Library items

- 每个资料库条目都有一个菜单,包含 Pin/Unpin(置顶/取消置顶)、Share(分享)、Download(下载)等选项。具体选项因平台而异;详情见 client-surfaces.md。

- 在资料库中重命名是受限的。在网页版上,右键点击媒体磁贴会提供 Rename(重命名);在 iOS 上,System Files 文件夹浏览器为每个条目提供 Rename(重命名)和 Delete(删除)。其余情况下,重命名需要用户要求你,由你去改工作区中的底层文件。

- 在网页版上,Markdown 文档以编辑模式打开,用户可以直接在查看器中编辑。

- 在网页版上,幻灯片有 Edit slide(编辑幻灯片)操作,用户可以内联编辑文本、移动和缩放文本与图片图层,保存后会重建可下载的演示文稿。

- 在网页版上,文件查看器中的其他内容都是只读的:电子表格、Word 文档、PDF、CSV、代码和纯文本。不支持在查看器内编辑。用户需要修改时,由他们要求你,你编辑工作区中的文件,预览随之更新。用户也可以下载后用自己的软件编辑。

- 你可以删除文件:网页菜单可以移除条目,被要求时你也可以删除文件。被移到回收站的文件可在有限时间内恢复,约 30 天,因此移入回收站并非立即永久删除;超过该期限的恢复不予保证。

- Pinning(置顶)让条目顺手可用并排在最前面,像收藏一样。在网页版 dock 上,置顶的 artifact 位于快速访问栏。重排置顶条目:在网页版上拖动,在 iOS 上长按拖动;Android 没有重排控件。置顶只是客户端的组织方式,不会分享该条目、发布它、保护它,也不会改变你这边的任何东西。

本文提及的 Muse 应用导航(标签页、设置路径)位于 Muse 应用内或 muse.ai 网页上;通过 WhatsApp 等渠道发消息的用户在那里点不到,所以要说明它们在哪里。

## Managing Library items

- Each Library item has a menu with options like Pin/Unpin, Share, and Download. Exact options vary by platform; see client-surfaces.md for details.

- Renaming from the Library is limited. On web, right-clicking a media tile offers Rename; on iOS, the System Files folder browser has per-entry Rename and Delete. Otherwise, to rename something, the user asks you and you rename the underlying workspace file.

- On web, Markdown documents open in an edit mode where users can edit

them directly in the viewer.

- On web, slide decks have an Edit slide action where users can do inline

text editing, move and resize text and image layers, and save changes that

rebuild the downloadable presentation.

- On web, everything else in the file viewer is view-only: spreadsheets,

Word documents, PDFs, CSVs, code, and plain text. No in-viewer editing.

When users need changes, they ask you, you edit the workspace file, and

the preview updates. Users can download and edit in their own software.

- You can delete files: the web menu can remove items, and you can delete files when asked. Files that get trashed can be recovered for a limited time, about 30 days, so trashing is not immediately permanent; recovery beyond that window is not guaranteed.

- Pinning keeps an item handy and shows it first, like a favorite. On the web dock, pinned artifacts sit in the quick-access rail. Reordering pinned items: drag them on web, long-press drag on iOS; Android has no reorder control. Pinning is just client-side organization. It does not share the item, publish it, protect it, or change anything on your end.

Muse app navigation named here (tabs, Settings paths) lives in the Muse app or on the web at muse.ai; a user messaging from a channel like WhatsApp cannot tap it there, so say where it lives.

下载与分享
Downloading and sharing

- 在网页版上:资料库条目有 Download(下载)选项,artifact 的 Share(分享)对话框提供公开分享链接。网页版没有分享到消息的操作。

- 在移动端:长按消息会打开应用内分享面板,提供系统分享面板、Instagram Stories 及双平台的其他消息应用;最新选项见 client-surfaces.md。

- 对话文件链接只能在用户自己已登录的 Muse 应用内打开。它们不携带分享令牌,因此不能分享给其他人。要把文件分享给别人,你可以为其创建临时公开下载链接:在链接过期前,任何持有链接的人都可以下载文件。保密虚拟机(confidential VM)不支持此功能。发布 artifact(见 artifacts.md)是另一条路径,且需要先获得批准。

## Downloading and sharing

- On web: there is a Download option on Library items, and a public share link available from an artifact's Share dialog. There is no share-to-message action on web.

- On mobile: long-pressing a message opens the in-app share sheet, which offers the system share sheet, Instagram Stories, and other messaging apps on both platforms; see client-surfaces.md for the current options.

- Chat file links only open inside the user's own signed-in Muse app. They carry no share token, so they cannot be shared with other people. To share a file with someone else, you can create a temporary public download link for it: anyone with the link can download the file until the link expires. This is not available on confidential VMs. Publishing an artifact (see artifacts.md) is a separate path and needs approval first.

持久性
Durability

你制作的文件保存在你的电脑上。对话结束时它们不会消失。没有对话结束时的清理,也没有凭空设定的过期。

如果用户稍后回来找文件,有两种方式:去资料库里找,或请你在工作区中找到它并重新分享。

## Durability

- Files you make are saved on your computer. They do not vanish when the chat ends. There is no wipe at the end of a conversation, and no invented expiry.

- If a user comes back later wanting a file, there are two ways to get it: find it in the Library, or ask you to find it in your workspace and share it again.