Merge branch 'master' into dev-moshengren

01_安装升级指南/Hyper-v&openKylin-x86虚拟机安装指南.md

@@ -0,0 +1,94 @@
+# Hyper-v&openKylin-x86虚拟机安装指南
+---
+
+## 〇、背景
+- **Hyper-v**是微软自Windows 8开始引入的虚拟化技术，在Windows 10中得到了进一步的完善，使用他的优点是可以充分释放性能(开启后Windows都是跑在Hyper-v上的，性能损失很小)，并且不需要安装虚拟机软件。
+- **openKylin**是麒麟软件推出的Linux发行版，是中国首款根社区自主可控的Linux，本指南主要说明win11上使用Hyper-v安装openKylin系统，并完成相关初步配置。
+
+## 一、准备工作
+### 1.1 下载openKylin-x86镜像文件
+可以从openKylin官方网站下载最新版本的镜像文件，官网地址为[https://www.openkylin.top/downloads/index-cn.html](https://www.openkylin.top/downloads/index-cn.html)。
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/下载镜像.png)
+### 1.2 安装Hyper-v
+1. 按`windows+x`，点击设置
+2. 搜索“启用或关闭”，点击显示所有结果，找到“启用或关闭Windows功能”，点击打开
+![alt text](./assets/Hyper-v&openKylin-x86虚拟机安装/启用或关闭.png)
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/启用或关闭windows功能.png)
+3. 勾选“Hyper-v虚拟机平台”和“Hyper-v虚拟交换机管理器”，点击确定
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/勾选Hyper-v.png)
+4. 等待安装完成后重启电脑
+
+## 二、创建虚拟机
+### 2.1 打开虚拟机管理器
+在开始菜单中搜索`hyper`即可找到虚拟机管理器，选择并打开
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/找到虚拟机管理器.png)
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/虚拟机管理器.png)
+### 2.2 创建虚拟机
+先点选自己的电脑，然后点击右侧的新建虚拟机
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/新建虚拟机.png)
+### 2.3 设置虚拟机名称和位置
+名称就写ok吧，位置就不要默认的C盘了这样会导致C盘爆炸，自定义一个位置：
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/名称和位置.png)
+### 2.4 设置代数
+用第二代，支持uefi启动。
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/代数.png)
+### 2.5 分配内存
+直接就默认的完事，反正可以动态内存，这里一定要确保你电脑剩余内存有你设置的这么大，否则虚拟机启动不了。
+笔者当时开了一堆网页导致虚拟机启动失败，关闭浏览器回收了一些内存后才完成启动。
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/内存.png)
+### 2.6 设置网络
+肯定要联网的，所以选择`default switch`即可，这样就可以和主机共享网络了。
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/网络.png)
+### 2.7 创建虚拟硬盘
+选择默认的参数即可。
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/虚拟硬盘.png)
+不用担心这个数值太大占用硬盘太多，他其实是最大大小，vhdx是动态管理大小的，比如笔者安装完实际大小只有16.8G:
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/实际大小.png)
+
+
+### 2.8 安装选项
+这里选择你下载好的虚拟机镜像文件即可：
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/选择镜像.png)
+### 2.9 完成创建
+点击完成即可，然后就可以启动虚拟机了。
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/完成创建.png)
+### 2.10 关闭安全启动
+为了保险起见，我们关闭安全启动，这样安装的成功率更高。
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/关闭安全启动.png)
+
+## 三、安装openKylin
+### 3.1 启动虚拟机
+选择虚拟机然后点启动：
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/启动虚拟机.png)
+然后再点击连接：
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/链接虚拟机.png)
+此时就进入了体验环节(因为先点的启动，等点连接时候已经进入了live系统)：
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/体验openKylin.png)
+### 3.2 进入安装程序
+点击`安装openKylin`：
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/安装openKylin.png)
+然后就跟普通的x86安装一样了，选择语言一步步配置往下走即可。
+这里建议安装时候直接一根到底，比较方便，而且不像全盘安装容易出现系统分区不足的情况，也不会过多占用不用的空间：
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/一根到底.png)
+最后就是确认操作和开始安装：
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/开始安装.png)
+### 3.3 安装完成和卸载镜像
+等待安装完成一般都比较快，完成后，选择关机：
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/安装完成.png)
+然后点击设置，卸载安装镜像文件：
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/卸载镜像.png)
+### 3.4 登录系统
+然后点启动：
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/启动.png)
+等待启动后，输入密码即可登录系统：
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/登录系统.png)
+## 四、修改分辨率
+此时我们会发现分别率是比较低的，窗口比较小，用着不舒服。
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/默认分辨率.png)
+这其实很好办，我们只需要在虚拟机里设置分辨率即可生效：
+![](./assets/Hyper-v&openKylin-x86虚拟机安装/修改分辨率.png)
+
+## 五、配置openKylin
+这块与其他方式安装均无区别，今天就不多做叙述，虚拟机有个好处可以直接点保存，不用关机，下次启动还是上次的状态。
+## 六、总结
+使用Hyper-v安装openKylin系统，可以充分利用Windows的性能，并且安装过程比较简单，推荐使用。

01_安装升级指南/riscv上安装openKylin.md

@@ -28,16 +28,21 @@ dateCreated: 2022-07-22T06:40:16.074Z
 [在SpacemiT_K1上安装openKylin](./在riscv上安装/在SpacemiT_K1上安装openKylin.md)
 
 
-# 五、在 HiFive Unmatched 上安装openKylin
+# 五、在 RuyiBook 上安装openKylin
+
+[在RuyiBook上安装openKylin](./在riscv上安装/在RuyiBook上安装openKylin.md)
+
+
+# 六、在 HiFive Unmatched 上安装openKylin
 
 [在HiFive_Unmatched上安装openKylin](./在riscv上安装/在HiFive_Unmatched上安装openKylin.md)
 
 
-# 六、在 Sophgo sg2042 上安装openKylin
+# 七、在 Sophgo sg2042 上安装openKylin
 
 [在Sophgo_sg2042上安装openKylin](./在riscv上安装/在Sophgo_sg2042上安装openKylin.md)
 
 
-# 七、在 Lotus2 上安装 openKylin
+# 八、在 Lotus2 上安装 openKylin
 
 [在Lotus2上安装openKylin](./在riscv上安装/在Lotus2上安装openKylin.md)

01_安装升级指南/在riscv上安装/在DW1000上安装openKylin.md

