初始导入：PhoneRail 五路手机直供电源板

原理图/PCB 已在 EasyEDA 里做到 12 页跨页 0 漏接，固件刚完成骨架包 A1。
这次是把已有的一切一次性纳入版本控制，没有改动任何设计内容。

纳入：
- 设计与需求文档、PROGRESS.md、小米8 参考原理图 PDF 与追脚脚本
- .claude/ 下的 EasyEDA 桥接工具链与几何/网表缓存（eda-parts.json、
  pcb-parts.json、pcb-pads.json、p2-ch1.json 等，是重画各页的唯一事实来源）
- 117 张验证截图（本项目所有方向问题都是靠人眼看截图发现的，属于证据不是垃圾）
- firmware/ 的 A1 骨架与 site/ 文档站源码

.gitignore 排除：构建产物（firmware/build、host/build、sdkconfig）、
site/node_modules、__pycache__、桥接日志 _bridge.log、脚本自标的 *.stale。

.gitattributes 默认 `* -text`：现有 .py/.json 大多是 CRLF，原样存，
不让 git 重写行尾。唯一例外是 *.sh 强制 LF —— 带 \r 的 shell 脚本 bash 跑不了。

Co-Authored-By: Claude Opus 5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01QYuExfgyYa6DzRRcUso8M8

小米8原理图/conn.py

@@ -0,0 +1,44 @@
+import fitz, math
+from collections import defaultdict
+from trace import nets
+doc=fitz.open('Xiaomi_Mi_8_Schematic.pdf')
+NETCOL={0xFF0000, 0x400040}
+
+def labels(page):
+    out=[]
+    for b in page.get_text('dict')['blocks']:
+        for l in b.get('lines',[]):
+            for s in l['spans']:
+                t=s['text'].strip()
+                if s['color'] in NETCOL and t and t not in ('o','<','>'):
+                    out.append((t, fitz.Rect(s['bbox'])))
+    return out
+
+def gnd_comps(segs,dsu,key):
+    by=defaultdict(list)
+    for a,b in segs: by[dsu.find(key(a))].append((a,b))
+    g=set()
+    for c,ss in by.items():
+        sh=[round(math.dist(*s),1) for s in ss if 1.0<math.dist(*s)<9.0]
+        if len(sh)>=3 and len(set(sh))>=3: g.add(c)
+    return g
+
+def dump(pgno, pinxy, maxd=14):
+    page=doc[pgno-1]
+    segs,dsu,key,comp=nets(page)
+    pts=[]
+    for a,b in segs: pts.append(a); pts.append(b)
+    lb=labels(page); gc=gnd_comps(segs,dsu,key)
+    res={}
+    for pin,q in sorted(pinxy.items()):
+        d,p=min((math.dist(p,q),p) for p in pts)
+        if d>maxd: res[pin]=('NO-WIRE',d,0,''); continue
+        c=dsu.find(key(p)); cp=comp[c]
+        best=None
+        for t,r in lb:
+            dm=min(math.hypot(max(r.x0-x,0,x-r.x1), max(r.y0-y,0,y-r.y1)) for x,y in cp)
+            if best is None or dm<best[0]: best=(dm,t)
+        nm=best[1] if best and best[0]<=16 else ''
+        if c in gc and not nm: nm='GND?'
+        res[pin]=(nm or '(unlabeled)', d, len(cp), f'{best[0]:.1f}' if best else '')
+    return res

小米8原理图/hl.py

@@ -0,0 +1,25 @@
+import fitz, math, sys
+from trace import nets
+from collections import defaultdict
+
+def highlight(pgno, probe, out, pad=22, scale=6):
+    doc=fitz.open('Xiaomi_Mi_8_Schematic.pdf')
+    page=doc[pgno-1]
+    segs,dsu,key,comp=nets(page)
+    pts=[]
+    for a,b in segs: pts.append(a); pts.append(b)
+    d,p=min((math.dist(p,probe),p) for p in pts)
+    c=dsu.find(key(p))
+    mine=[(a,b) for a,b in segs if dsu.find(key(a))==c]
+    r=fitz.Rect(1e9,1e9,-1e9,-1e9)
+    for a,b in mine:
+        for q in (a,b):
+            r.x0=min(r.x0,q[0]); r.y0=min(r.y0,q[1])
+            r.x1=max(r.x1,q[0]); r.y1=max(r.y1,q[1])
+    for a,b in mine:
+        page.draw_line(fitz.Point(*a), fitz.Point(*b), color=(0,0.75,0), width=2.2)
+    r=fitz.Rect(r.x0-pad, r.y0-pad, r.x1+pad, r.y1+pad)
+    clip=r*page.rotation_matrix
+    pix=page.get_pixmap(matrix=fitz.Matrix(scale,scale), clip=clip)
+    pix.save(out)
+    print(out, 'dist=%.1f'%d, 'segs=%d'%len(mine), 'bbox=%s'%r, pix.width, pix.height)

