npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@qilin-agent/package-manifest

v3.1.11

Published

Shared type declarations for package.json.qilin configuration fields

Readme


description: "包身份、运行时要求和 DSH 插件元数据的共享 TypeScript 声明。" kind: "package-library"

@qilin-agent/package-manifest

English | 中文

概述

使用 QilinPackageManifest 描述包元数据、QilinManifest 描述 qilin 下的公共字段,以及 QilinClientManifest 等成员类型描述单个领域。各读取方负责 JSON 解析、校验和默认值解析。

目录


使用本包

从包根导入类型。仅检查自己的源码时使用开发依赖;若发布的声明文件引用这些类型,则使用生产依赖。

import type { QilinClientManifest, QilinPackageManifest } from '@qilin-agent/package-manifest'

const client: QilinClientManifest = { platform: 'web' }
const manifest: QilinPackageManifest = {
  name: 'example-qilin-plugin',
  version: '1.0.0',
  engines: { node: '>=24', qilin: '0.1.5-alpha.1' },
  qilin: {
    manifestVersion: 1,
    bundle: { patch: './cordis.patch.yml' },
    client,
  },
}

QilinPackageManifest 描述 DSH 使用的 package.json 字段,其中 name 和 version 必填;它不是完整的 npm schema(模式)。本地 profile 读取方使用 Partial<QilinPackageManifest>,因为 profile 无需发布版本。QilinManifest 仅描述 qilin 下的公共作者字段。TypeScript 检查示例并删除 import type;这些接口不解析 JSON,也不写入文件。

以下元数据字段均可选。省略时,格式版本或兼容的宿主版本保持未声明状态;读取方不推断默认值。

| 字段 | 含义 | |---|---| | qilin.manifestVersion | manifest(元数据清单)格式标识;声明的格式为 1,独立于 npm 包版本和 Session 格式版本。 | | engines.qilin | 作者声明的兼容 DSH 版本,使用 SemVer 范围,也可填写精确的预发布版本。此字段与 engines.node、engines.npm 并列;engines 对象可省略 qilin。 |

公共组合声明定义在 src/types.ts 中。内部 configTrees、sessionFormatMigration 和生成的 moduleFallback 元数据分别由镜像打包器、目录生成器和启动器读取方拥有;公共类型不暴露这些字段。


理解实现

包根仅重新导出 src/types.ts 中的声明。


进一步探索

模型体验

无,因为本包仅导出类型。

KV Cache 影响

类型声明不增加模型输入,因此不影响提供方的缓存复用。

已知限制与后续工作

  • 仅提供静态类型。 消费方读取并校验所需的 JSON 字段,再将共享声明适配为运行时数据。本包不提供解析器、getter helper、文件检查或默认值。
  • 兼容性仅作声明。 当前安装器和加载器不强制检查 qilin.manifestVersion 或 engines.qilin;声明范围不会拒绝不兼容的宿主,也不会校验 SemVer 语法。

开发备注

无。