@@ -0,0 +1,31 @@
+## 准备SD卡
+openkylin适配DW1000的镜像可以通过以下链接下载
+> https://www.openkylin.top/downloads
+
+通过以下命令解压
+> tar xf openKylin-Embedded-V1.0-Release-DW1000-RV64G.tar.xf
+
+以上路径请根据自己的实际路径去解压
+
+## 制作SD卡启动盘
+首先使用磁盘工具将SD卡格式化。
+> sudo dd if=</path/to/image.img> of=/dev/sdb1 bs=1M status=progress
+
+
+此命令假设您已将SD卡linux PC的SD卡插槽中。 如果您使用的是USB读卡器，它会显示为 /dev/sdb或者类似内容
+
+注意：要非常小心上一个命令中的“of”参数。 如果使用了错误的磁盘，您可能会丢失数据。也可通过磁盘工具的回复磁盘映像功能来将镜像刷入sd卡。
+
+## 烧录后分配SD卡剩余空间
+按照以下步骤将SD卡剩余空间分配到根分区。
+注：此命令假设您SD卡的设备号为/dev/sdb，分盘时请根据实际的设备号进行分盘。
+> sudo apt install cloud-guest-utils
+> sudo growpart /dev/sdb 1
+> sudo resize2fs /dev/sdb1
+
+
+## 第一次启动
+将烧录并分盘后的SD卡插入DW1000卡槽并按下电源按钮。首次启动之后，系统中会存在一个默认用户，当桌面环境启动之后，您可以通过默认用户进行DW1000首次登陆，后期可以根据自己需求进行用户或密码的更改。
+默认用户名/密码是
+> username：openkylin
+> password：openkylin

01_安装升级指南/在riscv上安装/在LicheePi4A上安装openKylin.md

@@ -6,7 +6,7 @@ openkylin适配LicheePi4A的镜像可以通过以下链接下载：
 > https://www.openkylin.top/downloads
 
 通过以下命令将文件解压：
-> tar -xvf openKylin-2.0-licheepi4a-riscv64.tar.xz
+> tar -xvf openKylin-Embedded-V2.0-Release-licheepi4a-riscv64.tar.xz
 
 拿出准备好的Type-C数据线，按住开发板板上BOOT键，进入fastboot模式，连接开发板Type-C口与电脑USB接口，接好红灯亮后可松开BOOT键
 
@@ -22,7 +22,7 @@ sudo ./thead-image-linux.sh
 终端会打印烧录日志，烧录完成后拔调数据线，上电启动即可。
 
 ### 第一次启动
-将烧录好的sd卡插入VisionFive 2卡槽并连接好电源线。首次启动之后，系统中会存在一个默认用户，当桌面环境启动之后，您可以通过默认用户进行VisionFive 2首次登陆，后期可以根据自己需求进行用户或密码的更改。
+首次启动之后，系统中会存在一个默认用户，当桌面环境启动之后，您可以通过默认用户进行LicheePi4A首次登陆，后期可以根据自己需求进行用户或密码的更改。
 默认用户名/密码是
 > username：openkylin
 > password：openkylin

01_安装升级指南/在riscv上安装/在Milk-V_Pioneer上安装openKylin.md

@@ -3,7 +3,7 @@ openkylin适配Milk-V Pioneer的镜像可以通过以下链接下载
 > https://www.openkylin.top/downloads
 
 通过以下命令解压
-> unxz  openKylin-2.0-milk-v-pioneer-riscv64.img.xz
+> unxz  openKylin-Embedded-V2.0-Release-milk-v-pioneer-riscv64.img.xz
 
 以上路径请根据自己的实际路径去解压
 

01_安装升级指南/在riscv上安装/在RuyiBook上安装openKylin.md

@@ -0,0 +1,23 @@
+## 准备emmc烧录环境
+准备好一根Type-C数据线，一般如意笔记本包装盒会配套提供。
+
+openkylin适配RuyiBook的镜像可以通过以下链接下载：
+> https://www.openkylin.top/downloads
+
+通过以下命令将文件解压：
+> tar -xvf openKylin-Embedded-V2.0-Release-RuyiBook-riscv64.tar.xz
+
+需要使用X86架构设备
+
+进入解压后的文件夹，执行脚本烧录镜像：
+sudo ./burn_techvision.sh
+
+拿出准备好的Type-C数据线，使用取卡针或别针按住笔记本右侧前方的烧录按钮，进入fastboot模式，连接笔记本左侧前方的Type-C口与电脑USB接口。注意在烧录过程中不要将如意笔记本通电。
+
+终端会打印烧录日志，烧录完成后拔掉数据线。
+
+## 第一次启动
+烧录后先不要连接电源，长按开机按键10秒左右直到笔记本左侧绿色灯熄灭，之后连接笔记本电源并按开机键开机。首次启动之后，系统中会存在一个默认用户，当桌面环境启动之后，您可以通过默认用户进行如意笔记本的首次登陆，后期可以根据自己需求进行用户或密码的更改。
+默认用户名/密码是
+> username：openkylin
+> password：openkylin

01_安装升级指南/在riscv上安装/在SpacemiT_K1上安装openKylin.md

@@ -3,7 +3,7 @@ openkylin适配SpacemiT K1的镜像可以通过以下链接下载
 > https://www.openkylin.top/downloads
 
 通过以下命令解压
-> unxz  openKylin-2.0-spacemit-k1-riscv64.img.xz
+> unxz  openKylin-Embedded-V2.0-Release-spacemit-k1-riscv64.img.xz
 
 以上路径请根据自己的实际路径去解压
 

01_安装升级指南/在riscv上安装/在VisionFive2上安装openKylin.md

@@ -3,7 +3,7 @@ openkylin适配VisionFive 2的镜像可以通过以下链接下载
 > https://www.openkylin.top/downloads
 
 通过以下命令解压
-> unxz openKylin-2.0-visionfive2-riscv64.img.xz
+> unxz openKylin-Embedded-V2.0-Release-visionfive2-riscv64.img.xz
 
 以上路径请根据自己的实际路径去解压
 

02_基础操作/AI模型管理/基于KylinCode+DeepSeek实现AI编程助手.md

