普贤教程 › 包参考

dirs 包

系统/XDG 目录探测

项	值
包名	`dirs`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`dirs.px`
分类	`文件系统`
文件数 / 行数	`1 / 103`

安装与引入

bash

pxpkg init          # 首次
pxpkg add dirs@0.2.0
pxpkg install

import dirs

所属分类教程：文件系统

公开接口

函数	参数
`dr_home`
`dr_config`
`dr_data`
`dr_cache`
`dr_temp`
`dr_pjoin`	`parts`

其余 11 个 def（内部与辅助，可直接调用但不属稳定接口）

函数	参数
`dr_env`	`s`
`dr_log`
`dr_app_config`	`app_name`
`dr_app_data`	`app_name`
`dr_app_cache`	`app_name`
`dr_desktop`
`dr_documents`
`dr_downloads`
`dr_pictures`
`dr_music`
`dr_videos`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/dirs —— 系统/XDG 目录探测
------------------------------------------------------------
纯函数库（无状态；读取进程环境变量），编译（px build）与解释（px run）双模式一致。
dr_home()    → 用户主目录（$HOME，无则 "/root"）
dr_config()  → $XDG_CONFIG_HOME 或 ~/.config
dr_data()    → $XDG_DATA_HOME 或 ~/.local/share
dr_cache()   → $XDG_CACHE_HOME 或 ~/.cache
dr_temp()    → $TMPDIR 或 /tmp
dr_pjoin(parts) → 路径拼接（"/"）
============================================================