什么是 HTTP 基本认证

对于部署的一些纯前端系统，本身并没有内置用户校验。但是我们又不希望其他用户能无限制使用，所以希望能有简单的用户校验流程。这就需要用到 HTTP Basic Authentication (HTTP 基本认证) 。

HTTP 基本认证是一种非常简单的认证机制，广泛用于保护 Web 应用的资源。它通过 HTTP Header 传递用户名和密码，并通过 Base64 编码对其进行简单的编码（注意：不是加密）。实际应用中需要配合 HTTPS 使用，以防止明文凭据在网络中被拦截。

HTTP 基本认证的交互流程

1. 客户端请求资源：客户端向服务器发起请求，但未包含认证信息。
2. 服务器返回 401 响应：服务器返回 401 Unauthorized 状态码，同时通过 WWW-Authenticate 头提示客户端需要提供凭证。
3. 客户端提示输入凭证：客户端向用户请求输入用户名和密码。
4. 客户端发送认证信息：客户端将用户名和密码通过 Base64 编码后，添加到 HTTP Header 的 Authorization
5. 服务器验证凭证：服务器解码并验证用户名和密码的正确性。
6. 服务器返回响应：
   • 如果验证成功，返回 200 OK 和资源。
   • 如果验证失败，返回 401 Unauthorized 并要求重新认证。

下面我们用 curl 命令的交互来看下整个流程能更加清晰，可以使用参数-u 来指定用户名和密码，而实际处理中会对用户名和密码计算 MD5，并填充到 Authorization 的 Header 中。

curl --verbose "https://some.examples.com"

> GET / HTTP/1.1
> Accept: */*
>
< HTTP/1.1 401 Unauthorized
< WWW-Authenticate: Basic realm="Need Authorization"

curl -u user:pwd --verbose "https://some.examples.com"
> GET / HTTP/1.1
> Authorization: Basic Base64ByUserAndPwd
> Accept: */*
>
< HTTP/1.1 200 OK

我们再来看下浏览器中访问效果，对于返回需要校验的网站，浏览器会弹出一个弹框，要求输入用户名和密码：

如何在 Nginx 中配置 HTTP 基本认证

创建用户凭据文件

1. 安装 htpasswd 工具：

   apt-get install apache2-utils

2. 创建新用户，执行命令后输入密码

   cd /etc/nginx/conf.d/
   
   htpasswd -c ./auth.htpasswd username

3. 设置文件权限，设置文件所有者和nginx的执行用户一致

   chmod 600 auth.htpasswd
   chown xx:xx auth.htpasswd

4. 可以本地校验下

   htpasswd -v ./auth.htpasswd username

配置nginx

配置较为简单，只要增加auth_basic和auth_basic_user_file就好了

location / {
    auth_basic "Need Authorization";  # 认证提示内容，显示取决于客户端实现
    auth_basic_user_file /etc/nginx/conf.d/auth.htpasswd

    # 其他的配置
}

配置完成后，重新加载下nginx的配置

systemctl reload nginx

测试访问

可以在浏览器中输入网址，访问验证下是否有弹出一个认证窗口，提示用户输入用户名和密码。验证成功后，服务器将正常返回资源，否则会要求重新输入用户名和密码。如果浏览器关闭重新打开后，会要求重新输入。

如何无感登录

增加了这一步骤的确是更安全了，但是每次打开页面需要输入一遍用户名和密码，这又带来了很大的不便。我们可以通过浏览器自带的密码保存，在下次要求认证的时候，直接按登录按钮就好了。

有没有可能更进一步，连登录按钮也不用按，在可信任的电脑上默认帮我登录呢。BitWarden 还真提供了这样的功能，能隐藏式自动填充用户名和密码的功能，这样对使用者就完全无感了。理论上还有种方式可以通过浏览器的插件来直接设置Header。

总结

HTTP 基本认证算是一种最简单有效的认证方式，如果需要更复杂的认证机制，可以考虑其他方式，如 OAuth、JWT 或基于 Session 的认证。

大型模型虽然功能强大，但并非无所不能。自从OpenAI推出工具调用功能后，大型模型的能力边界得到了极大的提升，但这并不是一种通用的解决方案。MCP的出现让我们看到了一种统一和扩展大型模型能力的可能性，特别是在OpenAI宣布全面支持MCP后，这一技术获得了市场的普遍认可。本文致力于通过分享一系列实际案例，让你更深入地理解MCP能够做什么。

获取各旅游城市近期天气情况

低效的传统方案

传统方案不仅耗时费力（通常需要 1 小时以上），还存在较高的人为操作错误风险：

1. ​ 收集城市列表：通过百度搜索手动整理全国旅游城市名录
2. ​ 采集天气数据 ​：逐个访问天气网站，复制粘贴各城市气象数据
3. 整理数据结果：将零散数据手工整理为结构化表格或 PPT

虽然开发人员可通过编写爬虫或调用 API 优化第 2 步，但面对一次性需求时，代码开发调试的时间成本往往又难以覆盖收益。

AI 工具的初步尝试

使用 kimi、豆包、元宝等 AI 大模型时，尝试直接提问【整理全国各大旅游城市近期天气情况，以表格形式返回)】看似可行。但是由于缺乏实时的天气数据，结果也就缺乏意义了。

MCP 标准化解决方案

如果大模型能帮助我们调用 API，那问题就方便解决了，可以 API 接口形式五花八门，有什么办法能统一 API 接口标准呢。MCP（模型控制协议）通过统一接口标准，完美解决了 API 多样性和任务复杂性的矛盾。

下面我们看下集成了天气查询功能的 MCP 后，大模型的回答变化：

提问 ​： 整理全国主要旅游城市最近的天气情况，以表格形式返回，一个城市一行数据

