红枫吟 - 作品

为内容创作者和开发者打造的轻量级静态站点生成器Snow

Tue, 16 Jun 2026 14:00:00 +0000

如果你想搭建一个博客、技术文档站、项目主页，或者一个可以长期维护的内容网站，你可能已经尝试过许多静态站点生成器。它们功能强大，但有时也意味着复杂的依赖、繁琐的配置和不够直观的扩展方式。

Snow 提供了另一种选择：一个用 Go 编写的、单二进制分发的静态站点生成器。它足够轻量，也足够灵活，适合从个人博客到多语言文档站的多种场景。

开箱即用，快速开始

Snow 的使用方式非常直接。你可以通过 Homebrew 安装：

1brew install honmaple/tap/snow

也可以直接从源码安装：

1go install github.com/honmaple/snow@latest

创建新站点只需要一条命令：

1snow init myblog

随后进入目录，启动本地预览：

1snow server --autoload

--autoload 会监听内容、模板和静态文件变化，自动重新构建并刷新浏览器。写文章、调模板、看效果，整个流程非常顺滑。

生产环境构建同样简单：

1snow build --mode publish --clean

Snow 支持通过 mode 管理不同环境配置，例如本地开发使用 127.0.0.1，发布时自动切换为正式域名。

支持 Markdown、Org-mode 和 HTML

Snow 不只支持常见的 Markdown，也内置支持 Org-mode 和 HTML 内容文件。对于习惯使用 Emacs/Org-mode 管理知识库的用户来说，这一点非常友好。

你可以在 content/ 目录下自由组织内容：

1content/
2├── about.md
3└── posts/
4    ├── hello.md
5    └── bundle/
6        ├── index.md
7        └── image.png

Snow 支持 Page Bundle，文章和图片等资源可以放在同一个目录中，便于迁移、备份和维护。

清晰的内容模型

Snow 的内容系统围绕三个核心概念构建：

Page：单篇文章或页面
Section：栏目或目录，用来组织文章
Taxonomy：标签、分类、作者等归档系统

通过 FrontMatter，你可以轻松控制标题、日期、slug、草稿状态、自定义路径、模板、标签和分类：

 1---
 2title: "我的文章"
 3date: 2024-01-15
 4tags:
 5  - go
 6  - web
 7categories:
 8  - Programming/Go
 9draft: false
10---

对于博客、知识库、项目文档来说，这种模型既直观，也足够强大。

多语言、分页、RSS，一应俱全

Snow 内置多语言能力，支持通过目录、文件后缀或 FrontMatter 识别语言。你可以为不同语言配置独立内容目录、翻译文件和站点参数。

同时，Snow 支持 Section 和 Taxonomy 级别的分页，也支持 RSS、Atom、JSON 等自定义输出格式。无论你是在做个人博客、产品文档，还是需要生成机器可读的数据源，Snow 都能覆盖常见需求。

灵活的模板系统

Snow 使用 Pongo2 模板引擎，语法接近 Django：

1{% for page in pages.OrderBy("date desc") %}
2  <a href="{{ page.Path }}">{{ page.Title }}</a>
3{% endfor %}

模板中可以直接访问页面、栏目、分类、配置和多语言翻译函数。Snow 还提供了常用的列表操作能力，例如排序、分组、筛选、限制数量、上一篇/下一篇等。

这意味着你可以很轻松地构建文章列表、归档页、标签页、相关推荐和自定义首页。

主题可覆盖，站点可定制

Snow 支持主题系统。主题可以包含模板、静态资源和配置文件：

1themes/mytheme/
2├── theme.yaml
3├── templates/
4├── static/
5└── i18n/

站点本地模板优先级高于主题模板，因此你可以先使用主题快速启动，再按需覆盖某个页面模板，而不必复制整个主题。

这种设计既适合普通用户快速搭站，也适合开发者维护自己的主题体系。

插件 Hook，让构建流程可扩展

Snow 内置 Hook 插件系统，可以在内容处理、模板执行、资源处理、写入输出等阶段插入自定义逻辑。

目前内置插件包括：

shortcode：在内容中嵌入可复用组件
encrypt：内容加密
assets：静态资源处理
minify：输出压缩
rewrite：FrontMatter 重写
filter：页面筛选
snakecase：模板上下文 snake_case 访问
pelican：文档格式转换辅助

