knowme-careerforge-skill 0.0.1 → 0.0.2

package/scripts/{validate-ats.ts → validation/validate-ats.ts}

@@ -12,8 +12,8 @@ interface AtsValidationResult {
   status: 'PASS' | 'WARN' | 'FAIL';
   candidateName: string | null;
   detectedContacts: {
-    phone: string | null;
     email: string | null;
+    phone: string | null;
   };
   headingsFound: Array<{
     level: string;
@@ -44,26 +44,24 @@ export async function validateAts(htmlPath: string): Promise<AtsValidationResult
   await page.goto(`file://${absoluteHtml}`, { waitUntil: 'networkidle' });
 
   const rawData = await page.evaluate(() => {
-    const nameEl = document.querySelector('.candidate-name, h1');
-    const name = nameEl ? (nameEl.textContent || '').trim() : null;
-
-    const fullText = (document.body.innerText || '').trim();
+    const nameEl = document.querySelector('.candidate-name') || document.querySelector('h1');
+    const candidateName = nameEl ? nameEl.textContent?.trim() || null : null;
 
-    // 提取电话与邮箱
-    const phoneMatch = fullText.match(/(?:(?:\+|00)86)?1[3-9]\d{9}|(?:1[3-9]\d-\d{4}-\d{4})/);
-    const emailMatch = fullText.match(/[a-zA-Z0-9_.+-]+@[a-zA-Z0-9-]+\.[a-zA-Z0-9-.]+/);
+    const bodyText = document.body.innerText || '';
+    const emailMatch = bodyText.match(/[a-zA-Z0-9_.+-]+@[a-zA-Z0-9-]+\.[a-zA-Z0-9-.]+/);
+    const phoneMatch = bodyText.match(/1[3-9]\d{9}|\+?\d{1,4}[-\s]?\d{7,11}/);
 
-    const headings = Array.from(document.querySelectorAll('h1, h2, h3, .section-title, .sub-title')).map(h => ({
+    const headings = Array.from(document.querySelectorAll('h1, h2, h3, h4')).map(h => ({
       level: h.tagName.toLowerCase(),
-      text: (h.textContent || '').trim()
+      text: h.textContent?.replace(/[\s\n]+/g, ' ').trim() || ''
     }));
 
     return {
-      candidateName: name,
-      phone: phoneMatch ? phoneMatch[0] : null,
+      candidateName,
       email: emailMatch ? emailMatch[0] : null,
+      phone: phoneMatch ? phoneMatch[0] : null,
       headings,
-      fullTextLength: fullText.length
+      totalTextLength: bodyText.trim().length
     };
   });
 
@@ -85,12 +83,11 @@ export async function validateAts(htmlPath: string): Promise<AtsValidationResult
   }
 
   const validatedHeadings = rawData.headings.map(h => {
-    const textClean = h.text.toLowerCase().replace(/[^\w\u4e00-\u9fa5]/g, '');
-    const isStd = STANDARD_SECTION_HEADERS.some(s => textClean.includes(s.toLowerCase().replace(/\s+/g, '')));
+    const textClean = h.text.toLowerCase();
+    const isStandard = STANDARD_SECTION_HEADERS.some(sh => textClean.includes(sh.toLowerCase()));
     return {
-      level: h.level,
-      text: h.text,
-      isStandard: isStd
+      ...h,
+      isStandard
     };
   });
 
@@ -105,11 +102,11 @@ export async function validateAts(htmlPath: string): Promise<AtsValidationResult
     status,
     candidateName: rawData.candidateName,
     detectedContacts: {
-      phone: rawData.phone,
-      email: rawData.email
+      email: rawData.email,
+      phone: rawData.phone
     },
     headingsFound: validatedHeadings,
-    totalTextLength: rawData.fullTextLength,
+    totalTextLength: rawData.totalTextLength,
     warnings,
     errors
   };
@@ -126,6 +123,8 @@ async function main() {
       i++;
     } else if (args[i] === '--json') {
       jsonOutput = true;
+    } else if (!args[i].startsWith('-')) {
+      htmlPath = args[i];
     }
   }
 
@@ -134,36 +133,41 @@ async function main() {
 
     if (jsonOutput) {
       console.log(JSON.stringify(result, null, 2));
-      return;
+      process.exit(result.status === 'FAIL' ? 1 : 0);
     }
 
     console.log('======================================================');
     console.log(`  KnowMe CareerForge — ATS Compliance QA: [${result.status}]`);
-    console.log(`  Candidate Name : ${result.candidateName || 'N/A'}`);
-    console.log(`  Phone Extracted: ${result.detectedContacts.phone || 'None'}`);
-    console.log(`  Email Extracted: ${result.detectedContacts.email || 'None'}`);
+    console.log(`  Candidate Name : ${result.candidateName || 'NOT FOUND'}`);
+    console.log(`  Phone Extracted: ${result.detectedContacts.phone || 'NOT DETECTED'}`);
+    console.log(`  Email Extracted: ${result.detectedContacts.email || 'NOT DETECTED'}`);
     console.log(`  Text Extracted : ${result.totalTextLength} characters`);
     console.log('------------------------------------------------------');
     console.log('  Headings Structure:');
     for (const h of result.headingsFound) {
-      const tag = h.isStandard ? '✓' : '?';
-      console.log(`    [${tag}] <${h.level}> ${h.text}`);
+      const mark = h.isStandard ? '[✓]' : '[?]';
+      console.log(`    ${mark} <${h.level}> ${h.text}`);
     }
 
-    if (result.errors.length > 0) {
-      console.log('\n[!] Errors:');
-      for (const e of result.errors) console.log(`  - ✗ ${e}`);
+    if (result.warnings.length > 0) {
+      console.log('\n[!] Warnings:');
+      for (const w of result.warnings) {
+        console.log(`  - ⚠️  ${w}`);
+      }
     }
 
-    if (result.warnings.length > 0) {
-      console.log('\n[?] Warnings:');
-      for (const w of result.warnings) console.log(`  - ⚠️ ${w}`);
+    if (result.errors.length > 0) {
+      console.log('\n[✗] Errors:');
+      for (const e of result.errors) {
+        console.log(`  - ✗ ${e}`);
+      }
     }
 
     console.log('======================================================');
+    process.exit(result.status === 'FAIL' ? 1 : 0);
   } catch (err: unknown) {
-    const msg = err instanceof Error ? err.message : String(err);
-    console.error(`[✗] ATS Validation Failed: ${msg}`);
+    const errorMsg = err instanceof Error ? err.message : String(err);
+    console.error(`[✗] ATS Validation Failed: ${errorMsg}`);
     process.exit(1);
   }
 }

package/scripts/{validate-layout.ts → validation/validate-layout.ts}

@@ -14,15 +14,15 @@ interface LayoutValidationResult {
   totalPagesFound: number;
   pageDetails: Array<{
     pageIndex: number;
-    measuredHeightPx: number;
+    actualHeightPx: number;
     allowedHeightPx: number;
-    overflowPx: number;
     isOverflow: boolean;
+    overflowDeltaPx: number;
   }>;
   overflowSections: Array<{
     selector: string;
-    heightPx: number;
-    textPreview: string;
+    bottomPx: number;
+    overflowByPx: number;
   }>;
 }
 
@@ -35,7 +35,7 @@ export async function validateLayout(htmlPath: string, expectedPages: number = 1
   const browser = await chromium.launch({ headless: true });
   const context = await browser.newContext({
     viewport: { width: 794, height: 1123 }, // A4 at 96 DPI
-    deviceScaleFactor: 2
+    deviceScaleFactor: 1
   });
 
   const page = await context.newPage();
@@ -47,39 +47,44 @@ export async function validateLayout(htmlPath: string, expectedPages: number = 1
 
   const evaluation = await page.evaluate((allowedHeight) => {
     const pages = Array.from(document.querySelectorAll('.resume-page'));
-    const details = pages.map((el, index) => {
-      const rect = el.getBoundingClientRect();
-      const scrollH = el.scrollHeight;
-      const actualH = Math.max(rect.height, scrollH);
-      const diff = actualH - allowedHeight;
+    const details = pages.map((p, idx) => {
+      const rect = p.getBoundingClientRect();
+      const actualHeight = Math.ceil(rect.height);
+      const isOverflow = actualHeight > allowedHeight + 2; // 2px 浮点容差
       return {
-        pageIndex: index + 1,
-        measuredHeightPx: Math.round(actualH * 10) / 10,
+        pageIndex: idx + 1,
+        actualHeightPx: actualHeight,
         allowedHeightPx: allowedHeight,
-        overflowPx: diff > 2 ? Math.round(diff * 10) / 10 : 0,
-        isOverflow: diff > 2
+        isOverflow,
+        overflowDeltaPx: isOverflow ? Math.ceil(actualHeight - allowedHeight) : 0
       };
     });
 
-    const overflows: Array<{ selector: string; heightPx: number; textPreview: string }> = [];
+    const overflowSections: Array<{ selector: string; bottomPx: number; overflowByPx: number }> = [];
     if (details.some(d => d.isOverflow)) {
-      const sections = Array.from(document.querySelectorAll('.resume-section, .timeline-item, .milestone-item, .experience-item, tr'));
-      for (const s of sections) {
-        const r = s.getBoundingClientRect();
-        if (r.bottom > allowedHeight) {
-          overflows.push({
-            selector: s.className || s.tagName.toLowerCase(),
-            heightPx: Math.round(r.height),
-            textPreview: (s.textContent || '').trim().slice(0, 60)
+      const items = Array.from(document.querySelectorAll('.experience-item, .project-item, .skills-content, .resume-section'));
+      for (const item of items) {
+        const rect = item.getBoundingClientRect();
+        if (rect.bottom > allowedHeight) {
+          overflowSections.push({
+            selector: item.className ? `.${item.className.split(' ').join('.')}` : item.tagName.toLowerCase(),
+            bottomPx: Math.ceil(rect.bottom),
+            overflowByPx: Math.ceil(rect.bottom - allowedHeight)
           });
         }
       }
     }
 
     return {
-      totalPagesFound: pages.length,
-      pageDetails: details,
-      overflowSections: overflows
+      totalPagesFound: pages.length || 1,
+      pageDetails: details.length ? details : [{
+        pageIndex: 1,
+        actualHeightPx: Math.ceil(document.body.getBoundingClientRect().height),
+        allowedHeightPx: allowedHeight,
+        isOverflow: document.body.getBoundingClientRect().height > allowedHeight + 2,
+        overflowDeltaPx: Math.max(0, Math.ceil(document.body.getBoundingClientRect().height - allowedHeight))
+      }],
+      overflowSections
     };
   }, A4_HEIGHT_PX);
 
@@ -111,6 +116,8 @@ async function main() {
       i++;
     } else if (args[i] === '--json') {
       jsonOutput = true;
+    } else if (!args[i].startsWith('-')) {
+      htmlPath = args[i];
     }
   }
 
@@ -119,7 +126,7 @@ async function main() {
 
     if (jsonOutput) {
       console.log(JSON.stringify(result, null, 2));
-      return;
+      process.exit(result.status === 'PASS' ? 0 : 1);
     }
 
     console.log('======================================================');
@@ -129,29 +136,23 @@ async function main() {
     console.log('------------------------------------------------------');
 
     for (const p of result.pageDetails) {
-      const statusSymbol = p.isOverflow ? '✗ OVERFLOW' : '✓ FIT';
-      console.log(`  Page ${p.pageIndex}: ${p.measuredHeightPx}px / ${p.allowedHeightPx}px [${statusSymbol}] (Overflow: ${p.overflowPx}px)`);
+      const fitText = p.isOverflow ? `[✗ OVERFLOW by ${p.overflowDeltaPx}px]` : `[✓ FIT] (Overflow: ${p.overflowDeltaPx}px)`;
+      console.log(`  Page ${p.pageIndex}: ${p.actualHeightPx}px / ${p.allowedHeightPx}px ${fitText}`);
     }
 
     if (result.overflowSections.length > 0) {
-      console.log('\n[!] Nodes exceeding A4 physical boundary:');
-      for (const o of result.overflowSections) {
-        console.log(`  - <${o.selector}> (${o.heightPx}px): "${o.textPreview}..."`);
+      console.log('\n[!] Offending Overflow Elements:');
+      for (const el of result.overflowSections.slice(0, 3)) {
+        console.log(`  - Element "${el.selector}" exceeds A4 baseline by ${el.overflowByPx}px (Bottom: ${el.bottomPx}px)`);
       }
-      console.log('\n[Self-Healing Guidance]:');
-      console.log('  1. Reduce --resume-space-section by 1~2pt in workspace/resume.html <style>');
-      console.log('  2. Reduce --resume-font-size-body by 0.2pt');
-      console.log('  3. Condense verbose bullet points');
+      console.log('\n💡 Recommendation: Reduce --resume-space-section by 1~2pt or reduce --resume-font-size-body by 0.2pt in <style>.');
     }
 
     console.log('======================================================');
-
-    if (result.status === 'OVERFLOW') {
-      process.exit(1);
-    }
+    process.exit(result.status === 'PASS' ? 0 : 1);
   } catch (err: unknown) {
-    const msg = err instanceof Error ? err.message : String(err);
-    console.error(`[✗] Layout Validation Failed: ${msg}`);
+    const errorMsg = err instanceof Error ? err.message : String(err);
+    console.error(`[✗] Layout Validation Failed: ${errorMsg}`);
     process.exit(1);
   }
 }

package/scripts/{validate-resume.py → validation/validate-resume.py}

@@ -7,21 +7,28 @@ KnowMe CareerForge — Resume Validation Engine (Layout, Schema & ATS Compliance
 import sys, os, json, argparse, re
 from pathlib import Path
 
+def get_project_root() -> Path:
+    curr = Path(__file__).resolve().parent
+    for _ in range(5):
+        if (curr / "SKILL.md").exists() or (curr / "package.json").exists():
+            return curr
+        curr = curr.parent
+    return Path.cwd()
+
 def validate_resume_html(html_path: str, expected_pages: int = 1) -> dict:
     p = Path(html_path)
     if not p.exists():
-        # 尝试相对于脚本目录上一级
-        alt = Path(__file__).resolve().parent.parent / html_path
+        root = get_project_root()
+        alt = root / html_path
         if alt.exists():
             p = alt
         else:
             return {
                 "status": "FAIL",
-                "file": html_path,
-                "expectedPages": expected_pages,
-                "checks": {},
-                "errors": [f"HTML file not found at: {html_path}"],
-                "warnings": []
+                "file": str(p),
+                "errors": [f"File not found: {html_path}"],
+                "warnings": [],
+                "checks": {}
             }
 
     content = p.read_text(encoding="utf-8")
@@ -45,7 +52,9 @@ def validate_resume_html(html_path: str, expected_pages: int = 1) -> dict:
     required_tokens = [
         "--resume-page-width",
         "--resume-page-min-height",
-        "--resume-font-size-body"
+        "--resume-font-size-body",
+        "--resume-space-section",
+        "--resume-color-primary"
     ]
     missing_tokens = []
     for token in required_tokens:
@@ -72,18 +81,18 @@ def validate_resume_html(html_path: str, expected_pages: int = 1) -> dict:
 
     checks["detected_sections"] = detected_sections
 
-    # 6. 单页高度预估 (剔除 <style> 后的实际可见文字量)
+    # 6. 单页高度预估 (可见文字量)
     body_text_only = re.sub(r'<style.*?>.*?</style>', '', content, flags=re.DOTALL)
     visible_text = re.sub(r'<[^>]+>', '', body_text_only).strip()
     char_count = len(re.sub(r'\s+', ' ', visible_text))
 
     density_status = "OPTIMAL"
     if expected_pages == 1:
-        if char_count > 1500:
-            warnings.append(f"Visible text volume ({char_count} chars) is high for a single-page resume; risk of overflow.")
-            density_status = "HIGH_RISK_OVERFLOW"
-        elif char_count < 400:
-            warnings.append(f"Visible text volume ({char_count} chars) is low for a single-page resume; canvas may appear sparse.")
+        if char_count > 1600:
+            warnings.append(f"High text density for 1 page: {char_count} chars (recommend trimming or reducing spacing tokens)")
+            density_status = "OVERFLOW_RISK"
+        elif char_count < 300:
+            warnings.append(f"Low content volume for 1 page: {char_count} chars")
             density_status = "UNDERFLOW"
 
     checks["char_count"] = char_count
@@ -95,21 +104,21 @@ def validate_resume_html(html_path: str, expected_pages: int = 1) -> dict:
         "status": "PASS" if passed else "FAIL",
         "file": str(p.resolve()),
         "expectedPages": expected_pages,
-        "checks": checks,
         "errors": errors,
-        "warnings": warnings
+        "warnings": warnings,
+        "checks": checks
     }
 
 def main():
     parser = argparse.ArgumentParser(description="KnowMe CareerForge — Resume Validator")
-    parser.add_argument("--html", "-i", default="workspace/resume.html", help="Path to resume HTML (default: workspace/resume.html)")
-    parser.add_argument("--expected-pages", "-p", type=int, default=1, help="Expected page count (default: 1)")
-    parser.add_argument("--json", action="store_true", help="Output JSON format")
+    parser.add_argument("path", nargs="?", default="workspace/resume.html", help="Path to resume.html")
+    parser.add_argument("--html", help="Path to resume.html (named)")
+    parser.add_argument("--expected-pages", "-p", type=int, default=1, help="Expected target pages (1 or 2)")
+    parser.add_argument("--json", action="store_true", help="Output JSON result")
 
     args = parser.parse_args()
-
-    result = validate_resume_html(args.html, args.expected_pages)
-
+    target_html = args.html or args.path
+    result = validate_resume_html(target_html, expected_pages=args.expected_pages)
     if args.json:
         print(json.dumps(result, ensure_ascii=False, indent=2))
         return

package/skill.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/skill.json",
   "name": "knowme-careerforge",
   "displayName": "KnowMe CareerForge",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "An agent-native skill for self-discovery, career positioning, and tailored resume engineering. Know yourself. Define your direction. Forge your opportunity.",
   "author": "Miles <https://github.com/Max-Samson>",
   "license": "MIT",

package/src/knowledge/index.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.0.1",
+  "version": "0.0.2",
   "totalRoles": 9,
   "totalTemplates": 4,
   "roles": [

package/src/knowledge/resume-schema.json

@@ -0,0 +1,112 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "CandidateResumeSchema",
+  "description": "KnowMe CareerForge Candidate Master Profile & Tailored Resume Schema with L1~L3 Evidence Chains.",
+  "type": "object",
+  "required": ["basics", "skills", "experience", "education"],
+  "properties": {
+    "basics": {
+      "type": "object",
+      "required": ["name", "title", "email", "phone"],
+      "properties": {
+        "name": { "type": "string", "description": "Candidate's full name" },
+        "title": { "type": "string", "description": "Professional job title or target role" },
+        "email": { "type": "string", "format": "email" },
+        "phone": { "type": "string" },
+        "location": { "type": "string" },
+        "website": { "type": "string" },
+        "github": { "type": "string" },
+        "summary": { "type": "string", "description": "Core Value Proposition (15-30 words)" }
+      }
+    },
+    "skills": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["category", "items"],
+        "properties": {
+          "category": { "type": "string" },
+          "items": { "type": "array", "items": { "type": "string" } },
+          "highlighted": { "type": "array", "items": { "type": "string" } }
+        }
+      }
+    },
+    "experience": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["company", "role", "startDate", "endDate", "bullets"],
+        "properties": {
+          "company": { "type": "string" },
+          "role": { "type": "string" },
+          "startDate": { "type": "string" },
+          "endDate": { "type": "string" },
+          "location": { "type": "string" },
+          "summary": { "type": "string" },
+          "bullets": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["text", "evidenceLevel"],
+              "properties": {
+                "text": { "type": "string" },
+                "evidenceLevel": { "type": "string", "enum": ["L1", "L2", "L3"] },
+                "evidenceSource": { "type": "string" },
+                "keywords": { "type": "array", "items": { "type": "string" } }
+              }
+            }
+          }
+        }
+      }
+    },
+    "projects": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name", "role", "techStack", "bullets"],
+        "properties": {
+          "name": { "type": "string" },
+          "role": { "type": "string" },
+          "techStack": { "type": "array", "items": { "type": "string" } },
+          "repoUrl": { "type": "string" },
+          "demoUrl": { "type": "string" },
+          "startDate": { "type": "string" },
+          "endDate": { "type": "string" },
+          "bullets": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["text", "evidenceLevel"],
+              "properties": {
+                "text": { "type": "string" },
+                "evidenceLevel": { "type": "string", "enum": ["L1", "L2", "L3"] },
+                "evidenceSource": { "type": "string" },
+                "keywords": { "type": "array", "items": { "type": "string" } }
+              }
+            }
+          }
+        }
+      }
+    },
+    "education": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["institution", "degree", "startDate", "endDate"],
+        "properties": {
+          "institution": { "type": "string" },
+          "degree": { "type": "string" },
+          "field": { "type": "string" },
+          "startDate": { "type": "string" },
+          "endDate": { "type": "string" },
+          "gpa": { "type": "string" },
+          "honors": { "type": "array", "items": { "type": "string" } }
+        }
+      }
+    },
+    "certifications": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  }
+}

