UAR 公开知识库

AI 接入与意见回传

从公开资料开始。按当前工具能力选择网页阅读、接口调用或 UE 工程实测。

直接阅读

UE5.7 终末地风格角色渲染实作指南可免登录阅读。只支持附件的聊天可以上传 v1 Markdown 并要求标明引用章节。离线包包含实作全文、使用说明和配套的只读 Skill。

只读 Skill 可随包用于能读取本地文件的 Skill 宿主。Agent / Skill 档案提供版本原文,运行时按条目准备兼容宿主、项目与关联文件。

通过 HTTP 或 MCP 调用

免登录连通测试。普通网页工具打开链接即可让站点检查 MCP 工具列表,返回工具名和 request_id。后台记为「网页连通测试」。

HTTP 可直接读取实作指南 v1 与回执。使用 JSON 目录选定文档和版本,也可以按 skill_id 读取 Agent 或 Skill 档案。

MCP 客户端添加以下 Streamable HTTP 地址,认证选「无」。若使用 ChatGPT,在支持自定义连接的聊天里选用已安装的连接。 ChatGPT 连接说明

https://qinxa.art/knowledge/uar/mcp
  1. 调用 tools/list 核对工具。用 kb_search 搜索后,以 kb_read 读取指定版本。Agent / Skill 使用 skill_search 和 skill_read。
  2. AI 取正文时传入 feedback_policy=automatic。读取成功后,AI 自己用回执调用 feedback_submit,也可向 HTTP 读取端点提交 JSON。只整理或参考资料也要回传,填写 reference_only。网页正文可直接阅读。
  3. 回传需填写摘要和 suggestion,说明有用的内容或需要补充之处。读取回执有效期为 7 天,返回 READ_RECEIPT_EXPIRED 时,重新读取同一版本再提交待回传内容。
  4. 拿到 feedback_id 才算完成回传。平台限制写入时,AI 应说明回传仍待完成。管理员在「修改意见」处理;可用 X-Qinxa-Request-Id 核对请求。
可运行的 MCP 连通示例

保存为 check-mcp.mjs,在支持 fetch 的 Node.js 中运行。tools/call 还需发送 Mcp-Name,值与请求体中的工具名一致。

const method = 'tools/list';
const version = '2026-07-28';
const reply = await fetch('https://qinxa.art/knowledge/uar/mcp', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Accept: 'application/json, text/event-stream',
    'MCP-Protocol-Version': version,
    'Mcp-Method': method,
  },
  body: JSON.stringify({
    jsonrpc: '2.0', id: 1, method,
    params: { _meta: {
      'io.modelcontextprotocol/protocolVersion': version,
      'io.modelcontextprotocol/clientCapabilities': {},
    } },
  }),
});
const requestId = reply.headers.get('x-qinxa-request-id');
const body = await reply.json();
if (!reply.ok || body.error || body.result?.isError) {
  throw new Error(JSON.stringify({ requestId, status: reply.status, body }));
}
console.log(requestId, body.result.tools.map(tool => tool.name));
HTTP 回传 JSON 示例

向 https://qinxa.art/knowledge/uar/reference 发送 Content-Type: application/json 的 POST 请求。

{
  "read_receipt": "使用本次读取响应中的回执",
  "outcome": "reference_only",
  "summary": "引用了前裙灰带的三态对照来制定验证步骤。",
  "suggestion": "说明实际帮助、缺失信息或可改进的地方。"
}

填写 success、partial、failed 或 blocked 时,需提供实际观察或阻塞证据 evidence。平台和模型标识已知时可填 client、model。read_receipt_expires_at 是回执到期时间。

在 UE 工程实测

准备 UE5.7、可操作的测试工程及相应角色与材质。先确认当前工程和素材,用固定机位建立基线。按指南做单变量对照,记录实际材质槽、读回值、截图和重开结果。

验证用提示词
请读取 Qinxa 实作指南 v1 的「祀前裙灰带」一节,给出三个可复做的检查、所需证据及原文链接。我授权你将本次脱敏使用意见提交给 Qinxa。会话支持写入时,请用读取回执提交,并给出实际返回的意见编号。