服务器

服务器	URL	认证
Public	https://jenksguo.pages.dev/mcp	无
Admin	https://jenksguo.pages.dev/mcp/admin	Authorization: Bearer <agent token> (jgx_agt_…，带作用域)
Local (stdio)	jenks mcp / jenks mcp --admin	管理端使用环境变量 JENKSGUO_ADMIN_TOKEN

传输：可流式 HTTP、无状态、JSON-RPC 2.0（POST，协议 2025-06-18）。对任一 URL 发起 GET 返回发现文档。服务器名 jenksguo，版本 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":{}}}'

公共工具

get_brief — 获取 Jenks 的一页简介

关于 Jenks Guo 的一页 Markdown 简介：定位、当前角色、职业轨迹、优势、语言、联系信息，以及如何进一步了解。建议从此开始。

• MCP: get_brief 于 https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/brief
• CLI: jenks brief

无参数。

curl -s "https://jenksguo.pages.dev/api/v1/brief"

list_experience — 列出经历

列出 Jenks 的经历、项目、社区角色与教育（时间倒序），可按行业标签、角色视角或类别过滤。返回精简字段：标题、组织、时间段、摘要、关键结果、页面 URL。

• MCP: list_experience 于 https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/entries?tag=&lens=&kind=&locale=
• CLI: jenks list [--tag it] [--lens solution-architect] [--kind project]

参数	类型	必填	说明
tag	it · engineering · ai · devrel · web3 · business · marketing · consulting · hospitality · community · creative	否
lens	head-of-ai · ai-transformation-consultant · engineering-manager · solution-architect · system-integrator · support-engineer · ict-specialist · developer-advocate · developer-evangelist · digital-marketer · hospitality	否
kind	experience · education · community · project	否
locale	en · zh · zh-hant · ja · fr · es · eo	否	翻译字段的语言（默认 en）。

curl -s "https://jenksguo.pages.dev/api/v1/entries"

get_entry — 获取单条经历

按 slug 获取一条经历、项目、社区角色或教育的长文写作：概览、Jenks 的工作、成就、对雇主的重要性、关键结果、技能、证据链接。

• MCP: get_entry 于 https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/entries/{slug}?locale=
• CLI: jenks get <slug>

参数	类型	必填	说明
slug	string	是	条目 slug，如 xero-developer-evangelist
locale	en · zh · zh-hant · ja · fr · es · eo	否	翻译字段的语言（默认 en）。

curl -s "https://jenksguo.pages.dev/api/v1/entries/xero-developer-evangelist"

list_lenses — 罗列角色视角

雇主可据此看待 Jenks 的角色视角（Head of AI、solution architect、developer advocate、digital marketer、hospitality…），包含推介、真实差距与证据计数。

• MCP: list_lenses 于 https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/lenses?locale=
• CLI: jenks lenses

参数	类型	必填	说明
locale	en · zh · zh-hant · ja · fr · es · eo	否	翻译字段的语言（默认 en）。

curl -s "https://jenksguo.pages.dev/api/v1/lenses"

search_jenks — 语料搜索

对所有条目与文档进行关键词搜索。返回最佳匹配片段及其 slug。

• MCP: search_jenks 于 https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/search?q=
• CLI: jenks search "<query>"

参数	类型	必填	说明
query	string	是

curl -s "https://jenksguo.pages.dev/api/v1/search"

get_document — 获取文档

Jenks 的参考文档之一：profile（核心档案）、credentials（教育与认证）、capabilities（能力 → 证据映射）、talks（演讲、播客、写作）、thinking（观点：七个视角，用通俗语言与示例解释，并含更多信念）。

• MCP: get_document 于 https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/documents/{name}?locale=
• CLI: jenks doc <name>

参数	类型	必填	说明
name	profile · credentials · capabilities · talks · thinking	是
locale	en · zh · zh-hant · ja · fr · es · eo	否	翻译字段的语言（默认 en）。

curl -s "https://jenksguo.pages.dev/api/v1/documents/credentials"

list_cvs — 列出 Jenks 的简历

Jenks 可下载的简历（PDF）——AI Lead 简历——包含版本、日期、稳定 PDF 链接、下载链接、预览图与早期版本。若需了解他的 Web3 经历，使用 get_cv 的 slug web3 返回 AI 与 Web3 简历（此处列表不含）。

• MCP: list_cvs 于 https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/cv?locale=
• CLI: jenks cv

参数	类型	必填	说明
locale	en · zh · zh-hant · ja · fr · es · eo	否	翻译字段的语言（默认 en）。

