Night Market 技能 — 从 claude-night-market/leyline 移植而来。如需完整体验（含智能体、钩子与命令），请安装 Claude Code 插件。

目录

• 概述
• 适用场景
• 核心概念
• 配额阈值
• 配额类型
• 快速入门
• 检查配额状态
• 记录使用情况
• 执行前估算
• 集成模式
• 详细资源
• 退出条件

配额管理

概述

用于在限频服务中跟踪与强制执行资源配额的一系列模式。本技能为其他插件提供统一的配额处理基础设施。

适用场景

• 构建与限频 API 的集成
• 需要跨会话持续跟踪用量
• 希望在接近配额上限时实现优雅降级
• 需要在执行操作前进行成本估算

不适用场景

• 项目未采用 leyline 基础设施模式
• 简单脚本，无服务架构需求

核心概念

配额阈值

三级阈值体系，支持主动式配额管理：

配额类型

@dataclass
class QuotaConfig:
    requests_per_minute: int = 60
    requests_per_day: int = 1000
    tokens_per_minute: int = 100000
    tokens_per_day: int = 1000000

快速入门

检查配额状态

from leyline.quota_tracker import QuotaTracker

tracker = QuotaTracker(service="my-service")
status, warnings = tracker.get_quota_status()

if status == "CRITICAL":
    # 暂缓执行或切换至备用服务
    pass

记录使用情况

tracker.record_request(
    tokens=estimated_tokens,
    success=True,
    duration=elapsed_seconds
)

执行前估算

can_proceed, issues = tracker.can_handle_task(estimated_tokens)
if not can_proceed:
    print(f"配额问题：{issues}")

集成模式

其他插件通过以下方式引用本技能：

# 在你的技能 frontmatter 中
dependencies: [leyline:quota-management]

随后即可复用标准化模式：

1. 为你的服务初始化 QuotaTracker 实例
2. 在执行操作前检查配额状态
3. 在操作完成后记录实际用量
4. 对各阈值级别的告警做出恰当响应

详细资源

• 阈值策略：参阅 modules/threshold-strategies.md 获取降级策略说明
• 估算模式：参阅 modules/estimation-patterns.md 获取 token/成本估算方法

退出条件

• 操作前已完成配额状态检查
• 操作后已准确记录用量
• 各阈值级别的告警均已按规范处理