本地数据和机密
Screph 分隔普通设置、用户项目和机密。大多数运行时文件位于 ScrephData 目录下，但帐户令牌和 API 密钥使用系统凭证存储，而项目本地 Assistant 历史记录可能位于项目本身旁边。
1. ScrephData 所在位置
- 安装版本：
ScrephData位于安装根目录中的可执行文件旁边。 - 来源结帐：
<存储库>/ScrephData。 - 显式覆盖：
SCREPH_CONFIG_DIR环境变量。可重复使用的语音运行时还支持VOICE_CONTROL_DATA_DIR和VOICE_CONTROL_MODEL_DIR。
这是当前的实现，而不是标准 AppData 路径的承诺。在移动或删除安装之前，请检查实际的运行时根目录并单独备份所需的项目。
2. 存储映射
| 数据 | 位置 | 保留和清理 |
|---|---|---|
| 普通设置 | ScrephData/settings_modules/settings.json | 普通未加密 JSON：首选项、路径、端点、配置文件元数据和角色映射。保留直至更改、重置或手动删除。 |
| Selector 本地状态 | ScrephData/local_state/selector_layout.json | 窗口几何形状、面板尺寸、画布布局/演示、链接窗格、显示模式、证据选项卡和导航器。这是本地无像素工作区快照，不是项目包的一部分。测量线和层锁被排除。 |
| 令牌和 API 密钥 | Windows Credential Manager，服务 Screph | 注销会删除帐户令牌； LLM 配置文件/密钥控制删除匹配的密钥。密钥环故障不会触发明文回退。 |
| 项目 | 所选目录或 ScrephData/automation_runtime/project | Canonical JSON、图像、产物和伴随文件是用户拥有的；没有全局自动删除。 |
| AI Assistant | ScrephData/runtime/ai_assistant<project>/.screph_ai_assistant | 会话清理有效使用 180 天（例外情况除外）；动作历史有一个单独的字段。该清理不会删除项目镜像。 |
| LLM usage metadata | ScrephData/llm/usage_events.jsonl | 成功共享运行时响应的仅附加指标；不存储提示或响应文本。没有自动保留或清晰的用户界面，并且该文件不是完整的计费/错误分类帐。 |
| 路径历史记录和管理器元数据 | ScrephData/local_state/selector_project_history.jsonScrephData/local_state/selector_project_metadata.jsonCapture 和自动化管理器子目录 | 最多 60 个最近的项目，每个项目密钥 25 个源选择和 10 个最近的脚本。项目标签和注释由绝对路径键入，保留在包之外，并且在复制或重命名期间不会迁移。记录包含完整的本地路径。 |
| 日志和崩溃报告 | ScrephData/logs | 崩溃报告：默认最新 10 条。其他日志没有单一的共享保留规则；使用特定于组件的控件或手动清理。 |
| CV 运行时会话 | ScrephData/screen_selector/cv/resultsSelector 会话路径 /cv_artifacts | 技术映像运行捆绑包和旧版/调试预测。最近的会话列表仅限于十个 ID，但这不会删除旧的会话目录；未发现共享自动保留。项目保存仅复制附加的图像系列条目。 |
| 视频/时间 CV 运行 | ScrephData/screen_selector/cv/results/temporal | 清单、快照、配置、出处、覆盖范围/问题和观察块。 Hide 主动运行不删除运行；未找到删除/修剪 UI 或自动保留。应用的轨道单独位于 <name>.temporal-标注.json 中的项目旁边。 |
| Capture Action CV | <recording>/action_cv<recording>/automation_context | action_cv 存储物化输入、捆绑、作业、计划、运行、候选结果、审核决策、导出、诊断、准备好的 VLM 图像、请求、原始响应和默认打开的响应缓存。未发现自动保留。完全手动重新运行会删除 action_cv，但不会回滚相邻的 automation_context（如果之前已丰富）。 |
| 模型、依赖项和缓存 | 专用 ScrephData 子目录 | 通过特定于组件的删除/修复操作或手动删除。设置重置并不是完整的文件擦除。 |
3. 秘密边界
settings.json 不是秘密存储。它包含提供者种类、模型、api_base、超时、角色和路径，而 LLM API 密钥、语音密钥和帐户访问/刷新令牌使用系统密钥环。旧版 secure.* 块在迁移过程中被删除，而不是复制回普通 JSON。
环境变量作为显式运行时源具有优先级。这对于部署很有用，但未沙箱的子进程可能会继承该环境。请勿将机密信息放入项目 JSON、脚本参数、带有凭据的 URL 或诊断注释中。
路径也可能是敏感的
端点、项目/源/脚本路径和 Google 凭证路径不是密钥值，因此它们可能会出现在普通设置/历史记录和诊断预览中。审核发送前捆绑。
4. 为什么 180 天不是完整的删除规则
history.jsonl在附加新事件时修剪日期行。- 打开工作区会删除旧的全局会话目录，但会保护活动会话以及具有未解决的需要确认操作的会话。
<project>/.screph_ai_assistant不在该清理范围内。当前的镜像控制会影响操作历史存储，但通用工作空间存储仍然默认使用镜像；该切换既不会停止所有新消息、时间线和操作镜像文件，也不会删除现有文件。
创建运行时时，UI 保留字段将应用于仅附加 history.jsonl。会话目录清理当前不会收到用户值并有效使用 180 天，因此更改该字段不是全局 Assistant 删除策略。
历史记录可能包含提示、响应、操作有效负载、项目路径、上下文元数据、编辑报告和允许的附件。要完全删除，请关闭 Screph，删除相关的全局会话目录和项目本地镜像，然后检查项目备份或同步副本。
5. 实际清理
- 确定实际的运行时根，包括任何
SCREPH_CONFIG_DIR覆盖。 - 注销并删除未使用的 LLM 或带有专用控件的语音键。
- 清除 UI 提供的最近的、源或脚本历史记录；
从历史记录中删除和在Project Manager中清除缺失的不会删除项目或脚本本身。路径键控标签和注释必须与元数据存储分开清理。 - 分别删除未使用的模型、运行时组件、CV/Capture 输出和日志。设置重置不会取代此步骤。
- 在删除项目镜像之前，请确保不再需要其决策历史记录或未解决的操作恢复。