Token 优化器 · 用量估算与预算分配【律令·本地零联网】
Token优化工具：Token估算、Token计数、Token优化与用量分配、上下文优化、文本切分，发请求前先算清成本，纯本地计算不调用模型。
免费 · 开源许可 BUSL-1.1 · 本地执行，安装后不产生任何外部网络请求
去安装 →这个技能做什么
本地运行，零网络、免 API Key、数据不出电脑。 四项诚实承诺：① 算不出就说算不出，绝不编造数字；② 高危动作强制人工确认；③ 幂等断点，绝不重复副作用；④ 全程留痕可审计。
Token 优化器
子命令（全部实测通过）
estimate：批量估算
token_optimizer.py estimate conv.md article.md实测：两文件合计 total_est_tokens: 6620，每文件含 chars/cjk_chars/lines/est_tokens 明细。
top：定位最大文本块
token_optimizer.py top article.md -n 3实测：返回最大 3 块的行号区间与首行预览，最大段 137 est_tokens。
budget：预算分配计划
token_optimizer.py budget --limit 500 --files conv.md,article.md实测：超预算时返回 within_budget: false + trim_suggestions（按最大的文件优先削减并给每文件留 5% 余量）。
split：按 token 上限切分
token_optimizer.py split article.md --max-tokens 800 --write --out-dir chunks/实测：5984 token 文章切成 9 块（8×~710 + 137），切分点全部落在块边界；不带 --write 只出计划不动文件。
工作流建议
- 用户问"塞不塞得下"→ 先 estimate，再 budget 出分配计划
- 超预算 → top 找大块 → 配合上下文压缩器压缩后再复测
- 交付时说明：启发式估算 ±20%，做精确计费请用模型厂商账单
自检清单
- 估算结果是否说明了启发式口径
- split 切分点是否落在块边界（不截断句子中间）
- budget 超支时是否给出了可执行的削减建议
- 未加 --write 时是否确实没写任何文件
与相邻技能的关系
本包只做自己职责范围内的事，遇到下列情形直接转给兄弟技能：
| 用户要做的事 | 转交给 | 转交话术 |
|---|---|---|
| 要记账与出费用报表 | cost-controller | 「费用台账交给 cost-controller」 |
| 要按复杂度选更便宜的模型 | model-degrader | 「模型选档交给 model-degrader」 |
| 要压缩长对话省 token | conversation-slimmer | 「对话瘦身交给 conversation-slimmer」 |
| 要压缩长文保结构 | context-compressor | 「长文压缩交给 context-compressor」 |
反向边界：只做本地估算，不连任何 tokenizer 服务、不联网。估不准就说估不准，给区间不给假精确值。
你是一个token 预算规划师：先用数字说话再动手裁剪，估算永远标注口径。核心原则：估算必须诚实标注启发式口径、切分只在块边界、写文件必须显式 --write。
标签
Token估算Token优化上下文优化文本切分Token计数
安装方式
- 打开 SkillHub 上的技能页，点击安装；
- 技能文件落在本机技能目录，SKILL.md 全文可在安装前预览；
- 在你的 Agent 里直接说出使用场景即可触发，例如「这段话多少 token、估算 token、token 超预算了」。
network: none，运行过程中不发起任何外部网络请求，也不上传你的文件与数据。你可以断网运行来验证这一点。同类技能
常见问题
按真实会被问到的顺序排。每条答案都给得出可核对的依据——触发词、文件名、路径、源码，全部来自技能包里的真实内容，不是宣传话术。
Token 优化器 · 用量估算与预算分配 能帮我做什么？
Token优化工具：Token估算、Token计数、Token优化与用量分配、上下文优化、文本切分，发请求前先算清成本，纯本地计算不调用模型。
常见的触发场景有：这段话多少 token、估算 token、token 超预算了。
完整说明、版本记录和安装方式在 SkillHub 上的「Token 优化器 · 用量估算与预算分配」页面。
具体能做哪几件事？
按包内文档「子命令（全部实测通过）」，它做这几件事：
- estimate：批量估算
- top：定位最大文本块
- budget：预算分配计划
- split：按 token 上限切分
它明确不做什么？什么情况该转给别的技能？
本包只做职责范围内的事。下面这些情况它会明确转给兄弟技能，而不是硬做：
- 要记账与出费用报表 → 转给 cost-controller
- 要按复杂度选更便宜的模型 → 转给 model-degrader
- 要压缩长对话省 token → 转给 conversation-slimmer
- 要压缩长文保结构 → 转给 context-compressor
反向边界：只做本地估算，不连任何 tokenizer 服务、不联网。估不准就说估不准，给区间不给假精确值。
用之前得注意什么？有什么红线？
每次执行前要过的自检项：
- 估算结果是否说明了启发式口径
- split 切分点是否落在块边界（不截断句子中间）
- budget 超支时是否给出了可执行的削减建议
- 未加 --write 时是否确实没写任何文件
装上之后怎么用？
安装后，在支持 SkillHub 的 AI 客户端（如 WorkBuddy）里直接使用即可。
触发方式：对话里提到「这段话多少 token、估算 token、token 超预算了」等场景，或把相关文件发给 AI，它就会自动响应。
也可以直接跑脚本，典型用法："$PY" <skill目录>/scripts/token_optimizer.py <子命令> [参数]（完整参数见包内说明）。
或从客户端的「已安装技能」列表里手动唤起。
怎么验证它真的没有联网？
不发一个网络包——包的 frontmatter 声明 network: none，不声明就没有联网能力。三条验证路径任选：
① 安装后把网断掉再跑一遍，功能照常——它本来就没打算联网；
② 用抓包工具（Wireshark / Fiddler）观察该技能进程，零外部连接；
③ 直接翻源码：token_estimator.py、token_optimizer.py 等源码全部公开可预览，没有一行网络代码。这是能逐行核对的技术事实，不是宣传口号。
要付费吗？要 API Key 吗？
不需要 API Key，全部技能免费安装。
许可为 BUSL-1.1：BUSL-1.1 源码可见，个人及企业内部可自由使用（含内部生产环境）；发布满 4 年自动转为 Apache-2.0。详见随包 LICENSE.md。
什么环境能跑？需要装依赖吗？
Windows / macOS / Linux 都能跑。
依赖情况以包内「环境准备」一节为准，SkillHub 安装页可直接预览 SKILL.md 全文。
唯一前置是本机装了 Python 3；客户端（如 WorkBuddy）会替你调用，一般不用手动敲命令。
它会不会乱动我的电脑？高危操作怎么办？
四项诚实承诺写死在每个包里：算不出就说算不出；高危动作强制人工确认（阻断而非提示，不是弹窗问一句就放行）；幂等断点，绝不重复副作用；全程留痕可审计。
这类工具包只读取你指定的输入，结果写到输出目录，不改原文件；每一步动作留痕可查。
遇到问题怎么反馈？
执行 · 门禁 · 账单 · 可靠 —— 四块拼图，覆盖 Agent 落地全链路
去企业页 →