@ghostystudio/computer

中文文档
0.7.14发布于 2026/11/04MITTypeScriptES Module零依赖近 30 天下载 6731

«La computadora del agente»: the agent's work as steps beside the chat — plan, browser with ghost cursor, live view and take-over, search results, file diffs and a hidden technical terminal. Step model + React panel + chat card, host-agnostic (own CSS, ho

原始使用文档
文档目录4 节
  1. Comprobante y cuándo abrir el panel (0.3.0)
  2. Diffs y modo no técnico (0.3.2)
  3. Captura del turno y pedido de ayuda en la tarjeta (0.4.5)
  4. Contestar el pedido de ayuda sin tomar el control (0.7.3)

@ghostystudio/computer

«La computadora del agente»: lo que un agente hace, paso por paso, al lado del chat. El plan palomeado, el navegador con captura, cursor fantasma, vista en vivo y «Tomar el control», resultados de búsqueda, diffs de archivos y la terminal escondida detrás de «Ver detalle técnico».

Nació en Sitios de EasyBits; lo usan Ghosty Teams y el chat de Ghosty Studio (/c).

import { upsertStep, attachFrame, computerCard, type AgentStep } from "@ghostystudio/computer";
import { AgentComputer, ComputerCard } from "@ghostystudio/computer/react";
import "@ghostystudio/computer/styles.css";
  • El host pone los datos: steps (los arma con upsertStep desde los eventos de tool de su turno y attachFrame con cada captura), live, y los adaptadores t (traducción, la clave es el texto en español), resolveImage, onWatch y onTakeover.
  • Estilos propios con prefijo .gc- sobre variables de .gc-scope (--gc-bg, --gc-ink, --gc-brand…): cada app las mapea a sus tokens. Sin Tailwind ni !important.
  • Publicar = subir version aquí y hacer merge a main (.github/workflows/publish-computer.yml, npm Trusted Publishing).

Comprobante y cuándo abrir el panel (0.3.0)

  • ComputerCard terminado = comprobante «▶ Ver cómo lo revisé» con la última captura; onOpen(replay) avisa si se abre como repetición (pásale autoplay a AgentComputer). TurnReceipt({steps, onOpen}) lo arma desde los pasos.
  • worthWatching(steps, now): abre el panel solo si el turno lleva WATCH_AFTER_MS (15 s), un paso espera algo (note) o el navegador falló. turnReceipt(steps) → {thumb, host, browsed}.
  • La ventana del navegador dice «En vivo» (screencast) o «Captura».

Diffs y modo no técnico (0.3.2)

  • Una salida de diff -u / git diff en la terminal se pinta como cambios (parseUnifiedDiff), no como texto.
  • exitMeaning(command, exitCode): diff/cmp con 1 = «hay diferencias», grep/rg con 1 = «sin coincidencias».
  • AgentComputer technical={false} (Sitios): terminal y genérico = tarjeta de trabajo con engrane, intent y «✓ Listo / No se pudo»; diffs como «Antes / Ahora»; la terminal tras «Ver detalles técnicos».

Captura del turno y pedido de ayuda en la tarjeta (0.4.5)

  • attachTurnFrame(steps, frame, image, stepId?): cuelga la captura tal cual viaja del host (TurnFrame, el evento browser de gs) con la imagen que tu navegador puede pintar (data URL, ruta privada…).
  • pendingAsk(steps) → {stepId, text, key} del cloud_browser_ask_human abierto; key cambia con cada pedido nuevo (para reabrir el panel o avisar una sola vez).
  • ComputerCard en vivo con un pedido abierto se vuelve la alerta «Te necesito aquí · …» con «Tomar el control» (abre el panel con onOpen(false)).

Contestar el pedido de ayuda sin tomar el control (0.7.3)

  • ComputerCard onAnswer(sessionId, "delegate" | "cancel"): la alerta «Te necesito aquí» suma «Hazlo tú» y «Cancelar» junto a «Tomar el control». El host suelta la espera del agente con esa respuesta (en gs, POST /api/v2/me/agents/:agentId/browser/answer {sessionId, answer}). Sin onAnswer, sólo «Tomar el control».
  • 0.7.5: onAnswer puede resolver {gone: true} (el agente ya no esperaba): la alerta se cierra. Si rechaza, la tarjeta enseña el error bajo el texto; ningún botón se queda mudo.

版本与发布记录

@ghostystudio/computer 共发布 33 个版本,首次发布于 2026/10/24;过去 12 个月发布了 33 个版本。

版本发布日期距今
0.7.14latest2026/11/0412 天前
0.7.132026/11/0313 天前
0.7.122026/11/0214 天前
0.7.112026/10/2720 天前
0.7.102026/10/2621 天前
0.7.92026/10/2621 天前

关于 @ghostystudio/computer 的常见问题

@ghostystudio/computer 是什么?

«La computadora del agente»: the agent's work as steps beside the chat — plan, browser with ghost cursor, live view and take-over, search results, file diffs and a hidden technical terminal. Step model + React panel + chat card, host-agnostic (own CSS, ho

如何安装 @ghostystudio/computer?

在项目目录运行 npm install @ghostystudio/computer,或使用 pnpm add / yarn add / bun add。

@ghostystudio/computer 支持 TypeScript 吗?

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

@ghostystudio/computer 支持 ESM 还是 CommonJS?

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

@ghostystudio/computer 可以商用吗?

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

@ghostystudio/computer 的下载量有多少?

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

@ghostystudio/computer 还在维护吗?

最新版本 0.7.14 发布于 2026/11/04(12 天前);至今共发布 33 个版本,其中过去 12 个月发布了 33 个;首次发布于 2026/10/24。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。