# 安全使用与问题报告

当前main是未发布的0.2.0开发候选。整改与验证入口见[2026-11-07记录](docs/security-20261107.md)。已发布0.1.1不含本轮防护；本轮结论不能回填旧包或历史r2。

源码预算按阶段执行，阶段收尾可能追加少量诊断。默认 SVG 输出上限为 32 MiB UTF-8，可通过专用 API 配置。解析器接收外部解码器结果时会检查 UTF-8 字节长度，回调自身的用时和内存由调用方管理。详见[资源预算](docs/resource-limits.md)。

库不访问网络、不执行DXF内嵌内容，不加载外部图像/参照。原始字节与记录是权威保留视图；Drawing/Geometry是派生语义视图。结构保留、几何重建与检查完整性分别判断，不能把普通模式退出0当安全/标准符合性证明。

语义视图进一步拒绝超过256字符的标识字段或65536字符的文本字段，避免重复展开放大诊断/渲染字符串；原始tag仍保留。这是派生视图的保守预算，不把原始文本剪成另一个名字或图形。

默认读取最多64 MiB、单行/字符串各1 MiB、100万个tag、20万条组码0记录、1000条扫描警告；超限停止并诊断。流式调用方应在`is_limited()`后停止读取。手工构造的TagScan/Drawing及提高自定义预算由调用方负责，不构成内存沙箱。`ReadDocument.source`保留调用方已经分配的原始字节，预算不能撤回这项分配。

展开默认限1万输出实体、20万点、10万访问、8层路径。几何拓扑/相交/净距共用100万次候选访问预算；耗尽为检查不完整。解码与展开在约1000条诊断后截断；不同阶段独立计数，ReadLimits.max_warnings仅指扫描阶段。渲染限制20万点及65536个文字字符。预算是有限工作量防线，不是固定峰值内存或墙钟耗时保证；服务应在独立进程设置外部内存/时间限制。

网页在读取前限制16 MiB，使用可终止Worker、15秒检查超时、取消与任务代次隔离；文件字节转移到Worker后再编码。预算仍允许中间表示并存。网页不上传文件；历史Pages演示不会随main自动升级。

当前 XY 检查与预览保守接受零或绝对值在 1e-100 至 1e100 的坐标及相应尺度。超出范围时拒绝完整结论，WCS 可保留原值。使用 CheckOptions 的入口共用 tol，新入口可独立配置离散、平面与比较容差。浮点近退化条件仍需专项验证。

普通缺陷请向[GitHub Issues](https://github.com/mik1e80/dxfkit/issues)提供源码SHA、工具链、最小输入、调用入口、预期依据与实际结果。含秘密或可利用细节时，不要贴入公开Issue；如仓库启用私密漏洞报告，使用GitHub Security入口，否则先提交不含利用细节的联系请求。没有声明固定响应时限或全面漏洞/依赖扫描认证。