​ 响应结果 ​（数据已精简）：

查看执行的过程，我们能看到大模型自动发起了多次工具调用，用于查询天气信息。

通过 Cherry-Studio 可直观查看高德地图 MCP 服务的完整能力，天气查询仅是众多标准化接口之一，更主要的是提供路径规划和导航的能力。

API 聚合平台的 MCP 转型实践

看完前面的的例子，有了 MCP 就能自动调用各类 API，而其能力自然也取决于 API 本身。这时候原来的一些 API 聚合平台是不是就能大显身手了。 下面以ALApi为例来展示下整体流程。

常用的 MCP 服务是用 node.js 和 python 服务为主，而事实上语言不会有限制， 我们只要遵循一定标准规范就好，这个 ALApi 的MCP 服务是用 go 实现的。

1. 账号及权限申请

   注册 ALApi 账号，申请 token，申请需要的接口。

2. 服务部署

   编译 MCP 服务，编译成功后会生成mcp-alapi-cn.exe

   git clone "https://github.com/ALAPI-SDK/mcp-alapi-cn.git"
   cd mcp-alapi-cn
   git build

3. 系统集成

   在 Cherry-Studio 中配置 MCP 服务，名称任选，命令填写前面编译来的mlp-alapi-cn.exe全路径，环境变量配置申请的 token 即可。

   如果在 Cline、Claude 等其他客户端中配置的话，可以粘贴下述 json（需要和其他的 mcp 配置合并下）

   {
     "mcpServers": {
       "ALAPI": {
         "name": "ALAPI",
         "type": "stdio",
         "isActive": true,
         "command": "D:\\xxx\\mcp-alapi-cn.exe",
         "args": [],
         "env": {
           "ALAPI_TOKEN": "YOUR_API_TOKEN"
         }
       }
     }
   }

4. 启用 MCP

   配置完成后，Cherry-Studio 中访问的大模型的时候勾选相应的 MCP 服务就可以了

应用场景展示

1. 查询油价：执行了一次工具 (api/oil) 查询

2. 查询汇率：执行了四次工具 (api/exchange) 查询

3. 查询黄金等贵金属价格：

通过这种方式，ALApi 上的所有 API 接口，都可以转换成 MCP 服务为大模型所用了。

背后逻辑

整个流程是如何实现的呢？我们看下代码，可以发现先通过接口 /api/user_apis 获取所有有访问权限的 API 列表（名字、描述、参数列表等），然后将这些 API 依次进行注册。核心注册工具的代码如下：

func (s *Server) registerOpenAPITools(doc *openapi3.T) error {
    toolCount := 0
    for path, item := range doc.Paths.Map() {
        if item.Post != nil {
            tool := mcp.NewTool(path, mcp.WithDescription(item.Post.Summary))
            schema := item.Post.RequestBody.Value.Content["application/json"].Schema

            requiredParams := make(map[string]bool)
            for _, required := range schema.Value.Required {
                requiredParams[required] = true
            }

            for paramName, ref := range schema.Value.Properties {
                description := ref.Value.Description
                if requiredParams[paramName] {
                    mcp.WithString(paramName, mcp.Description(description), mcp.Required())(&tool)
                } else {
                    mcp.WithString(paramName, mcp.Description(description))(&tool)
                }
            }

            s.mcpServer.AddTool(tool, s.wrapHandler(s.handler.Handle))
            toolCount++
        }
    }

    if toolCount == 0 {
        return fmt.Errorf("no tools were registered from the OpenAPI spec")
    }

    return nil
}

总结

MCP 最大的作用是实现了标准化的API接口 ​，建立了统一的交互标准，而更重要的是这一规范得到市场的普遍认可。

最近将博客从 Jekyll 迁移到 Hugo 了，虽然 Valine 评论系统在 Hugo 中可以直接通过配置文件 hugo.toml 进行设置，但在实际使用中发现了一些坑，以下是整理的解决方案。

1. 配置 requiredFields 无效问题

在 Valine 的官方文档中提到，可以通过 requiredFields 配置字段来设置评论时的必填项，比如昵称、邮箱等。然而，在 Hugo 中直接配置后发现该功能无效。

问题原因

Hugo 主题下文件 layouts/partials/comment.html 文件中只针对部分字段进行了处理，而没有对 requiredFields 进行正确处理。

解决方法

将 comment.html 文件复制到项目中相同目录下，然后增加以下代码：

{{- with $valine.requiredFields -}} {{- $commentConfig = dict "requiredFields" .
| dict "valine" | merge $commentConfig -}} {{- end -}}

2. Gravatar 头像显示问题

在配置头像时发现，随机头像无法正常显示，例如以下头像地址。但是将域名替换为 www.gravatar.com 则可以正常显示。
https://gravatar.loli.net/avatar/d41d8cd98f00b204e9800998ecf8427e?d=wavatar&v=1.5.2

问题原因

Gravatar 的中转服务，gravatar.loli.net 存在处理上的问题，导致随机头像无法显示。

解决方法

由于 Gravatar 的官网在国内访问存在较多问题，更换了另一个 Gravatar 的中转服务： cn.gravatar.com。在配置文件中增加 avatar_cdn 之后，发现这个配置不生效。需要增加类似的处理逻辑，修改 comment.html 文件：

{{- with $valine.avatar_cdn -}} {{- $commentConfig = dict "avatar_cdn" . | dict
"valine" | merge $commentConfig -}} {{- end -}}

修改后，Gravatar 头像和随机头像的显示恢复正常，但邮箱为空时随机头像无法随机。

邮箱为空时头像并不会随机

问题原因

获取随机头像的 MD5 是根据邮箱地址进行生成，而邮箱地址为空时其生成的 MD5 是固定的，这也导致获取的也都是固定头像。

解决方法

