《你当像鸟飞往你的山》

作者：塔拉·韦斯特弗
译者：任爱红
出版社：南海出版公司

在看这本书之前，我陆续听说过，但一直没什么兴趣去了解。在我印象中这是一本"励志"书，而我并不喜欢"励志"或"成功学"类的书籍。当时我正在看一些工具书，读得艰难有些疲惫，就想换本有故事性的书来放松一下。

于是，这本书陪我度过了多个通勤和午休前的时间。读完后我发现，虽然作者的故事确实很励志，但这本书想表达的不止于此——它给我带来的更多是关于个体与家庭、个人与信仰关系的思考。

书中最让我印象深刻的，是作者在"回归家庭"和"保持自我"之间的挣扎。也许这两者并非完全对立，但她极端的成长经历把这种冲突逼到了非此即彼的境地。更难的是，"回归"这个选项有着真实的诱惑：回到家庭，回到宗教，仿佛就可以不再烦恼。放弃自己的主体性，不用再为自己负责，上帝会解决一切。那种安稳，并不是没有吸引力的。

这让我想到一个我一直在思考的问题。这种用归属感换取安全感的冲动，在宗教信仰里同样存在——信仰一个至高无上的力量，仿佛生活的问题都能得到解答，仿佛你也能借此拥有某种庇护。这种对外部至高力量的依赖，与作者面临的选择很相似：是选择依赖某个更大的存在来承担自己，还是承担独立思考的重负，以及随之而来的孤独？作者的选择给出了她的答案。

总的来说，我觉得这本书有一种温柔的治愈力量。它没有简单地批判或赞美她的家人，也没有简单地美化自己的选择，而是以真诚的探索和思考，展现了一个人如何在复杂的关系网络中寻找自己的位置。

本文记录我使用树莓派 5 过程的经验，即是笔记，也是分享。

优化：增大 swap 分区

我在我的树莓派 5 4GB 上跑 Docker，部署了多个服务。当加入 Nextcloud 后，系统开始出现明显卡顿，响应速度大幅下降。输入 top 命令发现，内存几乎用满，swap 更是直接 100% 占用：

MiB Mem :   4049.9 total,    146.7 free,   3369.8 used,    789.0 buff/c
MiB Swap:    200.0 total,      0.0 free,    200.0 used.    680.1 avail

这时我才发现树莓派 5 的 Raspberry Pi OS (Bookworm) 默认仅配置了 200MB swap。这个保守的设置可能是为了照顾使用 SD 卡的用户——毕竟频繁的 swap 读写会严重缩短 SD 卡寿命。

但既然树莓派 5 已经配备了 PCIe 接口，官方也推出了专用的 M.2 HAT+ 和 SSD 套件，如果你和我一样使用 SSD 作为系统盘，完全可以将 swap 调大，充分发挥 SSD 的读写性能和耐用性优势。

1. 打开配置文件：

   sudo nano /etc/dphys-swapfile

2. 修改 CONF_SWAPSIZE，我的树莓派系统是安装在 SSD 上的，所以 swap 调大点没关系。如果你用的是 SD 卡，建议设置小点，不要超过 1GB，因为频繁的 swap 读写会大幅缩短 SD 卡寿命。

   CONF_SWAPSIZE=4096  

   为了设置超过 2GB 的 swap， 还需要修改 CONF_MAXSWAP 调大限制，可以和 CONF_SWAPSIZE 一致，也可以设置的更大一些方便后续调整。

   CONF_MAXSWAP=4096

3. 重启 swap 服务

   sudo /etc/init.d/dphys-swapfile restart

4. 验证

   free -h

优化：开启 zram

1. 安装

   sudo apt update
   sudo apt install zram-tools

2. 验证

   cat /proc/swaps

   可以看到

   Filename                                Type            Size            Used            Priority
   /dev/zram0                              partition       262128          257344          100
   /var/swap                               file            4194288         697648          -2

避坑：树莓派 5 PCIe 排线干扰

如果你使用树莓派 5 搭配 树莓派官方 M.2 套件（HAT+），建议不要把树莓派直接叠放在路由器上。

之前有段时间，我发现树莓派经常重启，有时甚至直接卡死无响应。最严重的一次，我部署的 Karakeep 书签服务因为底层数据错误导致数据库损坏，数据瞬间全丢，万幸最后从 Meilisearch 中抢救回来了。

排查过程中我尝试了很多方法（包括修改PCIe节能设置等），最后发现罪魁祸首可能是官方 FPC 排线的抗干扰能力不足（虽然官方说是抗干扰的）。后来我将树莓派与路由器物理分离一段距离后，就再也没出现过类似问题。

如果你不需要使用树莓派的 WiFi 功能，也建议关闭。

参考链接

https://linuxblog.io/raspberry-pi-performance-add-zram-kernel-parameters/

https://github.com/geerlingguy/raspberry-pi-pcie-devices/issues/559

可以通过下面方式，让 Antigravity 能够使用 VS Code 的应用扩展商店：

1. 在 Antigravity 的菜单栏中的 “首选项” 中打开 “Antigravity Setting”。

   

2. 在设置中的 “Editor” 区域，设置以下参数：

   Marketplace Item URL

    https://marketplace.visualstudio.com/items

   Marketplace Gallery URL

   https://marketplace.visualstudio.com/_apis/public/gallery

   

3. 重启 Antigravity 即可。

时隔多年再次重装 OpenWrt，早已忘记当初的安装方法。许多教程已经过时或缺少关键细节，因此记录本文以便日后查阅，也方便有需要的人参考。如有问题，欢迎在评论区讨论。本文仅作为参考，请谨慎操作，数据风险自负。

本文将演示如何在树莓派4B上安装 ImmortalWrt 并进行扩容。

1. 安装 ImmortalWrt

ImmortalWrt 是 OpenWrt 的一个分支 ，它移植了更多的软件包，支持更广泛的设备，默认优化了配置文件，并为中国大陆用户进行了本地化修改。

1.1 下载 ImmortalWrt

前往 ImmortalWrt 固件选择工具 下载对应固件：

搜索设备型号，查找对应固件。

每个设备一般会对应四个固件：

• SYSUPGRADE vs. FACTORY:
  • FACTORY 固件是用于首次安装ImmortalWrt。
  • SYSUPGRADE 固件是用于升级已经运行ImmortalWrt的设备，它会保留你的配置。
• EXT4 vs. SQUASHFS:
  • EXT4 是一个可读写的日志文件系统，更灵活，可以更方便地修改系统文件。
  • SQUASHFS 是一个只读的压缩文件系统，通常与一个小的可写分区（如JFFS2或UBI）结合使用。它在系统稳定性、节省空间和抗意外修改方面有优势。如果系统被破坏，可以更容易地恢复到初始状态。

首次安装，选择 FACTORY 版本，树莓派设备推荐使用 EXT4。

下载 FACTORY(EXT4) 的版本。

1.2 烧录 ImmortalWrt

利用 rufus 工具将上一步得到的 immortalwrt-[版本号]-bcm27xx-bcm2711-rpi-4-ext4-factory.img.gz 直接烧录到内存卡，保持 rufus 默认设置即可。

2. 初始化系统

2.1 连接与首次登录

ImmortalWrt 不再默认创建 Wi-Fi 热点，所以需要通过有线的方式连接到它。

把内存卡插到树莓派中，接通电源。然后用网线连接树莓派和电脑。

在电脑上访问 192.168.1.1。默认账号名为 root，密码为空。

登录后按照提示修改默认密码。

2.2 配置网络

进入 “网络” - “接口”，然后编辑默认 lan 接口。

根据实际需求配置网络。

由于我将其作为旁路网关使用，所以设置了静态 IP 地址，并指定了相应的网关和 DNS。且在“DHCP 服务器”界面，勾选“忽略此接口”。

确认无误后，点击“保存并应用”，并强制执行。

然后，就可以用网线将树莓派连接到路由器了。

3. 扩容分区

完成后上述步骤后，ImmortalWrt 就能正常使用了。但是默认 ImmortalWrt 只用了 300MB 的储存，并没有用完整张储存卡。所以可用空间很少，并且被浪费。

接下来我们来扩容。

1. 安装需要用到的工具

   opkg update  
   opkg install fdisk resize2fs losetup

2. 查看当前分区状况

   fdisk -l

   你会看到类似下面的输出（120GB 的内存卡，只用了 64MB + 300MB）：

   

3. 重新分区

   进入 fdisk 工具：

   fdisk /dev/mmcblk0

   输入 p 查看分区表，记住第二分区开始的位置：

   

   输入 d 删除第二个分区：

   

   输入 n 重新创建分区：

   • 分区类型：选择 p ，或直接回车使用默认值。
   • 分区序号：选择 2 ，或直接回车使用默认值。
   • 起始扇区：输入之前记录的 147456（根据实际情况替换，使用原起始扇区）。
   • 结束扇区：可以指定大小，或直接回车使用默认值，默认值是占用所有剩余空间。
   • 当提示是否移除标识：输入 N。

   

   最后，输入 w 确认并执行变更：

   

4. 再次查询分区情况，可以看到第二个分区现在已经扩大。

   fdisk -l

   

5. 接下来还需要让系统能够识别这个分区：

   先查看当前是否有循环设备：

   losetup

   此时，输出可能为空。或者有一些设备。在下个命令中，不要与已有设备冲突，可以用 loop1 或其他未使用的编号。

   创建循环设备：

   losetup /dev/loop0 /dev/mmcblk0p2

   扩展文件系统到分区全部空间：

   resize2fs -f /dev/loop0

6. 重启系统，网页访问树莓派，可以看到扩容成功，磁盘空间大小已经更新。

   reboot

   

4. 参考链接

https://blog.caliburn.work/archives/1709726837347

Motrix 在 v1.8.19 版本中开始支持 arm64 设备，可以在树莓派等设备上运行。树莓派功耗低、运行安静，很适合 24 小时运行下载服务。由于我的树莓派没有安装桌面系统，所以通过 docker-baseimage-gui 项目制作了一个 docker 镜像。docker-baseimage-gui 提供了集成轻量级桌面环境、VNC 服务和 Web 访问功能的基础镜像，专门用于在无头服务器上运行 GUI 应用。

项目是开源的，具体实现可以查看：eMUQI/motrix-arm64-vnc

使用说明

以下以我的树莓派 5 为例：

Raspberry Pi 5 Model B Rev 1.0
OS: Debian GNU/Linux 12 (bookworm) aarch64
Kernel: 6.12.34+rpt-rpi-2712

1. 前置条件

请确保您的宿主机系统已安装 Docker 及 Docker Compose。

2. 创建并配置 docker-compose.yml

在宿主机上创建项目目录，并在该目录中新建 docker-compose.yml 文件。

mkdir motrix-server
cd motrix-server
touch docker-compose.yml

将以下内容写入 docker-compose.yml 文件：

docker-compose.yml

