Agent 远程改稿

端点

客户端用 Streamable HTTP 连到这个地址，请求头带个人令牌。和 Obsidian 同步共用同一类 folio_ 令牌。

个人令牌

完整字符串只出现一次。远程 Agent 必须把它放在 Authorization 头里。

工具

Agent 可列出、读取、推送、改权限、进回收站、上传图片。

• whoami

  当前令牌对应的用户、角色，以及站点栏目列表。

• list_posts

  列出当前用户可管理的文章（作者看自己的，编辑/管理员看全部）。

• get_post

  按 slug 或数字 id 读取完整 Markdown（含 YAML 头信息）。

• search_posts

  在可管理文章的标题、摘要、别名中搜索。

• publish_post

  用 Markdown 发布或更新文章。同一 slug 再次推送会覆盖并留下版本。YAML 头可含 title、slug、topic、tags、status、access（public|early|paid）、exclusiveDays、cover、excerpt。status 缺省为 published。

• update_post

  按 slug 局部更新标题、正文、栏目、标签、状态或阅读权限，不必重传全文。

• set_post_status

  把文章设为已发布或草稿。

• delete_post

  把文章移入回收站（软删除）。

• restore_post

  从回收站恢复文章。

• list_topics

  列出站点栏目，写文章时 topic 必须是其中之一。

• list_revisions

  列出一篇文章最近的版本快照。

• upload_image

  上传封面或正文配图。传入文件名和 Base64（可带 data: 前缀）。返回站点相对路径与绝对 URL。

推送格式

调用 publish_post 时传入完整 Markdown。同一 slug 再次推送会覆盖并留下版本。

1---2title: 从 Agent 推送的判别联合3slug: ts-unions-from-agent4topic: TypeScript5tags:6  - TypeScript7  - 类型系统8status: published9access: public10---11 12正文从这里开始。代码围栏写清语言和文件名：13 14```ts:src/lib/parse.ts {3}15export type Result = { ok: true; value: string } | { ok: false; error: string };16 17export function parse(raw: string): Result {18  if (!raw.trim()) return { ok: false, error: "empty" };19  return { ok: true, value: raw.trim() };20}21```22