图灵工具 TLTools10 -- Creo Parametric 10 辅助工具插件
版本 1.1.16      Copyright (C) 2026 Mr Wang 版权所有
================================================================

  本次更新（1.1.16）
    1) 模型树/绘图区右键「复制模型名称」= 复制**鼠标选中的那个**零件/组件名
       （此前会错误地复制成整个组件的名字）
    2) 技术资料详情页图片：修掉 jpg 显示不出来的问题；页面上图片扩展名与
       实际文件格式不一致时也会自动纠正
    3) 六视图导出 DWG：改用 Creo 系统默认模板，不再要求先配模板路径；
       批量导出工程图仍使用设置页里指定的模板
    4) 浮窗不再「总在最前」：修掉插件窗口打开后 Creo 绘图区左右键点不动、
       只剩中键可用的问题。需要置顶时：TLconfig\TLTools10.ini 里加 [Window] topmost=1
    5) 「关于图灵」页新增网站 https://tl.singzo.cn 与联系提示
    6) 「关于图灵」页新增在线更新：启动插件自动检查，有新版本会弹提醒；
       也可点右下角「检查更新」手动查、「前往网站」直达下载页
    7) 技术资料改为随包提供：TLconfig\TechPages\（一页一个 HTML）+ TLconfig\TechImages\


一、包内容
  TLTools10.dll          插件主体（Release x64，Creo 10.0.3.0 Pro/TOOLKIT 编译）
  protk.dat              插件注册文件（exec_file / text_dir 按 D:\Creo10_Config\Tools\TLTools10 预设）
  TLconfig\              配置目录（4 个 ini 文件，见第三节）
  text\chinese_cn\       菜单与提示文字（Pro/TOOLKIT 消息文件，text_dir 指向本目录）
  chinese_cn\            同上的兼容副本（旧版布局用，可保留）
  安装说明.txt           本文件

二、安装步骤（推荐装到 D:\Creo10_Config\Tools\TLTools10）
  1) 退出 Creo。
  2) 把整个 TLTools10 文件夹复制到 D:\Creo10_Config\Tools\ 下，即成为
     D:\Creo10_Config\Tools\TLTools10\TLTools10.dll。
     如果装到别的目录：用记事本打开 protk.dat，把 exec_file 与 text_dir 两行改成实际路径，
     例如装在 E:\TLTools10 时：
         exec_file E:\TLTools10\TLTools10.dll
         text_dir  E:\TLTools10
  3) 注册插件：在 Creo 启动目录的 config.pro 里加一行：
         protkdat D:\Creo10_Config\Tools\TLTools10\protk.dat
     本机该文件是 D:\Creo10_Config\Temp\config.pro（注意别被前面的 ! 注释掉）。
     也可以在 Creo 里用「工具 -> 辅助应用程序 -> 注册」，选到 protk.dat 后点「启动」。
  4) 重新启动 Creo。菜单栏出现「图灵工具」，点它下面的「打开图灵工具」即弹出浮窗。
     注册成功时，程序目录会生成 TLTools10.log（需 LogEnable=1）。

