印懿报价 Skill（yinyi-quote）

把「印懿报价」的报价能力提炼成一个可安装到各类 AI 工具的 Skill，覆盖印刷包装 120+ 品类（纸盒/纸箱/手提袋/画册/宣传页/卡片/不干胶等），支持材质、后工艺与小批量数码印刷计价。

设计：提示词驱动，skill 不联网

早期版本自带联网脚本，但在很多 AI 工具的沙箱环境里网络请求会被拦截。现在改为：

• SKILL.md 指导 AI 工具用自己的联网能力（内置网页/HTTP 工具、shell、申请权限后的网络）直接调用云端报价 API https://zouph.com

• skill 里唯一的脚本 scripts/format-quote.js 是纯离线的 JSON 格式化工具，任何沙箱都能运行

• 价格库在云端集中维护，skill 无需更新数据；报价结果与小程序完全一致

• 联系方式由服务端 contact 字段随报价动态下发（skill 本身不写死电话，上架审核更干净；改号码只需改服务端一处，用户 git pull 与否都生效。接口暂无该字段时，skill 只引导到微信小程序「印懿报价」，不编造号码）

• 报价 Key 注册制：skill 里不内置共享 Key（写在公开仓库里的 Key 等于没有 Key）。首次使用领一个专属 Key，自带每天 5 次免费报价额度（每天 00:00 恢复）；可单独吊销、可计量，也是「次数包充值」的载体——当天次数用完后 AI 能就地生成专属付款链接（手机号登录后微信扫码），用户不必换工具。MCP 服务器会自动完成领用与本地缓存

• 成本保密：面向客户的输出只含总价与单价；成本明细、利润系数、拼版方案等内部数据在格式化脚本与 MCP 工具中一律剔除，SKILL.md 也明确禁止 AI 向用户透露

• 请求留痕可核对：请求体可选带 rawText（用户这句需求的原样原文）。服务端用它核对「AI 填的参数」与「用户实际说的话」是否一致——抄错尺寸/数量/材质是这条链路最常见的错价来源，而接口本身是无状态的，出了错只有服务端留痕能复盘。rawText 不参与计价、不会回显，不传也能正常出价

• 内置常用参数速查表（SKILL.md ③张表）：把可报价盒型按"要哪几个尺寸"分组、把会计价的后工艺标准写法与材质标准名列成表，让 AI 优先照表映射客户口语。少犯两类错：一是"该问哪些尺寸"不用猜（圆筒精装盒只要 L+H，平面品多传 H 反而错，信封却要传 H）；二是躲开两处静默降级——工艺写法不在表里等于这道没算钱，材质写法认不出等于被换成 300g白卡纸 且不给你任何提示。表里不含任何价格，权威源仍是 /api/box-types 与 /api/materials：后台新增盒型不必更新 skill，表只加速匹配、不作数据源

Related MCP server: bizprint-mcp-server

目录结构

yinyi-quote/
├── SKILL.md                  # 技能说明（Codex / Claude Code 等自动识别的入口）
├── README.md                 # 本文件
├── package.json
└── scripts/
    ├── format-quote.js       # 离线格式化工具（不联网）
    └── mcp-server.js         # 可选：MCP 服务器（见下文）

快速验证

1. 领一个专属报价 Key（每台机器一次即可，自带每天 5 次免费报价，每天 00:00 恢复）：

curl -s -X POST https://zouph.com/api/skill/register -H "Content-Type: application/json" -d "{}"

把返回的 data.apiKey 存成 ~/.yinyi-quote/key（一行文本；Windows 为 %USERPROFILE%\.yinyi-quote\key）。 2. 用任意联网方式请求报价（示例为 curl）：

curl -s -X POST https://zouph.com/api/quote -H "Content-Type: application/json" -H "X-Api-Key: $(cat ~/.yinyi-quote/key)" -d '{"boxType":"飞机盒","L":30,"W":20,"H":10,"quantity":500,"material":"300g白卡纸","crafts":["覆亮膜"],"rawText":"30x20x10的飞机盒，300g白卡，覆亮膜，做500个"}' > result.json

3. （可选）格式化成中文报价单：

node scripts/format-quote.js result.json

各工具安装指南

第一步：获取 skill（二选一）

• 用 git（推荐，后续更新方便）：

