Astrion
HEADLESS
这是 Astrion 的 API 后端实例，运行正常。
本实例以 headless 形态启动：只提供 Gateway / Runtime API
（供 CLI、桌面端、Android 等客户端使用），不包含 Web 界面。
如需 Web 界面，请改用 full 形态启动：
python -m server.app
Astrion headless backend · same runtime, API-only surface
"""
def create_headless_app() -> Flask:
"""创建 headless 形态的 Flask app（最小 API 路由面）。"""
app = Flask(__name__)
app.config['MAX_CONTENT_LENGTH'] = MAX_UPLOAD_SIZE
# Flask session 仍被 Bearer 通道的身份注入使用（请求内 session 对象），
# 必须配置 SECRET_KEY；解析规则与 full 形态一致。
_secret_key = os.environ.get("WEB_SECRET_KEY") or os.environ.get("SECRET_KEY")
if not _secret_key:
_secret_key = secrets.token_hex(32)
print(f"{OUTPUT_FORMATS['warning']} WEB_SECRET_KEY 未设置，已生成临时密钥（重启后所有会话将失效）。")
app.config['SECRET_KEY'] = _secret_key
app.config['PERMANENT_SESSION_LIFETIME'] = timedelta(hours=12)
app.config['SESSION_COOKIE_SAMESITE'] = os.environ.get("WEB_COOKIE_SAMESITE", "Strict")
app.config['SESSION_COOKIE_HTTPONLY'] = True
_cookie_secure_env = (os.environ.get("WEB_COOKIE_SECURE") or "").strip().lower()
app.config['SESSION_COOKIE_SECURE'] = _cookie_secure_env in {"1", "true", "yes"}
attach_security_hooks(app)
for _name, bp in HEADLESS_BLUEPRINTS:
app.register_blueprint(bp)
@app.route('/')
def headless_landing():
return _HEADLESS_LANDING_HTML
return app
def run_headless(path: str, thinking_mode: bool = False, port: int = DEFAULT_PORT, debug: bool = False):
"""初始化并以 headless 形态运行（与 full 形态共享初始化与后台任务）。"""
app = create_headless_app()
# 与 full 形态一致：同机多实例时 Cookie 按端口隔离，避免互相覆盖
app.config['SESSION_COOKIE_NAME'] = os.environ.get(
"WEB_SESSION_COOKIE_NAME", f"agents_session_{port}"
)
initialize_system(path, thinking_mode)
start_background_jobs()
app.run(
host=WEB_SERVER_HOST,
port=port,
debug=debug,
use_reloader=debug,
threaded=True,
)
def parse_arguments():
parser = argparse.ArgumentParser(description="Astrion headless backend (Gateway + Runtime, API-only)")
parser.add_argument(
"--path",
default=str(Path(DEFAULT_PROJECT_PATH).resolve()),
help="默认工作区路径（仅作兜底，工作区可在客户端中管理）",
)
parser.add_argument("--port", type=int, default=DEFAULT_PORT, help="监听端口")
parser.add_argument("--thinking-mode", action="store_true", help="启用思考模式")
parser.add_argument("--debug", action="store_true", help="调试模式")
return parser.parse_args()
def main():
args = parse_arguments()
print(f"{OUTPUT_FORMATS['info']} 以 headless 形态启动（仅 API 路由面，无 Web 界面）...")
run_headless(path=args.path, thinking_mode=args.thinking_mode, port=args.port, debug=args.debug)
if __name__ == "__main__":
main()