默认启用 assets、encrypt 和 shortcode，其他插件可以按需开启。你还可以通过权重控制插件执行顺序，让构建流程更可控。

单二进制，部署简单

Snow 使用 Go 编写，可以编译成单个二进制文件。没有复杂运行时，没有庞大的依赖链，也不需要在服务器上安装一整套前端工具。

对于静态站点来说，这非常实用：本地构建，产物上传，或者直接放进 CI/CD 流程，都很干净。

适合谁使用？

Snow 特别适合这些用户：

想搭建个人博客或技术博客的开发者
希望用 Markdown 或 Org-mode 管理内容的写作者
需要多语言文档站的项目维护者
想要轻量、可控、易部署静态站点工具的团队
喜欢 Go 单二进制工具链的用户

总结

Snow 的优势不在于把每件事都做得庞大复杂，而在于把静态站点生成中真正重要的能力做得清晰、直接、可扩展。

它支持多格式内容、多语言、分类归档、分页、自定义输出、主题覆盖、实时预览和插件扩展，同时保持了单二进制工具应有的简洁。

如果你正在寻找一个轻量但不简陋、灵活但不臃肿的静态站点生成器，Snow 值得一试。

项目地址：https://github.com/honmaple/snow

红枫笔记发布1.0.4版本

Thu, 12 Mar 2026 12:21:16 +0000

最近红枫笔记发布了 v1.0.4 版本，主要更新功能如下:

增加数据导出功能: 可将红枫笔记中的待办事项、纪念日、备忘录及其附件导出到本地
增加数据导入功能: 支持从Flomo、Usememos，或者从红枫笔记自身导出的文件中导入笔记
增加数据同步功能: 支持S3、Webdav的数据同步
增加导航功能：笔记模版、远程服务等功能都能一键直达
远程服务增加RSS订阅功能: 添加RSS链接即可在红枫云盘内查看内容

使用CloudFS连接本地磁盘与多种云存储

Tue, 10 Mar 2026 12:27:10 +0000

在应用开发中，文件存储常常不是一个“简单上传下载”的问题。

你可能会遇到这些场景：

开发环境使用本地磁盘
生产环境切换到 S3 对象存储
企业内网需要接入 SMB / SFTP
用户希望挂载 WebDAV / OneDrive / Google Drive
文件分发依赖 GitHub Release
后续还要支持更多云盘或私有存储服务

如果每一种存储都单独适配，业务代码很快就会被各种 SDK、认证方式、路径规则和异常处理淹没。

CloudFS 正是为了解决这个问题而生。

CloudFS 是一个 Go 语言云存储抽象库，它将本地磁盘、多种云盘和常见存储协议统一到一套类似文件系统的接口中。开发者只需要面向 cloudfs.FS 编程，就可以完成常见文件操作。

例如：

 1// 列出目录文件
 2files, err := fs.List(ctx, "/")
 3
 4// 读取文件
 5r, err := fs.Open(ctx, "/file.txt")
 6
 7// 创建或上传文件
 8w, err := fs.Create(ctx, "/docs/hello.txt")
 9
10// 移动文件
11err = fs.Move(ctx, "/old.txt", "/archive")

底层到底是本地目录、S3、WebDAV、SFTP、SMB、Google Drive，还是 OneDrive，对于业务代码来说不再重要。

多驱动支持，存储接入更自由

CloudFS 已内置丰富的驱动支持：

Local：本地文件系统
FTP / SFTP：传统文件传输协议
S3：兼容 S3 的对象存储
SMB：企业内网文件共享
WebDAV：常见网盘与文件服务协议
Google Drive / OneDrive：主流云盘
GitHub / GitHub Release：适合文件分发场景
Upyun / Openlist / Foxel
115 / Quark

这意味着你可以用同一套业务逻辑连接不同存储后端。

典型使用方式包括：

开发环境使用 local
生产环境使用 s3
企业部署使用 smb 或 sftp
个人网盘场景支持 webdav、gdrive、onedrive
文件下载场景接入 github-release

直接创建驱动：

1fs, err := webdav.New(&webdav.Option{
2    Endpoint: "https://example.com/dav",
3    Username: "user",
4    Password: "pass",
5})

也可以通过统一工厂动态创建：

1fs, err := driver.New("webdav", map[string]any{
2    "endpoint": "https://example.com/dav",
3    "username": "user",
4    "password": "pass",
5})

