返回使用指南

使用指南

从第一份总结开始，把资料变成自己的知识。

看看最近更新

账户、笔记同步与开放平台

从账户菜单进入「账户设置」，管理会员、登录安全、完成提醒、笔记同步、分享和个人数据下载；程序接入在「开放平台」。

注册与登录

知否唯一主站为 zhifou.app，不使用 www。旧站网页会跳转到主站，并保留页面路径和查询参数。已有账号和资料继续使用；浏览器登录状态不会跨域迁移，请在新站重新登录。API／MCP 客户端也应把服务地址更新为新主站。

打开登录页，填写邮箱并「发送验证码」，再输入邮件中的6位数字并「登录」。验证码10分钟内有效，重发后请使用最新验证码；连续输错3次需要重新申请。首次验证成功会创建账号，无需另外注册。

申请发送后会显示验证码输入框。若提示发送结果未确认，但邮件已经收到，可直接输入最新验证码；重发倒计时不影响输入和登录。刷新页面或重新打开登录页后，可先填写同一邮箱，再点「已有验证码，直接输入」，无需重复发送。人机验证失败时按提示重新验证后重发。

知否仅使用邮箱验证码登录，密码和 Passkey 已停止使用。旧账号直接使用原邮箱登录，账号、资料、会员及仍有效的登录保持不变。新用户可注册的邮箱和人机验证要求以页面为准；已有账号不受新注册邮箱域名限制。

登录成功后会回到此前要访问的页面；其他已打开页面会重新核对登录状态，切换账户时清除页面中显示的上一账户内容和草稿。

收不到邮件时先检查邮箱拼写与垃圾邮件，等页面允许后再重发；不要把验证码发给他人。登录网站、原视频平台和插件设备授权是三个不同状态。

验证码邮件由知否的 @zhifou.app 域名邮箱发送；邮件中的站点链接指向 https://zhifou.app。

启用邀请制时，发送前会显示邀请码输入框，新用户需填写有效邀请码，已有账号可留空。未收到验证码时，也请核对首次使用是否满足页面说明的注册条件。

每个邮箱两次申请至少间隔60秒，一小时最多申请10次，登录和注销共用此限制；请按页面提示等待。邮件发送失败时可在允许后重试。如果验证码已经验证但登录未完成，请重新获取验证码。

邮箱是唯一登录凭据，请确保它能正常收信。当前不提供更换登录邮箱或其他登录方式。怀疑登录授权泄露时，请管理下方的登录设备；开放平台 API Key 在开放平台单独撤销。

查看套餐、安全和设备

桌面登录后点击右上角账户头像，手机点击「打开菜单」进入「账户设置」。外观可选择「跟随系统」「浅色」「深色」：桌面在主题按钮或账户菜单的「外观」里，手机在菜单中选择。主题只影响阅读显示，不改变资料权限。

「套餐与额度」显示有效等级、截止时间、剩余与已用量、会员月刷新时间及媒体时长上限；早鸟账号还会显示同档年付续费资格截止时间，兑换码也在这里填写。各档区别见套餐权益与计量。

「登录安全」说明邮箱验证码登录方式，登录设备可在下方查看与退出。切换账号前保存笔记与未上传原件；录制暂存不会跨账号显示。

「插件后台协助」控制是否允许插件用本人浏览器的原平台登录态处理本人提交的媒体。只有当前浏览器可获取的内容才可能协助，开关不会替你登录原平台。

手机可以直接使用网站；浏览器支持时，可用浏览器自己的「安装应用／添加到主屏幕」将网站添加到桌面。系统分享入口和通知支持取决于设备及浏览器，不等于已安装桌面 Chrome／Edge 插件。

个人转录词库

在「账户设置 → 个人词库」保存常用人名、品牌和专业术语，最多1000个词，每词最多64个 Unicode 字符。每行一个，也可用逗号分隔；短语内的空格、重音符号和合法连接字符会保留。可以导入 UTF-8 TXT，也可导出当前草稿为 TXT。

