开发工具
共 415 篇文章
LangGraph 恢复 interrupt 后，日志和前置操作又执行了一遍
人审恢复会重跑被中断节点的前置代码。拆分准备与人审节点，核对持久化、业务幂等和权限，避免只看最终状态就漏掉重复操作。
AutoGen 重载终止条件后，用户消息也触发了 TERMINATE
AutoGen 0.7.5 保存再加载 TextMentionTermination 时，sources 过滤可能丢失。对照配置往返，显式构造来源规则，并区分 reset 与会话状态。
LangGraph Agent 反复调用 save_memory，最后报 GraphRecursionError
检索已有结果，Agent 却反复调用 save_memory。按工具请求、结果与图路由判断循环，再设置业务上限和真正的结束路径。
Spring Security 配了 permitAll，为什么 POST 还是 403
permitAll 不跳过 CSRF 检查。默认会话应用先获取当前 token，再随表单或同源 JSON 请求提交；区分安全链、过期会话和请求体错误，保留 CSRF 防护。
uuid/v1 报 ERR_PACKAGE_PATH_NOT_EXPORTED：改用包入口的命名导出
uuid 8 移除旧深层入口后，应从 uuid 包入口导入对应函数；核对真正的调用方和依赖版本，保留算法，并区分 uuid 12 起的 ESM 范围。
Android 13 通知不显示也不弹权限框：检查 POST_NOTIFICATIONS 和通知渠道
Android 13 通知不显示时，区分 targetSdk 对弹窗的影响，检查 POST_NOTIFICATIONS、用户选择、升级预授权及通知渠道。
.gitignore 写了 !.keep，子目录中的文件仍被忽略
.gitignore 的文件例外无法穿过已被忽略的父目录。用 check-ignore 定位规则，先放行目录再保留 .keep，并通过添加预览确认例外范围。
TypeScript API 检查外部项目报 TS2688：配置位置没传给 Program
外部项目已安装类型包却报 TS2688 时，核对 Compiler API 是否传递配置位置。保留 TypeScript 5.3–6.0 范围、类型根目录和原工具入口的验收条件。
NumPy 条件判断报 truth value ambiguous：区分筛选、聚合与判空
NumPy 条件组合触发 truth value ambiguous，按逐元素筛选、any/all 聚合与 size 判空选择表达式，保留括号、空输入和短路求值边界。
Windows 执行 NODE_ENV=production 报不识别：修正 npm 构建脚本
Windows 把 NODE_ENV=production 当成命令时，区分终端与 npm script-shell，用项目 cross-env 构建入口设置变量，保留 Node 版本与构建依赖安装条件。
PEFT 报 Target modules not found，LoRA 应该挂到哪一层
先读取真实模块名称，再区分 target_modules 的字符串正则与列表匹配。说明模型结构、层筛选和训练参数验收，避免套用其他模型的 q_proj 名称。
PHP 用 strpos 大于等于 0 判断包含关系，未找到字符串也进入分支
strpos 返回整数位置或 false，非严格比较会让未找到也通过。用 !== false 保留位置 0 的有效匹配，并明确空输入和 PHP 版本条件。
真机能编译，iOS 模拟器却提示链接了 iOS 库：检查 XCFramework 的平台切片
真机构建成功、模拟器报平台不匹配或缺库时，核对 XCFramework 的平台与架构切片，分别归档并统一打包，明确旧库临时排除 arm64 的限制。
pytest 报 ScopeMismatch：长生命周期 fixture 不能依赖短生命周期对象
pytest 长范围 fixture 依赖短范围资源时报 ScopeMismatch。按依赖链缩短缓存范围，或拆分长期初始化与逐测试状态，保留事务、临时资源和清理的隔离责任。
pnpm 安装发布包报 WORKSPACE_PKG_NOT_FOUND：检查包内未转换的 workspace 协议
pnpm 安装发布包报工作区依赖缺失时，区分本地成员遗漏与包内残留 workspace 协议，核对打包后的清单和外部消费结果。
Git 已设置 safe.directory，后续命令仍报 dubious ownership
checkout 成功，后续 Git 命令仍报 dubious ownership 时，在失败步骤中核对用户、HOME、仓库路径和配置来源，只为确认可信的目录添加例外。
Vite 开发时缺少 default 导出：链接的 CommonJS 包没有进入预构建
链接的 CommonJS 包在 Vite 开发模式中缺少 default 导出时，核对实际入口、显式预构建和缓存，并单独验收正式构建。
Webpack 报 ERR_OSSL_EVP_UNSUPPORTED：检查 OpenSSL 与 loader 哈希链
Webpack 在 OpenSSL 3 环境报哈希算法不支持，沿堆栈核对 Webpack 与 loader，区分 xxhash64 配置范围、依赖升级和临时 legacy provider。
Git fetch 后仍看不到其他远程分支
单分支克隆后，git fetch --all 仍可能只更新原分支。确认远端目标分支存在，检查 remote.origin.fetch，并按需追加一个分支或恢复全部普通分支的抓取范围。