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

134 lines
3.4 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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
- ✅ 文件小,部署简单
- ✅ 绿色软件,复制即用
这是最简单、最可靠的部署方案!