保存前核对当前内容。多页面同时编辑时，后保存的页面会提示冲突并保留草稿；「重新读取」只更新已保存版本，不覆盖正在编辑的文字，可合并后再保存。修改词库不会改变已经开始的转录任务。

提交或上传时可以选择是否使用相关的个人常用词，也可另外填写本次补词。个人转录词库与润色、翻译的术语表分别管理；此处只记录字面词语，不解析翻译、替换或其他指令。完整数据备份也包含已保存的个人词库和本次任务设置。

管理登录设备

从「账户设置」的「登录设备」分区查看当前设备和其他有效的网页登录、插件授权。列表显示登录时间与来源IP，可展开客户端信息；最近续期不是实时在线状态。登录超过24小时后，需重新登录再管理。

  • 单独退出：找到要处理的登录，点击「退出此登录」，核对确认框中的客户端与时间后确认；取消会保留该登录。
  • 批量退出：点击「退出其他所有登录」并确认，当前设备继续使用。较多登录可展开完整列表，不会只处理前100条。
  • 被退出的设备在刷新或下一次操作时需要重新登录或授权。退出会话不能收回该设备已下载或本地保存的副本，也不会删除账户资料。
  • 如提示账户或登录已变化，刷新并核对当前账户后再操作。API Key不在此列表中，需到开放平台单独撤销。

下载个人数据

在网站登录后，进入「账户设置 → 个人数据」，点击「完整数据备份（JSON）」。此项免费，无需升级套餐；与阅读页的文稿导出、资料库的批量导出分别使用。

文件包含账户信息、登录方式与设备的元信息、会员和额度记录、资料库中的文件夹／合集／标签／阅读位置／回收站整理记录、私人笔记及版本、划线和批注、问答及对话历史、总结模板与生成请求设置、订阅及处理记录、提醒设置及投递状态、自己创建的分享和反馈，以及当前有权读取的原文、总结和相关历史。所有分页都会读取，不限单批 100 份资料。内容以下载开始时的状态为准；已作废或失去权限的原文依据及相应受保护生成稿不会借此恢复。

完整备份还包含私人笔记、模板稿及相关历史中的富文本格式，以及已经保存、当前仍有权读取的私人图片字节和校验信息。未保存图片、外链图片文件、音视频原件和来源画面原件不包含在其中。资料在回收站或图片已无权读取时，会注明图片不可用，不借备份恢复读取权限。

这是下载时的资料与文件快照，不能直接导回知否。文件的 media 列表保留本人原件的名称、大小、状态和期限；需要音视频原件时，请在有效期内从云空间另行下载，具体规则见原件保留与云空间。以前下载的文本备份不会自动补入图片，需要时重新下载完整备份。

文件不包含验证码、登录令牌、设备授权码、API 密钥及其哈希、浏览器推送密钥、退订口令和第三方连接密钥。你自己输入的正文、链接和分享记录仍可能含私人信息，请妥善保存文件，不要随意公开。

请使用网站的登录状态下载；插件令牌与开放平台 API Key 不提供整账户下载。进度和下载失败提示由浏览器管理。会话失效、账号被停用、网络中断或下载被取消时，请重新登录或排除问题后重试；没有完整结束的文件不能当作完整备份。成功文件为可解析的 JSON，末尾有 complete: true 和各类记录数量。

连接 Notion

  1. 在「账户设置」的「笔记同步」找到 Notion 入口后，点击连接并按授权页面选择允许知否访问的范围。
  2. 返回知否确认「已连接」。
  3. 打开要发送的资料，先选择正确的总结版本，再打开「导出」选择「Notion」。发送需要有效 Plus 或 Pro。
  4. 按回执打开 Notion 页面核对。若提示部分保存，已创建页面可能只含前半段，请勿当作完整备份。

请在同一浏览器、同一知否账号中完成授权。切换账号或授权过期后，请回到「账户设置」重新连接 Notion。

