commit 2877d6620facf37901e6ceb216bc9a71b822a8cd Author: zsyg <3872006562@qq.com> Date: Sat Jun 14 10:21:46 2025 +0800 Initial Home page diff --git a/主页.md b/主页.md new file mode 100644 index 0000000..ec3784a --- /dev/null +++ b/主页.md @@ -0,0 +1,480 @@ + + +

kortapp-z Wiki

概述

kortapp-z 是一个开源、轻量级的 Windows 应用商店客户端，提供简洁美观的界面和高效的软件下载管理功能。该项目使用 C# 和 .NET 8 开发，采用 Windows Forms 作为 UI 框架。

核心功能

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

安装指南

系统要求

Windows 10/11 (64位)
.NET 8.0 运行时

下载选项

预编译版本 (推荐): +

git clone https://github.com/zs-yg/kortapp-z.git

从 Releases 页面下载最新安装包

编译指南

# 64位版本
+dotnet publish -c Release -r win-x64 -p:PublishSingleFile=true
+
+# 32位版本
+dotnet publish -c Release -r win-x86 -p:PublishSingleFile=true

项目结构

kortapp-z/
+├── AppStore/                 # 核心应用代码
+│   ├── MainForm.cs           # 主界面逻辑
+│   ├── DownloadManager.cs    # 下载引擎实现
+│   ├── AppCard.cs            # 应用卡片组件
+│   ├── DownloadItem.cs       # 下载项组件
+│   ├── SettingsForm.cs       # 设置界面
+│   └── Logger.cs             # 日志系统
+├── resource/                 # 运行时资源
+│   ├── aria2c.exe            # 下载引擎核心
+│   └── log_cleaner.exe       # 日志清理工具
+├── img/                      # 应用图标资源
+│   ├── ico/                  # 程序图标
+│   └── png/                  # 应用截图
+└── LICENSE                   # MIT 许可证

使用说明

主界面

+
软件下载标签页：
+
- 浏览按类别组织的应用卡片
- 点击"下载"按钮获取应用
+
+
下载进度标签页：
+
- 查看实时下载进度
- 取消进行中的下载任务
- 查看下载历史记录
+
+
设置菜单：
+
- 清理系统日志文件
- 配置下载选项
+

自定义应用

编辑 MainForm.cs 中的 CreateAppCard 方法添加新应用：

flowPanel.Controls.Add(CreateAppCard(
+    "应用名称",
+    "下载URL",
+    "img/png/图标文件.png"
+));

技术细节

下载引擎

基于 aria2c 的多线程下载技术
支持断点续传
自动校验文件完整性

线程数配置： +

var arguments = $"--out=\"{originalFileName}\" 
+                 --dir=\"{downloadsDir}\" 
+                 --split=16 
+                 --max-connection-per-server=16 
+                 {url}";

日志系统

每日独立日志文件
自动创建 logs 目录
错误堆栈记录

使用示例： +

Logger.Log("信息性消息");
+Logger.LogError("错误消息", exception);

贡献指南

欢迎通过以下方式参与项目：

提交 Issues 报告问题或建议功能
创建 Pull Request 贡献代码
完善应用图标资源
添加新的优质开源软件

开发规范

C# 10 语法规范
遵循 Windows Forms 最佳实践
所有用户交互需线程安全调用
新功能需附带单元测试

常见问题

下载速度慢怎么办？

检查网络连接状态
尝试不同的下载镜像源
在设置中增加线程数 (需修改代码)

如何更改下载目录？

编辑 DownloadManager.cs 中的下载路径：

var downloadsDir = Path.Combine(
+    Environment.GetFolderPath(Environment.SpecialFolder.UserProfile), 
+    "Downloads");

软件无法启动？

确认已安装 .NET 8.0 运行时
检查 resource 目录是否完整
查看 logs 目录中的错误日志

许可证

本项目采用 MIT 许可证：

Copyright (c) 2025 kortapp-z 项目组
+
+特此免费授予任何获得本软件及相关文档文件（以下简称“软件”）副本的任何人
+无限制地处理本软件的权限，包括但不限于使用、复制、修改、合并、发布、
+分发、再许可和/或销售本软件的副本...

完整许可证内容请查看 LICENSE 文件。

+ + + + +

安装指南

系统要求

Windows 10/11 (64位)
.NET 8.0 运行时

