文档 - 参数配置 自动化控制规则 文档

KdanAutoTest/KdanAuto/Class/AutoTestCase/StringAutoBackTest.swift

@@ -0,0 +1,330 @@
+//
+//  CharacterAutoTest.swift
+//  KdanAuto
+//
+//  Created by 朱东勇 on 2022/11/22.
+//
+
+import Foundation
+import Cocoa
+
+class StringAutoBackTest : StringAutoTest {
+    
+    
+    override func needTest() -> Bool {
+        return self.selectedKeys().count > 0
+    }
+    
+    
+    override class func shared() -> AutoTest? {
+        return StringAutoBackTest()
+    }
+    
+//    // Auto Test refrence Check File
+//    override func autoTest(_ complention:@escaping (_ object:AutoTest, _ report:NSAttributedString?) -> ()) {
+//        self.compareFinishedFiles.removeAllObjects();
+//        self.convertFiles.removeAllObjects()
+//
+//        clearCacheFiles()
+//
+//        let needCheckString = self.selectedKeys().contains("字符")
+//
+//        if !needCheckString {
+//            _status = .Finished
+//            complention(self, self.reportString)
+//            return
+//        }
+//
+//        _status = .Process
+//        reportString = NSMutableAttributedString.init(string: "\n【\(String(self.fileType())) - \(self.name())】字符比对开始!\n",
+//                                                      attributes:[.foregroundColor : NSColor.blue])
+//        let files = DataModel.shared.originFilesFor(_fileType, type: _type)
+//        self.testFiles = NSArray(array: files);
+//
+//        let checkDirectory = self.checkFileDirectory()
+//        let originDirectory = self.originFileDirectory()
+//        let resultDirectory = self.resultFileDirectory()
+//
+//        if (files.count > 0) {
+//            try? FileManager.default.createDirectory(atPath: checkDirectory, withIntermediateDirectories: true);
+//            try? FileManager.default.createDirectory(atPath: resultDirectory, withIntermediateDirectories: true);
+//        }
+//
+//        var tDegree = Double(0);
+//        var tCount = Int(0)
+//        var fileIndex = 0;
+//
+//        var convertFileBlock = { (files:[String]) in }
+//        convertFileBlock = { (files:[String]) in
+//            if (fileIndex >= files.count) {
+//                TestDegreeManager.shared().set(((tCount != 0) ? tDegree/Double(tCount) : 0.0),
+//                                               fileType: self.fileType(),
+//                                               type: self.type())
+//
+//                self._status = .Finished
+//                DispatchQueue.main.async {
+//                    autoreleasepool {
+//                        complention(self, self.reportString);
+//                    }
+//                }
+//                return
+//            }
+//
+//            let fileName = files[fileIndex]
+//            let fName = NSString(string: fileName).deletingPathExtension
+//            let originPath = NSString(string: originDirectory).appendingPathComponent(fName+".pdf")
+//            let resultPath = NSString(string: resultDirectory).appendingPathComponent(fName+"."+self.extention())
+//            let checkPath = NSString(string: checkDirectory).appendingPathComponent(fName+"."+self.extention())
+//
+//
+//            self.reportString?.append(NSMutableAttributedString.init(string: "\n【\(String(self.fileType())) - \(self.name())】开始转换文件 \"\(fName)\"\n",
+//                                                                     attributes:[.foregroundColor : NSColor.black]))
+//            // ...
+//            // 执行转换过程
+//            let index = self.testFiles.index(of: fileName);
+//            if (index != NSNotFound) {
+//                self.convertProgress = Double(index) / Double(self.testFiles.count)
+//            }
+//            self.convertFiles.add(fileName);
+//            self.testlog("开始转换："+fileName, (self.compareProgress + self.convertProgress)/2.0)
+//            self.process(originPath, resultPath: resultPath) { status in
+//                if FileManager.default.fileExists(atPath: resultPath) && status == 1 {
+//                    if needCheckString && FileManager.default.fileExists(atPath: checkPath) {
+//                        DispatchQueue.global().async {
+//                            let checkString = self.readTextFile(checkPath as NSString)
+//                            let resultStr = self.readTextFile(resultPath as NSString)
+//
+//                            if (checkString != nil && resultStr != nil) {
+//                                let maxSize = checkString!.count
+//                                let report = NSMutableAttributedString(string: "")
+//                                let degree = self.compareString(checkString as! NSString, result: resultStr as! NSString) { appAttr in
+//                                    report.append(appAttr)
+//                                }
+//                                //                                let degree = self.compareString(checkString as! NSString, result: resultStr as! NSString) { skipString, failString in
+//                                //                                    self.appendErrorInfo(skipString, failString: failString)
+//                                //                                }
+//
+//                                var color = NSColor.black
+//                                if fabs(degree-100.0) >= 0.01 {
+//                                    color = NSColor.red
+//                                }
+//                                tDegree += degree;
+//                                tCount += 1
+//
+//                                TestDegreeManager.shared().set(degree,
+//                                                               fileType: self.fileType(),
+//                                                               type: self.type(),
+//                                                               fileName: fileName)
+//
+//                                let successCount = Int(maxSize * Int(degree)/100)
+//                                report.append(NSAttributedString.init(string: "【\(String(self.fileType())) - \(self.name())】文件 \"\(fName)\"比对完成，准确率\(degree)%(\(successCount)/\(maxSize))\n",
+//                                                                      attributes:[.foregroundColor : color]))
+//                                if (report != nil) {
+//                                    do {
+//                                        let rtfData = try? report.data(from: .init(location: 0, length: report.length),
+//                                                                       documentAttributes: [.documentType: NSAttributedString.DocumentType.rtf])
+//
+//                                        let path = NSString(string: resultPath).appendingPathExtension("rtf")
+//                                        try? FileManager.default.removeItem(atPath: path!);
+//                                        try? rtfData?.write(to: NSURL.fileURL(withPath: path!))
+//                                    } catch {
+//                                    }
+//                                    self.reportString?.append(report)
+//                                }
+//                            }
+//
+//                            let index = self.testFiles.index(of: fileName);
+//                            if (index != NSNotFound) {
+//                                self.compareProgress = Double(index) / Double(self.testFiles.count)
+//                            }
+//                            self.compareFinishedFiles.add(fileName);
+//                            self.testlog("对比完成："+fileName, (self.compareProgress + self.convertProgress)/2.0)
+//
+//                            fileIndex += 1
+//                            convertFileBlock(files);
+//                        }
+//                    }else {
+//                        self.reportString?.append(NSMutableAttributedString.init(string: "【\(String(self.fileType())) - \(self.name())】对照文件 \"\(fName)\"不存在!\n",
+//                                                                                 attributes:[.foregroundColor : NSColor.red]))
+//
+//                        let index = self.testFiles.index(of: fileName);
+//                        if (index != NSNotFound) {
+//                            self.compareProgress = Double(index) / Double(self.testFiles.count)
+//                        }
+//                        self.compareFinishedFiles.add(fileName);
+//                        self.testlog("对比完成："+fileName, (self.compareProgress + self.convertProgress)/2.0)
+//
+//                        fileIndex += 1
+//                        convertFileBlock(files);
+//                    }
+//                }else {
+//                    if (status == 0) {
+//                        self.reportString?.append(NSMutableAttributedString.init(string: "【\(String(self.fileType())) - \(self.name())】文件 \"\(fName)\"转档失败!\n",
+//                                                                                 attributes:[.foregroundColor : NSColor.red]))
+//                    }else if (status == -1 || status == -2) {
+//                        self.reportString?.append(NSMutableAttributedString.init(string: "【\(String(self.fileType())) - \(self.name())】文件 \"\(fName)\"文档无法打开!\n",
+//                                                                                 attributes:[.foregroundColor : NSColor.red]))
+//                    }else if (status == -3) {
+//                        self.reportString?.append(NSMutableAttributedString.init(string: "【\(String(self.fileType())) - \(self.name())】文件 \"\(fName)\"转档中 Crash!\n",
+//                                                                                 attributes:[.foregroundColor : NSColor.red]))
+//                    }
+//
+//                    let index = self.testFiles.index(of: fileName);
+//                    if (index != NSNotFound) {
+//                        self.compareProgress = Double(index) / Double(self.testFiles.count)
+//                    }
+//                    self.compareFinishedFiles.add(fileName);
+//                    self.testlog("对比完成："+fileName, (self.compareProgress + self.convertProgress)/2.0)
+//                    fileIndex += 1
+//                    convertFileBlock(files);
+//                }
+//            }
+//        }
+//        convertFileBlock(files);
+//    }
+//
+//
+    /// Compare
+    override func compareString(_ check:NSString, result:NSString, callback:@escaping (_ appAttr:NSAttributedString)->()) -> Double {
+//    func compareString(_ check:NSString, result:NSString, failure:@escaping (_ skipString:NSString, _ failString:NSString)->()) -> Double {
+        return autoreleasepool {
+            var checkString = check
+            var resultStr = result
+            let maxSize = checkString.length
+            var successCount = 0;
+            /**
+             (A0 = B0)
+             - A-1 & B-1
+             (A0 != B0) & (A0 in B) & (B0 in A)
+             - 取 A0，B0最小 Range 值
+             - 字符串裁剪对齐
+             (A0 != B0) & (A0 in B)
+             - 存储B0到识别错误缓存
+             (A0 != B0) & (B0 in A)
+             - 存储 A0到识别遗漏字符串
+             (A0 != B0)
+             - 分别存储 A0、B0到遗漏及错误字串
+             */
+            var skipString = NSString()
+            var failString = NSString()
+            while (checkString.length > 0 && resultStr.length > 0) {
+                let subc = checkString.substring(to: 1) as NSString
+                let subr = resultStr.substring(to: 1) as NSString
+                
+                let cRange = checkString.range(of: subr as String)
+                let rRange = resultStr.range(of: subc as String)
+                
+                if subc.isEqual(to: subr) { // (A0 = B0)
+                                            // Check Success
+                    callback(attributeStringWith(skipString, failString: failString))
+//                    failure(skipString, failString)
+//                    self.appendErrorInfo(skipString, failString: failString)
+                    skipString = NSString()
+                    failString = NSString()
+                    
+                    
+                    checkString = checkString.substring(from:1) as NSString
+                    resultStr = resultStr.substring(from:1) as NSString
+                    successCount = successCount + 1
+                    callback(NSAttributedString(string: subc as String))
+                } else if (cRange.location != NSNotFound &&
+                           rRange.location != NSNotFound) {
+                    if (min(cRange.location, rRange.location) >= 2) {
+                        let nextc = checkString.substring(with: NSRange(location: 1, length: 1)) as NSString
+                        let nextr = resultStr.substring(with: NSRange(location: 1, length: 1)) as NSString
+                        let ncRange = checkString.range(of: nextr as String)
+                        let nrRange = resultStr.range(of: nextc as String)
+                        
+                        if (min(nrRange.location, ncRange.location) < min(cRange.location, rRange.location)) {
+                            if (ncRange.location < nrRange.location) {
+                                //‘subc' 字符串有在‘resultStr’中，但'subr'不在’checkString‘中，resultStr 往后推一
+                                skipString = skipString.appending(subc as String) as NSString
+                                checkString = checkString.substring(from:1) as NSString
+                            }else {
+                                //‘subc' 字符串有在‘resultStr’中，但'subr'不在’checkString‘中，resultStr 往后推一
+                                failString = failString.appending(subr as String) as NSString
+                                resultStr = resultStr.substring(from:1) as NSString
+                            }
+                        }else if (cRange.location < rRange.location) {
+                            //‘subc' 字符串有在‘resultStr’中，但'subr'不在’checkString‘中，resultStr 往后推一
+                            skipString = skipString.appending(subc as String) as NSString
+                            checkString = checkString.substring(from:1) as NSString
+                        }else {
+                            //‘subc' 字符串有在‘resultStr’中，但'subr'不在’checkString‘中，resultStr 往后推一
+                            failString = failString.appending(subr as String) as NSString
+                            resultStr = resultStr.substring(from:1) as NSString
+                        }
+                    }else {
+//                        var scale = (skipString.length > 0) ? (Float(checkString.length) / Float(skipString.length)) : Float(1.0)
+//                        if (checkString.length > skipString.length && cRange.location <= Int(Float(rRange.location)*scale)) {
+//                            //‘subc' 字符串有在‘resultStr’中，但'subr'不在’checkString‘中，resultStr 往后推一
+//                            skipString = skipString.appending(subc as String) as NSString
+//                            checkString = checkString.substring(from:1) as NSString
+//                        }else if (checkString.length <= skipString.length && cRange.location > Int(Float(rRange.location)*scale)) {
+//                            failString = failString.appending(subr as String) as NSString
+//                            resultStr = resultStr.substring(from:1) as NSString
+//                        }else
+                        if (cRange.location < rRange.location) {
+                            //‘subc' 字符串有在‘resultStr’中，但'subr'不在’checkString‘中，resultStr 往后推一
+                            skipString = skipString.appending(subc as String) as NSString
+                            checkString = checkString.substring(from:1) as NSString
+                        }else  {
+                            //‘subc' 字符串有在‘resultStr’中，但'subr'不在’checkString‘中，resultStr 往后推一
+                            failString = failString.appending(subr as String) as NSString
+                            resultStr = resultStr.substring(from:1) as NSString
+                        }
+//                        //                    self.appendErrorInfo(skipString, failString: failString)
+//                        callback(attributeStringWith(skipString, failString: failString))
+//                        //                    failure(skipString, failString)
+//                        skipString = NSString()
+//                        failString = NSString()
+//
+//                        // C:a[bcde]fghij
+//                        // R:f[klmnbvcx]a
+//                        if (cRange.location < rRange.location) {
+//                            let cacheString = checkString.substring(to:cRange.location + cRange.length)
+//                            callback(attributeStringWith(cacheString as NSString, failString: ""))
+//                            //                        failure(cacheString as NSString, "")
+//                            //                        self.reportString?.append(NSMutableAttributedString.init(string: "对照字符串【\(cacheString)】未识别到\n",
+//                            //                                                                                 attributes:[.foregroundColor : NSColor.red]))
+//                            checkString = checkString.substring(from:cRange.location) as NSString
+//                        }else {
+//                            let cacheString = resultStr.substring(to:rRange.location)
+//                            callback(attributeStringWith("", failString: cacheString as NSString))
+//                            //                        failure("", cacheString as NSString)
+//                            //                        self.reportString?.append(NSMutableAttributedString.init(string: "字符串【\(cacheString)】识别出错\n",
+//                            //                                                                                 attributes:[.foregroundColor : NSColor.red]))
+//                            resultStr = resultStr.substring(from:rRange.location + rRange.length) as NSString
+//                        }
+                    }
+                }else if (cRange.location != NSNotFound) {
+                    //‘subc' 字符串有在‘resultStr’中，但'subr'不在’checkString‘中，resultStr 往后推一
+                    skipString = skipString.appending(subc as String) as NSString
+                    checkString = checkString.substring(from:1) as NSString
+                }else if (rRange.location != NSNotFound) {
+                    //‘subc' 字符串有在‘resultStr’中，但'subr'不在’checkString‘中，resultStr 往后推一
+                    failString = failString.appending(subr as String) as NSString
+                    resultStr = resultStr.substring(from:1) as NSString
+                }else {
+                    //  两个子字串均未找到
+                    skipString = skipString.appending(subc as String) as NSString
+                    failString = failString.appending(subr as String) as NSString
+                    
+                    checkString = checkString.substring(from:1) as NSString
+                    resultStr = resultStr.substring(from:1) as NSString
+                }
+            }
+            
+            skipString = skipString.appending(checkString as String) as NSString
+            failString = failString.appending(resultStr as String) as NSString
+//            failure(skipString, failString)
+            callback(attributeStringWith(skipString, failString: failString))
+            callback(NSAttributedString(string: "\n"))
+            
+            let degree = (maxSize>1) ? Double(Float(successCount)/Float(maxSize) * 100) : 0
+            
+            return degree
+        }
+    }
+    
+}

