01必需
确认已有完整离线目录本次公开的是 R 更新安装器；需要保留原完整离线包及其中的 offline-payload 目录。
更新前确认前往下载页HELP CENTER / ALPHA
卡在哪一步，就查哪一步。
当前提供 Windows Alpha · R 更新版（已有完整离线包）。需要已有完整离线包和其中的 offline-payload；本页公开的更新 EXE 不能独立完成全新安装。
BEFORE UPDATE
已有完整离线包，再按这六步更新
保留原完整目录，确认其中有 offline-payload。没有该目录时，不要把旧 alpha.14 下载或单独的 R EXE 当作完整离线包；本次未公开第三方软件载荷。
02本机更新
替换安装器并原位修复先等任务结束、保存笔记并退出旧安装向导、Obsidian 和 ZCode，再替换原目录中的 EXE，点击“安装 / 修复本机”。
保留原数据03检查
检查 Kimi 配置已有 Key 会保留，无需重复填写。只有待配置时才在本机输入自己的 Key。
按需填写创建 API Key04确认
重开 Obsidian 与 ZCode确认新版“知识激活”助手已载入，ZCode 选择自己的“视知库助手”项目。
保留原工作区查看更新帮助05按需连接
确认平台与微信连接原登录状态会保留；失效时在专用 Firefox 或 ZCode 官方 Bot Channel 中亲自扫码。
本机操作查看扫码教程06检查 → 使用
先本地检查，再继续任务先用向导的本地连接检查；ZCode / 微信实际调用另行确认，路由模型可能计费。已有结果优先恢复或查看。
避免重复生成推荐只登录你实际使用的视频平台
隔离 Firefox Profile 会在本机保存登录状态，用于更稳定地获取视频和画质；不需要把 Cookie 交给官网。
IN-PLACE UPGRADE
已经装过？不用卸载，原位升级
R 更新安装器修复“知识激活”生成前的文件检查。当前 Alpha 没有静默自动更新；更新前等任务结束，并保留原离线包、Vault 和全部登录配置。
- 01等任务结束，先退出旧安装向导
保存笔记，正常退出旧安装向导、Obsidian 和 ZCode（包括托盘），确认关闭后再替换 EXE，避免文件锁定。不要清理原 offline-payload、Key、笔记或登录状态。
- 02下载 R 并放回原目录前往下载页
核对下载页 SHA-256，将 R 的
VideoToObsidian.Setup.exe放回已有完整离线目录，替换旧安装器并保留offline-payload。 - 03执行原位修复
运行该目录中的 EXE，保持原来的 Vault 路径不变，点击“安装 / 修复本机”。缺失载荷时先恢复原完整目录，不要删除 runtime 硬修。
- 04重开并确认新版助手
正常重开 Obsidian 与 ZCode，确认“知识激活”助手载入，先用向导做本地连接检查。已有结果先恢复或查看；重新生成可能产生模型费用。
原位升级会保留
Kimi Key、抖音/B站登录状态、Obsidian Vault、ZCode 工作区、已有笔记、总结偏好和可复用检查点。
DECISION TREE
没有出现？先对照症状处理
Obsidian 里没看到知识库
- 回到安装器，确认 Vault 路径并执行一次修复。
- 完成后点击“用 Obsidian 打开”。
- 仍未出现时，在 Obsidian 选择“打开文件夹作为仓库”，选择安装器显示的整个目录。
不要新建第二个同名 Vault，也不要手工修改 .obsidian 或插件文件。
ZCode 里没有“视知库助手”
- 在完整离线目录运行 R，点击“安装 / 修复本机”。
- 完成自己的 ZCode 账号连接及首次偏好设置，保持向导开着。
- 按向导提示核对自己的“文档\视知库助手”目录并亲自确认信任；已有项目直接选择。
不要只打开其中的 AGENTS.md，也不要在其他编程项目里连接微信 Bot。
右侧没有“知识激活”助手
- 先关闭并重新打开 Obsidian。
- 若出现 Restricted Mode 提示，允许社区插件并关闭受限模式。
- 再重启一次 Obsidian。
这是 Obsidian 的一次性安全确认；插件不显示或保存 Kimi Key。
SAFE AGENT FALLBACK
还没恢复？把受限任务交给本机 Agent
先完成上面的原位修复。仍然失败时，导出“脱敏诊断报告”，再把下面整段任务文本交给能够操作这台 Windows 电脑的 Agent。不要附带 API Key、Cookie、验证码或个人视频。
只处理视知库不碰其他项目不改 .obsidian不读取 Key / Cookie不触发付费分析
请只修复本机“视知库”安装，不要重装系统，不要删除任何笔记、Vault、浏览器 Profile、API Key 或 ZCode 项目，也不要修改“视知库助手”以外的 ZCode 配置。
请按顺序执行：
1. 只读检查 %LOCALAPPDATA%\VideoToObsidian\runtime\Scripts\video-to-obsidian.exe 是否存在；
2. 运行 doctor --json 和 onboarding-status --json，输出时不得显示 Secret、Cookie 或完整本机路径；
3. 检查“文档\视知库助手”是否包含 AGENTS.md、README.md、.zcode/config.json 和 .video-to-obsidian-workspace.json；
4. 若工作区缺失，仅调用 bootstrap-workspace --workspace <该目录> --json 重建受管文件；
5. 不要手工编辑 Obsidian 的 .obsidian。若 Vault 未登记、插件缺失或 Obsidian 正在占用配置，请让我关闭 Obsidian/ZCode 并重新运行官网当前安装器的“安装 / 修复本机”；
6. 修复后重新运行 doctor 和 onboarding-status，只报告通过项、失败项和下一步；
7. 不调用 analyze_douyin、analyze_bilibili 或 knowledge-run，不产生任何付费调用。
遇到非受管目录、无效 JSON、多个 Vault 无法判断或路径与安装器显示不一致时立即停止并询问，不得猜测、覆盖或迁移数据。选中上方整段文字即可复制。查看完整 Windows 恢复文档
SUCCESS CHECK
更新后，逐项确认实际状态
向导的本地检查通过，待配置项已经处理
Obsidian 能打开你选择的 Vault
Obsidian 右侧能看到“知识激活”助手
ZCode 打开的是“视知库助手”工作区
需要微信入口时，确认官方 Bot 绑定与实际工具回复
抖音或 B 站只登录你实际使用的平台
本地检查不调用模型。ZCode / 微信实际调用可能使用路由模型；视频分析和知识生成使用你自己的模型账户，已有结果优先恢复或查看。
COMMON QUESTIONS
常见问题
怎样确认拿到的是 R 更新安装器？
当前构建是 0.1.0-alpha.14+private-offline4r。以下载页公布的 SHA-256 核对文件；旧 GitHub alpha.14 标签和旧网盘分享不能作为 R 文件来源。
以后会自动更新吗？
当前 Alpha 没有静默自动更新。现阶段是：等待任务结束并保存笔记 → 退出旧安装向导、Obsidian 和 ZCode → 核对并替换完整离线目录中的 EXE → 点击“安装 / 修复本机”。保留原 offline-payload、Key、笔记与登录状态。
SmartScreen 或安全软件阻止安装怎么办？
R 安装器尚未代码签名。核对本站下载地址与 SHA-256，并保留拦截提示和脱敏诊断；不要关闭防护、添加排除项或强行恢复被隔离的文件。原 alpha.14 历史事件与 R 记录在证据页分开说明。
提示离线载荷缺失怎么办？
确认 R EXE 与原完整包的 offline-payload 位于同一目录，且完整包没有只解出 EXE。本次官网未公开第三方软件载荷；不要用旧 alpha.14 单文件或其他版本的零散文件拼装。
还需要一台中央服务器吗？
不需要。任务在用户自己的 Windows 电脑运行；官网和域名不是机器人工作的前置条件。处理时电脑与 ZCode 需要在线。
这个 EXE 能在空白电脑上独立安装吗？
不能。本次提供 R 更新安装器，需要原完整离线目录及其载荷。拥有完整离线包的用户继续使用原包依赖，本次更新不单独提供 Obsidian、ZCode、Firefox 等软件。
Obsidian 右侧没有“知识激活”怎么办？
首次打开新 Vault 时，Obsidian 可能要求你关闭受限模式并允许社区插件。这是 Obsidian 的一次性安全确认；允许后重启 Obsidian，助手会自动出现在右侧。
Kimi Key 保存在哪里？官网能看到吗？
Key 在本机输入并保存到 Windows Credential Manager。官网不提供 Key 输入框，也不会收到 Key。请不要把 Key 粘贴到聊天截图、Issue 或日志。
默认使用哪个模型？
默认使用 K2.7；只有消息中包含精确短语“使用K3深度分析”才启用 K3。模型价格会变化，请查看 Kimi 官方价格页。
怎样检查而不调用模型？
先使用向导的“检查本地连接（不调用模型）”。它只调用本机体检；从微信或 ZCode 发起同样的工具调用仍可能使用文本路由模型，不能把整个聊天过程承诺为零费用。
DeepSeek、Z.ai、Coding Plan 和火山怎么选？
DeepSeek、Z.ai 与 Coding Plan 目前只能作为 ZCode 的文本路由通道，不能替代 Kimi 对视频的理解。火山需要单独开发适配器，当前不能只填一个地址切换。
登录抖音或 B 站会上传 Cookie 吗？
不会上传给官网。用户只在隔离 Firefox Profile 中登录实际使用的平台，Cookie 保留在本机。项目不提供共享 Cookie，也不绕过会员、地区限制或 DRM。
会保存原视频或生成逐字稿吗？
标准模式默认不会。逐字稿是可选的本地增强，失败也不应阻止正式笔记；原视频只有用户主动开启归档时才保留。
当前支持哪些视频？
目前聚焦抖音和 B 站公开普通单视频。不处理直播、合集、番剧、交互视频、会员、私密内容或 DRM。
平台提示未登录或下载失败怎么办？
在安装器中点击对应的“登录抖音”或“登录B站”，只在弹出的隔离 Firefox 窗口里用自己的账号扫码。确认网页能够正常播放目标视频后关闭窗口，再重试一次。登录状态只保存在这台电脑。
任务超时或生成失败后怎么办？
先查看原任务状态、错误与已有结果，不要连续重发。需要升级时按本页步骤将 R 放回完整离线目录后原位修复；付费请求已经开始时，不承诺自动重试、远端立即停止或退费。
同一链接发了两次，会重复扣费或生成两篇吗？
系统会按稳定来源身份检查已完成任务和 Vault 中的正式笔记。已完成的同一视频应直接命中结果并阻止重复正式入库；如果你看到重复笔记，请停止继续提交并附脱敏诊断报告反馈。
在哪里导出诊断报告？
打开安装器，在“免费检查”区域点击“导出脱敏诊断报告”。桌面会生成 JSON 文件；它只包含检查状态，不包含本机路径、Kimi Key、Cookie、Bearer 或签名媒体地址，也不会发起付费调用。
总结不合口味怎么办？
直接在 ZCode 对助手说“以后总结更详细”“重点保留数据、例子和反讽语境”等偏好。长期偏好会保存在 Vault 外，不需要自己编辑配置文件。
仍然没有解决？
打开问题反馈 先导出安装器中的脱敏诊断报告，再到 GitHub 提交问题；报告不含 Key、Cookie 或签名媒体地址。