Clone
4
主页
zsyg edited this page 2025-06-15 14:05:07 +08:00
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.

<html> <html><head></head>

kortapp-z Wiki

概述

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

核心功能

功能 | 描述 -- | -- 📦 应用发现 | 浏览超过 40 款精选开源软件 下载管理 | 多线程下载支持,实时进度监控 🧹 日志清理 | 一键清理系统日志文件 🔔 通知系统 | 下载完成桌面通知 📁 本地化管理 | 自动保存到用户下载目录

安装指南

系统要求

下载选项

  1. 预编译版本 (推荐):
    git clone https://github.com/zs-yg/kortapp-z.git
  2. 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 许可证

使用说明

主界面

  1. 软件下载标签页:

    • 浏览按类别组织的应用卡片
    • 点击"下载"按钮获取应用
  2. 下载进度标签页:

    • 查看实时下载进度
    • 取消进行中的下载任务
    • 查看下载历史记录
  3. 设置菜单:

    • 清理系统日志文件
    • 配置下载选项

自定义应用

编辑 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);

贡献指南

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

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

开发规范

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

常见问题

下载速度慢怎么办?

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

如何更改下载目录?

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

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

软件无法启动?

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

许可证

本项目采用 MIT 许可证

Copyright (c) 2025 kortapp-z 项目组

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

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

</html> </html>