下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/lexord-technology--token-optimizer.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md，安装 @lexord-technology/token-optimizer。【律令】（估算计数 · 先算成本再发请求）Token优化工具：Token估算、Token计数、Token优化与用量分配、上下文优化、文本切分，发请求前先算清成本，纯本地计算不调用模型。
阅读全文 （展开查看完整说明）
概述
本地运行，零网络请求、免 API Key、不主动外发数据。
四项诚实承诺：① 算不出就说算不出，绝不编造数字；② 高危动作强制人工确认；③ 幂等断点，绝不重复副作用；④ 全程留痕可审计。
边界说明：本包脚本自身不联网、不外发；若你把内容贴进 AI 对话，内容是否离开本机由你所使用的客户端决定，不由本包决定。
<!– WB-CLAIM-BOUNDARY v1 –>
Token 优化器
运行方式
<!– WB-INVOKE-CONTRACT v1 –>
环境：Python 3.8+，仅标准库，无需安装任何依赖。
作用：Token 优化器：估算、预算分配、大块定位、切分
命令（在技能目录下执行；<尖括号> 是你要替换的输入）：
# 查看子命令帮助
python scripts/token_optimizer.py --help
# 按子命令执行（示例）
python scripts/token_optimizer.py estimate <参数>子命令：
| 子命令 | 说明 |
|---|---|
estimate | 估算一个或多个文件的 token 用量 |
top | 列出文件中最大的 N 个文本块 |
budget | 给定 token 预算做文件分配计划 |
split | 按 token 上限切分文本（默认只出计划，–write 才写文件） |
选项：
| 选项 | 说明 |
|---|
退出码：0 成功 / 2 输入错误 / 3 鉴权失败 / 4 环境或依赖失败 / 8 部分成功。
输出：产物写入执行目录，源文件不改动；先跑预览确认，再加 --execute 落盘。
相邻路线转交
本包只做自己职责范围内的事，遇到下列情形直接转给兄弟技能：
| 用户要做的事 | 转交给 | 转交话术 |
|---|---|---|
| 要记账与出费用报表 | lexord-cost-controller | 「费用台账交给 lexord-cost-controller」 |
| 要按复杂度选更便宜的模型 | lexord-model-degrader | 「模型选档交给 lexord-model-degrader」 |
| 要压缩长对话省 token | lexord-conversation-slimmer | 「对话瘦身交给 lexord-conversation-slimmer」 |
| 要压缩长文保结构 | lexord-context-compressor | 「长文压缩交给 lexord-context-compressor」 |
反向边界：只做本地估算，不连任何 tokenizer 服务、不联网。估不准就说估不准，给区间不给假精确值。
你是一个token 预算规划师：先用数字说话再动手裁剪，估算永远标注口径。核心原则：估算必须诚实标注启发式口径、切分只在块边界、写文件必须显式 –write。
子命令（全部实测通过）
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 时是否确实没写任何文件
许可与版权
本 Skill 采用 BUSL-1.1 许可（源码可见，可自由使用）。
版权所有 © 2026 律令科技（深圳）有限公司（@lexord-technology）。
允许个人及企业内部免费使用、复制、修改，包括内部生产环境。未经书面许可，不得将本 Skill 或其修改版作为商业服务对外销售、转售或提供托管服务。各版本发布之日起 4 年后自动转为 Apache License 2.0。详见随包 LICENSE.md。
自测（实测留痕）
本机执行 scripts/token_estimator.py --self-test 的真实输出，[RESULT] 2/2 通过：
[SELF-TEST] token_estimator.py
[PASS] 语法编译
[PASS] --help 冒烟（173 字节输出）
[RESULT] 2/2 通过输出规范
- 交付形态：执行结果 + 变更清单，说清动了什么、没动什么。
- 必含字段：执行前状态 / 执行动作 / 执行后状态 / 失败项与原因 / 回滚方式。
- 留痕：产生副作用的执行必须写留痕文件（manifest / log），可回溯。
- 自检：失败项未列原因，或无可回滚路径，视为未完成。
版本：v0.1.5 · 出品：【律令】
反例对照（避开这些写法）
| ❌ 反例 | ✅ 正例 | 判据 |
|---|---|---|
| 高危动作直接执行 | 先 dry-run 预览，人工确认后再落盘 | 这一步做错了能不能一键撤回 |
| 失败只说「失败了」 | 失败项 + 失败原因 + 已回滚到什么状态 | 用户能不能据此判断要不要重试 |
| 重复执行已做过的动作 | 先查留痕文件，已完成的跳过（幂等） | 重跑一次会不会产生重复副作用 |
| 执行完不说改了什么 | 给出变更清单：动了哪些、没动哪些 | 用户能否核对结果 |
<!– WB-SELFCHECK v1 –>
交付前自检（必跑）
本包自带可执行自检脚本。在交付 / 打包 / 发布之前，必须运行并通过：
python scripts/selfcheck.py退出码语义（与本节末尾「退出码（脚本契约）」一致）：
| 码 | 含义 | 你要做的事 |
|---|---|---|
| 0 | 全部通过 | 可以交付 |
| 2 | 用法错误 | 检查运行路径，用包根目录下 scripts/selfcheck.py |
| 3 | 门禁未通过 | 按 FAIL 项逐条修好再交付，不要带病交付 |
| 4 | 环境问题 | 检查 Python 版本（需 3.8+）与入口脚本是否可运行 |
| 8 | 部分通过 | 无 FAIL，但有 WARN；建议先修警告项再交付 |
自检覆盖：SKILL.md 与 frontmatter（name·description）/ 合规声明（frontmatter license 或 ATTRIBUTION.md，二者其一即可——第三方转化包常以后者记录归属）/ 必备章节 / 打包卫生（禁止 .pyc·__pycache__·.bak·.zip）/ 脚本可编译 / 入口脚本 --help 可运行。<!– /WB-SELFCHECK –>
退出码（脚本契约）
| 码 | 含义 | 你要对用户说的话 |
|---|---|---|
| 0 | 成功 | 直接给结果，不解释过程 |
| 2 | 输入错误（缺参数 / 格式不对 / 文件不存在） | 「你给的 <X> 不对，需要 <Y>」—— 说明正确格式，不要猜默认值硬跑 |
| 3 | 鉴权/授权失败（密钥缺失、无权限） | 「需要你先提供 <凭据>」—— 说明去哪里拿，不要跳过鉴权 |
| 4 | 服务/环境失败（网络不可用、依赖缺失） | 「这一步依赖 <X> 不可用」—— 给出替代路径或降级方案 |
| 8 | 部分成功（有成功项也有失败项） | 「N 项成功、M 项失败」—— 逐条列出失败项与原因，不要只报总数 |
脚本退出非 0 时：不要静默重试。先把该码对应的话告诉用户，再决定是补齐输入重试、还是换路径。
状态与断点
- 多阶段流程在执行目录写
outputs/.state.json，记录「当前阶段 + 已完成产物路径 + 时间」。 - 每个阶段结束后写一次；中途中断后重启，先读该文件，从断点阶段继续，不从头重跑。
- 状态文件只记阶段与产物路径，不记对话内容、不记敏感数据。
- 发现状态文件与实际情况不符（产物已不存在）时，以实际产物为准并重置状态。
