synapse-cli-agent 0.1.13__tar.gz → 0.1.15__tar.gz

{synapse_cli_agent-0.1.13 → synapse_cli_agent-0.1.15}/AGENTS.md

@@ -1,5 +1,27 @@
 # Synapse 项目协作指南
 
+## 用户信息
+- 姓名：肖前程
+- 年龄：35 岁
+- 职业：Java 程序员
+- 当前学习方向：Agent 应用开发
+- 主语言背景：Java → 正在学习 Python/LangChain Agent 生态
+
+## 用户信息
+- 姓名：肖前程
+- 年龄：35 岁
+- 职业：Java 程序员
+- 当前学习方向：Agent 应用开发
+- 主语言背景：Java → 正在学习 Python/LangChain Agent 生态
+
+## 约定
+- Python 依赖使用 `uv` 管理。
+- 优先小步、可测试的改动。
+- CLI 输出简洁，不使用 emoji。
+- 默认关闭人工审批（自动放行）；除非用户要求，不要自行加审批门槛。
+- Backend 仅使用 `LocalShellBackend`，无远程 sandbox。
+- 对用户回复与模型思考过程使用中文；代码标识符/路径/命令可保留原文。
+
 ## 当前仓库结构
 
 | 路径                               | 主要职责                                                 |

{synapse_cli_agent-0.1.13 → synapse_cli_agent-0.1.15}/CHANGELOG.md

@@ -7,6 +7,24 @@ The release workflow automatically extracts the matching section as release note
 
 ---
 
+## v0.1.15
+
+### 工程改进
+
+- 拆分 TUI transcript、工具组、待办清单、用户消息和 turn rail widget，缩小 `tui.py` 的职责范围。
+- 保留 `synapse.ui.tui` 的既有组件、格式化函数和 timeline 符号兼容导出。
+- 保持动态主题、流式展示、文本选择、复制与 turn rail 交互行为，并覆盖相关 TUI 回归测试。
+
+---
+
+## v0.1.14
+
+### 工程改进
+
+- PyPI 项目页增加主页、源代码仓库、问题追踪和变更日志链接。
+
+---
+
 ## v0.1.13
 
 ### 新功能

synapse_cli_agent-0.1.13/README.md → synapse_cli_agent-0.1.15/PKG-INFO

@@ -1,3 +1,38 @@
+Metadata-Version: 2.4
+Name: synapse-cli-agent
+Version: 0.1.15
+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
+Project-URL: Issues, https://github.com/alex8224/synapse-agent/issues
+Project-URL: Changelog, https://github.com/alex8224/synapse-agent/blob/main/CHANGELOG.md
+Author-email: alex8224 <alex8224@gmail.com>
+Requires-Python: >=3.12
+Requires-Dist: aiosqlite>=0.20.0
+Requires-Dist: deepagents>=0.6.12
+Requires-Dist: langchain-anthropic>=1.4.8
+Requires-Dist: langchain-openai>=1.3.5
+Requires-Dist: langchain>=1.3.14
+Requires-Dist: langgraph-checkpoint-sqlite>=3.1.0
+Requires-Dist: langgraph>=1.2.9
+Requires-Dist: mcp>=1.28.0
+Requires-Dist: pydantic-settings>=2.14.2
+Requires-Dist: python-dotenv>=1.2.2
+Requires-Dist: rich>=15.0.0
+Requires-Dist: termaid>=0.7.1
+Requires-Dist: texicode>=1.0.3
+Requires-Dist: textual-diff-view>=0.1.5
+Requires-Dist: textual>=1.0.0
+Requires-Dist: typer>=0.27.0
+Requires-Dist: websockets<16,>=13
+Requires-Dist: zstandard>=0.23.0
+Provides-Extra: dev
+Requires-Dist: mkdocs-material>=9.7.7; extra == 'dev'
+Requires-Dist: mkdocs>=1.6.1; extra == 'dev'
+Requires-Dist: pytest>=9.1.1; extra == 'dev'
+Requires-Dist: ruff>=0.15.22; extra == 'dev'
+Description-Content-Type: text/markdown
+
 # Synapse
 
 基于 **LangChain Deep Agents** 的本地 Synapse。
