Merge pull request #310 from Karlbaey101/Karlbaey101-patch-READMEFormat0-1

修改 README.md 格式
2026-05-20 08:35:46 +08:00 · 2025-05-31 22:41:23 +08:00
parent 91688ec4ae e1f24796b2
commit 7e685fae64
1 changed files with 48 additions and 47 deletions
--- a/README.md
+++ b/README.md
@@ -1,88 +1,91 @@
-<p align="center"><img src="readme/cover0.png" alt="小小电脑使用照片" height="400"></img></p>
+[![小小电脑使用照片](https://github.com/Cateners/tiny_computer/raw/master/readme/cover0.png)](https://github.com/Cateners/tiny_computer/blob/master/readme/cover0.png)

 # 小小电脑

-给所有安卓arm64设备的“PC应用引擎”平替。你可以在小小电脑上安装PC级WPS、CAJ Viewer、亿图图示等软件。
+给所有安卓 arm64 设备的“PC 应用引擎”平替。你可以在小小电脑上安装 PC 级 WPS、CAJ Viewer、亿图图示等软件。

 Click-to-run Debian Bookworm XFCE/LXQt/... on Android for Chinese users, with the Fcitx Pinyin input method preinstalled. No Termux is required. If you want to change the language in the container, run "tmoe", since this root filesystem is made using [tmoe](https://github.com/2moe/tmoe).

 ## 特点

 - 一键安装，即开即用
- 来自kali-undercover的win10主题(仅xfce版本)，友好的界面
+- 来自 kali-undercover 的 win10 主题(仅 xfce 版本)，友好的界面

-![1](readme/img1.png)
+[![1](https://github.com/Cateners/tiny_computer/raw/master/readme/img1.png)](https://github.com/Cateners/tiny_computer/blob/master/readme/img1.png)

 - 提供常用软件的一键安装指令

-![1](readme/img2.png)
+[![1](https://github.com/Cateners/tiny_computer/raw/master/readme/img2.png)](https://github.com/Cateners/tiny_computer/blob/master/readme/img2.png)

 - 可方便地改变屏幕缩放，不用担心屏幕过大或过小

-![1](readme/img3.gif)
+[![1](https://github.com/Cateners/tiny_computer/raw/master/readme/img3.gif)](https://github.com/Cateners/tiny_computer/blob/master/readme/img3.gif)

- 便捷访问设备文件，或通过设备SAF访问软件文件
+- 便捷访问设备文件，或通过设备 SAF 访问软件文件

-![1](readme/img4.png)
+[![1](https://github.com/Cateners/tiny_computer/raw/master/readme/img4.png)](https://github.com/Cateners/tiny_computer/blob/master/readme/img4.png)

 - 提供终端和众多可调节参数供高级用户使用

-![1](readme/img5.png)
+[![1](https://github.com/Cateners/tiny_computer/raw/master/readme/img5.png)](https://github.com/Cateners/tiny_computer/blob/master/readme/img5.png)

 ## 下载

-小小电脑提供多个版本。要将小小电脑作为PC应用引擎使用，请在[Releases](https://github.com/Cateners/tiny_computer/releases)页面下载并安装[XFCE](https://xfce.org/)版本（tiny-computer-xfce.apk）。
+小小电脑提供多个版本。要将小小电脑作为 PC 应用引擎使用，请在 [Releases](https://github.com/Cateners/tiny_computer/releases) 页面下载并安装 [XFCE](https://xfce.org/) 版本（tiny-computer-xfce.apk）。

-如果遇到黑屏问题，请卸载后尝试[LXQt](https://lxqt-project.org/)版本（Releases页寻找tiny-computer-lxqt.apk）。
+如果遇到黑屏问题，请卸载后尝试 [LXQt](https://lxqt-project.org/) 版本（[Releases](https://github.com/Cateners/tiny_computer/releases) 页寻找 tiny-computer-lxqt.apk）。

 这些版本的区别在于桌面环境不同。你可以简单地理解为界面不一样，但功能基本一致。

-LXQt的界面示例：
+LXQt 的界面示例：

-![1](https://lxqt-project.org/images/screenshots/ambiance.png)
+[![1](https://camo.githubusercontent.com/016ff8803c228f26db750c8424777d8e04a3aebec4ff11d8436a0b22a2e6f58a/68747470733a2f2f6c7871742d70726f6a6563742e6f72672f696d616765732f73637265656e73686f74732f616d6269616e63652e706e67)](https://camo.githubusercontent.com/016ff8803c228f26db750c8424777d8e04a3aebec4ff11d8436a0b22a2e6f58a/68747470733a2f2f6c7871742d70726f6a6563742e6f72672f696d616765732f73637265656e73686f74732f616d6269616e63652e706e67)

-如果你下载小小电脑是为了体验更多桌面环境，享受折腾Linux的乐趣，这里也有一些其他版本供下载！
+如果你下载小小电脑是为了体验更多桌面环境，享受折腾 Linux 的乐趣，这里也有一些其他版本供下载！

-和[GXDE](https://www.gxde.org/)团队合作的版本[#129](https://github.com/Cateners/tiny_computer/issues/129)。可在[此处](https://mirrors.sdu.edu.cn/spark-store-repository/GXDE-OS/APK/)下载。GXDE的界面示例：
+和 [GXDE](https://www.gxde.org/) 团队合作的版本 [#129](https://github.com/Cateners/tiny_computer/issues/129)。可在[此处](https://mirrors.sdu.edu.cn/spark-store-repository/GXDE-OS/APK/)下载。GXDE 的界面示例：

-![1](https://www.gxde.org/1.png)
-
-由[灵墨桌面](https://www.lingmo.org/)开发者提供的版本[#218](https://github.com/Cateners/tiny_computer/issues/218)。灵墨桌面的界面[示例](https://www.bilibili.com/video/BV1Ci421R7AR)
+[![1](https://camo.githubusercontent.com/2884358def5f52e31b9f6dfc72be081f8defcc2c1463f8050786cb1f033fe761/68747470733a2f2f7777772e677864652e6f72672f312e706e67)](https://camo.githubusercontent.com/2884358def5f52e31b9f6dfc72be081f8defcc2c1463f8050786cb1f033fe761/68747470733a2f2f7777772e677864652e6f72672f312e706e67)

+由[灵墨桌面](https://www.lingmo.org/)开发者提供的版本[#218](https://github.com/Cateners/tiny_computer/issues/218)。灵墨桌面的界面[示例](https://www.bilibili.com/video/BV1Ci421R7AR)。

 ## 原理

-使用proot运行debian环境
+使用 proot 运行 debian 环境。

-内置[noVNC](https://github.com/novnc/noVNC)/[AVNC](https://github.com/gujjwal00/avnc)/[Termux:X11](https://github.com/termux/termux-x11)显示图形界面
+内置 [noVNC](https://github.com/novnc/noVNC)/[AVNC](https://github.com/gujjwal00/avnc)/[Termux:X11](https://github.com/termux/termux-x11) 显示图形界面。

 ## 项目结构

-assets的文件来源信息可以在[这里](extra/readme.md)找到。
+assets 的文件源信息可以在[这里](https://github.com/Cateners/tiny_computer/blob/master/extra/readme.md)找到。

-完整的容器制作过程可以在[这里](extra/build-tiny-rootfs.md)看到。
+完整的容器制作过程可以在[这里](https://github.com/Cateners/tiny_computer/blob/master/extra/build-tiny-rootfs.md)看到。

-数据包不再在assets中更新，而是随releases提供，主要是为了避免git越来越大
+数据包不再在 assets 中更新，而是随 releases 提供，主要是为了避免 git 越来越大。

-lib目录：
+lib 目录：

- main.dart文件，页面布局，有点乱
- workflow.dart文件，逻辑部分，目前也还可以理解
-  - Util 工具类
-  - TermPty 一个终端
-  - G 全局变量类
-  - Workflow 从软件点开到容器启动的所有步骤
+- main.dart 文件，页面布局，有点乱
+- workflow.dart 文件，逻辑部分，目前也还可以理解
+	- Util 工具类
+	- TermPty 一个终端
+	- G 全局变量类
+	- Workflow 从软件点开到容器启动的所有步骤

 ## 编译

-你需要配置好flutter和安卓sdk，还需安装python3、bison、patch、gcc，然后克隆此项目。
+你需要配置好 flutter 和安卓 sdk，还需安装 python3、bison、patch 和 gcc，然后克隆此项目。

-在编译之前，需要在release中下载patch.tar.gz拷贝到assets；以及下载系统rootfs(或者[自行制作](extra/build-tiny-rootfs.md))，之后使用split命令分割，拷贝到assets。一般我将其分为98MB。
+在编译之前，需要在 release 中下载 patch.tar.gz 拷贝到 assets；以及下载系统 rootfs（或者[自行制作](https://github.com/Cateners/tiny_computer/blob/master/extra/build-tiny-rootfs.md)），之后使用 split 命令分割，拷贝到 assets。一般我将其分为 98MB。

-`split -b 98M debian.tar.xz`
+```bash
+split -b 98M debian.tar.xz
+```
+
+还需要对 flutter 的一些默认配置作修改，因为其与项目中 build.gradle 的一些设置冲突。
+
+- 注释或删除 `flutter\packages\flutter_tools\gradle\src\main\groovy\flutter.groovy` 路径下与 `ShrinkResources` 相关的 `if` 代码块。

-还需要对flutter的一些默认配置作修改，因为其与项目中build.gradle的一些设置冲突。
- 注释或删除`flutter\packages\flutter_tools\gradle\src\main\groovy\flutter.groovy`路径下与`ShrinkResources`相关的`if`代码块。
 ```groovy
            // if (shouldShrinkResources(project)) {
            //     release {
@@ -101,23 +104,23 @@ lib目录：

 接下来就可以编译了。我使用的命令如下：

-`flutter build apk --target-platform android-arm64 --split-per-abi --obfuscate  --split-debug-info=tiny_computer/sdi`
+```bash
+flutter build apk --target-platform android-arm64 --split-per-abi --obfuscate  --split-debug-info=tiny_computer/sdi
+```

-有一些C代码可能报错。比如KeyBind.c等文件，报错一些符号未定义。但其实包含那些符号的函数并没有被使用，所以可以把它们删掉再编译。
-应该有编译选项可以避免这种情况，但我对cmake不熟，就先这样了:P
+有一些 C 代码可能报错。比如 KeyBind.c 等文件，报错一些符号未定义。但其实包含那些符号的函数并没有被使用，所以可以把它们删掉再编译。 应该有编译选项可以避免这种情况，但我对 cmake 不熟，就先这样了:P

-## 目前已知bug
+## 目前已知 bug

-多用户/分身情形无法sudo, 其它见issue
+多用户/分身情形无法 sudo , 其它见 issue。

 ## 一些链接

-这是我的第一个flutter软件，感谢这些项目为我指路
+这是我的第一个 flutter 软件，感谢这些项目为我指路

- 要一点基础的 [《Flutter实战·第二版》](https://book.flutterchina.club)
+- 要一点基础的[《Flutter实战·第二版》](https://book.flutterchina.club/)
 - 也许是零基础的Flutter视频课程 [freeCodeCamp Flutter Course](https://www.youtube.com/watch?v=wFn-m-OgKPU&list=PL6yRaaP0WPkVtoeNIGqILtRAgd3h2CNpT)
-
- 安卓上的VS Code [Code FA](https://github.com/nightmare-space/vscode_for_android)
+- 安卓上的 VS Code [Code FA](https://github.com/nightmare-space/vscode_for_android)

 ## Getting Started

@@ -128,6 +131,4 @@ A few resources to get you started if this is your first Flutter project:
 - [Lab: Write your first Flutter app](https://docs.flutter.dev/get-started/codelab)
 - [Cookbook: Useful Flutter samples](https://docs.flutter.dev/cookbook)

-For help getting started with Flutter development, view the
-[online documentation](https://docs.flutter.dev/), which offers tutorials,
-samples, guidance on mobile development, and a full API reference.
+For help getting started with Flutter development, view the [online documentation](https://docs.flutter.dev/), which offers tutorials, samples, guidance on mobile development, and a full API reference.