登录注册

思源笔记丨动态图标使用笔记

思源笔记 v3.1.11 支持了动态图标：Add internal kernel API `/api/icon/getDynamicIcon` by Achuan-2 · Pull Request #12939 · siyuan-note/siyuan

这篇帖子分享下如何用链接传参的方式使用动态图标，选择图标样式、颜色等。v3.1.11 版本还不支持文档图标设置动态图标，可以期待下之后能支持这个功能（见文档图标支持使用动态图标 · Issue #12943 · siyuan-note/siyuan）

参数

目前有 8 种 color 和 8 种 type

type：图标类型，默认为 1
- type=1：显示年月日星期
- type=2：显示年月日
- type=3：仅显示年月
- type=4：仅显示年
- type=5：当前周数
- type=6：仅返回星期
- type=7：倒数日
- type=8：文字图标
lang：默认为当前思源笔记使用的语言，仅在 type=1、2、3、5、6、7 时有效
- lang=zh_CN：显示中文简体
- lang=zh_CHT：显示中文繁体
- lang=en_US/lang=en_ES：显示英文
- 其他语言用英文显示
color：设置配色，一共八种配色
- color=red
- color=blue
- color=yellow
- color=green
- color=purple
- color=pink
- color=orange
- color=grey
支持通过 color=FE3427 或 color=%23FE3427 设置自定义颜色（注意：直接输出 color=#FE3427，会由于 # 是 URL 特殊符号，导致 URL 被截断，会使得参数不起作用）
```
![](api/icon/getDynamicIcon?color=FE3427&type=3)
```
date: 设置日期，默认为当前日期，日期设置格式为 yyyy-mm-dd，仅在 type=1-7 时有效
weekdayType: 设置星期格式，默认为第一种类型，仅在 type=1、6 时有效
- 中文
  - weekdayType=1："周日", "周一", "周二", "周三", "周四", "周五", "周六"
  - weekdayType=2："周天", "周一", "周二", "周三", "周四", "周五", "周六"
  - weekdayType=3："星期日", "星期一", "星期二", "星期三", "星期四", "星期五", "星期六"
  - weekdayType=4："星期天", "星期一", "星期二", "星期三", "星期四", "星期五", "星期六
- 英文
  - weekdayType=1："Sun","Mon","Tue","Wed","Thu","Fri","Sat"
  - weekdayType=2："SUN","MON","TUE","WED","THU","FRI","SAT"
  - weekdayType=3："Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"
  - weekdayType=4："SUNDAY","MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY"
content：设置文字图标的内容，默认为空，仅在 type=8 时有效

注意 content 输入下面特殊符号，需要用 URL 编码替代，否则导致解析参数失败或丢失
- %: %25
- +: %2B
- #: %23

使用

如果是在思源笔记内部使用（不用外部软件打开），可以直接用 api/icon/getDynamicIcon 后添加 type、color、lang、date/content 等参数，例如 api/icon/getDynamicIcon?color=red&type=7&lang=zh_CN

外部使用需要添加 ip 地址和端口，如 http://127.0.0.1:6806/api/icon/getDynamicIcon

示例

type=1：显示年月日星期

默认显示今天的日期。

可通过 date=2024-10-27 指定显示的日期

![](api/icon/getDynamicIcon?color=red&lang=zh_CN&date=2024-10-27)
![](api/icon/getDynamicIcon?color=red&lang=en_US_US&date=2024-10-27)

type=2：显示年月日

![](api/icon/getDynamicIcon?type=2&color=red&lang=&date=2024-10-27)
![](api/icon/getDynamicIcon?type=2&color=red&lang=en_US&date=2024-10-27)

type=3：仅显示年月

![](api/icon/getDynamicIcon?type=3&color=red&lang=zh_CN&date=2024-10-27)
![](api/icon/getDynamicIcon?type=3&color=red&lang=en_US&date=2024-10-27)

type=4：仅显示年

![](api/icon/getDynamicIcon?type=4&color=red&lang=zh_CN&date=2024-10-27)

type=5：当前周数

![](api/icon/getDynamicIcon?type=5&color=red&lang=zh_CN&date=2024-10-27)