连接 flomo

  1. 从自己的 flomo 账号取得 API 地址，注意其会员和 API 使用条件由 flomo 决定。
  2. 在「账户设置 → 笔记同步」的「flomo API 地址」填写后「保存」。不要把包含凭据的地址发给他人。
  3. 回到资料，选择总结版本，打开「导出 → flomo…」，预览内容和分条数量后主动发送；需要有效 Plus 或 Pro。
  4. 逐条核对回执。明确拒绝时处理原因后再继续；网络超时或结果未知时先到 flomo 核对，避免从头重发造成重复。

连接并不等于自动同步，只有主动发送才向第三方写入。断开连接停止后续使用，不能收回已发到第三方的内容。完整恢复规则见导出与分享。

管理提醒与分享

顶部铃铛进入「完成提醒」，可查看站内通知，再按页面提供的方式开启提醒。订阅新集和所有新总结的范围不同，详见订阅与完成提醒。

浏览器通知设备随开启它的登录管理：退出对应登录或撤销该登录设备后，对应设备停止接收后续提醒。用 API Key 登记的设备随密钥撤销，独立于网页登录。已送到设备或推送服务的通知无法撤回。

若设备显示「需要重新开启」，请在对应浏览器登录后点「开启本设备通知」；也可点「停止此设备」移除不用的记录。重新开启只接收之后新完成的总结，不补发历史提醒。

停止设备时若提示「设备通知未能更新」，记录会保留，请在浏览器权限与网络恢复后重试；失败提示不代表已停止。账号已变化时先刷新当前登录状态，再管理对应设备。

「我的分享」集中列出有效的单版总结与多模型比较链接，可按分享标题、资料标题、作者或分享短码搜索，分页查看、复制、打开或撤销；比较链接标明「模型比较」。某次比较的有效与已撤销历史，可在阅读页的「分享比较」中查看。具体创建方式见公开分享比较。撤销站内链接不会删除对方已下载或转存的副本。本人上传、文档、私人稿和笔记的权限不会因公开来源存在而自动改变。

注销账户

「个人数据」下载包含本人比较分享的公开快照、创建及撤销记录。资料在回收站中或原文已不可读取时，只保留分享记录，不打包正文。注销账户会移除这些站内比较分享；他人已经保存的副本仍需自行处理。

原资料后来不可读取时，仍可按分享标题或短码查找并撤销已有链接；分享管理不会显示或搜索他人的新来源信息。

  1. 先在「账户设置 → 个人数据」下载需要保留的记录，并到云空间另行保存仍可用的原始音视频。
  2. 在「账户设置 → 注销账户」进入确认页，填写当前账户的完整邮箱，勾选已保存数据并理解不可恢复，再「发送注销验证码」。最后一位正常使用的管理员需先安排另一位管理员。
  3. 输入邮件中的注销专用6位验证码，再点「确认永久注销」。验证码10分钟内有效；登录验证码不能用于注销。重发后使用最新验证码；错误3次、过期、刷新页面或重新登录后需重新申请。旧注销邮件链接已停止使用。

邮件或注销失败时按提示重试，未显示成功前不要把失败回执当作账户已注销。切换账户或登录设备后，原注销验证码不能继续使用。

确认成功后，账户及登录授权失效，私人资料、整理、笔记、对话和设置不可恢复；私人文件由后台继续清理。当前浏览器中该账户的录制暂存、笔记及模板草稿（包括富文本草稿）会清理，其他账户的内容和阅读偏好保留。若提示本地暂存未清理，请清除知否的网站存储，并关闭其他知否页面。

已验证公开的资料仍可供其他读者使用，不会因某个账户注销而删除其他读者的公开内容或共享任务。最少的安全、运行和清理记录保留在受保护系统中；清理标识用于防止旧上传内容被重新接管。已下载文件、第三方保存的内容和其他设备上的本地副本需自行处理。重新注册不会恢复原账户资料。