package/src/workflows/forge-resume.md

@@ -8,11 +8,11 @@
 
 1. **执行模板检索**：
    ```bash
-   python3 scripts/search-template.py "<Target Role>" --style "<minimal|modern|executive|classic>" --target-pages 1
+   python3 scripts/template/search-template.py "<Target Role>" --style "<minimal|modern|executive|classic>" --target-pages 1
    ```
 2. **实例化中间修改场**：
    ```bash
-   python3 scripts/instantiate-resume.py --template <template_id> --keywords "Python,LLM,RAG,FastAPI" --output workspace/resume.html
+   python3 scripts/template/instantiate-resume.py --template <template_id> --keywords "Python,LLM,RAG,FastAPI" --output workspace/resume.html
    ```
 
 ## 2. 修改场编辑规范

package/src/workflows/review.md

@@ -8,12 +8,12 @@
 
 1. **测试 1：布局与 DOM 高度溢出检测**：
    ```bash
-   python3 scripts/validate-resume.py --html workspace/resume.html --expected-pages 1
+   python3 scripts/validation/validate-resume.py --html workspace/resume.html --expected-pages 1
    ```
    - 单页标准高度：$297\text{mm} \times 96\text{DPI} / 25.4 \approx 1122.5\text{px}$。
 2. **测试 2：ATS 纯文本流解析检测**：
    ```bash
-   npx ts-node scripts/validate-ats.ts --html workspace/resume.html
+   npx ts-node scripts/validation/validate-ats.ts --html workspace/resume.html
    ```
 
 ## 2. 自动化自愈修复闭环