![](api/icon/getDynamicIcon?type=5&color=red&lang=en_US&date=2024-10-27)

type=6：仅返回星期

不输入 color 的话，默认星期一到星期五为红色，星期六和星期日为蓝色

![](api/icon/getDynamicIcon?type=6&lang=en_US&date=2024-10-21 "星期一")

![](api/icon/getDynamicIcon?type=6&lang=en_US&date=2024-10-22 "星期二")

![](api/icon/getDynamicIcon?type=6&lang=en_US&date=2024-10-23 "星期三")

![](api/icon/getDynamicIcon?type=6&lang=en_US&date=2024-10-24 "星期四")

![](api/icon/getDynamicIcon?type=6&lang=en_US&date=2024-10-25 "星期五")

![](api/icon/getDynamicIcon?type=6&lang=en_US&date=2024-10-26 "星期六")

![](api/icon/getDynamicIcon?type=6&lang=en_US&date=2024-10-27 "星期日")

指定 color

![](api/icon/getDynamicIcon?type=6&lang=en_US&date=2024-10-21&color=red "星期一")

![](api/icon/getDynamicIcon?type=6&lang=zh_CN&date=2024-10-22&color=blue "星期二")

![](api/icon/getDynamicIcon?type=6&lang=zh_CN&date=2024-10-23&color=green "星期三")

![](api/icon/getDynamicIcon?type=6&lang=zh_CN&date=2024-10-24&color=yellow "星期四")

![](api/icon/getDynamicIcon?type=6&lang=zh_CN&date=2024-10-25&color=purple "星期五")

![](api/icon/getDynamicIcon?type=6&lang=zh_CN&date=2024-10-26&color=pink "星期六")

![](api/icon/getDynamicIcon?type=6&lang=zh_CN&date=2024-10-27&color=grey "星期日")

type=7：倒数日

该图标会显示当前日期与指定日期之间的天数。

支持 lang=en_US 修改为英文：

已过 用 Past 表示。
还有 用 Left 表示。

![](api/icon/getDynamicIcon?color=red&date=2024-10-22&type=7&lang=zh_CN)
![](api/icon/getDynamicIcon?color=red&date=2024-10-22&type=7&lang=en_US)

![](api/icon/getDynamicIcon?color=red&type=7&lang=zh_CN)
![](api/icon/getDynamicIcon?color=red&type=7&lang=en_US)

![](api/icon/getDynamicIcon?color=red&date=2025-10-26&type=7&lang=zh_CN)
![](api/icon/getDynamicIcon?color=red&date=2025-10-26&type=7&lang=en_US)

type=8：文字图标

该图标可以显示文字。

![](api/icon/getDynamicIcon?type=8&content=知乎&color=blue)
![](api/icon/getDynamicIcon?type=8&content=GREAT&color=red)

如何在 dailynote 模板中设置动态图标，创建 dailynote 自动添加图标？

v3.1.11 还不支持文档图标支持使用动态图标

之后等这个功能实现了，就可以在 dailynote 模板后面添加下面这段代码，应该就能让 dailynote 自动添加上指定的动态文档图标了。

.action{/* 获取今天日期和星期 */}
.action{$today := now | date "2006-01-02" }
.action{$weekday := now | date "Mon" }
.action{/* 工作日用红色图标，周末用蓝色图标 */}
.action{$color := "red"}
.action{if or (eq $weekday "Sat")  (eq $weekday "Sun") }
.action{$color = "blue"}
.action{else} 
.action{$color = "red"}
.action{end} 
.action{/* 设置文档图标：选择type6，仅返回星期样式 */}
{: icon="api/icon/getDynamicIcon?type=6&date=.action{$today}&color=.action{$color}"   type="doc"}

‍

思源笔记

思源笔记是一款隐私优先的个人知识管理系统，支持完全离线使用，同时也支持端到端加密同步。

融合块、大纲和双向链接，重构你的思维。
22328 引用 • 89350 回帖

2 操作

Achuan-2 在 2024-11-17 21:34:37 更新了该帖

Achuan-2 在 2024-11-09 19:04:51 更新了该帖