PropertySettingGuide/PropertySettingGuide.md

@@ -0,0 +1,318 @@
+#转档参数设置帮助
+
+##一、背景
+‘KdanAuto’作为用于(半)自动化转档测试工具，用于降低重复的、需要占用大量QA 人力的工作量的工具，其App 自身的开发时间投入，也是需要纳入重点考虑。
+     
+基于未来转档、DocumentAI SDK 将会长期投入开发，相关控制参数定会持续增加， 用于同步测试的 KdanAuto 必然需要能够同步支持所新增的参数；同时 QA 用于测试的用例也必然会是随着需求增加而不断增长，相应测试项需要有更灵活的设置方式。
+
+因此，设计了该套 【SDK新增参数 -》更新控制规则 -》App 启动加载自动配置】 控制规则，如下图：
+
+![KdanAuto 参数规则控制流程](KdanAuto 参数规则控制流程.png)
+图 1.1.1 KdanAuto 参数规则控制流程
+
+##二、参数控制规则文档效果及样式
+注：该文档以转档 SDK1.7.0版本参数参考拟定
+
+###1、JPEG/PNG 格式
+- SDK  JPEG 格式参数信息
+![](jpeg.params.png)
+<center>图 2.1.1 SDK JPEG 格式参数信息<center/>
+
+- 参数控制 UI 效果
+ ![](jpeg.png)
+<center>图 2.1.2 参数控制 UI 效果<center/>
+
+- 参数规则属性配置
+![](jpeg.property.png)
+<center>图 2.1.3 参数规则属性配置<center/>
+
+- 参数规则配置详情
+
+		<key>JPEG</key>
+		<dict>
+			<key>Classs</key>
+			<array>
+				<dict>
+					<key>Name</key>
+					<string>快照对照测试</string>
+					<key>Class</key>
+					<string>AutoTest</string>
+				</dict>
+			</array>
+			<key>Extention</key>
+			<string>jpg</string>
+			<key>Params</key>
+			<array>
+				<dict>
+					<key>ValueType</key>
+					<string>int</string>
+					<key>Property</key>
+					<string>imageDpi</string>
+					<key>Name</key>
+					<string>Image DPI</string>
+					<key>DefaultValue</key>
+					<integer>216</integer>
+				</dict>
+				<dict>
+					<key>ValueType</key>
+					<string>BOOL</string>
+					<key>Property</key>
+					<string>isContainAnnotations</string>
+					<key>Name</key>
+					<string>Contain Annotations</string>
+					<key>DefaultValue</key>
+					<false/>
+				</dict>
+			</array>
+		</dict>
+
+###2、CSV 格式
+- SDK CSV 格式参数信息
+![](csv.params.png)
+<center>图 2.2.1 SDK CSV 格式参数信息<center/>
+
+- 参数控制 UI 效果
+ ![](csv.png)
+<center>图 2.2.2 参数控制 UI 效果<center/>
+
+- 参数规则属性配置
+![](csv.property.png)
+<center>图 2.2.3 参数规则属性配置<center/>
+
+- 参数规则配置详情
+
+
+		<key>CSV</key>
+		<dict>
+			<key>Classs</key>
+			<array>
+				<dict>
+					<key>Name</key>
+					<string>快照对照测试</string>
+					<key>Class</key>
+					<string>AutoTest</string>
+				</dict>
+			</array>
+			<key>Extention</key>
+			<string>csv</string>
+			<key>Params</key>
+			<array>
+				<dict>
+					<key>ValueType</key>
+					<string>BOOL</string>
+					<key>Property</key>
+					<string>isMergeCSV</string>
+					<key>Name</key>
+					<string>Merge CSV</string>
+					<key>DefaultValue</key>
+					<false/>
+				</dict>
+			</array>
+		</dict>
+
+###3、TXT 格式
+- SDK TXT 格式参数信息
+![](txt.params.png)
+<center>图 2.3.1 SDK TXT 格式参数信息<center/>
+
+- 参数控制 UI 效果
+ ![](txt.png)
+<center>图 2.3.2 参数控制 UI 效果<center/>
+
+- 参数规则属性配置
+![](txt.property.png)
+<center>图 2.3.3 参数规则属性配置<center/>
+
+
+###4、HTML 格式
+- SDK HTML 格式参数信息
+![](html.params.png)
+<center>图 2.4.1 SDK HTML 格式参数信息<center/>
+
+- 参数控制 UI 效果
+ ![](html.png)
+<center>图 2.4.2 参数控制 UI 效果<center/>
+
+- 参数规则属性配置
+![](html.property.png)
+<center>图 2.4.3 参数规则属性配置<center/>
+
+
+###5、Excel 格式
+- SDK Excel 格式参数信息
+![](excel.params.png)
+<center>图 2.5.1 SDK Excel 格式参数信息<center/>
+
+- 参数控制 UI 效果
+ ![](excel.png)
+<center>图 2.5.2 参数控制 UI 效果<center/>
+
+- 参数规则属性配置
+![](excel.property.png)
+<center>图 2.5.3 参数规则属性配置<center/>
+
+
+###6、PPT 格式
+- SDK PPT格式参数信息
+![](ppt.params.png)
+<center>图 2.6.1 SDK PPT 格式参数信息<center/>
+
+- 参数控制 UI 效果
+ ![](ppt.png)
+<center>图 2.6.2 参数控制 UI 效果<center/>
+
+- 参数规则属性配置
+![](ppt.property.png)
+<center>图 2.6.3 参数规则属性配置<center/>
+
+
+###7、Word 格式
+- SDK Word格式参数信息
+![](word.params.png)
+<center>图 2.7.1 SDK Word 格式参数信息<center/>
+
+- 参数控制 UI 效果
+ ![](word.png)
+<center>图 2.7.2 参数控制 UI 效果<center/>
+
+- 参数规则属性配置
+![](word.property.png)
+<center>图 2.7.3 参数规则属性配置<center/>
+
+
+###8、RTF 格式
+- SDK RTF格式参数信息
+![](rtf.params.png)
+<center>图 2.8.1 SDK RTF 格式参数信息<center/>
+
+- 参数控制 UI 效果
+ ![](rtf.png)
+<center>图 2.8.2 参数控制 UI 效果<center/>
+
+- 参数规则属性配置
+![](rtf.property.png)
+<center>图 2.8.3 参数规则属性配置<center/>
+
+###9、PDF 格式
+注：PDF -> PDF : PDF 文档对照测试，实际内部用到的转档为 PDF 转 JPEG格式，然后进行的 JPEG 图片对照
+
+- SDK JPEG格式参数信息
+<center>![](jpeg.params.png)<center/>
+<center>图 2.9.1 SDK JPEG 格式参数信息<center/>
+
+- 参数控制 UI 效果
+ ![](pdf.png)
+<center>图 2.9.2 参数控制 UI 效果<center/>
+
+- 参数规则属性配置
+![](pdf.property.png)
+<center>图 2.9.3 参数规则属性配置<center/>
+
+
+##三、参数设置规则
+### Classs - 测试类型设置
+作用于具体文档的具体测试类型，目前有支持的测试类型有：AutoTest（全类型文档，自动转档及快照对照测试）、PDFCompareTest（PDF 文档，逐页快照对比测试）、StringAutoTest（TXT/RTF 文档，自动转档及字符对比测试）、StringAutoCompare（TXT/RTF 文档，字符对比测试)
+
+#### Class 类型
+#####-【AutoTest】
+	
+- 用途：用于自动化转档到各种类型文档，再进行快照（JPEG 格式），然后将（新旧）快照（JPEG 格式）进行逐个相素对比
+
+- 支持格式：支持全类型格式，PDF、RTF、WORD、PPT、Excel、CSV、HTML、TXT、JPEG、PNG、GIF、TIFF、TGA、BMP、JPEG2000
+
+#####- 【PDFCompareTest】
+
+- 用途：用于对 PDF 文档，进行逐页快照对比测试；例如，在 Windows 端用命令行工具批量执行出来的结果文档，用该工具进行对照确认
+
+- 支持格式：PDF
+
+#####- 【StringAutoTest】
+
+- 用途：用于自动化转档到字符化文档（如 TXT、RTF），再将结果文档与初始字符文档进行字符对照测试
+
+- 支持格式：RTF、TXT
+
+
+#####- 【StringAutoCompare】
+
+- 用途：用于自动化对比字符化文档（如 TXT、RTF）的结果文档和对照文档，例如在 Windows 端做 OCR 识别，然后在 Mac 端进行结果对比
+
+- 支持格式：RTF、TXT
+
+
+####Class 参数设置
+
+#####- 示例一
+
+		//例如 Word 文档进行设置，支持做 【快照对照】
+		
+		<key>Classs</key>
+		<array>
+			<dict>
+				<key>Name</key>
+				<string>快照对照测试</string>
+				<key>Class</key>
+				<string>AutoTest</string>
+			</dict>
+		</array>
+
+![](word.class.png)
+图 3.1.1 Word 格式 Classs 参数设置效果示意图 
+
+#####- 示例二
+	
+	
+		//RTF 文档支持【转档快照对照】、【转档对比测试】、【字符对比操作】
+		<key>Classs</key>
+		<array>
+			<dict>
+				<key>Name</key>
+				<string>快照对照测试</string>
+				<key>Class</key>
+				<string>AutoTest</string>
+			</dict>
+			<dict>
+				<key>Name</key>
+				<string>字符对照测试</string>
+				<key>Class</key>
+				<string>StringAutoTest</string>
+			</dict>
+			<dict>
+				<key>Name</key>
+				<string>跨平台字符对比测试</string>
+				<key>Class</key>
+				<string>StringAutoCompare</string>
+			</dict>
+		</array>
+
+
+![](rtf.class.png)
+图 3.1.2 RTF 格式 Classs 参数设置效果示意图 
+
+### Extention - 结果文档格式后缀设置
+对应文档类型（转档后）对照(/对比)测试的文档后缀名称，每种格式对应指定一种后缀格式名称，字符串属性值
+
+- PDF：对应后缀 pdf
+-  RTF：对应后缀 rtf
+-  Word: 对应后缀 docx
+-  PPT: 对应后缀 pptx
+-  Excel：对应后缀 xlsx
+-  CSV: 对应后缀 csv
+-  HTML: 对应后缀 html
+-  TXT：对应后缀 txt
+-  JPEG：对应后缀 jpg
+-  PNG：对应后缀 png
+-  GIF：对应后缀 gif，新库暂不支持
+-  TIFF：对应后缀 tiff，新库暂不支持
+-  TGA：对应后缀 tga，新库暂不支持
+-  BMP：对应后缀 bmp，新库暂不支持
+-  JPEG2000：对应后缀jp2, 新库暂不支持
+
+![](all.extention.png)
+图 3.2.1 Extention参数设置示意
+
+### Params - 转档控制参数设置
+用于控制转档成各种文档过程中的转档控制参数，支持参数种类有 *BOOL*、*Bool*、*bool*、*size_t*、*int*、*uint8_t*、*int8_t*、*int16_t*、*uint16_t*、*int32_t*、*uint32_t*、*int64_t*、*uint64_t*、*NSInteger*、*NSUInteger*、*float*、*double*、*CGRect*、*NSRect*、*CGSize*、*NSSize*、*NSString*以及*枚举值*
+
+####1、各
+