如果配置已经是 JSON，还可以使用：

driver.NewFromString
driver.Exists
driver.VerifyOption

这对于配置化系统、后台管理平台、插件化应用非常友好。

中间件机制，让文件系统能力可以组合

CloudFS 不只是封装驱动，它还提供了可组合的中间件机制。

你可以像搭积木一样增强文件系统能力：

缓存中间件：缓存目录列表和文件信息，减少远端请求
限流中间件：控制访问频率，避免触发服务限制
压缩中间件：写入时压缩，读取时自动解压
加密中间件：支持文件内容、文件名、目录名加密
Hook 中间件：支持路径映射、文件过滤、自定义处理
Prefix 中间件：将某个目录前缀映射为文件系统根路径

示例：

1fs, err = cloudfs.New(
2    fs,
3    middleware.PrefixFS("/data"),
4    middleware.CacheFS(&middleware.CacheOption{}),
5)

像操作文件系统一样操作云端资源

CloudFS 的核心接口非常直观：

 1type FS interface {
 2    List(context.Context, string, ...ListOption) ([]FileInfo, error)
 3    Move(context.Context, string, string) error
 4    Copy(context.Context, string, string) error
 5    Rename(context.Context, string, string) error
 6    Remove(context.Context, string) error
 7    MakeDir(context.Context, string) error
 8    Stat(context.Context, string) (FileInfo, error)
 9    Open(context.Context, string) (File, error)
10    Create(context.Context, string) (FileWriter, error)
11    Close() error
12}

它保留了 Go 开发者熟悉的接口风格：

io.Reader
io.Seeker
io.Closer
io.WriteCloser
io/fs.FileInfo

因此，CloudFS 很容易和现有 Go 生态集成。

文件信息也在标准 io/fs.FileInfo 基础上增加了：

Path()：完整路径
Type()：文件类型
ExtraInfo()：驱动额外元数据

既保留标准语义，也给不同存储驱动留下扩展空间。

快速开始

安装 CloudFS：

1go get github.com/honmaple/cloudfs

只引入需要的驱动：

1import "github.com/honmaple/cloudfs/driver/webdav"

或者一次性注册全部内置驱动：

1import _ "github.com/honmaple/cloudfs/driver/all"

完整示例：

 1package main
 2
 3import (
 4    "context"
 5    "io"
 6    "strings"
 7
 8    "github.com/honmaple/cloudfs/driver/local"
 9)
10
11func main() {
12    fs, err := local.New(&local.Option{
13        Path: "/tmp/cloudfs",
14    })
15    if err != nil {
16        panic(err)
17    }
18    defer fs.Close()
19
20    ctx := context.Background()
21
22    _ = fs.MakeDir(ctx, "/docs")
23
24    w, _ := fs.Create(ctx, "/docs/hello.txt")
25    _, _ = io.Copy(w, strings.NewReader("hello cloudfs"))
26    _ = w.Close()
27
28    files, _ := fs.List(ctx, "/docs")
29    for _, file := range files {
30        println(file.Path(), file.Name(), file.Size())
31    }
32}

适合哪些项目？

CloudFS 特别适合这些场景：

网盘系统：统一管理本地、WebDAV、S3、云盘等资源
文件管理器：用一套接口浏览和操作多种存储
备份系统：在不同存储后端之间归档与迁移
同步工具：屏蔽不同云服务之间的接口差异
内容分发服务：对接 GitHub Release、S3、WebDAV 等下载源
企业内部工具：同时支持 SMB、SFTP、本地目录等环境
插件化平台：通过动态驱动注册和 JSON 配置创建文件系统

如果你正在为不同存储后端写重复的适配代码，CloudFS 可以把复杂度收束到一套清晰、统一、可组合的 Go 接口里。

总结

CloudFS 的核心价值可以概括为三点：

统一接口：用一套 cloudfs.FS 操作不同存储
多驱动支持：覆盖本地、协议、对象存储和主流云盘
中间件组合：缓存、限流、压缩、加密、路径映射灵活叠加

对于需要多存储支持的 Go 项目来说，CloudFS 是一个轻量、清晰、可扩展的基础库。

项目地址：https://github.com/honmaple/cloudfs

知名网盘工具Alist被卖，不用担心，我们还可以使用它

Fri, 13 Jun 2025 23:22:29 +0000