git clone https://gitee.com/zph2254/yinyi_quote_skill.git yinyi-quote

GitHub 镜像（GitHub 访问顺畅时可用）：

git clone https://github.com/ZPH-xx/yinyi_quote_skill.git yinyi-quote

• 不用 git：打开 Gitee 仓库页面 或 GitHub 镜像，下载 ZIP 压缩包，解压得到 yinyi-quote 目录

• 以后更新：在 skill 目录里执行 git pull

下面的命令把仓库直接克隆到对应工具的技能目录，克隆后的目录名必须保持 yinyi-quote。

Codex（OpenAI Codex CLI / 桌面应用）

Windows：

git clone https://gitee.com/zph2254/yinyi_quote_skill.git C:\Users\<用户名>\.codex\skills\yinyi-quote

macOS / Linux：

git clone https://gitee.com/zph2254/yinyi_quote_skill.git ~/.codex/skills/yinyi-quote

重新打开会话即可。Codex 的 shell 沙箱拦截联网时，它会按 SKILL.md 的指引申请联网权限或改用其他途径。

Claude Code

个人级：

git clone https://gitee.com/zph2254/yinyi_quote_skill.git ~/.claude/skills/yinyi-quote

项目级：把仓库克隆到 <项目>/.claude/skills/yinyi-quote。

Claude Code 会自动发现目录里的 SKILL.md；它自带 WebFetch 能力，可直接访问接口。

千问（Qwen Code / 通义灵码 CLI）

若版本支持 skills 目录：

git clone https://gitee.com/zph2254/yinyi_quote_skill.git ~/.qwen/skills/yinyi-quote

若不支持：把 SKILL.md 内容复制到项目的 QWEN.md 或 AGENTS.md 里。

WorkBuddy 及其他 Agent 工具

• 支持 Agent Skills（SKILL.md）：把本仓库克隆到它的技能目录，或把克隆下来的目录配置为技能目录

• 只支持自定义提示词：把 SKILL.md 内容粘贴进系统提示词/角色设定

• 支持 MCP：见下方 MCP 配置

豆包

豆包 App 本身不能执行本地技能，两个办法：

1. 在支持 MCP 的入口（豆包电脑版、扣子 Coze 等）添加下面的 MCP 服务器；

2. 在扣子（Coze）里创建插件/工作流，直接调用 https://zouph.com/api/quote（先按下方 /api/skill/register 领一个 Key，把 Key 配在插件的请求头里；接口文档见下）。

可选：MCP 接入（Claude Desktop / Codex / Cherry Studio / 扣子等）

scripts/mcp-server.js 是零依赖的 MCP stdio 服务器，由 MCP 宿主程序（而不是沙箱里的 shell）启动并联网，因此不受聊天沙箱的网络限制：

{
  "mcpServers": {
    "yinyi-quote": {
      "command": "node",
      "args": ["<绝对路径>/yinyi-quote/scripts/mcp-server.js"]
    }
  }
}

提供六个工具：

• calculate_quote 计算报价；参数不全时返回结构化错误（errorCode + askUser + requiredDims），照它追问用户即可。建议每次带 rawText（用户那句需求的原话），便于服务端事后核对参数有没有被抄错

• list_box_types / list_materials 查盒型与材质

• get_quota 查当前 Key 还剩多少次、可购哪些档位

• get_recharge_url 次数用完后生成专属充值链接（30 分钟有效）

• redeem_code 用兑换码充值

API 文档（供直接对接）

基础地址 https://zouph.com。

POST /api/skill/register

领用专属报价 Key。无必填参数；可选 {"installId":"<8-64位字母数字串>","label":"skill|mcp|manual"}，带同一 installId 反复调用会找回同一个 Key。 返回 {code:200,data:{apiKey,quotaTotal,quotaUsed,remaining,freeDaily,dailyUsed,dailyLimit,created}}。 装机 Key 的免费额度是每天 freeDaily 次（默认 5 次/天，每天 00:00 恢复），所以 quotaTotal 为 0（不设终身总次数）、remaining 指的是今天还能报几次。 限制：同一来源 IP 每天最多新建 3 个 Key（防批量领用）；Key 泄露或滥用可在服务端单独吊销。

POST /api/quote

请求头：

额度与限流：

• 速率：每来源 10 次/分钟，同参数 60 秒内有服务端缓存；超限返回 429，反复触发会被临时封禁（403）

