@fnndsc/menu

中文文档
0.41.2发布于 2026/11/15MITTypeScriptES Module近 30 天下载 8343

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

中文使用文档
文档目录4 节
  1. 里面有什么东西
  2. 为什么它是自己的包
  3. 这里的规则
  4. 另见

@ fnndsc/菜单

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

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

里面有什么东西

模块目录
envelope.tsCommandEnvelope 及其部分——状态,打入的模型槽,错误堆栈,分辨率跟踪
messages.ts会话协议: 附加、 执行、 完整、 输出、 进步、 及时、 管道、 shell、 编辑
validate.ts解析从未抛出过的边界——a ParseResult,所以打电话者可以回答而不是崩溃
version.tsCONTRACT_VERSION 及其精确的主要兼容规则
progress.ts结构化进展词汇
proc.ts快速显示进程- 索引状态
listing.tsListingItem 及其计划——一个上市条目,开放 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 共发布 48 个版本,首次发布于 2026/09/05;过去 12 个月发布了 48 个版本。

版本发布日期距今
0.41.2latest2026/11/151 天前
0.41.12026/11/141 天前
0.41.02026/11/105 天前
0.40.02026/11/087 天前
0.39.02026/11/088 天前
0.38.02026/11/069 天前

关于 @fnndsc/menu 的常见问题

@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 和提交记录判断。