小白Python工具使用说明：三人聚智-Python程序管理工具

type

status

date

slug

summary

使用方法

1. 下载与安装

在 sanrenjz - 三人聚智-余汉波的版本介绍中找到你需要版本，然后进行下载解压，解压之后双击“三人聚智-余汉波程序控制工具.exe”便可运行程序，绿色版本，不需安装。

若是 QMT 量化交易的小白建议 yuhanbopy-lh 版本，该版内嵌 python 和 mini QMT 的库 xquant，省略复杂的配置。

因为应用是嵌入 python 和 xquant 库的，解压后有近 900M，下载消耗的资源较多，每次下载，这边需向腾讯云支付约 0.2 元。所以，为减少某些不必要的资源消耗，请关注订阅号"余汉波"，发送"资源下载"获取验证码，输入验证码进行下载。

若能访问 github，也可以拉取整个库，或通过夸克网盘下载，这边就不用支付相应的资源流量费。若愿意在程序小店付费下载就更好了，0.99 元。

2. python 程序代码的加载

程序中显示的所有 python 程序代码是放在本地文件夹 resources\app\software 中，将需要运行的代码放到该文件夹中便可运行（最好一个 python 程序或代码创建一个文件夹，以免混杂，更好管理），而运行只需双击更可。

加载代码程序的方法有三种：

程序小店的代码程序：双击“腾讯云对象存储下载器”，会出现下面的界面，只需将在程序小店购买获得的链接粘贴到“下载地址”便可。程序就会进行下载并解压文件到 resources\app\software 中，在应用层主界面就能看到该程序。

github 的代码程序：如果你的代码是在 github 上，那么只需双击"GiHub 仓库下载器"，将仓库地址粘贴上来；选择保存位置，最好是应用的 resources\app\software 文件夹；点击“克隆仓库”便可拉取整个仓库，自动解压到 resources\app\software 中，在应用层主界面就能看到该程序。

手动加载：如果你的代码是自己写的，或来自于其他路径，那么可以点击菜单栏的“本地文件”，建议加载整个文件夹，会将整个文件复制到 resources\app\software 文件夹中，容易管理的同时，可以加载相应的说明等，而不是看不懂的文件。

3. 程序代码的使用

将程序代码加载进来后，双击便可运行。第一次运行可能会较慢，程序会检查程序代码文件夹的 requirements.txt 文件。若库 requirements.txt 载明的库已经安装会跳过，否则会从 pip ，阿里云镜像或清华镜像中拉取相应的库，进行安装。

若需手动安装相应的库，你可以通过双击“终端模拟器”打开终端，输入 pip 等进行手动安装。

若你的库是自己开发的，或者不是开源库，需要自己将文件放到 resources\python\python-3.12.8-embed-amd64\Lib\site-packages 文件夹内。

功能介绍

1. 基本功能

这是一个基于 Electron 的桌面应用程序，用于管理和运行 Python 脚本，用于提高开发和文件管理效率。

支持加密和非加密的 Python 程序

提供实时运行日志显示

自动管理 Python 依赖

2. 版本使用和下载

该程序共提供三个版本，分别命名为：yuhanbopy-xl、yuhanbopy-lh 和 yuhanbopy-mini。其中 yuhanbopy-lh 在 github 的进行开源，地址 yuhanbo758/yuhanbopy-app: 三人聚智-余汉波程序控制工具，基于 MIT 许可证发布。

夸克网盘：三人聚智-余汉波程序控制工具

付费下载：三人聚智-余汉波程序控制工具使用说明 | 三人聚智-余汉波程序小店

yuhanbopy-xl：有嵌入版 python，无需另外安装 python，适用于电脑小白，下载解压直接使用，效率优先。

yuhanbopy-lh：在 yuhanbopy-xl 基础上，植入了 mini QMT 的库 xquant，主要对象是需要小 QMT 量化交易的小白，可以直接加载运行个人提供“通达信与 QMT 结合下单”的 tdx3 程序。