三、配置文件（TLconfig 目录，均为 UTF-8，可用记事本编辑）
  TLTools10.ini     主配置。多数项在浮窗「设置」页里改，改动后自动保存（立即写回本文件）。
      SetLastDir                是否把工作目录设为最后打开（1 是 / 0 否）
      RmbDisable                关闭右键菜单，防止覆盖其他插件（1 是 / 0 否）
      YtRandomColorOpt          批量随机色策略：asUG=UG 预设 18 色 / random=随机亮色
      YtExportDwgDIr            DWG 导出目录：deskTop=桌面 / byUser=每次询问 / 其他=固定目录
      YtExportPdfDIr            同上（PDF）
      YtExportStpDir            同上（STEP）
      FileNameUppercase_BATCH   批量导出 STP/IGS/SAT 文件名大小写（uppercase/lowercase）
      FileNameUppercase_QUICK   快速导出 STP/DWG/PDF 文件名大小写
      LogEnable                 是否写 TLTools10.log（1 是 / 0 否）
      A0Asmpath / A0Prtpath ... A4HPrtpath
                                12 个图幅模板路径（A0~A4、A4 横向，装配/零件各一），
                                在浮窗「工程图」页点「浏览」选择，改动后自动保存
      提示：工作目录、右键菜单这类选项要重启 Creo 才生效。
  TLBom.ini         BOM 表头与取值来源映射
      [tableCols_sum] / [tableCols_level]   总表 / 层级 BOM 的表头（半角逗号分隔）
      [tableCols_map]   表头 -> 取值来源：
                        @INDEX 序号 / @TYPE 物料类别 / @FILENAME 图号 / @QTY 数量 /
                        @IMAGE 图示 / @LEVELPATH 层级路径 为系统字段；
                        其余写模型参数名，如 MC_CODE、MC_NAME、MC_TYPE、Size、UNIT...
                        值写 Auto 表示由系统自动计算（取自 TLParams.ini）。
                        本版「物料类别」默认取模型上客户自定义参数 MC_TYPE 的值。
      [tableStyle]      样式：zebra 斑马纹、asmRowColor 装配行底色、
                        snapshotWidth/Height 截图尺寸、imageCrop/imageScale 裁切与缩放
      改完在浮窗「导出BOM」页点「导入配置文件」即可刷新表头。
  TLBatchParam.ini  批量参数方案。[BatchParams] 留空时，程序按内置默认行生成：
                    DESIGNER / SIZE / MC_CODE / MC_NAME / MC_TYPE / MATERIAL_PROCESS / UNIT / BOM_NOTE
                    再补 TLBom.ini 里其它参数名来源的表头（判重忽略大小写）。
  TLParams.ini      Auto 取值映射（如「外观尺寸」自动取产品外形尺寸）。
  TechPages\        「技术资料」的页面目录：一条资料 = 一个 .html 文件（UTF-8）。
                    这是资料库的唯一来源，可自行增删改（记事本就能编辑）。
                    文件名随便起（列表里显示的是页面里的 <title>），页面头部写元信息：
                        <title>标题</title>
                        <meta name="category" content="钣金设计标准">   （分类，可省）
                        <meta name="keywords" content="折弯,弯曲半径">   （关键词，可省）
                        <meta name="desc" content="一句话说明">          （列表描述，可省）
                    正文就是普通 HTML（段落、表格、列表都行）。分类下拉固定含
                    技术支持 / 塑胶设计标准 / 钣金设计标准 / 压铸设计标准 / 标准件参数查询 / 其他。
                    图片用相对路径引用（下面 TechImages 目录）：
                        <div class="tl-img"><img src="../TechImages/名字.png"></div>
  TechImages\       「技术资料」用到的图片目录；在详情窗口点「插入图片」会自动复制到这里，
                    并把图片块追加到该页面正文的最后一行（独占一行，不会与文字挤在一起）。
  TLTechData.txt    旧版数据文件（可选）。首次运行且 TechPages 目录里没有任何页面时，
                    程序会自动把旧文件逐条迁移成页面文件，并把旧文件改名为 TLTechData.txt.bak。
                    迁移后的资料库仍保持 40+ 条（齿轮/螺纹计算公式、IT 公差表、AG 玻璃、
                    压铆件参数表、螺纹牙距表、钣金/塑胶/压铸设计标准等）。

四、排错
  菜单没出现：
      1) config.pro 里的 protkdat 行是否被 ! 注释掉、路径是否正确；
      2) Creo「工具 -> 辅助应用程序」里该插件是否为「正在运行」；
      3) protk.dat 里 exec_file 指向的 DLL 是否真实存在（路径不要写错盘符）。
  功能失败：看 TLTools10.log（与 DLL 同目录）里的错误码与提示；参数写入、导出、颜色都会记录。