小米8原理图/netmap.py

@@ -0,0 +1,54 @@
+import fitz, math
+from collections import defaultdict
+from trace import nets
+
+doc=fitz.open('Xiaomi_Mi_8_Schematic.pdf')
+
+def red_spans(page):
+    out=[]
+    for b in page.get_text('dict')['blocks']:
+        for l in b.get('lines',[]):
+            for s in l['spans']:
+                if s['color']==0xFF0000:
+                    t=s['text'].strip()
+                    if t: out.append((t, fitz.Rect(s['bbox'])))
+    return out
+
+def gnd_components(segs,dsu,key):
+    """ground symbol = >=3 short parallel segs of decreasing length sharing a component"""
+    byc=defaultdict(list)
+    for a,b in segs:
+        byc[dsu.find(key(a))].append((a,b))
+    g=set()
+    for c,ss in byc.items():
+        shorts=[s for s in ss if 1.0<math.dist(s[0],s[1])<9.0]
+        if len(shorts)>=3:
+            lens=sorted(round(math.dist(s[0],s[1]),1) for s in shorts)
+            if len(set(lens))>=3: g.add(c)
+    return g
+
+def page_netmap(pgno):
+    page=doc[pgno-1]
+    segs,dsu,key,comp=nets(page)
+    pts=[]
+    for a,b in segs: pts.append(a); pts.append(b)
+    lab=defaultdict(set)
+    for t,r in red_spans(page):
+        cands=[]
+        for p in pts:
+            dx=max(r.x0-p[0], 0, p[0]-r.x1); dy=max(r.y0-p[1],0,p[1]-r.y1)
+            cands.append((math.hypot(dx,dy),p))
+        d,p=min(cands)
+        if d<=14: lab[dsu.find(key(p))].add(t)
+    for c in gnd_components(segs,dsu,key): lab[c].add('GND')
+    return page,segs,dsu,key,comp,lab
+
+def probe(pgno, probes, maxd=15):
+    page,segs,dsu,key,comp,lab=page_netmap(pgno)
+    pts=[]
+    for a,b in segs: pts.append(a); pts.append(b)
+    for name,q in probes.items():
+        d,p=min((math.dist(p,q),p) for p in pts)
+        if d>maxd: print(f'{name:8s} -> NO WIRE'); continue
+        c=dsu.find(key(p))
+        print(f'{name:8s} d={d:.1f} n={len(comp[c]):3d}  NET = {sorted(lab.get(c,[])) or "(unlabeled)"}')

小米8原理图/pins.py

@@ -0,0 +1,31 @@
+import fitz, math, sys
+from trace import nets
+
+doc=fitz.open('Xiaomi_Mi_8_Schematic.pdf')
+
+def analyze(pgno, probes, radius=25):
+    page=doc[pgno-1]
+    segs,dsu,key,comp=nets(page)
+    words=page.get_text('words')
+    pts=[]
+    for a,b in segs:
+        pts.append((a,key(a))); pts.append((b,key(b)))
+    for name,(px,py) in probes.items():
+        # nearest endpoint
+        best=None
+        for (p,k) in pts:
+            dd=math.dist(p,(px,py))
+            if best is None or dd<best[0]: best=(dd,p,k)
+        if best is None or best[0]>15:
+            print(f'{name:8s} -> no wire (d={best[0]:.1f})'); continue
+        root=dsu.find(best[2])
+        cpts=comp[root]
+        labels=[]
+        for x0,y0,x1,y1,t,*_ in words:
+            cx,cy=(x0+x1)/2,(y0+y1)/2
+            dmin=min(math.dist((cx,cy),q) for q in cpts)
+            if dmin<=radius: labels.append((round(dmin,1),t))
+        labels.sort()
+        # keep informative tokens
+        keep=[t for d,t in labels if len(t)>2 and not t.replace('.','').isdigit()]
+        print(f'{name:8s} d={best[0]:.1f} comp_pts={len(cpts)}  ->  {keep[:14]}')

小米8原理图/probe2.py

