acmer-coach 1.0.0

package/coach/render_map.py

@@ -0,0 +1,226 @@
+#!/usr/bin/env python3
+"""
+render_map.py v2 — 竖向可折叠树 + 依赖高亮
+
+v1 的问题：
+  「线 和线重叠完了 啥也看不清楚 …… 你可以做成竖着的一棵树一样的
+    每一个"学科"你可以做一个可以点击就让他不显示的功能」
+
+所以 v2 改成：不做图形化的 DAG（那必然线乱），改成**竖向的折叠树**
+  - 学科可折叠（点标题开合）
+  - 二级分组（OI-wiki 的分组）也可折叠
+  - 每个节点的前置用小字列在旁边（不用连线）
+  - 点节点 → 高亮它的完整依赖链（向上追溯），依赖它的节点也会亮
+
+为什么不做连线：OI-wiki 的分组树里，节点多数只跨 1-3 条依赖边，
+用文字列出比画线可靠得多 —— 画线在 351 个节点上必然糊成一团。
+
+用法: python render_map.py [输出路径]   默认 ~/Desktop/教练地图.html
+"""
+import os
+import sys
+from collections import defaultdict
+
+for _s in (sys.stdout, sys.stderr):
+    if _s and hasattr(_s, "reconfigure"):
+        _s.reconfigure(encoding="utf-8", errors="replace")
+
+MAP = os.path.join(os.path.expanduser("~"), ".dsh", "knowledge", "MAP.yaml")
+OUT = sys.argv[1] if len(sys.argv) > 1 else os.path.join(
+    os.path.expanduser("~"), "Desktop", "教练地图.html")
+
+DOMAIN_ORDER = ["算法基础", "基本算法", "搜索", "动态规划", "字符串", "数学",
+                "数据结构", "数据结构进阶", "图论", "计算几何", "杂项", "专题"]
+DOMAIN_COLOR = {
+    "算法基础": "#58a6ff", "基本算法": "#58a6ff", "搜索": "#d29922",
+    "动态规划": "#f778ba", "字符串": "#3fb950", "数学": "#bc8cff",
+    "数据结构": "#39c5cf", "数据结构进阶": "#39c5cf",
+    "图论": "#ff7b72", "计算几何": "#e3b341", "杂项": "#8b949e", "专题": "#8b949e",
+}
+
+
+def main():
+    import yaml
+    with open(MAP, "r", encoding="utf-8") as f:
+        doc = yaml.safe_load(f)
+    nodes = doc["nodes"]
+    parallels = doc.get("parallel_branches") or []
+
+    by_id = {n["id"]: n for n in nodes}
+    name_of = {n["id"]: n["name"] for n in nodes}
+
+    # 依赖（只算显式 depends —— parent 是分类不是前置，见文件头注释）
+    deps = {n["id"]: [d for d in (n.get("depends") or []) if d in by_id] for n in nodes}
+    rev = defaultdict(list)
+    for i, ds in deps.items():
+        for d in ds:
+            rev[d].append(i)
+
+    # 分组：学科 → parent 分组 → 节点
+    grouped = defaultdict(lambda: defaultdict(list))
+    for n in nodes:
+        grouped[n["domain"]][n.get("parent") or ""].append(n)
+
+    order = {d: i for i, d in enumerate(DOMAIN_ORDER)}
+    domains = sorted(grouped.keys(), key=lambda d: (order.get(d, 99), d))
+
+    # ── 生成 HTML ──
+    parts = []
+    for dom in domains:
+        color = DOMAIN_COLOR.get(dom, "#8b949e")
+        total = sum(len(v) for v in grouped[dom].values())
+        parts.append(f'<section class="dom" data-dom="{dom}">')
+        parts.append(
+            f'<h2 style="--c:{color}"><span class="caret">▾</span>{dom}'
+            f'<em>{total}</em></h2><div class="body">')
+        for grp in sorted(grouped[dom]):
+            items = sorted(grouped[dom][grp], key=lambda n: n["name"])
+            if grp:
+                parts.append(f'<div class="grp"><h3><span class="caret">▾</span>'
+                             f'{grp}<em>{len(items)}</em></h3><div class="body">')
+            for n in items:
+                ds = deps[n["id"]]
+                revs = rev[n["id"]]
+                dep_html = ""
+                if ds:
+                    dep_html = ('<span class="dep">← ' +
+                                "、".join(f'<b data-id="{d}">{name_of[d]}</b>' for d in ds) +
+                                '</span>')
+                rev_html = f'<span class="cnt">{len(revs)}</span>' if revs else ""
+                parts.append(
+                    f'<div class="node" data-id="{n["id"]}" data-deps="{",".join(ds)}" '
+                    f'data-rev="{",".join(revs)}">'
+                    f'<span class="nm">{n["name"]}</span>{dep_html}{rev_html}</div>')
+            if grp:
+                parts.append('</div></div>')
+        parts.append('</div></section>')
+
+    body = "\n".join(parts)
+    n_dep = sum(len(v) for v in deps.values())
+    n_entry = sum(1 for v in deps.values() if not v)
+    par_html = "".join(
+        f'<li><b>{p["a"]}</b> ∥ <b>{p["b"]}</b> —— {p["note"]}</li>' for p in parallels)
+
+    html = f"""<!DOCTYPE html><html lang="zh-CN"><head><meta charset="utf-8">
+<title>教练地图 v2</title><style>
+:root {{ --bg:#0d1117; --fg:#e6edf3; --dim:#8b949e; --line:#21262d; --panel:#161b22; }}
+* {{ box-sizing:border-box; }}
+body {{ margin:0; background:var(--bg); color:var(--fg);
+  font:14px/1.6 "Segoe UI","Microsoft YaHei",sans-serif; }}
+header {{ padding:20px 28px; border-bottom:1px solid var(--line);
+  position:sticky; top:0; background:var(--bg); z-index:10; }}
+h1 {{ margin:0 0 8px; font-size:18px; font-weight:600; }}
+.stat {{ color:var(--dim); font-size:13px; }}
+.stat b {{ color:var(--fg); }}
+.toolbar {{ margin-top:10px; display:flex; gap:8px; flex-wrap:wrap; }}
+.toolbar button {{ background:var(--panel); color:var(--fg); border:1px solid var(--line);
+  padding:5px 12px; border-radius:6px; cursor:pointer; font-size:12.5px; }}
+.toolbar button:hover {{ border-color:#58a6ff; }}
+main {{ padding:12px 28px 60px; max-width:1100px; }}
+section.dom {{ margin:14px 0; }}
+h2 {{ margin:0; padding:9px 12px; border-radius:8px 8px 0 0; cursor:pointer;
+  font-size:15px; font-weight:600; background:var(--panel);
+  border-left:3px solid var(--c); user-select:none; }}
+h2 em, h3 em {{ font-style:normal; color:var(--dim); font-size:12px;
+  margin-left:8px; font-weight:400; }}
+h2 .caret, h3 .caret {{ display:inline-block; width:16px; transition:transform .15s;
+  color:var(--dim); }}
+.collapsed > .body {{ display:none; }}
+.collapsed .caret {{ transform:rotate(-90deg); }}
+h3 {{ margin:6px 0 0; padding:6px 12px 6px 26px; font-size:13.5px; font-weight:500;
+  color:var(--dim); cursor:pointer; user-select:none; }}
+h3:hover {{ color:var(--fg); }}
+.body {{ padding-left:14px; }}
+section.dom > .body > .grp > .body {{ border-left:1px dashed var(--line); margin-left:12px; }}
+.node {{ padding:4px 12px 4px 26px; border-radius:5px; cursor:pointer;
+  display:flex; align-items:baseline; gap:10px; }}
+.node:hover {{ background:#1c2128; }}
+.nm {{ min-width:200px; }}
+.dep {{ color:var(--dim); font-size:12px; }}
+.dep b {{ color:#58a6ff; font-weight:400; cursor:pointer; }}
+.dep b:hover {{ text-decoration:underline; }}
+.cnt {{ color:#484f58; font-size:11px; }}
+.node.hl {{ background:#1f6feb22; box-shadow:inset 2px 0 0 #1f6feb; }}
+.node.dep-hl {{ background:#3fb95022; box-shadow:inset 2px 0 0 #3fb950; }}
+.node.rev-hl {{ background:#d2992222; box-shadow:inset 2px 0 0 #d29922; }}
+.legend {{ display:flex; gap:16px; font-size:12px; color:var(--dim); margin-top:8px; }}
+.legend i {{ font-style:normal; padding:1px 7px; border-radius:4px; }}
+.par {{ margin-top:26px; padding:16px 18px; background:var(--panel);
+  border-radius:8px; font-size:13px; color:var(--dim); }}
+.par b {{ color:var(--fg); font-weight:500; }}
+.par ul {{ margin:8px 0 0; padding-left:18px; }}
+.par li {{ line-height:1.9; }}
+</style></head><body>
+<header>
+  <h1>教练地图 v2 —— 完整知识树</h1>
+  <div class="stat">
+    <b>{len(nodes)}</b> 个节点 · <b>{n_dep}</b> 条依赖边 ·
+    其中 <b>{n_entry}</b> 个未标注前置 · 来源 OI-wiki 导航全量
+  </div>
+  <div class="toolbar">
+    <button onclick="allOpen()">全部展开</button>
+    <button onclick="allClose()">全部折叠</button>
+    <button onclick="onlyDomains()">只留学科</button>
+    <button onclick="clearHL()">清除高亮</button>
+  </div>
+  <div class="legend">
+    <span><i style="background:#1f6feb22;box-shadow:inset 2px 0 0 #1f6feb">&nbsp;&nbsp;</i> 你点的</span>
+    <span><i style="background:#3fb95022;box-shadow:inset 2px 0 0 #3fb950">&nbsp;&nbsp;</i> 它的前置</span>
+    <span><i style="background:#d2992222;box-shadow:inset 2px 0 0 #d29922">&nbsp;&nbsp;</i> 依赖它的</span>
+  </div>
+</header>
+<main>
+{body}
+<div class="par">
+  <b>平行分支</b>（不是依赖，是「选一条走即可」）
+  <ul>{par_html}</ul>
+</div>
+</main>
+<script>
+document.querySelectorAll('h2,h3').forEach(h => h.onclick = e => {{
+  if (e.target.tagName === 'B') return;
+  h.parentElement.classList.toggle('collapsed');
+}});
+function allOpen()  {{ document.querySelectorAll('.dom,.grp').forEach(e => e.classList.remove('collapsed')); }}
+function allClose() {{ document.querySelectorAll('.dom,.grp').forEach(e => e.classList.add('collapsed')); }}
+function onlyDomains() {{ allClose(); document.querySelectorAll('.dom').forEach(e => e.classList.remove('collapsed')); }}
+function clearHL() {{ document.querySelectorAll('.node').forEach(e =>
+  e.classList.remove('hl','dep-hl','rev-hl')); }}
+function mark(id, cls) {{
+  const el = document.querySelector(`.node[data-id="${{CSS.escape(id)}}"]`);
+  if (el) {{ el.classList.add(cls); return el; }}
+  return null;
+}}
+document.querySelectorAll('.node').forEach(el => el.onclick = ev => {{
+  if (ev.target.tagName === 'B') {{                       // 点前置名 → 跳到它
+    const id = ev.target.dataset.id;
+    const dst = mark(id, 'hl');
+    if (dst) {{ dst.scrollIntoView({{block:'center', behavior:'smooth'}}); }}
+    return;
+  }}
+  clearHL();
+  el.classList.add('hl');
+  // 向上追溯全部前置（传递闭包）
+  const seen = new Set(), stack = [...(el.dataset.deps || '').split(',').filter(Boolean)];
+  while (stack.length) {{
+    const id = stack.pop();
+    if (seen.has(id)) continue;
+    seen.add(id);
+    const n = document.querySelector(`.node[data-id="${{CSS.escape(id)}}"]`);
+    if (n) {{ n.classList.add('dep-hl'); stack.push(...(n.dataset.deps||'').split(',').filter(Boolean)); }}
+  }}
+  // 直接依赖它的（一层，多了会糊）
+  (el.dataset.rev || '').split(',').filter(Boolean).forEach(id => mark(id, 'rev-hl'));
+}});
+</script></body></html>"""
+
+    with open(OUT, "w", encoding="utf-8") as f:
+        f.write(html)
+    print(f"渲染完成 → {OUT}")
+    print(f"  节点 {len(nodes)} · 依赖边 {n_dep} · 未标注前置 {n_entry}")
+    print(f"  学科 {len(domains)} 个")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/coach/render_skilltree.py

