# xiaoya-kits
> 小雅 alist 部署和维护。
## ❤️ 赞助
`xiaoya-kits` 完全免费获取及使用，但是您的赞赏可以鼓励作者维护，万分谢谢！
### 🌟 GitHub Star
请点击 [GitHub](https://github.com/podboy/xiaoya-kits) 右上角的 `⭐ Star` 增加人气，以便更多的人发现此工具。
### 💽 转存阿里云盘文件
点击链接保存，或者复制本段内容，打开「阿里云盘」APP 。
<https://www.alipan.com/s/dn6J8Gg4FUC>
这是一个非常小的文件（仅占用您几KB空间），您的转存可以使作者获得更多的存储空间。
### 💰 打赏
欢迎直接通过打赏来支持作者！
## 🗑️ xiaoya clear-aliyundrive
> 一个清理`阿里云盘`中 `xiaoya` 转存文件的工具。
### 为什么选择 `xiaoya clear-aliyundrive`
相比于其他（使用 `Shell` 开发）的清理脚本，`xiaoya clear-aliyundrive` 的清理更加灵活。
由于 `xiaoya-kits` 基于 `Python` 开发，并且使用了 [xarg-python](https://github.com/bondbox/xarg-python) 模块，因此 `xiaoya clear-aliyundrive` 命令行更为友好，可同时进行多维度的清理过滤，维护也相对来说更加简单。
### 过滤条件
`xiaoya clear-aliyundrive` 会对小雅转存文件夹下的所有文件（包括文件夹）按照 `updated_at` 时间进行排序，所有最新的转存文件会被优先保留。
#### 强制条件
1. 为避免清理正在转存或者刚刚转存的文件，会强制保留 `60` 秒内的文件（和文件夹）。
2. 由于当前文件夹没有 `size` 属性，还无法统计文件夹的占用空间，并且小雅一般转存的都是文件而非文件夹，所以文件夹会被强制清理。
3. 虽然可以根据文件大小来过滤文件，但是（大于空间约束条件的）超大文件总是会被清理，所以必须强制保留一些（没有过时的）文件。
#### 清理过多的文件
`--file`，十进制数，指定最大保留的文件数（默认值为：100）。
按照 `updated_at` 时间进行排序，超过指定数量后的文件会被强制清理。
**默认值 `100` 应该够保持一部电视连续剧了，如果你转存了非常多的小文件，可适当增大此值。**
#### 清理较大的文件
`--byte`，十进制数，最大保留的空间量（默认值为：50.0GB），单位为字节数。
按照 `updated_at` 时间进行排序并计算空间，超过指定空间后的文件会被清理。
**默认值 `50.0GB` 即一半的 `阿里云盘` 永久免费空间，如果您有更多可用空间或可用空间不足，可适当调整此值。**
#### 清理较早的文件
`--minute`，十进制数，最大保留的分钟值（默认值为：24h），单位为分钟。
按照 `updated_at` 时间，和当前时间的差值超过指定分钟数强制清理。
### ⏩ 快速清理（一次性）
使用 `Python>=3.8` 环境，在小雅数据目录下执行以下命令：
```bash
pip3 install --upgrade xiaoya && xiaoya --version
xiaoya clear-aliyundrive --stdout --format
```
### ⏱️ 定时清理
您可以将 `xiaoya clear-aliyundrive` 命令添加到 `crontab` 中，实现定时清理。
### 🪐 持续清理（守护模式）
在小雅数据目录下执行以下命令，使用守护模式持续清理，按 `ctrl+c` 退出：
```bash
pip3 install --upgrade xiaoya && xiaoya --version
xiaoya clear-aliyundrive --stdout --format --daemon
```
### docker 部署
```bash
docker run -v <xiaoya_config_path>:/etc/xiaoya --name xiaoya-clear ghcr.io/podboy/xiaoya-clear:latest
```
Raw data
{
"_id": null,
"home_page": "https://github.com/podboy/xiaoya-kits",
"name": "xiaoya",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "docker, podman",
"author": "Mingzhe Zou",
"author_email": "zoumingzhe@outlook.com",
"download_url": "https://files.pythonhosted.org/packages/c1/44/72380ca2069d7a953f32929e8f4aa98dce1f56303b000d00c1c740f91377/xiaoya-0.1.6.tar.gz",
"platform": "any",
"description": "# xiaoya-kits\n\n> \u5c0f\u96c5 alist \u90e8\u7f72\u548c\u7ef4\u62a4\u3002\n\n## \u2764\ufe0f \u8d5e\u52a9\n\n`xiaoya-kits` \u5b8c\u5168\u514d\u8d39\u83b7\u53d6\u53ca\u4f7f\u7528\uff0c\u4f46\u662f\u60a8\u7684\u8d5e\u8d4f\u53ef\u4ee5\u9f13\u52b1\u4f5c\u8005\u7ef4\u62a4\uff0c\u4e07\u5206\u8c22\u8c22\uff01\n\n### \ud83c\udf1f GitHub Star\n\n\u8bf7\u70b9\u51fb [GitHub](https://github.com/podboy/xiaoya-kits) \u53f3\u4e0a\u89d2\u7684 `\u2b50 Star` \u589e\u52a0\u4eba\u6c14\uff0c\u4ee5\u4fbf\u66f4\u591a\u7684\u4eba\u53d1\u73b0\u6b64\u5de5\u5177\u3002\n\n### \ud83d\udcbd \u8f6c\u5b58\u963f\u91cc\u4e91\u76d8\u6587\u4ef6\n\n\u70b9\u51fb\u94fe\u63a5\u4fdd\u5b58\uff0c\u6216\u8005\u590d\u5236\u672c\u6bb5\u5185\u5bb9\uff0c\u6253\u5f00\u300c\u963f\u91cc\u4e91\u76d8\u300dAPP \u3002\n\n<https://www.alipan.com/s/dn6J8Gg4FUC>\n\n\u8fd9\u662f\u4e00\u4e2a\u975e\u5e38\u5c0f\u7684\u6587\u4ef6\uff08\u4ec5\u5360\u7528\u60a8\u51e0KB\u7a7a\u95f4\uff09\uff0c\u60a8\u7684\u8f6c\u5b58\u53ef\u4ee5\u4f7f\u4f5c\u8005\u83b7\u5f97\u66f4\u591a\u7684\u5b58\u50a8\u7a7a\u95f4\u3002\n\n### \ud83d\udcb0 \u6253\u8d4f\n\n\u6b22\u8fce\u76f4\u63a5\u901a\u8fc7\u6253\u8d4f\u6765\u652f\u6301\u4f5c\u8005\uff01\n\n\n\n## \ud83d\uddd1\ufe0f xiaoya clear-aliyundrive\n\n> \u4e00\u4e2a\u6e05\u7406`\u963f\u91cc\u4e91\u76d8`\u4e2d `xiaoya` \u8f6c\u5b58\u6587\u4ef6\u7684\u5de5\u5177\u3002\n\n### \u4e3a\u4ec0\u4e48\u9009\u62e9 `xiaoya clear-aliyundrive`\n\n\u76f8\u6bd4\u4e8e\u5176\u4ed6\uff08\u4f7f\u7528 `Shell` \u5f00\u53d1\uff09\u7684\u6e05\u7406\u811a\u672c\uff0c`xiaoya clear-aliyundrive` \u7684\u6e05\u7406\u66f4\u52a0\u7075\u6d3b\u3002\n\n\u7531\u4e8e `xiaoya-kits` \u57fa\u4e8e `Python` \u5f00\u53d1\uff0c\u5e76\u4e14\u4f7f\u7528\u4e86 [xarg-python](https://github.com/bondbox/xarg-python) \u6a21\u5757\uff0c\u56e0\u6b64 `xiaoya clear-aliyundrive` \u547d\u4ee4\u884c\u66f4\u4e3a\u53cb\u597d\uff0c\u53ef\u540c\u65f6\u8fdb\u884c\u591a\u7ef4\u5ea6\u7684\u6e05\u7406\u8fc7\u6ee4\uff0c\u7ef4\u62a4\u4e5f\u76f8\u5bf9\u6765\u8bf4\u66f4\u52a0\u7b80\u5355\u3002\n\n### \u8fc7\u6ee4\u6761\u4ef6\n\n`xiaoya clear-aliyundrive` \u4f1a\u5bf9\u5c0f\u96c5\u8f6c\u5b58\u6587\u4ef6\u5939\u4e0b\u7684\u6240\u6709\u6587\u4ef6\uff08\u5305\u62ec\u6587\u4ef6\u5939\uff09\u6309\u7167 `updated_at` \u65f6\u95f4\u8fdb\u884c\u6392\u5e8f\uff0c\u6240\u6709\u6700\u65b0\u7684\u8f6c\u5b58\u6587\u4ef6\u4f1a\u88ab\u4f18\u5148\u4fdd\u7559\u3002\n\n#### \u5f3a\u5236\u6761\u4ef6\n\n1. \u4e3a\u907f\u514d\u6e05\u7406\u6b63\u5728\u8f6c\u5b58\u6216\u8005\u521a\u521a\u8f6c\u5b58\u7684\u6587\u4ef6\uff0c\u4f1a\u5f3a\u5236\u4fdd\u7559 `60` \u79d2\u5185\u7684\u6587\u4ef6\uff08\u548c\u6587\u4ef6\u5939\uff09\u3002\n2. \u7531\u4e8e\u5f53\u524d\u6587\u4ef6\u5939\u6ca1\u6709 `size` \u5c5e\u6027\uff0c\u8fd8\u65e0\u6cd5\u7edf\u8ba1\u6587\u4ef6\u5939\u7684\u5360\u7528\u7a7a\u95f4\uff0c\u5e76\u4e14\u5c0f\u96c5\u4e00\u822c\u8f6c\u5b58\u7684\u90fd\u662f\u6587\u4ef6\u800c\u975e\u6587\u4ef6\u5939\uff0c\u6240\u4ee5\u6587\u4ef6\u5939\u4f1a\u88ab\u5f3a\u5236\u6e05\u7406\u3002\n3. \u867d\u7136\u53ef\u4ee5\u6839\u636e\u6587\u4ef6\u5927\u5c0f\u6765\u8fc7\u6ee4\u6587\u4ef6\uff0c\u4f46\u662f\uff08\u5927\u4e8e\u7a7a\u95f4\u7ea6\u675f\u6761\u4ef6\u7684\uff09\u8d85\u5927\u6587\u4ef6\u603b\u662f\u4f1a\u88ab\u6e05\u7406\uff0c\u6240\u4ee5\u5fc5\u987b\u5f3a\u5236\u4fdd\u7559\u4e00\u4e9b\uff08\u6ca1\u6709\u8fc7\u65f6\u7684\uff09\u6587\u4ef6\u3002\n\n#### \u6e05\u7406\u8fc7\u591a\u7684\u6587\u4ef6\n\n`--file`\uff0c\u5341\u8fdb\u5236\u6570\uff0c\u6307\u5b9a\u6700\u5927\u4fdd\u7559\u7684\u6587\u4ef6\u6570\uff08\u9ed8\u8ba4\u503c\u4e3a\uff1a100\uff09\u3002\n\n\u6309\u7167 `updated_at` \u65f6\u95f4\u8fdb\u884c\u6392\u5e8f\uff0c\u8d85\u8fc7\u6307\u5b9a\u6570\u91cf\u540e\u7684\u6587\u4ef6\u4f1a\u88ab\u5f3a\u5236\u6e05\u7406\u3002\n\n**\u9ed8\u8ba4\u503c `100` \u5e94\u8be5\u591f\u4fdd\u6301\u4e00\u90e8\u7535\u89c6\u8fde\u7eed\u5267\u4e86\uff0c\u5982\u679c\u4f60\u8f6c\u5b58\u4e86\u975e\u5e38\u591a\u7684\u5c0f\u6587\u4ef6\uff0c\u53ef\u9002\u5f53\u589e\u5927\u6b64\u503c\u3002**\n\n#### \u6e05\u7406\u8f83\u5927\u7684\u6587\u4ef6\n\n`--byte`\uff0c\u5341\u8fdb\u5236\u6570\uff0c\u6700\u5927\u4fdd\u7559\u7684\u7a7a\u95f4\u91cf\uff08\u9ed8\u8ba4\u503c\u4e3a\uff1a50.0GB\uff09\uff0c\u5355\u4f4d\u4e3a\u5b57\u8282\u6570\u3002\n\n\u6309\u7167 `updated_at` \u65f6\u95f4\u8fdb\u884c\u6392\u5e8f\u5e76\u8ba1\u7b97\u7a7a\u95f4\uff0c\u8d85\u8fc7\u6307\u5b9a\u7a7a\u95f4\u540e\u7684\u6587\u4ef6\u4f1a\u88ab\u6e05\u7406\u3002\n\n**\u9ed8\u8ba4\u503c `50.0GB` \u5373\u4e00\u534a\u7684 `\u963f\u91cc\u4e91\u76d8` \u6c38\u4e45\u514d\u8d39\u7a7a\u95f4\uff0c\u5982\u679c\u60a8\u6709\u66f4\u591a\u53ef\u7528\u7a7a\u95f4\u6216\u53ef\u7528\u7a7a\u95f4\u4e0d\u8db3\uff0c\u53ef\u9002\u5f53\u8c03\u6574\u6b64\u503c\u3002**\n\n#### \u6e05\u7406\u8f83\u65e9\u7684\u6587\u4ef6\n\n`--minute`\uff0c\u5341\u8fdb\u5236\u6570\uff0c\u6700\u5927\u4fdd\u7559\u7684\u5206\u949f\u503c\uff08\u9ed8\u8ba4\u503c\u4e3a\uff1a24h\uff09\uff0c\u5355\u4f4d\u4e3a\u5206\u949f\u3002\n\n\u6309\u7167 `updated_at` \u65f6\u95f4\uff0c\u548c\u5f53\u524d\u65f6\u95f4\u7684\u5dee\u503c\u8d85\u8fc7\u6307\u5b9a\u5206\u949f\u6570\u5f3a\u5236\u6e05\u7406\u3002\n\n### \u23e9 \u5feb\u901f\u6e05\u7406\uff08\u4e00\u6b21\u6027\uff09\n\n\u4f7f\u7528 `Python>=3.8` \u73af\u5883\uff0c\u5728\u5c0f\u96c5\u6570\u636e\u76ee\u5f55\u4e0b\u6267\u884c\u4ee5\u4e0b\u547d\u4ee4\uff1a\n\n```bash\npip3 install --upgrade xiaoya && xiaoya --version\nxiaoya clear-aliyundrive --stdout --format\n```\n\n### \u23f1\ufe0f \u5b9a\u65f6\u6e05\u7406\n\n\u60a8\u53ef\u4ee5\u5c06 `xiaoya clear-aliyundrive` \u547d\u4ee4\u6dfb\u52a0\u5230 `crontab` \u4e2d\uff0c\u5b9e\u73b0\u5b9a\u65f6\u6e05\u7406\u3002\n\n### \ud83e\ude90 \u6301\u7eed\u6e05\u7406\uff08\u5b88\u62a4\u6a21\u5f0f\uff09\n\n\u5728\u5c0f\u96c5\u6570\u636e\u76ee\u5f55\u4e0b\u6267\u884c\u4ee5\u4e0b\u547d\u4ee4\uff0c\u4f7f\u7528\u5b88\u62a4\u6a21\u5f0f\u6301\u7eed\u6e05\u7406\uff0c\u6309 `ctrl+c` \u9000\u51fa\uff1a\n\n```bash\npip3 install --upgrade xiaoya && xiaoya --version\nxiaoya clear-aliyundrive --stdout --format --daemon\n```\n\n### docker \u90e8\u7f72\n\n```bash\ndocker run -v <xiaoya_config_path>:/etc/xiaoya --name xiaoya-clear ghcr.io/podboy/xiaoya-clear:latest\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "\u5c0f\u96c5 alist \u90e8\u7f72\u548c\u7ef4\u62a4",
"version": "0.1.6",
"project_urls": {
"Bug Tracker": "https://github.com/podboy/issues",
"Documentation": "https://github.com/podboy/xiaoya-kits",
"Homepage": "https://github.com/podboy/xiaoya-kits",
"Source Code": "https://github.com/podboy/xiaoya-kits"
},
"split_keywords": [
"docker",
" podman"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8559c99e25e2dd575fce8350703a8169bfbb1d1644b7cc42439839da5241f543",
"md5": "3cefb5e961429d92be90cf707ad89398",
"sha256": "5bc688f18dea9c02ef2b3f2827b172dcabcab80554d6131d198f0a3d6de580ac"
},
"downloads": -1,
"filename": "xiaoya-0.1.6-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "3cefb5e961429d92be90cf707ad89398",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.8",
"size": 11025,
"upload_time": "2024-07-05T11:26:16",
"upload_time_iso_8601": "2024-07-05T11:26:16.659346Z",
"url": "https://files.pythonhosted.org/packages/85/59/c99e25e2dd575fce8350703a8169bfbb1d1644b7cc42439839da5241f543/xiaoya-0.1.6-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c14472380ca2069d7a953f32929e8f4aa98dce1f56303b000d00c1c740f91377",
"md5": "0989cb1e16da2659d48ea2e6501a1955",
"sha256": "5a8968d9dbe59db69576759e8531be93588f4b4616168fa48e5b6e05dbf2a39e"
},
"downloads": -1,
"filename": "xiaoya-0.1.6.tar.gz",
"has_sig": false,
"md5_digest": "0989cb1e16da2659d48ea2e6501a1955",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 11199,
"upload_time": "2024-07-05T11:26:14",
"upload_time_iso_8601": "2024-07-05T11:26:14.498053Z",
"url": "https://files.pythonhosted.org/packages/c1/44/72380ca2069d7a953f32929e8f4aa98dce1f56303b000d00c1c740f91377/xiaoya-0.1.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-05 11:26:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "podboy",
"github_project": "xiaoya-kits",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "xarg-python",
"specs": [
[
">=",
"1.5.1"
]
]
},
{
"name": "requests",
"specs": []
}
],
"lcname": "xiaoya"
}
JSON