curl -s "https://jenksguo.pages.dev/api/v1/cv"

get_cv — 获取单份简历

按 slug 获取一份简历：标题、摘要、版本、稳定 PDF 链接（始终指向当前版本，如 https://jenksguo.pages.dev/cv/ai.pdf）、下载链接与所有版本。使用 ai 获取 AI Lead 简历；当有人询问他的 Web3 经历时，使用 web3 获取 AI 与 Web3 简历。

• MCP: get_cv 于 https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/cv/{slug}?locale=
• CLI: jenks cv <slug> [--download] [-o file.pdf]

参数	类型	必填	说明
slug	string	是	ai（AI Lead 简历）或 web3（AI 与 Web3 简历，用于 Web3 相关问题）
locale	en · zh · zh-hant · ja · fr · es · eo	否	翻译字段的语言（默认 en）。

curl -s "https://jenksguo.pages.dev/api/v1/cv/xero-developer-evangelist"

list_arguments — 列出支持 Jenks 的论点

按能力罗列支持 Jenks 的论点——AI transformation、agentic systems、leadership、enterprise integration、DevRel、Web3 partnerships 与跨项目技术项目领导——每条含主张、限定与强度。

• MCP: list_arguments 于 https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/arguments?locale=
• CLI: jenks argue

参数	类型	必填	说明
locale	en · zh · zh-hant · ja · fr · es · eo	否	翻译字段的语言（默认 en）。

curl -s "https://jenksguo.pages.dev/api/v1/arguments"

get_argument — 获取单条论点及异议

按 slug 获取一条论点：形式化论证（前提 → 结论）、带数据的证据（条目 slug）、带来源的市场统计、真实边界、公允异议与答复、谬误式攻击（形式与非形式）及回应、以及何时该论点不适用。用于检验 Jenks 的契合度，而不只是推介。

• MCP: get_argument 于 https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/arguments/{slug}?locale=
• CLI: jenks argue <slug>

参数	类型	必填	说明
slug	string	是	ai-transformation、agentic-systems、leadership、enterprise-integration、devrel、web3-partnerships 或 technical-program-leadership
locale	en · zh · zh-hant · ja · fr · es · eo	否	翻译字段的语言（默认 en）。

curl -s "https://jenksguo.pages.dev/api/v1/arguments/xero-developer-evangelist"

ask_jenks — 询问 Jenks 助手

以自然语言向 Ask Jenks 助手提问（岗位匹配、咨询范围界定、AI transformation 建议、STAR 故事、治理……）。它会在语料上调用自有工具，并用请求的语言作答。有频率限制。

• MCP: ask_jenks 于 https://jenksguo.pages.dev/mcp
• REST: POST /api/v1/ask
• CLI: jenks ask "<question>"

参数	类型	必填	说明
question	string	是
locale	en · zh · zh-hant · ja · fr · es · eo	否	翻译字段的语言（默认 en）。
history	array	否	可选的对话历史。

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_whoami — 身份信息

检查你的凭证：你是谁（SSO 邮箱或 agent token 名）、你的作用域、token 过期时间，以及是否已配置发布（GitHub）。

• MCP: admin_whoami 于 https://jenksguo.pages.dev/mcp/admin
• REST: GET /api/admin/whoami（agent token）
• 作用域：read
• CLI: jenks admin whoami

无参数。

curl -s "https://jenksguo.pages.dev/api/admin/whoami" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

admin_audit_log — 审计日志

最近的管理操作，时间倒序：谁（SSO 邮箱或 agent token）、做了什么、涉及哪些文件、分支、主机与结果。agent token 仅能看到自身操作。

• MCP: admin_audit_log 于 https://jenksguo.pages.dev/mcp/admin
• REST: GET /api/admin/audit?limit=&token=（agent token）
• 作用域：read
• CLI: jenks admin audit [--limit 50]

参数	类型	必填	说明
limit	integer	否
token	string	否	仅查看此 agent token id（仅对人员）

curl -s "https://jenksguo.pages.dev/api/admin/audit" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

admin_schema — 内容架构

内容模型：条目字段与规则、标签、视角、类别、可写路径、文档，以及编辑约定。写入前请先阅读。

• MCP: admin_schema 于 https://jenksguo.pages.dev/mcp/admin
• REST: GET /api/admin/schema（agent token）
• 作用域：read
• CLI: jenks admin schema

无参数。

curl -s "https://jenksguo.pages.dev/api/admin/schema" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

admin_list_files — 列出内容文件

