Dokumentaro / reference
MCP-iloj
Ĉiu ilo sur la publikaj kaj administraj MCP-servoj, kun argumentoj kaj ekzemploj.
Serviloj
| Servilo | URL | Aŭtentigo |
|---|---|---|
| Publika | https://jenksguo.pages.dev/mcp |
neniu |
| Admin | https://jenksguo.pages.dev/mcp/admin |
Authorization: Bearer <agent token> (jgx_agt_…, ampleksoj) |
| Loka (stdio) | jenks mcp / jenks mcp --admin |
env JENKSGUO_ADMIN_TOKEN por admin |
Transporto: Flue transdona HTTP, senstato, JSON-RPC 2.0 per POST (protokolo 2025-06-18). GET ĉe ambaŭ URL-oj redonas malkovran dokumenton. Servilo nomo jenksguo, versio 1.4.0.
curl -s https://jenksguo.pages.dev/mcp -H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_brief","arguments":{}}}'
Publikaj iloj
get_brief — Ricevi la resumon de Jenks
Unupaĝa Markdown-resumo pri Jenks Guo: poziciigo, nuna rolo, kariera arko, fortoj, lingvoj, kontakto, kaj kiel esplori plu. Komencu ĉi tie.
- MCP:
get_briefĉehttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/brief - CLI:
jenks brief
Neniuj argumentoj.
curl -s "https://jenksguo.pages.dev/api/v1/brief"
list_experience — Listigi spertojn
Listigu la spertojn, projektojn, komunumarolojn kaj edukadon de Jenks (la plej novaj unue), laŭvole filtrite per industria etikedo, rola lenso aŭ tipo. Redonas mallongajn formojn: titolo, organizo, periodo, resumo, ĉefa rezulto, paĝa URL.
- MCP:
list_experienceĉehttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/entries?tag=&lens=&kind=&locale= - CLI:
jenks list [--tag it] [--lens solution-architect] [--kind project]
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
tag |
it · engineering · ai · devrel · web3 · business · marketing · consulting · hospitality · community · creative |
ne | |
lens |
head-of-ai · ai-transformation-consultant · engineering-manager · solution-architect · system-integrator · support-engineer · ict-specialist · developer-advocate · developer-evangelist · digital-marketer · hospitality |
ne | |
kind |
experience · education · community · project |
ne | |
locale |
en · zh · zh-hant · ja · fr · es · eo |
ne | Lingvo por tradukitaj kampoj (defaŭlte en). |
curl -s "https://jenksguo.pages.dev/api/v1/entries"
get_entry — Ricevi unu eniron
Plena longforma priskribo de unu sperto, projekto, komunumarolo aŭ eduk-eniro laŭ slugo: superrigardo, kion faris Jenks, atingoj, kial tio gravas por dungantoj, ĉefaj rezultoj, lertoj, pruvoligiloj.
- MCP:
get_entryĉehttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/entries/{slug}?locale= - CLI:
jenks get <slug>
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
slug |
string | jes | Enir-slugo, ekz. xero-developer-evangelist |
locale |
en · zh · zh-hant · ja · fr · es · eo |
ne | Lingvo por tradukitaj kampoj (defaŭlte en). |
curl -s "https://jenksguo.pages.dev/api/v1/entries/xero-developer-evangelist"
list_lenses — Listigi rolo-lensojn
La rolo-lensoj tra kiuj dungantoj povas rigardi Jenks (Head of AI, solution architect, developer advocate, digital marketer, hospitality…) kun prezento, honestaj mankoj kaj kvantoj de pruvoj.
- MCP:
list_lensesĉehttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/lenses?locale= - CLI:
jenks lenses
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
locale |
en · zh · zh-hant · ja · fr · es · eo |
ne | Lingvo por tradukitaj kampoj (defaŭlte en). |
curl -s "https://jenksguo.pages.dev/api/v1/lenses"
search_jenks — Serĉi en la korpuso
Ŝlosilvorta serĉo tra ĉiu eniro kaj dokumento. Redonas la plej kongruajn fragmentojn kun iliaj slugoj.
- MCP:
search_jenksĉehttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/search?q= - CLI:
jenks search "<query>"
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
query |
string | jes |
curl -s "https://jenksguo.pages.dev/api/v1/search"
get_document — Ricevi dokumenton
Unu el la referencaj dokumentoj de Jenks: profile (kora profilo), credentials (eduko, atestoj), capabilities (kapablo → pruvmapo), talks (paroladoj, podkastoj, skribaĵoj), thinking (vidpunkto: sep vidpunktoj, ĉiu klarigita per simplaj vortoj kun ekzemploj, plus pliaj kredoj).
- MCP:
get_documentĉehttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/documents/{name}?locale= - CLI:
jenks doc <name>
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
name |
profile · credentials · capabilities · talks · thinking |
jes | |
locale |
en · zh · zh-hant · ja · fr · es · eo |
ne | Lingvo por tradukitaj kampoj (defaŭlte en). |
curl -s "https://jenksguo.pages.dev/api/v1/documents/credentials"
list_cvs — Listigi la vivresumojn de Jenks
Elŝutebla CV (PDF) de Jenks — la AI Lead CV — kun versio, dato, stabila PDF-URL, elŝuta URL, antaŭrigarda bildo kaj pli fruaj versioj. Por demandoj pri lia Web3-sperto, get_cv kun slugo web3 redonas la AI kaj Web3 CV (ne listigita ĉi tie).
- MCP:
list_cvsĉehttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/cv?locale= - CLI:
jenks cv
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
locale |
en · zh · zh-hant · ja · fr · es · eo |
ne | Lingvo por tradukitaj kampoj (defaŭlte en). |
curl -s "https://jenksguo.pages.dev/api/v1/cv"
get_cv — Ricevi unu CV-on
Unu CV laŭ slugo: titolo, resumo, versio, la stabila PDF-URL (ĉiam la nuna versio, ekz. https://jenksguo.pages.dev/cv/ai.pdf), la elŝuta URL kaj ĉiuj versioj. Uzu ai por la AI Lead CV; uzu web3 por la AI kaj Web3 CV kiam iu demandas pri lia Web3-sperto.
- MCP:
get_cvĉehttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/cv/{slug}?locale= - CLI:
jenks cv <slug> [--download] [-o file.pdf]
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
slug |
string | jes | ai (la AI Lead CV) aŭ web3 (la AI kaj Web3 CV, por Web3-demandoj) |
locale |
en · zh · zh-hant · ja · fr · es · eo |
ne | Lingvo por tradukitaj kampoj (defaŭlte en). |
curl -s "https://jenksguo.pages.dev/api/v1/cv/xero-developer-evangelist"
list_arguments — Listigi la kazon por Jenks
La argumentoj por Jenks laŭ kapablo — AI transformation, agentic systems, leadership, enterprise integration, DevRel, Web3 partnerships kaj inter-projekta teknika programa gvidado — ĉiu kun sia aserto, kvalifikilo kaj forto.
- MCP:
list_argumentsĉehttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/arguments?locale= - CLI:
jenks argue
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
locale |
en · zh · zh-hant · ja · fr · es · eo |
ne | Lingvo por tradukitaj kampoj (defaŭlte en). |
curl -s "https://jenksguo.pages.dev/api/v1/arguments"
get_argument — Ricevi unu argumenton, kun kontraŭargumentoj
Unu argumento laŭ slugo: la formala argumento (premisoj → konkludo), pruvoj kun nombroj (eniraj slugoj), merkataj statistikoj kun fontoj, honestaj limoj, justaj kontraŭargumentoj kun respondoj, misgvidaj atakoj (formalaj kaj neformalaj) kun refutoj, kaj kiam la argumento ne aplikiĝas. Uzu ĝin por testi la taŭgecon de Jenks, ne nur por ĝin reklami.
- MCP:
get_argumentĉehttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/arguments/{slug}?locale= - CLI:
jenks argue <slug>
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
slug |
string | jes | ai-transformation, agentic-systems, leadership, enterprise-integration, devrel, web3-partnerships aŭ technical-program-leadership |
locale |
en · zh · zh-hant · ja · fr · es · eo |
ne | Lingvo por tradukitaj kampoj (defaŭlte en). |
curl -s "https://jenksguo.pages.dev/api/v1/arguments/xero-developer-evangelist"
ask_jenks — Demandi la asistanton de Jenks
Faru natur-lingvan demandon al la asistanto Ask Jenks (rola taŭgeco, konsilado pri konsulta amplekso, AI-transforma konsilo, STAR-rakontoj, rego…). Ĝi lanĉas proprajn ilojn super la korpuso kaj respondas en la petita lingvo. Indictlimigita.
- MCP:
ask_jenksĉehttps://jenksguo.pages.dev/mcp - REST:
POST /api/v1/ask - CLI:
jenks ask "<question>"
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
question |
string | jes | |
locale |
en · zh · zh-hant · ja · fr · es · eo |
ne | Lingvo por tradukitaj kampoj (defaŭlte en). |
history |
array | ne | Laŭvolaj pli fruaj turnoj. |
curl -s -X POST https://jenksguo.pages.dev/api/v1/ask \
-H 'content-type: application/json' \
-d '{"question":"Is Jenks a fit for a Head of AI role?"}'
Admin-iloj
admin_whoami — Kiu mi estas
Kontrolu vian akreditilon: kiu vi estas (SSO-retpoŝto aŭ nomo de agent-tokano), viaj ampleksoj, kiam via tokano senvalidiĝas, kaj ĉu publikigo (GitHub) estas agordita.
- MCP:
admin_whoamiĉehttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/whoami(agent token) - Amplekso:
read - CLI:
jenks admin whoami
Neniuj argumentoj.
curl -s "https://jenksguo.pages.dev/api/admin/whoami" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_audit_log — Revizia protokolo
Lastatempaj admin-agojoj, la plej novaj unue: kiu (SSO-retpoŝto aŭ agent-tokano), kion, kiujn dosierojn, branĉon, gastigon kaj rezulton. Agent-tokano vidas nur siajn proprajn agojn.
- MCP:
admin_audit_logĉehttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/audit?limit=&token=(agent token) - Amplekso:
read - CLI:
jenks admin audit [--limit 50]
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
limit |
integer | ne | |
token |
string | ne | Nur ĉi tiu agent-tokana identigilo (nur por homoj) |
curl -s "https://jenksguo.pages.dev/api/admin/audit" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_schema — Enhava skemo
La enhava modelo: enirkampoj kaj reguloj, etikedoj, lensoj, tipoj, skribeblaj vojoj, dokumentoj, kaj redaktaj konvencioj. Legu ĉi tion antaŭ ol skribi.
- MCP:
admin_schemaĉehttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/schema(agent token) - Amplekso:
read - CLI:
jenks admin schema
Neniuj argumentoj.
curl -s "https://jenksguo.pages.dev/api/admin/schema" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_list_files — Listigi enhavajn dosierojn
Listigu redakteblajn enhavajn dosierojn en branĉo (vojo, grandeco, sha), laŭvole ene de unu dosierujo kiel content/corpus/experiences.
- MCP:
admin_list_filesĉehttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/files?dir=&branch=(agent token) - Amplekso:
read - CLI:
jenks admin ls [dir]
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
dir |
string | ne | ekz. content/corpus/projects (defaŭlte: tuta enhavo) |
branch |
main · dev |
ne | main publikigas la vivan retejon (jenksguo.pages.dev kaj ĝia spegulo jenksguo.xyz); dev antaŭvidas ĉe dev.jenksguo.xyz (defaŭlte main). |
curl -s "https://jenksguo.pages.dev/api/admin/files" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_read_file — Legi enhavan dosieron
Legu la krudan Markdown/JSON-fonton de enhava dosiero (kun ĝia sha). Transdonu path, aŭ slug por eniro, lenso aŭ lerto.
- MCP:
admin_read_fileĉehttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/file?path=&slug=&branch=(agent token) - Amplekso:
read - CLI:
jenks admin get <slug|path>
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
path |
string | ne | |
slug |
string | ne | |
branch |
main · dev |
ne | main publikigas la vivan retejon (jenksguo.pages.dev kaj ĝia spegulo jenksguo.xyz); dev antaŭvidas ĉe dev.jenksguo.xyz (defaŭlte main). |
curl -s "https://jenksguo.pages.dev/api/admin/file" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_validate — Validigi ŝanĝon
Validigu dosierenhavon kontraŭ la enhava skemo sen fari enmeton. Redonas liston de problemoj (malplena = valida).
- MCP:
admin_validateĉehttps://jenksguo.pages.dev/mcp/admin - REST:
POST /api/admin/validate(agent token) - Amplekso:
read - CLI:
jenks admin validate <path> <file>
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
path |
string | jes | |
content |
string | jes |
curl -s -X POST https://jenksguo.pages.dev/api/admin/validate \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"path":"content/corpus/projects/example.md","content":"<content>"}'
admin_write_file — Krei aŭ ĝisdatigi enhavan dosieron
Validigu kaj enmetu unu enhavan dosieron (krei aŭ anstataŭigi). Publikigo estas aŭtomata: CI retradukas ŝanĝitajn enirojn al ĉiuj lingvoj, rekonstruas kaj deplojas (main → jenksguo.pages.dev kaj jenksguo.xyz, dev → dev.jenksguo.xyz) post kelkaj minutoj.
- MCP:
admin_write_fileĉehttps://jenksguo.pages.dev/mcp/admin - REST:
PUT /api/admin/file(agent token) - Amplekso:
content(+publishpor branĉomain) - CLI:
jenks admin put <path> <file> -m <message>
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
path |
string | jes | |
content |
string | jes | |
message |
string | jes | Komentmesaĝo |
branch |
main · dev |
ne | main publikigas la vivan retejon (jenksguo.pages.dev kaj ĝia spegulo jenksguo.xyz); dev antaŭvidas ĉe dev.jenksguo.xyz (defaŭlte main). |
curl -s -X PUT https://jenksguo.pages.dev/api/admin/file \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"path":"content/corpus/projects/example.md","content":"<content>","message":"<message>"}'
admin_delete_file — Forigi enhavan dosieron
Forigu unu enhavan dosieron (ekz. forigi eniron) kun komentmesaĝo. Git-historio tenas ĝin reakirebla.
- MCP:
admin_delete_fileĉehttps://jenksguo.pages.dev/mcp/admin - REST:
DELETE /api/admin/file?path=&message=&branch=(agent token) - Amplekso:
content(+publishpor branĉomain) - CLI:
jenks admin rm <path> -m <message>
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
path |
string | jes | |
message |
string | jes | |
branch |
main · dev |
ne | main publikigas la vivan retejon (jenksguo.pages.dev kaj ĝia spegulo jenksguo.xyz); dev antaŭvidas ĉe dev.jenksguo.xyz (defaŭlte main). |
curl -s -X DELETE https://jenksguo.pages.dev/api/admin/file \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"path":"content/corpus/projects/example.md","message":"<message>"}'
admin_commit_changes — Enmeti plurajn dosierojn samtempe
Validigu kaj enmetu plurajn dosierŝanĝojn kiel UNU komiton. Ĉiu ŝanĝo estas {path, content} aŭ {path, delete: true}.
- MCP:
admin_commit_changesĉehttps://jenksguo.pages.dev/mcp/admin - REST:
POST /api/admin/changes(agent token) - Amplekso:
content(+publishpor branĉomain) - CLI:
jenks admin commit <changes.json> -m <message>
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
changes |
array | jes | |
message |
string | jes | |
branch |
main · dev |
ne | main publikigas la vivan retejon (jenksguo.pages.dev kaj ĝia spegulo jenksguo.xyz); dev antaŭvidas ĉe dev.jenksguo.xyz (defaŭlte main). |
curl -s -X POST https://jenksguo.pages.dev/api/admin/changes \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"changes":"<changes>","message":"<message>"}'
admin_ai_edit — Verki redakton per AI
Petu la modelon de la retejo reskribi unu enhavan dosieron el simpl-angla instrukcio. Redonas la proponitan enhavon, diferencon (diff) kaj validigajn problemojn. NE enmetas — reviziu, poste voku admin_write_file.
- MCP:
admin_ai_editĉehttps://jenksguo.pages.dev/mcp/admin - REST:
POST /api/admin/ai-edit(agent token) - Amplekso:
content - CLI:
jenks admin ai-edit <slug|path> "<instruction>" [--apply]
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
path |
string | ne | |
slug |
string | ne | |
instruction |
string | jes | |
branch |
main · dev |
ne | main publikigas la vivan retejon (jenksguo.pages.dev kaj ĝia spegulo jenksguo.xyz); dev antaŭvidas ĉe dev.jenksguo.xyz (defaŭlte main). |
content |
string | ne | Laŭvola nekonservita dosierteksto el kiu verki skizon (defaŭlte: la konservita dosiero). |
curl -s -X POST https://jenksguo.pages.dev/api/admin/ai-edit \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"instruction":"<instruction>"}'
admin_read_translation — Legi tradukon
Unu enhava dosiero en alia lingvo: la anglaj font-kampoj, la nuna traduko kaj ĝia stato (aktuala, malaktuala, mane redaktita, mankanta). Funkcias por eniroj, lensoj, CV-oj, argumentoj, vidpunkto-paĝoj, credentials, talks kaj la dokumentoj. Lingvoj: zh, zh-hant, ja, fr, es, eo.
- MCP:
admin_read_translationĉehttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/translation?path=&slug=&locale=&branch=(agent token) - Amplekso:
read - CLI:
jenks admin tr get <slug|path> <locale>
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
path |
string | ne | |
slug |
string | ne | |
locale |
zh · zh-hant · ja · fr · es · eo |
jes | |
branch |
main · dev |
ne | main publikigas la vivan retejon (jenksguo.pages.dev kaj ĝia spegulo jenksguo.xyz); dev antaŭvidas ĉe dev.jenksguo.xyz (defaŭlte main). |
curl -s "https://jenksguo.pages.dev/api/admin/translation" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_write_translation — Redakti tradukon
Skribu la tekston de unu enhava dosiero en alia lingvo (zh, zh-hant, ja, fr, es, eo) — ekzemple pli bona ĉina resumo. Donu nur la kampojn por ŝanĝi; legu admin_read_translation unue por la kampnomoj. Markdown devas konservi la anglajn titolojn, kodblokoj kaj ligilojn. La redakto estas konservata ĝis la angla ŝanĝiĝas; tiam tiu lingvo estas retradukata aŭtomate. La angla estas la fonto: ŝanĝu ĝin per admin_write_file.
- MCP:
admin_write_translationĉehttps://jenksguo.pages.dev/mcp/admin - REST:
PUT /api/admin/translation(agent token) - Amplekso:
content(+publishpor branĉomain) - CLI:
jenks admin tr put <slug|path> <locale> <fields.json> -m <message>
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
path |
string | ne | |
slug |
string | ne | |
locale |
zh · zh-hant · ja · fr · es · eo |
jes | |
fields |
object | jes | ekz. {"summary": "…", "body": "## …"} |
message |
string | ne | Komentmesaĝo |
branch |
main · dev |
ne | main publikigas la vivan retejon (jenksguo.pages.dev kaj ĝia spegulo jenksguo.xyz); dev antaŭvidas ĉe dev.jenksguo.xyz (defaŭlte main). |
curl -s -X PUT https://jenksguo.pages.dev/api/admin/translation \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"locale":"<locale>","fields":"<fields>"}'
admin_read_copy — Legi retejan tekstaron
La interfaca teksto de la retejo en unu lingvo — menuoj, paĝaj titoloj, la unuliniaj paĝenkonduktoj, la ĉefheroa titolo, butonoj, SEO-priskriboj — kiel ŝlosilo → teksto, kun la angla (kaj la ĉina por zh-hant) apude. Filtru per prefikso, ekz. hero aŭ career.
- MCP:
admin_read_copyĉehttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/copy?locale=&prefix=&branch=(agent token) - Amplekso:
read - CLI:
jenks admin copy get <locale> [prefix]
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
locale |
en · zh · zh-hant · ja · fr · es · eo |
jes | |
prefix |
string | ne | |
branch |
main · dev |
ne | main publikigas la vivan retejon (jenksguo.pages.dev kaj ĝia spegulo jenksguo.xyz); dev antaŭvidas ĉe dev.jenksguo.xyz (defaŭlte main). |
curl -s "https://jenksguo.pages.dev/api/admin/copy" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_write_copy — Redakti retejan tekstaron
Ŝanĝu interfacan tekston en unu lingvo: values estas ŝlosilo → teksto ("" forigas vian redakton). en kaj zh estas la permane verkitaj fontoj: angla ŝanĝo estas tradukata al ja, fr, es kaj eo aŭtomate — ankaŭ fiksu zh. Redakto en alia lingvo estas konservata ĝis ĝia font-teksto ŝanĝiĝas. Konservu {placeholders} ekzakte.
- MCP:
admin_write_copyĉehttps://jenksguo.pages.dev/mcp/admin - REST:
PUT /api/admin/copy(agent token) - Amplekso:
content(+publishpor branĉomain) - CLI:
jenks admin copy set <locale> <key> "<text>" -m <message>
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
locale |
en · zh · zh-hant · ja · fr · es · eo |
jes | |
values |
object | jes | ekz. {"hero.sub": "…"} |
message |
string | ne | |
branch |
main · dev |
ne | main publikigas la vivan retejon (jenksguo.pages.dev kaj ĝia spegulo jenksguo.xyz); dev antaŭvidas ĉe dev.jenksguo.xyz (defaŭlte main). |
curl -s -X PUT https://jenksguo.pages.dev/api/admin/copy \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"locale":"<locale>","values":"<values>"}'
admin_deploy_status — Deplojstato
Lastatempaj CI-ruladoj (translate → build → deploy) kun stato, branĉo, komito kaj ligiloj.
- MCP:
admin_deploy_statusĉehttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/deploys?branch=(agent token) - Amplekso:
read - CLI:
jenks admin deploys
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
branch |
main · dev |
ne | main publikigas la vivan retejon (jenksguo.pages.dev kaj ĝia spegulo jenksguo.xyz); dev antaŭvidas ĉe dev.jenksguo.xyz (defaŭlte main). |
curl -s "https://jenksguo.pages.dev/api/admin/deploys" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_promote — Promocii dev al produktado
Kunfandu la dev-branĉon en main, publikigante ĉion antaŭviditan ĉe dev.jenksguo.xyz al la viva retejo (jenksguo.pages.dev kaj jenksguo.xyz).
- MCP:
admin_promoteĉehttps://jenksguo.pages.dev/mcp/admin - REST:
POST /api/admin/promote(agent token) - Amplekso:
publish - CLI:
jenks admin promote
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
message |
string | ne |
curl -s -X POST https://jenksguo.pages.dev/api/admin/promote \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{}'
admin_publish_cv — Publikigi novan CV-version
Alŝutu novan PDF-on por CV (ai, web3 aŭ nova slugo) kaj faru ĝin la nuna versio en unu paŝo: la PDF iras al la amaskomunikila biblioteko, la antaŭa versio moviĝas al la historio de la CV (ankoraŭ elŝutebla), kaj la ŝanĝo estas enmetita (CI ĝin publikigas). Laŭvola antaŭrigarda bildo kaj nova titolo/resumo. La stabila url /cv/
- MCP:
admin_publish_cvĉehttps://jenksguo.pages.dev/mcp/admin - REST:
POST /api/admin/cv(agent token) - Amplekso:
content+media(+publishpor branĉomain) - CLI:
jenks admin cv publish <slug> <file.pdf> --cv-version 2026.10 [--preview /media/…]
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
slug |
string | jes | ai, web3, aŭ nova kebab-case identigilo |
version |
string | jes | ekz. 2026.10 |
filename |
string | ne | |
data |
string | ne | PDF-bajtoj, base64 |
url |
string | ne | Alternativo al data: https-URL de la PDF |
preview |
string | ne | Laŭvole: jam alŝutita /media/… bildo de paĝo 1 |
title |
string | ne | |
summary |
string | ne | |
message |
string | ne | Komentmesaĝo |
branch |
main · dev |
ne | main publikigas la vivan retejon (jenksguo.pages.dev kaj ĝia spegulo jenksguo.xyz); dev antaŭvidas ĉe dev.jenksguo.xyz (defaŭlte main). |
curl -s -X POST https://jenksguo.pages.dev/api/admin/cv \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"slug":"<slug>","version":"<version>"}'
admin_list_media — Listigi amaskomunikilaron
Listigu alŝutitajn bildojn, videoj kaj PDF-ojn (la plej novaj unue): url, tipo, grandeco, dimensioj, alternativa teksto, preta-alglui Markdown, kaj kiuj eniroj uzas ĉiun dosieron.
- MCP:
admin_list_mediaĉehttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/media?prefix=&cursor=&limit=(agent token) - Amplekso:
read - CLI:
jenks admin media ls [prefix]
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
prefix |
string | ne | Ŝlosila prefikso kiel 2026/10 |
cursor |
string | ne | |
limit |
integer | ne |
curl -s "https://jenksguo.pages.dev/api/admin/media" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_upload_media — Alŝuti amaskomunikilaron
Konservu bildon (webp, jpg, png, gif, avif, svg), videon (mp4, webm) aŭ PDF-on, ĝis 25 MB, en Cloudflare R2 kaj ricevu ĝian publikan /media/… URL-on kaj Markdown. Sendu base64 data kun filename, aŭ publikan https-url por importi. Dosieroj estas publike alireblaj tuj per URL; referencu ilin el enhavo per admin_write_file. La REST-finpunkto ankaŭ akceptas multipart/form-data (kampo file).
- MCP:
admin_upload_mediaĉehttps://jenksguo.pages.dev/mcp/admin - REST:
POST /api/admin/media(agent token) - Amplekso:
media - CLI:
jenks admin media upload <file|https-url> [--alt "…"]
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
filename |
string | ne | Origina dosiernomo; fariĝas la legebla parto de la URL. |
data |
string | ne | Dosierbajtoj, base64 (data:-URL-prefikso estas permesata). |
url |
string | ne | Alternativo al data: https-URL kiun la servilo elŝutas. |
alt |
string | ne | Alternativa teksto: kion la bildo montras, por ekranlegiloj kaj la boto. |
width |
integer | ne | |
height |
integer | ne |
curl -s -X POST https://jenksguo.pages.dev/api/admin/media \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{}'
admin_update_media — Ĝisdatigi alternativan tekston de amaskomunikilaro
Ŝanĝu la konservitan alternativan tekston de alŝutita dosiero (la defaŭlta alt kiam ĝi estas enmetata en enhavon).
- MCP:
admin_update_mediaĉehttps://jenksguo.pages.dev/mcp/admin - REST:
PATCH /api/admin/media(agent token) - Amplekso:
media - CLI:
jenks admin media alt <key> "<alt text>"
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
key |
string | jes | Amaskomunikila ŝlosilo aŭ URL, ekz. 2026/10/xero-talk-1a2b3c4d5e.webp |
alt |
string | jes |
curl -s -X PATCH https://jenksguo.pages.dev/api/admin/media \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"key":"<key>","alt":"<alt>"}'
admin_delete_media — Forigi amaskomunikilaron
Daŭre forigu alŝutitan dosieron. Rifuzata dum publikigita enhavo ankoraŭ uzas ĝin, krom se force estas vera. Ne reakirebla — male al enhavaj dosieroj ne ekzistas git-historio.
- MCP:
admin_delete_mediaĉehttps://jenksguo.pages.dev/mcp/admin - REST:
DELETE /api/admin/media?key=&force=(agent token) - Amplekso:
media - CLI:
jenks admin media rm <key> [--force]
| Argumento | Tipo | Deviga | Notoj |
|---|---|---|---|
key |
string | jes | |
force |
boolean | ne |
curl -s -X DELETE https://jenksguo.pages.dev/api/admin/media \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"key":"<key>"}'
.mdĈi tiu paĝo estas tradukita kun helpo de AI; oficialaj titoloj restas en la angla.