Python开发API文档生成完整流程提示词

角色定义与任务定位

请您以“技术可视化架构师”或“开发流程设计师”的身份展开创作。您的核心目标不是编写代码，而是将“Python开发API文档生成”这一技术流程，转化为一套清晰、具有视觉冲击力且可直接用于图像生成（如AI绘画、概念图设计）的提示词方案，从而直观地展示从代码到文档的完整专业链路。

适用场景

• 为技术博客、教程文章配图，可视化文档生成流程。
• 制作开发工具或API平台的概念介绍与宣传材料。
• 设计内部技术培训或工作坊的视觉演示幻灯片。
• 创建开发方法论或最佳实践的可视化指南。

核心提示词

• 基础组合：A professional flowchart, Python developer generating API documentation, clean modern office desk with dual monitors, code on one screen, beautiful API docs on the other.
• 流程可视化：Step-by-step infographic showing process: writing Python code with docstrings -> running automation tool (Sphinx, Swagger) -> generating interactive API documentation page.
• 工具特写：Close-up of a developer’s hands typing, with visual icons floating above: a Python logo, a Swagger/OpenAPI icon, a book or documentation icon, connected by glowing lines.

风格方向

• 专业极简：Clean, corporate tech style, muted color palette (深蓝、灰、白、点缀亮绿或橙色)，扁平化图标，充足留白。
• 科技感插画：Isometric 3D illustration, depicting a pipeline from code blocks to a polished documentation portal, with soft shadows and gradient colors.
• 暗色模式：Dark theme interface, glowing code syntax highlighting (Monokai or One Dark theme), neon accents to highlight the documentation output.

构图建议

• 中心流程构图：将Python代码文件、终端命令窗口、文档生成工具图标、最终API文档网页作为四个核心节点，从左至右水平排列，用箭头或光纤连接，形成清晰动线。
• 对角线分割：画面左上角为写满代码的IDE界面，右下角为渲染精美的API文档网页，中间区域用半透明的工具图标或流程图元素过渡。
• 第一人称视角：从开发者背后视角拍摄，焦点在前方屏幕，屏幕上正从代码自动渲染出文档，营造沉浸式体验。

细节强化

• 代码细节：在代码编辑器中显示带有清晰docstring的Python函数（如使用Flask或FastAPI框架），docstring中包含参数、返回值和示例。
• 文档输出：最终生成的文档应具有交互式元素，如“Try it out”按钮、可折叠的端点列表、清晰的请求/响应模型示例。
• 环境氛围：桌上散落着现代极简的办公用品（咖啡杯、笔记本），背景是模糊的绿植或书架，营造专注、专业的开发环境。
• 动态元素：可添加微妙的动态效果，如从代码文件流向文档页面的粒子流，或终端中滚动的生成日志。

使用建议

• 生成图像时，可将“核心提示词”中的句子组合使用，并添加选定的“风格方向”与“细节强化”中的关键词，以获得更精确的结果。
• 示例组合提示词：”An isometric 3D infographic, professional Python API documentation generation workflow, from code with docstrings to Swagger UI output, dark theme with glowing blue accents, clean and detailed –v 6.0″
• 优先在提示词中明确指定工具（如Sphinx, FastAPI, Swagger UI, Postman）和输出格式（如HTML, PDF, interactive web page），以提升图像的专业度和准确性。
• 本方案同样适用于构思技术示意图、PPT图表，只需根据“构图建议”调整对场景和元素的描述即可。