# @fnndsc/menu 中文文档

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

版本：0\.41\.2
npm 元数据更新时间：2026-11-14T19:18:01.004Z
中文译文更新时间：2026-11-15T03:33:21.511Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：602 kB，89 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-09-05T12:54:43.148Z
- 最新版本发布：2026-11-14T19:18:00.852Z
- 近 30 天下载量：8343（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：48（近 12 个月 48 个）

## 中文简介

薄电线合同:信封、会话协议和表面和内核都说话的结果模型计划

## 安装

```sh
npm install @fnndsc/menu
```

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

## README

# @ fnndsc/菜单

密电合同:命令返回什么,会话交换什么 词典都狭窄到.

菜单上写着可以订购的东西和到达的东西 一个表面可以要求 上面的东西 上面的东西 上面的东西 上面的东西 建筑师声称 软件包的存在是为了制造结构:内核和内核之外不存在任何能力 钢丝,而每个表面 都可以随意编曲和呈现 这条线.

## 里面有什么东西

| 模块 | 目录 |
| --- | --- |
| `envelope.ts` | `CommandEnvelope` 及其部分——状态,打入的模型槽,错误堆栈,分辨率跟踪 |
| `messages.ts` | 会话协议: 附加、 执行、 完整、 输出、 进步、 及时、 管道、 shell、 编辑 |
| `validate.ts` | 解析从未抛出过的边界——a `ParseResult`,所以打电话者可以回答而不是崩溃 |
| `version.ts` | `CONTRACT_VERSION` 及其精确的主要兼容规则 |
| `progress.ts` | 结构化进展词汇 |
| `proc.ts` | 快速显示进程- 索引状态 |
| `listing.ts` | `ListingItem` 及其计划——一个上市条目,开放 `type` 所以后端可以列出自己的类型 |
| `surface.ts` (传教士) `@fnndsc/menu/surface`(中文(简体) ) | 发动机与它运行地点的合同: `OutputSink` (输出去的地方)和 `Surface` 以它的能力,提示,编辑和交付. 子路径,所以浏览器捆绑 永远不会遇到节点 `Buffer` |

## 为什么它是自己的包

表面作者取决于合同,而不是发生在 服务它。 在这个包裹之前,合同是 `@fnndsc/calypso`, (中文(简体) ), 这意味着第三方表面依赖会议主办方 学习结果的形状.

它没有从堆栈里进口任何东西 `zod` 没有别的了,坐在下面 `cumin`,因此生成信封的引擎和使 他们可以装上它.

## 这里的规则

**开放世界.** 一个信封 `model.kind` 是自由字符串:表面窄 它认识并回到 `rendered` 剩下的钱 未知的词源 数值降解而不是拒绝——未知进度操作读作 `task`,未知的阶段为 `working` - 因为丢掉的信息是无形的 通用指标不是.

**从不 `.strict()`。 。 。 .** 一个平地 `z.object()` 条形键未知, 所以是一个字段 由更新的对等者添加的被忽略而不是致命. `.strict()` 看起来像 严谨且是相容性的断开.

**一艘有后退的新船.** `safeParse` 整个消息失败 一个未知值。 当你在铁丝网上加注时,给它一个 `.catch()` 内 同样的变化,如果它没有.

**类型是推断的,从未申报过两次.** 有效载荷类型来自 `z.infer<typeof schema>`信封和电线曾经分开 由汇编时间断言合并保存的声明;一种推断类型 漂移是不可能的 而不是检测.

## 另见

-   `docs/menu.adoc` - 设计记录和计划 这个软件包是..
-   `docs/principles.adoc` ——规范架构
-   `docs/structured-progress.md` - 详细进度合同

## 常见问题

### @fnndsc/menu 是什么？

薄电线合同:信封、会话协议和表面和内核都说话的结果模型计划

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

在项目目录运行 npm install @fnndsc/menu，或使用 pnpm add / yarn add / bun add。

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

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

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

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

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

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

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

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

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

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