数据可视化图表库【免费下载链接】pyecharts Python Echarts Plotting Library项目地址https://gitcode.com/gh_mirrors/py/pyecharts点击查看免费下载导读AGENTS.md 是 pyecharts 仓库中面向在代码库上工作的 Agent以及任何贡献者编写的协作规范集中定义了项目的测试/静态检查/格式化/构建命令全集、代码风格约束与开发工作流。本文以该文档为主体结合仓库中的 Makefile、setup.py、pyproject.toml、test.py 与 test/ 测试用例等源码证据进行纵深解读。读完本文你将掌握在 pyecharts 仓库中如何正确运行单测与覆盖率统计、如何按团队规范编写可合入的代码导入、命名、异常处理、Google 风格 docstring、以及从改代码到提交的完整开发闭环。一、构建 / 静态检查 / 测试命令总览AGENTS.md 指出项目同时使用 pytest 与 nose2 两套测试框架并建议运行单个测试时优先使用 pytest见文档 Additional Notes 一节该结论同样可以从 test.py 中同时串联执行两种框架得到印证。1. 运行全部测试文档给出了四种等价的全量测试入口make test # 或 python test.py # 或 nose2 --with-coverage --coverage pyecharts --coverage-config .coveragerc -s test # 或 pytest -cov-config.coveragerc --cov./ test/make test是仓库推荐的统一入口。查看 Makefile 可以发现其真实执行体为uv run pytest -v --cov-configpyproject.toml --cov./ test/——即通过 uv 管理环境并调用 pytest以pyproject.toml中的[tool.coverage.run]作为覆盖率配置omit 掉pyecharts/render/templates/*、setup.py、install.py、test.py、test/*等非被测对象。python test.py是仓库自带的便捷脚本其内部通过os.system(...)依次执行 nose2--coverage pyecharts --coverage-config .coveragerc -s test、pytest-cov-config.coveragerc --cov./ test/以及 flake8 静态检查即一次脚本同时跑两套测试框架 代码检查。nose2与pytest两条裸命令分别对应上述两套框架的等价写法二者都显式引用.coveragerc.coveragerc 中配置了与 pyproject.toml 一致的 omit 规则与show_missing True报告选项。2. 运行单个测试文件# 使用 pytest推荐 pytest test/test_chart.py # 使用 nose2 nose2 --with-coverage --coverage pyecharts --coverage-config .coveragerc test.test_chart注意两种框架对测试文件路径的写法差异pytest 接受文件系统路径test/test_chart.pynose2 则接受模块路径test.test_chart点号分隔、无.py后缀。以 test/test_chart.py 为例该文件基于unittest.TestCase组织测试类内含test_chart_dark_mode、test_chart_line_style_opts、test_chart_split_line_style_opts等方法。3. 运行特定测试方法# 使用 pytest pytest test/test_chart.py::TestChartClass::test_chart_dark_mode # 使用 nose2 nose2 --with-coverage --coverage pyecharts --coverage-config .coveragerc test.test_chart.TestChartClass.test_chart_dark_modepytest 用双冒号::逐级定位文件::类::方法nose2 用点号逐级定位模块.类.方法。这种精确到方法的粒度非常适合在开发中快速复现单个失败用例。4. 带 verbose 输出的测试pytest -v test/test_chart.py-v会让 pytest 逐条打印每个测试用例的名称与 PASS/FAIL 状态便于定位具体失败方法。5. 带覆盖率报告的测试pytest -v --cov./ --cov-reporthtml test/test_chart.py--cov./指定对整个仓库根目录做覆盖率统计--cov-reporthtml生成可浏览器查看的 HTML 覆盖率报告。若仅需命令行摘要可将--cov-reporthtml替换为--cov-reportterm这也是 pytest-cov 的默认行为。6. 静态检查Lintingmake lint # 或 flake8 --excludebuild,images,example,examples --max-line-length89 --ignoreF401查看 Makefile 可知make lint实际执行uv run flake8 --excludebuild,images,example,examples,.venv --max-line-length89 --ignoreF401,F824其中新增了对.venv的排除以及 F824 忽略。flake8 的裸命令以--max-line-length89强制行宽上限与文档 Code Style 一节一致--ignoreF401忽略导入未使用告警该规则与下方导入别名实践相关部分导入仅为保持 API 可访问性而存在。若只想检查某个文件把路径追加到命令末尾即可例如flake8 --excludebuild,images,example,examples --max-line-length89 --ignoreF401 test/test_chart.py7. 代码格式化black . isort .仓库明确采用 black isort 组合black 负责统一代码排版isort 负责整理 import 顺序。二者版本由 requirements-dev.txt 锁定black24.3.0、isort4.3.16在 CI/协作环境中应使用该文件固定版本避免格式漂移。8. 构建与发布python setup.py sdist bdist_wheel make uploadpython setup.py sdist bdist_wheel基于 setup.py 构建源码包sdist与 wheel 包。setup.py 中通过exec读取 pyecharts/_version.py 获取版本号声明了jinja2、prettytable、simplejson三个运行时依赖并提供可选依赖组seleniumsnapshot-selenium、phantomjssnapshot-phantomjs、pyppeteersnapshot-pyppeteer、imagesPIL/Pillow这些与文档JavaScript 依赖通过 Base 类的 js_dependencies 属性管理属于不同维度的依赖体系。make upload在 Makefile 中并未直接定义而是依赖 setup.py 中的cmdclass{upload: UploadCommand}setup.py 顶部注释写明# $ python setup.py upload。查看 setup.py 中UploadCommand.run()的实现可知该命令会依次清理 dist/build/egg-info → 调用setup.py sdist bdist_wheel重新构建 → 通过twine upload dist/*发布到 PyPI → 打v{version}的 git 标签并推送。注意它依赖本机已安装 twine 且已配置 PyPI 凭据仅限维护者发布流程使用。二、代码风格指南1. 导入组织与别名文档要求 import 按标准库 → 第三方库 → 本地应用库三段式组织并给出正反示例# 推荐 from pyecharts import options as opts from pyecharts.charts import Line, Bar # 避免 from pyecharts.options import * import pyecharts.charts.Line同时建议为高频模块使用别名import pyecharts.options as opts import pyecharts.globals as globals这一惯例在仓库源码中随处可见例如 pyecharts/charts/chart.py 首行即from .. import options as optstest/test_chart.py 也遵循from pyecharts import options as opts、from pyecharts.charts import Line, Bar的写法。这解释了 flake8 命令为何--ignoreF401——存在仅为别名可达性而导入的合法场景。2. 排版规范行宽上限 89 字符flake8--max-line-length89强制当前项目配置在 pyproject.toml 与 Makefile 中均可复现。缩进 4 空格禁止 Tab。字符串使用双引号字符字面量使用单引号。这与 black 默认风格一致。空行规则顶层函数与类之间空 2 行类内方法之间空 1 行PEP 8 标准。最终以black .兜底保证全库一致。3. 命名约定对象风格示例变量 / 函数snake_casedef add_yaxis(self, series_name, y_axis, *args, **kwargs): pass类PascalCaseclass TestChartClass(unittest.TestCase): pass常量UPPER_CASEMAX_RETRIES 3私有成员下划线前缀def _internal_method(self): pass从源码看pyecharts/charts/base.py 中的self.js_dependencies: utils.OrderedSet、pyecharts/charts/chart.py 中的self._chart_type: Optional[str] None均为该规范的实际落地公开 API 使用 snake_case内部状态使用_前缀。4. 错误处理文档明确三条原则用异常表达错误不用返回码异常类型要具体示例中分别捕获ValueError与RuntimeError并先记录日志再raise传播禁止无差别捕获except:pass属于反模式应改为捕获具体异常类型。这一约定与仓库 pyecharts/exceptions.py 提供的专用异常体系相呼应调用方可按具体异常类型精确处理。5. 测试指南结构基于unittest框架 TestCase类组织把相关测试聚合成类方法名使用描述性命名。仓库 test/test_chart.py 中class TestChartClass(unittest.TestCase)即为此范式。命名test_前缀 被测特性例如test_chart_dark_mode、test_chart_line_style_opts从命名即可判断测试目标。Mock 外部依赖文档示例用patch(pyecharts.render.engine.write_utf8_html_file)打桩 HTML 写盘函数避免测试产生真实文件。仓库测试大量采用此模式例如 test/test_chart.py 中test_chart_dark_mode断言渲染内容里包含darkMode从而在不落盘的情况下验证set_dark_mode()正确写入了 ECharts 配置。覆盖率目标追求高覆盖率同时覆盖成功路径、失败路径与边界情况。仓库通过.coveragerc与pyproject.toml的[tool.coverage.run]排除模板与安装脚本等不可测文件保证统计结果聚焦真实业务代码。6. 文档规范Google 风格 docstring方法 docstring 应包含Args、Returns、Raises三节按需出现def add_yaxis(self, series_name, y_axis, colorNone): Add a series to the chart. Args: series_name (str): Name of the series. y_axis (list): Data values. color (str, optional): Color of the series. Defaults to None. Returns: Chart: The chart instance for method chaining. 注释原则解释为什么而非是什么并随代码变更保持同步。仓库中 pyecharts/charts/chart.py 的set_dark_mode()注释# [Hard Code Here] The Echarts default Dark Mode Configurations即为解释动机的典型注释。7. 最佳实践方法链Method Chaining修改对象的方法应return self。源码佐证set_dark_mode()见 pyecharts/charts/chart.py末尾return self、add_xaxis()pyecharts/charts/basic_charts/custom.py均遵循该约定使Line().add_xaxis(...).add_yaxis(...).render()式链式调用成为可能。类型提示公开方法建议标注参数与返回类型如def add_yaxis(self, series_name: str, y_axis: list) - Base。仓库广泛使用 pyecharts/types.py 中的Optional、Sequence等类型别名如 pyecharts/charts/chart.py 中dark_mode_colors: Optional[Sequence[str]]。选项对象不可变性修改 options 时不得改动原始对象应deepcopy或dict(old_opts)生成副本后再写回。这与 options 体系pyecharts/options/配置对象可被多个图表复用的设计一致。性能意识处理大数据集时注意性能。可参考 pyecharts/datasets/ 下数据集的加载方式与渲染管线。向后兼容任何改动都需考虑既有用户避免破坏已公开的 API 签名。三、标准开发工作流AGENTS.md 给出了从改动到提交的五步闭环改代码跑测试验证无回归make test静态检查make lint格式化black .与isort .提交并推送。实际执行时建议按格式化 → 测试 → lint的顺序微调先格式化可减少因格式导致的失败噪音在提交前也可用pytest -v --cov./ --cov-reporthtml test/test_chart.py对改动模块做定向验证。四、附加说明与仓库特性速查AGENTS.md 末尾罗列了与协作直接相关的项目事实逐条结合仓库核实如下双测试框架pytest 与 nose2 并行支持运行单个用例优先 pytesttest.py 与文档命令均可验证。覆盖率配置.coveragerc与pyproject.toml的[tool.coverage.run]均排除测试文件与模板pyecharts/render/templates/*报告开启show_missing True。构建流程由 setup.py 定义内置UploadCommand负责 PyPI 发布python setup.py upload发布前会清理旧构建产物并打 git 版本标签。JavaScript 依赖管理通过Base类的js_dependencies属性管理pyecharts/charts/base.py 中self.js_dependencies: utils.OrderedSet utils.OrderedSet(echarts)地图、词云、液体填充等扩展图会向该集合追加对应依赖如echarts-liquidfillpyecharts/charts/basic_charts/liquid.py、echarts-wordcloudpyecharts/charts/basic_charts/wordcloud.py、echarts-glpyecharts/charts/three_axis_charts/ 及 pyecharts/charts/chart.py 的add_schema路径等。默认语言默认中文ZH可切换为英文EN对应 pyecharts/globals.py 中的语言/主题等全局常量。深色模式通过set_dark_mode()开启。结合 pyecharts/charts/chart.py 的实现可知默认背景色#100C2A默认配色为 9 色的 ECharts Dark 色板#4992ff #7cffb2 #fddd60 #ff6e76 #58d9f9 #05c091 #ff8a45 #8d48e3 #dd79ff同时将darkModeTrue写入 options 并把self.theme切换为ThemeType.DARKtest/test_chart.py 中的test_chart_dark_mode正是通过断言渲染内容包含darkMode来回归此功能。渲染方式render()生成 HTML 文件render_embed()输出可嵌入页面的图表内容对应 pyecharts/charts/base.py 中render/render_embed方法及 pyecharts/render/ 渲染引擎与 Jinja2 模板体系。结语AGENTS.md 虽然名为面向 Agent 的说明文件实质上是 pyecharts 仓库最浓缩的工程规范手册它把测试矩阵、代码风格、提交流程与关键架构事实js_dependencies、深色模式、双框架、构建发布收敛在一份可执行、可检查、可回归的文档里。无论是人类贡献者还是自动化 Agent遵循本文梳理的命令与规范即可在 test/ 测试体系、pyecharts/ 源码结构与 pyproject.toml 配置之间保持一致、可验证的协作基线。赞分享数据可视化图表库【免费下载链接】pyecharts Python Echarts Plotting Library项目地址https://gitcode.com/gh_mirrors/py/pyecharts点击查看免费下载相关推荐Orchard Core 开发全指南Agent 协作、构建测试、编码规范与扩展点详解Orchard Core 开发全指南Agent 协作、构建测试、编码规范与扩展点详解 导读 本文以 Orchard Core 仓库根目录下的 AGENTS.CMS后端Web框架猫抓(cat-catch)免费网页视频下载怎么做完整指南一次讲清猫抓 cat catch 免费网页视频下载怎么做完整指南一次讲清 讲座回放只在网页播放器里播右键被禁用页面上翻不到任何下载入口——文件其实一直在那里只音视频四步写好自己的 Stitch 技能SKILL.md 完整拆解指南四步写好自己的 Stitch 技能SKILL.md 完整拆解指南 stitch skills 技能库能让 Claude Code、Cursor、GeminiAI 技能AI 插件上一篇告别单调文档Slate主题配色终极指南让API文档颜值飙升下一篇终极代码规范自动化指南从cpplint到PyLint的全语言解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 pyecharts 项目开发协作指南：为 Agent 与开发者准备的构建、测试与代码规范全解
数据可视化图表库【免费下载链接】pyecharts Python Echarts Plotting Library项目地址https://gitcode.com/gh_mirrors/py/pyecharts点击查看免费下载导读AGENTS.md 是 pyecharts 仓库中面向在代码库上工作的 Agent以及任何贡献者编写的协作规范集中定义了项目的测试/静态检查/格式化/构建命令全集、代码风格约束与开发工作流。本文以该文档为主体结合仓库中的 Makefile、setup.py、pyproject.toml、test.py 与 test/ 测试用例等源码证据进行纵深解读。读完本文你将掌握在 pyecharts 仓库中如何正确运行单测与覆盖率统计、如何按团队规范编写可合入的代码导入、命名、异常处理、Google 风格 docstring、以及从改代码到提交的完整开发闭环。一、构建 / 静态检查 / 测试命令总览AGENTS.md 指出项目同时使用 pytest 与 nose2 两套测试框架并建议运行单个测试时优先使用 pytest见文档 Additional Notes 一节该结论同样可以从 test.py 中同时串联执行两种框架得到印证。1. 运行全部测试文档给出了四种等价的全量测试入口make test # 或 python test.py # 或 nose2 --with-coverage --coverage pyecharts --coverage-config .coveragerc -s test # 或 pytest -cov-config.coveragerc --cov./ test/make test是仓库推荐的统一入口。查看 Makefile 可以发现其真实执行体为uv run pytest -v --cov-configpyproject.toml --cov./ test/——即通过 uv 管理环境并调用 pytest以pyproject.toml中的[tool.coverage.run]作为覆盖率配置omit 掉pyecharts/render/templates/*、setup.py、install.py、test.py、test/*等非被测对象。python test.py是仓库自带的便捷脚本其内部通过os.system(...)依次执行 nose2--coverage pyecharts --coverage-config .coveragerc -s test、pytest-cov-config.coveragerc --cov./ test/以及 flake8 静态检查即一次脚本同时跑两套测试框架 代码检查。nose2与pytest两条裸命令分别对应上述两套框架的等价写法二者都显式引用.coveragerc.coveragerc 中配置了与 pyproject.toml 一致的 omit 规则与show_missing True报告选项。2. 运行单个测试文件# 使用 pytest推荐 pytest test/test_chart.py # 使用 nose2 nose2 --with-coverage --coverage pyecharts --coverage-config .coveragerc test.test_chart注意两种框架对测试文件路径的写法差异pytest 接受文件系统路径test/test_chart.pynose2 则接受模块路径test.test_chart点号分隔、无.py后缀。以 test/test_chart.py 为例该文件基于unittest.TestCase组织测试类内含test_chart_dark_mode、test_chart_line_style_opts、test_chart_split_line_style_opts等方法。3. 运行特定测试方法# 使用 pytest pytest test/test_chart.py::TestChartClass::test_chart_dark_mode # 使用 nose2 nose2 --with-coverage --coverage pyecharts --coverage-config .coveragerc test.test_chart.TestChartClass.test_chart_dark_modepytest 用双冒号::逐级定位文件::类::方法nose2 用点号逐级定位模块.类.方法。这种精确到方法的粒度非常适合在开发中快速复现单个失败用例。4. 带 verbose 输出的测试pytest -v test/test_chart.py-v会让 pytest 逐条打印每个测试用例的名称与 PASS/FAIL 状态便于定位具体失败方法。5. 带覆盖率报告的测试pytest -v --cov./ --cov-reporthtml test/test_chart.py--cov./指定对整个仓库根目录做覆盖率统计--cov-reporthtml生成可浏览器查看的 HTML 覆盖率报告。若仅需命令行摘要可将--cov-reporthtml替换为--cov-reportterm这也是 pytest-cov 的默认行为。6. 静态检查Lintingmake lint # 或 flake8 --excludebuild,images,example,examples --max-line-length89 --ignoreF401查看 Makefile 可知make lint实际执行uv run flake8 --excludebuild,images,example,examples,.venv --max-line-length89 --ignoreF401,F824其中新增了对.venv的排除以及 F824 忽略。flake8 的裸命令以--max-line-length89强制行宽上限与文档 Code Style 一节一致--ignoreF401忽略导入未使用告警该规则与下方导入别名实践相关部分导入仅为保持 API 可访问性而存在。若只想检查某个文件把路径追加到命令末尾即可例如flake8 --excludebuild,images,example,examples --max-line-length89 --ignoreF401 test/test_chart.py7. 代码格式化black . isort .仓库明确采用 black isort 组合black 负责统一代码排版isort 负责整理 import 顺序。二者版本由 requirements-dev.txt 锁定black24.3.0、isort4.3.16在 CI/协作环境中应使用该文件固定版本避免格式漂移。8. 构建与发布python setup.py sdist bdist_wheel make uploadpython setup.py sdist bdist_wheel基于 setup.py 构建源码包sdist与 wheel 包。setup.py 中通过exec读取 pyecharts/_version.py 获取版本号声明了jinja2、prettytable、simplejson三个运行时依赖并提供可选依赖组seleniumsnapshot-selenium、phantomjssnapshot-phantomjs、pyppeteersnapshot-pyppeteer、imagesPIL/Pillow这些与文档JavaScript 依赖通过 Base 类的 js_dependencies 属性管理属于不同维度的依赖体系。make upload在 Makefile 中并未直接定义而是依赖 setup.py 中的cmdclass{upload: UploadCommand}setup.py 顶部注释写明# $ python setup.py upload。查看 setup.py 中UploadCommand.run()的实现可知该命令会依次清理 dist/build/egg-info → 调用setup.py sdist bdist_wheel重新构建 → 通过twine upload dist/*发布到 PyPI → 打v{version}的 git 标签并推送。注意它依赖本机已安装 twine 且已配置 PyPI 凭据仅限维护者发布流程使用。二、代码风格指南1. 导入组织与别名文档要求 import 按标准库 → 第三方库 → 本地应用库三段式组织并给出正反示例# 推荐 from pyecharts import options as opts from pyecharts.charts import Line, Bar # 避免 from pyecharts.options import * import pyecharts.charts.Line同时建议为高频模块使用别名import pyecharts.options as opts import pyecharts.globals as globals这一惯例在仓库源码中随处可见例如 pyecharts/charts/chart.py 首行即from .. import options as optstest/test_chart.py 也遵循from pyecharts import options as opts、from pyecharts.charts import Line, Bar的写法。这解释了 flake8 命令为何--ignoreF401——存在仅为别名可达性而导入的合法场景。2. 排版规范行宽上限 89 字符flake8--max-line-length89强制当前项目配置在 pyproject.toml 与 Makefile 中均可复现。缩进 4 空格禁止 Tab。字符串使用双引号字符字面量使用单引号。这与 black 默认风格一致。空行规则顶层函数与类之间空 2 行类内方法之间空 1 行PEP 8 标准。最终以black .兜底保证全库一致。3. 命名约定对象风格示例变量 / 函数snake_casedef add_yaxis(self, series_name, y_axis, *args, **kwargs): pass类PascalCaseclass TestChartClass(unittest.TestCase): pass常量UPPER_CASEMAX_RETRIES 3私有成员下划线前缀def _internal_method(self): pass从源码看pyecharts/charts/base.py 中的self.js_dependencies: utils.OrderedSet、pyecharts/charts/chart.py 中的self._chart_type: Optional[str] None均为该规范的实际落地公开 API 使用 snake_case内部状态使用_前缀。4. 错误处理文档明确三条原则用异常表达错误不用返回码异常类型要具体示例中分别捕获ValueError与RuntimeError并先记录日志再raise传播禁止无差别捕获except:pass属于反模式应改为捕获具体异常类型。这一约定与仓库 pyecharts/exceptions.py 提供的专用异常体系相呼应调用方可按具体异常类型精确处理。5. 测试指南结构基于unittest框架 TestCase类组织把相关测试聚合成类方法名使用描述性命名。仓库 test/test_chart.py 中class TestChartClass(unittest.TestCase)即为此范式。命名test_前缀 被测特性例如test_chart_dark_mode、test_chart_line_style_opts从命名即可判断测试目标。Mock 外部依赖文档示例用patch(pyecharts.render.engine.write_utf8_html_file)打桩 HTML 写盘函数避免测试产生真实文件。仓库测试大量采用此模式例如 test/test_chart.py 中test_chart_dark_mode断言渲染内容里包含darkMode从而在不落盘的情况下验证set_dark_mode()正确写入了 ECharts 配置。覆盖率目标追求高覆盖率同时覆盖成功路径、失败路径与边界情况。仓库通过.coveragerc与pyproject.toml的[tool.coverage.run]排除模板与安装脚本等不可测文件保证统计结果聚焦真实业务代码。6. 文档规范Google 风格 docstring方法 docstring 应包含Args、Returns、Raises三节按需出现def add_yaxis(self, series_name, y_axis, colorNone): Add a series to the chart. Args: series_name (str): Name of the series. y_axis (list): Data values. color (str, optional): Color of the series. Defaults to None. Returns: Chart: The chart instance for method chaining. 注释原则解释为什么而非是什么并随代码变更保持同步。仓库中 pyecharts/charts/chart.py 的set_dark_mode()注释# [Hard Code Here] The Echarts default Dark Mode Configurations即为解释动机的典型注释。7. 最佳实践方法链Method Chaining修改对象的方法应return self。源码佐证set_dark_mode()见 pyecharts/charts/chart.py末尾return self、add_xaxis()pyecharts/charts/basic_charts/custom.py均遵循该约定使Line().add_xaxis(...).add_yaxis(...).render()式链式调用成为可能。类型提示公开方法建议标注参数与返回类型如def add_yaxis(self, series_name: str, y_axis: list) - Base。仓库广泛使用 pyecharts/types.py 中的Optional、Sequence等类型别名如 pyecharts/charts/chart.py 中dark_mode_colors: Optional[Sequence[str]]。选项对象不可变性修改 options 时不得改动原始对象应deepcopy或dict(old_opts)生成副本后再写回。这与 options 体系pyecharts/options/配置对象可被多个图表复用的设计一致。性能意识处理大数据集时注意性能。可参考 pyecharts/datasets/ 下数据集的加载方式与渲染管线。向后兼容任何改动都需考虑既有用户避免破坏已公开的 API 签名。三、标准开发工作流AGENTS.md 给出了从改动到提交的五步闭环改代码跑测试验证无回归make test静态检查make lint格式化black .与isort .提交并推送。实际执行时建议按格式化 → 测试 → lint的顺序微调先格式化可减少因格式导致的失败噪音在提交前也可用pytest -v --cov./ --cov-reporthtml test/test_chart.py对改动模块做定向验证。四、附加说明与仓库特性速查AGENTS.md 末尾罗列了与协作直接相关的项目事实逐条结合仓库核实如下双测试框架pytest 与 nose2 并行支持运行单个用例优先 pytesttest.py 与文档命令均可验证。覆盖率配置.coveragerc与pyproject.toml的[tool.coverage.run]均排除测试文件与模板pyecharts/render/templates/*报告开启show_missing True。构建流程由 setup.py 定义内置UploadCommand负责 PyPI 发布python setup.py upload发布前会清理旧构建产物并打 git 版本标签。JavaScript 依赖管理通过Base类的js_dependencies属性管理pyecharts/charts/base.py 中self.js_dependencies: utils.OrderedSet utils.OrderedSet(echarts)地图、词云、液体填充等扩展图会向该集合追加对应依赖如echarts-liquidfillpyecharts/charts/basic_charts/liquid.py、echarts-wordcloudpyecharts/charts/basic_charts/wordcloud.py、echarts-glpyecharts/charts/three_axis_charts/ 及 pyecharts/charts/chart.py 的add_schema路径等。默认语言默认中文ZH可切换为英文EN对应 pyecharts/globals.py 中的语言/主题等全局常量。深色模式通过set_dark_mode()开启。结合 pyecharts/charts/chart.py 的实现可知默认背景色#100C2A默认配色为 9 色的 ECharts Dark 色板#4992ff #7cffb2 #fddd60 #ff6e76 #58d9f9 #05c091 #ff8a45 #8d48e3 #dd79ff同时将darkModeTrue写入 options 并把self.theme切换为ThemeType.DARKtest/test_chart.py 中的test_chart_dark_mode正是通过断言渲染内容包含darkMode来回归此功能。渲染方式render()生成 HTML 文件render_embed()输出可嵌入页面的图表内容对应 pyecharts/charts/base.py 中render/render_embed方法及 pyecharts/render/ 渲染引擎与 Jinja2 模板体系。结语AGENTS.md 虽然名为面向 Agent 的说明文件实质上是 pyecharts 仓库最浓缩的工程规范手册它把测试矩阵、代码风格、提交流程与关键架构事实js_dependencies、深色模式、双框架、构建发布收敛在一份可执行、可检查、可回归的文档里。无论是人类贡献者还是自动化 Agent遵循本文梳理的命令与规范即可在 test/ 测试体系、pyecharts/ 源码结构与 pyproject.toml 配置之间保持一致、可验证的协作基线。赞分享数据可视化图表库【免费下载链接】pyecharts Python Echarts Plotting Library项目地址https://gitcode.com/gh_mirrors/py/pyecharts点击查看免费下载相关推荐Orchard Core 开发全指南Agent 协作、构建测试、编码规范与扩展点详解Orchard Core 开发全指南Agent 协作、构建测试、编码规范与扩展点详解 导读 本文以 Orchard Core 仓库根目录下的 AGENTS.CMS后端Web框架猫抓(cat-catch)免费网页视频下载怎么做完整指南一次讲清猫抓 cat catch 免费网页视频下载怎么做完整指南一次讲清 讲座回放只在网页播放器里播右键被禁用页面上翻不到任何下载入口——文件其实一直在那里只音视频四步写好自己的 Stitch 技能SKILL.md 完整拆解指南四步写好自己的 Stitch 技能SKILL.md 完整拆解指南 stitch skills 技能库能让 Claude Code、Cursor、GeminiAI 技能AI 插件上一篇告别单调文档Slate主题配色终极指南让API文档颜值飙升下一篇终极代码规范自动化指南从cpplint到PyLint的全语言解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考