https://docs.nanako.org/zh-CN/changelog Nanako Docs Blog 2026-09-16T00:00:00.000Z https://github.com/jpmonette/feed Nanako Docs Blog https://docs.nanako.org/zh-CN/img/favicon.ico <![CDATA[长文件名不再撑开翻译和解析页面]]> https://docs.nanako.org/zh-CN/changelog/2026/09/16/long-filename-layout 2026-09-16T00:00:00.000Z 在桌面端，上传文件名很长的文件会撑开 PDF 翻译和文档解析页面的双栏布局，把任务 列表挤出可视范围，而不是把文件名缩短显示。

修复​

  • PDF 翻译和文档解析页面的长文件名现在会在所在栏内截断显示，双栏布局保持原有比例
  • 鼠标悬停在被截断的文件名上可以看到完整名称
]]> <![CDATA[删除翻译与解析记录]]> https://docs.nanako.org/zh-CN/changelog/2026/07/30/delete-task-records 2026-07-30T00:00:00.000Z 已结束的 PDF 翻译和文档解析现在可以删除了，文件也会一并清掉。这是从存储里真的 删除，不是把记录从列表中悄悄藏起来。

新增​

  • PDF 翻译和文档解析中，每条已结束的任务都多了一个删除按钮。它会把源文件 和全部结果从对象存储中永久删除，无法恢复。
  • DELETE /api/v1/translate/tasks/:id/record 与 DELETE /api/v1/mineru/tasks/:id/record 提供相同能力。对仍在进行的任务两者都 返回 400——请先取消，否则它的 worker 可能在删除之后才写出结果，留下无人管理的文件。
  • 存储不可达时整个请求以 503 失败，不会隐藏任何记录。记录绝不会在文件还在的情况下消失。

变更​

  • 取消行为未变。DELETE /api/v1/translate/tasks/:id 与 DELETE /api/v1/mineru/tasks/:id 仍然只用于取消进行中的任务。取消与删除刻意分成 两个端点，同一个请求不会因任务状态不同而表示两种含义。
]]> <![CDATA[消息通知上线]]> https://docs.nanako.org/zh-CN/changelog/2026/07/30/notifications 2026-07-30T00:00:00.000Z 事情做完了 Nanako 会告诉你,不用再自己回去刷页面看。

状态核验于 2026-09-10

本文记录 P0 通知版本。已核验实现仍包含站内收件箱、带轮询降级的 SSE 实时更新、 通知偏好、按已授权应用静音，以及在 worker/邮件渠道启用时的邮件投递。浏览器 Web Push 和 APNs 仍是后续渠道：当前没有设备注册端点，对应偏好开关会标成 “未开放”并禁用。下文关于清理推送订阅的描述是预留数据模型/会话行为，不代表 推送渠道现在可用。

本次交付​

  • 消息中心 —— 顶栏的收件箱,带未读角标。新消息不用刷新页面就会出现。
  • 邮件提醒 —— 同样的事件可以发到你的邮箱。所有类别默认关闭,需要你自己打开。
  • 偏好设置页 —— 按类别、按渠道分别决定要不要收。你授权过的第三方应用可以 单独静音,不必撤销它的授权。
  • 翻译完成是第一个接进来的事件。PDF 翻译跑完——或者失败——都会通知你。

说明​

通知由一个独立的后台进程投递。如果你自建 Nanako,打开这个功能的同时必须部署 那个进程,否则消息中心里会堆满永远停在 pending 的条目。详见部署文档。

P0 数据模型还把未来的推送订阅关联到登录会话，以便撤销设备时让订阅失效。推送 投递本身没有随 P0 发布，在当前已核验实现中仍不可用。

]]> <![CDATA[面向第三方开发者的 OAuth 2.0 文档]]> https://docs.nanako.org/zh-CN/changelog/2026/07/30/oauth2-developer-docs 2026-07-30T00:00:00.000Z 让用户用 Nanako 账号登录你的产品,所需要的一切现在都有文档了:流程、每个端点和参数、 每个 scope 和 claim、每种错误,以及安全要求。

新增​

  • OAuth 2.0 —— 概览、支持的客户端类型、令牌有效期,以及 提供方实现了什么、没实现什么
  • 注册应用 —— 开发者审核、创建应用、回调地址规则 与凭证处理
  • 授权码流程 —— 完整对接过程与可直接运行 的请求,含 PKCE、刷新与撤销
  • Scope —— 四个 scope、各自返回的 claim,以及 scope 的校验方式
  • 端点参考 —— 四个 OAuth 端点的每个参数与响应字段
  • 错误 —— 每种错误的成因,以及该不该重试
  • 安全要求 —— 对接必须做对的事

说明​

动手之前有两个限制值得先知道:/.well-known/openid-configuration 这份发现文档里的 端点地址是打不开的,请手动配置端点;纯浏览器应用在运营方把来源加入白名单之前,无法 完成换取令牌这一步。两点在文档里都有详细说明。

]]> <![CDATA[docs.nanako.org 上线]]> https://docs.nanako.org/zh-CN/changelog/2026/07/28/docs-site-launch 2026-07-28T00:00:00.000Z Nanako 生态的公开文档站上线了:docs.nanako.org。

状态核验于 2026-09-10

本文记录 2026-07-28 的上线事件。仓库仍配置了 docs.nanako.org、Nanako 英中文档、更新日志搜索和有条件执行的 Cloudflare 部署，但仓库配置不能证明网站 当前可访问。Nanako 仍是唯一文档区；NanoStart 和 NanoUptime 是外部第一方应用， 目前在本站仍没有独立文档区。本站也尚未接入 OpenAPI 渲染。

本次交付​

  • Nanako 文档,双语骨架(默认英文,简体中文位于 /zh-CN/ 下)
  • 更新日志 —— 也就是本页
  • 全文搜索,覆盖两种语言,含中文分词
  • 持续部署 —— 改动合并到 main 后自动发布,无需任何手动操作

更新是怎么走的​

文档与它所描述的代码同仓库存放。改一个 API 和改它的文档发生在同一个 commit 里,在同一个 PR 中一起被 review。

接下来​

上线时的计划是增加 NanoStart、NanoUptime 文档区，并从 NanoUptime 的机器可读 描述生成 API 参考。这是当时的路线图，不是当前站点状态；请以上方核验注记为准。

]]>