បកប្រែ កែសម្រួល និងពិនិត្យគម្រោងតូច¶

ចាប់ផ្តើមជាមួយឯកសារ Markdown ខ្លីពីរ និងភាសាគោលបំណងមួយ។ អ្នកនឹងឃើញកន្លែងដែលបានសរសេរបកប្រែ តើមានអ្វីខ្លះកើតឡើងពេលដែលប្រភពផ្លាស់ប្តូរ ហើយធ្វើម៉េចដើម្បីពិនិត្យលទ្ធផល។

លទ្ធផលដែលបានកត់ត្រា¶

ឧទាហរណ៍នេះបានរត់នៅថ្ងៃទី 19 កញ្ញា 2026 ជាមួយ Co-op Translator 0.21.0 និង Azure OpenAI (gpt-5-mini)។ ពាក្យបញ្ជា CLI ដែលមិនបានកែប្រែ ត្រូវបានហៅតាមរយៈ Click's CliRunner ដោយប្រើ wheel ដែលបាន build និងទន្រ្ទាន Python ដែលមានរួច។

ជំហាន	លទ្ធផល
ពិនិត្យមើលជាមុន	បញ្ចប់ដោយកូដ 0; មិនបានស្នើការបកប្រែម៉ូឌែលទេ
ការបកប្រែដំបូង	បញ្ចប់ដោយកូដ 0; 27.36 វិនាទី
ការពិនិត្យដំបូង	បញ្ចប់ដោយកូដ 0
កែសម្រួល README និងពិនិត្យ	បញ្ចប់ដោយកូដ 1; បានរកឃើញការបកប្រែចាស់
ធ្វើបច្ចុប្បន្នភាពការបកប្រែ	បញ្ចប់ដោយកូដ 0; 22.17 វិនាទី
ពិនិត្យបន្ទាប់ពីធ្វើបច្ចុប្បន្នភាព	បញ្ចប់ដោយកូដ 0; គ្មានកំហុស ឬ ការព្រមាន
មគ្គុទ្ទេសក៍មិនបានផ្លាស់ប្តូរ	បៃដូចគ្នាមុន និងក្រោយពេលធ្វើបច្ចុប្បន្នភាព README
រត់ម្ដងទៀត	បញ្ចប់ដោយកូដ 0; hash ដូចគ្នាសម្រាប់ឯកសារបកប្រែទាំងអស់

នេះគឺជាការវាស់កម្រិតក្នុងការរត់នីមួយៗ មិនមែនជាការធានាសមត្ថភាពទេ។ ពេលរៀបចំមិនត្រូវបានរួមបញ្ចូល; ការគិតចំណាយដោយអ្នកផ្គត់ផ្គង់មិនបានវាស់ទេ។ ការរត់ដែលមិនបានផ្លាស់ប្តូរទៅតែមួយទៀតអាចនៅតែបង្កើតតេស្តសុខភាពអ្នកផ្គត់ផ្គង់បាន។

ពិនិត្យមើល ការបកប្រែដំបូង, ការបកប្រែដែលបានធ្វើបច្ចុប្បន្នភាព, ផ្ទៃខុសគ្នារបស់ការបកប្រែទាំងមូល, ការពិនិត្យចាស់, ការពិនិត្យចុងក្រោយ, និង ព័ត៌មានលម្អិតរត់។ ការបកប្រែឯកសារទាំងមូលអាចផ្លាស់ប្ដូរពាក្យផ្សេងទៀត ដូចដែល diff ដែលបានចាប់យកបង្ហាញ។ ឯកសារអត្ថបទទាំងពីររក្សាការបដិសេធដែលបានបង្កើត។

ការពិនិត្យដោយមនុស្សនៅតែមានសារៈសំខាន់៖ ការធ្វើបច្ចុប្បន្នភាពដែលបានចាប់យកប្រើ [사용 가이드](guide.md)을; គន្លឹះភាសាកូរ៉េខាងត្រូវគួរតែជា [사용 가이드](guide.md)를។ អត្ថាឯកសារនេះបានរក្សាលទ្ធផលដើមសោះ មិនបានបង្ហាញជាការបកប្រែដែលបានកែសម្រួលដោយម៉ូឌែល។ ការពិនិត្យរចនាសម្ព័ន្ធក៏ឆ្លងកាត់ទោះបីមានបញ្ហាផ្នែកពាក្យក៏ដោយ។

1. រៀបចំថតតូច¶

ប្រើ Python 3.11–3.14 និង ការតំឡើងបរិយាកាស virtual environment។ តម្លើងកំណែដែលបានប្រើសម្រាប់ឧទាហរណ៍នេះ៖

python -m pip install co-op-translator==0.21.0
mkdir translation-demo
cd translation-demo
git init

ទាញយក README.txt និង guide.txt ទៅក្នុងថតនេះ ហើយរក្សាទុកជា README.md និង guide.md។ វាជាឯកសារគម្រោងនិទានខ្លីៗ; មិនចាំបាច់តម្លើងកម្មវិធីណាមួយឡើយ។

README រួមមានកូដប្លុកមួយ និងតំណទៅ guide.md។ ប្រយោគចុងក្រោយរបស់វា គឺ៖

Notes are saved locally.

រក្សាទុកតែឯកសារប្រភពទាំងពីរនេះនៅក្នុងថតនេះ។ ពាក្យបញ្ជាទាំងអស់នៅក្រោយនេះរត់ក្នុង translation-demo និងអាចដំណើរការបាននៅក្នុង Bash និង PowerShell។

