# @abstractframework/observer 中文文档

规范地址：https://npmcn.com/package/%40abstractframework/observer/

版本：0\.12\.4
npm 元数据更新时间：2026-11-07T17:15:58.134Z
中文译文更新时间：2026-11-09T21:05:33.320Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40abstractframework/observer
原文对照：https://npmcn.com/package/%40abstractframework/observer/?lang=original
项目主页：https://abstractframework.ai/observer
源码仓库：https://github.com/lpalbou/AbstractObserver

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

- 包体积（解压后）：7.6 MB，14 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.0\.0
- 运行依赖：6 个
- 首次发布：2026-02-04T08:40:12.382Z
- 最新版本发布：2026-11-07T17:15:57.775Z
- 近 30 天下载量：1731（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：33（近 12 个月 33 个）

## 中文简介

用于抽象框架的仅网关可观察性 UI - 连接到运行网关,重放/流出分类账,并提交可持久使用的命令

## 安装

```sh
npm install @abstractframework/observer
```

也可以使用：`pnpm add @abstractframework/observer`、`yarn add @abstractframework/observer`、`bun add @abstractframework/observer`

## README

# 摘要观察员

用于抽象框架运行的仅网关可观察UI(Web/PWA).

它做什么(执行于 `src/ui/app.tsx` + 键 `src/lib/gateway_client.ts`:

-   **发现** 文摘Gateway所曝光的工作流程/捆绑
-   **发射** 运行,或创建 **自动化** 当有东西到达时, 网关按时间表运行( 邮件、 种子、 网络呼号) 或用手运行( 可延长)
-   **观察** 通过重放 + 流出持久运行和子运行 **分类账** (重播-第一+SSE) (中文(简体) )
-   **检查运行时状态** 跨活动运行、生成的文物、供应商呼叫和网关审计日志
-   **控制权** 通过持久命令运行( r)`pause`, (中文(简体) ), `resume`, (中文(简体) ), `cancel`(中文(简体) )
-   (备选) **语音**: 高声读取( 流出句子的句子) 在 Ask 中拼写, 运行结果和自动化 ; 讨论 ; 设置 ; 语音是工具包的共享部分, 显示网关的默认路线( )`src/ui/observer_voice.tsx`(中文(简体) )

## 有什么新情况

0.12.4 显示网关的每次会话、 Docs 助理聊天和摘要说明本身的会话 **会议** 简单过滤器一行(All, Conversations, Automation, Notes and any other kind of the 网关报告), 当网关提供过滤器时。 委员会比较平和,容易读取:句子-案发道,全宽卡片标题, 以工作流程、持续时间和计数方式命名的无标题卡以及读取为个人卡的实体卡 而不是一个代码面板。 见 [变动情况](https://npmcn.com/package/%40abstractframework/observer/CHANGELOG.md#0124---2026-11-07)。 。 。 .

0.12.3 用共享实体卡(工具包)取代理事会的实体牌 `EntityCard`,每个应用程序共享: 实体显示它的外观和名称,它现在在做什么,以及做了多久,当它自己的时间在之后停止时警告 失败,这是最近和最后的时刻,用平话直说。 符号计数,相位芯片和 "78个问题" 29个问题"33个课" 夜晚:每块瓷砖下有48个信号"药丸已去. 带有摘要Gateway 每张卡片0.210. 每30秒有一张小读取. 见 [变动情况](https://npmcn.com/package/%40abstractframework/observer/CHANGELOG.md#0123---2026-11-07)。 。 。 .

0.12.2 使委员会的实体条块立即出现:一旦实体名单列出,就立即绘制出瓷砖 所以一个历史悠久的实体就不再保留了 整条空地几秒钟。 缓慢变化的细节保存,每5分钟或实体时再读一次 更改状态,而不是每30秒再次被下载一次,一个失败的读取会保留所显示的内容(说到 旧的,而不是 空白它。 见 [变动情况](https://npmcn.com/package/%40abstractframework/observer/CHANGELOG.md#0122---2026-11-07)。 。 。 .

0.12.1 取取共享语音修正:当浏览器暂停页面声音时,会高声读取并说出按钮 提供 Play 并说, Play 恢复相同的音频, 而不是再准备回复 。 见 [变动情况](https://npmcn.com/package/%40abstractframework/observer/CHANGELOG.md#0121---2026-11-07)。 。 。 .

0.12.0 将每个实体以自己的设计和颜色取自理事会的身份(从一个瓦片上取出 设计,颜色和声音),代理页面以平话语描述谈话的去向:, 成功,失败和一种只考虑任务完成或"还没有经验"的信任. 打开 操作中, 最新的活动首先, 并将已暂停的活动折叠到“ 暂停 : N” 下。 所有这些需要 文摘Gateway 02.0 (英语). 见 [变动情况](https://npmcn.com/package/%40abstractframework/observer/CHANGELOG.md#0120---2026-11-04)。 。 。 .

0.11.0 将批准、等待和工具结果用文字读出,将口音麦克风放入Send in 共享作曲,并使用工具包的一个账户部件。 见 [变动情况](https://npmcn.com/package/%40abstractframework/observer/CHANGELOG.md#0110---2026-11-02)。 。 。 .

## 观察实体(实体应用程序)

这个 **实体应用** (memory图 + 访问UI)是它自己的包, [抽象实体](https://github.com/lpalbou/AbstractEntity) (单位:千美元)`npx @abstractframework/entity`默认端口 `3007`) (中文(简体) ). 观察员仍然 _手表_ - 董事会实体从每个实体抽取一张共享实体卡 `GET /api/gateway/entities` 财务报告和审定财务报表 `/entities/{name}/tile` (0.21.0之前的网关,来自 `/entities/{name}/cognition` 财务报告和审定财务报表 `/entities/{name}/card`——及其成果 实体应用程序部署的“ 实体 QQ” 链接点 (单位:千美元)`--entity-app-url`默认值 `http://127.0.0.1:3007`) (中文(简体) ).

## 适合的地方(框架生态系统)

抽象观察家(Cradual Observator)是该页面中的浏览器UI之一 **抽象框架** 生态系统:

-   抽象框架(生态系统切入点): [https://github.com/lpalbou/Abstract 框架](https://github.com/lpalbou/AbstractFramework)
-   抽象运行时间( 可持久运行时间+网关后面的分类账): [https://github.com/lpalbou/abstractruntime 互联网档案馆的存檔,存档日期2014-12-21](https://github.com/lpalbou/abstractruntime)
-   抽象核心( LLM + 运行时/ 工作流程所使用的工具集成): [https://github.com/lpalbou/abstractcore 页面存档备份,存于互联网档案馆](https://github.com/lpalbou/abstractcore)

```mermaid
flowchart LR
  U[User] --> O[AbstractObserver<br/>browser UI]
  O -->|HTTP fetch + SSE| G[AbstractGateway<br/>/api/gateway/*]
  G --> R[AbstractRuntime<br/>durable runs + append-only ledger]
  R --> C["AbstractCore<br/>LLM + tools (optional)"]
```

## 快速启动( npm)

总理:

-   节点.js `>=18`
-   显示 : `docs/api.md`

运行 UI 服务器 :

```bash
npx --yes --package @abstractframework/observer -- abstractobserver
```

注: npm 软件包是 `@abstractframework/observer`,而CLI 二进制是 `abstractobserver`。 。 。 .

打开 `http://localhost:3001`。签名是共享的抽象框架 连接对话框( 同一节选Flow 和网关控制台使用) : 它在浏览器没有网关会话时自动打开——输入 网关 URL( 预填自服务器), 一个网关用户 ID, 以及 用户的符号 。 对话框总是在信头连接上点击一下 徽标.

在主机模式下, 观察者将用户代号交换为应用瞄准网关 浏览器会话, 并且不会在浏览器设置中坚持该符号 。 直接 无记名模式仍可用于当地发展。 当观察者是 从非本地主机名服务,服务器配置的网关 URL 是 权威; 除非 `ABSTRACTOBSERVER_ALLOW_REMOTE_BROWSER_GATEWAY_CONFIG=1` 被设置在自己的后面 进入控制。 如果反向代理重写 `Host`设置 `ABSTRACTOBSERVER_TRUST_PROXY_HEADERS=1` 仅在代理剥离时 客户端提供的转发头.

## 安装选项

### 全局安装

```bash
npm install -g @abstractframework/observer
abstractobserver
```

### Pin a (推荐用于部署)

```bash
npx --yes --package @abstractframework/observer@0.12.1 -- abstractobserver
```

### CLI 配置

CLI(`bin/cli.js`)为已建成的UI服务,并挂载应用程序源网关 会话代理从 `@abstractframework/app-server` (以周期为单位) 此软件包,自动安装).

-   `--gateway-url <url>` (别名) `--gateway`, (中文(简体) ), `--url`)——此服务器的Gateway 输入和代理 `/api` 改为: 默认: 在此安装的网关 计算机`~/.abstractframework/gateway.json`当它移动端口时, 其他情况 `http://127.0.0.1:8080`。 。 。 .
-   `--port <n>` (默认) `3001`和 `--host <addr>` (默认) `127.0.0.1`(中文(简体) )
-   `--monitor-gpu` ——可选的 GPU 部件
-   `--entity-app-url <url>` ——实体应用所居住的地方("实体"QQ链接)
-   `--gateway-dir <dir>` – 相对运行的工作空间路径的基础( 本地文件夹显示)

环境变量是旗下遗留的别名: `PORT`, (中文(简体) ), `HOST`, (中文(简体) ), `ABSTRACTOBSERVER_GATEWAY_URL`, (中文(简体) ), `ABSTRACTGATEWAY_URL`, (中文(简体) ), `ABSTRACTOBSERVER_MONITOR_GPU`, (中文(简体) ), `ABSTRACTOBSERVER_ENTITY_APP_URL`, (中文(简体) ), `ABSTRACTOBSERVER_GATEWAY_DIR`。 。 。 .

该网关还可通过观察员本身在 `/apps/observer/` (一个端口和一个地址,用于控制台、API和应用程序,例如: 远程服务器: 网关启动此服务器 `127.0.0.1` 并转发到 这个. `abstractobserver --help` 列出旗帜.

见 `docs/configuration.md` 完整名单.

## 特征(UI页)

所有页面共享相同的网关连接设置.

-   **董事会** (任务控制,着陆页):每张一卡 **任务** ——你开始的跑道,或者自动化的转道——在任何街区的道上: **需要你帮忙** (只有您可以移动这些 : 请求的子运行请求带有内联网批准/ 拒绝/ Answer/ Resume; 等待已经结束的子运行的运行会被标记) **粘贴** 并说, **工作** (一个特工在上面: 开阔的台阶,它移动了多久, 过了你在车道上挑取的无进步门槛), **等着..** (其他事情必须先发生: 潜行、事件、时钟), **计划** (自动:下一次运行、最后一次运行、转弯、弯曲), **完成** (结果的一瞥,时间,标志,工具,文物). 任务卡显示其内部的子运行链——每个子运行链都有自己的单词,连接到该子运行的链接和仅该子运行的停止控制——每个车道头都有一个被取消的任务(一个被取消的到达任务的父母和子运行,从没有自动化的时间表). 最后已知的棋盘再装入后立即刷新; (一)承担了全部任务和一个自动化的参数; QQ复制了运行的ID.
-   **观察**: 链接到一个运行 `#run/<run_id>` (网关下: `/apps/observer/#run/<run_id>`; 未知的运行, 或您的账户无法看见的运行, 被说得如此简单; 运行视图的工作流程/ 子工作流程导航器( 一个段落摘要, 然后被代理周期归类为崩溃的卡片, 并扩展至全部的快速和回答; LLM 调用 / Tools / 失败过滤器, 一个用于内部管理、 搜索的所有步骤切换), 图表, **询问** 关于运行( 整个对话被发送; 当网关的 50,000- token 窗口将旧消息放出时, 便条会写出; 可选的声音 : PTT + TTS ) 这个 **探员** 视图(在一张棋盘卡打开的地方)描述代理人——它是谁、它可能使用和确实使用什么、它会做什么、它会做什么、它会做什么、它会做什么、它会多久、它会做什么——每一个值都完整(按大小拼接,从不剪接),其输入和输出为带有活值的抽象花针、其上下文窗口、运行树并花费。 这个 **流动** 视图表示正在进行中或已完成,突出“摘要Flow”词汇中的当前节点,并用副本(事实、记录、准确的LLM上下文)和一击显示每个节点的事实 **复制运行状态** 为AI读者提供.
-   **助理** (上行):观察员本身的问题,从其文件;每次谈话一次网关会话(**新对话** 启动新工具, 无工具
-   **系统** (运行时视图):用于平台级监测的活动,艺术,内存,和日志模式. Artifact Explorer 使用 Gateway 的文物信封和准确的数据数据,将语音/音乐/声音/未分类的音频与诸如Markdown/HTML/JSON等渲染类型区分开来,预览介质内线,并将文物链接回生成运行,分类账,以及元数据可用时的跟踪/审计动作
-   **发射** (模式,不是一页): **\+ 新的自动化** 在Automate 页面上以 Automate 模式打开它( 包括自己运行的流量, 并预选其触发器; 当 : 流量的触发器, 某物通过手, UTC 间隔到达, 或每日/ 每周/ 月/ 一次在您的账户的时区上, 由网关填入; 独立或不断增长的上下文; 工具批准); 标题 **发射** 按钮以一次运行模式打开; `#launch` 编号 : `#launch/automate` 深链接在当前页面上打开; 捆绑上传/再装入
-   **自动化**:签名用户的每个自动化,现在都有暂停/重修/运行(同时暂停)/停止当前/编辑(任务,间隔,上下文,工具——行的编辑一次打开表单)/存档,以词来触发("当邮件到达...","当发行笔记有新项目时"),其运行读作对话(在每次运行上方到达, **跑完车后** 每个答案下:注意,提示或什么也不响,每次发送),按种类回答等待运行(问题,工具批准,事件),其文件夹可以从浏览器上浏览(通过网关打开或下载),并讨论(在同一页上聊天,同时有一个叉子:其完整历史,自己的工作空间和自动化文件只读);遗留时间表保持其控制,可以被重制为自动化(`docs/automations.md`(中文(简体) )
-   **系统-内存**: 知识图 (活性内存) 查询 UI( 需要) `POST /api/gateway/kg/query`(中文(简体) )
-   **设置**: 连接状态、主题和显示偏好,可选远程工具工作者
-   **响应布局**:电话、平板电脑和小窗口获得一个导航抽屉、全宽列表和带有可折叠列表的细节、底表对话框和触控大小(`docs/getting-started.md` ——"对策布局"
-   **关于** (上行的信息按钮):与摘要观察器版本的共享 Conference About Card, 摘要框架和摘要Gateway 版本连接的网关报告、链接(网站、来源、文件、问题、反馈、联系)和许可行

## 文档

-   从这里开始 : `docs/getting-started.md`
-   文档索引 : `docs/README.md`
-   问: `docs/faq.md`
-   结构( 有图表) : `docs/architecture.md`
-   配置部署( D) : `docs/configuration.md`
-   API( 使用的出入口终点) : `docs/api.md`
-   自动化( 创建、 管理、 回答、 讨论) : `docs/automations.md`
-   解决问题: `docs/troubleshooting.md`
-   发展: `docs/development.md`
-   安全信任边界( T) : `docs/security.md`

## 项目

-   更改日志 : `CHANGELOG.md`
-   贡献: `CONTRIBUTING.md`
-   安全政策(脆弱性报告): `SECURITY.md`
-   承认: `ACKNOWLEDGMENTS.md`
-   行为守则: `CODE_OF_CONDUCT.md`

## 发展(来源)

```bash
npm install
npm run dev
```

重要的: dev/building 预想对显示器包进行兄弟“AbstractUIC”检查(`@abstractframework/monitor-*`页:1 `vite.config.ts` 别名改为 `../abstractuic/*/src`· ; `@abstractframework/ui-kit` 财务报告和审定财务报表 `@abstractframework/panel-chat` 是 npm 的依赖关系. 见 `docs/development.md` 详细情况.

## 常见问题

### @abstractframework/observer 是什么？

用于抽象框架的仅网关可观察性 UI - 连接到运行网关,重放/流出分类账,并提交可持久使用的命令

### 如何安装 @abstractframework/observer？

在项目目录运行 npm install @abstractframework/observer，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 abstractobserver，可以用 npx abstractobserver 直接运行。

### @abstractframework/observer 支持 TypeScript 吗？

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

### @abstractframework/observer 支持 ESM 还是 CommonJS？

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

### @abstractframework/observer 需要什么版本的 Node\.js？

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

### @abstractframework/observer 可以商用吗？

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

### @abstractframework/observer 的下载量有多少？

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

### @abstractframework/observer 还在维护吗？

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