五、界面操作要点
  - 10 个选项卡：批量参数 / 导出BOM / 批量操作 / 视图颜色 / 元件操作 / 工程图 / 设置 /
    技术资料 / 常用标准件 / 关于图灵。
  - 窗口可自由调整大小：拖右下角斜线抓手、拖任意边框，或用最大化按钮；
    窗口太小时页面右侧会自动出现滚动条，也支持鼠标滚轮。
  - 批量参数页：上方「筛选范围」选应用对象（当前模型 / 当前装配所有零件 / 当前装配含子装配 /
    会话中所有模型），点「应用筛选」可看命中模型数；表格里双击单元格直接改（名称/值/说明都能改），
    勾选框决定「应用」哪些行（都不勾选＝应用全部）。右键菜单可粘贴/复制/清空单元格、增删行、批量勾选。
  - 技术资料页：关键词搜索（空格分词＝同时包含）+ 分类下拉，搜索按钮紧跟在关键词框后面；
    列表显示「标题 + 描述」；点条目（或双击、点「查看详情」）内嵌显示该页面的 HTML，
    可直接「编辑内容」改源码、「插入图片」、「新建页面」、「删除页面」、「打开页面目录」。
    一条资料＝TLconfig\TechPages 下的一个 .html 文件，可自行增删改，改完点「重新载入」。
  - 常用标准件页：先「选择目录」指定存放常用零件的文件夹（可勾「含子目录」）→「刷新列表」；
    选中条目后「装配到当前」（双击同效）：
        当前是装配   → 直接装配元件（放在原点，之后自行添加约束）；
        当前是零件/钣金 → 以导入特征方式新建主体（等价于 合并/继承 - 外部参考 - 添加主体，
                        注意是几何导入，与源件不关联）。
  - 设置页、工程图页的选项改动后立即自动保存，无需再点保存按钮。
  - 底部状态栏右侧三个小方格分别显示：当前模型类型 / 表格行数或条目数 / 筛选范围。

六、卸载
  1) 从 config.pro 中删除 protkdat 那一行（或在「辅助应用程序」里停止并移除注册）。
  2) 删除 D:\Creo10_Config\Tools\TLTools10 整个目录即可。

================================================================

  本次更新（1.1.16）
    1) 模型树/绘图区右键「复制模型名称」= 复制**鼠标选中的那个**零件/组件名
       （此前会错误地复制成整个组件的名字）
    2) 技术资料详情页图片：修掉 jpg 显示不出来的问题；页面上图片扩展名与
       实际文件格式不一致时也会自动纠正
    3) 六视图导出 DWG：改用 Creo 系统默认模板，不再要求先配模板路径；
       批量导出工程图仍使用设置页里指定的模板
    4) 浮窗不再「总在最前」：修掉插件窗口打开后 Creo 绘图区左右键点不动、
       只剩中键可用的问题。需要置顶时：TLconfig\TLTools10.ini 里加 [Window] topmost=1
    5) 「关于图灵」页新增网站 https://tl.singzo.cn 与联系提示
    6) 「关于图灵」页新增在线更新：启动插件自动检查，有新版本会弹提醒；
       也可点右下角「检查更新」手动查、「前往网站」直达下载页
    7) 技术资料改为随包提供：TLconfig\TechPages\（一页一个 HTML）+ TLconfig\TechImages\

本版更新（1.0.15 / 2026-09-24）
  - BOM「图号」改为**完整文件名（带后缀）**，如 ABC.PRT / ABC.ASM，一眼区分零件与组件
    （原来是不带后缀的文件名）。同件号判定也改用完整文件名。
  - 需要旧的"去后缀"写法时，把 TLBom.ini 的映射改成：图号=@MDLNAME
    （系统字段：@INDEX 序号 / @TYPE 物料类别 / @FILENAME 完整文件名 / @MDLNAME 去后缀名 /
      @QTY 数量 / @LEVELPATH 层级路径 / @IMAGE 图示）