Achuan-2 2 周前上海位置

10 感谢

1 关注

12 收藏

2 赞同

2 操作

18 回帖

362 329 30 3

欢迎来到这里！

我们正在构建一个小众社区，大家在这里相互信任，以平等 • 自由 • 奔放的价值观进行分享交流。最终，希望大家能够找到与自己志同道合的伙伴，共同成长。

注册关于

请输入回帖内容 ...

pakeh2866 • 2 周前
付费者

阿川好，有没有实例展示一下，大家可以更方便了解这个可以怎么用？

3 回复
Wetoria • 2 周前
订阅者付费者捐赠者

理解成思源里提供了一个生成这种图片的方式就行。所有显示图片的地方都能这么用。

那些参数是用来控制显示效果的。
YRJ0422 • 2 周前
付费者

文中有案例演示，直接复制到思源中即可，根据提供的具体字段进行修改使用。现在还不支持在文档图标中添加，等下个版本出来就可以根据模板自动设置日记的图标了，感谢阿川开发，太好看了。

1 回复
Achuan-2 • 2 周前
订阅者先知作者

把我文中的代码块直接粘贴到思源笔记，就能用了，其实就是图片链接改成 api 地址，具体更改日期修改 date 参数、颜色修改 color 参数

我录制的视频：【思源笔记丨本地也能使用的动态图标！如何使用？-哔哩哔哩】 https://b23.tv/sqNNiEq
Achuan-2 • 2 周前
订阅者先知作者

大家喜欢就好哈哈
YRJ0422 • 1 周前 • 1
付费者

思源 3.1.12 Dev2 测试的时候发现模版不能用原因是代码复制到论坛吞了一块

更正：去掉 amp；即可，上述方式存在 BUG 会导致文档树和文档内颜色不一致

1 操作
YRJ0422 在 2024-11-11 11:31:15 更新了该回帖

Achuan-2 • 1 周前

订阅者先知作者

写了一个脚本，可以用 python 脚本批量更改 dailynote、月份、年、周复盘的图标为动态图标

日记：格式“20241109 Sat”

import json
import re
import os


def update_sy_file(file_path):
    # 读取 .sy 文件内容
    with open(file_path, "r", encoding="utf-8") as file:
        content = file.read()

    # 解析 JSON 数据
    data = json.loads(content)

    # 使用正则表达式提取 title 中的日期
    title = data.get("Properties", {}).get("title", "")
    match = re.match(r"^(\d{4})(\d{2})(\d{2})\s\w{3}$", title)
    if match:
        year, month, day = match.groups()
        formatted_date = f"{year}-{month}-{day}"
        # 更新 icon 属性
        new_icon = f"api/icon/getDynamicIcon?type=6&color=red&date={formatted_date}"
        data["Properties"]["icon"] = new_icon

        # 将更新后的数据写回文件
        with open(file_path, "w", encoding="utf-8") as file:
            json.dump(data, file, ensure_ascii=False)
        print(f"Updated icon for file: {file_path}")


def process_directory(directory_path):
    # 遍历目录及其子目录中的所有文件
    for root, _, files in os.walk(directory_path):
        for file in files:
            if file.endswith(".sy"):
                file_path = os.path.join(root, file)
                update_sy_file(file_path)


# 使用示例
process_directory(r"D:\Notes\Siyuan\Achuan-2\data\20241028223345-d9ifjv0")

月：格式“202411”

import json
import re
import os


def update_sy_file(file_path):
    # 读取 .sy 文件内容
    with open(file_path, "r", encoding="utf-8") as file:
        content = file.read()

    # 解析 JSON 数据
    data = json.loads(content)

    # 使用正则表达式提取 title 中的日期
    title = data.get("Properties", {}).get("title", "")
    match = re.match(r"^(\d{4})(\d{2})$", title)
    if match:
        year, month = match.groups()
        formatted_date = f"{year}-{month}-01"
        # 更新 icon 属性
        new_icon = f"api/icon/getDynamicIcon?type=3&date={formatted_date}"
        data["Properties"]["icon"] = new_icon

        # 将更新后的数据写回文件
        with open(file_path, "w", encoding="utf-8") as file:
            json.dump(data, file, ensure_ascii=False)
        print(f"Updated icon for file: {file_path}")

