knowme-careerforge-skill 0.0.4 → 0.0.6

package/scripts/build/build-gallery.py

@@ -4,7 +4,13 @@ KnowMe CareerForge — Template Gallery Builder
 扫描验证 src/templates/ 核心模板，生成 output/templates_gallery/ 静态可视化画廊。
 """
 
-import os, sys, json, re
+import argparse
+import importlib.util
+import json
+import os
+import sys
+import tempfile
+from html import escape
 from pathlib import Path
 
 def get_project_root() -> Path:
@@ -15,61 +21,55 @@ def get_project_root() -> Path:
         curr = curr.parent
     return Path.cwd()
 
-def build_gallery():
-    base_dir = get_project_root()
-    templates_dir = base_dir / "src" / "templates"
-    gallery_dir = base_dir / "output" / "templates_gallery"
+def load_instantiator():
+    spec = importlib.util.spec_from_file_location(
+        "gallery_instantiator", get_project_root() / "scripts/template/instantiate-resume.py")
+    module = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(module)
+    return module
+
+
+def build_gallery(output_dir=None, font_preset="system"):
+    """Validate and stage every preview before publishing; publish the index last."""
+    gallery_dir = Path(output_dir) if output_dir else get_project_root() / "output/templates_gallery"
     gallery_dir.mkdir(parents=True, exist_ok=True)
-    
-    gallery_items = []
+    with tempfile.TemporaryDirectory(prefix=".gallery-", dir=gallery_dir) as scratch:
+        stage = Path(scratch)
+        _render_gallery(stage, font_preset)
+        for preview in sorted(stage.glob("*.html")):
+            if preview.name != "index.html":
+                os.replace(preview, gallery_dir / preview.name)
+        os.replace(stage / "index.html", gallery_dir / "index.html")
+    return gallery_dir / "index.html"
 
-    print("==============================================================")
-    print("  KnowMe CareerForge — Template Gallery Builder")
-    print("==============================================================")
 
+def _render_gallery(gallery_dir, font_preset):
+    templates_dir = get_project_root() / "src/templates"
+    binder = load_instantiator()
+    gallery_items = []
     for t_dir in sorted(templates_dir.iterdir()):
         if not t_dir.is_dir() or t_dir.name == "common":
             continue
-            
-        html_file = t_dir / "template.html"
-        css_file = t_dir / "style.css"
-        meta_file = t_dir / "metadata.json"
-
-        if not html_file.exists() or not css_file.exists() or not meta_file.exists():
-            print(f"[!] Skipping incomplete template: {t_dir.name}")
-            continue
-
-        try:
-            meta = json.loads(meta_file.read_text(encoding="utf-8"))
-            html_content = html_file.read_text(encoding="utf-8")
-            css_content = css_file.read_text(encoding="utf-8")
-
-            # 编译内联单文件独立预览页面
-            inlined_preview = html_content.replace(
-                '<link rel="stylesheet" href="style.css">',
-                f'<style>\n{css_content}\n  </style>'
-            )
-
-            preview_path = gallery_dir / f"{t_dir.name}.html"
-            preview_path.write_text(inlined_preview, encoding="utf-8")
-
-            gallery_items.append({
-                "id": meta.get("id", t_dir.name),
-                "name": meta.get("name", t_dir.name),
-                "style": meta.get("style", "single-column"),
-                "category": meta.get("roleCategory", "engineering-ai"),
-                "tone": meta.get("visualStyle", {}).get("tone", "modern"),
-                "accent": meta.get("visualStyle", {}).get("accentColor", "#2563eb"),
-                "pages": meta.get("layout", {}).get("targetPages", 1),
-                "density": meta.get("layout", {}).get("density", "balanced"),
-                "atsTier": meta.get("atsScoreTier", "tier-1-optimal"),
-                "previewFile": f"{t_dir.name}.html",
-                "supported": meta.get("supportedRoles", [])
-            })
-            print(f"[✓] Generated Gallery Preview -> {preview_path.name}")
-        except Exception as e:
-            print(f"[✗] Error processing {t_dir.name}: {e}")
-
+        for name in ("canvas.html", "sample-profile.json", "style.css", "metadata.json"):
+            if not (t_dir / name).is_file():
+                raise ValueError(f"Incomplete template {t_dir.name}: missing {name}")
+        meta = json.loads((t_dir / "metadata.json").read_text(encoding="utf-8"))
+        binder.instantiate_workspace(
+            t_dir.name, profile_path=t_dir / "sample-profile.json",
+            output_path=gallery_dir / f"{t_dir.name}.html", quiet=True,
+            font_preset=font_preset)
+        gallery_items.append({
+            "name": meta.get("name", t_dir.name),
+            "style": meta.get("style", "single-column"),
+            "tone": meta.get("visualStyle", {}).get("tone", "modern"),
+            "pages": meta.get("layout", {}).get("targetPages", 1),
+            "density": meta.get("layout", {}).get("density", "balanced"),
+            "atsTier": meta.get("atsScoreTier", "unspecified"),
+            "previewFile": f"{t_dir.name}.html",
+            "supported": meta.get("supportedRoles", [])
+        })
+    if not gallery_items:
+        raise ValueError("No templates found")
     # 生成主索引 index.html
     gallery_html = f"""<!DOCTYPE html>
 <html lang="zh-CN">
