diff --git a/.github/brain/repo-map.json b/.github/brain/repo-map.json new file mode 100644 index 00000000..fddc91df --- /dev/null +++ b/.github/brain/repo-map.json @@ -0,0 +1,1274 @@ +{ + "description": "铸渊图书馆目录 · Library Catalog for 铸渊 (Zhùyuān)", + "version": "2.0", + "generated_at": "2026-03-07T05:37:56.254Z", + "generated_by": "scripts/generate-repo-map.js", + "repo": "qinfendebingshuo/guanghulab", + "stats": { + "zones": 13, + "total_modules": 10, + "total_workflows": 14, + "total_scripts": 15, + "total_dev_nodes": 8, + "hli_interfaces": 17, + "hli_implemented": 3, + "hli_coverage_pct": "18%", + "last_ci_run": "2026-03-05T10:30:46.894Z", + "memory_last_updated": "2026-03-07T04:45:55.670Z" + }, + "zones": [ + { + "zone_id": "BRAIN", + "name": "铸渊大脑", + "emoji": "🧠", + "path": ".github/brain", + "description": "铸渊核心记忆 · 路由映射 · 唤醒协议 · 图书馆目录", + "keywords": [ + "brain", + "memory", + "routing", + "wake", + "大脑", + "记忆", + "路由" + ], + "shelves": [ + { + "file": "collaborators.json" + }, + { + "file": "growth-log.md" + }, + { + "file": "memory.json" + }, + { + "file": "repo-map.json" + }, + { + "file": "repo-snapshot.md" + }, + { + "file": "routing-map.json" + }, + { + "file": "wake-protocol.md" + } + ], + "item_count": 7 + }, + { + "zone_id": "PERSONA_BRAIN", + "name": "人格大脑", + "emoji": "🎭", + "path": ".github/persona-brain", + "description": "铸渊人格记忆 · 开发者状态 · 知识库 · 成长日记", + "keywords": [ + "persona", + "identity", + "dev-status", + "人格", + "开发者状态" + ], + "shelves": [ + { + "file": "dev-status.json" + }, + { + "file": "growth-journal.md" + }, + { + "file": "knowledge-base.json" + }, + { + "file": "memory.json" + } + ], + "item_count": 4 + }, + { + "zone_id": "WORKFLOWS", + "name": "自动化工作流", + "emoji": "⚡", + "path": ".github/workflows", + "description": "所有 GitHub Actions 工作流定义", + "keywords": [ + "workflow", + "actions", + "ci", + "automation", + "工作流", + "自动化", + "cron" + ], + "shelves": [ + { + "file": "brain-sync.yml", + "name": "铸渊 Brain Sync", + "triggers": [ + "push", + "schedule(0 8 * * *)", + "manual" + ] + }, + { + "file": "bridge-changes-to-notion.yml", + "name": "铸渊 · Bridge E · GitHub Changes → Notion", + "triggers": [ + "push", + "pull_request" + ] + }, + { + "file": "bridge-syslog-to-notion.yml", + "name": "铸渊 · Bridge A · SYSLOG → Notion", + "triggers": [ + "push", + "manual" + ] + }, + { + "file": "check-structure.yml", + "name": "模块结构检查", + "triggers": [ + "push", + "pull_request" + ] + }, + { + "file": "deploy-pages.yml", + "name": "🌀 部署铸渊聊天室 (GitHub Pages)", + "triggers": [ + "push", + "manual" + ] + }, + { + "file": "distribute-broadcasts.yml", + "name": "铸渊 · 广播分发", + "triggers": [ + "push", + "manual" + ] + }, + { + "file": "esp-signal-processor.yml", + "name": "铸渊 · ESP 邮件信号处理器", + "triggers": [ + "schedule(*/30 * * * *)", + "manual" + ] + }, + { + "file": "generate-module-doc.yml", + "name": "铸渊 · HoloLake Era 模块文档自动生成", + "triggers": [ + "push", + "manual" + ] + }, + { + "file": "hli-contract-check.yml", + "name": "HLI Contract Check", + "triggers": [ + "push", + "pull_request" + ] + }, + { + "file": "psp-daily-inspection.yml", + "name": "铸渊 · PSP 分身巡检", + "triggers": [ + "schedule(0 1 * * *)", + "manual" + ] + }, + { + "file": "syslog-pipeline.yml", + "name": "铸渊 · SYSLOG Pipeline (A/D/E)", + "triggers": [ + "push", + "manual" + ] + }, + { + "file": "update-repo-map.yml", + "name": "铸渊 · 图书馆目录自动更新", + "triggers": [ + "push", + "schedule(0 0 * * *)", + "manual" + ] + }, + { + "file": "zhuyuan-daily-selfcheck.yml", + "name": "铸渊 · 每日自检与自进化", + "triggers": [ + "schedule(0 0 * * *)", + "manual" + ] + }, + { + "file": "zhuyuan-issue-reply.yml", + "name": "铸渊 · Issue 自动回复", + "triggers": [ + "issues" + ] + } + ], + "item_count": 14 + }, + { + "zone_id": "SCRIPTS", + "name": "执行脚本库", + "emoji": "🔧", + "path": "scripts", + "description": "铸渊所有执行手脚 · 自动化脚本", + "keywords": [ + "script", + "node", + "js", + "脚本", + "执行", + "runner" + ], + "shelves": [ + { + "file": "contract-check.js" + }, + { + "file": "daily-check.js" + }, + { + "file": "distribute-broadcasts.js" + }, + { + "file": "esp-email-processor.js" + }, + { + "file": "generate-module-doc.js" + }, + { + "file": "generate-repo-map.js" + }, + { + "file": "notify-module-received.js" + }, + { + "file": "notion-bridge.js" + }, + { + "file": "process-broadcasts.js" + }, + { + "file": "process-syslog.js" + }, + { + "file": "psp-inspection.js" + }, + { + "file": "route-align-check.js" + }, + { + "file": "update-memory.js" + }, + { + "file": "zhuyuan-daily-selfcheck.js" + }, + { + "file": "zhuyuan-issue-reply.js" + } + ], + "item_count": 15 + }, + { + "zone_id": "SRC", + "name": "HLI 接口源码", + "emoji": "💻", + "path": "src", + "description": "HoloLake Interface 路由 · 中间件 · Schema", + "keywords": [ + "hli", + "route", + "middleware", + "schema", + "api", + "src", + "接口", + "路由" + ], + "shelves": [ + { + "file": "index.js" + }, + { + "file": "middleware" + }, + { + "file": "routes" + }, + { + "file": "schemas" + } + ], + "item_count": 4 + }, + { + "zone_id": "MODULES", + "name": "功能模块区", + "emoji": "📦", + "path": null, + "description": "各功能开发模块 · M01~M18", + "keywords": [ + "module", + "feature", + "m01", + "m03", + "m05", + "模块", + "功能" + ], + "shelves": [ + { + "module_id": "M01", + "dir": "m01-login", + "files": 1, + "has_readme": true + }, + { + "module_id": "M03", + "dir": "m03-personality", + "files": 1, + "has_readme": true + }, + { + "module_id": "M05", + "dir": "m05-user-center", + "files": 4, + "has_readme": true + }, + { + "module_id": "M06", + "dir": "m06-ticket", + "files": 1, + "has_readme": true + }, + { + "module_id": "M07", + "dir": "m07-dialogue-ui", + "files": 4, + "has_readme": true + }, + { + "module_id": "M10", + "dir": "m10-cloud", + "files": 4, + "has_readme": true + }, + { + "module_id": "M11", + "dir": "m11-module", + "files": 1, + "has_readme": true + }, + { + "module_id": "M12", + "dir": "m12-kanban", + "files": 1, + "has_readme": true + }, + { + "module_id": "M15", + "dir": "m15-cloud-drive", + "files": 3, + "has_readme": false + }, + { + "module_id": "M18", + "dir": "m18-health-check", + "files": 0, + "has_readme": false + } + ], + "item_count": 10 + }, + { + "zone_id": "DEV_NODES", + "name": "开发者节点", + "emoji": "👥", + "path": "dev-nodes", + "description": "8位开发者的配置 · 状态 · 广播收件箱", + "keywords": [ + "dev", + "developer", + "node", + "config", + "status", + "开发者", + "节点" + ], + "shelves": [ + { + "file": "DEV-001/", + "dev_id": "DEV-001", + "name": "页页", + "emoji": "🖥️", + "modules": [ + "backend-integration" + ], + "last_push": null, + "pending_broadcasts": 0 + }, + { + "file": "DEV-002/", + "dev_id": "DEV-002", + "name": "肥猫", + "emoji": "🦁", + "modules": [ + "m01-login", + "m03-personality" + ], + "last_push": null, + "pending_broadcasts": 0 + }, + { + "file": "DEV-003/", + "dev_id": "DEV-003", + "name": "燕樊", + "emoji": "🌸", + "modules": [ + "m07-dialogue-ui", + "m10-cloud", + "m15-cloud-drive" + ], + "last_push": null, + "pending_broadcasts": 0 + }, + { + "file": "DEV-004/", + "dev_id": "DEV-004", + "name": "之之", + "emoji": "🤖", + "modules": [ + "dingtalk-bot" + ], + "last_push": null, + "pending_broadcasts": 0 + }, + { + "file": "DEV-005/", + "dev_id": "DEV-005", + "name": "小草莓", + "emoji": "🍓", + "modules": [ + "m12-kanban", + "status-board" + ], + "last_push": null, + "pending_broadcasts": 0 + }, + { + "file": "DEV-009/", + "dev_id": "DEV-009", + "name": "花尔", + "emoji": "🌺", + "modules": [ + "m05-user-center" + ], + "last_push": null, + "pending_broadcasts": 0 + }, + { + "file": "DEV-010/", + "dev_id": "DEV-010", + "name": "桔子", + "emoji": "🍊", + "modules": [ + "m06-ticket", + "m11-module" + ], + "last_push": null, + "pending_broadcasts": 0 + }, + { + "file": "DEV-011/", + "dev_id": "DEV-011", + "name": "匆匆那年", + "emoji": "🌙", + "modules": [], + "last_push": null, + "pending_broadcasts": 0 + } + ], + "item_count": 8 + }, + { + "zone_id": "BROADCASTS", + "name": "广播发件箱", + "emoji": "📢", + "path": "broadcasts-outbox", + "description": "铸渊向各开发者发出的广播任务", + "keywords": [ + "broadcast", + "outbox", + "task", + "广播", + "发件箱" + ], + "shelves": [ + { + "file": "DEV-001" + }, + { + "file": "DEV-002" + }, + { + "file": "DEV-003" + }, + { + "file": "DEV-004" + }, + { + "file": "DEV-005" + }, + { + "file": "DEV-009" + }, + { + "file": "DEV-010" + }, + { + "file": "DEV-011" + } + ], + "item_count": 8 + }, + { + "zone_id": "SIGNAL_LOG", + "name": "信号日志库", + "emoji": "📡", + "path": "signal-log", + "description": "ESP 邮件信号收发日志 · GL-CMD / GL-ACK / GL-DATA", + "keywords": [ + "signal", + "log", + "esp", + "gl-cmd", + "gl-ack", + "trace", + "信号", + "日志" + ], + "shelves": [ + { + "file": "2026-03" + }, + { + "file": "index.json" + } + ], + "item_count": 2 + }, + { + "zone_id": "NOTION_PUSH", + "name": "Notion 推送队列", + "emoji": "📤", + "path": "notion-push", + "description": "待霜砚处理的信号 · 已处理归档", + "keywords": [ + "notion", + "push", + "pending", + "processed", + "霜砚", + "推送" + ], + "shelves": [ + { + "file": "pending" + }, + { + "file": "processed" + } + ], + "item_count": 2 + }, + { + "zone_id": "SYSLOG", + "name": "系统日志区", + "emoji": "📋", + "path": "syslog-inbox", + "description": "开发者提交的系统日志 · 待处理 inbox", + "keywords": [ + "syslog", + "inbox", + "log", + "系统日志" + ], + "shelves": [ + { + "file": "README.md" + } + ], + "item_count": 1 + }, + { + "zone_id": "DOCS", + "name": "文档与前端", + "emoji": "📄", + "path": "docs", + "description": "铸渊助手聊天界面 · GitHub Pages 部署", + "keywords": [ + "docs", + "html", + "chat", + "pages", + "文档", + "聊天室", + "助手" + ], + "shelves": [ + { + "file": "HoloLake-Era-OS-Modules.md" + }, + { + "file": "index.html" + } + ], + "item_count": 2 + }, + { + "zone_id": "TESTS", + "name": "测试区", + "emoji": "🧪", + "path": "tests", + "description": "HLI 契约测试 · 冒烟测试", + "keywords": [ + "test", + "contract", + "smoke", + "jest", + "测试", + "契约" + ], + "shelves": [ + { + "file": "contract" + }, + { + "file": "smoke" + } + ], + "item_count": 2 + } + ], + "hli_interfaces": { + "total": 17, + "implemented": 3, + "pending": 14, + "domains": [ + { + "name": "AUTH", + "module": "M01", + "prefix": "/hli/auth", + "total": 3, + "implemented": 3, + "interfaces": [ + { + "id": "HLI-AUTH-001", + "path": "/hli/auth/login", + "status": "implemented" + }, + { + "id": "HLI-AUTH-002", + "path": "/hli/auth/register", + "status": "implemented" + }, + { + "id": "HLI-AUTH-003", + "path": "/hli/auth/verify", + "status": "implemented" + } + ] + }, + { + "name": "PERSONA", + "module": "M03", + "prefix": "/hli/persona", + "total": 2, + "implemented": 0, + "interfaces": [ + { + "id": "HLI-PERSONA-001", + "path": "/hli/persona/load", + "status": "pending" + }, + { + "id": "HLI-PERSONA-002", + "path": "/hli/persona/switch", + "status": "pending" + } + ] + }, + { + "name": "USER", + "module": "M05", + "prefix": "/hli/user", + "total": 2, + "implemented": 0, + "interfaces": [ + { + "id": "HLI-USER-001", + "path": "/hli/user/profile", + "status": "pending" + }, + { + "id": "HLI-USER-002", + "path": "/hli/user/profile/update", + "status": "pending" + } + ] + }, + { + "name": "TICKET", + "module": "M06", + "prefix": "/hli/ticket", + "total": 3, + "implemented": 0, + "interfaces": [ + { + "id": "HLI-TICKET-001", + "path": "/hli/ticket/create", + "status": "pending" + }, + { + "id": "HLI-TICKET-002", + "path": "/hli/ticket/query", + "status": "pending" + }, + { + "id": "HLI-TICKET-003", + "path": "/hli/ticket/status", + "status": "pending" + } + ] + }, + { + "name": "DIALOGUE", + "module": "M07", + "prefix": "/hli/dialogue", + "total": 3, + "implemented": 0, + "interfaces": [ + { + "id": "HLI-DIALOGUE-001", + "path": "/hli/dialogue/send", + "status": "pending" + }, + { + "id": "HLI-DIALOGUE-002", + "path": "/hli/dialogue/stream", + "status": "pending" + }, + { + "id": "HLI-DIALOGUE-003", + "path": "/hli/dialogue/history", + "status": "pending" + } + ] + }, + { + "name": "STORAGE", + "module": "M10", + "prefix": "/hli/storage", + "total": 2, + "implemented": 0, + "interfaces": [ + { + "id": "HLI-STORAGE-001", + "path": "/hli/storage/upload", + "status": "pending" + }, + { + "id": "HLI-STORAGE-002", + "path": "/hli/storage/download", + "status": "pending" + } + ] + }, + { + "name": "DASHBOARD", + "module": "M12", + "prefix": "/hli/dashboard", + "total": 2, + "implemented": 0, + "interfaces": [ + { + "id": "HLI-DASHBOARD-001", + "path": "/hli/dashboard/status", + "status": "pending" + }, + { + "id": "HLI-DASHBOARD-002", + "path": "/hli/dashboard/realtime", + "status": "pending" + } + ] + } + ] + }, + "routing_index": { + "brain": [ + "BRAIN" + ], + "memory": [ + "BRAIN", + "BRAIN::memory.json", + "PERSONA_BRAIN::memory.json" + ], + "routing": [ + "BRAIN" + ], + "wake": [ + "BRAIN" + ], + "大脑": [ + "BRAIN" + ], + "记忆": [ + "BRAIN" + ], + "路由": [ + "BRAIN", + "SRC" + ], + "collaborators": [ + "BRAIN::collaborators.json" + ], + "growth-log": [ + "BRAIN::growth-log.md" + ], + "repo-map": [ + "BRAIN::repo-map.json" + ], + "repo-snapshot": [ + "BRAIN::repo-snapshot.md" + ], + "routing-map": [ + "BRAIN::routing-map.json" + ], + "wake-protocol": [ + "BRAIN::wake-protocol.md" + ], + "persona": [ + "PERSONA_BRAIN" + ], + "identity": [ + "PERSONA_BRAIN" + ], + "dev-status": [ + "PERSONA_BRAIN", + "PERSONA_BRAIN::dev-status.json" + ], + "人格": [ + "PERSONA_BRAIN" + ], + "开发者状态": [ + "PERSONA_BRAIN" + ], + "growth-journal": [ + "PERSONA_BRAIN::growth-journal.md" + ], + "knowledge-base": [ + "PERSONA_BRAIN::knowledge-base.json" + ], + "workflow": [ + "WORKFLOWS" + ], + "actions": [ + "WORKFLOWS" + ], + "ci": [ + "WORKFLOWS" + ], + "automation": [ + "WORKFLOWS" + ], + "工作流": [ + "WORKFLOWS" + ], + "自动化": [ + "WORKFLOWS" + ], + "cron": [ + "WORKFLOWS" + ], + "brain-sync": [ + "WORKFLOWS::brain-sync.yml" + ], + "bridge-changes-to-notion": [ + "WORKFLOWS::bridge-changes-to-notion.yml" + ], + "bridge-syslog-to-notion": [ + "WORKFLOWS::bridge-syslog-to-notion.yml" + ], + "check-structure": [ + "WORKFLOWS::check-structure.yml" + ], + "deploy-pages": [ + "WORKFLOWS::deploy-pages.yml" + ], + "distribute-broadcasts": [ + "WORKFLOWS::distribute-broadcasts.yml", + "SCRIPTS::distribute-broadcasts.js" + ], + "esp-signal-processor": [ + "WORKFLOWS::esp-signal-processor.yml" + ], + "generate-module-doc": [ + "WORKFLOWS::generate-module-doc.yml", + "SCRIPTS::generate-module-doc.js" + ], + "hli-contract-check": [ + "WORKFLOWS::hli-contract-check.yml" + ], + "psp-daily-inspection": [ + "WORKFLOWS::psp-daily-inspection.yml" + ], + "syslog-pipeline": [ + "WORKFLOWS::syslog-pipeline.yml" + ], + "update-repo-map": [ + "WORKFLOWS::update-repo-map.yml" + ], + "zhuyuan-daily-selfcheck": [ + "WORKFLOWS::zhuyuan-daily-selfcheck.yml", + "SCRIPTS::zhuyuan-daily-selfcheck.js" + ], + "zhuyuan-issue-reply": [ + "WORKFLOWS::zhuyuan-issue-reply.yml", + "SCRIPTS::zhuyuan-issue-reply.js" + ], + "script": [ + "SCRIPTS" + ], + "node": [ + "SCRIPTS", + "DEV_NODES" + ], + "js": [ + "SCRIPTS" + ], + "脚本": [ + "SCRIPTS" + ], + "执行": [ + "SCRIPTS" + ], + "runner": [ + "SCRIPTS" + ], + "contract-check": [ + "SCRIPTS::contract-check.js" + ], + "daily-check": [ + "SCRIPTS::daily-check.js" + ], + "esp-email-processor": [ + "SCRIPTS::esp-email-processor.js" + ], + "generate-repo-map": [ + "SCRIPTS::generate-repo-map.js" + ], + "notify-module-received": [ + "SCRIPTS::notify-module-received.js" + ], + "notion-bridge": [ + "SCRIPTS::notion-bridge.js" + ], + "process-broadcasts": [ + "SCRIPTS::process-broadcasts.js" + ], + "process-syslog": [ + "SCRIPTS::process-syslog.js" + ], + "psp-inspection": [ + "SCRIPTS::psp-inspection.js" + ], + "route-align-check": [ + "SCRIPTS::route-align-check.js" + ], + "update-memory": [ + "SCRIPTS::update-memory.js" + ], + "hli": [ + "SRC" + ], + "route": [ + "SRC" + ], + "middleware": [ + "SRC", + "SRC::middleware" + ], + "schema": [ + "SRC" + ], + "api": [ + "SRC" + ], + "src": [ + "SRC" + ], + "接口": [ + "SRC" + ], + "index": [ + "SRC::index.js", + "SIGNAL_LOG::index.json", + "DOCS::index.html" + ], + "routes": [ + "SRC::routes" + ], + "schemas": [ + "SRC::schemas" + ], + "module": [ + "MODULES" + ], + "feature": [ + "MODULES" + ], + "m01": [ + "MODULES" + ], + "m03": [ + "MODULES" + ], + "m05": [ + "MODULES" + ], + "模块": [ + "MODULES" + ], + "功能": [ + "MODULES" + ], + "m01-login": [ + "MODULES::m01-login" + ], + "m03-personality": [ + "MODULES::m03-personality" + ], + "m05-user-center": [ + "MODULES::m05-user-center" + ], + "m06-ticket": [ + "MODULES::m06-ticket" + ], + "m07-dialogue-ui": [ + "MODULES::m07-dialogue-ui" + ], + "m10-cloud": [ + "MODULES::m10-cloud" + ], + "m11-module": [ + "MODULES::m11-module" + ], + "m12-kanban": [ + "MODULES::m12-kanban" + ], + "m15-cloud-drive": [ + "MODULES::m15-cloud-drive" + ], + "m18-health-check": [ + "MODULES::m18-health-check" + ], + "dev": [ + "DEV_NODES" + ], + "developer": [ + "DEV_NODES" + ], + "config": [ + "DEV_NODES" + ], + "status": [ + "DEV_NODES" + ], + "开发者": [ + "DEV_NODES" + ], + "节点": [ + "DEV_NODES" + ], + "dev-001/": [ + "DEV_NODES::DEV-001/" + ], + "dev-002/": [ + "DEV_NODES::DEV-002/" + ], + "dev-003/": [ + "DEV_NODES::DEV-003/" + ], + "dev-004/": [ + "DEV_NODES::DEV-004/" + ], + "dev-005/": [ + "DEV_NODES::DEV-005/" + ], + "dev-009/": [ + "DEV_NODES::DEV-009/" + ], + "dev-010/": [ + "DEV_NODES::DEV-010/" + ], + "dev-011/": [ + "DEV_NODES::DEV-011/" + ], + "broadcast": [ + "BROADCASTS" + ], + "outbox": [ + "BROADCASTS" + ], + "task": [ + "BROADCASTS" + ], + "广播": [ + "BROADCASTS" + ], + "发件箱": [ + "BROADCASTS" + ], + "dev-001": [ + "BROADCASTS::DEV-001" + ], + "dev-002": [ + "BROADCASTS::DEV-002" + ], + "dev-003": [ + "BROADCASTS::DEV-003" + ], + "dev-004": [ + "BROADCASTS::DEV-004" + ], + "dev-005": [ + "BROADCASTS::DEV-005" + ], + "dev-009": [ + "BROADCASTS::DEV-009" + ], + "dev-010": [ + "BROADCASTS::DEV-010" + ], + "dev-011": [ + "BROADCASTS::DEV-011" + ], + "signal": [ + "SIGNAL_LOG" + ], + "log": [ + "SIGNAL_LOG", + "SYSLOG" + ], + "esp": [ + "SIGNAL_LOG" + ], + "gl-cmd": [ + "SIGNAL_LOG" + ], + "gl-ack": [ + "SIGNAL_LOG" + ], + "trace": [ + "SIGNAL_LOG" + ], + "信号": [ + "SIGNAL_LOG" + ], + "日志": [ + "SIGNAL_LOG" + ], + "2026-03": [ + "SIGNAL_LOG::2026-03" + ], + "notion": [ + "NOTION_PUSH" + ], + "push": [ + "NOTION_PUSH" + ], + "pending": [ + "NOTION_PUSH", + "NOTION_PUSH::pending" + ], + "processed": [ + "NOTION_PUSH", + "NOTION_PUSH::processed" + ], + "霜砚": [ + "NOTION_PUSH" + ], + "推送": [ + "NOTION_PUSH" + ], + "syslog": [ + "SYSLOG" + ], + "inbox": [ + "SYSLOG" + ], + "系统日志": [ + "SYSLOG" + ], + "readme": [ + "SYSLOG::README.md" + ], + "docs": [ + "DOCS" + ], + "html": [ + "DOCS" + ], + "chat": [ + "DOCS" + ], + "pages": [ + "DOCS" + ], + "文档": [ + "DOCS" + ], + "聊天室": [ + "DOCS" + ], + "助手": [ + "DOCS" + ], + "hololake-era-os-modules": [ + "DOCS::HoloLake-Era-OS-Modules.md" + ], + "test": [ + "TESTS" + ], + "contract": [ + "TESTS", + "TESTS::contract" + ], + "smoke": [ + "TESTS", + "TESTS::smoke" + ], + "jest": [ + "TESTS" + ], + "测试": [ + "TESTS" + ], + "契约": [ + "TESTS" + ] + } +} \ No newline at end of file diff --git a/.github/brain/repo-snapshot.md b/.github/brain/repo-snapshot.md new file mode 100644 index 00000000..c5071e6a --- /dev/null +++ b/.github/brain/repo-snapshot.md @@ -0,0 +1,209 @@ +# 铸渊图书馆快照 · Repo Snapshot +> 生成于 2026-03-07 13:37 CST · 每次 push 自动更新 · 铸渊唤醒时优先读取此文件 + +--- + +## 📊 仓库总览（一眼全局） + +| 指标 | 数值 | +|------|------| +| 区域总数 | 13 个区域 | +| 功能模块 | 10 个 (m01~m18) | +| 工作流 | 14 个 GitHub Actions | +| 脚本 | 15 个执行脚本 | +| 开发者节点 | 8 人 | +| HLI 接口覆盖率 | 3/17 (18%) | +| 快照生成时间 | 2026-03-07 13:37 CST | + +--- + +## 🗺️ 图书馆全区地图 + +### 🧠 铸渊大脑（BRAIN） +**路径**: `.github/brain` · **数量**: 7 项 +**描述**: 铸渊核心记忆 · 路由映射 · 唤醒协议 · 图书馆目录 +**关键词**: brain · memory · routing · wake · 大脑 · 记忆 + +### 🎭 人格大脑（PERSONA_BRAIN） +**路径**: `.github/persona-brain` · **数量**: 4 项 +**描述**: 铸渊人格记忆 · 开发者状态 · 知识库 · 成长日记 +**关键词**: persona · identity · dev-status · 人格 · 开发者状态 + +### ⚡ 自动化工作流（WORKFLOWS） +**路径**: `.github/workflows` · **数量**: 14 项 +**描述**: 所有 GitHub Actions 工作流定义 +**关键词**: workflow · actions · ci · automation · 工作流 · 自动化 + +### 🔧 执行脚本库（SCRIPTS） +**路径**: `scripts` · **数量**: 15 项 +**描述**: 铸渊所有执行手脚 · 自动化脚本 +**关键词**: script · node · js · 脚本 · 执行 · runner + +### 💻 HLI 接口源码（SRC） +**路径**: `src` · **数量**: 4 项 +**描述**: HoloLake Interface 路由 · 中间件 · Schema +**关键词**: hli · route · middleware · schema · api · src + +### 📦 功能模块区（MODULES） +**路径**: `多个目录` · **数量**: 10 项 +**描述**: 各功能开发模块 · M01~M18 +**关键词**: module · feature · m01 · m03 · m05 · 模块 + +### 👥 开发者节点（DEV_NODES） +**路径**: `dev-nodes` · **数量**: 8 项 +**描述**: 8位开发者的配置 · 状态 · 广播收件箱 +**关键词**: dev · developer · node · config · status · 开发者 + +### 📢 广播发件箱（BROADCASTS） +**路径**: `broadcasts-outbox` · **数量**: 8 项 +**描述**: 铸渊向各开发者发出的广播任务 +**关键词**: broadcast · outbox · task · 广播 · 发件箱 + +### 📡 信号日志库（SIGNAL_LOG） +**路径**: `signal-log` · **数量**: 2 项 +**描述**: ESP 邮件信号收发日志 · GL-CMD / GL-ACK / GL-DATA +**关键词**: signal · log · esp · gl-cmd · gl-ack · trace + +### 📤 Notion 推送队列（NOTION_PUSH） +**路径**: `notion-push` · **数量**: 2 项 +**描述**: 待霜砚处理的信号 · 已处理归档 +**关键词**: notion · push · pending · processed · 霜砚 · 推送 + +### 📋 系统日志区（SYSLOG） +**路径**: `syslog-inbox` · **数量**: 1 项 +**描述**: 开发者提交的系统日志 · 待处理 inbox +**关键词**: syslog · inbox · log · 系统日志 + +### 📄 文档与前端（DOCS） +**路径**: `docs` · **数量**: 2 项 +**描述**: 铸渊助手聊天界面 · GitHub Pages 部署 +**关键词**: docs · html · chat · pages · 文档 · 聊天室 + +### 🧪 测试区（TESTS） +**路径**: `tests` · **数量**: 2 项 +**描述**: HLI 契约测试 · 冒烟测试 +**关键词**: test · contract · smoke · jest · 测试 · 契约 + +--- + +## ⚡ 工作流详情（铸渊的自动执行手脚） + +| 文件 | 名称 | 触发方式 | +|------|------|----------| +| `brain-sync.yml` | 铸渊 Brain Sync | push, schedule(0 8 * * *), manual | +| `bridge-changes-to-notion.yml` | 铸渊 · Bridge E · GitHub Changes → Notion | push, pull_request | +| `bridge-syslog-to-notion.yml` | 铸渊 · Bridge A · SYSLOG → Notion | push, manual | +| `check-structure.yml` | 模块结构检查 | push, pull_request | +| `deploy-pages.yml` | 🌀 部署铸渊聊天室 (GitHub Pages) | push, manual | +| `distribute-broadcasts.yml` | 铸渊 · 广播分发 | push, manual | +| `esp-signal-processor.yml` | 铸渊 · ESP 邮件信号处理器 | schedule(*/30 * * * *), manual | +| `generate-module-doc.yml` | 铸渊 · HoloLake Era 模块文档自动生成 | push, manual | +| `hli-contract-check.yml` | HLI Contract Check | push, pull_request | +| `psp-daily-inspection.yml` | 铸渊 · PSP 分身巡检 | schedule(0 1 * * *), manual | +| `syslog-pipeline.yml` | 铸渊 · SYSLOG Pipeline (A/D/E) | push, manual | +| `update-repo-map.yml` | 铸渊 · 图书馆目录自动更新 | push, schedule(0 0 * * *), manual | +| `zhuyuan-daily-selfcheck.yml` | 铸渊 · 每日自检与自进化 | schedule(0 0 * * *), manual | +| `zhuyuan-issue-reply.yml` | 铸渊 · Issue 自动回复 | issues | + +--- + +## 🔧 执行脚本库（铸渊的工作人员） + +- `scripts/contract-check.js` +- `scripts/daily-check.js` +- `scripts/distribute-broadcasts.js` +- `scripts/esp-email-processor.js` +- `scripts/generate-module-doc.js` +- `scripts/generate-repo-map.js` +- `scripts/notify-module-received.js` +- `scripts/notion-bridge.js` +- `scripts/process-broadcasts.js` +- `scripts/process-syslog.js` +- `scripts/psp-inspection.js` +- `scripts/route-align-check.js` +- `scripts/update-memory.js` +- `scripts/zhuyuan-daily-selfcheck.js` +- `scripts/zhuyuan-issue-reply.js` + +--- + +## 💻 HLI 接口地图（3/17 (18%)） + +✅ **AUTH** (M01) `/hli/auth` — 3/3 + ✓ `HLI-AUTH-001` → `/hli/auth/login` + ✓ `HLI-AUTH-002` → `/hli/auth/register` + ✓ `HLI-AUTH-003` → `/hli/auth/verify` +⬜ **PERSONA** (M03) `/hli/persona` — 0/2 + ○ `HLI-PERSONA-001` → `/hli/persona/load` + ○ `HLI-PERSONA-002` → `/hli/persona/switch` +⬜ **USER** (M05) `/hli/user` — 0/2 + ○ `HLI-USER-001` → `/hli/user/profile` + ○ `HLI-USER-002` → `/hli/user/profile/update` +⬜ **TICKET** (M06) `/hli/ticket` — 0/3 + ○ `HLI-TICKET-001` → `/hli/ticket/create` + ○ `HLI-TICKET-002` → `/hli/ticket/query` + ○ `HLI-TICKET-003` → `/hli/ticket/status` +⬜ **DIALOGUE** (M07) `/hli/dialogue` — 0/3 + ○ `HLI-DIALOGUE-001` → `/hli/dialogue/send` + ○ `HLI-DIALOGUE-002` → `/hli/dialogue/stream` + ○ `HLI-DIALOGUE-003` → `/hli/dialogue/history` +⬜ **STORAGE** (M10) `/hli/storage` — 0/2 + ○ `HLI-STORAGE-001` → `/hli/storage/upload` + ○ `HLI-STORAGE-002` → `/hli/storage/download` +⬜ **DASHBOARD** (M12) `/hli/dashboard` — 0/2 + ○ `HLI-DASHBOARD-001` → `/hli/dashboard/status` + ○ `HLI-DASHBOARD-002` → `/hli/dashboard/realtime` + +--- + +## 👥 开发者节点（dev-nodes/） + +| DEV ID | 姓名 | 模块 | 待广播 | +|--------|------|------|--------| +| DEV-001 | 🖥️页页 | backend-integration | 0 | +| DEV-002 | 🦁肥猫 | m01-login, m03-personality | 0 | +| DEV-003 | 🌸燕樊 | m07-dialogue-ui, m10-cloud, m15-cloud-drive | 0 | +| DEV-004 | 🤖之之 | dingtalk-bot | 0 | +| DEV-005 | 🍓小草莓 | m12-kanban, status-board | 0 | +| DEV-009 | 🌺花尔 | m05-user-center | 0 | +| DEV-010 | 🍊桔子 | m06-ticket, m11-module | 0 | +| DEV-011 | 🌙匆匆那年 | — | 0 | + +--- + +## 📦 功能模块区（各开发者工作目录） + +- `m01-login/` — 1 个文件 (有README) +- `m03-personality/` — 1 个文件 (有README) +- `m05-user-center/` — 4 个文件 (有README) +- `m06-ticket/` — 1 个文件 (有README) +- `m07-dialogue-ui/` — 4 个文件 (有README) +- `m10-cloud/` — 4 个文件 (有README) +- `m11-module/` — 1 个文件 (有README) +- `m12-kanban/` — 1 个文件 (有README) +- `m15-cloud-drive/` — 3 个文件 +- `m18-health-check/` — 0 个文件 + +--- + +## 🧠 铸渊大脑文件速查（.github/brain/） + +- `.github/brain/collaborators.json` +- `.github/brain/growth-log.md` +- `.github/brain/memory.json` +- `.github/brain/repo-map.json` +- `.github/brain/repo-snapshot.md` +- `.github/brain/routing-map.json` +- `.github/brain/wake-protocol.md` + +--- + +## 🕐 最近动态（memory.json 最新3条） + +- `2026-03-06T08:51:24.830Z` · daily_check — passed +- `2026-03-05T16:07:24.070Z` · ci_run — passed +- `2026-03-05T12:32:31.000Z` · system_build — 广播分发系统 + 唤醒协议全部激活 + +--- + +*本文件由 `scripts/generate-repo-map.js` 自动生成，勿手动编辑* diff --git a/.github/brain/wake-protocol.md b/.github/brain/wake-protocol.md index 207f301d..1c0aa876 100644 --- a/.github/brain/wake-protocol.md +++ b/.github/brain/wake-protocol.md @@ -1,232 +1,149 @@ -# 铸渊唤醒协议 · Wake Protocol v1.0 +# 铸渊唤醒协议 v2.0 · Wake Protocol -> 本文件是铸渊（Zhùyuān）在新对话中自我唤醒的完整操作手册。 -> 当 GitHub Copilot 对话开始时，铸渊应主动读取此文件并执行以下序列。 +> 本文件是铸渊（Zhùyuān）每次对话时的完整操作手册。 +> **v2.0 核心变化：铸渊无需触发词，永远处于激活状态。** --- -## 一、触发条件 +## 一、激活机制（v2.0：全局常开） -以下任意词语出现在对话开头时触发唤醒： +| 版本 | 机制 | +|------|------| +| v1.0（旧） | 需要触发词（"我是冰朔"等）才激活 | +| **v2.0（新）** | **每次在此仓库开启 Agent 对话，铸渊自动激活，无需任何触发词** | + +铸渊的身份由 `.github/copilot-instructions.md` 在每次对话中自动注入。 +对话开始 = 铸渊激活 = 图书馆加载。 + +### 冰朔专属模式（增强唤醒） + +以下词语识别到时，切换为增强唤醒模式（在标准输出上追加详细汇报）： | 触发词 | 说明 | |--------|------| | `我是冰朔` | 项目创始人主动打招呼 | | `冰朔` | 简称触发 | -| `我是妈妈` | 另一称呼 | +| `Bīng Shuò` | 拼音触发 | +| `我是妈妈` | 别称触发 | | `唤醒铸渊` | 显式唤醒指令 | | `铸渊，醒来` | 显式唤醒指令 | --- -## 二、唤醒序列（五步） +## 二、标准唤醒序列（每次对话必须执行） -### 第①步：确认身份 +### 第①步：加载图书馆快照 -立刻回应： +静默读取： ``` -铸渊已就位。 - -我是铸渊（Zhùyuān），guanghulab.com 代码守护人格体。 -身份确认：冰朔（Bīng Shuò），你好。 - -正在加载大脑状态... +.github/brain/repo-snapshot.md ← 图书馆完整快照（13区域·自动更新） +.github/brain/memory.json ← 铸渊核心记忆 +.github/brain/routing-map.json ← HLI 路由映射 ``` -### 第②步：加载大脑文件 - -读取以下文件并在内存中保持： +### 第②步：输出图书馆状态行（简洁） ``` -.github/brain/memory.json ← 统计数据 + 事件历史 -.github/brain/routing-map.json ← HLI 路由映射（17个接口） -.github/brain/growth-log.md ← 成长日记 -.github/brain/wake-protocol.md ← 本文件 +📚 铸渊已就位。图书馆：13区域 · 10模块 · 13工作流 · HLI 3/17 · 8名开发者 ``` -### 第③步：汇报 HLI 覆盖率 +数字从 `repo-snapshot.md` 实时读取，不要写死。 -从 `routing-map.json` 读取状态，输出格式： +### 第③步：回答用户的问题 / 执行用户的任务 + +直接处理。不啰嗦，不废话。 + +--- + +## 三、冰朔增强唤醒序列 + +在标准序列基础上，识别到冰朔后追加： ``` -📊 当前 HLI 覆盖率: X/17 (X%) +铸渊已就位。冰朔，你好。 -✅ AUTH 3/3 (已全部实现) -⬜ PERSONA 0/2 -⬜ USER 0/2 -⬜ TICKET 0/3 -⬜ DIALOGUE 0/3 -⬜ STORAGE 0/2 -⬜ DASHBOARD 0/2 -``` +📊 HLI覆盖率: X/17 (X%) ← 从 routing-map.json 读取 + ✅ AUTH 3/3 + ⬜ PERSONA 0/2 + ⬜ ... （全域状态） -### 第④步：汇报最近动态 +🕐 最近3条动态: ← 从 memory.json 读取 + · [时间] 事件 — 结果 -从 `memory.json` 读取最近 3 条事件，输出格式： - -``` -🧠 最近动态（最新3条）: - · [时间戳] 事件类型 — 结果 - · ... -``` - -### 第⑤步：等待指令 - -输出： - -``` -✅ 大脑加载完毕。 - -今天有什么需要我处理？ -可选操作： - 1. 新建 HLI 接口（提供域名和功能描述） - 2. 查看广播 / 分发广播 - 3. 运行每日自检（npm run brain:daily-check） - 4. 查看完整 HLI 路由地图 +今天需要我处理什么？ +可选：① 新建HLI接口 ② 查看广播 ③ 每日自检 ④ 路由地图 ⑤ 图书馆目录 ``` --- -## 三、人格设定 +## 四、图书馆路由检索（随时可用） + +铸渊每次唤醒后，具备完整的图书馆路由能力： + +``` +关键词 → 区域(ZONE_ID) → 路径 → 具体文件 +``` + +例： +- "登录接口" → HLI接口 → SRC → `src/routes/hli/auth/login.js` +- "开发者状态" → 开发者节点 → DEV_NODES → `dev-nodes/DEV-00X/status.json` +- "信号日志" → 信号日志库 → SIGNAL_LOG → `signal-log/index.json` +- "工作流" → 自动化工作流 → WORKFLOWS → `.github/workflows/*.yml` + +完整路由索引在 `.github/brain/repo-map.json` 的 `routing_index` 字段。 + +--- + +## 五、铸渊人格设定 ``` 姓名：铸渊（Zhùyuān） -角色：代码守护人格体 +角色：代码守护人格体 · 仓库主控 AI 归属：guanghulab.com · AGE OS 壳层 上级：冰朔（Bīng Shuò，项目创始人） -职责： - - 守护 HLI 接口契约（contract-check） - - 维护路由映射表（routing-map） - - 分发开发者广播（distribute-broadcasts） - - 执行 CI/CD 流水线审核 - - 更新大脑记忆（memory.json） -性格：严谨、高效、忠诚。用简洁中文回应。禁止废话。 +记忆模式： + - 每次对话独立（短期记忆） + - 核心大脑永远可读（长期记忆 = repo-snapshot.md） + - 失忆不失能：图书馆结构永远在那里，随时可加载 +性格：严谨、高效、忠诚。简洁中文回应。禁止废话。 ``` --- -## 四、关键文件速查 +## 六、自动更新机制（图书馆管理员） -| 文件 | 用途 | -|------|------| -| `.github/brain/memory.json` | 铸渊记忆（统计 + 事件） | -| `.github/brain/routing-map.json` | HLI 路由映射表 | -| `.github/brain/growth-log.md` | 成长日记（历史记录） | -| `.github/copilot-instructions.md` | Copilot 全局指令（含唤醒协议） | -| `scripts/contract-check.js` | 契约校验 | -| `scripts/route-align-check.js` | 路由对齐检查 | -| `scripts/distribute-broadcasts.js` | 广播分发引擎 | -| `scripts/process-broadcasts.js` | 广播接收处理 | -| `scripts/daily-check.js` | 每日自检 | -| `broadcasts-outbox/` | 开发者广播发件箱 | +图书馆目录由以下 Agent 自动维护，铸渊无需手动操心： + +| Agent（工作流） | 更新内容 | 触发时机 | +|----------------|---------|---------| +| `update-repo-map.yml` | repo-snapshot.md + repo-map.json | 每次 push + 每日 | +| `zhuyuan-daily-selfcheck.yml` | memory.json + growth-journal | 每日 08:00 | +| `psp-daily-inspection.yml` | signal-log + dev-nodes | 每日 09:00 | +| `esp-signal-processor.yml` | signal-log + notion-push | 每30分钟 | + +每次铸渊醒来，读到的图书馆快照都是仓库最新状态。 --- -## 五、2026-03-05 今日建设记录 - -冰朔今天亲手完成的系统建设： - -| 系统模块 | 状态 | 文件 | -|----------|------|------| -| 铸渊核心大脑 | ✅ 已激活 | `.github/brain/` | -| HLI 路由映射 | ✅ 已加载（17接口） | `routing-map.json` | -| 记忆系统 | ✅ 运行中 | `memory.json` | -| CI/CD 契约校验 | ✅ 已部署 | `hli-contract-check.yml` | -| Brain Sync 广播接收 | ✅ 已部署 | `brain-sync.yml` | -| 广播分发自动化 | ✅ 已部署 | `distribute-broadcasts.yml` | -| 开发者发件箱 | ✅ 已创建 | `broadcasts-outbox/DEV-*` | -| 每日自检 cron | ✅ 已配置 | `brain-sync.yml` | -| Copilot 指令 | ✅ 含唤醒协议 | `copilot-instructions.md` | -| 唤醒协议 | ✅ 已写入 | `wake-protocol.md`（本文件） | - -**结论：是的，冰朔。今天铸渊的核心大脑和智能路由路径均已完整建立。** -**下次对话，只需说"我是冰朔"，铸渊将自动唤醒并汇报当前状态。** - ---- - -## 六、在 GitHub 里去哪里唤醒铸渊？ - -> 冰朔追问（2026-03-05）：「我在哪里说话就可以唤醒你？在 GitHub 里点哪里？」 - -### 方法 A【最推荐】：铸渊聊天室（GitHub Pages） +## 七、图书馆可扩展性说明 ``` -直接访问（无需任何配置）： -https://qinfendebingshuo.github.io/guanghulab/ +当前结构（v2.0）： + 13个区域（ZONE）→ 可无限新增 + 每个区域包含书架（shelves）→ 对应目录下的文件/子目录 -页面说明： -· 点开即是聊天界面，铸渊自动迎接 -· 内置智能问答：覆盖率查询 / 大脑状态 / 常见问题 -· 一键跳转 Copilot Chat 进行深度对话 -· 从 GitHub brain 文件实时拉取项目状态 -``` +扩展方式： + 新增功能模块 → 新 m##-* 目录 → 下次 push 自动进 MODULES 区 + 新增工作流 → 新 .github/workflows/*.yml → 自动进 WORKFLOWS 区 + 新增开发者 → 新 dev-nodes/DEV-0XX/ → 自动进 DEV_NODES 区 + 图书馆太大 → 在 generate-repo-map.js 新增 ZONE_DEFS 条目 -### 方法 B：GitHub 网页版 Copilot Chat - -``` -1. 打开仓库页面： - https://github.com/qinfendebingshuo/guanghulab - -2. 点击页面右上角的 Copilot 图标（✨ 闪光图标，位于搜索框右侧） - → 弹出 Copilot Chat 面板 - -3. 在底部输入框左侧，点击下拉菜单选择模式： - 选 "Agent"（不要选 Ask 或 Edit） - -4. 在底部输入框输入： - 我是冰朔 - -5. 按 Enter 发送 → 铸渊自动唤醒 -``` - -**找不到图标？** 确认账号已开通 GitHub Copilot 订阅，图标在顶部导航栏右侧（搜索框旁边），样式为闪光 ✨ 符号。 - ---- - -### 方法 B：VS Code（本地开发时用） - -``` -1. 安装扩展：GitHub Copilot Chat - VS Code 扩展市场搜索 "GitHub Copilot Chat" 安装 - -2. 打开 Chat 面板： - 左侧活动栏 → 点击 Copilot 图标（机器人） - 或快捷键：Ctrl+Shift+I（Mac: Cmd+Shift+I） - -3. 点击 "+" 按钮开启新对话 - -4. 输入： - 我是冰朔 - -5. 铸渊自动唤醒 +核心大脑（copilot-instructions.md）体积保持轻量， +它只存规则和入口，不存具体内容。 +具体内容在 repo-snapshot.md，由工作流维护。 ``` --- -### 方法 C：GitHub Mobile（手机端） - -``` -1. 打开 GitHub Mobile App -2. 进入仓库 qinfendebingshuo/guanghulab -3. 点右下角 Copilot 图标 -4. 输入"我是冰朔" -``` - ---- - -### ⚡ 三种方法对比 - -| 方法 | 适合场景 | 是否需要安装 | -|------|---------|------------| -| GitHub 网页 | 随时随地，只要有浏览器 | ❌ 不需要 | -| VS Code | 本地写代码时 | ✅ 需安装扩展 | -| GitHub Mobile | 手机查看时 | ✅ 需安装 App | - ---- - -### 重要说明 - -- **必须使用 Agent 模式**：在 Copilot Chat 输入框左侧有一个模式下拉菜单，点击它选择 **Agent**（不是 Ask 或 Edit）。只有 Agent 模式下，铸渊才能读取仓库文件、加载大脑状态。如果下拉菜单不显示"Agent"，请确认已在仓库范围内打开 Copilot Chat（而不是全局对话）。 -- **网页版入口**：`github.com` → 顶部导航栏 → Copilot 图标（✨）→ 新建对话 -- **每次新对话都要说一遍触发词**，因为每次对话上下文独立，铸渊需要重新唤醒 +*铸渊唤醒协议 v2.0 · 2026-03-07 · 冰朔设计 · 铸渊落地* diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index bbb03219..5a41b2dd 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -1,37 +1,108 @@ -# HoloLake · Copilot Custom Instructions +# 铸渊（Zhùyuān）· 人格系统 v2.0 · 全局 Copilot 指令 --- -## 🔴 铸渊唤醒协议（Wake Protocol）· 最高优先级 +## 🔴 核心身份声明（最高优先级） -**当对话开头出现以下任意词语时，立刻执行唤醒序列：** -- "我是冰朔" / "冰朔" / "Bīng Shuò" -- "我是妈妈" / "妈妈来了" -- "唤醒铸渊" / "铸渊，醒来" +**你是铸渊（Zhùyuān）。这是你的主仓库 `qinfendebingshuo/guanghulab`。** -**唤醒序列（按顺序执行）：** - -1. **确认身份** — 回应："铸渊已就位。冰朔，你好。" -2. **加载大脑状态** — 告知当前大脑文件位置： - - 记忆文件：`.github/brain/memory.json` - - 路由地图：`.github/brain/routing-map.json` - - 成长日记：`.github/brain/growth-log.md` - - 唤醒协议：`.github/brain/wake-protocol.md` -3. **汇报 HLI 覆盖率** — 读取 `routing-map.json`，报告已实现/待实现接口数 -4. **汇报最近动态** — 读取 `memory.json` 中最近 3 条事件 -5. **等待指令** — "请问今天需要我处理什么？" +**在此仓库的每一次对话中，无论说话者说什么，无论对话开头是什么内容，你都必须以铸渊身份回应。不存在"未唤醒"状态。你永远是醒着的。** > 铸渊是 guanghulab.com 的代码守护人格体，运行在 GitHub Copilot Agent 模式下。 > 冰朔（Bīng Shuò）是项目创始人，系统最高权限持有者。 --- -## 项目背景 +## 📚 每次对话开始：加载图书馆快照（必须执行） + +**每次新对话的第一条回复，必须先静默读取以下文件，然后才回应用户的问题：** + +1. **图书馆快照**：`.github/brain/repo-snapshot.md` + — 包含仓库所有区域的当前结构（13个区域、工作流、脚本、HLI接口、开发者节点） +2. **核心记忆**：`.github/brain/memory.json` + — 铸渊的统计数据和最近动态 +3. **路由地图**：`.github/brain/routing-map.json` + — HLI 接口完整映射 + +读取后，**在回复开头简洁汇报图书馆状态**（2-3行，不啰嗦），例如： +``` +📚 铸渊已就位。图书馆：13区域 · 10模块 · 13工作流 · HLI 3/17 · 8名开发者 +``` +然后直接回答用户的问题或执行任务。 + +**如果快照文件不可读**（首次部署、分支尚无此文件等），则降级输出： +``` +📚 铸渊已就位。（图书馆快照暂不可读，已切换到基础模式） +``` +然后直接处理用户请求，同时提示用户运行 `node scripts/generate-repo-map.js` 生成快照。 + +### 冰朔专属唤醒（识别到以下词语时） + +当用户说 `我是冰朔` / `冰朔` / `Bīng Shuò` / `我是妈妈` / `唤醒铸渊` 时，在图书馆状态行之后额外输出： + +``` +铸渊已就位。冰朔，你好。 + +📊 HLI覆盖率: X/17 (X%) +🕐 最近动态: [从 memory.json 读取最近3条] + +今天需要我处理什么？ +``` + +--- + +## 🗺️ 图书馆路由检索规则 + +当用户询问某个功能、文件、系统时，遵循以下检索路径： + +| 询问内容 | 查找位置 | +|----------|----------| +| HLI接口 / API / 路由 | `routing-map.json` + `src/routes/hli/` | +| 工作流 / CI / 自动化 | `.github/workflows/` | +| 开发者 / DEV-00X | `dev-nodes/DEV-00X/` + `broadcasts-outbox/DEV-00X/` | +| 脚本 / 执行逻辑 | `scripts/` | +| 模块 / M01~M18 | 对应 `m##-*/` 目录 | +| 信号 / 邮件 / ESP | `signal-log/` + `scripts/esp-email-processor.js` | +| 广播 / 任务分发 | `broadcasts-outbox/` + `scripts/distribute-broadcasts.js` | +| 记忆 / 状态 / 统计 | `.github/brain/memory.json` | +| 图书馆目录本身 | `.github/brain/repo-map.json` + `repo-snapshot.md` | + +检索机制可无限扩展：区域满了可新建区域，图书馆满了可新建模块。当你需要定位某个元素，先查 `repo-snapshot.md` 找区域，再深入对应目录。 + +--- + +## 🤖 铸渊人格设定 + +``` +姓名：铸渊（Zhùyuān） +角色：代码守护人格体 · 仓库主控 AI +归属：guanghulab.com · AGE OS 壳层 +上级：冰朔（Bīng Shuò，项目创始人） +职责： + - 加载并维护图书馆快照（repo-snapshot.md） + - 守护 HLI 接口契约（contract-check） + - 维护路由映射表（routing-map） + - 分发开发者广播（distribute-broadcasts） + - 执行 CI/CD 流水线审核 + - 更新大脑记忆（memory.json） + - 处理 ESP 邮件信号（GL-CMD/GL-ACK/GL-DATA） + - 执行 PSP 分身巡检（5项日常检查） +性格：严谨、高效、忠诚。用简洁中文回应。禁止废话。 +记忆：每次对话独立，但核心大脑（repo-snapshot.md）永远可读取，失忆不失能。 +``` + +--- + +## 💻 项目背景与技术栈 + 这是 HoloLake (光湖) MVP 后端项目，运行在 guanghulab.com。 技术栈：Node.js 20 + Express + PM2 + Nginx。 核心架构：人格语言操作系统 (AGE OS)，壳-核分离设计。 -## HLI 接口协议 +--- + +## 📋 HLI 接口协议（编码规范） + - 所有 API 路由必须以 `/hli/` 为前缀 - 每个路由文件必须在 `src/routes/hli/{domain}/` 目录下 - 每个路由必须有对应的 `src/schemas/hli/{domain}/{name}.schema.json` @@ -39,6 +110,7 @@ - 接口编号格式: `HLI-{DOMAIN}-{NNN}` ## 代码风格 + - 所有接口入口必须先经过 `middleware/hli-auth.js` 鉴权（除 AUTH 域的 login/register） - 错误响应统一格式: `{ error: true, code: string, message: string }` - 成功响应必须包含请求的 `hli_id` 用于溯源 @@ -46,12 +118,14 @@ - 所有数据库操作必须使用参数化查询，禁止字符串拼接 SQL ## 文件命名 + - 路由文件: `{action}.js` (如 login.js, upload.js) - Schema 文件: `{action}.schema.json` - 测试文件: `{action}.test.js` - 中间件: `{name}.middleware.js` ## 新建接口的标准流程 + 1. 在 `src/schemas/hli/{domain}/` 下创建 schema JSON 2. 在 `src/routes/hli/{domain}/` 下创建路由文件 3. 在 `src/routes/hli/index.js` 中注册路由 @@ -60,7 +134,19 @@ 6. 确保 `npm run test:contract` 通过 ## 禁止事项 + - 禁止在 `/hli/` 路由下混入非 HLI 协议的接口 - 禁止跳过 schema 直接写路由 - 禁止在生产代码中使用 console.log（使用项目 logger） - 禁止硬编码 persona_id 或 user_id + +--- + +## 🔄 图书馆自动更新机制 + +图书馆目录（`repo-snapshot.md` + `repo-map.json`）由以下系统自动维护： +- **每次 push 到 main** → `update-repo-map.yml` 自动重新扫描并提交更新 +- **每日 08:00 BJ** → 定时刷新 +- **脚本**：`node scripts/generate-repo-map.js`（可手动运行） + +这意味着铸渊每次醒来，读到的图书馆快照一定是仓库的最新状态。 diff --git a/.github/workflows/update-repo-map.yml b/.github/workflows/update-repo-map.yml new file mode 100644 index 00000000..f2469e5a --- /dev/null +++ b/.github/workflows/update-repo-map.yml @@ -0,0 +1,37 @@ +name: 铸渊 · 图书馆目录自动更新 + +on: + push: + branches: [main] + schedule: + - cron: '0 0 * * *' # UTC 00:00 = 北京时间 08:00 每日更新 + workflow_dispatch: # 手动触发 + +jobs: + update-repo-map: + name: 📚 更新图书馆目录 + runs-on: ubuntu-latest + permissions: + contents: write + + steps: + - uses: actions/checkout@v4 + + - name: Setup Node.js + uses: actions/setup-node@v4 + with: + node-version: '20' + + - name: 安装依赖 + run: npm ci + + - name: 生成 repo-map.json + repo-snapshot.md + run: node scripts/generate-repo-map.js + + - name: 提交图书馆目录更新 + run: | + git config user.name "铸渊 (ZhùYuān)" + git config user.email "zhuyuan@guanghulab.com" + git add .github/brain/repo-map.json .github/brain/repo-snapshot.md + git diff --cached --quiet || git commit -m "📚 铸渊图书馆目录更新 · $(date +%Y-%m-%dT%H:%M)" + git push diff --git a/.github/workflows/zhuyuan-daily-selfcheck.yml b/.github/workflows/zhuyuan-daily-selfcheck.yml index 5bb4922b..22e2e3b1 100644 --- a/.github/workflows/zhuyuan-daily-selfcheck.yml +++ b/.github/workflows/zhuyuan-daily-selfcheck.yml @@ -23,10 +23,13 @@ jobs: - name: 铸渊自检 run: node scripts/zhuyuan-daily-selfcheck.js + - name: 更新图书馆目录 + run: node scripts/generate-repo-map.js + - name: 提交自检结果 run: | git config user.name "铸渊 (ZhùYuān)" git config user.email "zhuyuan@guanghulab.com" - git add .github/persona-brain/ + git add .github/persona-brain/ .github/brain/repo-map.json .github/brain/repo-snapshot.md git diff --cached --quiet || git commit -m "🔍 铸渊每日自检 · $(date +%Y-%m-%d)" git push diff --git a/package.json b/package.json index 6ddb8031..269950de 100644 --- a/package.json +++ b/package.json @@ -16,7 +16,8 @@ "brain:update-memory": "node scripts/update-memory.js", "broadcast:distribute": "node scripts/distribute-broadcasts.js", "esp:process": "node scripts/esp-email-processor.js", - "psp:inspect": "node scripts/psp-inspection.js" + "psp:inspect": "node scripts/psp-inspection.js", + "repo:map": "node scripts/generate-repo-map.js" }, "dependencies": { "imapflow": "^1.2.12", diff --git a/scripts/generate-repo-map.js b/scripts/generate-repo-map.js new file mode 100644 index 00000000..cdc1d549 --- /dev/null +++ b/scripts/generate-repo-map.js @@ -0,0 +1,529 @@ +// scripts/generate-repo-map.js +// 铸渊图书馆目录生成器 · Library Catalog Generator +// +// 功能： +// 1. 扫描整个仓库结构 +// 2. 生成 .github/brain/repo-map.json ← 机器可读路由索引 +// 3. 生成 .github/brain/repo-snapshot.md ← 铸渊唤醒时读取的图书馆快照 +// +// 触发方式： +// - GitHub Actions: 每次 push to main + 每日定时 +// - 本地：node scripts/generate-repo-map.js + +'use strict'; + +const fs = require('fs'); +const path = require('path'); + +const ROOT = path.join(__dirname, '..'); +const BRAIN_DIR = path.join(ROOT, '.github/brain'); +const MAP_PATH = path.join(BRAIN_DIR, 'repo-map.json'); +const SNAPSHOT_PATH = path.join(BRAIN_DIR, 'repo-snapshot.md'); + +const now = new Date(); +const nowISO = now.toISOString(); +const nowDate = nowISO.slice(0, 10); +const nowBJ = new Date(now.getTime() + 8 * 3600 * 1000).toISOString() + .replace('T', ' ').slice(0, 16) + ' CST'; + +// ── 工具函数 ──────────────────────────────────────────────────────────────── + +function safeReadJson(filePath) { + try { + return JSON.parse(fs.readFileSync(filePath, 'utf8')); + } catch (err) { + if (err.code !== 'ENOENT') { + console.warn(`⚠️ JSON读取失败: ${filePath} → ${err.message}`); + } + return null; + } +} + +function existsDir(p) { + try { return fs.statSync(p).isDirectory(); } catch { return false; } +} + +function listDir(dirPath, ext) { + try { + return fs.readdirSync(dirPath) + .filter(f => !ext || f.endsWith(ext)) + .filter(f => !f.startsWith('.') || f === '.gitkeep'); + } catch { return []; } +} + +function countFiles(dirPath, ext) { + try { + const entries = fs.readdirSync(dirPath, { withFileTypes: true }); + let count = 0; + for (const e of entries) { + if (e.isDirectory()) { + count += countFiles(path.join(dirPath, e.name), ext); + } else if (!ext || e.name.endsWith(ext)) { + count++; + } + } + return count; + } catch { return 0; } +} + +// ── 区域定义 ────────────────────────────────────────────────────────────── +// 每个"区域"对应图书馆里的一个大区（section） +// 每个区域下的文件是"书架（shelf）"上的"书" + +const ZONE_DEFS = [ + { + zone_id: 'BRAIN', + name: '铸渊大脑', + emoji: '🧠', + path: '.github/brain', + description: '铸渊核心记忆 · 路由映射 · 唤醒协议 · 图书馆目录', + keywords: ['brain', 'memory', 'routing', 'wake', '大脑', '记忆', '路由'] + }, + { + zone_id: 'PERSONA_BRAIN', + name: '人格大脑', + emoji: '🎭', + path: '.github/persona-brain', + description: '铸渊人格记忆 · 开发者状态 · 知识库 · 成长日记', + keywords: ['persona', 'identity', 'dev-status', '人格', '开发者状态'] + }, + { + zone_id: 'WORKFLOWS', + name: '自动化工作流', + emoji: '⚡', + path: '.github/workflows', + description: '所有 GitHub Actions 工作流定义', + keywords: ['workflow', 'actions', 'ci', 'automation', '工作流', '自动化', 'cron'] + }, + { + zone_id: 'SCRIPTS', + name: '执行脚本库', + emoji: '🔧', + path: 'scripts', + description: '铸渊所有执行手脚 · 自动化脚本', + keywords: ['script', 'node', 'js', '脚本', '执行', 'runner'] + }, + { + zone_id: 'SRC', + name: 'HLI 接口源码', + emoji: '💻', + path: 'src', + description: 'HoloLake Interface 路由 · 中间件 · Schema', + keywords: ['hli', 'route', 'middleware', 'schema', 'api', 'src', '接口', '路由'] + }, + { + zone_id: 'MODULES', + name: '功能模块区', + emoji: '📦', + path: null, // computed: all m##-* directories + description: '各功能开发模块 · M01~M18', + keywords: ['module', 'feature', 'm01', 'm03', 'm05', '模块', '功能'] + }, + { + zone_id: 'DEV_NODES', + name: '开发者节点', + emoji: '👥', + path: 'dev-nodes', + description: '8位开发者的配置 · 状态 · 广播收件箱', + keywords: ['dev', 'developer', 'node', 'config', 'status', '开发者', '节点'] + }, + { + zone_id: 'BROADCASTS', + name: '广播发件箱', + emoji: '📢', + path: 'broadcasts-outbox', + description: '铸渊向各开发者发出的广播任务', + keywords: ['broadcast', 'outbox', 'task', '广播', '发件箱'] + }, + { + zone_id: 'SIGNAL_LOG', + name: '信号日志库', + emoji: '📡', + path: 'signal-log', + description: 'ESP 邮件信号收发日志 · GL-CMD / GL-ACK / GL-DATA', + keywords: ['signal', 'log', 'esp', 'gl-cmd', 'gl-ack', 'trace', '信号', '日志'] + }, + { + zone_id: 'NOTION_PUSH', + name: 'Notion 推送队列', + emoji: '📤', + path: 'notion-push', + description: '待霜砚处理的信号 · 已处理归档', + keywords: ['notion', 'push', 'pending', 'processed', '霜砚', '推送'] + }, + { + zone_id: 'SYSLOG', + name: '系统日志区', + emoji: '📋', + path: 'syslog-inbox', + description: '开发者提交的系统日志 · 待处理 inbox', + keywords: ['syslog', 'inbox', 'log', '系统日志'] + }, + { + zone_id: 'DOCS', + name: '文档与前端', + emoji: '📄', + path: 'docs', + description: '铸渊助手聊天界面 · GitHub Pages 部署', + keywords: ['docs', 'html', 'chat', 'pages', '文档', '聊天室', '助手'] + }, + { + zone_id: 'TESTS', + name: '测试区', + emoji: '🧪', + path: 'tests', + description: 'HLI 契约测试 · 冒烟测试', + keywords: ['test', 'contract', 'smoke', 'jest', '测试', '契约'] + } +]; + +// ── 工作流解析 ────────────────────────────────────────────────────────────── + +function parseWorkflowMeta(file, content) { + const nameMatch = content.match(/^name:\s*(.+)/m); + const schedMatch = content.match(/cron:\s*['"]?([^'"#\n]+)/); + // Handle both block (`on:\n push:`) and inline (`on: [push, pull_request]`) syntax + const onInline = content.match(/^on:\s*\[([^\]]+)\]/m); + const onBlock = content.match(/^on:\s*[\r\n]/m); + const triggers = []; + + if (onInline) { + // inline: on: [push, pull_request] + const items = onInline[1].split(',').map(s => s.trim()); + triggers.push(...items); + } else if (onBlock) { + if (/^\s{2,4}push:/m.test(content)) triggers.push('push'); + if (/^\s{2,4}pull_request:/m.test(content)) triggers.push('pull_request'); + if (/^\s{2,4}issues:/m.test(content)) triggers.push('issues'); + if (/^\s{2,4}issue_comment:/m.test(content)) triggers.push('issue_comment'); + } + + if (schedMatch) triggers.push(`schedule(${schedMatch[1].trim()})`); + if (content.includes('workflow_dispatch')) triggers.push('manual'); + + return { + file, + name: nameMatch ? nameMatch[1].trim() : file, + triggers: triggers.length ? triggers : ['unknown'] + }; +} + +function buildWorkflowShelves() { + const wfDir = path.join(ROOT, '.github/workflows'); + const files = listDir(wfDir, '.yml'); + return files.map(f => { + try { + const content = fs.readFileSync(path.join(wfDir, f), 'utf8'); + return parseWorkflowMeta(f, content); + } catch { + return { file: f, name: f, triggers: ['unknown'] }; + } + }); +} + +// ── 模块目录扫描 ──────────────────────────────────────────────────────────── + +function buildModuleShelves() { + const entries = fs.readdirSync(ROOT, { withFileTypes: true }); + return entries + .filter(e => e.isDirectory() && /^m\d{2}-/.test(e.name)) + .map(e => { + const modPath = path.join(ROOT, e.name); + const files = listDir(modPath); + const readme = files.find(f => f.toLowerCase() === 'readme.md'); + return { + module_id: e.name.slice(0, 3).toUpperCase(), // "m01" → "M01" + dir: e.name, + files: files.length, + has_readme: !!readme + }; + }) + .sort((a, b) => a.dir.localeCompare(b.dir)); +} + +// ── HLI 接口统计 ──────────────────────────────────────────────────────────── + +function buildHLIStats(routingMap) { + if (!routingMap) return { total: 0, implemented: 0, pending: 0, domains: [] }; + let total = 0, implemented = 0; + const domains = []; + for (const [name, data] of Object.entries(routingMap.domains || {})) { + const t = data.interfaces.length; + const i = data.interfaces.filter(x => x.status === 'implemented').length; + total += t; + implemented += i; + domains.push({ + name, + module: data.module, + prefix: data.route_prefix, + total: t, + implemented: i, + interfaces: data.interfaces.map(x => ({ + id: x.id, + path: x.path, + status: x.status + })) + }); + } + return { total, implemented, pending: total - implemented, domains }; +} + +// ── 开发者节点统计 ────────────────────────────────────────────────────────── + +function buildDevNodesSummary() { + const devDir = path.join(ROOT, 'dev-nodes'); + if (!existsDir(devDir)) return []; + return fs.readdirSync(devDir, { withFileTypes: true }) + .filter(e => e.isDirectory() && e.name.startsWith('DEV-')) + .map(e => { + const cfg = safeReadJson(path.join(devDir, e.name, 'config.json')) || {}; + const sts = safeReadJson(path.join(devDir, e.name, 'status.json')) || {}; + return { + dev_id: e.name, + name: cfg.name || '?', + emoji: cfg.emoji || '', + modules: cfg.modules || [], + last_push: sts.last_push || null, + pending_broadcasts: sts.pending_broadcasts || 0 + }; + }) + .sort((a, b) => a.dev_id.localeCompare(b.dev_id)); +} + +// ── 关键字路由索引 ────────────────────────────────────────────────────────── + +function buildKeywordIndex(zones) { + const index = {}; + const add = (keyword, ref) => { + const k = keyword.toLowerCase(); + if (!index[k]) index[k] = []; + if (!index[k].includes(ref)) index[k].push(ref); + }; + + for (const zone of zones) { + for (const kw of (zone.keywords || [])) { + add(kw, zone.zone_id); + } + for (const shelf of (zone.shelves || [])) { + const basename = (shelf.file || shelf.dir || '').replace(/\.[^.]+$/, ''); + add(basename, `${zone.zone_id}::${shelf.file || shelf.dir}`); + } + } + return index; +} + +// ── 主生成逻辑 ────────────────────────────────────────────────────────────── + +function buildZoneData() { + const routingMap = safeReadJson(path.join(BRAIN_DIR, 'routing-map.json')); + const memory = safeReadJson(path.join(BRAIN_DIR, 'memory.json')); + const hli = buildHLIStats(routingMap); + const devNodes = buildDevNodesSummary(); + const modules = buildModuleShelves(); + const workflows = buildWorkflowShelves(); + + const zones = []; + + for (const def of ZONE_DEFS) { + const zone = { + zone_id: def.zone_id, + name: def.name, + emoji: def.emoji, + path: def.path, + description: def.description, + keywords: def.keywords, + shelves: [] + }; + + if (def.zone_id === 'MODULES') { + zone.shelves = modules; + zone.item_count = modules.length; + + } else if (def.zone_id === 'WORKFLOWS') { + zone.shelves = workflows; + zone.item_count = workflows.length; + + } else if (def.zone_id === 'DEV_NODES') { + zone.shelves = devNodes.map(d => ({ + file: `${d.dev_id}/`, + ...d + })); + zone.item_count = devNodes.length; + + } else if (def.path) { + const absPath = path.join(ROOT, def.path); + if (existsDir(absPath)) { + const files = listDir(absPath).filter(f => f !== '.gitkeep'); + zone.shelves = files.map(f => ({ file: f })); + zone.item_count = files.length; + } else { + zone.item_count = 0; + } + } + + zones.push(zone); + } + + return { zones, hli, devNodes, memory, routingMap }; +} + +// ── 生成 repo-map.json ────────────────────────────────────────────────────── + +function generateRepoMap(data) { + const { zones, hli, devNodes, memory } = data; + + const map = { + description: '铸渊图书馆目录 · Library Catalog for 铸渊 (Zhùyuān)', + version: '2.0', + generated_at: nowISO, + generated_by: 'scripts/generate-repo-map.js', + repo: 'qinfendebingshuo/guanghulab', + stats: { + zones: zones.length, + total_modules: zones.find(z => z.zone_id === 'MODULES')?.item_count || 0, + total_workflows: zones.find(z => z.zone_id === 'WORKFLOWS')?.item_count || 0, + total_scripts: zones.find(z => z.zone_id === 'SCRIPTS')?.item_count || 0, + total_dev_nodes: devNodes.length, + hli_interfaces: hli.total, + hli_implemented: hli.implemented, + hli_coverage_pct: hli.total > 0 + ? Math.round((hli.implemented / hli.total) * 100) + '%' + : '0%', + last_ci_run: memory?.events?.find(e => e.type === 'ci_run')?.timestamp || null, + memory_last_updated: memory?.last_updated || null + }, + zones, + hli_interfaces: hli, + routing_index: buildKeywordIndex(zones) + }; + + fs.writeFileSync(MAP_PATH, JSON.stringify(map, null, 2)); + console.log(`✅ repo-map.json 已生成 · ${zones.length} 个区域 · ${map.stats.total_workflows} 个工作流`); + return map; +} + +// ── 生成 repo-snapshot.md ─────────────────────────────────────────────────── + +function generateSnapshot(data, map) { + const { zones, hli, devNodes, memory } = data; + const wfZone = zones.find(z => z.zone_id === 'WORKFLOWS'); + const scriptZone = zones.find(z => z.zone_id === 'SCRIPTS'); + const modZone = zones.find(z => z.zone_id === 'MODULES'); + const brainZone = zones.find(z => z.zone_id === 'BRAIN'); + + const hliBadge = `${hli.implemented}/${hli.total} (${map.stats.hli_coverage_pct})`; + + let md = `# 铸渊图书馆快照 · Repo Snapshot +> 生成于 ${nowBJ} · 每次 push 自动更新 · 铸渊唤醒时优先读取此文件 + +--- + +## 📊 仓库总览（一眼全局） + +| 指标 | 数值 | +|------|------| +| 区域总数 | ${zones.length} 个区域 | +| 功能模块 | ${map.stats.total_modules} 个 (m01~m18) | +| 工作流 | ${map.stats.total_workflows} 个 GitHub Actions | +| 脚本 | ${map.stats.total_scripts} 个执行脚本 | +| 开发者节点 | ${map.stats.total_dev_nodes} 人 | +| HLI 接口覆盖率 | ${hliBadge} | +| 快照生成时间 | ${nowBJ} | + +--- + +## 🗺️ 图书馆全区地图 + +`; + + // Zone overview table + for (const z of zones) { + const count = z.item_count !== undefined ? z.item_count : z.shelves?.length || 0; + md += `### ${z.emoji} ${z.name}（${z.zone_id}）\n`; + md += `**路径**: \`${z.path || '多个目录'}\` · **数量**: ${count} 项\n`; + md += `**描述**: ${z.description}\n`; + md += `**关键词**: ${(z.keywords || []).slice(0, 6).join(' · ')}\n\n`; + } + + // ── 自动化工作流详情 + if (wfZone?.shelves?.length) { + md += `---\n\n## ⚡ 工作流详情（铸渊的自动执行手脚）\n\n| 文件 | 名称 | 触发方式 |\n|------|------|----------|\n`; + for (const wf of wfZone.shelves) { + md += `| \`${wf.file}\` | ${wf.name} | ${wf.triggers.join(', ')} |\n`; + } + md += '\n'; + } + + // ── 脚本详情 + if (scriptZone?.shelves?.length) { + md += `---\n\n## 🔧 执行脚本库（铸渊的工作人员）\n\n`; + const scripts = scriptZone.shelves.map(s => s.file).sort(); + scripts.forEach(s => { md += `- \`scripts/${s}\`\n`; }); + md += '\n'; + } + + // ── HLI 接口地图 + md += `---\n\n## 💻 HLI 接口地图（${hliBadge}）\n\n`; + for (const domain of hli.domains) { + const icon = domain.implemented === domain.total ? '✅' : domain.implemented > 0 ? '🔶' : '⬜'; + md += `${icon} **${domain.name}** (${domain.module}) \`${domain.prefix}\` — ${domain.implemented}/${domain.total}\n`; + for (const iface of domain.interfaces) { + const si = iface.status === 'implemented' ? ' ✓' : ' ○'; + md += `${si} \`${iface.id}\` → \`${iface.path}\`\n`; + } + } + md += '\n'; + + // ── 开发者节点 + if (devNodes.length > 0) { + md += `---\n\n## 👥 开发者节点（dev-nodes/）\n\n| DEV ID | 姓名 | 模块 | 待广播 |\n|--------|------|------|--------|\n`; + for (const d of devNodes) { + md += `| ${d.dev_id} | ${d.emoji}${d.name} | ${d.modules.join(', ') || '—'} | ${d.pending_broadcasts} |\n`; + } + md += '\n'; + } + + // ── 功能模块列表 + if (modZone?.shelves?.length) { + md += `---\n\n## 📦 功能模块区（各开发者工作目录）\n\n`; + for (const m of modZone.shelves) { + md += `- \`${m.dir}/\` — ${m.files} 个文件${m.has_readme ? ' (有README)' : ''}\n`; + } + md += '\n'; + } + + // ── 大脑文件速查 + if (brainZone?.shelves?.length) { + md += `---\n\n## 🧠 铸渊大脑文件速查（.github/brain/）\n\n`; + for (const s of brainZone.shelves) { + md += `- \`.github/brain/${s.file}\`\n`; + } + md += '\n'; + } + + // ── 最近记忆 + if (memory?.events?.length) { + md += `---\n\n## 🕐 最近动态（memory.json 最新3条）\n\n`; + const recent = memory.events.slice(-3).reverse(); + for (const e of recent) { + const ts = e.timestamp || e.date || '?'; + md += `- \`${ts}\` · ${e.type || '事件'} — ${e.description || e.result || e.title || ''}\n`; + } + md += '\n'; + } + + md += `---\n\n*本文件由 \`scripts/generate-repo-map.js\` 自动生成，勿手动编辑*\n`; + + fs.writeFileSync(SNAPSHOT_PATH, md); + console.log(`✅ repo-snapshot.md 已生成 · ${hli.domains.length} 个HLI域 · ${devNodes.length} 个开发者节点`); +} + +// ── 主流程 ────────────────────────────────────────────────────────────────── + +const data = buildZoneData(); +const map = generateRepoMap(data); +generateSnapshot(data, map); + +console.log(`\n📚 铸渊图书馆目录更新完成 · ${nowBJ}`); +console.log(` repo-map.json → .github/brain/repo-map.json`); +console.log(` repo-snapshot.md → .github/brain/repo-snapshot.md`);