应用数据目录路径

灵感：热门库 env-paths（Get paths for storing things like data, config, cache, etc）。

> 小四原创：应用名 → envPaths → data/config/cache/log。
> CLI/本地工具存配置用；与 dotenv（读 .env）互补。

何时使用

• 本地 CLI 要放用户配置
• 缓存目录跟系统约定走
• 跨 Windows/macOS/Linux 统一取路径

硬约束

1. 依赖：env-paths。
2. name 用稳定应用标识（勿每次随机）。
3. 实现要点注释标 小四原创。
4. 不做配置 schema/加密存储全集。

推荐实现

import envPaths from 'env-paths'
import fs from 'fs-extra'
import path from 'node:path'

// 小四原创：应用数据目录路径
const paths = envPaths('beacon-toolbox')

export function getAppPaths() {
  return paths // { data, config, cache, log, temp }
}

export async function ensureConfigFile(filename = 'settings.json') {
  await fs.ensureDir(paths.config)
  return path.join(paths.config, filename)
}

Agent 步骤

1. npm i env-paths。
2. 用固定 name 取路径；写文件前 ensureDir。
3. 自测：能拿到非空 config/data 路径。

不要做

• 把配置写死在项目仓库目录却声称「用户级配置」。
• 与 dotenv-env-load 整篇复读：本 Skill 侧重 系统目录约定。

附加

• README.md · reference.md · templates/usage.md