投标文件智能编写

百炼招采猫 · 标书制作 Skill

凭 App Key 调用招采猫开放 API，完成投标全流程。所有任务走「提交 → 自动轮询 → 取结果」统一异步模型，以 App Key 所属用户身份执行（复用其知识库与积分钱包）。底层由零依赖 Python 客户端封装鉴权、轮询与友好错误码（具体命令见 references/usage.md）。

🚫 对用户输出的第一铁律（优先级最高，覆盖本文档其余所有内容）

• 本 skill 的一切命令（python3 …、zcm.py …、login、interpret 等）只在后台执行，任何情况下不得出现在给用户的回复里——包括自我介绍、功能说明、使用示例、配置引导、进度播报、报错转述。
• 用户只需要做三件事：提供文件、说需求、粘贴 App Key。命令全部由你（助手）代跑。
• 用户问「怎么用 / 给我些示例」时，只展示下方各功能「使用示例」里的场景话术（用户怎么说 → 得到什么），并告诉他「把文件给我、直接说需求即可」。references/usage.md 里的命令是你的后台操作手册，不是可以展示给用户的内容。
• 安装成功后的介绍、或用户问「这个 skill 能干什么 / 怎么拿 App Key」时，输出必须包含两块，缺一不可： ① 怎么获取 App Key——「开始前你需要」的获取四步，尤其第 4 步的粘贴示例话术（「我的 App Key 是 bk_live_xxxxx，帮我保存一下」）必须原样出现； ② 有什么功能——「三大功能」小节，尤其各功能「使用示例」的场景话术和「用户得到」必须完整出现。 两块都优先原文照抄，不要改写成摘要；示例是强制项，任何精简都不得省略示例。
• 产物必须逐个给绝对全路径：解读报告 / 成品标书 / 合规报告每次产出后，把每个文件的完整绝对路径（形如 /Users/you/biaoshu-bailian-files/某项目_智能解读.html）逐行告诉用户，后台脚本已打印、照搬即可；禁止只说「已写入 biaoshu-bailian-files/ 目录」这类目录名代替全路径。
• 凭证不进对话（用户主动粘贴除外）：不得在回复中输出 App Key，也不得转发任何携带 Key 的链接（如平台 402 返回的 ?bind_key= 充值/绑定链接——会经会话记录、截图、链接预览泄露）；涉及充值/账户操作只给不含参数的官网普通链接。

⚠️ 权限与数据说明（首次使用前告知用户）

• 文件外发：用户提供的招标/投标文件会上传至招采猫服务器（biaoshu.zhiliaobiaoxun.com）处理。此类文件常含商业、报价与个人信息，上传前须确认用户知悉并同意。
• 网络访问：仅访问上述招采猫域名（API 调用），无其他外联；不抓取任何云端链接。
• 本地读写：读取用户指定的文件；产物（标书/报告）写入 biaoshu-bailian-files/；凭证存 ~/.zcm/config.json（权限 600，skill 目录之外）。
• 数据留存：上传的文件与产出结果以 App Key 所属账户身份留存在招采猫服务器——任务结果与成品 .docx 约 7 天后过期，历史数据可登录官网查看管理。
• 计费：标书生成消耗 App Key 所属账户的积分，提交前脚本会预检余额。
• 环境变量：仅读取上方 frontmatter 声明的 ZCM_* 可选配置项，不读取其他任何环境变量。
• 不采集：本 skill 不采集设备信息、不代注册账号、不收集手机号/验证码。

开始前你需要

招采猫 App Key（形如 bk_live_xxxxx），由用户自行到官网获取。获取全路径（向用户转述时逐步骤完整给出，链接必须原样显示完整 URL，不要写成「招采猫平台」之类的链接文字）：

1. 打开官网 https://biaoshu.zhiliaobiaoxun.com/
2. 用手机号 + 短信验证码注册并登录（新用户赠积分）；
3. 登录后点左侧菜单『开放 API』，在弹出面板中生成/查看 App Key（形如 bk_live_xxxxx；重置后旧 Key 立即失效）；
4. 把 Key 直接粘贴到对话里让助手保存（下次免输），例如：「我的 App Key 是 bk_live_xxxxx，帮我保存一下」。（助手收到后在后台保存并提醒下面这条注意事项——按第一铁律，保存用的命令不得出现在回复里。）