@@ -0,0 +1,30 @@
+import fitz, math
+from trace import nets
+doc=fitz.open('Xiaomi_Mi_8_Schematic.pdf')
+
+def redtext(page):
+    out=[]
+    for b in page.get_text('dict')['blocks']:
+        for l in b.get('lines',[]):
+            for s in l['spans']:
+                if s['color']==0xFF0000 and s['text'].strip():
+                    out.append((s['text'].strip(), fitz.Rect(s['bbox'])))
+    return out
+
+def run(pgno, probes, maxd=18, top=3):
+    page=doc[pgno-1]
+    segs,dsu,key,comp=nets(page)
+    pts=[]
+    for a,b in segs: pts.append(a); pts.append(b)
+    rt=redtext(page)
+    for name,q in probes.items():
+        d,p=min((math.dist(p,q),p) for p in pts)
+        if d>maxd:
+            print(f'{name:10s} -> NO WIRE (d={d:.1f})'); continue
+        c=dsu.find(key(p)); cp=comp[c]
+        scored=[]
+        for t,r in rt:
+            dm=min(math.hypot(max(r.x0-x,0,x-r.x1), max(r.y0-y,0,y-r.y1)) for x,y in cp)
+            scored.append((dm,t))
+        scored.sort()
+        print(f'{name:10s} d={d:.1f} n={len(cp):3d} :: ' + ', '.join(f'{t}({dm:.1f})' for dm,t in scored[:top]))

小米8原理图/trace.py

@@ -0,0 +1,70 @@
+import fitz, math
+from collections import defaultdict
+
+TOL = 0.6
+WIRE_COLORS = {(1.0,0.0,0.0), (0.5,0.0,0.25)}   # red pin stubs + maroon wires
+
+class DSU:
+    def __init__(s): s.p={}
+    def find(s,x):
+        s.p.setdefault(x,x)
+        while s.p[x]!=x:
+            s.p[x]=s.p[s.p[x]]; x=s.p[x]
+        return x
+    def union(s,a,b):
+        ra,rb=s.find(a),s.find(b)
+        if ra!=rb: s.p[ra]=rb
+
+def segs_of_page(page):
+    out=[]
+    for d in page.get_drawings():
+        col=d.get('color')
+        if col is None: continue
+        c=tuple(round(v,3) for v in col)
+        if c not in WIRE_COLORS: continue
+        for it in d['items']:
+            if it[0]=='l':
+                p,q=it[1],it[2]
+                out.append(((p.x,p.y),(q.x,q.y)))
+    return [s for s in out if math.dist(s[0],s[1])>0.05]
+
+def on_seg(p,a,b,tol=TOL):
+    (px,py),(ax,ay),(bx,by)=p,a,b
+    dx,dy=bx-ax,by-ay
+    L2=dx*dx+dy*dy
+    if L2==0: return False
+    t=((px-ax)*dx+(py-ay)*dy)/L2
+    if t<-1e-9 or t>1+1e-9: return False
+    cx,cy=ax+t*dx,ay+t*dy
+    return math.hypot(px-cx,py-cy)<=tol
+
+
+def junction_dots(page):
+    out=[]
+    for d in page.get_drawings():
+        f=d.get('fill')
+        if d['type']=='fs' and f and abs(f[0]-1)<.01 and f[1]<.01 and abs(f[2]-1)<.01:
+            r=d['rect']; out.append(((r.x0+r.x1)/2,(r.y0+r.y1)/2))
+    return out
+
+def nets(page):
+    segs=segs_of_page(page)
+    dsu=DSU()
+    key=lambda p:(round(p[0]*2)/2, round(p[1]*2)/2)
+    for a,b in segs: dsu.union(key(a),key(b))
+    for i,(a,b) in enumerate(segs):
+        for p in (a,b):
+            for j,(c,e) in enumerate(segs):
+                if i==j: continue
+                if on_seg(p,c,e):
+                    dsu.union(key(p),key(c)); dsu.union(key(p),key(e))
+    for dc in junction_dots(page):
+        hit=[]
+        for a,b in segs:
+            if on_seg(dc,a,b,tol=1.4): hit.append((a,b))
+        for a,b in hit[1:]:
+            dsu.union(key(a),key(hit[0][0])); dsu.union(key(b),key(hit[0][0]))
+    comp=defaultdict(set)
+    for a,b in segs:
+        for p in (a,b): comp[dsu.find(key(p))].add(key(p))
+    return segs,dsu,key,comp