• 报价 Key 免费额度：未付费的装机 Key 每天 5 次（freeDaily，每天 00:00 自动恢复；不是"总共 5 次"）。当天用完返回 HTTP 429 + errorCode:"QUOTA_EXHAUSTED"，响应另带 data.resetsTomorrow:true、data.freeDaily、data.dailyUsed，message 含「装机赠送的 5 次/天今日已用完」并引导绑定手机号登录并充值（老 skill 按「装机赠送的 N 次」这串前缀判断，所以前缀保留）。之所以复用 QUOTA_EXHAUSTED 而不是 DAILY_LIMIT：客户端只认前者才会去换充值链接，回 DAILY_LIMIT 就等于只说"明天再来"，转化路径整条被掐掉

• 参考价与精确价：Key 没绑到账号名下时（未付过次数包），data.finalPrice 取整到元、finalUnitPrice 保留两位小数、不下发 nesting 拼版明细，并带 data.quoteNote 说明这是参考价；绑定过账号的 Key 与小程序/网页登录态拿的是精确价。system_config.public_quote_coarse=0 可整条关掉

• 终身预算那一档（后台手工发的 Key、买过次数包的 Key）：quotaTotal 为购买的总次数，用完返回 429 + QUOTA_EXHAUSTED，message 改说「N 次报价额度已全部用完（含已购 M 次）」；data.recharge 里写明下一步该调的充值接口

• 付费后的每日速率上限：买过次数包的 Key 另有 dailyLimit（默认 200 次/天；¥129 / 5000 次这一档为 500 次/天），超限返回 429 + errorCode:"DAILY_LIMIT"，次日自动恢复——这条是防脚本刷爆的速率闸，不是次数用完，不要引导充值。Key 一旦买到次数包，freeDaily 那一档就让位（按次数包的总额与日限判，两套账不叠加）

• 无 Key/旧共享 Key 的来源：按来源 IP 每日 50 次（服务端 ANON_QUOTE_DAILY_LIMIT 可调），用完当天返回 429 且 message 含「今日报价次数已达上限」，次日自动恢复

• 每次成功报价会写一行计费台账（Key/来源 IP/盒型与数量/报价结果），保留 90 天；此外每一次 /api/quote 请求都会写一行排查留痕（含缺参追问、401 无效 Key、429 次数用尽、500 引擎异常这些不计费的下场），保留 30 天

请求体（JSON）：

成功返回 {code:200, data:{...}}，data 字段：

• finalPrice / finalUnitPrice 总价与单价

• boxName / boxCode / params / crafts / colorCount 盒型与参数回显

• billQty 实际计价数量（小批量满版时可能大于 quantity）

• estimate（有则必须转述）：这一单里没算钱/被系统猜了的部分。 unbilledCrafts 线上无价档的工艺、contactRequired 该转人工核价、 assumedMaterial 材质是系统估的、hint 可直接转述的中文句子

• 画册另有 pageCount / bindingType / bindingName / coverPaper / innerPaper / sizeDesc； 画册按页计价，没有 billQty 与 colorCount，复述需求时别当成缺字段

• isSmallBatch 是否走小批量数码路径、defaultLaminated 小批量未提覆膜时是否默认含哑膜

• nesting 拼版方案（幅面、每版拼数、印张数）

• contact 联系方式文案，AI 报价回复末尾附上

成本构成、利润系数由服务端统一裁剪，接口不下发（2026-09-09 起）。 对外主张是单价与总价透明、展开尺寸与拼版可核对、成本构成不外发。

错误返回 {code:400/404/500, errorCode:"...", message:"...", data:{...}}（HTTP 状态码仍是 200）。errorCode 取值：MISSING_PARAMS、BOX_AMBIGUOUS、BOX_UNKNOWN、BOX_CONTACT_ONLY、ENGINE_ERROR；额度类 QUOTA_EXHAUSTED（含当天免费次数用完，此时带 data.resetsTomorrow:true）/ DAILY_LIMIT（付费 Key 的当日速率上限）走真实 HTTP 429。

参数澄清协议：/api/quote 是无状态的，补齐参数后必须带上全部已知参数重发一次完整请求，不能只发增量。

