# @fnndsc/calypso 中文文档

规范地址：https://npmcn.com/package/%40fnndsc/calypso/

版本：0\.29\.15
npm 元数据更新时间：2026-11-15T02:04:33.781Z
中文译文更新时间：2026-11-15T03:37:46.520Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40fnndsc/calypso
原文对照：https://npmcn.com/package/%40fnndsc/calypso/?lang=original
项目主页：https://github.com/HARBOR-Medical-AI/mise/tree/main/packages/calypso#readme
源码仓库：https://github.com/HARBOR-Medical-AI/mise

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

- 包体积（解压后）：648 kB，76 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：6 个
- 首次发布：2026-07-11T13:59:43.805Z
- 最新版本发布：2026-11-15T02:04:33.546Z
- 近 30 天下载量：6941（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：101（近 12 个月 101 个）

## 中文简介

CALYPSO: ChrIS会话守护进程 – 在一个 WebSocket 上为附着的表面主持一个 brasa 引擎

## 安装

```sh
npm install @fnndsc/calypso
```

也可以使用：`pnpm add @fnndsc/calypso`、`yarn add @fnndsc/calypso`、`bun add @fnndsc/calypso`

## README

# @fnndsc/calypso (英语)

**卡丽波** **A 类**阴茎 **L**愤怒, **Y**iel **页:1**允许 **页:1**地狱 **欧**研讨会的东道主和未来的意向援助层 [爱](https://npmcn.com/package/README.md) 堆栈.

名字是港湾参考. 在那个 _奥德赛_, Calypso 保留了航行者所发现的避风港;这个名字是希腊语"来隐藏"的单词,项目保持了这个单词,但转过身来. **哈尔博尔** 是ChRIS操作员的天堂,而CALYPSO是它的边缘的守护者——你和开水之间的地层: Collection+JSON splawl,一个联邦后端的复杂性. CALYPSO隐瞒的是摩擦 而不是结果 一个没有扣留的港口避难所:工作是作为可核查的可实现状态留下的,是你的离开和返回——CALYPSO你经过的港口,永远不要站在你站立的地上.

## 这个包裹是什么

CALYPSO 主办者 [刹车](https://npmcn.com/package/%40fnndsc/brasa/README.md) a 后面的引擎 **会话守护进程** 并把它用在一个网络上: [铃声](https://npmcn.com/package/%40fnndsc/chell/README.md) 今天的CLI,下一个是网页控制台,每个都渲染相同的会话. 因为引擎可以与其显示分离(参见: [第一阶段](https://npmcn.com/package/docs/calypso.adoc)),它可以运行数据必须停留的地方——在说话的信任边界内——而操作员将数据驱动过一个瘦客户端.

接线合同,守护进程,会话总线,身份密钥发现,以及ChELL远程客户端被运出. 自然语言的意向援助层仍然是单独的前行工作.

## 电线合同

合同的定义是: [佐德语](https://zod.dev/) schemas——真实的单一来源,从中推断出信息类型,并在边界上验证每个信息.

-   **信件** (两个方向键结合):表面附着在本地 能力,执行,完成, 回答提示,返回本地管和 shell 结果或失败,并返回编辑 守护进程确认附件、 返回结果和完成、 流输出 和结构化的进展,广播会话信封, 推动迅速的背景, 代表们提示/管/壳逃出/编辑到原地表,并报告出错.
-   **信封** - 那个 `commandEnvelopeSchema` 验证 cumin 的 `CommandEnvelope` 在电线上; 一个编译时间的守护使这个计划与cumin的类型步入正轨,这样公布的合同永远不能默默地从代码产生的东西上漂出.
-   **边界验证** ——驳回结构性侵权行为;未知 _添加剂_ 字段是被容忍的,所以守护进程接受较新的未成年人的扩展而不理解它们。 解说不掷.
-   **版本** - 合同版本(`CONTRACT_VERSION`)在附着的握手中被携带,并因不匹配而被拒绝;在一大项中,更改仅是添加剂.

```ts
import { clientMessage_parseJson, attach_parse, type ClientMessage } from '@fnndsc/calypso';

const parsed = clientMessage_parseJson(rawSocketText);
if (!parsed.ok) socket.send({ type: 'error', reason: parsed.error });
```

## 状态

会话主机已运出 。 0.4版本添加了身份键本地泊位,所以 OS 账户可以为多个 CUBE 身份运行孤立守护进程; ChELL 解析 明确或带有拾取器。 守护进程模式温暖并报告共享 在发布其监听泊位前启动缓存 。 整个建筑和 最终的自然语言层——只可能 _提议_ 命令 用于校验和运行的确定性外壳在下列文件中有记载: [文件/calypso.adoc](https://npmcn.com/package/docs/calypso.adoc), (中文(简体) ), [文件/会议-主管.adoc](https://npmcn.com/package/docs/session-supervisor.adoc),以及 [文件/表层.adoc](https://npmcn.com/package/docs/surfaces.adoc)。 。 。 .

## 常见问题

### @fnndsc/calypso 是什么？

CALYPSO: ChrIS会话守护进程 – 在一个 WebSocket 上为附着的表面主持一个 brasa 引擎

### 如何安装 @fnndsc/calypso？

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

### @fnndsc/calypso 支持 TypeScript 吗？

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

### @fnndsc/calypso 支持 ESM 还是 CommonJS？

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

### @fnndsc/calypso 可以商用吗？

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

### @fnndsc/calypso 的下载量有多少？

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

### @fnndsc/calypso 还在维护吗？

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