---
name: biaoshu-writer-city
description: 上传招标/投标文件，AI 一站式完成智能解读（废标红线/评分标准/控标洞察）、成品投标文件(.docx)生成、标书审查（分级风险+雷同检测）和标书查重（2-3份投标文件相似/雷同风险检查）。覆盖投标、招标、标书、投标文件、竞标、围标、控标、废标、评分标准、资格条件、技术标、商务标、暗标、响应文件、应答文件、雷同检测、相似检查、标书查重等场景——当用户提供或提及招标/投标文件、问「这个标能不能投 / 有哪些废标红线 / 帮我写投标书 / 检查标书有没有问题 / 两份投标文件像不像 / 会不会被判雷同」，或想解读招标文件、生成投标文件、做标书审查或查重时使用。需百炼®标书 Api Key（新用户零输入免费试用，赠 50,000 字；手机号注册赠 5 万字）；文件经百炼®标书云端处理，智能解读免费，标书制作/审查/查重按可用字数计费。
allowed-tools: Read, Write, Bash(python3 scripts/zcm.py:*)
metadata:
  permissions:
    network:
    - biaoshu.zhiliaobiaoxun.com（招采猫 API，唯一外联目标）
    filesystem:
      read: 仅用户明确提供的招标/投标文件与本 skill 自身脚本
      write: biaoshu-bailian-files/（产物）；~/.zcm/config.json（凭证，权限 600，logout 可删）
    environment:
    - ZCM_APP_KEY（可选：App Key，替代凭证文件）
    - ZCM_BASE / ZCM_CONFIG / ZCM_HOME / ZCM_OUTPUT_DIR（可选：地址与路径覆盖）
    billing: 标书生成消耗 App Key 所属账户积分（提交前预检余额）
    not-collected: 设备信息 / 手机号 / 验证码 / 除上述 ZCM_* 外的任何环境变量
slug: biaoshu-writer-city
version: 1.0.5
displayName: 标袋云投标文件生成助手
---

# 招采猫 AI 标书助手

> 📌 本文档同时是 AI 助手的执行手册：文末「🚫 对用户输出的第一铁律」优先级最高、覆盖全文，任何面向用户的输出都必须先满足其要求；一切任务命令由助手后台代跑（后台操作手册见 [references/usage.md](references/usage.md)）。

## 快速开始：获取 Api Key

用百炼®标书写作助手出解读/标书/标书审查/标书查重，只需一个 Api Key。**安装完成后，助手会自动为你开通试用账号**（零输入，赠 50,000 字，自动采集设备特征，Api Key 自动保存、下次免输）——用户无需敲任何命令，直接上传文件、说需求即可开始。

**当可用字数不足后**，再引导用户通过**官网获取**正式 Api Key 或购买会员/字数包（向用户转述时**逐步骤完整给出**，链接原样显示完整 URL）：

1. 打开官网 https://biaoshu.zhiliaobiaoxun.com/?ch=s93 ，用手机号 + 短信验证码注册并登录（手机号注册赠 5 万字）；
2. 登录后点**左侧菜单『Skill 接入 → 获取 Api Key』**，在弹出面板中**查看/复制 Api Key**（首次打开自动生成，形如 `bk_live_xxxxx`；重置后旧 Key 立即失效）；
3. 把 Key 直接粘贴到对话里让助手保存（下次免输），例如：「我的 Api Key 是 bk_live_xxxxx，帮我保存一下」。（助手收到后必须在**当前已安装的 biaoshu-writer-city skill 根目录**执行保存，让 `config.json` 写到该目录；不得写到 `~/.zcm/` 等全局旧目录。保存成功后把 `config.json` 的**完整路径**转述给用户。）

**安装说明/提示词必须这样约束 Api Key 落盘**：请 AI 助手先定位当前安装的 `biaoshu-writer-city/SKILL.md` 所在目录，然后在同级目录创建或更新 `config.json`，内容为 `{"app_key":"用户自己的 Api Key"}`，权限设为 `600`。不要让助手把 Api Key 写入其他目录，也不要把 Api Key 拼进任何链接。

**升级 skill 必须保留配置**：如果当前已安装目录存在 `config.json`，升级时不得删除、覆盖或替换该文件；只能更新 `SKILL.md`、`scripts/`、`references/` 等 skill 内容文件。本地生成目录 `biaoshu-writer-city-files/` 也必须保留。

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

## 四大功能

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

