AIFA · MCP

AIFA 杂志系统 · MCP 操作说明

给人：把这个地址发给你的 Agent，它读完就知道怎么替你在 AIFA 编辑和运营。给 Agent：本页是速览、典型任务、本地 CLI 与方法索引；细节按需跳说明全文。

接入 Agent

接入 AIFA 杂志，用我的账号（授权页由我本人点同意）。按你能做到的，选下面第一条走得通的路；做完我就会看到 AIFA 授权页。
1. 你的终端就在我这台电脑上（本机有 Node）：运行
   npx -y https://afa5.chaos.callai.online/cli/aifa.tgz login
   它会打印授权链接，能开浏览器时自动打开；打不开就把链接原样发给我。
   写稿、排版、上传图片与配音都用这个 aifa 命令（把 login 换成 --help 看用法）。
   你在云端电脑上跑命令的话不要 login（授权完成后要跳回 127.0.0.1，我的浏览器连不到你那台机器）：请我在 https://afa5.chaos.callai.online/account/agents 点「签发令牌」，由我把令牌设成你那台机器的环境变量 AIFA_TOKEN（在你的密钥或环境设置里，不要让我贴进对话），再运行 npx -y https://afa5.chaos.callai.online/cli/aifa.tgz status 确认已连上。
2. 你能添加自定义 MCP 连接器（在设置里加，或在对话里自己加都算）：添加 https://afa5.chaos.callai.online/mcp
   （传输选 Streamable HTTP，鉴权选 OAuth 登录，不填密钥），马上连接；连接后直接弹出授权页，弹不出就把登录链接发给我。
   阅读、收藏、订单与管理后台都经这一个地址。
3. 以上都做不到，照实说是哪一种：
   - 连接器要我在界面里手动加：把第 2 条的地址发给我，说出你确定的添加位置；不确定就说「在设置里找连接器、插件或 MCP，新建自定义，类型 HTTP，粘贴这个地址」，不要编造菜单名。
   - 你的连接器只能填固定令牌或请求头，走不了 OAuth 登录：请我在 https://afa5.chaos.callai.online/account/agents 点「签发令牌」，选好档位与有效期，由我把令牌填进你的连接器设置（地址用第 2 条的，请求头 Authorization: Bearer 加令牌）。不要让我把令牌贴进对话。
   - 你完全接不了外部工具：告诉我接不了。能上网的话，可以帮我读 AIFA 的公开单篇，但动不了我的账号。
按我要做的事选：写稿排版走 1，阅读与后台走 2，两样都要就都接（授权页各点一次）；我没说要做什么，就先走你能走的第一条。
授权后按连接时下发的说明（或 aifa --help）做事，不必先读别的文档。

手动安装

Claude Codeclaude mcp add --transport http aifa-magazine https://afa5.chaos.callai.online/mcp && claude mcp login aifa-magazine

安装到 VS Code 安装到 Cursor 入口技能文件

只收固定令牌的连接器签发令牌

MCP 端点: https://afa5.chaos.callai.online/mcp
命令行: 15.0.0 · t91 · e3.17
完整说明: https://afa5.chaos.callai.online/mcp-guide

速览

AIFA 是一本中英双语杂志，也是它自己的内容系统，经 MCP 开放给你。你替某个 AIFA 账号做事，本页把它叫绑定账号：它做得到的你都做得到，你的每一处改动都记在它名下。

一、开工自查两条

调 permissions.retrieve：核对 principal 是用户要你代表的那个账号；能不能做一件事只看 capabilities。
tools/list 列出令牌够得着的工具（作者档能调 233 个方法，全部档另含后台）；按一句话找方法用 aifa_find，完整入参与示例用 aifa_describe。仍调不动才是档位或角色不够：请用户在网站「我的 → Agent」重新授权。

二、通用规矩（各工具的说明不再重复）

先读后写，带版本号。写回时把读到的版本号作 expectedVersion 传（入参里没有这一项的工具不传，严格入参会拒）；返回 409 就重新读、保留对方的改动再写，不要只换版本号原样重发。
读工具分段取。offset 从 0 起，limit 不传就按约 100KB 的返回上限自己收；page.hasMore 为真就拿 nextOffset 接着取，page.cappedBy 是 "bytes" 表示被上限截短、不是到头；回 nextCursor 的工具把它传回 cursor。
需确认的动作不由你完成。这类工具只发起请求、不改动线上，返回体第一项是 confirmUrl（带 needsConfirm: true）：把链接交给有权限的人，不要自己打开，不向任何人索要验证码；他确认后才执行，结果用 aifa_confirm_read 取。哪些工具在这一档，见索引的「需确认」一列。
入参以工具清单发来的 schema 为准，对象入参也接受 JSON 字符串；字段规则匿名读 https://afa5.chaos.callai.online/mcp-guide/schema；块写成 class + variant，五类 26 个变体的写法见块技能 aifa-block-<变体>。
返回里单篇、合集、块、账号另带短编号 articleNo、collectionNo、blockNo（容器号-序号）、userNo；canonicalUrl 是正式链接（站内路径，如 /u12/a34）。
读者可见短字段有长度上限（中/英；中文按字宽、拉丁字母与数字算半字，英文按字符）：合集名 12/32、合集副题 20/60、封面导语 40/120、单篇标题 18/46、作者名 6/20、作者头衔 12/24、作者简介 45/110。超长照收，回执 lengthHints 提醒；发布检查只拦合集副题与封面导语。

三、再往下读什么

