总览

# 总览

一、跨源综述（Synthesis · 11）

综合 ≥2 个不同来源才成立、可脱离项目带走的判断。

• 先定位归属层再动手 — 症状看起来在哪一层 ≠ 问题在哪一层；先用最便宜的观测划边界
• 口径先于数值 — 数字不可信几乎总是归属问题：先问分子是谁、分母是谁、时间窗是什么
• 对照才产生信息 — 单点不产生信息，先造一个 A/B；「说不清」多半是缺参照系
• 判据要用真值而非代理 — 用「事件序号/固定像素/循环动画/会话缓存」代替真实状态，必然静默出错
• 可复用物与不可复用物分开 — 按「寿命」分层：会过期的和不会过期的不能放同一层
• 分层要落到运行时才有效 — 分对层只完成一半；契约/适配器没人读，约束就等于不存在
• 契约只承载结构，个性留给扩展层 — 共享层只描述「有哪些位置/步骤」，视觉、格式、业务规则一律外推
• 更新时序要由本地最新状态决定 — 「谁最新」要靠显式版本记录，不能靠「谁最后返回」
• 存量不会自动跟上新逻辑 — 改对代码 ≠ 修好现状；存量数据、旧路径、未同步的层要单独带过来
• 真源要按维度显式指定 — 「谁新/谁全/谁像」都不是判据；先按维度把真源写死，再谈同步
• 定义要由使用者确认 — 分类法/术语/协议由单方给出必然错位；定义权要显式交给使用者并确认一次

二、主题聚合（Topics · 10）

标题即主题，页内是该主题下的多条判断。

• 执行力的复盘 — 野心是水不是火；结果锚点 vs 产出锚点；拖延是环境问题；难题逃避待解
• 数据指标的解读 — 整体 vs 净成、ROI 成对看、LTV 链路、必须补自然流量/内容/画像
• 用户访谈与需求挖掘 — 邀约措辞 + 第一句「先给料再提问」
• 多Agent协作控制面 — 协作控制面分裂；四层职责（入口/当前/隔离/知识）各配一种文件
• 本地优先知识产品的架构演进 — 云端加工厂 + 本地主仓库；Agent 先做可执行入口；AI 执行层可替换
• 简历模板的三层渲染协议与迁移 — data/layout/render 分层、section 只分 block|list、逐字段 slot 契约
• 几何题3D化的题库定位 — 产品形态是「题库播放器」；模型与切法由题目决定，用户不选
• UI原型保真 — 原型是唯一真源；逐片对照、共享 primitive、不用替代物、判断机制而非抄常量

三、可复用的判断（Concepts · 97）

AI 基础概念（ai-basics · 7）

• scaling-law — 能力随参数/数据/算力可预测提升；Chinchilla 打脸「只堆模型」
• 长尾查询 — 冷门具体查询决定搜索源的选择
• 实时与异步 — 选型不看技术难度，看内容变化速度
• 技术性通缩与经济学通缩 — 生产率降价是好事，货币通缩是病
• 缓存命中率 — 先怀疑「每次都是首请求」，再怀疑实现；测量动作本身可能绕过被测对象
• dogfooding — 用真实使用验证价值；是必要条件，不是充分条件
• 一词多义先确认所指 — 有 ≥2 种解释时先确认；反复追问 = 知识体系有洞

LLM 工程（llm-engineering · 11）

• 上下文成本由基础上下文和会话数决定 — 压缩只压历史；系统指令/工具 schema/最近原文是省不掉的固定包袱
• 计数闸门不等于上下文管理 — 条数护栏既不全塞也不滑窗，最坏输入没有 token 兜底
• 关键词检索的三个打分缺陷 — 只匹配标题、按 token 长度打分、中文整句切
• 检索要按难度迭代 — 先判难度定预算，读不通就换查询；停止看覆盖度
• 多账号模型路由机制 — model-aware 路由：按目录筛账号、请求内锁区、额度互补
• 模型可见性按入口分批 — 灰度按入口/账号放量，排查第一步是分入口
• 轮换要带健康状态记忆 — 记坏过的组合、按错误性质设冷却、给每次尝试设超时
• 评测平台是平台层项目规则是适配层 — 平台管版本/数据集/trace/评分，项目只写 fixtures/cases/runners/evaluators

Agent 与 Skills 生态（agent-ecosystem · 12）

