Suwayomi/Tachidesk-Server本地章节存储路径解析

在Suwayomi/Tachidesk-Server项目中，用户下载的漫画章节会存储在本地文件系统中。对于macOS用户，这些文件的默认存储位置遵循Unix-like系统的惯例，但可能因配置不同而有所变化。

默认数据目录结构

该应用采用标准化的数据目录结构，主要包含以下关键路径：

1. 配置目录
   通常位于~/.local/share/tachidesk/或~/Library/Application Support/Tachidesk/，包含：

   • 服务器配置文件
   • 数据库文件
   • 插件数据

2. 下载内容目录
   实际章节文件存储在独立的数据目录中，默认路径为：

   ~/.local/share/tachidesk/data/
   

   或

   ~/Library/Application Support/Tachidesk/data/
   

macOS系统下的特殊说明

由于macOS的文件系统权限管理较严格，用户需要注意：

1. Finder默认会隐藏以点号开头的目录，可通过以下方式访问：

   • 使用终端命令open ~/.local/share/tachidesk
   • 在Finder中使用Command+Shift+G快捷键直接输入路径

2. 目录层级示例：

   data/
   ├── downloads/
   │   ├── manga_123/
   │   │   ├── chapter_1.cbz
   │   │   └── chapter_2/
   │   │       ├── page1.jpg
   │   │       └── page2.jpg
   └── backups/
   

自定义存储路径

高级用户可以通过修改配置文件调整存储位置：

1. 修改server.conf中的data.directory参数
2. 使用环境变量TACHIDESK_DATA_DIR指定新路径

技术建议

1. 文件格式
   下载内容可能以以下形式存在：

   • 打包格式（CBZ/CBR）
   • 原始图片文件（JPEG/PNG）
   • 临时下载片段

2. 清理策略
   应用会自动管理存储空间，但用户可手动删除不需要的章节文件

3. 迁移数据
   如需迁移数据目录，建议：

   • 先停止服务器
   • 使用rsync等工具保持文件权限
   • 更新配置文件路径

对于开发者而言，理解这个存储结构有助于进行二次开发或故障排查。普通用户则可以通过这些路径管理本地存储内容，优化设备空间使用。