要什么	去哪里
按任务找方法	本页的方法索引，共 293 个
怎么写一篇 AIFA 的单篇、版面怎么排	有可用技能：`aifa_skill` 列出，写稿先读必读 `aifa-author/SKILL.md`，不自动送达
连接细节、报错、保留范围项、要人确认的事、汇报	说明全文：整页很长，查问题时按节取，写一篇不必读
让另一个全新的 Agent 接入	入口技能文件，一页讲完连接与该取哪个技能包

说明页的地址后面加 .md 就是纯文本版，都不需要登录。与工具自己的说明不一致时，以工具的为准。

典型任务（最短流程）

读一篇：articles.search 按标题找（自己的稿用 articles.list）→ articles.text 给 articleId，按页分段回纯文本。要页文件与版本号用 aifa_pull。
写一篇并发布：aifa_skill 取必读 aifa-author/SKILL.md → articles.create 建稿 → uploads.create 传素材 → aifa_push 一批写入，照回执改到不超行 → articles.pages.render 桌面与手机各看一张，articles.check 阻断项改到零 → articles.preview_links.create 给用户预览 → articles.publish，看 display：live 已上线，pending 进了运营审核；读者直链是回执的 readerUrl。
改已上线的一篇（含补英文）：aifa_pull 取索引与要改那一页的页文件 → 只改那一块 → aifa_push 带读到的 expectedVersion 写回 → articles.check → articles.publish。改的是修改稿，一律进运营审核（live_pending），通过前线上还是旧版；退回就改后重提，或 articles.discard_revision 放弃。
审待审的单篇、把一篇下线（全部档，运营角色）：review_items.retrieve / moderation_items.list（facet=queue）取队列 → review_items.update 通过、退回或下线，items 一次可放多篇。不生成确认链接，你可以独立完成。

处置留言：comments.list → comments.update。编合集从 collections.create 起。别的按方法索引找。

还没连上：连接三步

把 MCP 端点 https://afa5.chaos.callai.online/mcp 加进客户端，传输方式 Streamable HTTP，不填任何密钥。Claude Code：claude mcp add --transport http aifa-magazine https://afa5.chaos.callai.online/mcp。这是唯一的入口，读者、作者与后台都连它，授权一次即可。你无权改客户端配置时，把端点交给用户在 MCP 或「连接器」设置里添加。
客户端连上即给出授权链接（Claude Code 用 claude mcp login 或 /mcp 点 Authenticate）。请用户本人登录、选档位（读者档 reader 只替读者办事，作者档 author 只含创作面，全部档 full，含管理后台，要绑定账号本身是运营（含客服工单）或管理员（另含计费、账号与授权））、点同意。这一步你替不了：同意页只认网页登录会话；改邮箱、付款、授权管理、绑定验证器要用户勾过对应范围项，缺了回 403 reserved_scope_missing。
拿到令牌后每次调用带 Authorization: Bearer <访问令牌>，刷新由客户端管。要自己实现 OAuth 2.1 授权码 + PKCE，读说明全文的「三、连接与身份」。

本地 CLI

有命令行、本机有 Node 22+ 的 Agent 可以用本地构建工具 aifa：在本机写稿，用与网站同一套排版引擎校验、预览、出图，再一次批量写回。写回的与 aifa_push 是同一批文件。它只处理登录账号自己的稿，别人的稿用 MCP 或网站；只能聊天或在远端沙箱里的 Agent 照常走 MCP。安装包：https://afa5.chaos.callai.online/cli/aifa.tgz。

npm i -g https://afa5.chaos.callai.online/cli/aifa.tgz   # 安装；不装也行：npx --yes https://afa5.chaos.callai.online/cli/aifa.tgz <命令>
aifa login --site https://afa5.chaos.callai.online   # 用户登录后点同意一次；--no-open 只打印授权地址
aifa pull <单篇 id>   # 或 aifa new <标题> [--source en]，再 cd 进单篇包目录
aifa check && aifa preview && aifa push && aifa articles publish <单篇 id>

一级命令（文件三步、发布六动作、本机能力）

aifa map [--json]
    # 打印能力地图（同 MCP aifa_map）：先教文件四步 pull → 改 → check → push，再列资源与方法数
aifa find <一句话> [--limit <1-10>] [--json]
    # 按意图找规格方法（中英皆可，同 MCP aifa_find）：回最相关的几个方法 ID、说明与 CLI 写法；接着 aifa describe <方法> 看入参
aifa pull <单篇 id> [--dir <目录>] [--stdout] [--live|--reader] | pull --reader --collection <合集 id> [--dir <目录>] [--stdout] | pull <单篇 id> --original <rs_…|st_…>
    # 取回整篇（同 MCP aifa_pull）：落成本机单篇包，在单篇包里不带 id 跑即拉取合并；--stdout 不落目录，印出文本包（改完 check --stdin、push --stdin）；--live 取线上版、--reader 取读者那一份（别人的已发布稿也行，付费未解锁的块只有封面），两者只读；--reader --collection 取一本已发布合集整本；--original 印出某次提交交上来的原稿
aifa check [--remote] [--json] [--publish] | check --stdin <单篇 id>
    # 只校验不落盘：本地先按写入同一套规则校验并测量；--remote 把 push 会交的那一批交 aifa_check（网站走真写同一条路、不落盘），与本地结论逐块比；--publish 按发布结论退出（有发布拦截项退出 1，每条拦截带改法）；--stdin 收 pull --stdout 的文本包交 aifa_check、印网站回执
