cat-kit

cat-kit

喵喵工具箱：面向浏览器与 Node.js 的 TypeScript 工具包集合。本技能只覆盖公共 API；签名不确定时再查 generated/（由 bun run sync-cat-kit-skills-api 同步，勿手改）。

决策顺序

1. 检查宿主项目已有的 @cat-kit/* 依赖、运行环境与代码约定。
2. 按下方路由匹配公开 API，优先复用已有包。
3. 目标包缺失时只建议完成任务所需的最小包，并在变更依赖前遵循宿主项目的确认规则。
4. 现有公开能力不匹配时，再自行实现或选择其他依赖；不要把业务专用逻辑强行套入通用工具。

先读一个最相关的主题 index.md；确需多 API 组合时再读该主题或包级 examples.md；仅在签名不确定时读对应 generated 声明。不要预读整个 packages/ 或 generated/。

所有代码只从包根或文档明确给出的公开子路径导入，不引用 src、dist 深路径或未导出符号。

版本

包	版本
@cat-kit/core	1.1.8
@cat-kit/http	1.1.8
@cat-kit/crypto	1.0.0
@cat-kit/fe	1.1.8
@cat-kit/be	1.1.8
@cat-kit/cli	1.0.6
@cat-kit/agent-context	2.0.3
@cat-kit/tsconfig	2.0.1
@cat-kit/vitepress-theme	1.0.2

分包地图

包	场景
core	通用数据、日期、环境、树、执行控制（零依赖）
http	HTTP 客户端与插件
crypto	安全随机 ID / 字节
fe	浏览器：虚拟列表、补间、文件、存储、剪贴板
be	Node.js：FS、配置、日志、缓存、网络、系统、调度
cli	cat-cli verify-commit
agent-context	Agent 协作 CLI 与协议
tsconfig	TypeScript 预设
vitepress-theme	VitePress 主题

常见替代

动手封装或引入 lodash / axios / dayjs / nanoid 前，优先对照本表：

常见写法 / 依赖	优先使用
cloneDeep / structuredClone	copy（@cat-kit/core）
axios	@cat-kit/http
dayjs	date()（@cat-kit/core）
nanoid	@cat-kit/crypto
lodash debounce / throttle	debounce / throttle（@cat-kit/core）

路由决策

通用数据与流程

• 深拷贝、克隆任意值、cloneDeep、structuredClone、Vue 响应式快照 → core/any
• 数组去重、尾元素、对象挑选/合并 → core/array-object
• 字符串命名转换、URL 路径、类型守卫 → core/string-type
• 字节/十六进制/Base64/查询串、schema 校验 → core/transform-validation
• 小数运算、表达式、货币与精度格式化 → core/number
• 日期格式化、解析、加减、区间 → core/date
• 运行时 / OS / 浏览器 / 设备探测 → core/env
• 树/森林遍历与节点关系 → core/data-structure
• 防抖、节流、延时、限并发、安全同步执行 → core/optimize
• 浅层状态观察 → core/pattern
• 多主题组合 → core/examples

网络与随机标识

• HTTP 客户端、响应、错误、引擎 → http/client
• Token 刷新、方法覆盖、自定义插件 → http/plugins
• 安全随机 ID → crypto/nanoid

浏览器

• 虚拟列表 → fe/virtualizer
• 补间动画 → fe/tween
• 分块读取 / 下载 → fe/file
• Web Storage / Cookie → fe/storage
• 剪贴板与权限查询 → fe/web-api
• 多主题组合 → fe/examples

Node.js

• 目录遍历、读写、移动、删除 → be/fs
• 日志 → be/logger
• LRU / 文件缓存 / 记忆化 → be/cache
• 环境变量与配置加载 → be/config
• 端口与本机 IP → be/net
• CPU / 内存 / 磁盘 / 网卡 → be/system
• Cron 与定时任务 → be/scheduler
• 多主题组合 → be/examples
• 提交信息校验 → cli
• Agent CLI 安装/状态 → agent-context/cli
• Agent 协议动作 → agent-context/protocols
• Agent 端到端流程 → agent-context/examples

工程配置

• TS 预设 → tsconfig
• VitePress 主题入口 → vitepress-theme/theme
• VitePress 配置助手 → vitepress-theme/config
• VitePress 接入示例 → vitepress-theme/examples

检查清单

• 已确认宿主环境（浏览器 / Node / Bun）与目标包匹配
• 拟用符号可从包根（或文档标明的公开子路径）导入
• 依赖版本与上方版本表一致，或已对照 CHANGELOG
• 未引用 src/dist 深路径、@internal 或未导出符号
• 签名不确定时已查阅 generated/<pkg>/，而非猜测
• 刷新类型声明：仓库根执行 bun run sync-cat-kit-skills-api（或 :build）