yuhanbopy-mini：yuhanbopy-xl 的 mini 版，没有嵌入版 python，安装后首次启动时，系统会要求选择 Python 解释器（.exe 文件）

3. 程序目录结构

主要程序存放在 app/software 目录下，主要包含三个格式文件，py 或 enc 文件、settings.json 文件和 requirements.txt 文件：

3.1 单文件程序

支持 .py 文件（普通 Python 文件）

支持 .enc 文件（加密的 Python 文件）

3.2 文件夹程序

每个程序文件夹可以包含 json 相关说明，示例：

3.3 依赖管理

在程序目录中可以放置 requirements.txt 文件

系统会自动检查并安装缺失的依赖

使用多个 pip 源以提高安装成功率：

pypi.org
清华大学镜像
阿里云镜像

4. 程序运行

Windows 64 位操作系统

程序列表会显示所有可用的 Python 程序——若文件夹中有 settings.json 文件，显示指定 py 文件，否则显示文件夹中所有 py 文件。

双击列表中的程序即可运行

运行时会自动打开日志窗口，显示程序输出

如果程序有依赖项（requirements.txt 文件），会自动安装所需依赖

需加载本地 python 代码，点击右上角“本地文件”，选择 py 文件或文件夹，会将文件或文件夹复制到 app/software 下，创建项目。

5. 安全特性

支持 AES-256-CBC 加密的 Python 程序（.enc 文件）

程序结束后自动清理临时文件

6. 注意事项

若是 yuhanbopy-mini 应用，确保 Python 解释器路径正确设置

建议在程序目录中提供 requirements.txt 声明依赖

加密程序需要使用特定的加密工具进行加密

程序运行时保持日志窗口打开可查看实时输出

7. 错误处理

如果遇到 Python 环境问题，可以通过界面重新选择 Python 解释器，或卸载重装

依赖安装失败时，日志窗口会显示详细错误信息

程序运行错误会在日志窗口中显示具体原因

这个工具设计得比较完善，特别适合管理和分发 Python 程序，同时通过加密机制保护源代码安全。

8. 已集成应用

终端模拟器: 内置终端工具，支持命令行操作

文件下载器: 通用的文件下载工具，支持多种文件格式

GitHub 仓库下载器: 便捷的 GitHub 仓库克隆和下载工具

腾讯云对象存储下载器: 专用的腾讯云 COS 文件下载工具

同花顺板块自动交易系统: 基于同花顺板块的自动交易系统

通达信板块自动交易系统 4.0: 基于通达信和国金 QMT 的自动化交易系统

问财单策略量化交易系统 2.0: 基于问财自然语言查询的量化交易系统

自定义工具集成: 可扩展的工具集成平台

8.1 系统工具

终端模拟器

功能: 简单的终端模拟器，可以执行系统命令

使用方法:

输入任何系统命令来执行
输入 'exit' 或 'quit' 退出程序
输入 'clear' 清除屏幕
输入 'cd 目录路径' 切换工作目录

8.2 下载工具

文件下载器

功能: 通用的文件下载工具

使用方法:

在输入框中粘贴文件下载地址

选择文件保存位置

选择是否自动解压 ZIP 文件

点击下载按钮开始下载

GitHub 仓库下载器

功能: GitHub 仓库克隆工具

使用方法:

在输入框中粘贴 GitHub 仓库地址

选择保存位置

选择是否自动解压

点击克隆仓库按钮开始下载

腾讯云对象存储下载器

功能: 腾讯云对象存储文件下载工具

使用方法:

在输入框中粘贴文件下载地址

点击下载按钮开始下载

文件将保存到 app/software/ 目录

ZIP 文件会自动解压

8.3 量化交易系统

同花顺板块自动交易系统

功能: 基于同花顺板块的自动交易系统，支持股票和可转债的自动买卖

主要特点:

自动监控同花顺自定义板块变化

根据板块内容自动买入或卖出股票