@@ -0,0 +1,197 @@
+#!/usr/bin/env python3
+"""
+render_skilltree.py — 把 MAP.yaml + DEPENDS.yaml 渲染成技能树（单文件 HTML）
+
+它是个**视图**：只读两份 YAML，不存任何数据。改地图请改 DEPENDS.yaml。
+
+布局不用 dagre（省一个 CDN 依赖，也方便把间距调成中文标签舒服的值）：
+  1. 层 = 最长路深度（跟 analyze_map.py 同一套算法）
+  2. 层内顺序 = 重心法（barycenter）迭代 6 轮，减少连线交叉
+  3. 每层居中排布，节点宽度随标签长度自适应
+
+用法: python render_skilltree.py [地图.yaml] [输出.html]
+  不给参数就用 COACH_DATA_DIR（默认 ~/.dsh/knowledge）下的 MAP.yaml → skilltree.html
+  改完地图记得重跑一次，否则页面还是旧的。
+"""
+import json
+import os
+import sys
+from collections import defaultdict
+
+import yaml
+
+for _s in (sys.stdout, sys.stderr):
+    if _s and hasattr(_s, "reconfigure"):
+        _s.reconfigure(encoding="utf-8", errors="replace")
+
+_here = os.path.dirname(os.path.abspath(__file__))
+# 默认数据目录：和插件同一套规矩（COACH_DATA_DIR 优先，否则 ~/.dsh/knowledge）
+_DATA = os.environ.get("COACH_DATA_DIR") or os.path.join(
+    os.path.expanduser("~"), ".dsh", "knowledge")
+MAP = sys.argv[1] if len(sys.argv) > 1 else os.path.join(_DATA, "MAP.yaml")
+OUT = sys.argv[2] if len(sys.argv) > 2 else os.path.join(_DATA, "skilltree.html")
+
+# 学科配色。VP 的规矩：这些颜色只用于描边/淡底（非文字 UI 组件，够 3:1 即可），
+# 正文一律用 --text-1，所以不需要为它们压深。
+DOMAIN_COLOR = {
+    "算法基础": ("#2b7fe0", "#4aa3f7"),
+    "数据结构": ("#0e9aa7", "#2dd4bf"),
+    "图论":     ("#6d4aca", "#a78bfa"),
+    "动态规划": ("#d97706", "#ffa726"),
+    "字符串":   ("#16a24a", "#3fd968"),
+    "数学":     ("#c026d3", "#e879f9"),
+    "搜索":     ("#0891b2", "#22d3ee"),
+    "计算几何": ("#e11d48", "#fb7185"),
+    "杂项":     ("#7a8fa6", "#94a3b8"),
+    "专题":     ("#b45309", "#fbbf24"),
+}
+
+NODE_H = 44          # 节点高
+NODE_GAP = 12        # 同层水平间隙
+ROW_GAP = 26         # 折行之间的间隙
+LAYER_GAP = 64       # 层间垂直间隙
+PAD = 48
+W_MAX = 2240         # 单行最大宽度，超过就折行
+# 为什么必须折行：第 2 层有 122 个节点，一字排开是 14696×1004 的一条带子
+# （14.7:1），缩到屏幕里每个字只有 5px，等于看不见。折行后接近 4:3。
+
+
+def text_units(s):
+    """粗估标签宽度：CJK/全角算 1，其余算 0.55。"""
+    return sum(1.0 if ord(c) > 0x2E80 else 0.55 for c in s)
+
+
+def build():
+    doc = yaml.safe_load(open(MAP, encoding="utf-8"))
+    nodes = doc["nodes"]
+    name_of = {n["id"]: n["name"] for n in nodes}
+    dom_of = {n["id"]: n["domain"] for n in nodes}
+    # tier / entry 是**标注**，来自 NODE_META.yaml 和 NODE_ENTRY.yaml，
+    # 由 build_map.py 合并进 MAP.yaml。缺了就是没标 / 没数据，**别拿 0 冒充**。
+    tier_of = {n["id"]: (n.get("tier") or "") for n in nodes}
+    entry_of = {n["id"]: int(n.get("entry") or 0) for n in nodes}
+    pool_of = {n["id"]: int(n.get("pool") or 0) for n in nodes}
+    ids = [n["id"] for n in nodes]
+
+    dep = {}
+    for n in nodes:
+        dep[n["id"]] = [d for d in (n.get("depends") or []) if d in name_of]
+
+    succ = defaultdict(list)
+    for u, ps in dep.items():
+        for p in ps:
+            succ[p].append(u)
+
+    # ── 1. 分层：最长路 ──
+    memo = {}
+
+    def depth(u, stack=frozenset()):
+        if u in memo:
+            return memo[u]
+        ps = dep.get(u) or []
+        if u in stack or not ps:
+            memo[u] = 0
+            return 0
+        memo[u] = max(depth(p, stack | {u}) for p in ps) + 1
+        return memo[u]
+
+    for i in ids:
+        depth(i)
+
+    layers = defaultdict(list)
+    for i in ids:
+        layers[memo[i]].append(i)
+    max_depth = max(layers)
+
+    # ── 2. 层内排序：重心法 ──
+    for l in sorted(layers):
+        layers[l].sort(key=lambda u: (dom_of[u], name_of[u]))
+
+    # 宽度：左侧圆点(15) + 点后间距(12) + 文字 + 右侧留白(12)
+    w = {u: max(104, min(226, 39 + text_units(name_of[u]) * 13.2)) for u in ids}
+
+    for _ in range(6):
+        cx = {}
+        for l in sorted(layers):
+            cur = 0.0
+            for u in layers[l]:
+                cx[u] = cur + w[u] / 2
+                cur += w[u] + NODE_GAP
+        for l in sorted(layers)[1:]:
+            def bary(u):
+                ps = [p for p in dep[u] if p in cx]
+                return sum(cx[p] for p in ps) / len(ps) if ps else cx[u]
+            layers[l].sort(key=bary)
+
+    # ── 3. 落坐标：每层按 W_MAX 折行 ──
+    pos, bands = {}, []
+    y_cursor = PAD
+    layout = []                      # (层, 行列表, 行高)
+    widest = 0.0
+    for l in sorted(layers):
+        ns = layers[l]
+        rows, cur = [[]], 0.0
+        for u in ns:
+            if cur > 0 and cur + w[u] > W_MAX:
+                rows.append([])
+                cur = 0.0
+            rows[-1].append(u)
+            cur += w[u] + NODE_GAP
+        h = len(rows) * NODE_H + (len(rows) - 1) * ROW_GAP
+        layout.append((l, rows, h))
+        for row in rows:
+            widest = max(widest, sum(w[u] for u in row) + NODE_GAP * (len(row) - 1))
+
+    # 画布宽度按**实际最宽的那一行**算，不是按 W_MAX 上限 ——
+    # 否则右边会留一大片死白（W_MAX 是折行阈值，不是真实宽度）。
+    canvas_w = widest + PAD * 2
+    for l, rows, h in layout:
+        bands.append({"depth": l, "count": len(layers[l]), "y": y_cursor - LAYER_GAP / 2,
+                      "h": h + LAYER_GAP, "rows": len(rows)})
+        for ri, row in enumerate(rows):
+            total = sum(w[u] for u in row) + NODE_GAP * (len(row) - 1)
+            x = PAD + (widest - total) / 2
+            y = y_cursor + ri * (NODE_H + ROW_GAP)
+            for u in row:
+                pos[u] = [round(x, 1), y, w[u], NODE_H]
+                x += w[u] + NODE_GAP
+        y_cursor += h + LAYER_GAP
+
+    edges = [[p, u] for u, ps in dep.items() for p in ps]
+
+    data = {
+        "nodes": [
+            {
+                "id": i, "name": name_of[i], "domain": dom_of[i],
+                "depth": memo[i], "x": pos[i][0], "y": pos[i][1],
+                "w": pos[i][2], "h": pos[i][3],
+                "pre": dep[i], "suc": sorted(succ[i]),
+                "tier": tier_of[i], "entry": entry_of[i], "pool": pool_of[i],
+            }
+            for i in ids
+        ],
+        "edges": edges,
+        "bands": bands,
+        "size": [round(canvas_w, 1), round(y_cursor - LAYER_GAP + PAD, 1)],
+        "domainColors": DOMAIN_COLOR,
+    }
+    return data
+
+
+def main():
+    data = build()
+    tpl = os.path.join(os.path.dirname(os.path.abspath(__file__)), "skilltree_template.html")
+    html = open(tpl, encoding="utf-8").read()
+    html = html.replace("/*__DATA__*/null", json.dumps(data, ensure_ascii=False))
+    open(OUT, "w", encoding="utf-8").write(html)
+
+    print(f"生成完成 → {OUT}")
+    print(f"  节点 {len(data['nodes'])}   连线 {len(data['edges'])}")
+    print(f"  画布 {data['size'][0]} × {data['size'][1]} px")
+    print(f"  层数 {len(data['bands'])}   每层节点 " +
+          " / ".join(str(b["count"]) for b in data["bands"]))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/coach/serve_map.py

