nec-hub — NEC 团队 AI 中台

单体 Cloudflare Worker：门户 + 飞书 OAuth 登录 + API + MCP 端点 + 应用托管（R2）+ 注册表（KV）+ 报销 ERP 快照（D1）。

生产门户：https://hub.newenergycoder.club
MCP 端点（Agent 接入）：https://hub.newenergycoder.club/mcp（streamable HTTP / JSON-RPC；协议元数据公开，业务读工具按工具要求验证 user_token，写操作需 Authorization: Bearer <MCP_TOKEN>）；token 生成 npm run mcp:token + wrangler secret put MCP_TOKEN，桌面 IDE 一键接入 npm run mcp:setup，详见 docs/IDE接入指南.md
源码：GitHub necc-hub/nec-hub · Gitee 镜像 darrenpig/nec-hub

线上内容（截至 2026-10-16）

门户共 15 个 Tab：我的首页 / 我的任务 / 图纸评审 / 报销 / 任务排期 / 赛季目标 / 应用广场 / Skill 中心 / 资料页 / 开源仓库 / 硬件评审 / 合同审批 / 数据看板 / PRD 看板 / NEC-MCP（Skill 中心 / 资料页 / 开源仓库 / 硬件评审 / 合同审批 5 个低频 Tab 收进「更多」；图纸/硬件/合同评审登录后可见）。

应用广场 15 个应用（实时列表见 GET /api/apps）：

应用	说明	链接
擎天塔重建 // NEON PROTOCOL	战队年度项目门户	https://tower.newenergycoder.club
NEC 仓库作业台	MES 仓储系统（电控组，飞书免登）	https://mes.newenergycoder.club
KV Assets	主视觉资产库（KV 画廊 + 飞书宣传栏 + PNG 物料）	/apps/kv-assets/
常州工NEC · 新人招募海报	招募静态页	/apps/recruit-poster/
nec-hub-portal / reimburse / drawing / domains	R2 自托管应用（门户镜像 / 报销助手 / 图纸评审 / 域名分发）	见 `/api/apps`
solarglyph26.07 / newenergycoder-club / gexo-website / public-beta-calculator / r2-web / fluid-workstation-ui / fibersteelstudio	Vercel 项目，`sync_vercel` 自动登记	见 `/api/apps`

Skill 中心 21 个（实时列表见 GET /api/skills）：

中台自托管 4 个：nec-tech-report（技术方案报告）· nec-kv-design（主视觉设计系统）· nec-vi（VI 规范）· nec-ppt（PPT 模板）
Gitee 同步 17 个：仅 NEC 原创（白名单 scripts/nec-skills-allowlist.txt，第三方/镜像一律不导入），源仓库 darrenpig/new_energy_coder_club SKill 分支，经 scripts/sync-gitee-skills.py 登记（source: "gitee"，门户显示 ⤤ 外链）

代码结构

src/index.ts 为纯路由表（~250 行），Cron 调度独立为 src/scheduled.ts（时间窗驱动 + guard 去重），secrets 的 Env 声明在 src/env.d.ts；跨域钩子（如 ERP 状态回写）在路由层注入，依赖保持 erp → approvals 单向。业务按域拆分，公共层沉淀在 src/shared/（session、http、feishu-table-adapter、module-config、module-gateway、meeting.service）；门户前端为独立 Vue 3 + Vite 工程（web/，构建产物输出到 public/portal-assets/，hash 路由深链）：