最近几天国内开源界最大的瓜莫过于知名的网盘聚合挂载工具 Alist 被卖，甚至很可能早在几个月前就已经被卖，只是直到最近，有小伙伴关注到 Alist 原作者 xhofe 已经很久没有在Github上出现，而且Alist的文档也被刚注册不久的两个账号修改，甚至添加了企业微信的咨询服务方式，这些都不算什么，最不能让人接受的是在 Pull Request 中出现了统计并上报所部署机器信息的相关代码

开源项目被某某公司收购其实是一件很寻常不过的事情，毕竟作者也要吃饭不是，总不能一直为爱发电，其实 Alist 这件事之所以闹得这么大，主要有以下几点原因：

收购Alist的公司名声及其“前科”，导致正在使用Alist的小伙伴们不得不对该公司的动机多了几分怀疑，更无法判断其对隐私的保护甚至是否会进行供应链投毒
Alist原作者事前没有发布任何声明，直到被网友扒出才确认此事
虽然这是一个开源项目，但是部分API比如阿里云盘、百度网盘等的授权是闭源的，Alist被收购后，这部分授权是否会被一同打包给收购的公司我们不得而知

虽然 Alist 被卖，但是这是开源界，一言不合就造轮子的开源界，直到本篇文章发出，已经有了不少大佬fork了原项目，并且将在原有代码的基础上继续维护 Alist，所以习惯使用 Alist 的小伙伴们也不用太过担心，也许它只是改了一个名称，比如新的项目 OpenList

除此之外，还有一些同类的网盘聚合和挂载工具，今天向大家介绍的是一款桌面端与手机端的网盘聚合工具—— 红枫云盘

红枫云盘，这是一个开源且跨平台的多协议云盘文件聚合软件，它不同于Alist，它不需要一台服务器或者Nas进行部署，只需要下载安装，然后打开即可。

红枫云盘目前支持Windows、MacOS、Android、IOS多种平台，也集成了以下多种存储方式:

本地文件
FTP
SFTP
S3
SMB
Webdav
Alist
又拍云
115网盘
夸克网盘
Github
Github Release

此外，红枫云盘还拥有以下多种功能:

支持文件列表查看、复制、移动、删除、重命名、上传、下载
支持桌面端拖拽上传(文件或者文件夹)
支持文件多选及操作
支持文件列表信息缓存
支持回收站
支持视频、音频、图片和文本文件的预览
支持文件加密和压缩
支持多语言(中文、英文)

文件预览效果：

欢迎大家下载使用：https://github.com/honmaple/maple-file

红枫笔记: 一个有些不一样的Usememos/Blinko/AI客户端

Sat, 07 Jun 2025 17:42:27 +0000

前言

起因是我在之前偶然间看到有人在用微信的文件传输助手记录临时笔记，我觉得这是一个很好的想法，，但微信的导出是一个很大的问题，不如我自己写一个

红枫笔记，一个用聊天的方式记录并同步你的想法，使用熟悉的聊天窗口记录偶然间的灵感一现

既然有了聊天窗口，不如来加个好友吧。

但红枫笔记是一个本地优先的应用，于是我把好友定位为需要同步的远程服务，比如 Usememos 、Blinko ，或者是一个 AI 组手，你向好友发送一条消息，也是向远程服务同步一条笔记，
同样的，既然有了好友，不如来建一个群吧。

使用红枫笔记，你可以把多个远程服务放进一个群聊天里，可以是多组 Usememos 服务，也可以是多个 AI 组手，从而实现"一文多发"

主要功能

书写格式: 支持 Markdown 、拍照、图片、录音等。
模版切换: 支持备忘录、待办事项、纪念日等。
远程服务: 支持 Usememos 、Blinko ，包括创建更新删除。
AI 笔记: 支持 AI 接口及流式输出，目前仅支持文本及一问一答，暂不支持上下文

后续计划

录音转文字
webdav/S3 的同步备份
AI 功能的完善：支持上下文及图片视频
文章撰写，用于整理这些临时的笔记
更多远程服务

下载

国区：红枫笔记
美区：maple-note

欢迎大家下载试用

红枫云盘正式上线App Store

Sat, 15 Mar 2025 17:25:17 +0000

欢迎大家下载使用 https://apps.apple.com/us/app/maplefile/id6743229674

