安装与卸载
==========

安装
----

Windows
~~~~~~~

*计量视觉系统 MeterVision* 以 Windows 安装程序形式提供
（例如 ``MeterVision-2.2-Setup.exe``）。

运行安装程序并按屏幕提示完成安装。

Linux (Astra Linux)
~~~~~~~~~~~~~~~~~~~

在 Linux 上，MeterVision 以 deb 软件包形式提供，并附带自动安装脚本
``install_deb.sh`` (适用于 Astra Linux 及其他 Debian 类系统)。

1. 将 deb 文件与 ``install_deb.sh`` 复制到同一目录。
2. 在该目录打开终端并执行：

.. code-block:: bash

   chmod +x install_deb.sh
   ./install_deb.sh
   # 或显式指定：
   ./install_deb.sh ./metervision_*.deb

脚本将：

* 把软件包安装到带版本号的目录，例如 ``/opt/MeterVision-2.2``；
* 创建符号链接 ``/opt/MeterVision`` → 当前版本目录；
* 在依赖出错时尝试通过 ``apt-get install -f`` 修复；
* 在桌面和应用程序菜单中创建快捷方式；
* 安装程序所用字体（通过 ``install_fonts.sh``）。

字体（包括 Comic Sans MS）也可单独安装：

.. code-block:: bash

   chmod +x install_fonts.sh
   ./install_fonts.sh
   # 为所有用户安装：
   ./install_fonts.sh --system

安装完成后，可通过双击快捷方式启动，或运行（请替换为实际版本号）：

.. code-block:: bash

   /opt/MeterVision-2.2/MeterVision
   # 或通过指向当前版本的链接：
   /opt/MeterVision/MeterVision

macOS
~~~~~

在 macOS 上，程序以磁盘映像 **MeterVision.dmg** 形式提供
（例如 ``MeterVision_2.2.dmg``）。

安装步骤：

1. 双击打开 ``MeterVision.dmg``，Finder 中会显示 ``MeterVision.app``
   以及“应用程序”（Applications）文件夹快捷方式。
2. 将 ``MeterVision.app`` 拖入“应用程序”（或任意位置）。
3. 如不再需要，可推出（卸载）该 DMG 卷。
4. 在“应用程序”中双击 ``MeterVision.app`` 启动程序。

无需通过终端安装。

若系统阻止未识别开发者的应用，可通过右键菜单选择“打开”，
或在“系统设置”→“隐私与安全性”中允许运行。

所有操作系统
~~~~~~~~~~~~~~

若要启用 *神经网络* 识别方法，需安装 *TesseractOCR* 引擎，  
并在 MeterVision 程序设置中添加 *TesseractOCR* 可执行文件的路径。

卸载
----

Windows
~~~~~~~

可通过 Windows 操作系统的标准方式卸载程序  
（控制面板中的“添加或删除程序”），或运行程序目录中的 `uninst000.exe` 文件。

Linux
~~~~~

使用系统工具卸载软件包，例如：

.. code-block:: bash

   sudo apt-get remove metervision
   # 或：
   sudo dpkg -r metervision

如需删除快捷方式：

.. code-block:: bash

   rm -f ~/Desktop/MeterVision.desktop
   rm -f ~/.local/share/applications/MeterVision.desktop

macOS
~~~~~

从“应用程序”中删除 ``MeterVision.app``（移到废纸篓）。
安装完成后可删除 ``MeterVision.dmg`` 文件。
工作目录 ``~/Documents/MeterVision`` 不会自动删除。

.. _catalog:

程序目录
--------

程序首次启动后，将自动创建一个程序目录（工作目录），其默认位置为：

- Windows: %USERPROFILE%\Documents\MeterVision  
- macOS 与 Linux: ~/Documents/MeterVision

可在主菜单中更改工作目录：:ref:`settings` → **工作目录...**。
选择新目录后，当前程序文件会复制到该目录，之后程序仅在新目录中继续工作。
这也使得可以并行运行多个程序实例或版本——各自使用独立的工作目录，互不冲突。

所选工作目录的路径保存在**默认目录**（``Documents/MeterVision``）中的 ``settings/work_dir.txt``，
而不是程序安装目录。启动时程序先查看默认目录；若其中指定了其他可用目录，则使用该目录，否则继续使用默认目录。

目录结构如下：

.. code-block:: none

   MeterVision
   ├── input
   │   ├── command.txt               # 可发送给程序的外部命令文件
   │   ├── ip_cameras.txt            # 程序使用的 IP 摄像头列表
   │   └── socket_config.txt         # socket 连接配置文件
   ├── license
   │   ├── license.key               # 许可证密钥
   │   └── query.key                 # 许可证请求文件
   ├── log
   │   └── window.log                # 程序运行日志文件
   ├── output
   │   ├── 1.txt, 2.txt, ...         # 识别结果文件
   │   ├── results.txt               # 汇总结果文件
   │   ├── figures
   │   │   ├── graduation_graph_*.png   # 标定图
   │   └── screenshots
   │       ├── *.png                 # 程序自动生成的截图
   └── settings
       ├── user.settings             # 用户设置文件
       └── work_dir.txt              # 所选工作目录的指针（仅存在于默认目录）

文件夹说明：

- **output** — 存放识别结果（文本文件）、截图（位于 *screenshots* 子目录中），  
  以及标定图像（位于 *figures* 子目录中）。  
- **input** — 包含外部命令文件、IP 摄像头列表及 socket 连接设置，  
  可在此指定接收识别数据的客户端主机和端口。  
- **settings** — 用户设置及程序运行参数；在默认目录中还可能包含 ``work_dir.txt``。  
- **license** — 与许可相关的文件。  
- **log** — 程序运行日志文件。

此目录在下文中称为 *程序目录*。

许可证
------

程序安装并首次运行后，将在 *license* 文件夹中生成 *query.key* 文件。  
要获取许可证密钥，请将该文件发送给权利人 OOO "Dipol-Integratsiya"（Dipaul）：
网站 https://dipaul.ru/，电话 8 800 200 02 66，邮箱 info@dipaul.ru。

具有法律约束力的最终用户许可协议仅提供俄文版，见发行包中的 ``LICENSE.md`` 文件
以及俄文文档（安装与设置 → 许可证）。
一份许可证绑定一台计算机；期限由密钥决定；转移到其他计算机须联系权利人。