Tumia Gongwen Skill Kuunda na Kuhakiki Hati Rasmi za DOCX za GB/T 9704-2012

Mradi huu unatatua tatizo gani

Gongwen GB/T 9704-2012 Skill ni zana huria kwa ajili ya nyaraka rasmi za Kichina. Si kuweka tu fonti ya Heiti kwenye vichwa na FangSong kwenye maandishi ya kawaida; inatekeleza mahitaji yanayoweza kutekelezwa ya GB/T 9704-2012 kwa kushughulikia vipengele vya mpangilio kama ukurasa wa A4, eneo la maandishi, vichwa, maandishi makuu, viwango vya vichwa, ukurasa wa kwanza, jina la taasisi, nambari ya hati, saini, tarehe na nambari za kurasa, kisha kutoa faili la DOCX linaloweza kuhaririwa zaidi.

Mradi huu unafaa kwa ripoti za kawaida, mipango na mawasilisho, na pia unaunga mkono utoaji rasmi wa hati, uchapishaji kwenye karatasi yenye kichwa chekundu kilichochapishwa awali, kichwa chekundu kamili cha kielektroniki, barua, amri na kumbukumbu za mikutano. Baada ya kutengenezwa, hati inaweza kuendelea kuhaririwa katika Word au WPS ili kuongeza majedwali, viambatisho na picha za mihuri, au kupanga upigaji wa muhuri halisi.

GB/T 9704-2012 inatumika kwa hati rasmi zinazotolewa na vyombo vya chama na serikali; vyombo na vitengo vingine vinaweza kuitumia kama rejea. README inaeleza kuwa kiwango hicho kiliendelea kuwa halali baada ya mapitio ya tarehe 30 Mei 2025.

Vipengele muhimu na mipaka ya matumizi

• Nyaraka za kawaida: Tumia ordinary kwa chaguo-msingi; hata jina la taasisi likitolewa, kichwa chekundu hakitatengenezwa kiotomatiki.
• Utoaji rasmi wa hati: Lazima uchague formal kwa uwazi. Hali ya karatasi yenye kichwa chekundu kilichochapishwa awali huacha nafasi kwa kichwa na mstari mwekundu uliopo kwenye karatasi, bila kuvichora tena kwenye DOCX.
• Kichwa chekundu cha kielektroniki: Ni wakati tu wa kuweka formal --letterhead digital ndipo jenereta huchora vipengele kamili vya kichwa chekundu.
• Jina la taasisi na nambari ya hati: Hutoa kupitia --org na --doc-no. Mpangilio rasmi utakataa nambari za hati zinazoonekana kutofuata kanuni za mwaka, mabano ya pembe sita, nambari ya mfuatano na herufi “号”.
• Vichwa na jedwali la yaliyomo: Vichwa vya hadi viwango vinne vitaandikwa kwa mitindo ya Word/WPS ya “Heading 1” hadi “Heading 4” na viwango vinavyolingana vya muhtasari, hivyo kuwezesha kuingiza jedwali la yaliyomo kiotomatiki.
• Nambari za kurasa: Inaunga mkono hali tatu: kuweka katikati, kurasa za upande mmoja na pande mbili, na kutokuonyesha. Vigezo husika vinapaswa kufuata SKILL.md ya mradi.
• Viambatisho na taarifa za mwisho: Viambatisho vinaweza kutengenezwa kwenye ukurasa tofauti huku mfululizo wa nambari za kurasa rasmi ukidumishwa; taarifa za nakala au uchapishaji zinaweza kuwekwa chini ya eneo la maandishi kwenye ukurasa wa mwisho.
• Usindikaji wa kibinadamu: Mihuri, mihuri ya saini, maudhui ya viambatisho na maeneo halisi ya kupiga muhuri bado yanahitaji kuongezwa au kukaguliwa kwenye DOCX kulingana na matumizi.

Kuandaa mradi na mazingira ya uendeshaji

Kwanza pata hazina kutoka ukurasa wa mradi wa GitHub, kisha ingia kwenye saraka kuu ya mradi. Jenereta na kikagua huendeshwa kupitia node, hivyo kompyuta yako inahitaji mazingira yanayofanya kazi ya Node.js; README haijaainisha toleo maalum, kwa hiyo fuata hati na matokeo ya majaribio ya sasa ya hazina.

Ikiwa unataka tu kutengeneza DOCX moja kwa moja, unaweza kuendesha hati ndani ya hazina. Ikiwa ungependa zana ya upangaji programu ya AI isome Skill hii kiotomatiki, unaweza kutumia kisakinishi cha mifumo mbalimbali.

macOS na Linux

scripts/install.sh --all

Windows

.\scripts\install.ps1 -All

Kisakinishi huunganisha saraka ileile ya chanzo na saraka za ujuzi za kiwango cha mtumiaji kwenye kila jukwaa. Windows hutumia kunakili kwa chaguo-msingi ili kuepuka matatizo ya ruhusa za viungo vya kiishara. Majukwaa yanayoungwa mkono ni pamoja na Codex, Claude Code, OpenCode, Trae Code, Trae CLI, Kimi Code CLI, Kimi Code, WorkBuddy na ZCode. TraeWork hutumia kifurushi cha kuagiza kilicho kwenye hazina, dist/traework-gongwen-skill.zip.