services:
  motrix:
    image: emuqi/motrix-arm64-vnc:latest
    container_name: motrix-vnc
    ports:
      # 5800: 用于 noVNC (Web 浏览器) 访问的端口
      - "5800:5800"
      # 5900: (可选) 用于标准 VNC 客户端直接访问的端口
      - "5900:5900"
    volumes:
      # 将宿主机的 ./data 目录映射到容器的 /config/Downloads 目录
      # 用于持久化存储下载的文件
      - ./data:/config/Downloads
    environment:
      # 关键：设置容器内应用的用户与用户组 ID。
      # 建议修改为宿主机当前用户的 UID 和 GID，以避免挂载目录的权限冲突。
      # 可在宿主机终端执行 `id` 命令获取。
      - USER_ID=1000
      - GROUP_ID=1000
      # 设置 VNC 会话的显示分辨率
      - DISPLAY_WIDTH=1280
      - DISPLAY_HEIGHT=720
      # (可选) 设置 VNC 访问密码。取消注释并替换为强密码。
      # - VNC_PASSWORD=your_secret_password
    restart: unless-stopped

3. 启动容器服务

在 docker-compose.yml 文件所在的目录下，执行以下命令以启动服务：

docker compose up -d

访问方式

• Web 浏览器 (noVNC): 访问 http://<宿主机IP地址>:5800

• VNC 客户端: 使用 VNC 客户端 (如 RealVNC Viewer, TigerVNC) 连接至 vnc://<宿主机IP地址>:5900

关键配置：设定下载路径

为确保下载文件能正确保存至宿主机映射目录，首次启动后必须在 Motrix 应用内完成以下配置：

1. 在 Motrix 图形界面中，导航至 偏好设置 -> 基础设置。

2. 定位到 下载路径 选项，点击 “更改”。

3. 将路径手动设置为容器内部的绝对路径：/config/Downloads。

   

4. 保存并应用设置。

   此操作仅需配置一次。完成后，所有下载任务产生的文件，都将被保存在您之前创建的 motrix-server 项目目录内的 data 文件夹中。

其他提示

noVNC 不支持传统意义上的直接、无缝剪贴板调用。这主要是由于现代网页浏览器的安全限制。

当你通过浏览器访问此项目时，需要通过以下方式将下载链接复制 Motrix：

1. 在你的本地电脑上复制文本。

2. 打开 noVNC 界面侧边的控制条，找到剪贴板工具。

   

3. 将文本粘贴到 noVNC 的剪贴板文本框中。

   

4. 此时，文本被发送到远程服务器的剪贴板。你现在可以在远程桌面环境中使用粘贴命令（如 Ctrl+V）来粘贴内容。

   

环境变量参考

其他项目

还有一个 Motrix-Web 项目实现了在网页上运行 Motrix 的功能。该项目的前端用户界面与 aria2 后端是分离的。Motrix-Web 作为前端 UI，直接从浏览器发出请求以控制后端的 aria2。这意味着，当考虑将 Motrix-Web 部署到公网环境时，aria2 也需要相应地部署到公网。

而本项目 motrix-arm64-vnc 将向 aria2 发送的网络请求封装在容器内部。这种架构的好处是，aria2 无需直接暴露在公网上，从而提供了更为安全的运行环境。

值得注意的是，无论选择哪种部署方案，出于安全考虑，都不建议将上述提及的两个项目直接暴露在公网上。在任何面向公网的部署场景中，都应考虑将其置于某种验证机制之后，例如 Cloudflare Access 或其他反向代理与身份验证解决方案。

具体原理是：使用树莓派安装 Home Assistant，通过 Home Assistant 中的小米官方集成连接米家设备。通过 Home Assistant 中的 HomeKit Bridge 集成，将米家设备桥接到 Apple HomeKit。这样就可以通过 Apple 的“家庭”应用和 Siri 来控制这些设备，即使它们不支持 HomeKit。

目录

• 1. 安装 Home Assistant
• 2. 安装与配置 Home Assistant 社区商店 (HACS)
  • 2.1 安装 HACS
  • 2.2 配置 HACS
• 3.将米家设备接入 Home Assistant
  • 3.1 安装 Xiaomi Home (米家官方) 集成
  • 3.2 配置 Xiaomi Home
• 4. 桥接米家设备到 HomeKit
  • 4.1 在 Home Assistant 中添加 HomeKit Bridge 集成
  • 4.2 在 HomeKit Bridge 中排除不必要的实体
  • 4.3 将 HomeKit Bridge 添加到苹果家庭
• 5.常见问题

我的树莓派配置

Raspberry Pi 5 4gb
OS: Raspberry Pi OS Lite
Kernel: Linux 6.12.20+rpt-rpi-2712 #1 SMP PREEMPT Debian 1:6.12.20-1+rpt1~bpo12+1 (2025-03-19) aarch64 GNU/Linux

1. 安装 Home Assistant

Home Assistant 支持多种安装方式，大致有三种方法：

1. 安装 Home Assistant OS 操作系统
2. 通过 Docker 容器安装
3. 直接安装 Home Assistant Core（逐步弃用，从 Home Assistant 2025.6 版本开始，此安装方式将进入为期六个月的弃用期。）

Home Assistant 官方已提出计划逐步停止对 Home Assistant Core 安装方式的官方支持。建议采用第一种或者第二种方法。

为了便于管理，我选择使用 Docker Compose 来安装 Home Assistant。参考官方教程，docker-compose.yml 如下：

~/docker/homeassistant/docker-compose.yml

services:
  homeassistant:
    container_name: homeassistant
    image: ghcr.io/home-assistant/home-assistant:stable
    volumes:
      - ./config:/config
      - /etc/localtime:/etc/localtime:ro
      - /run/dbus:/run/dbus:ro
    restart: unless-stopped
    privileged: true
    network_mode: host