def process_directory(directory_path):
    # 遍历目录及其子目录中的所有文件
    for root, _, files in os.walk(directory_path):
        for file in files:
            if file.endswith(".sy"):
                file_path = os.path.join(root, file)
                update_sy_file(file_path)


# 使用示例
process_directory(r"D:\Notes\Siyuan\Achuan-2\data\20241028223345-d9ifjv0")

年：格式“2024”

import json
import re
import os


def update_sy_file(file_path):
    # 读取 .sy 文件内容
    with open(file_path, "r", encoding="utf-8") as file:
        content = file.read()

    # 解析 JSON 数据
    data = json.loads(content)

    # 使用正则表达式提取 title 中的日期
    title = data.get("Properties", {}).get("title", "")
    match = re.match(r"^(\d{4})$", title)
    if match:
        year,= match.groups()
        formatted_date = f"{year}-01-01"
        # 更新 icon 属性
        new_icon = f"api/icon/getDynamicIcon?type=4&date={formatted_date}"
        data["Properties"]["icon"] = new_icon

        # 将更新后的数据写回文件
        with open(file_path, "w", encoding="utf-8") as file:
            json.dump(data, file, ensure_ascii=False)
        print(f"Updated icon for file: {file_path}")



def process_directory(directory_path):
    # 遍历目录及其子目录中的所有文件
    for root, _, files in os.walk(directory_path):
        for file in files:
            if file.endswith(".sy"):
                file_path = os.path.join(root, file)
                update_sy_file(file_path)


# 使用示例
process_directory(r"D:\Notes\Siyuan\Achuan-2\data\20241028223345-d9ifjv0")

1 回复

iqeq • 1 周前
付费者

通过 svg 参数动态修改图标，非常好的思路，感谢分享，期待新版可以直接把 API 输入方式添加一个按钮，方便普通用户使用。

1 回复

1 操作
iqeq 在 2024-11-10 10:44:08 更新了该回帖
Achuan-2 • 1 周前
订阅者先知作者

dev 版本已经有按钮了

White-Night-Dream • 1 周前 • 1 赞同

付费者

补一个默认设置的脚本

日记：格式“2024-11-10”

import json
import re
import os


def update_sy_file(file_path):
    # 读取 .sy 文件内容
    with open(file_path, "r", encoding="utf-8") as file:
        content = file.read()

    # 解析 JSON 数据
    data = json.loads(content)

    # 使用正则表达式提取 title 中的日期
    title = data.get("Properties", {}).get("title", "")
    match = re.match(r"^(\d{4})-(\d{2})-(\d{2})$", title)
    if match:
        year, month, day = match.groups()
        formatted_date = f"{year}-{month}-{day}"
        # 更新 icon 属性
        new_icon = f"api/icon/getDynamicIcon?type=6&color=red&date={formatted_date}"
        data["Properties"]["icon"] = new_icon

        # 将更新后的数据写回文件
        with open(file_path, "w", encoding="utf-8") as file:
            json.dump(data, file, ensure_ascii=False)
        print(f"Updated icon for file: {file_path}")


def process_directory(directory_path):
    # 遍历目录及其子目录中的所有文件
    for root, _, files in os.walk(directory_path):
        for file in files:
            if file.endswith(".sy"):
                file_path = os.path.join(root, file)
                update_sy_file(file_path)


# 使用示例
process_directory(r"D:\1STUDY\SIYUAN\data\20231007210051-jpydsvc")

月：格式“11”

import json
import re
import os


