# @linkshell/host 中文文档

规范地址：https://npmcn.com/package/%40linkshell/host/

版本：0\.4\.80
npm 元数据更新时间：2026-11-01T16:38:27.259Z
中文译文更新时间：2026-11-01T17:53:28.014Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40linkshell/host
原文对照：https://npmcn.com/package/%40linkshell/host/?lang=original
项目主页：https://github.com/LiuTianjie/LinkShell#readme
源码仓库：https://github.com/LiuTianjie/LinkShell

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

- 包体积（解压后）：4.2 MB，307 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.13
- 运行依赖：13 个
- 首次发布：2026-09-30T14:52:41.275Z
- 最新版本发布：2026-11-01T16:38:27.096Z
- 已发布版本数：88（近 12 个月 88 个）

## 中文简介

LinkShell v2主机守护进程：拥有您计算机上的代理会话和终端，为您的设备提供服务。

## 安装

```sh
npm install @linkshell/host
```

也可以使用：`pnpm add @linkshell/host`、`yarn add @linkshell/host`、`bun add @linkshell/host`

## README

# @linkshell /主机

LinkShell v2主机守护进程。它运行在你的电脑上，拥有你的设备控制： 代理会议（Codex, Claude Code, Gemini, Copilot， Grok和其他ACP代理），终端， 文件，端口预览和远程屏幕。设备通过局域网或中继到达，端到端加密。

在CLI中运行： `npm install -g linkshell-cli`,然后 `linkshell host --daemon`.

即使在主会话空闲时，工作流进度和后台子代理文本也保持同步。该应用程序可以独立打开每个运行，阶段和代理。

## 食典委的认证

Codex使用计算机现有的ChatGPT、API密钥或自定义提供商配置， 包括CC Switch管理的设置。LinkShell不需要Codex登录： 帐户检测是建议性的，当请求运行时，Codex报告凭据错误。 修改shell环境变量后重启主机。

`pnpm --filter @linkshell/host live:codex-api` 检查已安装的Codex CLI 环回响应装置与隔离配置：保存API密钥，提供程序env密钥 以及没有账户认证的提供商。每个人通过主机完成两圈 并检查HTTP认证。没有使用真正的API凭证或付费推理。

## 会话恢复

主机0.4.19在重新启动后重新验证繁忙的会话，协调Codex本地存档。 并且把被打断的回合当作结束。在不取消归档的情况下读取已归档的法典历史。 克劳德失踪的记录和其他失败的历史记录保存了缓存信息，并显示了 事情的错误。惰性ACP代理在检查其恢复能力之前进行初始化； 仅恢复代理解释不能获取较早的消息。

主机协商并验证acp1。ACP 2仍处于草案状态，并将进行修改，以便尽快完成； 历史回放、消息和权限；单独更改版本号是不兼容的。 看到 [会话恢复，协议证据和验证](https://npmcn.com/package/docs/v2/session-recovery.md).

## 代理的问题

Codex Desktop异步问题保留其待处理状态并接受立即回复。 Claude和标准ACP表格，光标选择题和Grok问题/MCP表格共享 电话的问题卡，同时保留每个代理的本地响应格式。 看到 [问题支持和验证边界](https://npmcn.com/package/docs/v2/agent-questions.md).

## 远程屏幕

`screen.start` 返回受令牌保护的环回查看器端口和显示列表。电话 转发端口；web客户端在独立的iframe中托管相同的页面。苹果芯片和英特尔 运行macOS 13+的mac电脑，通用的LinkShell。应用程序捕获和编码与screenapturekit /VideoToolbox。主机通过 基于Unix套接字的SDP/ICE；媒体轨道和四个输入/光标通道直接运行 LinkShell之间。应用程序和本地iOS接收器或web播放器。

此媒体连接与主机的批量数据通道(`direct.offer`)， 它可以承载转发的HTTP/WebSocket流量。如果视频无法播放，Mac会提供编码 H.264帧通过另一个Unix套接字和 `screen-pacer.ts` 应用基于ack的删除和 质量措施;WebCodecs呈现字节流。iOS尝试原生→标准WebView→RPC， 在最后一步中绕过批量直接通道。Linux使用ffmpeg/X11，并且只支持视图。

`LINKSHELL_ICE_SERVERS=off` 禁用批量通道并从屏幕信号中删除STUN； 视频仍然可以尝试局域网候选人。 `LINKSHELL_SCREEN_VIDEO=off` 禁用媒体轨道提供。 带有TURN服务器的网关向主机出借其凭据(`turn.credentials`)：视频尝试 首先是直接路径，其次是中继（保持在网关上） `TURN_MAX_KBPS`)和字节中继 最后的。通过TURN或网关转发的图片在未使用3分钟后结束 （`LINKSHELL_SCREEN_IDLE_SECONDS`， `0` 从来没有); `LINKSHELL_TURN=off` 保持主机关闭。看到 [当前的体系结构](https://npmcn.com/package/docs/v2/screen-realtime.md) 用于 源/显示限制、特定于传输的默认值和验证边界。

需要Node.js 22.13或更新版本。

MIT许可证

## 常见问题

### @linkshell/host 是什么？

LinkShell v2主机守护进程：拥有您计算机上的代理会话和终端，为您的设备提供服务。

### 如何安装 @linkshell/host？

在项目目录运行 npm install @linkshell/host，或使用 pnpm add / yarn add / bun add。

### @linkshell/host 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @linkshell/host 支持 ESM 还是 CommonJS？

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

### @linkshell/host 需要什么版本的 Node\.js？

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

### @linkshell/host 可以商用吗？

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

### @linkshell/host 还在维护吗？

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