@@ -0,0 +1,26 @@
+# 基于KylinCode+DeepSeek实现AI编程助手
+
+
+### 第一步：
+安装并运行ollama服务及DeepSeek-R1模型，具体见上一期文章：https://docs.openkylin.top/zh/02_%E5%9F%BA%E7%A1%80%E6%93%8D%E4%BD%9C/AI%E6%A8%A1%E5%9E%8B%E7%AE%A1%E7%90%86/%E5%9F%BA%E4%BA%8EopenKylin%E6%9C%AC%E5%9C%B0%E9%83%A8%E7%BD%B2%E5%B9%B6%E8%BF%90%E8%A1%8CDeepSeek-R1%E5%BC%80%E6%BA%90%E6%A8%A1%E5%9E%8B
+
+![输入图片说明](../assets/%E5%9F%BA%E4%BA%8EKylinCode+DeepSeek%E5%AE%9E%E7%8E%B0AI%E7%BC%96%E7%A8%8B%E5%8A%A9%E6%89%8B/1.png)
+
+### 第二步：
+打开KylinCode集成开发工具，在插件商店搜索并安装“Continue”，这是一款开源AI编程助手插件。安装后如下图所示：
+
+![输入图片说明](../assets/%E5%9F%BA%E4%BA%8EKylinCode+DeepSeek%E5%AE%9E%E7%8E%B0AI%E7%BC%96%E7%A8%8B%E5%8A%A9%E6%89%8B/2.png)
+
+### 第三步：
+在“Continue”插件点击“Add Chat model”。
+
+![输入图片说明](../assets/%E5%9F%BA%E4%BA%8EKylinCode+DeepSeek%E5%AE%9E%E7%8E%B0AI%E7%BC%96%E7%A8%8B%E5%8A%A9%E6%89%8B/3.png)
+
+选择我们在第一步已运行的ollama服务及DeepSeek-R1模型，然后点击“Connect”完成DeepSeek-R1模型配置，如下图所示：
+
+![输入图片说明](../assets/%E5%9F%BA%E4%BA%8EKylinCode+DeepSeek%E5%AE%9E%E7%8E%B0AI%E7%BC%96%E7%A8%8B%E5%8A%A9%E6%89%8B/4.png)
+
+### 第四步：
+按提示选择需要处理的代码文件，并说明需要DeepSeeK如何处理。如下图所示，请DeepSeek帮忙分析一下这段代码：
+
+![输入图片说明](../assets/%E5%9F%BA%E4%BA%8EKylinCode+DeepSeek%E5%AE%9E%E7%8E%B0AI%E7%BC%96%E7%A8%8B%E5%8A%A9%E6%89%8B/5.png)

02_基础操作/AI模型管理/基于openKylin本地部署并运行DeepSeek-R1开源模型.md

@@ -0,0 +1,79 @@
+# 基于openKylin本地部署并运行DeepSeek-R1开源模型
+
+## 第一步：下载并安装ollama
+
+
+●方式一
+
+执行如下命令：
+
+`curl -fsSL https://ollama.com/install.sh | sh`
+
+●方式二　
+
+前往github平台自行下载后解压，下载地址如下：
+
+
+`https://github.com/ollama/ollama/releases/tag/v0.5.7`
+
+
+执行如下命令进行解压缩：
+
+
+`sudo tar -C /usr -xzf ollama-linux-amd64.tgz`
+
+●方式三　
+
+如以上两种方式均无法成功下载，可通过关注openKylin公众号，回复ollama，获取百度网盘链接进行下载。　
+
+## 第二步：启动ollama服务　
+
+执行如下命令启动ollama服务：　
+
+`ollama serve`
+![输入图片说明](../assets/%E5%9F%BA%E4%BA%8EopenKylin%E6%9C%AC%E5%9C%B0%E9%83%A8%E7%BD%B2%E5%B9%B6%E8%BF%90%E8%A1%8CDeepSeek-R1%E5%BC%80%E6%BA%90%E6%A8%A1%E5%9E%8B/%E5%90%AF%E5%8A%A8ollama.png)
+
+然后打开一个新的终端窗口，查看是否已启动成功，如下图所示：　
+![输入图片说明](../assets/%E5%9F%BA%E4%BA%8EopenKylin%E6%9C%AC%E5%9C%B0%E9%83%A8%E7%BD%B2%E5%B9%B6%E8%BF%90%E8%A1%8CDeepSeek-R1%E5%BC%80%E6%BA%90%E6%A8%A1%E5%9E%8B/%E6%9F%A5%E7%9C%8Bollama%E7%89%88%E6%9C%AC%E5%8F%B7.png)
+
+## 第三步：下载并安装运行DeepSeek-R1模型　
+
+执行如下命令下载并安装运行DeepSeek-R1 1.5b模型　
+
+`ollama run deepseek-r1:1.5b`
+![输入图片说明](../assets/%E5%9F%BA%E4%BA%8EopenKylin%E6%9C%AC%E5%9C%B0%E9%83%A8%E7%BD%B2%E5%B9%B6%E8%BF%90%E8%A1%8CDeepSeek-R1%E5%BC%80%E6%BA%90%E6%A8%A1%E5%9E%8B/%E4%B8%8B%E8%BD%BDdeepseek%E6%A8%A1%E5%9E%8B.png)
+
+注意：本次演示以1.5b模型为例，若您的电脑性能更高，可下载安装DeepSeek-R1更高规格的模型，效果更好哦！具体官方命令如下：　
+
+DeepSeek-R1-Distill-Qwen-1.5B
+
+`ollama run deepseek-r1:1.5b`
+
+　
+DeepSeek-R1-Distill-Qwen-7B　　
+
+`ollama run deepseek-r1:7b`　　
+
+DeepSeek-R1-Distill-Llama-8B　　
+
+`ollama run deepseek-r1:8b`　　
+
+DeepSeek-R1-Distill-Qwen-14B　　
+
+`ollama run deepseek-r1:14b`　　
+
+DeepSeek-R1-Distill-Qwen-32B　　
+
+`ollama run deepseek-r1:32b`　　
+
+DeepSeek-R1-Distill-Llama-70B　　
+
+`ollama run deepseek-r1:70b`　　
+
+
+至此，已完成DeepSeek-R1模型的部署，接下来我们来问它一个问题测试一下：　
+![输入图片说明](../assets/%E5%9F%BA%E4%BA%8EopenKylin%E6%9C%AC%E5%9C%B0%E9%83%A8%E7%BD%B2%E5%B9%B6%E8%BF%90%E8%A1%8CDeepSeek-R1%E5%BC%80%E6%BA%90%E6%A8%A1%E5%9E%8B/%E6%B5%8B%E8%AF%95%E9%97%AE%E7%AD%94%E8%BF%90%E8%A1%8C%E7%BB%93%E6%9E%9C.png)
+
+可以看到，基于openKylin开源操作系统本地部署的DeepSeek-R1 1.5b模型，在较短的时间内即可给出它的分析过程及最终答案。
+
+

02_基础操作/openKylin系统如何在tty1终端正常显示中文.md

