SuperAPI AI 工具集

wiki-viewer

写作与研究

查看项目

更新于 10-16 00:21

技能介绍

用途:在完成 /wiki 研究运行后,把 pro-workflow wiki 渲染成一个自包含的单文件 HTML 查看器,用于查看研究产出、分享给同事或管理层、为陌生模块做代码审查、做事故复盘或周期性审计。

主要能力:读取 ~/.pro-workflow/data.db,将 wiki 导出为单个 HTML 文件。文件中包含:顶部信息(slug、flavor、范围、路径、更新时间、页面与来源数量、kill-switch 状态);侧栏按 page_type 分组的页面列表与页面内筛选;主区显示所选页面的标题、摘要、渲染后的完整 markdown 内容,内联引用可解析到来源行;来源表(wiki_sources 与手动 sources.md);按状态分组的种子队列表,每条待处理种子带“复制为研究提示”按钮;跨页引用与反向链接的 SVG 力导向图;浏览器内针对标题、摘要、内容的子串与分词搜索;页脚显示 schema 版本、嵌入模型(如有)和生成器版本。文件完全自包含:无 CDN、无外部字体、无外部脚本,仅内联 CSS、SVG 和 JS。

使用方式:运行命令 node $SKILL_ROOT/scripts/render.js <slug> [--out <path>] [--theme dark|light] 默认输出到 <wiki-root>/derived/viewer.html,默认主题 dark。示例流程: /wiki research agent-memory --max-pages 5 node skills/wiki-viewer/scripts/render.js agent-memory open ~/.pro-workflow/wikis/agent-memory/derived/viewer.html 也可上传到 S3 分享: aws s3 cp ~/.pro-workflow/wikis/agent-memory/derived/viewer.html s3://my-bucket/agent-memory.html --acl public-read

限制:Markdown 使用文件内小型解析器,支持标题、列表、代码块、链接、引用块、表格、脚注引用,不支持 markdown 中的 HTML。链接图为预计算并序列化为 SVG,无实时重排。搜索为子串加分词 AND 匹配,BM25 仍留在 SQLite,查看器是快照。每次批量更改后需重新渲染,文件不是实时的。未来计划中的 --include-council、--include-survey、contested 声明旁的“复制为 council 提示”按钮以及 --against 差异视图均不在初始版本中。