SuperAPI AI 工具集

pm-preview

通用与其它

查看项目

更新于 10-15 23:47

技能介绍

用途:在浏览器中实时预览 docs/ 目录下的全部 Markdown 产品文档,适合查看 PRD、BRD、MRD 等文档的渲染效果。文档尚未生成(docs/ 为空)时不适用。

主要能力:左侧边栏按目录分组展示文档树,支持折叠展开;右侧渲染 Markdown,支持表格、代码块、流程图;文档更新时通过 WebSocket 自动推送刷新;亮暗主题跟随操作系统;仅使用 Node.js 内置模块,无需 npm install;30 分钟无活动自动停止并清理临时文件。

使用方式:先确认 docs/ 下存在 .md 文件,再启动预览服务器: bash "<当前 pm-preview skill 所在目录>/scripts/start-preview.sh" --project-dir . 服务器在 49152-65535 随机高端口后台启动,输出含 port、url、docs_dir、state_dir 的 JSON,将 url 告知用户在浏览器打开。使用 --project-dir . 会把 session 持久化到 .superpm/preview/。停止方式: ls -d .superpm/preview/*/ bash "<当前 pm-preview skill 所在目录>/scripts/stop-preview.sh" .superpm/preview/{session_id}

限制:需要本地 Node.js 与支持 WebSocket 的现代浏览器(Chrome/Firefox/Safari/Edge);Markdown 渲染与 HTML 清理库随 skill 本地提供,预览不依赖 CDN;随机端口被占用时自动换端口;每次启动创建独立 session,可同时运行多个实例;文档更新后有 100ms 防抖延迟;启动失败可用 --foreground 模式查看错误;验收后应删除不再需要的 session。收费、价格等信息暂未提供。