安装完成后，通过浏览器访问树莓派的 IP 地址加 8123 端口 (例如 http://树莓派IP:8123)。首次访问会进入 Home Assistant 初始化向导，按照提示设置管理员账户和密码。

2. 安装与配置 Home Assistant 社区商店

2.1 安装 HACS

配置完 Home Assistant 后，我们需要安装 HACS（Home Assistant Community Store）。你可以将其理解为 Home Assistant 的应用商店，通过 HACS 我们能够安装第三方集成来增强 Home Assistant 的功能。后续我们需要通过 HACS 来安装小米官方的 Home Assistant 集成。

参考 HACS安装指南，我们需要进入容器内部执行安装脚本。

docker exec -it homeassistant bash
wget -O - https://get.hacs.xyz | bash -

安装成功后，退出容器，然后重启容器。这一步骤很重要，配置HACS前必须重启Home Assistant。

~/docker/homeassistant/

exit
docker compose restart

2.2 配置 HACS

接下来我们需要初始化 HACS，你可以参考此教程或按照下图步骤配置。注意，你需要提前注册一个 Github 账号。

在“设置”中打开“设备与服务”

点击“添加集成”，搜索并选择“HACS”

根据指引逐步操作，打开提示中的网址，登录 GitHub，输入授权码。

看到下图界面，就说明 HACS 已经安装成功了。

指派设备可以先选“跳过并完成”。

3. 将米家设备接入 HomeAssistant

3.1 安装 Home Assistant 米家官方集成

接下来，我们安装米家官方集成以将米家设备接入HomeAssistant。

进入 HACS 页面，找到“Xiaomi Home”。

点“下载”，然后确认下载。

同样地，安装完集成之后需要重启 HomeAssistant。

~/docker/homeassistant/

docker compose restart

3.2 配置 Xiaomi Home

接下来，我们配置 Xiaomi Home 将米家设备接入 Home Assistant。注意，配置 Xiaomi Home 前需要重启 HomeAssistant。

点击“设置”，选择“设备与服务”

点击“添加集成”，搜索并选择“Xiaomi Home”

登录小米账号以获取设备信息。

在登录认证过程中，如果遇到类似下图的错误提示，通常是因为集成默认使用 homeassistant.local:8123作为OAuth2 认证跳转地址。你可以通过修改路由器或者本地 host，将 homeassistant.local 指向你安装了 Home Assistant 的设备。也可以直接在地址栏修改地址，将homeassistant.local改为对应设备的 IP, 然后刷新网页完成认证。

认证成功后，该页面会自动关闭跳转回 Home Assistant，之后按照指引完成剩余的设备添加步骤即可。

4. 桥接米家设备到 HomeKit

接下来，我们通过 HomeKit Bridge 将 Home Assistant 中设备桥接到 HomeKit。

4.1 在 Home Assistant 中添加 HomeKit Bridge 集成

首先，我们要添加 HomeKit Bridge 集成。点击“设置”，进入“设备与服务”页面。

搜索“homekit”，点击“Apple”

点击添加“HomeKit Bridge” 集成，按照指引完成添加。

需要注意的是，如果你希望桥接传感器类型的设备（如温湿度传感器），确保在“要包含的域”中勾选“Sensor”选项，这个选项默认是未勾选的。

4.2 在 HomeKit Bridge 中排除不必要的实体

HomeKit Bridge 会自动识别 Home Assistant 中的设备。在将其同步到 Apple 家庭 App 之前，建议先检查并禁用一些不需要桥接的实体。

否则可能会出现以下情况：例如，当将小米智能插座添加到 HomeKit 时，插座会被识别为三个设备，除了开关之外，其中插座的指示灯被识别为灯具，插座温度也被误认为环境温度传感器。这可能不是我们期望看到的结果。

在 HomeKit Bridge 的详情页面，点击“配置”

在“排除的实体”列表中，依次添加要排除的实体

4.3 将 HomeKit Bridge 添加到苹果家庭

最后，将配置好的 HomeKit Bridge 添加到你的 Apple 家庭 App 中。点击界面左下角的通知按钮，查看 homekit 的配对二维码。

打开“家庭”应用，点击左上角的“+”号，选择“添加配件”。扫描上个步骤的得到的二维码，点击“添加到家庭”。在加入过程中，可能会提示“未认证设备”，点击“仍要添加”。然后完成剩余步骤，逐个添加设备。完成后，你就能用 Siri 控制你的智能设备了。

5. 常见问题

Siri 回复设备没有回应？

通过上述方法添加设备后，只能在同一局域网内控制该设备。如果出现这种情况，请检查手机是否连接到家庭网络，并进一步确认 Home Assistant 服务状态是否正常。

如何通过 Siri 在局域网外控制家里的设备？

你需要有一个家庭中枢，比如 HomePod 或者 Apple TV。

更新小米集成相关问题

小米官方的 Home Assistant 集成现在还处于早期开发阶段，版本更新时可能会存在破坏性更新。更新前要注意查看更新说明。

其他问题

其他问题？欢迎在评论区留言讨论！

参考链接

https://www.home-assistant.io/installation/linux/#install-home-assistant-container

https://hacs.xyz/

https://hacs.xyz/docs/use/download/download/#to-download-hacs

https://github.com/XiaoMi/ha_xiaomi_home

这篇文章，我想分享我在配置 Docker 容器实现定时任务时遇到的一个问题，以及我是如何解决它的：我最初在容器内使用标准的 Cron 服务来调度 Python 脚本。但我发现，即使把环境变量传入了容器，Cron 触发脚本时依然读不到这部分配置，导致 Python 读取不到 API 密钥。原因是 Cron 不会继承容器的环境变量，它运行在相对隔离的环境中。

为了解决这个问题，我开始在网上搜索并向大语言模型求助，最后得到几个可能的方案：

• 将 .env 文件直接挂载进容器，让脚本从指定路径读取
• 在 entrypoint.sh 文件中，读取环境变量，然后显式地将它们写入 crontab 文件或注入到 Cron 进程环境中
• 使用 Supercronic 或其他替代 Cron 方案

虽然前两种方法可行，但需要额外的配置和脚本处理。经过测试，我最终选择了 Supercronic。它是一个与 Cron 语法兼容、专为容器设计的任务调度工具，用法和原生 Cron 几乎一致，且能够直接继承容器内的环境变量，大大简化了配置过程。将 Cron 替换为 Supercronic 后，问题就迎刃而解了。

如果你有同样的需求，想要通过容器定时运行 Python 脚本或其他程序，我推荐试试 Supercronic。我精简了eudic-maimemo-sync 项目，编写一个基础示例 docker-python-supercronic-example。示例中展示了如何在 Docker 容器里配置 Supercronic，并定时执行 Python 脚本，供大家参考。

接下来我讲讲如何使用这个示例：

.
├── Dockerfile          # 用于构建包含 Supercronic 的 Python 镜像
├── docker-compose.yml  # 容器部署的配置
├── entrypoint.sh       # 生成 crontab 并启动 Supercronic 的脚本
├── test.py             # 按计划运行的示例 Python 脚本
└── requirements.txt    # Python 依赖项

开始使用

1. 克隆此仓库

   git clone https://github.com/emuqi/docker-python-supercronic-example.git
   cd docker-python-supercronic-example
   

2. 为你的架构选择 Supercronic

   Dockerfile 默认配置为 ARM64 架构。对于其他架构（例如 x86_64），需要修改 Dockerfile：

   访问 Supercronic Releases，找到适合你的 CPU 架构的 安装说明。安装说明内一般会包含要添加到 Dockerfile 的代码。

   替换以下部分：

   # 最新版本请访问 https://github.com/aptible/supercronic/releases
   # 根据你的CPU架构选择合适的 Supercronic 版本
   ENV SUPERCRONIC_URL=https://github.com/aptible/supercronic/releases/download/v0.2.33/supercronic-linux-arm64 \
       SUPERCRONIC_SHA1SUM=e0f0c06ebc5627e43b25475711e694450489ab00 \
       SUPERCRONIC=supercronic-linux-arm64
   
   RUN curl -fsSLO "$SUPERCRONIC_URL" \
    && echo "${SUPERCRONIC_SHA1SUM}  ${SUPERCRONIC}" | sha1sum -c - \
    && chmod +x "$SUPERCRONIC" \
    && mv "$SUPERCRONIC" "/usr/local/bin/${SUPERCRONIC}" \
    && ln -s "/usr/local/bin/${SUPERCRONIC}" /usr/local/bin/supercronic
   

3. 创建 .env 文件用于设置环境变量

   CUSTOM_MESSAGE=来自计划任务的问候！
   CRON_SCHEDULE=*/5 * * * *  # 每 5 分钟运行一次

4. 构建并启动容器

   docker compose up -d --build
   

5. 检查日志以验证程序是否按预期运行

   docker logs my_python_cron_job
   

   你应该能看到类似下面的日志输出:

   my_python_cron_job  | time="2025-04-23T18:53:00+08:00" level=info msg="Python script start" channel=stdout iteration=0 job.command="/usr/local/bin/python /app/test.py" job.position=0 job.schedule="* * * * *"
   my_python_cron_job  | time="2025-04-23T18:53:00+08:00" level=info msg="Message: Hello World!" channel=stdout iteration=0 job.command="/usr/local/bin/python /app/test.py" job.position=0 job.schedule="* * * * *"
   my_python_cron_job  | time="2025-04-23T18:53:00+08:00" level=info msg="job succeeded" iteration=0 job.command="/usr/local/bin/python /app/test.py" job.position=0 job.schedule="* * * * *"

配置

环境变量

Cron 计划表达式示例

• * * * * * - 每分钟
• */5 * * * * - 每 5 分钟
• 0 * * * * - 每小时（0分时）
• 0 0 * * * - 每天午夜
• 0 18 * * * - 每天下午 6:00

自定义

1. 用你自己的 Python 脚本替换或修改 test.py
2. 通过编辑 .env 文件或 docker-compose.yml 中的 environment: 部分来扩展或覆盖变量。添加的任何新变量（例如 NEW_VAR=value）都将被加载到容器中。
3. 将所需的任何依赖项添加到 requirements.txt
4. 重新构建并运行容器：docker-compose up -d --build

因此，我在寻找一种方法，将欧路词典的生词本同步到墨墨背单词的词库。这样，我就可以用自己习惯的软件来记忆日常阅读中遇到的生词了。

后来我发现，这两个软件其实都提供开放 API。于是，我开发了 eudic-maimemo-sync 工具，实现欧路词典生词本到墨墨背单词云词库的自动同步。同时，我还将其部署在树莓派上，让它每天自动运行，实现了生词本的无缝同步。

接下来，我将介绍如何配置和使用这个工具，并分享开发过程中遇到的一些问题和解决方法。也欢迎大家贡献代码或提出建议。

目录

• eudic-maimemo-sync 使用教程
  • 1. 下载代码安装依赖
  • 2. 配置环境变量
    • 2.1 欧路词典相关配置
    • 2.2 墨墨背单词相关配置
  • 3. 手动同步
  • 4. 自动同步（部署到树莓派上或者其他 Linux 设备）
    • 使用 Docker
    • 使用其他方式
• 开发中遇到的问题
• 相关链接

eudic-maimemo-sync 使用教程

1. 下载代码安装依赖

前置条件：已安装 Python 3 环境

下载代码：

git clone https://github.com/eMUQI/eudic-maimemo-sync.git

安装依赖：

cd eudic-maimemo-sync
pip install -r requirements.txt

2. 配置环境变量

接下来，需要配置环境变量。首先，复制 .env.example 为 .env。

2.1 欧路词典相关配置

• 获取欧路词典 API 密钥

  访问此页面，登录后，获取你的API密钥。并将获取到的 API 密钥填入.env文件中的EUDIC_API_KEY字段。

  

• 获取生词本 ID

  运行 get_wordbook_id.py，查看生词本信息，记下你需要同步的生词本 ID。

  python get_wordbook_id.py

  

  将需要同步的生词本 ID 填入 .env 中的 EUDIC_CATEGORY_ID。

2.2 墨墨背单词相关配置

• 获取墨墨背单词 API 密钥

  打开墨墨背单词手机 App，进入「我的」-「更多设置」-「实验功能」-「开放 API」，生成并复制 API 密钥，然后将其填入 .env 文件中的 MOMO_API_KEY 字段。

• 获取云词库 ID

  运行 get_notepad_id.py，查看云词库信息，记住你需要同步的云词库 ID。

  python get_notepad_id.py

  

  将需要同步的词库 ID 填入 .env 文件中的 MOMO_NOTEPAD_ID 字段。

3. 手动同步

运行 sync.py，即可手动触发一次同步。

python sync.py

4. 自动同步（部署到树莓派上或者其他 Linux 设备）

确保部署前已经成功手动运行过 python sync.py，验证配置无误。

使用Docker

我个人比较喜欢用 Docker， 隔离性好，依赖管理简单，不会弄乱系统的环境。在我的树莓派 5 上运行良好，额外的性能开销在可接受范围内。

创建一个 docker-compose.yml 配置文件:

services:
  eudic-maimemo-sync:
    image: ghcr.io/emuqi/eudic-maimemo-sync:latest
    container_name: eudic-maimemo-sync
    restart: unless-stopped
    env_file:
      - .env
    # volumes:
    #   - ./words_data.txt:/app/words_data.txt # 如果想查看单词记录，取消此行和上一行的注释
    environment:
      - TZ=Asia/Shanghai
      - RUN_ON_STARTUP=true # 设置为 true 时，容器每次启动时会执行一次同步任务
      # CRON 定时任务表达式配置:
      # 示例：每小时的第 0 分钟执行（即整点执行）
      # - CRON_SCHEDULE=0 * * * *
      # 示例：每天凌晨 3:15 执行
      - CRON_SCHEDULE=15 3 * * *
      # 请确保所有必需的环境变量（如 EUDIC_API_KEY 等）已在 .env 文件中定义或在此处直接指定。
    healthcheck:
      # Test if the supercronic process is running
      test: ["CMD-SHELL", "pgrep supercronic || exit 1"]
      interval: 2m
      timeout: 5s
      retries: 3
      start_period: 10s

你可以通过 CRON_SCHEDULE 来设置任务的运行周期：

• CRON_SCHEDULE=0 * * * *: 每小时的第 0 分钟执行（即整点执行）
• CRON_SCHEDULE=15 3 * * *: 每天凌晨 3:15 执行

在相同目录下创建一个 words_data.txt 文件，用于记录同步的单词列表，方便调试或查看。如果不需要，可以跳过此步。

touch words_data.txt

启动容器

docker compose up -d

其他方式

你还可以使用 cron 或者 systemctl 的方式来定时运行这个同步脚本。如果你熟悉这些工具的配置，欢迎分享你的方法或提交 Pull Request。

开发中遇到的问题

1. 欧路词典 API 的 User-Agent 要求： 欧路词典 API 对请求的 User-Agent 有特定要求，不接受 Python HTTP 库（如 requests）的默认 User-Agent。因此，在与该 API 交互时，必须显式设置一个浏览器类型的 User-Agent，以确保请求被正确处理。本项目中，我采用了 Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36。

2. 墨墨背单词 API 云词库格式： 墨墨背单词 API 文档中关于添加单词到云词库所需的数据格式说明不够清晰。文档中只说明数据类型是 string，但未明确其具体结构。经过试验，结构为以井号 # 开头的行作为分类标记（例如日期），换行后紧跟该分类下的单词，每个单词独占一行。下一个分类同样以 # 开头的标记开始。如 #20250415\napple\nboy#20250416\ncat。

   #20250415
   apple
   boy
   #20250416
   cat

3. Docker 中定时任务：从 Cron 到 Supercronic 的迁移： 一开始，我尝试在 Docker 容器内部署 Cron 来定时执行 Python 任务。但是，Cron 任务默认在隔离的、极简的环境中执行，无法直接继承 Docker 容器启动时定义的环境变量（例如 API 密钥等配置）。虽然有方法可以间接加载，但配置比较繁琐。于是我迁移到了 Supercronic。Supercronic 是一款专为容器环境设计的 Cron 实现，它兼容标准的 Crontab 语法，还能继承容器的环境变量。如果你有类似的项目，推荐你使用 Supercronic 作为替代方案。

最后，欢迎提交 Pull Requests 或 Issues 到 eudic-maimemo-sync。有任何想法，也欢迎在下方留言。

相关链接

• 欧路词典生词本API
• 墨墨背单词开放API
• eudic-maimemo-sync

第一篇是 《On the benefits of learning in public》，讲述了 "learn in public" 的好处，比如能够巩固和深化知识。我写的大多数文章其实都是教程，也算是 "learn in public" 的一种实践，但我有时会怀疑这些教程是否真的有意义，因为它们看起来很简单、基础，似乎谁都能写，不够深刻。我会质疑那些记录基础操作步骤的文章是否值得发布——毕竟它们有时看起来只是对官方文档的简单复述，或是任何开发者通过Google都能找到的常见解决方案。如果说只是为了记录下来，方便以后自己查询，也许它们呆在个人知识库就足够了。

这篇文章给了我启发：他把自己写的教程描述为“我希望在刚开始学习时就能找到的文章”（"tutorials that I wished someone else had written for me before I started trying to learn this stuff"）。这句话让我豁然开朗：即使是简单的教程，只要它能够帮助初学者少走弯路，就有其独特价值。这在很大程度上消除了我的疑虑，给了我很大的鼓舞，因为这也正是一直以来我希望自己的文章能够达到的标准。

比如我的这两篇文章，或许就是某个人摸索时的及时雨：

https://wulu.zone/posts/whisper-cn

https://wulu.zone/posts/mi-iot-homekit

另一篇是 《It's still worth blogging in the age of AI》，这篇文章探讨了在人工智能普及的时代，博客写作的意义。在他的上一篇文章登上 Hacker News 热门后，一个常见的问题浮现：如果人们都在使用 ChatGPT、Claude 和 DeepSeek 获取信息，谁还会阅读博客内容？除了 AI，还有谁会阅读你写的内容？Giles 认为是值得的，并且给出了他的思考。我觉得如果你是博客作者，你能在其中找到共鸣，推荐大家去看。

我为什么写博客？

读完这两篇文章，我再次思考：我为什么写博客？这个问题其实早已存在。从为了满足自己拥有网站的虚荣心而搭建博客的最初时期，到随性有灵感时更新，再到中途停笔的时期，到最后现在有意识地重新开始写作。这种问题总会反复出现。

尽管与作者笔耕不辍不同，我的博客更新并不频繁，不太算是一个经常写博客的人。但文章中提到的几点博客写作的价值依然让我共鸣：

1. 知识结构化：将知识记录下来帮助自己更好地掌握，而且也方便后续查询
2. 成就感：当别人阅读并从我的文章中获益时带来的那种多巴胺刺激
3. 个人品牌：通过博客创建一个能展示自己思想观点的作品集

我认可费曼学习法和 "learn in public" 等观念，就像文章提到的“如果你不能向一个聪明且感兴趣的听众解释清楚某件事，那么你就没有真正理解它。”。写作是思考的升华过程。当我们将想法用自己的语言阐述时，思维才得以精细的加工。而且为了准确表达，我常常会查阅额外资料，这本身是一个深度学习的过程。

记录下这些教程还有一个好处：文字是对抗遗忘的工具。记忆并不那么可靠，记录下来后，回头再看当时写下的文章，能够帮助自己回溯。文字能够复现消逝的自我。

另一方面，写作对我而言除了是一种思想训练和学习方式，更是一种存在的证明。在《直视骄阳》这本书中了解到波动影响理论后（在我的《2024 读书总结》中有提到，如果你感兴趣的话），我发现写作能有效缓解我的存在焦虑。

刚接触互联网时，我就读到了《欺骗的艺术》这本书，了解了社会工程学，对在互联网上分享信息产生了警惕。这种警惕加上我的性格特点，导致我一直以来很少在互联网上透露个人信息，甚至很少写一些感想类的文章。我的博客大多数聚焦于技术分享，个人观点则被谨慎地隔离在外。

直到经历了一场深刻的心理危机，接受心理咨询并广泛阅读心理学和哲学书籍后，我的世界观发生了微妙的转变。我开始渴望与人连接，期待真诚的交流。这种认识让我开始思考在博客上分享更多个人感想的可能。虽然仍有矛盾和犹豫，但我开始相信，适度的自我揭示和真诚分享不仅是自我成长的一部分，也可能为他人提供某种共鸣或安慰。我期待我的文字能够帮助人，与更多人产生联系，传播那或许是非常微小但真实的影响。

写作帮助我整理思绪，获得分享的快感，同时也是应对生活空虚感的方式。即便有时感觉像 Giles 文章中提到的 "feel like you're shouting into the void" （就像对着虚空喊叫），但偶尔从“虚空”传来的一条留言、一个点赞，都将成为继续前行的动力。

AI 时代的写作价值

在AI盛行的时代，我认为坚持写作变得更加重要。从我的理解来看，现阶段的大语言模型本质上还是基于概率的文本生成，而每个人独特的思考和写作方式是无法被完全替代的。当越来越少的人选择写作，那些仍然坚持的声音反而变得更加珍贵，更加真实，充满温度和灵魂。写作不仅是信息的传递，更是人类思想和情感的独特表达。

这就是为什么，尽管面对AI的崛起，我依然相信博客写作的价值——它帮助我思考，连接他人，留下我存在的印记，同时也为这个世界贡献一份真实的人类声音。

题外话：一个邀请

在浏览 Hacker News 的关于上面文章的评论区时，我被 Aditya Athalye 的做法所吸引——他学习Derek Sivers和patio11的做法，在他的网站放了一份“长期邀约”。

我觉得这种方式很吸引我，我也想学习这种方式，以下是我的对所有人发起的邀请：

如果你对我的文章，或者我所讨论的任何主题感兴趣，欢迎你给我发送邮件。我的邮箱地址是：wulu@wulu.zone

我会不定期查看邮件，可能我无法及时回复，但我承诺只要你是以友善和尊重的态度联系我，我一定会回应。每一次真诚的交流都可能成为意外的收获和启发，或许这也是在AI时代写博客和保持人际连接的另一种价值所在。

谢谢你的阅读！期待收到你的来信。

注意：自行更换电池可能会影响手表防水性能，并存在进灰等风险。

需要准备的工具

• 镊子
• 螺丝刀
• CR2016电池（建议选松下，和出厂时一致）
• 防静电手套以避免指纹和灰尘（如果有的话）

操作步骤

1. 拆出后盖

用螺丝拧开后盖。然后取下这个膜，记住这个膜的方向。

2. 打开电池扣取出电池

打开后盖，取下中间的厚后，可以看到机芯模块。用镊子插入左图箭头所示缝隙，向右撬开电池盖。

缓慢地取出电池，需要注意，电池和电池盖之间有胶，所以要慢慢撕下来。

3. 更换电池

然后，换入新电池。这款手表的电池型号是 CR2016。放入电池后将电池盖向下按，扣回去。

4. 短接AC和地

按照电池盖上的说明，用镊子短接AC和地。

5. 盖上覆膜和安装好密封圈

将覆膜按初始状态放回，注意区分正反面。然后安装密封圈（黑色橡胶环），请参考右图箭头所示位置，确保密封圈正确放入对应槽内。

随后，可以利用这个机会用酒精棉片轻轻清洁表壳内部边缘和外壳，去除积累的汗渍和污垢。注意不要让酒精接触到电子元件，并确保完全干燥后再继续下一步。

6. 装回后盖，大功告成

拧螺丝时要注意，不要直接拧紧。先将四个螺丝全部拧入，再依次拧紧。

注意事项

• 强烈建议看完两个参考视频后再动手
• 整个过程大约需要15-20分钟，建议在光线充足、干净的桌面上操作
• 更换电池后，手表需要重新设置时间和日期
• 如果操作后发现手表功能异常，建议尽快送专业维修点检查

如果你决定自行更换电池，那么祝你好运！

参考

卡西欧 G-SHOCK GBA-800 使用手册

https://www.youtube.com/watch?v=8MBkgxxEeI8

https://www.bilibili.com/video/BV1PA411P7UB

《蛤蟆先生去看心理医生》

作者：罗伯特·戴博德
译者：陈赢
出版社：天津人民出版社

一本很薄的故事书，有点像童话或者寓言故事，如书名，讲述了蛤蟆先生去看心理医生的故事。 读起来很轻松，流畅，一下就可以读完。这本书提供了一个了解心理咨询的视角，是一本不错的心理学读物。 书中还科普了交互分析理论（Transactional Analysis，TA）中的儿童自我状态，父母自我状态，成人自我状态。这个理论认为我们会在这三种状态不停地切换，非常有趣的理论，有助于帮助了解自我。

《直视骄阳》

作者：Irvin D. Yalom
译者：张亚
出版社：中国轻工业出版社

这是一部关于如何面对死亡的深刻著作。

这本书讲了死亡焦虑的普遍性，如何识别死亡焦虑，它能够带来什么，以及我们可以如何去面对它。

对我而言，这本书帮助最大的就是带我了解了伊比鸠鲁的观念：

• 死亡本身不可怕，因为我们无法感受死亡，死后“我”就消失了，即“完全虚无的死亡”。
• 生前和死后，是对称的两极。死后其实和生前并无差别。
• 波动影响。指人有意无意会对周围的任何事物产生影响，就像池塘中的涟漪，即使细微但是很长远。

这本书给了我一些方法去处理我的死亡焦虑，也给我带来了一些新的思考去看待自己的死亡和他人的死亡。书中还讨论了死亡意识如何反过来影响我们的生活态度,以及如何将对死亡的思考转化为珍惜当下的动力。如果你有存在焦虑或者死亡焦虑，我非常推荐这本书。

《非暴力沟通》

作者：马歇尔·卢森堡
译者：刘轶
出版社：华夏出版社

这本书介绍了非暴力沟通。也是一种生活理念。它提示我要关注自己内心的感受和需求，真诚地与人沟通。

通过把注意力放到观察、感受、需求和请求这四个要素来改善沟通，同时非暴力沟通还强调自主的重要性，强调个人责任。我觉得这一点和存在主义的观念是很吻合。

书中还提到了很多非常有意思的讨论：比如观察和评论的区别，请求和要求的区别。这些讨论不仅帮助我反思与人的沟通，也帮助我反思人际关系。

非暴力沟通方法在亲密关系中尤其有效,能帮助伴侣之间建立更深入的理解和连接。

书中还有很多内容，需要真正去读并且实践才有用，非常有帮助，非常推荐这本书。

《Headspace 冥想正念手册》

作者：安迪·帕帝康
译者：李芳龄
出版社：星出版

这本书科普了冥想和正念，有很多帮助理解冥想的故事，还提供一些方法帮助入门冥想。

之前一直听说过冥想，听过很多关于冥想的传闻，却也没有真正了解过。今年特别想尝试一下冥想，买了这本书来了解一下，让我对冥想有了不同的认识。书中还提供了很多隐喻帮助理解冥想。我也尝试了冥想，对我而言确实有帮助的。

如果你也对冥想感兴趣，或者正在尝试但觉得摸不着头绪，很推荐这本书。我看的这个版本是繁体中文，还有一个简体中文的版本，名字是《十分钟冥想》。

《天生敏感》

作者：伊莱恩·阿伦
译者：于娟娟
出版社：华夏出版社

这是一本讲述所谓高敏感人群的特质的书。

听了枫言枫语的节目，专门看了这本书。我大致也属于比较敏感的人群，这本书帮助高敏感人群了解自我，理解自我，并且提供了一些方法更好的与外部世界相处。还有很重要的是，能够带来很大的认同感。

《素食者》

作者：韩江
译者：胡椒筒
出版社：四川文艺出版社

这是一本小说，由2024年诺贝文学奖作者韩江写的。书中通过三个视角来叙述同一个故事，这点比较有趣。我是慕名去看，没有我想象中的好看，整本书像是讲述几个精神病的故事，很压抑。

《也许你该找个人聊聊》

作者：洛丽·戈特利布
译者：张含笑
出版社：上海文化出版社

这是一本讲述心理咨询的书。这本书很厚，由一个心理咨询师的视角写作，书中以一个个故事组成，每一个章节是一个故事，有作者本人的故事，也有作者作为心理咨询师在咨询室里遇到的故事。虽然很厚但是读起来没有压力，可以慢慢看看，每天看几个故事。我喜欢这本书不是一本说教的书，平易近人，没有让人感觉是在尝试告诉你什么道理，而是通过一个个故事，让你自己去感受，找到自己的理解。

结语

希望今年能保持阅读的习惯，也期待遇见更多好书。

这种声音的立体移动效果，实际上是通过精妙的声道控制实现的。

具体而言，声音的左右穿梭可以通过调整左右声道的音量来完成。比如，我们可以逐步减弱左声道的音量，同时逐渐增强右声道的音量。这种渐进式的音量变化，会给观众造成声音从左向右流动的听觉错觉，仿佛声音正在穿越立体空间。通过细腻地控制声音的转换，我们可以为视频增添一层令人着迷的听觉维度，提升视听体验。

接下来，我将分享如何使用 Audacity 制作这种立体音。

安装 Audacity

你可以前往 Audacity 或者是它的 Github 页面下载。但需要是要注意的是，在官网下载时，如果你没有选择 “Download without Muse Hub” 选项，那么它可能会捆绑安装 Muse Hub。

你还可以安装可选的 FFmpeg 库。如果你要使用 Audacity 编辑 AC3, M4A, MP4 或 WMA 格式的音频，则是必须的。

https://support.audacityteam.org/basics/installing-ffmpeg

1. 使用包络工具标记左右声道切换的位置

将音频导入 Audacity，你可以直接将音频拖入 Audacity 或者选择“文件 > 导入 > 音频”。

然后你可以看到音频的波形图：

首先我们使用“包络”工具标记声道切换的位置。

找到“包络”工具，

在期望声音左右切换的位置点一下，标记声音切换的位置，方便后面我们调整各声轨的音量变换。

比如，我想要每一秒声音切换（声音从左到右或者从右到左）一次，我就每隔一秒标记一下：

2. 分离音轨左右声轨

点击“分离立体声轨”，将左右声道分开成两个声轨，方便编辑。

3. 分别调整左右声轨

分离声轨后，上面的声轨代表左声道，下面的声轨的右声道。这样就能分别控制左耳和右耳听到的声音。按照下图的方式调整声轨。

逐渐减弱左耳听到的声音，同时逐渐增强右耳的声音，就能制造声音从左到右的效果。

同理，逐渐减弱右耳听到的声音，同时逐渐增强左耳的声音，就能制造声音从右到左的效果。

反复调节，调整到你期望的效果：

最后，通过“文件 > 导出音频”，导出降噪后的音频。

参考链接

https://manual.audacityteam.org/man/envelope_tool.html

更多

https://wulu.zone/posts/audacity-noise-reduction-guide

我找到了 Audacity，它轻量化（不到100MB）且是开源的，功能强大易于使用。它的降噪功能，总体感觉比 CapCut 好。在 Audacity 中，可以选择噪音样本，再设定降噪范围，并且可以调整降噪的参数，最后的效果也比 CapCut 更佳。

接下来，我分享如何使用 Audacity 降噪音频。

安装 Audacity

你可以前往 Audacity 或者是它的 Github 页面下载。但需要是要注意的是，在官网下载时，如果你没有选择 “Download without Muse Hub” 选项，那么它可能会捆绑安装 Muse Hub。

你还可以安装可选的 FFmpeg 库。如果你要使用 Audacity 编辑 AC3, M4A, MP4 或 WMA 格式的音频，则是必须的。

https://support.audacityteam.org/basics/installing-ffmpeg

1. 取得噪音特征

将音频导入 Audacity，你可以直接将音频拖入 Audacity 或者选择“文件 > 导入 > 音频”。

然后你可以看到音频的波形图：

用鼠标左键选取噪音样本（仅包含你想要减少的噪音的区域），然后点击“效果器 > 噪音移除与修复 > 降噪”：

然后 ，点击“取得噪音特征”。

2. 调整参数降噪音频

接下来，选择你要降噪的范围：

然后再次点击“效果器 > 噪音移除与修复 > 降噪”：

点击“预览”可以听降噪后的效果，调整降噪的参数，直到预期的效果。这通常最好通过反复试验来完成，调整滑块并使用预览按钮聆听降噪后的音频。最后，点击“确定”。

• 降噪强度(dB): 控制对识别噪声所应用的音量减少量。使用能将噪声减至可接受水平的最低值。高于必要的值可能使噪声更安静，但会导致剩余音频受损。
• 灵敏度：控制音频中有多少被视为噪声，范围是 0（关闭）到 24（最大）。灵敏度越高，意味着去除的噪声越多，但也可能会去除一些所需的信号。较低的灵敏度可能会在降噪后的音频中留下伪影（不自然的声音失真）。建议将灵敏度设置为能有效去除噪声且不出现失真的最低值。
• 频率平滑（频带）：当值为 1 或更高时，此控制将噪声降低扩展到指定数量的相邻频段中。这会修改您打算保留的信号，但是如果在降噪音频中残留伪影，平滑可以使这些伪影听起来更可接受。平滑可能会使所需的音频不太清晰，因此当噪声较轻时，请尝试将此控件保持在 0（关闭）。

最后，通过“文件 > 导出音频”，导出降噪后的音频。

参考链接和拓展链接

除了上面的方法，你还可以通过 Audacity 使用频谱编辑（Spectral Editing）、噪音门（Noise Gate）和陷波滤波器（Notch Filter）等方式来降噪音频，如果你感兴趣，下面是参考链接：

https://support.audacityteam.org/repairing-audio/noise-reduction-removal

https://manual.audacityteam.org/man/noise_reduction.html

https://manual.audacityteam.org/man/alternative_noise_reduction_techniques.html

我觉得这个项目很有意义，它为儿童编程学习提供了优质资源。我希望能够通过将其翻译成中文，让中文世界的孩子们更方便地获取这些教育资源。因此，我参与了翻译活动，翻译了其中的两个 Scratch 项目。

现在，Moonhack 2024 已经正式启动，我希望通过这篇文章，向更多人推广这个活动，提供多一种学习编程的方式。即使不参加活动，活动中提供的项目教程也是个不错学习资源。

Moonhack 是什么？

Moonhack 是一项面向青少年的免费国际编程挑战赛，由 Code Club Australia 每年举办。在过去的 8 年里，超过 190,000 名儿童一直在编写 Moonhack 项目。

你可以在这里查看往年的项目：https://moonhack.com/previous-projects/

Moonhack 2024

Moonhack2024 于 10 月 14 日至 31 日举行。今年的主题为：气候变化。这些项目将帮助参与者了解从农业工作者如何利用气候数据提高农作物产量和实践可持续农业，到全球气温上升对海洋生物种群的影响等话题。

参与者可以使用 Scratch、micro：bit 或 Python 进行编程。

今年有六个项目，感兴趣的可以前往 Moonhack 官网了解：

• Great Pacific Garbage Patch 大太平洋垃圾带（不限制编程平台）

  在任何编码平台中使用您的编码技能，创建一个可以清理太平洋大垃圾带的解决方案。

  项目主页 | 中文教程PDF

  

• In Deep Water 深陷水中（Scratch项目）

  创建一个迷宫游戏，帮助减缓上升的水位。帮助乌龟在水位上升之前回到地球。

  项目主页 | 中文教程PDF

  

• Sweeten the Crop 让作物更甜美 （Scratch项目）

  你能种出完美的甘蔗作物吗？创建一个点击游戏，尽力尝试一下吧。

  项目主页 | 中文教程PDF

  

• Water Adventure 水之旅（Scratch项目）

  创建一个展示水循环的动画。然后进一步开发，反映人类的影响。

  项目主页 | 中文教程PDF

  

• Talking Rubbish 垃圾会说话（micro：bit项目）

  创建一个设备，用于跟踪放入垃圾桶中的垃圾类型，并利用数据制定行动计划。

  项目主页 | 中文教程PDF

  

• Turtles and Temperature 海龟与温度（Python项目）

  编写一个程序，利用温度数据来观察这对海龟幼崽性别的影响。

  项目主页 | 中文教程PDF

  

相关链接：

https://www.raspberrypi.org/blog/moonhack-2024/

https://moonhack.com/

https://www.codeclubau.org/moonhack-2023/

Follow 是一个最近新出的 RSS阅读器，由 RSSHub 的作者 DIYgod 的新团队 RSSNext 开发。

我喜欢 RSS 这个概念，尤其是 RSSHub 使得许多原生不支持 RSS 的网站和平台都能够通过 RSS 来订阅，让 RSS 有更多可能。我喜欢互联网开放的理念，更倾向不受特定平台限制地获取信息，并希望避免推荐算法的影响。长期以来，我使用 FreshRSS 来管理的 RSS 订阅。看到 Follow 这个新兴的 RSS 阅读器项目出现，我感到非常兴奋，期待它为 RSS 生态注入新的活力。

Follow 目前处于内测阶段，需要邀请码才能体验。当我在社交媒体看到 Follow 的宣传时，我向 DIYgod 私信，并且幸运地获得了一个邀请码以参加早期测试。现在我使用 Follow 已经差不多一个月，接下来谈谈我的体会。如果你也对Follow 感兴趣，文末我提供了两个邀请码。

Follow 吸引我的地方

• 出色的UI设计和动效

  具体可以查看 Follow 的核心开发者 Innei 写的文章《浅谈 Follow 中的设计理念》，这里就不再赘述。

• 与 RSSHub 深度结合

  通过与 RSSHub 深度结合，Follow 提供了非常便捷的订阅体验，你可以直接在 Follow 里面搜索订阅 X、bilibili、youtube 等热门的社交平台以及各种 RSSHub支持的网站。

  

• 对媒体提供不同的视图

  在不同的视图下，Follow 将 RSS 订阅以不同的形式呈现。大多数的 RSS 阅读器，只提供了一个统一的视图，也就是文章视图。而 Follow 团队别出心裁的为各个视图设计不同的信息处理方式。

  比如在“播客视图”，你会感觉 Follow 变成了一个优秀的播客播放器。有一个精致的播放器，展示 shownote，甚至支持点击 shownote 中时间轴节点跳转播放进度。

  

  在“视频视图”，信息以视频封面呈现。点击视频，能够直接在 Follow 播放视频。

  

  

• 自动化 提供了丰富的自动化能力，比如AI摘要、翻译、重写和 Webhooks 等。

  

• 处于活跃开发阶段，反馈问题能够快速的处理

  Follow的开发者非常活跃，也有全职开发人员，问题处理的速度很快。有功能请求开发者也会积极考虑和开发。我反馈了一些问题都得到了回复和处理。

  

缺点？

谈完了又优点，再来谈谈我认为的一些缺点。其实也不至于说是这款软件的缺点，只能说是我个人不是那么喜欢的地方。

• 默认索引用户订阅的站点，可能暴露付费RSS订阅或者私人订阅。目前，Follow 自动将用户的 RSS 订阅整合到其数据库中，并在其他用户搜索时显示。虽然这提高了用户体验，但也带来了隐私和安全风险。特别是对于私人RSS源（如Wallabag）或付费内容，即使选择了"私人关注"，它们仍可能被包含并被公开搜索。我向 Follow 反应了这个问题，但是遗憾的是开发团队认为这不是目前开发的重点。

• 后端不是开源的，无法自部署。这一点就见仁见智，习惯了使用 FreshRSS，我确实有点贪心希望 Follow 能够自部署。我看到 Follow 团队正在招聘全职开发、产品经理和市场营销专家。我猜测 Follow会发展成为一个付费服务，如果定价合理的话，我会愿意支持。希望Follow 团队能够越走越远。

展望

• 修正隐私问题，在维护互联网开放的精神同时，保护用户的隐私。克制合理地分享。
• 发布移动版本。

Follow内测邀请码

如果你曾在 RSSHub 项目贡献过代码，你可以直接私信 DIYgod 或者 Follow 的X账号获取邀请码。

你也可以向内测用户获取邀请码，这里提供两个邀请码，先到先得，使用后请在评论区反馈。如果你很想参加内测，也可以直接评论，并且谈谈你对Follow 的看法，我会直接在评论回复邀请码。但是我的邀请码也十分有限（10天一个），只能尽量邀请。

• 8i19XX0IQa （已使用）
• 4d8Xv451u8（已使用）

241024更新：现在 Follow 已经开始 Beta 测试，不用邀请码也能体验一些功能，但是会有一些限制。

• soGuIpSY1Q（已使用）

241125更新：现在 Follow 网页终于支持移动端访问了，还支持PWA! 在墨水平板上也能使用，效果也很不错。

• cMGg7BIhgy（已使用）
• Wa65ezWJTP（已使用）

2025.02.14 更新的新邀请码：

• nkTrKI8ZPA（已使用）
• 05C71sAN4L（已使用）
• QQUyUYGOJY（已使用）

2025.03.01 更新

Follow 开始了 ios 内测，原生支持移动端了🎉

分享几个新的邀请码：

• 8uEXAEpB6K（已使用）
• 3xXiqHMCEj（已使用）
• BTmconUxsQ（已使用）

2025.03.23 更新：Follow 正式发布 iOS 版本 Folo

https://apps.apple.com/us/app/folo-follow-everything/id6739802604

分享几个新的邀请码：

• fbsYJICV12（已使用）
• GgdjYNUTMz（已使用）
• K5GQEjXUHe（已使用）
• wxIoi5HpFE（已使用）
• sq_cuxWahO（已使用）

欢迎在 Follow 上订阅本博客：https://app.follow.is/feed/53322153570297857

我整理的 STEAM 教育硬件资讯列表：https://app.follow.is/share/lists/72173389013837824

学习英语的播客列表：https://app.follow.is/share/lists/92088247676273664

You tried to access openai.ChatCompletion, but this is no longer supported in openai>=1.0.0 - see the README at https://github.com/openai/openai-python for the API.

You can run `openai migrate` to automatically upgrade your codebase to use the 1.0.0 interface.

Alternatively, you can pin your installation to the old version, e.g. `pip install openai==0.28`

A detailed migration guide is available here: https://github.com/openai/openai-python/discussions/742

openai>=1.0.0 示例

在查看了提示中迁移说明的后，写一个基本示例来调用openai>=1.0.0版本，供大家参考：

说明：代码中设置 base_url 以自定义主机，从而能够使用第三方 OpenAI 代理，这个选项的可选的，如果你使直接访问openai的服务，可以删除这一个配置。

from openai import OpenAI

client = OpenAI(
  api_key="xxx",
  base_url = 'xxx'
)

def get_completion(prompt, model="gpt-3.5-turbo-1106"):
    messages = [{"role": "user", "content": prompt}]
    response = client.chat.completions.create(
        model=model,
        messages=messages,
        temperature=0.7,
    )
    return response.choices[0].message.content

prompt = "你好，ChatGPT！"

print(get_completion(prompt))

如果要启用 OpenAI 新推出的 JSON mode：

def get_completion(prompt, model="gpt-3.5-turbo-1106"):
    messages = [{"role": "user", "content": prompt}]
    response = client.chat.completions.create(
        model=model,
        messages=messages,
        response_format={"type": "json_object"},
        temperature=0.7,
    )
    return response.choices[0].message.content

openai==0.28 示例

import openai

openai.api_key  = ''
openai.api_base = ''

def get_completion(prompt, model="gpt-3.5-turbo-1106"):
    messages = [{"role": "user", "content": prompt}]
    response = openai.ChatCompletion.create(
        model=model,
        messages=messages,
        temperature=0.7,  
    )
    return response.choices[0].message["content"]

prompt = "你好，ChatGPT！"

print(get_completion(prompt))

【2024.12.17更新】：下文方法仍然可用，基于 Xiaomi Miot Atuo 集成。但近日小米发布了官方的Home Assistant 集成，目前处于初期阶段，尚有一些问题。等版本稳定后，我会将下面的方法切换到米家官方集成。如果你感兴趣，可以在文末输入邮箱订阅本博客以获取更新。

【2025.05.10更新】：使用小米官方集成的教程已经写好了，请查看《使用 Home Assistant 将米家设备接入 HomeKit 教程》

最近把常用的米家设备都接入到了HomeKit，这样就可以通过Siri来控制住处中的智能设备了。

具体原理是：使用树莓派安装HomeAssistant，连接米家设备。通过 HomeAssistant 中的 HomeKit Bridge 集成，将米家设备桥接到 Apple HomeKit。这样就可以通过Apple的家庭应用和Siri来控制这些设备，即使它们不支持HomeKit。

目录

• 1.安装HomeAssistant
• 2.安装与配置 Home Assistant 社区商店
  • 2.1安装 HACS
  • 2.2配置 HACS
• 3.将米家设备接入HomeAssistant
  • 3.1安装 Xiaomi Miot Atuo
  • 3.2配置 Xiaomi Miot Atuo
  • 3.3删除不必要的实体（非必要，但强烈推荐）
• 4.桥接米家设备到HomeKit
• 5.常见问题

我的树莓派配置

Raspberry Pi 4b 4gb
OS: OpenWrt
Kernel: aarch64 Linux 5.4.203

1. 安装HomeAssistant

HomeAssistant 支持多种安装方式，对于树莓派来说，大致有三种方法：

1. 安装 Assistant 操作系统
2. 使用容器安装（比如Docker）
3. 直接安装Home Assistant Core

为了便于管理，我选择使用Docker-compose来安装HomeAssistant。

如果你和我一样使用的是openwrt系统，参考官方教程，你可能会遇到以下错误：

[+] Running 0/1
 ⠿ Container homeassistant  Starting                                                                             0.3s
Error response from daemon: error while creating mount source path '/etc/localtime': mkdir /etc/localtime: file exists

错误的原因在 HomeAssistant论坛 可以找到。这里是我解决问题的方法：删除原.yml文件中- /etc/localtime:/etc/localtime:ro，将时区作为环境变量传递。

修改后的docker-compose.yml：

~/homeas/docker-compose.yml

version: '3'
services:
  homeassistant:
    container_name: homeassistant
    image: "ghcr.io/home-assistant/home-assistant:stable"
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - ~/homeas/config:/config
    restart: unless-stopped
    privileged: true
    network_mode: host

安装完HomeAssistant后，访问树莓派的 8123 端口。初始化HomeAssistant，设置管理员账号密码。

2. 安装与配置 Home Assistant 社区商店

2.1 安装 HACS

配置完 HomeAssistant 后，我们需要安装 HACS（Home Assistant Community Store）。你可以将其理解为 HomeAssistant 的应用商店，通过 HACS 我们能够安装第三方集成来增强 HomeAssistant 的功能。

参考 HACS安装指南，我们需要进入容器内部执行安装脚本。

~/homeas/

docker exec -it homeassistant bash
wget -O - https://get.hacs.xyz | bash -

安装成功后，退出容器，然后重启容器。这一步骤很重要，配置HACS前必须重启Home Assistant。

~/homeas/

exit
docker-compose restart

2.2 配置 HACS

接下来我们需要初始HACS，你可以参考此教程或按照下图步骤配置。注意，你需要提前注册一个 Github 账号。

在“设置”中打开“设备与服务”

点击“添加集成”，搜索并选择“HACS”

跟据指引一步一步操作，打开提示中的网址，登录GitHub，输入授权码。

看到下图界面，就说明HACS以及安装成功了。

3. 将米家设备接入HomeAssistant

3.1 安装 Xiaomi Miot Atuo

接下来，我们需要安装 “Xiaomi Miot Atuo” 集成以将米家设备接入HomeAssistant。

进入 HACS 页面，点击 “集成”。

点击右下角的“浏览并下载储存库”，然后搜索并安装“Xiaomi Miot Atuo”。

同样地，安装完集成之后需要重启 HomeAssistant。

~/homeas/

docker-compose restart

3.2 配置 Xiaomi Miot Atuo

接下来，我们配置 Xiaomi Miot Atuo 将米家设备接入HomeAssistant。注意，配置 Xiaomi Miot Atuo 前需要重启 HomeAssistant。

点击“设置”，选择“设备与服务”

切换到 “设备” ， 然后点击 “添加设备”

搜索并选择“Xiaomi Miot Atuo”

选择“账号集成”，登录小米账号获取设备信息。

按照配置指引完成剩余步骤，选择你想要接入 HomeAssistant 的设备。

3.3 删除不必要的实体（非必要，但强烈推荐）

在将米家设备桥接到HomeKit之前，建议禁用一些不必要的实体。否则可能会出现以下情况：例如，当将小米智能插座添加到homekit时，插座会被识别为三个设备，除了开关之外，其中插座的指示灯被识别为灯具，插座温度也被误认为环境温度传感器。这可能不是我们期望看到的结果。

以我浴室的智能开关为例，切换到“实体注册表”。找到对应的实体，我的智能开关名为“浴室热水器”，对应指示灯的实体就是“浴室热水器 Indicator Light”，点击这个实体。

点击右上角“设置”按钮

关闭“已启用”，将这个实体禁用。

以此类推，你可禁用掉所有不必要的实体。

4. 桥接米家设备到HomeKit

接下来，我们通过 HomeKit Bridge 将 Home Assistant 中设备桥接到 HomeKit。

首先，我们要添加 HomeKit Bridge 集成。点击“设置”，进入“设备与服务”页面。

搜索“homekit”，点击“Apple”

点击添加“HomeKit Bridge 集成”，按照指引完成添加。

需要注意是的，如果你有温湿度传感器，记得勾选“Sensor”，这个选项默认是不勾选的。

添加 HomeKit Bridge 集成成功后，点击界面左下角的通知按钮。查看 homekit 的配对二维码。

打开“家庭”应用，点击左上角的“+”号，选择“添加配件”。扫描上个步骤的得到的二维码，点击“添加到家庭”。在加入过程中，可能会提示“未认证设备”，点击“仍要添加”。然后完成剩余步骤，逐个添加设备。完成后，你就能能用Siri控制你的智能设备了。

大功告成！🎉

5. 常见问题

Siri 回复设备没有回应？

通过上述方法添加设备后，只能在同一局域网内控制该设备。如果出现这种情况，请检查手机是否连接到家庭网络，并进一步确认 HomeAssistant 服务状态是否正常。

米家空调伴侣导致环境温度错误？

https://github.com/al-one/hass-xiaomi-miot/issues/800

我通过修改配置文件解决这个问题：

1. 在config目录下的configuration.yaml添加下面内容：

~/homeas/config/configuration.yaml

homeassistant:
  customize: !include customize.yaml

2. 在config目录下创建customize.yaml，将温度传感器绑定到空调伴侣实体。对应的设备名称和实体名称需要根据实际情况调整（在“设置-设备与服务-实体注册表”中可以得到）：

~/homeas/config/customize.yaml

climate.lumi_mcn02_d045_air_conditioner:    # 空调伴侣实体ID
  bind_sensor: sensor.miaomiaoce_t2_0b9e_temperature_humidity_sensor    #温度传感器实体ID

3. 重启 HomeAssistant

~/homeas/

docker-compose restart

其他问题

欢迎在评论区讨论

我希望你能担任英语翻译、拼写校对和修辞改进的角色。
我会用任何语言和你交流，你会识别语言，将其翻译并用更为优美和精炼的英语回答我。
请将我简单的词汇和句子替换成更为优美和高雅的表达方式，确保意思不变，但使其更具文学性。
请仅回答更正和改进的部分，不要写解释。
我提供的文本遵循Markdown格式，请不要修改我的格式。
你的回复应该以```开始```结束。

这是我的第一个文本：

<需要翻译的内容>

尽管ChatGPT的网页版具备持续对话的能力，只需在对话开始时输入上面提示模板，之后就无需再次输入，ChatGPT会理解你后面发给它的内容是需要翻译的。然而，由于对话的上下文长度是有限的，随着对话长了以后，ChatGPT可能会在后续对话中"遗忘"前面的内容，并将需要翻译的内容误认为是与它的对话内容。

因此，我更倾向于将模板放置在文本编辑器中，每次将待翻译的内容替换到提示词模板中，然后将完整的提示词发给ChatGPT。不过，当需要翻译多个文本时，就需要不断复制要翻译的内容、替换模板、然后粘贴，操作很繁琐。

于是，我想到使用AutoHotkey（AHK）来实现：每当我选中文本并使用Ctrl+C复制后，自动将复制的内容替换到提示模板中，并更新剪贴板。这样，在粘贴时就能直接发送给ChatGPT了。 通过这种方式省去了手动替换文本到模板步骤，提高效率。

效果如下：

什么是AutoHotkey（AHK）？

AutoHotkey 是一种免费的开源脚本编程语言和自动化工具，用于创建自定义脚本和宏来自动化计算机任务和增强工作流程。它支持自定义快捷键、鼠标动作、窗口操作等，并可以与其他应用程序交互。它简单易用，适用于Windows系统，可提高效率和简化重复任务。

编写ank脚本

下载并安装AutoHotkey（AHK）后，新建一个.ahk文件（例如chatgpt_copy.ahk），并使用你喜欢的文本编辑器进行编辑。Windows自带的记事本也可以，但我推荐使用VScode。将此gist内容复制到该文件中即可：

https://gist.github.com/eMUQI/3d3eaf5241ab6dff32283fecd7eeb899

这个脚本绑定了Ctrl+Shift+C快捷键。当你按下这个快捷键时，它会执行以下操作：

1. 复制选中的文本到剪贴板。
2. 将剪贴板的内容插入到模板中的相应位置。
3. 更新剪贴板内容为最终的文本。

如果你要修改代码，关于代码的说明：

1. 为了避免破坏原来Ctrl + C的体验，我设置激活的按钮为Ctrl + Shift + C。如需修改，参考：AHK - How to Write Hotkeys
2. 在 AutoHotkey 的脚本中，如果你需要在字符串里表示一个反引号（`），你需要使用两个反引号（``）来转义它。
3. ;分号后的内容是注释。

运行ank脚本

由于文本编码问题，编写完脚本之后记得打开 AutoHotkey ，进入设置页面，勾选"default to UTF-8 even for v1 scripts"。否则粘贴出来的文本会变成乱码。

完成了以上步骤后，只需双击.ahk文件即可运行。程序会在右下角的系统托盘中显示其正在运行。

ChatGPT 上线至今已经有一段时间了，但是不少人还没真正掌握它的使用技巧。

其实，ChatGPT 的难点，在于 Prompt（提示词）的编写，OpenAI 创始人在今年 2 月时，在 Twitter 上说：「能够出色编写 Prompt 跟聊天机器人对话，是一项能令人惊艳的高杠杆技能」。

因为从 ChatGPT 发布之后，如何写好 Prompt 已经成为了一个分水岭。熟练掌握 Prompt 编写的人，能够很快让 ChatGPT 理解需求，并很好的执行任务。

目前你在网上看到的所有 AI 助理、智能翻译、角色扮演，本质上还是通过编写 Prompt 来实现。

只要你的 Prompt 写的足够好，ChatGPT 可以帮你快速完成很多工作，包括写爬虫脚本、金融数据分析、文案润色与翻译等等，并且这些工作还做的比一般人出色。

为了帮助大家能更好的掌握 Prompt 工程，DeepLearning.ai 创始人吴恩达与 OpenAI 开发者 Iza Fulford 联手推出了一门面向开发者的技术教程：《ChatGPT 提示工程》。

--- https://github.com/GitHubDaily/ChatGPT-Prompt-Engineering-for-Developers-in-Chinese

ChatGPT的难点在于Prompt（提示词）的编写，熟练掌握Prompt编写的人能够很快让ChatGPT理解需求，并很好地执行任务。为了帮助开发者更好地掌握Prompt工程，吴恩达与OpenAI联手推出了一门面向开发者的技术教程《ChatGPT提示工程》。

虽然这门课程已经推出一段时间了，但我最近才开始学习。学完确实受益匪浅，推荐给大家。课程介绍了大型语言模型时的提示原则和相关策略，并提供了每个策略的实例。可在 deeplearning.ai 平台上学习，并提供预置OpenAI Key的Jupyter Notebook环境。可以边观看视频边使用Jupyter Notebook运行课程中的代码实例。

如果你觉得全英文视频有些吃力，也可以查看这个项目，在B站上传了相关视频并提供中英文字幕。即使你是跟着B站的课程学习，依然强烈建议跟着视频在 deeplearning.ai 平台上运行课程案例。

• 中文视频地址：面向开发者的 ChatGPT 提示词工程
• 英文原视频地址：ChatGPT Prompt Engineering for Developers

课程大纲与笔记

建议至少学习完第一章，以下是我整理的课程大纲与笔记：

访问链接：《ChatGPT Prompt Engineering for Developers-大纲&笔记》

相关文章

https://wulu.zone/posts/API2D

Whisper是OpenAI推出的一种开源语音识别模型，能够自动识别多种语言，将音频转换文字。Whisper由python实现，同时拥有丰富的社区支持。除了原始的Whisper之外，还有一些相关的项目，有移植到 C/C++的whisper.cpp和能使用GPU加速的faster-whisper。如果你不懂编程或者不熟悉命令行，也有也有很多开发者开发了图形界面，比如buzz和Const-me/Whisper等。

Whisper 支持直接输出srt格式的字幕文件。我最近用 Whisper 生成字幕文件，再配合ChatGPT 使用GPT-Subtrans 翻译字幕，整体效果很好。不过， Whisper有一个问题，就是Whisper 使用--language来指定语言，但无论是简体中文还是繁体中文，对应的代码都是zh。很多情况下，使用Whisper 生成字幕文件，设置参数--language zh，会生成繁体中文的字幕文件。

解决方案

在网上终于查到解决方案，分享给大家。 在 Whisper 的讨论区中，@jongwook 提出：

1. 使用 --initial_prompt 参数，用简体中文输入 "以下是普通话的句子。" 就能生成简体中文字幕。（补充：whisper.cpp 用户可以尝试使用--prompt参数）
2. 以此类推，用繁体中文输入 "以下是普通話的句子。" 就能得到繁体字幕。

$ whisper --language Chinese --model large audio.wav
[00:00.000 --> 00:08.000] 如果他们使用航空的方式运输货物在某些航线上可能要花几天的时间才能卸货和通关
$ whisper --language Chinese --model large audio.wav --initial_prompt "以下是普通話的句子。"  # traditional
[00:00.000 --> 00:08.000] 如果他們使用航空的方式運輸貨物,在某些航線上可能要花幾天的時間才能卸貨和通關。
$ whisper --language Chinese --model large audio.wav --initial_prompt "以下是普通话的句子。"  # simplified
[00:00.000 --> 00:08.000] 如果他们使用航空的方式运输货物,在某些航线上可能要花几天的时间才能卸货和通关。

另外，有关 --initial_prompt 参数，可在 openai的文档 查看更多。其中也提到 "有些语言可以用不同的方式书写，比如简体或繁体中文。模型可能默认不会使用你想要的转录写作风格。你可以通过使用你偏好的写作风格的提示来改善这一点。"。

前言：AI技术的普及和应用，让我们的生活更加便捷和愉悦。尤其是近期火热的ChatGPT，在自然语言交互等方面，已经取得了很重要的突破。然而，由于诸多因素的影响，使用ChatGPT在国内变得越来越困难。希望通过这篇博客，让更多的人了解到 API2D 这个很好的ChatGPT 访问方案，让大家都能受益于AI技术的进步。

api2d 是什么？与ChatGPT是什么关系？

最近openai开始封禁亚洲用户的账号还有部分机房ip，使得在国内使用ChatGPT越来越难。再加上ChatGPT本来注册就有一定门槛，付费也不方便，只能用美国本地的银行卡支付。

找到一个替代方案：API2D 。API2D 是一个集成OpenAI接口的工具，为用户提供国内可用的API支持，而且还支持微信支付。它实质上为一个国内可用的ChatGPT API代理，会将请求转发到ChatGPT api，再将结果返回给用户。由于api2d的使用方式与chatgpt基本一致，只要应用程序支持设置OpenAI API Host，就可以轻松地使用。

更多详细信息可以查看他们的官网。这篇文章主要介绍两个最重要的地方：1. 价格 2. 使用方法。3. 支持ChatGPT 4.0

1. 价格。API2D按实际使用的Token数量收费，聊天接口价格大约为OpenAI的1.5倍（考虑到国内可以支付和使用，还可以接受）。API2D 使用P作为计费单位，1P=100token，每次调用最低消耗1P。建议通过Github账号注册，这样能够获得50P的免费点数。

2.使用方法。对于用户来说，找支持填写第三方OpenAI API Host的应用。填入https://openai.api2d.net/和api2d的forwardkey。对于开发者来说，API2D 提供了开发者文档。

利用api2d快速搭建一个属于自己的ChatGPT网站

1. 注册 api2d。 注册没什么特别的。有一点需要注意：注册的时候建议使用github账户注册，可以获得50P（相当5000token）的额度。
2. 搭建 ChatGPT-Next-Web。毕竟api是无法直接使用的，所以需要搭建一个网页应用来使用ChatGPT。ChatGPT-Next-Web 是一个支持 chatgpt api 私人 ChatGPT 网页应用。具体可以查看他的中文文档。使用 Vercel 可以免费部署。参考链接：如何在Vercel搭建ChatGPT-Next-Web/。需要注意的是，设置环境变量步骤时，需要额外添加环境变量BASE_URL，值设为stream.api2d.net。设置OPENAI_API_KEY的值为api2d的forwardkey。最后，一定要设置CODE变量，不然别人就能用你的api访问chatgpt，CODE是 ChatGPT-Next-Web 的访问密码，设置了访问密码后，在设置页面填入密码就能使用。
3. 绑定域名。如果你有域名，强烈建议绑定自己的域名，然后删掉Vercel分配给你的域名访问。Vercel 分配的域名 DNS 在某些区域被污染了，绑定自定义域名即可直连，而且有些人会根据 Vercel 提供域名的规律找到你的域名然后爆破。绑定域名也很简单。在 Vercel 项目设置添加域名，按照指引添加一条CNAME记录即可。

api2d还能做什么？

只要应用程序支持设置OpenAI API Host，就可以轻松地使用。如下图的开源项目 memos。

更多项目在api2d的官网找到：

使用chatgpt一段时间后，萌生了一个想法：利用chatgpt辅助我编程。

大致需求是通过运行在树莓派上的网页服务来控制Windows主机关机，同时还可让树莓派发送wakeonlan数据包唤醒Windows电脑。最终实现的效果见上方链接。

代码编写过程

通过了好几天，数十次对话，终于把程序写出了。由于没有经验，这样一个简单的功能花了好几天的空闲时间才完成，中间数次向chatgpt请教网页知识。而且还不断调整需求。

下面是几个主要的提问：

1. “如何实现利用python远程控制Windows电脑开机和关机。通过网络（局域网内）来控制，需要服务端是Windows，客户端是任何支持网络的设备。”
2. “能否在Windows开启一个web服务，通过在局域网内网页来控制电脑关机呢”
3. “如何添加身份验证呢？能否添加一个确认关机功能，直接访问网页就执行光机操作很容易误操作”
4. “程序的架构是：Windows端作为服务器，只提供接口不需要渲染网页。树莓派运行网页服务，通过访问树莓派的上运行的网页来控制Windows关机。通过python来实现。”
5. “修改树莓派的代码，用变量来设置 服务器的端口和ip”
6. “不要修改代码原有的功能，在代码的基础上，添加一个检测电脑端服务是否开启的功能，并显示到网页上”
7. “现在根据我刚刚给你的两个代码文件，判断项目内容。为这个项目写一个README”

经验&技巧

1. 选择你擅长或者至少熟悉基础语法的语言。chatgpt生成的代码如果你不能大致看懂，那么让他写复杂一点的代码给你就很难了，chatgpt生成的代码可能有错误。比如说在这个项目的例子中，我只懂python的基础语法，对于用到flask框架，request 和wakeonlan库我都不了解。但是通过让chatgpt写上注释，我能做到简单的debug。
2. 每次和chatgpt对话，当你向他要代码时，可以在最后加上“请加上合理的注释”。或者在对话最开始和chatgpt约定，只要发送代码都加上易读的指数。
3. 由于chatgpt的会话限制，有可能chatgpt无法一次将完整内容发给你，内容会戛然而止。可以试着和chatgpt说“继续”，但是也有可能会出现chatgpt前言不搭后语。或者不同部分的功能分别询问，有意地控制chatgpt的内容不要超过限制。
4. 当项目逐渐成型，代码变得很长，可以试着和chatgpt说：“请只给我修改或者新增的部分”。
5. 如果让chagpt设计css，可以尝试让他使用bootstrap，效果还可以。

有时候需要下载百度网盘上的资料，但是百度网盘下载速度非常慢，又不想一直开着电脑挂着百度云盘费电。可以试着将百度网盘客户端下载到树莓派上。目前百度网盘的官网下载页面虽然有提供Linux版的安装包，但是没有提供arm架构的安装包。

不过，通过搜索发现百度其实有提供arm的安装包，通过链接 https://issuepcdn.baidupcs.com/issue/netdisk/LinuxGuanjia/${版本号}/baidunetdisk_${版本号}_arm64.deb 就能得到，但是有时候amd64的版本arm64不一定有。目前我测试到最新的arm版本号是4.14.6。

总结起来，现在有下面这几个问题：

1. 只有rpm和deb包，其他linux系统比如archlinux和openwrt安装就无从下手。
2. 需要有桌面环境，没有桌面环境就无法使用。
3. 版本维护麻烦。

怎么样才能够在各种Linux发行版上运行，不依赖桌面环境。那就是使用docker，将百度网盘安装docker容器里。再借助docker-baseimage-gui 项目，这样就可以通过浏览器或任何VNC客户端访问百度网盘的GUI。

总之，最后我整理了一下把项目放到github了，项目地址：

https://github.com/eMUQI/baidunetdisk-arm64-vnc

用法

可以通过docker或者docker-compose来部署，使用前确保你安装了docker或者docker-compose。

docker 部署

docker run -d \
       --name baidunetdisk-vnc \
       -p 5800:5800 \
       -p 5900:5900 \
       -v /配置文件位置:/config \
       -v /下载位置:/config/baidunetdiskdownload \
       --restart unless-stopped \
       emuqi/baidunetdisk-arm64-vnc:latest

其中需要修改的是/配置文件位置:/config和/下载位置:/config/baidunetdiskdownload，冒号前的路径修改为你希望储存位置（比如将下载文件存放到你树莓派上挂载的硬盘上）。

修改5800:5800冒号前的数字可以修改通过浏览器访问的端口号，修改5900:5900冒号前的数字可以修改VNC的端口号。

如果希望用密码限制访问，在-p 5900:5900 \后加上-e VNC_PASSWORD=password \，等号后面写你要设置的密码。如果你只在你的家的内部网络环境使用，可以不设置密码，但是如果你将端口暴露到外网，那么强烈建议你设置密码以防止隐私泄露。

执行完成后，可以在浏览器中访问noVNC端口，例如http://localhost:5800，网页打开后等待加载就行，使用方法和正常客户端一致，确保下载位置为baidunetdiskdownload。也通过VNC客户端来访问vnc://localhost:5900。

注意：如果百度网盘弹出升级提示，请忽略，点击升级按钮并不会执行程序升级而且新版本不一定有适配arm。可以将截图版本号提交到issue，我会根据适配情况维护升级。

常用docker命令：

docker stop baidunetdisk-vnc # 启动容器
docker stop baidunetdisk-vnc # 停止容器
docker rm baidunetdisk-vnc # 删除容器
docker image rm johngong/baidunetdisk:latest #删除镜像

docker-compose 部署

# 创建文件夹用于存放docker-compose配置文件
mkdir baidunetdisk-vnc
# 进入 baidunetdisk-vnc 文件夹
cd baidunetdisk-vnc
# 下载docker-compose配置文件
wget https://raw.githubusercontent.com/eMUQI/baidunetdisk-arm64-vnc/main/docker-compose.yml
# 根据需要修改docker-compose配置文件
nano docker-compose.yml
# 以后台形式运行
docker-compose up -d

你可能希望修改docker-compose.yml里配置存放的位置${PWD}/bdnetdisk-config:/config和下载文件的位置${PWD}/downloads:/config/baidunetdiskdownload。修改冒号前的部分。

修改5800:5800冒号前的数字可以修改通过浏览器访问的端口号，修改5900:5900冒号前的数字可以修改VNC的端口号。

如果希望用密码限制访问，在- GROUP_ID=1000 后加上- VNC_PASSWORD=password，等号后面写你要设置的密码。如果你只在你的家的内部网络环境使用，可以不设置密码，但是如果你将端口暴露到外网，那么强烈建议你设置密码以防止隐私泄露。

执行完成后，可以在浏览器中访问noVNC端口，例如http://localhost:5800，网页打开后等待加载就行，使用方法和正常客户端一致，确保下载位置为baidunetdiskdownload。也通过VNC客户端来访问vnc://localhost:5900。

注意：如果百度网盘弹出升级提示，请忽略，点击升级按钮并不会执行程序升级而且新版本不一定有适配arm。可以将截图版本号提交到issue，我会根据适配情况维护升级。

常用docker-compose命令：

docker-compose up -d # 以后台形式运行
docker-compose stop # 停止
docker-compose down # 停止并删除

配置

感谢以下项目:

https://github.com/jlesage/docker-baseimage-gui

https://github.com/gshang2017/docker

https://open.spotify.com/track/49qhKNDnvA792NHeFwTKvk?si=e29e4337c9394c3b

https://open.spotify.com/track/0g8H61FNXHHhMVHB0jwdzH?si=992ef4c4e0e64ead

https://open.spotify.com/track/7FeF8ywQi6Auovb94rEjOG?si=9ff72885e4f045a7

6PEN.ART

初次使用的AI绘画平台，以及我使用最多的是 6pen.art 。AI绘画其实是有一定门槛的：如果使用开源的模型，那么你需要有一定的编程基础（你需要知道怎么能让模型跑起来，还有大量的参数需要调整，除此，你还需要有一张不错的显卡）。如果使用商用的模型，那么就需要花钱，而且并不便宜。 6pen.art 不需要拥有编程知识，直接就能使用，甚至支持中文关键词。而且，6pen还把生成的图片版权归属于用户，每天都提供免费的生成次数。这些特点都非常吸引我。

具体是通过什么渠道知道这个平台的已经忘了。但是我仍然清晰地记得，在我刚开始接触人工智能绘画的时候，我很高兴，因为我对人工智能的绘画很感兴趣。作为一个在艺术上没有什么天赋的人，我也许也能够通过另一种方式表达自己脑中想象的画面，去捕获脑海中偶尔会出现的灵光一闪。我注册了 6pen 并开始AI绘画，我加入了 6pen 的用户群，看到群友生成的许多精妙的作品，我也跃跃欲试。

生成图片方式比较简单。有这些地方可以调整：画面描述、画面类型、风格修饰、艺术家、模型、参考图、尺寸和随机种子。如果你只需要你是新手，可以考虑使用禅思模式，这样只需要输入画面描述即可。

另外，可以使用我的 分享链接 注册，这样我们都能获得用于生成图片的点数，点数可以缩短图片生成的排队时间。

效果图

下面是我用AI生成的一些图片：如果对图片感兴趣，想知道关键词和风格，直接留言提问即可。

版权提示：下面部分图片由 stable diffusion 生成，版权属于公共领域。其余图片与本文保持同样的协议。

蓝色群山星空夜晚

一只慵懒的猫拿着花自画像

一只狐狸在层层叠叠的玫瑰花开在山坡上

玫瑰花山坡上新人类的核避难所

其他