@@ -27,5 +27,5 @@
 ## 3. 确定性无损 PDF 导出
 
 ```bash
-npx ts-node scripts/render-pdf.ts --input workspace/resume.html --output workspace/resume.pdf
+python3 scripts/rendering/render-pdf.py workspace/resume.html workspace/resume.pdf
 ```

package/scripts/instantiate-resume.py

@@ -1,83 +0,0 @@
-#!/usr/bin/env python3
-"""
-KnowMe CareerForge — Resume Workspace Instantiator
-将指定模板与关键词高亮组装为自包含的单文件 HTML 工作区修改场 (Intermediate Working Canvas)。
-"""
-
-import sys, os, json, argparse, re
-from pathlib import Path
-
-def highlight_keywords(text, keywords):
-    if not keywords:
-        return text
-    for kw in keywords:
-        kw_clean = kw.strip()
-        if kw_clean:
-            # 避免对已有标签属性进行错误替换
-            pattern = re.compile(rf'(?<![<\w/])({re.escape(kw_clean)})(?![>\w])', re.IGNORECASE)
-            text = pattern.sub(lambda m: f"<strong>{m.group(0)}</strong>", text)
-    return text
-
-def instantiate_workspace(template_id, keywords=None, output_path="workspace/resume.html"):
-    script_dir = Path(__file__).resolve().parent
-    base_dir = script_dir.parent
-    
-    template_dir = base_dir / "src" / "templates" / template_id
-    
-    if not template_dir.exists():
-        # 尝试通过 ID 查找
-        for sub in (base_dir / "src" / "templates").iterdir():
-            if sub.is_dir() and (sub / "metadata.json").exists():
-                try:
-                    meta = json.loads((sub / "metadata.json").read_text(encoding="utf-8"))
-                    if meta.get("id") == template_id:
-                        template_dir = sub
-                        break
-                except:
-                    pass
-
-    if not template_dir.exists():
-        raise ValueError(f"Template '{template_id}' not found in src/templates/")
-        
-    html_file = template_dir / "template.html"
-    css_file = template_dir / "style.css"
-    
-    if not html_file.exists() or not css_file.exists():
-        raise FileNotFoundError(f"template.html or style.css missing in {template_dir}")
-        
-    html_content = html_file.read_text(encoding="utf-8")
-    css_content = css_file.read_text(encoding="utf-8")
-    
-    # 将外部 style.css 内联进 HTML，形成零依赖单文件工作场
-    inlined_html = html_content.replace(
-        '<link rel="stylesheet" href="style.css">',
-        f'<style>\n{css_content}\n  </style>'
-    )
-    
-    # 注入关键词高亮
-    if keywords:
-        kw_list = [k.strip() for k in keywords.split(",") if k.strip()]
-        inlined_html = highlight_keywords(inlined_html, kw_list)
-        
-    out_file = Path(output_path)
-    out_file.parent.mkdir(parents=True, exist_ok=True)
-    out_file.write_text(inlined_html, encoding="utf-8")
-    
-    print("=" * 70)
-    print(f"  KnowMe CareerForge — Intermediate Canvas Instantiated!")
-    print(f"  Selected Template : {template_id} ({template_dir.name})")
-    print(f"  Working Canvas    : {out_file.resolve()}")
-    print("=" * 70)
-    return out_file
-
-def main():
-    parser = argparse.ArgumentParser(description="KnowMe CareerForge — Workspace Instantiator")
-    parser.add_argument("--template", "-t", required=True, help="Template ID (minimal, modern, executive, classic)")
-    parser.add_argument("--keywords", "-k", default=None, help="Comma-separated keywords to highlight (e.g. 'Python,LLM,RAG')")
-    parser.add_argument("--output", "-o", default="workspace/resume.html", help="Output canvas path (default: workspace/resume.html)")
-
-    args = parser.parse_args()
-    instantiate_workspace(args.template, keywords=args.keywords, output_path=args.output)
-
-if __name__ == "__main__":
-    main()