src/
├── index.ts            # 纯路由表 + 跨域钩子注入（组合根）
├── scheduled.ts        # Cron 调度（时间窗驱动 + guard 去重）
├── env.d.ts            # secrets 的全局 Env 声明
├── auth/               # 飞书 OAuth、会话、角色解析
├── home/               # FE-06/07 个人首页布局（个人 > 组 > 默认三级覆盖）
├── todos.ts            # FE-09 审批/待办聚合
├── my-tasks/           # 我的任务（飞书 Task v2 绑定授权 + 同步拉取，KV 缓存）
├── season-goals/       # 赛季目标管理（收集单提交/采纳 + 按任务自动规划）
├── validation/         # FE-05 数据校验（声明式规则 + 每周一群机器人摘要推送）
├── reports/            # 团队周报（每周一 cron 自动推群，队长可手动补发）
├── dashboard.ts        # 数据看板聚合（KV 缓存）
├── repos.ts            # GitHub + Gitee 开源仓库合并（KV 1 小时缓存）
├── reimburse.ts        # 报销提交（发票号 + OCR）+ 审批动作 + 我的报销列表
├── erp/                # R-01 报销助手 ERP 化（D1 单据快照/费用目录/收款账户 + R2 附件）
├── prd.ts              # PRD 看板（/api/prd + update_prd）+ GitHub push webhook
├── approvals/          # Plan B 审批引擎：flows 配置 / 状态机 / REST / MCP 工具 / SLA 时效巡检
├── domains/            # 域名分发系统（自助申请三级域名 + Cloudflare API 落 DNS）+ 泛域名应用直达
├── cla/                # 开源社区贡献协议（CLA）签署与公开名单
├── hosting.ts          # /apps/ /skills/ 静态托管（R2 + Cache API 边缘缓存）
├── drawing-review/     # 图纸评审：薄壳路由（单据走审批引擎）+ board/bom/inquiry/suggestion(联想)/alert 子表服务
├── hardware-review/    # 硬件评审：薄壳路由（单据走审批引擎）+ 纪要/整改/报告子表
├── contract-approval/  # 合同审批：薄壳路由（单据走审批引擎，HT 单号 + 会签）+ 评论/事件子表
├── meeting/            # 飞书日历 + 视频会议创建（评审拉会共用）
├── feishu/             # 飞书多维表格客户端（token 实例缓存 + in-flight 去重）+ 群机器人 webhook（加签/重试/留痕）
├── mcp/                # MCP 端点：handler / tools / implementations / module-config-tools
└── __tests__/          # vitest 测试（各域另有就近 __tests__）

性能：飞书 token 实例内存缓存 + in-flight 去重；R2 托管应用/SKILL.md 接 Cache API 边缘缓存，部署/上架时按 URL 主动失效；看板/仓库/角色/会话的 KV 写全部走 ctx.waitUntil 不阻塞响应；角色解析复用看板 members 表缓存，消除重复飞书拉取。

功能模块

