在之前的一篇文章里，我分享了在律师工作中，给自己写了个工具管理案件项目的经历。最近，我终于又有了一些时间来改善界面和功能，让它在可以记录项目的同时，也能够被用于知识管理。

这个过程总体是愉快的，每一点小的改进都让人有成就感。比方说，在参考了电脑上其他应用程序的界面后，我学着在左侧按钮选项上增加了一个“选中”标签的移动小动画。即使是这样的无用改动，都足以让我有个好的心情继续探索。

对比之下，最后一步的打包工作称得上是噩梦，这足足花费了我两天多的时间，数十次地往返于失败——再尝试——再失败之间，心态和睡眠质量都差了许多。

因此，在这篇文章中，一方面，我将简单介绍工具的使用方法，分享最近的改进成果，以推介给同行或者其他有类似项目/知识管理需求的朋友使用。另一方面，流水帐式地记录一下打包 PyQt 和 sqlite3 程序过程中遇到的各种坑和教训，以我为戒。

一、简单的介绍

你可以在这里，或这里（网盘）下载到更新后的版本。其中，zip 格式为 Windows 版本，dmg 格式为 macOS 版本，source code 为源文件，供修改或自行编译使用。

我是在 m1 macOS 环境开发，在虚拟机（Windows 11 arm）中打包为 Windows 版本的，也许有针对不同系统考虑不周之处，或者无法使用的情况。对于这些问题，欢迎与我联系，我会争取（职业病式备注：指在时间精力有限的情况下进行尝试但因知识和技术限制而不保证能成功）修正它。

（一）项目

管理项目是我设计这个程序的初衷所在，基本结构是“项目-案件-案件信息”。

在左侧的项目列表中，可以按标签和加入顺序来筛选项目，也可以通过搜索框直接搜索需要的项目。在项目列表的右键菜单中，可以对项目和案件进行基本的编辑操作，例如置顶或把案件更换到其他项目里。

对于预设了项目文件夹的项目，可以在列表上双击打开文件夹。点开状态栏图标的“访达”也可以打开项目文件夹，只不过那里只显示在办案件和知识库主题内容。

对于具体案件，右侧有四个标签页，分别用于展示录入的案件信息，填写和查看计划事项和案件记录，以及临时记事。至于每个案件可以记录哪些信息，是完全由用户自定义的，初始下只有民事诉讼和仲裁两项，但实际上不难通过“模板”功能自行扩展。

在案件信息栏内，除了查看信息详情的放大镜按钮，以及编辑按钮外，较为重要的是“导出/复制”。“导出/复制”按钮允许使用者导出一些格式化的信息，包括案件的描述信息、当事人信息和联系人的联系地址。

计划和记录标签页是两张表格，均支持右键复制选中行，或右下角导出全部内容。“计划”页面额外的功能是，在删除一行“计划”内容时，可以选择删除或者转为“记录”。

作为待办事项的总结，使用者可以点击状态栏图标，找到“今日简报”的功能，一次性查看全部项目未来15日内的计划安排。

（二）主题/知识库

实际上，这部分内容与项目管理没有本质区别，只是少了计划、记录和剪贴板。

对于主题，我只预置了“案例”这一种模板。但实际上，只要相应设计好模板，此处完全可以用来剪贴或总结文章、书籍或知识点。

除了日常查看浏览以外，将这些内容记录进来的好处在于方便导出。在这个界面，“导出/复制”按钮均用于复制整个主题的内容，并可粘贴于任意表格内（整个应用里的“导出”实际上都需要自行粘贴，而非导出为“xlsx”文件，我认为这样更灵活一点。此外，为了防止误操作清空剪贴板，“导出/复制”按钮默认设置下会弹出确认窗口）。

（三）当事人、联系人

单独来看，这只是一个有检索功能的电话簿，但实际上这部分功能主要是服务于案件管理的。

一方面，不论是在案件中还是这里修改当事人或联系人的信息，都始终相互同步。这些信息也当然会在不同案件中同步，这对于管理同一主体的不同案件，同一法官审理的不同案件，都是比较方便的。

另一方面，就像前面提到的，案件里的当事人和联系人可以导出为格式化信息。当事人可以导出类似起诉状开头的当事人信息。联系人则对应导出形如“xxx市xxx号 xxx（收） 电话：123xxxxx”的邮寄信息。

（四）模板

实际上，设置模板才是使用本工具的第一步，只不过我已经预设了部分内容。

对于项目和主题，每一个模板均可以添加三类信息：纯文本，当事人和联系人。

纯文本，即纯粹的文字信息。当事人和联系人如第三部分显示，并非简单的一行文字可以体现，而是包含了“名字”、“地址”、“电话”等不同类型的信息——这可以在相应的模板中设定。

利用模板，不难构造出诸如“案件——企业（当事人类）——注册地址（当事人字段）”，或者单纯的“主题——关键字（纯文字类）”的链条，将信息关联起来。

在前面案件信息的记录和展示中，纯文本直接记录和展示文字信息，而当事人和联系人还需要填写其在案件中的身份。

