使用 AI 更新内容

四种入口，一套规则

所有管理端编辑都通过同一个 admin API。人类通过 Google（Cloudflare Access）登录控制台；代理和脚本使用你在控制台中创建的服务令牌——参见 Give an AI agent access。按需选择最合适的方式：

界面	最适合
控制台 https://admin.jenksguo.xyz/admin	手动编辑：带表单字段、媒体库、变更差异和预览的可视化编辑器
CLI jenks admin …	通过终端或脚本快速编辑
Admin MCP（/mcp/admin 或 jenks mcp --admin）	让 AI 代理（如 Claude Code）代劳
REST /api/admin/*	自主自动化

每次写入都会按内容模式进行校验并提交到 git。随后 CI 会将变更条目重新翻译成所有语言、重建并部署。若你要自行撰写另一种语言——无论是翻译还是界面文案——请参见 Edit the site in any language。

加载令牌

使用具备 content 范围的代理令牌（jgx_agt_…），如果需要直接写入线上站点，再加上 publish：

export JENKSGUO_ADMIN_TOKEN=jgx_agt_…   # from your Keychain or password manager
jenks admin whoami                      # shows the token's name, scopes and expiry

写之前先读取

jenks admin schema                         # fields, tags, lenses, writable paths
jenks admin ls content/corpus/experiences  # files and their sha
jenks admin get linktree-partner-solutions-lead

先校验，再写入

在本地编辑文件、校验，然后提交：

jenks admin get linktree-partner-solutions-lead > linktree.md
# …edit linktree.md…
jenks admin validate content/corpus/experiences/linktree-partner-solutions-lead.md linktree.md
jenks admin put content/corpus/experiences/linktree-partner-solutions-lead.md linktree.md \
  -m "Linktree: add developer portal launch detail" --branch dev

未通过校验的写入会被拒绝，因此错误修改不会破坏构建。

让 AI 起草

jenks admin ai-edit tooronga-toastmasters "correct the period to 2019 — 2021" --branch dev
jenks admin ai-edit tooronga-toastmasters "correct the period to 2019 — 2021" --branch dev --apply

第一次调用会返回提案、差异以及任何校验问题。第二次则提交变更。

在一次提交中修改多个文件

使用 admin_commit_changes（MCP）或结合 JSON 文件的 jenks admin commit：

{
  "changes": [
    { "path": "content/corpus/community/murrumbeena-school-council.md", "content": "---\n…" },
    { "path": "content/corpus/capabilities.md", "content": "…" }
  ]
}

jenks admin commit changes.json -m "School council: confirm dates" --branch dev

如需删除文件，使用 { "path": "…", "delete": true }。

让代理来完成

当 admin MCP 服务器已连接时，直接用自然语言指示代理，例如：

阅读模式。将 Virginia Park Childcare 条目的时间段更新为 2019 — 2024。校验它，用清晰的信息提交到 dev，然后把部署状态发给我。

一个行为规范的代理会按顺序调用 admin_schema、admin_read_file、admin_validate、 admin_write_file 和 admin_deploy_status。

值得坚持的规则

• 使用 dev 处理任何非琐碎的变更，先检查 https://dev.jenksguo.xyz，再晋级。参见 Preview and promote。
• 只写事实。内容会被 Ask Jenks 助手当作真相来源。不要让 AI 添加你无法证实的数字、头衔或主张。
• 切勿在内容中放入机密——包括令牌、电话号码、家庭住址或推荐人信息。content/ 下的一切都是公开的。
• 用英文撰写。其余六种语言由 CI 自动生成翻译；content/corpus/i18n/glossary.json 中的术语表可固定标题和镜头名称。
• 撤销只需一次提交。Git 历史会保留每个版本。