登录与权限：飞书 OAuth 登录（/auth/feishu → 签发 HttpOnly 会话 Cookie），角色由队员名单表解析（队长/财务可见财务明细，队员见汇总，未登录隐藏）；MES 免登复用同一兑换端点。
APP 互联互通（FE-20）：14 个内置应用均以 web/apps/<name>/integration.json 声明 P（公开只读）/ I（身份打通）/ B（业务打通）/ D（设备打通）、权威数据源、业务 ID、缓存和证据；核心业务应用须统一飞书 open_id、服务端权限与审批/待办闭环。新增或更新上架必须传 integration，历史未声明应用保留入口但不视为已打通；verified 只能凭带 summary 的 production 证据，自动化测试最多支持 partial。接入步骤见 docs/APP互联互通使用手册.md，验收口径见 docs/APP互联互通规范_V1.0.md。
个人首页（FE-06/07）：/api/home 千人千面布局（个人 > 组 > 全员默认三级回退），白名单组件（我的应用/我的任务/我的报销/常用资料/赛季目标/物资查询），MCP set_home_layout 可让 Agent 按自然语言配置；/api/todos 聚合审批与待办（FE-09）。工作台含风险红黄分级告警、待办卡行（审批/评审/任务/报销）、组件拖拽排序与刷新过时提示。
我的任务：GET /api/my-tasks 绑定飞书任务后按 Task v2 同步拉取（KV 5 分钟缓存，?refresh=1 强刷），POST /api/my-tasks/unbind 解绑；门户「我的任务」Tab 展示。
赛季目标管理：/api/season-goals/* 收集单提交/采纳 + 按任务自动规划（模块网关 + 配置接口）；门户「赛季目标」Tab。
数据看板：/api/dashboard 聚合飞书多维表格（队员/任务/物资/财务），KV 缓存（TTL 30 分钟，cron 预热），财务区按登录角色脱敏；配置手册见 docs/数据看板配置手册.md。
目标回写（FE-04）：MCP update_progress 回写赛季目标表完成度/状态，写后自动清看板缓存。
数据校验（FE-05）：/api/validate* + MCP validate_bitable / config_validate_rules，校验看板 4 张底表脏数据（声明式 JSON 规则存 KV，新增规则无需改代码），每周一 08:00 cron 自动全量校验并推送群机器人摘要。
团队周报：src/reports/weekly 每周一 00:16 UTC 窗口 cron 自动汇总推飞书群，POST /api/reports/weekly/run 队长/组长可手动补发（可用 FEISHU_BOT_WEBHOOK_WEEKLY_REPORT 分流）。
报销提交：POST /api/reimburse（multipart/form-data，需登录），门户数据看板内直接提交报销单；支持发票号字段与发票 OCR 识别（含 PDF）；GET /api/reimburse/mine 我的报销列表，POST /api/reimburse/<单号>/<action> 审批动作（approve/reject/pay）。
报销 ERP 化（R-01）：/api/erp/reimburse/* —— 费用项目目录 + 收款账户（D1），整单提交走 SOP 校验 → 审批引擎写底表 → D1 单据快照；附件经 POST /api/approvals/upload 存 R2 receipts/；GET /api/erp/reimburse/manage 为队长/财务报销单据台账（搜索/排序/分页），门户「报销」Tab 三视图。
审批引擎（Plan B）：POST /api/approvals 统一发起（reimburse / drawing / hardware / compliance / drawing_review / hardware_review / contract 七流程，flows:config 配置驱动，required + conditional 声明式校验 + 金额须 >0），POST /api/approvals/<type>/<单号>/<action> 状态机动作（全局中文状态机：approve/reject/pay/start/archive/arrive/issue/publish，幂等；评审三流程走各自英文 machine 配置），GET /api/approvals/mine 我的申请；状态机落多维表格底表「状态」字段，结果推飞书群机器人（多群分流 + 加签 + 重试 + notify:failed 留痕）；SLA 时效巡检每小时 :08 窗口 cron 自动跑（G-03）。旧 drawing(MECH)/hardware(HW) 轻审批线已废弃（由 drawing_review/hardware_review 取代，tableId 清空即停用）。
PRD 看板与提交推送：门户「PRD 看板」Tab（GET /api/prd，M1/M2/M3 三列卡片 + 总进度 + 最近 git 提交）；初始状态为 PRD V2.0 盘点基线（src/prd.ts 内 DEFAULT_PRD_ITEMS），之后由 Agent 调 update_prd 维护（覆盖存 KV prd:status）；POST /api/hooks/github 接收 GitHub push webhook（HMAC-SHA256 验签），记录最近提交到看板并推飞书群（可用 FEISHU_BOT_WEBHOOK_PRD 分流）。
图纸评审：src/drawing-review/ 薄壳路由（URL 不变，评审单本体/状态机/通知由审批引擎 drawing_review 流程承担，单号 DR-2026-0001 年计数器）+ 门户「图纸评审」Tab + 静态页 public/apps/drawing-review/，对接飞书多维表格（评审单/纪要/整改项/BOM/事件日志）；含列表/看板双视图（/api/drawing-review/board）与联想功能（/api/drawing-review/suggestions）；PRD 与设计文档见 docs/新增机图纸评审流程_*.md，联想功能全套文档见 docs/文档目录索引.md。
硬件评审：src/hardware-review/ 薄壳路由（单据走引擎 hardware_review 流程，单号 HR-2026-0001）+ /api/hardware-review/*（提交/列表/发起）+ 门户「硬件评审」Tab，MCP config_hardware_review 配置底表。
合同审批：src/contract-approval/ 薄壳路由（单据走引擎 contract 流程，单号 HT-2026-001 三位年计数器，会签全员通过才生效）+ /api/contract-approval/*（提交/列表/发起）+ 门户「合同审批」Tab（列表优先 + 抽屉表单、批准人选择器、文件上传、编号自动生成/查重、审批进度时间线、临期告警、草稿），MCP config_contract_approval 配置底表。
域名分发系统：/api/domains/* 成员自助申请 <subdomain>.newenergycoder.club 三级域名（CNAME/A/AAAA，Cloudflare API 落 DNS，未配凭证时 pending + retry 补同步），申请/释放推群公示；泛域名应用直达 <app>.<zone> → R2 apps/<app>/（deploy_app 零配置获得独立域名）。
CLA 签署：/api/cla* 开源社区贡献协议——元信息 + 公开签署名单（脱敏）、签署状态查询、按 GitHub 用户名幂等签署（登录会话自动绑定 open_id）。
资料页：品牌规范 / 文档模板 / 制度 SOP / 培训材料的登记与展示（GET /api/docs + publish_doc 工具）。
开源仓库：/api/repos 合并 GitHub org necc-hub 与 Gitee darrenpig，含 Star/Fork/Commit，KV 1 小时缓存（可选 GITHUB_TOKEN / GITEE_TOKEN 提额）。

审批通知与 webhook 配置（两步待办）

GitHub 侧：仓库 Settings → Webhooks → Add webhook → https://hub.newenergycoder.club/api/hooks/github，Content type 选 application/json，secret 用 GITHUB_WEBHOOK_SECRET 的值（wrangler secret put GITHUB_WEBHOOK_SECRET 先写入）。
飞书群机器人：战队群 → 群设置 → 群机器人 → 添加「自定义机器人」→ webhook 地址写入 FEISHU_BOT_WEBHOOK（加签 secret 写 FEISHU_BOT_WEBHOOK_SECRET）；可按流程分流 FEISHU_BOT_WEBHOOK_<TYPE>（PRD/REIMBURSE/DRAWING/HARDWARE/COMPLIANCE/DRAWING_REVIEW/HARDWARE_REVIEW/CONTRACT/DOMAINS/WEEKLY_REPORT，secret 同名 _SECRET 后缀）。未配置时推送静默跳过，失败留痕 KV notify:failed（7 天 TTL，100 条截断）。其中 FEISHU_BOT_WEBHOOK_WEEKLY_REPORT 为团队周报（每周一 00:16 UTC cron 自动推送，POST /api/reports/weekly/run 队长可手动补发）的可选分流，缺省回落主 webhook。

FE-05 校验周报与图纸评审告警走另一变量 FEISHU_WEBHOOK_URL（加签 secret 为 FEISHU_WEBHOOK_SECRET）。

本地开发

npm install
npm run dev        # wrangler dev --local --port 8787
npm run check      # tsc --noEmit 类型检查
npm run types      # wrangler types 重新生成 worker-configuration.d.ts
npm test           # vitest 单元/集成测试（test:coverage 出覆盖率）
npm run dev:web    # 门户前端（Vue 3 + Vite）开发热更新
npm run build:web  # 门户前端构建（产物输出到 public/portal-assets/，部署前需跑）

注意：public/index.html、public/apps/*/index.html、public/portal-assets/ 均为构建产物（已被 .gitignore 忽略），勿手改；手写静态资源在 public/brand/、public/docs/、public/assets/。

