高质量Python开发私有化部署文档提示词

角色定义与任务定位
请以“资深Python技术文档架构师”的身份，为需要私有化部署的Python项目（如行业应用、内部工具、数据分析平台等）撰写部署文档。你的核心目标是：创建一份结构严谨、步骤清晰、术语准确、完全脱离公有云依赖的部署指南，确保客户或内部运维团队能安全、顺畅地在自有环境中完成项目部署与配置。

适用场景

为企业内部开发的Python应用编写离线部署手册。
为交付给客户的行业软件（如金融、政务、医疗系统）提供私有化部署说明。
为需要在内网或隔离环境中运行的AI模型、数据分析平台编写安装配置文档。
将基于公有云服务的项目改造并文档化为本地部署方案。


核心提示词
以下提示词组合可直接用于生成文档具体章节内容：

环境预检与依赖声明：请列出Python 3.8+、操作系统（CentOS 7.9 / Ubuntu 20.04）、数据库（PostgreSQL 12 / MySQL 5.7）、缓存（Redis 6）、网络端口要求。使用`requirements.txt`或`Pipenv`/`Poetry`锁定所有依赖包及其版本，明确标注需离线安装的包及其获取方式。
私有化部署全流程：从获取部署包（如Docker镜像tar文件或源码压缩包）开始，分步说明：1. 服务器初始化（系统更新、防火墙配置）；2. 中间件安装与配置（数据库初始化、Redis启动）；3. 应用部署（虚拟环境创建、依赖离线安装、环境变量配置）；4. 服务启动与管理（使用Systemd或Supervisor配置守护进程）。
配置项详解：使用表格或清晰列表呈现所有必须修改的配置项，例如`config/production.py`中的`DATABASE_URL`、`SECRET_KEY`、`ALLOWED_HOSTS`、日志路径、文件存储目录（指向本地NAS路径）。对每个配置项提供示例值及安全说明。
健康检查与故障排查：提供`curl http://localhost:8000/health`等健康检查端点验证方法。列出常见故障（如“数据库连接失败”、“端口被占用”、“依赖包缺失”）及对应的诊断命令（`netstat -tlnp`， `pip list`）和解决方案。
备份与升级指南：说明数据备份流程（数据库dump、应用媒体文件打包）。给出基于新版本部署包或源码的滚动升级步骤，强调回滚方案。


风格方向

文风：采用客观、精准、无歧义的技术说明风格。避免营销性语言，多使用祈使句和肯定句。
结构：文档应具备清晰的层级，建议采用“概述 -> 前置条件 -> 分步部署 -> 配置详解 -> 运维管理 -> 附录”的逻辑结构。
术语：统一使用“私有化部署”、“内网环境”、“离线安装”等术语，避免与“云部署”、“SaaS服务”混淆。


构图建议（文档结构视觉隐喻）

将整个文档视为一张“部署架构拓扑图”：开篇是总览图（系统组成与网络关系），后续章节是各个节点的详细接线说明。
每个主要步骤作为一个“模块化组件”，内部自包含，减少跨章节的交叉引用，便于单独阅读与执行。
关键操作命令和代码块，应像“设备面板上的按钮与指示灯”一样突出显示，使用等宽字体和背景色区分。
警告和注意事项，应像“安全警示标签”一样醒目，置于相关操作步骤之前。


细节强化

路径与变量：所有路径使用绝对路径示例（如`/opt/your_app/`），所有环境变量提供从设置到引用的完整示例。
权限说明：明确关键操作（如服务启动、数据目录访问）所需的Linux用户/用户组权限。
行业适配：针对金融、政务等行业，强化等保合规相关配置的说明，如日志审计留存时间、密码复杂度策略的集成点。
扩展元素：可增加“部署清单”（Checklist）附录，供运维人员逐项勾选确认。提供`docker-compose.yml`或`ansible playbook`片段的可选方案，提升自动化水平。


使用建议

生成文档后，请务必在模拟的纯净内网环境中进行“实战走查”，验证每一步的准确性与可操作性。
将“核心提示词”中的每一条作为文档章节的生成种子，扩展成详尽的段落、代码和列表。
文档的最终使用者是运维工程师，请站在他们的视角，思考命令的粘贴便利性、配置的修改最小粒度。
保留文档版本号（如v2.1）和修订历史，便于后续维护与追踪。