家目录:_qqq

文档发表:2026-09-27 · 阅读:4 · 更新:2026-09-27

家目录:_qqq

为什么会有 _qqq? 因为 qqqide 把你得「家」安在项目里。云端工具的数据在别人服务器上;传统桌面工具的数据藏在系统深处(AppData、注册表)。qqqide 反过来——项目级数据一律落在项目文件夹内的 _qqq/:你得对话、你得上下文背包、你得文件史册、你得偏好,全部跟项目走、随项目迁移。

一个项目的一切,都在它自己的文件夹里

  • 把项目文件夹整体拷到 U 盘或另一台电脑,聊天记录、背包、文件历史原样跟着走;
  • 不拷 _qqq/,AI 就回到「第一层楼」——只是失忆,不是坏掉;
  • 它属于你:纯本地数据,接续对话不依赖任何「云端同步」;登录只为使用 AI 服务本身。
  • 在 AI 视口与 Roam 里,_qqq 与 _qqqvault 两个文件夹恒为红色加粗(仅此两目录,家目录特供,一眼可辨)。

顺带一提:程序自己的数据另有住处(绿色包的 Data/、系统的 %LOCALAPPDATA%/qqqide/)——那是软件的家;_qqq/ 是"你这个项目"的家。

成员全景

{你的项目}/
└── _qqq/
    ├── alphal/            ← 程序数据盒(程序格式,别手改)
    │   ├── .lock          ← 项目锁:防两个窗口同时写同一个项目
    │   ├── quest.sq3      ← 对话索引:每层楼一行元数据(约 200B/层,正文不在这)
    │   ├── only.sq3       ← 项目资产:编辑器标签、分栏布局、光标、树展开快照…
    │   ├── panel_re{l|c|r}.json ← 三面板各自「上次看到哪个任务」的续播记录
    │   ├── rule/project.txt ← 你得项目规则(RULES 两层规则之一)
    │   └── expert/        ← E-Flow 专家档案(index.md + arch/*.md)
    ├── quests/            ★ 对话正文仓库(体量大头)
    │   ├── q{n}.{任务名}/
    │   │   ├── ctx.json   ← 这个任务的上下文背包真理源(压缩饼干/事实清单)
    │   │   └── f{n}.{问题}/
    │   │       ├── all.json  ← 机器读:完整对话 + 工具调用 + 计费 + 现场数据
    │   │       ├── all.txt   ← 人类读:完整母本(想看 AI 到底收到了什么,看它)
    │   │       ├── reasoning.txt ← 审计版:工具结果截断到 300 字的精简版
    │   │       └── img_*.png · web_fetch_*.txt ← 你这层楼发过的图、抓取过的网页
    │   └── .trash/        ← 空壳归档:超过 30 分钟仍无内容的空目录自动移进这里
    ├── timeline/          ★ 文件史册(删掉的文件在这能找回来)
    │   ├── blobs/{xx}/{sha}.gz ← 每个文件的每个历史版本(内容寻址、不可变、永不删)
    │   ├── timeline.db / .wal / .bak ← 索引与双备份
    │   └── file-index.json ← 全库文件清单(记忆库的目录页)
    ├── genera/            ← AI 生图等图片产物的默认落盘处
    ├── bullet/            ← 子弹文件暂存(用完即抛,20MB 上限自动轮转)
    ├── secret-guard/      ← 密钥脱敏的状态与白名单(用过该功能才有)
    ├── index/             ← 智能搜索索引(用过才有;删了会自动重建)
    ├── new_log/ · logs/   ← 运行日志与诊断追踪(自动维护、自动轮转)
    └── tmp/               ← 临时中转(AI 跑的临时脚本等;可随手清)

目录随使用生长:用不到的功能不会长目录;alphal/ 里偶尔出现的 *.prev、*.corrupt.*、*.tmp.* 是自动备份与自愈副本——程序自己管理,别管、也别删。

强相关事宜(重点)

① 它是你硬盘上最「话痨」的目录——注意公开仓库。 quests/ 存着你喂给 AI 的一切(对话、工具输出,可能含密钥与隐私——在一切历史中检索 就建立在这份原料之上);timeline/ 存着每个文件的每一版。若项目要推上公开 GitHub:先确保 .gitignore 忽略 _qqq/。qd 自带 gitignore 保障机器——项目首次被识别为 git 仓库时,发现缺忽略项会弹提醒、一键补全(点不点由你,qd 绝不偷偷改你得文件)——提交工作流见 git 指南。风险全景见 → 密钥脱敏。

② 迁移 / 备份 / 分享。

场景做法
换电脑、接续对话整个项目文件夹拷走(含 _qqq/)→ 打开继续,如常
只要代码、不要历史不拷(或删掉)_qqq/ 即可——项目毫发无损,AI 从零开始
连对话一起分享连 _qqq/ 一起打包(先读 ①,里面有你的全部输入)

③ 哪些能清、哪些别碰。

可以放心清别手删
.trash/(空壳归档)· tmp/(中转)· 日志系列(new_log/、logs/)quests/(对话本体)· timeline/(文件史册)
bullet/(用完即抛)· index/(自动重建)alphal/ 全家(索引 / 偏好 / 规则 / 专家档案)

想看内容就开 all.txt(人类可读);*.sq3、*.json 都是程序格式——别用编辑器手改,改了轻则被程序重建、重则丢数据。

④ 它在你看不见的地方也在干活。

  • .lock 项目锁:保证「一个项目同一时间只被一个窗口写」——双开同项目被拦,就是它在站岗(详见 qqqide 滴工作空间)。
  • timeline/ 文件史册:每次保存、每次 AI 改文件都自动留档——「删了的文件还能找回来」全靠它(玩法见 文件版本时间线)。
  • 小彩蛋:在任务列表里改了任务名、磁盘目录暂时没变?它会懒改名(编号才是身份),下次启动/关闭自己对齐,不用管。

与 _qqqvault 的分工

_qqq = 程序数据的家;_qqqvault = 你的素材的家。两者平级、完全解耦——素材不混进程序数据,程序数据不占素材目录。下一站 → 家目录:_qqqvault。