diff --git a/主页.md b/主页.md index 2d4e17b..1b754d6 100644 --- a/主页.md +++ b/主页.md @@ -150,303 +150,3 @@ Logger.LogError("错误消息", exception);

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

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

安装指南

-

系统要求

- -

下载选项

-
    -
  1. ​预编译版本​ (推荐): -
    git clone https://github.com/zs-yg/kortapp-z.git
    -
    2. -
  2. 从 Releases 页面 下载最新安装包
    3. -
-

编译指南

-
# 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. -
  2. -

    ​下载进度标签页：

    - -
    3. -
  3. -

    ​设置菜单：

    - -
    4. -
-

自定义应用

-

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

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

技术细节

-

下载引擎

- -

日志系统

- -

贡献指南

-

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

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

开发规范

- -

常见问题

-

下载速度慢怎么办？

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

如何更改下载目录？

-

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

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

软件无法启动？

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

许可证

-

本项目采用 ​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