mcpField
W
wiki-viewer

wiki-viewer

github.com/rohitg00生产力2.9k137 次安装4 周前更新
代码仓库

关于 wiki-viewer

这个渲染器将 pro-workflow Wiki 转为独立 HTML 快照，包含搜索、来源与种子面板，以及引用关系图。适用于检查、审计、打印或分享 Wiki 内容，接收者无需安装 pro-workflow。

主要功能

  1. 01生成单文件 HTML
  2. 02浏览器内搜索 Wiki
  3. 03页面、来源和种子面板
  4. 04引用与反向链接图
  5. 05深色或浅色主题
  6. 06适合打印的布局

适用场景

  1. 01查看研究运行后的结果
  2. 02与同事分享 Wiki 快照
  3. 03审计过时论点和孤立页面
  4. 04打印 Wiki 内容供审阅

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/rohitg00/pro-workflow --skill wiki-viewer

安装后在 Claude Code 中输入/wiki-viewer确认已加载。

附带文件scripts/render.js

详细介绍

Wiki Viewer

以单个 HTML 文件呈现的 pro-workflow wiki。读取 ~/.pro-workflow/data.db，将 wiki 导出为一个自包含的 HTML 文档，内置浏览器搜索、链接图和种子队列面板。

为什么用 HTML，而不是 markdown

  • 信息密度 — 页面、来源、论断、种子和链接图都能显示在一个视口中
  • 视觉清晰 — 原始 markdown 难以阅读长篇 wiki；HTML 能更好地呈现内容
  • 易于分享 — 上传到 S3，发送 URL；接收者无需安装 pro-workflow
  • 双向交互 — “copy as seed”按钮可将未解问题转换为种子队列提示词，方便你粘贴回 Claude Code
  • 可审计 — 快速直观地验证自动研究循环是否产出了有用内容

适用场景

  • 运行 /wiki research 后，查看构建结果
  • 与队友或领导层分享 wiki 前
  • 代码审查：为不熟悉的模块渲染 codebase 风格的 wiki
  • 事件复盘：渲染 incident wiki，用于事后分析报告
  • 定期审计：检测过时论断、检查孤立页面

命令

node $SKILL_ROOT/scripts/render.js <slug> [--out <path>] [--theme dark|light]

默认值：

  • 输出：<wiki-root>/derived/viewer.html
  • 主题：dark

文件内容

面板内容
页眉wiki slug、风格、范围、根路径、最后更新时间戳、页面数量、来源数量、终止开关状态
侧边栏按 page_type 分组的页面列表，页内筛选输入框
主面板所选页面的详情：标题、摘要、完整 markdown 内容（渲染后），行内引用链接到对应来源行
来源所有 wiki_sources 行和手动添加的 sources.md 行组成的表格
种子按状态分组的种子队列表；每个待处理种子都有“copy as research prompt”按钮
链接图通过力导向布局呈现跨页面引用和反向链接的 SVG
搜索在浏览器中对标题、摘要和内容进行子串及词元搜索
页脚元数据：架构版本、嵌入模型（如有）和生成器版本

自包含

不使用 CDN、外部字体或 <script src=>。仅包含内联 CSS、内联 SVG 和内联 JS。生成的单个 .html 文件可在本地或任何静态托管服务中打开。

与其他组件配合

# Generate after auto-research run completes
/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

# Hand off to a teammate
aws s3 cp ~/.pro-workflow/wikis/agent-memory/derived/viewer.html s3://my-bucket/agent-memory.html --acl public-read

设计原则

  1. 类型优先 — 每个面板都以文本为主；可视化仅作辅助，不承担关键信息。
  2. 零装饰 — 不使用渐变、光晕或氛围背景。
  3. 颜色承载含义 — 仅用 Anthropic 珊瑚色标记当前页面和 CTA。
  4. 适合打印 — @media print 会折叠侧边栏，让 markdown 内容整洁地打印出来。

限制（初始版本）

  • Markdown 渲染使用文件内的小型解析器（标题、列表、代码块、链接、引用块、表格、脚注引用）。不支持 markdown 中的 HTML。
  • 链接图会预先计算并序列化为 SVG；不会实时重新布局。
  • 搜索采用子串匹配和词元化 AND 匹配。BM25 保留在 SQLite 中；查看器展示的是快照。
  • 每批更改后都需要重新渲染。文件不是实时更新的。

后续扩展点（初始版本不包含）

  • 使用 --include-council 将所有关联的 council 逐字稿内嵌
  • 使用 --include-survey 将生成的调查内容内嵌
  • 在标记为 contested 的论断旁添加“Copy as council prompt”按钮
  • 差异视图：使用 --against <previous.html> 突出显示自上次渲染以来新增的论断

评论

支持 Markdown