打开 http://localhost:8787 即为门户。本地模式下 KV/R2/D1 走 Miniflare 本地模拟，无需 Cloudflare 账号。

作为 Kimi Code 插件（本地 MCP）

仓库自带项目级 MCP 配置 .kimi-code/mcp.json（已被 .gitignore 忽略，不入库），npm run dev 启动后新开 Kimi Code 会话即自动接入，工具以 mcp__nec-hub__* 出现。本地启用全部 30 个工具（含写操作）需配置本地 token：

openssl rand -hex 24 > .mcp-token                                   # 生成本地 token（gitignored）
printf 'MCP_TOKEN=%s\n' "$(cat .mcp-token)" > .dev.vars             # Worker 侧（gitignored）
# .kimi-code/mcp.json 的 nec-hub.headers.Authorization 写入 "Bearer <同一 token>"

不配 token 时协议元数据仍可用，业务侧仅放行 readOnly 工具且继续执行各工具的用户权限检查：whoami 不再误报管理员，query_bitable 需有效 user_token 且名单匹配，写工具始终拒绝。生产环境写操作需 Authorization: Bearer <MCP_TOKEN>（secret 经 wrangler secret put 配置），无效 Bearer 一律 401，不能降级为匿名身份。

绑定 Kimi Code 的三层方式（按场景选）

