synapse-cli-agent 0.1.13__tar.gz

synapse_cli_agent-0.1.13/.github/workflows/ci.yml

@@ -0,0 +1,41 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.12"
+
+      - name: ruff check
+        run: uv run ruff check src tests
+
+  test:
+    needs: lint
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python-version: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Run tests
+        run: uv run pytest -v

synapse_cli_agent-0.1.13/.github/workflows/docs.yml

@@ -0,0 +1,48 @@
+name: docs
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Build site
+        run: uv run mkdocs build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

synapse_cli_agent-0.1.13/.github/workflows/native-compression-wheels.yml

@@ -0,0 +1,69 @@
+name: Build Native Compression Wheels
+
+on:
+  push:
+    tags:
+      - "synapse-tool-compress-core-v*"
+  pull_request:
+    paths:
+      - "rust/synapse-tool-compress-core/**"
+      - ".github/workflows/native-compression-wheels.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  wheel:
+    name: ${{ matrix.target }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: windows-latest
+            target: x86_64-pc-windows-msvc
+          - os: macos-latest
+            target: aarch64-apple-darwin
+          - os: ubuntu-latest
+            target: x86_64-unknown-linux-gnu
+          - os: ubuntu-24.04-arm
+            target: aarch64-unknown-linux-gnu
+    steps:
+      - uses: actions/checkout@v4
+      - uses: PyO3/maturin-action@v1
+        with:
+          command: build
+          working-directory: rust/synapse-tool-compress-core
+          target: ${{ matrix.target }}
+          args: --release --locked --compatibility pypi --out dist
+          manylinux: 2014
+          # tree-sitter 0.25 requires _BSD_SOURCE on manylinux2014's glibc 2.17
+          # for le16toh/be16toh to expand as macros instead of unresolved symbols.
+          docker-options: --env CFLAGS=-D_BSD_SOURCE
+      - name: Smoke test wheel
+        shell: bash
+        run: |
+          python -m pip install --force-reinstall rust/synapse-tool-compress-core/dist/*.whl
+          python -c "import synapse_tool_compress_core; print('native wheel import OK')"
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheel-${{ matrix.target }}
+          path: rust/synapse-tool-compress-core/dist/*.whl
+
+  publish:
+    if: startsWith(github.ref, 'refs/tags/synapse-tool-compress-core-v')
+    needs: wheel
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: wheel-*
+          merge-multiple: true
+          path: dist
+      - uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*.whl
+          name: synapse-tool-compress-core ${{ github.ref_name }}

synapse_cli_agent-0.1.13/.github/workflows/release.yml

@@ -0,0 +1,71 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.12"
+
+      - name: Extract changelog section
+        run: |
+          VERSION="${GITHUB_REF#refs/tags/}" python -c "
+          import os, re
+          ver = os.environ['VERSION']
+          with open('CHANGELOG.md', 'r', encoding='utf-8') as f:
+              content = f.read()
+          pattern = rf'(?ms)^## {re.escape(ver)}\n.*?(?=\n## |\Z)'
+          m = re.search(pattern, content)
+          if m:
+              out = m.group().strip()
+              with open('release_body.md', 'w', encoding='utf-8') as f:
+                  f.write(out)
+              print(f'Extracted {len(out)} chars for {ver}')
+          else:
+              raise SystemExit(f'ERROR: ## {ver} section not found in CHANGELOG.md')
+          "
+
+      - name: Build distributions
+        run: uv build
+
+      - name: Upload distribution artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          body_path: release_body.md
+
+  publish-pypi:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/synapse-cli-agent
+    permissions:
+      id-token: write
+    steps:
+      - name: Download distribution artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

synapse_cli_agent-0.1.13/.gitignore

@@ -0,0 +1,41 @@
+# Rust build artifacts
+**/target/
+
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Local env / agent state
+.env
+.coding-agent/
+.cmd-agent/
+.synapse/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+
+# Agent transient output
+large_tool_results/
+conversation_history/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+
+# Runtime logs
+logs/
+site/
+
+# OS
+Thumbs.db
+.DS_Store

synapse_cli_agent-0.1.13/.python-version

@@ -0,0 +1 @@
+3.12

synapse_cli_agent-0.1.13/.readthedocs.yaml

@@ -0,0 +1,19 @@
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+version: 2
+
+build:
+  os: "ubuntu-22.04"
+  tools:
+    python: "3.12"
+
+python:
+  install:
+    - method: pip
+      path: .
+      extra_requirements:
+        - dev
+
+mkdocs:
+  configuration: mkdocs.yml

synapse_cli_agent-0.1.13/AGENTS.md

@@ -0,0 +1,133 @@
+# Synapse 项目协作指南
+
+## 当前仓库结构
+
+| 路径                               | 主要职责                                                 |
+| ---------------------------------- | -------------------------------------------------------- |
+| `src/synapse/app/`                 | Agent 装配与 `AGENTS.md` 注入                            |
+| `src/synapse/commands/`            | slash 命令解析、补全和命令结果                           |
+| `src/synapse/content/`             | prompt、skills、输入历史和多模态内容处理                 |
+| `src/synapse/integrations/`        | MCP、模型传输、Codex 导入、图片识别等外部集成            |
+| `src/synapse/models/`              | 模型 profile、registry、配置解析与辅助逻辑               |
+| `src/synapse/observability/`       | 启动与运行观测                                           |
+| `src/synapse/runtime/`             | backend、middleware、压缩、steer、安全和异步运行时       |
+| `src/synapse/sessions/`            | session、transcript、recap、取消修复与持久化             |
+| `src/synapse/settings/`            | 分层配置路径、Settings schema 与加载逻辑                 |
+| `src/synapse/tool_output/`         | 可逆工具输出检测、变换、存储和指标                       |
+| `src/synapse/tools/`               | 注入 Agent 的自定义工具                                  |
+| `src/synapse/ui/`                  | Textual TUI、stream、timeline、dialogs、topbar/bottombar |
+| `tests/`                           | Python 测试；测试文件通常与领域模块对应                  |
+| `rust/synapse-tool-compress-core/` | 可选 Rust/PyO3 原生工具输出压缩核心                      |
+| `docs/`、`mkdocs.yml`              | 用户文档与 MkDocs 配置                                   |
+| `.github/workflows/`               | CI、文档、Python Release 与原生 wheel 构建               |
+
+## 架构与兼容性约定
+
+- 将 `src/synapse/app/agent.py` 视为装配层，不要把具体领域算法继续堆入该文件。
+- 新功能应落入对应领域包；跨领域装配放在 `app/` 或明确的 runtime middleware 中。
+- `src/synapse/config.py` 是兼容导出层。新代码优先从 `synapse.settings` 导入，但不要无理由破坏旧导入路径。
+- 各包 `__init__.py` 中的导出属于公共 API。移动实现时保留必要 re-export，并检查现有测试和扩展调用方。
+- 配置采用用户层与项目层合并策略。修改 Settings 时同步检查：
+  - `src/synapse/settings/schema.py`
+  - `src/synapse/settings/config_paths.py`
+  - `tests/test_config.py`
+  - `tests/test_layered_config.py`
+  - `README.md` 与 `docs/config.md` 中的用户文档
+- `AGENTS.md` 由 `AgentMdMiddleware` 静态注入，独立于可写 memory。不要把它重新并入 memory 写回机制。
+
+## 编码规范
+
+- Ruff 配置是 Python 风格的唯一自动化基线：行宽 100，目标 Python 3.12，规则集 `E/F/I/B/UP`。
+- 为新增或修改的公共函数、复杂状态转换和兼容分支补充类型标注。
+- 捕获宽泛异常只用于明确的降级边界，并说明为何允许 fallback；不要静默吞掉核心业务错误。
+- 避免无界读取、无界搜索和无界终端输出；对日志、工具结果和外部数据设置合理上限。
+- 不在代码、测试快照、文档或终端输出中暴露 API key、token、`.env` 内容或用户私有配置。
+- 修改用户可见行为时，同步更新相应 README/docs；修改内部实现但行为未变时，不制造无关文档改动。
+
+## 6. Python 开发与测试
+
+首次安装或依赖变化后执行：
+
+```powershell
+uv sync
+```
+
+验证遵循“最窄测试 → 相关领域测试 → 全量检查”的顺序。
+
+### 6.1 针对性测试
+
+```powershell
+uv run --no-sync pytest tests/test_x.py -q
+uv run --no-sync pytest tests/test_x.py::test_case_name -q
+```
+
+按改动领域优先选择相应测试，例如：
+
+| 改动领域                | 优先测试                                                                 |
+| ----------------------- | ------------------------------------------------------------------------ |
+| settings/models         | `tests/test_config.py`、`tests/test_layered_config.py`、模型相关测试     |
+| backend/safety/runtime  | `tests/test_backends.py`、`tests/test_safety.py`、对应 middleware 测试   |
+| tool output/compression | `tests/test_tool_output.py`、`tests/test_tool_output_*`、请求压缩测试    |
+| sessions/Codex import   | `tests/test_session_*`、`tests/test_transcript.py`、`tests/test_codex_*` |
+| CLI/slash commands      | `tests/test_cli.py`、`tests/test_slash_*`                                |
+| TUI/widgets/dialogs     | 对应 `test_tui_*`、`test_stream_*`、`test_dialogs.py` 和组件测试         |
+
+### 6.2 全量检查
+
+针对性测试通过后，根据改动风险运行：
+
+```powershell
+uv run --no-sync ruff check .
+uv run --no-sync pytest -q
+```
+
+CI 会在 Windows/Linux、Python 3.12/3.13 上运行 lint 和测试。平台相关改动至少要覆盖当前本机，并在代码层面检查另一平台分支。
+
+### 6.3 文档与构建
+
+修改 `docs/`、`README.md` 或 `mkdocs.yml` 后运行：
+
+```powershell
+uv run --no-sync mkdocs build
+```
+
+修改打包配置、入口点或发布内容后可运行：
+
+```powershell
+uv build
+```
+
+## 7. Rust/PyO3 原生压缩核心
+
+- `synapse-tool-compress-core` 是独立可选包，不是 Synapse 的必需开发依赖。
+- Python 主程序必须在未安装原生 wheel 时正常工作，不能移除 `ImportError`/`OSError` fallback。
+- 修改 `rust/synapse-tool-compress-core/` 时，至少运行：
+
+```powershell
+cargo test --manifest-path rust/synapse-tool-compress-core/Cargo.toml
+cargo fmt --manifest-path rust/synapse-tool-compress-core/Cargo.toml --check
+```
+
+- 如修改 Python 绑定/API，再构建或安装本地扩展，并运行 `tests/test_tool_output.py` 及相关压缩测试。
+- 保留 `src/headroom_port/` 中的 Apache-2.0 SPDX、来源归属、`LICENSE` 和 `NOTICE`；不要引入被明确排除的网络调用或模型下载依赖。
+- 原生 wheel 由 `.github/workflows/native-compression-wheels.yml` 独立构建，tag 格式为 `synapse-tool-compress-core-v*`。
+
+## 9. 发布流程
+
+任何 `git push` 前必须询问用户：**“本次是否需要打 tag 发 Release？”**
+如果用户确认不发布，只执行普通 push，不创建 tag。
+如果用户确认发布：
+
+1. 读取 `pyproject.toml` 的当前版本，并让用户确认或覆盖版本号。
+2. 用 `git log` 对比上一个 `v*` tag 以来的变更。
+3. 在 `CHANGELOG.md` 顶部新增 `## v{version}` 段落；标题必须与 tag 完全一致，并按新增功能、修复、工程改进等类别总结。
+4. 如版本变化，更新 `pyproject.toml`；需要时同步 `uv.lock`。
+5. 运行相关测试、Ruff 和 `uv build`，确认工作树内容正确。
+6. 提交发布文件，提交信息使用：`release: bump to v{version}`。
+7. 运行：
+
+```powershell
+powershell -ExecutionPolicy Bypass -File scripts/release.ps1
+```
+
+8. 脚本会创建并推送 `v{version}` tag；`.github/workflows/release.yml` 会从 `CHANGELOG.md` 提取同名段落、执行 `uv build` 并创建 GitHub Release。

synapse_cli_agent-0.1.13/CHANGELOG.md

@@ -0,0 +1,270 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+Each release section starts with `## v{version}` and ends before the next `## ` heading.
+The release workflow automatically extracts the matching section as release notes.
+
+---
+
+## v0.1.13
+
+### 新功能
+
+- 支持通过 PyPI Trusted Publisher 自动发布 `synapse-cli-agent` 分发包。
+
+### 工程改进
+
+- 安装文档增加无需克隆仓库的 PyPI 安装方式；`uv` 可自动管理所需 Python 版本。
+
+---
+
+## v0.1.2
+
+### 修复
+
+- 修复 `synapse-tool-compress-core` manylinux2014 wheel 中 tree-sitter 的 `le16toh` / `be16toh` 未解析符号，确保原生扩展可导入。
+
+### 工程改进
+
+- 原生 wheel 构建固定 manylinux2014 兼容目标，并增加安装导入冒烟测试。
+- 同步 Rust crate 与 Python wheel 的发布版本为 `0.1.2`。
+
+---
+
+## v0.1.11
+
+### 新功能
+
+- F5 MCP Tools 面板支持按 `d` 临时切换当前选中 MCP server 的启用状态，并自动重建 agent；该状态不写入 `mcp.json`
+- 工具输出路径压缩增加更清晰的统计与诊断展示，优化压缩处理路径
+
+### 修复
+
+- 修复会话切换与删除快捷键的职责冲突
+
+### 工程改进
+
+- 扩充 `AGENTS.md` 的仓库结构、架构约束、测试和发布协作规范
+
+---
+
+## v0.1.10
+
+### 工程改进
+
+- 重组应用、命令、运行时、内容与会话等核心领域模块，收紧模块职责与依赖边界
+- 拆分工具输出管道为模型、仓储、检测和变换层，保留既有公共 API
+- 将 slash 命令按压缩、会话、MCP、模型和主题职责拆分，保留统一分发入口
+- 拆分流处理为渲染、事件归一化与运行时迭代层，兼容现有 CLI 和 TUI 调用路径
+- 提取 TUI turn rail 和用户 turn 格式化逻辑，降低主应用模块复杂度
+- 拆分模型配置解析、Profile 与 settings/能力辅助逻辑，保持 provider 工厂和 mock 契约稳定
+
+---
+
+## v0.1.9
+
+### 新功能
+
+- 紧凑工具描述中间件：替换上游冗长的工具 schema 描述（~4K chars → ~200 chars），减少 token 开销
+- Cache-aware 压缩控制面：实时追踪 provider 缓存命中/写入，区分缓存输入与新输入
+- 压缩诊断面板：profile-driven 内容分解与优化机会排序（TUI `Ctrl+D`）
+- 请求账本（interaction ledger）：turn 级与 model-call 级关联追踪
+- Topbar 实时压缩指示器：显示活跃 zone 与压缩状态
+- `/tool-output` slash 命令：查看工具输出变换统计
+- GitSummaryTransformer：识别 `git status`/`git diff --stat` 输出并智能摘要
+
+### 修复
+
+- 避免 search 内容检测误判为 critical-line 回退
+- 修复 Alt+C 复制崩溃
+
+### 工程改进
+
+- 默认路径从 `.coding-agent` 迁移至 `.synapse`（checkpoint / sessions / memory）
+- 工具输出压缩阈值降至 512 bytes
+- CI native compression wheel 发布到 GitHub Release（替代 PyPI）
+
+---
+
+## v0.1.8
+
+### 新功能
+
+- 工具输出变换管道：大型工具结果自动归档到 JSONL journal，替换为边界预览 + `tool-result://` 引用，避免撑爆 LLM 上下文
+- Rust 原生压缩核心 (`synapse-tool-compress-core`)：智能摘要引擎 SmartCrusher，支持 code/diff/log/search 专用压缩器，BM25 相关性排序，adaptive sizer
+- CLI `--diagnose-tool-output` 诊断标志：查看每次工具输出的变换统计
+- F4 多选删除 session + F5 MCP 分组折叠 + 多选 UI 统一
+
+### 修复
+
+- MCP deferred 状态不再错误显示为 "mcp err"
+
+### 工程改进
+
+- `tool_results.py` 重构为 `tool_output.py` + `tool_output_middleware.py`，职责更清晰
+- 新增 `tool_output_eval.py` 评估框架
+- CI 新增 native-compression-wheels workflow 用于构建 Rust wheel
+
+---
+
+## v0.1.7
+
+### 新功能
+
+- 斜杠命令 TUI 输出升级为 Markdown 渲染，会话/MCP/主题等数据使用 Rich 表格展示
+- AgentMdMiddleware：将 `AGENTS.md` 静态注入 system prompt，与 memory 解耦
+- MCP per-tool 过滤：支持 UI 勾选工具并持久化到配置
+
+### 修复
+
+- 全新 session 输入斜杠命令不会在 TUI 显示内容（welcome 页面遮挡 `#log`）
+- shell 默认值平台感知：非 Windows 用 `bash` 替代 `pwsh`
+- prompt_border 校验 Textual 白名单，新增 `panel` 样式支持
+
+### 工程改进
+
+- 添加 MkDocs + GitHub Pages 文档站点
+- subagents 和 memory 默认关闭，精简冗余 middleware prompt 块
+- UI：steer 更名为 queue，简化 bottombar mode 标签
+
+---
+
+## v0.1.6
+
+### 新功能
+
+- 支持 OpenAI Responses API WebSocket 传输，降低延迟
+- Welcome 页面动画重构：左到右打字光标出现 + 斜扫逐点删除循环
+- Braille Logo 点阵逐点显隐动画，仅用 muted/fg 两种主题色无中间杂色
+- 打字光标效果：新字符短暂高亮 accent 后降为 fg
+- `prompt_border` 字段支持主题自定义输入框边框样式（tall/heavy/dashed/dotted/double/round/solid）
+- 后端 glob/grep 工具自动跳过 `.gitignore` 匹配路径
+
+### 修复
+
+- WebSocket：握手前刷新异步 API key，避免网关 401
+- WebSocket：关闭 ping timeout，防止推理期间误断连
+- WebSocket：过滤 Chat Completions 专用 `thinking` 字段
+- TUI：主题设计器 backdrop 完全透明
+- TUI：修复 `_open_theme_designer` 缺失回调
+- TUI：移除 `_save_theme` 重复 `apply_theme` 调用，避免 UI 卡死
+- TUI：git changes popover 重新挂载避免 DuplicateIds 异常
+- SteerQueue：修复可重入死锁和 graph 重建后队列丢失
+- 修复子 agent 工具调用的时间线渲染
+- 修复 alt-v 多行粘贴被截断
+
+### 性能
+
+- 纯异步 model clients，消除同步 OpenAI 客户端的阻塞
+- 加速模型切换和 shutdown 流程
+
+### 工程
+
+- 移除 cancel-seal 诊断日志输出
+- SteerQueue 在活跃 turn 期间保持可见
+- 简化 agent 工具表面，减少不必要的工具暴露
+- 上调模型瞬时故障重试上限
+
+---
+
+## v0.1.5
+
+### 新功能
+
+- 新增独立识图服务：非多模态主模型可通过 `vision_model` 配置独立图片识别服务，自动将图片转为文字描述后交给主模型处理
+- 支持 `models.json` / `settings.json` 中配置 `vision_model`，可自由更换任意 OpenAI-compatible 识图服务（Qwen-VL 等）
+- 识图服务支持独立 `think` 开关（不影响主模型思考模式）、`allow_remote_urls` 安全策略、超时重试和 fallback 模型
+- 自动推断主模型是否原生支持图片输入（按 provider/model 名匹配），支持 `image_input` 显式覆盖
+
+### 修复
+
+- 修复 mermaid / git-explore 调用卡死问题
+- 修复 Windows 下 git 输出编码导致的乱码问题
+
+### 工程
+
+- 新增 `vision_middleware`、`describe_image` 模块
+- 新增识图服务测试和 API 检查脚本
+
+---
+
+## v0.1.4
+
+### 新功能
+
+- 新增 Codex session 的只读发现、预览和导入，支持 CLI 与 TUI picker
+- 导入使用终态 checkpoint seeding 与 ledger，支持幂等重用和崩溃恢复
+
+### 修复
+
+- 修复 state DB 过期、空 thread、Windows 扩展路径、长 metadata header 导致 Codex 历史缺失的问题
+- 支持 `subagent.thread_spawn` 子代理会话，并按首条用户消息生成 picker 与导入标题
+- 对可恢复的模型服务 5xx 故障增加退避重试，并向 TUI 显示重试状态
+
+### 工程
+
+- 扩充 Codex discovery、import、TUI 和 retry 回归覆盖
+
+---
+
+## v0.1.3
+
+### 修复
+
+- 修复 49 个 ruff lint 错误（E501 超长行、UP042 StrEnum、F401/F811 未使用导入、I001 导入排序）
+
+### 工程
+
+- CI 仅对 PR 触发，避免 push tag 时与 Release workflow 重复构建
+
+---
+
+## v0.1.2
+
+### 修复
+
+- Release workflow 中 CHANGELOG 提取脚本误将 shell 变量当 Python 变量，改用 `os.environ` 读取
+
+---
+
+## v0.1.1
+
+### 工程
+
+- 新增 `CHANGELOG.md`，发布说明从此文件对应版本段落自动提取
+- 修复 `release.ps1`：打 tag 时同步推送分支提交，避免 tag 到了代码没跟上
+- 更新 `AGENTS.md` 发布流程：AI 自动分析变更、写入 changelog 条目
+
+---
+
+## v0.1.0
+
+初版发布。基于 LangChain Deep Agents 的本地 AI 编码 Agent。
+
+### 新功能
+
+- 自主编码闭环：读改代码、执行命令、运行测试、Git 操作
+- 子代理协作：内置 researcher / tester / reviewer，任务自动拆解并行执行
+- MCP 协议支持，接入外部工具生态
+- 多模型切换：OpenAI / Anthropic / DeepSeek / 任意 OpenAI-compatible 网关
+- TUI 终端界面（Textual）：斜杠命令补全、实时流式输出、快捷键
+- CLI 命令行：`run` / `chat` / `tui` / `sessions` / `models` / `mcp` / `version`
+- 分层配置：用户全局 + 项目本地，密钥写入 models.json
+- Skills 系统：Agent Skills 可复用能力单元
+- 会话管理：SQLite checkpointer，支持导出
+- TUI 文本选择与复制、mermaid 渲染、Git Explore
+- 自适应顶栏与底栏，模型/MCP 状态显示
+
+### 修复
+
+- Windows subprocess timeout 管道卡死问题
+- TeXicode 解析错误污染最终回答
+- Textual DiffView 卸载后样式缓存泄漏
+- stream_chunk_timeout 默认关闭，避免长思考被掐断
+
+### 工程
+
+- uv 依赖管理，Python 3.12+
+- GitHub Actions：CI（lint + test）和 Release（自动构建 wheel）
+- 一键发布脚本 `scripts/release.ps1`