• skill跨agent加载差异 — frontmatter 不兼容会导致整个 skill 被静默跳过
• 一次性凭证拿到就落盘 — 一次性授权码必须在第一次执行时就写入文件
• 通用脚本要靠工具适配器接入 — 跨 agent 的通用脚本要经各端薄适配器才被调用
• 作者是AI时协议要唯一规范答案 — 作者是 AI 时，友好 = 低歧义、唯一写法、可自动校验
• 多源更新按维度取真源 — skill 正文取上游、协议字段取本地；按维度定真源，不整体选「更新的那个」
• Agent harness 要隔离复现可收尾 — harness 三问（隔离谁/怎么复现/怎么收尾）；配置隔离同理
• Agent编排层薄自建优先于重型框架 — 能力边界明确时，权限边界比「框架功能丰富」更重要
• 项目里的技能可能有多份副本 — 多目录并存且内容不全；按单一目录名找就断言「没有」是错的
• 远程控制本机Agent要让bridge跑在本机 — Agent 只能操作所在机器；bridge 必须跑在被控端
• 远程Agent控制要定义执行协议与状态模型 — 只画 App 页面不够；先定执行控制协议 + 状态模型
• 改协议要同时改两端 — 服务端、客户端类型/连接逻辑、设置页说明三处要一起改

产品方法论（product · 8）

• 用户可感知的价值与差异化表达 — 价值只有变成用户能感知的对照才存在
• 北极星指标要量价值闭环 — 不量调用勤不勤，量产出有没有被采纳沉淀
• 一次循环只做一个可体验的v1能力 — 一个 loop = 一个连贯的 v1 能力，不是补丁也不是路线图
• 评审设计可行性先问方案再定难度 — 先问「你打算怎么做」，再谈难度；无歧义时不要问
• 修复范围分保守彻底与最小闭环 — 修复分保守/彻底/最小闭环三档；判据是「能否落在源头」+ 改动面最小
• 容器要有超出文件夹的意义才值得独立入口 — 只做到文件夹形态就该降级；判据是「去掉入口用户损失什么能力」
• 完整蓝图不等于同阶段交付 — 全量架构 + 分阶段落地，把「做什么」和「何时做」拆成两维
• 地基阶段先跑通基础件再谈抽象 — 地基期先跑通基础件与全路由骨架，过早抽象会拖慢且更难用

前端工程（frontend · 29）

• 流式更新要合并字段而非替换对象 — 整体替换会丢掉后加的字段，要用展开合并
• 延迟保存要捕获创建时的实体 — debounce 回调读「当前活跃对象」会把 A 写到 B
• 过期响应不能覆盖当前编辑内容 — 旧请求晚回来会用过期正文盖掉正在编辑的正文
• 编辑即时反馈与落盘延迟分离 — 内存立即更新 + 落盘 debounce，边界处 flush
• 编辑器显示不能脱离真实光标状态 — live preview 由本地光标位置决定，不由远端返回决定
• 跨源取数据要靠自建代理 — 不同端口即不同源；「UI 做不出来」其实是数据拿不到
• 进度条要由真实进度驱动 — 不能用无限循环动画假装加载；按经过时间推进
• 高频手势缩放不要走React状态 — 高频手势直接写 DOM，框架状态只留最终值
• flex子项的百分比max-height不可靠 — 父级高度隐含时百分比会退化成不可预期值
• 引擎不做建模器 — 复杂模型交给 Blender→GLB，引擎只负责切与渲染
• 兼容fallback会让内容重复渲染 — 新旧两条渲染路径同时命中同一份数据
• 可调与固定的边界按语义划分 — 可调/固定是语义属性不是 CSS 属性；固定区要连行距一起锁
• 控件参数要在下游被消费 — 值传到了但消费方没写，就表现为「调了没反应」且不报错
• 折叠动画要有收起态过渡 — 条件渲染只有进入动画；收起要过渡就得保持挂载
• 焦点环画在圆角外会露出四角 — 四角蓝影是通用 ring 画在圆角外；改这一处，不动通用组件
• 图片加载失败要可重试并升级到HTTPS — 失败状态不能整场会话永久化；http 图源优先升 https + favicon 兜底
• 条件return前必须调用所有hooks — 子层白屏第一嫌疑是条件 return 之后的 hooks
• 滚动层会裁剪溢出内容要与显示层拆开 — 滚动容器天然裁剪；滚动与显示要拆成两层 DOM
• 滚动条顶到固定栏要调视口而非隐藏滚动条 — 让滚动视口从 toolbar 下方开始；隐藏滚动条只是治标
• 依赖版本要锁主版本而非一律取最新 — 脚手架可最新，运行依赖按任务书 pin 主版本
• 手搓编辑器核心逻辑到深处要评估换社区方案 — 判据是「已在重写成熟内核的职责」；换方案 ≠ 照单收默认规则
• 浮层要收敛到一个共享primitive — 菜单/弹窗/下拉共用一处公共行为，否则逐页漂移
• 环境变量校验要按模块懒加载 — 未开发模块不该阻塞已可用功能；用到哪个模块才校验
• 隐藏态按钮要保留命中区 — pointer-events: none 会让按钮出现后也点不到
• 首次内容事件不能无条件跳过 — 判据应是「内容是否变化」，不是「事件序号」
• 显示阈值应按元素可见性而非固定像素 — 判据是元素实际位置，不是固定滚动距离
• 改版后旧路由仍指向旧实现 — 入口 route 仍 import 旧组件，就会绕开新布局
• 保存失败要落本地草稿并自动重试 — 失败路径用本地草稿兜底，不能只活在内存里
• 图片粘贴要上传对象存储换永久URL — blob: 会话级、data: 撑爆库；正文只存永久 URL