@@ -145,7 +180,7 @@ cp .env.example .env
 | `MODEL` | 是 | 模型标识，如 `openai:gpt-4.1`、`openai:deepseek-chat` |
 | `OPENAI_API_KEY` | 是* | OpenAI 兼容 API 密钥 |
 | `OPENAI_BASE_URL` | 否 | 自定义 API 端点（中转/本地服务需填） |
-| `OPENAI_WEBSOCKET` | 否 | 普通 Responses API 使用 WebSocket；默认 `false`（HTTP/SSE） |
+| `OPENAI_WEBSOCKET` | 否 | 普通 Responses API 使用 WebSocket；默认 `false`（HTTP/SSE）。瞬时断流按模型 `max_retries` 重连，耗尽后在尚未输出内容时回退 HTTP/SSE |
 | `ANTHROPIC_API_KEY` | 否 | Anthropic 原生 API 密钥 |
 | `WORKSPACE` | 否 | 工作区路径，默认 `.` |
 | `SHELL_EXECUTABLE` | 否 | Shell 类型，默认 `pwsh`（可选 `cmd`/`bash`） |
@@ -155,6 +190,42 @@ cp .env.example .env
 
 完整变量列表见 `.env.example`。
 
+### OpenAI Codex OAuth（ChatGPT Plus/Pro）
+
+除普通 API Key 外，Synapse 可使用 Codex 的 ChatGPT OAuth 登录。凭据仅保存到用户目录
+`~/.synapse/openai_oauth.json`，不会写入项目配置或显示在终端中。
+
+```bash
+# 浏览器登录；也可加 --no-browser 手动打开终端打印的链接
+synapse auth openai login
+
+# 若本机已通过 Codex CLI 登录，安全导入其现有登录态
+synapse auth openai login --import-codex
+
+synapse auth openai status
+synapse auth openai logout
+```
+
+然后在 `~/.synapse/models.json` 或 `<workspace>/.synapse/models.json` 配置模型：
+
+```json
+{
+  "default": "codex",
+  "models": {
+    "codex": {
+      "model": "openai:gpt-5",
+      "auth": "openai_oauth"
+    }
+  }
+}
+```
+
+OAuth profile 强制使用 Codex backend，不能通过 `base_url` 覆盖。该登录方式不能用于第三方
+OpenAI 兼容网关，也不需要设置 `OPENAI_API_KEY`。浏览器授权回调固定使用
+`http://localhost:1455/auth/callback`；若端口被占用，请关闭占用进程后重试。Synapse 会自动将
+Agent 的 OpenAI `system` 消息转换为 Codex backend 接受的 `developer` 消息，并移除 DeepSeek
+兼容的 `extra_body.thinking` 字段，只发送 Codex 支持的 reasoning 参数，并强制设置 `store: false`。
+
 ### 方式二：models.json（多模型 profiles，推荐）
 
 在 `~/.synapse/` 或 `<workspace>/.synapse/` 下创建 `models.json`。支持多 profile、自定义模型参数（temperature、max_tokens、thinking 等）。
@@ -294,6 +365,8 @@ OpenAI Responses API 同时支持 HTTP/SSE 与普通 LLM WebSocket。profile 中
 |---|---|
 | `api_key` | **推荐**：密钥直接写在 models.json |
 | `api_key_env` | 旧方式：从环境变量读密钥 |
+| `auth` | 认证方式；设为 `openai_oauth` 时使用 `synapse auth openai login` 保存的 Codex OAuth 登录态 |
+| `headers` | 模型级 HTTP 请求头对象；同名头覆盖顶层 `headers`，适用于自定义 `User-Agent` 等请求指纹 |
 | `thinking` / `thinking_level` / `reasoning_effort` | 思考级别：`off\|minimal\|low\|medium\|high\|max` |
 | `enable_thinking` | 兼容旧字段 bool |
 | `temperature` / `max_tokens` / `timeout` 等 | 直接传给 ChatModel |
@@ -301,6 +374,33 @@ OpenAI Responses API 同时支持 HTTP/SSE 与普通 LLM WebSocket。profile 中
 | `model_kwargs` | 请求体 kwargs |
 | `extra_body` | 厂商扩展体（与 thinking 合并） |
 