def update_sy_file(file_path):
    # 读取 .sy 文件内容
    with open(file_path, "r", encoding="utf-8") as file:
        content = file.read()

    # 解析 JSON 数据
    data = json.loads(content)

    # 使用正则表达式提取 title 中的日期
    title = data.get("Properties", {}).get("title", "")
    # path = data.get("Path", "")


    match = re.match(r"^(\d{2})$", title)  # 匹配2位数字的月份
    if match:
        month = match.group(1)  # 使用group(1)而不是groups(1)
        formatted_date = f"{whatyear}-{month}-01"
        # 更新 icon 属性
        new_icon = f"api/icon/getDynamicIcon?type=3&date={formatted_date}"
        data["Properties"]["icon"] = new_icon

        # 将更新后的数据写回文件
        with open(file_path, "w", encoding="utf-8") as file:
            json.dump(data, file, ensure_ascii=False)
        print(f"Updated icon for file: {file_path}")

def process_directory(directory_path):
    # 只遍历当前目录下的文件，不递归进入子目录
    for item in os.listdir(directory_path):
        full_path = os.path.join(directory_path, item)
        if os.path.isfile(full_path) and item.endswith('.sy'):
            update_sy_file(full_path)

whatyear = "2023"
# 使用示例
process_directory(r"D:\1STUDY\SIYUAN\data\20231007210051-jpydsvc\20231212180155-4yzi6wx\20231212180155-jzvvkz7")# 2024

White-Night-Dream • 1 周前

付费者

或者也可自定义颜色

日记：格式“2024-11-10”

import json
import re
import os
from datetime import datetime


def update_sy_file(file_path):
    # 读取 .sy 文件内容
    with open(file_path, "r", encoding="utf-8") as file:
        content = file.read()

    # 解析 JSON 数据
    data = json.loads(content)

    # 使用正则表达式提取 title 中的日期
    title = data.get("Properties", {}).get("title", "")
    match = re.match(r"^(\d{4})-(\d{2})-(\d{2})$", title)
    if match:
        year, month, day = match.groups()
        formatted_date = f"{year}-{month}-{day}"

        # 获取日期对应的星期几
        date_obj = datetime.strptime(formatted_date, "%Y-%m-%d")
        weekday = date_obj.weekday()  # 星期一是0，星期日是6

        # 根据星期几设置颜色
        colors = ["E55D3B", "FFA95C", "FAD155", "8BC34A", "5BC0DE", "5FADE2", "C481BD"]
        color = colors[weekday]

        # 更新 icon 属性
        new_icon = f"api/icon/getDynamicIcon?type=6&color={color}&date={formatted_date}&lang=zh_CN&weekdayType=1"
        data["Properties"]["icon"] = new_icon

        # 将更新后的数据写回文件
        with open(file_path, "w", encoding="utf-8") as file:
            json.dump(data, file, ensure_ascii=False)
        print(f"Updated icon for file: {file_path}")


def process_directory(directory_path):
    # 遍历目录及其子目录中的所有文件
    for root, _, files in os.walk(directory_path):
        for file in files:
            if file.endswith(".sy"):
                file_path = os.path.join(root, file)
                update_sy_file(file_path)


# 使用示例
process_directory(r"D:\1STUDY\SIYUAN\data\20231007210051-jpydsvc")

月：格式“11”

import json
import re
import json
import re
import os


def update_sy_file(file_path):
    # 读取 .sy 文件内容
    with open(file_path, "r", encoding="utf-8") as file:
        content = file.read()

    # 解析 JSON 数据
    data = json.loads(content)

    # 使用正则表达式提取 title 中的日期
    title = data.get("Properties", {}).get("title", "")
    # path = data.get("Path", "")


    match = re.match(r"^(\d{2})$", title)  # 匹配2位数字的月份
    if match:
        month = match.group(1)  # 使用group(1)而不是groups(1)
        formatted_date = f"{whatyear}-{month}-01"

        # 定义每个月份对应的颜色
        month_colors = {
            "01": "FFFF99",  # 正月-黄白游
            "02": "A64236",  # 二月-朱草
            "03": "422166",  # 三月-凝夜紫
            "04": "C25160",  # 四月-唇脂
            "05": "D5DBAA",  # 五月-筠雾碧
            "06": "E3B1C3",  # 六月-夕岚
            "07": "88B5DA",  # 七月-窃蓝
            "08": "F5F2EA",  # 八月-凝脂
            "09": "941D24",  # 九月-朱樱
            "10": "DC82A7",  # 十月-龙膏烛
            "11": "E7CCE7",  # 十一月-银红
            "12": "92BCC6",  # 十二月-青白玉
        }

        # 获取对应月份的颜色
        color = month_colors.get(month, "#FFFFFF")  # 默认颜色为白色

        # 更新 icon 属性
        new_icon = f"api/icon/getDynamicIcon?type=3&date={formatted_date}&color={color}"
        data["Properties"]["icon"] = new_icon

        # 将更新后的数据写回文件
        with open(file_path, "w", encoding="utf-8") as file:
            json.dump(data, file, ensure_ascii=False)
        print(f"Updated icon for file: {file_path}")

