可视化类组件

可视化类组件负责把笔记中的数量、时间、进度和查询结果转换成更容易阅读的图表。它们适合放在主页上方或侧栏，用来快速回答“最近写了多少”“项目进行到哪里”“哪些资料刚刚更新”等问题。

当前可用组件

一、热力图

热力图把每天的创作量映射到颜色深浅。颜色越深，代表当天记录的数量越多，适合观察长期写作节奏，而不是比较某两天的精确数值。

基础设置

右键热力图组件选择 内容设置，然后设置以下项目。

四种计数方式

数据不正确时怎么处理

热力图的长期统计依赖插件本地索引。如果刚切换统计口径、迁移了大量文档，或某段日期的数据明显缺失，请进入“主页设置 → 检索管理”，刷新或重建相关索引，然后重新打开主页。

二、SQL 查询

SQL 查询组件适合把思源数据库中的文档或内容块筛选成表格。它比“最近文档”和“条件文档”更灵活，但也更需要明确查询范围。

设置步骤

1. 添加 SQL 查询组件，右键组件选择 内容设置。
2. 填写组件标题，例如“最近更新的文档”。
3. 输入 SQL 查询语句，并尽量添加明确的筛选条件和数量限制。
4. 在“列排序”中填写希望优先展示的字段。
5. 在“隐藏字段”中填写不希望显示的原始字段名。
6. 确定后检查结果数量、字段顺序和文档跳转是否符合预期。

一个可以直接修改的示例

下面的查询会找出最近更新的 20 篇文档：

SELECT
  id,
  content,
  hpath,
  box,
  tag,
  created,
  updated
FROM blocks
WHERE type = 'd'
ORDER BY updated DESC
LIMIT 20;

可以把“列排序”设置为：

content,hpath,updated,created,box,tag

如果不想直接展示内部 ID，可以把“隐藏字段”设置为：

id

常用字段

组件会把思源数据库的英文列名转换成更易读的中文表头。

其他可用字段还包括 name、alias、memo、fcontent、length、subtype、ial 和 sort。只有在确实需要时才加入查询，表格列越少越容易阅读。

列排序与隐藏字段

• “列排序”支持中文逗号或英文逗号分隔，可以填写原始英文列名，也可以填写转换后的中文列名。
• “隐藏字段”同样用逗号分隔。为了避免字段名混淆，优先填写 id、path、ial 这类原始英文列名。
• 没有写进“列排序”的字段不会消失，而是排在已指定字段之后。
• 查询 created 或 updated 时，组件会自动格式化为年月日和时分秒。

SQL 学习资料

思源 SQL 实用参考

补充常见查询场景和使用思路。

siyuannote.com

↗

需要核对字段定义时，可以查看 思源数据库表结构参考↗。

三、可视化图表工作台 👑

5.0 版的可视化图表不再只是进度条或标签云，而是一个可以连接多种数据源的图表工作台。

打开并连接数据

添加可视化图表后，右键组件选择 打开图表工作台。在“数据”页选择数据来源：

• 思源数据库：填写数据库块 ID 或属性视图 ID；
• SQL 结果：输入查询语句；
• 文档信息：按笔记本、标题关键词和排序读取；
• 笔记标签：读取标签名称和引用数量；
• 手动数据：粘贴 JSON 或 CSV。

数据加载后，工作台会显示实时预览。数据库、SQL 和文档数据还可以设置自动刷新间隔。

选择图表和映射字段

工作台支持：

• 趋势：折线图、面积图；
• 比较：柱状图、横向条形图；
• 进度：进度图；
• 占比：饼图、环形图；
• 关系：散点图、雷达图；
• 高级：热力图、漏斗图、仪表盘；
• 层级：矩形树图、旭日图；
• 文本：词云。

在“字段”页选择分类、名称、数值或多指标字段。可以使用自动映射，也可以手动指定。数据处理还支持计数、求和、平均值、最小值、最大值、排序、数量限制和空值处理。

外观与交互

“外观”页用于设置标题、颜色、图例、坐标轴和当前图表的专属样式。“动态”页可以设置自动刷新、动画、提示框、缩放和保存图片工具。

调整完成后点击 保存图表。之后仍可从组件右键菜单重新打开工作台，不需要重新添加组件。

四、统计卡片 👑

统计卡片用于突出一个数字。它不负责展示明细，而是让你进入主页时立刻看到某个关键指标，例如总字数、未完成任务或今日截止任务。

可调整的样式

• 标题文字、标题大小和标题颜色。
• 数字大小和数字颜色。
• 统计类型。
• 选择“SQL 查询结果数”时使用的自定义 SQL。

当前统计类型

“SQL 查询结果数”统计的是查询返回的行数，适合制作“本月新建文档”“带有某标签的资料”“等待处理的项目”等自定义指标。

数字为空或不更新

除自定义 SQL 外，多数统计类型依赖插件的统计索引。如果首次添加后没有数据，或批量迁移文档后数字明显不正确，请进入“主页设置 → 检索管理”刷新或重建索引，再重新载入主页。

组合示例