# @executor-js/motel 中文文档

规范地址：https://npmcn.com/package/%40executor-js/motel/

版本：0\.2\.5-executor\.1
npm 元数据更新时间：2026-06-12T03:27:47.118Z
中文译文更新时间：2026-11-14T03:29:03.726Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40executor-js/motel
原文对照：https://npmcn.com/package/%40executor-js/motel/?lang=original
项目主页：https://github.com/kitlangton/motel#readme
源码仓库：https://github.com/UsefulSoftwareCo/motel

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

- 包体积（解压后）：1.2 MB，90 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：15 个
- 首次发布：2026-06-12T03:27:46.496Z
- 最新版本发布：2026-06-12T03:27:46.858Z
- 近 30 天下载量：11103（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：1（近 12 个月 1 个）

## 中文简介

一个本地OpenTeleometry 摄入 + TUI 查看器用于开发,由 SQLite 支持. (执行叉@kitlangton/motel)

## 安装

```sh
npm install @executor-js/motel
```

也可以使用：`pnpm add @executor-js/motel`、`yarn add @executor-js/motel`、`bun add @executor-js/motel`

## README

# 汽车旅馆

本地 OpenTeleometry 摄入 + TUI 浏览器用于开发, 由 SQLite (英语). 将您的应用程序的 OTLP/ HTTP 导入到本地的汽车旅馆服务器 并调试实时证据——来自终端,内置网络 UI,或直接取自AI编码代理.

## 对于代理商:安装汽车旅馆调试技能

`motel` 教授克洛德密码 OpenCode的伴奏技巧, 光标、 Codex 和 40 + 其他代理 如何调试运行时的证据 通过查询汽车旅馆的本地OTLP商店。 安装一次,任何未来 项目中的代理会话将知道如何使用它.

```bash
# Project-local (adds to .claude/skills, .agents/skills, etc.)
npx skills add kitlangton/motel --skill motel-debug

# Or globally, for every project
npx skills add kitlangton/motel --skill motel-debug -g
```

见全能在 [`skills/motel-debug/SKILL.md`](https://npmcn.com/package/%40executor-js/motel/skills/motel-debug/SKILL.md)。 。 。 .

## 对人类:安装和运行TUI

汽车旅馆在npm上发行 `@kitlangton/motel`二进制是一个 Bun 剧本,所以Bun一定在你身上 `PATH` 运行时间 :

```bash
# one-off (no install)
bunx @kitlangton/motel

# or install globally
bun add -g @kitlangton/motel
motel

# npm also works (Bun still required to run it)
npm install -g @kitlangton/motel
```

没有邦?

```bash
curl -fsSL https://bun.sh/install | bash
```

`motel` 启动本地 OTLP 摄入服务器 `http://127.0.0.1:27686` 并发射TUI. 新闻 `?` 一次进去 键盘作弊表,或 `c` 复制粘贴准备设置指令 用于任何您想要跟踪的效果/OTEL应用程序.

所需经费: [阿宝](https://bun.sh/) v1.1 或较新.

## 您的应用程序如何连接

一旦汽车旅馆开业,请将您的应用程序的 OTLP/HTTP 出口商指向这些 本地端点 :

```
http://127.0.0.1:27686/v1/traces
http://127.0.0.1:27686/v1/logs
```

Motel将一切保存在一个机器全球本地SQLite数据库中 `${XDG_STATE_HOME:-~/.local/state}/motel/telemetry.sqlite`一个管理 守护进程在本地项目中共享 。 无多克,无云帐.

该店默认保留了7天的遥测,目标为1GB 使用边框背景批次的活数据上限。 保存最近的数据时 最古老的完成的痕迹和日志先被取出。 配置策略 与 `MOTEL_OTEL_RETENTION_HOURS`, (中文(简体) ), `MOTEL_OTEL_MAX_DB_SIZE_MB`, (中文(简体) ), `MOTEL_OTEL_RETENTION_TRACE_BATCH`, (中文(简体) ), `MOTEL_OTEL_RETENTION_LOG_BATCH`,以及 `MOTEL_OTEL_RETENTION_INTERVAL_SECONDS`。没有创建现有数据库 增量自动真空在启动时永远不会默写; 删除页面 重新使用,但缩小这样的历史文件需要明确的离线 SQL 点 `VACUUM` 由用户选择.

## 代理连接方式

特工与 `motel-debug` 已安装的技能将自动使用 汽车旅馆的HTTP API。 完整的 OpenAPI 光谱在 `http://127.0.0.1:27686/openapi.json` -关键终点是:

```
GET /api/health                              liveness check
GET /api/services                            services reporting telemetry
GET /api/traces?service=<service>            recent traces for a service
GET /api/traces/<trace-id>                   full trace tree
GET /api/spans/<span-id>                     single span + logs
GET /api/logs?service=<service>              recent logs
GET /api/traces/search?...                   structured trace search
GET /api/logs/search?...                     structured log search
GET /api/ai/calls                            AI SDK call inspector
```

## TUI 密钥

-   `?` 键盘作弊表
-   `j` 编号 : `k` 或者说 `↑` 编号 : `↓` ——移动选择
-   `enter` 编号 : `esc` - 钻入/后出(跟踪-瀑布-跨度细节)
-   `[` 编号 : `]` ——开关服务
-   `tab` 切换服务日志
-   `/` - 过滤器痕迹
-   `s` 周期类型(最近) 出错
-   `t` --周期主题
-   `c` ——复制另一应用程序的粘贴准备设置指令
-   `o` ——在浏览器中打开所选的跟踪
-   `q` ——退出

## 隐私说明

汽车旅馆是本地开发工具 但你的应用可以发出敏感的信号 遥测. 相关日志可能包括秘密、标志或PII,如果您 app登录它们;AI调用痕迹可能包含全部即时内容并 响应文本。 将本地 SQLite 商店视为敏感开发 数据当指汽车旅馆 真正的工作量.

## 常见问题

### @executor-js/motel 是什么？

一个本地OpenTeleometry 摄入 \+ TUI 查看器用于开发,由 SQLite 支持\. \(执行叉@kitlangton/motel\)

### 如何安装 @executor-js/motel？

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

### @executor-js/motel 支持 TypeScript 吗？

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

### @executor-js/motel 支持 ESM 还是 CommonJS？

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

### @executor-js/motel 可以商用吗？

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

### @executor-js/motel 的下载量有多少？

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

### @executor-js/motel 还在维护吗？

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