!373 文档征集活动九月内容整理

Merge pull request !373 from DSOE1024/dev-faq

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的性能，并且安装过程比较简单，推荐使用。

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_基础操作/应用和游戏/使用HMCL启动器畅玩minecraft.md

@@ -0,0 +1,86 @@
+# 使用HMCL启动器畅玩minecraft
+
+---
+
+**更新日期**：2024.08.27
+**系统版本**：openKylin 2.0 x86_64
+
+---
+
+## 〇、前言
+
+Minecraft是一款非常受欢迎的沙盒游戏，而HMCL（Hypixel 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)

03_常见问题/FAQ.md

@@ -85,3 +85,58 @@ 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
+    ```
+   该操作容易造成命令混淆和影响环境变量等，请谨慎操作