指南总览

CatKit 是一组按运行环境和能力拆分的 TypeScript 工具包。阅读顺序建议是：先在本页定位包，再进入对应包入口页，最后去具体功能页查 API 与示例。

如何使用这份文档

• 不确定装什么：先看本页的“包总览”和“按场景找包”
• 已经知道包名：直接进入对应包入口页
• 已经知道具体能力：进入包入口页后，继续看该包下的功能页
• 只想先安装：跳到 安装

安装

最小安装通常从 @cat-kit/core 开始：

bun

bun add @cat-kit/core

pnpm

pnpm add @cat-kit/core

npm

npm install @cat-kit/core

如果你会直接导入多个包，就把这些包一起安装。完整安装方式、ESM 要求和验证步骤见 安装。

包总览

包	主要用途	适用环境	入口页
@cat-kit/core	数据处理、日期、环境检测、性能优化、设计模式	Browser / Node.js / Bun	Core 核心包
@cat-kit/http	HTTP 客户端、插件扩展、请求类型系统	Browser	HTTP 请求包
@cat-kit/fe	浏览器存储、文件处理、Web API、虚拟化	Browser	FE 前端工具包
@cat-kit/be	文件系统、配置、日志、缓存、网络、系统、调度	Node.js / Bun	BE 后端工具包
@cat-kit/excel	xlsx 读写、流式解析、地址和日期工具	Browser / Node.js / Bun	Excel 表格包
@cat-kit/maintenance	monorepo 依赖、版本、构建、发布维护	Node.js	Maintenance 维护工具包
@cat-kit/agent-context	为 AI 编程助手安装统一的协作工作流	Node.js	Agent Context

按场景找包

你的任务	推荐包	继续阅读
通用工具函数、日期处理、数据结构	@cat-kit/core	数据处理 / 日期处理
浏览器里发请求、做鉴权或插件扩展	@cat-kit/http	HTTP 客户端 / 插件系统
浏览器存储、下载上传、文件读取、剪贴板、权限	@cat-kit/fe	存储 / 文件操作 / Web API
Node/Bun 侧文件、配置、日志、缓存、任务调度	@cat-kit/be	文件系统 / 配置管理 / 日志系统
Excel 导入导出、流式解析、大文件读写	@cat-kit/excel	工作簿模型 / 读写与流式解析
monorepo 依赖分析、版本递增、构建与发布	@cat-kit/maintenance	Monorepo 管理 / 版本管理 / 构建工具
让多个 AI 助手围绕同一份计划协作	@cat-kit/agent-context	Action 说明 / CLI 命令

AI 导航索引

这一节是给 AI 助手和全文检索用的稳定入口。优先按“任务关键词 -> 包 -> 页面”定位，再进入具体 API 页面。

任务或关键词	推荐包	入口页	继续阅读	检索关键词
数组、对象、字符串、日期、比较、格式化、环境检测	@cat-kit/core	Core 核心包	数据处理 / 日期处理 / 环境检测	core data date env pattern optimize
request、client、plugin、token、method override、types	@cat-kit/http	HTTP 请求包	HTTP 客户端 / 插件系统 / 类型定义	http client plugins token types
storage、localStorage、sessionStorage、cookie、file、save、read、clipboard、permission、virtualizer	@cat-kit/fe	FE 前端工具包	存储 / 文件操作 / Web API / 虚拟化	fe storage file web api virtualizer
fs、config、logger、cache、net、system、scheduler	@cat-kit/be	BE 后端工具包	文件系统 / 配置管理 / 日志系统 / 任务调度	be fs config logger cache net system scheduler
excel、xlsx、workbook、worksheet、stream、address、date serial	@cat-kit/excel	Excel 表格包	工作簿模型 / 读写与流式解析 / 地址与日期工具	excel workbook read write stream tools
monorepo、workspace、deps、version、build、release	@cat-kit/maintenance	Maintenance 维护工具包	Monorepo 管理 / 依赖管理 / 版本管理 / 发布与 Git	maintenance monorepo deps version build release
agent、workflow、plan、replan、implement、patch、done、CLI	@cat-kit/agent-context	Agent Context	Action 说明 / AI 协作场景 / CLI 命令	agent-context workflow plan patch cli

LLM 检索约定

• 先问“这是哪个包的能力”，再问“这个包里的哪一页”
• 查概览时优先看本页；查包边界时优先看各包 index.md
• 查 API、参数、返回值时进入对应功能页，不要停留在总览页
• 先根据运行环境筛选：
  • Browser：优先看 http、fe
  • Node.js / Bun：优先看 be、maintenance、agent-context
  • 全环境通用：优先看 core、excel
• 若任务同时涉及基础能力和环境能力，通常先查 core，再查环境包
• 推荐检索短语：
  • cat-kit core date
  • cat-kit http plugins
  • cat-kit fe storage
  • cat-kit be config
  • cat-kit excel stream
  • cat-kit maintenance version
  • cat-kit agent-context cli

下一步

• 安装
• Core 核心包
• HTTP 请求包
• FE 前端工具包
• BE 后端工具包
• Excel 表格包
• Maintenance 维护工具包
• Agent Context