API 与 MCP：给程序和 AI 助手使用

  1. 登录后打开顶部开放平台，在「API Key」填写名称，点击「创建 Key」。每个账号最多保留 5 把，明文只展示一次，创建后妥善保存。
  2. 程序使用页面提供的 REST／OpenAPI 说明；支持 Streamable HTTP 的 AI 助手复制页面中当前站点的 /mcp 地址，把自己的 Key 放在 X-API-Key 请求头。开放平台文档只包含账户可用的产品接口。
  3. 可搜索、列库、读取资料、提交链接、查任务状态、取消或重试，也可让助手管理笔记与文件夹。提交链接后先查询进度，完成后再读取结果。
  4. API 与 MCP 采用本人账号的读取权限、套餐与额度，不会因为用程序调用就解除导出限制或获得额外免费次数。停用某个客户端时可撤销对应 Key。

普通网站和浏览器插件用户无需创建 API Key，也不需要提供模型厂商密钥。Key、验证码、Cookie 和笔记同步凭据都不应出现在公开分享或问题反馈中。

密钥列表中的「最近验证」按北京时间记录这把密钥通过身份校验的时间，业务请求失败也会记录。「暂无验证记录」不代表从未使用；历史调用不会补写时间。撤销密钥或停用账户后，后续验证会被拒绝，不再更新记录。

程序提交的普通 JSON 请求默认每次最多 32 MiB，手工稿校正保留 64 MiB，MCP 每次最多 5 MiB，按实际 UTF-8 字节计算；已有入口中更小的限制仍适用。REST 使用 gzip 时，传输内容和解压后内容分别受限，压缩不能扩大允许规模。遇到「请求内容过大」时，请缩短内容或分批提交；文件上传继续以页面所示容量为准。

Agent 笔记管理

让已连接 MCP 的助手先查找和阅读，再提出整理方案。例如：「查找上周关于摄影的资料，读完正文和我的批注，建议分类目录，确认后再移动。」助手只能使用你的资料和真实目录，不会因知道其他账号的 ID 就获得权限；回收站资料需先恢复。

任务工具与操作
找到资料zhifou_notes_find 默认按创建时间倒序；支持标题关键字、原始完整链接、时间和文件夹。正文全文检索使用 zhifou_search。
阅读内容zhifou_note_read 的 views 列出内容及最近 60 个已有润色／译文版本。markdown 读取正式文字笔记的兼容 Markdown 投影，其他资料读取原文；note 读取私人笔记的 Markdown 投影，不能完整保留全部视觉格式。document 读取完整富文本 JSON、Markdown 与版本信息，图片是需鉴权的引用，并非图片文件。还可选择 summary、overview、outline、transcript，或用真实 editionId 读取 edition。缺少总结或尚未完成的版本会明确提示。
查看个人记录zhifou_note_records 读取私人笔记的版本信息和划线批注；私人笔记正文使用阅读工具的 note 视图。
创建文字笔记zhifou_note_create 接受标题、Markdown 和可选文件夹，标题 1—300 字，正文最多 20 万字符并沿用文字导入的段落限制。先确认内容及目标，传入 confirmed: true 和本次创建的 UUID requestId。创建不自动总结或扣总结次数，正文可在网站「笔记」继续编辑。
整理目录zhifou_folders 读取完整文件夹树与资料数；zhifou_folder_create、zhifou_folder_update、zhifou_folder_delete 分别创建、重命名／移动、删除目录。沿用最多三级目录等网站规则。删除会将子目录和资料移到上一级。
移动资料zhifou_notes_move 一次移动 1—100 篇本人资料，目标为真实文件夹 ID 或 null（根目录）。任意资料或目标无效时整批不执行。先阅读内容和个人记录、确认分类方案，再执行并回读位置。
保存 Markdownzhifou_note_export 默认导出私人笔记，可选择总结、原文、批注和已有派生稿等内容；沿用 Plus／Pro 导出权益。将全部分块原样拼接后保存为 .md，不要把失败提示或半份内容当作文件。含私人图片需要 ZIP 时，会提示改用网站导出面板，不能把该提示保存为 Markdown 文件。

所有写入或删除工具都需要 confirmed: true。助手应先展示标题、正文、目标目录及影响，按你的授权执行，随后回读核对。创建回执不明时沿用原 requestId 重试；同 ID 改内容会被拒绝。创建后的编辑、移动、目录删除或回收不会被旧创建请求覆盖或撤销。新笔记使用新 ID；创建文件夹回执未知时先读树核对，避免重复。

