工作台账(维护交接)——换会话/换模型时先读本篇
位置:库根
工作台账.md(Obsidian 可见;.zcode/工作台账.md为指针)。更新时间:2026-10-06。 用途:本库跨会话的唯一进度真相。新会话接管时:先读本篇 → 再读记忆目录(~/.zcode/cli/memories/projects/ic-bc1cc886698f2347/memory/)的 MEMORY.md → 即可继续。
一、库现状(2026-10-06)
- 真实路径:
/home/sam/openlist/data/obsidian/(Obsidian vault「obsidian」内,挂载于 openlist 同步层)。 - 规模:323 篇 md(2026-10-07 实测)/ 876 张图 / 72 份 PDF(90_资料源 50 份一手 + IC datasheet 目录 22 份存档)。
- 结构(七板块 + 00 设计主线):
00_设计速查/(00_总览 + 选型决策/公式速查/故障反查/术语索引)10_基础理论/(按学科四类:01_数学 17 篇【全库数学归一处】 + 02_电路 10 篇【通识+电路分析课程+RCD吸收/驱动/EMI滤波设计】 + 03_控制理论 4 篇【原理/建模/补偿/实测】 + 04_开关电源 8 篇【概念/方法论/变换器理论】)30_经典IC精读/(八拓扑 · 21 个 IC 目录 · 8 横评 · IC 速查索引)20_基本元器件/(01_二极管 / 02_三极管 / 03_功率器件 / 04_隔离反馈器件 / 05_电容家族 / 06_电感磁件含磁材·变压器·磁珠 / 07_电阻 / 08_EMI滤波 / 09_保护器件含放电管)40_仿真验证/(01~09 编号连续 + 教程×3 + sim 工程目录)50_电源设计流程/(01~09 九篇)90_资料源/(50 PDF + 同名 txt + 00_总览)
- 根文件:
00_总览.md(板块表)、01_待核实与推断总表.md、02_工作台账.md(本篇)。 - 命名约定:全库
NN_中文名.md两位序号;目录入口笔记一律00_总览.md(原 README 已全部更名)。 - 标签约定:每篇 ≤2 个标签 = 内容叶子标签 +
类型/受控词表标签(导航/译文/引脚规格/原理分析/设计计算/排障/原厂精译/横评/讲义/专题/速查/答案/方法论/清单/维护)。
二、本会话已完成(2026-10-01)
- 六板块结构定型:40_工程实务拆分为 40_仿真验证+50_电源设计流程;10_基础与方法改名 10_理论与方法;2840 条链接经脚本重算零断链。
- B 层敌意审计(20_基本元器件)已完成修复:
- 英文残留 9 处(navigate/Employ/behaves/somewhat/generally/hit/extremes/bin/skill 泄漏)→ 全修
- 过期“待建/未译”引用 6 处(NTC/电容/EMI 的姊妹篇)→ 全修
- 光耦极点两个口径(4kHz 实测 vs 1.6kHz 估算)→ 两篇互加口径注
- TL431 源路径 datasheet/→90_资料源/;“19/21 颗”旧数→统一 20 颗;“七个→六个”子类
- 新建
01_功率器件/器件物理/README.md(补齐最后一个缺 README 的子类) - 坏体标记 2 处(未闭合加粗)→ 修
- 数据口径修正:全库 IC 数统一 20 颗(曾错写 21/19)。
三、未完成(新会话继续)
A/C/D 三层敌意审计已于 2026-10-01 完成(三层深审共 41 条语义问题,全部修复)。修复要点:- 真数值错 5 处:NCP1681 高线复算(8.77A 误用 → 正确 6.20A/10.2A/RCS 8.3Ω)、NCP1622 折返推导(1/13.3µs≠33kHz)、环路实测 ④ 相位因果写反、PCB 100k×10p 极点 16k→159 kHz、617 V 尖峰双口径澄清
- 教程硬伤 3 处:LTspice 教程与 03 实战矛盾(wine .tran 发散——已加警告块+读数改 4.7~4.8V)、电磁教程第 1 步标“示意骨架不可运行”、Gecko 教程补电压外环简化说明
- netlist 建模错误:03 篇 ESR 曾串错位置(电感-输出间 → 电容支路内),已按正确拓扑重跑 ngspice:ΔV_out 3.6→40.67 mV(ESR 主导,理论 44.8 mV 的 −9%),保留“拓扑伪值”教学注记
- 归类残留:XDPS21071 README 的“ACF 代表作 UCC28781”→ ZVSF/真ACF 分开表述;MP6951 搭配矛盾、NCP4307 起振阈值 4.0V、UCC28700 OVP 113.6% 等 12 处
- 总表行号系统性漂移:120 处引用经脚本重扫校正(条目关键词重叠启发式)
- NCP1622 版本码通配符(onsemi
A**/B**/C**器件码)破坏加粗配对 + 历史替换链残留(“同要点”等):全库孤儿**清理(7 文件),十项复扫全零
- 2026-10-01 续(全部欠账清册见 §二.4 注):四套 Gecko 实验课全部实跑对账完毕(新增 40 板块 05/06 两篇:DCDC/三相实战 + GetDP 能量法提电感实操,双线回路三电流点线性闭合);模型文件归档 90_资料源/getdp_能量法/。
- 2026-10-01 收尾批:练习①实测推翻 06 初稿归因(自我纠错入库)——D=600mm 重网格重解(242k 单元,L′=1.2395 µH/m,
loop_600.*已归档):若 −5.1% 真是边界效应应按 1/D² 坍缩,实测仅收窄 0.7 个百分点。深查为截面口径错:1×1mm² 方截面导体的严格解走 GMD 法(自 GMD 0.4471mm,数值二重积分并用圆盘精确解 e^(−1/4)r 验证到 5×10⁻⁵),L′=1.2430 µH/m;边界占比实为 −0.99%@60mm / −0.28%@600mm,其余 −4.2% 是“内切圆圆导线公式 vs 方截面”模型差。06 篇三处(总结/正文/速查表)已按新口径改写。 - FreeCAD 电磁链:几何段实证、场解段封存(用户决定 2026-10-01)——勘查定论:FreeCAD 1.1.3 FEM 磁场唯一后端是 Elmer(无 GetDP 接口,本机不可装)→ 走“FreeCAD 无头几何前端 → STEP → Gmsh → GetDP”。已实证:RM8 轴对称截面 28 区共形分区(面积台账 260.6+3.7+183.1+6752.6=7200.0 mm² 精确闭合)、OCC 自融合焊接共享边、STEP 新进程读回逐面比对 28/28、Gmsh 导入按单元重心分类的分组面积与台账一致;
Coherence同域合并(28→22 面)等三处实测坑已写入教程 §4。轴对称场求解未通过,用户决定搁置,场值不造数;全部脚本/模型/台账归档90_资料源/getdp_能量法/rm8_*。练习②参数错绑同步勘误:初稿把 PQ26 数(lg=0.46/Np≈24)挂 RM8,库内 RM8 口径为 Ae=60mm²/Np=45/lg=0.85mm,磁路目标 173µH(教学取值 le=60mm、µr=2000,挂待核实)。 - 小账清:
Gecko_PFC_Exercise.pdf无文本层(矢量讲义),同名 txt 补占位备注并在 90 README 登记例外。 - 仍挂账:后台下载代理(TVS/GDT/瓷介安规/NCP16xx EVM 手册)——上一会话代理跨会话失联且 0 到货,重派中 → 到货后按 IC 文件夹 05_* 与 30 板块预留子类补齐。
四、审计制度(每轮改动后必跑)
十项机检脚本(python 一行流,按需重跑):
- 链接/图片断链检查(全库 markdown 链接与嵌入图片目标的存在性)
- 公式 Unicode 残留(
$...$/$$...$$内 ×÷≤≥±µΩ℃ 等) - AI 腔套话 13 类扫描
- 口语 13 类扫描(坑/地板/天花板/翻车/招牌…)
- 表格列数一致性
- 旧路径残留(10_基础与方法 / 40_工程实务 等历史名)
- 层 README 覆盖检查
- 编号连续性
- 空/极短文件
- 库级数字一致性(IC=20 颗 / PDF=50 / 总表=284)
敌意审读规范(人工/代理审读用):找问题不是验证——重点查①英文单词残留 ②过期“待建/未译”引用 ③跨篇数值打架 ④声明与实况矛盾(如“无法提取图”但实际有图)⑤结构缺失(本篇总结/精炼要点/功能模块索引)⑥坏体标记(未闭合加粗)。
五、常用操作速查
- 结构改动后:用“解析旧绝对路径 → 映射新路径 → 重算相对路径”脚本全库重写链接(模板:/tmp/restructure_kb.py 思路,或参考本台账 §二的教训——改完必跑链接检查)。
- 改文件夹前后:
sudo ln -sfn <新路径> /mnt/xx/IC解读保持 symlink;shell 全 ENOENT 时先查 cwd 悬空(见记忆 mnt-xx-symlink-fragility)。 - 下载 PDF(NXP/MPS 反爬):用内置浏览器过 .com→.com.cn 同域 fetch(见记忆 nxp-pdf-download-via-browser)。
六、2026-10-06 轮维护记录(结构重构 · 全量改名 · 措辞专业化)
- 用户主诉:① 翻译腔/比喻修辞多(“省一笔损耗”“物理税”“扛应力”类)需专业化;② 一篇文章挂多个标签不合理;③ 文档命名格式不统一,要求全部改为带序号名称;④ 分类结构混乱,数学内容应归一类;⑤ 全库存在未闭合
**与错配引号。 - 已执行:
- 机械损坏修复:
**X**要点**:型断粗体 30 处逐例复原、[**A]版本标记修复、MP6922 脚注星号转义。 - 引号规范化:全库 280 文件 7,896 对含中文的直引号
"…"→ 中文引号“…”;YAML/代码块/纯英文引用不动;修复错配引号 1 处。 - 结构重构:删除 02_理论通识 根目录 5 篇旧版残留(与编号版重复、零引用);数学内容统一至
10_理论与方法/02_数学基础/(微积分通识、傅里叶与频域通识 + 数学专题一~九);04_基础课升级为03_基础课程;01_理论通识更名04_体系通识;03_建模与控制理论更名05_建模与控制理论;40_仿真验证 撞号修复(05/05、06/06 → 05~09 连续)。 - 全量改名:284 个文件改为
NN_中文名.md;67 个 README.md →00_总览.md;_横评_*→01_横评_*;15 个_未引用图片清单.md→99_未引用图片清单.md;IC 五件套与器件目录顺位 +1(00 规格书全译 → 01 规格书全译,依此类推);全部 wikilink 由脚本同步改写。 - 术语统一:傅立叶 → 傅里叶(全库 20 文件 + 1 文件名)。
- 标签体系:由“板块→子类→型号”三重祖先堆叠改为内容叶子标签 + 类型标签(≤2 个),doctype 收敛为受控词表(19 → 15 类);286 篇重算。
- 措辞专业化:全库比喻/口语表述(记账类“笔/账/付”、拟人类、戏剧类等约 40 词族)按语境映射替换为规范工程术语(多子代理分区并行执行);“对账”统一改“核对”(文件名除外);炸管/打嗝模式/谷底开通等正规术语保留。
- 机械损坏修复:
- 复检指标:见知识库维护报告本轮附表。
七、2026-10-07 轮:挂载故障恢复 + 仿真板块对齐(本轮)
- 故障与根因(定案+勘误):rclone 挂载 EIO 的真正根因是主机名解析——
nas在家靠局域网 DNS 解析,人到公司后解析失败(MagicDNS 未兜底),WebDAV 全断。已用/etc/hosts固定100.67.45.96 nas解决。期间误诊两处,经 crontab 实证纠正:① "OpenList 无自启/守护进程死了"——实际 NAS crontab 早有@reboot自启 + 每分钟pgrep看门狗(二进制名openlist非 alist),守护进程全程存活;② "NAS 防火墙拦 5244"——当时 curl 走的是解析失败的域名而非 IP。经验:测连通性一律用 Tailscale IP。干扰项(已自愈):NAS sshd 来源惩罚洪水、GCP↔NAS 直连超时。 - 仿真板块对齐(40_仿真验证 30 篇):① 修复 01~04 四篇 H1 被历史全局替换误伤的板块前缀("50_电源设计流程 07~10"→"40_仿真验证 01~04");② 06/07 两篇重编号后 title/H1 序号跟上(05→06、06→07),frontmatter 由旧式 layer/kind 规范化为 title/category/doctype/tags/created;③ 08/09 H1 统一加板块编号前缀;④ 全部旧号别名(06_建模方法论、07_开源仿真、08_仿真实战、10_理论与方法/01_通用基础 等)改为新口径;⑤ 00_总览 title 去重、篇目表核对。
- 元器件/电路补篇落盘(挂载故障期间暂存于 /tmp 的 14 篇):02_电路 补 08_RCD吸收电路设计 / 09_驱动电路设计 / 10_EMI滤波电路设计;20_基本元器件 补二极管×2、三极管×2、电容应用场景、磁材基础、变压器设计实务、磁珠选型、电阻全功能、保护器件导览、气体放电管与空气放电管;20_基本元器件/00_总览 重写为九分类。
- 仿真全量复跑(2026-10-07,本机):ngspice 44.2(Buck ESR 系列 5 例:vout 长窗 3.648 vs 3.647、vint 41.276 vs 41.27)、LTspice 26.0.2(反激 .ac 4 网表:G0 9.031dB、1.77kHz −20.10dB、闭环 fc=1359.85Hz、CTR 五角落 565.9→2795.1Hz=4.939 倍)、GetDP 3.5.0(loop_600:L′=1.2395 µH/m @241,868 单元,与记录值完全一致)——全部复现,零勘误。GeckoCIRCUITS 无批处理接口(GUI 依赖),三套实验课待人工复跑。明细见 40_仿真验证/10_仿真复跑记录,原始日志归档 *.rerun20261007.log。
- 终检:3,150 条 wikilink 断链 0(归档页 2 处历史示例占位除外);未闭合
**0;目录重号 0;README 残留 0;标签 >2 个的文件 0;别名重复 0。
八、2026-10-07 低成本优化批(用户指定先做)
- 环境加固:
Host nas补IdentityFile ~/.ssh/id_ed25519+ ServerAliveInterval(本机 ~/.ssh/config,实测 NAS-SSH-OK)。勘误:经 NAS crontab 实证,OpenList 早有自启体系(@reboot + 每分钟 pgrep 看门狗,二进制名openlist非 alist)——"无自启需建 systemd"为误诊,不必也不应再建单元;可选升级:看门狗 pgrep → curl /ping 健康检查。记忆与台账旧结论已同步勘误。 - 新建笔记模板:模板/笔记模板.md 更新为现行 frontmatter 五字段 + 标签词表 + 待核实段。
- 孤儿图片:复扫 63 张全部为 datasheet/pages 原版存档(有意保留);UCC28700 8 张 EVM 图已在前几轮补挂归零——历史遗留项关闭。误报根因:99_清单自引用污染检测,已排除。
- 反向链接审计:检测脚本修正(vault 根基准 + 同名消歧 + 目录链接跳过)后,真孤立内容篇 = 0,图谱连通完整。
- QA 常驻脚本:.workbuddy/qa_check.py 固化(9 项检查 + 已知豁免:归档示例 2 处、历史台账旧名、电阻采样 legacy 别名/原版 PDF 文件名、"原 01_通用基础"注记),退出码 0/1 可挂 CI。当前全绿。
- 附带修复:30_经典IC精读/01_IC速查索引 → 99_IC速查索引(物理文件落地);反激 img/100_未引用图片清单 → 99_;维护报告对应断链修正;07_电阻 两篇 category 基本元器件。
- 仿真一键回归脚本:40_仿真验证/sim/rerun_all.sh 固化(Buck 系列 ngspice 补丁副本 / .ac 系列 LTspice / GetDP 能量法含 b.pos 场图积分),exit 0/1;本机全量验证通过(GetDP L′=1.2395 µH/m、g0=9.031 dB 与基准一致)。修复两处脚本 bug:积分器面积公式 y3 用错 z2、sim 子目录路径少一层。
- 基础课程第 11~14 讲(模拟电路·运放与负反馈):02_电路/11_运放基础与理想模型、12_负反馈与虚短虚断、13_运放非理想性与精度预算(含 12V/2A 采样链精度预算表演示)、14_电源里的运放电路(六电路×规则总表,电路部分结课)——按现行四分类落位 02_电路,讲次=文件序号,课程进度 14/23 讲(后续电力电子专门化是否单设讲次待定,器件级由 20_基本元器件/运放三篇承担)。