开始前
- 使用已验证手机号、状态正常的 YunLeFun 账号登录。
- 准备一个自己拥有 write、maintain 或 admin 权限的 GitHub 仓库。
- 允许 YunLeFun CMS GitHub App 访问目标仓库。
连接站点
- 登录云栈并关联 GitHub，短期用户授权只用于确认身份和 App 安装范围。
- 安装或调整 YunLeFun CMS App 的仓库范围，然后刷新授权。
- 搜索并选择仓库；Monorepo 可在“高级：分支与项目目录”中指定目标位置。
- 连接成功后，从内容目录打开文档，等待云草稿保存，再点击“发布”，核对变更后创建 Pull Request。
在另一台设备继续草稿
- 在第一台设备登录云栈，打开已连接站点的文章，编辑后等待状态栏显示“云草稿已同步”，并确认没有同步错误。
- 在另一台设备的浏览器登录同一个 YunLeFun 账号，选择同一站点并打开文章。云栈会读取 CMS 中的最新草稿版本。
- 如果两台设备同时修改了同一版本，先在冲突界面核对两份内容，再选择云端版本或保存合并结果。
桌面客户端默认在本地保存。登录桌面账号不会自动上传本地文件；需要为当前项目连接云端草稿，并在浏览器批准具体站点后才能同步。也可直接在浏览器使用云端工作台；桌面登录状态不会自动登录 Web。
查看文章以外的文件
Web 左侧「内容目录」中的「显示仓库其他文件」可展示已连接仓库的其他文件；内容集合之外的文件保持只读。桌面侧边栏可切换「文章／文件」：文章视图专注 pages/**/*.md，文件视图按需浏览本地目录，支持文本和图片只读预览，并保留未保存的文章草稿。
上传与使用图片
- 将光标放到文章需要插图的位置，点击「插入图片」，或直接拖入、粘贴图片文件；也可从「媒体 → 打开媒体资源」或封面字段的图片按钮进入。
- 选择「跟随默认设置／自动压缩（WebP）／使用原图」，以及「随文章发布后公开／立即生成公开链接」。选择会保存在当前设备。
- 点击「上传并插入」选择文件，或确认已拖入的图片。支持 JPEG、PNG、WebP、GIF、AVIF，Web 单张最多 50 MiB，正文每批最多 20 张，图片字段一次一张。
- 上传完成后自动插入原光标或拖放位置。已有资源可以「选择并插入」，也可「立即生成公开链接」或「复制公开链接」。
自动压缩只使用体积更小的结果；GIF、AVIF 和动画图片保持原样，失败时使用原图。「使用原图」直接用于文章；「仅私密保存原图」用于素材留存，不会插入或公开。
默认云图片在 PR 合并并完成图片公开处理后才能公开访问。「立即生成公开链接」会让任何持有链接的人都可访问，无需等待文章发布。公开地址来自站点存储，生成链接不等于开通 CDN 加速。
桌面插图窗口支持相同的文件选择、拖入和粘贴，单张最多 10 MiB。「当前项目」将图片复制到 public/images/yunzhan/，需随文章提交并部署。登录、配对站点并启用 COS 插件后，可选「云端媒体库」并生成公开链接；也可在「设置 → 插件 → 配对站点的云端图片」管理。私有云图片仍需经云端发布流程公开，本地直接部署不会完成此步骤。
日常图片上传与插入可在云栈内完成，「在 Drive 中管理」提供 YunLeFun Drive 素材整理入口。
写作助手
打开 Markdown 或 MDX 文章后，点击右下角的写作助手图标查看静态检查，再次点击可收起。助手以悬浮面板展示，编辑文章时可以继续查看建议。服务端配置 AI 模型后，可以按需获取逐步显示的写作检查和思路提示；面板会显示当前模型是否可用。点击“复制给 Codex”可将当前文章和审阅要求复制到剪贴板，再自行粘贴到 Codex 任务。
从草稿到 Valaxy 上线
- 等待云草稿同步完成，点击“发布”并核对选中文件、草稿版本和变更差异。
- 创建
yunzhan/**分支的 Pull Request。草稿保存和 PR 创建都不会直接修改主分支。 - 按仓库规则审阅并合并 PR，由仓库自己的 CI 构建 Valaxy 并部署；以 CI 和部署结果确认上线。
无法识别内容布局
标准 Valaxy 与 VitePress 仓库通常无需配置。如果云栈提示 CMS_MANIFEST_REQUIRED，请复制界面提供的模板，保存为仓库根目录的 .yunlefun/cms.json，按实际内容目录调整并提交，然后回到云栈重新连接。
Manifest 只声明可编辑内容、表单字段、帮助和首次使用指引，不能包含凭据，也不会扩大 GitHub 本身授予的权限。
协作邀请
开放内测不要求产品准入邀请。站点所有者仍可创建一次性的 Editor 或 Viewer 邀请链接，让协作者加入指定站点；协作者不需要拥有该 GitHub 仓库。