@@ -0,0 +1,37 @@
+# openKylin系统如何在tty1终端正常显示中文
+用户如果遇到桌面卡死需要到tty1终端里去查看日志时，往往因为无法查看中文目录而感到棘手。其实有多种方式可以个性化配置您的tty1窗口，让它可以正常显示中文。本文档将主要介绍通过fbterm的方式
+## 第一步
+执行如下命令安装fbterm、fcitx5-frontend-fbterm这两个包：
+
+```
+sudo apt install fbterm fcitx5-frontend-fbterm
+```
+
+## 第二步
+在~/.fbtermrc文件里，设置字体大小、输入法，如下图所示：
+
+![输入图片说明](assets/openKylin%E7%B3%BB%E7%BB%9F%E5%A6%82%E4%BD%95%E5%9C%A8tty1%E6%A8%A1%E5%BC%8F%E6%AD%A3%E5%B8%B8%E6%98%BE%E7%A4%BA%E4%B8%AD%E6%96%87/1.png)
+
+![输入图片说明](assets/openKylin%E7%B3%BB%E7%BB%9F%E5%A6%82%E4%BD%95%E5%9C%A8tty1%E6%A8%A1%E5%BC%8F%E6%AD%A3%E5%B8%B8%E6%98%BE%E7%A4%BA%E4%B8%AD%E6%96%87/2.png)
+
+## 第三步
+执行如下命令设置在fbterm终端下可使用快捷键
+```
+sudo setcap 'cap_sys_tty_config+ep' /usr/bin/fbterm
+```
+## 第四步
+在~/.bashrc文件中，增加如下配置，将fbterm设置成tty桌面默认终端
+
+
+```
+alias fbterm='LANG=zh_CN.UTF-8 fbterm'
+
+if [[ "$TERM" = linux ]] && [[ "$(ps otty= $$)" =~ tty ]] && type fbterm &>/dev/null; then
+
+        fbterm
+
+fi
+```
+
+## 最终效果
+![输入图片说明](assets/openKylin%E7%B3%BB%E7%BB%9F%E5%A6%82%E4%BD%95%E5%9C%A8tty1%E6%A8%A1%E5%BC%8F%E6%AD%A3%E5%B8%B8%E6%98%BE%E7%A4%BA%E4%B8%AD%E6%96%87/3.png)

02_基础操作/小白课程/openKylin文件管理器介绍.md

