[add] README, LICENSE, update directory structural

Author: Makiras

.github/workflows/envbase.yaml

@@ -11,7 +11,7 @@ on:
 env:
   REGISTRY: ghcr.io
   IMAGE_NAME: xs-mlvp/envbase
-  IMAGE_TAG: ${{ github.sha }}
+  IMAGE_TAG: ${{ github.sha.substring(0, 7) }}
 
 jobs:
   build-and-push:
@@ -38,7 +38,8 @@ jobs:
         uses: docker/build-push-action@v4
         with:
           context: .
-          file: ./Dockerfile
+          file: ./docker/Dockerfile
+          platforms: linux/amd64,linux/arm64
           push: true
           tags: |
             ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:${{ env.IMAGE_TAG }}

LICENSE

@@ -0,0 +1,53 @@
+Copyright (c) [2025] [XS-MLVP]
+unitychip-tutorial is licensed under Mulan PSL v2.
+You can use this software according to the terms and conditions of the Mulan PSL v2.
+You may obtain a copy of Mulan PSL v2 at:
+         http://license.coscl.org.cn/MulanPSL2
+THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND,
+EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+See the Mulan PSL v2 for more details.
+
+Mulan Permissive Software License，Version 2 (Mulan PSL v2)
+
+January 2020 http://license.coscl.org.cn/MulanPSL2
+
+Your reproduction, use, modification and distribution of the Software shall be subject to Mulan PSL v2 (this License) with the following terms and conditions:
+
+0. Definition
+
+Software means the program and related documents which are licensed under this License and comprise all Contribution(s).
+
+Contribution means the copyrightable work licensed by a particular Contributor under this License.
+
+Contributor means the Individual or Legal Entity who licenses its copyrightable work under this License.
+
+Legal Entity means the entity making a Contribution and all its Affiliates.
+
+Affiliates means entities that control, are controlled by, or are under common control with the acting entity under this License, ‘control’ means direct or indirect ownership of at least fifty percent (50%) of the voting power, capital or other securities of controlled or commonly controlled entity.
+
+1. Grant of Copyright License
+
+Subject to the terms and conditions of this License, each Contributor hereby grants to you a perpetual, worldwide, royalty-free, non-exclusive, irrevocable copyright license to reproduce, use, modify, or distribute its Contribution, with modification or not.
+
+2. Grant of Patent License
+
+Subject to the terms and conditions of this License, each Contributor hereby grants to you a perpetual, worldwide, royalty-free, non-exclusive, irrevocable (except for revocation under this Section) patent license to make, have made, use, offer for sale, sell, import or otherwise transfer its Contribution, where such patent license is only limited to the patent claims owned or controlled by such Contributor now or in future which will be necessarily infringed by its Contribution alone, or by combination of the Contribution with the Software to which the Contribution was contributed. The patent license shall not apply to any modification of the Contribution, and any other combination which includes the Contribution. If you or your Affiliates directly or indirectly institute patent litigation (including a cross claim or counterclaim in a litigation) or other patent enforcement activities against any individual or entity by alleging that the Software or any Contribution in it infringes patents, then any patent license granted to you under this License for the Software shall terminate as of the date such litigation or activity is filed or taken.
+
+3. No Trademark License
+
+No trademark license is granted to use the trade names, trademarks, service marks, or product names of Contributor, except as required to fulfill notice requirements in section 4.
+
+4. Distribution Restriction
+
+You may distribute the Software in any medium with or without modification, whether in source or executable forms, provided that you provide recipients with a copy of this License and retain copyright, patent, trademark and disclaimer statements in the Software.
+
+5. Disclaimer of Warranty and Limitation of Liability
+
+THE SOFTWARE AND CONTRIBUTION IN IT ARE PROVIDED WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED. IN NO EVENT SHALL ANY CONTRIBUTOR OR COPYRIGHT HOLDER BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING, BUT NOT LIMITED TO ANY DIRECT, OR INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING FROM YOUR USE OR INABILITY TO USE THE SOFTWARE OR THE CONTRIBUTION IN IT, NO MATTER HOW IT’S CAUSED OR BASED ON WHICH LEGAL THEORY, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+6. Language
+
+THIS LICENSE IS WRITTEN IN BOTH CHINESE AND ENGLISH, AND THE CHINESE VERSION AND ENGLISH VERSION SHALL HAVE THE SAME LEGAL EFFECT. IN THE CASE OF DIVERGENCE BETWEEN THE CHINESE AND ENGLISH VERSIONS, THE CHINESE VERSION SHALL PREVAIL.
+
+END OF THE TERMS AND CONDITIONS

README.md

@@ -0,0 +1,75 @@
+# UnityChip Tutorial Environment Repository 🐳 
+
+
+This repository contains everything needed to set up the Picker tool's complete development environment. It provides pre-built Docker images and materials for our tutorial series.
+
+
+## 📦 Repository Contents
+
+```sh
+.
+├── docker/                  # Docker configurations
+│   ├── Dockerfile           # Base image definition 
+│   ├── Dockerfile.full      # Full image definition
+│   ├── build-scripts/       # Automated build utilities
+│   └── compose/             # (Optional) Docker-compose files
+├── tutorials/               # Workshop materials
+│   ├── ppt/                 # Presentation slides
+│   └── code-samples/        # Demo scripts
+├── LICENSE
+└── README.md                 # This document
+```
+
+## 🚀 Getting Started
+
+### Pre-built Docker Images 💿
+
+1. ​Basic environment
+    ```sh
+    # This is the base image for the UnityChip tutorial environment, only picker tool is installed without any additional frameworks (e.g. toffee, XSPdb, etc.)
+    docker pull ghcr.io/xs-mlvp/envbase:latest
+    ```
+    Ubuntu 22.04, Python 3.10 + essential development tools
+    > Note: This image is smaller and faster to download, but it does not include any additional frameworks. You can install them manually if needed. If you want try picker for your own, this is the image to start with.
+
+2. ​Full environment
+    ```sh
+    # This is the full image for the UnityChip tutorial environment, which includes the picker tool and all additional frameworks.
+    docker pull ghcr.io/xs-mlvp/envfull:latest
+    ```
+    Ubuntu 22.04, Python 3.10 + essential development tools + additional frameworks (e.g. toffee, XSPdb, etc.)
+    > Note: The full image is larger and may take longer to download, but it includes everything you need to get started with the UnityChip tutorial environment.
+
+### Build Your Own Image 🔨
+
+If you want to build your own image, you can use the provided Dockerfile. This is useful if you want to customize the environment or add additional tools.
+
+#### Requirements
+
+- Docker Engine ≥20.10
+- 8GB+ free disk space
+
+#### Build Commands
+
+```sh
+# Build base image
+./docker/build-scripts/build-base.sh
+
+# Build full toolkit image 
+./docker/build-scripts/build-full.sh
+```
+
+### Image Contents 🛠️
+
+Images include:
+
+- `Picker` in /usr/local/bin
+- `verilator` in /usr/local/bin
+- Examples in /workspace/
+
+## 📚 Tutorial Materials
+
+Find workshop resources in repo's /tutorials directory:
+
+- Slide decks (PDF/PPTX)
+- Code templates