# @felan-ai/daemon 中文文档

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

版本：0\.7\.11
npm 元数据更新时间：2026-11-13T15:02:00.719Z
中文译文更新时间：2026-11-14T13:50:58.596Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：2.2 MB，336 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.19\.0
- 运行依赖：6 个
- 首次发布：2026-10-19T17:33:30.671Z
- 最新版本发布：2026-11-13T15:01:59.955Z
- 近 30 天下载量：4840（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：28（近 12 个月 28 个）

## 中文简介

Felan 会话守护进程, 包含配置的服务提供商

## 安装

```sh
npm install @felan-ai/daemon
```

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

## README

# Felan 会话守护进程

`@felan-ai/daemon` 拥有会话服务器、录入、注册、目录 持久性和处决寿命。 它不依赖Felan客户端 或延期执行. `@felan-ai/felan` 当地供应商, 默认配置和客户端,并安装精确的守护进程版本.

导入此软件包不会启动守护进程 。 管理软件包的启动 已安装了可信任配置的入口。 提供者模块解析自 从工作目录或项目内容中选择.

## 支持的平台

本地所有权后端支持 macOS, glibc Linux 和 Windows 在 x64 上 还有Arm64 其他平台或无法使用的本地后端无法关闭 `platform_blocked`;没有TCP或租赁锁倒置. 保留克菲的可选性 安装或捆绑守护进程时的平台软件包.

Windows使用进程令牌SID,独家共享文件控件和 秘密认证的节点 命名管道。 生产端点文件是 `<OS account profile>\AppData\Local\felan-daemon-v1\production\ipc-endpoint.json`。 。 。 . 协调员没有遵循 `HOME`, (中文(简体) ), `USERPROFILE` 或者说 `LOCALAPPDATA` 超载 私人路径 DACLs 允许账户,系统和管理器. 管道保留了节点默认 DACL,所以认证取决于私人 秘密,不是同一个SID管道检查。 见 [AR 0048 (英语)](https://npmcn.com/package/docs/decisions/0048-authenticate-windows-daemon-ipc-with-a-private-secret.md) 剩余出入和冒充风险.

Windows跳过目录 fsync,但保留了文件 fsync. 文件替换重试 `EPERM`, (中文(简体) ), `EACCES` 财务报告和审定财务报表 `EBUSY` 最多两秒钟 守护进程启动默认值 儿童进程 `windowsHide` 改为 `true` 除非是电话打来的 视窗 CI 操作 x64 和 arm64 在高级管理员账户下运行; 它没有 覆盖标准的非管理员账户或交互式控制台-窗口行为. 见 [土著所有权](https://npmcn.com/package/docs/maintainers/session-daemon-native-ownership.md) 用于路径、故障代码和核查范围.

## 合同和配置

-   `.` 出口 `DAEMON_VERSION` 并配置 `SESSION_RUNTIME_SERVICE`。 。 。 .
-   `./version` 出口 `DAEMON_VERSION` 不装入会话运行时间合同.
-   `./host-config` 曝光主机配置计划、装入和信任 用于管理软件包的提供者分辨率.
-   `./session-runtime` 描述会议组成和主机操作 配置,首选项,设置和根准备. 供应商供应 这些操作和证书存储; 守护进程保留录入和 关闭所有权.
-   `./provider` 描述信任的提供者定义, 限制执行 端口、处理适配器和共享存储/锁定帮助器.
-   `./client` 暴露经认证的当地运输、目标分辨率和 管理守护进程启动 . `./daemon-bootstrap` 支持管理切入点.
-   内部子路径,包括登记、储存、持久性和运行时间 UI 翻译器, 不导出 .

本地设置解析、 密钥链证书、 模型默认、 HTTP 靴子陷阱, 系统快速加载、文件夹信任和认证工作者所属 `@felan-ai/felan` 提供者, 不是守护进程软件包 .

旧的 `./daemon-profile` 导出被删除。 守护进程0.1.0和协议0.2.0 与Core 0.13.0特工协调. 它们不通过当地核查公布。 新 npm 软件包仍然需要 手动 0.0 拖带和可信任的 publisher 设置 [释放程序](https://npmcn.com/package/docs/releasing.md)。 。 。 .

`host.json` 选择提供者、扩展名和政策。 优先是明确的 绝对路径,代理目录文件,然后由 经理 通用守护进程没有隐含的本地提供者配置 . 在 Windows 上,配置信任检查文件的 DACL 而不是 POSIX 模式 位数。 在账户、系统、管理人和 信任的安装原因 `unsafe_host_config`本地安全描述符读取 失败和无支持的ACE传播 `unsafe_path` 换句话说. 提供者更改需要重新启动 。 会话配置和存储身份 在恢复时检查; 更改或缺少身份需要明确重新装入. 控制状态使用版本 1 。 无效或未支持的数据未关闭, 并且是 为恢复而保留; 没有自动迁移、重置或重放.

Stdio运输及其持续阅读器是会议基础设施,而不是 积极工作。 消费者通过运行时间报告飞行请求 终身服务。 闲置运输不能阻止重新装入或驱逐;守护进程 在发布会话前. 贝壳工作和互动终端在运行时继续阻碍驱逐.

## 列报和核查

客户端生成共享的UI词汇. 可选的渲染器提示不能允许 权力。 能力和可信赖的运输事实决定资格; 客户类标签没有。 主机设置在本地主机前应用策略 并且严格的非加太执行政策仍然不具有列报性.

被钉住的 Pi SDK 中转包括 `pi-tui`; 此软件包没有索赔 成为无终端。 通过测试 `scripts/test-isolated.sh`,则给出 各运行一个新鲜的家庭,代理目录和TMPDIR.

## 常见问题

### @felan-ai/daemon 是什么？

Felan 会话守护进程, 包含配置的服务提供商

### 如何安装 @felan-ai/daemon？

在项目目录运行 npm install @felan-ai/daemon，或使用 pnpm add / yarn add / bun add。

### @felan-ai/daemon 支持 TypeScript 吗？

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

### @felan-ai/daemon 支持 ESM 还是 CommonJS？

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

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

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

### @felan-ai/daemon 可以商用吗？

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

### @felan-ai/daemon 的下载量有多少？

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

### @felan-ai/daemon 还在维护吗？

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