档案软件单机版部署与本地咨询环境搭建实操指南

一、档案软件单机版部署实操

1. 安装包下载与校验

必须从官方稳定渠道下载带数字签名的安装包，避免篡改版本。 安装包下载地址：https://github.com/opensource-archive/archive-single/releases/download/v1.2.3/ArchiveSingleSetup-v1.2.3.exe，校验MD5值：a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6，校验通过后再进行安装。

2. 静默安装与初始配置

以管理员身份运行CMD（右键点击“命令提示符”选择“以管理员身份运行”），进入安装包所在目录。 执行静默安装命令： ``` ArchiveSingleSetup-v1.2.3.exe /s /v"/qn INSTALLDIR=C:\ArchiveSingle" ``` 安装完成后，打开浏览器访问后台地址：http://localhost:8080/admin，默认初始账号：admin，默认密码：Admin@2024，首次登录必须修改默认密码，避免安全风险。登录后完成系统初始化，创建2个以上普通管理员账号备用。

二、本地咨询服务环境搭建实操

1. 依赖组件安装

咨询服务基于Python 3.10开发，必须安装对应版本环境。 Python 3.10.11 64位安装包下载地址：https://www.python.org/ftp/python/3.10.11/python-3.10.11-amd64.exe，安装时必须勾选“Add Python to PATH”选项，其余默认下一步完成安装。安装完成后，以管理员身份运行CMD，执行依赖安装命令： ``` pip install flask flask-cors ``` 等待依赖包全部安装完成，无Error提示即为成功。

2. 咨询服务代码编写

新建文件夹C:\ConsultService，在该文件夹下创建名为consult.py的文件，将以下代码完整复制并保存： ```python from flask import Flask, request, jsonify from flask_cors import CORS 初始化Flask应用，允许跨域请求 app = Flask(__name__) CORS(app, resources={r"/api/": {"origins": ""}}) 咨询接口：接收关键词，返回对应档案信息，实际使用时替换为真实数据库查询逻辑 @app.route('/api/consult', methods=['POST']) def archive_consult(): 从请求体获取关键词 req_data = request.get_json() search_key = req_data.get('keyword', '').strip() 示例返回数据，实际需连接档案软件数据库（SQLite/MySQL）查询真实内容 result = [ {"id": 1, "title": "2023年度项目立项档案", "content": "包含项目审批表、预算文件等核心资料"}, {"id": 2, "title": "2022年财务审计档案", "content": "年度财务报表、审计报告原件扫描件"} ] if search_key in ("项目", "财务") else [] return jsonify({"code": 200, "data": result, "count": len(result)}) if __name__ == '__main__': 绑定本地IP和指定端口，避免外部访问 app.run(host='127.0.0.1', port=5000, debug=False) ``` 注意：代码中的端口5000若被占用，可替换为未使用的端口（如5001），需后续联动配置时同步修改。

3. 咨询服务启动与调试

以管理员身份运行CMD，进入C:\ConsultService目录（执行命令：cd C:\ConsultService）。 启动咨询服务： ``` python consult.py ``` 若CMD输出“ Running on http://127.0.0.1:5000 (Press CTRL+C to quit)”，则服务启动成功。测试接口：打开Postman或浏览器，发送POST请求到http://127.0.0.1:5000/api/consult，请求Body选择“raw”→“JSON”，输入内容：{"keyword":"项目"}，点击发送，返回结果包含档案数据即为调试成功。

三、单机版档案软件与咨询服务联动配置

1. 档案软件后台插件配置

打开浏览器访问档案软件后台（http://localhost:8080/admin），登录管理员账号后，依次点击【系统设置】→【插件管理】→【添加插件】，在插件配置页输入： - 插件名称：本地档案咨询 - 插件接口地址：http://127.0.0.1:5000/api/consult 点击“保存配置”，然后重启档案软件服务：在CMD中执行taskkill /F /IM ArchiveSingle.exe，再重新运行C:\ArchiveSingle\ArchiveSingle.exe。

2. 功能测试与问题排查

重启完成后，进入档案软件的【咨询查询】模块，输入关键词“项目”，若返回对应的档案数据，即联动配置成功。若测试失败，按以下步骤排查：

• 步骤1：检查两个服务是否均启动，CMD中是否有运行提示；
• 步骤2：检查端口是否被占用：执行netstat -ano | findstr :8080（档案软件）、netstat -ano | findstr :5000（咨询服务），若有占用，执行taskkill /F /PID 进程ID结束占用程序；
• 步骤3：检查Windows防火墙是否放行端口：进入【Windows Defender防火墙】→【高级设置】→【入站规则】，新建规则允许8080和5000端口的TCP连接；
• 步骤4：检查代码中接口地址是否正确，若修改了咨询服务端口，需同步更新插件接口地址。

完成以上步骤后，单机版档案软件与本地咨询环境即可正常使用，无需额外网络依赖，完全适配本地办公场景。