================================================================

  本次更新（1.1.16）
    1) 模型树/绘图区右键「复制模型名称」= 复制**鼠标选中的那个**零件/组件名
       （此前会错误地复制成整个组件的名字）
    2) 技术资料详情页图片：修掉 jpg 显示不出来的问题；页面上图片扩展名与
       实际文件格式不一致时也会自动纠正
    3) 六视图导出 DWG：改用 Creo 系统默认模板，不再要求先配模板路径；
       批量导出工程图仍使用设置页里指定的模板
    4) 浮窗不再「总在最前」：修掉插件窗口打开后 Creo 绘图区左右键点不动、
       只剩中键可用的问题。需要置顶时：TLconfig\TLTools10.ini 里加 [Window] topmost=1
    5) 「关于图灵」页新增网站 https://tl.singzo.cn 与联系提示
    6) 「关于图灵」页新增在线更新：启动插件自动检查，有新版本会弹提醒；
       也可点右下角「检查更新」手动查、「前往网站」直达下载页
    7) 技术资料改为随包提供：TLconfig\TechPages\（一页一个 HTML）+ TLconfig\TechImages\

上一版更新（1.0.14 / 2026-09-24）
  - 「复制模型名称」右键菜单项改为中文（标签/帮助取自 tlmsg_display.txt 的消息键）。
  - 模型树右键菜单项注册改为「失败自动重试」：init 时菜单未就绪会返回 -1，
    现在会在右键菜单创建通知里、以及每次打开浮窗时自动补挂，并在日志里记录每次结果。
  - 复制名称取值优先级：右键菜单可用性回调捕获的选择 → 选择缓冲 → 当前模型，
    日志会写明本次取值的来源，便于定位「只能复制当前模型名」之类的现象。
  - 为排查绘图区右键异常：默认不再往 Creo 原生右键菜单（图形窗口选择菜单）注入我们的项，
    只在日志里记录 Creo 创建的右键菜单名。需要时可用 ini 开关打开（见下）。
  - 查看详情页改用「把页面内容直接写入浏览器」的方式显示（配合注入的 <base>），
    不再依赖 file:// 对中文文件名的解码；同时修正控件尺寸同步（避免渲染区 0 尺寸一片空白），
    并在日志里记录写入字符数、正文长度与 base 地址，便于定位显示异常。
  - 常用标准件页：「目录分类」下拉与「选择目录 / 含子目录 / 刷新列表」确认在同一排
    （上一版个别文件被外部编辑器回退，本版已重新落实）。

  新增 ini 开关（TLconfig\TLTools10.ini，可手工添加）：
      [CopyName]
      popup=1     往图形窗口的右键选择菜单里也注入「复制模型名称」（默认 0=不注入）
      notify=0    完全不注册右键菜单创建通知（默认 1=注册；怀疑通知影响右键菜单时置 0）
================================================================

  本次更新（1.1.16）
    1) 模型树/绘图区右键「复制模型名称」= 复制**鼠标选中的那个**零件/组件名
       （此前会错误地复制成整个组件的名字）
    2) 技术资料详情页图片：修掉 jpg 显示不出来的问题；页面上图片扩展名与
       实际文件格式不一致时也会自动纠正
    3) 六视图导出 DWG：改用 Creo 系统默认模板，不再要求先配模板路径；
       批量导出工程图仍使用设置页里指定的模板
    4) 浮窗不再「总在最前」：修掉插件窗口打开后 Creo 绘图区左右键点不动、
       只剩中键可用的问题。需要置顶时：TLconfig\TLTools10.ini 里加 [Window] topmost=1
    5) 「关于图灵」页新增网站 https://tl.singzo.cn 与联系提示
    6) 「关于图灵」页新增在线更新：启动插件自动检查，有新版本会弹提醒；
       也可点右下角「检查更新」手动查、「前往网站」直达下载页
    7) 技术资料改为随包提供：TLconfig\TechPages\（一页一个 HTML）+ TLconfig\TechImages\

