mirror of
https://github.com/zs-yg/kortapp-z.git
synced 2025-12-06 16:10:42 +08:00
Destroyed 主页 (markdown)
zsyg
480
主页.md
480
主页.md
@@ -1,480 +0,0 @@
|
||||
<html>
|
||||
<body>
|
||||
<!--StartFragment--><html><head></head><body><h1>kortapp-z Wiki</h1>
|
||||
<h2>概述</h2>
|
||||
<p><strong>kortapp-z</strong> 是一个开源、轻量级的 Windows 应用商店客户端，提供简洁美观的界面和高效的软件下载管理功能。该项目使用 C# 和 .NET 8 开发，采用 Windows Forms 作为 UI 框架。</p>
|
||||
<h2>核心功能</h2>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<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>
|
||||
|
||||
|
||||
<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)。
|
||||
Reference in New Issue
Block a user