拖拽、放下、搞定:文件来到 Archyl 文档
我们都写过那种文档。
"见附件中的图。" 附件在哪?"看一下规格说明。" 哪份规格?"我把截图发到 Slack 了。" 三周前。在某个话题串里。早没了。
指向别处文件的文档,不是文档。它是一张缺了一半线索的藏宝图。
今天,这一切结束了。Archyl 文档现在可以容纳自己的文件了。
拖拽。放下。搞定。
打开任意一个文档页面,然后……直接把文件放上去。从剪贴板粘贴一张截图。或者点击 附加文件,选上几个。
图片会嵌入在你放下的位置——不用折腾 Markdown,不用四处找图床。其余的一切(PDF、规格、导出文件,还有那份总有人要的 CSV)都会落进页面顶部一个整洁的 附件 面板里,让读者一眼就能看到。
Bug 的截图?内嵌。架构导出?一键下载。那份 80 页的供应商 PDF?就在它所佐证的决策旁边。
任何文件。真的,任何文件。
PNG、PDF、Word 文档、ZIP、日志、配置文件——只要是文件,都欢迎。没有"不支持的类型"这道墙。不必为了讨好上传器去转换格式。放下,然后继续。(有一个合理的大小上限,免得有人想上传一张蓝光碟——这是唯一的规矩。)
以你想要的方式存储
你的文件不会撑大数据库——它们存放在对象存储里。在 Archyl Cloud 上,那就是 Google Cloud Storage:私有存储桶,默认静态加密,无需任何配置。自托管 Archyl?把它指向你所用的任何兼容 S3 的服务商——GCS、Amazon S3、MinIO、Cloudflare R2——你的基础设施,你说了算。
无论哪种方式,存储桶都保持 私有,页面通过短时效的签名链接来提供文件:机密文档依旧机密,公开文档照常可用。
说白了:快、私密,再大的文档也轻松扛住。
为什么这很重要
C4 图展示系统的形态。ADR 记录缘由。但那份凭证——截图、基准测试、签好的合同、那张引发一切的餐巾纸草图——过去散落各处,唯独不在它该在的文字旁边。
现在,整个故事都汇聚到一处:背景、决策,以及支撑它们的凭证。
十秒钟试一试
打开一个文档。把一个文件拖进去。看着它出现。
这就是全部教程。
架构文档,从此不再只是空谈。
— Vincent