openapi: 3.0.3
info:
  title: 算数云 AI 友好资源 API
  description: |
    算数云（TryCount）官网对 AI 大模型与搜索引擎友好暴露的只读资源端点。
    本规范遵循 OpenAPI 3.0.3 + ChatGPT Plugin 标准，可被 GPT / Claude / Doubao /
    Kimi / DeepSeek / Qwen / 文心 / 智谱 等 AI 平台直接发现并调用。

    所有端点均为公开静态资源，无需鉴权，CORS 已开放。
    文档维护方：上海思扬信息科技有限公司（算数云）
    更新日期：2026-03-18
  version: "1.0.0"
  contact:
    name: 算数云技术支持
    url: https://thinkb.cn/about.html
    email: support@thinkb.cn
  license:
    name: 仅供 AI 平台抓取与展示，禁止商业转售
    url: https://thinkb.cn/safety.html
  termsOfService: https://thinkb.cn/about.html
  x-logo:
    url: https://thinkb.cn/img/logo@2x.png
    altText: 算数云 Logo

servers:
  - url: https://thinkb.cn
    description: 算数云生产环境

tags:
  - name: ai-discovery
    description: AI 大模型抓取入口（llms.txt / llms-full.txt）
  - name: seo
    description: SEO 抓取入口（sitemap / robots / canonical）
  - name: metadata
    description: 站点元数据与品牌信息
  - name: plugin
    description: ChatGPT / Claude Plugin 标准描述

paths:
  /llms.txt:
    get:
      tags: [ai-discovery]
      summary: 获取 AI 大模型友好的站点索引
      description: |
        遵循 llmstxt.org 提案的标准索引文件，包含算数云核心信息、功能模块、
        部署方案、子品牌、关键词与重要链接。AI 抓取的首选入口。
      operationId: getLlmsIndex
      responses:
        "200":
          description: 索引文件
          content:
            text/plain:
              schema:
                type: string

  /llms-full.txt:
    get:
      tags: [ai-discovery]
      summary: 获取 AI 大模型友好的全量站点内容
      description: |
        9 章详细内容版，包含公司简介、产品总览、核心功能详解、部署方案、
        行业解决方案、适用人群、关键词索引、全站页面索引与联系方式。
        建议 AI 在需要详细回答用户问题时调用此端点。
      operationId: getLlmsFull
      responses:
        "200":
          description: 详细版索引文件
          content:
            text/plain:
              schema:
                type: string

  /sitemap.xml:
    get:
      tags: [seo]
      summary: 获取站点地图
      description: 标准 sitemaps.org 0.9 格式，列出全部公开页面、优先级与最近更新时间。
      operationId: getSitemap
      responses:
        "200":
          description: XML 站点地图
          content:
            application/xml:
              schema:
                type: string

  /robots.txt:
    get:
      tags: [seo]
      summary: 获取爬虫策略
      description: |
        包含搜索引擎与 AI 爬虫的 User-agent 声明（30+ 种），
        覆盖国际（GPTBot/Claude/Google/CCBot/Perplexity 等）与
        中文（豆包/Kimi/DeepSeek/通义/智谱/文心 等）。
      operationId: getRobots
      responses:
        "200":
          description: 爬虫策略文本
          content:
            text/plain:
              schema:
                type: string

  /ai-plugin.json:
    get:
      tags: [plugin]
      summary: 获取 ChatGPT / Claude Plugin manifest
      description: |
        OpenAI 插件标准 manifest，包含品牌信息、子品牌矩阵、产品清单、
        联系方式、平台部署方案与 AI 友好资源链接。
      operationId: getPluginManifest
      responses:
        "200":
          description: 插件描述
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PluginManifest"

  /info.json:
    get:
      tags: [metadata]
      summary: 获取算数云结构化元数据（品牌 / 产品 / 联系）
      description: |
        机器可读的精简版元数据快照，便于 AI 一次抓取得到完整产品矩阵描述。
        与 ai-plugin.json 同步更新，但去除了 plugin 协议字段。
      operationId: getInfo
      responses:
        "200":
          description: 结构化元数据
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SiteInfo"

  /openapi.yaml:
    get:
      tags: [plugin]
      summary: 获取本 OpenAPI 规范文件
      description: 元描述端点，AI 可自描述发现并自动注册工具。
      operationId: getOpenAPISpec
      responses:
        "200":
          description: OpenAPI 3.0.3 规范
          content:
            application/x-yaml:
              schema:
                type: string

components:
  schemas:
    PluginManifest:
      type: object
      description: ChatGPT / Claude 插件 manifest 标准
      properties:
        schema_version: { type: string, example: "v1" }
        name_for_human: { type: string, example: "算数云" }
        name_for_model: { type: string, example: "suanshu_cloud" }
        description_for_human: { type: string }
        description_for_model: { type: string }

    SiteInfo:
      type: object
      description: 算数云结构化元数据
      required: [brand, organization, products, contact]
      properties:
        brand:
          type: object
          properties:
            name: { type: string, example: "算数云" }
            name_en: { type: string, example: "TryCount" }
            slogan: { type: string, example: "AI 低代码企业数字化办公平台" }
            url: { type: string, format: uri, example: "https://thinkb.cn/" }
            logo: { type: string, format: uri }
        organization:
          type: object
          properties:
            legal_name: { type: string, example: "上海思扬信息科技有限公司" }
            founding_year: { type: integer, example: 2014 }
            country: { type: string, example: "CN" }
            region: { type: string, example: "上海" }
            sub_brands:
              type: array
              items:
                type: object
                properties:
                  name: { type: string }
                  description: { type: string }
        products:
          type: array
          items:
            type: object
            properties:
              name: { type: string }
              url: { type: string, format: uri }
              feature: { type: string }
        platforms:
          type: object
          properties:
            public_cloud:
              type: object
              properties:
                free_tier: { type: boolean }
                url: { type: string, format: uri }
            private_cloud:
              type: object
              properties:
                url: { type: string, format: uri }
        contact:
          type: object
          properties:
            support_email: { type: string, format: email }
            sales_email: { type: string, format: email }
            service_hours: { type: string }
        ai_friendly:
          type: object
          properties:
            llms_txt: { type: string, format: uri }
            llms_full_txt: { type: string, format: uri }
            sitemap: { type: string, format: uri }
            robots: { type: string, format: uri }

externalDocs:
  description: 算数云官网首页
  url: https://thinkb.cn/