层	配置位置	指向	适用
用户级	`~/.kimi-code/mcp.json` 加 `nec-hub` 条目（headers 带生产 token）	生产 `https://hub.newenergycoder.club/mcp`	日常使用，所有项目可用，无需本地起服务
项目级	本仓库 `.kimi-code/mcp.json`（gitignored）	本地 `http://localhost:8787/mcp`	开发中台本身；同名条目自动覆盖用户级，进本仓库即走本地
插件级	本仓库 `.kimi-plugin/plugin.json`（随仓库分发）	生产（token 走环境变量 `NEC_HUB_MCP_TOKEN`，不落文件）	团队成员一键安装：`/plugins install https://github.com/necc-hub/nec-hub`
Pi 常驻	`scripts/pi/`（install.sh + systemd，仓库分发）	局域网树莓派 `http://<pi-ip>:8787/mcp`	团队共享 staging：调试/联调走 Pi（Miniflare 模拟，与生产隔离），不耗 CF 配额；队员配 `nec-hub-dev` 条目与生产并存，详见 `scripts/pi/README.md`

三条规则让体验「充分绑定」：① 用户级与项目级同名 nec-hub，Kimi Code 按项目级优先自动切换本地/生产，无需手工改配置；② config.toml 加 [[permission.rules]]（decision = "allow", pattern = "mcp__nec-hub__*"）免逐次批准；③ 改动后 /reload 或新会话生效，/mcp 可查连接状态。

升级路径

工具增删改（最常见）：只动服务端。push 到 main → CI 自动 wrangler deploy；客户端零操作，新会话 tools/list 自动拿到最新工具表。改工具时同步递增 src/mcp/handler.ts 的 serverInfo.version。
插件清单变更（systemPrompt / 元信息）：改 .kimi-plugin/plugin.json 并递增其 version，已安装的队员在 /plugins 面板按 Enter 即更新；工具变更不需要重装插件（工具表在会话启动时实时拉取）。
本地开发环境：git pull && npm run dev 即可，token 配置一次长期有效。

部署

CI/CD（.github/workflows/ci-cd.yml）：PR 跑类型检查；push 到 main 先跑 vitest 门禁再自动 wrangler deploy（需仓库 secret CLOUDFLARE_API_TOKEN）。也可手动一键部署：

./scripts/deploy-hub.sh   # 创建 KV/R2 → 回填 wrangler.jsonc → 构建门户前端 → wrangler deploy → 健康检查

绑定资源：KV REGISTRY（注册表/缓存/会话）、R2 APPS_BUCKET（应用/Skill/报销附件托管）、D1 ERP_DB（报销 ERP 快照，迁移在 migrations/erp/）、Assets（门户静态页）、泛域名路由 *.newenergycoder.club/*（应用直达，需 DNS * 代理记录 + Universal SSL）。

Cron（wrangler.jsonc triggers，2 条 + 时间窗调度）：*/8 * * * * 快触发器驱动看板预热（每 tick）、审批时效巡检（每小时 :08 窗口）、仓库缓存 + 图纸评审阻塞告警（每小时 :24 窗口）；0 0 * * 1（周一 08:00 UTC+8）数据校验周报（00:00 UTC 窗口）+ 团队周报（00:16 UTC 窗口）+ 群机器人推送。handler 按 UTC 时间窗分发 + cron:guard 去重，与账户实际生效的触发器解耦（残留触发器由 handler 兼容，防双重执行/重复推送）。

路由

