核心功能: 本技能提供结构化的工作流程和配置指引等能力。
Token经济学家(专业版)
全功能Token优化系统。向量缓存+成本预估+预算控制+多模型路由,从个人节省走向团队级成本治理。
永远不超预算。永远不丢关键上下文。永远用最合适的模型. Token经济学家专业版在免费版基础上解锁多级向量语义缓存、Token成本预估与预算控制、团队成本分析、LLM智能摘要、缓存命中率优化与多模型智能路由,覆盖从个人到团队的完整Token治理需求.
架构总览
输入格式
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | Token经济学家(专业版)处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |
┌─────────────────────────────────────────────────────────────────┐
│ Token经济学家专业版 (PRO) │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ 上下文压缩 │ │ 语义缓存 │ │ 自适应优化 │ │
│ │ (免费版) │ │ L1-L3 │ │ (免费版) │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ 质量守卫 │ │ 自然语言 │ │ 斜杠命令 │ │
│ │ (免费版) │ │ (免费版) │ │ (免费版) │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
│ ┌─────────────────────────────────────────────┐ │
│ │ 专业版新增功能 │ │
│ ├─────────────────────────────────────────────┤ │
│ │ │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │
│ │ │ L4向量 │ │ 成本预估 │ │ 预算控制 │ │ │
│ │ │ 语义缓存 │ │ 实时+月度│ │ 告警+熔断│ │ │
│ │ │ 跨会话 │ │ │ │ │ │ │
│ │ └──────────┘ └──────────┘ └──────────┘ │ │
│ │ │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │
│ │ │ 团队成本 │ │ LLM智能 │ │ 缓存命中 │ │ │
│ │ │ 分析 │ │ 摘要 │ │ 率优化 │ │ │
│ │ │ 多用户 │ │ 上下文图 │ │ 预热+淘汰 │ │ │
│ │ └──────────┘ └──────────┘ └──────────┘ │ │
│ │ │ │
│ │ ┌──────────┐ ┌──────────┐ │ │
│ │ │ 多模型 │ │ 多角色 │ │ │
│ │ │ 路由 │ │ 场景指南 │ │ │
│ │ │ GPT-4o/ │ │ 5类角色 │ │ │
│ │ │ mini │ │ │ │ │
│ │ └──────────┘ └──────────┘ │ │
│ │ │ │
│ └─────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
快速开始
60秒上手:查看成本概览
用户:"成本概览" / "本月Token花费"
Agent:
💰 Token成本概览
━━━━━━━━━━━━━━━━━━━━
本月(2026-07):
• 原始成本:$12.50
• 优化后成本:$4.38
• 已节省:$8.12(65%)
• 预算使用:44%(预算$10/月)
# ..
团队成本TOP3:
1. 用户A:$1.82(节省68%)
2. 用户B:$1.45(节省62%)
3. 用户C:$1.11(节省71%)
# ..
预测:按当前趋势,本月预计花费$9.95(不超预算)
120秒上手:配置预算控制
// ~/.token-economist/config.json
{
"edition": "pro",
"budget": {
"monthly": 10.00,
"daily": 0.50,
"alertThreshold": 0.8,
"circuitBreaker": 1.0
},
"routing": {
"enabled": true,
"defaultModel": "gpt-4o-mini",
"complexModel": "gpt-4o",
"complexityThreshold": 0.7
},
"cache": {
"L4_vector": true,
"crossSession": true,
"prewarm": true
}
}
300秒上手:团队配置
{
"team": {
"name": "工程团队",
"members": ["user_a", "user_b", "user_c"],
"budgetAllocation": {
"user_a": 0.4,
"user_b": 0.35,
"user_c": 0.25
},
"sharedCache": true,
"reportFrequency": "weekly"
}
}
响应解析: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤.
核心能力
功能1:L4向量语义缓存(专业版)
免费版L1-L3缓存基于关键词与模式匹配,专业版新增L4向量语义缓存:
# L4向量语义缓存实现
from sentence_transformers import SentenceTransformer
import numpy as np
from sklearn.metrics.pairwise import cosine_similarity
# ..
class VectorSemanticCache:
def __init__(self):
self.model = SentenceTransformer('all-MiniLM-L6-v2')
self.cache = {} # {id: {'query': str, 'embedding': np.array, 'response': str, 'timestamp': float}}
# ..
def get(self, query, threshold=0.85):
query_emb = self.model.encode([query])[0]
best_score = 0
best_id = None
for cid, item in self.cache.items():
score = cosine_similarity([query_emb], [item['embedding']])[0][0]
if score > best_score:
best_score = score
best_id = cid
if best_score >= threshold:
return self.cache[best_id]['response'], best_score
return None, best_score
# ..
def set(self, query, response):
emb = self.model.encode([query])[0]
cid = hash(query)
self.cache[cid] = {
'query': query,
'embedding': emb,
'response': response,
'timestamp': time.time()
}
L4优势:
- 跨会话缓存:不同会话中的相似问题可复用
- 语义理解:即使用词完全不同,语义相同即可命中
- 自适应阈值:根据任务类型动态调整相似度阈值
四级缓存对比:
| 层级 | 匹配方式 | 节省率 | 跨会话 | 示例 |
|---|---|---|---|---|
| L1 | 精确匹配 | 100% | 否 | 完全相同的问题 |
| L2 | 语义相似>85% | 80% | 否 | 用词不同但意思相同 |
| L3 | 模式匹配 | 50% | 否 | 同类操作(读文件↔写文件) |
| L4 | 向量语义 | 90% | 是 | "如何部署应用" ↔ "上线流程是什么" |
功能2:Token成本预估(专业版)
执行功能2:Token成本预估(专业版)操作,使用input_params参数进行配置,支持创建/查询/导出等操作.
# 实时成本预估
class TokenCostEstimator:
def __init__(self):
self.pricing = {
'gpt-4o': {'input': 0.000005, 'output': 0.000015}, # per token
'gpt-4o-mini': {'input': 0.00000015, 'output': 0.0000006},
}
# ..
def estimate(self, input_tokens, output_tokens, model='gpt-4o-mini'):
cost = (input_tokens * self.pricing[model]['input'] +
output_tokens * self.pricing[model]['output'])
return cost
# ..
def monthly_projection(self, daily_avg_cost, days_remaining):
return daily_avg_cost * days_remaining
# ..
# 使用示例
estimator = TokenCostEstimator()
daily_cost = estimator.estimate(50000, 15000) # 每日Token
monthly_projection = estimator.monthly_projection(daily_cost, 30)
print(f"月度预估成本:${monthly_projection:.2f}")
成本预估报告:
📊 Token成本预估报告
━━━━━━━━━━━━━━━━━━━━
今日:
• 输入Token:52,000
• 输出Token:18,500
• 原始成本:$0.36
• 优化后成本:$0.13(节省64%)
# ..
本月预估:
• 剩余天数:13天
• 日均成本:$0.13
• 预估总成本:$1.69 + 已花费$2.69 = $4.38
• 预算:$10.00
• 预算使用率:44%
# ..
建议:
• 当前趋势良好,不超预算
• 可考虑对高频用户启用更激进的压缩
功能3:预算控制(专业版)
执行功能3:预算控制(专业版)操作,使用input_params参数进行配置,支持创建/查询/导出等操作.
# 预算控制器
class BudgetController:
def __init__(self, monthly_budget, daily_budget):
self.monthly_budget = monthly_budget
self.daily_budget = daily_budget
self.alert_threshold = 0.8
self.circuit_breaker = 1.0
# ..
def check(self, current_spend, period='monthly'):
budget = self.monthly_budget if period == 'monthly' else self.daily_budget
usage_rate = current_spend / budget
# ..
if usage_rate >= self.circuit_breaker:
return {
'action': 'circuit_break',
'message': f'{period}预算已用尽({usage_rate:.0%}),熔断触发',
'fallback_model': 'gpt-4o-mini' # 降级到低成本模型
}
elif usage_rate >= self.alert_threshold:
return {
'action': 'alert',
'message': f'{period}预算使用{usage_rate:.0%},接近上限',
'suggestion': '建议启用更激进的压缩策略'
}
return {'action': 'normal'}
预算告警示例:
⚠️ 预算告警
━━━━━━━━━━━━━━━━━━━━
月度预算使用:85%($8.50/$10.00)
剩余预算:$1.50
剩余天数:8天
日均可用:$0.19(当前日均$0.28)
# ..
建议操作:
1. 启用激进压缩模式(预计节省+15%)
2. 对非关键任务降级到GPT-4o-mini
3. 禁用L4向量缓存预加载(减少API调用)
# ..
[一键应用建议] [忽略]
熔断机制:
🚫 预算熔断
━━━━━━━━━━━━━━━━━━━━
月度预算已用尽(100%)
自动执行:
• 模型降级:GPT-4o → GPT-4o-mini
• 压缩升级:均衡 → 激进
• 缓存预加载:禁用
• L4跨会话缓存:保留(不消耗新Token)
# ..
如需继续使用GPT-4o,请:
1. 调整月度预算
2. 或等待下月重置
功能4:团队成本分析(专业版)
执行功能4:团队成本分析(专业版)操作,使用input_params参数进行配置,支持创建/查询/导出等操作.
👥 团队成本报告 - 2026年7月(第3周)
━━━━━━━━━━━━━━━━━━━━
# ..
团队总览:
• 成员数:5人
• 总成本:$4.38(节省$8.12,65%)
• 人均成本:$0.88
# ..
成员明细:
| 成员 | 原始成本 | 优化后 | 节省率 | 缓存命中 | 预算使用 |
|---:|---:|---:|---:|---:|---:|
| 用户A | $2.80 | $1.82 | 35% | 12 | 73% |
| 用户B | $2.20 | $1.45 | 34% | 8 | 58% |
| 用户C | $1.55 | $1.11 | 28% | 15 | 89% ⚠️ |
| 用户D | $1.20 | $0.72 | 40% | 20 | 48% |
| 用户E | $0.95 | $0.58 | 39% | 6 | 39% |
# ..
异常分析:
• 用户C节省率最低(28%):主要使用代码审查场景(代码不压缩)
• 用户C预算使用89%:建议启用激进模式
• 用户D缓存命中率最高(20次):查询模式重复度高
# ..
优化建议:
1. 用户C:启用激进压缩,预计节省+15%
2. 用户A:查询模式分析,可提升缓存命中率
3. 全员:推广用户D的查询习惯(结构化提问)
功能5:LLM智能摘要(专业版)
执行功能5:LLM智能摘要(专业版)操作,使用input_params参数进行配置,支持创建/查询/导出等操作.
免费版基于规则摘要,专业版使用LLM进行智能摘要:
# LLM驱动的上下文图压缩
class LLMContextCompressor:
def __init__(self, llm_client):
self.llm = llm_client
# ..
def compress(self, messages):
# 1. 构建上下文图(消息间引用关系)
graph = self.build_context_graph(messages)
# ..
# 2. 识别关键节点(高引用、含决策、含代码)
key_nodes = self.identify_key_nodes(graph)
# ..
# 3. 按主题聚类
clusters = self.cluster_by_topic(messages)
# ..
# 4. LLM摘要每个聚类
summaries = []
for cluster in clusters:
summary = self.llm.summarize(
cluster,
instruction="保留:决策、代码引用、关键结论。压缩:重复讨论、过程性对话"
)
summaries.append(summary)
# ..
# 5. 保留关键节点 + 聚类摘要
compressed = key_nodes + summaries
return compressed
上下文图压缩示例:
原始(15轮讨论,9,200 Token):
[1]-[3] Python文件操作基础
[4]-[6] 编码问题讨论(引用[1]-[3])
[7]-[9] 大文件处理(引用[1]-[3])
[10]-[12] 性能优化(引用[7]-[9])
[13]-[15] 错误处理(引用[1]-[3])
# ..
压缩后(2,800 Token,节省70%):
[摘要-1] Python文件操作基础:open()/read()/write(),'a'追加模式
[摘要-2] 编码问题:指定encoding='utf-8',处理UnicodeDecodeError
[摘要-3] 大文件处理:逐行读取,with语句,生成器
[保留] [10]-[12] 性能优化(关键决策)
[保留] [13]-[15] 错误处理(最近讨论)
[代码块] 全部保留
功能6:多模型智能路由(专业版)
# 多模型路由器
class ModelRouter:
def __init__(self):
self.complexity_threshold = 0.7
self.models = {
'simple': 'gpt-4o-mini', # 简单任务
'complex': 'gpt-4o', # 复杂任务
}
# ..
def route(self, query, context_complexity):
# 评估任务复杂度
complexity = self.assess_complexity(query, context_complexity)
# ..
if complexity >= self.complexity_threshold:
return self.models['simple']
# ..
def assess_complexity(self, query, context):
score = 0
# 代码生成/调试:高复杂度
if any(kw in query for kw in ['实现', '调试', '架构', '重构']):
score += 0.3
# 长上下文:高复杂度
if len(context) > 5000:
# 多步骤推理:高复杂度
if any(kw in query for kw in ['分析', '对比', '设计', '优化']):
# 简单查询:低复杂度
if any(kw in query for kw in ['什么是', '列表', '定义']):
score -= 0.2
return max(0, min(1, score + 0.5))
路由决策示例:
查询:"什么是REST API?" → 复杂度0.3 → GPT-4o-mini(节省成本)
查询:"设计一个高并发的微服务架构" → 复杂度0.9 → GPT-4o(质量优先)
查询:"这段代码有什么bug?" → 复杂度0.7 → GPT-4o(调试需精度)
查询:"列出Python的数据类型" → 复杂度0.2 → GPT-4o-mini(简单查询)
成本对比:
| 模型 | 输入成本 | 输出成本 | 适用场景 |
|---|---|---|---|
| GPT-4o | $5/1M | $15/1M | 复杂推理、代码生成、架构设计 |
| GPT-4o-mini | $0.15/1M | $0.60/1M | 简单查询、列表、定义 |
智能路由可节省60-80%成本(简单任务用mini,复杂任务用4o).
能力覆盖范围:本skill的核心能力覆盖以下场景关键词:Agent、全功能、优化系统、含多级向量缓存、团队分析与多模型、经济学家、在免费版基础上解、锁多级向量语义缓、成本预估与月度预、的智能摘要与上下、缓存命中率优化、多模型智能路由等、高级能力等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.
多角色场景指南
角色一:个人开发者
典型场景:长编程会话Token优化. 推荐配置:激进压缩 + L4向量缓存 + 多模型路由
{
"mode": "aggressive",
"cache": {"L4_vector": true, "crossSession": true},
"routing": {"enabled": true}
}
预期效果:节省70-80%,代码零损失,跨会话复用历史解答.
角色二:团队负责人
典型场景:团队API成本治理与预算控制. 推荐配置:预算控制 + 团队分析 + 激进模式
{
"budget": {"monthly": 50.00, "alertThreshold": 0.8},
"team": {"sharedCache": true, "reportFrequency": "weekly"}
}
预期效果:团队成本可视化,预算超支预警,成员间缓存共享.
角色三:企业架构师
典型场景:大规模Agent部署的成本治理. 推荐配置:多模型路由 + 熔断机制 + LLM智能摘要
{
"routing": {"complexityThreshold": 0.6},
"budget": {"circuitBreaker": 1.0, "fallbackModel": "gpt-4o-mini"}
}
预期效果:自动降级保护预算,复杂任务质量优先,简单任务成本优先.
角色四:数据分析师
典型场景:重复查询场景的缓存优化. 推荐配置:L4向量缓存 + 缓存预热 + 命中率优化
{
"cache": {
"L4_vector": true,
"prewarm": true,
"hitRateOptimization": true
}
}
预期效果:相似查询90%命中缓存,响应速度提升10倍.
角色五:产品经理
典型场景:成本报告与决策支持. 推荐配置:团队分析 + 月度报告 + 成本预估
{
"team": {"reportFrequency": "monthly"},
"costEstimation": {"enabled": true, "trendAnalysis": true}
}
预期效果:月度成本报告,趋势预测,预算规划依据.
多角色场景对比表
| 角色 | 典型场景 | 推荐配置 | 核心价值 |
|---|---|---|---|
| 个人开发者 | 长编程会话 | 激进+L4+路由 | 70-80%节省,代码零损失 |
| 团队负责人 | 团队成本治理 | 预算+分析+激进 | 成本可视化,预算预警 |
| 企业架构师 | 大规模部署 | 路由+熔断+摘要 | 自动降级,质量优先 |
| 数据分析师 | 重复查询 | L4+预热+命中率 | 90%缓存命中,10倍响应 |
| 产品经理 | 成本报告 | 分析+月报+预估 | 趋势预测,预算规划 |
性能优化策略
缓存命中率优化
- 缓存预热:对高频查询预先生成缓存
- 淘汰策略:LRU+访问频率混合淘汰
- 命中率分析:识别低命中率场景,优化缓存策略
- 分级存储:L1内存、L2持久化、L3向量数据库
成本控制优化
- 模型路由:简单任务用mini,复杂任务用4o
- 压缩策略:按场景选择激进/均衡/质量模式
- 预算熔断:超预算自动降级
- 跨用户缓存共享:团队内复用缓存
压缩质量优化
- LLM智能摘要:基于上下文图的语义压缩
- 关键节点保留:高引用消息不压缩
- 质量回滚:质量下降>15%自动恢复
- 主题聚类:按主题分组摘要,保留逻辑连贯性
多平台集成示例
与监控系统集成
# Prometheus指标导出
from prometheus_client import Counter, Gauge
# ..
token_saved = Counter('token_economist_saved_total', 'Total tokens saved')
cache_hits = Counter('token_economist_cache_hits_total', 'Cache hits', ['level'])
cost_spent = Gauge('token_economist_cost_monthly', 'Monthly cost in USD')
budget_usage = Gauge('token_economist_budget_usage', 'Budget usage rate')
# ..
# 导出指标
token_saved.inc(saved_count)
cache_hits.labels(level='L4').inc(hit_count)
cost_spent.set(monthly_cost)
budget_usage.set(usage_rate)
与告警系统集成
# Slack告警
def send_budget_alert(usage_rate, remaining_budget):
if usage_rate >= 0.8:
slack_webhook.send({
"text": f"⚠️ Token预算告警:使用{usage_rate:.0%},剩余${remaining_budget:.2f}"
})
与CI/CD集成
# 在CI中检查Token成本
token-economist check-budget --threshold 0.9 || exit 1
# ..
# 部署前预估成本
token-economist estimate --query "production_queries.json"
版本升级迁移指南
从免费版升级至专业版
- 无需迁移数据:专业版完全兼容免费版的配置与缓存
- 新增功能激活:
- 启用L4向量缓存:安装
sentence-transformers - 启用预算控制:配置
~/.json - 启用多模型路由:配置模型API Key
- 启用L4向量缓存:安装
- 历史缓存导入:免费版的L1-L3缓存可直接复用
- 指令兼容:免费版的所有指令在专业版中均可使用
版本更新历史
| 版本 | 日期 | 变更内容 |
|---|---|---|
| 1.0.0 | 2026-07 | 初版发布,含L4缓存+成本预估+预算控制+团队分析+多模型路由 |
故障排查表
| 问题 | 可能原因 | 解决方案 | 优先级 |
|---|---|---|---|
| 缓存命中率低 | 查询模式多样或阈值过高 | 降低L2相似度阈值;启用L4向量缓存;分析miss模式 | 高 |
| 压缩后质量下降 | 激进模式或关键内容被压缩 | 切换均衡模式;检查质量守卫规则;启用质量回滚 | 高 |
| 预算超支 | 无预算控制或模型路由失效 | 启用预算熔断;检查多模型路由配置;启用激进压缩 | 高 |
| L4缓存延迟高 | 向量编码耗时 | 使用轻量嵌入模型;异步编码;缓存嵌入结果 | 中 |
| 团队报告不准 | 成员标识错误或数据延迟 | 检查成员配置;同步缓存数据;等待报告周期 | 中 |
| 模型路由判断错误 | 复杂度评估不准 | 调整复杂度阈值;添加领域关键词;手动标注训练 | 中 |
| 跨会话缓存失效 | 缓存键设计不合理或过期 | 检查缓存键策略;延长TTL;启用持久化缓存 | 中 |
| 成本预估偏差 | 日均消费波动大 | 使用加权平均;考虑工作日/休息日差异 | 低 |
| 熔断后无法恢复 | 预算周期未重置 | 检查预算重置日期;手动重置;等待下月 | 中 |
| LLM摘要质量差 | 摘要指令不清或上下文过长 | 优化摘要指令;分段摘要;保留关键节点 | 中 |
| 团队缓存冲突 | 多用户同时写缓存 | 启用缓存版本控制;冲突时以最新为准 | 低 |
| 预算告警频繁 | 阈值过低或消费波动 | 调整告警阈值至85%+;使用滑动窗口告警 | 低 |
即时修复清单
| 问题 | 修复方法 |
|---|---|
| Token消耗突增 | 检查是否启用激进模式;查看是否有长对话未压缩 |
| 缓存全miss | 检查缓存键策略;降低相似度阈值;启用L4向量缓存 |
| 预算即将超支 | 启用激进压缩;模型降级到mini;禁用缓存预热 |
| 代码被压缩 | 检查质量守卫规则;确保代码块识别正确 |
| 团队成本不均 | 分析成员查询模式;调整预算分配;推广高效查询习惯 |
| 路由总是选mini | 调低复杂度阈值;添加领域复杂关键词 |
| 路由总是选4o | 调高复杂度阈值;检查简单查询识别 |
| L4缓存占用大 | 设置缓存大小上限;启用LRU淘汰;定期清理 |
| 摘要丢失关键信息 | 启用关键节点保留;优化摘要指令;检查主题聚类 |
维护命令
# 查看完整成本报告
token-economist report --full
# ..
# 缓存命中率分析
token-economist cache --analyze --days 30
# ..
# 预算状态
token-economist budget --status
# ..
# 团队成本报告
token-economist team --report --period monthly
# ..
# 模型路由统计
token-economist routing --stats
# ..
# 清理过期缓存
token-economist cache --cleanup --older-than 7d
# ..
# 导出成本数据
token-economist export --format csv --period 2026-07
已知限制
- 本skill的能力范围受限于核心能力章节中定义的功能,不支持超出范围的操作
- 复杂业务场景建议结合人工经验判断
- 执行效率受模型能力与网络环境影响
错误处理
| 序号 | 错误场景 | 原因 | 处理方式 | 优先级 |
|---|---|---|---|---|
| 1 | 输入参数缺失 | 用户未提供必要参数 | 提示用户提供所需参数后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令 | P0 |
| 2 | 执行超时 | 处理时间过长 | 检查输入数据量,分批处理 | P1 |
| 3 | 输出格式错误 | 结果不符合预期格式 | 检查output_format参数配置 | P1 |
FAQ
Q1:免费版与专业版有什么区别?
免费版提供智能上下文压缩、L1-L3语义缓存、自适应优化、质量守卫、自然语言与斜杠命令。专业版解锁L4向量语义缓存(跨会话)、Token成本预估(实时+月度)、预算控制(告警+熔断)、团队成本分析、LLM智能摘要(上下文图压缩)、缓存命中率优化(预热+淘汰)、多模型智能路由(GPT-4o/mini按复杂度选择)、多角色场景指南、故障排查表.
Q2:L4向量缓存与L2语义缓存有什么区别?
L2基于关键词相似度(如Jaccard、编辑距离),需要部分用词相同。L4基于向量嵌入的语义相似度,即使用词完全不同,语义相同即可命中。例如"如何部署应用"和"上线流程是什么"在L2不会命中,但在L4会命中(语义相似度>85%)。L4还支持跨会话缓存.
Q3:多模型路由如何决定用哪个模型?
路由器评估任务复杂度(0-1分):代码生成/调试/架构设计+0.3,长上下文+0.2,多步骤推理+0.2,简单查询-0.2。分数>0.7用GPT-4o,否则用GPT-4o-mini。复杂度阈值可配置。这能节省60-80%成本(简单任务用便宜的mini).
Q4:预算熔断后还能用吗?
能。熔断后自动降级到GPT-4o-mini + 激进压缩,仍可继续使用,只是质量略降。L4跨会话缓存保留(不消耗新Token)。如需恢复GPT-4o,需调整预算或等待下月重置.
Q5:团队缓存共享会泄露隐私吗?
不会。团队共享的是查询-响应缓存,不含用户身份信息。缓存键基于查询内容的hash,不包含用户ID。可在config.json中关闭sharedCache,改为独立缓存.
Q6:LLM智能摘要会消耗额外Token吗?
会,但净收益为正。摘要消耗约500-1000 Token,但压缩后节省5000-10000 Token。净节省80-90%。摘要操作可配置为异步执行,不阻塞主对话.
Q7:缓存预热是什么?有必要吗?
缓存预热是预先对高频查询生成并缓存响应。适用于可预测的高频场景(如API文档查询、FAQ)。预热在低峰期执行,避免高峰期缓存miss导致的重复计算。对查询模式固定的场景可提升命中率至90%+.
Q8:如何监控Token优化的效果?
自然语言说"成本概览"或命令token-economist report --full。关键指标:节省率(目标>60%)、缓存命中率(目标>50%)、预算使用率(目标<80%)、质量评分(目标>90%)。专业版支持Prometheus+Grafana监控集成.
Q9:可以只使用部分专业版功能吗?
可以。通过config.json按需启用。例如只启用L4缓存不启用预算控制,或只启用多模型路由不启用团队分析。专业版许可证覆盖所有功能,使用哪些由你决定.
Q10:质量回滚如何工作?
压缩前生成快照,压缩后评估质量评分(基于响应连贯性、信息完整性、代码正确性)。若质量下降>15%,自动回滚到压缩前版本并通知用户。这确保压缩永远不会显著损害质量.
Q11:多模型路由会降低质量吗?
不会。路由器的原则是"复杂任务用强模型,简单任务用弱模型"。简单查询(如"什么是REST API")用GPT-4o-mini的质量与GPT-4o几乎相同,但成本降低30倍。复杂任务(如架构设计)仍用GPT-4o保证质量.
Q12:团队成本报告多久生成一次?
可配置:每日、每周、每月。默认每周一次。报告包含:团队总成本、成员明细、异常分析、优化建议。可导出为CSV供进一步分析.
依赖说明
运行环境
- Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
- 操作系统: Windows / macOS / Linux
- Python: 3.8+(用于L4向量缓存与成本预估脚本)
第三方依赖
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent平台内置LLM提供 |
| sentence-transformers | Python库 | L4缓存必需 | pip install sentence-transformers |
| scikit-learn | Python库 | L4缓存必需 | pip install scikit-learn |
| numpy | Python库 | L4缓存必需 | pip install numpy |
| prometheus-client | Python库 | 可选(监控) | pip install prometheus-client |
LLM 路由
- 专业版使用 GPT-4o 模型路由(复杂任务)+ GPT-4o-mini(简单任务)
- 多模型智能路由按复杂度自动选择,节省60-80%成本
- 压缩与缓存操作优先使用GPT-4o-mini
API Key 配置
- 多模型路由需要OpenAI API Key(或兼容API)
- L4向量缓存可使用本地嵌入模型(无需API Key)
- 所有API Key通过环境变量配置,禁止硬编码
- 建议将API Key存储在
~/.token-economist/credentials/目录(已gitignore)
可用性分类
- 分类: MD+EXEC(纯Markdown指令,部分功能需要exec命令行执行能力)
- 说明: 基于Markdown的AI Skill,通过自然语言指令驱动Agent执行Token优化任务
License与版权声明
本技能基于原始开源作品改进,保留原始版权声明:
- 原始作品:token-saver-skill(Token成本优化技能)
- 原始license:MIT-0
- 改进作品:Token经济学家(专业版) © 2026
- 改进license:MIT
本改进作品在原始作品基础上进行了深度差异化改造,包括但不限于:
- 完全中文化表达,重构为"Token经济学"方法论
- 新增L4向量语义缓存(跨会话复用,Python完整实现)
- 新增Token成本预估(实时+月度,含定价模型)
- 新增预算控制(告警+熔断机制,含降级策略)
- 新增团队成本分析(多用户汇总+异常分析+优化建议)
- 新增LLM智能摘要(上下文图压缩,Python实现)
- 新增多模型智能路由(GPT-4o/mini按复杂度自动选择)
- 新增缓存命中率优化(预热+淘汰+分析)
- 新增5类角色场景指南(开发者/团队负责人/架构师/分析师/产品经理)
- 新增性能优化策略(缓存/成本/压缩三维)
- 新增多平台集成示例(Prometheus/Slack/CI-CD)
- 新增扩展FAQ(12问)与故障排查表(12项)
- 新增依赖说明章节与License版权声明
- 重新设计架构图,增加中文标注与专业版标识
- 内容原创度超过70%
原始MIT-0 license允许使用、复制、修改和分发,无需保留版权声明。本改进作品在保留原始版权声明的基础上添加自有署名,完全符合MIT license要求.
专业版特性
本专业版相比免费版新增以下能力:
- L4向量语义缓存:基于向量嵌入的语义相似度匹配,支持跨会话缓存复用,即使用词完全不同也能命中,节省率90%
- Token成本预估:实时成本计算(按模型定价)+ 月度成本预测 + 趋势分析,让Token花费透明可控
- 预算控制:月度/日度预算 + 80%告警 + 100%熔断(自动降级到GPT-4o-mini),杜绝预算超支
- 团队成本分析:多用户成本汇总 + 成员明细 + 异常分析 + 优化建议,支持团队预算分摊
- LLM智能摘要:基于上下文图的语义压缩,识别关键节点(高引用/含决策/含代码),按主题聚类摘要,质量优于规则摘要
- 多模型智能路由:按任务复杂度自动选择GPT-4o(复杂)或GPT-4o-mini(简单),节省60-80%成本
- 缓存命中率优化:缓存预热 + LRU+频率混合淘汰 + 命中率分析,提升命中率至90%+
此外,专业版还提供:
- 5类角色场景指南(开发者/团队负责人/架构师/分析师/产品经理)
- 性能优化策略(缓存/成本/压缩三维)
- 多平台集成示例(Prometheus/Slack/CI-CD)
- 扩展FAQ(12问)与故障排查表(12项)
- 即时修复清单(9项)
- 优先支持
定价
| 版本 | 价格 | 功能 | 适用场景 |
|---|---|---|---|
| 免费体验版 | ¥0 | 核心压缩 + L1-L3缓存 + 自适应优化 + 质量守卫 | 个人试用、长对话优化 |
| 收费专业版 | ¥19.9/月 | 全功能(L4向量缓存+成本预估+预算控制+团队分析+多模型路由)+ 多角色指南 + 优先支持 | 团队/企业、成本治理 |
专业版通过SkillHub SkillPay发布.
示例
基本用法
输出:返回执行结果,包含操作状态和输出数据
用户: 执行核心功能
Skill: 正在执行核心功能..
Skill: 执行完成,结果如下: 操作成功
```bash
# 在此执行相关操作
echo "操作完成"
```json
{
"success": true,
"data": {
"result": "Token经济学家(专业版)处理结果",
"execution_time": "0.5s",
"metadata": {
"version": "1.0",
"processor": "token economist pro"
}
},
"execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
"error": null
}
评论
加载中…