@artale/pi-weigh
可视化分析AI系统提示词（Prompt）的令牌预算。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@artale/pi-weigh。 它的用途是：可视化分析AI系统提示词（Prompt）的令牌预算。 详细介绍见：https://321skill.com/skills/artale-pi-weigh/ 请根据该页面的说明完成安装。
使用示例
“分析一下我项目根目录下的 `system-prompt.md` 文件，生成令牌使用报告。”，它会调用工具解析该文件，计算每个工具定义和指令部分的令牌消耗，并生成一份详细的HTML报告，帮助你快速定位可以精简内容的部分。
介绍
在构建和优化AI Agent时，开发者常面临系统提示词（System Prompt）过长、令牌使用不透明的问题，难以精确控制成本和性能。本工具旨在解决这一问题，通过生成一份可视化的HTML报告，清晰展示系统提示词中各个工具（Tools）和模块所占用的令牌预算，并提供健康度指示，帮助开发者进行精细化的成本与性能分析。
使用方式非常简单。开发者只需在项目中安装此npm包，并在构建或评估流程中运行它。工具会自动解析指定的系统提示词文件或配置，计算其中每个工具、函数调用以及各个逻辑部分（如指令、示例、约束等）的令牌消耗，并输出一份结构清晰、可直接在浏览器中查看的HTML报告。
它非常适合AI应用开发者、提示词工程师以及任何需要优化大型语言模型（如Claude、GPT系列）系统提示词以控制API调用成本的团队或个人。对于正在调试复杂Agent行为、或需要向团队或客户展示提示词资源分配情况的场景尤其有用。
建议在每次对系统提示词进行重大修改后都运行一次分析，以监控令牌预算的变化。需要注意的是，该工具仅提供静态分析，报告中的令牌数是基于模型分词器的估算值，可能与实际API调用时的消耗存在微小差异，主要用于相对比较和趋势观察。
核心特点
与同类工具相比，它专注于为复杂的AI Agent系统提示词提供精细到每个工具（per-tool）和模块（section）的令牌消耗可视化报告，并包含一个直观的健康度指示器，帮助快速识别预算超支的风险点，且实现上为零依赖，轻量易集成。
注意事项
该工具仅提供基于分词器的静态令牌估算，不适用于分析动态生成或运行时拼接的提示词的实际API消耗。
常见问题
这个工具支持哪些AI模型？
它使用通用的分词器进行估算，适用于分析面向Claude、GPT等主流大模型的提示词，但报告数值为估算值。
生成的报告包含哪些内容？
报告包含总令牌数、各工具/函数调用分解、提示词各模块（如指令、示例）分析以及一个预算健康度指示。