你不用先研究客户端，按这个顺序交文件
先拖文件，失败时再打开一次性链接；如果文件以前用过，还可以直接选择旧合同的原 PDF。 这三种方式最后都由现有的 dianqian_create_contract 工具继续创建合同， 不会为了上传再多出第六个 MCP 工具。
| 顺序 | 怎么做 | 什么时候用 |
|---|---|---|
| 第一选择 | 把 PDF 直接拖进对话 | Agent 能把聊天附件交给远程 MCP |
| 自动备用 | 打开一次性链接选择 PDF | Agent 看得到附件，但传不出原文件 |
| 不用重传 | 选择一份旧合同的原 PDF | 同企业、同环境中已有合格原文件 |
先说清楚：这份 PDF 要不要签？
点签把文件分成两种。签署文件会进入签名流程；普通附件作为合同附件保存，不参与签署， 也不会出现在签后 PDF 列表里。不同签署端是否展示附件、从哪里打开，以实际页面为准。 多份文件可以混合使用，但发起前要让 Agent 分开列给你核对。
| 你想要的效果 | 技术参数 | 现在的状态 |
|---|---|---|
| 这份 PDF 需要签字或盖章 | upload_target: "signing"，不写时也默认按签署文件处理 | 测试环境已上线 |
| 这份 PDF 只随合同查看，不参与签署 | upload_target: "attachment" | 测试环境已上线 |
你只要说“这三份需要签，这一份只是附件”。Agent 或连接器负责换成上面的技术参数。 普通附件的一次性浏览器上传已经在公开测试服务器上线；这不代表生产环境已经发布。
先直接拖入 PDF
先把 PDF 拖进聊天框，并告诉 Agent 用它创建合同。支持附件直传的 Agent 会直接处理， 你不需要复制文件编号，也不需要安装额外程序。
有些 Agent 只能读到文件名或预览内容，不能把原文件交给远程点签服务。 这是 Agent 客户端的文件权限限制，不是合同功能坏了。遇到这种情况不用反复拖文件， Agent 应改用一次性上传链接。
当前实测中，CodeBuddy CN 会把对话里的 PDF 按图片处理，不能稳定交给远程 MCP。 使用 CodeBuddy 时直接让 Agent 返回一次性浏览器上传链接，不需要安装本地 Skill 或输入命令。
普通附件：上传后回 Agent 继续
签署文件已经选好，还要增加一份不参与签署的 PDF 时，直接这样告诉 Agent。 普通用户不需要安装本地 Skill，也不需要再次输入企业凭据。
普通附件：测试环境已上线
签署文件不变，再加一份普通附件，不参与签署。- Agent 返回当前合同的一次性浏览器上传链接。
- 打开网页，选择一份不超过 20 MiB 的有效 PDF 并上传。上传页不会再问你要企业凭据。
- 上传成功后回到原对话，说“继续创建合同”。上传成功本身不等于合同已经创建。
- 系统创建合同后，Agent 再做一次只读查询，确认普通附件已经绑定。
只查刚才的合同：确认普通附件已绑定，只说附件数量和文件名。链接有效期为 30 分钟，只能用于当前合同的一份 PDF。不要转发、截图或公开发布这个链接。 当前测试环境的真实闭环已确认普通附件已经绑定。只读确认时，让 Agent 只返回附件数量和文件名，不显示文件编号、手机号或链接。
也可以复用旧合同原 PDF
测试环境已上线
同一家企业、同一环境中，已经成功创建过的合同原 PDF 可以用于新合同。 系统会为新合同生成一份独立副本，不会让两份合同共用同一条文件记录。
请重新查找测试服务合同当前可用的原 PDF，确认后复用。Agent 会先列出当前可用的候选文件让你选择。如果它提示缓存已经过期， 就换用当前可用的原文件，或让它重新读取原合同后再选。历史缓存不是永久有效， 不要反复提交旧会话里的文件编号。
哪些文件能复用？
| 文件类型 / 情况 | 结果 | 原因 |
|---|---|---|
| 同企业、同环境、已成功合同中当前可读取的签署前原 PDF（技术名称：ORIGINAL） | 可以 | 系统会复制成新合同自己的文件 |
| 签署完成后的 PDF（signed） | 不可以 | 这是签署结果，不能再当作新的签署原件 |
| 合同附件 | 不可以 | 附件不是合同的签署原件 |
| 其他企业或其他环境的文件 | 不可以 | 不同企业和环境的数据不能混用 |
| 损坏或校验失败的文件 | 不可以 | 系统无法确认它是有效 PDF |
| 已经删除的文件 | 不可以 | 文件已经不可用 |
上传和读取 PDF 时要注意
- 每个文件不能超过 20 MiB。
- 文件必须是真实有效的 PDF，不能只修改扩展名。
- 文字型 PDF 可以分页读取和总结；扫描件暂不支持 OCR。
- 扫描件会提示
no_text，加密文件会提示encrypted，损坏文件会提示invalid_pdf。 - 能读到签后 PDF 的正文，只说明文字可以提取，不代表电子签名、证书或合同效力已经验证。