+### 自定义请求头与请求指纹
+
+参考 `cmd-agent` 的配置方式，`models.json` 顶层 `headers` 会应用到全部 OpenAI 兼容模型；
+模型内 `headers` 按 HTTP 头名称（不区分大小写）覆盖全局值。分层配置的优先级为：
+项目模型 > 用户模型 > 项目全局 > 用户全局。可用于设置 `User-Agent`、客户端标识等请求指纹。
+
+```json
+{
+  "headers": {
+    "User-Agent": "synapse-global/1.0",
+    "X-Client-Channel": "desktop"
+  },
+  "models": {
+    "codex": {
+      "model": "openai:gpt-5",
+      "auth": "openai_oauth",
+      "headers": {
+        "User-Agent": "synapse-codex/1.0"
+      }
+    }
+  }
+}
+```
+
+OAuth 模式中 `ChatGPT-Account-Id`、`originator` 等协议认证头由运行时强制设置，不能被配置覆盖。
+请求头值支持 `${ENV_NAME}` / `$ENV_NAME` 环境变量展开；不要将私密 token 写入项目级配置。
+
 `.env` 仍可读，仅作迁移/CI 兼容，**不推荐**作为常规分发方式。
 
 ## 示例：修复 sample_repo

synapse_cli_agent-0.1.13/PKG-INFO → synapse_cli_agent-0.1.15/README.md

@@ -1,34 +1,3 @@
-Metadata-Version: 2.4
-Name: synapse-cli-agent
-Version: 0.1.13
-Summary: Local coding agent built on LangChain Deep Agents (LocalShell, no sandbox)
-Author-email: alex8224 <alex8224@gmail.com>
-Requires-Python: >=3.12
-Requires-Dist: aiosqlite>=0.20.0
-Requires-Dist: deepagents>=0.6.12
-Requires-Dist: langchain-anthropic>=1.4.8
-Requires-Dist: langchain-openai>=1.3.5
-Requires-Dist: langchain>=1.3.14
-Requires-Dist: langgraph-checkpoint-sqlite>=3.1.0
-Requires-Dist: langgraph>=1.2.9
-Requires-Dist: mcp>=1.28.0
-Requires-Dist: pydantic-settings>=2.14.2
-Requires-Dist: python-dotenv>=1.2.2
-Requires-Dist: rich>=15.0.0
-Requires-Dist: termaid>=0.7.1
-Requires-Dist: texicode>=1.0.3
-Requires-Dist: textual-diff-view>=0.1.5
-Requires-Dist: textual>=1.0.0
-Requires-Dist: typer>=0.27.0
-Requires-Dist: websockets<16,>=13
-Requires-Dist: zstandard>=0.23.0
-Provides-Extra: dev
-Requires-Dist: mkdocs-material>=9.7.7; extra == 'dev'
-Requires-Dist: mkdocs>=1.6.1; extra == 'dev'
-Requires-Dist: pytest>=9.1.1; extra == 'dev'
-Requires-Dist: ruff>=0.15.22; extra == 'dev'
-Description-Content-Type: text/markdown
-
 # Synapse
 
 基于 **LangChain Deep Agents** 的本地 Synapse。
@@ -176,7 +145,7 @@ cp .env.example .env
 | `MODEL` | 是 | 模型标识，如 `openai:gpt-4.1`、`openai:deepseek-chat` |
 | `OPENAI_API_KEY` | 是* | OpenAI 兼容 API 密钥 |
 | `OPENAI_BASE_URL` | 否 | 自定义 API 端点（中转/本地服务需填） |
-| `OPENAI_WEBSOCKET` | 否 | 普通 Responses API 使用 WebSocket；默认 `false`（HTTP/SSE） |
+| `OPENAI_WEBSOCKET` | 否 | 普通 Responses API 使用 WebSocket；默认 `false`（HTTP/SSE）。瞬时断流按模型 `max_retries` 重连，耗尽后在尚未输出内容时回退 HTTP/SSE |
 | `ANTHROPIC_API_KEY` | 否 | Anthropic 原生 API 密钥 |
 | `WORKSPACE` | 否 | 工作区路径，默认 `.` |
 | `SHELL_EXECUTABLE` | 否 | Shell 类型，默认 `pwsh`（可选 `cmd`/`bash`） |
@@ -186,6 +155,42 @@ cp .env.example .env
 
 完整变量列表见 `.env.example`。
 
