Md 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 文件

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

1. 如果提供了文件路径： a. 确认文件路径为绝对路径 b. 如果 server 未运行：cd $SKILL_DIR/server && node viewer-server.js &，等待 2 秒 c. 注册文件并打开浏览器（一步完成）：

   ID=$(curl -s "http://localhost:PORT/api/register?path=ENCODED_ABS_PATH" | python3 -c "import sys,json; print(json.load(sys.stdin)['id'])")
   open "http://localhost:PORT/i/${ID}"
   

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

`

stop — 关闭 viewer server

kill $(lsof -ti:PORT)

配置

配置文件：$SKILL_DIR/config.json