@linkshell/host

中文文档
0.4.80发布于 2026/11/02MITTypeScriptES Module

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

中文使用文档
文档目录4 节
  1. 食典委的认证
  2. 会话恢复
  3. 代理的问题
  4. 远程屏幕

@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仍处于草案状态,并将进行修改,以便尽快完成; 历史回放、消息和权限;单独更改版本号是不兼容的。 看到 会话恢复,协议证据和验证.

代理的问题

Codex Desktop异步问题保留其待处理状态并接受立即回复。 Claude和标准ACP表格,光标选择题和Grok问题/MCP表格共享 电话的问题卡,同时保留每个代理的本地响应格式。 看到 问题支持和验证边界.

远程屏幕

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 保持主机关闭。看到 当前的体系结构 用于 源/显示限制、特定于传输的默认值和验证边界。

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

MIT许可证

版本与发布记录

@linkshell/host 共发布 88 个版本,首次发布于 2026/09/30;过去 12 个月发布了 88 个版本。

版本发布日期距今
0.4.80latest2026/11/021 天前
0.4.792026/11/011 天前
0.4.782026/11/012 天前
0.4.772026/11/012 天前
0.4.762026/11/012 天前
0.4.752026/10/303 天前

关于 @linkshell/host 的常见问题

@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 和提交记录判断。