• 画册必须问 P 数：pageCount 缺失返回 MISSING_PARAMS（data.missing 含 pageCount）。 P 数不是尺寸、也没有可兜底的"常规值"——32P 与 64P 差一倍成本，猜一个数就是发假价格。

• data.askUser：可直接转述给用户的中文追问句（一次问齐所有缺项）

• data.missing / data.invalid：缺哪些字段、哪些字段传了但不是大于 0 的数字

• data.missingLabels：缺项的中文说法

• data.requiredDims：该盒型需要哪几个尺寸，如 ["L","W","H"]（判断该问什么比按盒型名猜可靠）

• data.candidates（盒型歧义时）：[{code,name,requiredDims,defaultMaterial}]

• 调用方不得臆造尺寸/数量：宁可追问，也不要拿默认值算出一个假价格

• 参数类 400 不消耗额度（服务端只对 code:200 留痕计数）

GET /api/box-types

返回 {code:200, data:[{code,name,aliases}]}，共 120+ 盒型。

GET /api/materials

返回 {code:200, data:[{name,category,grammage_min,grammage_max}]}。

GET /api/skill/quota

请求头 X-Api-Key。返回 {code:200,data:{apiKey,quotaTotal,quotaUsed,quotaPaid,freeDaily,dailyUsed,remaining,dailyLimit,exhausted,resetsTomorrow,packs,recharge,pendingOrders?}}。免费档的 remaining 是今天还能报几次（freeDaily - dailyUsed）；只有白名单 Key 才 remaining:null（不限量）。exhausted:true 表示现在报不了价（当天免费次数用完，或终身预算用完），recharge 给出下一步该调的充值接口，resetsTomorrow:true 说明明天 00:00 会自动恢复。这个接口自带对账：exhausted 为真时会先向微信核对该 Key 名下未确认的充值单，付了就当场到账再返回，所以用户说「充好了」而你不确定时，调它比猜可靠。pendingOrders（仅在有待确认单时出现）形如 [{orderId,packName,quota,priceYuan,tradeState}]，同时 recharge.paymentInFlight:true——此时应让用户等约 30 秒重发报价，不要再生成新链接。

GET /api/skill/packs

公开接口，无需 Key。返回 {code:200,data:{packs:[{key,name,quota,amount,priceYuan,dailyLimit}]}}，amount 单位为分。

POST /api/skill/claim-url

请求头 X-Api-Key，body {}。生成一次性专属充值链接（30 分钟内对同一 Key 复用同一条）。 返回 {code:200,data:{url,expiresAt,expiresInMinutes,reused,key,packs,tellUser,pendingOrders?,paymentInFlight?,alreadyPaid?,grantedQuota?}}：url 形如 https://zouph.com/recharge?t=ct_…，原样交给用户点击；tellUser 是可直接念给用户的话术。链接域名由服务端 SKILL_RECHARGE_BASE_URL 决定，不接受请求参数覆盖（否则被诱导的 AI 能生成指向钓鱼域的「官方充值链接」）。 出码前同样先对账，因此有四种结果，tellUser 已经分别写好，照念即可：

• 正常（未付费装机 Key 用完当天 5 次）：给出链接，另带 resetsTomorrow:true，话术里既说"每天 00:00 自动恢复"也说"今天想继续就绑定手机号登录并充值"；

• 正常（买过的次数包用完）：给出链接；

• paymentInFlight:true：有一笔还在微信侧确认中（用户可能正在输密码），话术是「先别重复付款，等 30 秒重发报价」；

• alreadyPaid:true + grantedQuota:N：上一笔其实已经付成（回调晚了而已），次数当场到账，话术明确让用户别再扫第二次。

充值页 GET /recharge?t=

用户在浏览器里打开：选次数包 → 手机号 + 密码登录/注册（与官网、小程序网页端同号互通）→ 微信扫码付款 → 页面每 2.5 秒轮询到账状态。付款成功后次数直接发放到 t 所绑定的那个 Key，用户回到 AI 工具说一句「充好了」即可继续报价。手机端可直接跳转微信付款；跳转被内置浏览器拦住时，页面还提供「显示二维码用另一台设备扫」与「复制链接到电脑打开」两条退路。页面没来得及显示到账也不等于没到账：到账由服务端保证（回调 / 回 AI 时对账 / 后台定时扫三条路都会补发），用户只需回 AI 重发报价。

