DeepSeek Harness Hub
← 返回列表

RAG 切分可视化PerryLink/RAG-Chunk-Visualizer

DeepSeek Harnessspec-screened在 GitHub 查看 ↗
未验证

把文本切分结果渲染成高亮重叠的交互网页

尚未跑自动兼容性验证,可查看页面内的依赖与入口分析。 · 最近上游提交 2026/8/22 · 已提供中文文档

A visualization tool for RAG (Retrieval-Augmented Generation) text chunking. Helps developers intuitively understand chunk splitting effects, overlap regions, and context boundaries. RAG(检索增强生成)文本切分可视化工具。帮助开发者直观理解 chunk 切分效果、重叠区域和上下文边界。

综合分
28.2
GitHub 分
28.2
用户评分
★ Stars
1
周下载量
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add PerryLink/RAG-Chunk-Visualizer
该插件未发布到 npm,走 GitHub 源安装(pnpm 若拦截 prepare 脚本,按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑)
数据截至 2026/9/16(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

RAG-Chunk-Visualizer

将 RAG 文本切分结果渲染为带重叠高亮的交互式 HTML 可视化的工具。

已移植到 dsh-library —— PerryLink DSH 插件家族的一员。

License

English · 简体中文

功能简介

RAG-Chunk-Visualizer 按可配置的 chunk 大小与重叠长度将文本文件切分成多个块,并生成一张颜色编码的 HTML 页面,展示每个 chunk、重叠区域以及各 chunk 的统计信息,帮助开发者直观查看切分参数对结果的影响。

功能特性

- 生成交互式、颜色编码的 HTML 输出
- 以斜纹高亮标记重叠区域
- 悬停提示显示 chunk 索引、位置与字符数
- 使用 chardet 自动检测文本编码
- 使用 Rich 在终端汇总 chunk 数量、大小与输出路径

快速开始

需要 Python 3.8+ 与 Poetry。

git clone https://github.com/PerryLink/RAG-Chunk-Visualizer.git
cd RAG-Chunk-Visualizer
poetry install

使用方法

使用默认 chunk 大小(200)与重叠(50)
rag-chunk-visualizer input.txt

或以模块方式运行
python -m rag_chunk_visualizer input.txt

自定义 chunk 大小、重叠与输出文件
rag-chunk-visualizer -s 500 -o 100 -O result.html input.txt

详细输出
rag-chunk-visualizer -v input.txt

| 参数 | 默认值 | 说明 |
|------|--------|------|
| input_file | — | 输入文本文件路径(位置参数,必需) |
| -s, --chunk-size | 200 | Chunk 大小(字符数) |
| -o, --overlap | 50 | 重叠大小(字符数) |
| -O, --output | output.html | 输出 HTML 文件路径 |
| --encoding | 自动检测 | 文本编码 |
| -v, --verbose | 关 | 详细输出 |
| --version | — | 显示版本 |

示例:

echo "这是一段测试文本。它包含多个句子,用于验证切分效果。重叠区域应该被正确标记。RAG系统需要将长文本切分成多个chunk,以便更好地进行检索和生成。" > test.txt
rag-chunk-visualizer -s 30 -o 10 test.txt

在浏览器中打开生成的 output.html 即可查看切分布局。

基于 Jinja2、Rich 与 chardet 构建;测试使用 pytest。

开发

poetry run pytest -v

相关项目

- dsh-library —— 本工具已移植进的 DSH 插件
- PerryLink —— PerryLink DSH 插件家族

许可证

Apache License 2.0 © 2026 PerryLink

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

💬 加入 DPharness 群聊

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

点击加入 QQ 群
DPharness 群聊二维码,手机 QQ 扫码进群
扫码进群