使用 AI 更新内容

四种入口，一套规则

所有管理修改都会通过同一套管理 API，并由你的个人令牌进行保护（Keychain 中的 agent-env:JENKSGUO_ADMIN_TOKEN）。按需选择最合适的方式：

界面	最适合
位于 https://jenksguo.xyz/admin 的控制台	手动浏览和编辑，带实时预览
CLI jenks admin …	通过终端或脚本进行快速编辑
管理 MCP (/mcp/admin 或 jenks mcp --admin)	让 AI 代理（如 Claude Code）来完成工作
REST /api/admin/*	自定义自动化

每次写入都会依据内容模式进行校验，并提交到 git。随后 CI 会将变更条目重新翻译为所有语言，重建并部署。

加载令牌

export JENKSGUO_ADMIN_TOKEN="$(security find-generic-password -s agent-env:JENKSGUO_ADMIN_TOKEN -w)"
jenks admin whoami

写入前先读取

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 }。

让代理来完成

连接上管理 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，再进行晋级。参见 预览与晋级。
• 只写事实。内容会供 Ask Jenks 助手使用，并被视为真实。不要让 AI 添加入无法证实的数字、头衔或主张。
• 切勿在内容中放入机密信息——不要包含令牌、电话号码、住址或推荐人信息。content/ 下的所有内容都是公开的。
• 用英文撰写。其他六种语言的翻译由 CI 生成；content/corpus/i18n/glossary.json 中的术语表会固定标题和视角名称。
• 撤销只需一次提交。Git 历史会保留每个版本。