Kutengeneza hati yako ya kwanza ya kawaida

Mradi hutoa faili la majaribio la ingizo, tests/fixture.md. Amri ifuatayo hulibadilisha kuwa mpangilio wa hati ya kawaida na kuihifadhi kwenye saraka ya muda:

node scripts/generate_gongwen_docx.mjs --input tests/fixture.md --output /tmp/gongwen.docx --format ordinary --title "公文格式回归测试"

Maana kuu za vigezo ni hizi:

• --input: Faili la maudhui ya ingizo.
• --output: Njia ya DOCX itakayotengenezwa.
• --format ordinary: Tumia mpangilio wa ripoti, mpango au wasilisho la kawaida.
• --title: Weka kichwa cha hati.

Baada ya kutengeneza, tumia kikagua kuangalia muundo wa DOCX na vipengele vya mpangilio ambavyo zana inaweza kuthibitisha:

node scripts/verify_gongwen_docx.mjs --input /tmp/gongwen.docx --profile ordinary

Kupita kwa ukaguzi hakumaanishi kuwa mapitio ya mwisho yanaweza kurukwa. Kabla ya kuwasilisha rasmi, bado unapaswa kufungua faili katika Word au WPS kwenye kompyuta lengwa na kuangalia kukatika kwa mistari, mgawanyo wa kurasa, fonti, viambatisho na eneo la muhuri kulingana na hali halisi ya uchapishaji.

Kutengeneza rasimu ya uchapishaji kwenye karatasi yenye kichwa chekundu kilichochapishwa awali

Ikiwa hati inahitaji kuchapishwa kwenye karatasi ambayo tayari ina alama nyekundu ya taasisi na mstari mwekundu, chagua wazi mpangilio rasmi na hali ya karatasi yenye kichwa chekundu kilichochapishwa awali:

node scripts/generate_gongwen_docx.mjs --input tests/fixture.md --output /tmp/formal.docx --format formal --letterhead preprinted --letterhead-reserve-mm 72 --org "示例单位文件" --doc-no "示例发〔2026〕1号" --title "公文格式回归测试"

--letterhead-reserve-mm 72 inamaanisha kuacha nafasi ya milimita 72 kwenye ukurasa wa kwanza kwa eneo la kichwa chekundu lililopo kwenye karatasi. Milimita 72 ni thamani ya chaguo-msingi; katika matumizi halisi, pima karatasi yenye kichwa chekundu ya kitengo chako na urekebishe ndani ya kiwango cha milimita 37 hadi 130 kinachoungwa mkono na mradi. Hali hii haichori tena alama nyekundu ya taasisi na mstari mwekundu kwenye DOCX.

Kisha tumia usanidi unaolingana wa mpangilio rasmi kwa uthibitishaji:

node scripts/verify_gongwen_docx.mjs --input /tmp/formal.docx --profile formal --letterhead preprinted

Kutengeneza kichwa chekundu kamili cha kielektroniki

Tumia --letterhead digital tu unapohitaji kuchora vipengele kamili vya kichwa chekundu ndani ya DOCX:

node scripts/generate_gongwen_docx.mjs --input tests/fixture.md --output /tmp/formal-digital.docx --format formal --letterhead digital --org "示例单位文件" --doc-no "示例发〔2026〕1号" --title "公文格式回归测试"

Kichwa chekundu cha kielektroniki huathiriwa zaidi na mazingira ya fonti. Kichwa chekundu na vichwa vinapaswa kutumia Xiaobiao Song iliyo kwenye kompyuta lengwa, huku maandishi makuu na maudhui mengine yakihitaji FangSong sanifu. Jenereta ikikosa fonti hizi, itaonyesha onyo kwenye terminali na kurekodi fonti mbadala iliyotumiwa.

Kukataza matumizi ya fonti mbadala

Kwa mazingira ya uwasilishaji yasiyoruhusu fonti mbadala, ongeza --require-standard-fonts kwenye jenereta na kikagua kwa pamoja. Ikiwa kompyuta ya sasa haina Xiaobiao Song au FangSong sanifu, amri itasimama na kuorodhesha fonti zilizokosekana badala ya kuendelea kutoa toleo lenye fonti mbadala.

node scripts/generate_gongwen_docx.mjs --input tests/fixture.md --output /tmp/strict.docx --format formal --letterhead digital --org "示例单位文件" --doc-no "示例发〔2026〕1号" --title "公文格式回归测试" --require-standard-fonts
node scripts/verify_gongwen_docx.mjs --input /tmp/strict.docx --profile formal --letterhead digital --require-standard-fonts

Jedwali la yaliyomo, viambatisho na miundo maalum

Kutengeneza jedwali la yaliyomo katika Word au WPS

Jenereta huandika vichwa vya hadi viwango vinne kwa mitindo sanifu ya vichwa na viwango vya muhtasari. Baada ya kufungua hati, chagua “Marejeo→Jedwali la yaliyomo” katika Word/WPS ili kutengeneza au kusasisha jedwali la yaliyomo kiotomatiki. Ili kuonyesha vichwa vya kiwango cha nne, chagua hilo katika mipangilio ya jedwali la yaliyomo.