下载选项

预编译版本 (推荐): +

git clone https://github.com/zs-yg/kortapp-z.git

从 Releases 页面下载最新安装包

编译指南

# 64位版本
+dotnet publish -c Release -r win-x64 -p:PublishSingleFile=true
+
+# 32位版本
+dotnet publish -c Release -r win-x86 -p:PublishSingleFile=true

项目结构

kortapp-z/
+├── AppStore/                 # 核心应用代码
+│   ├── MainForm.cs           # 主界面逻辑
+│   ├── DownloadManager.cs    # 下载引擎实现
+│   ├── AppCard.cs            # 应用卡片组件
+│   ├── DownloadItem.cs       # 下载项组件
+│   ├── SettingsForm.cs       # 设置界面
+│   └── Logger.cs             # 日志系统
+├── resource/                 # 运行时资源
+│   ├── aria2c.exe            # 下载引擎核心
+│   └── log_cleaner.exe       # 日志清理工具
+├── img/                      # 应用图标资源
+│   ├── ico/                  # 程序图标
+│   └── png/                  # 应用截图
+└── LICENSE                   # MIT 许可证

使用说明

主界面

+
软件下载标签页：
+
- 浏览按类别组织的应用卡片
- 点击"下载"按钮获取应用
+
+
下载进度标签页：
+
- 查看实时下载进度
- 取消进行中的下载任务
- 查看下载历史记录
+
+
设置菜单：
+
- 清理系统日志文件
- 配置下载选项
+

自定义应用

编辑 MainForm.cs 中的 CreateAppCard 方法添加新应用：

flowPanel.Controls.Add(CreateAppCard(
+    "应用名称",
+    "下载URL",
+    "img/png/图标文件.png"
+));

技术细节

下载引擎

基于 aria2c 的多线程下载技术
支持断点续传
自动校验文件完整性

线程数配置： +

var arguments = $"--out=\"{originalFileName}\" 
+                 --dir=\"{downloadsDir}\" 
+                 --split=16 
+                 --max-connection-per-server=16 
+                 {url}";

日志系统

每日独立日志文件
自动创建 logs 目录
错误堆栈记录

使用示例： +

Logger.Log("信息性消息");
+Logger.LogError("错误消息", exception);

贡献指南

欢迎通过以下方式参与项目：

提交 Issues 报告问题或建议功能
创建 Pull Request 贡献代码
完善应用图标资源
添加新的优质开源软件

开发规范

C# 10 语法规范
遵循 Windows Forms 最佳实践
所有用户交互需线程安全调用
新功能需附带单元测试

常见问题

下载速度慢怎么办？

检查网络连接状态
尝试不同的下载镜像源
在设置中增加线程数 (需修改代码)

如何更改下载目录？

编辑 DownloadManager.cs 中的下载路径：

var downloadsDir = Path.Combine(
+    Environment.GetFolderPath(Environment.SpecialFolder.UserProfile), 
+    "Downloads");

软件无法启动？

确认已安装 .NET 8.0 运行时
检查 resource 目录是否完整
查看 logs 目录中的错误日志

许可证

本项目采用 MIT 许可证：

Copyright (c) 2025 kortapp-z 项目组
+
+特此免费授予任何获得本软件及相关文档文件（以下简称“软件”）副本的任何人
+无限制地处理本软件的权限，包括但不限于使用、复制、修改、合并、发布、
+分发、再许可和/或销售本软件的副本...

完整许可证内容请查看 LICENSE 文件。