将 valine.min.js 中的 t.get("mail") 修改为 t.get("mail") || t.get("nick")，即邮箱为空时使用昵称计算随机头像。修改后需要将文件发布到 CDN 才能使用，具体步骤不在此赘述。

QQ 头像和昵称获取问题

在 Valine 中，昵称字段输入 QQ 时，预期是可以获取 QQ 头像和昵称的，但是实际测试的时候却无法正确获取。在 Chrome 的调试窗口，可以看到访问第三方的 API 地址的时候会报错：

https://api.qjqq.cn/api/qqinfo?qq=12345

问题原因

就在写该文章的几天前直接在浏览器中访问这个地址还是正常的，不过会因为跨域问题而导致在 Valine 中无法正常使用。今天访问这个地址，发现这个服务已经无法访问了，页面会跳转到一个 API 服务平台奶思猫。

解决方法

在网站上搜索后，发现有免费的QQ 信息服务接口。这个 API 的回包结构和 Valine 中使用的 api.qjqq.cn 是不一致的。由于原来的接口已经下线，正确的回包结构目前也不清楚。好在现在有强大的 AI，直接把压缩的 JS 代码丢给 AI，它就能分析出原来处理 QQ 头像和昵称的逻辑。

var a = function (e, t) {
  var n = i.default.store.get(o.QQCacheKey);
  n && n.qq == e
    ? t && t(n)
    : i.default
        .ajax({
          url: "https://api.nsmao.net/api/qq/query?key=xx&qq=" + e,
          method: "get",
        })
        .then(function (e) {
          return e.json();
        })
        .then(function (n) {
          if (200 == n.code) {
            var r = n.data.nick,
              a = n.data.avatar,
              u = {
                nick: r,
                qq: e,
                pic: a,
              };
            i.default.store.set(o.QQCacheKey, u), t && t(u);
          }
        });
};

我们有两种方案分别是在客户端直接修改和在服务端进行中转：

方案 1：修改 Valine 中请求的 url 以及回包解析逻辑。方案修改起来很容易，最大的问题是会暴露了密钥。