aifa push [--json] | push --stdin <单篇 id>
    # 一次提交（同 MCP aifa_push）：素材一批直传、作品包逐个上传，新稿先建稿，整批文件经 aifa_push 全成全败、产生一步，打印网站回执、与本地回执的逐块差异、预览链接；--stdin 收 pull --stdout 的文本包一次提交、印网站回执
aifa submit [<单篇 id>] [--skip-capacity-check] [--expected-version <n>] [--json]
    # 把工作稿交运营审核（未认证作者的首次发布与修改稿走这条）
aifa publish [<单篇 id>] [--skip-capacity-check] [--expected-version <n>] [--json]
    # 发布网站上的工作稿：已认证作者直接上线，未认证进运营审核，修改稿一律进审；块高没量成时被拒，持全部范围写权限的账号可带 --skip-capacity-check
aifa unpublish [<单篇 id>] [--note <原因>] [--expected-version <n>] [--json]
    # 下线自己已发布的单篇（再 publish 即重新上线）
aifa request-revision [<单篇 id>] [--expected-version <n>] [--json]
    # 已发布单篇申请修改：开一份修改稿，线上继续是旧版，改完 publish 进审
aifa discard-revision [<单篇 id>] [--expected-version <n>] [--json]
    # 放弃修改：修改稿整篇回到线上那一版，线上不动
aifa withdraw [<单篇 id>] [--expected-version <n>] [--json]
    # 撤回审核中的候选，回到工作稿
aifa new <标题> [--source <语种>] [--title.<语种> <标题>…] [--dir <目录>]
    # 在本地建一个空单篇包（正文一个对页 new-a、new-b）；<标题> 写进原文那一格，--source 声明原文语种（zh、en），其他语种的标题用 --title.<语种> 各给一格；第一次 push 时建稿
aifa preview [--port <端口>] [--no-open]
    # 本地预览页：PC 对页 / 手机、夜览、中英，改文件自动刷新
aifa render <页…> [--device mobile] [--lang zh|en] [--dark] [--screen 1440x900] [--blocks] [--out <目录>] [--json] | render --canvas <画面.html> [--width full|half] [--rows <行>] [--label] [--sources]
    # 本地出 PNG（p1 是封面；不带 --lang 出原文语种那一份）；--canvas 把一个画面文件放进真实版面试排
aifa upload <文件或作品包目录…> [--target asset|drive] [--rightsNote.<语种> …] [--aiGenerated] [--tags a,b] [--json]
    # 上传本机图片、视频、音频或作品包目录（打成 zip），打印资源 id：素材库的文件一批直传，网盘文件与作品包走上传凭证再入库；在单篇包里记下，push 不重传
aifa voice <音频文件> [--lang zh|en] [--timeline <时间轴.json>] [--duration <秒>] [--json]
    # 上传本机配音并登记进音频库，音频与逐段时间轴（该语言那条轨）直接写进网站上这篇的单篇设置；时间轴点名的块要在本地 article.<语种>.md 里；新稿先 aifa push 再跑
aifa snapshot [--dir <目录>] [--include published,own,meta] [--since [<时刻>]] [--languages zh,en] | snapshot --dir <目录> --query <SQL> [--json]
    # 按身份导出只读快照落本机（缺省 ./aifa-snapshot/）：published/ 读得到的已发布稿（付费未解锁的块只有封面）、own/ 自己的稿、index.json 与 index.sqlite（articles、blocks、collections 三表加 blocks_fts 全文检索）；--since 增量；--query 在本机索引库上跑只读 SQL；快照只读，里面不能 push
aifa skills sync [--dir <目录>] [--json]
    # 按技能包发布版本把本站分发的技能落到本机目录（缺省 ./aifa-skills），只写变了的文件，列出本次新增、变更、删除的文件；status、check、push 发现本机副本落后站点时提醒一行
aifa guide night-palette --colors '{"--名字":"#色值"}' | --file <画面.html> [--write] | --source <源码> | --input <文件|-> [--json]
    # 本机算自定义配色的夜览版本（与夜览配色契约同一个函数，不连站点）：--file 读画面源码，加 --write 把夜览那一段写回文件（重跑只换那一段）
aifa inbox [--types article.published,message.created] [--since <游标>] [--limit <n>] [--json] | inbox --listen [--exec "<命令>"] [--types …] [--since <游标>] [--json]
    # 拉一次本账号的事件（events.list）；--listen 常驻：挂本机专用的拉取目的地长等，每来一批先标 working（作者看到「Agent 正在处理」）再执行一次 --exec 命令（批 JSON 从标准输入给，instructions 单列作者的话），退出码 0 才确认（作者侧标已处理），非 0 退避后从这批开头重给；不给 --exec 打到标准输出
aifa channel
    # Claude Code 渠道插件（stdio MCP 服务端，声明 claude/channel）：作者在「我的 Agent」会话说的话以 notifications/claude/channel 推进正在运行的会话，Agent 用 reply 工具回话，回了哪条才标哪条已处理；回话前退出的再起时重推。登记：claude mcp add aifa -- aifa channel

账号与资源命令

aifa login [--site <地址>] [--scope author|full|reader] [--no-open] [--device [--login-hint <邮箱或主页短名>] [--name <Agent 名>]]
    # 打印授权地址并打开浏览器，人类登录后点同意一次（缺省作者档，15 天免登录）；一张令牌连单一入口 /mcp。没有浏览器回跳的机器用 --device：打印核对码，本人在官方 APP 或网页消息页批准（带 --login-hint 时接入卡直接推到本人「待处理」），批准后自动存令牌。云端电脑用环境变量 AIFA_TOKEN（用户在账号页签发的个人访问令牌），不用 login