+### OpenAI Codex OAuth（ChatGPT Plus/Pro）
+
+除普通 API Key 外，Synapse 可使用 Codex 的 ChatGPT OAuth 登录。凭据仅保存到用户目录
+`~/.synapse/openai_oauth.json`，不会写入项目配置或显示在终端中。
+
+```bash
+# 浏览器登录；也可加 --no-browser 手动打开终端打印的链接
+synapse auth openai login
+
+# 若本机已通过 Codex CLI 登录，安全导入其现有登录态
+synapse auth openai login --import-codex
+
+synapse auth openai status
+synapse auth openai logout
+```
+
+然后在 `~/.synapse/models.json` 或 `<workspace>/.synapse/models.json` 配置模型：
+
+```json
+{
+  "default": "codex",
+  "models": {
+    "codex": {
+      "model": "openai:gpt-5",
+      "auth": "openai_oauth"
+    }
+  }
+}
+```
+
+OAuth profile 强制使用 Codex backend，不能通过 `base_url` 覆盖。该登录方式不能用于第三方
+OpenAI 兼容网关，也不需要设置 `OPENAI_API_KEY`。浏览器授权回调固定使用
+`http://localhost:1455/auth/callback`；若端口被占用，请关闭占用进程后重试。Synapse 会自动将
+Agent 的 OpenAI `system` 消息转换为 Codex backend 接受的 `developer` 消息，并移除 DeepSeek
+兼容的 `extra_body.thinking` 字段，只发送 Codex 支持的 reasoning 参数，并强制设置 `store: false`。
+
 ### 方式二：models.json（多模型 profiles，推荐）
 
 在 `~/.synapse/` 或 `<workspace>/.synapse/` 下创建 `models.json`。支持多 profile、自定义模型参数（temperature、max_tokens、thinking 等）。
@@ -325,6 +330,8 @@ OpenAI Responses API 同时支持 HTTP/SSE 与普通 LLM WebSocket。profile 中
 |---|---|
 | `api_key` | **推荐**：密钥直接写在 models.json |
 | `api_key_env` | 旧方式：从环境变量读密钥 |
+| `auth` | 认证方式；设为 `openai_oauth` 时使用 `synapse auth openai login` 保存的 Codex OAuth 登录态 |
+| `headers` | 模型级 HTTP 请求头对象；同名头覆盖顶层 `headers`，适用于自定义 `User-Agent` 等请求指纹 |
 | `thinking` / `thinking_level` / `reasoning_effort` | 思考级别：`off\|minimal\|low\|medium\|high\|max` |
 | `enable_thinking` | 兼容旧字段 bool |
 | `temperature` / `max_tokens` / `timeout` 等 | 直接传给 ChatModel |
@@ -332,6 +339,33 @@ OpenAI Responses API 同时支持 HTTP/SSE 与普通 LLM WebSocket。profile 中
 | `model_kwargs` | 请求体 kwargs |
 | `extra_body` | 厂商扩展体（与 thinking 合并） |
 
+### 自定义请求头与请求指纹
+
+参考 `cmd-agent` 的配置方式，`models.json` 顶层 `headers` 会应用到全部 OpenAI 兼容模型；
+模型内 `headers` 按 HTTP 头名称（不区分大小写）覆盖全局值。分层配置的优先级为：
+项目模型 > 用户模型 > 项目全局 > 用户全局。可用于设置 `User-Agent`、客户端标识等请求指纹。
+
+```json
+{
+  "headers": {
+    "User-Agent": "synapse-global/1.0",
+    "X-Client-Channel": "desktop"
+  },
+  "models": {
+    "codex": {
+      "model": "openai:gpt-5",
+      "auth": "openai_oauth",
+      "headers": {
+        "User-Agent": "synapse-codex/1.0"
+      }
+    }
+  }
+}
+```
+
+OAuth 模式中 `ChatGPT-Account-Id`、`originator` 等协议认证头由运行时强制设置，不能被配置覆盖。
+请求头值支持 `${ENV_NAME}` / `$ENV_NAME` 环境变量展开；不要将私密 token 写入项目级配置。
+
 `.env` 仍可读，仅作迁移/CI 兼容，**不推荐**作为常规分发方式。
 
 ## 示例：修复 sample_repo