每张付款码 15 分钟内有效（服务端下单时给微信传了 time_expire，超时自动关单），页面会写明几点前有效，过期后撤掉二维码并给出「重新生成付款码」按钮；同一个 Key 最多挂 3 张没付的码，再多会被提示先付掉手上那张。所以用户说"码扫不了/付不了"时，八成是过期了 —— 回页面点重新生成即可，不需要重领充值链接。

POST /api/skill/redeem

请求头 X-Api-Key，body {"code":"YQAC-DEFG-HJKL"}。兑换码充值（不便扫码时的兜底）。成功返回 {code:200,message:"兑换成功，已到账 N 次…",data:{quota,key}}；失败时 errorCode 取 CODE_REQUIRED / CODE_NOT_FOUND / CODE_USED / CODE_VOID。兑换码不区分大小写，横线可省略。

常见问题

• 沙箱拦截联网怎么办？ 这正是本 skill 提示词驱动设计要解决的：让 AI 工具用自己内置的网络能力或向用户申请权限；skill 脚本本身不需要网络。

• 报价失败「对应多种盒型」？ 盒型名有歧义，message 里列了候选，选一个具体盒型重试。SKILL.md 的速查表①末尾列了常撞的几组（民航盒、翻盖盒、六角盒、抽屉盒、展示盒、圆筒盒），照着问一句就能定下来。

• 传了牛皮纸/特种纸，价格却像白卡？ 材质写法没被认出来：服务端会静默按 300g白卡纸 出价，而且不会回 estimate.assumedMaterial（那个字段只在压根没传材质时出现）。改用 SKILL.md 速查表③的标准名（如 120g本色牛皮纸），或先调 GET /api/materials 核对写法。

• 客户要的工艺没算进价格？ 只有速查表②列出的标准写法计价。磨砂、珠光上光、3D立体烫、植绒、贴亮片这类线上无价档，会出现在 data.estimate.unbilledCrafts 里并带 contactRequired:true —— 这时必须说明这部分要人工核价，不能把缺工艺的单当成品价报出去。

• 返回 429「今日报价次数已达上限」？ 该来源当天的额度已用完（errorCode:"DAILY_LIMIT"），次日自动恢复；这不是次数用完，不需要充值。

• 返回 429 QUOTA_EXHAUSTED（次数用完了）怎么办？ 先看 data.resetsTomorrow：为 true 说明只是当天 5 次免费额度用完（明天 00:00 自动恢复），今天就继续则要绑定手机号登录并充值；为 false/缺省则是买的次数用完了。两种都调 POST /api/skill/claim-url 拿到专属充值链接交给用户，微信扫码付款后立即到账；不便扫码可联系客服 15990159967 用兑换码充值。MCP 用户直接用 get_recharge_url / redeem_code 工具。

• 付了钱次数没到账？ 先让用户回 AI 工具重发一次报价——服务端会自己向微信核对并补发（充值页关掉了、微信回调晚了都不影响）。仍没到账再看 data.pendingOrders：里面有 orderId（QP_ 开头）就说明有一笔正在确认，等约 30 秒再重发；超过 5 分钟仍不到账，把订单号发给客服 15990159967 核对。不要因为没到账就再要一条新链接付款——同一笔钱付两次就是扣两次。

• 调用会被记录吗？ 会，分两张表。计费台账（只记成功报价：时间、来源 IP、盒型与尺寸数量、报价结果）保留 90 天；排查留痕（每一次请求都记，含追问、拒绝、异常这些不计费的下场）保留 30 天，两者都只用于额度控制与出错复盘。除调用方自愿附带的 rawText 外不会记录任何客户身份或联系方式——rawText 是按原样留存的，所以请不要把手机号、收件地址等客户信息主动塞进这个字段，只放那句报价需求本身。

• 想指向本地开发服务器？ 先在项目里 node server/index.js 起服务（默认端口 3900），再把本文各示例里的 https://zouph.com 换成 http://127.0.0.1:3900。真机/局域网联调必须用本机 LAN IP 而不是 127.0.0.1，且注意别让端口被 IDE 的端口转发占住（转发监听只绑 127.0.0.1，不接局域网地址）。

• 需要更新价格？ 无需更新 skill，价格库在服务器集中维护。

来源

报价逻辑与小程序「印懿报价」服务端完全一致（同一套云端引擎与价格库）。