数据目录

用 CRYSTAL_HOME 或 --home 覆盖。

~/.crystal/
  binaries/code/CrystalCode (CrystalCode.exe on Windows)
  config.json
  providers.json
  credentials.json
  permissions.json
  trusted.json
  access.json
  instructions.md
  AGENTS.md
  prompts/
    work.md
    plan.md
    review.md
    review.user.md
    topic.md
    compaction.system.md
    compaction.user.md
    image.system.md
    image.user.md
  promptsets/
    concise/
      prompt.json
      work.md
      plan.md
      review.md
      review.user.md
      topic.md
      compaction.system.md
      compaction.user.md
      image.system.md
      image.user.md
  prompt-attachments/
    <name>/
      prompt.json
      work.md
      plan.md
      review.md
  skill/<name>/SKILL.md
  skills/<name>/SKILL.md
  tools/<directory>/tools.json
  data/tools/<directory>/
  plugins/<directory>/plugin.json
  data/plugins/<directory>/
  sessions/<id>.json
  logs/

项目覆盖（同目录名的命名提示、提示附件、Crystal 技能、工具集和插件优先于主目录）：

<workspace>/.crystal/
  instructions.md
  prompts/
    work.md
    plan.md
    review.md
    review.user.md
    topic.md
    compaction.system.md
    compaction.user.md
    image.system.md
    image.user.md
  prompt-attachments/
    <name>/
      prompt.json
      work.md
      plan.md
      review.md
  skill/<name>/SKILL.md
  skills/<name>/SKILL.md
  tools/<directory>/tools.json
  plugins/<directory>/plugin.json
  data/tools/<directory>/
  data/plugins/<directory>/
<workspace>/.crystal.md
<workspace>/AGENTS.md

config.json 不属于项目覆盖。工作区级配置被推迟。

access.json 按规范化的工作区根存储默认的额外目录。

事件	默认值怎么处理
新会话、/clear、/fork、成功的 /cd 或 /space	把默认值复制进会话
/resume	保留已保存的规则，不把默认值加回去
任一 --allow-read 或 --allow-write	替换本次进程的默认值，不保存

缺失的目录或凭据路径会带着错误被跳过，并留在文件中。损坏的文件，或一个目录有两种模式，不播种任何内容。会话仍然打开。

插件和工具集把运行时数据放在 data/ 下，按种类分开。

根	路径
全局	~/.crystal/data/{plugins|tools}/<directory>，跨工作区共享
项目	<workspace>/.crystal/data/{plugins|tools}/<directory>

宿主在扩展第一次收到它们时创建两者，时机是插件附加或工具调用之前。它们与安装树分开，也不是秘密存储。

plugins/<directory>/plugin.json 加载一个操作者插件。Dotnet 工具集仍然只从工具集目录加载类库。见插件。