第一次上线APP，虽然走了不少弯路，不过总体上线过程还是挺顺利的。3月12日注册的开发者账号，今天（3月15日）即成功上线，大概的流程就是

注册开发者账号

首先登陆 https://developer.apple.com。注意，这里只能使用国区的Apple ID进行注册，我第一次使用美区ID，但是需要美国的身份证明，换成国区ID后才成功注册。

第一天注册苹果会在48小时内进行审核，我刚开始还以为在成功缴费 688元 后就行，但一直没有下一步，后来联系了苹果的支持，收到回复注册的开发者账号会在48小时内审核。不过也不用48小时，我头天下午注册的，第二天早上9点多就收到了身份验证的邮件，因为注册用的是国区的ID，所以需要提交身份证照片，提交后一个小时内即审核通过。

审核通过后就能在开发者页面看到 计划资源，否则会提示需要审核

软件准备(Flutter)

这里我走了不少弯路，在网上搜索相关教程时又要本地创建证书，又要申请Profile的，其实不必这么麻烦。

首先点击 计划资源 里的 标识符 (英文)，然后点击 + 号，依次选择 App IDs -> App，然后输入 Bundle ID 及 Description。如果需要在手机上进行测试，则需要在设备(Devices)里添加相应的设备，其中 Device ID (UDID) 可以使用 Xcode，选择Windows -> Devices And Simulators查看。

接下来就不需要在网页上创建证书，只需要打开 Xcode，选择 Runner(TARGETS) -> Signing & Capabilities, 勾选 Automatically manage signing 并选择 Team，然后输入 Bundle Identifier 即可

图标设计

相关的环境准备好后，就到了最耗时也最难（对于我而言）的 图标设计。

对于一个没有学过UI设计的人来说，这确实是难题，虽然现在已有了AI的加持，但生成的设计图都不太符合我的审美，更重要的是，即使生成了一张符合的图片，但要把它转换为可用的APP图标还需要进行一系列的裁剪和修改，比如在MacOS上一个 1024 * 1024 的图标就需要设置外边缘为10%，即图标大小应为 819.2像素，底部图层为透明色，除此之外，还需要设置图标的圆角大小为 179.649，这些对于设计人员非常常见的参数，对于我却花费了不少时间。

在经过对AI生成的原图片进行不断地抠图、裁剪，但还是不满意之后，最后我还是决定自己绘制矢量图(SVG)，于是我通过搜索找到了 Inkscape 这个软件，并在B站学习了两天半的时间，简单上手之后参考原图片自己绘制了红枫云盘的图标，还算不错（个人觉得，哈哈）。

有了图标后，就能使用 flutter_launcher_icons 这个插件就能快速生成IOS/MacOS/Android的图标

 1flutter_launcher_icons:
 2  android: "launcher_icon"
 3  image_path: "assets/icon/icon.png"
 4  web:
 5    generate: true
 6    image_path: "assets/icon/icon.png"
 7  windows:
 8    generate: true
 9    image_path: "assets/icon/icon.png"
10  ios: true
11  image_path_ios: "assets/icon/icon.png"
12  remove_alpha_ios: true
13  background_color_ios: "#ffffff"
14  macos:
15    generate: true
16    image_path: "assets/icon/icon-macos.png"

同样的，也能使用 flutter_native_splash 快速生成启动图

 1flutter_native_splash:
 2  color: "#ffffff"
 3  color_dark: "#121212"
 4  image: "assets/icon/icon.png"
 5
 6  android_12:
 7    image: "assets/icon/icon.png"
 8    icon_background_color: "#ffffff"
 9    icon_background_color_dark: "#121212"
10
11  web: false

IPA上传

使用 flutter build ipa 生成ipa文件，不需要在Xcode上操作，然后使用 Transporter 这个苹果官方的软件进行上传，上传后的文件可在下一步里的 构建版本 中选择。

提交审核

首先登陆 https://appstoreconnect.apple.com/apps，创建好APP，并填写好相关的表单，上传好对应的截图，在 构建版本 中选择上传的IPA文件。

这一步确实有很多表单要填写，包括 App信息、App隐私、价格与销售范围，如果是付费App，还需要签署一些协议，添加银行卡，不过只要认真填写，在审核这一步能减少非常多与客服掰扯的时间，就像我一样，提交审核后一次就能通过，不需要反复地修改

