Merge branch 'main' of https://github.com/xerrors/Yuxi-Know

Author: xerrors

docs/changelog/roadmap.md

@@ -5,30 +5,30 @@
 - **[2025/10/13]** v0.3 进入 beta 测试环节，不会再封装新的特性，仅作 bug 层面的修复
 
 
-**Bugs**
+## Bugs
 
 - [ ] 当前 ReAct 智能体有消息顺序错乱的 bug，且不会默认调用工具
 
 
-**Next**
+## Next
 
 - [ ] 修改现有的智能体Demo，并尽量将默认助手的特性兼容到 LangGraph 的 [`create_agent`](https://docs.langchain.com/oss/python/langchain/agents) 中
 - [ ] 基于 create_agent 创建 SQL Viewer 智能体 <Badge type="info" text="0.3.5" />
 - [ ] 优化 MCP 逻辑，支持 common + special 创建方式 <Badge type="info" text="0.3.5" />
 - [ ] 添加对于上传文件的支持
-- [ ] 知识图谱的上传和可视化，支持属性，标签的展示 <Badge type="info" text="0.4" />
+- [ ] 统一图谱数据结构，优化可视化方式 [#298](https://github.com/xerrors/Yuxi-Know/issues/298) <Badge type="info" text="0.4" />
 - [ ] 集成智能体评估，首先使用命令行来实现，然后考虑放在 UI 里面展示
 - [ ] 开发与生产环境隔离，构建生产镜像 <Badge type="info" text="0.4" />
-- [ ] 支持 MinerU 2.5 的解析方法（含API方法，API不支持文件上传）<Badge type="info" text="0.3.5" />
+- [ ] 支持 MinerU 2.5 的解析方法 <Badge type="info" text="0.3.5" />
 - [ ] 优化全局配置的管理模型，优化配置管理
 
-**Later**
+## Later
 
 下面的功能**可能**会放在后续版本实现，暂时未定
 
 - [ ] 集成 LangFuse (观望) 添加用户日志与用户反馈模块，可以在 AgentView 中查看信息
 
-**Done**
+## Done
 
 
 - [x] 添加测试脚本，覆盖最常见的功能（已覆盖API）

docs/intro/knowledge-base.md

@@ -71,7 +71,32 @@ LightRAG 知识库可在知识库详情中可视化，但不支持在侧边栏
 - 更结构化的库内检索/可视化：优先使用 LightRAG（注意构建质量与成本）。
 - 统一的图查询/工具调用：依赖全局 Neo4j 图谱与工具 `query_knowledge_graph`。
 
-接入已有 Neo4j 实例、三元组导入方式与注意事项见下文说明；LightRAG 构建模型可通过 `.env` 中的 `LIGHTRAG_LLM_*` 变量覆盖。
+因此，侧边栏知识图谱页面展示的是 Neo4j 图数据库中符合以下规则的知识图谱信息。
+
+具体展示内容包括：
+
+- 带有 Entity 标签的节点
+- 带有 RELATION 类型的关系边
+
+注意：
+
+这里仅展示用户上传的实体和关系，不包含知识库中自动创建的图谱。
+查询逻辑基于 `graphbase.py` 中的 `get_sample_nodes` 方法实现：
+
+```SQL
+MATCH (n:Entity)-[r]->(m:Entity)
+RETURN
+    {id: elementId(n), name: n.name} AS h,
+    {type: r.type, source_id: elementId(n), target_id: elementId(m)} AS r,
+    {id: elementId(m), name: m.name} AS t
+LIMIT $num
+```
+
+如需查看完整的 Neo4j 数据库内容，请使用 "Neo4j 浏览器" 按钮访问 Neo4j 原生界面。
+
+通过网页上传的 `jsonl` 文件的图谱默认会符合上述条件。
+
+
 
 ### 1. 以三元组形式导入