# @alltomatos/opencode 中文文档

规范地址：https://npmcn.com/package/%40alltomatos/opencode/

版本：1\.21\.93
npm 元数据更新时间：2026-11-01T15:14:44.430Z
中文译文更新时间：2026-11-05T23:50:44.842Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40alltomatos/opencode
原文对照：https://npmcn.com/package/%40alltomatos/opencode/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：18.6 kB，5 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-09-04T00:42:48.903Z
- 最新版本发布：2026-11-01T15:14:44.259Z
- 近 30 天下载量：9015（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：236（近 12 个月 236 个）

## 中文简介

[](https://github.com/alltomatos/opencode)

## 安装

```sh
npm install @alltomatos/opencode
```

也可以使用：`pnpm add @alltomatos/opencode`、`yarn add @alltomatos/opencode`、`bun add @alltomatos/opencode`

## README

[![OpenCode logo](https://npmcn.com/package/%40alltomatos/opencode/packages/console/app/src/asset/logo-ornate-light.svg)](https://github.com/alltomatos/opencode)

Alltomatos的OpenCode——开源AI编码代理的叉.

Grupo de Apoio: https://chat.whatsapp.com/DOLzfQ4aPZ12R7ZRbLabNh 页面存档备份,存于互联网档案馆

[![Latest release](https://img.shields.io/github/v/release/alltomatos/opencode?style=flat-square)](https://github.com/alltomatos/opencode/releases) [![Build status](https://img.shields.io/github/actions/workflow/status/alltomatos/opencode/publish.yml?style=flat-square&branch=dev)](https://github.com/alltomatos/opencode/actions)

[![OpenCode Desktop](https://npmcn.com/package/%40alltomatos/opencode/packages/web/src/assets/lander/screenshot-splash.png)](https://github.com/alltomatos/opencode)

* * *

### 截图

![Modos de permissão (Automático, Manual, Aceitar edições, Planejar)](https://npmcn.com/package/%40alltomatos/opencode/packages/web/src/assets/lander/t2.png) ![Tela de Configurações, com suporte a português](https://npmcn.com/package/%40alltomatos/opencode/packages/web/src/assets/lander/config.png)

* * *

埃斯特·埃克·多索尔 [打开代码](https://github.com/anomalyco/opencode)马提多·波尔 [全托马托斯](https://github.com/alltomatos), com o foco no app desktop para Windows e judges de UI/UX específicos deste fork (sidebar de projetos, 终端 e 浏览器 embutidos no Cabeçalho da sessão, 技术种子 paderão, entre outros-veja o) [更改日志](https://npmcn.com/package/%40alltomatos/opencode/changelog.json) e 作为 [释放](https://github.com/alltomatos/opencode/releases) (原始内容存档于2017-09-29). para o histórico completo.

### 分支

Estext trabalha com duas 分枝: 树枝:

-   **`prod`** - 支助处。 Só ela gera发布公示(o app instalado e o auto-updater apontam pra cá). 笔名 `dev` (原始内容存档于2018-10-26) (英语). promovida quando um lade de mudanças está maduro.
-   **`dev`** ——分行分出. acontece aqui priminiro, roda em modo def localmente pra vialar, e só depois é provida pra) 维基语录链接:名人名言 - 文学作品 - 谚语 - 谚语 - 谚语 - 谚语 - 谚语 `prod`。 。 。 .

### 应用桌面( produção)

贝克西・克多・克多 [释放](https://github.com/alltomatos/opencode/releases/latest) ——分枝相接地相接地相接地相接地相接地相接 `prod`。 。 。 .

| 平方阵a | 下载 |
| --- | --- |
| 窗口 | `opencode-desktop-win-x64.exe` (Intador NSIS) |
| macOS(英特尔/亚美尼亚) | `opencode-desktop-mac-x64.dmg` 编号 : `opencode-desktop-mac-arm64.dmg` |
| Linux (德文/乌本图) | `opencode-desktop-linux-x64.deb` |
| Linux( 费多拉/ RHEL) | `opencode-desktop-linux-x64.rpm` |
| Linux( 普遍性) | `opencode-desktop-linux-x64.AppImage` |

没有视窗,baixee骑O `opencode-desktop-win-x64.exe` (Instador NSIS)——脚本的sem necessidade de 脚本. 没有macOS e Linux, baixe o instalador 通讯员 e instale manualmente (英语:`.dmg`, (中文(简体) ), `dpkg -i *.deb`, (中文(简体) ), `rpm -i *.rpm`页:1 `.AppImage`) (中文(简体) ).

> **诺塔(macOS):** os 建立 Mac não são assinados/notarizados por este分叉 (não temos uma conta Apple开发者 configurada). (原始内容存档于2018-03-26). Na priminira abertura o Gatekeepers vai avisar que o app "não pode ser ver vificado"—— Clique com o botão straito no app – ique **阿布里尔** 自由手册.

O app verifica atualiza – es autoamente contra reste repositório (英语:`alltomatos/opencode`(原始内容存档于2013-10-12). não contra o projeto origent.

### 罗丹多·德森沃尔门托

Pra vialar pudanças antes de prover (原始内容存档于2018-09-21) (英语) `dev` ưμ㼯a `prod`, 骑 o app 桌面本地化 partir da 分支 `dev`数字 :

```bash
git clone https://github.com/alltomatos/opencode.git
cd opencode
git checkout dev
bun install
cd packages/desktop
bun run dev
```

Canal 电力公司 `dev`(原始内容存档于2013-10-12). auto-update desativado, ícone de dev. Pra Builtar um instalador 本地的羊群公开:

```bash
cd packages/desktop
OPENCODE_CHANNEL=prod bun run build
bun run package:win     # Windows (feito manualmente nesta máquina)
bun run package:mac     # macOS — precisa rodar num Mac
bun run package:linux   # Linux — precisa de dpkg/rpm/fpm disponíveis
```

{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}哦 死神们 `packages/desktop/dist/`。 。 。 .

**真正的自治公共组织**: assim que a 分支 `prod` 促销 `dev` → `prod`),o工作流程 [`release-desktop.yml`](https://npmcn.com/package/%40alltomatos/opencode/.github/workflows/release-desktop.yml) dispara sozinho e builda Windows/macOS/Linux em paralelo (英语:`windows-latest`编号 :`macos-latest`编号 :`ubuntu-latest`(原始内容存档于2018-09-21). publicando os três num único release do GitHub com a versão que estivers em `packages/desktop/package.json` 没有一分钟做推。 (原始内容存档于2018-12-09) (英语). Não pricesa mais builar nada manualmente corse máquina (só umbar a versão, contentar, e prover.). Pra reexucutar manualmente(前: retry de uma plataforma que falhou),用法 `gh workflow run release-desktop.yml`。 。 。 .

### 通过 npm (canais dev/ prod) 的 CLI

Além do app桌面, o CLI deste fork é publicado serreto no npm sob o escopo 互联网档案馆的存檔,存档日期2013-12-20 `@alltomatos`, 分离 `opencode-ai`编号 :`@opencode-ai/*` 做原创的 —— instala com 运河通过 sintaxe `@tag` 时间轴:

```bash
npm install -g @alltomatos/opencode@dev     # última publicada a cada push em dev
npm install -g @alltomatos/opencode@latest  # última publicada a cada push em prod
```

公共自动工作流程 [`release-npm-fork.yml`](https://npmcn.com/package/%40alltomatos/opencode/.github/workflows/release-npm-fork.yml): cross-compilados num único transfer) e publica com a 标记通讯员 à 分支. Útil pudanças de `dev` 通过 CLI/servidor sem precisar instalar o app桌面.

### 目 录

Estef forciona um sistema de memória cross-sessão (Global e por por projeto),又译作活生生地活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活泼活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活 O modelo tem acesso a duas 工具索布需求a - `memory_search` (相关协商)e `memory_save` (registra algo pra lembrar depois)——chamadas quando o próprio modelo决定 que é conference, sem injetar tudo autulamente em todo prote.

-   **Ativar/desativar e escolher模型**互联网档案馆的存檔,存档日期2013-12-21. Configura'es – Memória (mesmo paderão de toggle superâneo do reso do app.).
-   **全球记忆组织** (单位:千美元)`~/.local/share/opencode/memory/global/`(fisca disponível como 技能 carregada autaramente em qualquer sessão/projeto, além de consultável通过) 互联网档案馆的存檔,存档日期2013-12-02 `memory_search`。 。 。 .
-   **梅莫里亚 por projeto** (单位:千美元)`~/.local/share/opencode/memory/projects/<projeto>/`(原始内容存档于2013-10-12). fica isolada por pretório.

### Rodando numa VPS (服务器再机)

O OpenCode também roga como servido puro, sem o app 桌面 – útil pra manter sessães ativers 24/7 e sessar de qualquer lugar. 中国植物物种信息数据库.

```bash
export OPENCODE_SERVER_PASSWORD="uma-senha-forte-aqui"
opencode web --hostname 0.0.0.0 --port 4096      # UI web embutida, acessível pelo navegador
# ou
opencode serve --hostname 0.0.0.0 --port 4096    # só a API, pra conectar via app desktop ou TUI
```

重新定义 **(中文(简体) )** 没有应用桌面, ou abrir a URL serito no navegador. Guia completo(系统化、代理reverso/TLS、segurança) em [`docs/vps-hosting.md`](https://npmcn.com/package/%40alltomatos/opencode/docs/vps-hosting.md)。 。 。 .

**装瓶完成电报**互联网档案馆的存檔,存档日期2011-12-02. : Conecte em Configura \* Integra \* Telegram (ken do @BotFather). cada pedido roda em segundo plano; se um tuno ficar travado (前: uma pergunta sem resposta) ele suncha sozinho depois de 10 minutos e visa 不聊天——您使用 `/cancel` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}请检查date=中的日期值 (帮助). `/new` 来来来来来来来来来来来来来来来回来去.

### Abas do app: 代码 e AgentUI

O app 桌面 Organiza o trabalho em abas na barra 横向:

-   **代码** aba paderão: sessães de codificação oldais; com o agente OpenCode opendo no seu projeto (terminal e 浏览器embutidos, pissães等).
-   **探员** —— 构思器:配置 um agente com 系统即时, modelo e 技能 selecionadas, teste num sandbox de chalch embutido, e habilite/desabilite por sessão. 编辑: Baseado em páginas, sratto na sidebar. 中国植物物种信息数据库.

### 探员

OpenCode 包括两个内置代理, 您可以在其中切换 `Tab` 键.

-   **构建** - 发展工作的默认、完全无障碍代理
-   **计划** - 用于分析和代码勘探的只读剂
    -   默认拒绝文件编辑
    -   在运行 bash 命令前询问权限
    -   探索不熟悉的代码库或计划更改的理想

还包括: **常规** 用于复杂搜索和多步骤任务的子代理. 这在内部使用,可以使用 `@general` 在消息中输入.

学习更多关于 [代理人](https://opencode.ai/docs/agents) (原始内容存档于2017-09-29). in the original project's docs.

### 文档

一个文件 [打开码.ai/docs](https://opencode.ai/docs)Diferenças específicas deste分叉(旁条、技能种子、运河等) [更改日志](https://npmcn.com/package/%40alltomatos/opencode/changelog.json) (原始内容存档于2018-10-25). dete repositório.

* * *

## 十字军

Estefork 存在 graças ao tabalho da 装备 原作 **[打开代码](https://github.com/anomalyco/opencode)** (阿诺玛利克语). Todo o núcleo do produto- o agente de codificação, a TUI, o proto, o SDK- vem do projeto 原生; este fork adiceona e justa produce a camada do app desktop.

-   原创: [github.com/anomalyco/开口编码](https://github.com/anomalyco/opencode)
-   官方网站: [打开代码.ai](https://opencode.ai/)
-   官方解释: [打开码.ai/discord](https://opencode.ai/discord)

(原始内容存档于2018-03-21) (英语). Se você não está procurando e pecificamente por este分叉,使用o [原创](https://github.com/anomalyco/opencode)

### 建立在 OpenCode 上

如果您正在研究一个与OpenCode相关的项目,并且正在使用"opencode"作为其名称的一部分,例如"opencode-dashboard"或"opencode-mobile",请在你的README中添加一则注释来澄清它不是由OpenCode团队所建,并且不以任何方式附属于它们.

## 常见问题

### 如何安装 @alltomatos/opencode？

在项目目录运行 npm install @alltomatos/opencode，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 opencode，可以用 npx opencode 直接运行。

### @alltomatos/opencode 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/alltomatos\_\_opencode 是否存在。

### @alltomatos/opencode 可以商用吗？

@alltomatos/opencode 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @alltomatos/opencode 的下载量有多少？

根据 npm 官方下载统计，@alltomatos/opencode 在 2026/10/06 – 2026/11/04 这 30 天内被下载 9,015 次，日均约 301 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @alltomatos/opencode 还在维护吗？

最新版本 1\.21\.93 发布于 2026/11/01（6 天前）；至今共发布 236 个版本，其中过去 12 个月发布了 236 个；首次发布于 2026/09/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。