注意：如果想上架国区，还需要进行App备案，虽然我已经有了一个已备案的域名和服务器，但App备案是要重新提交并申请的，挺麻烦的，大概吧，所以红枫云盘是未上架国区的，也是唯一未上架的区域，如果想要下载使用，则需要使用其它区的Apple ID

其它

CNAPS(联行号)查看: https://www.cwjyz.com.cn/bank/index.html

缺少出口合规证明: Info.plist中添加

1<key>ITSAppUsesNonExemptEncryption</key><false/>

红枫云盘版本发布记录

Fri, 14 Feb 2025 17:55:50 +0000

`v1.2.0` (2025-11-06)

新增

服务增加验证机制及优化服务启动
可开启webdav服务

修复

CFB文件解密

优化

缩略图存储路径
界面显示问题若干

`v1.1.0` (2025-10-24)

新增

访问频率限制
文件加密支持 OFB 和 CTR

修复

大文件上传卡顿
大文件流式加密和解密
开启缓存时文件列表刷新策略

优化

通知从 snackbar 切换至 smartDialog

`v1.0.9` (2025-06-12)

新增

115网盘(不支持上传)
夸克网盘(不支持上传)
S3增加 force_path_style 和 session_token 参数

修复

大文件上传错误
Github文件获取错误
阿里云OSS需设置 force_path_style 为 false

`v1.0.8` (2025-05-01)

新增

ios支持
文件排序支持目录优先
移动端视频播放支持mkv格式
支持 Github 和 Github Release 存储(只读)
增加启动Logo页面

修复

应用置于后台时并重新打开时服务断开

优化

视频、音频、图片的预览
MacOS端bookmark优化
移除部分不必要的包依赖

`v1.0.5` (2025-02-16)

新增

桌面端增加右键菜单
应用数据可选备份至云盘或者本地

修复

重试任务时应用退出
任务列表图标颜色同主题保持一致
MacOS沙盒模式下本地存储访问受限

优化

MacOS下应用图标使用白色背景

`v1.0.4` (2025-02-03)

新增

文件拖拽上传支持文件夹
文件列表信息缓存
S3存储增加 list_version 选项
SMB存储增加 domain 选项

依赖

Flutter版本升级至3.27.3

修复

Alist根目录无法上传/新建目录/移动/复制
拖拽文件导致重复上传 issue25

优化

添加/修改存储时，更多设置使用卡片分隔不同的选项

`v1.0.3` (2025-01-24)

新增

新增帮助文档，并使用外部浏览器查看

修复

修复自定义挂载目录在非根目录/时的问题

优化

使用 flex_color_scheme 优化界面主题和颜色

`v1.0.2` (2025-01-09)

新增

windows支持

移除

同步备份功能(bug较多无法使用)

优化

桌面端UI

`v1.0.1` (2025-01-06)

新增

回收站功能
文件加密和压缩
桌面端文件拖拽上传(仅文件)

优化

界面优化

红枫云盘发布v1.0.1版本，支持文件加密、压缩以及回收站功能

Mon, 06 Jan 2025 15:32:50 +0000

距离红枫云盘第一次发布已经过去了一个多月，这期间很感谢阮一峰大佬的推荐，上了2024年最后一期科技爱好者周刊，在短短几天时间就涨了 150 多个Star ，今天发布了最新的 v1.0.1版本，对比上一次有了重大更新，也带来了更多功能

文件加密

采用 AES 加密算法，自动对上传或者复制到此存储的文件进行加密，客户端查看或下载时自动解密，再也不用担心上传的视频变成8秒教育片

文件压缩

采用 GZIP 压缩算法, 自动对上传或者复制到此存储的文件进行压缩，客户端查看或下载时自动解压缩

回收站

删除文件时自动转为重命名文件(增加时间后缀)并移动到指定目录，想要恢复文件则进入回收站路径找到文件并复制到其它目录即可

文件拖拽上传

桌面端增加文件拖拽上传，当前只支持文件，不支持目录拖拽

Web支持

浏览器也能管理文件，这样就能通过 Docker 将红枫云盘部署到服务器或NAS

开源一个离线版Alist，无需服务端部署即可管理云盘文件

Mon, 02 Dec 2024 13:09:48 +0000

