Skip to content

ArcMD 0.2.8 · 上游官方 v0.2.5 + MDX 3.1.1 第一阶段

Latest

Choose a tag to compare

@evlic evlic released this 20 Nov 20:28

ArcMD 0.2.8 · ybbapp 主线版(上游官方 v0.2.5 + MDX 3.1.1 第一阶段)

这是 ybbapp/ArcMD:main 的正式 fork Release,真实 cmd/arcmd 主程序,macOS 13+ / Apple Silicon(arm64)。运行不需要 Node/npm/esbuild,没有内置 Node 或本地服务。

本包对应上游官方 Release v0.2.5(ID 453104529,源码 cc5013ef3de866c74c1535378a3d3ada26acb04d)。本 fork 已发布过 0.2.1–0.2.7,因此本包版本为 0.2.8,避免版本号冲突。

上游 v0.2.5 能力(已纳入本包)

  • 侧栏复制、粘贴与创建副本(Ciao1019#10、Ciao1019#39):可在侧栏对文档、文件夹、多选和收藏磁贴使用右键或 ⌘C/⌘V(Windows/Linux 为 Ctrl),支持跨文件夹和跨空间粘贴,并保留或重定位附件/封面;副本进入行内重命名并打开到正文,撤销走回收站。
  • 更清晰的公式绘制、按内容宽度扩展的表格、窄窗口侧栏展开迟滞,以及设置/命令栏中的可选自动保存(Ciao1019#32):关闭自动保存后,离开或关闭未保存文档会提示「保存 / 不保存 / 取消」。
  • 从表格、行内代码和正文复制时保留字面纯文本,不再带 Markdown 转义或对齐用 HTML 包裹;单词内部的下划线也不再被转义。
  • 表格工具栏在行索引超出列数时不再崩溃(Ciao1019#34、Ciao1019#35)。
  • 空间问答的流式 Responses 与 Chat Completions 协议选择(Ciao1019#23)已在此前的 main 同步中合入,并包含在本官方 v0.2.5 说明中。
  • 本 fork 在文档退场路径上同时销毁 JSX WebView(document.close() 调用幂等 closeJSX();丢弃未保存编辑时 replaceReferences 也会先关闭旧文档的 JSX),避免只回收位图而留下岛屿运行时。

上游 v0.2.4 及更早能力(仍纳入本包)

  • 修复反复切换 Markdown 文档、侧栏悬停预览与空间时内存持续增长的问题(Ciao1019#33):关闭文档后回收编辑器与解码位图,限制后台图片解码并发为 4,并在 GPU 上传后释放 CPU RGBA/mipmap 缓冲;侧栏缩略图改为 8 项 LRU 与 DecodeBitmapScaled(640);空间会话、白板缓存与版本/合并模态引用在关闭时释放。
  • 纯 Go wazero WebAssembly 插件沙箱与官方「云端同步」插件、Git 风格变更视图与 IDEA 式三栏合并、可导航文档思维导图、每空间附件目录与自动重链、原生 <kbd> 与原始 HTML/注释、侧栏多选批量管理。
  • 本包同时包含已在 0.2.4 / 0.2.5 / 0.2.6 / 0.2.7 中打包的上游 v0.2.1 / v0.2.2 / v0.2.3 / v0.2.4 能力(纯 Go 矢量 PDF、原生 Mermaid、手绘白板、\boldsymbol、拼音搜索、Obsidian 图片嵌入,macOS 未安装楷体时避免 CoreText MobileAsset 挂起,以及内存生命周期修复等)。

0.2.3 起已有的阶段兼容(仍适用于 0.2.8)

编译器精确锁定 @mdx-js/mdx 3.1.1,宿主 profile 为 arcmd-mdx3-phase1,不宣称完整 MDX 3 兼容。

  • 原生 Markdown 正文,块级 JSX/表达式使用隔离 WebView。新增独立表达式、数组/map JSX、局部 IIFE、小写 JSX 容器、expression/spread props 和事件。
  • 顶层段落内行内 JSX/表达式部分支持:整个受影响段落变成一个岛屿,不是原生 inline run 或整页网页;普通段落不受影响。
  • 新增独立实现的 Tabs/TabItem/Accordion,保留 Counter/Callout。随包 demo.mdx 包含行内42、数组1/2/3、局部41、Counter初值5和嵌套Tabs/Accordion。
  • 主题跟随且不重载组件,内容测高、源码保存还原、错误诊断/重试保留;正常没有技术横幅。

验收来源

用户反馈 PR #3 的 2283afd 测试包 效果可接受,并已合入 0.2.3。该测试源码为 2283afd。新生成的 0.2.8 主线 ZIP 未在真实 Mac/Finder/WKWebView 验收,不能把先前测试包验收或 0.2.3 / 0.2.4 / 0.2.5 / 0.2.6 / 0.2.7 包当作本包已实机验收。

安装与使用

  1. 保存文档并完全退出所有旧 ArcMD 进程,将本包 ArcMD.app 明确替换到 /Applications/ArcMD.app,从这个路径启动。稳定名称 ArcMD.app、bundle ID org.ybbapp.arcmd、正常配置与单实例均不变;不新增测试产品身份,也不会自动删除文档、配置或其他应用副本。建议先备份重要文档/配置。
  2. 全包 ad-hoc 临时签名,无 Developer ID,未 Apple 公证。若系统拦截,请按 macOS 针对单个应用的安全提示决定是否允许运行;不要关闭 Gatekeeper/SIP。
  3. 可从 Finder 启动,打开本地 .mdx(空间/侧栏/系统打开均可)。先试同包 demo.mdx,再让agent改一个新文件验证动态编译。普通正文仍原生。
  4. JSX/受提升段落请让agent或外部编辑器改原文件,再回应用重载;源码视图仍是只读导出预览。先保存/解决原生编辑,再重载。保存还原岛屿原文,不写回HTML;岛屿外Markdown仍可能被原生序列化规范化。
  5. 切主题不重载组件;重新打开/重载可重置状态。非活动Tab面板卸载,不承诺状态跨切换保留。编译/WebView/未知组件失败应显示诊断和源码,可重试;源码fallback不是成功。故意错误文件 intentional-error-unknown-component.mdx 用于检查渲染诊断。
  6. 不同目录副本和macOS旧登记可能造成“打开方式”重复条目,不能仅凭菜单确定本机副本数量。本包不主动清理用户Mac。需要恢复上一正式版可退出后重装 https://github.com/ybbapp/ArcMD/releases/tag/arcmd-v0.2.7 ,不需要删除数据。

范围与安全

不支持 import/exports 模块解析、文档共享作用域、用户组件模块、跨岛屿状态、dynamic import/import.meta/await,以及岛屿外标题/列表/引用中的行内MDX。空表达式仍有最小留白,完整MDX插件/引用上下文/资源解析没有实现;不是完整MDX支持。不改只读标题折叠。

运行时通过内嵌 moejs 动态编译受支持的新文件,不是预编译示例冒充支持。开发者重新生成编译器/React资源和运行npm测试需要Node;普通Go构建用提交的资源,应用运行不需要Node。

可信编译器在moejs中只把文档作为文本解析,不执行文档表达式;无Go/OS/文件/网络API、无模块加载器或动态eval。保持5秒求值截止、256MiB JS分配、512KiB源文件、32岛屿、16MiB/200000节点返回限制;固定编译器初始解析在求值期限之前,这些不是进程总RSS限制。

文档表达式只在Untrusted WebView执行,无Go bridge,hash CSP、禁网络/导航保持。编译预算不是浏览器不可信表达式的CPU/内存沙箱承诺。现有Linux WebView设置不放宽。本fork不配置上游自动替换更新,小时维护不是用户电脑上的自动安装器。

诊断与测试边界

终端只读编译诊断(无需Node):
/Applications/ArcMD.app/Contents/MacOS/ArcMD --jsx-check /绝对路径/文件.mdx

输出包含compiler精确版本/profile/build SHA、源SHA、岛屿与诊断。编译/部分不支持返回非零;未知组件等浏览器错误仍要在界面检查。输出含原文,请只保存到自己的本地文件。

canonical编译器/浏览器测试与相关Go/vet、无Node新文件动态编译及交叉构建将随本次 Release 记录。完整Go测试若仅保留既有六个已知Linux app baseline失败及既有 Issue 19 Linux 环境失败,不借机修复。JSDOM和交叉构建/ZIP/签名结构核查不替代真实WKWebView与macOS安全验证。详见Release测试记录和docs/mdx-compatibility.md。

本次精确来源与校验

最终 main:aec74db1a005917ddcb4826801cea6f5fba95f3a

上游官方 Release:v0.2.5 / 453104529,源码 cc5013ef3de866c74c1535378a3d3ada26acb04d。

JSX 编译器定位:@mdx-js/mdx 3.1.1 / arcmd-mdx3-phase1 由 internal/jsx/assets/mdx-compiler.js 经 moejs 编译后 go:embed 进 ArcMD 主程序,应用运行不读 PATH 上的 Node,也不把源码 fallback 当作 JSX 运行通过。可用 /Applications/ArcMD.app/Contents/MacOS/ArcMD --jsx-check 在无 Node 环境下核对。

ZIP:ArcMD-macOS-arm64-aec74db.zip,23057703 bytes(21.99 MiB)

SHA256:c62ce7b175a7e0a6f352e83c5be56c4b1008d853d2dca1923bf5a55af3acf4bd

相关 Go/vet/mod tidy、canonical 编译器/浏览器 44/44(含预期拒绝项)、旧套件 15/15、moejs 运行时 3/3,以及 darwin/arm64、linux/amd64、windows/amd64 CGO-disabled 构建通过。完整 Go 测试仅复现已知失败:Linux app 基线 TestQACitationPreviewDoesNotOccludeAnswerText;上次 main 同步已在干净上游/main 上同样复现的 TestQAProtocolPreference(ui: Chat Completions has no visible area);以及与干净上游/main 在本 Linux 环境相同的 Issue 19 失败 TestIssue19CodeTabVisualIndentAndPaste、TestIssue19LongIndentedCodeLineSoftWrap/tab(char.X=8.428711)。其余五项已知 Linux app 基线测试已通过。未借机修改测试,无新增失败。

最终包独立检查178项资源 hash、Mach-O 全部代码页和 Info.plist/CodeResources 特殊槽,ZIP/执行权限及无运行时 Node 结构通过;未在真实 Mac 对本 ZIP 测试。源码 fallback 不能算 JSX 运行通过。不关闭 Gatekeeper/SIP,不做真实 Mac 验收声明。