# inhuman 中文文档

规范地址：https://npmcn.com/package/inhuman/

版本：0\.3\.0
npm 元数据更新时间：2026-11-03T20:55:54.361Z
中文译文更新时间：2026-11-03T21:58:47.887Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/inhuman
原文对照：https://npmcn.com/package/inhuman/?lang=original
项目主页：https://github.com/here-build/inhuman-harness#readme
源码仓库：https://github.com/here-build/inhuman-harness

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

- 包体积（解压后）：206 kB，92 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：11 个
- 首次发布：2026-10-29T20:42:59.101Z
- 最新版本发布：2026-11-03T20:55:53.972Z
- 已发布版本数：5（近 12 个月 4 个）

## 中文简介

不人道：代理利用CLI - TUI， web客户端，守护进程，远程访问。

## 安装

```sh
npm install inhuman
```

也可以使用：`pnpm add inhuman`、`yarn add inhuman`、`bun add inhuman`

## README

# 不人道的

一个本地代理工作区，其会话在关闭浏览器或终端后继续运行。后台守护进程保持会话并在您的机器上运行工作；重新打开任一客户端以再次获取它。

## 开始

需要 **node . js 22 +** 和 **macOS或Linux**。

```sh
npx inhuman web
```

该命令启动守护进程和本地web服务器，打印其URL，并打开浏览器。然后它返回到您的shell，而服务继续运行。

1.  第一次运行 **连接模型** 屏幕，选择一个提供者并完成其登录或凭据提示。选项包括ChatGPT、OpenRouter、Grok和openai兼容的端点。稍后，通过添加连接 **设置→连接→添加模型**。
    
2.  在终端中，注册一个已有的项目文件夹：
    
    ```sh
    cd /path/to/your/project
    npx inhuman
    ```
    
    将路径替换为您的文件夹。终端客户端打开后，您可以关闭它；项目和会话仍然可用。
    
3.  返回到浏览器，选择项目的选项卡，并在编写器中选择一个模型。从项目页面发送将创建一个会话。
    
4.  试试：“写一份包含三项内容的项目计划清单。只在这里回复；不要使用工具或更改文件。”
    

关闭浏览器并运行 `npx inhuman web` 再次回到你的疗程。您的机器必须保持运行状态才能继续工作。工具可能等待您的批准。

## 日常使用

```sh
npx inhuman                       # terminal client
npx inhuman web                   # browser client
npx inhuman start                 # start services and print the URL
npx inhuman web --no-browser      # print the URL without opening it
npx inhuman daemon stop           # stop background execution
npx inhuman daemon restart        # restart; interrupts active work
npx inhuman --help
```

关闭客户端会使守护进程继续运行。 `daemon stop` 停止;保存的会话文档保留在磁盘上。默认的内核目录为 `~/.harness`;使用 `--kernel PATH` 不断地选择另一个。保存的会话文档位于内核的 `documents/` 目录中。

选择 `manual`， `auto`,或 `always approve` 在会话的权限选择器中。MCP服务器和插件可以在安装后扩展代理的工具。

通过远程访问 `npx inhuman login` 是实验性的，仅限于电子邮件允许列表。它与连接模型提供程序是分开的。

读了 [使用指南](https://github.com/here-build/inhuman-harness/blob/main/docs/usage.md) 用于设置、权限、存储和故障排除。看到 [项目](https://github.com/here-build/inhuman-harness#readme)， [远程访问限制](https://github.com/here-build/inhuman-harness/blob/main/docs/proposals/remote-access.md),或 [报告问题](https://github.com/here-build/inhuman-harness/issues)。

[麻省理工学院的许可](https://github.com/here-build/inhuman-harness/blob/main/LICENSE.md)。

## 常见问题

### inhuman 是什么？

不人道：代理利用CLI - TUI， web客户端，守护进程，远程访问。

### 如何安装 inhuman？

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

### inhuman 支持 TypeScript 吗？

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

### inhuman 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### inhuman 需要什么版本的 Node\.js？

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

### inhuman 可以商用吗？

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

### inhuman 还在维护吗？

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