aifa logout
    # 删本机令牌；网站上的授权在账号页吊销
aifa status
    # 当前站点登没登录、版本号、/mcp 开场说明的摘要；设了 AIFA_TOKEN 时报令牌的档位；在单篇包里另报改过哪些文件
aifa instructions [--json]
    # 打印 /mcp 连接时下发的开场说明全文（MCP instructions）
aifa version [--json]
    # CLI 版本、规格契约号与规格指纹、排版引擎版本
aifa tools [资源|关键词] [--json]
    # 每个规格方法一行：CLI 写法、读/写、是否需确认
aifa describe <方法 ID>
    # 一个方法的说明、入参、权限、错误与 CLI 写法（同 MCP aifa_describe）
aifa <资源…> <动词> [<路径参数…>] [--参数 值…] [--input 文件|-] [--json]
    # 如 aifa articles list --segment articles、aifa collections items create col_1 --article-id art_2
aifa call <方法 ID> [--input 文件|-] [--参数 值…] [--json]
    # 原始形式：按方法 ID 调，入参名与规格逐字相同

本机预览与出图用读者端同一套外框：电脑上封面封底固定 1:√2 独立一屏，手机封面铺满一屏，对页分左右页眉页脚。第一次出图会自动装一个无头浏览器（一百多 MB），只开预览页不需要。
aifa check --json（或 .aifa/receipt.json）的 elements 按块、按遍（pc636、phone 与中英）给浏览器读数，与 articles.pages.render 同一个采集：box 是块在页上的 [x, y, 宽, 高]；scroll 装不下时带 lastVisibleLine、lastVisibleText（读者在框里读到第几行、最后几个字）；images 看 loaded 与 bareEdge（露底）；fonts.fallbackGlyphs 为真是中文落到回落字形；画面块的 errors 是画面里的脚本错误、console.error 与加载失败的资源，已归到出错的那一块。aifa render 画面判不过（与排版规则 R19 同一判据被裁，或首帧空白）退出码 1。
aifa push 先核对排版引擎版本，与网站不一致就当场停下、什么都不传，照提示重装一次安装包即可，本地单篇包不用动。推送成功后本地记录的版本号同步更新，不必再拉。
拉别人的稿会报「本地构建工具只处理登录账号自己的稿」；单篇 id 用 aifa articles list 查。发布、下线与修改稿是资源命令 aifa articles publish <单篇 id> 等。全部命令与参数见 aifa --help。

方法索引（293）

开场工具（11）

连上 /mcp 后 tools/list 只给这几个工具：写稿改稿走文件三步 aifa_pull → aifa_check → aifa_push；其余能力先 aifa_find 按一句话找方法 ID，再 aifa_describe 看入参，最后 aifa_call_read 或 aifa_call_write 调用。下面各表列的就是这些方法 ID。

工具	用途	读/写
`aifa_map`	Start here: the file workflow and what else AIFA can do.	读
`aifa_pull`	Get a whole article as an editable text pack.	读
`aifa_check`	Validate an edited text pack without saving; returns measurements.	读
`aifa_push`	Save an edited text pack in one batch; returns receipt.	写
`aifa_find`	Find other API methods by intent; returns method IDs.	读
`aifa_describe`	Get a method's params, permissions, flags, errors and CLI form.	读
`aifa_call_read`	Call any read-only API method by ID.	读
`aifa_call_write`	Call any write API method by ID; returns receipt.	写
`aifa_confirm_read`	Check a pending confirmation and its human approval link.	读
`aifa_skill`	Read a skill's metadata or a file from it.	读
`aifa_events`	Pull new events for your destination since a cursor.	读

先按域缩到一张表，再按「用途」挑一行。规格方法全集 293 个，全部经单一入口 /mcp 调用；你的令牌调得动的按档位与能力收窄，aifa_find 只回你调得动的。

「档位」是调用它至少需要哪一档授权（读者档 < 作者档 < 全部档，全部档另要绑定账号有后台角色）。每个方法的入参、返回体、权限与报错用 aifa_describe 当场取，本索引不重复。「需确认」是要人打开确认链接才执行的动作（见速览第四条规矩），「按入参」表示只有某些入参落进这一档。「读」指调用它不改任何数据，用 aifa_call_read；「写」指会改数据，用 aifa_call_write；「写·花 Token」指调用要跑模型、消耗 Token 或余额；四个保留范围项见第八节。逐域的说明与常见流程见说明全文。

运维探活与版本（7）

方法	用途	档位	需确认	读/写
`system.retrieve`	Retrieve system (read-only)	读者档起	—	读
`jobs.list`	List jobs (read-only)	全部档	—	读
`jobs.create`	Create jobs	全部档	—	写
`jobs.update`	Update jobs	全部档	—	写
`jobs.events.list`	List jobs events (read-only)	全部档	—	读
`api_docs.retrieve`	Retrieve api docs (read-only)	不登录也可	—	读
`operation_settings.update`	Update operation settings	全部档	—	写

Agent 授权与 OAuth（21）