支持设置交易间隔、单笔金额和总金额

支持多种委托方式和价格调整

实时日志显示交易状态

通达信板块自动交易系统 4.0

功能: 基于通达信和国金 QMT 的自动化交易系统

主要特点:

支持自定义买入卖出板块监控

灵活的交易参数设置

实时委托和成交反馈

智能资金管理和风控

完整的日志记录系统

问财单策略量化交易系统 2.0

功能: 基于问财自然语言查询的量化交易系统

主要特点:

支持通过自然语言查询选股

自动执行交易策略

实时查看持仓和资产信息

定时执行策略

支持股票、基金、可转债等多种证券类型

9. 插件开发指南

本章节将指导您如何为三人聚智-Python 程序管理工具开发自定义插件。

9.1 插件系统概述

插件系统基于标准的目录结构和配置文件，支持以下特性：

自动插件发现和加载

标准化的配置管理

依赖包自动安装

统一的界面风格

日志和错误处理

9.2 插件目录结构

每个插件都应该放在 resources/app/software/ 目录下的独立文件夹中：

9.3 配置文件说明

settings.json（必需）

这是插件的元数据配置文件，系统通过此文件识别和加载插件：

字段说明：

name: 在界面中显示的插件名称

description: 插件的详细描述，支持换行符

main_file: 主程序文件名（相对于插件目录）

version: 插件版本号

author: 开发者信息

category: 插件分类（如：下载工具、量化交易、系统工具等）

requirements.txt（可选）

列出插件需要的 Python 包依赖：

系统会在运行插件前自动安装这些依赖包。

logo.ico（可选）

插件的自定义图标文件：

文件名: 必须命名为 logo.ico

格式: ICO 格式图标文件

尺寸: 建议使用 32x32 或 48x48 像素

作用: 在主界面程序列表中显示为插件图标

图标设计建议：

使用简洁明了的设计，便于识别

选择与插件功能相关的图形元素

确保在小尺寸下仍然清晰可见

使用适当的颜色对比度

图标制作方法：

在线工具: 使用 favicon.io、convertio.co 等在线转换工具

图像编辑软件: 使用 Photoshop、GIMP 等软件导出为 ICO 格式

命令行工具: 使用 ImageMagick 等工具进行格式转换

示例转换命令（ImageMagick）：

图标文件要求：

文件大小建议不超过 50KB

支持透明背景

建议包含多个尺寸（16x16, 32x32, 48x48）

如果不提供 logo.ico 文件，系统将使用默认图标显示插件。插件模板目录中包含了一个示例图标文件供参考。

9.4 插件开发规范

9.4.1 基本结构

插件主程序应该遵循以下基本结构：

9.4.2 界面设计建议

使用 Tkinter: 推荐使用 Tkinter 作为 GUI 框架，确保兼容性

响应式布局: 使用 grid 或 pack 布局管理器创建响应式界面

统一风格: 使用 ttk 组件保持界面风格一致

错误处理: 添加适当的异常处理和用户提示

9.4.3 配置管理

插件应该支持配置文件管理：

9.5 插件开发模板

系统提供了一个完整的插件开发模板，位于： resources/app/software/plugin_template/

该模板包含：

完整的插件结构示例

标准的配置文件管理

界面组件创建示例

错误处理机制

日志输出功能

您可以复制此模板作为新插件的起点。

9.6 插件测试和调试

9.6.1 本地测试

将插件文件夹放入 resources/app/software/ 目录

重启应用程序

在主界面中找到您的插件并运行

9.6.2 调试技巧

控制台输出: 使用 print() 输出调试信息

日志记录: 在界面中添加日志输出区域

异常处理: 使用 try-catch 捕获和显示错误

配置验证: 确保配置文件格式正确

9.7 插件发布和分享

9.7.1 打包插件

测试插件在不同环境下的运行情况

编写详细的使用说明

9.7.2 分享插件

其他用户只需解压到 software/ 目录即可使用