（五）设置

大体上，这个页面充分体现了制作者对自己的配色审美没有信心，省事地选择灰色配色并将色彩搭配方案交给用户的不良用心。

除此之外，用于可以在这个设置界面里取消上方的标题栏，像我一样习惯地使用“ctrl + w”（macos 系统为 command + w）来关闭窗口，以及关闭“导出/复制”按钮给出的相关提示。

二、打包

下面聊聊最后一段“噩梦”。

为了把这个工具分享出来使用，不得不进行打包。这个过程只有报错和闪退，没有任何成就感可言。以下流水帐式记录一下遇到的各种问题。

（一）macOS

在 macOS 中的打包耗费了我最多时间，我分别使用了 PyInstaller，py2app 和 cx_freeze 三种打包工具，并在 conda 的虚拟环境和系统环境下做了大量尝试。大体上，我在这个过程中经历了以下报错：

1. 找不到名为 AppKit 的模块，我用这个库来控制程序在 dock 栏上的显示和隐藏。尽管我已经使用 pip 安装了这个库，但在虚拟环境打包时仍然找不到，网上搜索得知需要安装名为 PyObjC 的库，但仍不能解决问题。反复尝试后发现，应彻底删除 AppKit，仅安装完整的 PyObjC 来解决问题。
2. 用 PyInstaller 打包 macOS 程序时，不能正确识别并包含使用的第三方库，这个问题最后没能解决。
3. 用 py2app 在虚拟环境打包。运行打包后的 app，提示缺少 libffi.8.dylib 文件，找到这个文件丢入 app 内 Frameworks 文件夹解决这一报错。
4. 解决 libffi.8.dylib 后，出现“Symbol not found: ……python3.11/lib-dynload/_sqlite3.so, 0x0002):  _sqlite3_enable_load_extension”的报错，网上找到类似问题的解决方案是（1）重装 sqlite3；（2）conda 环境下安装 libsqlite。均不能解决我的问题。
5. 在非虚拟环境下用 py2app 打包，没有出现丢失 libffi.8.dylib 的问题，但同样出现上面的 sqlite3 的问题，不能解决。
6. 用 cx_freeze 打包，出现缺少 libiodbc.2.dylib 的报错，安装 libiodbc，然后把这个文件放到指定位置解决。
7. 解决 libiodbc.2.dylib 丢失后，继续出现找不到 libpq.5.dylib 的报错，下载安装 Postgres 解决。
8. 然后出现了一大堆 “@rpath”开头的报错，看不懂，也找不到直接的解决方案，遂放弃。（ps. 我关注到 cx_freeze 的作者仍然在更新并试图解决上述问题，也许以后可以正常使用这个方法来打包。）

在上面的过程中，我不断在系统环境和 conda 虚拟环境中重装各种版本的 python 和第三方库，甚至尝试用 conda 模拟 x86 环境，排列组合尝试各种方案，都没有成功。其中最好的一种情况是，打包出来的 app 在移动位置后就不能够使用了，完全没有可以分享的可能性。

绝大部分的错误，与动态链接库有关。我对此没有任何基础知识，也没有精力去读懂并修改第三方库的源码，只能够不断从网络论坛上的讨论中，尝试各种解决的方法——因为不了解原理，这么做和拍打电器试图修理没有太大区别，可以说是只有痛苦而没有成长。

最后通过掀桌子成功打包：首先，我把备份好文件，将 macOS 系统从上个月升级的测试版中回退到正式版；然后，用 pyenv 做好 python 的版本管理，确定使用的所有库都是最新、稳定版本，且不使用虚拟环境；最后，用 py2app 成功打包。

事后测试，可以确定的是，使用 conda 版本的 python 会出一些问题。但此前使用系统环境一直也没有取得成功，如果不是测试版系统的问题，那么最可能的原因是，我从某一次删除 python 开始，后续用 brew 安装或官网下载的 python 都因为混乱的版本管理而没有被使用。目前，macOS 自带的 python 已经升级到了 3.9 版本，早已不是诸多教程中提及的 2.x 时代，使用系统版本的 python 编译我的程序不会发生任何编译错误。对于我这种偶尔写一次程序的外行人来说，不小心就会忽略自己使用的 python 和 pip 命令来自哪一个 python。

（二）Windows

相比下，Windows 下打包的问题少了不少，我也同样尝试使用了  PyInstaller，py2exe 和 cx_freeze 三种工具，总体而言：

1. 虽然我在虚拟机中的 Windows 版本是 arm 版的，但似乎 python 需要仍然用 64 位版本，否则一步都进行不下去。
2. py2exe 不能正确识别并把 PyQt6 等第三方库包含进去，看到一种说法是需要包含 sip 库，但对我没用，最后也没解决。
3. cx_freeze 打包后的程序，打开时闪退。
4. PyInstaller 表现极佳，出来的文件完整而小巧（相比 macOS 版本）。但如果选择把所有文件打包成一个，就会出现一些附带数据文件（图片等）不能包含进去的问题。所以我最后也没有选择打包成一个 app 文件，而是保留了文件夹。