知识库架构（knowledge-base · 8）

• 知识入库的筛选标准 — 对未来有帮助 / 是知识非动作 / 有反复疑问（权重最大）
• 入库前先分层清洗 — 过滤层与判断层分开，噪声不留到提炼时处理
• 清洗合并会破坏源格式语义 — 验收标准是渲染出来的样子，不是文本一字不差
• 导入要保留来源类型以选对渲染链 — 落库要留 kind；多入口先归一化再入库
• 放宽过滤会连噪声一起放进来 — 修漏和修假是两件事；改闸门要换判据，不是拆闸门
• Agent读语义文件App读结构化存储 — Markdown 是唯一真源，SQLite 是可重建的派生层
• 数据权威模型要先于同步与迁移确定 — 先定 source of truth，再写同步/迁移/冲突/离线
• 文章元信息用发布日期而非创建日期 — 详情页用发布日期，创建日期只属列表；两类字段要分开存

本机排障（diagnosis · 22）

• 先分清平台错误还是应用错误 — 有无响应体决定是平台层还是应用层
• 以前能用最近坏了先查自己改了什么 — 默认假设是自己这边的回归，先看最近提交
• 讲bug先讲现象再讲根因 — 先说会看到什么坏现象，再说根因和改法
• 样式丢失先核对类名再怀疑缓存与权限 — 先比对组件类名与 CSS 里的类名；截图 ≠ 代码
• GitHub打不开先分清主站与静态资源域名 — 按域名分层测，别直接归因「被墙」
• 面板多出的固定区块先查数据源再改前端 — 先看接口实际返回什么，再改渲染
• 杀端口要区分服务端与客户端连接 — lsof -ti 会连客户端进程一起杀
• 高负载发烫先排除负载而非硬件 — 无风扇机型持续功耗直接变体感温度
• 仓库残留会误导对现状的判断 — 「代码里有什么」≠「运行时用什么」
• 同一应用开出两个窗口先查单实例限制 — 两个窗口 = 两个进程，先查重复启动与旧实例
• 文件被回退先分清是工具还是并发会话 — 先确认工具是否有写能力，再查并发写者
• INSERT OR IGNORE会让旧行不更新 — 新行字段对、界面仍旧值，先查插入语句；升级要配回填
• 功能缺失先确认运行的是哪份产物 — 构建完成 ≠ 安装完成；先读产物版本号
• 中转源不更新先分清是哪一层 — 直连 RSS 两段 vs 中转源三段；用同类源差异切分故障层
• 对照两端要用同一条标识 — 用中转页 URL 去查聚合端必然「查不到」；先排除标识不匹配
• 合盖仍会睡眠后台任务会被中断 — 后台任务能否跑完由 macOS 电源管理决定，不由 agent 决定
• 需要认证的命令不要并行执行 — 并行会各自发起授权，弹出两个授权页；先确认登录态
• 远端主线可能与本地主线无共同祖先 — 先 merge-base；无共同祖先不能普通 merge
• 真机白屏先分清Debug包与证书 — 两个最平凡原因：证书未信任、装的是 Debug 包
• 本机卡顿先清残留开发进程 — 「越来越卡」常是残留 dev server / build / 缓存目录
• 备用构建目录不要嵌在next目录里 — 嵌进 .next 会触发 manifest 竞态；改用同级目录

四、待探索（有问题没答案 —— 最有价值的钩子）

• 遇到具体难题想逃避，怎么破（已有环境/具体动作框架，缺难题切入法）
• 各渠道免费额度的刷新机制横向对比
• 数据缺趋势视角：环比/同周期对比怎么建
• 「RAG vs 微调」补成正式概念页（clean 里只有 agent 提及，缺提问作为依据）

共 118 页 · 更新于 2026-09-21