Repository navigation
ArcMD 0.2.5 · 上游官方 v0.2.2 + MDX 3.1.1 第一阶段
ArcMD 0.2.5 · ybbapp 主线版(上游官方 v0.2.2 + MDX 3.1.1 第一阶段)
这是 ybbapp/ArcMD:main 的正式 fork Release,真实 cmd/arcmd 主程序,macOS 13+ / Apple Silicon(arm64)。运行不需要 Node/npm/esbuild,没有内置 Node 或本地服务。
本包对应上游官方 Release v0.2.2(ID 450124722,源码 6ad40d616d2d7f4a2ab2c525a7d7e06f9e408313)。本 fork 已发布过 0.2.1–0.2.4,因此本包版本为 0.2.5,避免版本号冲突。
上游 v0.2.2 能力(已纳入本包)
- 原生手绘白板:纯 Go Excalidraw 兼容引擎,可创建独立
.excalidraw.svg/.excalidraw文档,或在 Markdown 中插入 excalidraw 代码围栏,以及![[*.excalidraw.svg]]嵌入。 - MyGo UI 运行时升级至 v0.10.0。
- 代码块可视缩进与软换行、分层 ⌘A / Ctrl+A 全选、嵌套列表缩进,以及编辑时 Space 不再误触发翻页等修复。
- 在 macOS 未安装楷体时避免 CoreText MobileAsset 挂起。该修复位于官方 Release 标签当前指向的
6ad40d6,晚于最初的eabb520标签提交。 - 本包同时包含已在 0.2.4 中打包的上游 v0.2.1 能力(纯 Go 矢量 PDF、原生 Mermaid、
\boldsymbol、拼音搜索、Obsidian 图片嵌入等)。
0.2.3 起已有的阶段兼容(仍适用于 0.2.5)
编译器精确锁定 @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.5 主线 ZIP 未在真实 Mac/Finder/WKWebView 验收,不能把先前测试包验收或 0.2.3 / 0.2.4 包当作本包已实机验收。
安装与使用
- 保存文档并完全退出所有旧 ArcMD 进程,将本包 ArcMD.app 明确替换到 /Applications/ArcMD.app,从这个路径启动。稳定名称 ArcMD.app、bundle ID org.ybbapp.arcmd、正常配置与单实例均不变;不新增测试产品身份,也不会自动删除文档、配置或其他应用副本。建议先备份重要文档/配置。
- 全包 ad-hoc 临时签名,无 Developer ID,未 Apple 公证。若系统拦截,请按 macOS 针对单个应用的安全提示决定是否允许运行;不要关闭 Gatekeeper/SIP。
- 可从 Finder 启动,打开本地 .mdx(空间/侧栏/系统打开均可)。先试同包 demo.mdx,再让agent改一个新文件验证动态编译。普通正文仍原生。
- JSX/受提升段落请让agent或外部编辑器改原文件,再回应用重载;源码视图仍是只读导出预览。先保存/解决原生编辑,再重载。保存还原岛屿原文,不写回HTML;岛屿外Markdown仍可能被原生序列化规范化。
- 切主题不重载组件;重新打开/重载可重置状态。非活动Tab面板卸载,不承诺状态跨切换保留。编译/WebView/未知组件失败应显示诊断和源码,可重试;源码fallback不是成功。故意错误文件 intentional-error-unknown-component.mdx 用于检查渲染诊断。
- 不同目录副本和macOS旧登记可能造成“打开方式”重复条目,不能仅凭菜单确定本机副本数量。本包不主动清理用户Mac。需要恢复上一正式版可退出后重装 https://github.com/ybbapp/ArcMD/releases/tag/arcmd-v0.2.4 ,不需要删除数据。
范围与安全
不支持 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:4acd8642a23c51364ac4fa4dfa5131797c78aae5
上游官方 Release:v0.2.2 / 450124722,源码 6ad40d616d2d7f4a2ab2c525a7d7e06f9e408313。
ZIP:ArcMD-macOS-arm64-4acd864.zip,18856267 bytes(17.98 MiB)
SHA256:170329fd9815828d5d697050fb3852203a58e1678ec96a378c267f40fbc82264
相关 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 在本 Linux 环境相同的 Issue 19 失败 TestIssue19CodeTabVisualIndentAndPaste、TestIssue19LongIndentedCodeLineSoftWrap/tab(char.X=8.428711)。其余五项已知 Linux app 基线测试已通过。未借机修改测试,无新增失败。
最终包独立检查173项资源 hash、Mach-O 全部代码页和 Info.plist/CodeResources 特殊槽,ZIP/执行权限及无运行时 Node 结构通过;未在真实 Mac 对本 ZIP 测试。源码 fallback 不能算 JSX 运行通过。不关闭 Gatekeeper/SIP,不做真实 Mac 验收声明。