Feffery-Dash AI 开发辅助 Skill
为 Claude Code 提供 Feffery-Dash 生态系统的完整开发支持
核心模块导航
1. 开发规范 (references/core/)
| 文档 | 内容 |
|---|---|
| feffery-dash-core.md | 核心入口 - 标准导入、应用实例化、回调规范 |
| project_standards.md | 项目结构规范、文件组织 |
| callback_patterns.md | 回调模式大全：ctx、Patch、set_props、模式匹配 |
| layout_guide.md | 布局指南：栅格、Flex、响应式 |
| best_practices.md | 最佳实践：性能、安全、代码组织 |
| plugins.md | Dash 3.x 插件系统 |
2. 组件库 (references/components/)
| 组件库 | 文档 | 用途 |
|---|---|---|
| fac | feffery-fac.md | Ant Design UI 组件 (100+) |
| fuc | feffery-fuc.md | 工具组件、性能优化 |
| fact | feffery-fact.md | 数据可视化图表 |
| flc | feffery-flc.md | Leaflet 地图组件 |
| fm | feffery-fm.md | MapLibre/Deck.gl 高性能地图 |
| fi | feffery-fi.md | 声明式信息图 (59 模板) |
3. 专题指南 (references/topics/)
| 专题 | 文档 | 说明 |
|---|---|---|
| magic-dash | magic-dash.md | 项目脚手架 CLI 工具 |
| 仪表盘 | dashboard.md | 仪表盘开发完整指南 |
4. 扩展组件 (references/extras/)
| 组件/插件 | 文档 | 说明 |
|---|---|---|
| fmc | fmc_markdown.md | Markdown 渲染、代码高亮、LaTeX |
| famc | mobile_components.md | 移动端 UI 组件 (57个) |
| 插件 | plugins.md | Tailwind CSS / Vite 插件 |
| 汇总 | feffery-extras.md | 扩展组件入口文档 |
5. 案例库 (references/examples/)
| 文档 | 说明 |
|---|---|
| feffery-examples.md | 案例索引入口 |
| by_category.md | 按类别浏览 |
| by_component.md | 按组件浏览 |
快速参考
标准导入模板
python
# Dash 核心 import dash from dash import html, dcc, ctx, Patch, set_props, no_update from dash.dependencies import Input, Output, State, ALL, MATCH # Feffery 组件库（必须使用指定别名） import feffery_antd_components as fac import feffery_utils_components as fuc
应用基础结构
python
app = dash.Dash(
__name__,
title='应用标题',
suppress_callback_exceptions=True,
)
server = app.server
app.layout = fac.AntdConfigProvider(
locale='zh-cn',
children=[
# 页面内容
]
)
if __name__ == '__main__':
app.run(debug=True)
常用组件速查
| 类别 | 组件 |
|---|---|
| 布局 | AntdRow/Col, AntdSpace, AntdLayout, AntdCard |
| 表单 | AntdForm, AntdInput, AntdSelect, AntdDatePicker |
| 展示 | AntdTable, AntdTabs, AntdModal, AntdDrawer |
| 反馈 | AntdMessage, AntdNotification, AntdSpin, AntdAlert |
| 图表 | AntdLine, AntdBar, AntdPie, AntdArea |
组件库一览
| 组件库 | 别名 | 组件数 | 官方文档 |
|---|---|---|---|
| feffery-antd-components | fac | 109 | https://fac.feffery.tech/ |
| feffery-utils-components | fuc | 123 | https://fuc.feffery.tech/ |
| feffery-antd-charts | fact | 32 | https://fact.feffery.tech/ |
| feffery-leaflet-components | flc | 29 | http://flc.feffery.tech/ |
| feffery-maplibre | fm | 32 | - |
| feffery-markdown-components | fmc | - | http://fmc.feffery.tech/ |
| feffery-antd-mobile-components | famc | 57 | - |
| feffery-infographic | fi | 1 (59 模板) | https://infographic.antv.vision/ |
Use Cases
- •快速搭建 Dash + Feffery 的后台与数据看板
- •编写复杂回调（模式匹配、Patch、ctx）
- •规划组件选型（fac/fuc/fact/flc/fm/fmc/famc）
- •统一项目结构、代码规范与性能基线
Run
bash
python3 -m venv .venv && source .venv/bin/activate pip install -U pip dash feffery-antd-components feffery-utils-components
Inputs
- •页面目标与交互流程
- •数据来源与刷新频率
- •组件约束（桌面/移动端、图表类型、地图）
- •代码组织要求（单页/多页、目录规范）
Outputs
- •可运行的 Dash 页面骨架与核心回调
- •组件选型建议与替代方案
- •性能与可维护性建议（回调拆分、状态管理）
Safety
- •避免在回调中暴露敏感数据
- •对用户输入做校验与兜底
- •大数据量场景优先分页/懒加载
- •仅在必要时启用高成本前端特效
Version
- •Template-Version: 1.0
- •Last-Updated: 2026-02-17