接入
⑧ 接入步骤与 ⑩ 路线、反馈入口待写。 见
docs/public-page/content-spec.md。 ⑧ 卡在两件事:正式域名未启用(写 dev 域名上线会让所有已授权客户端在换地址时 重新授权),且每条可复制命令必须人工实跑过一次才能上页(L-7)。
权限、限流与边界
我们宁可把边界写在前面,也不想让你在项目做到一半时才撞上。
授权
接上之后,你的客户端会引导你走一次标准的 OAuth 授权。ArchLink MCP 本身只验令牌,
不经手你的账号密码。令牌拿到的范围是 archlink:tools,也就是调用本站
工具清单 里列出的那些工具,此外什么也做不了。
慢的那些工具是「作业制」
耗时以分钟计的工具不会占着对话干等。它们发起后立刻返回一个作业号,之后由客户端 按返回体里给出的间隔来取结果。请按它给的间隔取——秒级轮询不会让作业变快, 只会更早撞上限流。
现在不支持什么
- 令牌 24 小时到期,而且不发 refresh token。 也就是说,重度使用的话大约每天要 重新授权一次。这是当前有意的取舍,不是故障。
- 取消作业只止得住还没开始的部分。 已经发给上游的请求不会被追回,已经跑完的 计算也不会回滚。所以作业快结束时再取消,基本上省不下什么。
- 作业结果保留 7 天,过期之后查不到。
- 结果里的图片和表格链接只有 1 小时有效,比作业本身的保留期短得多。要留就尽快 下载下来——7 天内你还能查到那个作业,但链接早就失效了。
- 服务端发给模型的工具描述是中文的。 你的客户端界面里会显示它们。这不影响你用 什么语言提问,但界面上会是中文。
限流
有按用户的限流,包括并发作业上限和每天的作业配额。具体数字随内测阶段调整,暂不写死 在这里;触发时返回体会直接告诉你是哪一条、以及多久之后可以重试。