密钥格式不正确问题源于私钥与公钥不匹配、PEM结构损坏或编码污染，需依次验证模数一致性、检查PEM边界与Base64完整性、清除隐藏字符、转换为PKCS#1格式，并利用内置诊断工具定位具体错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在WorkBuddy中输入密钥后收到“密钥格式不正确”提示，且该密钥为RSA密钥对（如用于SSH认证、JWT签名验证或API身份鉴权），则问题极可能源于私钥与公钥不匹配、PEM结构损坏或编码污染。以下是针对性排查与修复步骤：
一、验证RSA密钥对是否成对生成
WorkBuddy要求使用的RSA私钥必须与其对应公钥由同一组原始参数生成，任意一方被替换、截断或重导出均会导致签名/验签失败，系统将拒绝加载并报格式错误。需确认二者数学关联性而非仅检查文件存在。
1、使用OpenSSL命令行提取私钥的模数（modulus）：
openssl rsa -in private.key -noout -modulus
2、提取公钥的模数：
openssl rsa -pubin -in public.key -noout -modulus
3、比对两次输出的Modulus值是否完全一致（区分大小写与换行）；若不一致，说明密钥对不匹配，必须重新生成完整密钥对。
二、检查PEM封装完整性与边界标记
WorkBuddy严格校验RSA密钥的PEM格式：私钥必须以-----BEGIN RSA PRIVATE KEY-----或-----BEGIN PRIVATE KEY-----开头，公钥必须以-----BEGIN PUBLIC KEY-----开头，结尾标记须严格对应，且中间Base64内容不得含空行、空格或非ASCII字符。
1、用记事本打开私钥文件，确认首行精确为-----BEGIN RSA PRIVATE KEY-----（注意无空格、无中文破折号、无多余空行）。
2、检查末行是否为-----END RSA PRIVATE KEY-----，且与首行配对；若使用PKCS#8格式，则应为-----BEGIN PRIVATE KEY-----与-----END PRIVATE KEY-----。
3、在Base64正文区域内，逐行检查是否每行长度≤64字符、无空格、无制表符；若发现任意一行含空格或长度超64，需用文本编辑器手动拆分并保存。
三、剥离富文本粘贴导致的隐藏控制字符
从网页、邮件或聊天工具复制RSA密钥时，常混入零宽空格（U+200B）、软连字符（U+00AD）、HTML实体（如 ）等不可见字符，导致OpenSSL解析失败，WorkBuddy底层调用即返回格式错误。
1、将密钥全文粘贴至Notepad++，启用「视图 → 显示符号 → 显示所有字符」，定位并删除¶（CR）、·（NBSP）、 （LS）等符号。
2、在VS Code中安装“Hex Editor”扩展，以十六进制模式打开密钥文件，搜索字节序列EF BB BF（UTF-8 BOM）或C2 A0（NBSP），全部清除。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
3、将清理后的密钥重新复制，使用curl命令测试基础解析：
curl -X POST https://workbuddy.codebuddy.cn/api/v1/validate/key -H "Content-Type: text/plain" --data-binary "@private.key"
四、强制转换为WorkBuddy兼容的PKCS#1格式
部分新生成的OpenSSH密钥默认采用PKCS#8（-----BEGIN PRIVATE KEY-----）或OpenSSH专有格式（starts with "-----BEGIN OPENSSH PRIVATE KEY-----”），而WorkBuddy当前版本仅支持传统PKCS#1 RSA私钥（-----BEGIN RSA PRIVATE KEY-----），需主动转换。
1、若密钥为OpenSSH格式，先转为PEM：
ssh-keygen -p -f id_rsa -m PEM
2、再转换为PKCS#1格式：
openssl pkcs8 -in id_rsa -traditional -out rsa_private_pkcs1.key
3、验证转换结果：
openssl rsa -in rsa_private_pkcs1.key -check -noout
执行后若输出“RSA key ok”，表明已符合WorkBuddy私钥格式要求。
五、使用WorkBuddy内置密钥诊断工具实时反馈
WorkBuddy v2.8.3起集成密钥语法预检模块，可在提交前对RSA密钥执行多层结构校验，包括PEM头尾匹配、Base64解码可行性、ASN.1 DER结构有效性及公私钥模数一致性快检。
1、进入WorkBuddy设置页→安全中心→密钥管理→RSA凭证配置区。
2、在私钥输入框内粘贴待测内容后，立即点击输入框外任意位置触发onBlur事件。
3、观察输入框下方红色提示信息：
“Invalid PEM header”表示边界标记错误；
“Base64 decode failed at line 5”指向具体损坏行；
“Modulus mismatch with public key”说明公私钥不匹配。
根据提示信息精准定位问题层级，避免盲目重试。