建议在 GitHub 等平台分享插件代码

9.8 常见问题和解决方案

Q: 插件无法在主界面显示？

A: 检查 settings.json 文件格式是否正确，确保 main_file 字段指向正确的文件。

Q: 依赖包安装失败？

A: 检查 requirements.txt 文件格式，确保包名和版本号正确。

Q: 插件运行时出现编码错误？

A: 确保所有 Python 文件都使用 UTF-8 编码，并在文件开头添加编码声明。

Q: 如何访问插件的工作目录？

A: 插件运行时的工作目录就是插件所在的文件夹，可以直接使用相对路径访问资源文件。

Q: 插件图标不显示或显示为默认图标？

A: 检查以下几点：

确保图标文件命名为 logo.ico（区分大小写）

确保图标文件格式为标准的 ICO 格式

重启应用程序以刷新图标缓存

检查图标文件是否损坏，可以尝试重新制作

Q: 如何制作高质量的插件图标？

A: 建议步骤：

设计 48x48 像素的原始图标

确保图标在小尺寸下仍然清晰

使用在线工具或专业软件转换为 ICO 格式

测试图标在不同背景下的显示效果

9.9 高级功能

9.9.1 加密插件

系统支持加密的 .enc 文件，可以保护插件源代码。

9.9.2 多文件插件

插件可以包含多个 Python 文件，通过 import 语句相互调用。

9.9.3 资源文件管理

插件可以包含图片、数据文件等资源，放在插件目录中即可访问。

常见资源文件类型：

logo.ico: 插件图标文件，用于在主界面显示

数据文件: CSV、JSON、XML 等数据文件

配置模板: 默认配置文件模板

帮助文档: README、使用说明等文档

其他图片: PNG、JPG 等图片资源

资源文件访问示例：

10. 插件集成和配置详解

10.1 插件自动发现机制

系统启动时会自动扫描 resources/app/software/ 目录下的所有子目录和文件：

目录扫描: 系统会遍历 software 目录下的所有子文件夹

配置检测: 检查每个文件夹中是否存在 settings.json 文件

插件注册: 根据配置文件信息将插件注册到系统中

界面显示: 在主界面的程序列表中显示可用插件

10.2 插件加载流程

当用户点击运行插件时，系统执行以下步骤：

10.3 依赖包管理

10.3.1 自动安装机制

系统会在运行插件前自动检查和安装依赖包：

10.3.2 依赖包安装位置

依赖包安装在系统的 Python 环境中

所有插件共享相同的依赖包环境

建议使用兼容的包版本避免冲突

10.3.3 常用依赖包推荐

10.4 插件配置管理最佳实践

10.4.1 配置文件结构

建议使用分层的配置文件结构：

10.4.2 配置文件示例

settings.json（系统配置）:

config.json（用户配置）:

10.4.3 配置管理代码示例

10.5 插件生命周期管理

10.5.1 插件状态

系统跟踪每个插件的运行状态：

未运行: 插件已加载但未启动

运行中: 插件正在执行

已停止: 插件执行完成或被用户停止

错误: 插件运行时发生错误

10.5.2 进程管理

10.6 插件调试和日志

10.6.1 日志记录最佳实践

10.6.2 错误处理和用户反馈

10.7 插件性能优化

10.7.1 启动优化

延迟加载非必需模块

使用配置缓存

优化界面初始化

10.7.2 内存管理

及时释放大对象

使用生成器处理大数据

避免内存泄漏

10.7.3 响应性优化

10.8 插件安全考虑

10.8.1 文件访问安全

限制文件访问范围

验证文件路径

避免执行外部命令

10.8.2 网络安全

验证 URL 和证书

处理网络超时

保护敏感信息

10.8.3 用户输入验证

其他应用程序正创建中，可关注右上方"程序小店"，获取更多可视化 python 应用程序。

GitHub Issues: https://github.com/yuhanbo758/yuhanbopy-app/issues