# មគ្គុទេសក៍ដោះស្រាយបញ្ហា AI-សម្រាប់អ្នកដំណើរកាត់ចាប់ផ្តើម

មគ្គុទេសក៍នេះជួយអ្នកដោះស្រាយបញ្ហាទូទៅដែលជួបប្រទៈពេលប្រើប្រាស់ ឬចូលរួមចំណែកក្នុងឃ្លាំង [AI-For-Beginners](https://github.com/microsoft/AI-For-Beginners)។ បញ្ហា និងអ្វីដែលទៅជាមួយនឹងវារួមមាន ប្រែវត្ថុ, រលក្ខណៈ, សេចក្ដីពន្យល់ និងដំណោះស្រាយជាជំហ៊ាន។

---

## តារាងមាតិកា

- [បញ្ហាទូទៅ](#បញ្ហាទូទៅ)
- [បញ្ហាក្នុងការដំឡើង](#បញ្ហាក្នុងការដំឡើង)
- [បញ្ហាកំណត់រចនា](#បញ្ហាកំណត់រចនា)
- [ការប្រតិបត្តិលើកំណត់ត្រា](#ការប្រតិបត្ដិលើកំណត់ត្រា)
- [បញ្ហាផ្នែកប្រសិទ្ធភាព](#បញ្ហាផ្នែកប្រសិទ្ធភាព)
- [បញ្ហាគេហទំព័រពុម្ពភាគ](#បញ្ហាគេហទំព័រពុម្ពភាគ)
- [បញ្ហា​ចូលរួមធ្វើការ](#បញ្ហាចូលរួមធ្វើការ)
- [សំណួរញឹកញាប់](#សំណួរញឹកញាប់)
- [ការទទួលជំនួយ](#ការទទួលជំនួយ)

---

## បញ្ហាទូទៅ

### 1. ឃ្លាំងមិនអាចកើនឡើងបានត្រឹមត្រូវ

**ជំពូក៖** ការក្លូនអនុញ្ញាតឲ្យអ្នកចម្លងឃ្លាំងទៅកាន់ម៉ាស៊ីនរបស់អ្នក។

**រោគសញ្ញា៖**
- ព័តមានកំហុស៖ `fatal: repository not found`
- ព័តមានកំហុស៖ `Permission denied (publickey)`

**មូលហេតុដែលអាចមាន៖**
- អាសយដ្ឋាន URL របស់ឃ្លាំងមិនត្រឹមត្រូវ
- សិទ្ធិការអនុញ្ញាតមិនគ្រប់គ្រាន់
- កូនសោ SSH មិនបានកំណត់រចនា

**ដំណោះស្រាយ៖**
1. **ពិនិត្យអាសយដ្ឋាន URL របស់ឃ្លាំង។**  
   ប្រើអាសយដ្ឋាន HTTPS៖  
   ```
   git clone https://github.com/microsoft/AI-For-Beginners.git
   ```
2. **ប្តូរទៅ HTTPS ប្រសិនបើ SSH បរាជ័យ។**  
   ប្រសិនបើអ្នកឃើញ `Permission denied (publickey)` សូមប្រើតំណ HTTPS ខាងលើជំនួស SSH ។
3. **កំណត់រចនាកូនសោ SSH (មិនបាច់ធ្វើក៏បាន)។**  
   ប្រសិនបើអ្នកចង់ប្រើ SSH សូមអនុវត្តតាម [មគ្គុទេសក៏នៃ SSH របស់ GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh)។

---

## បញ្ហាក្នុងការដំឡើង

### 2. បញ្ហាបរិបទ Python

**ជំពូក៖** ឃ្លាំងអាស្រ័យលើ Python និងបណ្ណាល័យគ្រប់យ៉ាង។

**រោគសញ្ញា៖**
- កំហុស៖ `ModuleNotFoundError: No module named '<package>'`
- កំហុសនាំចូលពេលរត់ script ឬ notebook

**មូលហេតុដែលអាចមាន៖**
- មិនបានដំឡើងទំនាក់ទំនង
- ជំរើស Python មិនត្រឹមត្រូវ

**ដំណោះស្រាយ៖**
1. **បង្កើតបរិបទវីរុស។**  
   ```bash
   python -m venv venv
   source venv/bin/activate   # នៅលើ Windows: venv\Scripts\activate
   ```
2. **ដំឡើងទំនាក់ទំនង។**  
   ```bash
   pip install -r requirements.txt
   ```
3. **ពិនិត្យជំរើស Python។**  
   ប្រើ Python 3.7 ឬថ្មីជាង។  
   ```bash
   python --version
   ```

### 3. Jupyter មិនបានដំឡើង

**ជំពូក៖** កំណត់ត្រាគឺជាធនធានសិក្សាអគ្គិសនីសំខាន់មួយ។

**រោគសញ្ញា៖**
- កំហុស៖ `jupyter: command not found`
- កំណត់ត្រាបរាជ័យក្នុងការចាប់ផ្តើម

**មូលហេតុដែលអាចមាន៖**
- មិនបានដំឡើង Jupyter

**ដំណោះស្រាយ៖**
1. **ដំឡើង Jupyter Notebook។**  
   ```bash
   pip install notebook
   ```
   ឬ ប្រសិនបើប្រើ Anaconda៖
   ```bash
   conda install notebook
   ```
2. **ចាប់ផ្តើម Jupyter Notebook។**  
   ```bash
   jupyter notebook
   ```

### 4. ទំនាក់ទំនងជំនាន់បញ្ហា

**ជំពូក៖** គម្រោងអាចខូចប៉ះពាល់ ប្រសិនបើជំនាន់កញ្ចប់មិនស្របគ្នា។

**រោគសញ្ញា៖**
- កំហុស ឬ ការព្រមានអំពីជំនាន់ដែលមិនបា្រក់គ្នា

**មូលហេតុដែលអាចមាន៖**
- កញ្ចប់ Python ចាស់ ឬ ប៉ះពាល់គ្នា

**ដំណោះស្រាយ៖**
1. **ដំឡើងនៅក្នុងបរិបទស្អាត។**  
   លុបបរិបទ venv/conda ចាស់ ហើយបង្កើតថ្មី។
2. **ប្រើជំនាន់ត្រឹមត្រូវ។**  
   ជានិច្ចបញ្ចូល:
   ```bash
   pip install -r requirements.txt
   ```
   ប្រសិនបើបរាជ័យនេះ សូមដំឡើងកញ្ចប់ខ្វះដូចបានពណ៌នា​នៅ README ។

---

## បញ្ហាកំណត់រចនា

### 5. ព្រំដែនបរិបទមិនបានកំណត់

**ជំពូក៖** ម៉ូឌុលមួយចំនួនប្រហែលត្រូវការកូនសោ ស្លាក ឬការកំណត់រចនា។

**រោគសញ្ញា៖**
- កំហុស៖ `KeyError` ឬ ការព្រមានអំពីការខ្វះ config

**មូលហេតុដែលអាចមាន៖**
- មិនបានកំណត់ព្រំដែនបរិបទដែលត្រូវការ

**ដំណោះស្រាយ៖**
1. **ពិនិត្យឯកសារ `.env.example` ឬឯកសារលាយៗ។**
2. **បង្កើតឯកសារ `.env` ហើយបំពេញតម្លៃដែលត្រូវការ។**
3. **ផ្ទុកឡើង Terminal ឬ IDE របស់អ្នកបន្ទាប់ពីកំណត់ environment variables។**

---

## ការប្រតិបត្ដិលើកំណត់ត្រា

### 6. កំណត់ត្រាមិនផ្ទុកឬមិនដំណើរការ

**ជំពូក៖** កំណត់ត្រា Jupyter ត្រូវការការកំណត់រចនាឲ្យត្រឹមត្រូវ។

**រោគសញ្ញា៖**
- កំណត់ត្រាបរាជ័យក្នុងការចាប់ផ្តើម
- អន្ដរជាតិសម្រង់មិនបើកឡើងស្វ័យប្រវត្តិ

**មូលហេតុដែលអាចមាន៖**
- មិនបានដំឡើង Jupyter
- បញ្ហាការកំណត់រចនាក្នុងកម្មវិធីរុករក

**ដំណោះស្រាយ៖**
1. **ដំឡើង Jupyter (មើលបញ្ហាក្នុងការដំឡើងខាងលើ)។**
2. **បើកកំណត់ត្រាដោយដៃ​។**
   - ចម្លង URL ពី Terminal (ឧ. `http://localhost:8888/?token=...`) ហើយបិទវាទៅកម្មវិធីរុករក។

### 7. Kernel បែកបាក់ ឬ ហើយត្រូវបិទរយះពេលយូរ

**ជំពូក៖** Kernel កំណត់ត្រាអាចបែកដោយសារកំណត់ធនធានឬកូដមានកំហុស។

**រោគសញ្ញា៖**
- Kernel ស្លាប់ ឬ ចាប់ផ្តើមឡើងវិញជាបន្តបន្ទាប់
- កំហុសចុះពីអង្គចងចាំ (out-of-memory)

**មូលហេតុដែលអាចមាន៖**
- ទិន្នន័យធំ
- កូដ ឬ កញ្ចប់មិនស្របគ្នា

**ដំណោះស្រាយ៖**
1. **ចាប់ផ្តើម Kernel ថ្មី។**  
   ប្រើប៊ូតុង "Restart Kernel" នៅក្នុង Jupyter។
2. **ពិនិត្យការប្រើប្រាស់អង្គចងចាំ។**  
   បិទកម្មវិធីដែលមិនបានប្រើ។
3. **រត់កំណត់ត្រានៅលើវេទិកាបណ្តាញ។**  
   ប្រើ [Google Colab](https://colab.research.google.com/) ឬ [Azure Notebooks](https://notebooks.azure.com/)។

---

## បញ្ហាផ្នែកប្រសិទ្ធភាព

### 8. កំណត់ត្រារត់យឺត

**ជំពូក៖** ភារកិច្ច AI មួយចំនួនតម្រូវឲ្យមានអង្គចងចាំ និង CPU ច្រើន។

**រោគសញ្ញា៖**
- រត់យឺត
- សំឡេងកង្ហារលេបក្តៅម៉ាស៊ីនកុំភ្លេច

**មូលហេតុដែលអាចមាន៖**
- ទិន្នន័យ ឬ ម៉ូឌែលធំ
- អង្គចងចាំក្នុងប្រព័ន្ធមានកំណត់

**ដំណោះស្រាយ៖**
1. **ប្រើវេទិកាបណ្តាញ។**
   - បញ្ចូលកំណត់ត្រាទៅ Colab ឬ Azure Notebooks។
2. **កាត់បន្ថយទំហំទិន្នន័យ។**
   - ប្រើទិន្នន័យគំរូសម្រាប់ហាត់ប្រាណ។
3. **បិទកម្មវិធីមិនចាំបាច់។**
   - ទទួលបាន RAM ល្អបំផុតសម្រាប់ប្រព័ន្ធ។

---

## បញ្ហាគេហទំព័រពុម្ពភាគ

### 9. មាតិកាផ្សាប់មិនបានផ្ទុក

**ជំពូក៖** សៀវភៅអេឡិចត្រូនិចបង្ហាញមេរៀន និងជំពូក។

**រោគសញ្ញា៖**
- មាតិកាយ៉ាងណាមួយ (ឧ. Transformers/BERT) ខ្វះ ឬ មិនបើកឡើង

**បញ្ហាល្បី៖**  
- [បញ្ហា #303](https://github.com/microsoft/AI-For-Beginners/issues/303): “18 Transformers. BERT. មិនអាចបើកបាននៅលើគេហទំព័រពុម្ពភាគ។” មានហេតុពីកំហុសឈ្មោះឯកសារ (`READMEtransformers.md` ជំនួសឲ្យ `README.md`)។

**ដំណោះស្រាយ៖**
1. **ពិនិត្យកំហុសប្តូរឈ្មោះឯកសារ។**  
   ប្រសិនបើអ្នកជាអ្នកចូលរួម សូមធានាថាឯកសារជំពូកមានឈ្មោះជា `README.md`។
2. **រាយការណ៍ឯកសារខ្វះ។**  
   បើកបញ្ហារបស់ GitHub ជាមួយឈ្មោះជំពូក និងព័ត៌មានកំហុស។

---

## បញ្ហាចូលរួមធ្វើការ

### 10. PR មិនទទួល ឬ ការសាងសង់បរាជ័យ

**ជំពូក៖** ការចូលរួមត្រូវតែឆ្លងកាត់ការធ្វើតេស្ដ និងអនុវត្តផែនការទាញយក។

**រោគសញ្ញា៖**
- ការស្នើប្រាក់ចូលRejected
- កំហុសក្នុង CI/CD pipeline

**មូលហេតុដែលអាចមាន៖**
- ទេស្ដបរាជ័យ
- មិនអនុវត្តតាមស្តង់ដារកូដ

**ដំណោះស្រាយ៖**
1. **អានក្រុមប្រឹក្សាចូលរួម។**
   - អនុវត្តតាម [CONTRIBUTING.md](https://github.com/microsoft/AI-For-Beginners/blob/main/CONTRIBUTING.md) របស់ឃ្លាំង។
2. **ធ្វើតេស្ដក្នុងម៉ាស៊ីនមូលដ្ឋានមុនចុចបញ្ជូន។**
3. **ពិនិត្យច្បាប់ linting ឬតម្រូវការរចនា។**

---

## សំណួរញឹកញាប់

### តើខ្ញុំអាចស្វែងរកជំនួយសម្រាប់ម៉ូឌុលជាក់លាក់នៅណា?
- ម៉ូឌុលនីមួយៗភាគច្រើនមាន README របស់វា។ ចាប់ផ្តើមនៅទីនោះសម្រាប់ការដំឡើង និងកំណត់ប្រើប្រាស់។

### តើធ្វើដូចម្តេចដើម្បីរាយការណ៍កំហុស ឬស្នើសុំមុខងារថ្មី?
- [បើកបញ្ហា GitHub](https://github.com/microsoft/AI-For-Beginners/issues/new) ជាមួយការពិពណ៌នាស្រួលយល់ និងជំហ៊ានសម្រាប់បង្កើតតាម។

### តើខ្ញុំអាចស្នើសុំជំនួយប្រសិនបើបញ្ហារបស់ខ្ញុំមិនមានក្នុងបញ្ជីទេ?
- បាន! ស្វែងរកបញ្ហាដែលមានជាមុនសិន ហើយប្រសិនបើមិនមានបញ្ហារបស់អ្នក សូមបង្កើតបញ្ហាថ្មី។

---

## ការទទួលជំនួយ

- **ពិនិត្យបញ្ហា៖** [GitHub Issues](https://github.com/microsoft/AI-For-Beginners/issues)
- **សួរសំណួរ៖** ប្រើការពិភាក្សា GitHub ឬបើកបញ្ហា។
- **សហគមន៍៖** មើលតំណភ្ជាប់ឃ្លាំងសម្រាប់ជម្រើសជជែក/វេទិកា។

---

_បានបន្តបន្ទាប់ចុងក្រោយ៖ 2025-09-20_

---

<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**ការផ្សងព្រេង**:  
ឯកសារនេះបានបកប្រែដោយប្រើសេវាកម្មបកប្រែ AI [Co-op Translator](https://github.com/Azure/co-op-translator)។ ខណៈពេលយើងខិតខំប្រឹងប្រែងដើម្បីភាពត្រឹមត្រូវ សូមពាក់ព័ន្ធថាបកប្រែដោយកម្មវិធីអាចមានខុសត្រូវ ឬកំហុសបាន។ ឯកសារដើមដែលនៅក្នុងភាសាគោលត្រូវបានទទួលស្គាល់ថាជាដើមឯកសារដែលមានសុពលភាព។ សម្រាប់ព័ត៌មានសំខាន់ ការបកប្រែដោយមនុស្សជំនាញគឺគួរឱ្យយកចិត្តទុកដាក់។ យើងមិនទទួលខុសត្រូវចំពោះការយល់មិនអាចកើតមាន ឬក៏ការបកប្រត្យាសខុសផ្សេងៗពីការប្រើប្រាស់បកប្រែនេះឡើយ។
<!-- CO-OP TRANSLATOR DISCLAIMER END -->