• 修改请求 URL：api.njqq.cn/api/qqinfo?qq=xxx 修改成 https://api.nsmao.net/api/qq/query?key=xx&qq=
• 修改昵称和头像的获取：{var r=n.name,a=n.imgurl 修改成 {var r=n.data.nick,a=n.data.avatar。

方案 2：后台提供中转服务

通过自己的服务器封装中转接口，避免密钥暴露，接口可以丢给 AI 实现，但需要额外的服务维护成本。

下面是用 golang 实现的获取QQ资料的 HTTP 服务，功能就是将奶思猫提供的 QQ 资料的API接口转换成适配Valine的格式。需要设置下密钥和访问端口。

package main

import (
        "encoding/json"
        "fmt"
        "io/ioutil"
        "log"
        "net/http"
        "os"
)

// APIResponse represents the response from the QQ API
type APIResponse struct {
        Code     int    `json:"code"`
        Msg      string `json:"msg"`
        Data     QQData `json:"data"`
        ExecTime float64 `json:"exec_time"`
        IP       string  `json:"ip"`
}

// QQData represents the data field in the API response
type QQData struct {
        Nick      string `json:"nick"`
        Qid       string `json:"qid"`
        RegTime   string `json:"regTime"`
        Level     int    `json:"level"`
        Avatar    string `json:"avatar"`
        Email     string `json:"email"`
        IsVip     bool   `json:"is_vip"`
        IsYearsVip bool  `json:"is_years_vip"`
        VipLevel  int    `json:"vip_level"`
}

// ClientResponse represents the response we'll send to the client
type ClientResponse struct {
        Code   int    `json:"code"`
        Name   string `json:"name"`
        ImgURL string `json:"imgurl"`
        Email  string `json:"email"`
}

func main() {
        // Get the API key from environment variable or use default
        apiKey := os.Getenv("QQ_API_KEY")
        if apiKey == "" {
                apiKey = "MY_KEY" // Default key for development
        }

        http.HandleFunc("/qq_api/qqinfo", func(w http.ResponseWriter, r *http.Request) {
                // Get QQ number from query parameter
                qqNumber := r.URL.Query().Get("qq")
                if qqNumber == "" {
                        http.Error(w, "Missing qq parameter", http.StatusBadRequest)
                        return
                }

                // Construct the API URL
                apiURL := fmt.Sprintf("https://api.nsmao.net/api/qq/query?key=%s&qq=%s", apiKey, qqNumber)

                // Make the request to the QQ API
                resp, err := http.Get(apiURL)
                if err != nil {
                        log.Printf("Error making request to QQ API: %v", err)
                        http.Error(w, "Failed to fetch QQ information", http.StatusInternalServerError)
                        return
                }
                defer resp.Body.Close()

                // Read the response body
                body, err := ioutil.ReadAll(resp.Body)
                if err != nil {
                        log.Printf("Error reading response body: %v", err)
                        http.Error(w, "Failed to read QQ information", http.StatusInternalServerError)
                        return
                }

                // Parse the API response
                var apiResp APIResponse
                if err := json.Unmarshal(body, &apiResp); err != nil {
                        log.Printf("Error parsing API response: %v", err)
                        http.Error(w, "Failed to parse QQ information", http.StatusInternalServerError)
                        return
                }

                // Prepare the client response
                clientResp := ClientResponse{
                        Code:   200,
                        Name:   "",
                        ImgURL: "",
                        Email:  "",
                }

                // Only populate the fields if the API request was successful
                if apiResp.Code == 200 {
                        clientResp.Name = apiResp.Data.Nick
                        clientResp.ImgURL = apiResp.Data.Avatar
                        clientResp.Email = apiResp.Data.Email
                } else {
                        // If the API request failed, pass along the error code
                        clientResp.Code = apiResp.Code
                        log.Printf("API returned error: %s", apiResp.Msg)
                }

                // Set content type header
                w.Header().Set("Content-Type", "application/json")

                // Encode and send the response
                if err := json.NewEncoder(w).Encode(clientResp); err != nil {
                        log.Printf("Error encoding client response: %v", err)
                        http.Error(w, "Failed to encode response", http.StatusInternalServerError)
                        return
                }
        })

        // Start the HTTP server
        port := os.Getenv("PORT")
        if port == "" {
                port = "52101" // Default port
        }

        log.Printf("Starting server on port %s", port)
        if err := http.ListenAndServe(":"+port, nil); err != nil {
                log.Fatalf("Failed to start server: %v", err)
        }
}

另外还需要在 nginx 配置中进行 proxy_pass 的转发配置，这里不再赘述i。

评论数据迁移

如果 URL 没有改变，评论数据是无需处理的。如果 URL 发生了变化，并且你想保留之前的评论数据，那就需要手动进行迁移。 Valine 的所有数据是存储在 LeanCloud 中，可以很方便地通过脚本进行修改。

不过因为我的评论量少得可怜，我就直接手动修改了。

总结

Valine 评论系统现在已经基于处理停止维护的状态了，而且新的版本源友也没有完全开源的服务，存在较大的局限性。未来如果有时间的话，升级 Waline 似乎是一个比较好的选择。Waline 不仅功能更完善，还提供了更好的国内访问体验和开源支持。另外最大的差异其实是 Waline 是需要后台服务，这一点可以说是优点，也可以说是限制。

初见“仓输入法”

在 windows 和 mac 使用了 Rime 输入法已经有一段时间了，但是手机上的iRime并不完善，更新也不频繁。iOS 系统关闭了网络权限，在输入法隐私上这点是有保障的。直到最近接触到仓输入法，发现功能已经做得很完善了。它不仅内置了雾凇拼音等优秀输入方案，还提供了数据同步和词表更新的完善解决方案。这促使我下定决心，完成全平台输入法 RIME 统一化的最后一环。

上手“仓输入法”

对于不想深入研究配置细节的用户，仓输入法的新手友好度相当高。我选择保留 26 键布局，以无缝迁移电脑端配置，避免重新适应 9 键布局。习惯了从 Nokia 时代的 T9 输入法，我能够实现高速单手盲打，但现在是时候转变了。仓输入法的上下左右划动设定，极大地扩展了单键输入内容的可能性，使得快捷输入变得异常方便。。我们可以很方便在一个 26 键字母键盘上加上数字，及大量的标点符号。快捷输入（手机号、邮箱地址、车牌号等等）真的很方便，相比起电脑上之前的 v 模式，这个下划真的就是那么一下就搞定了。此外，我们还可以增加很多系统命令，复制、粘贴、剪切等，以及输入法的方案切换等等。

键盘配置方面，官方文档尚需完善。注意区分字符（symbols）和符号（characters），只有符号才支持 Rime 处理。此外，确保勾选了“经过 Rime 处理”选项。

除了键盘配置之外，其他的配置和 PC 端是完全一致的，基本上可以直接复用 PC 端配置。将 PC 端配置打包发到手机后，导入到仓输入法基本就能生效了。

想念“五笔输入”

看群里还蛮多人钟情于五笔 86 的人，想起自己也算是最早一代使用五笔的人，直到后面拼音输入法联想功能的完善，尤其在引入在线提示词之后，常用语的打字速度上五笔已经处于劣势了，我才逐步切换到了搜狗拼音输入法。

这么想起来有 8 年没有使用过五笔输入了，这似乎是有点遗憾。 我开始折腾起五笔输入法了，先拿五笔做了反差来用吧。首先想要找一份简体的五笔单字码表，有人推荐了WubiLex，还是相当好用的，自带大量的五笔词库。开始选择了微软五笔的单字，后面发现很多字都不支持，比如羴之类的。既然要作为反查词库，那么词库必须完整啊。后面用了 WubiLex 自带的五笔单字库，字库看起来还是比较完整的。现在五笔可以作为不认识字的反查，也可以想念的时候切换打打字。原以为五笔打字是刻在骨子里面的，不过竟然有点忘记最后一笔的规则了，看来时间还真是会让人忘却。

再聊聊“双拼输入”

在研究五笔输入法的时候，同时也看看其他的形码输入法，目前比较多人推崇的是小鹤音形，不过现在对新的形码输入并没有啥兴趣了。不过在过程中看到有人在说，“双拼输入法是投入性价比最高的输入法了，花上几个小时就能熟悉，花上几天就能赶上原来的拼音输入速度了，而且是一辈子受益的”。理论上，双拼能显著降低击键次数和输入错误率。我是否应该花时间学习双拼输入呢？。推荐下这篇文章让双拼不再是只属于少数人的输入方式。

双拼方案众多，主要区别在于是否使用;键。搜狗和微软双拼用了;做ing的输入，而自然码和小鹤并没有去用;。我更喜欢后者，小鹤算是在自然码上做了一些改进，尽管这个改进有很多作者自己的因素在里面。花了十几分钟去做打字练习，发现完全没有记住，不过我下载了一张键位图放在桌面了，以后还是会试一试的。顺便推荐一个这个双拼在线练习的网站，提供了各种不同的双拼方案的在线练习，另外还有提供小程序。

另我还发现了双拼方案评测工具，它根据击键手指、位置和过程预估打字时间，评估分数，并提供优化方案。理论上，我们可以根据数据设计出最高效的双拼输入法。

在对不同双拼方案进行比较后，发现主流方案之间的差异不大，从 114.9 到 123.6，差异在 10%不到，简单看数据，相比全拼输入法大概能有 20%-30%的速度提升吧。但是“飞猫”和“乱序”从分数上看却是遥遥领先，这是为啥呢？

我们先来看下“飞猫”和“乱序优化”的键位图。有没有发现和其他双拼输入法很明显的差异，他们的声母是乱序的，你不仅需要记住韵母，还得重新去记声母。通过这一点，能比其他双拼输入法的输入速度再继续提升 30%。而“飞猫”还有一个特点在于部分拼音是支持多个键的，就是所谓的“飞键”，比如sh既可以通过N也可以通过A进行输入，你哪个手指方便就用哪个手指去打印，有点像是按Shift键的感觉，你左手打字母那就右手按右边的Shift，反之亦然。不过我估计挺多人没有遵守这个基础打字规范，我个人大部分情况还是遵循了这一点的。

网上关于“飞猫”的资料相当少，这一篇算是作者在 2016 年发的原文，的确是通过程序计算出来的按键，可是后面就没啥新内容了。GitHub 上也没有其他资料，只有这一篇写到在 Rime 中的飞猫配置。下面这些是作者文章中的截图。

多端数据同步方案

我们需要同步的数据，可以分为几类：

1. 配置类 yaml 文件；
2. 词库类 yaml 文件；
3. 用户输入词库，以 userdb 格式保存；

我们先看前两类数据的同步方案，这里的数据源头是维护在 Git 仓库的。

在看用户词库的同步方案，这里的数据源头的话就是各个输入设备的本地数据，执行同步操作后会将自己设备的数据写入微云同步盘的指定目录，同时读取其他设备的用户词库进行合并处理。

这里相关的脚本操作在 Mac 和 Windows 上是在 uTools 的快捷命令插件中进行维护，开启了定时执行，手机端是通过 iPhone 的快捷指令进行定时执行。而源头的词库是通过 Github Workflow 进行定时更新的，这样整体流程都不需要人工干预了。

最近又开始折腾起我的服务器了，重点关注数据更新流程中的一些不满意之处：

1. Git仓库同步更新：广州和香港的服务器通过crontab任务每分钟执行git pull操作；
2. 博客同步更新：服务器上的crontab任务执行git fetch，对比差异后触发构建流程；
3. Cronicle部署：广州服务器未部署cronicle，导致定时脚本依赖crontab，无法在页面查看执行状态

部署cronicle

为了简化广州服务器上的定时任务管理，我部署了 Cronicle。尽管步骤较多，但得益于之前的经验，十几分钟内便完成了：

1. 申请并配置域名，设置 CNAME 转发；
2. 配置 Nginx，申请 HTTPS 证书；
3. 安装Cronicle（未使用Docker，直接通过curl命令）；
4. 修改配置文件，参照香港服务器；
5. 启动Cronicle；
6. 在页面配置任务，如进程监控脚本等；

部署过程中发现，Cronicle支持API远程访问，这正是我一直期望的功能。考虑到直接在机器上部署agent来转发命令存在安全隐患，且定制化配置页面需要额外维护，cronicle的API很好的满足了我。

部署n8n

有了Cronicle的API，我们具备了通过GitHub push webhook触发同步更新的基础。接下来，需要找到一个合适的服务接收webhook请求，并优雅地调用我们的API接口。这时，我想起了持续集成（CI）的概念。曾尝试使用集简云等服务，但它们通常按执行次数收费且价格不菲。经过一番搜索，我发现n8n受到了许多人的推荐。其插件生态完善，能方便地集成主流服务。

部署n8n相对简单：

1. 申请域名，配置CNAME转发；
2. 配置Nginx，申请HTTPS证书；
3. 使用Docker部署n8n；

借助n8n实现git仓库的同步更新

配置流水线花费了一些时间，没找到直接参考的例子，只能一步步琢探索。

第一步：引入GitHub Trigger节点，配置了token之后，只看到一个Test step的按钮。点击之后，n8n能自动配置GitHub的Webhook的配置项。n8n区分了测试和正式的webhook地址，注意的是对于正式地址仍然需要手动在GitHub页面配置的。

第二步：引入HTTP request节点，调用cronicle的API。

简单测试了下发现流程就可以跑通了，但是这里的流水线没有对API执行的结果做回包解析。所以第三不便是需要引入Code节点，判断下下错误码，对于非0的情况直接抛异常了。

code=$input.item.json.code

if (code !== 0) {
  throw new Error(`HTTP request failed with code {data[0].code}`)
}

return $input.item;

整体流水线的配置，只包含三类节点

实现博客的同步更新

有了git仓库同步的经验，要解决博客的同步更新其实就比较简单了。不过这里顺便提下n8n的消息通知并不优雅，没有地方统一配置成功和失败的消息发送。目前来看需要针对每一条流水线进行配置。

后续会将更多任务挪到n8n上面来，这只是一个起步。

最近，我踏上了减肥的征程，并在过去一个月里取得了小小成果。不过这里重要不是减肥，而是我需要一种方式来直观展示我的减肥进展，其实最主要的也就是体重数据的折线图。但市面上的多数健康追踪应用似乎都未能满足我的需要，它们提供的图表功能缺乏对时间选择的灵活性——大多数应用仅支持以自然日、周或月为单位的折线图展示，其实我需要的也就是我从减肥开始到现在一个区间段的数据变化而已。

我决定自己动手制作图表。在众多图表库中，Echarts 以其美观和功能强大脱颖而出，经过一番尝试，我发现它几乎可以满足我所有的需求。

我曾幻想能够直接在网页上读取我的 iPhone 健康数据，但苹果的 HealthKit 似乎并未对网页端开放，这让我不得不另辟蹊径。我选择了从手机导出所有健康数据，然后在电脑上进行处理，再将其导出为便于网页使用的格式。

最初，我将数据以 HTML 的形式维护在 git 仓库中，每当有更新时，GitHub 的 workflow 会自动触发并部署更新。这种方法基本上能满足我的需求了。

只是想到数据放在 HTML 中不是一个太好的解决方案，我就尝试将数据从 HTML 中独立出来，转而使用 JSON 格式存储。这样一来，每当需要更新数据时，我只需修改 JSON 文件，而无需触碰 HTML 代码，这并未将我的工作简化，但是听起来更合理不是？

我很快意识到，即使是 JSON，也仍然需要通过 git 提交，这并不是我所追求的优雅解决方案。我希望能够在网页上直接编辑数据，于是开始探索不同的方案。最终，我发现了一个完美的解决方案——无极。它不仅提供了一个可视化的表格数据编辑界面，还有数据拉取的 API 接口，而且是完全免费的。尽管我对其可能存在的使用限制尚不明确，但它已经很好地满足了我的需求。

在部署过程中，我遇到了一个棘手的问题：无极提供的 API 接口存在跨域访问的问题。为了解决这个问题，我不得不设置了一个 nginx 服务器作为中转，虽然这增加了一些复杂性，但最终确保了数据的顺利传输和展示。

这纯粹是一趟折腾之旅，不过好在不管是 GitHub 的流水线更新流程，还是 Nginx 服务器也都是现成的，所以工作量倒是不大。最后还是展现下我的趋势图吧，网址就先不贴了。

• candidate_list_layout: linear
• text_orientation: vertical

• candidate_list_layout: linear
• text_orientation: horizontal

• candidate_list_layout: stacked
• text_orientation: horizontal

• candidate_list_layout: stacked
• text_orientation: vertical

最开始用的基础词库来源于ssnhd/rime，这是它的词表介绍

主要用了这几份词库：

• luna_pinyin.dict.yaml：默认字库，有部分的词语，总计7万；
• luna_pinyin.sogou.dict.yaml：来源于搜狗词库，总计105万；
• easy_en.dict.yaml：英文词库，总计11万；

此外还用了几份自己维护的词库：

• 股票名称列表，使用Tushare API拉取A股的股票名称列表生成词库，总计5千；
• 我的搜狗自定义词库，从搜狗导出后经过手动删除，总计3千；
• 我手动维护的词库，总计1百；

但是这份词库存在几个问题：

1. 缺乏词库持续的更新维护；
2. 这份百万级的搜狗词库质量不高，并不是搜狗自带的词库；
3. 本身基于繁体，尽管这符合RIME的做法；

最近发现两份还不错的简体词库，分别是四叶草拼音和雾凇拼音。其中雾凇拼音有6K的star数量，并且更新还是比较及时的，提供的功能也比较完善，下面是一个功能介绍：

作者也明确说明了他会长期维护几份词库：

• 8105 字表。
• base 基础词库。
• ext 扩展词库，小词库。
• tencent 扩展词库，大词库。
• Emoji

雾凇拼音用了大量的lua脚本来实现功能，这里先不整体引用，打算只引用词库。但是在部署的时候却发现小狼毫会一直处于加载中，尝试后发现是在加载Tencent大词库的时候才出问题。搜索Github发现可以关掉配置use_preset_vocabulary就可以解决问题。

目前使用的外部词库保留了来源于雾凇拼音的四份中文词库

• cn_dicts/8105 # 字表
• cn_dicts/base # 基础词库
• cn_dicts/ext # 扩展词库
• cn_dicts/tencent # 腾讯词向量

在Typora的设置页中打开主题文件夹，然后新建一个 xx.user.css 文件（xx为你的主题名称），比如使用的主题为github，则新建一个 github.user.css 文件，里面的内容填写如下：

body {
    font-family: "Source Han Sans SC", "Microsoft Yahei";
}

header, .context-menu, .megamenu-content, footer{
    font-family: "Source Han Sans SC", "Microsoft Yahei";
}

.md-fences, tt, code {
    font-family: Consolas;
}

这里其实就是修改了字体为思源黑体、微软雅黑，以及代码字体为 Consolas。关于思源字体的介绍，可以参考之前发表的文章。重新打开Typora，或者切换其它主题再切换回来就可以生效了。最近新装了Windows11， 把常用软件都切换成了深色界面了，Typora也换成了官方的Night主题。

顺便补充一点，字体的英文名可以通过 Exif 查看工具（比如 exif-tool 命令行工具或者在线工具也行）获取真实的 font-family，在windows的字体设置中展示的是中文font-family，实测并不可用。

Scoop 操作示例

1. 安装 scoop

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
   Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression

2. 安装main的软件

   scoop install go
   scoop install nodejs

3. 安装extra的软件 （也是官方维护，要求比main宽松）

   scoop bucket add extras
   scoop install extras/apifox

4. 安装第三方软件（这是我自己的 bucket 哈）

   scoop bucket add plutotree https://github.com/plutotree/scoop-bucket
   scoop install plutotree/qqmusic

5. 安装字体

   scoop bucket add nerd-font
   scoop install hack-nf

6. 更新所有软件

   scoop update
   scoop update *

安装流程和 Mac 下的 Homebrew 相似，scoop 用 json 来维护软件信息，做法也是和老版本的 homebrew 一样。不过 scoop 有点优势在于，绝大部分软件都能支持自动更新，官方也提供了 Github Action 组件，定时检测发现有新版本的时候会自动更新描述文件。

Scoop 使用说明

1. 使用自定义目录进行安装

   [environment]::setEnvironmentVariable('SCOOP', 'E:\Scoop', 'User')
   $env:SCOOP='E:\Scoop' # 如果不用这句话的话可以重开窗口也行
   iex (new-object net.webclient).downloadstring('https://get.scoop.sh')

2. 增加常用的 bucket，可以参考官方介绍的bucket 列表（质量比较高），我目前只加了 extra 和 nerd-fonts

   scoop bucket add extra
   scoop bucket add nerd-fonts

3. 安装官方推荐的加速下载工具 aria2

   scoop install aria2

4. 从控制面版卸载不需要的程序，然后通过 scoop 进行安装和管理。

• 查找：scoop search xx
• 安装： scoop install xx
• 卸载：scoop uninstall xx
• 升级: scoop update; scoop update xx
• 查看缓存（下载的安装包）：scoop cache
• 删除缓存：scoop cache rm xx （*表示所有软件）
• 查看已安装软件：scoop list
• 删除软件的旧版本：scoop cleanup xx （*表示所有软件）
• 删除软件的旧版本同时清理缓存：scoop cleanup -k xx（*表示所有软件）

哪些软件不适合

绿色软件是更适合的，而和系统关联性太强的软件是不适合的，尤其是需要管理员权限进行安装的。尽管 scoop 也支持使用管理权限进行安装，但是同样更新和卸载也许要管理权限，我觉得就没必要了而且维护起来会比较麻烦。

目前就我电脑上的软件而言，没有使用 scoop 管理的主要是：

1. 系统驱动和厂商管理工具，比如 Nvidia、HP 等管理工具；
2. 微软的开发工具和环境依赖，比如Microsoft Visual C++ xx Redistributables、Microsoft Windows Desktop Runtime等；
3. 微软自带的部分商店应用，比如主题、微软 TODO 工具、画图工具、3D 查看器等；
4. 和系统关联系比较大，或者不方便迁移出来的，比如 Adobe 系列、Office 软件、iTunes、输入法等；
5. 平台类软件，需要使用其更新管理，比如 steam、Epic 等，后续需要研究下；
6. 专业软件，或者内部使用的软件；
7. 部分还没来得及迁移的软件，比如 TortoseSVN、QQ、微云等；

查找软件

可以使用命令scoop search进行搜索，不过建议是在官网进行搜索，需要注意的是选项Official bucket only选项是否开启，一般情况下是建议安装官方包，以及可信赖的第三方。而我个人而言，第三方目前会控制在自己的 bucket 范围。

在官方查找不到的时候，可以扩展到第三方，找到之后可以修改后何如自己的 bucket 中。第三方的 bucket 其实质量并一定能保证，最后看下描述文件内容，以及是否从官网下载。还有部分维护破解软件的第三方 bucket，建议就不要使用了。还有就是关注下 bucket 的 star 数量，毕竟 star 多点还是稍微靠谱点。这个网站提供按 star 数量排名的 bucket 列表，也可以参考下，蛮多是中国人维护的 bucket。

维护自己的 bucket

1. 创建一个自己的 bucket
   • 在 GitHub 上直接通过Bucket 模板新建一个仓库；
   • 按照提示说明，修改仓库的设置，开启读写权限；
   • 修改几个文件的占位符，指定下仓库名信息；
2. 维护自己软件的描述信息，
   • 自己写应用描述信息，或者直接复用第三方，或者在其基础上修改；
3. 增加自己的 bucket：scoop bucket add BUCKET_NAME YOUR_BUCKET_GIT_ADDRESS
4. 安装自己的软件：scoop install BUCKET_NAME/APP_NAME

应用描述信息

这块算是 scoop 中最复杂的内容了，官方文档提供了基础的介绍，更有用的话应该需要多参考已有的描述。我们来看几个例子

Cos-Browser

{
  "version": "2.11.13",
  "description": "A visualization interface tool provided by Tencent Cloud COS, view, transfer, and manage COS resources easily",
  "homepage": "https://github.com/tencentyun/cosbrowser",
  "license": "Freeware",
  "url": "https://cos5.cloud.tencent.com/cosbrowser/cosbrowser-setup-2.11.13.exe#/dl.7z",
  "hash": "sha512:0063411445cc4a2af098b71780525ec2e190f396934d1b910fbd62aea897ce99a0b2099a848d15df871e7f774aa7334be6acd2c4c4de2e9d0ae8cce05830940f",
  "architecture": {
    "64bit": {
      "pre_install": "Expand-7zipArchive \"$dir\\`$PLUGINSDIR\\app-64.7z\" \"$dir\""
    },
    "32bit": {
      "pre_install": "Expand-7zipArchive \"$dir\\`$PLUGINSDIR\\app-32.7z\" \"$dir\""
    }
  },
  "post_install": "Remove-Item \"$dir\\`$*\" -Force -Recurse",
  "shortcuts": [
    ["cosbrowser.exe", "COSBrowser", "--user-data-dir=\"$dir\\UserData\""]
  ],
  "persist": "UserData",
  "checkver": {
    "url": "https://cos5.cloud.tencent.com/cosbrowser/latest.yml",
    "regex": "version: ([\\d.]+)"
  },
  "autoupdate": {
    "url": "https://cos5.cloud.tencent.com/cosbrowser/cosbrowser-setup-$version.exe#/dl.7z",
    "hash": {
      "url": "$baseurl/latest.yml",
      "regex": "sha512: $base64"
    }
  }
}

看下整体流程：

1. 下载指定 URL，下载后进行 Hash 校验；
2. URL 后面有#/dl.7z，在校验成功后会直接使用 7zip 进行解压缩；
3. 调用pre_install脚本内容，这里使用了Expand-7zipArchive解压缩；
4. 调用install脚本内容，这个应用是空的；
5. 创建快捷方式，这里关注下有指定参数--user-data-dir，这样就不会使用系统的AppData目录了。猜测这个参数是 electron 开发的软件都会有的，其它框架开发的就不支持了。
6. 调用post_install脚本内容，这里主要就是删除一些无用的文件；
7. persist指定了需要持久化的目录，scoop 会帮忙创建一个链接，并且卸载的时候不会删除；
8. checkver 是用来检测是否有新版本，autoupdate 是用来在有新版本的时候进行下载并且更新描述文件。这两块的细节内容会比较复杂点，可以参考官方文档。

Evernote

{
  "version": "10.71.2",
  "description": "[Evernote] Use it for note taking, project planning and organize everything",
  "homepage": "https://evernote.com",
  "license": "Freeware",
  "url": "https://win.desktop.evernote.com/builds/Evernote-latest.exe#/dl.zip",
  "hash": "7e3b3565651b6ddeaa9dfb86502951917d996b09ebd32f2ce11509325d3bcce1",
  "architecture": {
    "64bit": {
      "pre_install": "Expand-7zipArchive \"$dir\\`$PLUGINSDIR\\app-64.7z\" \"$dir\""
    },
    "32bit": {
      "pre_install": "Expand-7zipArchive \"$dir\\`$PLUGINSDIR\\app-32.7z\" \"$dir\""
    }
  },
  "post_install": "Remove-Item \"$dir\\`$*\" -Force -Recurse",
  "shortcuts": [["Evernote.exe", "Evernote"]],
  "checkver": {
    "url": "https://evernote.com/release-notes",
    "regex": "Version.*?([\\d.]+)"
  },
  "autoupdate": {
    "url": "https://win.desktop.evernote.com/builds/Evernote-latest.exe#/dl.zip"
  }
}

基本上和 Cos-Browser 的信息是类似的，但是 autoupdate 这里没有指定 Hash 获取方式，其实是官方没有提供，这种情况下的话就只能等文件下载完成之后再进行 hash 计算了，理论上来说是存在文件下载异常描述信息有问题的，这种的话就只能等发现之后手动修复了。

QQ 音乐

{
  "##": "QQ音乐",
  "version": "20.05.0",
  "description": "[QQ音乐] 千万正版音乐海量无损曲库新歌热歌天天畅听的高品质音乐平台",
  "homepage": "https://y.qq.com",
  "license": "Freeware",
  "url": "https://dldir1.qq.com/music/clntupate/QQMusic_YQQWinPCDL.exe#/dl.7z",
  "hash": "4c35742f11a011e8aff31987966e29b014fcdabfd6f50240125c8252f86188b2",
  "post_install": "Copy-Item \"$dir\\QQMusic.tpc\" \"$dir\\instok\"",
  "checkver": {
    "url": "https://y.qq.com/download/download.html",
    "regex": "Windows PC.*\\:([\\d.]+)"
  },
  "shortcuts": [
    ["QQMusic.exe", "QQ音乐"],
    ["QQMusic.exe", "QQ Music"]
  ],
  "autoupdate": {
    "url": "https://dldir1.qq.com/music/clntupate/QQMusic_YQQWinPCDL.exe#/dl.7z"
  }
}

这里我们创建了两个快捷方式，分别是 QQ 音乐和QQ Music，这样不管输入的是哪个都能启动了。同样 QQ 音乐也没提供 hash 获取方式，只能下载后本地计算。

补充说明

腾讯会议比较奇怪，不能直接在current目录启动，而必须在版本目录启动，所以就不能用自带的快捷方式，而需要手动创建了。

{
  "pre_install": [
    "Rename-Item \"$dir\\`$_*_\" \"$dir\\$version\"",
    "Remove-Item \"$dir\\`$*\",\"$dir\\wemeetapp_new.exe\" -Recurse -Force",
    "startmenu_shortcut -target $(Get-Item \"$dir\\wemeetapp.exe\") -shortcutName \"Tencent Meeting\"",
    "startmenu_shortcut -target $(Get-Item \"$dir\\wemeetapp.exe\") -shortcutName \"腾讯会议\""
  ],
  "pre_uninstall": [
    "if (Get-Process -Name \"wemeetapp\" -Erroraction SilentlyContinue) {Stop-Process -Name \"wemeetapp\"}",
    "if (Test-Path \"$(shortcut_folder)\\Tencent Meeting.lnk\"){Remove-Item \"$(shortcut_folder)\\Tencent Meeting.lnk\" -Force}",
    "if (Test-Path \"$(shortcut_folder)\\腾讯会议.lnk\"){Remove-Item \"$(shortcut_folder)\\腾讯会议.lnk\" -Force}"
  ]
}

有些软件是不能直接解压缩的，而是通过 Inno 方式进行安装，这种的话 scoop 也有自带提供支持，可以参考其它软件，等我遇到的时候再补充。

问题记录

GitHub 访问 401 问题

遇上 GitHub API 访问受限导致的 401 问题，可以设置环境变量SCOOP_GH_TOKEN，使用自己的 Access Token 即可。创建 Access Token 的时候不需要指定任何特别的权限，使用默认权限即可。

应用打开网址无法拉起 Chrome 浏览器

尝试过多种方法但是仍然有不低的概率遇上，最后只能放弃使用 scoop 来维护 Chrome，换成 chrome 默认安装之后问题就不再出现了。

everything 开机启动无效

这里主要在使用 uTools 调用 everything 搜索的时候，每次开机启动需要重新进行索引，按照 uTools 的说法，如果使用的是安装版并且开机启动的前提下，是不会触发使用内置的绿色版 everything 而导致重新索引的问题的。最后也放弃使用 scoop 维护 everything，而使用官方的安装版本进行安装。不过这个问题也可能通过修改 everything 的配置项能解决。

hash 校验不一致导致无法安装

有一种可能是更换了安装包但是没有更换版本号，也有可能是计算 hash 的时候遇到了一些bug。在执行 scoop install 的时候只要增加 -s 参数即可跳过 hash 校验。