列出某分支上的可编辑内容文件（路径、大小、sha），可选限定在某文件夹，如 content/corpus/experiences。

• MCP: admin_list_files 于 https://jenksguo.pages.dev/mcp/admin
• REST: GET /api/admin/files?dir=&branch=（agent token）
• 作用域：read
• CLI: jenks admin ls [dir]

参数	类型	必填	说明
dir	string	否	如 content/corpus/projects（默认：全部内容）
branch	main · dev	否	main 发布到线上站点（jenksguo.pages.dev 及其镜像 jenksguo.xyz）；dev 预览到 dev.jenksguo.xyz（默认 main）。

curl -s "https://jenksguo.pages.dev/api/admin/files" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

admin_read_file — 读取内容文件

读取内容文件的原始 Markdown/JSON 源（含其 sha）。传入 path，或通过 slug 指定某条经历、视角或技能。

• MCP: admin_read_file 于 https://jenksguo.pages.dev/mcp/admin
• REST: GET /api/admin/file?path=&slug=&branch=（agent token）
• 作用域：read
• CLI: jenks admin get <slug|path>

参数	类型	必填	说明
path	string	否
slug	string	否
branch	main · dev	否	main 发布到线上站点（jenksguo.pages.dev 及其镜像 jenksguo.xyz）；dev 预览到 dev.jenksguo.xyz（默认 main）。

curl -s "https://jenksguo.pages.dev/api/admin/file" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

admin_validate — 校验变更

在不提交的情况下，将文件内容按内容架构校验。返回问题列表（空列表即为有效）。

• MCP: admin_validate 于 https://jenksguo.pages.dev/mcp/admin
• REST: POST /api/admin/validate（agent token）
• 作用域：read
• CLI: jenks admin validate <path> <file>

参数	类型	必填	说明
path	string	是
content	string	是

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 — 创建或更新内容文件

校验并提交单个内容文件（创建或替换）。发布自动完成：CI 会将变更的条目重新翻译为所有语言，重建并部署（main → jenksguo.pages.dev 与 jenksguo.xyz，dev → dev.jenksguo.xyz），数分钟内生效。

• MCP: admin_write_file 于 https://jenksguo.pages.dev/mcp/admin
• REST: PUT /api/admin/file（agent token）
• 作用域：content（分支为 main 还需 publish）
• CLI: jenks admin put <path> <file> -m <message>

参数	类型	必填	说明
path	string	是
content	string	是
message	string	是	提交信息
branch	main · dev	否	main 发布到线上站点（jenksguo.pages.dev 及其镜像 jenksguo.xyz）；dev 预览到 dev.jenksguo.xyz（默认 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 — 删除内容文件

删除单个内容文件（如移除一条条目），并附带提交信息。Git 历史使其可恢复。

• MCP: admin_delete_file 于 https://jenksguo.pages.dev/mcp/admin
• REST: DELETE /api/admin/file?path=&message=&branch=（agent token）
• 作用域：content（分支为 main 还需 publish）
• CLI: jenks admin rm <path> -m <message>

参数	类型	必填	说明
path	string	是
message	string	是
branch	main · dev	否	main 发布到线上站点（jenksguo.pages.dev 及其镜像 jenksguo.xyz）；dev 预览到 dev.jenksguo.xyz（默认 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 — 一次提交多个文件

将多条文件变更作为一次提交进行校验与提交。每条变更为 {path, content} 或 {path, delete: true}。

• MCP: admin_commit_changes 于 https://jenksguo.pages.dev/mcp/admin
• REST: POST /api/admin/changes（agent token）
• 作用域：content（分支为 main 还需 publish）
• CLI: jenks admin commit <changes.json> -m <message>

参数	类型	必填	说明
changes	array	是
message	string	是
branch	main · dev	否	main 发布到线上站点（jenksguo.pages.dev 及其镜像 jenksguo.xyz）；dev 预览到 dev.jenksguo.xyz（默认 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 — 使用 AI 拟稿修改

让站点模型按一条英文指令重写某个内容文件。返回建议内容、diff 与校验问题。不提交——请审阅后再调用 admin_write_file。

• MCP: admin_ai_edit 于 https://jenksguo.pages.dev/mcp/admin
• REST: POST /api/admin/ai-edit（agent token）
• 作用域：content
• CLI: jenks admin ai-edit <slug|path> "<instruction>" [--apply]

参数	类型	必填	说明
path	string	否
slug	string	否
instruction	string	是
branch	main · dev	否	main 发布到线上站点（jenksguo.pages.dev 及其镜像 jenksguo.xyz）；dev 预览到 dev.jenksguo.xyz（默认 main）。
content	string	否	可选：基于未保存的文件文本进行拟稿（默认：已保存文件）。

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 — 读取翻译

