convoviz

把 ChatGPT 聊天记录一键变成干净的 Markdown 和图表

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署对话助手 🍴 复刻 53 👀 关注 11

GitHub ↗

GitHub 星标 ★ 893

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，完全免费，无付费版本。

项目预览

项目数据

分类对话助手

开发团队mohamed-chs

GitHubhttps://github.com/mohamed-chs/convoviz

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，完全免费，无付费版本。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Python

技术栈/模型backup,chatgpt,chatgpt-export,cli,conversations,data-visualization,export,markdown,markdown-converter,obsidian,obsidian-md,openai,personal-knowledge-management,wordcloud

GitHub 星标★ 893

上线时间2023-09-16 00:00:00

代码更新2026-11-08

仓库体积7.9 MB

本站数据更新2026-11-10

维护状态活跃

收录时间2026-08-09

浏览次数6

项目介绍

convoviz 是一个将 ChatGPT 导出文件（ZIP 格式）转换为干净 Markdown 文本文件的工具，支持内联媒体，并能生成词云和使用统计图等数据可视化。它主要解决 ChatGPT 对话记录难以整理、检索和备份的问题，让用户能够将聊天历史无缝导入 Obsidian 等笔记工具，或用于本地归档和分析。核心能力包括：解析 ChatGPT 导出 ZIP 中的 JSON 数据，提取对话内容并转换为结构化 Markdown；自动处理图片等媒体资源，使其内嵌于 Markdown 中；生成词云、消息频率图等可视化图表，帮助用户洞察自己的使用模式。项目基于 Python 实现，技术栈涵盖 JSON、Markdown、ZIP 处理等，适合对隐私敏感或希望深度管理对话数据的用户。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 893

技术标签

chatgpt cli data-visualization markdown obsidian

使用教程

难度：入门约 10 分钟部署方式：本地安装 4 步

环境要求

Python 3.9+

安装与启动步骤

1装包

带 viz extra 才有可视化能力。

python3 -m venv .venv
.venv/bin/pip install "convoviz[viz]"

2导出数据

从 ChatGPT 官方导出拿到 conversations.json，作为输入。
```
convoviz --help
```
3生成 Markdown

每个会话输出成独立 md，便于自己检索与归档。
4补 nltk 数据

词云等功能依赖停用词表，没下会报错。
```
python -c "import nltk; nltk.download('stopwords')"
```