# @felan-ai/ext-prompt-history 中文文档

规范地址：https://npmcn.com/package/%40felan-ai/ext-prompt-history/

版本：0\.9\.3
npm 元数据更新时间：2026-11-13T15:01:33.986Z
中文译文更新时间：2026-11-14T13:55:28.943Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40felan-ai/ext-prompt-history
原文对照：https://npmcn.com/package/%40felan-ai/ext-prompt-history/?lang=original
项目主页：https://github.com/felan-ai/felan#readme
源码仓库：https://github.com/felan-ai/felan

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

- 包体积（解压后）：71.8 kB，36 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.19\.0
- 运行依赖：2 个
- peer 依赖：@felan-ai/agent-core ^0\.15\.0
- 首次发布：2026-08-29T08:26:41.289Z
- 最新版本发布：2026-11-13T15:01:33.540Z
- 近 30 天下载量：2899（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：28（近 12 个月 28 个）

## 中文简介

TUI 快速历史摘取者 Felan

## 安装

```sh
npm install @felan-ai/ext-prompt-history
```

也可以使用：`pnpm add @felan-ai/ext-prompt-history`、`yarn add @felan-ai/ext-prompt-history`、`bun add @felan-ai/ext-prompt-history`

## README

# @felan-ai/ext-prompt-history (英语)

通过通用UI进行即时历史搜索,可选本地TUI采取器.

默认扩展登记册 `/prompt-history`, (中文(简体) ), `Ctrl+R`,以及 `Cmd+R`打开 包含当前会议实时提示,并提供明确的查询和范围控制 用于会话、当前项目和全部项目历史。 搜索仍然模糊不清 递增,出现最先变质,最多50个结果。 选择一个 结果打开其全文;它从不插入、提交或运行提示.

可选本地取取器默认使用两个全宽水平分取器进行内接. 设定 `presentation.promptHistory.displayMode` 内 `$FELAN_AGENT_DIR/tui/settings.json` 改为 `overlay` 给一个中心弹出. 重叠模式使用完整的四边框. 它的编辑器插入和 TUI 唯一行为仍然可以通过命名 工厂。 显示模式不影响默认通用UI.

## 组成

默认根需要共享仅记录的会话服务并使用始终存在的会话 `pi.ui` 用于演示的 API :

```ts
import extension from '@felan-ai/ext-prompt-history';
import { SESSIONS_HISTORY_SERVICE } from '@felan-ai/agent-core';

services.set(SESSIONS_HISTORY_SERVICE, sessionHistory);
```

当前会话搜索从现场会话管理器中提取提示 。 项目 和全局搜索只使用可显示提供者的会话,将每个完整的日记贴上 并保留内部发布的参考文献。 复制 条目、 无效光标、 修正漂移和超大小历史明显失败 . 不可用读取生成不完整的搜索结果而不是空的完整 成功吗? 传承的地物服务出口仍可供来电者使用,但 默认根既不声明也不消耗.

一般情况 `view` 曝光已验证的查询/ 范围字段, 结果细节动作, 并扫描进度。 它不需要介绍人的提示, `hasUI`,或客户模式决定. 项目/全球扫描保存了四场会议的批次。 停止搜索或 更改其查询后防止再分批和丢弃过时结果 飞行读取完成。 初始发布后打开返回 在用户浏览时保持命令打开。 关闭和关闭 在关闭控件前加入未完成的读取和 UI 工作 .

查询范围为4,096个UTF-8字节. 结果预览被限定为512字节; 项目/会话标签使用128字节预览. 标记了剪接的即时预览 . 选中的提示不截断: 执行现有的 64 MiB 显示限制 , 完整文本被页码为 24 KiB 块。 文本为 字面标记显示 。 超大小选择明显失败, 而不是沉默 丢失文本。 检查元素身份、修订、行动目标和字段值 在使用前使用。 不将文本插入编辑器或执行提示.

所命名的工厂仍然可以直接组成,包括当地工厂 TUI倒计时:

```ts
import { createPromptHistoryExtension } from '@felan-ai/ext-prompt-history';

const extension = createPromptHistoryExtension(host);
```

这个本地采取器保留了范围循环、内线/覆盖演示,以及 将本地编辑器替换为选中的提示。 显示配置属于 TUI, 它已发布 `settings.json` 首选项为只读倒计时。 扩展声明否 显示设置.

软件包不访问文件系统、网络、证书或环境 Pi 直接配置。 历史提示可以包含私人来源,路径, 命令,或先前用户信件中提供的证书。 主机应保留 本地、界限和明确项目 可见.

配置主机通过扩展列表加载软件包 。 历史 访问来自会话范围提供者,而不是来自客户端-本地商店.

## 发展

```sh
pnpm --filter @felan-ai/ext-prompt-history build
pnpm --filter @felan-ai/ext-prompt-history type-check
pnpm --filter @felan-ai/ext-prompt-history test
```

## 归属

这个软件包适应了麻省理工学院的许可 `pi-prompt-history` 执行。 见 [通知](https://npmcn.com/package/%40felan-ai/ext-prompt-history/NOTICE) 财务报告和审定财务报表 [自由主义](https://npmcn.com/package/%40felan-ai/ext-prompt-history/LICENSE)。 。 。 .

## 常见问题

### @felan-ai/ext-prompt-history 是什么？

TUI 快速历史摘取者 Felan

### 如何安装 @felan-ai/ext-prompt-history？

在项目目录运行 npm install @felan-ai/ext-prompt-history，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@felan-ai/agent-core（^0\.15\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @felan-ai/ext-prompt-history 支持 TypeScript 吗？

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

### @felan-ai/ext-prompt-history 支持 ESM 还是 CommonJS？

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

### @felan-ai/ext-prompt-history 需要什么版本的 Node\.js？

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

### @felan-ai/ext-prompt-history 可以商用吗？

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

### @felan-ai/ext-prompt-history 的下载量有多少？

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

### @felan-ai/ext-prompt-history 还在维护吗？

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