关于 visualize
visualize 是一项将 OKF bundle 转换为独立 HTML 图谱的技能，可用于探索概念及其链接。它展示概念详情和派生的信任度与过期状态指示，并提供布局和输出选项。
主要功能
- 01生成独立 HTML 图谱
- 02查看概念详情和渲染内容
- 03显示概念之间的链接
- 04派生信任度与过期状态指示
- 05选择图谱布局和输出选项
适用场景
- 01探索 OKF bundle 中的关联
- 02检查概念的来源与状态
- 03渲染指定 bundle 目录以供审阅
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/visualize确认已加载。
附带文件scripts/okf_visualize.py
详细介绍
可视化 OKF bundle
为目标 bundle 生成一个自包含的 HTML 图。必须提供 bundle 目录，因此未给出路径时请显式传入 .okf。无需后端，无需安装，bundle 内容不会离开页面。查看器需要网络连接：cytoscape、marked 和 dompurify 会从 cdn.jsdelivr.net 加载。
uv run "${CLAUDE_SKILL_DIR}/scripts/okf_visualize.py" $ARGUMENTS
如果无法使用 uv：
python3 -m pip install --quiet pyyaml && \
python3 "${CLAUDE_SKILL_DIR}/scripts/okf_visualize.py" $ARGUMENTS
详情面板会显示每个概念的 type、description、tags、status、
generated、verified、stale_after、sources（包含其可信度信号，以及与之对应的 usage_window 和 usage_count）和渲染后的正文；指向 bundle 中另一个概念的 sources 条目也会成为图中的边。v0.1 的 timestamp 会被读取为 generated.at，因此旧版 bundle 也能完整呈现。
两个徽标是推导得出的，而非读取所得：§5.3 信任级别
（未验证 / 机器确认 / 人工审核，依据 verified[].by 中的 human: 前缀判定）和过时状态（now >= stale_after）。这些都是参考信号——报告 bundle 时，请说明概念所属的信任级别，而不要将其视为门槛。
| 标志 | 效果 |
|---|---|
-o <path> | 输出文件（默认 <bundle>/viz.html）。 |
-t, --title | 图标题（默认 parent/bundle 目录名）。 |
-l, --link | 在页眉显示的源 URL。 |
--layout | cose、concentric、breadthfirst、circle、grid。 |
--max-nodes N | 超过 N 个概念时退出并返回 1（适用于 CI）。 |
--og-image URL | 社交预览图片的绝对 URL。 |
概念超过 1,000 个时，默认布局会切换为 concentric（强行使用默认布局会导致页面卡死；--layout cose 可覆盖此设置，页面内的选择器会先询问）。超过 5,000 个时，会警告页面加载缓慢且图形会变成一团毛线，并建议渲染某个子目录。
可在任意浏览器中打开；无论这是作为 okf 插件的一部分运行，还是作为独立的 skills.sh 技能运行，${CLAUDE_SKILL_DIR} 都会正确解析。页面支持深层链接：?select=<concept-id> 或 #<concept-id> 会打开对应概念，?layout=<name> 会预设布局。