独立锁定默认翻转: 文物缺失、 绑定 Web 设置、 思维图、 下载预选

作者: teng-lin创建于 2026年9月6日更新于 2026年9月6日
标签enhancementdo-not-implement-yetP2

父级: #2376。 这些是 行为默认 / 签名删除 更改,它们有自己的通知窗口。添加性 API 已在 main 中存在(自 #2375 之后)。此问题只是后续的转换。 它们 不是 因为 v1.0.0 发布而授权的。如果它们的通知在一个 MINOR 版本中尚未出现在稳定版本中,则保留 0.x 默认值并计划在稳定版本中发布。 已提交的账本: docs/deprecations.md“独立 C3/C4/C5 迁移行” (标题是历史性的;从下面的行文中实现)。 1. 精确查找资产:停止将不完整的读取视为“缺失” 今天的 0.x - artifacts.lookup() / list_with_status() 已经区分了 FOUND / MISSING / UNKNOWN 和列表的完整性。 - 内部 CLI 获取/下载使用 lookup。 - 公共 get() / get_or_none() 仍然将不完整的未命中视为 ArtifactNotFoundError / None 并仅在备注支持的思维导图不可用时发出 artifact_ambiguous_absence。 完整的未命中和命中保持沉默。 - Android get_prompt(..., require_complete=False)(默认值)仍然通过传统的 get_or_none 路径,因此备注中断可能看起来像“没有此资产”。 require_complete=True 已经是严格的。 Web get_prompt 直接读取 Studio,并且已经在真正的未命中中引发;它 不应 生成冗余的聚合预检。 翻转(在警告发布后) - [ ] get() / get_or_none() 完全委托给权威性查找:不完整的未命中不是缺失( UNKNOWN → 存在的 RPCError,带有经过清理的不完整读取消息,而不是 404) - [ ] Android get_prompt 默认值变为 require_complete=True(或者默认路径变为严格的) - [ ] 仅 Studio 监测( poll_statuswait_for_completion)仍然是 Studio 专用;不要在其中引入备注依赖。 注册键: artifact_ambiguous_absence。 来源注册; 在发布版本中。 2. Web 请求设置:在构建时冻结而不是重新读取环境 今天的 0.x - WebBackendConfig.request=WebRequestOptions(...) 是添加性的。 省略它( None)保留 动态 的每次查找环境解析( NOTEBOOKLM_BASE_URL,语言,构建标签,传输,恢复命令/ shell)。 文档在 docs/configuration.md 中。 - 内部 CLI/MCP/REST 工厂已选择使用绑定策略。 - 两个具有不同端点/恢复命令的绑定客户端不应共享冷冻刷新流或将另一个策略的成功视为自己的。 翻转(在稳定预览/通知后 — 今天这行没有 Python DeprecationWarning - [ ] 默认(省略 request=) 在调用 NotebookLMClient(...) / from_storage(...) 时捕获进程默认 ,而不是在每个 RPC 中 - [ ] 绑定客户端将该主机/语言/传输/恢复策略注入主页,刷新,batchexecute,流式聊天,上传,资产下载和 notebook/share URL …

内容来源: teng-lin/notebooklm-py