用途:该技能在 MkDocs Material 站点中生成完整可用的多因果回路图(CLD)文章。每节讨论一个反馈回路,以可拖拽的交互图呈现,最后汇总为全系统视图。触发场景包括“为 X 做因果回路图”“展示 X 中的反馈回路”“向站点添加 CLD 文章”等;若用户只要单张图,则仅生成一个 CLD JSON 并内联嵌入。
主要能力:为每个回路生成一个 JSON(通常 3–5 个节点),并生成一个围绕共享中心节点合并全部回路的全系统 JSON;生成文章 Markdown(渐进展开,每回路一节,含内联交互图及全屏按钮);按需补充共享基础设施(cld-inline.js、cld-viewer)并更新 mkdocs.yml 导航。所有图均为可拖拽、缩放、点击查看的 vis-network 实例,而非静态图片。
使用方式:先理解系统并列出发散回路(R1、R2…)与平衡回路(B1、B2…),展示给用户确认后再生成。确认项目布局(查找 mkdocs.yml,确认或创建 docs/articles/、docs/sims/cld-viewer/examples/ 等),从技能 assets/ 复制缺失资源,按 references/json-schema.md 生成 JSON,按 article-structure.md 写文章,并更新导航。默认输出 1 个锚点示例、3–4 个发散回路、3–4 个平衡回路和 1 个全系统图,共 8–10 张图;主题动态较少时按比例缩减,不凑数。
限制与注意:不要在文章中内联使用 iframe 嵌入图(Chrome 与 Firefox 在单页第 5–6 个 iframe 后静默渲染失败,且无客户端解决办法),应使用 div.cld-inline 与内联渲染器;不要用 mermaid、ASCII 或静态图片;不要弱化 2px solid blue 边框,也不要修改 extra.css 的全局 iframe 规则;不要遗漏文章底部的 script src 标签,否则内联 div 只会是空边框盒子。修改渲染代码前须阅读 pitfalls.md。具体收费、价格、平台与效果等未在资料中提供。