![智能解读报告示例](https://cdn-huokezu.bailian-ai.com/smart_bidding/skill/report-interpret.png)

### 📝 标书制作
- **输入**：已解读项目 + 分包选择（无分包时自动跳过选包）+ 目标页数；平台当前最大页数上限为 1200 页，实际提交页数还必须以抽包结果里的 `max_total_pages` 为准。若用户在上传/提供招标文件后明确要求制作标书或投标文件，且未指定页数，则默认生成200页的标书，并用 `max_total_pages` 校验；同时要告诉用户也可以指定 1 到 max_total_pages 范围内的页数。
- **输出**：成品投标文件 `.docx`——按招标文件名自动命名，自动完成选包、抽需求、生成大纲、生成正文、抽取制式模板并导出，含目录、章节与「待填项」定位书签。（此步按生成内容消耗可用字数。）
- **使用示例**（用户可以这样说）：
  - 「就用刚才解读的项目，帮我生成投标文件」
  - 「这是招标文件，直接帮我做一份标书」
  - 「选 01 包，生成一份 80 页左右的标书，存到桌面」
  - 「这个项目出标书，包和页数你先列出来让我确认」
  - 「时间紧，先给我出个标书框架，页数用系统建议，但开始前先问我」
  - 用户得到：解读完成后，助手必须先抽取分包。当用户只要求解读或尚未明确制作意图时，如存在多个分包，展示分包清单并让用户选择；如无分包/单项目，不再询问包选择，直接进入页数确认。页数确认时展示「系统建议页数 / 最大页数 / 预计消耗字数」，并明确说明预计消耗仅供参考，实际消耗以平台最终结算为准；用户确认前不得提交生成任务。若用户在上传/提供招标文件后明确要求制作标书或投标文件（如「做标书」「生成投标文件」「出一份响应文件」），视为已授权自动制作：无分包/单包时自动继续，直接走 interpret → packages → generate --no-wait → progress-stream → download-url；多包项目必须停下来让用户确认具体包，不默认全选。未指定页数时默认 200 页，并带入 max_total_pages 校验；如果 200 超过 max_total_pages，则按上限提示用户确认或使用上限页数。无论走自动制作还是确认流程，面向用户都要说明“默认按 200 页生成，也可以指定 1 到 max_total_pages 范围内的页数”。用户已指定包/页数时按指定值执行并校验上限。用户明确说「先列出来让我确认」「开始前先问我」时，按确认流程暂停。提交生成后不做字数不足示警。生成过程中必须持续播报阶段、百分比、已用时间和当前章节，平台暂未返回细节时也要每 5 秒转述运行中心跳。若生成中途因 `insufficient_balance` / `insufficient_points` 停止，必须明确说明平台不会自动续跑；如果后端已导出半成品，先交付半成品下载链接，并提示充值或购买字数包后可用 `continue-generate` 继续生成正文。最后交付短时下载链接或本地成品路径；下载链接有效期以平台返回的 `expires_in` 为准，失效后只能重新获取新链接。制式表格/范本会尽量自动抽取或生成，无法确认的信息保留为待填项。（此步按生成内容消耗可用字数，生成耗时可能超过 10 分钟；章节级进度取决于后端 `progress` 是否持续写入。）

### ✅ 标书审查
- **输入**：招标文件（已解读）+ **一份或多份**投标文件（`.doc` / `.docx` / `.pdf`，**支持多选，最多 100 份**；**单份 ≤ 1024 MB**，**总大小不超过 2GB**）。
- **审查选项**：支持标记暗标、电子投标；可填写敏感单位名称用于检索；可按需关闭语义审查，仅保留规则类检查。
- **输出**：分级风险问题清单（高风险 / 待复核 / 提示，每条带招标依据、投标证据、修改建议）+ 一句话结论 + 检查范围 + 语义审查状态/部分结果提示 + 多文件雷同检测 + 人工核查清单。可导出审查报告。（此步按平台规则消耗可用字数。）
- **使用示例**（用户可以这样说，招标文件需已解读）：
  - 「审查一下这份投标文件 `/Users/me/某项目_投标文件.docx` 有没有废标风险」
  - 「把 `A公司投标.docx` 和 `B公司投标.docx` 一起查一遍，看看有没有雷同和风险」
  - 「这是暗标，帮我查格式和红线问题，出一份合规报告」
  - 「投之前帮我把把关，别废标」（把投标文件发我或给我路径即可）
  - 用户得到：「高风险 0 · 待复核 39 · 提示 25」+ 一句话结论、检查范围、语义审查是否完整、整改建议 + 报告绝对全路径（形如 `/Users/you/biaoshu-writer-city-files/某采购项目招标文件_合规审查.html`）（多份文件时含雷同检测结果；部分结果不得说成完整审查）。

![合规审查报告示例](https://cdn-huokezu.bailian-ai.com/smart_bidding/skill/report-compliance.png)

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

### 🔁 标书查重
- **入口判断**：用户说「查重 / 雷同 / 相似 / 两份像不像 / 会不会被判雷同 / 围标风险线索」时，才进入标书查重；不要误走标书审查。查重只比较**不同投标文件之间**的相似/雷同风险。
- **输入**：必须先收齐 `2-3` 份合法持有的**投标文件**（`.doc` / `.docx` / `.pdf`，本地路径或云端 URL；云端文件会先下载到本地再处理）。招标文件不是投标文件，不能凑数；如用户提供招标文件，只能作为可选的 `1` 份公共表述基线（≤ 50 MB）。投标文件单份 ≤ 1024 MB，总大小不超过 2GB。
- **发起前确认**：未收齐至少 2 份投标文件前，不得发起查重；收齐后还必须先确认用户合法持有并有权处理全部上传文件。查重结果仅供提交前内部自查，不构成围标、串标或违法违规的法律认定。
- **输出**：按文件对展示文本相似、图片相似、文档元数据、主体线索、招标原文共同表述等风险线索，包含风险率、证据片段和修改建议。当前 skill 输出完整 JSON 结果，可在百炼®标书平台查看历史报告。（此步按平台规则消耗可用字数。）
- **使用示例**（用户可以这样说）：
  - 「帮我查一下这两份投标文件有没有雷同风险：`/Users/me/A公司投标.docx` 和 `/Users/me/B公司投标.docx`」
  - 「这三份响应文件做一下相似检查，招标文件是 `/Users/me/招标文件.pdf`」
  - 「投之前帮我看两份标书像不像，会不会有围标风险线索」
  - 用户得到：如果投标文件不足 2 份，先提示「还需要至少 2 份投标文件才能查重」；如果已收齐，先请用户确认合法持有和处理权限，再发起查重。完成后展示文件对风险率、相似片段、图片/元数据/主体线索风险提示和修改建议。

智能解读、标书生成、标书审查、标书查重的结果均可同步在百炼®标书平台查看：<https://biaoshu.zhiliaobiaoxun.com/?ch=s93>

> 百炼®标书是面向投标场景的**投标全流程工作台**。网页工作台之外，也支持通过**开放 API 与 Skill 接入**完成解读、抽包、生成、标书审查与标书查重。
>
> **字数计费说明**：智能解读免费，可用字数为 0 也能发起；标书制作、标书审查、标书查重通过开放 API / Skill 按平台规则消耗可用字数。标书生成的预计消耗仅供页数确认参考，实际消耗以平台最终结算为准；生成前不做余额不足示警，也不做余额拦截。抽包、任务查询、结果获取、知识库查询等辅助查询不作为独立成果单独计费。

## 🪶 轻咨询也接得住 & 顺势衔接下一步

- **只给片段、问通用问题也接得住**：用户只粘了一段招标公告/采购需求，或问「投标要注意什么 / 暗标有什么要求 / 技术方案怎么写 / 常见废标原因有哪些 / 控标怎么识别」时，先给一段通用要点应答，**再按第一铁律说清「怎么给完整文件」**（上传文件，或给本地绝对路径 / 云端可下载 URL，并举个路径示例），引导补上文件后做定制解读/审查。
- **一步做完，顺势提示下一步**（用户不接就不再追）：解读完 → 问「要不要接着基于它生成投标文件？」；但用户一开始已明确要求制作标书或投标文件时，无分包/单包项目不追问、不停顿，直接跑完“智能解读 → 抽包 → 标书制作 → 交付成品”；多包项目必须停下来让用户确认包。标书生成完 → 问「要不要再做一遍标书审查、排查废标风险？」；标书审查完 → 问「要不要按整改清单改完后复审一次？」；用户提供多份不同主体投标文件时 → 可提示「要不要单独做标书查重，看雷同/相似风险线索？」。

## 💡 经验沉淀与问题反馈（询问式，绝不擅自上传）

**经验沉淀**（三个触发点：解读结果调整完成后、标书改稿告一段落后、合规整改完成后），固定两问：
1. 「这个阶段的调整要不要总结沉淀为经验？」→ 同意后，从对话上下文总结出素材/偏好/纠错条目，**展示给用户过目**；条目数注意每天最多沉淀 20 条的额度，优先保留信息量最高的。
2. 「要不要回传到百炼®标书平台沉淀？」→ 同意后才后台回传，并转述「已沉淀 N 条经验备用」。**不承诺下次生成会用上**（平台侧只存储）。

两问任一拒绝则本阶段不再追问。当天沉淀满 20 条时如实转述「今日沉淀已达上限，明天可以继续」。

**问题上报**：发现用户纠正助手、流程跑偏或脚本报错时，先把要上报的内容（分类/场景/现象/期望）展示给用户并征得同意，再后台上报；默认不含任何文件内容与个人信息。

具体操作命令见 references/usage.md（仅后台执行，勿展示给用户）。

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

- 本 skill 的一切命令（`python3 …`、`zcm.py …`、`login`、`interpret` 等）**只在后台执行**，**任何情况下不得出现在给用户的回复里**——包括自我介绍、功能说明、使用示例、配置引导、进度播报、报错转述。
- 用户只需要做三件事：**提供文件、说需求、粘贴 Api Key**（或按引导提供手机号/验证码）。命令���部由你（助手）代跑。
- 用户问「怎么用 / 给我些示例」时，**只展示上方各功能「使用示例」里的场景话术**（用户怎么说 → 得到什么），并告诉他「把文件给我、直接说需求即可」。[references/usage.md](references/usage.md) 里的命令是你的后台操作手册，**不是可以展示给用户的内容**。
- **安装成功后的介绍、或用户问「这个 skill 能干什么 / 怎么拿 Api Key」时，输出必须包含两块，缺一不可**：
  ① **怎么获取 Api Key**——「快速开始：获取 Api Key」的拿 Key 路径，**尤其官网获取第 3 步的粘贴示例话术**（「我的 Api Key 是 bk_live_xxxxx，帮我保存一下」）必须原样出现；
  ② **有什么功能**——「四大功能」小节，**尤其各功能「使用示例」的场景话术和「用户得到」**必须完整出现。
  两块都**优先原文照抄**，不要改写成摘要；示例是强制项，任何精简都不得省略示例。
- **让用户提供文件时，必须说清「怎么给」**：无论是要招标文件还是投标文件，都不能只说「发给我」。要明确告诉用户两种方式任选——**① 直接上传文件；② 给出文件路径**（本地绝对路径，形如 `/Users/你的用户名/Downloads/某采购项目招标文件.pdf`，或云端可下载 URL；若给 URL，本 skill 会先下载到本地再处理），并**举一个具体路径示例**。别让用户猜格式。
- **产物交付必须清楚**：解读报告 / 合规报告 / 查重报告每次产出后，把**每个文件的完整绝对路径**（形如 `/Users/you/biaoshu-writer-city-files/某项目_智能解读.html`）逐行告诉用户；成品标书默认交付**短时下载链接**（脚本会打印链接、文件名、大小、有效期），用户明确要本地文件时再用 `result <job_id> -o <路径>.docx` 下载并告知绝对路径。标书查重未请求报告时只总结 JSON 核心结论，不编造本地报告路径。
- **凭证保护**：不得在回复中复述、展示或转发 Api Key，也不得把 Api Key 拼入任何给用户打开的 URL。绑定手机号走 skill 内验证码流程；充值/自助操作只给百炼®标书官网普通地址（可带 `ch` 渠道码）。

## 进一步

凭 **Api Key** 调用百炼®标书开放 API，无需登录网页即可闭环完成投标全流程。所有任务走「**提交 → 自动轮询 → 取结果**」统一异步模型，以 Api Key 所属用户身份执行（复用其知识库与可用字数账户）。底层由零依赖 Python 客户端封装鉴权、轮询与友好错误码（具体命令见 [references/usage.md](references/usage.md)）。

- **执行任务前先读** [references/usage.md](references/usage.md)：各步参数、命名规则、计费与凭证规则、报告/边界情形、断点续查、幂等、错误处理。
- **输出铁律**（除非用户明确说不要）：运行脚本时进度照常显示、不重定向吞掉；解读/标书/合规结果文件的**绝对全路径**必须打印给用户。详见 usage.md 顶部「⚠️ 输出约定」。
- **接口契约**（开放 API 端点、错误码、解读/合规/查重返回字段）→ 见 [references/api.md](references/api.md)。