master_task_710395169

tests/test_headhaul_document_tools.py

@@ -113,6 +113,8 @@ class HeadhaulDocumentToolContractTest(unittest.TestCase):
         )
         self.assertIn('使用场景：', metadata['description'])
         self.assertIn('禁止使用：', metadata['description'])
+        self.assertIn('文档类型名称 - 文件维度', metadata['description'])
+        self.assertIn('完整显示名', metadata['description'])
 
     def test_prepare_does_not_declare_upload_widget(self):
         metadata = PrepareHeadhaulDocumentUploadTool().metadata()

tools/list_headhaul_document_filter_options.py

@@ -18,6 +18,11 @@ class ListHeadhaulDocumentFilterOptionsTool:
                 'query_headhaul_document_list、prepare_headhaul_document_upload或'
                 'save_headhaul_document。查询文档类型用于列表；添加文档类型用于签发和保存，'
                 '没有写入权限时不可用；录入单号种类用于确认号码类型。'
+                '查询文档类型和添加文档类型的显示名是「文档类型名称 - 文件维度」，'
+                '例如「提单 - 柜子」。关键字按整段显示名匹配。'
+                '用户只说出文档类型名称且不止一条显示名对得上时，必须先列出完整显示名请用户选择；'
+                '选定前不得把类型 ID 传给查询、签发或保存。只有一条对得上时使用该条 value。'
+                '录入单号种类不带文件维度。'
                 '禁止使用：本工具不返回文档业务数据，禁止猜测任何筛选值，'
                 '也禁止用于报关资料或订单附件。参数只用于工具内部调用；'
                 '最终回答只能展示中文业务名称；描述筛选条件时不得展示筛选字段的英文参数名。'

tools/prepare_headhaul_document_upload.py

@@ -11,6 +11,9 @@ class PrepareHeadhaulDocumentUploadTool:
             'description': (
                 '使用场景：用户要上传头程文档文件且已在对话窗口添加该文件时，'
                 '先确认添加文档类型，再调用本工具签发一次性上传槽位。'
+                '添加文档类型的显示名是「文档类型名称 - 文件维度」。'
+                '用户只说了类型名称且不止一条对得上时，先列出完整显示名请用户选择，选定前不要签发。'
+                '只有一条对得上时使用该条 value。'
                 '签发后由宿主把窗口里的文件 POST 到返回的上传地址，并带上upload_token。'
                 '禁止使用：选文件框、把文件内容放进工具参数、打开独立上传页、'
                 '改走报关资料或订单附件、让用户去 home 后台上传。'
@@ -25,6 +28,7 @@ class PrepareHeadhaulDocumentUploadTool:
                         'description': (
                             '要添加的文档类型。必须先调用'
                             'list_headhaul_document_filter_options并选择“添加文档类型”。'
+                            '显示名含文件维度。不止一条对得上类型名称时，先请用户按完整显示名选择。'
                         ),
                     },
                 },

tools/query_headhaul_document_list.py

@@ -20,7 +20,8 @@ class QueryHeadhaulDocumentListTool:
                 'minimum': 1,
                 'description': (
                     '文档类型。必须先调用list_headhaul_document_filter_options'
-                    '并选择“查询文档类型”取得可传值。'
+                    '并选择“查询文档类型”取得可传值。显示名含文件维度。'
+                    '不止一条对得上类型名称时，先请用户按完整显示名选择。'
                 ),
             },
             'original_name': {
@@ -43,6 +44,9 @@ class QueryHeadhaulDocumentListTool:
                 '使用场景：用户要看头程文档列表时，必须先有文档类型、完整文件名'
                 '或已经标明种类的录入单号之一，再查询当前页。对照后台'
                 'admin/document/index，一行一份文件或外链。号码类型不明确时必须先询问用户，'
+                '按文档类型查询时，显示名是「文档类型名称 - 文件维度」。'
+                '用户只说了类型名称且不止一条对得上时，先列出完整显示名请用户选择，选定前不要查询。'
+                '只有一条对得上时使用该条 value。'
                 '不得根据号码格式猜测，不得跨字段或跨工具试查，也不得改走'
                 'query_customs_declaration_files或订单附件。'
                 '禁止使用：空扫全表、混查单号框、行内编辑、把文件放进工具参数。'

tools/save_headhaul_document.py

@@ -11,6 +11,9 @@ class SaveHeadhaulDocumentTool:
             'description': (
                 '使用场景：上传成功返回ticket_ref之后，或用户只要外链时，'
                 '用本工具保存一份新的头程文档。必须带添加文档类型和至少一条已确认种类的录入单号。'
+                '添加文档类型的显示名是「文档类型名称 - 文件维度」。'
+                '用户只说了类型名称且不止一条对得上时，先列出完整显示名请用户选择，选定前不要保存。'
+                '只有一条对得上时使用该条 value。'
                 'ticket_ref和外链不能同时提交。没有行内编辑；要改只能删除后重加。'
                 '禁止使用：手填OSS路径、混放号码种类、把文件放进工具参数。'
                 '参数只用于工具内部调用；最终回答只能展示中文业务名称。'
@@ -24,6 +27,7 @@ class SaveHeadhaulDocumentTool:
                         'description': (
                             '要添加的文档类型。必须先调用'
                             'list_headhaul_document_filter_options并选择“添加文档类型”。'
+                            '显示名含文件维度。不止一条对得上类型名称时，先请用户按完整显示名选择。'
                         ),
                     },
                     'ticket_ref': {