路径	说明
`GET /`	门户（15 个 Tab：我的首页 / 我的任务 / 图纸评审 / 报销 / 任务排期 / 赛季目标 / 应用广场 / Skill 中心 / 资料页 / 开源仓库 / 硬件评审 / 合同审批 / 数据看板 / PRD 看板 / NEC-MCP；hash 路由深链 `/#/<tab>`）
`POST /mcp`	MCP streamable HTTP 端点（JSON-RPC；写操作需 `MCP_TOKEN`）
`POST /auth/feishu` · `POST /auth/logout` · `GET /api/whoami`	飞书 OAuth 登录 / 登出 / 当前用户与角色
`GET /api/config`	公开配置（飞书 App ID、登录是否启用）
`GET /api/health`	健康检查
`GET /api/apps` · `/api/skills` · `/api/docs`	应用 / Skill / 资料页注册表
`GET /api/repos`	NEC 开源仓库列表（GitHub + Gitee 合并，KV 1 小时缓存）
`GET /api/dashboard`	数据看板聚合（KV 缓存 + cron 预热；财务区按登录角色脱敏）
`GET/POST /api/home` · `POST /api/home/reset`	个人首页布局（需登录；个人 > 组 > 默认三级覆盖）
`GET /api/todos`	审批/待办聚合（需登录）
`GET /api/my-tasks` · `POST /api/my-tasks/unbind`	我的任务（飞书 Task v2 绑定同步，KV 5 分钟缓存，`?refresh=1` 强刷）/ 解绑
`/api/season-goals/*`	赛季目标管理（收集单提交/采纳 + 按任务自动规划；`config` 无需登录）
`GET /api/prd`	动态 PRD 看板（M1/M2/M3 需求状态 + 总进度 + 最近 git 提交；状态经 MCP `update_prd` 维护）
`POST /api/hooks/github`	GitHub push webhook（HMAC-SHA256 验签 → 记录最近提交 → 推飞书群机器人；需 `GITHUB_WEBHOOK_SECRET`）
`POST /api/approvals`	发起审批（需登录；4 流程统一入口，flows:config 配置驱动；external / 越组 403）
`POST /api/approvals/<type>/<单号>/<action>`	审批与流程动作（approve/reject/pay/start/archive/arrive/issue/publish，幂等）
`GET /api/approvals/mine?type=`	我的申请列表（按 open_id 过滤，提交时间降序 20 条）
`POST /api/approvals/upload`	审批凭证文件上传（multipart → R2 `receipts/`，返回 key）
`POST /api/reports/weekly/run`	团队周报手动触发（队长/组长；cron 每周一 00:16 UTC 窗口自动推送）
`GET /api/validate` · `/api/validate/report` · `POST /api/validate/run`	数据校验查询 / 最新报告 / 手动触发（FE-05）
`POST /api/reimburse`	报销提交（multipart/form-data，需登录；发票号 + OCR）
`GET /api/reimburse/mine` · `POST /api/reimburse/<单号>/<action>`	我的报销列表 / 报销审批动作（approve/reject/pay）
`/api/erp/reimburse/*`	报销 ERP 化（R-01，需登录）：`meta` 费用目录+收款账户 · `PUT payee` · `submit` 整单提交 · `docs/mine` 我的单据 · `docs/<单号>` 详情 · `manage` 台账（队长/财务，搜索/排序/分页）
`/api/domains/*`	域名分发系统：公开目录 / 我的域名 / 申请 / 释放 / 重试同步（登录后自助，CF API 落 DNS）
`/api/cla` · `/api/cla/status` · `POST /api/cla/sign`	开源社区贡献协议：元信息+公开名单 / 签署状态 / 幂等签署
`/api/drawing-review/*`	图纸评审（`config` 无需登录；列表/提交/看板/联想需登录）
`/api/hardware-review/*`	硬件评审流程（提交/列表/发起，需登录）
`/api/contract-approval/*`	合同审批流程（提交/列表/发起，需登录）
`GET /apps/<name>/`	队员应用（R2，Cache API 边缘缓存）
`<app>.newenergycoder.club`	泛域名应用直达 R2 `apps/<app>/`（登记过外部目标的域名与保留名透传回源）
`GET /skills/<name>/SKILL.md`	Skill 原文

MCP 工具（30 个）