@@ -217,18 +217,20 @@ def build_gallery():
   <div class="gallery-container">
     <header>
       <h1>KnowMe CareerForge — Template Gallery</h1>
-      <p class="subtitle">A4 Deterministic HTML Resume Templates with Design Tokens Calibration</p>
+      <p class="subtitle">虚构样例 · 与实际简历共用 canvas.html 和完整样式 · ATS 标签仅代表设计目标</p>
     </header>
     <div class="grid">
 """
 
-    for item in gallery_items:
+    for raw_item in gallery_items:
+        item = {k: ([escape(str(v)) for v in value] if isinstance(value, list) else escape(str(value), quote=True))
+                for k, value in raw_item.items()}
         tags_html = "".join([f'<span class="tag">{r}</span>' for r in item['supported'][:5]])
         gallery_html += f"""
       <div class="card">
         <div class="card-header">
           <span class="card-title">{item['name']}</span>
-          <span class="badge optimal">ATS Tier 1</span>
+          <span class="badge">{item['atsTier']}</span>
         </div>
         <div class="preview-frame-wrapper">
           <iframe class="preview-frame" src="{item['previewFile']}"></iframe>
@@ -255,8 +257,16 @@ def build_gallery():
 """
     gallery_index = gallery_dir / "index.html"
     gallery_index.write_text(gallery_html, encoding="utf-8")
-    print(f"\n[✓] Generated Gallery Master Index -> {gallery_index}")
-    print("==============================================================")
+
 
 if __name__ == "__main__":
-    build_gallery()
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--output", type=Path, help="Gallery output directory")
+    parser.add_argument("--font-preset", choices=("system", "arial-unicode"), default="system")
+    args = parser.parse_args()
+    try:
+        index = build_gallery(args.output, args.font_preset)
+        print(json.dumps({"status": "PASS", "index": str(index)}, ensure_ascii=False))
+    except Exception as exc:
+        print(json.dumps({"status": "FAIL", "error": str(exc)}, ensure_ascii=False), file=sys.stderr)
+        sys.exit(1)

package/scripts/build/run-all-tests.py

@@ -19,6 +19,7 @@ def run_all_test_suites():
     start_time = time.time()
     base_dir = get_project_root()
     tests_dir = base_dir / "tests"
+    sys.path.insert(0, str(base_dir))
 
     print("==============================================================")
     print("  KnowMe CareerForge — Full-Chain Automated Test Suite")

package/scripts/build/sync-version.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 """
 KnowMe CareerForge — Version Synchronization Engine
