synapse-cli-agent 0.1.24__tar.gz → 0.1.25__tar.gz

{synapse_cli_agent-0.1.24 → synapse_cli_agent-0.1.25}/CHANGELOG.md

@@ -7,6 +7,22 @@ The release workflow automatically extracts the matching section as release note
 
 ---
 
+## v0.1.25
+
+### 新增功能
+
+- `synapse-web` 新增 `--public-url` 参数：指定 `textual-serve` 生成的页面 WebSocket 与静态资源地址，支持 nginx/TLS 反向代理场景（`https://` 自动推导 `wss://`）。
+
+### 修复
+
+- 修复容器经 nginx 反向代理后页面内 WebSocket/静态资源地址使用 `http://<host>:<port>` 导致浏览器无法连接的问题。
+
+### 工程改进
+
+- Docker 部署文档补充容器仅绑定回环端口 + nginx 443 反代的配置示例。
+
+---
+
 ## v0.1.24
 
 ### 新增功能

{synapse_cli_agent-0.1.24 → synapse_cli_agent-0.1.25}/Dockerfile.web

@@ -15,7 +15,7 @@ ARG SYNAPSE_MODE=pypi
 
 # pypi mode: install the released wheel and its dependencies from PyPI.
 FROM python:3.12-slim AS pypi
-ARG SYNAPSE_VERSION=0.1.23
+ARG SYNAPSE_VERSION=0.1.25
 RUN pip install --no-cache-dir --disable-pip-version-check \
     "synapse-cli-agent==${SYNAPSE_VERSION}"
 

{synapse_cli_agent-0.1.24 → synapse_cli_agent-0.1.25}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synapse-cli-agent
-Version: 0.1.24
+Version: 0.1.25
 Summary: Local coding agent built on LangChain Deep Agents (LocalShell, no sandbox)
 Project-URL: Homepage, https://github.com/alex8224/synapse-agent
 Project-URL: Repository, https://github.com/alex8224/synapse-agent

{synapse_cli_agent-0.1.24 → synapse_cli_agent-0.1.25}/docs/docker-web.md

@@ -83,3 +83,41 @@ http://<gateway1-ip>:8000
 - 每个浏览器标签页对应一个独立的 TUI 子进程。
 - agent 的工具执行都发生在容器内，适合作为沙箱隔离。
 - 容器以非 root 用户 `synapse` 运行，镜像只暴露 `8000` 端口。
+
+## 通过 nginx 443 反向代理
+
+容器不应直接监听公网。推荐让容器只绑定本机回环地址，由 nginx 承担 TLS 与公网入口：
+
+```bash
+docker run --rm -d --name synapse-web \
+  -p 127.0.0.1:8000:8000 \
+  -v "$PWD:/workspace" \
+  synapse-web \
+  --host 127.0.0.1 --port 8000 \
+  --public-url https://synapse-agent.best/tui
+```
+
+`--public-url` 是必须的：`textual-serve` 用它生成页面中的 WebSocket 与静态资源
+地址。不设置时默认使用 `http://<host>:<port>`，经 nginx 反代后浏览器无法连接。
+`https://` 前缀会自动推导出 `wss://`。
+
+nginx 站点中为 Web TUI 增加一个路径并转发到回环端口（需支持 WebSocket 升级）：
+
+```nginx
+location /tui/ {
+    proxy_pass http://127.0.0.1:8000/;
+    proxy_http_version 1.1;
+    proxy_set_header Upgrade $http_upgrade;
+    proxy_set_header Connection "upgrade";
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-IP $remote_addr;
+    proxy_set_header X-Forwarded-Proto $scheme;
+    proxy_read_timeout 86400;
+}
+```
+
+重载配置后访问：
+
+```text
+https://synapse-agent.best/tui
+```

{synapse_cli_agent-0.1.24 → synapse_cli_agent-0.1.25}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "synapse-cli-agent"
-version = "0.1.24"
+version = "0.1.25"
 description = "Local coding agent built on LangChain Deep Agents (LocalShell, no sandbox)"
 readme = "README.md"
 license = { file = "LICENSE" }

synapse_cli_agent-0.1.25/release_body.md

@@ -0,0 +1,15 @@
+## v0.1.25
+
+### 新增功能
+
+- `synapse-web` 新增 `--public-url` 参数：指定 `textual-serve` 生成的页面 WebSocket 与静态资源地址，支持 nginx/TLS 反向代理场景（`https://` 自动推导 `wss://`）。
+
+### 修复
+
+- 修复容器经 nginx 反向代理后页面内 WebSocket/静态资源地址使用 `http://<host>:<port>` 导致浏览器无法连接的问题。
+
+### 工程改进
+
+- Docker 部署文档补充容器仅绑定回环端口 + nginx 443 反代的配置示例。
+
+---

{synapse_cli_agent-0.1.24 → synapse_cli_agent-0.1.25}/src/synapse/web.py

@@ -29,6 +29,15 @@ def build_parser() -> argparse.ArgumentParser:
         default=None,
         help="Workspace directory passed to the TUI (default: current dir)",
     )
+    parser.add_argument(
+        "--public-url",
+        default=None,
+        help=(
+            "External URL (scheme://host[:port][/path]) used in the served page "
+            "for WebSocket/static links. Required when behind an nginx/TLS "
+            "reverse proxy; otherwise derived from --host/--port."
+        ),
+    )
     return parser
 
 
@@ -46,6 +55,7 @@ def main(argv: list[str] | None = None) -> None:
         build_command(args.workspace),
         host=args.host,
         port=args.port,
+        public_url=args.public_url,
     )
     server.serve()
 

{synapse_cli_agent-0.1.24 → synapse_cli_agent-0.1.25}/uv.lock

@@ -2242,7 +2242,7 @@ wheels = [
 
 [[package]]
 name = "synapse-cli-agent"
-version = "0.1.24"
+version = "0.1.25"
 source = { editable = "." }
 dependencies = [
     { name = "aiosqlite" },

synapse_cli_agent-0.1.24/release_body.md

@@ -1,14 +0,0 @@
-## v0.1.24
-
-### 新增功能
-
-- 新增 `synapse-web` 控制台入口（`synapse.web:main`）：无需源码即可通过安装的 wheel 启动 Web TUI，支持 `--host`、`--port`、`--workspace` 参数。
-- 新增 `Dockerfile.web` 最小镜像：基于 `python:3.12-slim`，无 Rust 工具链，运行时依赖全部通过预编译 wheel 安装；支持 `pypi`（从 PyPI 安装发布版本）与 `local`（安装构建上下文中的本地 wheel）两种构建模式。
-- 新增 `.dockerignore` 与 Docker 部署文档（`docs/docker-web.md`），包含远程机器构建、运行、端口映射与 `/workspace` 数据持久化说明。
-
-### 工程改进
-
-- `scripts/serve_web.py` 改为 `synapse.web` 的兼容薄包装。
-- 文档导航新增 Docker Web TUI 页面。
-
----