文件与路径

八千代持久化的一切都在同一个目录里。别处没有隐藏状态，没有某个在暗中起作用的 application-support 缓存，也没有服务器留着一份副本。

~/.yachiyo

路径	是什么
config.toml	所有设置 —— 供应商、工具、技能、记忆、网页搜索。参考
channels.toml	频道凭据与调参。参考
yachiyo.sqlite	线程、消息、工具调用、记忆、定时任务、运行历史
SOUL.md	助手人格与演化中的特质日志
USER.md	你的档案，以结构化表格记录
skills/core/	内置技能。每次启动重新解压 —— 改动会丢失。
skills/custom/	你自己的技能
bin/yachiyo	命令行包装脚本。每次启动重新生成；不要编辑。
yachiyo.sock	send 系列命令通信用的 Unix socket
temp-workspace/<thread-id>/	为没有分配目录的线程自动创建的工作区
file-history/	运行的文件快照（内容寻址）
workspace-indexes/	已注册工作区的搜索索引
web-search/browser-session/	搜索使用的隐藏浏览器会话
browser-automation/	useBrowser 的会话和配置文件
jotdowns/	用速记快捷键记下的短笔记
activity-source.key	活动来源的密钥

YACHIYO_HOME

设置 YACHIYO_HOME 可以整个目录搬家：

YACHIYO_HOME=/tmp/yachiyo-test yachiyo thread list

上面的一切会一起挪走 —— 配置、数据库、技能、socket。想跑一个隔离实例做测试又不碰真实历史，这是最干净的做法。

命令行也可以只指向单个文件，想读一份数据库副本而不动其他东西时很方便：

yachiyo thread list --db /path/to/yachiyo.sqlite
yachiyo config get --settings /path/to/config.toml
yachiyo soul traits list --soul /path/to/SOUL.md

该备份什么

优先级	路径	为什么
高	yachiyo.sqlite	你的全部对话历史
高	SOUL.md、USER.md	人格与档案 —— 很小，但重建起来很慢
高	skills/custom/	你写的技能
中	config.toml	设置。含 API key —— 请加密。
中	channels.toml	机器人凭据。同样的警告。
跳过	temp-workspace/、file-history/、workspace-indexes/、web-search/、browser-automation/	可再生成，而且很大

什么会离开你的机器

只有你引发的那些请求：发给你自己配置的供应商的调用、智能体抓取的页面、你执行的搜索，以及频道消息。没有遥测，也没有托管后端。

同步是唯一的例外，而且它需要主动开启并指向一个你自己选的文件夹 —— 它会把 config.toml（含 API key）和聊天存档复制进那个目录。