Repository navigation
Releases
Sqraft 0.0.9
0.0.9
English summary: This release is the delivery wave: SVG out, SVG in, gradients, component variants and an export matrix. Copy as ▸ and Export as ▸ now cover SVG alongside PNG. SVG files can be dropped on the canvas and become native editable shapes, paths and text, with unsupported features rasterized element by element instead of failing the whole file. Fills and strokes accept linear, radial, angular and diamond gradients, editable in the inspector and writable by agents. Components can be grouped into a component set with enumerated variant properties and switched from the instance inspector while keeping geometry, property values and name-path overrides. The export dialog writes PNG 1×/2×/4× and optional SVG into one ZIP archive and remembers the settings. The .sqraft format moves from 9 to 10 (gradient paints and component sets); 0.0.8 cannot open files saved by 0.0.9. Tool count goes from 33 to 35.
这一版把「交付链」一次补齐:SVG 出、SVG 入、原生渐变、组件变体与导出矩阵。文件格式从 9 升到 10,0.0.8 打不开本版保存的文件。
SVG 导出
- 右键
Copy as ▸ SVG、文件菜单Export as ▸ SVG(⌘⇧E)与 agentexport_as({format:"svg"})共用同一套序列化 - 形状 / 路径 / 文本 / 图片 / 效果 / 蒙版按矢量输出;文本逐行定位,导入字体内嵌
- 线性与径向渐变保持矢量;角度与菱形渐变、背景模糊、部分效果节点栅格化,清单进
rasterized - 页面导出只画该页,不含根级母版与组件集合
SVG 导入
- 把
.svg拖进画布即导入为原生节点(按住⌥拖入则按图片资源插入);文件菜单与大图拖放同一入口 - 支持
rect / circle / ellipse / line / polyline / polygon / path / text / g / 本地 use、symbol + use、a / switch与嵌套svg(按x / y / viewBox / preserveAspectRatio套变换);use的x / y与symbol的缩放都会生效;纯色与线性/径向渐变、data URI 图片照常映射 - 样式按 SVG presentation attributes 继承(
fill / stroke / stroke-width / font-*,含currentColor);多子路径线稿拆成多条 path,带填充的多子路径整元素栅格化 - 插入真实 DOM 前会净化克隆(丢弃
script / foreignObject / iframe / on* / 外链 href / 外链 url()),不执行、不发起外部请求;解析阶段同样只丢弃这些元素并记进warnings,不再让整份失败 - 不支持的子树(
filter / mask / pattern / clip-path等)逐元素栅格化成图片贴回原位;单个元素既不能映射也不能栅格化时只跳过它并记warnings,整份失败只留给非法 XML、缺尺寸、空内容或超限 - 单文件 5MB、3000 节点、200 个栅格化元素上限;超限整份报错并说明是哪一类(节点 / 栅格化 / 尺寸 / 语法 / 空内容)
- 文本与图片带旋转/缩放时同样走逐元素栅格化,避免丢变换
- 一次导入 = 一个撤销步;agent 用
import_svg({svg, pageId?, x?, y?}),返回{frameId,width,height,rasterized,missingFonts,warnings}
原生渐变
fill/stroke新增linear / radial / angular / diamond四种渐变;坐标相对节点包围盒(0–1),节点移动缩放时跟随- 检查器新增结构化渐变编辑器:类型、角度、中心与半径、2–16 个色标(位置、颜色、增删)
- 色标颜色可以引用 Token;Token 严格模式下 agent 写字面色标会被拒绝(
TOKEN_REQUIRED) - agent 的
create_node/update_node接受fillGradient/strokeGradient,优先级为 Token > 渐变 > 字面量
组件集合与枚举变体
- 选中 2+ 根级主组件 → 右键「组成组件集合」;组件名必须是
Property=Value(如Size=M, Type=Primary),同名属性合并成枚举 - 组件面板按「集合 → 变体」两级展示,单击定位、双击插入实例;集合行尾「+」复制最后一个变体并取一个空闲值
- 实例检查器新增「变体」区块:每个属性一行下拉,不存在的组合置灰
- 切换变体保留实例几何、
propValues与按图层名路径匹配的节点覆盖;新变体多出的图层用默认值 - 集合检查器可重命名属性/值、复制或删除变体;有实例引用的变体禁止删除(命令层拦截)
- agent 新增
create_component_set与add_variant;set_instance_prop的属性 id 命中变体属性时等价于切换变体
导出矩阵
- 文件菜单「导出…」对当前目标(选区,缺省活动页)一次导出 PNG 1×/2×/4× 与可选 SVG,打成一个 ZIP 压缩包
- 文件名统一为
<文档>-<页面名>-<对象名>(整页导出只到页面名,多选也只到页面名);ZIP 内文件平铺在根目录 - 保存对话框记住上次位置,PNG 只存储不重复压缩
- 设置持久化;不做多目标、PDF、HTML、React 或 Copy as code
升级说明
.sqraft的formatVersion从 9 升到 10:Paint增加渐变形态,根节点增加componentSet。0.0.8 无法打开 0.0.9 保存的文件,请先升级再打开新稿- 旧文件无需迁移:新增字段全部可选,纯色与原有组件不受影响
- MCP 工具数 33 → 35(
create_component_set/add_variant);工具清单与read_document的 document 视图已带上组件集合摘要 - 已知限制:组件名解析不做模糊匹配,命名不合规会直接拒绝;角度/菱形渐变在 SVG 里是栅格化的;SVG 导入的纯文本定位以行盒为准,复杂排版文字会降级为图片;
script / foreignObject / iframe / 动画只丢弃并在warnings里提示,不渲染其内容
手点清单
- 打开多页稿:选区导出 PNG 1×/2×/4× + SVG,确认目录记忆与文件数提示
- 导出一份含线性/径向渐变的稿:SVG 与 PNG 视觉一致;角度/菱形渐变在 SVG 里是位图
- 拖入含
filter、渐变、文本的 SVG:可编辑节点正确落下,降级元素有提示,一次撤销全撤 - 拖入带
<a>包裹、图标雪碧图(symbol+use)或带<script>的 SVG:前者正常落成节点,雪碧图展开成图标,script被丢弃并有提示,都不再整份失败 - 根级带
filter的 SVG:整份按图片导入而不报「没有可导入内容」;3002 节点的 SVG 报「超过 3000 个节点上限」 - 两个
Property=Value组件 → 右键组成集合 → 插入实例 → 切变体 → 确认尺寸与覆盖保留;删除有实例的变体应被拒绝 - agent:
create_component_set→add_variant→set_instance_prop切变体;严格模式下写渐变字面色标应报TOKEN_REQUIRED
Sqraft 0.0.8
0.0.8
English summary: This release makes agent setup a first-class part of the app. The MCP panel can now write the Sqraft entry into six clients (Claude Code, Codex, OpenCode, Cursor, VS Code, Zed), back up the file first, read the result back, and follow the port if it drifts. A ⌘K command palette covers commands, pages, layers, tokens and recent files. Three built-in examples and three copyable prompts make the first agent session concrete. Settings are now consolidated into one window with four sections (General / MCP / Shortcuts / Advanced) reachable by ⌘, and deep links from the old entry points. Update checks now repeat every four hours while the app stays open and once after the machine wakes, instead of one attempt per launch. The .sqraft format is unchanged (still 9); tool count is unchanged at 32. Windows one-click setup is implemented but not verified on a real machine yet.
这一版把「接入」从手写配置变成产品的一部分,并给 ⌘K 一个统一入口;文件格式与工具数量都不变。
MCP 一键接入
- 配置面板列出 Claude Code / Codex / OpenCode / Cursor / VS Code / Zed 六个客户端,四态显示:已连接 / 已写入 / 未接入 / 未检测到
- 写入只碰名为
sqraft的那一条:写前备份到userData/mcp-backups/(每客户端保留 5 份)、临时文件 + rename、写后回读校验,失败自动还原 - 每个客户端只有一条写路径:Claude Code / Codex 走官方 CLI(显式 user scope),其余走文件 adapter;JSONC 用范围编辑保留注释
- 端口漂移时只同步所有权清单里的条目;失败保留旧地址并在面板显示「需要处理」,不阻塞启动
- 认不出的同名条目一律不动,由用户在面板里显式「替换」;删除只删自己那条
- 手动片段仍保留(六个客户端 + 通用 URL),CLI 缺失或配置不可写时自动降级为复制
- Windows:一键接入已实现,但本版未在 Windows 实机验证;失败时请用面板里的手动片段
⌘K 命令面板
- 五类结果:命令、页面、图层、Token、最近文件
- 命令与菜单、快捷键共用
shared/commands.ts的 55 个 id(含设置聚合新增的app.shortcuts与日食示例命令);面板里直接显示快捷键 - 图层 2 个字只搜当前页,3 个字起扩到全文档;输入防抖 80ms
- Token 结果跳到设计系统面板并短暂高亮
- 纯键盘可用:
↑↓/PageUp/PageDown/Home/End/Enter/Esc
设置聚合
- 「设置…」(⌘,)改成四个分类:通用(语言)/ MCP / 快捷键 / 高级(数据目录、日志目录、清空图片缓存)
- 旧的「配置 MCP…」、欢迎页按钮、工具栏键位图标与
⌘/都改为"打开设置并跳到对应分类",再按一次入口关闭 - 「关于」保持独立面板,数据目录移到「高级」
- 键位表补上此前漏显示的
file组 7 条(⌘N / ⌘O / ⇧⌘I / ⌘S / ⇧⌘S / ⌘⇧E / ⌘W) - 设置里切换分类不会重跑 MCP 客户端检测;需要刷新时用面板里的重新检测
示例与引导
- 欢迎页新增三个内置示例:登录页、三列卡片列表、日全食主题落地页(纯图形与文本,无 Token、无图片)
- 日食页演示深色底与效果近似的光晕:文档模型没有渐变,光晕用低透明度椭圆 + 图层模糊/投影还原
- 示例以未保存文档打开,
⌘S时才另存 - MCP 面板「连上之后试试」给三条可复制 prompt:批量建卡片、Token + 严格模式、按诊断修复
更新检查
- 运行期每 4 小时自动检查一次(以前只在启动后查一次),合盖唤醒后补查(受最小间隔约束,距上次检查不足 4 小时则跳过)
- 两次自动检查之间至少隔 4 小时(原来是 24 小时);手动「帮助 → 检查更新…」不受限制
- 更新包下载分三档超时:连接 60 秒、空闲 60 秒、总时长 60 分钟;慢网不再因为「总 10 分钟」被整体掐断
- 设置 → 高级新增「自动下载更新」开关:关闭后只提示新版本,点「前往下载」手动安装(与 Windows 一致,下次检查生效)
- 自动下载会等窗口失焦再开始(最多等 30 分钟,期间关于面板显示「等空闲时自动下载」),不在你操作时抢带宽;7 天提醒同样等切走再弹
- 下载就绪后即使一直不重启,满 7 天也会提醒一次,不再只在下次启动时判断
升级说明
.sqraft的formatVersion仍是 9,0.0.8 与 0.0.7 文件互相兼容- 之前手工写进客户端的
sqraft条目会被识别为「已写入」;点「断开」只删这一条 - 新增依赖仅
jsonc-parser(devDependency,由 Vite 打进out/,不进 asar 依赖树),不改变安装包外的文件布局 - 配置写入失败不会影响应用启动;日志里能看到
client ...事件
Sqraft 0.0.7
0.0.7
English summary: This release is about agents building more than one node at a time, and about making their work auditable. A new create_nodes tool creates a whole nested subtree in a single call — one transaction, one undo step — instead of dozens of create_node rounds. The activity pill now lists exactly which nodes each call touched, next to the warnings that call returned, and every entry is clickable. A document-level strict mode (off by default) makes agents reference design tokens for colors instead of writing raw hex. The .sqraft format goes 8 → 9 with a single new field, old files keep the permissive behaviour automatically, and 0.0.7 opens 0.0.6 files but not the other way round. Tool count 31 → 32; the UI, shortcuts and data directory are unchanged.
这一版把 agent 从「一次改一个节点」推进到「一次改一棵子树」,并且把它的改动摆到台面上;设计系统还多了一个只约束 agent 的严格模式。
批量建树:create_nodes
- 一次调用提交嵌套节点树,整棵树走一个事务、一个撤销步;此前生成一屏卡片要连续调十几次
create_node,每次都是独立的一步撤销 - 入参与
create_node逐字段同构(kind/name/text/points/image/layout/ 全部样式字段),只多两处:id必须由调用方生成(命令确定性:id 在命令创建前分配,apply 期不生成)children表达层级,节点级不再接受parentId
- 先全量校验再落库:任一节点非法,整次调用回滚,文档不留半成品,错误里带条目路径(如
nodes[0].children[2]) - 单次含子孙 上限 500,超出报
TOO_MANY_NODES并提示分批 children内不能放主组件与插槽(这两种仍是create_node的职责);组件实例仍用create_instance- 顶层可以放主组件(等价于
create_node不给parentId) - 实测:15 个节点的卡片列表 1 次调用建完,自动布局、文本自动尺寸、诊断照常工作;一次撤销整树回退
变更清单:看得见 agent 改了什么
- 顶部胶囊点开后,连接详情下面多了两段:「本次改动 N 个节点」与「诊断 M 条」
- 每条 = 节点名 + 动作词(新建 / 修改 / 删除 / 移动 / 实例 / 文档),点击即选中并定位(与图层面板的定位同一条路径,带脉冲标记)
- 诊断条目按诊断码显示本地化说明(
diag.*,四语);未知码原样显示 - 单个节点被删掉后,清单里仍是删除前的名字(调用前就抄好了,整棵子树一起抄)
- 单次最多列 200 条,超出显示「还有 N 个未列出」
- 生命周期:
- 保留到下一次成功调用覆盖;失败的调用不清(它没改文档,旧清单仍然准确)
- 撤销 / 重做立即清空;空撤销栈上的 ⌘Z 不动清单
- 新建 / 打开 / 关闭文档也清空——否则清单会指向上一份稿子的节点,点击定位静默无反应
Token 严格模式(可选,默认关)
- 设计系统面板新增「严格模式」开关,文档级(随文件走:把稿子交给别人或 agent,策略一起过去)
- 开启后 agent 写
fill/stroke字面量颜色被直接拒绝,错误码TOKEN_REQUIRED,并按色距给出最近的 3 个 Token(名 + 色值 + ΔE),没有颜色 Token 时提示先define_token - 色距用 OKLab ΔE(感知均匀;按 ×100 展示,否则
#3366ff与#4477ff会一起显示成0.0) - 只拦 MCP 写入:检查器里手选颜色不受影响;
fillToken与字面量同时给时 Token 优先、不报错 - 只管颜色:字号、圆角、间距等数字字面量不拦("越界"没有共识,强行拒绝会让 agent 卡住)
- 开关本身是文档命令,可撤销
修复
create_node/create_nodes现在拒绝未知kind:createNode()本身不校验类型,以前传错类型会把无效节点写进文档,现在直接报错- 最接近 Token 的 ΔE 之前按一位小数输出,OKLab 距离是 0–1 量级,两个差别明显的 Token 都显示成
0.0;改为 ×100 展示,排序与数值都可读
兼容性
- 文档格式
formatVersion8 → 9:只新增一个可选字段strictTokens,缺省false- 0.0.7 打开 0.0.6 的文件:自动迁移,行为与 0.0.6 完全一致
- 0.0.6 打不开 0.0.7 存的稿:会明确拒绝并提示版本(
error.newerFormat),不会"尽量解析"出一份坏稿——这是 ADR-0029 的既定规则,跨版本协作请一起升级
- 工具数 31 → 32;
create_nodes是新工具,其余工具的参数与返回体未变 - 界面、快捷键、数据目录、已有文档的样式与排版均无变化
- 唯一的行为性破坏:以前给
create_node传无效kind会被静默接受(产出一个不可用节点),现在报错
内部
packages/core:新增纯函数color.ts(sRGB → OKLab 色距,不碰 DOM,可在 Node 下测试);新增命令doc.setStrictTokens(进撤销栈);formatVersion迁移按既有模式加一档packages/ai-tools:CREATABLE_KINDS成为"能建哪些类型"的唯一真源(schema enum 与运行期白名单同源,不再两处手抄);handlers/nodes.ts拆出readKind/readShapeArgs/buildStyleFor/resolveImageRef,单建与批量共用同一条构造路径- 渲染层:新模块
renderer/agent-report.ts承载变更清单(纯逻辑,可单测);store.replaceDocument()收口"换文档"这件事,避免以后新增入口时忘记清理 UI 状态 - 新增 33 项测试(批量建树 12、严格模式 10、变更清单 8、迁移与命令 3),合计 856 项
安装提示
安装包本身与 0.0.6 相同:
- macOS:已签名、未公证,首次打开到 系统设置 → 隐私与安全性 点 仍要打开(每个新版本更新后需要再放行一次)
- Windows:安装器未签名,首次运行点「更多信息 → 仍要运行」;更新仍是手动下载
已知限制
- 严格模式只覆盖
fill/stroke的颜色;效果(投影 / 内模糊)里的颜色不受约束 - 严格模式只拦 agent,不拦人:检查器里手选的颜色照写(故意如此——人不该被自己的工具锁死)
create_nodes不建组件实例、不在children里建主组件或插槽;需要这些仍要单独调用- 单次建树 500 个节点是拍板值,更大的结构需要分批;分批之间不是同一个撤销步
- 变更清单只保留最近一次成功调用,且最多列 200 条;不做调用历史
- 严格模式对数字 Token 无约束(字号 / 圆角 / 间距仍可写字面量)
- 中日韩文字使用各系统自带字体,同一文档在 macOS 与 Windows 上换行位置可能不同
Sqraft 0.0.6
0.0.6
English summary: This release is about agents getting it right in fewer round trips. read_document now reads one page or one subtree instead of the whole file (42.7 KB instead of 334 KB per page on a 100k-node design), a new search_nodes tool finds nodes by name, text, type, token or component, and every write result carries warnings — zero-size nodes, clipped text, missing tokens — so an agent can correct itself without another call. Models without vision get a text summary of the screen. The UI and the .sqraft format are unchanged; agent tooling sees four breaking changes, listed below.
这一版改的是 agent 干活的质量,不是画布:读得更少、找得更准、写完自己知道哪里不对。界面和文件格式没有变化。
读取:只读需要的那一块
read_document新增作用域参数:scope(page/subtree/document)、pageId、subtreeId、depth(0–8,默认 1)、limit(默认 200,上限 1000)- 默认行为变了:不传参数只读「当前页的第一层」,不再整篇返回;整篇读取需要显式
scope:"document"(只给页面与组件摘要)或逐页读 - 返回体里的节点是扁平数组(先序遍历,每条带相对
depth),不再是二次编码的 JSON 字符串 - 组件母版当普通节点读:
subtreeId直接接受组件 id;scope:"document"给页面与组件的nodeCount - 被
limit截断时返回truncated与一句hint(提高limit、降低depth、或读某棵子树),不提供游标
实测(100 页 × 1001 节点 ≈ 10.01 万节点的回归 fixture):
| 读取方式 | 体积 |
|---|---|
| 默认(当前页一层) | 42.7 KB |
| 同一页读到底 | 334 KB |
| 整篇读取 | 33.4 MB |
| 一张卡片的子树 | 3.4 KB |
scope:"document" 摘要 |
1.9 KB |
搜索:跨页面与组件母版
- 新增
search_nodes:按name/text/type/fillToken/strokeToken/componentId过滤(AND),至少给一个条件 - 命中行很轻:
id、name、type、parentId、rootKind/rootId(长在哪个页面或母版里)、path(名称链)、match(字段 + 80 字符摘要);不返回子树、不带坐标 - 默认搜所有页面与组件母版,
visible:false的节点连同子树跳过;pageId可限定单页;命中到limit(默认 20,上限 200)即停,hasMore表示还有更多 - 100 页空文档上单次搜索约 23 ms;命中 20 条即停,不做全表计数
写入诊断:同一响应里告诉 agent 哪里不对
- 写工具返回里新增
diagnostics(只在非空时出现),只有warning一档:ZERO_SIZE、TEXT_NO_FILL、TEXT_OVERFLOW、TOKEN_MISSING、OUTSIDE_PARENT - 覆盖全部写工具;一次调用最多扫 2000 个节点、报 20 条,超出给
diagnosticsTruncated - 只警告:不回滚、不阻断写入、不新增撤销步;一次工具调用仍然是一步撤销
inspect_layout复用同一套规则,几何行不变,只多一个顶层diagnostics- 新增的
OUTSIDE_PARENT取代了原计划里的FAR_FROM_WORK:判断「改动节点与父容器内容区完全不相交」(角标、图标伸出边界不报);SIBLING_OVERLAP因误报率高,本版没做 - 诊断范围只覆盖本次调用动到的节点;固定布局容器改尺寸后、没被布局搬动的子项落在容器外,本版不会报警(
inspect_layout仍能看到几何)
无视觉客户端
screenshot新增format:"text":返回区域内节点的世界坐标、解析后的填充/描边颜色(缺 Token 会暴露成#ff00ff)、文字与同一套诊断,最多 200 个节点;format省略时行为不变(仍返回 PNG)- MCP
initialize现在下发五条工作规则(先搜索再读取、默认只读一层、处理诊断、无视觉用文本视图、一次调用一步撤销);只有支持该字段的客户端会注入
兼容性:会破坏现有 agent 提示词
这一版对工具契约有四处破坏性变更,人的操作不受影响:
read_document默认从「整篇」变成「当前页 + 深度 1」- 节点树从
pages[].subtree(字符串)改为扁平的nodes(数组) includeComponentTrees不再展开组件树,只返回一句弃用提示- 组件摘要的
w/h改名为width/height;工具总数 30 → 31
- 文档格式不变(
formatVersion仍是 8):0.0.5 与 0.0.6 可以互相打开 - 界面、快捷键、数据目录、已有文档的样式与排版均无变化
- 之前写死的提示词如果依赖「
read_document一次拿全稿」,升级后 agent 会只看到一层;把提示词换成「先search_nodes,再read_document({scope:"subtree", subtreeId})」即可
内部
packages/ai-tools按职责拆分:tools.ts(工具清单)、args.ts(参数校验)、serialize.ts(读取/搜索的序列化)、diagnostics.ts(诊断接线)、handlers/*(按域分派),入口只剩装配packages/core新增纯函数diagnostics.ts:不依赖 DOM,文本度量由宿主注入
安装提示
与 0.0.5 相同,安装包本身没有变化:
- macOS:已签名、未公证,首次打开到 系统设置 → 隐私与安全性 点 仍要打开
- Windows:安装器未签名,首次运行点「更多信息 → 仍要运行」;更新仍是手动下载
已知限制
- 诊断只到
warning:不会阻止写入,也不做自动修复 SIBLING_OVERLAP(兄弟节点重叠)本版没有;设计里角标、叠层卡片是常态,误报风险高- 实例
overrides表里的 Token 引用不在TOKEN_MISSING扫描范围内(已知盲区) - 文本替代视图最多 200 个节点,按世界坐标包围盒筛选,不处理裁剪与透明度;跨页面重叠时可能带出同区域其它页面的节点
- 搜索不做正则、模糊或跨文档匹配,也没有索引;命中即停,不返回精确总数
initialize的工作规则只有支持该字段的客户端会采用,其余客户端仍靠工具描述- 中日韩文字使用各系统自带字体,同一文档在 macOS 与 Windows 上换行位置可能不同
Sqraft 0.0.5
0.0.5
English summary: Large documents are usable now. Opening a 1.5 GB, 554-page, ~195k-node design takes about 3.4 seconds instead of 7–11, scrolling drops from 51 stuttering frames per 120 wheel events to 2, and dragging while zoomed out goes from 408 ms to 30 ms per frame. Page labels disappear below 25% zoom, two offscreen-layer bugs are fixed, and macOS builds are now signed with a Developer ID certificate — notarization is still pending, so the first launch asks for one manual allow.
几百页的大稿终于能顺着手感用了:打开更快、滚动不卡、缩到全局拖动也跟得上。macOS 包从这版起用 Developer ID 签名(公证暂缓),首次打开需要在系统设置里放行一次。
性能:大文档
实测文档:1.5 GB、554 页、约 19.5 万节点、555 张图(M1 Pro)。
- 打开:读取 + 传输 + 解析从 7–11 秒降到约 3.4 秒
- 文件不再整块经 IPC 结构化克隆,主进程登记一次性只读取件地址,渲染层流式读取
- zip 里本就未压缩的图片条目零拷贝取出,
doc.json交给原生解压
- 滚动:120 次滚轮里超过 50ms 的卡顿帧 51 → 2,回滚已看过的区域 0 帧;滚动时 GPU 平均占用 75%(峰值 94%)→ 46–54%
- 页面与根级母版的整块合成结果跨帧缓存,平移时直接回贴位图
- 效果层(投影 / 图层模糊 / 内阴影)与蒙版层同样缓存;背景模糊不缓存(它取样的是下面已画好的内容)
- 图片按屏幕上实际需要的分辨率分级解码,解码缓存改按最近使用淘汰,滚动时不再反复淘汰重解
- 缩小看全局:4% 缩放下拖动单帧 408ms → 30ms,缩放手势 15–16ms;停下 150ms 后分帧补清晰
- 视口剔除:屏幕外的页面 / 母版整棵子树直接跳过;只在根节点这一级判定,成本与文档总节点数无关
- 导出的 PNG 与 AI 截图不受这些缓存影响,仍是逐层完整绘制
改进
- 缩放到 25% 以下时,页面与母版的名称标签不再绘制、也不参与命中,避免固定屏幕尺寸的标签互相重叠、遮挡内容;选中的节点仍保留标签(#2)
修复
- 半透明分组里的蒙版滚到屏幕边缘时被裁错位置、内容整块消失(嵌套离屏层取错了坐标矩阵)
- 离屏层外接框带小数导致回贴时被拉伸、边缘发糊
macOS 代码签名
- macOS 包用 Apple Developer ID 签名,
codesign --verify --deep --strict与 Team 校验通过;公证(notarization)暂缓——Apple 公证服务这段时间把提交长时间挂在处理中,等它恢复后再补 - 因此首次打开仍会被 Gatekeeper 拦一次:到 系统设置 → 隐私与安全性,在 Sqraft 旁边点 仍要打开;之后不再提示,也不需要再执行
xattr - 签名有效时不会再出现「Sqraft 已损坏」那种提示
- 自动更新在替换前校验新包的代码签名与 Team,校验不过就保留旧版本,不会把坏包装上去
- 从 0.0.4 自动更新上来的那一次仍由旧版(未签名)执行替换,更新完成后才进入「已验证签名」状态;想立刻生效就直接下载 dmg 覆盖安装
兼容性
- 文档格式不变(
formatVersion仍是 8):0.0.4 与 0.0.5 可以互相打开,本版没有新增字段 - 数据目录、快捷键、已有文档的样式与排版均无变化
- 缩放手势中与刚缩放完的几帧会短暂看到发虚的页面,随后逐帧变清晰——用「缩放时略糊」换「缩放时不卡」
安装提示
macOS
首次打开会出现一次「Apple 无法验证"Sqraft"是否包含恶意软件」:到 系统设置 → 隐私与安全性,在 Sqraft 旁边点 仍要打开。之后启动不再提示。
唯一例外是从 0.0.4 自动更新上来的那一次(见上)。
Windows
安装器仍未签名,首次运行 SmartScreen 会拦一下:点「更多信息 → 仍要运行」。
安装向导默认按当前用户安装,不需要管理员权限,可在向导里改安装目录;卸载不删 %APPDATA%\Sqraft。
已知限制
- 安装包只覆盖 macOS Apple Silicon(arm64)与 Windows x64;Intel Mac、Windows ARM64 与 Linux 暂不支持
- macOS 包已签名但未公证:首次打开需要在系统设置里放行一次(见「安装」);公证恢复后这一条会去掉
- 自动更新只在 macOS 上提供;Windows 只提示有新版本,安装包需要手动下载覆盖安装
- 大文档第一次滚入一片没看过的区域仍可能有一两帧偏慢(整块缓存首次合成)
- 缩到很小时,屏幕上不到半个设备像素的点与细线不再绘制(导出不受影响)
- 中日韩文字使用各系统自带字体,同一文档在 macOS 与 Windows 上换行位置可能不同
- 日文 / 韩文文案由 AI 起草并抽查,可能不是母语级润色
Sqraft 0.0.4
0.0.4
English summary: Prototype links and a present mode — click a layer to jump to another page, scroll long pages while presenting, and highlight hotspots. The same capability is exposed over MCP, so an agent can hand back a clickable design. This release also ships a Windows x64 installer.
稿子现在能点着走了:给图层挂上链接,进演示模式点一遍。本版还开始提供 Windows x64 安装包。
新增
- 原型链接:给页面里的图层挂「点击 → 跳到某个页面」或「点击 → 返回上一屏」,随文档保存
- 检查器新增「原型」标签页:目标页面、转场(瞬间 / 淡入)、时长(60–2000ms)
- 演示模式:工具栏 ▶ 或
⌥⌘Enter进入,铺满窗口单页播放;←返回上一屏,H高亮全部热区,Esc、⌥⌘Enter或右上角×退出 - 页面滚动:检查器里给页面设「垂直 / 横向」,演示时可滚动,到边界停住;跳转到新页面从顶部开始,按
←返回则恢复离开时的位置 - 画布连线:编辑模式选中或悬停热区,看到连到目标页的折线与页名;目标页不在视口内时退化成「→ 页面名」标签
- 拖动模式显示全量流向图:只画两端都在视口内的连线,用来一眼看出哪一页还没接上
- MCP 新增
set_interaction/remove_interaction/list_interactions:agent 可以直接生成可点击的稿子,read_document会带上链接与滚动方向
Windows 版
- Windows x64 安装包
Sqraft-Setup-<版本>.exe:经典安装向导,默认按当前用户安装,不需要管理员权限,可在向导里改安装目录;开始菜单与桌面各建一个快捷方式 - 安装器关联
.sqraft:双击文件直接用 Sqraft 打开;卸载不删%APPDATA%\Sqraft里的偏好、最近文件与 MCP 配置 - 安装器提供 中 / 英 / 日 / 韩 四种语言,按系统语言自动选择
- Windows 用系统标题栏、菜单栏常显(不自动隐藏),「配置 MCP…」入口在「文件」菜单
- 快捷键按平台显示:内部仍是同一套键位,Windows 上显示为
Ctrl+S、Ctrl+Shift+Z,不再是⌘ - 更新只提示不安装:发现新版本时工具栏出现「前往下载」,打开 Releases 页面,由你下载新版安装器覆盖安装
改进
- 演示模式是只读的:不改选区、不改缩放、不写文档;退出后画布与你进入前完全一致
- 演示期间编辑快捷键全部让位,按
⌫或⌘S不会误删节点、也不会触发保存 - 删除页面时,指向它的链接在同一步撤销里一并清理;把图层拖进主组件时链接自动清除,不留点不动的死链接
- 粘贴到别的文档时,指向原文档页面的链接自动丢弃
- 实例只继承母版的样式与结构,不复制母版上的链接(避免一个母版在每份实例里变成热区)
兼容性
- 文件格式从 7 升到 8:旧文件在本版本打开完全正常;但用旧版本打开新文件会丢掉原型链接与页面滚动设置(不会报错,是静默丢失)
- macOS 的快捷键、数据目录与已有文档的样式、排版均无变化
- Windows 的数据目录是
%APPDATA%\Sqraft;同一份文档可在 macOS 与 Windows 之间互相打开
安装提示(未签名)
macOS
首次打开若提示「Sqraft 已损坏」,不是文件损坏,是 macOS Gatekeeper 拦下了未签名应用。
把 App 拖进「应用程序」后执行:
xattr -dr com.apple.quarantine /Applications/Sqraft.app再打开即可。之后的版本由应用自己下载更新,不会再触发这一步。
Windows
安装器同样未签名,首次运行 SmartScreen 会拦一下:点「更多信息 → 仍要运行」。
安装向导默认按当前用户安装,不需要管理员权限;装好后开始菜单与桌面会有快捷方式。
已知限制
- 安装包只覆盖 macOS Apple Silicon(arm64)与 Windows x64;Intel Mac、Windows ARM64 与 Linux 暂不支持
- 两个平台的包都未签名、未公证:macOS 首次打开会被 Gatekeeper 拦截,Windows 首次运行会弹 SmartScreen
- 自动更新只在 macOS 上提供;Windows 只提示有新版本,安装包需要手动下载
- 中日韩文字使用各系统自带字体,同一文档在 macOS 与 Windows 上换行位置可能不同
- 原型链接只支持「点击」触发;悬停、长按、延时跳转尚未支持
- 检查器一次只能编辑一条交互(一条图层可以存多条,多出来的由 agent 写入、只读展示)
- 本版只做转场,不做动效:图层属性之间的平滑过渡(Smart Animate 式)、浮层与变体间过渡都还没有
- 日文 / 韩文文案由 AI 起草并抽查,可能不是母语级润色
- 日文禁则只覆盖行首标点与行尾开括号,未实现完整的 JIS X 4051
Sqraft 0.0.3
0.0.3
English summary: Japanese and Korean UI, per-language CJK font stacks, Japanese line-breaking rules, a relocated MCP menu entry, and English-only errors for MCP agents.
新增日本語 / 한국어 界面,并让画布字体随界面语言切换。
新增
- 界面语言支持 中文 / English / 日本語 / 한국어,可选「自动」跟随系统语言
- 设置面板里的语言选项改为纵向列表,切换后立即生效
- 按界面语言选择 CJK 字体栈:日文用 Hiragino / Yu Gothic,韩文用 Apple SD Gothic Neo / Malgun Gothic,避免汉字显示成中文字形
- 新建文本的默认字体跟随当前界面语言
改进
- 日文换行加入轻量禁则:行首不出现收尾标点,行尾不留开括号
- 「配置 MCP…」入口移到「设置…」旁边(macOS 在应用菜单,其他平台在文件菜单),帮助菜单不再保留
- MCP 返回给外部 agent 的错误统一为英文,不再把内部错误码直接暴露给 agent
- 核心错误提示支持四语言本地化;未知错误回退到通用文案,原始信息只写入日志
- 检查器里的字体预设随语言变化,不再固定为中文回退字体
- 修正空文本测量与空格断行在日文下不符合禁则的问题
兼容性
- 已有文档的文字样式不受影响:文档里记录的
fontFamily不会被改写 - 文件格式、快捷键、数据目录均无变化
安装提示(未签名)
首次打开若提示「Sqraft 已损坏」,不是文件损坏,是 macOS Gatekeeper 拦下了未签名应用。
把 App 拖进「应用程序」后执行:
xattr -dr com.apple.quarantine /Applications/Sqraft.app再打开即可。之后的版本由应用自己下载更新,不会再触发这一步。
已知限制
- 仅提供 macOS Apple Silicon(arm64)安装包
- 未签名、未公证,首次打开会被 Gatekeeper 拦截
- 日文 / 韩文文案由 AI 起草并抽查,可能不是母语级润色
- 日文禁则只覆盖行首标点与行尾开括号,未实现完整的 JIS X 4051
Sqraft 0.0.2
0.0.2
- 第一个公开版本
安装提示(未签名)
首次打开若提示「Sqraft 已损坏」,不是文件损坏,是 macOS Gatekeeper 拦下了未签名应用。
把 App 拖进「应用程序」后执行:
xattr -dr com.apple.quarantine /Applications/Sqraft.app再打开即可。之后的版本由应用自己下载更新,不会再触发这一步。
已知限制
- 仅提供 macOS Apple Silicon(arm64)安装包
- 未签名、未公证,首次打开会被 Gatekeeper 拦截