zs_yg/kortapp-z
1
0
Fork 0
mirror of https://github.com/zs-yg/kortapp-z.git synced 2025-12-06 16:10:42 +08:00
Code Issues Packages Projects Releases Wiki Activity

Updated 主页 (markdown)

zsyg
2025-06-15 14:05:07 +08:00
parent 60be688fba
commit 5ef7a6ae58
1 changed files with 0 additions and 300 deletions
Download Patch File Download Diff File Expand all files Collapse all files

300
主页.md

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