上一版更新（1.0.13 / 2026-09-24）
  - 批量参数页取消右侧「批量编辑」面板：参数直接在表格里双击修改，应用范围由勾选框决定
    （都不勾选＝应用全部）；右键菜单提供粘贴（中文输入兜底）、复制、清空、增删行、批量勾选；
    F2 改参数值、Delete 删行。
  - 中文输入：新增「输入法结果串直接插入」（WM_IME_COMPOSITION + GCS_RESULTSTR），
    不再依赖编辑框自身处理，解决中文敲进去不显示的问题；同时把输入法与文本消息写入日志便于定位。
  - 技术资料改为「一条资料一个 HTML 页面」：文件放在 TLconfig\TechPages，标题/分类/关键词/描述
    写在页面头部的 <title> 与 <meta> 里；详情窗口内嵌 HTML 显示，可编辑源码、插入图片（追加到
    正文最后一行）、新建/删除页面、一键打开页面目录；旧的 TLTechData.txt 首次运行自动迁移为页面。
  - 技术资料页按钮顺序调整：「搜索」紧跟在关键词框后面，最右侧是「重置 / 重新载入」。
  - 常用标准件页：「目录分类」下拉与「选择目录 / 含子目录 / 刷新列表」放在同一排。
================================================================

  本次更新（1.1.16）
    1) 模型树/绘图区右键「复制模型名称」= 复制**鼠标选中的那个**零件/组件名
       （此前会错误地复制成整个组件的名字）
    2) 技术资料详情页图片：修掉 jpg 显示不出来的问题；页面上图片扩展名与
       实际文件格式不一致时也会自动纠正
    3) 六视图导出 DWG：改用 Creo 系统默认模板，不再要求先配模板路径；
       批量导出工程图仍使用设置页里指定的模板
    4) 浮窗不再「总在最前」：修掉插件窗口打开后 Creo 绘图区左右键点不动、
       只剩中键可用的问题。需要置顶时：TLconfig\TLTools10.ini 里加 [Window] topmost=1
    5) 「关于图灵」页新增网站 https://tl.singzo.cn 与联系提示
    6) 「关于图灵」页新增在线更新：启动插件自动检查，有新版本会弹提醒；
       也可点右下角「检查更新」手动查、「前往网站」直达下载页
    7) 技术资料改为随包提供：TLconfig\TechPages\（一页一个 HTML）+ TLconfig\TechImages\

上一版更新（1.0.12 / 2026-09-23）
  - 菜单/命令标签改为英文（TLTools / Open TLTools / Copy Model Name），避免中文菜单显示异常。
  - 中文输入：为浮窗与所有输入框显式关联默认输入法上下文；批量编辑新增「粘贴」按钮兜底；
    参数写入改为「含中文一律按字符串处理」并记录日志（类型=实数/字符串）。
  - 状态栏右侧方格改为按页面显示：模型类型（各页）+ 行数/条目数（表格页）+ 筛选范围（仅批量参数页）。
  - 常用标准件：新增「目录分类」下拉，列表按目录分类排序，不再混在一起。
  - 技术资料：搜索行改为 分类 → 关键词 → 搜索；列表只显示「标题 + 描述」；
    分类下拉固定为 技术支持 / 塑胶设计标准 / 钣金设计标准 / 压铸设计标准 / 标准件参数查询 / 其他；
    详情窗口改为可编辑富文本（自动换行、可插入图片、可保存回 TLTechData.txt）。
  - 技术资料新增：齿轮计算公式、螺纹计算公式、IT 公差等级表、AG 防眩光玻璃、压铆螺母/螺柱/螺钉参数、
    螺纹牙距表（含图片说明），并补充压铸设计标准 3 条。
  - 工程图页：模板路径只保留 A4 横向的零件/装配两项（A0~A3 取消）。
