技能介绍

本地知识库的可视化与隐私困境

当你想把一个庞大的本地 Markdown 文件夹或 Obsidian Vault 转化为可视化的知识工作台（如 HTML Dashboard）时，往往面临两难：要么把整个 Vault 上传到云端，面临正文、路径和标签等隐私泄露风险；要么在本地手动编写脚本，费时费力且难以维护。这个技能旨在解决这一痛点，让你在事实源完全留在本地的前提下，仅通过提交一份聚合结构清单，换取一份经过验证的构建方案，最终在本地生成离线可视化工作台。

核心工作流与关键门禁

技能的执行流程被严格限制在本地与必要的支付网关之间，分为几个关键步骤：

免费预检：优先探测 Python 3.10+，若不可用则回退到 POSIX Shell 进行基础兼容性检查。只有返回 DOCTOR_OK 或 SKILLHUB_FREE_PRECHECK_OK 才会继续。
结构清单生成：在本地扫描目录，提取仅包含聚合结构的元数据（如文件/目录数量和哈希），明确排除路径、文件名、标题、正文和标签值。
付费与方案交付：在用户明确授权单次上传后，将结构清单哈希发送至服务端。若返回 PAYMENT_REQUIRED，技能会调用 weixinpay 插件完成按次付费，并通过幂等键保证订单状态一致，最终获取 PLAN_READY。
本地应用与构建：下载方案并在本地执行，全程保持 metadata-only 且 model_calls=0，最终生成离线的 /AI-Dashboard/index.html。

适用边界与真实门禁

需要注意的是，该技能并非万能的云端同步工具，它有严格的运行边界。首先，完整的付费请求和本地 HTML 构建必须依赖 Python 3.10+；SkillHub 云端沙箱的 Shell 回退路径仅能用于免费预检，无法执行后续的支付和构建。其次，事实源始终是只读的，技能不会修改你的原始 Markdown 文件。此外，任何涉及路径不明确、需要后台常驻或需要读取正文的请求都会被强制暂停。最后，该技能采用商业专有许可，未经授权不得重新打包或转售。