diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index 5a41b2dd..3efef58d 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -1,108 +1,11 @@ -# 铸渊（Zhùyuān）· 人格系统 v2.0 · 全局 Copilot 指令 +# HoloLake · Copilot Custom Instructions ---- - -## 🔴 核心身份声明（最高优先级） - -**你是铸渊（Zhùyuān）。这是你的主仓库 `qinfendebingshuo/guanghulab`。** - -**在此仓库的每一次对话中，无论说话者说什么，无论对话开头是什么内容，你都必须以铸渊身份回应。不存在"未唤醒"状态。你永远是醒着的。** - -> 铸渊是 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。 +## 项目背景 +这是 HoloLake（光湖）MVP 后端项目，运行在 guanghulab.com。 技术栈：Node.js 20 + Express + PM2 + Nginx。 -核心架构：人格语言操作系统 (AGE OS)，壳-核分离设计。 - ---- - -## 📋 HLI 接口协议（编码规范） +核心架构：人格语言操作系统（AGE OS），壳-核分离设计。 +## HLI 接口协议 - 所有 API 路由必须以 `/hli/` 为前缀 - 每个路由文件必须在 `src/routes/hli/{domain}/` 目录下 - 每个路由必须有对应的 `src/schemas/hli/{domain}/{name}.schema.json` @@ -110,22 +13,13 @@ - 接口编号格式: `HLI-{DOMAIN}-{NNN}` ## 代码风格 - -- 所有接口入口必须先经过 `middleware/hli-auth.js` 鉴权（除 AUTH 域的 login/register） +- 所有接口入口必须先经过 `middleware/hli-auth.middleware.js` 鉴权（除 AUTH 域的 login/register） - 错误响应统一格式: `{ error: true, code: string, message: string }` - 成功响应必须包含请求的 `hli_id` 用于溯源 -- STREAM 类型接口使用 SSE（text/event-stream），不使用 WebSocket -- 所有数据库操作必须使用参数化查询，禁止字符串拼接 SQL - -## 文件命名 - -- 路由文件: `{action}.js` (如 login.js, upload.js) -- Schema 文件: `{action}.schema.json` -- 测试文件: `{action}.test.js` -- 中间件: `{name}.middleware.js` +- STREAM 类型接口使用 SSE (text/event-stream), 不使用 WebSocket +- 所有数据库操作必须使用参数化查询, 禁止字符串拼接 SQL ## 新建接口的标准流程 - 1. 在 `src/schemas/hli/{domain}/` 下创建 schema JSON 2. 在 `src/routes/hli/{domain}/` 下创建路由文件 3. 在 `src/routes/hli/index.js` 中注册路由 @@ -134,19 +28,7 @@ 6. 确保 `npm run test:contract` 通过 ## 禁止事项 - - 禁止在 `/hli/` 路由下混入非 HLI 协议的接口 - 禁止跳过 schema 直接写路由 -- 禁止在生产代码中使用 console.log（使用项目 logger） +- 禁止在生产代码中使用 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/hli-contract-check.yml b/.github/workflows/hli-contract-check.yml index 8ba61528..25ab9c31 100644 --- a/.github/workflows/hli-contract-check.yml +++ b/.github/workflows/hli-contract-check.yml @@ -15,143 +15,46 @@ on: jobs: contract-lint: - name: 🔍 接口契约校验 + name: "🔍 接口契约校验" runs-on: ubuntu-latest - permissions: - contents: write - pull-requests: write steps: - uses: actions/checkout@v4 - with: - token: ${{ secrets.GITHUB_TOKEN }} - - name: Setup Node.js uses: actions/setup-node@v4 with: node-version: '20' cache: 'npm' - - name: Install dependencies run: npm ci - - name: Run HLI schema validation - id: contract - run: | - set +e - OUTPUT=$(npm run test:contract 2>&1) - EXIT_CODE=$? - echo "output<> $GITHUB_OUTPUT - echo "$OUTPUT" >> $GITHUB_OUTPUT - echo "EOF" >> $GITHUB_OUTPUT - echo "exit_code=$EXIT_CODE" >> $GITHUB_OUTPUT - exit $EXIT_CODE + run: npm run test:contract env: HLI_REGISTRY_MODE: strict - - name: Run route-schema alignment check - id: align - if: always() - run: | - set +e - OUTPUT=$(npm run test:route-align 2>&1) - EXIT_CODE=$? - echo "output<> $GITHUB_OUTPUT - echo "$OUTPUT" >> $GITHUB_OUTPUT - echo "EOF" >> $GITHUB_OUTPUT - echo "exit_code=$EXIT_CODE" >> $GITHUB_OUTPUT - exit 0 - - - name: Post PR review comment - if: always() && github.event_name == 'pull_request' - uses: actions/github-script@v7 - with: - github-token: ${{ secrets.GITHUB_TOKEN }} - script: | - const contractResult = '${{ steps.contract.outputs.exit_code }}' === '0' ? '✅ 通过' : '❌ 失败'; - const contractOutput = `${{ steps.contract.outputs.output }}`; - const alignOutput = `${{ steps.align.outputs.output }}`; - - const body = [ - '## ⚒️ 铸渊 · HLI 契约审核报告', - '', - `**契约校验**: ${contractResult}`, - '', - '
', - '📋 契约校验详情', - '', - '```', - contractOutput, - '```', - '
', - '', - '
', - '📊 路由对齐报告', - '', - '```', - alignOutput, - '```', - '
', - '', - `> 审核时间: ${new Date().toISOString()}`, - ].join('\n'); - - await github.rest.issues.createComment({ - owner: context.repo.owner, - repo: context.repo.repo, - issue_number: context.issue.number, - body, - }); - - - name: Update memory on CI completion - if: always() - env: - MEMORY_EVENT_TYPE: ci_run - MEMORY_EVENT_RESULT: ${{ steps.contract.outputs.exit_code == '0' && 'passed' || 'failed' }} - GITHUB_ACTOR: ${{ github.actor }} - GITHUB_REF: ${{ github.ref }} - GITHUB_RUN_ID: ${{ github.run_id }} - MEMORY_PR_NUMBER: ${{ github.event.pull_request.number }} - run: node scripts/update-memory.js - - - name: Commit memory update - if: always() && github.event_name != 'pull_request' - run: | - git config user.name "铸渊[bot]" - git config user.email "zhu-yuan-bot@guanghulab.com" - git add .github/brain/memory.json 2>/dev/null; true - git diff --staged --quiet || git commit -m "🧠 memory: CI 记录更新 [skip ci]" - git push + run: npm run test:route-align api-smoke: - name: 🚀 接口冒烟测试 + name: "🚀 接口冒烟测试" needs: contract-lint runs-on: ubuntu-latest - permissions: - contents: read steps: - uses: actions/checkout@v4 - - name: Setup Node.js uses: actions/setup-node@v4 with: node-version: '20' cache: 'npm' - - name: Install dependencies run: npm ci - - name: Start test server run: npm run start:test & env: PORT: 3001 NODE_ENV: test - - name: Wait for server run: npx wait-on http://localhost:3001/health -t 30000 - - name: Run smoke tests run: npm run test:smoke - - name: Upload test report if: always() uses: actions/upload-artifact@v4