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,调用方报错,绝不猜落点)。