CocurdexProvider 与设置
Cocurdex 桌面端的 Agent CLI、Provider 配置、模型目录、MCP 服务器、网络代理、Git 提交信息模型、设备及其他设置。
Cocurdex 的大部分配置位于桌面应用的设置中。本页覆盖会影响 Agent 与模型行为的设置：Agent CLI、Provider、MCP、网络、Git、工作树环境和设备。
Agent CLI
设置 → Agent CLI 列出新建会话时可以选用的所有 Agent。每一项会显示探测到的版本和状态（内置、可用、未安装、需要升级）、可复制的安装命令、文档链接，以及——对能上报的 Agent——你的套餐用量。从 ACP Registry 添加可以安装更多 Agent,或用你自己的命令注册一个。见 Agent。
同一页的运行上限限制同时执行的 agent 运行数量。超出上限的委派运行（队友和脚本编排的子 Agent）会排队等待；你自己发起的运行不受限制。
| 控件 | 含义 |
|---|---|
| 并发运行数 | 所有会话合计的 agent 运行数（1–64） |
| 每个 agent 并发运行数 | 同一 agent 同时运行的数量（1–64） |
| 委派运行超时 | 队友或子 agent 超过该分钟数会被停止；留空表示不限时 |
Provider 与模型
设置 → 服务商 管理 Provider 配置:一组带凭据和模型目录的命名服务端点。这些配置为内置 Pi 运行时和会话内模型控件提供数据。
一个 Provider 配置包含：
| 字段 | 含义 |
|---|---|
| Provider id / 名称 | 稳定 id 与显示名 |
| Base URL | 服务端点 |
| API 运行时 | openai-completions、openai-responses、openai-codex-responses、anthropic-messages、google-generative-ai 或 mistral-conversations |
| 认证 | 通过 Pi OAuth 登录的 Provider 账号，或由 Pi 管理的 API key |
| 模型 | 每个模型的 id、显示名、能力（agent / chat / reasoning / vision）、上下文与输出上限、每百万 token 成本 |
| 高级 | 自定义请求头、兼容性 JSON、思考等级映射 |
模板可为常见 Provider 自动填充端点；Import JSON 可批量导入 Provider 定义。一切在 UI 中管理，之后可用 CLI 验证：
cocurdex provider list
cocurdex provider models <provider-id>Provider 配置与模型同样可以脚本化：cocurdex provider add|update|login|key|model|default|import|export——见 CLI。
外部 Agent CLI(claude、codex、opencode,以及 cursor-agent、grok 等 ACP Registry Agent)保留各自的认证——例如 Codex 的账号状态在 ~/.codex 下。Provider 配置不替代它们；它为 Pi 和桌面端提供统一的模型目录。
MCP 服务器
设置 → MCP 配置可供内置 Pi Agent 使用的 Model Context Protocol 服务器。Pi 会在会话启动时通过其内置的 MCP 支持连接它们。
- 两种编辑方式：表单（名称、连接方式、命令/URL、参数、环境变量）和原始 JSON。
- JSON 结构是标准的
mcpServers对象。 - 连接方式：local stdio(
command+args+env)和 remote HTTP(url)。 - 服务器名称只能包含字母、数字、
_和-。 - 变更在 Pi 会话启动时生效；已运行的会话保留其当前工具。
网络代理
设置 → 网络 控制应用的出站代理：
| 模式 | 行为 |
|---|---|
system | 跟随系统 / 环境代理配置 |
manual | 使用你提供的 HTTP / HTTPS / SOCKS(allProxy)地址与绕过列表(noProxy) |
off | 直连出站流量，不应用应用代理 |
适用范围说明：
- 作用于 Agent 子进程（含 ACP）、应用与 daemon 的模型/API 请求，以及 Chromium 网络流量。
- 不修改系统代理，也不强制集成终端使用这些设置。
- 代理 URL 以明文存储在应用设置中并传给 Agent 子进程——避免嵌入你不希望 CLI 子进程读到的凭据。
- 修改代理设置后重启活动中的 Agent 会话，使其获取新环境。
Test connectivity 通过应用的出站路径发送一次请求并回报出口 IP,可据此判断代理是否真正生效。
Git
设置 → Git 选择用于生成提交信息的 Agent 与模型。提交信息留空时，所选模型根据暂存变更生成一条 Conventional Commits 主题。选择 None 则始终手动输入。
工作树环境
分两层：
- 设置 → 工作树:托管工作树的根目录（留空使用默认位置），以及创建工作树前是否 fetch 远端。清单列出 Cocurdex 创建的每个检出、哪些会话在使用它，并提供删除 / 新建会话操作。
- 设置 → 工作区 → 工作树设置:按工作区配置 setup 与 cleanup 脚本以及 Actions。setup 在 Cocurdex 创建工作树后于后台运行(如
pnpm install)，会话首轮会等待它完成；cleanup 在移除未使用的检出前运行。Actions 是具名命令（例如「开发服务器」→npm run dev），显示在会话的 … 菜单中，每个都在新的终端标签中运行。让 Agent 分析会让 Agent 检查仓库，并提出两段脚本供你批准。
同样的能力可用 cocurdex worktree settings 脚本化——见 CLI。
设备
设置 → 设备 可在本机浏览器中打开同一主机，或把另一台设备按权限配对。见设备与本地网页。
设置助手
设置页有一个助手侧栏：一个带 settings Agent 工具的对话会话。让它「切换到深色模式」「检查我的通知设置」或者问「你能改哪些设置？」，它会替你读取并修改设置目录——包括项目工作树的 setup 与 cleanup 脚本。需要你确认的改动会先以提议形式给出。
任何主会话都能使用同样的工具；可选的 /cocurdex-settings skill 会教 Agent 用好它们。
应用更新
设置 → 关于会显示已安装的版本，并提供检查更新。更新通道可选稳定或测试；测试版可能不稳定，切回稳定通道时也可能安装较旧的版本。
更新下载完成后，会出现发现新版本卡片，其中有更新并重启、稍后和查看更新日志。自动更新仅在安装版应用中可用。
诊断
设置 → 诊断（或菜单 帮助 → 导出诊断日志…）会把脱敏后的应用日志与运行时信息打包成一个文件，方便附到 GitHub Issue 中。复现问题时可以打开详细诊断日志记录更多细节；无论开关与否，日志都会脱敏。
设置 → 常规 还会显示本地 daemon 的状态（socket、协议版本、启动时间）并提供重启——当笔记、Issue、演示文稿或 Agent 无响应时使用。
其他设置
| 分区 | 内容 |
|---|---|
| 常规 | 聊天布局、对话视图、HTML 预览位置、发送快捷键、后续消息排队/引导、语言、通知（含完成提示音）、Shell 命令（把 cocurdex 安装到 PATH）、daemon 状态与重启 |
| 外观 | 主题（跟随系统 / 深色 / 浅色——双主题对齐是产品要求）、配色主题预设、界面与代码字体 |
| 编辑器 | 代码 MiniMap |
| 快捷键 | 可重新绑定的键盘快捷键；null 覆盖表示解绑 |
| 服务商 | Provider 配置与模型目录（见上文） |
| Agent CLI | 已安装的 Agent、版本、安装提示、ACP Registry 与运行上限（见上文） |
| 角色 | 编辑或删除保存的 Agent 预设及其头像和描述；见 Agent |
| 团队 | 可复用的团队模板 |
| MCP | 供 Pi 使用的 MCP 服务器（见上文） |
| Skills | 安装 / 移除 cocurdex-* 产品 skill 包 |
| 网络 | 出站代理（见上文） |
| Git | 提交信息模型（见上文） |
| 工作树 / 工作区 | 托管工作树根目录与清单；按工作区的脚本与 Actions(见上文) |
| 设备 | 本地网页客户端与已配对的远程设备；见设备与本地网页 |
| 已归档会话 | 浏览你归档的会话；恢复或永久删除 |
| 开源许可 | 第三方许可 |
| 关于 | 版本、更新检查与更新通道；见应用更新 |
| 诊断 | 导出诊断信息、详细日志 |