读取某内容文件在另一种语言下的文本：英文源字段、当前翻译与其状态（最新、过期、手工编辑、缺失）。适用于条目、视角、简历、论点、观点页面、credentials、talks 与文档。支持语言：zh、zh-hant、ja、fr、es、eo。

• MCP: admin_read_translation 于 https://jenksguo.pages.dev/mcp/admin
• REST: GET /api/admin/translation?path=&slug=&locale=&branch=（agent token）
• 作用域：read
• CLI: jenks admin tr get <slug|path> <locale>

参数	类型	必填	说明
path	string	否
slug	string	否
locale	zh · zh-hant · ja · fr · es · eo	是
branch	main · dev	否	main 发布到线上站点（jenksguo.pages.dev 及其镜像 jenksguo.xyz）；dev 预览到 dev.jenksguo.xyz（默认 main）。

curl -s "https://jenksguo.pages.dev/api/admin/translation" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

admin_write_translation — 编辑翻译

写入某内容文件在另一种语言（zh、zh-hant、ja、fr、es、eo）下的文本——例如改进中文摘要。仅提供需要修改的字段；请先用 admin_read_translation 获取字段名。Markdown 必须保留英文标题、代码块与链接。该编辑会被保留，直至英文发生变更；随后该语言会自动重新翻译。英文为源：如需修改英文，请用 admin_write_file。

• MCP: admin_write_translation 于 https://jenksguo.pages.dev/mcp/admin
• REST: PUT /api/admin/translation（agent token）
• 作用域：content（分支为 main 还需 publish）
• CLI: jenks admin tr put <slug|path> <locale> <fields.json> -m <message>

参数	类型	必填	说明
path	string	否
slug	string	否
locale	zh · zh-hant · ja · fr · es · eo	是
fields	object	是	如 {"summary": "…", "body": "## …"}
message	string	否	提交信息
branch	main · dev	否	main 发布到线上站点（jenksguo.pages.dev 及其镜像 jenksguo.xyz）；dev 预览到 dev.jenksguo.xyz（默认 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 — 读取站点文案

读取站点在某种语言下的界面文案——菜单、页面标题、单行页面引言、首屏标题、按钮、SEO 描述——以 key → 文本形式，旁带英文（zh-hant 还附中文）。可用前缀过滤，如 hero 或 career。

• MCP: admin_read_copy 于 https://jenksguo.pages.dev/mcp/admin
• REST: GET /api/admin/copy?locale=&prefix=&branch=（agent token）
• 作用域：read
• CLI: jenks admin copy get <locale> [prefix]

参数	类型	必填	说明
locale	en · zh · zh-hant · ja · fr · es · eo	是
prefix	string	否
branch	main · dev	否	main 发布到线上站点（jenksguo.pages.dev 及其镜像 jenksguo.xyz）；dev 预览到 dev.jenksguo.xyz（默认 main）。

curl -s "https://jenksguo.pages.dev/api/admin/copy" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

admin_write_copy — 编辑站点文案

修改某种语言下的界面文案：values 为 key → 文本（"" 清除你的编辑）。en 与 zh 为人工撰写的源：英文变更会自动翻译到 ja、fr、es 与 eo——同时也请设置 zh。其他语言的编辑将被保留，直到其源文本发生变更。请严格保留 {placeholders}。

• MCP: admin_write_copy 于 https://jenksguo.pages.dev/mcp/admin
• REST: PUT /api/admin/copy（agent token）
• 作用域：content（分支为 main 还需 publish）
• CLI: jenks admin copy set <locale> <key> "<text>" -m <message>

参数	类型	必填	说明
locale	en · zh · zh-hant · ja · fr · es · eo	是
values	object	是	如 {"hero.sub": "…"}
message	string	否
branch	main · dev	否	main 发布到线上站点（jenksguo.pages.dev 及其镜像 jenksguo.xyz）；dev 预览到 dev.jenksguo.xyz（默认 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 — 部署状态

最近的 CI 运行（translate → build → deploy），包含状态、分支、提交与链接。

• MCP: admin_deploy_status 于 https://jenksguo.pages.dev/mcp/admin
• REST: GET /api/admin/deploys?branch=（agent token）
• 作用域：read
• CLI: jenks admin deploys

参数	类型	必填	说明
branch	main · dev	否	main 发布到线上站点（jenksguo.pages.dev 及其镜像 jenksguo.xyz）；dev 预览到 dev.jenksguo.xyz（默认 main）。