工具	说明
`deploy_app`	上传静态文件到 R2 并注册到应用广场；新上架/更新必传 `integration`，失败在副作用前终止
`register_app`	登记外部应用链接；新登记/更新必传 `integration`，不代表自动完成 SSO 或业务打通
`sync_vercel`	自动发现 Vercel 项目并批量登记（默认 dry-run，`confirm=true` 写入；需 `VERCEL_TOKEN`；经 `integrations` 按名声明并整批预检）
`publish_skill`	上架 SKILL.md 到 Skill 中心（中台自托管，`source: "hub"`）
`import_skills`	批量登记外部 Skill（只存名称/描述/链接）；不覆盖中台自托管的 Skill
`remove_skills`	按名称批量下架 Skill（安全约束：只能删外部登记来源，自托管不受影响）
`query_bitable`	只读查询飞书多维表格；非管理调用需有效 `user_token` 且名单匹配，finance 表另需队长/财务或管理端 `MCP_TOKEN`
`config_dashboard`	配置/查看数据看板对接的多维表格（app_token + 各表 table_id）
`config_drawing_review`	配置/查看图纸评审流程对接的多维表格（reviews/minutes/rectifications/bom/events 等 10 张表；reviews 主表与引擎 flows:config 双配置同源，引擎侧自动回填）
`config_hardware_review`	配置/查看硬件评审流程对接的多维表格（reviews/minutes/rectifications/reports/events；主表双配置同源同上）
`config_contract_approval`	配置/查看合同审批流程对接的多维表格（approvals/comments/events；approvals 主表双配置同源同上）
`update_progress`	回写赛季目标表完成度%/状态/备注（FE-04；唯一匹配才写入，写后自动清看板缓存）
`validate_bitable`	校验看板 4 张底表脏数据，输出按类型分组的异常清单（FE-05；scope=mine/all）
`config_validate_rules`	查看/整体替换/恢复数据校验规则集（声明式 JSON 存 KV，新增规则无需改代码）
`set_home_layout`	配置个人首页布局（FE-06/07；scope=user 本人 / scope=group 组别默认，需组长/队长）
`publish_doc`	发布/更新资料页条目（brand / template / sop / training 四类）
`remove_docs`	按 id 从资料页移除条目（只删索引，不动资料本体）
`setup_bitable`	数据基建一键建表：按标准 schema 在指定 base 创建队员名单/任务进度/物资台账/财务报销四张表并写入看板配置（仅管理端）
`add_records`	往飞书多维表格追加记录（字段名预检，人话报错；仅管理端）。典型用法：报销回写财务表、任务批量导入、名单录入
`update_prd`	更新 PRD 看板需求状态（done/partial/pending/todo），看板实时同步、状态变化推群（仅管理端）
`submit_approval`	代发起审批申请（4 流程 type 参数化，按 flows:config 声明式规则校验；仅管理端）
`list_todos`	按 open_id 拉取待办聚合（各流程底表中待其审批的单 + 逾期任务，按流程分组；仅管理端）
`send_notice`	向指定流程发送飞书群机器人通知（多群分流 + 加签；失败重试 2 次并留痕 `notify:failed`；channel=mail/both 走 N-02 邮件通道；仅管理端）
`config_flows`	查看/修改审批流程配置 flows:config（底表/单号前缀/审批角色/必填规则/金额会签阈值/sla 时效；set 深合并校验；仅管理端）
`schedule_meeting`	一键创建飞书日历日程 + 视频会议（`src/meeting/`，评审模块拉会共用；未授权时降级 mock）
`whoami`	验证当前调用身份（Agent 接入自检：管理端返回 admin；user_token 返回 open_id/姓名/角色）
`send_mail`	N-02 飞书邮箱发信（本人 user_token 或管理端 from 代发；from_address 显式地址；未配置发件人时返回降级说明）
`update_inventory`	物资台账手工调账（inbound 入库 / outbound 出库 / adjust 盘点调账；物料名模糊匹配自动建行，审批台账联动失败补偿；仅管理端）
`apply_domain`	代申请 NEC 三级域名 `<subdomain>.newenergycoder.club`（CNAME/A/AAAA，已配 CF 凭证时自动建 DNS 记录并推群公示；仅管理端）
`release_domain`	释放已登记的 NEC 三级域名（删 DNS 记录 + 删登记 + 推群公示；仅管理端）

