Alby's blog

世上没有巧合，只有巧合的假象。

0%

发表于 更新于 分类于

一、概述

用常规编程语言绘制图表的工具非常多且功能强大，比如 matplotlib 就几乎能绘制所有类型的二维图表，甚至可以做一定程度的三维绘图。
但是，如果要使用 ChatGPT、DeepSeek、Qwen3 等 LLM 来一次性正确地生成绘制代码，声明式图表语言（Declarative Diagram Languages）可能是更好的选择。
再加上需从“对 Pandoc 友好”、“配置难度”等方面考虑，相较而言最合适的是 Mermaid。

语言/工具 Pandoc 支持度 Markdown 支持度 配置难度 适合场景 备注
Mermaid 通过过滤器（mermaid-filter）或 CLI 高，许多 Markdown 编辑器原生支持 中，需安装 Node.js 和 mermaid-cli 流程图、时序图、类图、甘特图 语法简洁，多图表类型，现代且广泛应用
Graphviz DOT 原生支持代码块 + pandoc-graphviz 过滤器 中，需插件或预先渲染图片嵌入 低，安装 graphviz 即可 复杂流程图、网络图、层次结构图 自动布局优良，图结构复杂时首选
PlantUML 通过 pandoc-plantuml 过滤器调用 Java 中，部分 Markdown 编辑器支持插件 较高，需 Java 环境及 PlantUML UML 建模（类图、时序图、用例图等） 专业 UML 设计工具，适合软件设计文档
WebSequenceDiagrams 无原生支持，需手动生成图像插入 低，需插入生成的图片链接 低，在线使用即可 简单时序图，快速在线生成 依赖网络，适合临时绘图
Ditaa 通过 pandoc-ditaa 过滤器支持 低，需转换为图片插入 低，Java 环境，轻量 ASCII 艺术风格简单流程图、小示意图 轻量快速，风格独特，适合纯文本环境

阅读全文 »

发表于 分类于

一、准备工作

1、安装 node

1
brew install node

可以不预先安装 meson(ninjia) 和 flatc, 编译时会自动使用 pip 安装。故需确保安装了 python3 。

2、获取源码并安装 node 包

1
2
3
4
5
# 当前目录：/Users/alby/Workspace/OpenSource/Multimedia/versatica
git clone https://github.com/versatica/mediasoup
cd mediasoup
# 如果不关心 node 部分，可以不运行下行。
npm i
阅读全文 »

发表于 分类于

曾好几次尝试在 Hexo 中使用 hexo-math、hexo-renderer-markdown-it-plus 等包以支持 LaTeX 皆不成功，要么不行要么错乱。刚刚了解到如果使用 NexT 主题的话则不需要手工安装任何包。本文是一篇备忘录。

hexo: 7.0.0
hexo-theme-next: 7.8.0

阅读全文 »

发表于 分类于

一、概述

在 ASP.NET 或 ASP.NET Core 中，如果服务端得到一个 JSON 字符串(比如从 Redis 缓存中获取)，我们可以通过 Content 方法或直接创建 ContentResult 对象来作为 Action 的返回值。

1
2
var json = "{\"key\": \"value\"}";
return Content(json, "application/json");
1
2
3
4
5
return new ContentResult
{
    Content = json,
    ContentType = "application/json"
};

而在 SignalR 中，在 ASP.NET Core 7.0 之前，对于一个 JSON 字符串只能先反序列化，否则 Web 前端得用 JSON.parse() 处理一次。

本文主要记录测试 RawResult 的结果。

阅读全文 »

发表于 更新于 分类于

一、概述

PUT 和 PATCH 方法用于更新现有资源。 它们之间的区别是，PUT 会替换整个资源，而 PATCH 仅指定更改。

在 ASP.NET Core Web API 中，由于 C# 是一种静态语言(dynamic 在此不表)，当我们定义了一个类型用于接收 HTTP Patch 请求参数的时候，在 Action 中无法直接从实例中得知客户端提供了哪些参数。

比如定义一个输入模型和数据库实体：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
public class PersonInput
{
    public string? Name { get; set; }

    public int? Age { get; set; }

    public string? Gender { get; set; }
}

public class PersonEntity
{
    public string Name { get; set; }

    public int Age { get; set; }

    public string Gender { get; set; }
}

再定义一个以 FromForm 形式接收参数的 Action:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
[HttpPatch]
[Route("patch")]
public ActionResult Patch([FromForm] PersonInput input)
{
    // 测试代码暂时将 AutoMapper 配置放在方法内。
    var config = new MapperConfiguration(cfg =>
    {
        cfg.CreateMap<PersonInput, PersonEntity>());
    });
    var mapper = config.CreateMapper();

    // entity 从数据库读取，这里仅演示。
    var entity = new PersonEntity
    {
        Name = "姓名", // 可能会被改变
        Age = 18, // 可能会被改变
        Gender = "我可能会被改变",
    };

    // 如果客户端只输入 Name 字段，entity 的 Age 和 Gender 将不能被正确映射或被置为 null。
    mapper.Map(input, entity);

    return Ok();
}
1
2
curl --location --request PATCH 'http://localhost:5094/test/patch' \
--form 'Name="foo"'

如果客户端只提供了 Name 而没有其他参数，从 HttpContext.Request.Form.Keys 可以得知这一点。如果不使用 AutoMapper，那么就需要使用丑陋的判断：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
[HttpPatch]
[Route("patch")]
public ActionResult Patch([FromForm] PersonInput input)
{
    var keys = _httpContextAccessor.HttpContext.Request.Form.Keys.Select(m => m.ToLower());
    var entity = new PersonEntity
    {
        Name = "姓名", // 可能会被改变
        Age = 18, // 可能会被改变
        Gender = "我可能会被改变",
    };

    if (keys.Contains("name"))
    {
        // 更新 Name(这里忽略合法性判断)
        entity.Name = input.Name!;
    }
    if (keys.Contains("age"))
    {
        // 更新 Age(这里忽略合法性判断)
        entity.Age = input.Age!.Value;
    }
    // ... 其他判断
    return Ok();
}

本文提供一种方式来简化这个步骤。

阅读全文 »