文档 / reference
数据模型
支持网站、机器人和 API 的内容文件：条目、视角、技能、文档和标签。
文件
| 内容 | 路径 |
|---|---|
| 经验条目 | content/corpus/experiences/<slug>.md |
| 教育条目 | content/corpus/education/<slug>.md |
| 社区条目 | content/corpus/community/<slug>.md |
| 项目条目 | content/corpus/projects/<slug>.md |
| 角色视角 | content/corpus/lenses/<slug>.md |
| 机器人技能 | content/corpus/skills/<name>.md |
简历（listed: false 可隐藏） |
content/corpus/resumes/<slug>.md |
| 论点 | content/corpus/arguments/<slug>.md |
| 观点 | content/corpus/views/<slug>.md |
| 翻译（AI 协助，可编辑） | content/corpus/i18n/<locale>.json, content/docs/i18n/<locale>.json |
| 站点文案编辑（菜单、标题、简介） | content/site/copy.json（优先于 web/lib/content.ts） |
| 个人资料文档 | content/corpus/profile.md |
| 资质凭证文档 | content/corpus/credentials.md |
| 能力文档 | content/corpus/capabilities.md |
| 演讲与写作文档 | content/corpus/talks-and-writing.md |
| 思考文档 | content/corpus/thinking.md |
| 翻译术语表 | content/corpus/i18n/glossary.json |
| 文档 | content/docs/{tutorials,how-to,explanation}/<slug>.md |
条目前置元数据
| 字段 | 规则 |
|---|---|
slug |
短横线命名 id；必须与文件名相同（content/corpus/ |
kind |
取值为 experience、education、community、project 之一 |
title |
官方岗位或项目标题（职位名称在任何语言环境中都保持英文） |
org |
机构名称 |
orgUrl |
可选 https URL |
location |
可选 |
start |
YYYY-MM |
end |
YYYY-MM 或 'present' |
period |
可选显示标签，覆盖 start/end（例如 '2010 — 2011'） |
approx |
可选布尔值：日期为近似值（按年份显示） |
tags |
行业标签：it, engineering, ai, devrel, web3, business, marketing, consulting, hospitality, community, creative |
lenses |
角色视角（见 GET /api/admin/schema → lenses） |
skills |
技能/工具列表 |
metrics |
关键结果列表——简短、客观，已知处尽量包含数字 |
summary |
一句话摘要 |
featured |
可选布尔值：在主页显示 |
timeline |
可选布尔值（仅 projects）：也显示在职业时间线中 |
proof |
列表 { type: article|video|code|talk|paper|site, title, url? } —— url 为 https 或已上传的 /media/… 文件（例如 PDF） |
image |
可选封面图片：/media/…（通过 admin_upload_media 上传）或静态 /img/… 路径 |
imageAlt |
设置了 image 时必填 |
gallery |
可选列表 { src: /media/… 图像或视频, alt, caption? }，显示在条目页面上 |
body |
采用带 ## 小节的 Markdown：概览、Jenks 做了什么、成果、对雇主的重要性 |
标签
it · engineering · ai · devrel · web3 · business · marketing · consulting · hospitality · community · creative
角色视角
head-of-ai— 人工智能负责人ai-transformation-consultant— AI 转型engineering-manager— 工程经理solution-architect— 解决方案架构师system-integrator— 系统集成人员support-engineer— 支持工程师ict-specialist— ICT 专家developer-advocate— 开发者倡导者developer-evangelist— 开发者布道师digital-marketer— 数字营销人员hospitality— 酒店业
语言
源语言为英语。CI 会翻译为 zh、zh-hant、ja、fr、es、eo（AI 协助、哈希缓存，并为标题和角色名称使用固定术语表）。正式职位名称始终保留英文。
.md本页内容在 AI 协助下翻译；官方职位名称保留英文。