knowledge-base · 个人经验库

沉淀所有项目（AE 脚本 / C4D 插件 / Blender 插件 / Web 项目 / 小程序）的可复用经验。 原则：写的时候多花 10 秒，找的时候省 10 分钟。

🔗 关联管理仓库：codebuddy-skills（个人技能仓库）+ hub-world（项目导航/文档快照中心）——本仓管"经验"，那边管"技能/项目"，互相引用。

一套方案，两个层级（单项目 + 多项目）

层级	管理对象	入口	核心内容
单项目	每个仓库内部	单项目规范/README.md	4 文件分层（README / AGENTS / DEVELOPMENT / CHANGELOG）+ 生长式拆分
多项目	全部仓库的经验沉淀	本文件（README）	四分类 + 总导航 + 提炼管道

配合流程：单项目踩坑 → 记录进该仓库的 DEVELOPMENT.md / docs/问题记录/（与本文档同模板）→ 项目收尾或季度回顾 → 提炼跨项目通用的内容 → 存入本库 解决方案/、速查表/ 等。

仓库盘点（断点索引）

是什么：仓库盘点表.md 记录所有仓库的文档规范状态——哪些已按单项目规范重写、重写日期、基线 commit，以及未完成/未处理的仓库清单。

为什么：仓库重写完成后必须留下基线标记（日期 + commit hash）。否则以后更新了没人记得"重写到哪"，可能从头重写。基线 hash 支持 git diff <基线hash> 精确对比"上次重写后改了什么"——断点续传。

怎么用：

• 查：要更新某仓库前，先看盘点表拿到它的基线 commit → git log --oneline <基线hash>..HEAD 看增量
• 维护：更新仓库后四步回填——① 该仓库 CHANGELOG 追加版本 → ② AGENTS 基线行更新 → ③ 本表回填新 hash → ④ 推送

规则详见 单项目规范/README.md 第九节「文档基线」；每条仓库的基线行在各自 AGENTS.md 顶部。

目录结构

knowledge-base/
├── README.md            # 本文件：总导航
├── 仓库盘点表.md        # 全部仓库的规范状态 + 基线 commit（断点索引）
├── 单项目规范/          # 单项目（单仓库）文档规范 ← 单项目层级
├── 解决方案/            # 踩坑与解决（一坑一篇）
├── 复用模式/            # 跨项目复用的模式 / 工作流（暂空，见下）
├── 速查表/              # 速查清单（拿来就用）
├── 模板/                # 脚手架 / 配置模板
└── 归档/                # 过时条目归档（[说明](./归档/归档说明.md)）

复用模式/ 当前无条目：原「单仓库文档规范」已独立为 单项目规范/ 模块，此分类待后续沉淀新的跨项目模式。

分类边界（放什么 / 不放什么）

目录	放什么	不放什么	索引入口
解决方案/	一个问题一篇文章：问题 → 根因 → 解决 → 预防	通用可复用代码 → 复用模式/	解决方案/索引.md
复用模式/	跨项目通用的模式 / 工作流	一次性问题 → 解决方案/	复用模式/索引.md（暂空）
速查表/	速查：API 清单、语法限制、常用命令	完整教程 / 长篇讲解	速查表/索引.md
模板/	可直接复制的脚手架、配置模板	需要解释说明的内容 → 解决方案/	模板/索引.md

场景速查（我在做什么 → 看这里）