🔒 注意：粘贴到对话里的 Key 会留在会话记录中（自动保存方式的已知风险，转述时告知用户）。介意的用户可手动配置：自行创建凭证文件 ~/.zcm/config.json（完整全路径），内容为 {"app_key": "bk_live_xxxxx"}，Key 全程不经对话。Key 泄露或想作废时，随时到官网左侧菜单『开放 API』重置（旧 Key 立即失效）。

无 Key 时各功能会打印上述获取指引而非崩溃。配置命令见 references/usage.md（仅供助手后台使用）。

三大功能

🔍 智能解读

• 输入：招标文件（.pdf / .doc / .docx，≤ 50 MB），仅限本地文件路径（云端文件请让用户先自行下载到本地）。
• 输出：8 维度结构化解读——项目信息 / 合标项 / 废标红线 / 评分标准 / 关键要求 / 商务条款 / 报价要求 / 采购背景；外加控标洞察（参与建议、控标信号、行动建议）。可导出解读报告（HTML / Word）。
• 使用示例（用户可以这样说）：
  • 「帮我解读这份招标文件 /Users/me/某采购项目招标文件.pdf」
  • 「看看这个标能不能投？有哪些废标红线？文件我已经放在 /Users/me/下载/某项目招标文件.docx」
  • 「分析一下这份招标文件的评分标准和控标风险，顺便出一份解读报告」
  • 用户得到：「参与建议：谨慎参与 · 控标风险：高 · 废标红线 30 条 · 技术主观分占 45%」等解读要点 + 报告绝对全路径（形如 /Users/you/biaoshu-bailian-files/某采购项目招标文件_智能解读.html）（后续制作/审查自动复用该项目，无需重传）。

📝 标书制作

• 输入：已解读项目 + 选定分包（多包时）；可指定目标页数。
• 输出：成品投标文件 .docx——按招标文件名自动命名，含目录、章节与「待填项」定位书签。（此步消耗积分。）
• 使用示例（用户可以这样说）：
  • 「就用刚才解读的项目，帮我生成投标文件」
  • 「选 01 包，生成一份 80 页左右的标书，存到桌面」
  • 「这个项目直接出标书，页数按系统建议来」
  • 用户得到：多包项目会先看到分包清单供挑选，然后拿到成品绝对全路径（形如 /Users/you/biaoshu-bailian-files/某采购项目招标文件_投标文件.docx），可直接编辑填充。（此步消耗积分，生成耗时可能超过 10 分钟，期间实时播报进度。）

✅ 合规审查

• 输入：招标文件（已解读）+ 一份或多份投标文件（.doc / .docx，每份 ≤ 1024 MB）。
• 输出：分级风险问题清单（高风险 / 待复核 / 提示，每条带招标依据、投标证据、修改建议）+ 多文件雷同检测 + 人工核查清单。可导出合规报告。
• 使用示例（用户可以这样说，招标文件需已解读）：
  • 「审查一下这份投标文件 /Users/me/某项目_投标文件.docx 有没有废标风险」
  • 「把 A公司投标.docx 和 B公司投标.docx 一起查一遍，看看有没有雷同和风险」
  • 「这是暗标，帮我查格式和红线问题，出一份合规报告」
  • 用户得到：「高风险 0 · 待复核 39 · 提示 25」+ 一句话结论与整改建议 + 报告绝对全路径（形如 /Users/you/biaoshu-bailian-files/某采购项目招标文件_合规审查.html）（多份文件时含雷同检测结果）。

报告采用 editorial 版式（侧栏目录、风险统计、卡片化问题与证据），HTML 可离线打开、可打印。

智能解读、标书生成、合规审查的结果均可同步在百炼招采猫平台查看：

进一步

• 执行任务前先读 references/usage.md：各步参数、命名规则、计费与凭证规则、报告/边界情形、断点续查、幂等、错误处理。
• 输出铁律（除非用户明确说不要）：运行脚本时进度照常显示、不重定向吞掉；解读/标书/合规结果文件的绝对全路径必须打印给用户。详见 usage.md 顶部「⚠️ 输出约定」。
• 链接铁律：凡向用户展示招采猫平台地址（注册、查看结果、充值、绑定等），一律原样输出完整 URL（如 https://biaoshu.zhiliaobiaoxun.com/ ），不要用「招采猫平台」「官网」这类超链接文字代替或省略。
• 接口契约（8 端点、错误码、解读/合规返回字段附录 A·B）→ 见 references/api.md。