查找问题与解决方法
SentenceSplitter 说 metadata 比 chunk 还长，缩短正文为什么没用
SentenceSplitter 的 chunk_size 还要容纳元数据 token。排除进入 embedding 和 LLM 的大字段，使用实际 tokenizer 检查剩余正文预算；只缩短正文可能无效。
getter-return 报普通 get 方法缺少返回值，先核对描述符参数位置
getter-return 曾把描述符 API 的目标或原型参数中的普通 get 误当 getter。修复会校验参数位置及全局调用，真实空 getter 仍应接受规则检查。
Redis 异步 ClusterPubSub 首次订阅报 slots_cache KeyError
redis-py8.1.0异步集群客户端第一次就订阅时，可能在初始化前查空槽表。先等待真实集群初始化，再启动订阅，并分开处理连接、缺槽与消息恢复。
esbuild 压缩嵌套 CSS 后，选择器多匹配了元素
esbuild 0.28.1 可能删掉嵌套选择器前的 &，改变内部 :not() 中 & 的含义。0.28.2 已修复；不能只看压缩后的样式仍是合法 CSS。
Transformers 的 generate 结果为什么包含输入提示词
decoder-only 的 generate 返回输入加新增 token。按实际 input_ids 张量宽度裁剪，区分左补齐批次、结构化返回、pipeline 与 encoder-decoder。
Commander 全局选项值来自父命令，来源却显示 cli
Commander15.0.0在父命令setOptionValue清空来源后，全局来源查询可能保留被覆盖的子命令cli来源。按真实来源写入配置，成对核对最终值与来源，不伪造优先级。
Pydantic ValidationError 反序列化报 Invalid error type: sequence_str
部分 Pydantic 自定义错误可以被 pickle 写出，却在还原 ValidationError 时失败。跨进程传递稳定的错误数据，保留字段位置与错误类型，别把反序列化失败当成原校验失败。
React Hook Form setValue 设 null 报读取 source 失败
React Hook Form 7.90.0 将默认嵌套对象改为 null 并更新 dirtyFields 时，可能递归读取空值。7.91.0 正式代码已增加空值保护，更新后同时核对当前值、脏状态及还原默认值。
TypeScript 检查压缩调用链时栈溢出，堆栈重复 getEffectsSignature
allowJs 项目混入压缩 bundle 时，长逗号调用链可能令 TypeScript 控制流检查递归耗尽栈。核对真实输入范围，排除误纳入的产物，并保留导入仍能拉回文件的边界。
mypy 并行报 No status file，检查插件导入是否挡住最后一次轮询
mypy 并行协调器被插件导入阻塞时，旧轮询可能漏读已写出的状态文件。采用修复版本，保留原插件和输入验证，并区分连接等待与实际 worker 启动失败。
AnyIO 发送被取消后，其他请求也报 BAD_RECORD_MAC
AnyIO TLSStream 的发送取消后，连接可能已处于未知状态。说明加密记录丢失的路径、HTTP/2 共享连接影响，以及关闭旧连接而非重放写入的边界。
Microsoft.Data.Sqlite 在 RHEL 8 报 GLIBC_2.33 not found，检查原生包版本
RHEL 8 上 e_sqlite3 文件存在却加载失败时，核对 SQLitePCLRaw 原生库的 glibc 需求；2.1.14 已为旧 Linux 兼容发布修正，重新发布并在目标环境验证。
Deno 按 Tab 报 invalid argument，修正 zsh 短选项规格缺失的横线
Deno 生成的 zsh 短选项规格曾漏掉横线，普通单行描述也会报 invalid argument。2.9.7 包含处理，更新后须重新生成脚本并测试实际补全。
Faiss 的 k 看起来是整数，SWIG 却拒绝参数类型
NumPy 整数标量和 Python int 在部分 SWIG 入口并不等价。按官方示例在调用边界检查类型、范围和向量形状，再显式转换 k；不泛化为所有 TypeError 的修复。
Python 构建发现多个顶层包，报 flat-layout 错误
根目录多个候选包会触发自动发现保护。先确定发行范围，再配置find与子包模式；namespace、单文件模块和src布局需按真实结构处理。
Python textwrap.shorten 长字符串只剩省略号，怎样保留前缀
textwrap.shorten 按词删减，不能保证长单词留下前缀。日志编号等确实要求按字符截断时，定义独立的前缀预览规则，区分字符数、显示宽度和 Unicode 组合字符。
打印 SQLAlchemy 聚合语句时报 use_function_name 缺参，先区分编译方言
SQLAlchemy 2.1 的 aggregate_strings 曾在 str(stmt) 中触发 TypeError。2.1.4 修复了字符串展示，但不支持的默认方言仍可能抛 CompileError；诊断 SQL 应使用真实目标方言。
Gradle Isolated Projects 启动卡住，检查 worker 数与嵌套构建数
Gradle Isolated Projects 的部分嵌套构建会在 worker 容量耗尽时无法推进。原报告确认提高 max workers 可绕过，具体值须结合构建数量与机器资源选择。
SQLAlchemy 反射 PostgreSQL 18 的 PERIOD 外键时报 NoneType.groups
PostgreSQL 18 时间外键可触发旧 SQLAlchemy 的反射正则错误。使用包含修复的正式版本后仍须复核迁移，因为 PERIOD 语义尚未完整保存在反射结果中。
InputGuardrailTripwireTriggered 已经抛出，为什么工具还是执行了
收到 InputGuardrailTripwireTriggered 后，界面显示请求被拒绝，但后台工具日志里仍能看到执行记录。若输入 guardrail 使用默认并行模式，这可能是执行时序造成的。