Alist 是一个非常不错的云盘文件管理程序，不过需要一台服务器或者 Nas 进行部署，当然，这也同样便于在网络分享文件。但如果只是个人使用，服务器部署以及多账户系统未免有些麻烦。我是一个怕麻烦的人，虽然我自己也在 Nas 中部署了一个 Alist 服务，但还是想要一个单独的 离线版APP，红枫云盘 就由此诞生。

红枫云盘 即 maple-file，名称由 maple(枫叶) + file(文件) 组成，这原本是我很早之前写的一个基于 Flask 的项目，主要用于图片上传，还有相册的功能，但已经很久没有使用和维护过了。本来我准备把新项目起名为 Filesea，但又和我的另一个类似 Alist 的项目名相同(未开源)，而且 Filesea 和一个知名项目 Seafile 过于相似，所以还是继续沿用之前的名称，毕竟对比之前的纯API也算得上是一个全新的升级和改版

功能

目前已经支持的存储：

local(本地文件)
smb
ftp
sftp
webdav
alist
又拍云

包括了文件上传、下载、重命名、移动、复制、创建文件夹、预览等功能，虽然部分功能比如预览还比较简陋，但持续优化中，未来可能会添加相册，文件同步和备份等功能

文件列表
文件预览: 支持文本文件，图片，音频，视频
上传和下载
重命名、移动、复制(包括多选)
添加修改存储
设置

使用

目前提供了Android版本和MacOS版本的下载，下载地址: https://github.com/honmaple/maple-file/releases/tag/v1.0.0

开发

我参考了 Gopeed 和 Pho 两个项目，客户端使用 Flutter，后端服务使用 Go，通过 gomobile 把 Go 服务打包成 aar(安卓)，或者利用 buildmode 打包成 .dylib(MacOS), 这样就能把服务端嵌入到本地客户端，来达到 serverless 的目的。

如果想要添加更多存储，只需要使用 Go 创建一个文件系统接口

 1type FS interface {
 2    WalkDir(context.Context, string, WalkDirFunc) error
 3    List(context.Context, string) ([]File, error)
 4    Move(context.Context, string, string) error
 5    Copy(context.Context, string, string) error
 6    Rename(context.Context, string, string) error
 7    Remove(context.Context, string) error
 8    MakeDir(context.Context, string) error
 9    Get(string) (File, error)
10    Open(string) (FileReader, error)
11    Create(string) (FileWriter, error)
12    Close() error
13}

然后注册一个新的存储名称

 1// 注册服务
 2func init() {
 3    driver.Register("alist", func() driver.Option {
 4        return &Option{}
 5    })
 6}
 7
 8
 9// 加载服务
10import (
11   _ "github.com/honmaple/maple-file/server/pkg/driver/alist"
12)

最后在客户端创建一个用于提交配置的表单即可，扩展性足够简单，也足够方便

 1...
 2DriverFormField(
 3  label: "用户".tr(context),
 4  value: _option["username"],
 5  isRequired: true,
 6  onTap: (result) {
 7    setState(() {
 8      _option["username"] = result;
 9    });
10
11    widget.form.option = jsonEncode(_option);
12  },
13),
14DriverFormField(
15  type: DriverFormFieldType.password,
16  label: "密码".tr(context),
17  value: _option["password"],
18  onTap: (result) {
19    setState(() {
20      _option["password"] = result;
21    });
22
23    widget.form.option = jsonEncode(_option);
24  },
25),

Snow静态博客处理多图排版

Sun, 17 Dec 2023 17:04:52 +0000

