Back to Details

wiki-viewer

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Wiki Viewer

Wiki 查看器

Single-file HTML view of a pro-workflow wiki. Reads 
~/.pro-workflow/data.db
, dumps the wiki into one self-contained HTML document with in-browser search, link graph and a seed-queue panel.
pro-workflow Wiki 的单文件 HTML 视图。读取 
~/.pro-workflow/data.db
，将 Wiki 导出为一个自包含的 HTML 文档，并内置浏览器搜索、链接图和 seed 队列面板。

Why HTML, not markdown

为什么选择 HTML，而不是 markdown

  • Information density — pages, sources, claims, seeds, link graph in one viewport
  • Visual clarity — long wikis are unreadable as raw markdown; HTML scales
  • Shareability — upload to S3, send the URL; recipient does not need pro-workflow installed
  • Two-way interaction — "copy as seed" buttons turn open questions into seed queue prompts you can paste back into Claude Code
  • Auditable — quick visual proof that the auto-research loop produced something useful
  • 信息密度 — 页面、来源、主张、seed 和链接图尽览于同一视口
  • 视觉清晰度 — 冗长 Wiki 以原始 markdown 呈现时难以阅读；HTML 更适合规模化展示
  • 可分享性 — 上传到 S3 后发送 URL；接收者无需安装 pro-workflow
  • 双向交互 — “复制为 seed”按钮可将开放问题转换为 seed 队列提示词，再粘贴回 Claude Code
  • 可审计 — 快速以可视化方式验证自动研究循环是否产出了有用结果

When to use

使用场景

  • After a 
    /wiki research
    run, to see what it built
  • Before sharing a wiki with a teammate or with leadership
  • Code review: render a 
    codebase
    -flavored wiki for an unfamiliar module
  • Incident review: render an 
    incident
    wiki for a post-mortem readout
  • Periodic audits: stale-claim detection, orphan-page review
  • 执行 
    /wiki research
    后，查看构建出的内容
  • 与队友或管理层共享 Wiki 之前
  • 代码审查：为不熟悉的模块渲染 
    codebase
    风格的 Wiki
  • 事故复盘：渲染 
    incident
    Wiki，用于事后复盘汇报
  • 定期审计：检测过期主张、审查孤立页面

Commands

命令

node $SKILL_ROOT/scripts/render.js <slug> [--out <path>] [--theme dark|light]
Defaults:
  • output: 
    <wiki-root>/derived/viewer.html
  • theme: 
    dark
node $SKILL_ROOT/scripts/render.js <slug> [--out <path>] [--theme dark|light]
默认值：
  • 输出：
    <wiki-root>/derived/viewer.html
  • 主题：
    dark

What ships in the file

文件包含的内容

PanelContents
Headerwiki slug, flavor, scope, root path, last-update timestamp, page count, source count, kill-switch status
Sidebarpage list grouped by 
page_type
, in-page filter input
Mainselected-page detail: title, summary, full markdown content (rendered), inline citations resolve to source rows
Sourcestable of every 
wiki_sources
row + manual 
sources.md
rows
Seedsseed-queue table grouped by status; "copy as research prompt" button per pending seed
Link graphSVG force-layout of cross-page citations + back-links
Searchin-browser substring + token search over title/summary/content
Footermeta: schema versions, embedding model if present, generator version
面板内容
HeaderWiki slug、flavor、scope、root path、最后更新时间戳、页面数量、来源数量、kill-switch 状态
Sidebar按 
page_type
分组的页面列表、页内筛选输入框
Main所选页面详情：标题、摘要、完整 markdown 内容（已渲染）、可解析到来源记录的内联引用
Sources
wiki_sources
中的所有记录 + 手动添加的 
sources.md
记录
Seeds按状态分组的 seed 队列表格；每个待处理 seed 均有“复制为研究提示词”按钮
Link graph跨页面引用的 SVG 力导向布局 + 反向链接
Search在浏览器内对 title/summary/content 进行子字符串 + token 匹配搜索
Footer元信息：schema 版本、如有则显示 embedding model、生成器版本

Self-contained

自包含

No CDN, no external fonts, no 
<script src=>
. Inline CSS, inline SVG, inline JS only. Result is a single 
.html
file that opens locally or from any static host.
无 CDN、无外部字体、无 
<script src=>
。仅使用内联 CSS、内联 SVG 和内联 JS。最终生成单个 
.html
文件，可在本地打开，也可通过任意静态托管环境访问。

Compose with the rest

与其他部分组合使用

bash
undefined
bash
undefined

Generate after auto-research run completes

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
/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

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
undefined
aws s3 cp ~/.pro-workflow/wikis/agent-memory/derived/viewer.html s3://my-bucket/agent-memory.html --acl public-read
undefined

Design principles

设计原则

  1. Type-first — every panel reads as text; visualizations are auxiliary, not load-bearing.
  2. Zero decoration — no gradients, no glow, no atmospheric backgrounds.
  3. Color is meaning — Anthropic coral marks the active page and CTAs only.
  4. Print-friendly — 
    @media print
    collapses sidebars so the markdown content prints clean.
  1. 文本优先（Type-first） — 每个面板都以文本形式呈现；可视化仅起辅助作用，并非核心承载机制。
  2. 零装饰（Zero decoration） — 无渐变、无光晕、无氛围背景。
  3. 颜色即语义（Color is meaning） — Anthropic 珊瑚色仅用于标记当前页面和 CTA。
  4. 适合打印（Print-friendly） — 
    @media print
    会折叠侧边栏，使 markdown 内容打印时保持简洁清晰。

Limits (initial release)

初始版本的限制

  • Markdown rendering is a small in-file parser (headings, lists, code blocks, links, blockquotes, tables, footnote citations). No HTML-in-markdown.
  • Link graph is precomputed and serialized as SVG; no live re-layout.
  • Search is substring + tokenized AND match. BM25 stays in SQLite; the viewer is a snapshot.
  • Re-render after each batch of changes. The file is not live.
  • Markdown 渲染由文件内的小型解析器完成（标题、列表、代码块、链接、引用块、表格、脚注引用）。不支持 markdown 中嵌入 HTML。
  • 链接图预先计算并序列化为 SVG；不支持实时重新布局。
  • 搜索采用子字符串 + 分词 AND 匹配。BM25 仍保留在 SQLite 中；查看器仅为快照。
  • 每批更改后需重新渲染。该文件不是实时更新的。

Future hooks (not in initial release)

未来扩展点（初始版本尚不支持）

  • --include-council
    to bundle every linked council transcript inline
  • --include-survey
    to bundle generated surveys
  • "Copy as council prompt" buttons next to claims tagged 
    contested
  • Diff view: 
    --against <previous.html>
    to highlight new claims since a prior render
  • --include-council
    ：将每个关联的 council transcript 内联打包
  • --include-survey
    ：内联打包生成的 survey
  • 在标记为 
    contested
    的主张旁添加“复制为 council 提示词”按钮
  • 差异视图：
    --against <previous.html>
    ，高亮自上次渲染以来新增的主张