@@ -0,0 +1,181 @@
+#!/usr/bin/env python3
+"""
+serve_map.py — 起个本地端口看技能树，并让页面能标进度
+
+skilltree.html 是**视图**：节点/边从 MAP.yaml 来，进度从 PROGRESS.yaml 来，
+自己一份数据都不存（原则 4：单一真相源）。
+
+── 为什么不在这里读写 YAML ────────────────────────────────────
+看着更省事，但会让 PROGRESS.yaml 有**两个写入实现**（这边 Python 一个、
+插件 JS 一个），两套 YAML 库、两种输出风格；而且 PyYAML 不吃注释，
+文件头那段状态说明第一次写就没了。
+
+所以本文件**不 import yaml**，所有进度读写都 shell 出去跑
+`progress-cli.mjs` —— 那是插件自己的代码（原子写、损坏时抛错、
+文件头重贴，全复用）。这里只做一件事：把 HTTP 翻译成一次 CLI 调用。
+
+页面一度把标记存在浏览器 localStorage —— 那是**第二份真相**。
+这个项目在别处刚花一整轮治同一个病，不能自己家再长一个。
+
+用法: python serve_map.py     → 自动开浏览器，Ctrl+C 停
+"""
+import functools
+import http.server
+import json
+import os
+import shutil
+import socketserver
+import subprocess
+import sys
+import webbrowser
+
+for _s in (sys.stdout, sys.stderr):
+    if _s and hasattr(_s, "reconfigure"):
+        _s.reconfigure(encoding="utf-8", errors="replace")
+
+PORT = 8770
+ROOT = os.path.join(os.path.expanduser("~"), ".dsh", "knowledge")
+
+# 跑「已安装副本」里的 CLI，不是插件源码目录 ——
+# 源码目录下 import 不到 yaml 和 @deepseek-ai/dsh-tools（实测 ERR_MODULE_NOT_FOUND）
+CLI = os.path.join(
+    os.path.expanduser("~"), ".dsh", "profiles", "web", "node_modules",
+    "acmer-coach", "progress-cli.mjs",
+)
+
+
+def run_cli(*args):
+    """跑一次进度 CLI，返回它那行 JSON。
+
+    失败**必须抛**：调用方要靠它区分「真的没进度」和「读写出错了」。
+    吞掉异常返回空对象 = 界面显示一切正常，实际什么都没动。
+    """
+    node = shutil.which("node")
+    if not node:
+        raise RuntimeError("找不到 node")
+    p = subprocess.run(
+        [node, CLI, *args],
+        capture_output=True, text=True, encoding="utf-8", timeout=20,
+    )
+    lines = [l for l in (p.stdout or "").splitlines() if l.strip()]
+    if not lines:
+        raise RuntimeError((p.stderr or "").strip() or "progress-cli 没有输出")
+    return json.loads(lines[-1])
+
+
+class Handler(http.server.SimpleHTTPRequestHandler):
+    def log_message(self, *a):
+        pass                      # 别刷屏
+
+    def end_headers(self):
+        # 免得改了 YAML 重新生成 html 后浏览器还拿旧的
+        self.send_header("Cache-Control", "no-store")
+        super().end_headers()
+
+    def _json(self, code, obj):
+        body = json.dumps(obj, ensure_ascii=False).encode("utf-8")
+        self.send_response(code)
+        self.send_header("Content-Type", "application/json; charset=utf-8")
+        self.send_header("Content-Length", str(len(body)))
+        self.end_headers()
+        self.wfile.write(body)
+
+    def do_GET(self):
+        path = self.path.split("?")[0]
+        if path == "/api/progress":
+            try:
+                self._json(200, run_cli("get"))
+            except Exception as e:      # 全兜住报给前端 —— 别让页面以为"没数据"
+                self._json(500, {"ok": False, "reject": str(e)})
+            return
+        if path == "/api/schedule":
+            try:
+                self._json(200, run_cli("sched-get"))
+            except Exception as e:
+                self._json(500, {"ok": False, "reject": str(e)})
+            return
+        # 访问根路径不该给**目录列表** ——
+        # 那长得像文件系统，不像技能树，还得手敲 /skilltree.html。
+        # 重定向过去，地址栏也跟着对。
+        if path == "/":
+            self.send_response(302)
+            self.send_header("Location", "/skilltree.html")
+            self.end_headers()
+            return
+        super().do_GET()
+
+    def do_POST(self):
+        path = self.path.split("?")[0]
+        if path == "/api/schedule":
+            # 日程写入。**本文件不碰 YAML** —— 理由和上面一样（单一写实现），
+            # 所以还是 shell 出去跑 CLI，只是换个命令。
+            try:
+                n = int(self.headers.get("Content-Length") or 0)
+                req = json.loads(self.rfile.read(n) or b"{}")
+                res = run_cli(
+                    "sched-set",
+                    str(req.get("date") or ""),
+                    str(req.get("field") or ""),
+                    json.dumps(req.get("value") or [], ensure_ascii=False),
+                )
+                self._json(200 if res.get("ok") else 400, res)
+            except Exception as e:      # noqa: BLE001
+                self._json(500, {"ok": False, "reject": str(e)})
+            return
+        if path != "/api/progress":
+            self.send_error(404)
+            return
+        try:
+            n = int(self.headers.get("Content-Length") or 0)
+            req = json.loads(self.rfile.read(n) or b"{}")
+            op = req.get("op")
+            node = str(req.get("node") or "")
+            if op == "mark":
+                res = run_cli("mark", node, str(req.get("status") or ""))
+            elif op == "cursor":
+                res = run_cli("cursor", node)
+            else:
+                self._json(400, {"ok": False, "reject": f"未知 op「{op}」，只有 mark / cursor"})
+                return
+            self._json(200 if res.get("ok") else 400, res)
+        except Exception as e:          # noqa: BLE001
+            self._json(500, {"ok": False, "reject": str(e)})
+
+
+class Server(socketserver.TCPServer):
+    allow_reuse_address = True
+
+
+def main():
+    if not os.path.exists(os.path.join(ROOT, "skilltree.html")):
+        print("❌ 还没有 skilltree.html —— 先跑 python render_skilltree.py")
+        return 1
+    if not os.path.exists(CLI):
+        print(f"❌ 找不到进度 CLI：{CLI}")
+        print("   先跑 bash ~/.dsh/plugins/acmer-coach/dev.sh 把插件装进 profile")
+        return 1
+    # 启动先探一次：读不通就别假装能用，直接说清楚
+    try:
+        p = run_cli("get")
+        print(f"🐋 进度读得到：游标 {p.get('cursor') or '（未设）'}，"
+              f"{len(p.get('nodes') or {})} 个节点有状态")
+    except Exception as e:              # noqa: BLE001
+        print(f"❌ 读 PROGRESS.yaml 失败：{e}")
+        return 1
+
+    url = f"http://127.0.0.1:{PORT}/skilltree.html"
+    with Server(("127.0.0.1", PORT), functools.partial(Handler, directory=ROOT)) as httpd:
+        print(f"🐋 技能树  →  {url}")
+        print("   Ctrl+C 停")
+        # --no-open：自动化验页面时用，免得抢人屏幕
+        if "--no-open" not in sys.argv:
+            webbrowser.open(url)
+        try:
+            httpd.serve_forever()
+        except KeyboardInterrupt:
+            print("\n停了")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())