knowme-careerforge-skill 0.0.1

package/scripts/build-gallery.py

@@ -0,0 +1,233 @@
+#!/usr/bin/env python3
+"""
+KnowMe CareerForge — Template Gallery Builder
+扫描验证 src/templates/ 核心模板，生成 output/templates_gallery/ 静态可视化画廊。
+"""
+
+import os, sys, json, re
+from pathlib import Path
+
+def build_gallery():
+    base_dir = Path(__file__).resolve().parent.parent
+    templates_dir = base_dir / "src" / "templates"
+    gallery_dir = base_dir / "output" / "templates_gallery"
+    gallery_dir.mkdir(parents=True, exist_ok=True)
+    
+    gallery_items = []
+
+    print("==============================================================")
+    print("  KnowMe CareerForge — Template Gallery Builder")
+    print("==============================================================")
+
+    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_raw = html_file.read_text(encoding="utf-8")
+            css_raw = css_file.read_text(encoding="utf-8")
+
+            # 生成单文件自包含预览页面
+            inlined_preview = html_raw.replace(
+                '<link rel="stylesheet" href="style.css">',
+                f'<style>\n{css_raw}\n  </style>'
+            )
+
+            preview_path = gallery_dir / f"{meta['id']}.html"
+            preview_path.write_text(inlined_preview, encoding="utf-8")
+
+            gallery_items.append({
+                "id": meta["id"],
+                "name": meta.get("name", meta["id"]),
+                "style": meta.get("style", "custom"),
+                "category": meta.get("roleCategory", "engineering-ai"),
+                "accent": meta.get("visualStyle", {}).get("accentColor", "#2563eb"),
+                "targetPages": meta.get("layout", {}).get("targetPages", 1),
+                "density": meta.get("layout", {}).get("density", "balanced"),
+                "supported": meta.get("supportedRoles", []),
+                "previewUrl": f"{meta['id']}.html"
+            })
+            print(f"[✓] Generated Gallery Preview -> {preview_path.name}")
+        except Exception as e:
+            print(f"[✗] Error processing {t_dir.name}: {e}")
+
+    # 生成主索引 index.html
+    gallery_html = f"""<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>KnowMe CareerForge — 核心基准模板画廊</title>
+  <style>
+    :root {{
+      --bg: #0f172a;
+      --card-bg: #1e293b;
+      --border: #334155;
+      --accent: #38bdf8;
+      --text: #f8fafc;
+      --muted: #94a3b8;
+    }}
+    * {{ box-sizing: border-box; margin: 0; padding: 0; }}
+    body {{
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", sans-serif;
+      background: var(--bg);
+      color: var(--text);
+      padding: 32px 20px;
+    }}
+    .container {{
+      max-width: 1360px;
+      margin: 0 auto;
+    }}
+    .header {{
+      text-align: center;
+      margin-bottom: 32px;
+    }}
+    h1 {{ font-size: 26px; color: var(--accent); margin-bottom: 8px; font-weight: 800; }}
+    p.subtitle {{ color: var(--muted); font-size: 14px; max-width: 680px; margin: 0 auto; line-height: 1.5; }}
+    .grid {{
+      display: grid;
+      grid-template-columns: repeat(auto-fit, minmax(400px, 1fr));
+      gap: 24px;
+    }}
+    .card {{
+      background: var(--card-bg);
+      border: 1px solid var(--border);
+      border-radius: 12px;
+      padding: 20px;
+      display: flex;
+      flex-direction: column;
+      gap: 16px;
+      box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.2);
+    }}
+    .card-header {{
+      display: flex;
+      justify-content: space-between;
+      align-items: flex-start;
+      border-bottom: 1px solid var(--border);
+      padding-bottom: 12px;
+    }}
+    .card-title {{
+      font-size: 18px;
+      font-weight: 700;
+      color: var(--text);
+    }}
+    .badge {{
+      font-size: 11px;
+      padding: 3px 8px;
+      border-radius: 12px;
+      background: rgba(56, 189, 248, 0.15);
+      color: var(--accent);
+      border: 1px solid rgba(56, 189, 248, 0.3);
+    }}
+    .meta-list {{
+      display: flex;
+      flex-direction: column;
+      gap: 6px;
+      font-size: 13px;
+      color: var(--muted);
+    }}
+    .meta-item strong {{
+      color: var(--text);
+    }}
+    .tags {{
+      display: flex;
+      flex-wrap: wrap;
+      gap: 6px;
+      margin-top: 4px;
+    }}
+    .tag {{
+      background: #334155;
+      font-size: 11px;
+      padding: 2px 6px;
+      border-radius: 4px;
+      color: #e2e8f0;
+    }}
+    .frame-wrapper {{
+      width: 100%;
+      height: 480px;
+      border: 1px solid var(--border);
+      border-radius: 8px;
+      overflow: hidden;
+      background: #ffffff;
+      position: relative;
+    }}
+    iframe {{
+      width: 210mm;
+      height: 297mm;
+      border: none;
+      transform: scale(0.48);
+      transform-origin: top left;
+      position: absolute;
+      top: 0;
+      left: 0;
+      pointer-events: none;
+    }}
+    .btn {{
+      display: inline-block;
+      text-align: center;
+      background: var(--accent);
+      color: #0f172a;
+      padding: 10px 16px;
+      border-radius: 6px;
+      font-size: 13px;
+      font-weight: 700;
+      text-decoration: none;
+      transition: opacity 0.2s;
+    }}
+    .btn:hover {{ opacity: 0.9; }}
+  </style>
+</head>
+<body>
+  <div class="container">
+    <div class="header">
+      <h1>KnowMe CareerForge — 核心基准模板画廊</h1>
+      <p class="subtitle">面向 AI Agent 的确定性 HTML 简历设计工作场。所有模板均遵循 A4 绝对印刷几何与 CSS Design Tokens 规范。</p>
+    </div>
+    <div class="grid">
+"""
+
+    for item in gallery_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">
+          <div>
+            <div class="card-title">{item['name']}</div>
+            <div style="font-size: 12px; color: var(--muted); margin-top: 2px;">ID: <code>{item['id']}</code></div>
+          </div>
+          <span class="badge">{item['style']}</span>
+        </div>
+        <div class="meta-list">
+          <div class="meta-item"><strong>类别：</strong>{item['category']} | <strong>页数：</strong>{item['targetPages']} 页 | <strong>密度：</strong>{item['density']}</div>
+          <div class="meta-item"><strong>支持岗位：</strong></div>
+          <div class="tags">{tags_html}</div>
+        </div>
+        <div class="frame-wrapper">
+          <iframe src="{item['previewUrl']}"></iframe>
+        </div>
+        <a href="{item['previewUrl']}" target="_blank" class="btn">打开独立预览 (A4 全尺寸)</a>
+      </div>
+"""
+
+    gallery_html += """
+    </div>
+  </div>
+</body>
+</html>
+"""
+    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()

package/scripts/build-knowledge.py

@@ -0,0 +1,81 @@
+#!/usr/bin/env python3
+"""
+KnowMe CareerForge — Knowledge & Template Index Compiler
+扫描 src/knowledge/ 与 src/templates/，生成全量注册表与知识库索引。
+"""
+
+import sys, os, json, re
+from pathlib import Path
+
+def build_knowledge_index():
+    base_dir = Path(__file__).resolve().parent.parent
+    knowledge_dir = base_dir / "src" / "knowledge"
+    templates_dir = base_dir / "src" / "templates"
+    
+    # 1. 扫描岗位画像
+    roles_dir = knowledge_dir / "roles"
+    roles = []
+    if roles_dir.exists():
+        for f in sorted(roles_dir.glob("*.json")):
+            try:
+                data = json.loads(f.read_text(encoding="utf-8"))
+                roles.append(data)
+            except Exception as e:
+                print(f"[!] Error parsing role {f.name}: {e}")
+                
+    # 2. 扫描模板
+    templates = []
+    if templates_dir.exists():
+        for t_dir in sorted(templates_dir.iterdir()):
+            if not t_dir.is_dir() or t_dir.name == "common":
+                continue
+            meta_file = t_dir / "metadata.json"
+            if meta_file.exists():
+                try:
+                    data = json.loads(meta_file.read_text(encoding="utf-8"))
+                    data["directory"] = f"src/templates/{t_dir.name}"
+                    
+                    # 侦测 CSS 变量
+                    css_file = t_dir / "style.css"
+                    if css_file.exists():
+                        css_text = css_file.read_text(encoding="utf-8")
+                        vars_found = sorted(list(set(re.findall(r'--resume-[\w-]+', css_text))))
+                        data["detectedTokens"] = vars_found
+                        
+                    templates.append(data)
+                except Exception as e:
+                    print(f"[!] Error parsing template {t_dir.name}: {e}")
+
+    # 3. 读取主版本号
+    pkg_json_file = base_dir / "package.json"
+    version = "0.0.1"
+    if pkg_json_file.exists():
+        try:
+            version = json.loads(pkg_json_file.read_text(encoding="utf-8")).get("version", "0.0.1")
+        except:
+            pass
+
+    # 4. 聚合输出
+    index_data = {
+        "version": version,
+        "totalRoles": len(roles),
+        "totalTemplates": len(templates),
+        "roles": roles,
+        "templates": templates
+    }
+
+    out_index = knowledge_dir / "index.json"
+    out_index.write_text(json.dumps(index_data, ensure_ascii=False, indent=2), encoding="utf-8")
+
+    out_templates = knowledge_dir / "templates.json"
+    out_templates.write_text(json.dumps({"templates": templates}, ensure_ascii=False, indent=2), encoding="utf-8")
+
+    print("=" * 60)
+    print("  KnowMe CareerForge — Knowledge Index Built Successfully!")
+    print(f"  Indexed Roles     : {len(roles)}")
+    print(f"  Indexed Templates : {len(templates)}")
+    print(f"  Output Registry   : {out_index.resolve()}")
+    print("=" * 60)
+
+if __name__ == "__main__":
+    build_knowledge_index()

package/scripts/instantiate-resume.py

@@ -0,0 +1,83 @@
+#!/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()

package/scripts/release.py

@@ -0,0 +1,101 @@
+#!/usr/bin/env python3
+"""
+KnowMe CareerForge — Release & NPM Publishing Automation Script
+自动化执行版本同步、知识库编译、画廊刷新、TypeScript 构建、测试验证与 NPM 打包检查。
+"""
+
+import sys, os, subprocess, json, re, argparse
+from pathlib import Path
+
+def run_command(cmd, cwd, desc):
+    print(f"\n[+] {desc}...")
+    proc = subprocess.run(cmd, shell=True, text=True, cwd=cwd, capture_output=True)
+    if proc.returncode != 0:
+        print(f"[✗] Failed at: {desc}")
+        print(f"Error Output:\n{proc.stderr}\n{proc.stdout}")
+        sys.exit(1)
+    print(f"[✓] {desc} succeeded.")
+    return proc.stdout
+
+def main():
+    parser = argparse.ArgumentParser(description="KnowMe CareerForge — Release & NPM Publish Helper")
+    parser.add_argument("version", nargs="?", help="New semantic version to release (e.g. 1.0.1, 1.1.0)")
+    parser.add_argument("--dry-run", action="store_true", help="Perform build and test verification without publishing")
+    parser.add_argument("--publish", action="store_true", help="Directly trigger npm publish --access public after verification")
+
+    args = parser.parse_args()
+    base_dir = Path(__file__).resolve().parent.parent
+
+    # 1. 确定版本号
+    pkg_file = base_dir / "package.json"
+    current_version = "1.0.0"
+    if pkg_file.exists():
+        current_version = json.loads(pkg_file.read_text(encoding="utf-8")).get("version", "1.0.0")
+
+    target_version = args.version or current_version
+
+    if not re.match(r'^\d+\.\d+\.\d+(?:-[\w.]+)?$', target_version):
+        print(f"[!] Invalid semantic version format: {target_version}. Expected format: X.Y.Z (e.g. 1.0.1)")
+        sys.exit(1)
+
+    print("==============================================================")
+    print("  KnowMe CareerForge — NPM Build & Release Automation")
+    print(f"  Current Version : {current_version}")
+    print(f"  Target Version  : {target_version}")
+    print(f"  Working Root    : {base_dir}")
+    print("==============================================================")
+
+    # 2. 同步多文件版本号
+    if target_version != current_version or args.version:
+        sync_script = base_dir / "scripts" / "sync-version.py"
+        run_command(f"python3 {sync_script} {target_version}", base_dir, f"Synchronizing version to v{target_version}")
+
+    # 3. 重新编译知识库索引
+    build_kb = base_dir / "scripts" / "build-knowledge.py"
+    run_command(f"python3 {build_kb}", base_dir, "Compiling Knowledge Base Index")
+
+    # 4. 重新构建模板画廊
+    build_gal = base_dir / "scripts" / "build-gallery.py"
+    run_command(f"python3 {build_gal}", base_dir, "Building HTML Template Gallery")
+
+    # 5. 编译 TypeScript CLI 产物
+    run_command("npm run build", base_dir, "Compiling TypeScript CLI (tsc -> dist/)")
+
+    # 6. 运行全链路自动化测试套件
+    test_script = base_dir / "scripts" / "run-all-tests.py"
+    run_command(f"python3 {test_script}", base_dir, "Running Full-Chain Test Suites (21/21)")
+
+    # 7. NPM 打包预检 (npm pack --dry-run)
+    pack_output = run_command("npm pack --dry-run --json", base_dir, "Inspecting NPM Package Files")
+
+    try:
+        pack_data = json.loads(pack_output)
+        if isinstance(pack_data, list) and len(pack_data) > 0:
+            files_count = pack_data[0].get("entryCount", "N/A")
+            unpacked_size = pack_data[0].get("unpackedSize", "N/A")
+            print(f"\n[📦 NPM Package Stats]: {files_count} files included, Unpacked Size: ~{round(unpacked_size / 1024, 1)} KB")
+    except:
+        pass
+
+    # 8. 发布执行或指引
+    print("\n" + "=" * 62)
+    print(f"  [✓] Release Preparation for v{target_version} Completed!")
+    print("=" * 62)
+
+    if args.publish:
+        print("\n[🚀 Triggering NPM Publish...]")
+        run_command("npm publish --access public", base_dir, f"Publishing v{target_version} to NPM Registry")
+        print(f"\n🎉 Successfully published knowme-careerforge-skill@v{target_version} to NPM!")
+    else:
+        print("\nNext steps to publish your package to NPM:")
+        print("  1. Review Git status and commit changes:")
+        print(f"     git add . && git commit -m \"chore(release): bump version to v{target_version}\"")
+        print(f"     git tag v{target_version} && git push origin main --tags")
+        print("\n  2. Publish to NPM registry:")
+        print("     npm publish --access public")
+        print("\n  3. Verify on NPM:")
+        print(f"     npm view knowme-careerforge-skill@v{target_version}")
+        print(f"     npx knowme-careerforge-skill@{target_version} list\n")
+
+if __name__ == "__main__":
+    main()

package/scripts/render-pdf.ts

@@ -0,0 +1,86 @@
+#!/usr/bin/env ts-node
+/**
+ * KnowMe CareerForge — Playwright Deterministic PDF Renderer
+ * 加载自包含 HTML 中间工作区，等待字体及样式准备就绪，输出标准像素级 A4 PDF。
+ */
+
+import { chromium } from 'playwright';
+import * as path from 'path';
+import * as fs from 'fs';
+
+interface RenderOptions {
+  inputHtml: string;
+  outputPdf: string;
+}
+
+export async function renderResumePdf(options: RenderOptions): Promise<void> {
+  const absoluteHtml = path.resolve(options.inputHtml);
+  const absolutePdf = path.resolve(options.outputPdf);
+
+  if (!fs.existsSync(absoluteHtml)) {
+    throw new Error(`Input HTML file does not exist: ${absoluteHtml}`);
+  }
+
+  // 确保输出目录存在
+  const outputDir = path.dirname(absolutePdf);
+  if (!fs.existsSync(outputDir)) {
+    fs.mkdirSync(outputDir, { recursive: true });
+  }
+
+  console.log('======================================================');
+  console.log('  KnowMe CareerForge — Playwright PDF Renderer');
+  console.log(`  Source Canvas : ${absoluteHtml}`);
+  console.log(`  Target PDF    : ${absolutePdf}`);
+  console.log('======================================================');
+
+  const browser = await chromium.launch({ headless: true });
+  const context = await browser.newContext({
+    viewport: { width: 794, height: 1123 }, // A4 at 96 DPI
+    deviceScaleFactor: 2
+  });
+
+  const page = await context.newPage();
+  await page.goto(`file://${absoluteHtml}`, { waitUntil: 'networkidle' });
+
+  // 确保所有 Web 字体准备就绪
+  await page.evaluateHandle('document.fonts.ready');
+
+  await page.pdf({
+    path: absolutePdf,
+    format: 'A4',
+    printBackground: true,
+    preferCSSPageSize: true,
+    margin: { top: '0px', right: '0px', bottom: '0px', left: '0px' }
+  });
+
+  await browser.close();
+  console.log(`[✓] Deterministic PDF Rendered Successfully -> ${absolutePdf}`);
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  let inputHtml = 'workspace/resume.html';
+  let outputPdf = 'workspace/resume.pdf';
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--input' || args[i] === '-i') {
+      inputHtml = args[i + 1];
+      i++;
+    } else if (args[i] === '--output' || args[i] === '-o') {
+      outputPdf = args[i + 1];
+      i++;
+    }
+  }
+
+  try {
+    await renderResumePdf({ inputHtml, outputPdf });
+  } catch (err: unknown) {
+    const errorMsg = err instanceof Error ? err.message : String(err);
+    console.error(`[✗] PDF Rendering Failed: ${errorMsg}`);
+    process.exit(1);
+  }
+}
+
+if (require.main === module) {
+  main();
+}

package/scripts/run-all-tests.py

@@ -0,0 +1,41 @@
+#!/usr/bin/env python3
+"""
+KnowMe CareerForge — Unified Full-Chain Test Runner
+执行所有自动化测试套件（Templates, ATS, Workflows, End-to-End Pipeline），输出格式化质检报告。
+"""
+
+import os, sys, unittest, time
+from pathlib import Path
+
+def run_all_test_suites():
+    start_time = time.time()
+    base_dir = Path(__file__).resolve().parent.parent
+    tests_dir = base_dir / "tests"
+
+    print("==============================================================")
+    print("  KnowMe CareerForge — Full-Chain Automated Test Suite")
+    print(f"  Test Root : {tests_dir}")
+    print("==============================================================")
+
+    loader = unittest.TestLoader()
+    suite = loader.discover(start_dir=str(tests_dir), pattern="test_*.py")
+
+    runner = unittest.TextTestRunner(verbosity=2)
+    result = runner.run(suite)
+
+    elapsed = time.time() - start_time
+
+    print("\n" + "=" * 62)
+    print("  Test Execution Summary")
+    print(f"  Total Tests Run : {result.testsRun}")
+    print(f"  Failures        : {len(result.failures)}")
+    print(f"  Errors          : {len(result.errors)}")
+    print(f"  Skipped         : {len(result.skipped)}")
+    print(f"  Time Elapsed    : {elapsed:.2f}s")
+    print(f"  Overall Status  : {'[✓] ALL TESTS PASSED' if result.wasSuccessful() else '[✗] TEST FAILURES DETECTED'}")
+    print("==============================================================")
+
+    return 0 if result.wasSuccessful() else 1
+
+if __name__ == "__main__":
+    sys.exit(run_all_test_suites())