用途:该技能启动一个后台 HTTP 服务器,将 Markdown 文件渲染为带有宁静书卷感的阅读界面,也可作为目录浏览器使用。传入任意路径即可查看:Markdown 文件显示为小说式阅读 UI,目录显示为带链接的文件列表。
主要能力:书卷主题提供暖奶油色浅色模式与暖金色深色模式,标题使用 Libre Baskerville 衬线字体,正文 Inter,代码 JetBrains Mono,内容最大宽度 720px;目录浏览器显示带表情图标的文件列表,Markdown 文件与子目录可点击,并支持上级目录(..)导航与明暗模式;计划导航可自动识别计划目录结构,侧栏显示各阶段及状态,提供上一页/下一页按钮。快捷键:T 切换主题,S 切换侧栏,左右方向键切换阶段,Escape 关闭侧栏(移动端)。HTTP 路由包括 /view?file=<path>、/browse?dir=<path>、/assets/* 与 /file/*(本地图片)。
使用方式:首次使用需安装依赖,推荐 ck init,或手动执行 cd .claude/skills/markdown-novel-viewer 后运行 npm install。示例:node .claude/skills/markdown-novel-viewer/scripts/server.cjs --file ./plans/my-plan/plan.md --open;浏览目录使用 --dir,后台运行加 --background,停止全部服务器使用 --stop。也可用斜杠命令 /preview。CLI 选项包括 --file、--dir、--port(默认 3456)、--host(默认 localhost)、--open、--background、--stop。
适用场景:本地查看与浏览 Markdown 文档、计划目录与项目文档。
限制:仅面向本地使用,除非明确接受网络暴露风险,否则应保持 --host localhost;渲染依赖 npm 包,未安装会返回 500 渲染错误;图片路径需相对于 Markdown 文件;端口被占用时会在 3456-3500 自动递增;若服务器无法停止,需检查系统临时目录中的 md-novel-viewer-*.pid 残留文件。其余收费、价格等信息暂未提供。