MemRelay/projects/d1932ed6-07d3-4463-a224-8534ffd69a07/deploy.py - manage.py 兼容 Python 3.6 的改法与陷阱.md

title, type, permalink, stable_id, scope, memory_type, project_id, usage_profile_id, status, revision, request_id, created_at, updated_at, tags

title	type	permalink	stable_id	scope	memory_type	project_id	usage_profile_id	status	revision	request_id	created_at	updated_at	tags
deploy.py / manage.py 兼容 Python 3.6 的改法与陷阱	experience	main/projects/d1932ed6-07d3-4463-a224-8534ffd69a07/deploy.py-manage.py-兼容-python-3.6-的改法与陷阱	df7b18f9-490f-415f-a388-2332d1b7df87	project	experience	d1932ed6-07d3-4463-a224-8534ffd69a07	7aee455b-24cc-4008-bdaf-443721e6f939	active	1	nextoffice-20260903-py36-compat-experience	2026-09-03T01:43:00.310820+00:00	2026-09-03T01:43:00.310820+00:00	nextoffice python36 compatibility deploy manage.py

背景：目标服务器 CentOS 8 系统 Python 仅 3.6.8，原脚本在其上直接 SyntaxError。提交 27fc41b 完成兼容，并在真实 3.6.8 上验证。

必须改的点（以后新代码也要守）：

• 不能用 from __future__ import annotations（3.7+）；因此函数参数/返回注解会在定义时求值，不能用 PEP 585/604 写法（dict[str,str]、str | None），改用 typing.Dict/Optional/Union/Tuple/FrozenSet。局部变量注解不求值，但统一改成 x = {} # type: Dict[...] 注释形式。
• subprocess.CompletedProcess[str] 不可下标（3.9+），去掉 [str]。
• subprocess.run(text=True) 是 3.7+，改 universal_newlines=True；cwd 传 str(ROOT)。
• Path.write_text(newline=...) 是 3.10+，改 with path.open('w', encoding='utf-8', newline='\n')。
• argparse.add_subparsers(required=True) 是 3.7+，去掉 required，在 main() 中 if not hasattr(args, 'func'): parser.print_help(); return 2。
• f-string、secrets、ipaddress、pathlib、dict 有序（CPython 3.6 实际有序）均可用。

验证方法：本地高版本 Python 用 ast.parse(src, feature_version=(3, 6)) 先拦语法；但运行时 API 差异（text=、newline=、required=）只能靠真实 3.6 跑：把 mock 了 docker/occ 的行为测试脚本 sftp 到服务器 /tmp 用系统 python3 执行。manage.py 现从 deploy 导入 write_env，reconfigure 与安装共用 .env 写入（含 chmod 600）。