常见问题
桌面与 CLI 是同一份数据吗？
是。两者共享 ~/.arca/、资产、关系与写入规则。完整 CLI 管理 Models、Providers、MCPs 和 Skills；无参数 TUI 聚焦 MCP。无需重复创建资产。
为什么 Agent 可启动，却没有某项配置能力？
启动、运行时版本、配置文件与可写能力是不同事实。只有核验过的原生路径和格式才可写；缺少契约的能力保持只读或官方引导。插件宿主存在也不能证明插件已安装。
Arca 会覆盖我已有的设置吗？
只修改已管理字段，保留其他内容、注释与策略。外部新增和修改先显示为观测；格式不合法、并发变化和不安全的覆盖会拒绝对应写入。请根据当前可用动作采用、恢复或解除管理。
为什么部分 Agent 没同步成功？
每个实际目标单独同步，已经成功的目标保留。查看失败关系的状态和原因，再修复该目标；不需要把其他 Agent 全部重做。
停用、解除使用、删除有什么区别？
停用保留关系和中央资产。解除使用只去掉对应 Agent 的关系与可安全移除的受管目标。删除中央资产会审阅全部消费者并清理中央内容；Skill 内容会移到备份。外部文件不会被顺手删除。
同名的 MCP 或 Skill 怎么处理？
MCP 使用 name::transport，同名 stdio 与 HTTP 是不同资产。Skill 中央库按名称管理；导入相同中央名称会保留已有消费者，但不会自动覆盖内容不同的外部副本。详情可查看实际副本与内容。
Keychain 中有 Key，为什么 Agent 还提示鉴权失败？
确认该 Agent 支持的交付方式。环境变量引用需要启动环境确实提供变量；部分客户端需要明确审阅的原生私有配置交付。检查实际 Provider、协议、Model ID 和套餐，不要把密钥贴到日志中。详见 Models。
Skills 支持项目级路径、私有仓库或在线编辑吗？
当前只管理核验过的用户级路径，不支持需认证的私有 Git 来源或在 Arca 内编辑 SKILL.md。本地文件夹与压缩包可以直接导入。详见 Skills。
Trace 是在线上传或自动执行吗？
Trace 读取本地会话或显式导入文件。预览不会上传或执行内容。分享前仍需检查正文中的代码和业务信息。
怎样更新？
桌面端在设置中检查最新正式版；独立 CLI 使用 arca upgrade，桌面包内的 CLI 跟随 App 更新。先把 App 安装到 /Applications，不要直接在只读 DMG 内执行更新。下载与首次启动说明见 安装。
支持哪些平台？
正式预编译 Desktop 与 CLI 目前发布 macOS Apple Silicon。其他环境可研究源码构建，但不能把可编译等同于已经完成平台验收。