@@ -63,5 +63,8 @@ openKylin文件系统结构不同于Windows文件系统结构，没有盘符的
 如果你需要对文件路径进行记录，你只需要打开终端窗口，点击文件管理器窗口上端文件夹名称，右键选择复制选项，随后在终端窗口进行粘贴，此时便可得到该文件的具体路径。
 
 ![图片](https://www.openkylin.top/upload/202302/1675907689750834.png)
+### 4.复制文件夹路径
+如果你需要对文件夹路径进行记录，右键点击文件管理器地址栏文件夹名称，选择 拷贝路径，此时便可得到该文件夹的具体路径。
+![输入图片说明](./assets/openKylin文件管理器介绍/2024-08-14.png)
 
 以上就是本次openKylin文件管理器的基本介绍啦，希望能对大家有所帮助。目前，openKylin文件管理器仍然在不断的完善更新中，大家在使用过程中如有任何建议和需求，可前往openKylin Gitee仓库以Issue形式进行反馈。

02_基础操作/小白课程/openKylin用户手册原理解析.md

@@ -48,7 +48,6 @@ openKylin操作系统上用户手册的启动、展示、跳转是在QtWebkit基
 
 ![图片](https://www.openkylin.top/upload/202301/1673400502196692.png)
 
-ull Requ
 需要包含语言文件夹，一个图标；其中文件夹名称和图标名称保持一致，会用于首页图标展示以及用户手册dbus接口调用参数。
 
 #### 2.Markdown文件结构
@@ -57,7 +56,7 @@ ull Requ
 
 这里Markdown文档的一级标题会作为首页应用的展示名称。
 
-##3 3.修改install文件
+### 3.修改install文件
 
 ![图片](https://www.openkylin.top/upload/202301/1673400526886467.png)
 

02_基础操作/小白课程/利用openKylin社区自动开发者平台构建一个HelloWord软件包.md

@@ -0,0 +1,82 @@
+# 准备工作
+## 注册gitee账号
+https://gitee.com/
+## 签署cla
+https://cla.openkylin.top/
+## 申请成为单包维护者
+```
+https://gitee.com/openkylin/community/tree/master/packages
+name: ci-test-sample
+path: ci-test-sample
+maintainers:
+- name: xiewei
+  openkylinid: xiewei
+  displayname: 谢炜
+  email: xiewei@kylinos.cn
+```
+管理员审核通过后，后台将自动创建仓库，地址如下：https://gitee.com/openkylin/whfg-test
+
+# 初始化仓库并上传demo代码
+## 按照说明初始化仓库
+```
+mkdir demo
+cd demo
+git clone https://gitee.com/openkylin/whgf-test.git
+```
+## 上传自己的源代码到gitee仓库，并创建openkylin/nile打包分支
+```
+touch README.md
+mkdir user/
+mkdir user/bin
+touch user/bin/whgf-test
+```
+## 在程序文件中写入以下脚本代码后保存文件：
+```
+#!/bin/sh
+echo "Hello openKylin, start your first app!"
+```
+## 增加可执行权限：
+```
+chmod +x usr/bin/whgf-test
+```
+
+## 上传代码到仓库并创建打包分支
+```
+git add .
+git commit -m "first commit"
+git push
+```
+创建openKylin 2.0系列打包分支
+
+## 本地拉取上游更新，并切换到打包分支
+```
+git pull
+git checkout openkylin/nile
+```
+回到上一级目录
+
+
+# 生成debian目录
+```
+cp -r whgf-test/ whgf-test-1.0.0/
+tar -cvzf whgf-test-1.0.0.tar.gz whgf-test-1.0.0/
+cd whgf-test-1.0.0
+dh_make -f ../whgf-test-1.0.0.tar.gz -s -y
+```
+
+分别然后补充changlog/control/文件里的信息
+修改format文件里的格式为native
+
+# 将修改上传到仓库
+```
+git add debian
+git commit -m "add debian"
+git push
+```
+
+openKylin自动化开发者平台将自动构建上传软件包，审核通过后进行编译
+
+# 集成到镜像
+## 手动集成
+软件包编译完成后，进行下载，然后集成到镜像中去
+https://gitee.com/openkylin/docs/blob/master/04_%E7%A4%BE%E5%8C%BA%E8%B4%A1%E7%8C%AE/%E5%BC%80%E5%8F%91%E6%8C%87%E5%8D%97/openKylin%E7%B3%BB%E7%BB%9F%E9%95%9C%E5%83%8FISO%E5%AE%9A%E5%88%B6%E6%8C%87%E5%8D%97.md

02_基础操作/应用和游戏/使用HMCL启动器畅玩minecraft.md

@@ -0,0 +1,86 @@
+# 使用HMCL启动器畅玩minecraft
+
+---
+
+**更新日期**：2024.08.27
+**系统版本**：openKylin 2.0 x86_64
+
+---
+
+## 〇、前言
+
+Minecraft是一款非常受欢迎的沙盒游戏，而HMCL（Hello Minecraft! Launcher）是一款功能强大的Minecraft启动器，可以方便地管理和启动Minecraft游戏。
+本文将介绍在openKylin上如何使用HMCL启动器畅玩Minecraft。
+
+## 一、准备工作
+### 1.1 安装Java运行环境(JRE)
+1. 打开终端，输入`sudo apt install openjdk-21-jre`
+![](assets/openjdk.png)
+**注意**：1.21版本的minecoraft需要openjdk-21以上才能运行，但是hmcl暂时无法在23版本的openjdk下启动，所以这里选择21版本。
+
+### 1.2 下载并安装HMCL启动器
+1. 打开浏览器，访问HMCL官方网站下载页面：[https://hmcl.huangyuhui.net/download/](https://hmcl.huangyuhui.net/download/)
+2. 下载jar版本
+![](assets/下载hmcl.png)
+3. 下载完成后，将jar文件移动到合适的位置，例如`~/game`
+![](assets/保存到game文件夹.png)
+
+## 二、使用HMCL启动器畅玩minecraft
+### 2.1 启动HMCL启动器
+1. 刚才打开终端，进入到你存放`hmcl启动器`的目录，如果跟笔者一样的话就是输入`cd ~/game`
+2. 输入`java -jar hmcl.jar`启动HMCL启动器，首次启动会下载必要组件
+![](assets/下载组件.png)
+3. 下载完成后，就启动了HMCL启动器
+![](assets/hmcl启动器.png)
+
+
+
+### 2.2 快速启动 
+#### 2.2.1 别名启动
+显然每次输入那么多命令有点烦，我们可以编辑`.bashrc`，创建别名。
+1. 打开终端，输入`sudo nano ~/.bashrc`
+2. 在文件末尾添加`alias hmcl='java -jar ~/game/hmcl.jar'`，`ctrl+s`保存，`ctrl+x`退出
+![](assets/编辑bashrc.png)
+3. 输入`source ~/.bashrc`，使别名生效
+4. 输入`hmcl`启动HMCL启动器
+![](assets/别名启动.png)
+
+#### 2.2.2 创建桌面快捷方式
+当然也可以创建`.desktop`文件放到桌面上，这样就可以直接双击启动了。
+1. 打开终端，输入`nano ~/桌面/hmcl.desktop`
+2. 输入以下内容：
+```cpp{.line-numbers}
+[Desktop Entry]
+Name=HMCL
+Exec=java -jar /home/username/game/hmcl.jar
+Icon=/home/username/game/hmcl.png
+Type=Application
+Categories=Game;
+```
+   - **注意**：`/home/username/game/hmcl.jar`和`/home/username/game/hmcl.png`需要替换为你自己的路径，而且是绝对路径。
+3. 保存并退出，双击桌面上的HMCL图标即可启动。
+![](assets/desktop启动.png)
+### 2.3 下载版本
+此时我们还没有游戏版本，所以需要下载游戏版本，此时直接点启动游戏会自动跳转到有关界面。
+![](assets/下载游戏版本.png)
+![](assets/下载整合包.png)
+![](assets/等待下载完成.png)
+![](assets/安装成功.png)
+
+
+### 2.4 启动游戏
+安装成功后回到首页，点击启动游戏即可：
+![](assets/启动游戏.png)
+![](assets/耐心等待.png)
+![](assets/启动成功.png)
+
+
+## 三、注意事项 
+1. HMCL启动器需要Java运行环境，如果游戏不能正常运行，大概率是前面Java运行环境安装的问题，请仔细检查有关配置。
+2. 安装模组的时候请注意是forge的还是fabric，如不匹配无法正常加载。
+3. 尽量不要使用一键升级模组，很容易发生模组不兼容启动不了游戏的情况，很难排查到底是哪个模组的问题。
+
+## 四、结语
+使用HMCL启动器畅玩Minecraft非常简单，只需要下载并安装HMCL启动器，然后下载游戏版本，就可以开始游戏了。
+HMCL启动器还支持多账户登录、下载和安装各种模组、插件和资源包，大家可以自行摸索。
+

02_基础操作/应用和游戏/在openKylin-RISC-V编译运行Godot.md

@@ -0,0 +1,190 @@
+# 在openKylin RISC-V编译运行Godot
+
+为了扩展openkylin RISC-V游戏生态，一直在探索Godot这一开源游戏引擎在RISC-V设备上原生编译，以下是编译指南。特别感谢感谢Github开发者[MBCX](https://github.com/MBCX)的RISC-V交叉编译方法提供帮助和参考！
+
+
+![openKylin RISC-V Godot](assets/%E5%9C%A8openKylin-RISC-V%E7%BC%96%E8%AF%91%E8%BF%90%E8%A1%8CGodot/openKylinRISCVGodot.jpg)
+
+
+## 一、基础准备
+
+编译Godot至少需要4G内存，如果不足请开启swap，文章中演示的设备是8G内存。
+
+安装openKylin 2.0 RISC-V镜像，这里演示使用的是SpacemiT K1（Muse Book），请下载安装对应板卡的镜像。
+
+[在SpacemiT_K1上安装openKylin | openKylin文档平台](https://docs.openkylin.top/zh/01_%E5%AE%89%E8%A3%85%E5%8D%87%E7%BA%A7%E6%8C%87%E5%8D%97/%E5%9C%A8riscv%E4%B8%8A%E5%AE%89%E8%A3%85/%E5%9C%A8SpacemiT_K1%E4%B8%8A%E5%AE%89%E8%A3%85openKylin)
+
+## 二、克隆源代码
+
+克隆Godot 4.3源代码
+
+```bash
+sudo apt update
+sudo apt install git
+git clone https://github.com/godotengine/godot.git -b 4.3-stable --depth=1
+```
+
+## 三、安装编译依赖
+
+安装Godot编译依赖
+```bash
+sudo apt update
+sudo apt install -y \
+  build-essential \
+  pkg-config \
+  libx11-dev \
+  libxcursor-dev \
+  libxinerama-dev \
+  libgl1-mesa-dev \
+  libglu1-mesa-dev \
+  libasound2-dev \
+  libpulse-dev \
+  libudev-dev \
+  libxi-dev \
+  libxrandr-dev \
+  libwayland-dev
+```
+其中，openKylin 2.0的build-essential中gcc和g++版本默认是12，需要使用update-alternatives修改默认版本，切换到gcc-13和g++-13
+
+```bash
+# 安装gcc-13 g++-13
+sudo apt install gcc-13 g++-13
+
+sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-12 100
+sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-13 100
+
+# 输入gcc-13对应的数字序号
+sudo update-alternatives --config gcc
+```
+
+![切换GCC版本](assets/%E5%9C%A8openKylin-RISC-V%E7%BC%96%E8%AF%91%E8%BF%90%E8%A1%8CGodot/%E5%88%87%E6%8D%A2GCC%E7%89%88%E6%9C%AC.png)
+
+```bash
+# g++也是相同的步骤。
+
+sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-12 100
+sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-13 100
+
+# 输入g++-13对应的数字序号
+sudo update-alternatives --config g++
+```
+
+Godot项目使用SCons构建，SCons是一个开放源代码、以Python语言编写的自动化构建工具，在openKylin使用pip包安装程序安装SCons。
+```bash
+sudo apt install python3-pip
+
+sudo pip install scons -i https://pypi.tuna.tsinghua.edu.cn/simple --break-system-packages
+```
+检查SCons版本
+```bash
+openkylin@openkylin:~/godot$ scons -v
+SCons by Steven Knight et al.:
+	SCons: v4.8.0.7c688f694c644b61342670ce92977bf4a396c0d4, Sun, 07 Jul 2024 16:52:07 -0700, by bdbaddog on M1Dog2021
+	SCons path: ['/usr/local/lib/python3.12/dist-packages/SCons']
+Copyright (c) 2001 - 2024 The SCons Foundation
+```
+安装mold和Clang-17
+```
+sudo apt install mold clang-17
+```
+检查Clang版本，并确保编译器后端为GCC13，应该有如下输出：
+`Selected GCC installation: /usr/bin/../lib/gcc/riscv64-linux-gnu/13`
+```
+openkylin@openkylin:~/godot$ clang -v
+Openkylin clang version 17.0.6 (9ok4)
+Target: riscv64-unknown-linux-gnu
+Thread model: posix
+InstalledDir: /usr/bin
+Found candidate GCC installation: /usr/bin/../lib/gcc/riscv64-linux-gnu/12
+Found candidate GCC installation: /usr/bin/../lib/gcc/riscv64-linux-gnu/13
+Found candidate GCC installation: /usr/bin/../lib/gcc/riscv64-linux-gnu/8
+Selected GCC installation: /usr/bin/../lib/gcc/riscv64-linux-gnu/13
+```
+
+## 四、开始构建
+
+cd进入源码目录构建
+```bash
+cd godot
+```
+
+指定目标架构为`rv64`，启用Clang作为LLVM编译器前端，指定链接器为`mold`（GNU ld无法正确链接）并同时禁用链接时优化。
+```
+arch="rv64" use_llvm="yes" linker="mold" lto="none"
+```
+启用fb文本服务器后端（Godot有两种文本后端`fb`和`adv`）
+```
+module_text_server_fb_enabled="yes"
+```
+
+同时需要禁用一些在RISC-V设备可能没法正常工作的Godot模块
+
+```
+# 禁用Theora视频编码支持
+module_theora_enabled="no"
+# 禁用去噪模块
+module_denoise_enabled="no"
+# 禁用光线投射模块
+module_raycast_enabled="no"
+# 禁用Xatlas纹理展开模块
+module_xatlas_unwrap_enabled="no"
+```
+
+使用以下命令构建Godot编辑器
+```
+scons -j8 arch="rv64" use_llvm="yes" linker="mold" lto="none" \
+     target="editor" platform="linux" \
+     precision="single" module_text_server_fb_enabled="yes" \
+     module_theora_enabled="no" \
+     module_denoise_enabled="no" \
+     module_raycast_enabled="no" \
+     module_xatlas_unwrap_enabled="no"
+```
+使用以下命令构建Debug导出模板
+```
+scons -j8 arch="rv64" use_llvm="yes" linker="mold" lto="none" \
+     target="template_debug" platform="linux" \
+     precision="single" module_text_server_fb_enabled="yes" \
+     module_theora_enabled="no" \
+     module_denoise_enabled="no" \
+     module_raycast_enabled="no" \
+     module_xatlas_unwrap_enabled="no"
+```
+使用以下命令构建Release导出模板
+```
+scons -j8 arch="rv64" use_llvm="yes" linker="mold" lto="none" \
+     target="template_release" platform="linux" \
+     precision="single" module_text_server_fb_enabled="yes" \
+     module_theora_enabled="no" \
+     module_denoise_enabled="no" \
+     module_raycast_enabled="no" \
+     module_xatlas_unwrap_enabled="no"
+```
+
+![编译Godot](assets/%E5%9C%A8openKylin-RISC-V%E7%BC%96%E8%AF%91%E8%BF%90%E8%A1%8CGodot/%E7%BC%96%E8%AF%91Godot.png)
+
+
+## 五、运行Godot
+
+cd进入bin目录
+
+```bash
+cd bin
+```
+运行Godot编辑器，openKylin 2.0镜像默认使用wlcom（基于Wayland协议），IMG的GPU可以使用GLES，因此需要加上启动参数`--display-driver wayland opengl_es3`，如果设备可以外接AMD GPU可以尝试用GL（比如SG2042）。
+
+
+```
+chmod +x godot.linuxbsd.editor.rv64.llvm
+
+./godot.linuxbsd.editor.rv64.llvm --display-driver wayland opengl_es3
+```
+
+![运行Godot](assets/%E5%9C%A8openKylin-RISC-V%E7%BC%96%E8%AF%91%E8%BF%90%E8%A1%8CGodot/%E8%BF%90%E8%A1%8CGodot.png)
+
+
+## 六、设置项目启动参数
+
+在调试项目时，Godot仍会使用默认的软渲染管线，因此需要将`--display-driver wayland opengl_es3`添加到项目设置
+
+![运行参数](assets/%E5%9C%A8openKylin-RISC-V%E7%BC%96%E8%AF%91%E8%BF%90%E8%A1%8CGodot/%E8%BF%90%E8%A1%8C%E5%8F%82%E6%95%B0.png)

02_基础操作/应用和游戏/安装Visual_Studio_Code.md

@@ -0,0 +1,17 @@
+# 安装 Visual Studio Code
+
+## 使用软件商店安装
+
+打开软件商店，选择全部分类->开发
+
+在开发标签中找到 Visual Studio Code 软件，点击安装
+
+![选择Visual Studio Code](assets/install-vs-code/2025-01-20_08-54-30.png)
+
+等待一段时间后,软件商店提示安装完成
+
+![Visual Studio Code 安装完成](assets/install-vs-code/2025-01-20_08-55-20.png)
+
+点击打开按钮，即可打开 Visual Studio Code
+
+![Visual Studio Code 界面展示](assets/install-vs-code/2025-01-20_08-56-53.png)

03_常见问题/FAQ.md

@@ -1,6 +1,46 @@
 # FAQ
 > 这个页面是由Docs SIG和FAQ SIG共同维护的问答列表，广泛收集大家的问题以及问题解决方案，欢迎贡献！
 
+## 修复被破坏的apt软件包依赖关系
+
+- Q: 怎么修复软件包依赖问题
+- A: 可以执行以下命令
+
+```bash
+sudo apt install -f
+```
+
+## 如何查看连接的显示器各项信息
+
+- Q：怎么查看显示器的协议、刷新率、分辨率等信息
+- A：使用 `xrandr` 查看连接的显示器信息，如下
+
+```bash
+xrandr --verbose
+```
+找到已连接的显示器（标记为 connected），其接口名称会直接标明类型（如 HDMI-1 或 DP-1）
+
+```bash
+Screen 0: minimum 8 x 8, current 1920 x 2160, maximum 32767 x 32767
+HDMI-0 connected primary 1920x1080+0+0 (normal left inverted right x axis y axis) 530mm x 290mm
+   1920x1080     60.00 +  75.00*   60.00    59.94    50.00  
+   1680x1050     59.95  
+   1600x900      60.00  
+   1440x900      59.89  
+   1366x768      59.79  
+   1360x765      60.00  
+   1280x1024     75.02    60.02  
+   1280x960      60.00  
+   1280x720      60.00    59.94    50.00  
+   1152x864      60.00  
+   1024x768      75.03    70.07    60.00  
+   800x600       75.00    60.32  
+   720x480       59.94  
+   640x480       75.00    59.94    59.93  
+DP-0 connected 1920x1080+0+1080 (normal left inverted right x axis y axis) 344mm x 193mm
+   1920x1080     60.10*+ 165.01  
+```
+
 ## 安装apk包
 - Q：可以安装自己下载的apk包么？
 - A：可以，将apk下载到本地后，右键点击，打开方式选择安装器。
@@ -10,7 +50,7 @@
 - Q：如何升级openKylin？
 - A：可以执行以下命令
 
-```
+```bash
 sudo apt update
 sudo apt full-upgrade
 ```
@@ -85,3 +125,69 @@ Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
      可以通过`sudo fdisk -l`即可查看磁盘类型和大小、磁盘机型、扇区大小和其他附加信息。
 
      可以通过`hwinfo --disk`即可在Linux系统中查看硬碟硬件信息。
+
+
+## 如何查看 Linux 电池信息
+- Q：如何查看 Linux 电池容量等信息
+- A：可以通过`upower`命令，即可输出电池的详细信息，具体操作如下：
+
+     打开终端，运行如下命令，确定电池的路径
+```
+ upower --enumerate
+```
+ 在我的电脑上，电池路径为  /org/freedesktop/UPower/devices/battery_BAT1
+
+     
+  然后通过  upower -i 并粘贴电池设备路径，即可查看电池相关信息
+
+```
+ upower -i /org/freedesktop/UPower/devices/battery_BAT1
+```
+输出如下
+```
+  native-path:          BAT1
+  vendor:               LENOVO
+  model:                PABAS0241231
+  serial:               41167
+  power supply:         yes
+  updated:              2024年08月29日 星期四 14时46分57秒 (18 seconds ago)
+  has history:          yes
+  has statistics:       yes
+  battery
+    present:             yes
+    rechargeable:        yes
+    state:               fully-charged
+    warning-level:       none
+    energy:              29.04 Wh
+    energy-empty:        0 Wh
+    energy-full:         29.04 Wh
+    energy-full-design:  31.68 Wh
+    energy-rate:         0 W
+    voltage:             16.113 V
+    charge-cycles:       N/A
+    percentage:          100%
+    capacity:            91.6667%
+    technology:          lithium-ion
+    icon-name:          'battery-full-charged-symbolic'
+
+```
+ energy-full 是电池现在可容纳的最大电量，energy-full-design 是电池出厂时可容纳的最大电池容量 , capacity以百分比表示差异    
+
+## 如何开启终端里命令补全时忽略大小写的功能
+- Q：目录名或文件名，包含大小写时，自动补全会比较麻烦，如何忽略
+- A：执行如下命令即可
+    ``` 
+   echo "set completion-ignore-case on" >> ~/.inputrc
+    ```
+   该操作容易造成命令混淆和影响环境变量等，请谨慎操作
+
+
+## 为root用户设置密码
+
+- Q: 如何为root用户设置密码？
+- A: 可以执行以下命令
+
+    ```bash
+    sudo passwd root
+    ```
+    注意事项：请牢记root密码并不要轻易向他人透露root密码，在root用户下操作需谨慎！

04_社区贡献/openKylin社区技术全景案例集-案例模板.md

@@ -21,8 +21,15 @@ xxxxx项目位于gitee上，地址为：https://gitee.com/xxxx/yyyy。你可以
 ## 合作伙伴
 xxxxxxx
 
+# 三、生态适配成果案例参考模板
+## 产品介绍
+介绍该产品的基本信息（型号或版本）及主要特性或功能，硬件产品如处理器、显卡、外设等等；软件产品主要包括应用、开发工具、AI大模型等等。
+## 适配情况
+介绍该产品与openKylin操作系统的具体适配测试情况
+## 适配伙伴
+xxxxxxx（企业名称）
 
-# 三、用户使用案例参考模板
+# 四、用户使用案例参考模板
 ## 使用场景
 描述一个用户在openKylin社区产品或服务的具体场景。这包括使用的设备、应用场景、任务和目的等信息。
 ## 解决问题

04_社区贡献/openKylin贡献攻略.md

@@ -56,7 +56,7 @@ SIG即Special Interest Group的缩写，为了更好的管理和改善工作流
 
 如果您感兴趣的领域没有成立对应的SIG组，但是您希望在社区成立一个新的相关SIG进行维护和发展，您可以进行SIG组创建，具体流程如下：
 
-github项目页申请 -> 技术委员会审核 -> 创建邮件列表等基础设施 -> 开始运作
+Gitee项目页申请 -> 技术委员会审核 -> 创建邮件列表等基础设施 -> 开始运作
 
 ## 4、开启社区贡献之旅
 

04_社区贡献/开发指南/RISC-V版本Arduino_IDE安装.md

@@ -0,0 +1,25 @@
+# 在 RISC-V 版本 openKylin 系统中安装Arduino IDE
+
+## 1\. 环境准备
+- 开发板安装官网最新版 [openKylin 2.0](https://www.openkylin.top/downloads/) 镜像 
+- Arduino 兼容开发板
+
+## 2\. 安装步骤
+1. 打开终端 输入`sudo apt update`更新软件源
+
+2. 输入`sudo apt install arduino-ide` 安装 Arduino IDE
+
+3. 在开始菜单中找到 Arduino IDE 图标，单击打开。等待自动安装AVR工具链（视网络情况和机器性能，需要等待5-30分钟，如果安装失败可在开发板管理器中安装对应开发板）
+
+    ![](./assets/RISC-V%E7%89%88%E6%9C%ACArduino%20IDE%E5%AE%89%E8%A3%85/2024-09-13_12-57-36.png)
+
+4. 可选： 安装算能 SG200X 系列开发板工具
+    - 参考官方文档 https://milkv.io/zh/docs/duo/getting-started/arduino
+    - 替换 `其他开发板管理器地址` 为以下地址
+    > https://blob.bits.ink/arduino/packages/package_sg200x_index.json
+
+    ![](./assets/RISC-V%E7%89%88%E6%9C%ACArduino%20IDE%E5%AE%89%E8%A3%85/20240913131153.png)
+
+    - 其他步骤与官方文档相同，安装工具需要等待较长时间，请耐心等待安装完成，如遇安装失败请重新添加开发板并安装。
+
+5.  如遇到无法访问串口设备问题，请在终端执行命令`sudo usermod -a -G dialout $USER`并重启系统即可解决。

04_社区贡献/开发指南/openKylin开发环境配置手册.md

@@ -0,0 +1,135 @@
+# 一、安装openKylin
+常见的安装方式有以下两种：直接安装、虚拟机。
+openKylin镜像链接如下：
+
+https://www.openkylin.top/downloads/download-smp.php?id=80
+
+1、直接安装：将openKylin操作系统直接安装到计算机的硬盘上来使用。这种方法需要制作一个u盘启动盘，可以使用openKylin中的u盘启动器或windows中的rufus均可将openKylin操作系统的iso镜像制作到u盘启动盘中。将其接入计算机并从该启动盘引导，然后按照安装器向导的指示进行操作。安装过程中可以直接全盘安装、或安装双系统均可。
+
+![输入图片说明](assets/openKylin%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E9%85%8D%E7%BD%AE%E6%89%8B%E5%86%8C/%E5%9B%BE%E7%89%871.png)![输入图片说明](assets/openKylin%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E9%85%8D%E7%BD%AE%E6%89%8B%E5%86%8C/%E5%9B%BE%E7%89%872.png)
+
+2、虚拟机：在windows电脑上使用虚拟机软件来在计算机上创建一个虚拟的环境，并在其中安装openKylin系统。常用的虚拟机软件有VMware、VirtualBox等。这种方法允许开发者在现有的操作系统上同时运行openKylin，可以参考网络上的相关资料来安装虚拟机。
+
+部分开发者可能希望在arm、riscv开发板中安装openKylin，也建议首先在x86机器中安装，以此来熟悉openKylin开发环境的配置方法。arm、riscv开发板中openKylin安装指南链接如下：  
+[arm上安装openKylin.md](/01_安装升级指南/arm上安装openKylin.md)
+[riscv上安装openKylin](/01_安装升级指南/riscv上安装openKylin.md)
+
+
+# 二、基础编译环境配置
+安装openKylin并启动之后，可以通过以下步骤来编写.c文件并对其编译和运行：  
+1、安装编译环境：  
+按ctrl+alt+t或右键菜单->打开终端，终端内运行以下命令安装GCC和构建工具链：  
+
+```
+sudo apt update  # 更新软件包列表  
+sudo apt install build-essential  # 包含gcc、g++、make等  
+```
+
+2、编写helloworld.c  
+在终端中使用文本编辑器创建.c文件  
+`vim helloworld.c`
+按i进入输入模式，并输入以下内容：  
+
+```
+#include <stdio.h>
+int main() {
+    printf("Hello, World!\n");
+    return 0;
+}
+```
+
+保存并退出  esc->:wq->Enter
+
+3、编译程序  
+使用gcc编译源代码：  
+`gcc helloworld.c -o helloworld`
+
+4、运行程序  
+运行编译出的二进制文件  
+`./helloworld`
+输出为：  
+`Hello, World!`
+
+# 三、qt环境配置  
+qt是一个跨平台的 图形界面框架，支持高效开发桌面、嵌入式和移动应用。openKylin桌面组件大多基于qt开发，以下是配置qt开发环境的方法。  
+1、安装qt开发环境所需软件包  
+
+```
+sudo apt update
+sudo apt install qtcreator qt5-qmake qtbase5-dev g++
+```
+
+
+2、安装完成后在终端中执行qtcreator来启动，启动后创建新项目：文件->新建文件或项目。  
+之后需要配置编译套件：界面左侧项目->Manage Kits->Kits->Qt Versions->添加，其中选择/usr/lib/qt5/bin/qmake  
+开发者按自己的需要修改项目后，点击界面左下角的构建、运行按钮来编译并运行项目。  
+
+![输入图片说明](assets/openKylin%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E9%85%8D%E7%BD%AE%E6%89%8B%E5%86%8C/%E5%9B%BE%E7%89%873.png)
+![输入图片说明](assets/openKylin%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E9%85%8D%E7%BD%AE%E6%89%8B%E5%86%8C/%E5%9B%BE%E7%89%874.png)
+
+# 四、deb构建环境配置
+deb是openKylin系统中使用的软件包格式，当开发者创建了一个工程后，可以在工程中添加debian目录并将工程编译成deb包。之后可以使用apt或dpkg命令将该deb包安装到openKylin系统中。具体操作流程如下：  
+
+1、安装deb构建所需环境：
+`sudo apt install devscripts`
+
+2、生成debian目录前需要将项目文件夹改名为项目-1.0.0类似格式（生成debian目录后可以修改回原名），之后在项目所在目录执行以下命令生成debian目录：
+`dh_make --createorig -e $邮箱地址。          选择s`
+
+3、接下来需要修改debian目录，其中必须保留以下文件，具体功能如下：  
+
+```
+source/format：用于定义源码包的格式版本和打包规则，本地创建的包需要将该文件内容修改为3.0 (native)
+changelog：记录软件包的版本变更历史及修订说明
+control：定义软件包的元数据和依赖关系
+copyright：声明软件的法律许可信息
+install：指定需要安装的文件及其目标路径
+rules：定义软件包的构建规则
+```
+
+
+以下文件为debian目录中的可选文件，具体功能如下：
+
+```
+preinst：软件包安装前执行的脚本
+postinst：软件包安装后执行的脚本
+prerm：软件包卸载前执行的脚本
+postrm：软件包卸载后执行的脚本
+manpage：提供软件的man手册页
+```
+
+
+可参考：https://www.debian.org/doc/manuals/maint-guide/index.zh-cn.html
+
+4、修改debian目录后，通过以下命令构建deb包：
+`debuild`
+执行后会在项目所在的上层目录中构建出deb包，可以通过sudo apt install ./*.deb或sudo dpkg -i *.deb安装该deb包。
+
+# 五、ssh环境配置
+开发者可以通过ssh安全的远程登录和管理其他计算机，以下是配置ssh环境的方法。  
+1、安装ssh服务
+
+```
+sudo apt update
+sudo apt install openssh-client openssh-server
+```
+
+2、启动ssh服务
+`sudo systemctl start ssh`
+3、查看服务是否启动成功
+`ps -aux | grep ssh`
+查看其中是否有sshd字段，有则代表启动成功。例如：
+
+![输入图片说明](assets/openKylin%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E9%85%8D%E7%BD%AE%E6%89%8B%E5%86%8C/%E5%9B%BE%E7%89%875.png)
+
+4、远程登录其他计算机  
+`ssh user@192.168.1.1`   
+其中user为目标电脑的用户名。192.168.1.1为目标电脑的ip地址，可在目标电脑中通过ifconfig查看ip。执行以上命令后需要的操作：  
+（1）首次连接时需要输入yes。  
+（2）输入user在目标电脑上的登录密码。成功连接后终端提示符会变为user@目标主机名，代表连接成功。  
+
+# 六、kylin-aisdk环境配置
+https://mp.weixin.qq.com/s/IdHbAn0JNmhDg2MIf-dn3w
+
+# 七、deepseek本地部署方法
+https://mp.weixin.qq.com/s/4opXzFxV-AjUelYE8Q4tTQ