REST API

Base URL: https://jenksguo.pages.dev。默认返回 JSON；GET /api/v1/brief 返回 Markdown（发送 Accept: application/json 可获得 { markdown }）。机器可读规范： OpenAPI。

端点

方法	路径	工具	功能说明
GET	/api/v1/brief	get_brief	一页式 Jenks Guo Markdown 简介：定位、当前角色、职业轨迹、优势、语言、联系方式，以及如何进一步浏览。
GET	/api/v1/entries	list_experience	列出 Jenks 的经历、项目、社区角色与教育（按最新优先），可选按行业标签、角色视角或条目类型过滤。
GET	/api/v1/entries/{slug}	get_entry	某条经历、项目、社区角色或教育条目的完整长文（按 slug）：概述、Jenks 的工作、成就、对雇主的意义、关键结果、技能与证明链接。
GET	/api/v1/lenses	list_lenses	雇主可用于审视 Jenks 的角色视角（Head of AI、solution architect、developer advocate、digital marketer、hospitality…），含电梯陈述、真实差距与证据计数。
GET	/api/v1/search	search_jenks	跨所有条目与文档的关键词搜索。
GET	/api/v1/documents/{name}	get_document	Jenks 的参考文档之一：profile（核心档案）、credentials（教育、认证）、capabilities（能力 → 证据映射）、talks（演讲、播客、写作）、thinking（观点：七个视角，以通俗语言与示例说明，并含更多信念）。
GET	/api/v1/cv	list_cvs	Jenks 可下载的简历（PDF）——AI Lead 简历——包括版本、日期、稳定 PDF url、下载 url、预览图与早期版本。
GET	/api/v1/cv/{slug}	get_cv	按 slug 获取单份简历：标题、摘要、版本、稳定 PDF url（始终指向当前版本，例如
GET	/api/v1/arguments	list_arguments	按能力列出支持 Jenks 的论点——AI transformation、agentic systems、leadership、enterprise integration、DevRel、Web3 partnerships 与跨项目技术项目领导——每条含主张、限定与力度。
GET	/api/v1/arguments/{slug}	get_argument	按 slug 获取一条论点：形式化论证（前提 → 结论）、含数据的证据（条目 slug）、带来源的市场统计、诚实边界、公正反对与回答、谬误攻击（形式与非形式）的回应，以及不适用情形。
POST	/api/v1/ask	ask_jenks	向 Ask Jenks 助手提出自然语言问题（岗位契合、咨询范围界定、AI 转型建议、STAR 故事、治理…）。
POST	/api/chat	—	网站小部件使用的流式聊天（纯文本流；events: true 夹杂 \u001e 状态行；voice: true 请求简短口播回复）。
POST	/api/transcribe	—	语音回退：转写 base64 音频。
POST	/api/speak	—	为小部件语音模式朗读文本：{ text, locale } → 音频（英语：Deepgram Aura-2 'theia'，澳大利亚女性音；其他语言：OpenRouter 音频模型）。
GET	/api/health	—	存活性与配置检查。
GET	/cv/{slug}.pdf	—	某份简历的当前版本 PDF（稳定链接；?download=1 直接下载）。/cv/{slug}/{version}.pdf 提供特定版本。
GET	/media/{key}	—	已上传的图片、视频与 PDF（R2）。不可变 url；支持 Range 与 If-None-Match。
GET	POST	/mcp	—

错误与限制

• 400 bad_request、404 not_found、429 rate_limited（ask：20/分钟/IP）、503（当未配置模型密钥时）。
• GET 端点发送 Access-Control-Allow-Origin: *；POST 端点供服务端代理使用。

get_brief — 获取 Jenks 简介

一页式 Jenks Guo Markdown 简介：定位、当前角色、职业轨迹、优势、语言、联系方式，以及如何进一步浏览。从这里开始。

• MCP: get_brief on 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 on 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 on https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/entries/{slug}?locale=
• CLI: jenks get <slug>

参数	类型	必填	说明
slug	字符串	是	条目 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 on 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 on https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/search?q=
• CLI: jenks search "<query>"

参数	类型	必填	说明
query	字符串	是

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

get_document — 获取文档

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

• MCP: get_document on 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 url、下载 url、预览图与早期版本。若需了解其 Web3 经验，可使用 get_cv 且 slug 为 web3 获取 AI 与 Web3 简历（此处不列出）。

• MCP: list_cvs on 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 url（始终为当前版本，例如 https://jenksguo.pages.dev/cv/ai.pdf）、下载 url 与所有版本。使用 ai 获取 AI Lead 简历；当被问及其 Web3 经验时，使用 web3 获取 AI 与 Web3 简历。

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

参数	类型	必填	说明
slug	字符串	是	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 on 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 on https://jenksguo.pages.dev/mcp
• REST: GET /api/v1/arguments/{slug}?locale=
• CLI: jenks argue <slug>

参数	类型	必填	说明
slug	字符串	是	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 转型建议、STAR 故事、治理…）。它会在语料上运行自有工具，并以请求的语言作答。有频率限制。

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

参数	类型	必填	说明
question	字符串	是
locale	en · zh · zh-hant · ja · fr · es · eo	否	翻译字段的语言（默认为 en）。
history	数组	否	可选先前对话轮次。

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