• 写 AE 脚本（ES3 语法限制 / JSON polyfill） → 速查表/ES3语法限制速查.md
• 查哪些经验已做成技能 → 速查表/技能化清单.md
• 写 AE 脚本（ScriptUI 布局问题） → 解决方案/ScriptUI布局两坑.md
• AE 属性取不到 / matchName 不匹配 → 解决方案/AE2026中文版matchName兼容.md
• 做文字动画器（逐字 / 波浪 / 散落） → 解决方案/AERangeSelector只用Percent模式.md
• C4D 插件面板空白 / 二次打开崩溃 → 解决方案/C4D对话框生命周期与二次打开崩溃.md
• C4D 隐藏/显示不生效 → 解决方案/C4D可见性控制与状态快照.md
• C4D UI 控件莫名消失 → 解决方案/C4DPythonSDK参数命名坑.md
• C4D 选中/查找对象错乱 → 解决方案/C4D对象用GUID标识.md
• C4D 2026 迁移报错 → 解决方案/C4D2026SDK破坏性迁移清单.md
• C4D 用户数据默认值异常 → 解决方案/C4D用户数据写入类型与单位.md
• C4D 需要动态多列列表 → 解决方案/C4D动态列表控件方案.md
• Blender 面板列表卡 / 需手动刷新 → 解决方案/Blender面板缓存与手动刷新.md
• Blender 插件删除物体后撤销报错 → 解决方案/BlenderUNDO与bpy.data引用陷阱.md
• Blender 中文名称显示参差 → 解决方案/BlenderCJK字符宽度截断.md
• AE 粒子/批量随机错乱 → 解决方案/AE表达式seedRandom种子管理.md
• AE 面板控件错位 / 下拉失效 → 解决方案/ScriptUI可见性与控件状态陷阱.md
• AE 模糊边缘被裁剪 → 解决方案/AEMask与Effect渲染顺序.md
• AE 表达式不能用中文名 → 解决方案/AE表达式跨语言兼容.md
• AE 粒子分布/密度渐变 → 解决方案/AE表达式粒子分布与密度衰减.md
• AE 动画从播放头开始 / 清理生成图层 → 解决方案/AE动画时间基准与图层清理.md
• AE 用脚本生成图形（圆环/粒子） → 速查表/AEShapeLayer开发速查.md
• AE 2D/3D 属性赋值崩溃 → 解决方案/AE表达式维度继承用value关键字.md
• AE 音频驱动动画 → 解决方案/AE音频驱动图层方案.md
• 扩展取不到 Cookie / 权限问题 → 解决方案/MV3扩展权限三层防线.md
• 扩展 SW 注册失败 → 解决方案/MV3ServiceWorker注册规范.md
• 扩展重装丢数据 → 解决方案/浏览器扩展重装保留数据manifestkey.md
• 清除 Cookie 有残留 → 解决方案/Cookie操作URL前导点号.md
• 小程序接外部数据 / 域名白名单 → 解决方案/微信小程序域名与网络硬约束.md
• 小程序云开发双向同步 → 解决方案/微信云开发双向同步架构与防循环.md
• 云开发同步撞配额 → 解决方案/微信云开发同步变更检测优化.md
• 小程序识别当前用户 / 权限隔离 → 解决方案/小程序openid检测探针法.md
• 小程序页面闪退 / 授权后卡死 → 解决方案/小程序不用blockwxif配对.md
• 小程序 iPad / 大屏布局不生效 → 解决方案/小程序iPad大屏适配.md
• 小程序每次打开都全量拉云端 → 解决方案/小程序云缓存三层只刷当天.md
• Web 移动端 iOS 布局错乱 / 铺不满屏 → 解决方案/iOSSafari布局三坑.md
• Safari 页面突然卡顿（CDN 脚本） → 解决方案/关键JS库本地托管不用CDN.md
• Django 改内容丢用户数据 → 解决方案/数据表稳定唯一键与增量同步.md
• 前端 JS 全部失效 / Alpine 改了不生效 → 解决方案/前端JS两坑IIFE分号与Alpine写入.md
• Android 签名密钥泄露 / 仓库安全 → 解决方案/Android签名密钥绝不入库.md
• Android 13+ 通知不弹 → 解决方案/Android13通知权限运行时申请.md
• Android 后台拉起 App 被拦 → 解决方案/Android后台启动限制BAL与PendingIntent授权.md
• Android 闹钟到点不准 → 解决方案/Android精确闹钟声明权限不等于用对API.md
• Windows 窗口覆盖/蒙版工具 → 解决方案/Win32窗口操作三坑.md + 解决方案/托盘常驻程序生命周期设计.md
• PyInstaller 打包找不到文件 / 便携工具配置丢失 → 解决方案/PyInstaller路径与便携工具配置.md
• Android 常驻通知不显示 → 解决方案/Android前台服务通知渠道与时序.md
• Android 蒙版盖不住状态栏 → 解决方案/Android全屏蒙版盖状态栏刘海.md
• PowerShell 脚本中文乱码 → 解决方案/PowerShell中文乱码与先测量.md
• 监听新窗口/进程出现（避免轮询） → 解决方案/事件驱动替代轮询.md
• 桌面程序汉化 → 解决方案/桌面程序安全汉化方法论.md
• 本地工具"改了代码没效果" → 解决方案/本地服务防浏览器缓存旧代码.md
• 请求挂起 / 按钮一直转圈 → 解决方案/请求必须带超时与UI状态finally恢复.md
• 本地服务被其他端口页面调用被拦 → 解决方案/本地工具服务跨域被拦需开CORS.md
• 历史快照爆炸 / 折线趋势失真 → 解决方案/历史快照数据建模三原则.md
• 想规范单个仓库的文档 → 单项目规范/README.md
• 查看所有仓库的规范状态 / 基线 → 仓库盘点表.md
• 查看个人技能集合（管理仓库） → https://github.com/Simiely/codebuddy-skills
• 查看全部项目导航 / 文档中心（管理仓库） → https://github.com/Simiely/hub-world
• 忘记某条经验在哪 → Obsidian 打开本目录全文搜索

