docs: 扩展文档内容并优化资源结构

- 新增多个社区平台资源链接 (X、小红书、即刻、Folo)
- 扩充 Linux 文档内容 (数据处理、用户管理、系统管理)
- 更新 CI/CD 部分，重新组织 commit hooks 分类
- 添加 pretier 镜像源用于 pre-commit
- 新增 clean 脚本命令

Co-Authored-By: Claude <noreply@anthropic.com>

Author: Phil-Fan

README.md

@@ -11,7 +11,11 @@
 - [Linux.do](https://linux.do/)
 - [Hacker News](https://news.ycombinator.com/)
 - [OSPP](https://summer-ospp.ac.cn)
+- [X](https://x.com/)
+- [小红书](https://www.xiaohongshu.com/)
 - [小宇宙](https://www.xiaoyuzhoufm.com/)
+- [即刻](https://web.okjike.com)
+- [Folo](https://github.com/RSSNext/Folo): All-in-one RSS reader.
 
 ## AI 相关
 
@@ -72,9 +76,13 @@ brew install gemini-cli
 提问语句：
 
 ```text
-read this @SPEC.md and interview me in detail using the AskUserQuestionTool about literally anything: technical implementation, UI & UX, concerns, tradeoffs, etc. but make sure the questions are not obvious
+read this @SPEC.md and interview me in detail
+using the AskUserQuestionTool about literally anything: 
+technical implementation, UI & UX, concerns, tradeoffs, etc. 
+but make sure the questions are not obvious
 
-be very in-depth and continue interviewing me continually until it's complete, then write the spec to the file
+be very in-depth and continue interviewing me continually 
+until it's complete, then write the spec to the file.
 ```
 
 ### Skills
@@ -194,11 +202,15 @@ npx create-next-app@latest my-app
 - [jenkins](https://www.jenkins.io)
 - [Dagger](https://dagger.io/)：可编排的 CI/CD 引擎
 - [Drone CI](https://github.com/harness/drone)
-- [pre-commit](https://github.com/pre-commit/pre-commit)：多语言 pre-commit hooks 管理框架
+
+- commit hooks:
+  - [pre-commit](https://github.com/pre-commit/pre-commit)：多语言 pre-commit hooks 管理框架
+  - [husky](https://github.com/typicode/husky) 适合前端项目
 
 - Linter:
   - [eslint/eslint](https://github.com/eslint/eslint): JavaScript/TypeScript 静态分析
   - [prettier/prettier](https://github.com/prettier/prettier): 代码格式化
+    - [rbubley/mirrors-prettier](https://github.com/rbubley/mirrors-prettier) for pre-commit
   - [biomejs/biome](https://github.com/biomejs/biome): 一体化 Linter & Formatter & Bundler（ESLint + Prettier 替代）
   - [markdownlint](https://github.com/DavidAnson/markdownlint): Markdown 静态分析
   - [autocorrect](https://github.com/huacnlee/autocorrect): CJK 排版自动修正

docs/AI/MCP.md

@@ -14,7 +14,9 @@ MCP 并不是最早出现的类似事物，之前就有很多类似的尝试，
 - longchain：抽象层数太多，想要囊括的太多
 - pydantic：使用 python 抽象器进行抽象
 
-!!! note "把时间花在解决问题上面，而不是 build server"
+:::tip 把时间花在解决问题上面，而不是 build server
+:::
+
 mcp 作为 distribute 一个好的方式
 
 当我们使用一个工具的时候，我们不仅仅是在使用这个工具，更是接受这个工具对于未来的设想与设计

docs/Backend/db/sql.md

@@ -5,11 +5,15 @@
 
 [PHP 学习路线](https://www.runoob.com/w3cnote/php-learning-recommend.html)
 
-!!! tip "学习路线" 1. 熟悉 HTML/CSS/JS 等网页基本元素，完成阶段可自行制作简单的网页，对元素属性相对熟悉。2. 理解动态语言的概念和运做机制，熟悉基本的 PHP 语法。3. 学习如何将 PHP 与 HTML 结合起来，完成简单的动态页面。4. 接触学习 MySQL，开始设计数据库。5. 不断巩固 PHP 语法，熟悉大部分的 PHP 常用函数，理解面向对象编程，MySQL 优化，以及一些模板和框架。6. 最终完成一个功能齐全的动态站点。
+:::tip 学习路线
+
+:::
 
 ## 基础语法
 
-!!! note "优化之前写过的评论网页"
+:::tip 优化之前写过的评论网页
+
+:::
 
 - PHP 是一种开源的通用脚本语言，尤其适用于 Web 开发。
 - PHP（全称：PHP：Hypertext Preprocessor，即"PHP：超文本预处理器"）是一种通用开源脚本语言。
@@ -233,7 +237,9 @@ $conn->close();
 
 将序列化的值当作参数传入
 
-!!! note "最终的原因"
+:::tip 最终的原因
+:::
+
 PHP 是弱类型的原因，我们可以利用这样的特性去绕过一些判断
 
 #### [BUUCTF[极客大挑战 2019]PHP](https://buuoj.cn/challenges#[%E6%9E%81%E5%AE%A2%E5%A4%A7%E6%8C%91%E6%88%98%202019]PHP)
@@ -303,7 +309,9 @@ O:4:"Name":2:{s:14:"Nameusername";s:5:"admin";s:14:"Namepassword";i:100;}
 
 又因为私有变量需要修改，所以更改为
 
-!!! note "在反序列化时，当前属性个数大于实际属性个数时，就会跳过`__wakeup()`，去执行`__destruct`"
+:::tip 在反序列化时，当前属性个数大于实际属性个数时，就会跳过`__wakeup()`，去执行`__destruct`
+
+:::
 
 又因为需要绕过`__wakeup()`函数，所以我们把属性个数改成大于实际属性的个数
 
@@ -317,7 +325,9 @@ http://02801fc4-349c-428a-bb2c-2015f2934d2b.node5.buuoj.cn:81/?select=O:4:%22Nam
 
 上课老师讲的一个例题，主要核心思想就是利用 php 这种弱类型的语言。构造的 exp 是利用引用，使得两个变量一模一样，从而达到目的。
 
-!!! note "类型"
+:::tip 类型
+:::
+
 a - array
 b - boolean
 d - double

docs/Backend/php.md

@@ -1,6 +1,8 @@
 # IOS 开发
 
-!!! note "记录一下学习 IOS 开发的尝试"
+:::tip 记录一下学习 IOS 开发的尝试
+
+:::
 
 ## 安装
 

docs/Backend/platform/xcode.md

@@ -14,11 +14,13 @@ pip index versions <package>
 pip install <package>==<version>
 ```
 
-!!! note "windows 使用命令行调用不同版本的 python"
+:::tip windows 使用命令行调用不同版本的 python
 
-    在系统路径path（高级系统系统设置——环境变量）中加入python.exe所在目录（打开文件所在位置——属性——打开文件所在位置）（因为是快捷方式，所以需要先找到快捷方式所在目录，再找到原exe文件所在位置）
+在系统路径 path（高级系统系统设置——环境变量）中加入 python.exe 所在目录（打开文件所在位置——属性——打开文件所在位置）（因为是快捷方式，所以需要先找到快捷方式所在目录，再找到原 exe 文件所在位置）
 
-    **注：应考虑到优先级的问题，将想要通过命令行直接进入的 python 版本所对应的路径放在上面**
+**注：应考虑到优先级的问题，将想要通过命令行直接进入的 python 版本所对应的路径放在上面**
+
+:::
 
 ### pip 换源
 
@@ -30,13 +32,16 @@ pip install package_name -i https://pypi.tuna.tsinghua.edu.cn/simple
 pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
 ```
 
-!!! bug "WARNING: The repository located at mirrors.aliyun.com is not a trusted or secure host and is being ignored. If this repository is available via HTTPS we recommend you use HTTPS instead, otherwise you may silence this warning and allow it anyway with '--trusted-host mirrors.aliyun.com'."
-在大多数情况下，这个警告表示 pip 无法验证镜像源的 SSL 证书。可能的原因包括：
+:::warning
+WARNING: The repository located at mirrors.aliyun.com is not a trusted or secure host and is being ignored. If this repository is available via HTTPS we recommend you use HTTPS instead, otherwise you may silence this warning and allow it anyway with '--trusted-host mirrors.aliyun.com'.
+
+这个警告表示 pip 无法验证镜像源的 SSL 证书。可能的原因包括：
 
-    SSL证书问题： 镜像源的SSL证书过期、自签名或存在其他问题。
-    网络问题： 在某些网络环境中（特别是公司网络或学校网络），中间人攻击(MITM)防御机制可能会导致证书验证失败。
+- SSL 证书问题：镜像源的 SSL 证书过期、自签名或存在其他问题。
+- 网络问题：在某些网络环境中（特别是公司网络或学校网络），中间人攻击 (MITM) 防御机制可能会导致证书验证失败。
 
-    [已解决WARNING: The repository located at mirrors.aliyun.com is not a trusted or secure host异常的正确解决方法，亲测\_the repository located at mirrors, aliyun, com is -CSDN博客](https://blog.csdn.net/FMC_WBL/article/details/136143632)
+[已解决 WARNING: The repository located at mirrors.aliyun.com is not a trusted or secure host 异常的正确解决方法，亲测\_the repository located at mirrors, aliyun, com is -CSDN 博客](https://blog.csdn.net/FMC_WBL/article/details/136143632)
+:::
 
 ### pip 导出环境
 
@@ -133,7 +138,9 @@ uv venv --python 3.11
 export UV_DEFAULT_INDEX="https://mirrors.aliyun.com/pypi/simple"
 ```
 
-!!! note "网络环境"
+:::tip 网络环境
+:::
+
 `shell
     unset http_proxy && unset https_proxy
     `
@@ -285,7 +292,9 @@ bash Miniconda3-py39_24.7.1-0-Linux-aarch64.sh
 
 [conda 使用指南](https://blog.csdn.net/miracleoa/article/details/106115730)
 
-!!! note " conda 和 pip 的区别"
+:::tip  conda 和 pip 的区别
+:::
+
 [Anaconda | Understanding Conda and Pip](https://www.anaconda.com/blog/understanding-conda-and-pip)
 
     ||conda|pip|
@@ -413,10 +422,12 @@ pdb.set_trace()
 
 ### CUDA
 
-!!! note "什么是 CUDA"
+:::tip 什么是 CUDA
+
 通俗地说，CUDA 是一种协助“CPU 任务分发+GPU 并行处理”的编程模型/平台，用于加速 GPU 和 CPU 之间的计算。
 
-    也就是说CUDA通过CPU任务分发和GPU并行处理的方式，把计算任务通过CPU分发给GPU进行并行计算加速。而GPU并行计算的能力需要CUDA借助其自带的编程接口和工具，比如C/C++语言来编写并行计算程序，并通过CUDA编译器将程序转化为可以在英NVIDIA GPU上执行的机器码快速运行。
+也就是说 CUDA 通过 CPU 任务分发和 GPU 并行处理的方式，把计算任务通过 CPU 分发给 GPU 进行并行计算加速。而 GPU 并行计算的能力需要 CUDA 借助其自带的编程接口和工具，比如 C/C++ 语言来编写并行计算程序，并通过 CUDA 编译器将程序转化为可以在英 NVIDIA GPU 上执行的机器码快速运行。
+:::
 
 #### CUDA 版本的兼容性
 
@@ -476,19 +487,23 @@ nvcc --version
 pip install torch==1.10.1+cu102 torchvision==0.11.2+cu102 torchaudio==0.10.1 -f https://download.pytorch.org/whl/cu102/torch_stable.html
 ```
 
-!!! failure "numpy 报错"
+:::warning numpy 报错
+
 安装好 torch 之后，numpy 会报错
 
-    ```
-    UserWarning: Failed to initialize NumPy: _ARRAY_API not found (Triggered internally at  ..\torch\csrc\utils\tensor_numpy.cpp:68.)
-    _dtype_to_storage = {data_type(0).dtype: data_type for data_type in _storages}
-    ```
+```text
+UserWarning: Failed to initialize NumPy: _ARRAY_API not found (Triggered internally at  ..\torch\csrc\utils\tensor_numpy.cpp:68.)
+_dtype_to_storage = {data_type(0).dtype: data_type for data_type in _storages}
+```
+
+**解决方法：** 将 numpy 版本降低为非>2.0.0 的版本，之后就能成功导入了。
 
-    **解决方法：** 将 numpy 版本降低为非>2.0.0 的版本，之后就能成功导入了。
-    ```shell
-    pip uninstall numpy
-    pip install numpy==1.26
-    ```
+```shell
+pip uninstall numpy
+pip install numpy==1.26
+```
+
+:::
 
 ```python title="测试是否可用"
 import torch # 如果 pytorch 安装成功即可导入
@@ -553,15 +568,17 @@ ln -s /usr/lib/aarch64-linux-gnu/libstdc++.so.6.0.30 libstdc++.so.6
 
 ### ImportError: No module named parse
 
-!!! bug "ImportError: No module named parse"
+:::warning ImportError: No module named parse
 python 版本问题，在 python 2.x 中
 
-    ```python
-    from urlparse import urlparse
-    ```
+```python
+from urlparse import urlparse
+```
+
+在 python 3.x
 
-    在python 3.x
+```python
+from urllib.parse import urlparse
+```
 
-    ```python
-    from urllib.parse import urlparse
-    ```
+:::

docs/Backend/python.md

@@ -1,6 +1,8 @@
 # 常识
 
-!!! tip "这篇文章列举一些在产品开发中遇到的知识点和有用的技能"
+:::tip 这篇文章列举一些在产品开发中遇到的知识点和有用的技能
+
+:::
 
 ## 开发过程
 

docs/Backend/rules.md

@@ -2,22 +2,22 @@
 
 [Docker Compose - 安装和基本使用\_docker-compose 安装-CSDN 博客](https://blog.csdn.net/Que_art/article/details/135192479)
 
-=== "Docker Compose（容器编排工具）"
+:::info
 
-    定义：Docker Compose 是一个用于定义和运行多容器 Docker 应用的工具。
+Docker Compose（容器编排工具）：Docker Compose 是一个用于定义和运行多容器 Docker 应用的工具。
 
-    功能：
-    - **多容器管理**：允许用户在一个YAML文件中定义和管理多个容器
-    - **服务编排**：配置容器间的网络和依赖关系
-    - **一键部署**：使用docker-compose up命令启动、停止和
+功能：
+- **多容器管理**：允许用户在一个YAML文件中定义和管理多个容器
+- **服务编排**：配置容器间的网络和依赖关系
+- **一键部署**：使用docker-compose up命令启动、停止和
 
-=== "Docker（容器平台）"
+Docker（容器平台）：一个开放源代码的容器化平台，允许开发者将应用及其依赖打包进轻量级、可移植的容器中。
 
-    定义：一个开放源代码的容器化平台，允许开发者将应用及其依赖打包进轻量级、可移植的容器中。
-
-    - **容器化**：将应用和其运行环境封装在一个容器中
-    - **镜像管理**：创建、存储和分发容器镜像
-    - **容器运行**：可以运行在任何支持 Docker 的环境中
+功能：
+- **容器化**：将应用和其运行环境封装在一个容器中
+- **镜像管理**：创建、存储和分发容器镜像
+- **容器运行**：可以运行在任何支持 Docker 的环境中
+:::
 
 ## 安装
 
@@ -151,40 +151,42 @@ sudo journalctl -u docker
 
 ### 文档
 
-!!! note "文档结构"
-
-    === "说明"
-
-      - version：指定 Compose 文件格式 yaml 的规则版本，版本决定可用的配置选项
-      - service：定义了应用中的服务，每个服务可以使用不同的镜像、环境设置和依赖关系
-        - web：自己构建的镜像
-          - build：用于构建镜像，指定构建镜像的 dockerfile 的上下文路径
-          - ports：映射容器和宿主机的端口
-          - volumes：挂载本地目录到指定容器目录，用于数据持久化或在容器之间共享数据
-          - links：与 redis 服务连接
-      - redis：构建指定镜像 redis
-      - image：从指定的镜像中启动容器，可以是存储仓库、标签以及镜像 ID
-      - volumes：用于数据持久化和共享的数据卷定义，常用于数据库存储、配置文件、日志等数据的持久化
-
-    === "实例"
-
-        ```yml
-        version: "3.9"
-        services:
-            web:
-            build: .
-            ports:
-                - "8000:5000"
-            volumes:
-                - .:/code
-                - logvolume01:/var/log
-            links:
-                - redis
-            redis:
-            image: redis
-        volumes:
-        logvolume01: {}
-        ```
+:::tip 文档结构
+
+**说明：**
+
+- version：指定 Compose 文件格式 yaml 的规则版本，版本决定可用的配置选项
+- service：定义了应用中的服务，每个服务可以使用不同的镜像、环境设置和依赖关系
+  - web：自己构建的镜像
+    - build：用于构建镜像，指定构建镜像的 dockerfile 的上下文路径
+    - ports：映射容器和宿主机的端口
+    - volumes：挂载本地目录到指定容器目录，用于数据持久化或在容器之间共享数据
+    - links：与 redis 服务连接
+- redis：构建指定镜像 redis
+- image：从指定的镜像中启动容器，可以是存储仓库、标签以及镜像 ID
+- volumes：用于数据持久化和共享的数据卷定义，常用于数据库存储、配置文件、日志等数据的持久化
+
+**实例：**
+
+```yml
+version: "3.9"
+services:
+    web:
+    build: .
+    ports:
+        - "8000:5000"
+    volumes:
+        - .:/code
+        - logvolume01:/var/log
+    links:
+        - redis
+    redis:
+    image: redis
+volumes:
+    logvolume01: {}
+```
+
+:::
 
 ```shell
 docker-compose up