stamply 文档使用 AI Agent
自然语言指令 · Credits 规则 · 工具集 · 限制
13 个原子能力工具
AI Agent 通过组合 13 个原子能力完成所有盖章任务：
| 类别 | 工具 | 干啥 |
|---|---|---|
pdf_list | 列出当前打开的 PDF | |
pdf_pages | 读指定页文字 + bbox | |
pdf_layout | 用 PaddleOCR 识别版式（签字栏 / 印章位） | |
pdf_export | 导出盖章版 PDF | |
| seal | seal_list / seal_get / seal_create / seal_delete | 印章库 CRUD |
| stamp | stamp_list / stamp_put / stamp_delete | 落章 CRUD |
| editor | editor_state / editor_focus | 编辑器状态 |
常用指令示例
| 你说的 | Agent 怎么做 |
|---|---|
| 「给乙方位置盖合同章 + 法人章」 | seal_list → pdf_layout（找签字栏 / 印章位）→ stamp_put × 2 |
| 「这份合同盖骑缝章」 | seal_list 找公章 → pdf_list 拿页数 → stamp_put type=kiss（自动分段） |
| 「找出所有要签字的地方都签上」 | pdf_list → 循环 pdf_layout → 过滤 type=='signature' → 循环 stamp_put |
| 「第 3 页的章移到第 5 页」 | stamp_list pageIndex=2 → stamp_put 改 pageIndex |
| 「导出」 | editor_state → pdf_export |
字段契约（避免落章错位）
pdf_layout 返回 blocks，每个 block 有两套坐标：
xMm/yMm/wMm/hMm= bbox 左上角 + 宽高centerXMm/centerYMm= 几何中心（= xMm + wMm/2）
stamp_put 的坐标是印章中心点，所以 Agent 必须用 centerXMm/centerYMm 喂给 stamp_put。SYSTEM_PROMPT 内已强制约束。
suggestedWidthMm（仅 seal / signature 类有）= 推荐印章宽度，可直接喂 stamp_put.widthMm。
Credits 规则
MVP 阶段：
- 注册即送 100 credits
- 每月续 100 credits（约 50 页盖章额度）
pdf_layout每页消耗 2 credits- 其他工具不耗 credits
- LLM 对话每轮消耗 1 credits（含工具调用循环）
充值：
- 200 credits = ¥4
- 500 credits = ¥10（最划算）
- 2000 credits = ¥40
Credits 永不过期。
三层信任边界（重要，涉及数据流向）
stamply 是平台对外包装的 AI 服务，你看不到也不需要配置任何 API Key。这意味着 AI 请求会经过三层处理：
| 层级 | 角色 | 看到什么 | 留存吗 |
|---|---|---|---|
| L1 平台层 (stamply) | 转发 + Credits 计费 | 你的 Agent 对话 + tool 调用 | 不留存原文，只记 token 计数用于扣 Credits |
| L2 LLM provider | 当前是 DeepSeek（国内，合规） | OCR 返回的文本片段 + 你的指令 | 按 provider 自家政策，DeepSeek 不用于训练 |
| L3 你（本地浏览器） | 真正解析 PDF + 渲染 + 落章 | PDF 原文 | 完全在本机内存，刷新即丢 |
关键事实：
- PDF 二进制原文永远不离开你的浏览器（纯客户端引擎）
pdf_layoutOCR 把当前页 PNG 发给自托管 PaddleOCR（你或你公司控制的服务器，见PADDLE_LAYOUT_URL）- LLM 只看到 OCR 返回的文本 + 坐标 + 你的对话指令，看不到 PDF 二进制
敏感合同建议：
- 走私有部署（把 stamply + PaddleOCR + LLM 全装在你内网）
- 或等 Phase D 的 E2E 加密上线再用
已知限制
- 数据隐私边界：见上方三层信任边界。stamply 平台不留存 PDF 原文，但 LLM provider 会看到 OCR 文本片段
- OCR 推理速度：本机 Mac CPU 单页 3.5s，生产 GPU < 0.3s。慢时可调
PADDLE_TIMEOUT_MSenv - 撤销栈：Agent 落错章 ⌘Z 撤回，深度 100。骑缝章撤销会一并撤所有派生页
- 失败兜底：Agent 看到 tool error 会自我修正（重试 / 换路径），但仍可能落错章，你随时 ⌘Z
下一步：印章库管理