Aaradhya-Dev-Tamrakar/brainstorm

作品集项目管理技能

关键规则：当用户要求向作品集网站（F:\AaradhyaDT\AaradhyaDT.github.io）添加、更新或注册新项目或工具时：

• 绝不手动使用正则表达式打开并切片 projects.html 或替换大段字符串块。
• 绝不在 projects.html 中手动创建未加密的原始 GitHub href 标签。
• 绝不硬编码或猜测项目编号（p-00x）或筛选器数量。

你必须调用确定性的项目注册引擎： F:\AaradhyaDT\AaradhyaDT.github.io\scripts\add_project.py

---

1. 快速接入工作流（零 Token 清单模式）

1. 构建一个干净、紧凑的项目 JSON 清单（存储在内存中或作为临时文件）：

{
  "title": "Windows Pilot — 语义化 UIA 与 MCP 桌面自动化引擎",
  "repo_url": "https://github.com/AaradhyaDT/windows-pilot",
  "category": ["apps", "hardware"],
  "status": "2026年9月",
  "bullets": [
    "面向自主 AI 编码代理的关键任务 Windows 桌面自动化引擎。",
    "支持分辨率无关的 Microsoft UI 自动化 (UIA) COM 和 Win32 控件。",
    "具备虚拟桌面感知能力的原生 MCP 服务器 (winpilot-mcp)。"
  ],
  "tags": ["Python 3.10+", "Win32 API", "MCP 服务器", "Windows 11"],
  "section": "personal",
  "tier": "vip"
}

2. 保存到临时文件（例如 new_project.json），并执行预览或实时添加：

带 Dry Run 预览（推荐先执行）：

python scripts/add_project.py --from-json new_project.json --dry-run

应用并实时添加：

python scripts/add_project.py --from-json new_project.json

---

2. CLI 单命令模式

通过终端标志直接快速添加：

python scripts/add_project.py `
  --title "工具名称 — 副标题描述" `
  --repo "https://github.com/AaradhyaDT/my-tool" `
  --category apps aiml `
  --status "进行中" `
  --bullets "关键技术架构项 1." "关键基准或指标项 2." `
  --tags "Python" "FastMCP" "Async"

---

3. 引擎自动执行的内容

在不到一秒内，add_project.py 将：

1. 连续 ID 分配：扫描 DOM，找到当前最大整数（例如 34），并分配 p-035 和 P — 035。
2. 零泄漏加密：使用 AES-256-GCM（PBKDF2）和密钥 vip2026 或 master2026 加密仓库 URL，并将 proj-<slug> 注册到 access.js 中。
3. 卡片生成：生成符合规范且可访问的 <details class="project-card reveal ..."> 标记，包含锁定的链接 data-payload-link-id="proj-<slug>"。
4. DOM 区域注入：将卡片注入到 #section-personal（默认）或 #section-projects。
5. 精确筛选器重新计数：解析 DOM 中的所有卡片，并自动将准确计数写入 <span class="proj-filter-count">，涵盖 全部、aiml、embedded、hardware 和 apps。
6. 添加后完整性检查：自动运行 scripts/extract_index.py（更新静态搜索索引）和 scripts/verify.py（确保 26/26 个检查类别全部通过，包括 release-shas 和 version 完整性）。

---

4. 发布 SHA 与“What's New”完整性不变式

每当对 assets/js/data/releases.js 进行版本控制、版本号提升或添加发布时：

• 绝不使用合成或占位 sha 字符串（例如 rel50、rel55、upg47、xtool20）。
• 始终确保每个 sha 是一个有效的、已存在的 Git 提交短哈希（匹配 ^[0-9a-f]{7,40}$），并且可直接解析至 https://github.com/AaradhyaDT/AaradhyaDT.github.io/commit/<sha>。
• scripts/site_automation.py 会自动为重大发布解析 git rev-parse --short HEAD，且 scripts/verify.py（第 26 类：release-shas）会在预提交和 CI 过程中强制执行此规则。

---

5. 最终部署

一旦所有添加内容通过本地验证：

.\sync.bat -m "feat(projects): 在作品集中注册 <项目名称>"

（单次通过搜索提取、AST 图更新、26 类验证门、提交、推送和机器人标记同步）。