用途:仅用于编辑 Letta Code Desktop 的活动偏好设置 JSON 文件。不适用于 Desktop 产品代码变更、Electron IPC、UI 改动或 Letta Cloud Desktop 实现类任务。
偏好文件路径:~/.letta/desktop_preferences.json
已知偏好键:defaultWorkingDirectory(新本地会话默认文件夹);theme(auto、light 或 dark);allowRemoteAccess(是否在偏好中启用远程访问的布尔值);remoteEnvName(远程访问显示的环境名)。
工作流程:先读取现有 JSON;保留未知键;仅合并用户请求的偏好更新;以带末尾换行的格式化 JSON 写回。不要编辑 token、provider、secret、agent、conversation、memory 或无关状态文件。告知用户:仅当 Desktop 构建监视偏好文件变更时改动才实时生效;否则需重载/重启 Desktop,或使用 Preferences → General。
安全编辑命令采用合并式写法:node - <<'NODE'(读取 os.homedir()/.letta/desktop_preferences.json,不存在则用 {},展开 current 后替换请求键,再用 JSON.stringify(next, null, 2) + '\n' 写回)。
验证:编辑后读回或解析确认 JSON 有效:node -e "JSON.parse(require('fs').readFileSync(require('os').homedir() + '/.letta/desktop_preferences.json', 'utf8')); console.log('desktop_preferences.json is valid')"。
限制:仅限偏好文件,不得触碰其他状态文件;实时生效取决于 Desktop 是否监视文件变化。