Kuingsmile/PicHoro：一款手机端云存储平台/图床管理和文件上传/下载工具，支持直接

技术解读

以下内容由 GitRead 中文社区编辑团队基于项目 README 与官方资料整理，结合中文开发者的常见使用场景补充技术选型建议。具体以项目官方文档为准。

Kuingsmile/PicHoro 深度技术分析

项目背景与痛点

Kuingsmile/PicHoro 是一款手机端的云存储平台及图床管理工具，通过支持多样的云存储平台（包括 WebDAV、Alist、SSH/SFTP、S3、腾讯COS、阿里OSS等），极大提高了用户的存储和管理图片的能力。PicHoro 解决了传统云存储应用在便捷性、灵活性以及兼容性上的不足。其重点在于为开发者和用户提供一个统一的接口来管理不同云服务商的数据，从而减少用户在多种存储服务之间横跳的麻烦。

核心技术揭秘

PicHoro 内部的数据处理和传输流程是其核心技术之一。以下是一个简化的数据流图，展示请求从用户发起到最终处理的过程。

graph TD A[用户请求] --> B{"参数校验"} B -->|"通过"| C[协议适配层] B -->|"失败"| D[返回错误] C --> E[数据操作] E --> F{"数据修改"} F -->|"是"| G[数据推送] F -->|"否"| H[数据拉取] G --> I[返回结果] H --> I

核心被分成了几个主要部分：

协议适配层：负责对接不同的存储协议（如WebDAV、Alist等），由此保证了PicHoro对于多种云存储的兼容性。
数据操作：包含了CRUD操作，同时也要负责从中间件层获取或推送数据。
数据推送：这个环节负责将操作的数据更新到相应的存储后台。

此设计通过提供一个统一的接口来分离用户与底层存储机制，有效地提升了系统的可扩展性和兼容性。

功能亮点与差异

PicHoro 的独特之处主要在于其广泛的兼容性和易用性。目前市场上，不少同类产品要么功能单一，要么重点突出但兼容性欠佳。PicHoro 综合多个云存储平台，支撑几十种常见协议，同时提供了优化的使用体验。使得用户的文件管理过程更加流畅。

应用场景与落地建议

在生产环境中使用 PicHoro，最重要的是确保其服务接口与第三方云存储的兼容性。同时，安全也是不可忽视的一环，开发者应当注意用户隐私和数据安全。这款应用适合在多云环境部署，比如用户体验一致性要求高，或者需要随时迁移云服务商时。

综合评价

PicHoro 的设计思路和技术实现都展示了极高的综合水平，其广泛兼容的特性和对接多种云储存接口的能力，使得它非常适合需要跨平台进行云原生存储和管理的场景。其不足之处在于部分新用户可能需要更详细的文档来帮助理解如何有效地使用产品。尽管如此，PicHoro 在优化使用体验方面进行了许多努力，可以说是一款值得推荐的工具。

关于

flutter picgo android aliyun-oss github imgur qiniu smms tencent-cos upyun

MIT License
1.0k Stars
60 Forks
8 Watching

描述取自 GitHub 官方 API，保持仓库作者书写的原文。

简要分析

热度分

1149

价值分

631

活跃状态

活跃

GitHub

语言占比

Dart

Kotlin

Shell

Release

v3.0.12025年4月10日
v3.0.02025年4月7日
v2.4.02024年7月19日
v2.3.02024年4月13日
v2.2.42024年2月20日

贡献者

Kuingsmile

PicHoro

简介

PicHoro 是一款基于 Flutter 的手机端云存储平台/图床管理和文件上传/下载工具，最新版本 V3.0.1。

与 PicGo/PicList 配置互通，可直接扫码导入
支持云存储/图床/云服务器平台和网盘管理（通过 Alist）
提供文件上传、下载管理及多格式链接分享功能

支持多种图片/PDF/文本文件/音视频的在线预览和播放，具体支持的格式请查看支持的格式列表。

桌面端推荐：如果您需要桌面端图床管理，推荐使用 PicList

