# @covro/covro 中文文档 规范地址：https://npmcn.com/package/%40covro/covro/ 版本：0\.10\.0 npm 元数据更新时间：2026-11-13T08:38:04.309Z 中文译文更新时间：2026-11-13T09:16:56.205Z 软件包许可：未声明 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40covro/covro 原文对照：https://npmcn.com/package/%40covro/covro/?lang=original 项目主页：https://github.com/yuzheng14/covro#readme 源码仓库：https://github.com/yuzheng14/covro ## 关键信息（来自 npm 元数据） - 包体积（解压后）：10.4 MB，394 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=24\.19\.0 \<25 - 运行依赖：29 个 - 首次发布：2026-10-19T05:18:05.303Z - 最新版本发布：2026-11-13T08:38:03.848Z - 近 30 天下载量：7903（2026-10-11 至 2026-11-09，npm 官方下载统计） - 已发布版本数：81（近 12 个月 81 个） ## 中文简介 您本地 Codex 的自托管浏览器工作空间 ## 安装 ```sh npm install @covro/covro ``` 也可以使用：`pnpm add @covro/covro`、`yarn add @covro/covro`、`bun add @covro/covro` ## README ![Covro](https://npmcn.com/package/%40covro/covro/docs/assets/covro-logo.svg) # 在浏览器里，用你的 Codex CLI。 **Covro 是 Codex CLI 的自部署 Web UI。** 在桌前发起任务，用手机查看改动、处理审批，接着推进下一步。 **自行部署 · 电脑与手机 · 沿用 Codex 登录 · MIT 开源** [🚀 开始使用](https://npmcn.com/package/%40covro/covro/#readme-%E5%BC%80%E5%A7%8B%E4%BD%BF%E7%94%A8) · [✨ 功能介绍](https://npmcn.com/package/%40covro/covro/#readme-%E4%BD%A0%E5%8F%AF%E4%BB%A5%E5%81%9A%E4%BB%80%E4%B9%88) · [🌐 远程访问](https://npmcn.com/package/%40covro/covro/#readme-%E4%BB%8E%E5%85%B6%E4%BB%96%E8%AE%BE%E5%A4%87%E8%AE%BF%E9%97%AE) · [English](https://npmcn.com/package/%40covro/covro/README.md) ![Covro 桌面工作台：会话与 Markdown 文档并排阅读](https://npmcn.com/package/%40covro/covro/docs/assets/workspace-desktop.png) 截图来自实际运行的应用，使用示例项目与测试夹具生成的会话。 ## ✨ 你可以做什么 - 📱 **随时随地跟进任务。** 用电脑或手机发送截图、查看改动、[账户额度](https://npmcn.com/package/%40covro/covro/docs/account-usage.md)与[会话上下文用量](https://npmcn.com/package/%40covro/covro/docs/runtime-settings.md#%E4%BC%9A%E8%AF%9D%E4%B8%8A%E4%B8%8B%E6%96%87%E4%B8%8E-token266)、处理审批和回答问题。关闭页面，任务仍会继续；执行中也能调整会话配置。 - 🗂️ **集中管理项目与会话。** 无需项目即可开始任务，在一个工作台查看并行进展，接续或 Fork Codex CLI 会话，并用 [@](https://npmcn.com/package/%40covro/covro/docs/file-references.md) 引用服务器工作区文件、用 [$](https://npmcn.com/package/%40covro/covro/docs/skills.md) 引用技能。托管会话中的代理也能通过 Covro 在已注册项目中创建新任务。 - 📖 **一边看产出，一边讨论。** 电脑上将文档、图表和代码变更与会话并排阅读，手机上使用全屏阅读器；macOS、Linux 和 Windows x64 主机还可按需启用[开发预览代理](https://npmcn.com/package/%40covro/covro/docs/dev-preview.zh-CN.md)，在隔离标签页中打开会话的开发服务。上下文压缩期间仍可查看已提交消息，新回复实时到达时，已加载的历史正文保持完整。 - 🔔 **及时收到待办提醒。** 在支持通知的桌面或 Android 浏览器中，接收工作结束、需要回答或审批的提醒。需保持页面在线；页面冻结或关闭期间不推送通知。 操作、快捷键和命令用法见[使用指南](https://npmcn.com/package/%40covro/covro/docs/usage.zh-CN.md)、[Slash 命令说明](https://npmcn.com/package/%40covro/covro/docs/slash-commands.md)和[配置生效时机](https://npmcn.com/package/%40covro/covro/docs/session-live-settings.md)。 **📱 手机上也能舒服地使用** ![手机屏幕上的 Covro 会话](https://npmcn.com/package/%40covro/covro/docs/assets/workspace-mobile.png) ## 🚀 开始使用 需要 **Node.js 24.x，版本不低于 24.19**，以及已经安装、登录的 **Codex CLI**。界面支持简体中文、英语、日语和韩语。 推荐 Codex CLI：**0.167.0**。已验证版本：`0.167.0`。 其他 Codex 版本及使用确认要求见[兼容性说明](https://npmcn.com/package/%40covro/covro/docs/compatibility.md)。 ### 📦 npm 安装 ```sh npm install -g @covro/covro covro ``` `covro` 在后台启动，使用 `covro stop` 停止。配置、日志与登录自启见[安装指南](https://npmcn.com/package/%40covro/covro/docs/distribution.md)。 打开 **[http://127.0.0.1:8787](http://127.0.0.1:8787/)**，点击 **未关联项目** 旁的 **＋** 开始任务，或通过 **添加项目** [导入目录或克隆仓库](https://npmcn.com/package/%40covro/covro/docs/project-clone.md)。 ### 🛠️ 从源码运行 参与开发或从源码部署时，使用 **pnpm 12.11.2**： ```sh git clone https://github.com/yuzheng14/covro.git cd covro pnpm install --frozen-lockfile cp config.example.json config.local.json pnpm build pnpm start -- --config ./config.local.json ``` 本地开发可以改用 `pnpm dev`，打开 [http://127.0.0.1:5173](http://127.0.0.1:5173/)。 ## 🌐 从其他设备访问 新安装默认只监听回环地址。从其他设备访问时，请按[部署指南](https://npmcn.com/package/%40covro/covro/docs/deployment.md)配置 **Tailscale Serve** 或 **Cloudflare Tunnel 与 Access**。 运行服务的电脑需要保持唤醒并在线。远程添加项目时，填写的仍是这台电脑上的目录。 ## 更新与版本渠道 在更新面板或通过 `covro update` 选择稳定、预览或开发渠道。受管升级支持 **macOS 和 Linux 的 npm 全局安装**，其他安装方式沿用原更新方法。默认 Node 变更后，可切换到已安装全局 Covro 的受支持环境，Covro 同版本也可迁移。自动安装默认关闭，且只接受已验证的 Codex 组合；未验证组合需明确确认。Covro 不会升级 Codex CLI。详见[更新与恢复](https://npmcn.com/package/%40covro/covro/docs/distribution.md)。 ## 你的电脑，你的工作台 Covro 通过 `codex app-server` 连接已有 CLI，沿用你的 Codex 登录与配置。任务在运行服务的电脑上执行，项目和 Codex 历史也留在那里；登录凭据不会复制到浏览器，Codex 仍会访问你配置的模型提供方。 Covro 面向单用户。[Shell 面板](https://npmcn.com/package/%40covro/covro/docs/shell.md)沿用 Codex 配置的沙箱执行非交互命令。交互终端、文件编辑器、Git 图形界面与多人团队管理不在当前范围内。 DB Schema **10** 独立于应用版本，旧应用不能打开更新的数据库。备份只覆盖 Covro 数据库和服务配置，不包含项目文件、Codex 历史或凭据；恢复需停服。详见[备份](https://npmcn.com/package/%40covro/covro/docs/backups.md)与[数据库兼容规则](https://npmcn.com/package/%40covro/covro/docs/database.md)。 ## 开发与参与 开发环境、检查命令与 PR 约定见[贡献指南](https://npmcn.com/package/%40covro/covro/docs/contributing.md)。欢迎[提交 Issue](https://github.com/yuzheng14/covro/issues) 或范围明确的 PR；面向使用者的变更需同步更新两份 README。 ## 📚 文档导航 | 主题 | 指南 | | --- | --- | | 日常使用 | [使用指南](https://npmcn.com/package/%40covro/covro/docs/usage.zh-CN.md) · [命令](https://npmcn.com/package/%40covro/covro/docs/slash-commands.md) · [技能](https://npmcn.com/package/%40covro/covro/docs/skills.md) · [文件引用](https://npmcn.com/package/%40covro/covro/docs/file-references.md) · [提问与回答](https://npmcn.com/package/%40covro/covro/docs/async-questions.md) · [Shell](https://npmcn.com/package/%40covro/covro/docs/shell.md) · [容量重试](https://npmcn.com/package/%40covro/covro/docs/capacity-retry.md) | | 项目与会话 | [导入与克隆](https://npmcn.com/package/%40covro/covro/docs/project-clone.md) · [工作目录](https://npmcn.com/package/%40covro/covro/docs/workspaces.md) · [历史加载](https://npmcn.com/package/%40covro/covro/docs/session-history.md) · [提交恢复](https://npmcn.com/package/%40covro/covro/docs/submission-recovery.md#%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87) · [托管 MCP 工具](https://npmcn.com/package/%40covro/covro/docs/managed-mcp.md) | | 安装与访问 | [安装与更新](https://npmcn.com/package/%40covro/covro/docs/distribution.md) · [部署](https://npmcn.com/package/%40covro/covro/docs/deployment.md) · [日志与排障](https://npmcn.com/package/%40covro/covro/docs/logging.md) · [界面语言](https://npmcn.com/package/%40covro/covro/docs/i18n.md) | | 数据与兼容 | [备份](https://npmcn.com/package/%40covro/covro/docs/backups.md) · [数据库](https://npmcn.com/package/%40covro/covro/docs/database.md) · [Codex 兼容性](https://npmcn.com/package/%40covro/covro/docs/compatibility.md) | | 开发与发布 | [贡献](https://npmcn.com/package/%40covro/covro/docs/contributing.md) · [架构](https://npmcn.com/package/%40covro/covro/docs/architecture.md) · [验证](https://npmcn.com/package/%40covro/covro/docs/verification.md) · [发版](https://npmcn.com/package/%40covro/covro/docs/releases.md) · [品牌素材](https://npmcn.com/package/%40covro/covro/docs/brand.md) | ## 许可证 [MIT](https://npmcn.com/package/%40covro/covro/LICENSE)。Covro 是独立项目，与 OpenAI 无隶属关系。 ## 常见问题 ### @covro/covro 是什么？ 您本地 Codex 的自托管浏览器工作空间 ### 如何安装 @covro/covro？ 在项目目录运行 npm install @covro/covro，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 covro，可以用 npx covro 直接运行。 ### @covro/covro 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/covro\_\_covro 是否存在。 ### @covro/covro 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @covro/covro 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=24\.19\.0 \<25。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @covro/covro 可以商用吗？ @covro/covro 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。 ### @covro/covro 的下载量有多少？ 根据 npm 官方下载统计，@covro/covro 在 2026/10/11 – 2026/11/09 这 30 天内被下载 7,903 次，日均约 263 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @covro/covro 还在维护吗？ 最新版本 0\.10\.0 发布于 2026/11/13（今天）；至今共发布 81 个版本，其中过去 12 个月发布了 81 个；首次发布于 2026/10/19。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。