Question 1

为什么在 Windows 上重启 Atlas 后，恢复的 Codex 会话会从“Ask for approval”变为“Approve for me”？

Accepted Answer

这是 Windows 上 Atlas 0.3.4 的一个 bug：恢复现有的 Codex ACP 会话时，可能使用 agent 报告的 approval mode，而不是你之前选择的 mode。全新会话不受影响。

修复：升级到 Atlas 0.4.0 或更高版本。修复位于 PR #345，commit 6764d951。恢复的会话现在会还原你选择的 approval mode。如果该 mode 无法应用，composer 会显示一条警告，并且在你选择 mode 之前不会发送任何内容。

Atlas 0.3.4 的临时解决方法：重新打开项目并恢复 Codex 会话后，在发送 prompt 之前检查可见的 approval mode。如果显示“Approve for me”，请手动重新选择“Ask for approval”。

Question 2

在 Windows 上构建 src-tauri 时，如何修复“cannot find `menu` in `crate`”和“field `0` of struct `tauri::State` is private”？

Accepted Answer

这发生在 0.3.4 及之前的版本中，因为 keybindings.rs 无条件引用了仅 macOS 可用的 crate::menu 模块。升级到 0.4.0 或更高版本，其中包含提交 7cb5749a，然后重新构建：

git checkout 0.4.0
bun run dev:app

如果你必须停留在 0.3.4，请 cherry-pick 该修复，或用以下方式在 src-tauri/src/commands/keybindings.rs 中为依赖 menu 的代码加上条件编译：

#[cfg(target_os = "macos")]
{
// crate::menu::CloseTabItem 代码
}

在 Windows 和 Linux 上，该命令应为 no-op。该修复已在 Windows 11 上验证；还添加了 Linux CI 以捕获平台特定的构建失败。

Question 3

为什么 memory_forget 返回 "forgotten": true，但 memory_search 仍然在文档结果中找到已删除的文本？

Accepted Answer

在版本 0.3.3（69c56bfd）中，memory_forget 会立即删除结构化条目，但独立的设备端文档索引没有逐出 API。因此，已删除文本在下一次防抖索引重建之前仍可被搜索到，通常大约 1–2 分钟。

临时解决方法：调用 memory_forget 后，等待约 2 分钟，然后用该条目中的唯一短语运行 memory_search，并确认它不再出现在 documents 数组中。在该检查通过之前，将内容视为仍可检索。

永久修复：升级到包含提交 ece6e811 的构建（可在 main 上 5bff2ba 附近以及 0.3.4 分支上 a932ac5 附近获得）。该修复添加了一个 IndexEvict 接缝，使 memory_forget 逐出相应文档，并且 memory_search 通过 live_shared_docs() 根据实时条目表过滤文档命中。因此，已遗忘的内容不再立即返回。

Question 4

如何在 Windows 上修复 Atlas Codex ACP，当 npm 抛出 'Maximum call stack size exceeded' 且 Node 抛出 EISDIR lstat 'C:' 并带有 \?\ 路径时？

Accepted Answer

根本原因：在 Windows 上，std::fs::canonicalize 会返回 verbatim 扩展长度路径，例如 \?\C:\Users\...。Atlas 0.3.3 会将此路径传给 npm 的 --prefix 和 Node 入口点。npm 11.6.1 的 Arborist 可能递归直到 RangeError: Maximum call stack size exceeded，而 Node 24.11.0 可能失败并报错 Error: EISDIR: illegal operation on a directory, lstat 'C:'。

永久修复：升级到包含来自 PR #281 及其后续修复的 agent-store 路径规范化修复的 Atlas 版本。如果要修补 Rust 代码，在启动 npm 或 Node 之前规范化路径：

let install_dir = dunce::simplified(&std::fs::canonicalize(&dir)?).to_path_buf();

将 install_dir 用于 npm 的 --prefix 和 Node 脚本路径。你可以保留原始规范化路径用于内部文件系统检查。

临时解决方案：使用普通的 C:\... 路径安装适配器，然后用普通路径启动器启动它。在 PowerShell 中：

$dir = "$env:APPDATA\dev.atlas.ide\external-agentsegistry
px\codex-acp"
npm install --prefix $dir "@agentclientprotocol/codex-acp@1.12.0"
node "$dir
ode_modules\@agentclientprotocol\codex-acp\dist\index.js" --version

最后一条命令应输出 @agentclientprotocol/codex-acp 1.12.0。创建一个使用相同普通路径的 .cmd 启动器：

@echo off
node "C:\Users\<user>\AppData\Roaming\dev.atlas.ide\external-agentsegistry
px\codex-acp
ode_modules\@agentclientprotocol\codex-acp\dist\index.js" %*

配置 Atlas 使用该启动器。不要将以 \?\ 开头的路径传给 npm 或 Node。

Question 5

如何让 Codex 从 CLAUDE.md 和 .claude/rules/ 读取 Claude Code 规则？

Accepted Answer

在 Atlas 0.4.0 或更高版本中启用 instructionSync 设置。Atlas 随后会将 CLAUDE.md 和 .claude/rules/*.md 镜像到项目 AGENTS.md 末尾的一个带标记块中，Codex 会读取该文件。该块使用标记和；其外的文本不会被修改。启用该设置会同步每个窗口中的活动项目，而禁用它会从 Atlas 写入过该镜像块的所有项目中移除该镜像块。已由 pack 投影的规则会被跳过，并且 memory corpus 会排除该镜像块以防止重复索引。请注意，.claude/settings.json 中的 hooks 和 permissions 不会被镜像，因为它们仅适用于 Claude Code。

atlas

核心功能

避坑指南

适用场景

标签

快速上手

相似推荐