+ + +# kortapp-z Wiki + +## 概述 +**kortapp-z** 是一个开源、轻量级的 Windows 应用商店客户端，提供简洁美观的界面和高效的软件下载管理功能。该项目使用 C# 和 .NET 8 开发，采用 Windows Forms 作为 UI 框架。 + +## 核心功能 +| 功能 | 描述 | +|------|------| +| 📦 应用发现 | 浏览超过 40 款精选开源软件 | +| ⚡ 下载管理 | 多线程下载支持，实时进度监控 | +| 🧹 日志清理 | 一键清理系统日志文件 | +| 🔔 通知系统 | 下载完成桌面通知 | +| 📁 本地化管理 | 自动保存到用户下载目录 | + +## 安装指南 + +### 系统要求 +- Windows 10/11 (64位) +- [[.NET 8.0 运行时](https://dotnet.microsoft.com/download/dotnet/8.0)](https://dotnet.microsoft.com/download/dotnet/8.0) + +### 下载选项 +1. **预编译版本** (推荐): + ```bash + git clone https://github.com/zs-yg/kortapp-z.git + ``` +2. 从 [[Releases 页面](https://github.com/zs-yg/kortapp-z/releases)](https://github.com/zs-yg/kortapp-z/releases) 下载最新安装包 + +### 编译指南 +```bash +# 64位版本 +dotnet publish -c Release -r win-x64 -p:PublishSingleFile=true + +# 32位版本 +dotnet publish -c Release -r win-x86 -p:PublishSingleFile=true +``` + +## 项目结构 +``` +kortapp-z/ +├── AppStore/ # 核心应用代码 +│ ├── MainForm.cs # 主界面逻辑 +│ ├── DownloadManager.cs # 下载引擎实现 +│ ├── AppCard.cs # 应用卡片组件 +│ ├── DownloadItem.cs # 下载项组件 +│ ├── SettingsForm.cs # 设置界面 +│ └── Logger.cs # 日志系统 +├── resource/ # 运行时资源 +│ ├── aria2c.exe # 下载引擎核心 +│ └── log_cleaner.exe # 日志清理工具 +├── img/ # 应用图标资源 +│ ├── ico/ # 程序图标 +│ └── png/ # 应用截图 +└── LICENSE # MIT 许可证 +``` + +## 使用说明 + +### 主界面 + + +1. **软件下载**标签页： + - 浏览按类别组织的应用卡片 + - 点击"下载"按钮获取应用 + +2. **下载进度**标签页： + - 查看实时下载进度 + - 取消进行中的下载任务 + - 查看下载历史记录 + +3. **设置**菜单： + - 清理系统日志文件 + - 配置下载选项 + +### 自定义应用 +编辑 `MainForm.cs` 中的 `CreateAppCard` 方法添加新应用： +```csharp +flowPanel.Controls.Add(CreateAppCard( + "应用名称", + "下载URL", + "img/png/图标文件.png" +)); +``` + +## 技术细节 + +### 下载引擎 +- 基于 aria2c 的多线程下载技术 +- 支持断点续传 +- 自动校验文件完整性 +- 线程数配置： + ```csharp + var arguments = $"--out=\"{originalFileName}\" + --dir=\"{downloadsDir}\" + --split=16 + --max-connection-per-server=16 + {url}"; + ``` + +### 日志系统 +- 每日独立日志文件 +- 自动创建 logs 目录 +- 错误堆栈记录 +- 使用示例： + ```csharp + Logger.Log("信息性消息"); + Logger.LogError("错误消息", exception); + ``` + +## 贡献指南 + +欢迎通过以下方式参与项目： +1. 提交 Issues 报告问题或建议功能 +2. 创建 Pull Request 贡献代码 +3. 完善应用图标资源 +4. 添加新的优质开源软件 + +### 开发规范 +- C# 10 语法规范 +- 遵循 Windows Forms 最佳实践 +- 所有用户交互需线程安全调用 +- 新功能需附带单元测试 + +## 常见问题 + +### 下载速度慢怎么办？ +1. 检查网络连接状态 +2. 尝试不同的下载镜像源 +3. 在设置中增加线程数 (需修改代码) + +### 如何更改下载目录？ +编辑 `DownloadManager.cs` 中的下载路径： +```csharp +var downloadsDir = Path.Combine( + Environment.GetFolderPath(Environment.SpecialFolder.UserProfile), + "Downloads"); +``` + +### 软件无法启动？ +1. 确认已安装 .NET 8.0 运行时 +2. 检查 resource 目录是否完整 +3. 查看 logs 目录中的错误日志 + +## 许可证 +本项目采用 **MIT 许可证**： +```text +Copyright (c) 2025 kortapp-z 项目组 + +特此免费授予任何获得本软件及相关文档文件（以下简称“软件”）副本的任何人 +无限制地处理本软件的权限，包括但不限于使用、复制、修改、合并、发布、 +分发、再许可和/或销售本软件的副本... +``` + +完整许可证内容请查看 [[LICENSE 文件](https://github.com/zs-yg/kortapp-z/blob/main/LICENSE)](https://github.com/zs-yg/kortapp-z/blob/main/LICENSE)。 \ No newline at end of file