humanasllm: Instructions file for Claude Code

P390 · Human as Agent（人即智能体）

项目定位

让工程师作为「人肉大模型」接入现有多模型 Agent 调度框架。对外完全兼容 OpenAI 标准接口（/v1/chat/completions），上游调度池新增一条 human-llm 模型路由即可接入，零代码改动。涉密/私有逻辑任务经此路由派发给人工工程师，完成后按大模型格式返回，AI 工作链路不中断。

技术栈

• 后端：Node.js + Express + Socket.IO
• 数据库：PostgreSQL 5433（库名 p390，用户 postgres）
• 认证：JWT（jsonwebtoken + bcryptjs）
• 前端：Vanilla HTML/JS/CSS（IIFE 模块 + SVG 图标 + 4 套主题）

目录结构

server.js              # 入口：Socket.IO 认证 + 安全头 + 路由 + 超时扫描
db/
  index.js             # PG 连接 + 建表（users/tasks/task_logs/request_logs）
  adapters/pg.js       # pg 适配器（?→$n、INSERT RETURNING id）
  dialect.js           # 方言工具
middleware/
  auth.js              # authenticate / signToken / requireRole
  security.js          # 基础安全头（无 CSP/HSTS）+ CORS + 限流
routes/
  v1.js                # OpenAI 兼容：/v1/models + /v1/chat/completions + /v1/tasks/:id 回查
  auth.js              # 登录/me/改密
  users.js             # 工程师账户管理
  tasks.js             # 任务列表/详情/状态流转
  workbench.js         # 统计/治理概览/我的任务/待接单/未完成聚合
  approvals.js         # 审批列表 + 批准/驳回
  projects.js          # 项目管理 + 申请建项目
  logs.js              # 请求出入日志 + 任务审计
  rules.js             # 分级规则管理（治理配置后台）
  tenants.js           # 租户管理（多租户）
  gateway.js           # 网关配置 + 多工具 SKILL/AGENT 生成/微调/安装
  audit.js             # 合规报告 + 质量数据资产导出
  annotations.js       # 产出标注 + 私有评测集（快照 / SFT·评测导出）
  sso.js               # 企业 SSO：providers / start（302 授权页）/ callback（换 JWT）
  prd.js               # PRD 需求沉淀（git 本地提交）
  index.js             # 路由总挂载
services/
  stateMachine.js      # 状态机单例（任务/审批转换表 + 校验）
  categoryEngine.js    # 分级策略引擎（规则白名单锁死 > 上游显式 > 默认）
  queueService.js      # 任务状态机流转 + AI 降级 + 质量校验 + 30s 超时扫描
  aiShift.js           # 智能漂移（general 简单任务 AI 承接，confidential/ops 锁死）
  approvalService.js   # 审批状态机 + 挂起等待 + 24h 超时提醒
  aiRelay.js           # DeepSeek 中继（一次 + SSE 透传）
  openaiEncoder.js     # OpenAI 请求解析 + 响应/SSE chunk 封装
  projectService.js    # 项目 CRUD + 审批批准回调
  notifier.js / mailer.js  # 通知（邮件 + Webhook），可降级
  callback.js          # 上游完成回调（终态主动推送，免轮询；可降级）
  taskView.js          # 上游任务视图（/v1 回查与完成回调共用字段）
  taskEvents.js        # 任务事件总线（供 /v1 SSE 中途推送订阅）
  sseStream.js         # /v1 SSE 中途状态推送（opt-in stream_events:true）
  toolCalls.js         # tools/function calling（声明校验 + tool_calls 归一化）
  permissionService.js # 三权分立权限矩阵（sys_admin/sec_admin/audit_admin/engineer）+ requirePermission
  annotationService.js # 答复标注 + 私有评测集不可变快照 + SFT/评测 JSONL
  ssoService.js        # OAuth2/OIDC 授权码：提供方解析 + state 一次性 + profile 映射
  waiters.js           # 等待者单例（审批挂起等待）
  i18n.js / csv.js     # 消息翻译 / CSV 导出
  websocket.js         # Socket.IO 推送（task:new/update/timeout）
public/                # 落地页(landing/) + 登录页 + SSO 中继页(sso.html) + 工作台(workbench.html + utils/api/ws/ui/app/i18n.js)
scripts/seed.js        # 种子账户