SlideCombine/部署指南.md
yuuko a156fff7f4 优化部署方案:降级到 .NET Framework 4.5.2 并创建完整打包脚本
- 降级目标框架从 .NET Framework 4.8 到 4.5.2,提高系统兼容性
- 移除新版特性支持,确保在大多数 Windows 系统(Win7-Win11)上直接运行
- 添加 build.bat - 基础编译脚本
- 添加 打包发布.bat - 一键打包发布脚本,自动生成完整发布包
- 添加 部署指南.md - 详细的部署和使用说明文档
- 打包脚本会自动创建使用说明、技术文档和启动脚本
- 实现真正的绿色软件部署:无需安装,复制即用

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-24 17:13:20 +08:00

3.4 KiB
Raw Permalink Blame History

PDF书签合并工具 - 部署指南

🎯 简单部署方案(推荐)

方案特点

  • 无需安装开发环境
  • 依赖项少,兼容性强
  • 支持从 Windows 7 到 Windows 11
  • 直接复制运行,绿色软件

部署步骤

1 编译程序

在 Visual Studio 中:

  1. 打开 SlideCombine.csproj
  2. 配置选择 Release
  3. 平台选择 AnyCPU
  4. 点击 生成生成解决方案

或者使用提供的 build.bat 脚本:

  1. 双击运行 build.bat
  2. 等待编译完成

2 创建发布包

编译完成后:

  1. 找到 bin\Release\SlideCombine.exe 文件
  2. 创建一个新文件夹(如 SlideCombine
  3. SlideCombine.exe 复制到该文件夹

3 部署到目标电脑

只需将包含 SlideCombine.exe 的文件夹复制到目标电脑即可!

🔧 目标电脑系统要求

操作系统支持

  • Windows 7 SP1 或更高版本
  • Windows 8/8.1
  • Windows 10/11

.NET Framework 要求

  • 🔹 最低要求:.NET Framework 4.5.2
  • 🔹 大多数 Windows 7/10 系统已自带
  • 🔹 如需检查:控制面板 → 程序 → 启用或关闭 Windows 功能

如何检查是否已安装

  1. 打开 C:\Windows\Microsoft.NET\Framework64\
  2. 查找是否存在 v4.0.30319 文件夹
  3. 或在 PowerShell 中运行:dir "C:\Windows\Microsoft.NET\Framework64\v4*"

📦 发布包内容说明

发布包只需包含以下文件:

SlideCombine/
├── SlideCombine.exe          # 主程序
└── 使用说明.txt              # 用户使用指南(可选)

🚀 使用方法

基本使用

  1. 双击运行 SlideCombine.exe
  2. 选择三个路径:
    • 📁 PDF文件夹路径包含 FreePic2Pdf_bkmk.txt 文件的文件夹
    • 📄 TXT源文件路径包含元数据 TXT 文件的路径
    • 💾 输出路径:合并后文件的保存位置
  3. 点击 🚀 开始合并
  4. 等待处理完成

文件结构示例

PDF文件夹/
├── CH-875 1-3/FreePic2Pdf_bkmk.txt
├── CH-875 4-6/FreePic2Pdf_bkmk.txt

TXT源文件/
├── CH-875 1-3.txt
├── CH-875 4-6.txt

输出路径/
├── CH-875.txt          # 合并后的文件

🔍 故障排除

常见问题

Q1提示"应用程序无法启动"

解决方案

  1. 检查是否安装 .NET Framework 4.5.2
  2. 下载安装:https://dotnet.microsoft.com/download/dotnet-framework/net452

Q2找不到 MSBuild

解决方案

  1. 安装 Visual Studio 2017/2019/2022
  2. 或下载 .NET Framework 4.5.2 Developer Pack

Q3程序运行时出现错误

解决方案

  1. 检查输入路径是否正确
  2. 确保文件格式符合要求
  3. 检查文件权限

联系支持

如果遇到问题,请检查:

  1. 文件路径是否包含中文字符
  2. 是否有足够的磁盘空间
  3. 杀毒软件是否误报

📝 版本信息

  • 当前版本v1.0
  • 目标框架.NET Framework 4.5.2
  • 文件大小:约 30-50 KB
  • 依赖项.NET Framework 4.5.2

🔄 更新部署

如需更新程序:

  1. 编译新版本
  2. 复制新的 SlideCombine.exe 覆盖旧文件
  3. 配置文件和用户数据会保留

🎉 总结

使用 .NET Framework 4.5.2 的优势:

  • 几乎所有 Windows 系统都自带,无需额外安装
  • 兼容性强,支持 Windows 7 到 Windows 11
  • 文件小,部署简单
  • 绿色软件,复制即用

这是最简单、最可靠的部署方案!