Easy Markdown 预览

要解决什么问题

在 Agent 对话里改 Markdown、或要把 AI 生成的 md 落到本地再核对样式时，纯文本窗口很难判断标题层级、代码块和列表在公众号/知乎里的实际效果。本技能用本地浏览器预览服务把编辑、渲染、复制串在一起，而不是只做一次性 HTML 导出。

怎么工作

触发条件很窄：只有用户明确要预览 Markdown 文件时才执行（例如「预览这个 markdown 文件」），普通文本渲染或看图不会走这条链路。

执行上分两步：先用 preview_server.py 以脱离托管进程树的方式常驻本地服务（默认 127.0.0.1、端口默认 8765，冲突时在范围内递增），再用系统浏览器打开页面，而不是挤在内置小窗里。

页面能力包括：

• CodeMirror 编辑、单栏预览、双栏并排（滚动同步）、手机宽度预览
• 22 种预览主题与 9 种代码高亮，偏好写入本机配置目录，刷新后仍保留
• 富文本复制：把当前主题内联后的 HTML 写入剪贴板；本地预览图会通过本机服务 fetch 并内联为 base64，便于粘贴到公众号等
• 粘贴图片：在编辑/双栏模式下 Ctrl+V/Cmd+V，经 /api/image 存到与 md 同目录的 images/，并插入本地引用（单张 ≤5MB，全程不出本机）
• --file 热更新：约每 3 秒轮询文件，Agent 改 md 后页面会提示外部内容已更新

可选 --stdin 注入内容、--no-open 供后台场景、--heartbeat-timeout 控制页面关闭后的兜底自停（默认 120 分钟，避免后台标签冻结误杀）。

边界与注意

• --stdin 模式不支持热更新与粘贴图片。
• 编辑器停顿约 5 秒会自动保存并覆盖被预览的 md（无备份）；关页不会自动保存，未保存离开会确认。
• 服务跑在技能 assets/ 上，终止可参考 PID 文件（如 /tmp/claw-markdown-preview.pid）。