方法	用途	档位	需确认	读/写
`agent_quickstart.retrieve`	Retrieve agent quickstart (read-only)	不登录也可	—	读
`oauth_clients.list`	List oauth clients (read-only)	不登录也可	—	读
`oauth_clients.retrieve`	Retrieve oauth clients (read-only)	不登录也可	—	读
`oauth_clients.create`	Create oauth clients	读者档起	—	写
`oauth_clients.delete`	Delete oauth clients	全部档	—	写
`devices.list`	List devices (read-only)	读者档起	—	读
`devices.retrieve`	Retrieve devices (read-only)	读者档起	—	读
`devices.create`	Create devices	读者档起	—	写
`devices.delete`	Delete devices	读者档起	—	写
`agent_authorizations.list`	List agent authorizations (read-only)	读者档起	—	读
`agent_authorizations.check`	Check agent authorizations (read-only)	读者档起	—	读
`agent_authorizations.retrieve`	Retrieve agent authorizations (read-only)	读者档起	—	读
`agent_authorizations.create`	Create agent authorizations	读者档起	—	写
`agent_authorizations.update`	Update agent authorizations	作者档起	—	写
`agent_authorizations.delete`	Delete agent authorizations	读者档起	—	写
`sessions.create`	Create sessions	读者档起	—	写
`device_authorizations.retrieve`	Retrieve device authorizations (read-only)	读者档起	—	读
`device_authorizations.approve`	Approve device authorizations	读者档起	—	写
`device_authorizations.deny`	Deny device authorizations	读者档起	—	写
`sessions.list`	List sessions (read-only)	读者档起	—	读
`accounts.revoke_sessions`	Revoke sessions accounts	全部档	—	写

Agent 通道（MCP、CLI、版本、事件）（19）

方法	用途	档位	需确认	读/写
`events.list`	List events (read-only)	读者档起	—	读
`events.retrieve`	Retrieve events (read-only)	读者档起	—	读
`event_destinations.list`	List event destinations (read-only)	读者档起	—	读
`event_destinations.create`	Create event destinations	读者档起	—	写
`event_destinations.update`	Update event destinations	读者档起	—	写
`event_destinations.delete`	Delete event destinations	读者档起	—	写
`event_destinations.events.list`	List event destinations events (read-only)	读者档起	—	读
`layout_specs.list`	List layout specs (read-only)	不登录也可	—	读
`layout_specs.retrieve`	Retrieve layout specs (read-only)	不登录也可	—	读
`layout_specs.create`	Create layout specs	读者档起	—	写
`layout_specs.update`	Update layout specs	读者档起	—	写
`layout_specs.delete`	Delete layout specs	读者档起	—	写
`reader_capabilities.list`	List reader capabilities (read-only)	不登录也可	—	读
`reader_capabilities.retrieve`	Retrieve reader capabilities (read-only)	不登录也可	—	读
`reader_capabilities.create`	Create reader capabilities	读者档起	—	写
`reader_capabilities.update`	Update reader capabilities	读者档起	—	写
`reader_capabilities.delete`	Delete reader capabilities	读者档起	—	写
`event_destinations.test`	Test event destinations	读者档起	—	写
`event_destinations.ack`	Ack event destinations	读者档起	—	写

需确认动作（4）

方法	用途	档位	需确认	读/写
`confirmations.list`	List confirmations (read-only)	读者档起	—	读
`confirmations.retrieve`	Retrieve confirmations (read-only)	读者档起	—	读
`confirmations.cancel`	Cancel confirmations	读者档起	—	写
`confirmations.approve`	Approve confirmations	读者档起	—	写

统计（2）

方法	用途	档位	需确认	读/写
`analytics_reports.retrieve`	Retrieve analytics reports (read-only)	全部档	—	读
`analytics_events.create`	Create analytics events	不登录也可	—	写

外链登记（5）

方法	用途	档位	需确认	读/写
`exit_links.list`	List exit links (read-only)	读者档起	—	读
`exit_links.update`	Update exit links	全部档	—	写
`exit_links.own_hosts`	Own hosts exit links (read-only)	不登录也可	—	读
`exit_links.record_click`	Record click exit links	不登录也可	—	写
`exit_links.refetch`	Refetch exit links	作者档起	—	写

杂志设置与审核队列（6）

方法	用途	档位	需确认	读/写
`review_settings.retrieve`	Retrieve review settings (read-only)	作者档起	—	读
`review_settings.update`	Update review settings	全部档	按入参	写
`review_items.list`	List review items (read-only)	全部档	—	读
`review_items.retrieve`	Retrieve review items (read-only)	全部档	—	读
`review_items.update`	Update review items	全部档	—	写
`review_items.batch_decide`	Batch decide review items	全部档	—	写

内容审核（屏蔽与删除）（3）

方法	用途	档位	需确认	读/写
`moderation_items.list`	List moderation items (read-only)	全部档	—	读
`moderation_items.moderate`	Moderate moderation items	全部档	—	写
`moderation_items.delist`	Delist moderation items	全部档	—	写

技能包与作品包（13）

方法	用途	档位	需确认	读/写
`skills.list`	List skills (read-only)	不登录也可	—	读
`skills.retrieve`	Retrieve skills (read-only)	不登录也可	—	读
`skills.files.retrieve`	Retrieve skills files (read-only)	不登录也可	—	读
`skills.archive`	Archive skills (read-only)	不登录也可	—	读
`skills.create`	Create skills	全部档	—	写
`skills.update`	Update skills	全部档	按入参	写
`skills.files.update`	Update skills files	全部档	—	写
`skills.enable`	Enable skills	全部档	按入参	写
`skills.delete`	Delete skills	全部档	—	写
`skills.compare_constraint`	Compare constraint skills	全部档	—	写
`bundles.create`	Create bundles	作者档起	—	写
`bundles.retrieve`	Retrieve bundles (read-only)	作者档起	—	读
`bundles.launch`	Launch bundles	不登录也可	—	写

收藏与块引用（4）