-将项目根版本号统一同步至 package.json, pyproject.toml, skill.json, cli/package.json, SKILL.md, agents/*, Agent.md。
+将项目根版本号统一同步至 package.json, pyproject.toml, skill.json, cli/package.json, npm 锁文件, SKILL.md, agents/*, CLI 与知识索引。
 """
 
 import sys, os, json, re, argparse
@@ -18,7 +18,11 @@ def get_project_root() -> Path:
 def sync_version(new_version: str):
     base_dir = get_project_root()
     # 去除可能传入的 'v' 前缀
-    semver = new_version.lstrip("v")
+    semver = new_version.removeprefix("v")
+    core = r"(?:0|[1-9][0-9]*)"
+    prerelease = r"(?:0|[1-9][0-9]*|[0-9]*[A-Za-z-][0-9A-Za-z-]*)"
+    if not re.fullmatch(rf"{core}\.{core}\.{core}(?:-{prerelease}(?:\.{prerelease})*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?", semver):
+        raise ValueError(f"Invalid semantic version: {new_version}")
 
     print("==============================================================")
     print(f"  KnowMe CareerForge — Synchronizing Version to v{semver}")
@@ -40,6 +44,17 @@ def sync_version(new_version: str):
         cli_pkg_path.write_text(json.dumps(data, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
         print(f"[✓] Synced cli/package.json -> {semver}")
 
+    # Lockfiles carry the package version separately from dependency versions.
+    for relative in ("package-lock.json", "cli/package-lock.json"):
+        lock_path = base_dir / relative
+        if lock_path.exists():
+            data = json.loads(lock_path.read_text(encoding="utf-8"))
+            data["version"] = semver
+            if "" in data.get("packages", {}):
+                data["packages"][""]["version"] = semver
+            lock_path.write_text(json.dumps(data, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
+            print(f"[✓] Synced {relative} -> {semver}")
+
     # 3. Update skill.json
     skill_json_path = base_dir / "skill.json"
     if skill_json_path.exists():
@@ -60,7 +75,7 @@ def sync_version(new_version: str):
     skill_md_path = base_dir / "SKILL.md"
     if skill_md_path.exists():
         text = skill_md_path.read_text(encoding="utf-8")
-        new_text = re.sub(r'version:\s*[\d.]+', f'version: {semver}', text)
+        new_text = re.sub(r'(?m)^(\s*version:)[ \t]*[^\r\n]+$', lambda m: f'{m[1]} {semver}', text)
         skill_md_path.write_text(new_text, encoding="utf-8")
         print(f"[✓] Synced SKILL.md -> {semver}")
 
@@ -68,7 +83,7 @@ def sync_version(new_version: str):
     codex_yaml = base_dir / "agents" / "codex" / "knowme-careerforge.yaml"
     if codex_yaml.exists():
         text = codex_yaml.read_text(encoding="utf-8")
-        new_text = re.sub(r'version:\s*[\d.]+', f'version: {semver}', text)
+        new_text = re.sub(r'(?m)^(\s*version:)[ \t]*[^\r\n]+$', lambda m: f'{m[1]} {semver}', text)
         codex_yaml.write_text(new_text, encoding="utf-8")
         print(f"[✓] Synced agents/codex/knowme-careerforge.yaml -> {semver}")
 
@@ -76,7 +91,7 @@ def sync_version(new_version: str):
     opencode_yaml = base_dir / "agents" / "opencode" / "skill.yaml"
     if opencode_yaml.exists():
         text = opencode_yaml.read_text(encoding="utf-8")
-        new_text = re.sub(r'version:\s*[\d.]+', f'version: {semver}', text)
+        new_text = re.sub(r'(?m)^(\s*version:)[ \t]*[^\r\n]+$', lambda m: f'{m[1]} {semver}', text)
         opencode_yaml.write_text(new_text, encoding="utf-8")
         print(f"[✓] Synced agents/opencode/skill.yaml -> {semver}")
     # 8. Update cli/src/index.ts fallback version
@@ -84,7 +99,7 @@ def sync_version(new_version: str):
     if cli_ts_path.exists():
         text = cli_ts_path.read_text(encoding="utf-8")
         new_text = re.sub(r"return\s+data\.version\s*\|\|\s*'[^']+'", f"return data.version || '{semver}'", text)
-        new_text = re.sub(r"return\s+'[^']+'\s*;", f"return '{semver}';", new_text)
+        new_text = re.sub(r"return\s+'\d+\.\d+\.\d+[^']*'\s*;", f"return '{semver}';", new_text)
         cli_ts_path.write_text(new_text, encoding="utf-8")
         print(f"[✓] Synced cli/src/index.ts -> {semver}")
 
@@ -101,16 +116,19 @@ def sync_version(new_version: str):
     kb_script = base_dir / "scripts" / "build" / "build-knowledge.py"
     if kb_script.exists():
         import subprocess
-        subprocess.run([sys.executable, str(kb_script)], stdout=subprocess.DEVNULL)
+        subprocess.run([sys.executable, str(kb_script)], stdout=subprocess.DEVNULL, check=True)
         print(f"[✓] Recompiled knowledge index -> v{semver}")
 
     print("\n[✓] All package versions successfully synchronized!")
 
 def main():
     parser = argparse.ArgumentParser(description="Synchronize project version")
-    parser.add_argument("version", nargs="?", default="0.0.2", help="New semantic version (e.g. 0.0.2)")
+    parser.add_argument("version", help="Required target semantic version (e.g. 0.0.6)")
     args = parser.parse_args()
-    sync_version(args.version)
+    try:
+        sync_version(args.version)
+    except (ValueError, OSError) as error:
+        parser.exit(1, f"Version synchronization failed: {error}\n")
 
 if __name__ == "__main__":
     main()

package/scripts/contracts/profile.py

@@ -0,0 +1,101 @@
+"""Shared input contract. Structural validity does not certify candidate facts."""
+import copy
+import hashlib
+import json
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[2]
+SCHEMA = json.loads((ROOT / 'src/knowledge/resume-schema.json').read_text(encoding='utf-8'))
+
+class ContractError(ValueError):
+    pass
+
+
+def _normalize(value, schema, path):
+    types = schema.get('type', [])
+    types = [types] if isinstance(types, str) else types
+    if value is None:
+        if 'null' not in types:
+            raise ContractError(path + ': null is not allowed')
+        return [] if 'array' in types else {} if 'object' in types else None
+    if isinstance(value, str):
+        if 'string' not in types:
+            raise ContractError(path + ': expected ' + '/'.join(types))
+        value = value.strip() or None
+        if value is not None and 'enum' in schema and value not in schema['enum']:
+            raise ContractError(path + ': invalid value')
+        return value
+    if isinstance(value, dict) and 'object' in types:
+        properties = schema.get('properties', {})
+        unknown = set(value) - set(properties)
+        if unknown:
+            raise ContractError(path + ': unsupported fields: ' + ', '.join(sorted(unknown)))
+        result = {}
+        for key, child in properties.items():
+            if key in value:
+                item = _normalize(value[key], child, path + '.' + key)
+                if item is not None and item != {} and item != []:
+                    result[key] = item
+        return result
+    if isinstance(value, list) and 'array' in types:
+        values = [_normalize(item, schema['items'], path + '[' + str(i) + ']') for i, item in enumerate(value)]
+        return [item for item in values if item is not None and item != '' and item != {}]
+    raise ContractError(path + ': expected ' + '/'.join(types))
+
+
+def normalize_profile(raw):
+    result = _normalize(raw, SCHEMA, 'profile')
+    result.setdefault('basics', {})
+    for field in ('skills', 'experience', 'projects', 'education', 'certifications'):
+        result.setdefault(field, [])
+    return result
+
+
+def digest(value):
+    return hashlib.sha256(json.dumps(value, ensure_ascii=False, sort_keys=True, separators=(',', ':')).encode()).hexdigest()
+
+
+def missing_fields(profile):
+    # Informational gaps; optional omissions never turn into invented defaults.
+    return ['basics.' + field for field in ('name', 'title', 'email', 'phone')
+            if not profile.get('basics', {}).get(field)]
+
+
+def delivery_errors(profile):
+    errors = []
+    if not profile['basics'].get('name'):
+        errors.append('A non-empty candidate name is required for delivery')
+    if not any(profile.get(key) for key in ('experience', 'projects', 'education', 'skills', 'certifications')):
+        errors.append('At least one substantive resume section is required for delivery')
+    return errors
+
+
+def document(kind, profile, source=None):
+    if kind not in ('draft', 'master', 'variant'):
+        raise ContractError('Unknown document kind: ' + str(kind))
+    profile = normalize_profile(profile)
+    return {'schemaVersion': '1.0', 'kind': kind, 'profile': profile,
+            'profileSha256': digest(profile), 'missingFields': missing_fields(profile),
+            'source': copy.deepcopy(source or {})}
+
+
+def load_document(raw):
+    if not isinstance(raw, dict):
+        raise ContractError('Profile document must be an object')
+    if 'profile' not in raw:
+        # Existing --profile-json inputs are explicit user/Agent supplied facts.
+        return document('master', raw, {'type': 'legacy-user-input'})
+    unknown = set(raw) - {'schemaVersion', 'kind', 'profile', 'profileSha256', 'missingFields', 'source'}
+    if unknown:
+        raise ContractError('Unsupported document fields: ' + ', '.join(sorted(unknown)))
+    if raw.get('schemaVersion') != '1.0':
+        raise ContractError('Unsupported profile schemaVersion')
+    source = raw.get('source', {})
+    if not isinstance(source, dict):
+        raise ContractError('Document source must be an object')
+    result = document(raw.get('kind'), raw['profile'], source)
+    if raw.get('profileSha256') and result['profileSha256'] != raw['profileSha256']:
+        raise ContractError('Profile hash mismatch; regenerate metadata after editing facts')
+    if result['kind'] == 'variant' and not source.get('masterSha256'):
+        raise ContractError('Variant requires source.masterSha256')
+    return result

package/scripts/evidence/extract-evidence.py

@@ -225,86 +225,133 @@ def scan_repo(repo_path: Path) -> Dict[str, Any]:
     return facts
 
 def build_master_profile(facts: Dict[str, Any], user_overrides: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+    """Build structured candidate profile from codebase facts + optional user overrides.
+
+    Placeholder discipline:
+    - repo_mode=True : facts dict is populated from real repo scan; safe to synthesize
+      experience/education skeletons because they'll be user-reviewed before use.
+    - repo_mode=False: only user_overrides carry real data. NEVER emit fabricated placeholder
+      strings (fake company, fake school, fake dates). Use null / empty list instead.
+    """
     overrides = user_overrides or {}
     author = facts.get("author_info", {})
-    
-    name = overrides.get("name") or author.get("name") or "求职者"
-    title = overrides.get("title") or "资深工程师 / 技术专家"
-    email = overrides.get("email") or author.get("email") or "candidate@example.com"
-    phone = overrides.get("phone") or "138-0000-0000"
-    github = overrides.get("github") or author.get("git_remote") or "https://github.com"
-    
+    repo_mode: bool = bool(facts.get("detected_tech_stacks") or facts.get("evidence_items"))
+
+    # ── Basics ────────────────────────────────────────────────────────────────
+    name  = overrides.get("name")  or author.get("name")  or (None if not repo_mode else "候选人")
+    title = overrides.get("title") or (None if not repo_mode else "资深工程师 / 技术专家")
+    email = overrides.get("email") or author.get("email") or (None if not repo_mode else "candidate@example.com")
+    phone = overrides.get("phone") or (None if not repo_mode else None)
+    github = overrides.get("github") or author.get("git_remote") or None
+    location = overrides.get("location") or (None if not repo_mode else None)
+
     tech_stacks = facts.get("detected_tech_stacks", [])
-    languages = list(facts.get("detected_languages", {}).keys())
-
-    profile = {
-        "basics": {
-            "name": name,
-            "title": title,
-            "email": email,
-            "phone": phone,
-            "location": overrides.get("location") or "北京 / 远程",
-            "github": github,
-            "summary": f"拥有坚实的技术研发与工程化落地实战经验，主导过多个基于 {', '.join((tech_stacks + languages)[:3])} 的核心系统设计与交付。"
-        },
-        "skills": [
-            {
-                "category": "核心技术栈",
-                "items": tech_stacks if tech_stacks else ["Python", "TypeScript", "FastAPI", "React", "Docker"],
-                "highlighted": tech_stacks[:4]
-            },
-            {
-                "category": "工程化与架构",
-                "items": facts.get("architectural_signals", ["CI/CD", "微服务架构", "自动化测试", "性能优化"]),
-                "highlighted": ["CI/CD", "性能优化"]
-            }
-        ],
-        "experience": [
+    languages   = list(facts.get("detected_languages", {}).keys())
+
+    # ── Skills ────────────────────────────────────────────────────────────────
+    all_tech = tech_stacks + [l for l in languages if l not in tech_stacks]
+    arch_signals = facts.get("architectural_signals", [])
+    skills: list = []
+    if all_tech:
+        skills.append({"category": "核心技术栈", "items": all_tech, "highlighted": all_tech[:4]})
+    if arch_signals:
+        skills.append({"category": "工程化与架构", "items": arch_signals, "highlighted": arch_signals[:2]})
+
+    # ── Experience ────────────────────────────────────────────────────────────
+    bullets = [
+        {
+            "text": item["claim"],
+            "evidenceLevel": item["evidenceLevel"],
+            "evidenceSource": item["evidenceSource"],
+            "keywords": item.get("keywords", [])
+        }
+        for item in facts.get("evidence_items", [])
+    ]
+
+    if repo_mode and bullets:
+        # Repo mode: synthesize a single experience entry from code evidence.
+        # Company / dates are placeholders that the user MUST review.
+        experience = [
             {
-                "company": overrides.get("company") or "创新科技企业",
-                "role": title,
-                "startDate": "2022.06",
-                "endDate": "至今",
-                "location": "北京",
+                "company": overrides.get("company") or "[请填写：公司名称]",
+                "role": title or "[请填写：职位名称]",
+                "startDate": overrides.get("startDate") or "[请填写：开始时间]",
+                "endDate": overrides.get("endDate") or "至今",
+                "location": location or "[请填写：工作地点]",
                 "summary": "负责核心产品研发与关键架构攻坚",
-                "bullets": [
-                    {
-                        "text": item["claim"],
-                        "evidenceLevel": item["evidenceLevel"],
-                        "evidenceSource": item["evidenceSource"],
-                        "keywords": item["keywords"]
-                    }
-                    for item in facts.get("evidence_items", [])
-                ]
+                "bullets": bullets
             }
-        ],
-        "projects": [
+        ]
+    elif overrides.get("experience"):
+        experience = overrides["experience"]
+    else:
+        experience = []
+
+    # ── Projects ──────────────────────────────────────────────────────────────
+    if repo_mode and tech_stacks:
+        projects = [
             {
-                "name": facts.get("repo_name", "CoreSystem"),
+                "name": facts.get("repo_name") or "[请填写：项目名称]",
                 "role": "核心负责人 / 主力开发者",
                 "techStack": tech_stacks[:5],
                 "repoUrl": github,
-                "startDate": "2023.01",
+                "startDate": "[请填写：开始时间]",
                 "endDate": "至今",
                 "bullets": [
-                    {
-                        "text": item["claim"],
-                        "evidenceLevel": item["evidenceLevel"],
-                        "evidenceSource": item["evidenceSource"]
-                    }
+                    {"text": item["claim"], "evidenceLevel": item["evidenceLevel"], "evidenceSource": item["evidenceSource"]}
                     for item in facts.get("evidence_items", [])
                 ]
             }
-        ],
-        "education": [
+        ]
+    elif overrides.get("projects"):
+        projects = overrides["projects"]
+    else:
+        projects = []
+
+    # ── Education ─────────────────────────────────────────────────────────────
+    if overrides.get("education"):
+        education = overrides["education"]
+    elif overrides.get("school") or overrides.get("degree"):
+        education = [
+            {
+                "institution": overrides.get("school") or "[请填写：学校名称]",
+                "degree": overrides.get("degree") or "[请填写：学历与专业]",
+                "startDate": overrides.get("edu_start") or "[请填写：入学时间]",
+                "endDate": overrides.get("edu_end") or "[请填写：毕业时间]"
+            }
+        ]
+    elif repo_mode:
+        # Repo mode: emit a reminder skeleton so the user knows to fill it in.
+        education = [
             {
-                "institution": overrides.get("school") or "重点大学",
-                "degree": overrides.get("degree") or "计算机科学与技术 本科",
-                "startDate": "2016.09",
-                "endDate": "2020.06"
+                "institution": "[请填写：学校名称]",
+                "degree": "[请填写：学历与专业]",
+                "startDate": "[请填写：入学时间]",
+                "endDate": "[请填写：毕业时间]"
             }
         ]
-    }
+    else:
+        education = []
+
+    # ── Assemble ──────────────────────────────────────────────────────────────
+    basics: Dict[str, Any] = {}
+    if name:    basics["name"]     = name
+    if title:   basics["title"]    = title
+    if email:   basics["email"]    = email
+    if phone:   basics["phone"]    = phone
+    if location: basics["location"] = location
+    if github:  basics["github"]   = github
+    if all_tech:
+        basics["summary"] = (
+            f"拥有坚实的技术研发与工程化落地实战经验，"
+            f"主导过多个基于 {', '.join(all_tech[:3])} 的核心系统设计与交付。"
+        )
+
+    profile: Dict[str, Any] = {"basics": basics}
+    if skills:     profile["skills"]     = skills
+    if experience: profile["experience"] = experience
+    if projects:   profile["projects"]   = projects
+    if education:  profile["education"]  = education
     return profile
 
 def main():