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

synapse_cli_agent-0.1.25/.dockerignore

@@ -0,0 +1,15 @@
+.git
+.venv
+site/
+__pycache__/
+*.py[oc]
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+large_tool_results/
+conversation_history/
+landing/
+logs/
+*.egg-info

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

@@ -7,6 +7,37 @@ 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-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 页面。
+
+---
+
 ## v0.1.23
 
 ### 新增功能

synapse_cli_agent-0.1.25/Dockerfile.web

@@ -0,0 +1,40 @@
+# Minimal image for running the Synapse Web TUI via textual-serve.
+# No Rust toolchain: every runtime dependency installs from prebuilt wheels.
+#
+# Build (installs the published wheel from PyPI):
+#   docker build -f Dockerfile.web -t synapse-web .
+#
+# Build (installs a local prebuilt wheel copied into the build context):
+#   docker build -f Dockerfile.web --build-arg SYNAPSE_MODE=local -t synapse-web .
+#
+# Run (mount a workspace for the agent and publish the web port):
+#   docker run --rm -p 8000:8000 -v "$PWD:/workspace" synapse-web
+#   # then open http://<host>:8000
+
+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.25
+RUN pip install --no-cache-dir --disable-pip-version-check \
+    "synapse-cli-agent==${SYNAPSE_VERSION}"
+
+# local mode: install a locally built wheel from the build context (dist/).
+FROM python:3.12-slim AS local
+COPY dist/ /tmp/dist/
+RUN pip install --no-cache-dir --disable-pip-version-check /tmp/dist/*.whl
+
+FROM ${SYNAPSE_MODE} AS runtime
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1
+
+# Run as an unprivileged user.
+RUN useradd --create-home --uid 1000 synapse
+USER synapse
+WORKDIR /workspace
+
+EXPOSE 8000
+
+ENTRYPOINT ["synapse-web"]
+CMD ["--host", "0.0.0.0", "--port", "8000"]

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synapse-cli-agent
-Version: 0.1.23
+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.25/docs/docker-web.md

@@ -0,0 +1,123 @@
+# Docker 中运行 Web TUI
+
+把 Synapse Web TUI 以 Docker 容器作为沙箱运行：浏览器通过 WebSocket 连接
+`textual-serve`，服务端为每个浏览器会话启动一个 `synapse tui` 子进程。
+
+镜像不包含 Rust 工具链，运行时依赖全部通过预编译 wheel 安装，只依赖
+`python:3.12-slim` 基础镜像，镜像体积最小。
+
+## 入口
+
+Web 启动器已作为包内模块和独立控制台命令提供：
+
+- `synapse.web`（`python -m synapse.web`）
+- `synapse-web`（wheel 安装后直接可用）
+
+```powershell
+synapse-web --host 0.0.0.0 --port 8000
+```
+
+源码仓库中的 `scripts/serve_web.py` 保留为兼容薄包装，行为一致。
+
+## 镜像构建
+
+### 方式一：从 PyPI 安装发布版本
+
+```bash
+docker build -f Dockerfile.web -t synapse-web .
+```
+
+默认使用 `pypi` 模式，从 PyPI 安装 `synapse-cli-agent==0.1.23` 及其依赖
+（包括已有预编译 wheel 的 `synapse-core-tool`）。
+
+如需指定版本：
+
+```bash
+docker build -f Dockerfile.web \
+  --build-arg SYNAPSE_VERSION=0.1.23 \
+  -t synapse-web .
+```
+
+### 方式二：安装本地构建的 wheel
+
+先把本地 wheel 放入构建上下文 `dist/`，然后使用 `local` 模式：
+
+```bash
+docker build -f Dockerfile.web --build-arg SYNAPSE_MODE=local -t synapse-web .
+```
+
+## 在远程机器上构建
+
+```bash
+# 在远程机器 root@gateway1 上执行
+scp Dockerfile.web root@gateway1:/tmp/synapse/
+ssh root@gateway1
+cd /tmp/synapse
+docker build -f Dockerfile.web -t synapse-web .
+```
+
+## 运行
+
+```bash
+docker run --rm -d --name synapse-web \
+  -p 8000:8000 \
+  -v "$PWD:/workspace" \
+  synapse-web
+```
+
+然后浏览器访问：
+
+```text
+http://<gateway1-ip>:8000
+```
+
+`/workspace` 是 agent 的工作目录，也是配置（`.synapse/`）和会话数据的落盘位置，
+通过 volume 挂载到宿主机即可持久化。
+
+## 行为说明
+
+- `synapse-web` 进程常驻，负责 HTTP 页面和 WebSocket。
+- 浏览器每次刷新会断开旧 WebSocket 并建立新连接，服务端会重新启动一个
+  `synapse tui` 子进程；界面与内存状态会重置，但会话、配置和主题等持久化
+  数据仍从 `/workspace` 恢复。
+- 每个浏览器标签页对应一个独立的 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.23 → synapse_cli_agent-0.1.25}/mkdocs.yml

@@ -55,4 +55,5 @@ nav:
   - 会话管理: sessions.md
   - Skills 插件: skills.md
   - 权限与安全: permissions.md
-  - 原生核心工具: native-core-tool.md
+  - 原生核心工具: native-core-tool.md
+  - Docker Web TUI: docker-web.md

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

@@ -1,6 +1,6 @@
 [project]
 name = "synapse-cli-agent"
-version = "0.1.23"
+version = "0.1.25"
 description = "Local coding agent built on LangChain Deep Agents (LocalShell, no sandbox)"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -41,6 +41,7 @@ Changelog = "https://github.com/alex8224/synapse-agent/blob/main/CHANGELOG.md"
 
 [project.scripts]
 synapse = "synapse.cli:main"
+synapse-web = "synapse.web:main"
 
 [project.optional-dependencies]
 dev = [

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.25/scripts/serve_web.py

@@ -0,0 +1,12 @@
+"""Compatibility launcher for ``synapse.web``.
+
+Usage:
+    uv run --no-sync python scripts/serve_web.py [--host HOST] [--port PORT]
+"""
+
+from __future__ import annotations
+
+from synapse.web import main
+
+if __name__ == "__main__":
+    main()

synapse_cli_agent-0.1.25/src/synapse/web.py

@@ -0,0 +1,64 @@
+"""Serve the Synapse Textual TUI in a web browser via textual-serve.
+
+The TUI keeps running as a server-side process; the browser renders it
+through xterm.js over a WebSocket (same Python code, zero changes).
+
+This module is also the ``synapse-web`` console-script entry point so the
+packaged wheel can start the web server without any source checkout:
+
+    synapse-web --host 0.0.0.0 --port 8000
+"""
+
+from __future__ import annotations
+
+import argparse
+import sys
+
+from textual_serve.server import Server
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="synapse-web",
+        description="Serve the Synapse TUI in a web browser",
+    )
+    parser.add_argument("--host", default="localhost", help="Bind host (default: localhost)")
+    parser.add_argument("--port", type=int, default=8000, help="Bind port (default: 8000)")
+    parser.add_argument(
+        "--workspace",
+        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
+
+
+def build_command(workspace: str | None = None) -> str:
+    """Command textual-serve spawns for each browser session."""
+    command = f'"{sys.executable}" -m synapse tui'
+    if workspace:
+        command += f' --workspace "{workspace}"'
+    return command
+
+
+def main(argv: list[str] | None = None) -> None:
+    args = build_parser().parse_args(argv)
+    server = Server(
+        build_command(args.workspace),
+        host=args.host,
+        port=args.port,
+        public_url=args.public_url,
+    )
+    server.serve()
+
+
+if __name__ == "__main__":
+    main()

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

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

synapse_cli_agent-0.1.23/release_body.md

@@ -1,19 +0,0 @@
-## v0.1.23
-
-### 新增功能
-
-- Rich Markdown 渲染接入 Synapse 主题系统：内置主题提供完整 Markdown 样式映射，支持标题、段落、强调、行内代码、引用、链接、列表和表格等元素跟随主题配色。
-- `themes.json` 支持通过独立的 `markdown` 字段覆盖 Markdown 元素的 Rich style，并支持主题继承与分层配置。
-- 运行时切换主题会重绘已显示的答案、思考内容和独立 Markdown 块；主题设计器保存主题时保留 Markdown 样式配置。
-
-### 修复
-
-- 修复 Rich Markdown 使用内置默认颜色、导致 Markdown 内容无法跟随 Synapse 主题切换的问题。
-- 修复主题设计器保存已有主题时可能丢失手写 Markdown 样式覆盖的问题。
-
-### 工程改进
-
-- 增加 Markdown 主题解析、Rich 样式注入、主题继承、运行时重绘和内置主题完整性测试。
-- 补充 Markdown 主题配置文档，并保留代码块使用 `code_theme` 控制语法高亮的边界说明。
-
----

synapse_cli_agent-0.1.23/scripts/serve_web.py

@@ -1,42 +0,0 @@
-"""Serve the Synapse Textual TUI in a web browser via textual-serve.
-
-The TUI keeps running as a server-side process; the browser renders it
-through xterm.js over a WebSocket (same Python code, zero changes).
-
-Usage:
-    uv run --no-sync python scripts/serve_web.py [--host HOST] [--port PORT]
-"""
-
-from __future__ import annotations
-
-import argparse
-import sys
-
-from textual_serve.server import Server
-
-
-def main() -> None:
-    parser = argparse.ArgumentParser(
-        description="Serve the Synapse TUI in a web browser"
-    )
-    parser.add_argument("--host", default="localhost", help="Bind host (default: localhost)")
-    parser.add_argument("--port", type=int, default=8000, help="Bind port (default: 8000)")
-    parser.add_argument(
-        "--workspace",
-        default=None,
-        help="Workspace directory passed to the TUI (default: current dir)",
-    )
-    args = parser.parse_args()
-
-    # Launch the TUI with the same interpreter that runs this script, so the
-    # subprocess inherits the venv without depending on any console script.
-    command = f'"{sys.executable}" -m synapse tui'
-    if args.workspace:
-        command += f' --workspace "{args.workspace}"'
-
-    server = Server(command, host=args.host, port=args.port)
-    server.serve()
-
-
-if __name__ == "__main__":
-    main()