From 6f006f3c1aa000b2b419b94cba4d4f6731b3ec31 Mon Sep 17 00:00:00 2001 From: Ju4tCode <42488585+yanyongyu@users.noreply.github.com> Date: Sun, 2 Mar 2025 12:36:32 +0800 Subject: [PATCH] =?UTF-8?q?:memo:=20Docs:=20=E6=B7=BB=E5=8A=A0=20localstor?= =?UTF-8?q?e=20`use=5Fcwd`=20=E9=85=8D=E7=BD=AE=E9=A1=B9=E6=96=87=E6=A1=A3?= =?UTF-8?q?=20(#3345)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- website/docs/best-practice/data-storing.md | 36 +++++++++++++------ .../best-practice/data-storing.md | 36 +++++++++++++------ .../best-practice/data-storing.md | 36 +++++++++++++------ .../best-practice/data-storing.md | 36 +++++++++++++------ 4 files changed, 104 insertions(+), 40 deletions(-) diff --git a/website/docs/best-practice/data-storing.md b/website/docs/best-practice/data-storing.md index 95ad7970..d88214c0 100644 --- a/website/docs/best-practice/data-storing.md +++ b/website/docs/best-practice/data-storing.md @@ -68,15 +68,27 @@ data = data_file.read_text() ## 配置项 +### localstore_use_cwd + +使用当前工作目录作为数据存储目录，以下数据目录配置项默认值将会对应变更 + +默认值：`False` + +```dotenv +LOCALSTORE_USE_CWD=true +``` + ### localstore_cache_dir 自定义缓存目录 默认值： -- macOS: `~/Library/Caches/` -- Unix: `~/.cache/` (XDG default) -- Windows: `C:\Users\\AppData\Local\\Cache` +当 `localstore_use_cwd` 为 `True` 时，缓存目录为 `/cache`，否则： + +- macOS: `~/Library/Caches/nonebot2` +- Unix: `~/.cache/nonebot2` (XDG default) +- Windows: `C:\Users\\AppData\Local\nonebot2\Cache` ```dotenv LOCALSTORE_CACHE_DIR=/tmp/cache @@ -88,10 +100,12 @@ LOCALSTORE_CACHE_DIR=/tmp/cache 默认值： -- macOS: `~/Library/Application Support/` -- Unix: `~/.local/share/` or in $XDG_DATA_HOME, if defined -- Win XP (not roaming): `C:\Documents and Settings\\Application Data\` -- Win 7 (not roaming): `C:\Users\\AppData\Local\` +当 `localstore_use_cwd` 为 `True` 时，数据目录为 `/data`，否则： + +- macOS: `~/Library/Application Support/nonebot2` +- Unix: `~/.local/share/nonebot2` or in $XDG_DATA_HOME, if defined +- Win XP (not roaming): `C:\Documents and Settings\\Application Data\nonebot2` +- Win 7 (not roaming): `C:\Users\\AppData\Local\nonebot2` ```dotenv LOCALSTORE_DATA_DIR=/tmp/data @@ -103,10 +117,12 @@ LOCALSTORE_DATA_DIR=/tmp/data 默认值： +当 `localstore_use_cwd` 为 `True` 时，配置目录为 `/config`，否则： + - macOS: same as user_data_dir -- Unix: `~/.config/` -- Win XP (roaming): `C:\Documents and Settings\\Local Settings\Application Data\` -- Win 7 (roaming): `C:\Users\\AppData\Roaming\` +- Unix: `~/.config/nonebot2` +- Win XP (roaming): `C:\Documents and Settings\\Local Settings\Application Data\nonebot2` +- Win 7 (roaming): `C:\Users\\AppData\Roaming\nonebot2` ```dotenv LOCALSTORE_CONFIG_DIR=/tmp/config diff --git a/website/versioned_docs/version-2.3.3/best-practice/data-storing.md b/website/versioned_docs/version-2.3.3/best-practice/data-storing.md index 95ad7970..d88214c0 100644 --- a/website/versioned_docs/version-2.3.3/best-practice/data-storing.md +++ b/website/versioned_docs/version-2.3.3/best-practice/data-storing.md @@ -68,15 +68,27 @@ data = data_file.read_text() ## 配置项 +### localstore_use_cwd + +使用当前工作目录作为数据存储目录，以下数据目录配置项默认值将会对应变更 + +默认值：`False` + +```dotenv +LOCALSTORE_USE_CWD=true +``` + ### localstore_cache_dir 自定义缓存目录 默认值： -- macOS: `~/Library/Caches/` -- Unix: `~/.cache/` (XDG default) -- Windows: `C:\Users\\AppData\Local\\Cache` +当 `localstore_use_cwd` 为 `True` 时，缓存目录为 `/cache`，否则： + +- macOS: `~/Library/Caches/nonebot2` +- Unix: `~/.cache/nonebot2` (XDG default) +- Windows: `C:\Users\\AppData\Local\nonebot2\Cache` ```dotenv LOCALSTORE_CACHE_DIR=/tmp/cache @@ -88,10 +100,12 @@ LOCALSTORE_CACHE_DIR=/tmp/cache 默认值： -- macOS: `~/Library/Application Support/` -- Unix: `~/.local/share/` or in $XDG_DATA_HOME, if defined -- Win XP (not roaming): `C:\Documents and Settings\\Application Data\` -- Win 7 (not roaming): `C:\Users\\AppData\Local\` +当 `localstore_use_cwd` 为 `True` 时，数据目录为 `/data`，否则： + +- macOS: `~/Library/Application Support/nonebot2` +- Unix: `~/.local/share/nonebot2` or in $XDG_DATA_HOME, if defined +- Win XP (not roaming): `C:\Documents and Settings\\Application Data\nonebot2` +- Win 7 (not roaming): `C:\Users\\AppData\Local\nonebot2` ```dotenv LOCALSTORE_DATA_DIR=/tmp/data @@ -103,10 +117,12 @@ LOCALSTORE_DATA_DIR=/tmp/data 默认值： +当 `localstore_use_cwd` 为 `True` 时，配置目录为 `/config`，否则： + - macOS: same as user_data_dir -- Unix: `~/.config/` -- Win XP (roaming): `C:\Documents and Settings\\Local Settings\Application Data\` -- Win 7 (roaming): `C:\Users\\AppData\Roaming\` +- Unix: `~/.config/nonebot2` +- Win XP (roaming): `C:\Documents and Settings\\Local Settings\Application Data\nonebot2` +- Win 7 (roaming): `C:\Users\\AppData\Roaming\nonebot2` ```dotenv LOCALSTORE_CONFIG_DIR=/tmp/config diff --git a/website/versioned_docs/version-2.4.0/best-practice/data-storing.md b/website/versioned_docs/version-2.4.0/best-practice/data-storing.md index 95ad7970..d88214c0 100644 --- a/website/versioned_docs/version-2.4.0/best-practice/data-storing.md +++ b/website/versioned_docs/version-2.4.0/best-practice/data-storing.md @@ -68,15 +68,27 @@ data = data_file.read_text() ## 配置项 +### localstore_use_cwd + +使用当前工作目录作为数据存储目录，以下数据目录配置项默认值将会对应变更 + +默认值：`False` + +```dotenv +LOCALSTORE_USE_CWD=true +``` + ### localstore_cache_dir 自定义缓存目录 默认值： -- macOS: `~/Library/Caches/` -- Unix: `~/.cache/` (XDG default) -- Windows: `C:\Users\\AppData\Local\\Cache` +当 `localstore_use_cwd` 为 `True` 时，缓存目录为 `/cache`，否则： + +- macOS: `~/Library/Caches/nonebot2` +- Unix: `~/.cache/nonebot2` (XDG default) +- Windows: `C:\Users\\AppData\Local\nonebot2\Cache` ```dotenv LOCALSTORE_CACHE_DIR=/tmp/cache @@ -88,10 +100,12 @@ LOCALSTORE_CACHE_DIR=/tmp/cache 默认值： -- macOS: `~/Library/Application Support/` -- Unix: `~/.local/share/` or in $XDG_DATA_HOME, if defined -- Win XP (not roaming): `C:\Documents and Settings\\Application Data\` -- Win 7 (not roaming): `C:\Users\\AppData\Local\` +当 `localstore_use_cwd` 为 `True` 时，数据目录为 `/data`，否则： + +- macOS: `~/Library/Application Support/nonebot2` +- Unix: `~/.local/share/nonebot2` or in $XDG_DATA_HOME, if defined +- Win XP (not roaming): `C:\Documents and Settings\\Application Data\nonebot2` +- Win 7 (not roaming): `C:\Users\\AppData\Local\nonebot2` ```dotenv LOCALSTORE_DATA_DIR=/tmp/data @@ -103,10 +117,12 @@ LOCALSTORE_DATA_DIR=/tmp/data 默认值： +当 `localstore_use_cwd` 为 `True` 时，配置目录为 `/config`，否则： + - macOS: same as user_data_dir -- Unix: `~/.config/` -- Win XP (roaming): `C:\Documents and Settings\\Local Settings\Application Data\` -- Win 7 (roaming): `C:\Users\\AppData\Roaming\` +- Unix: `~/.config/nonebot2` +- Win XP (roaming): `C:\Documents and Settings\\Local Settings\Application Data\nonebot2` +- Win 7 (roaming): `C:\Users\\AppData\Roaming\nonebot2` ```dotenv LOCALSTORE_CONFIG_DIR=/tmp/config diff --git a/website/versioned_docs/version-2.4.1/best-practice/data-storing.md b/website/versioned_docs/version-2.4.1/best-practice/data-storing.md index 95ad7970..d88214c0 100644 --- a/website/versioned_docs/version-2.4.1/best-practice/data-storing.md +++ b/website/versioned_docs/version-2.4.1/best-practice/data-storing.md @@ -68,15 +68,27 @@ data = data_file.read_text() ## 配置项 +### localstore_use_cwd + +使用当前工作目录作为数据存储目录，以下数据目录配置项默认值将会对应变更 + +默认值：`False` + +```dotenv +LOCALSTORE_USE_CWD=true +``` + ### localstore_cache_dir 自定义缓存目录 默认值： -- macOS: `~/Library/Caches/` -- Unix: `~/.cache/` (XDG default) -- Windows: `C:\Users\\AppData\Local\\Cache` +当 `localstore_use_cwd` 为 `True` 时，缓存目录为 `/cache`，否则： + +- macOS: `~/Library/Caches/nonebot2` +- Unix: `~/.cache/nonebot2` (XDG default) +- Windows: `C:\Users\\AppData\Local\nonebot2\Cache` ```dotenv LOCALSTORE_CACHE_DIR=/tmp/cache @@ -88,10 +100,12 @@ LOCALSTORE_CACHE_DIR=/tmp/cache 默认值： -- macOS: `~/Library/Application Support/` -- Unix: `~/.local/share/` or in $XDG_DATA_HOME, if defined -- Win XP (not roaming): `C:\Documents and Settings\\Application Data\` -- Win 7 (not roaming): `C:\Users\\AppData\Local\` +当 `localstore_use_cwd` 为 `True` 时，数据目录为 `/data`，否则： + +- macOS: `~/Library/Application Support/nonebot2` +- Unix: `~/.local/share/nonebot2` or in $XDG_DATA_HOME, if defined +- Win XP (not roaming): `C:\Documents and Settings\\Application Data\nonebot2` +- Win 7 (not roaming): `C:\Users\\AppData\Local\nonebot2` ```dotenv LOCALSTORE_DATA_DIR=/tmp/data @@ -103,10 +117,12 @@ LOCALSTORE_DATA_DIR=/tmp/data 默认值： +当 `localstore_use_cwd` 为 `True` 时，配置目录为 `/config`，否则： + - macOS: same as user_data_dir -- Unix: `~/.config/` -- Win XP (roaming): `C:\Documents and Settings\\Local Settings\Application Data\` -- Win 7 (roaming): `C:\Users\\AppData\Roaming\` +- Unix: `~/.config/nonebot2` +- Win XP (roaming): `C:\Documents and Settings\\Local Settings\Application Data\nonebot2` +- Win 7 (roaming): `C:\Users\\AppData\Roaming\nonebot2` ```dotenv LOCALSTORE_CONFIG_DIR=/tmp/config