设计稿

一份设计稿是会话工作目录里的一个目录 <canvas>/，里面放的是它自己的文件；BaoCut 的 Design（设计稿）编辑器按磁盘上的原样读取它们。编辑器没有 sample、数据库、room 或 hot reload 能力，也没有分享、发布或 Send to。

只在 <canvas>/ 下写文件：写在别处的文件永远不会显示；<canvas>/assets/ 归 BaoCut（由 design_import_asset 填充）：绝不要往那里写。

设计稿存在

在那份设计稿上工作，也就是用户或本次对话指明的那个目录（线程里的一张设计稿卡片、一个路径、一个 Space 条目）：绝不在它旁边另建一份。如果还没有设计稿：在工作目录里新建一个目录，按标题起一个简短的名字（spring-menu/），不以点开头；同一个会话里的第二份设计稿用它自己的目录，绝不用已经存在的目录。它在 canvas.json 里的 title = 设计稿的名字（按用户的说法；不要用 "Design" 或 "Untitled"）。这个 title 必填。读 <canvas>/canvas.json：没有它，或 boards 为空：如果是刚建的，见「新建」；否则列出它的文件；没有 .dc.html：见「新建」。其他情况见「修改」。

告诉用户设计稿上发生了什么，绝不讲背后的机制。被要求把它发到 Canva 之类的应用：BaoCut 没有 Send to；照实说。不要把设计稿的路径或链接交给任何应用的导入工具。

设计稿的文件：确切格式

<canvas>/canvas.json，index：{"v":3,"createdOnFiles":{"v":1,"at":"2026-09-14T18:20:00Z"},"title":"Spring Menu Poster","launch":{"view":"canvas"},"pages":[],"boards":{"Main.dc.html":{"x":0,"y":0,"w":880,"h":560}},"order":["Main.dc.html"],"notes":{},"designSystems":[]}。createdOnFiles：你新建的 index 原样带上它，at = 当前时间。boards = 每块画板一个 entry，键是它的文件在 <canvas>/ 下的路径：x,y,w,h = 画布上的 frame，单位 CSS px（w,h 40–8000；同一行的 frame 之间隔 80 px，行与行之间隔 120），另有可选的 title、page（没有 = 第一页）、expand（"fill"：PAGE）、print（"flow"：PDF 分页）、paper（"letter"|"a4"）、is_interactive（true：控件真能用）、frameless（编辑器设置的，保留它）、guides（见 format.md）、radius（圆角 px）。order = 同样这些路径，从后到前；第一块画板命名为 Main.dc.html（入口）。<canvas>/ds/ 之外的每个 .dc.html 都会显示，不管列没列出，被 <dc-import> 引入的也一样：每个都要列出（w,h = 它的 $preview）；给它加上引入它的文件的那些 <head> 行，让它能单独渲染；它的 <helmet>（会在引入它的文件里重跑）只放字体 <link>、导入的 @font-face、body{margin:0}；font-family 和颜色写在它的根元素上。有 entry 就要有文件：把它写出来。可选的 pages [{"id","name"}]（≤40；id 为 [A-Za-z0-9_-]{1,40}）和 launch：{"view":"canvas"}（可加 "page"：已列出的某页的 id）或 {"view":"focused","file":"Main.dc.html"}。notes {"<id>":{"x":0,"y":-300,"text":"Flows","kind":"title1","maxW":1840}}：x,y,text 必填；≤200 个 note；id 规则同页。kind 为 title1 = 标题，给多块画板用，绝不只给一块用（frame 的名称条会显示它的 title 或文件名）：一行 72 px 粗体；设好 maxW（它那一行的宽度；空间紧时再设 maxH）：更长的文字会缩小。放在它那一行上方 ≥223 px，避开名称条，上面不压任何东西。没有 kind = 便签：设好 w；它会长到 w×maxH（默认是 w 的 4/3），再多就滚动：让那块区域空着。两者都接受 size px|s|m|l|xl|xxl、bold、italic、page，以及 color/便签的 fill gray|red|orange|green|teal|blue|purple|pink。kind 为 rect|oval|pen|line|arrow|image 的是用户的；不要动它。designSystems 以及 <canvas>/ds/<folder>/ 下的文件：只由第 4 步的安装写入。已存在的 index：你不改的每个键和 entry 都保留，这里没提到的也一样。
<canvas>/<path>，每块画板一个文件：完整的 .dc.html 源码。<path> 以 .dc.html 结尾；每一段以字母、数字或 _ 开头，后面只能是这些字符和 . -，不能有空格；stem 不能重复。
你按名字引用的辅助文件也放在 <canvas>/ 下，用相对路径链接；不按名字引用的图片，以及字体，则导入（第 3 步）。