📘 项目介绍和配置手册

支持的图床/存储平台

特色功能

核心特性

云存储/图床管理 - 新建/删除/修改存储桶，创建/删除目录和文件，上传和下载文件和照片等
网盘管理 - 通过 Alist V3 或 WebDav 管理多种网盘
图片压缩 - 支持压缩为 webp/jpg/png 格式
多格式文件预览 - 包括图片/PDF/文本文件/音视频等
SSH/SFTP支持 - 可视化管理文件，内置 SSH 终端可直接管理云服务器
PicGo兼容性 - 支持扫描二维码将 PicGo(v2.3.0-beta.2 以上版本)配置文件直接导入 PicHoro

其他功能

每种图床最多支持 26 个备用配置，可快速切换
连续上传模式，相机拍照后自动上传并返回拍照页面
支持导入剪贴板中的网络图片链接，换行符分割可批量导入
上传图片后自动复制链接到剪贴板
自定义复制到剪贴板的链接格式，占位符与 PicGo 一致
多种文件重命名方式（时间戳、随机字符串和自定义重命名）
相册分图床显示，支持多选管理，复制多张图片链接或删除
支持导出配置至剪贴板（与 PicGo 配置文件格式相同）
查看和导出软件日志，快捷查找问题和报告 bug

文件预览支持

平台	图片	PDF	文本文件
Alist	✅	✅	✅
阿里云	✅	✅	✅
S3	✅	✅	✅
腾讯云	✅	✅	✅
又拍云	✅	✅	✅
七牛云	✅	✅	✅
WebDav	✅	✅	✅
FTP	✅	❌	✅
Github	✅	❌	✅
Imgur	✅	❌	❌
兰空	✅	❌	❌
SM.MS	✅	❌	❌

下载

安卓

Github 下载: Github release
官网下载: 最新版本 V3.0.1

iOS

目前暂无 iOS 版本。如果您有兴趣帮助开发 iOS 版本，请联系我们提供技术支持。

应用展示

开发与交流

开发进度: 查看 Projects
讨论交流: 加入 Github 讨论区
问题反馈: 在 Github Issues 提出

Telegram 交流群:

Telegram Group

开发说明

软件修改步骤

准备环境: 安装 Android Studio、Android SDK 21+ 和 Flutter 3.27
克隆仓库: git clone https://github.com/Kuingsmile/PicHoro.git
Windows 用户推荐使用 VSCode 编辑和调试代码

图床修改说明

兰空图床相册 ID 参数生效条件:

基于付费企业版兰空图床搭建
开源免费版需修改源代码文件 /app/Services/ImageService.php:

// 原代码
if ($albumId = $user->configs->get(UserConfigKey::DefaultAlbum)) {
    if ($user->albums()->where('id', $albumId)->exists()) {
        $image->album_id = $albumId;
    }
}

// 修改后
if ($request->has('album_id')) {
    $image->album_id = $request->input('album_id');
} else {
    if ($albumId = $user->configs->get(UserConfigKey::DefaultAlbum)) {
        if ($user->albums()->where('id', $albumId)->exists()) {
            $image->album_id = $albumId;
        }
    }
}

软件打包

使用以下命令构建:

flutter build apk --release

构建成功后，在 build\app\outputs\flutter-apk\release 生成 app-release.apk 文件。

注意: 请设置 minifyEnabled false 和 shrinkResources false，否则打包后可能闪退。

License

MIT

Github Star 趋势

暂无评论

PicHoro

技术解读

Kuingsmile/PicHoro 深度技术分析

项目背景与痛点

核心技术揭秘

功能亮点与差异

应用场景与落地建议

综合评价

相关仓库

关于

简要分析

语言占比

Release

贡献者

PicHoro

简介

支持的图床/存储平台

特色功能

核心特性

其他功能

文件预览支持

下载

安卓

iOS

应用展示

最近更新

开发与交流

开发说明

软件修改步骤

图床修改说明

软件打包

License

Github Star 趋势

评论