================================================================

  本次更新（1.1.16）
    1) 模型树/绘图区右键「复制模型名称」= 复制**鼠标选中的那个**零件/组件名
       （此前会错误地复制成整个组件的名字）
    2) 技术资料详情页图片：修掉 jpg 显示不出来的问题；页面上图片扩展名与
       实际文件格式不一致时也会自动纠正
    3) 六视图导出 DWG：改用 Creo 系统默认模板，不再要求先配模板路径；
       批量导出工程图仍使用设置页里指定的模板
    4) 浮窗不再「总在最前」：修掉插件窗口打开后 Creo 绘图区左右键点不动、
       只剩中键可用的问题。需要置顶时：TLconfig\TLTools10.ini 里加 [Window] topmost=1
    5) 「关于图灵」页新增网站 https://tl.singzo.cn 与联系提示
    6) 「关于图灵」页新增在线更新：启动插件自动检查，有新版本会弹提醒；
       也可点右下角「检查更新」手动查、「前往网站」直达下载页
    7) 技术资料改为随包提供：TLconfig\TechPages\（一页一个 HTML）+ TLconfig\TechImages\

上一版更新（1.0.11 / 2026-09-23）
  - 新增「技术资料」选项卡：关键词搜索 + 分类筛选 + 列表；点条目弹窗看完整内容（可复制全文）。
    资料库文件 TLconfig\TLTechData.txt，内置 26 条（钣金材料/公差/表面处理、螺纹底孔、自攻孔径、
    压铆件、焊接喷涂、塑胶材料/缩水/壁厚/拔模/倒扣/公差/喷油电镀、DFM 检讨等），可自行扩写。
  - 新增「常用标准件」选项卡：指定零件库目录（可含子目录）→ 列出所有零件 → 装配到当前；
    装配模式直接装配，零件/钣金模式以导入特征新建主体（非关联几何）。
  - 批量编辑输入框中文乱码/不显示：改为多路解码兜底 + 输入法字节对修正（同时写日志便于排查）。
  - 状态栏去掉版权信息。
================================================================

  本次更新（1.1.16）
    1) 模型树/绘图区右键「复制模型名称」= 复制**鼠标选中的那个**零件/组件名
       （此前会错误地复制成整个组件的名字）
    2) 技术资料详情页图片：修掉 jpg 显示不出来的问题；页面上图片扩展名与
       实际文件格式不一致时也会自动纠正
    3) 六视图导出 DWG：改用 Creo 系统默认模板，不再要求先配模板路径；
       批量导出工程图仍使用设置页里指定的模板
    4) 浮窗不再「总在最前」：修掉插件窗口打开后 Creo 绘图区左右键点不动、
       只剩中键可用的问题。需要置顶时：TLconfig\TLTools10.ini 里加 [Window] topmost=1
    5) 「关于图灵」页新增网站 https://tl.singzo.cn 与联系提示
    6) 「关于图灵」页新增在线更新：启动插件自动检查，有新版本会弹提醒；
       也可点右下角「检查更新」手动查、「前往网站」直达下载页
    7) 技术资料改为随包提供：TLconfig\TechPages\（一页一个 HTML）+ TLconfig\TechImages\

上一版更新（1.0.10 / 2026-09-22）
  - 工程字符集改为 Unicode，修正「批量编辑」输入中文不显示/乱码的问题（并带兜底解码）。
  - 修复浮窗右侧被遮挡：去掉按客户区裁剪窗口的逻辑，恢复边框；新增右下角拖动抓手，
    窗口可拖动改变大小、可最大化。
  - 「设置」「工程图」页取消保存按钮，选项改动后自动保存。
  - 「工程图」页把视角/比例/模板路径的说明分别放到各自框内，取消重叠。
  - BOM「物料类别」取模型自定义参数 MC_TYPE（TLBom.ini 映射同步为 物料类别=MC_TYPE）。
  - 参数列表不再多出一行重复的 Size；MC_TYPE 默认值改为「钣金结构件」。
