第二十三节 文件命名约定

[!ref] 详解见用户手册「工作区」节。

下表为用户可见的文件命名规则,方便手工脚本化处理(不要修改这些文件,除非显式说明可以)。

类别 命名格式 说明
会话文件 <sid>.jsonl sid 为 8 字符随机;前 4 位为短 id
计划快照 <sid>.plan.json 与 jsonl 同名
待办快照 <sid>.todos.json
工作区配置 agents.yaml tools.yaml channels.yaml 各功能独立文件
技能 <skill-name>/SKILL.md 技能根目录名建议小写连字符
助手人设 <persona-id>.yaml 路径斜杠以 __ 编码
日志 avlcode-YYYYMMDD.log 按日轮转