条目模板（怎么用）

新增经验条目的标准流程，复制模板文档，不用记规则：

1. 复制 模板/条目模板与使用说明.md → 改为中文命名（领域-主题，如 AE2026中文版matchName兼容.md）
2. 放到对应分类目录（解决方案/ 复用模式/ 速查表/ 模板/，边界见上表）
3. 按模板内的字段说明和正文指引填空（frontmatter + TL;DR + 问题/根因/解决/预防）
4. 更新对应 索引.md 加一行 + 本文件「最近更新」加一行

• 模板文档：模板/条目模板与使用说明.md（含字段说明表、每节写什么、空白模板）
• 完整示例：解决方案/AE2026中文版matchName兼容.md（首批条目均提炼自 AE-Lyrics-Animator，见该仓库 DEVELOPMENT.md）

维护规则

• 新增一条：① 套模板写一个 md 文件 → ② 对应 索引.md 加一行 + 本文件「最近更新」加一行
• 命名：中文命名，领域-主题（中文为主 + 必要英文缩写，不带空格），如 AE2026中文版matchName兼容.md（文件名即关键词）
• 归档：过时 / 不再使用的条目移入 归档/，活跃区保持简洁
• 提炼节奏：项目收尾或解决问题后顺手写，不搞额外复盘仪式
• 隐私红线（公开仓库）：禁止收录任何敏感数据——凭据（token / 密码 / API Key）、个人信息（邮箱 / 手机 / 住址）、本地绝对路径、未公开的项目细节。发现已收录 → 立即清理并提交说明
• 断点续传：更新某仓库后，① 该仓库 CHANGELOG 追加版本 → ② AGENTS 基线行更新（日期+hash）→ ③ 仓库盘点表.md 回填新 hash → ④ 推送（规则见 单项目规范/README.md 第九节）

最近更新

• 2026-08-03 新增「技能化清单」：3 条经验已技能化到 codebuddy-skills（es3/c4d-sdk-compat/quota-guard）
• 2026-08-03 三管理仓库互链完成：knowledge-base ↔ codebuddy-skills ↔ hub-world（README 互链 + 盘点表收录基线）
• 2026-08-03 与 codebuddy-skills 建立管理仓库互链（README 顶部 + 场景速查）
• 2026-08-03 修复孤立文档：分类边界表加「索引入口」链接、归档说明补链接、复用模式注明暂空
• 2026-08-03 新增「仓库盘点表」（24 个仓库断点索引：领域/四件套/日期/基线 commit）；单项目规范新增「文档基线」规则（断点续传流程）
• 2026-08-03 提炼 6 个工具仓库：新增 9 条经验（Win32 窗口三坑/托盘生命周期/PyInstaller 路径/Android 前台通知/全屏蒙版/PowerShell 编码/事件驱动/汉化方法论），Windows 桌面领域首建
• 2026-08-03 提炼 meituan-bike-reminder：新增 4 条 Android 经验（签名密钥不入库/通知权限/BAL/精确闹钟），Android 领域首建
• 2026-08-03 提炼 learning-platform：新增 4 条 Web 移动端 / Django 经验（iOS Safari 布局三坑/JS 库本地托管/稳定唯一键/前端 JS 两坑），Web/Django 领域首建
• 2026-08-03 提炼 potty-training-miniprogram：新增 4 条小程序经验（openid 探针法/block wx:if 崩溃/iPad 适配/云缓存三层），小程序板块共 7 条
• 2026-08-03 提炼 workbuddy-credits-tool：新增 4 条 Node/Web 工具经验（缓存旧代码/请求超时/CORS/历史快照建模），Node 领域首建
• 2026-08-03 提炼 miniprogram-item-expiry（删除前）：新增 3 条小程序/云开发经验（域名硬约束/双向同步防循环/变更检测优化），小程序领域首建

使用建议

本仓库是纯 Markdown，可用 Obsidian 直接打开本目录，免费获得全文搜索 + 标签过滤 + 双链图谱；在 GitHub 上浏览亦完全可用。