更新日志

Memene API 开放平台的版本更新记录

v0.9.9 — 2026-05-19

说明：本版本聚焦在系统可观测性。普通开发者使用的接口、Gateway 调用方式和计费规则无任何变化，无需调整接入代码。

新功能

  • 4 个服务（API / Worker / Gateway / Web）统一接入应用日志体系：所有 Effect.log / Fastify HTTP 访问日志 / BullMQ 队列事件 / Web 服务端路由日志，均经由共享 Pino 实例同时输出到本地文件、控制台（开发期）和团队统一观测性基建（OTLP/HTTP，http://47.117.189.244:4318/v1/logs）。
  • 每条日志带上一致的资源属性（service.name / service.instance.id / service.version / deployment.environment），便于在 Grafana / Loki 中按服务和副本过滤；非 production 环境自动追加 -dev 后缀，避免本地噪音污染线上面板。
  • Worker 服务为每个 BullMQ 队列接上 active / completed / failed / stalled / error 五类事件监听，原本完全黑盒的任务处理过程现在可在后端按 queue / jobId 维度串起单次任务全生命周期。
  • Gateway LogWriter 自身的故障日志（rpop / requeue / createMany / consumeMany 失败）改为结构化字段（module / op / err 等），可按字段过滤而非全文搜索。
  • 容器化部署：docker-compose.prod.yml 给 7 个容器（4×api / worker / gateway / web）统一注入观测性变量，并按服务/副本挂载独立日志目录（./logs/api-1/...、./logs/worker/ 等），便于宿主机 tail 与远端 OTLP 互为冗余。

设计与文档

  • 业务日志（Gateway 计费链路：Redis → MySQL）与技术日志（OTLP）刻意双轨：前者要求精确、可重放、可审计；后者要求实时、可观测、容忍丢失，两者保留策略不同，不合并。
  • Web 端为避免拖累 Next.js dev 编译速度，独立维护一份观测性实现（packages/web/lib/observability/），不在运行时依赖 shared；Trace 与 Metrics 作为后续扩展点预留在 packages/shared/src/services/observability/ 目录下；新增 doc/observability.md 项目级方案文档（含字段映射表、4 阶段路线图、Span 命名规范、起步指标维度），以及共享模块的开发者视角 README。
  • 架构决策文档新增「观测性策略」章节，沉淀分阶段接入、双轨制、统一基建、共享 Pino 实例、Web 不复用 shared 等关键取舍。

修复

  • 修复线上 Web standalone 构建时 pino-opentelemetry-transport 模块未被 Next.js 静态依赖追踪打入产物，导致容器启动报 Cannot find module 的问题：放弃 worker-thread transport，改用同进程 OTel SDK LoggerProvider + 自定义 Pino Writable stream，所有上报路径全部主线程化，nft 能正确识别。
  • 修复 Fastify 5 不再接受 { logger: pinoInstance } 配置的兼容问题：外部 Pino 实例统一改为通过 loggerInstance 字段注入。
  • 修复 Web pnpm dev 启动后首次访问页面时 webpack 重新编译整个 @memene/shared 导致编译卡死的问题：观测性核心逻辑独立维护在 packages/web/lib/observability/，web 与 shared 之间仅保留类型耦合（import type），next.config.ts 不再需要 transpilePackages / extensionAlias / serverExternalPackages。

v0.9.8 — 2026-05-11

说明：本版本继续完善 LLM 中转网关（Gateway）相关能力，Gateway 仍 仅面向内部合作伙伴开放（内测中）；普通开发者的 API 访问不受影响。

新功能

  • 新增 Moonshot (Kimi) 与 DeepSeek 两家 Provider，支持 moonshot-v1-8k/32k/128k/auto、kimi-latest、kimi-k2-0905-preview、deepseek-v4-flash、deepseek-v4-pro 等模型。
  • Gateway 支持为每个 Provider 单独配置 HTTP 代理；国内端点默认禁用代理，避免被代理转发到墙外再回访国内 API。
  • Gateway 调用改为 后付费模型：实际消耗的 token 在调用结束后异步从账户余额中扣减，并允许至多 ¥5 的小额透支，避免高并发下被余额校验阻塞。
  • Gateway Console 文档页拆分为独立子路由：接入指南、各端点详情、模型与定价分别独立成页，左侧固定导航，告别"全部塞在一页"的滚动体验。
  • Gateway Playground 全面升级：
    • 支持上传图片（PNG/JPEG/WebP/GIF），按各厂商协议自动注入图像内容（OpenAI image_url / Anthropic image/source.base64 / Gemini inline_data）。
    • Token 用量按"输入 / 缓存输入 / 输出"分别展示，并在底部显示当前对话累计 token 与费用。
    • 右上新增"新建对话"图标按钮；调用失败时错误消息保留在对话历史中，旁边显示重试按钮（Google AI Studio 风格的纯图标），点击后按原输入重新发起。
  • admin 可在 Provider / Model 管理页面手动触发 Gateway 运行时热刷新，不再需要重启 Gateway 容器即可让配置变更生效。
  • 新增 运行时可配置的用户与页面权限管理系统：
    • 管理员可在 /dashboard/admin/users 查看全部用户、修改用户角色与启用/禁用状态。
    • 管理员可在 /dashboard/admin/access 创建自定义角色（如 vip、enterprise），并按页面勾选授权，无需改代码就能下放精细权限。
    • Gateway Console 的每个子页面（概览 / 余额 / Keys / 日志 / 用量 / 计费 / Provider 管理 / Model 管理 / 模型浏览 / 文档 / Playground）都是独立的权限项，可分别授予不同角色。
  • 提升 API 服务的处理能力与水平扩展性，新增线上压测脚本用于持续验证。