def process_directory(directory_path):
    # 只遍历当前目录下的文件，不递归进入子目录
    for item in os.listdir(directory_path):
        full_path = os.path.join(directory_path, item)
        if os.path.isfile(full_path) and item.endswith('.sy'):
            update_sy_file(full_path)

whatyear = "2024"
# 使用示例
process_directory(r"D:\1STUDY\SIYUAN\data\20231007210051-jpydsvc\20231212180155-4yzi6wx\20231230220908-wq15x5o")# 2024

White-Night-Dream • 1 周前

付费者

我用模板无法设置图标

.action{/* 获取今天日期和星期 */}
.action{ $today := now | date "2006-01-02" }
.action{ $weekday := now | date "Mon" }

.action{/* 定义每个星期几对应的颜色 */}
.action{ $weekdayColors := dict "Mon" "E55D3B" "Tue" "FFA95C" "Wed" "FAD155" "Thu" "8BC34A" "Fri" "5BC0DE" "Sat" "5FADE2" "Sun" "C481BD" }

.action{/* 获取当前星期的颜色 */}
.action{ $color := index $weekdayColors $weekday }

.action{/* 设置文档图标：选择type6，仅返回星期样式 */}
{: icon="api/icon/getDynamicIcon?type=6&date=.action{ $today }&color=.action{ $color }" type="doc"}

jiusii • 3 天前

大佬，：倒数日的

![](api/icon/getDynamicIcon/getDynamicIcon?color=red&date=2025-10-26&type=7&lang=zh_CN)
![](api/icon/getDynamicIcon/getDynamicIcon?color=red&date=2025-10-26&type=7&lang=en_US)

两个代码不可以用了，加载不出来。版本 3.11

1 回复

Achuan-2 • 3 天前

订阅者先知作者

![](api/icon/getDynamicIcon?color=red&date=2025-10-26&type=7&lang=zh_CN)
![](api/icon/getDynamicIcon?color=red&date=2025-10-26&type=7&lang=en_US)

getDynamicIcon 打多了，这样应该就可以

ONIONLYONE • 1 天前
付费者捐赠者

为啥更新之后模板添加代码没有图标呀

1 回复
Achuan-2 • 1 天前
订阅者先知作者

看看你的模板

可以直接在文档里调用模板，看看有没有报错

1 回复
ONIONLYONE • 1 天前
付费者捐赠者

佬，代码没问题，我正常创建日记有显示图标，但通过日历面板这个插件创建日历就不行

1 回复
Achuan-2 • 1 天前
订阅者先知作者

插件问题，插件没有添加图标的功能

请输入回帖内容 ...

Achuan-2

给时间以生命而不是给生命以时间，如果你喜欢我的分享，欢迎给我买杯咖啡 https://www.yuque.com/achuan-2 上海

回帖

815

帖子

226

积分

592

思源笔记丨动态图标使用笔记

参数

使用

示例

type=1：显示年月日星期

type=2：显示年月日

type=3：仅显示年月

type=4：仅显示年

type=5：当前周数

type=6：仅返回星期

type=7：倒数日

type=8：文字图标

如何在 dailynote 模板中设置动态图标，创建 dailynote 自动添加图标？

相关帖子

请大家一起补充一下思源隐藏的快捷键

导出 pdf 的时候只有第一个

思源笔记剪藏问题

PC 端思源为啥不支持中文符号

提及内容为啥没有颜色标记了

获取内核服务端口失败 20241121

为什么付款了没发激活码

欢迎来到这里！

我用模板无法设置图标