2. មើលជាមុនដោយមិនមានអាជ្ញាបណ្ណ¶

translate -l "ko" -md --dry-run

ការមើលជាមុនប៉ាន់ស្មានការងារបកប្រែដោយមិនហៅម៉ូឌែល ឬសរសេរបកប្រែ។ ការប៉ាន់ស្មាន token មិនមែនជាការបញ្ជាក់ទៅលើការគិតប្រាក់។ ការរត់ដំបូងគួរតែសម្គាល់ឯកសារ Markdown ទាំងពីរថាជាការងារថ្មី។

3. ជ្រើសរើសអ្នកផ្គត់ផ្គង់ និងបកប្រែ¶

កំណត់រចនាសម្ព័ន្ធអ្នកផ្គត់ផ្គង់មួយដោយប្រើ មគ្គុទ្ទនៃការកំណត់: Azure OpenAI, OpenAI, ឬ Anthropic។ ការបកប្រែអត្ថបទជាមួយ OpenAI និង Anthropic មិនត្រូវការគណនី Azure ទេ។ សេវាកម្មរូបភាពមិនចាំបាច់សម្រាប់ឧទាហរណ៍នេះ។

ប្រសិនបើអ្នកប្រើឯកសារ .env ទីតាំងតាមដានក្នុងម៉ាស៊ីន បន្ថែម .env ទៅក្នុង .gitignore របស់ថតនេះ។ ការហៅសេវាបកប្រែប្រើគណនីអ្នកផ្គត់ផ្គង់របស់អ្នក និងអាចបណ្តាលឱ្យមានកម្រៃ។

translate -l "ko" -md
co-op-review -l "ko"

បើក translations/ko/README.md និង translations/ko/guide.md។ ពិនិត្យពាក្យភាសាកូរ៉េ កូដប្លុក និងតំណពី README ដែលបានបកប្រែរ ទៅកាន់ guide ដែលបានបកប្រែ។ សំណុំនៃពាក្យលទ្ធផលអាចខុសគ្នាតាមម៉ូឌែល។

co-op-review ពិនិត្យភាពថ្មី រចនាសម្ព័ន្ធ និងតំណក្នុងកន្លែង។ លទ្ធផលដែលឆ្លងកាត់មិនបានធានាថាត្រឹមត្រូវផ្នែកភាសាទេ។ ដោះស្រាយកំហុសណាមួយដែលបានរាយការណ៍មុនបន្ត។

កត់ត្រាប្លាស៊ែនដែលជោគជ័យជាមួយ Git (កំណត់អត្តសញ្ញាណ Git របស់អ្នកជាមុន ប្រសិនបើចាំបាច់)៖

git add README.md guide.md translations
git commit -m "Record initial Korean translation"

4. ប្ដូរប្រភព¶

នៅក្នុង README.md ជំនួស Notes are saved locally. ដោយ៖

Notes are saved locally as Markdown files.

ទុក guide.md ដដែល។ បន្ទាប់មករត់៖

co-op-review -l "ko"
translate -l "ko" -md --dry-run

ការពិនិត្យគួរតែរាយការណ៍ថាការបកប្រែ README ធ្លាក់ចាស់ និងបញ្ចប់ដោយបរាជ័យ។ នេះគឺជាស្ថានភាពមធ្យមដែលរំពឹងទុក។ ការមើលជាមុនគួរតែសម្គាល់ការងារសម្រាប់ README ដែលបានផ្លាស់ប្តូរ។

5. បច្ចុប្បន្នភាព និងពិនិត្យ diff¶

translate -l "ko" -md
git diff -- README.md translations/ko/README.md
git diff -- translations/ko/guide.md
co-op-review -l "ko"

ពិនិត្យ diff ជាក់ស្តែង៖ CLI លំនាំដើមនឹងបកប្រែឡើងវិញឯកសារដែលបានផ្លាស់ប្តូរ ដូច្នេះម៉ូឌែលអាចកែសម្រួលពាក្យផ្សេងទៀតក្នុងឯកសារនោះបានផងដែរ។ មគ្គុទ្ទេសក៍ដែលមិនបានផ្លាស់ប្តូរគួរតែគ្មាន diff។ ការពិនិត្យគួរតែមិនរាយការណ៍ថា README ចាស់ឡើងវិញទេ; ស៊ើបអង្កេតលទ្ធផលផ្សេងទៀតជាជំហរមុនមិនត្រូវមើលរំលង។

ការរក្សាកម្រិតប្លុកនៃការកែសម្រួល Markdown ដោយមនុស្ស ត្រូវការអ្នកផ្គត់ផ្គង់ស្ថានភាពបកប្រែជាជម្រើសនៅក្នុង Python API។ វាមិនត្រូវបានបើកដោយពាក្យបញ្ជា CLI ទាំងនេះ។

6. រត់ម្ដងទៀតដោយគ្មានការផ្លាស់ប្តូរ¶

ធ្វើ commit ប្រភពដែលបានធ្វើបច្ចុប្បន្នភាព និងការបកប្រែ៖

git add README.md translations
git commit -m "Update Korean translation after source edit"
translate -l "ko" -md
git diff --exit-code -- translations

ជាមួយការបកប្រែបច្ចុប្បន្ន និងកំណត់រចនាសម្ព័ន្ធដែលមិនបានផ្លាស់ប្តូរ អ្នកបកប្រែនឹងលោតលើឯកសារ។ ពាក្យបញ្ជា Git ចុងក្រោយគួរតែបង្ហាញគ្មាន diff និងបញ្ចប់ដោយជោគជ័យ។