Official Product Validation

ePdf 产品能力验证页

这个页面只走正式产品入口，用来按接近成品的方式验证我们已经交付的产品能力。 它会自动处理 Bearer API key、文件上传、任务轮询和结果打开，不再要求你手工复制 `job_id`、`artifact_id` 才能完成一次验证。

打开调试工具箱 默认验证能力：上传、分析、编辑、合并、比较、脱敏、拆分、转换、提取、表单、批处理、工作流
10+ 当前页面覆盖的正式产品能力。提交、查询和编排都走正式产品入口，不暴露 `/_debug/smoke/*` 之类的快捷按钮。
2 两类入口区分明确：这里验证成品能力；`/debug.html` 专门用于 trace、provider、手动推进和排障。
Bearer 所有正式写接口都要求 API key。这个页面会把同一把 key 自动带到文件上传、任务提交和结果读取链路里。

连接与凭证

先让页面连到 test 环境，并确认正式 API 鉴权可用。

尚未验证

        

          说明：上传文件、提交 PDF 操作、批处理和工作流都依赖 Bearer API key。
          文件内容上传会沿用 `/v1/files/upload-url` 返回的受控 upload URL。
          如果这里验证不过，后面的产品能力页也不会成功。
        

      


      

        

          
源文件准备

          
先上传一到两个真实 PDF，后面的产品能力会直接引用它们。

        

      

      

        

          
源文件 A

          
推荐先上传一个最普通的 PDF，用来验证分析、编辑、脱敏、拆分、转换和提取。

          
          
          
          
          

            
            
            
          

          

            未就绪
            上传成功后会显示 file_id、文件名和内容类型。
          

          

        


        

          
源文件 B

          
用于验证合并和比较。你可以上传第二个 PDF，也可以复用另一个已有文件。

          
          
          
          
          

            
            
            
          

          

            未就绪
            合并和比较要求至少有两个有效源文件。
          

          

        

      


      

        

          
文档能力验证

          
这些卡片只触发正式产品能力。每次点击都会自动提交、轮询，并保留最近一次结果。

        

      

      

        

          
分析 PDF

          
验证 `pdf.analyze` 是否能读取文档基础结构，并返回分析记录。

          
          
          

            
          

          

          

        


        

          
编辑 PDF

          
用最直接的用户动作验证 `pdf.edit`：在指定页面增加一段文字。

          
          
          
          
          

            

              
              
            

            

              
              
            

            

              
              
            

          

          

            
          

          

          

        


        

          
合并 PDF

          
把源文件 A 和源文件 B 合并成一个结果 PDF，用来验证最常见用户场景。

          

            
          

          

          

        


        

          
比较 PDF

          
比较源文件 A 和源文件 B，验证文本层与渲染级差异结果是否可用。

          

            
          

          

          

        


        

          
脱敏 PDF

          
把命中文本替换成指定内容，验证文本、元数据与产物链路是否正常。

          
          
          
          
          
          
          

            
          

          

          

        


        

          
拆分 PDF

          
按单页拆分当前文档，验证产物生成和多结果输出能力。

          
          
          

            
          

          

          

        


        

          
转换 PDF

          
把 PDF 转成文本类或图片类格式，验证 convert 能力和结果文件产出。

          
          
          
          
          

            
          

          

          

        


        

          
提取 PDF

          
验证 `pdf.extract` 的结构化内容提取能力。

          
          
          
          
          

            
          

          

          

        


        

          
表单填充

          
验证 `pdf.forms.fill` 的基础表单回填。适合已有简单 AcroForm 的 PDF。

          
          
          
          
          
          
          
          
          

            
          

          

          

        

      


      

        

          
平台编排验证

          
这部分验证批处理和工作流是否已经能作为成品能力对外提供。

        

      

      

        

          
批量分析

          
一次提交多个文件，验证 `batches -> jobs -> status` 的正式编排链。

          
          
          

            
          

          

          

        


        

          
工作流运行

          
创建并运行一个 `analyze -> edit` 的样例工作流。需要 `TenantAdmin` 角色的 API key。

          
          
          

            
          

          

          

        

      


      

        

          
能力边界说明

          
下面这些能力已经纳入产品验证页；更专业的链路继续留在调试工具箱。

        

      

      

        

          当前页面覆盖仓库中已经落地的正式能力：`pdf.analyze`、`pdf.extract`、`pdf.merge`、
          `pdf.split`、`pdf.edit`、`pdf.compare`、`pdf.redact`、`pdf.convert`、
          `pdf.forms.fill`、`files / jobs / batches / workflows`。
          `signatures.prepare/apply/verify` 仍然更偏专业流程，暂时保留在
          调试工具箱 做深入验证。