现有 MCP 可新建文字笔记；已有正文请到网站「笔记」继续编辑。旧 Markdown 客户端不能直接覆盖已保存的富文本，可换用新版编辑器；确需纯 Markdown 时，在网站选择「Markdown编辑 → 确认转为Markdown」并保存，之前的格式可从历史恢复。

查找每页最多 100 篇，用返回的 nextBefore 作为下一次 before，保持相同筛选。createdFrom 为包含的起点，createdTo 为不包含的终点，均使用带 Z 的 UTC 时间；文件夹设为 null 仅查根目录，省略则查全部。批注每页最多 100 条，也需跟随其中的 nextBefore。

阅读、个人记录及导出每块默认 4000、最多 8000 个 Unicode 码点。先从 offset: 0 读取，将返回的 nextOffset 传给下次 offset，并携带首块的 sha256 作为 expectedSha256；直到 nextOffset: null 才表示这份内容读完。个人记录需先读完当前块中的 JSON，再跟随其中的批注分页游标。内容变化会拒绝续读，此时从首块重新获取，避免混用版本。密钥撤销或账户停用后不能继续调用。

命令行：提交、等待和下载

安装 Node.js 24 或更新版本后，下载独立的知否命令行脚本，保存为 zhifou.mjs。无需安装项目依赖或内部开发工具。先在开放平台创建 Key，再通过环境变量 ZHIFOU_API_KEY 传入；不要把 Key 放进命令参数或脚本文件。默认服务为 https://zhifou.app，自托管可设置 ZHIFOU_URL 为自己的 HTTPS 根地址；明文 HTTP 仅接受本机回环地址。

PowerShell 示例（把占位内容替换为自己的 Key 和 ID）：

$env:ZHIFOU_API_KEY = '你的开放平台Key'
node ./zhifou.mjs submit 'https://www.bilibili.com/video/BV1xx411c7mD/' --wait
node ./zhifou.mjs status '任务ID'
node ./zhifou.mjs read '来源ID'
node ./zhifou.mjs transcript '来源ID' --format srt --output './字幕.srt'
node ./zhifou.mjs export '来源ID' --format md --output './总结.md'

submit 返回任务 ID；--wait 先输出接纳结果，再输出终态，两行都是 JSON。完成结果中的 source.id 用于读取、字幕下载和导出。多条链接可一起提交，再分别使用 wait 任务ID 等待。等待默认上限30分钟，可用 --timeout 秒数 调整；超时或按 Ctrl+C 只停止本地等待，远端任务仍可查询。取消远端任务使用 cancel 任务ID，重试失败或取消的任务使用 retry 任务ID；重复提交沿用服务端幂等规则，不额外建立相同任务。

search '检索词' 搜索本人的资料；list --limit 20 列出任务，下一页用返回的 nextBefore 传给 list --before '游标'。read 返回资料 JSON，transcript 支持 JSON／TXT／SRT／VTT／Markdown；export 下载总结，支持 Markdown／TXT／HTML／Word／PDF／EPUB／JSON／可编辑PPTX／互动演示HTML，沿用现有导出权益和服务器可用性。需要选择更多导出内容时使用网站导出面板。输出文件必须是新文件，已有文件不会覆盖。

使用 node ./zhifou.mjs sync --directory './我的笔记' --watch 可以持续保存本人已完成资料，支持相对画面、字幕和本地改动保护。内容设置、命名与可选自动润色见自动保存到本地文件夹。

用 node ./zhifou.mjs --help 查看完整命令。退出码0表示成功，1表示参数、接口或文件错误，2表示等待的任务失败、取消或需要浏览器协助，3表示等待超时，4表示本地同步冲突，130表示本地中断。接口错误写入标准错误，不会写成下载文件；Key撤销或账户权限变化即时沿用服务端检查。

按当前产品流程维护 · 查看版本变化 · 套餐和用量以账户实时信息为准