style(代码风格): 统一参数注释与代码格式

ofdgo_geom_backend.go

@@ -30,21 +30,19 @@ const (
 // GeometryOperation 指定路径填充区域的布尔运算
 type GeometryOperation uint8
 
-// StrokeOptions 描述描边参数，长度单位为毫米，MiterLimitSet区分显式零值与默认截断值
+// StrokeOptions 描述描边参数，长度单位为毫米
+// Width须为正有限数；Cap和Join使用OFD名称，空值分别采用Butt和Miter
+// MiterLimit为尖角长度与半线宽的比值上限，MiterLimitSet区分显式零值与默认值
+// DashOffset为虚线起始偏移，允许负值；Dashes交替指定实线段和间隔长度，奇数项按重复一遍处理
+// Tolerance为曲线展开的误差目标，0采用后端默认精度
 type StrokeOptions struct {
-	// Width为正有限描边宽度
+	Width         float64
-	Width float64
+	Cap, Join     string
-	// Cap和Join使用OFD名称，空值分别采用Butt和Miter
-	Cap, Join string
-	// MiterLimit为尖角长度与半线宽的比值上限
 	MiterLimit    float64
 	MiterLimitSet bool
-	// DashOffset为绝对长度的虚线相位，允许负值
+	DashOffset    float64
-	DashOffset float64
+	Tolerance     float64
-	// Tolerance为曲线展开误差目标，0采用后端默认精度
+	Dashes        []float64
-	Tolerance float64
-	// Dashes为交替绘制和留空的绝对长度，奇数项按重复一遍处理
-	Dashes []float64
 }
 
 // GeometryBackend 操作库自有路径，坐标以页面左上角为原点，不修改任何输入

ofdgo_sign_write.go

@@ -44,27 +44,26 @@ type SignatureWriteMode uint8
 // SM2数字签名使用GB/T35275-2017消息结构；RSA/ECDSA使用裸签名，验签需WithSignatureCert
 // Seal仅接受已有合法SES v4电子印章，使用SM2/SM3，不声明GM/T0031-2025兼容
 // TrustRoots必须显式指定；证书吊销状态和外部业务授权由调用方在签署前检查
+// Time为签署方声明的时间，不是可信时间戳，零值取当前时间；Lock保护签名列表，禁止后续追加签署
+// ExistingVerifyOptions用于追加签署前和写出后的验证，可提供已有裸签名的验证证书
+// ReaderOptions用于打开加密包；Encryption为空时继承阅读器的加密策略
+// Compression在计算签名前优化图像，不改写已有签名保护的资源
 type SignatureWriteOptions struct {
-	Signer        crypto.Signer
+	Signer                crypto.Signer
-	Certificate   []byte
+	Certificate           []byte
-	TrustRoots    [][]byte
+	TrustRoots            [][]byte
-	Intermediates [][]byte
+	Intermediates         [][]byte
-	Seal          []byte
+	Seal                  []byte
-	Stamps        []SignatureStamp
+	Stamps                []SignatureStamp
-	Mode          SignatureWriteMode
+	Mode                  SignatureWriteMode
-	// Time是自报签署时间，不是可信时间戳；零值取当前时间
+	Time                  time.Time
-	Time     time.Time
+	Provider              SignatureProvider
-	Provider SignatureProvider
+	Lock                  bool
-	// Lock保护签名列表，禁止后续追加签署
-	Lock bool
-	// ExistingVerifyOptions用于追加前与写出后回验，例如提供其他旧裸签名的证书
 	ExistingVerifyOptions []SignatureVerifyOption
-	// ReaderOptions用于打开加密包；Encryption为空时继承阅读器的加密策略
+	ReaderOptions         []ReaderOption
-	ReaderOptions []ReaderOption
+	Encryption            *EncryptionOptions
-	Encryption    *EncryptionOptions
+	Compression           CompressionOptions
-	// Compression在签名计算前优化图片，已有签名的资源不额外改写
+	progress              editorProgress
-	Compression CompressionOptions
-	progress    editorProgress
 }
 
 // signatureWriteInfo 写出签名信息，省略数字签名中不存在的印章