md-viewer

name: md-viewer description: 在浏览器中渲染 Markdown 文件，当用户明确要求用 viewer/浏览器 预览 md 文件或关闭 viewer 时触发。触发词：view md/预览 md/viewer/关闭 viewer

路径

SKILL_DIR = 本 SKILL.md 所在目录的父目录(即 skill 根目录)
$SKILL_DIR/config.json              ← 配置文件(端口/刷新间隔/浏览历史条数/文件注册表)，不存在时自动创建
$SKILL_DIR/server/viewer-server.js  ← 服务端主程序

⚠️ 依赖

• npm: 首次使用需 cd $SKILL_DIR/server && npm install 安装 express
• CDN: marked + mermaid 通过 unpkg CDN 加载，离线不可用
• 首次加载: mermaid 2.6MB 约 2s，浏览器缓存后秒开

功能

初始化

cd $SKILL_DIR/server && npm install

config.json 不存在时启动自动创建，默认内容：

{"port":3456,"refresh_interval":3000,"browse_history_limit":5,"last_updated":"","files":[]}

命令

view — 查看 md 文件

1. 如果提供了文件路径： a. 确认文件路径为绝对路径 b. 注册文件：curl -s "http://localhost:PORT/api/register?path=ENCODED_ABS_PATH" 返回 JSON 中的 id 字段即为文件 ID c. 如果 server 未运行：cd $SKILL_DIR/server && node viewer-server.js &，等待 2 秒后重新注册 d. 打开浏览器：open "http://localhost:PORT/i/{id}"

2. 如果没有提供文件路径： a. 如果 server 未运行：cd $SKILL_DIR/server && node viewer-server.js &，等待 2 秒 b. 直接打开浏览器：open "http://localhost:PORT"

端口获取：cat $SKILL_DIR/config.json | grep -o '"port":[[:space:]]*[0-9]*' | grep -o '[0-9]*'

stop — 关闭 viewer server

kill $(lsof -ti:PORT)

配置

配置文件：$SKILL_DIR/config.json