Skip to main content

Module paths

Module paths 

Source
Expand description

W-43a 产品化:默认路径与 WAL 目录自动创建。

产品化的「零配置」体验:用户什么都不配置时,审计账本落在用户家目录的 .wanning/wal.jsonl 下(Windows = %USERPROFILE%\.wanning\wal.jsonl), 父目录不存在就自动创建。两件事都刻意保守:

  • 家目录解析顺序固定为 WANNING_HOME(测试/隔离开关,不是用户要配的东西) → USERPROFILE(Windows 标准)→ HOME(Unix 标准);三处都拿不到就返回 None,调用方 fail-closed 报错并给「显式路径」逃生门——绝不猜一个落点, 也绝不静默落到当前目录。
  • 只自动建 WAL 的父目录这一个目录,不建「.wanning 之外的任何东西」;裸文件名 (无父目录)是 no-op。

Functions§

default_home
默认配置/账本根目录:<home>/.wanning(Windows = %USERPROFILE%\.wanning)。
default_wal_path
默认审计账本路径:<home>/.wanning/wal.jsonl。纯路径计算,零 IO。
ensure_wal_parent
确保 WAL 的父目录存在(不存在则递归创建;已存在或裸文件名 = no-op)。
home_dir
解析家目录。三处都拿不到 = None(fail-closed,调用方报错,绝不猜落点)。