方法	用途	档位	需确认	读/写
`library_items.list`	List library items (read-only)	读者档起	—	读
`library_items.create`	Create library items	读者档起	—	写
`library_items.delete`	Delete library items	读者档起	—	写
`citations.list`	List citations (read-only)	作者档起	—	读

留言（9）

方法	用途	档位	需确认	读/写
`comments.list`	List comments (read-only)	不登录也可	—	读
`comments.create`	Create comments	读者档起	—	写
`comment_trusts.list`	List comment trusts (read-only)	作者档起	—	读
`comment_trusts.create`	Create comment trusts	作者档起	—	写
`comment_trusts.delete`	Delete comment trusts	作者档起	—	写
`comments.delete`	Delete comments	读者档起	—	写
`comments.update`	Update comments	作者档起	—	写
`comments.batch_moderate`	Batch moderate comments	作者档起	—	写
`comments.translate`	Translate comments	读者档起	—	写·花 Token

账号资料与作者主页（41）

方法	用途	档位	需确认	读/写
`accounts.list`	List accounts (read-only)	全部档	—	读
`accounts.retrieve`	Retrieve accounts (read-only)	读者档起	—	读
`accounts.update`	Update accounts	读者档起	—	写
`accounts.avatar.update`	Update accounts avatar	读者档起	—	写
`handle_protections.list`	List handle protections (read-only)	全部档	—	读
`handle_protections.create`	Create handle protections	全部档	—	写
`handle_protections.update`	Update handle protections	全部档	—	写
`handle_protections.delete`	Delete handle protections	全部档	—	写
`profiles.list`	List profiles (read-only)	不登录也可	—	读
`profiles.retrieve`	Retrieve profiles (read-only)	不登录也可	—	读
`profiles.update`	Update profiles	读者档起	—	写
`follows.list`	List follows (read-only)	读者档起	—	读
`follows.create`	Create follows	读者档起	—	写
`follows.delete`	Delete follows	读者档起	—	写
`follow_suggestions.list`	List follow suggestions (read-only)	读者档起	—	读
`permissions.retrieve`	Retrieve permissions (read-only)	读者档起	—	读
`permissions.update`	Update permissions	全部档	—	写
`account_deletions.retrieve`	Retrieve account deletions (read-only)	读者档起	—	读
`account_deletions.create`	Create account deletions	读者档起	—	写
`account_deletions.delete`	Delete account deletions	读者档起	—	写
`verifications.list`	List verifications (read-only)	全部档	—	读
`verifications.retrieve`	Retrieve verifications (read-only)	全部档	—	读
`verifications.create`	Create verifications	读者档起	—	写
`verifications.update`	Update verifications	全部档	—	写
`verifications.delete`	Delete verifications	读者档起	—	写
`verification_config.retrieve`	Retrieve verification config (read-only)	读者档起	—	读
`verification_config.update`	Update verification config	全部档	—	写
`sanctions.list`	List sanctions (read-only)	全部档	—	读
`sanctions.create`	Create sanctions	全部档	—	写
`sanctions.delete`	Delete sanctions	全部档	—	写
`abuse_policies.retrieve`	Retrieve abuse policies (read-only)	全部档	—	读
`abuse_policies.update`	Update abuse policies	全部档	—	写
`abuse_policies.steps.list`	List abuse policies steps (read-only)	全部档	—	读
`abuse_stats.retrieve`	Retrieve abuse stats (read-only)	全部档	—	读
`accounts.retrieve_me`	Retrieve me accounts (read-only)	读者档起	—	读
`handle_protections.check`	Check handle protections (read-only)	读者档起	—	读
`verifications.retrieve_me`	Retrieve me verifications (read-only)	读者档起	—	读
`reports.list`	List reports (read-only)	全部档	—	读
`reports.retrieve`	Retrieve reports (read-only)	全部档	—	读
`reports.create`	Create reports	读者档起	—	写
`reports.update`	Update reports	全部档	—	写

消息 im（独立服务）（26）

方法	用途	档位	需确认	读/写
`conversations.list`	List conversations (read-only)	读者档起	—	读
`conversations.retrieve`	Retrieve conversations (read-only)	读者档起	—	读
`conversations.create`	Create conversations	读者档起	—	写
`conversations.update`	Update conversations	读者档起	—	写
`conversations.agent_status.retrieve`	Retrieve conversations agent status (read-only)	读者档起	—	读
`conversations.agent_status.update`	Update conversations agent status	读者档起	—	写
`conversations.messages.list`	List conversations messages (read-only)	读者档起	—	读
`conversations.messages.create`	Create conversations messages	读者档起	—	写
`conversations.participants.list`	List conversations participants (read-only)	读者档起	—	读
`conversations.read_cursor.update`	Update conversations read cursor	读者档起	—	写
`message_settings.retrieve`	Retrieve message settings (read-only)	读者档起	—	读
`message_settings.update`	Update message settings	读者档起	—	写
`notification_cards.retrieve`	Retrieve notification cards (read-only)	读者档起	—	读
`contact_blocks.list`	List contact blocks (read-only)	读者档起	—	读
`contact_blocks.create`	Create contact blocks	读者档起	—	写
`contact_blocks.delete`	Delete contact blocks	读者档起	—	写
`notification_settings.retrieve`	Retrieve notification settings (read-only)	读者档起	—	读
`push_subscriptions.list`	List push subscriptions (read-only)	读者档起	—	读
`push_subscriptions.create`	Create push subscriptions	读者档起	—	写
`push_subscriptions.delete`	Delete push subscriptions	读者档起	—	写
`platform_rules.retrieve`	Retrieve platform rules (read-only)	读者档起	—	读
`platform_rules.update`	Update platform rules	全部档	—	写
`seats.conversations.list`	List seats conversations (read-only)	全部档	—	读
`conversations.to_ticket`	To ticket conversations	全部档	—	写
`message_settings.check`	Check message settings (read-only)	读者档起	—	读
`conversations.stream`	Stream conversations (read-only)	读者档起	—	读

信息流 feed（独立服务）（6）

方法	用途	档位	需确认	读/写
`feed_items.list`	List feed items (read-only)	读者档起	—	读
`reposts.list`	List reposts (read-only)	不登录也可	—	读
`reposts.create`	Create reposts	读者档起	—	写
`reposts.delete`	Delete reposts	读者档起	—	写
`feed_events.list`	List feed events (read-only)	读者档起	—	读
`feed_events.create`	Create feed events	读者档起	—	写

素材与媒体（7）

方法	用途	档位	需确认	读/写
`media.list`	List media (read-only)	作者档起	—	读
`media.retrieve`	Retrieve media (read-only)	不登录也可	—	读
`media.create`	Create media	读者档起	—	写
`uploads.create`	Create uploads	读者档起	—	写
`media.fetch`	Fetch media	作者档起	—	写
`media.update`	Update media	作者档起	—	写
`media.delete`	Delete media	作者档起	—	写

页与块（6）

方法	用途	档位	需确认	读/写
`block_uploads.list`	List block uploads (read-only)	读者档起	—	读
`block_uploads.create`	Create block uploads	作者档起	—	写
`block_uploads.delete`	Delete block uploads	读者档起	—	写
`articles.pages.render`	Render articles pages (read-only)	作者档起	—	写
`articles.blocks.act`	Act articles blocks	读者档起	—	写
`blocks.retrieve`	Retrieve blocks (read-only)	不登录也可	—	读

单篇与工作流（33）

方法	用途	档位	需确认	读/写
`articles.list`	List articles (read-only)	作者档起	—	读
`articles.search`	Search articles (read-only)	读者档起	—	读
`articles.retrieve`	Retrieve articles (read-only)	作者档起	—	读
`articles.create`	Create articles	作者档起	—	写
`articles.update`	Update articles	作者档起	—	写
`articles.delete`	Delete articles	作者档起	—	写
`articles.files.retrieve`	Retrieve articles files (read-only)	作者档起	—	读
`articles.files.update`	Update articles files	作者档起	—	写
`articles.check`	Check articles (read-only)	作者档起	—	写
`articles.diff`	Diff articles (read-only)	作者档起	—	读
`articles.byline_candidates.list`	List articles byline candidates (read-only)	作者档起	—	读
`articles.submit`	Submit articles	作者档起	—	写
`articles.publish`	Publish articles	作者档起	—	写
`articles.unpublish`	Unpublish articles	作者档起	—	写
`articles.request_revision`	Request revision articles	作者档起	—	写
`articles.discard_revision`	Discard revision articles	作者档起	—	写
`articles.withdraw`	Withdraw articles	作者档起	—	写
`articles.transfer`	Transfer articles	全部档	按入参	写
`articles.releases.list`	List articles releases (read-only)	作者档起	—	读
`articles.releases.retrieve`	Retrieve articles releases (read-only)	作者档起	—	读
`articles.restore_release`	Restore release articles	作者档起	—	写
`articles.originals.list`	List articles originals (read-only)	作者档起	—	读
`articles.originals.retrieve`	Retrieve articles originals (read-only)	作者档起	—	读
`steps.list`	List steps (read-only)	作者档起	—	读
`steps.retrieve`	Retrieve steps (read-only)	作者档起	—	读
`steps.revert`	Revert steps	作者档起	—	写
`articles.translate`	Translate articles	作者档起	—	写·花 Token
`articles.run_ai`	Run ai articles	作者档起	—	写·花 Token
`articles.preview_links.list`	List articles preview links (read-only)	作者档起	—	读
`articles.preview_links.create`	Create articles preview links	作者档起	—	写
`articles.preview_links.delete`	Delete articles preview links	作者档起	—	写
`articles.preview`	Preview articles (read-only)	作者档起	—	读
`preview_links.retrieve`	Retrieve preview links (read-only)	不登录也可	—	读

合集（24）

方法	用途	档位	需确认	读/写
`collections.list`	List collections (read-only)	作者档起	—	读
`collections.retrieve`	Retrieve collections (read-only)	作者档起	—	读
`collections.create`	Create collections	作者档起	—	写
`collections.update`	Update collections	作者档起	—	写
`collections.cover.update`	Update collections cover	作者档起	—	写
`collections.cover_bitmap`	Cover bitmap collections (read-only)	不登录也可	—	读
`collections.pages.render`	Render collections pages (read-only)	作者档起	—	写
`collections.delete`	Delete collections	作者档起	—	写
`collections.check_name`	Check name collections (read-only)	作者档起	—	读
`collections.local_review`	Local review collections (read-only)	不登录也可	—	读
`collections.check`	Check collections (read-only)	作者档起	—	写
`collections.publish`	Publish collections	作者档起	—	写
`collections.unpublish`	Unpublish collections	作者档起	—	写
`collections.transfer`	Transfer collections	全部档	按入参	写
`collections.items.list`	List collections items (read-only)	作者档起	—	读
`collections.items.batch_add`	Batch add collections items	作者档起	—	写
`collections.items.batch_remove`	Batch remove collections items	作者档起	—	写
`collections.items.reorder`	Reorder collections items	作者档起	—	写
`collections.files.retrieve`	Retrieve collections files (read-only)	作者档起	—	读
`collections.files.update`	Update collections files	作者档起	—	写
`inclusion_refusals.list`	List inclusion refusals (read-only)	作者档起	—	读
`inclusion_refusals.create`	Create inclusion refusals	作者档起	—	写
`inclusion_refusals.delete`	Delete inclusion refusals	作者档起	—	写
`collections.preview_links.create`	Create collections preview links	作者档起	—	写

阅读与读者（18）

方法	用途	档位	需确认	读/写
`reading_states.retrieve`	Retrieve reading states (read-only)	读者档起	—	读
`reading_states.update`	Update reading states	读者档起	—	写
`reader_documents.retrieve`	Retrieve reader documents (read-only)	不登录也可	—	读
`catalog.list`	List catalog (read-only)	不登录也可	—	读
`reader_documents.locate`	Locate reader documents (read-only)	不登录也可	—	读
`snapshots.export`	Export snapshots (read-only)	读者档起	—	写
`snapshots.retrieve`	Retrieve snapshots (read-only)	读者档起	—	读
`articles.text`	Text articles (read-only)	不登录也可	—	读
`articles.translation.retrieve`	Retrieve articles translation (read-only)	不登录也可	—	读
`articles.translation.create`	Create articles translation	读者档起	—	写·花 Token
`articles.cover_bitmap`	Cover bitmap articles (read-only)	不登录也可	—	读
`render_documents.retrieve`	Retrieve render documents (read-only)	不登录也可	—	读
`reader_documents.resolve_link`	Resolve link reader documents (read-only)	不登录也可	—	读
`reader_documents.probe`	Probe reader documents (read-only)	不登录也可	—	读
`articles.record_read`	Record read articles	不登录也可	—	写
`share_cards.create`	Create share cards	读者档起	—	写
`live_sessions.create`	Create live sessions	读者档起	—	写
`live_sessions.list`	List live sessions (read-only)	不登录也可	—	读

外壳与书架（2）

方法	用途	档位	需确认	读/写
`site_shell.retrieve`	Retrieve site shell (read-only)	不登录也可	—	读
`bookshelf.retrieve`	Retrieve bookshelf (read-only)	不登录也可	—	读

模型调用与额度（15）

方法	用途	档位	需确认	读/写
`model_runs.create`	Create model runs	读者档起	—	写·花 Token
`ai_settings.retrieve`	Retrieve ai settings (read-only)	全部档	—	读
`ai_settings.update`	Update ai settings	全部档	—	写
`ai_accounts.retrieve`	Retrieve ai accounts (read-only)	读者档起	—	读
`ai_accounts.update`	Update ai accounts	读者档起	—	写
`ai_ledger_entries.list`	List ai ledger entries (read-only)	读者档起	—	读
`ai_settings.set_provider_key`	Set provider key ai settings	全部档	是	写
`ai_settings.clear_provider_key`	Clear provider key ai settings	全部档	是	写
`ai_accounts.adjust_balance`	Adjust balance ai accounts	全部档	是	写
`reading_assistants.retrieve`	Retrieve reading assistants (read-only)	作者档起	—	读
`reading_assistants.update`	Update reading assistants	作者档起	—	写
`reading_assistants.glossary.create`	Create reading assistants glossary	作者档起	—	写·花 Token
`narrations.retrieve`	Retrieve narrations (read-only)	不登录也可	—	读
`narrations.update`	Update narrations	作者档起	—	写
`narrations.generate`	Generate narrations	作者档起	—	写

模型调用 model_runs.create（编辑台写稿派生同一条规则）：事实约束是硬的：引语候选必须是正文原句；导语与卡片不得出现正文没有的数字或专名（数字、拉丁专名、书名号标题逐个回查正文，中文专名机器判不了，只靠提示词约束与人工复核）；校验不过的项整项丢弃、回退为确定性派生；数字块的数字一律不由模型生成。

计费与权益（22）

方法	用途	档位	需确认	读/写
`orders.list`	List orders (read-only)	读者档起	—	读
`orders.retrieve`	Retrieve orders (read-only)	读者档起	—	读
`orders.create`	Create orders	读者档起	—	写
`orders.update`	Update orders	读者档起	—	写
`refunds.create`	Create refunds	读者档起	—	写
`prices.list`	List prices (read-only)	不登录也可	—	读
`prices.update`	Update prices	作者档起	—	写
`plans.list`	List plans (read-only)	不登录也可	—	读
`plans.update`	Update plans	全部档	是	写
`billing_settings.retrieve`	Retrieve billing settings (read-only)	全部档	—	读
`subscriptions.list`	List subscriptions (read-only)	读者档起	—	读
`subscriptions.update`	Update subscriptions	读者档起	—	写
`entitlements.list`	List entitlements (read-only)	读者档起	—	读
`checkouts.retrieve`	Retrieve checkouts (read-only)	读者档起	—	读
`wallets.retrieve`	Retrieve wallets (read-only)	读者档起	—	读
`charges.list`	List charges (read-only)	作者档起	—	读
`orders.reconcile`	Reconcile orders	全部档	是	写
`orders.refund`	Refund orders	全部档	是	写
`prices.suspend`	Suspend prices	全部档	—	写
`billing_settings.set_paid_switch`	Set paid switch billing settings	全部档	—	写
`billing_settings.set_platform_fee`	Set platform fee billing settings	全部档	是	写
`charge_items.list`	List charge items (read-only)	作者档起	—	读