> ## Documentation Index
> Fetch the complete documentation index at: https://langchain-docs-zh.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 可视化您的维基

> 探索一个 OpenWiki Markdown 维基，具有本地交互式节点图和阅读器

为探索 OpenWiki Markdown 维基，`openwiki visualize` 在浏览器中提供了一个本地交互式节点图，与实时 Markdown 阅读器并列。您还可以将相同的图和阅读器导出为静态目录进行托管。

## 打开可视化器

从已包含 `openwiki/` 目录的仓库：

```bash theme={null}
openwiki visualize
```

此命令将 `./openwiki` 在 `127.0.0.1:4321` 上启动服务并打开浏览器访问图界面。在服务器运行期间，对维基文件的修改会自动生效。可视化面板与 Markdown 阅读器并列，支持调整大小和折叠。

## 选项

```bash theme={null}
openwiki visualize openwiki --port 4400 --no-open
```

| 参数/标志 | 描述 |
| - | - |
| `[path]` | 维基目录路径。默认值 `./openwiki` |
| `--port <port>` | 预设端口。默认值 `4321`。若端口被占用则自动递增 |
| `--no-open` | 禁止自动打开浏览器 |
| `--export <dir>` | 导出静态可视化目录而非启动本地服务器。不可与 `--port` 或 `--no-open` 组合使用 |

要探索个人维基：

```bash theme={null}
openwiki visualize ~/.openwiki/wiki
```

![OpenWiki可视化器旁边有一个交互式节点图和一个实时Markdown阅读器](https://mintcdn.com/langchain-docs-zh/GwyUNaaRzl5kP0v2/langchain/oss/images/openwiki/visualizer.gif?s=60e444336ce770f99bcc61c7320e0bd3)

可视化器显示：

* 维基概念及其 Markdown 链接的交互式节点图
* 与所选页面并列的实时 Markdown 阅读器

节点图不显示 `INSTRUCTIONS.md` 和其他脚手架文件。

## 导出静态站点

要将其与生成文档一同发布，请导出静态目录而非启动服务器：

```bash theme={null}
openwiki visualize <PATH> --export docs/openwiki-visualizer
```

导出包包含 `index.html`、`client.js`、`client-lib.js`、`styles.css` 和 `graph.json`。客户端通过读取兄弟节点文件运行，无需实时刷新，因此可托管于 GitHub Pages、MkDocs 或任何静态主机。

> [!NOTE]
>
> 页面从公共 CDN 加载图、Markdown 和图表库，因此本地和静态视图均需网络连接。

## 参考文档

* [快速入门](https://langchain-docs-zh.mintlify.site/langchain/oss/openwiki/quickstart.md)
* [代码模式](https://langchain-docs-zh.mintlify.site/langchain/oss/openwiki/code-mode.md)
* [CLI 参考文档](https://langchain-docs-zh.mintlify.site/langchain/oss/openwiki/cli-reference.md)

***

> 官方原文：[src/oss/openwiki/visualize.mdx](https://github.com/langchain-ai/docs/blob/main/src/oss/openwiki/visualize.mdx) · 非官方翻译，译文由 AI 生成，以英文原文为准。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.