mirror of
https://github.com/zs-yg/kortapp-z.git
synced 2025-12-07 00:20:43 +08:00
Updated 主页 (markdown)
zsyg
300
主页.md
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-->
|
<p>完整许可证内容请查看 <a href="https://github.com/zs-yg/kortapp-z/blob/main/LICENSE">LICENSE 文件</a>。</p></body></html><!--EndFragment-->
|
||||||
</body>
|
</body>
|
||||||
</html>
|
</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