Kuongeza viambatisho

Kwa kutumia --attachment-file mara nyingi, unaweza kuongeza viambatisho vingi kwenye hati, kila kimoja kwenye ukurasa tofauti. Jenereta hupanga lebo ya “Kiambatisho”, kichwa cha mstari wa tatu na maandishi makuu, huku ikidumisha mfululizo wa nambari za kurasa za hati rasmi. Muundo mahususi wa ingizo unapaswa kurejelewa katika SKILL.md ya hazina.

Kuchagua tawi maalum la utengenezaji

• Barua letter: Hutengeneza mistari miwili myekundu ya juu na chini yenye vipimo vilivyoainishwa, mstari wa chini ukiwa kwenye kijachini, na kuzima nambari za kurasa.
• Amri command: Hutekeleza mahitaji ya mpangilio kama kuacha mistari miwili wazi chini ya alama ya taasisi na mistari miwili chini ya nambari ya amri.
• Kumbukumbu minutes: Huweka lebo za “Waliohudhuria”, “Waliomba ruhusa” na “Waliohudhuria kama wageni” kwa fonti ya Heiti, na orodha ya majina kwa FangSong.

Aina hizi si ubadilishaji rahisi wa maandishi katika mpangilio wa kawaida; kila moja huingia kwenye tawi lake la utengenezaji. Thibitisha kwanza aina ya hati kabla ya kuchagua.

Mapendekezo ya matumizi ya juu

1. Usikisie aina ya kichwa chekundu kwa kutumia jina la taasisi. Nyaraka za kawaida zitumie wazi ordinary, huku utoaji rasmi wa hati ukitumia wazi formal.
2. Thibitisha karatasi kwanza, kisha weka nafasi ya uchapishaji. Vipimo halisi vya karatasi yenye kichwa chekundu kilichochapishwa awali vinaweza kutofautiana kulingana na kiolezo cha kitengo; usitumie milimita 72 ya chaguo-msingi bila kupima.
3. Sakinisha na uthibitishe fonti katika mazingira ya mwisho ya uhariri. Fonti moja inaweza kuwa na majina tofauti katika mifumo, Word na WPS tofauti; fonti mbadala pia inaweza kubadilisha ukubwa wa maandishi, nafasi za mistari na kukatika kwa mistari.
4. Tumia mitindo ya vichwa kudhibiti hati ndefu. Usifananishie viwango vya jedwali la yaliyomo kwa mkono; tumia mitindo ya Heading 1 hadi Heading 4 iliyoandikwa na jenereta.
5. Unganisha ukaguzi wa kiotomatiki na ukaguzi wa kibinadamu. Unaweza kurejelea references/gbt9704-audit-matrix.md na references/formal-checklist.md katika hazina ili kutofautisha vipengele vinavyoweza kukaguliwa kiotomatiki na vile vinavyohitaji mapitio ya kibinadamu.
6. Zingatia mantiki maalum ya upangaji. Kichwa chekundu rasmi cha kielektroniki hutumia mistari wazi yenye ukubwa wa pointi 28 ili kudhibiti kwa uwazi umbali kutoka mstari mwekundu hadi kichwa kilicho chini yake na kutoka alama ya taasisi hadi nambari ya hati; katika hati zinazowasilishwa ngazi ya juu, nambari ya hati na mtoaji saini hupangwa kwenye mstari mmoja.

Kuendesha majaribio ya mradi

Katika mazingira ya macOS au Linux, unaweza kuendesha majaribio ya urejeshaji yanayotolewa na hazina:

tests/run_tests.sh

Majaribio haya yanashughulikia utengenezaji wa nambari za kurasa zilizowekwa katikati na za ukurasa mmoja/pande mbili, muundo wa kifurushi cha DOCX na uthibitishaji wa ubadilishaji wa PDF, hivyo kuthibitisha kuwa mnyororo wa jenereta, kikagua na faili linaloweza kuchapishwa unaweza kufanya kazi. Usakinishaji wa mifumo mbalimbali unaweza pia kuthibitishwa katika mazingira yaliyotengwa kupitia tests/test-install.sh, ikijumuisha saraka ya ujuzi ya ndani na kifurushi cha kuagiza cha TraeWork.

Hitimisho

Gongwen Skill hukusanya kanuni za nyaraka rasmi ambazo mara nyingi hutawanyika katika vidokezo vya maelekezo, violezo vya Word na hati za muda, na kuziweka katika mtiririko mmoja unaoweza kudumishwa. Njia thabiti zaidi ya kuitumia ni: kwanza chagua mpangilio sahihi wa kawaida au rasmi, kisha tengeneza DOCX, endesha kikagua, na hatimaye fanya uhakiki wa kibinadamu katika Word/WPS lengwa, mazingira ya fonti na masharti ya uchapishaji. Mradi umepewa leseni ya MIT, lakini maandishi sanifu na violezo vya taasisi bado vinapaswa kuzingatia sheria zao za haki na usimamizi.