用途：Endpoints 是文档管理 API 工具包，通过 AI 抽取把文本或文件中的信息整理成结构化数据，并按分类组织到端点（endpoint）中，用于跟踪联系人、票据、会议记录等。
主要能力：提供高层函数 listEndpoints 列出分类与端点树、getEndpoint 获取端点详情（含历史与最新条目）、scanText 和 scanFile 用 AI 扫描文本或文件并抽取实体与端点路径、createEndpoint 创建端点、deleteEndpoint 删除端点及其文件、deleteItem 按 8 位 ID 删除条目、getFileUrl 获取文件预签名链接、getStats 查询解析量、存储与套餐用量。
使用方式：在 scripts 目录执行 npm install 安装依赖；在项目根目录创建 .env，设置 ENDPOINTS_API_URL=https://endpoints.work 与 ENDPOINTS_API_KEY=ep_your_api_key_here（密钥在 API Keys 页面生成）。函数可从 scripts/src/index.ts 导入，例如 import { listEndpoints, scanText, getStats } from './scripts/src/index.js';，也可用 npx tsx scripts/src/index.ts 直接运行。每次分析分三阶段：调用 API 获取结构化数据、结果自动保存为 JSON 到 results/{category}/（命名结果存为 {sanitized_name}.json，自动生成存为 YYYYMMDD_HHMMSS__{operation}.json）、再读取保存的 JSON 生成 results/summaries/ 下的 markdown 摘要。
数据模型：采用 Living JSON 模式记录文档历史，包含 endpoint 路径、分类、slug 以及 metadata.oldMetadata 与 metadata.newMetadata；每个条目含 8 位 ID、AI 摘要 summary、抽取实体 entities、文件 S3 路径、MIME 类型与原始文本。
限制：需要 Endpoints 账号与 API Key；错误码包括 401 密钥无效或缺失、404 未找到端点或条目、409 端点已存在、429 用量超限。更细粒度的参数与类型参见 references/api-reference.md。其余平台或价格信息暂未提供。