Skip to content

feat(skills): 统一 Dashboard 技能与独立分发构建,完善地图模板 - #565

Merged
youngwinds merged 3 commits into
mainfrom
codex/map-dashboard-templates
Oct 19, 2026
Merged

youngwinds merged 3 commits into
mainfrom
codex/map-dashboard-templates

Conversation

@youngwinds

@youngwinds youngwinds commented Oct 19, 2026 •

Copy link
Copy Markdown
Collaborator

💡 问题与解决方案

Dashboard 技能需要既能完整安装,也能按场景独立分发;API 文档与公共能力应统一维护,打包时自动同步。本 PR 将技能统一为 skills/visactor-dashboard,通过 pnpm build:skills 生成可独立使用的轻量看板和地图看板 ZIP。

  • 统一技能与依赖方向:保留一个完整的 visactor-dashboard,场景共用 metric-analysis、server-runtime、visual-query。公共指南不得反向引用场景,两个场景不得互引,构建时检查违规依赖及缺失链接。
  • 统一 API 生成与分发:VBI、VQuery、VSeed 文档集中在 api/,工作流说明由 scripts/skill-api/ 统一维护。移除独立 build:skill-api 命令,每次构建先更新 API,再生成 dist/skills/light-dashboard.zip 和 map-dashboard.zip;显示 [1/11] 至 [11/11] 的阶段进度。
  • 精简 VSeed 文档:生成时跳过运行时 schema 声明(包括重命名导出),移除约 13 MB 的 schemas.md 并清理索引和指南链接;保留图表 DSL、Builder、公共类型及其他包 API,重建时自动清除旧文件。
  • 独立包完整可用:重写包内相对链接,附带三份公共指南、API、模板及元数据;排除依赖、缓存、本地环境配置和嵌套 ZIP,保留 .env.example。固定路径排序与时间戳以支持可重复构建;生成或打包失败时保留原有 ZIP。分发产物由构建生成,不提交到 Git。
  • 整理面向使用者的指南:技能正文移除仓库维护指令。地图入口按模板、四个 Step、参考资料组织;通用指标分析抽至公共指南,地图指南补充地域下钻、定位与视觉规则,并补齐验收与地域口径说明。
  • 完善地图模板与资源:新增电厂分布模板及主题 CSV 数据,更新地震、超市模板与加载、卡片、筛选、分析和地图交互。补充跨日期线定位、底图恢复、生命周期及演示数据检查。

改动类型

  • 功能增强与重构
  • 打包优化与测试更新
  • 文档与 Demo 更新

验证

  • pnpm build:skills 实跑通过,两个独立 ZIP 均可解压,阶段提示在执行过程中输出。
  • 完整构建测试 16/16:覆盖源码与工作流更新、缺失 API 恢复、过时内容移除、独立包完整性、依赖方向、可重复构建、失败保留原产物与进度时序;同时验证 schema 声明排除、别名处理、旧文件清理及两个 ZIP 不再包含 schemas.md。
  • 打包后地图模板测试 5/5;源码及两个 ZIP 的技能元数据、本地链接、HTML 资源、CRC 与模板一致性检查通过。
  • 构建工具覆盖率未下降:build-skills.mjs 行/分支/函数均为 100%;API 生成模块为 100% / 95.51% / 95.83%。Node 原生覆盖率不单独提供 statements 指标。
  • pnpm lint:check 通过,pnpm typecheck 通过(24 项,Turbo 缓存)。提交钩子执行格式化和 lint。
  • 浏览器冒烟验证首页与经营概览示例正常渲染,控制台无 error;此前验证华东筛选后的指标、发现与明细一致。
  • 地图瓦片、地震外部接口及超市 MySQL 的完整实时联调未在本轮验证。

自检

  • 文档、示例及构建说明已更新。
  • 未改变公共 TypeScript API 或依赖版本,无需包版本 changeset。
  • ZIP 由构建自动生成,维护源文件仅保留一份。

@youngwinds youngwinds changed the title feat(skills): 完善地图看板模板并精简构建指南 feat(skills): 统一 Dashboard 技能与独立分发构建,完善地图模板 Oct 19, 2026
@youngwinds
youngwinds merged commit e8dcd85 into main Oct 19, 2026
3 checks passed
@youngwinds
youngwinds deleted the codex/map-dashboard-templates branch October 19, 2026 09:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant