用途:让智能体用 mxs CLI 作为确定性接口操作 mx-core 内容,覆盖文章、笔记、页面等资源的查看、起草、校验、编辑、发布、取消发布、删除与配置。
主要能力:命令面包含 auth、post、note、page、category、topic、comment、snippet、config。使用前按需加载参考文档:命令语法与资源覆盖查 Command Index;文章、笔记、页面写作流程查 Content Authoring;认证、目标选择、输出模式与配置文件查 Auth, Config, And Output;变更安全、验证、失败与退出码查 Safety And Troubleshooting。
使用方式:先确认操作类型并加载相关参考,再确认目标与认证,例如运行 mxs auth status --json、mxs auth whoami --json、mxs category list --json。变更类操作优先使用 --dry-run,执行后读回验证。读取脚本用 --json,读取文档内容用 --output llm 或 --output envelope,仅在需要人工查看时用 --output readable。
安全规则:变更与读取默认传 --json;不得打印访问令牌、刷新令牌、Cookie、API 密钥或原始凭据文件;MXS_API_URL、MXS_TOKEN、MXS_API_KEY、--api-url、--token、--api-key 视为执行上下文而非内容;未获用户明确发布请求或未确认目标前不得发布到生产;测试写入路径时设置 draft 状态或传 --state draft;创建、编辑、更新、发布、取消发布后读回并核对可观察字段;破坏性操作先 --dry-run,删除需明确请求或确认目标后再用 delete --force。
限制与排错:若命令返回 fetch failed,需先启动或选择目标 mx-core 服务器,本地开发通常为 http://localhost:2333,不带 /api/v2 前缀。若读取正常但写入返回 auth.expired,确认凭据是否为 API key,API key 须通过 MXS_API_KEY 或 --api-key 传入,而非 MXS_TOKEN。不要从其他资源类型推断不支持的标志。排错可用 --verbose,但不得打印凭据。其他细节资料未提供。