事情的缘由是我无意中发现之前写的部分文章里的图片没有渲染出来，才想起之前博客系统改版，从 Pelican 切换到 Snow 时竟然忘记更新，看了一下原文，大部分都是以下形式

 1<div class="row">
 2  <div class="col-md-4">
 3    [[https://s.libforest.com/images/pic/西湖/日落(二).jpg]]
 4  </div>
 5  <div class="col-md-4">
 6    [[https://s.libforest.com/images/pic/西湖/日落(三).jpg]]
 7  </div>
 8  <div class="col-md-4">
 9    [[https://s.libforest.com/images/pic/西湖/日落(一).jpg]]
10  </div>
11</div>

因为我之前的博客主题使用了 Bootstrap，为了能够让多张图片并排显示，所以用了 Bootstrap 里的 .row .col-*。但前不久移除了全部的 Bootstrap，现在当然不会生效。另外一点是我之前用的 org mode 解析器可以直接解析 HTML 中的链接，但更换了新的解析器 org-golang 后，已经无法不能解析HTML中的原始链接

此次利用 Snow 博客系统中的 shortcode 功能实现多图排版，让图片可以并排显示，多行显示。

解析原始链接

首先在主题下创建一个名为 img-layout 的 shortcode，比如我使用的主题叫做 snow，所以在 themes/snow/templates/shortcodes 目录下创建一个 img-layout.html 文件，并添加 markdown 或者 org 的 filter 将原始文本解析成HTML

1<div class="img-layout">
2  {%- if params.type == "markdown" %}
3  {{ body | markdown | safe }}
4  {%- else %}
5  {{ body | org | safe }}
6  {%- endif %}
7</div>

接着修改原始文章

1#+begin_export html
2<shortcode _name="img-layout">
3[[https://s.libforest.com/images/pic/西湖/日落(二).jpg]]
4[[https://s.libforest.com/images/pic/西湖/日落(三).jpg]]
5[[https://s.libforest.com/images/pic/西湖/日落(一).jpg]]
6</shortcode>
7#+end_export

经过修改，原始文章中的内容将会自动渲染成

1<div class="img-layout">
2  <p>
3    <img src="https://s.libforest.com/images/pic/西湖/日落(二).jpg" />
4    <img src="https://s.libforest.com/images/pic/西湖/日落(三).jpg" />
5    <img src="https://s.libforest.com/images/pic/西湖/日落(一).jpg" />
6  </p>
7</div>

并排显示

有了固定结构的HTML，接着就可以添加 css，使多张图片可以并排显示

 1.img-layout p {
 2    display: flex;
 3    flex-wrap: wrap;
 4}
 5
 6.img-layout p > img {
 7    width: auto;
 8    min-width: 0;
 9    max-width: 100%;
10
11    flex: 10000 1 0%;
12}
13
14/* 处理手机等设备图片显示问题 */
15@media screen and (max-width: 600px) {
16    .img-layout p > img {
17        min-width: 100%
18    }
19}
20
21/* 添加图片上下左右间隔 */
22.img-layout p {
23    margin: -0.25rem 0 0 -0.25rem !important;
24}
25
26.img-layout p > * {
27    margin: 0.5rem 0 0 0.25rem !important;
28}

多行显示

多行显示可以利用文件解析时每次遇到空行都会生成一个新的段落，比如

1[[https://s.libforest.com/images/pic/西湖/日落(一).jpg]]
2
3[[https://s.libforest.com/images/pic/西湖/日落(二).jpg]]

就会生成

1<p>
2  <img src="https://s.libforest.com/images/pic/西湖/日落(一).jpg" />
3</p>
4<p>
5  <img src="https://s.libforest.com/images/pic/西湖/日落(二).jpg" />
6</p>

故如果需要多行显示，只用在多张图片中间添加一个空行即可

图片懒加载和点击全屏

之前的图片懒加载和点击全屏的功能我也是利用 Snow 中的 shortcode 功能实现的，我在 themes/snow/templates/shortcodes 目录下建立了一个 img.html 的文件

1<a href="{{ params.src }}" data-fancybox="image">
2  <img data-src="{{ params.src + '-thumb' }}" class="lazyload" />
3</a>

这样，文章内所有的 img 标签的图片都会加上懒加载和点击全屏的功能(基于 lazysizes 和 fancybox)

但是，由于 Snow 中 shortcode 的实现是一次性遍历 HTML DOM，无法在一个 shortcode 内部调用另一个 shortcode。所幸 Snow 是我自己写的，思索片刻，我在 shortcode 实现中加入了三行代码，这样就能在一个 shortcode 中重复调用其它的 shortcode

1vars := map[string]interface{}{
2...
3+	"_shortcode": func(s string) string {
4+		return self.shortcode(page, s)
5+	},
6}

然后修改 img-layout.html

1<div class="img-layout">
2  {%- if params.type == "markdown" %}
3  {{ _shortcode(body | markdown) | safe }}
4  {%- else %}
5  {{ _shortcode(body | org) | safe }}
6  {%- endif %}
7</div>

最后添加 css 样式

1- .img-layout p > img {
2+ .img-layout p > img, .img-layout p > a {
3
4+ .img-layout p > a > img {
5+     height: 100%;
6+ }

显示效果

一张图片
两张图片
三张图片
多行显示

参考资料

https://immmmm.com/about-images-gird/