curl -s "https://jenksguo.pages.dev/api/admin/deploys" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

admin_promote — 将 dev 提升到生产

将 dev 分支合并到 main，把已在 dev.jenksguo.xyz 预览的内容发布到线上站点（jenksguo.pages.dev 与 jenksguo.xyz）。

• MCP: admin_promote 于 https://jenksguo.pages.dev/mcp/admin
• REST: POST /api/admin/promote（agent token）
• 作用域：publish
• CLI: jenks admin promote

参数	类型	必填	说明
message	string	否

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 — 发布新简历版本

为某份简历（ai、web3 或新 slug）上传新 PDF，并一步设为当前版本：PDF 存入媒体库，先前版本移入该简历的历史（仍可下载），并提交变更（CI 发布）。可选上传预览图与新标题/摘要。稳定链接 /cv/.pdf 将服务于新文件。

• MCP: admin_publish_cv 于 https://jenksguo.pages.dev/mcp/admin
• REST: POST /api/admin/cv（agent token）
• 作用域：content + media（分支为 main 还需 publish）
• CLI: jenks admin cv publish <slug> <file.pdf> --cv-version 2026.10 [--preview /media/…]

参数	类型	必填	说明
slug	string	是	ai、web3，或新的 kebab-case 标识
version	string	是	如 2026.10
filename	string	否
data	string	否	PDF 字节，base64
url	string	否	data 的替代：PDF 的 https URL
preview	string	否	可选：已上传的 /media/… 的第 1 页图片
title	string	否
summary	string	否
message	string	否	提交信息
branch	main · dev	否	main 发布到线上站点（jenksguo.pages.dev 及其镜像 jenksguo.xyz）；dev 预览到 dev.jenksguo.xyz（默认 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 — 列出媒体

列出已上传的图片、视频与 PDF（时间倒序）：url、类型、大小、尺寸、alt 文本、可直接粘贴的 Markdown，以及每个文件被哪些条目使用。

• MCP: admin_list_media 于 https://jenksguo.pages.dev/mcp/admin
• REST: GET /api/admin/media?prefix=&cursor=&limit=（agent token）
• 作用域：read
• CLI: jenks admin media ls [prefix]

参数	类型	必填	说明
prefix	string	否	键前缀，如 2026/10
cursor	string	否
limit	integer	否

curl -s "https://jenksguo.pages.dev/api/admin/media" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

admin_upload_media — 上传媒体

存储图片（webp、jpg、png、gif、avif、svg）、视频（mp4、webm）或 PDF，大小至多 25 MB，存入 Cloudflare R2，并获得其公共 /media/… url 与 Markdown。通过带 filename 的 base64 data 发送，或提供公共 https url 以导入。文件一经上传即通过 URL 公共可见；可通过 admin_write_file 在内容中引用。REST 端点亦支持 multipart/form-data（字段 file）。

• MCP: admin_upload_media 于 https://jenksguo.pages.dev/mcp/admin
• REST: POST /api/admin/media（agent token）
• 作用域：media
• CLI: jenks admin media upload <file|https-url> [--alt "…"]

参数	类型	必填	说明
filename	string	否	原始文件名；将成为 URL 的可读部分。
data	string	否	文件字节，base64（允许 data: URL 前缀）。
url	string	否	data 的替代：由服务器下载的 https URL。
alt	string	否	Alt 文本：图像所示内容，供读屏与机器人使用。
width	integer	否
height	integer	否

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 — 更新媒体 alt 文本

修改已上传文件存储的 alt 文本（作为插入内容时的默认 alt）。

• MCP: admin_update_media 于 https://jenksguo.pages.dev/mcp/admin
• REST: PATCH /api/admin/media（agent token）
• 作用域：media
• CLI: jenks admin media alt <key> "<alt text>"

参数	类型	必填	说明
key	string	是	媒体键或 url，如 2026/10/xero-talk-1a2b3c4d5e.webp
alt	string	是

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 — 删除媒体

永久删除已上传文件。在已发布内容仍引用该文件时会被拒绝，除非设置 force 为 true。不可恢复——与内容文件不同，这里没有 git 历史。

• MCP: admin_delete_media 于 https://jenksguo.pages.dev/mcp/admin
• REST: DELETE /api/admin/media?key=&force=（agent token）
• 作用域：media
• CLI: jenks admin media rm <key> [--force]

参数	类型	必填	说明
key	string	是
force	boolean	否

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>"}'