# @kolisachint/hoocode 中文文档

规范地址：https://npmcn.com/package/%40kolisachint/hoocode/

版本：0\.2\.29
npm 元数据更新时间：2026-11-01T14:34:11.161Z
中文译文更新时间：2026-11-01T16:09:15.183Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40kolisachint/hoocode
原文对照：https://npmcn.com/package/%40kolisachint/hoocode/?lang=original
项目主页：https://kolisachint.github.io/hoocode/
源码仓库：https://github.com/kolisachint/hoocode

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

- 包体积（解压后）：14 kB，5 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-10-01T12:52:39.682Z
- 最新版本发布：2026-11-01T14:34:10.835Z
- 已发布版本数：73（近 12 个月 73 个）

## 中文简介

Hoocode，终端编码代理

## 安装

```sh
npm install @kolisachint/hoocode
```

也可以使用：`pnpm add @kolisachint/hoocode`、`yarn add @kolisachint/hoocode`、`bun add @kolisachint/hoocode`

## README

![hoocode](https://npmcn.com/package/%40kolisachint/hoocode/docs/assets/brand/hoocode.svg)

一个终端编码代理，用Rust编写。一个静态二进制文件，任何模型提供程序，没有您的允许，什么都不应用。

[![CI](https://github.com/kolisachint/hoocode/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/kolisachint/hoocode/actions/workflows/ci.yml) [![Latest release](https://img.shields.io/github/v/release/kolisachint/hoocode?sort=semver)](https://github.com/kolisachint/hoocode/releases/latest) [![npm](https://img.shields.io/npm/v/hoocode?label=npm)](https://www.npmjs.com/package/hoocode) [![PyPI](https://img.shields.io/pypi/v/hoocode?label=PyPI)](https://pypi.org/project/hoocode/) [![MIT license](https://img.shields.io/badge/license-MIT-blue)](https://npmcn.com/package/%40kolisachint/hoocode/LICENSE)

![hoocode in a terminal: asked to make mean() return an Option, it reads src/lib.rs, shows the edit as a diff and waits for approval, runs cargo test after a second approval (1 passed), sums up, and then opens the slash-command menu](https://npmcn.com/package/%40kolisachint/hoocode/docs/assets/demo.gif)

实二进制；只有模型是脚本化的，因此可以为每个发布版本再次记录演示(`scripts/demo/record.sh`）。

* * *

Hoocode读取你的代码，运行命令，编辑文件，并与你的模型 选择，从全屏终端UI或作为一个一次性命令。它是一个单一的本地 binary：不需要Node，不需要Python，不需要安装运行时。

-   **任何供应商。** Anthropic, OpenAI， b谷歌，OpenRouter, Groq, DeepSeek, xAI, Fireworks 以及更多，通过API键或 `/login` （Anthropic, GitHub Copilot, OpenAI Codex， b谷歌）。
-   **你要控制自己。** Shell， Edit and Write先问（Yes / No / Always）。四个 代理模式（询问、计划、构建、调试）限定代理可以做什么。
-   **子代理。** 代理可以将工作手工传递给后台的子代理并继续运行；他们的 工具调用要经过与主代理相同的审批门。
-   **你可以回来参加会议。** `--continue`， `/resume`， `/fork`， `/tree`, 自动压缩长对话。
-   **可扩展的开放格式。** `AGENTS.md` / `CLAUDE.md` 背景文件、技能、 提示模板和斜杠命令，MCP服务器，插件，主题和键绑定。
-   **脚本。** 打印模式(`-p`)输出文本或JSON，以及JSON- rpc模式 （`--mode rpc`)用于从另一个程序中驱动hoocode。

## 安装

Hoocode运行于 **macOS和Linux，支持x64和arm64**． Linux构建是静态的 （肌肉），所以一个二进制文件可以在任何发行版上运行。目前还没有Windows版本。

**安装脚本** （无root，无Node）：

```bash
curl -fsSL https://kolisachint.github.io/hoocode/install.sh | sh
```

它为您的平台下载发布归档，并根据发布进行检查 `SHA256SUMS`、安装 `~/.hoocode/bin/hoocode` (加上一个 `hoo` 别名)和添加 `~/.hoocode/bin` 到你的 `PATH`。通过 `--help` 对于选项(`--version`， `--dir`， `--no-modify-path`）. 脚本如下 [`install/install.sh`](https://npmcn.com/package/%40kolisachint/hoocode/install/install.sh) 在这个回购。

**NPM或bun** （Node 18或更新版本）：

```bash
npm install -g hoocode     # or: bun add -g hoocode
```

该包仅为您的平台导入本机二进制文件。它安装 `hoocode` 和 `hoo`.

**皮普** （Python 3.8或更新版本）：

```bash
pip install hoocode        # or: pipx install hoocode
```

一个瘦启动器：在第一次运行时，它会下载你的平台的发布二进制文件， 检查它的sha256 `SHA256SUMS` 把它藏在下面 `~/.cache/hoocode/`.

**预先构建的二进制文件。** 每一个 [GitHub释放](https://github.com/kolisachint/hoocode/releases) 有 `hoocode-<target>.tar.gz` 用于 `x86_64-unknown-linux-musl`， `aarch64-unknown-linux-musl`， `x86_64-apple-darwin` 和 `aarch64-apple-darwin`，和 `SHA256SUMS` 文件。打开包装，放好 `hoocode` 在你的 `PATH`：

```bash
tar xzf hoocode-aarch64-apple-darwin.tar.gz
install -m 755 hoocode-aarch64-apple-darwin/hoocode ~/.local/bin/hoocode
```

**从源** (Rust 1.88或更新版本；仓库将其开发工具链固定在 [`rust-toolchain.toml`](https://npmcn.com/package/%40kolisachint/hoocode/rust-toolchain.toml)（生锈会自己捡起来）：

```bash
git clone https://github.com/kolisachint/hoocode
cd hoocode
cargo install --locked --path crates/hoocode-code-main --bin hoocode
```

或运行 `scripts/install.sh`，它构建一个发布二进制文件并将其安装为 `hoocode` 和 `hoo`． 默认情况下，它会更新 `$HOOCODE_INSTALL_DIR/bin` 当 目录已包含可执行文件 `hoocode`;如果 `HOOCODE_INSTALL_DIR` 是 取消设置，它检查 `~/.hoocode/bin` 代替。否则，它将安装到 `~/.local/bin`。通过 `--prefix DIR` 覆盖目标。

Hoocode不在板条箱上。io或Homebrew。

**更新。** `hoocode update` 打印安装方式的正确更新命令。

## 快速启动

```bash
export ANTHROPIC_API_KEY=...          # or any provider key, see `hoocode --help`
cd your-project
hoocode                               # full-screen interactive session
```

没有API密钥？开始 `hoocode` 和运行 `/login` 以订阅方式登录。

在互动环节中可以尝试以下内容：

| 类型 | 它是做什么的 |
| --- | --- |
| `/model` | 选择一个模型（Ctrl+P在你最喜欢的模型中循环） |
| `/mode` | 在询问、计划、构建和调试之间切换 |
| `/resume` | 在此文件夹中重新打开较早的会话 |
| `@path/to/file` | 在邮件中附加一个文件 |
| `/hotkeys` | 显示键盘快捷键 |
| `/settings` | 改变设置 |

一次性和脚本使用：

```bash
hoocode -p "Summarize this repo"                        # print the answer and exit
hoocode -p --mode json "List the TODOs in src/"         # JSON event stream
hoocode --model anthropic/claude-sonnet-4-5 "Review the last commit"
hoocode --continue "And now fix the first one"          # continue the last session
hoocode --tools Read,CodeSearch -p "Review src/"        # read-only run
hoocode --mode rpc                                      # JSON-RPC over stdin/stdout
```

插件添加技能，子代理和MCP服务器。添加一个git市场，然后安装 从它，从壳或与 `/plugin` 在会话中：

```bash
hoocode plugin marketplace add <git-url-or-owner/repo>
hoocode install <plugin>@<marketplace>     # --scope project for this repo only
hoocode list
```

`hoocode --help` 列出每个标志和提供程序环境变量； `hoocode --list-models [search]` 列出它知道的模型。

## 配置

所有hoocode保存的东西都存在 **`~/.hoocode`**． 集 `HOOCODE_CODING_AGENT_DIR` 来 移动它。

| 文件或文件夹 | 它包含什么 |
| --- | --- |
| `~/.hoocode/settings.json` | 全局设置(`/settings` 编辑) |
| `.hoocode/settings.json` | 每个项目设置，在全局设置上合并 |
| `~/.hoocode/auth.json` | 登录名和密钥由保存 `/login` |
| `~/.hoocode/models.json` | 您自己的提供程序和模型（例如本地openai兼容服务器） |
| `~/.hoocode/hoo-config.json` | 代理模式和工具审批规则 (`auto_allow`） |
| `~/.hoocode/skills/`， `.hoocode/skills/` | 技能，全球和每个项目 |
| `~/.hoocode/themes/` | 自定义主题 |
| `~/.hoocode/sessions/` | 保存的会话，每个JSONL文件，在每个项目的文件夹中(`HOOCODE_CODING_AGENT_SESSION_DIR` 或者 `--session-dir` 移动它们) |
| `~/.agents/mcp.json`， `.agents/mcp.json` | 全局和每个项目的MCP服务器(`/mcp` 显示它们的状态) |
| `~/.agents/plugins/`， `.agents/plugins/` | 插件、用户和每个项目 (`hoocode install`， `hoocode list`，或者 `/plugin` 在一个会话中) |
| `AGENTS.md` 或者 `CLAUDE.md` | 项目说明，从工作文件夹及其父文件夹中读取 |

因为会话被保存为文件，所以您可以恢复、分叉或导出 他们 (`/export <file>.jsonl`）。 `--no-session` 保持短暂的运行，并且 `--offline` 关闭启动网络调用，如版本检查。

## 文档

-   [`docs/user/`](https://npmcn.com/package/%40kolisachint/hoocode/docs/user/): 用户文档，发布于 [https://kolisachint.github.io/hoocode](https://kolisachint.github.io/hoocode) 每次发布
-   [`docs/maps/ui.md`](https://npmcn.com/package/%40kolisachint/hoocode/docs/maps/ui.md)：屏幕，选择器，斜杠命令和键， 以及它们在代码中的位置
-   [`docs/maps/packages.md`](https://npmcn.com/package/%40kolisachint/hoocode/docs/maps/packages.md): 工作区中的每个板条箱和 它是做什么的
-   [`docs/design/`](https://npmcn.com/package/%40kolisachint/hoocode/docs/design/README.md)：设计说明和路线图
-   [`docs/design/distribution.md`](https://npmcn.com/package/%40kolisachint/hoocode/docs/design/distribution.md): 发布如何到达用户
-   [`CHANGELOG.md`](https://npmcn.com/package/%40kolisachint/hoocode/CHANGELOG.md)什么改变了 `/changelog` 内部hoocode)

## 贡献

### 试一试，然后告诉我们

您可以做的最有用的事情是尝试hoocode并告诉我们它是如何进行的。

-   **Bug还是想法？** [打开一个问题](https://github.com/kolisachint/hoocode/issues/new/choose).
-   **问题？** 询问 [讨论](https://github.com/kolisachint/hoocode/discussions).
-   **想要发送PR？** 拉请求是受欢迎的。从……开始 [你的第一个pull请求](https://npmcn.com/package/%40kolisachint/hoocode/CONTRIBUTING.md#your-first-pull-request) 和 [好的第一个问题](https://github.com/kolisachint/hoocode/labels/good%20first%20issue).

[CONTRIBUTING.md](https://npmcn.com/package/%40kolisachint/hoocode/CONTRIBUTING.md) 涵盖开发循环 (fmt，clippy，nextest)， 测试的去向以及发布的工作方式。请阅读 [行为准则](https://npmcn.com/package/%40kolisachint/hoocode/CODE_OF_CONDUCT.md)，并将安全问题私下报告为 描述在 [SECURITY.md](https://npmcn.com/package/%40kolisachint/hoocode/SECURITY.md).

如果hoocode对你有用，回购上的星星可以帮助其他人找到它。

## 学分

hoocode开始作为一个叉 [`pi-mono`](https://github.com/badlogic/pi-mono) 由 Mario Zechner，麻省理工学院授权。其版权声明保存在 [许可证](https://npmcn.com/package/%40kolisachint/hoocode/LICENSE). 感谢Mario和上游贡献者。

## 许可证

麻省理工学院,看到 [许可证](https://npmcn.com/package/%40kolisachint/hoocode/LICENSE).

## 常见问题

### @kolisachint/hoocode 是什么？

Hoocode，终端编码代理

### 如何安装 @kolisachint/hoocode？

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

### @kolisachint/hoocode 支持 TypeScript 吗？

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

### @kolisachint/hoocode 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @kolisachint/hoocode 可以商用吗？

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

### @kolisachint/hoocode 还在维护吗？

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