如何快速生成 HTML/Markdown 公共链接：Orca Artifacts 分享完整指南
【免费下载链接】orcaOrca is the ADE for working with a fleet of parallel agents. Run any coding agent with your own subscription. Available on desktop, mobile and VPS.项目地址: https://gitcode.com/GitHub_Trending/orca48/orca
Orca Artifacts 是 Orca 提供的文件分享能力：一条命令即可把本地的 HTML 或 Markdown 文件发布为公共链接，方便把 agent 生成的报告、页面原型快速分享给任何人。Orca 是一个并行运行多个编码 agent 的桌面开发环境（ADE），支持桌面、移动端和 VPS 部署，Artifacts 正是它"分享 agent 产出"的关键一环。
为什么需要 Artifacts 公共链接 📤
用 agent 写代码时，经常会产出这类文件：
- 生成的 HTML 报告、单页演示
- agent 写好的 Markdown 文档、README 草稿
传统分享方式是压缩后发到群里，或自己搭个静态托管。而 Artifacts 让文件"就地变身"公共网页：
- 文件发布后得到一个专属公共链接（shareUrl），任何人打开即可在浏览器中查看
- 链接归属你登录的 Orca 账号，可随时更新内容或撤销
- 同一路径重复分享会自动更新，链接不变，适合持续迭代
第一步：在设置中开启 Artifacts 分享
出于安全考虑，公共链接发布默认是关闭的——毕竟生成的链接任何拿到的人都能打开。第一次分享前需要先开启开关：
- 打开 Orca 桌面应用，进入Settings → Artifacts
- 打开"Allow publishing public artifact links"
- 回到终端重新执行分享命令即可
这个开关对整台设备生效：无论人工输入命令还是 agent 自动执行，开启前都无法生成公共链接。开启逻辑集中在 artifact-sharing-gate.ts 中，保证应用界面、CLI 和 agent 三者遵循同一份权限契约。
第二步：用一条命令生成公共链接
Orca 内置 CLI，在终端执行分享命令，文件内容会自动上传并渲染为网页：
orca artifacts share ./report.html orca artifacts share ./notes.md --json几个要点：
- 只支持 HTML 和 Markdown：
.html/.htm按text/html、.md/.markdown按text/markdown处理，其他扩展名会被拒绝 - 成功后会返回
id（唯一标识）、更新时间和url（公共链接），可直接粘贴给同事 - 加
--json输出结构化结果，方便脚本解析 - 未登录账号会提示先登录 Orca 再试
命令的参数与示例定义在 specs/artifacts.ts，具体的读取、校验与上传流程实现在 handlers/artifacts.ts。
常用管理命令速查
| 命令 | 作用 |
|---|---|
orca artifacts share <file> | 分享文件，生成/更新公共链接 |
orca artifacts update <file> | 用最新文件内容更新已分享的链接 |
orca artifacts unshare <file> | 撤销某个文件对应的 artifact |
orca artifacts list | 列出当前账号名下的所有 artifact 及链接 |
orca artifacts delete <id> | 按 id 删除某个 artifact |
典型工作流：先用share发出链接，文件改完后update原地刷新内容（链接不变），最后用list巡检、delete清理，保证没有"僵尸链接"。数据结构（slug、title、shareUrl、过期时间等）定义在 shared/artifacts.ts，其中每个 artifact 都带expiresAt字段，生命周期是受控的。
注意事项与限制
- 大文件走浏览器上传：CLI 通道有 800 KB 的体积上限，超出会提示改用浏览器上传页面
- 安全优先：公共链接不设访问门槛，敏感内容不要分享；分享前先确认开关确实是自己主动开启的
- 归属账号：artifact 归属登录的桌面账号，换账号后原来的链接不在列表中
- agent 同样可用：编码 agent 在获得授权后也能替你执行分享，配合并行 worktree 工作流，把多个 agent 的产出一次性变成可访问的链接
写在最后
Orca Artifacts 把"让 agent 产出可分享的网页"这件事压缩成了两条命令：开启开关 +share。对于习惯用并行 agent 写报告、做原型的团队，这是成本最低的输出通道。想深入了解 Orca 的并行 worktree 与 CLI 能力，可以阅读仓库内的 README.md 与 docs/ 目录下的更多文档。
【免费下载链接】orcaOrca is the ADE for working with a fleet of parallel agents. Run any coding agent with your own subscription. Available on desktop, mobile and VPS.项目地址: https://gitcode.com/GitHub_Trending/orca48/orca
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
