技能介绍

问题：知识库“能读”，但“不好读”

ima 知识库里存的往往是成体系的长文，但它的阅读界面围绕“打开一篇”设计。当知识库有几十个篇目、又希望对外分享或售卖时，直接把文件丢给读者会遇到三个具体问题：目录在哪、怎么在一篇长文里跳章节、以及离线时还能不能看到结构。这个技能要解决的是“把知识库变成可分享的阅读站点”这一层，而不是重复做内容整理。

工作方式：从导出到部署

整个流程以脚本串起来，大致分四段：

读取与扫描：通过 ima MCP 工具（如 get_knowledge_list、fetch_media_content）拉取知识库清单和正文，远程资源不通过本地文件工具读取。
清洗与分档：clean_text.py 剥离模板垃圾区块，只保留正文；gen_reading.py 生成深度解读（原文全本），gen_quick.py 生成五分钟解读（保留 h2 章节结构的自动浓缩，否则文章目录会丢失层级）。
构建主站：build_site.py 是单入口，生成 data.js（window.MAO）、按篇分片的 data/art/*.js 和六种页面模板（index/catalog/thinking/guide/start/article）。文章页内置 buildTOC()，目录第一条指向标题本身，再扫 #content h2 建锚点；切换阅读模式时重建目录。
可选扩展：build_resonance.py 抓微信读书数据生成共鸣页；build_longpage.py 产出自包含单页版；build_ima_export.py 导出可上传回 ima 的离线导航 HTML。navdrawer.js 是独立文件，改完直接部署，无需重新构建。

部署支持临时沙箱预览和 GitHub Pages 长期托管（site/.nojekyll + deploy_github.sh），file:// 也能直接打开。

适用边界与注意点

适用：已有成体系的 ima 知识库，且需要对外分享、售卖或长期托管。仅做临时预览意义不大。
内容依赖：五分钟解读是自动浓缩，质量取决于源文结构；五大思维栏目是 6 篇固定内容，顺序由 THINKING 常量控制，改顺序只改一处，但要同步检查卡片简介长度（约 45–57 字）以保持等高。
构建坑位多：Python % 格式化与 CSS 字面 % 冲突、data.js 是单行 JSON 不能 grep、锚点 id 只在 h2 生成、sticky header 遮挡跳转、scrollspy 需约 10px 容差、地图回调缺参数会整块渲染失败——均在 SKILL.md 里有明确规避方式，动手前值得通读。
数据与密钥：微信读书鉴权走环境变量 WEREAD_API_KEY，不落盘；沙箱代理常不可用，需直连。