修复

  • 修复 Provider 编辑时，若编辑过程中输入但未提交的新 API Key 会被保存动作覆盖丢失的问题。
  • 修复 Web 镜像构建时 NEXT_PUBLIC_API_BASE_URL 在某些环境下默认值不正确，导致前端调用线上 API 拼错路径的问题。
  • 修复 reload-gateway 在本地开发时默认 Base URL 误指向线上的问题。
  • 修复 CI/CD 部署链路中的若干稳定性问题。

v0.9.7 — 2026-04-15

说明：本版本上线的 LLM 中转网关（Gateway）及相关 Console 面板，仅面向内部合作伙伴开放，不对普通开发者公开。普通开发者的 API 访问不受影响。

新功能

  • 上线 AI API 中转网关（Gateway，仅内部合作伙伴开放），支持 OpenAI、Google Gemini、Anthropic、阿里百炼、OpenRouter 五家 Provider。
  • Web 后台新增独立的 Gateway Console 界面（/gateway-console，仅内部合作伙伴可见），提供 Gateway Key 管理、Provider/Model 配置、用量统计、调用日志、Playground 和计费看板。
  • 新增各厂商原生 API 格式的转发路由（/openai/*、/gemini/*、/anthropic/*），请求体中的 model 字段通过 ModelRegistry 映射到实际上游，支持跨路由调用。
  • 新增 OpenRouter 渠道，默认接入 google/gemini-3-flash-preview、anthropic/claude-sonnet-4.6、openai/gpt-5-chat 三款模型。
  • 镜像 transfer 任务增加最长 8 分钟的执行超时。

修复

  • 修复阿里百炼 Provider 因名称配置不一致始终停留在 disabled 状态的问题。
  • 修复异常数据导致 Gateway 调用记录无法入库更新的问题。
  • 修复 Log Writer 写入失败时错误被静默吞掉、难以排查的问题。
  • 修复按 API Key 查看 LLM 中转用量 / 统计时数据缺失的问题。
  • 修复 Gateway Playground 面板中流式输出的"是 / 否"状态渲染不正确的问题。
  • 修复 Gemini API 调用失败的问题。
  • 修复无法通过代理访问上游 Provider 的问题。
  • 修复 Gateway Playground 浏览器端地址硬编码，导致本地环境无法连接本地 Gateway 调试的问题。
  • 修复 Web 端部分构建错误。

文档

  • 更新部署文档，修复 nginx 配置中的若干问题。

v0.9.6 — 2026-04-02

新功能

  • 新增按日期获取产品频道新闻数据接口（GET /v1/meme/productNews/:date），返回 memene.cn/model 页面经过处理的结构化产品动态数据。

v0.9.5 - 2026.3.24

新功能

  • 添加更新日志页面。

优化

  • 优化了文档页面关于部分返回类型结构的前端渲染，补足相应的结构化信息。
  • 优化了 API 的结构化转换机制。

文档

  • 更新了联系我们的相关信息。

v0.9.4 — 2026-03-23

新功能

  • 添加产品信息查询相关接口（AI 产品数据查询）

修复

  • 修复产品接口的接口验证问题

文档

  • 修复部分接口文档描述不正确的问题

v0.9.3 — 2026-03-20

新功能

  • 添加定制化的行业的数据接口
  • 新增测试单元覆盖

修复

  • 修复首次登录后无法自动跳转到 Dashboard 的问题
  • 修复文档导出内容不正确的问题
  • 修复登录功能异常的问题
  • 修复部分接口配置缺失的问题

v0.9.2 — 2026-03-18

新功能

  • 添加产品信息源查询接口
  • 新增管理员对 API 资源的管控功能

修复

  • 修复类型定义与构建错误

v0.9.1 — 2026-03-16

新功能

  • 信息查询接口统一为 task/query 模式

修复

  • 修复 /get-v1-meme-memeItemsByDomain-taskId 相关接口的强校验问题
  • 修复 API Key 校验问题
  • 修复部分构建问题

文档

  • 修缮接口文档

v0.9.0 — 2026-03-14

新功能

  • 初版 API 文档站上线
  • Web 端添加 404 页面
  • RESTful API 服务、Worker 队列服务、Web 文档站点三端完成基础架构

修复

  • 修复线上 SKILL 复制时 API_BASE_URL 未替换的问题
  • 修复 /health 接口异常
  • 修复 CI/CD Docker 镜像中 Prisma 相关的部署问题