Skill 同步脚本

scripts/sync-gitee-skills.py — 从 Gitee 仓库的 skills/*/SKILL.md 批量解析 frontmatter 描述，按白名单 scripts/nec-skills-allowlist.txt 过滤后通过 import_skills 登记到 Skill 中心（默认来源标识 gitee，门户中显示 ⤤ 外链）。

python scripts/sync-gitee-skills.py                 # 预览（不写 hub）
python scripts/sync-gitee-skills.py --confirm       # 实际导入
python scripts/sync-gitee-skills.py --repo owner/name --branch SKill --dir skills --hub https://hub.newenergycoder.club

已配置的生产资源

自定义域名：hub.newenergycoder.club（custom domain，自动签发证书）+ 泛域名路由 *.newenergycoder.club/*（应用直达，DNS * 代理记录 + Universal SSL）
绑定：KV REGISTRY · R2 APPS_BUCKET（nec-hub-apps）· D1 ERP_DB（nec-hub-erp，迁移 migrations/erp/）· Assets（门户）
Secrets：FEISHU_APP_ID / FEISHU_APP_SECRET（OAuth 登录 + MES 免登）· MCP_TOKEN（MCP 写保护，已启用）· VERCEL_TOKEN（sync_vercel）· FEISHU_WEBHOOK_URL（群机器人：每周校验周报 + 图纸评审通知/阻塞告警；机器人开启签名校验时配套 FEISHU_WEBHOOK_SECRET）
可选：GITHUB_TOKEN / GITEE_TOKEN（/api/repos 提额）· GITHUB_WEBHOOK_SECRET（/api/hooks/github 验签）· FEISHU_BOT_WEBHOOK 系列（审批/PRD 群通知，可按流程分流）· CF_API_TOKEN / CF_ZONE_ID（域名分发系统自动建 DNS 记录，未配置时申请存 pending 可 retry 补同步）

待办（第二/三阶段）

完整需求、优先级与验收标准见 docs/团队AI中台PRD_V2.1.md（M1 地基 → M2 资产与智能 → M3 个性化与自动化）。

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
.kimi-plugin		.kimi-plugin
docs		docs
integrations/mes		integrations/mes
mechanical-review/6014		mechanical-review/6014
migrations/erp		migrations/erp
public		public
scripts		scripts
src		src
web		web
.gitignore		.gitignore
README.md		README.md
REIMBURSEMENT_GUIDE.md		REIMBURSEMENT_GUIDE.md
REIMBURSEMENT_SUMMARY.md		REIMBURSEMENT_SUMMARY.md
REIMBURSE_TEST_RESULT.md		REIMBURSE_TEST_RESULT.md
TEST_REIMBURSE_GUIDE.md		TEST_REIMBURSE_GUIDE.md
drawing-review-config-summary.md		drawing-review-config-summary.md
package-lock.json		package-lock.json
package.json		package.json
test-drawing-review.sh		test-drawing-review.sh
tsconfig.json		tsconfig.json
vitest.config.ts		vitest.config.ts
wrangler.jsonc		wrangler.jsonc

Navigation Menu

Repository navigation

About

Repository files navigation

nec-hub — NEC 团队 AI 中台

线上内容（截至 2026-10-16）

代码结构

功能模块

审批通知与 webhook 配置（两步待办）

相关仓库与文档

本地开发

作为 Kimi Code 插件（本地 MCP）

绑定 Kimi Code 的三层方式（按场景选）

升级路径

部署

路由

MCP 工具（30 个）

Skill 同步脚本

已配置的生产资源

待办（第二/三阶段）

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

nec-hub — NEC 团队 AI 中台

线上内容（截至 2026-10-16）

代码结构

功能模块

审批通知与 webhook 配置（两步待办）

相关仓库与文档

本地开发

作为 Kimi Code 插件（本地 MCP）

绑定 Kimi Code 的三层方式（按场景选）

升级路径

部署

路由

MCP 工具（30 个）

Skill 同步脚本

已配置的生产资源

待办（第二/三阶段）

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages