# @hasna/logs 中文文档

规范地址：https://npmcn.com/package/%40hasna/logs/

版本：0\.5\.1
npm 元数据更新时间：2026-10-15T20:12:53.876Z
中文译文更新时间：2026-11-17T11:55:02.788Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40hasna/logs
原文对照：https://npmcn.com/package/%40hasna/logs/?lang=original
项目主页：https://github.com/hasna/apps/tree/main/apps/logs#readme
源码仓库：https://github.com/hasna/apps

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

- 包体积（解压后）：3.4 MB，139 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：10 个
- 首次发布：2026-03-17T06:11:19.911Z
- 最新版本发布：2026-10-15T20:12:53.444Z
- 近 30 天下载量：12037（2026-10-18 至 2026-11-16，npm 官方下载统计）
- 已发布版本数：48（近 12 个月 48 个）

## 中文简介

日志汇总 + 浏览器脚本 + 无头页扫描仪 + AI 代理的性能监测

## 安装

```sh
npm install @hasna/logs
```

也可以使用：`pnpm add @hasna/logs`、`yarn add @hasna/logs`、`bun add @hasna/logs`

## README

# @hasna/ logs (中文(简体) )

日志汇总 + 浏览器脚本 + 无头页扫描仪 + AI 代理的性能监测

[![npm](https://img.shields.io/npm/v/@hasna/logs)](https://www.npmjs.com/package/@hasna/logs) [![License](https://img.shields.io/badge/license-Apache--2.0-blue)](https://npmcn.com/package/%40hasna/logs/LICENSE)

## 安装

```bash
npm install -g @hasna/logs
```

## 全权证书和授权

每个主机表面——CLI、MCP服务器和 `@hasna/logs/api` (原始内容存档于2018-10-11) (英语). SDK - 通过共享解决其 API 密钥和 URL `@hasna/contracts` 客户端 解析器(hasna/apps#1720),每一次请求都新鲜:

| 级别 | 证书 | 权力 |
| --- | --- | --- |
| 1\. 明确的论点 | `--api-key` 编号 : `credentials.apiKey` | `baseUrl` 选项 |
| 2\. 掩体指针 | `HASNA_LOGS_API_KEY_OVERRIDE`, (中文(简体) ), `HASNA_PROFILE`, (中文(简体) ), `HASNA_LOGS_API_KEY_REF` | —— 说 |
| 3\. macOS 键链 | `hasna.credentials.logs.api-key` (账户) `HASNA_STATION`,则 `hostname -s`,则 `USER`(中文(简体) ) | `hasna.credentials.logs.api-url` |
| 4\. 磁盘`0400`编号 :`0600`(中文(简体) ) | `~/.hasna/logs/config/credentials` (单位:千美元)`HASNA_HOME` 编号 : `HASNA_CONFIG_HOME` 移动根; XDG 从未被咨询) | 同一文件 |
| 5\. 环境 | `HASNA_LOGS_API_KEY` | `HASNA_LOGS_API_URL` |

没有配置 URL 权限默认为车队网关 `https://api.hasna.com/logs` (客户端附件) `/v1`)——单是钥匙就是 完整配置 。 无前缀的遗产 `LOGS_API_URL` 编号 : `LOGS_API_KEY` 名字只能作为解析器的无声化名被接受 释放并永远不超越峡谷 `HASNA_LOGS_*` 双人 已退休投入 (单位:千美元)`~/.hasna/fleet-env`遗产 `~/.hasna` `cloud` 编号 : `config` 点点, `$XDG_CONFIG_HOME`, (中文(简体) ), `~/.logs/config.json`)从未读过,没有 `*_MODE` 编号 : `*_STORAGE_MODE` 变量选择任何东西.

**Hosted 模式失败 .** 一个没有可解决证书的数据平面命令 以一行可操作线退出非零线 — 没有 SQLite 倒置, 没有本地倒置 活动。 深思熟虑的、不能遵守的等级`HASNA_PROFILE` 名称 a 没有密钥的配置文件,或 a `HASNA_LOGS_API_KEY_REF` 保险库指针此进程 ——而且 `logs-mcp` 启动时拒绝 : `initialize` 在stdio上回答,和 在可流- HTTP 收听器之前(`--http`约束其港口。 纸箱 SQLite 仓库(`~/.hasna/logs/logs.db`只能通过明确 选入 :

```bash
export HASNA_LOGS_LOCAL=1   # alias: LOGS_LOCAL=1
```

...一跑在地面上印出一个 `local` 线条在stderr上——它永远不会 默然无声. 检查哪个运输和源头能解决:

```bash
logs transport          # e.g. transport: http, source: default, api_key_tier: keychain
logs transport --json
```

服务`logs-serve`)遵循同一规则: `HASNA_LOGS_DATABASE_URL` 选择 PostgreSQL 支持的机队 API( 由 \* 销售的储存工具箱, `HASNA_LOGS_LOCAL=1` 选择框上的 SQLite 收集器(带有 `local` 线条在 stderr 上,没有配置 无 SQLite 启动的非零.

## 环境

| 变量 | 表面 | 目的 |
| --- | --- | --- |
| `HASNA_LOGS_API_KEY` | CLI / MCP / 国家 `@hasna/logs/api` | 车队 API 密钥( 证书链的env级) |
| `HASNA_LOGS_API_URL` | CLI / MCP / 国家 `@hasna/logs/api` | 服务权限; 默认为 `https://api.hasna.com/logs` |
| `HASNA_LOGS_API_KEY_OVERRIDE` 编号 : `HASNA_LOGS_API_KEY_REF` 编号 : `HASNA_PROFILE` | CLI / MCP / SDK | 故意证书指针(第2级) |
| `HASNA_STATION` | CLI / MCP / SDK | macOS 密钥链账户选择器 |
| `HASNA_HOME` 编号 : `HASNA_CONFIG_HOME` | CLI / MCP / SDK | 移动磁盘证书/配置根 |
| `HASNA_LOGS_LOCAL` (单位:千美元)`LOGS_LOCAL`(中文(简体) ) | CLI / MCP / 国家 `logs-serve` | 明确选入盒式 SQLite 商店/收藏器 |
| `HASNA_LOGS_DATABASE_URL` (单位:千美元)`LOGS_DATABASE_URL`(中文(简体) ) | `logs-serve`, (中文(简体) ), `logs db migrate/status` | 主机服务 PostgreSQL 连接 URL |
| `HASNA_LOGS_DATA_DIR` 编号 : `HASNA_LOGS_DB_PATH` | 本地存储 | 装入框的 SQLite 位置( 默认) `$HASNA_HOME/logs/logs.db`,也就是说. `~/.hasna/logs/logs.db`· ; `HASNA_HOME` 用配置移动数据) |
| `HASNA_LOGS_API_TOKEN` (单位:千美元)`LOGS_API_TOKEN`(中文(简体) ) | `logs-serve` | API 令牌 `/api/*` 请求 |
| `HASNA_LOGS_API_SIGNING_KEY` | `logs-serve` | 为主机签名秘密 `/v1` API 密钥 |
| `HASNA_LOGS_SECRET_KEY` (单位:千美元)`LOGS_SECRET_KEY`(中文(简体) ) | `logs-serve` | 在休息时加密页面扫描证书 |
| `HASNA_LOGS_S3_BUCKET` | `logs-serve` | S3 文物上传桶 |
| `LOGS_PORT` 编号 : `PORT` | `logs-serve` | 听取端口( 默认3460) |

## CLI 使用量

```bash
logs --help
```

-   `logs list`
-   `logs tail`
-   `logs summary`
-   `logs push`
-   `logs events`
-   `logs test-reports`
-   `logs scan`
-   `logs diagnose`

`logs list` 默认为有边框的紧凑身份预览: 25行、 信件和 服务预览,可逆的 JSON- 字符串- 逃避日志ID `logs get <id>`, (中文(简体) ), 和32KB输出上限。 当更多的行还剩,页脚报告a 暂存 `next_offset`; 递回来 `--offset`启用 `--limit` 财务报告和审定财务报表 `--max-bytes` 调谐紧凑 页 次, `--format table` 用于遗留的终端列,或 `--format json` 页:1 明确完整的记录。 多层次主机过滤器扫描限定的服务器页面 `--offset` 总是数到匹配行, 继续页脚保留 真实的,即使不匹配的行 在下一场比赛之前.

实例:

```bash
logs list
logs list --text timeout --limit 25
logs list --offset 25 --max-bytes 32768
logs get <id>
logs list --format json --limit 25
```

## MCP 服务器

```bash
logs-mcp
```

包括日志搜索、原始事件搜索/观察/导出、预测测试报告搜索/获取、存储同步、扫描、发行和性能工具.

## HTTP 模式

运行一个共享的可流式HTTP MCP服务器( 只127. 0.0.1 个) :

```bash
logs-mcp --http               # default port 8864
logs-mcp --http --port 8864
MCP_HTTP=1 logs-mcp
```

-   卫生: `GET http://127.0.0.1:8864/health`
-   磁共振: `POST http://127.0.0.1:8864/mcp`

没有时, Stdio 仍然是默认 `--http` 国旗通过.

## (原始内容存档于2013-10-12) (英语). REST API

```bash
HASNA_LOGS_DATABASE_URL=postgres://… logs-serve     # PostgreSQL-backed fleet API
HASNA_LOGS_LOCAL=1 logs-serve --local-open          # on-box SQLite collector (says "local" on stderr)
```

默认情况下, API 被锁定, 除非配置或信任 API 令牌 循环模式被明确启用 :

```bash
HASNA_LOGS_API_TOKEN="$(openssl rand -hex 32)" logs-serve
# or, for local-only development:
HASNA_LOGS_LOCAL=1 logs-serve --local-open
```

使用 `Authorization: Bearer <token>` 或者说 `X-Logs-Token: <token>` 页:1 `/api/*` 请求。 浏览器 ingest 令牌仍然为浏览器设定范围只写令牌 抓取并且不批准一般API访问.

在休息时用本地生成的页扫描仪证书加密 `page-auth.key` 在日志数据目录下。 需要部署人员 管理机密, 设置 `HASNA_LOGS_SECRET_KEY` 或者说 `LOGS_SECRET_KEY`数字 :

```bash
export HASNA_LOGS_SECRET_KEY="$(openssl rand -hex 32)"
```

## PostgreSQL 后端软件

主机服务直接读写PostgreSQL(包括AWS RDS). 配置 `HASNA_LOGS_DATABASE_URL` (或 `LOGS_DATABASE_URL` 然后 应用计划并检查:

```bash
logs db migrate            # apply cloud migrations (schema + api_keys)
logs db status
```

MCP 服务器在 HTTP 传输上曝光同一事件/日志数据平面 当证书解析时——任何客户端上都没有DSN,也没有存储 在数据平面中同步 .

`LOGS_DATABASE_URL` 被接受为一个非哈斯纳倒置数据库 URL 释放.

## 数据目录

本地模式数据( E)`logs.db`、原始事件段和持久性 `agent-registry.db` 当地 `logs-mcp`)存储于 `~/.hasna/logs/` —— 说 `$HASNA_HOME/logs/` 何时 `HASNA_HOME` 替换 `~/.hasna` 根,或 `HASNA_LOGS_DATA_DIR` 当设置。 它只是根据明令创造的 `HASNA_LOGS_LOCAL=1` 选入: 主机 `logs` 编号 : `logs-mcp` 编号 : `@hasna/logs/sdk` 进程未打开 SQLite 文件( 主机) `logs-mcp` 保持其代理登记册 内存,每个过程,及其工具描述都这么说).

## 许可证

Apache-2.0 - 见 [自由主义](https://npmcn.com/package/%40hasna/logs/LICENSE)

## 常见问题

### @hasna/logs 是什么？

日志汇总 \+ 浏览器脚本 \+ 无头页扫描仪 \+ AI 代理的性能监测

### 如何安装 @hasna/logs？

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

### @hasna/logs 支持 TypeScript 吗？

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

### @hasna/logs 支持 ESM 还是 CommonJS？

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

### @hasna/logs 可以商用吗？

@hasna/logs 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @hasna/logs 的下载量有多少？

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

### @hasna/logs 还在维护吗？

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

