aether-mkt 0.1.1__tar.gz

aether_mkt-0.1.1/.env.example

@@ -0,0 +1,40 @@
+# Real env vars for aether v0.1
+# Copy this file to .env and fill in real values.
+
+# ===== DB (Postgres) =====
+DATABASE_URL=postgresql://aether:aether@localhost:5432/aether
+
+# ===== LLM Provider（直连 + OpenRouter 双轨，三件套切模型只改 env 不改代码）=====
+# 推荐先用 OpenRouter：一个 key 全能切换 Claude / DeepSeek / MiMo / 其他
+# OpenAI/Anthropic 兼容 endpoint 都行 —— 切 provider 改 3 行。
+
+# 默认：直连 Anthropic
+LLM_BASE_URL=https://api.anthropic.com
+LLM_MODEL=claude-sonnet-4-6
+LLM_API_KEY=sk-ant-REPLACE_BEFORE_BLOCK_3
+
+# --- 其他 provider 选项（任一行取消注释填值即可） ---
+# OpenRouter（一个 key 路由到任意模型）:
+#   LLM_BASE_URL=https://openrouter.ai/api/v1
+#   LLM_MODEL=deepseek/deepseek-v4-flash        ← 或 anthropic/claude-sonnet-4-6 / 任意
+#   LLM_API_KEY=sk-or-xxxxx
+#
+# DeepSeek V4-Flash 直连（最便宜）：
+#   LLM_BASE_URL=https://api.deepseek.com/anthropic
+#   LLM_MODEL=deepseek-chat
+#   LLM_API_KEY=sk-xxxxx
+#
+# 小米 MiMo V2.5-Flash 直连：
+#   LLM_BASE_URL=https://api.xiaomimimo.com/anthropic
+#   LLM_MODEL=mimo-v2-flash
+#   LLM_API_KEY=xxxxx
+
+# ===== LangSmith（Block 5+ 可观测，可选）=====
+# LANGCHAIN_TRACING_V2=true
+# LANGCHAIN_API_KEY=lsv2-xxxxx
+# LANGCHAIN_PROJECT=aether-v0.1
+
+# ===== 数据源抓取层（Block 0）=====
+USER_AGENT=AetherBot/0.1
+REQUEST_TIMEOUT=30
+DEFAULT_TOP_N=3

aether_mkt-0.1.1/.gitignore

@@ -0,0 +1,43 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+.venv/
+venv/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# Node
+node_modules/
+dist/
+build/
+.next/
+
+# Secrets & local config
+.env
+.env.local
+*.local
+
+# IDE
+.idea/
+.vscode/
+*.swp
+
+# Block run artefacts (raw; curated runs go in expected/)
+# Inline gitignores in each blocks/NN-name/runs/ handle the file-level rules.
+
+# OS
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# Downloads
+downloads/
+
+# Block 3B: image_handler downloads (rewritten articles' images go here)
+data/article_images/
+# Web control panel: runtime settings overrides (UI 改 LLM key 等不进 git)
+data/*.json
+!data/.gitkeep

aether_mkt-0.1.1/AGENTS.md

@@ -0,0 +1,132 @@
+# AGENTS.md
+
+内容分发工作流 · v0.1 MVP 验证项目。**任何 AI 编码工具读我之前，先读这四份**：
+
+1. `README.md` — 项目是什么、为什么
+2. `docs/roadmap.md` — 目前在哪个块，前面通过了哪些
+3. 当前活跃的 `blocks/<stage>/<block>/README.md` — 这一块要验证什么
+4. `docs/decisions/` — 已拍板的决策（不要重复讨论已定的）
+
+> 这一份是给所有 AI agent 看的。Claude Code 还会再读 `CLAUDE.md`，那是它自己的额外约定。
+
+## 项目当前阶段
+
+**MVP 块级验证期**。按 `docs/roadmap.md` 里 `Block 0 → Block 1 → ...` 的顺序逐块推进，每块独立验证、独立审稿、独立日志。
+**没经过当前块验证 = 不进下一块**。
+
+## 项目结构
+
+```
+aether/
+├── AGENTS.md              ← 你在这里
+├── CLAUDE.md              ← Claude Code 专用
+├── README.md              ← 项目入口（人读）
+├── docs/
+│   ├── design.md          ← 整体架构设计
+│   ├── architecture.html  ← 架构图
+│   ├── roadmap.md         ← 块级验证路线
+│   └── decisions/         ← ADR（决策记录，编号单调递增）
+├── src/                   ← 跨 block 共享的基础设施
+│   ├── llm.py             ← LLM 抽象层（Anthropic SDK + base_url from env）
+│   ├── db.py              ← psycopg helpers + URL dedup + source upsert
+│   ├── fetcher.py         ← 通用 httpx wrapper
+│   ├── config.py          ← 环境变量集中读取
+│   └── base_subgraph.py   ← LangGraph subgraph ABC + 注册表
+├── blocks/                ← 核心。按 stage 分三大类
+│   ├── _templates/        ← 新块的标准模板
+│   ├── sources/           ← STAGE 1 · 抓源
+│   │   ├── basic/         ← Block 0（最小数据源）
+│   │   ├── multi/         ← Block 1（多源）
+│   │   └── scheduler/     ← Block 2（调度）
+│   ├── rewrite/           ← STAGE 2 · 改写
+│   │   ├── wechat/        ← Block 3（公众号）
+│   │   └── xiaohongshu/   ← Block 4（小红书）
+│   └── publish/           ← STAGE 3 · 发布
+│       ├── e2e/           ← Block 5
+│       ├── dashboard/     ← Block 6
+│       └── platforms/     ← Block 7+
+│           ├── wechat/
+│           └── xiaohongshu/
+│   └── <stage>/<block>/
+│       ├── README.md      ← 这一块验证什么、怎么算通过
+│       ├── prompt.*.md    ← 该块的 prompt（如有）
+│       ├── *.py / *.ts    ← 该块的代码（只放 block 专用逻辑）
+│       ├── samples/       ← 输入样本（git 入仓）
+│       ├── expected/      ← 手写 exemplar —— 期望长什么样
+│       └── runs/          ← 实际跑出来的原始结果（gitignore）
+├── logs/                  ← 按日期的判断记录（人写，每次验证完写一份）
+│   └── YYYY-MM-DD-block-NN-*.md
+├── tests/                 ← 通用测试（shared src/ 跨 block 部分在这里）
+└── scripts/               ← 通用脚本
+```
+
+**约定**：
+- `src/` = 任何 block 都要用 → 基础设施层，稳稳放这里
+- `blocks/<stage>/<block>/` = 单一 stage 内单一 block 的代码 + 配置 + 资产
+- block 里的代码**只放 block 专用逻辑**：parser / state / sources.yaml / subgraph.py
+- 通用件都搬到 `src/`：LLM、DB 连接、httpx fetch、env 配置、LangGraph 基类
+
+## 工作方式（很关键，照做）
+
+- **小颗粒度**：每个块是独立的最小可验证单元。没通过 → 不进下一个。
+- **不扩散范围**：用户明确"一块一块啃"，不要顺便做"这个块也顺手 X 一下"。
+- **每次验证完写日志**：哪怕只写几行，写一份 `logs/YYYY-MM-DD-block-NN-judgment.md`。**没日志 = 没做**。
+- **prompt 在 git、不在 DB**：风格 prompt 是核心资产，进 git 才能回滚、对比、复用。
+- **不要主动 git push / commit**：除非用户明确说"提交"。写完文件等用户审。
+- **不要主动 install 依赖**：除非用户明确说"装"。需要时先问。
+- **遇到不确定的事，先查 `docs/decisions/` 和当前块的 `README.md`** —— 大概率已写。
+- **遇到需要用户物理操作的事**（OAuth 链接、二维码、扫码、MFA 等），先自己尝试（找非交互式 flag、调整顺序、用 `--no-wait` 等），实在需要再明确告诉用户"这步需要你操作"。
+
+## 项目当前状态
+
+**内容领域**：英文营销生态（社媒 / 内容 / SEO / 付费广告 / 综合），目标平台微信公众号 + 小红书。详见 `README.md` 和 `docs/tech-stack.md`。
+
+## 存储分层（很重要，照做）
+
+```
+进 git（可回滚的资产）：
+  blocks/*/sources.yaml          — 源白名单
+  blocks/NN-name/prompt.*.md     — 风格 prompt
+  blocks/NN-name/samples/        — 输入样本
+  blocks/NN-name/expected/       — 手写 exemplar
+  logs/YYYY-MM-DD-*.md           — 判断记录
+  docs/*                         — 设计 + 决策
+
+进 DB（运行时数据）：
+  sources.runtime 字段          — last_fetched_at / agent_status
+  articles                       — 抓回的文章（含 dedup + translate_status）
+  drafts                         — 改写产物（A/B 版本都留）
+  agent_factory                  — 运行时生成的 agent 配置
+  translation_cache              — 多语言 LLM cache
+```
+
+**不要把 sources.yaml 改成 DB 里的硬编码；DB 是 source of truth 状态，yaml 是 source of truth 配置。两边各管一块。**
+
+## Setup
+
+- **Python env**：`conda activate aether`（miniconda3 env，Python 3.12.13，prefix `C:\Users\13107\miniconda3\envs\aether\python.exe`）
+- **包管理**：pip + pyproject.toml（`pip install -e ".[dev]"`；uv.lock 暂留但用 pip 装）
+- **Postgres**：`docker compose up -d db`（详见 ADR-0004 + `docs/tech-stack.md`）
+- **主图编排**：LangGraph 1.2+（拓扑在 `graph.py`，Block 0+ 已经用上）
+- **LLM**：Anthropic Claude Sonnet 4（Block 3+ 启用，`.env` 占位）
+- API key 走 `.env`（不进 git）
+
+## 测试
+
+v0.1 阶段**核心验证靠人的判断 + logs 记录**，不是自动化测试。Block 5+ 才引入 pytest。
+但写代码块时，每个块配 `expected/` 手写 exemplar，作为该块的"事实标准"。
+
+## 风格
+
+- 文件命名：`blocks/<stage>/<block>/`（stage = sources / rewrite / publish；block 短名小写下划线），`logs/YYYY-MM-DD-block-NN-{judgment,pass,fail}.md`，`docs/decisions/NNNN-kebab-case.md`。
+- 代码风格在引入实际代码前不定。
+- 所有 markdown 文件首行 # 标题用人话，不用 `Aether` 这种商标味的名字。
+
+## 决策记录
+
+任何"以后会想回来查"的决策 → 写 `docs/decisions/NNNN-*.md`。**改了决策先加新 ADR，老 ADR 不删**。
+
+## 安全
+
+- API key 走 `.env`（不进 git）。
+- 抓到的原文**不进仓**（版权 + 体积），只进 `blocks/*/samples/` 的精简版。

aether_mkt-0.1.1/CLAUDE.md

@@ -0,0 +1,52 @@
+# CLAUDE.md
+
+Claude Code 专用。和 `AGENTS.md` 配套读，不要重复 AGENTS.md 的内容。
+
+## 速读顺序（每次进项目先做）
+
+1. `AGENTS.md`
+2. `README.md`
+3. `docs/roadmap.md`（看当前 Block）
+4. 当前 Block 的 `blocks/NN-*/README.md`
+
+## 几条 Claude Code 特有的约定
+
+### prompt 编辑
+prompt 是**核心资产**，改了要：
+1. 跑一遍 `samples/`
+2. 跑完写一份 `logs/YYYY-MM-DD-block-NN-judgment.md`
+3. `git diff` 提示用户审
+不要"为了顺手"改 prompt。
+
+### 写代码
+代码落在 `blocks/NN-name/` 下，**不动根目录**。除非用户明确"动其它"。
+
+### 调试风格
+遇到不确定的事：
+1. 先查 `AGENTS.md` 和对应块的 `README.md`
+2. 再查 `docs/decisions/`（说不定 ADR 已写）
+3. 再 google / 看官方文档
+不要直接凭直觉拍命令。
+
+### DB 读写
+
+- 用 `psycopg` 直连（不要 ORM）；ORM 太重，v0.1 阶段没必要
+- schema 在 `db/schema.sql`，改 schema 必须走新 migration 文件 + 改 ADR
+- 查询 articles 时**必须**带 source_id 和/或时间窗，**禁止** `SELECT * FROM articles` 全表拉
+- `psycopg` connection 用 `with` context，进入/退出自动 commit/rollback
+- 事务里**不要**套 LLM 调用 —— 长事务会锁资源
+
+## 不要做（重申 AGENTS.md 的，加上 Claude Code 特化的）
+
+- ❌ 不要自动 `git push` / 自动 commit
+- ❌ 不要自动 `pip install` / `npm install`
+- ❌ 不要跨块推进
+- ❌ 不要扩展范围（"顺便 X 也做了"）
+- ❌ 不要在 root / 改 `.env` / 改 CI 配置
+- ❌ 不要把 source URL 或原文 commit 到仓
+
+## 调试提示
+
+- 用 `cat` 看小文件、`head -n` 看大文件开头、`tail -n` 看结尾
+- 不要 `rm -rf`，统一用 `trash` 工具
+- Windows PowerShell 下用 `Get-ChildItem` / `Select-String`，不要 ls -la / grep

aether_mkt-0.1.1/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: aether-mkt
+Version: 0.1.1
+Summary: 内容分发工作流 v0.1 · 抓取英文营销内容 → 改写成公众号/小红书中文草稿
+License: Proprietary
+Requires-Python: >=3.11
+Requires-Dist: anthropic>=0.40
+Requires-Dist: fastapi>=0.110
+Requires-Dist: httpx>=0.27
+Requires-Dist: jinja2>=3.1
+Requires-Dist: langgraph>=0.2
+Requires-Dist: playwright>=1.40
+Requires-Dist: psycopg[binary]>=3.2
+Requires-Dist: pydantic>=2.7
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: python-multipart>=0.0.9
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: selectolax>=0.3
+Requires-Dist: tenacity>=8.2
+Requires-Dist: uvicorn[standard]>=0.27
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pillow>=10.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# aether
+
+内容分发工作流 v0.1 · MVP 验证期 · LangGraph day-1 编排
+
+## 一句话
+
+把英文优质内容自动抓回来，按微信公众号 + 小红书双平台风格改写成中文草稿，进入人工审核 / 发布。
+第一阶段：单人自用，验证「双平台适配 + 降 AI 味」的核心假设。**真实平台自动发布留到 v0.2+**。
+
+## 一键安装（macOS 用户）
+
+```bash
+brew install postgresql@16 && brew services start postgresql@16 && createdb aether
+pip install aether-mkt
+aether init      # 自动建表 + 引导填 LLM_API_KEY
+aether serve     # launchd 后台跑 web + 自动重启
+# 浏览器 → http://localhost:8000/articles
+```
+
+CLI 命令：`aether {init,serve,stop,update,status,logs,uninstall}`
+完整说明：[docs/install-mac.md](docs/install-mac.md)。
+
+## 业务领域
+
+- **内容来源**：英文营销生态（社媒营销、内容营销、SEO、Google ads、综合营销）——见 `blocks/sources/basic/sources.yaml`
+- **目标平台**：微信公众号（深度长文） + 小红书（图文卡片）
+- **核心差异**：降 AI 味 + 按平台适配的语言风格改写，**不是单纯翻译**
+
+## 路线
+
+按块验证，从最小可验证单元开始。**LangGraph 骨架提前铺**，每个 block = 1 个 subgraph，独立测过再接主图。
+
+详见 [docs/roadmap.md](docs/roadmap.md)。
+
+当前活跃块：**Block 0 · 数据源（最小）**
+
+## 技术栈
+
+- Python 3.11+
+- LangGraph（主图编排，Day 1 起铺）
+- Anthropic SDK（Block 3+ 的 LLM 调用）
+- **PostgreSQL 16**（运行时状态库，详见 ADR-0004）
+- pyyaml（sources 配置）+ selectolax / httpx（Block 0 解析）
+- pytest（测试）
+
+详见 [`pyproject.toml`](pyproject.toml)、[`docs/tech-stack.md`](docs/tech-stack.md)。
+
+## 文档
+
+| 我想知道 | 去看 |
+|---|---|
+| 整个架构设计 | [docs/design.md](docs/design.md) |
+| 架构图（手稿的数字版） | [docs/architecture.html](docs/architecture.html) |
+| 现在做到哪、接下来做什么 | [docs/roadmap.md](docs/roadmap.md) |
+| 已经拍了哪些决策 | [docs/decisions/](docs/decisions/) |
+| 每一块在验证什么 | [blocks/](blocks/) |
+| 每次验证的判断记录 | [logs/](logs/) |
+| 数据源白名单 | [blocks/sources/basic/sources.yaml](blocks/sources/basic/sources.yaml) |
+
+## 协作方式
+
+你是「开发者 + 决策者 + 第一个用户」。AI agent 是协作搭子，**不替你拍板**。
+
+风格 prompt 不能漂 —— 都进 git，可回滚可对比。

aether_mkt-0.1.1/README.md

@@ -0,0 +1,64 @@
+# aether
+
+内容分发工作流 v0.1 · MVP 验证期 · LangGraph day-1 编排
+
+## 一句话
+
+把英文优质内容自动抓回来，按微信公众号 + 小红书双平台风格改写成中文草稿，进入人工审核 / 发布。
+第一阶段：单人自用，验证「双平台适配 + 降 AI 味」的核心假设。**真实平台自动发布留到 v0.2+**。
+
+## 一键安装（macOS 用户）
+
+```bash
+brew install postgresql@16 && brew services start postgresql@16 && createdb aether
+pip install aether-mkt
+aether init      # 自动建表 + 引导填 LLM_API_KEY
+aether serve     # launchd 后台跑 web + 自动重启
+# 浏览器 → http://localhost:8000/articles
+```
+
+CLI 命令：`aether {init,serve,stop,update,status,logs,uninstall}`
+完整说明：[docs/install-mac.md](docs/install-mac.md)。
+
+## 业务领域
+
+- **内容来源**：英文营销生态（社媒营销、内容营销、SEO、Google ads、综合营销）——见 `blocks/sources/basic/sources.yaml`
+- **目标平台**：微信公众号（深度长文） + 小红书（图文卡片）
+- **核心差异**：降 AI 味 + 按平台适配的语言风格改写，**不是单纯翻译**
+
+## 路线
+
+按块验证，从最小可验证单元开始。**LangGraph 骨架提前铺**，每个 block = 1 个 subgraph，独立测过再接主图。
+
+详见 [docs/roadmap.md](docs/roadmap.md)。
+
+当前活跃块：**Block 0 · 数据源（最小）**
+
+## 技术栈
+
+- Python 3.11+
+- LangGraph（主图编排，Day 1 起铺）
+- Anthropic SDK（Block 3+ 的 LLM 调用）
+- **PostgreSQL 16**（运行时状态库，详见 ADR-0004）
+- pyyaml（sources 配置）+ selectolax / httpx（Block 0 解析）
+- pytest（测试）
+
+详见 [`pyproject.toml`](pyproject.toml)、[`docs/tech-stack.md`](docs/tech-stack.md)。
+
+## 文档
+
+| 我想知道 | 去看 |
+|---|---|
+| 整个架构设计 | [docs/design.md](docs/design.md) |
+| 架构图（手稿的数字版） | [docs/architecture.html](docs/architecture.html) |
+| 现在做到哪、接下来做什么 | [docs/roadmap.md](docs/roadmap.md) |
+| 已经拍了哪些决策 | [docs/decisions/](docs/decisions/) |
+| 每一块在验证什么 | [blocks/](blocks/) |
+| 每次验证的判断记录 | [logs/](logs/) |
+| 数据源白名单 | [blocks/sources/basic/sources.yaml](blocks/sources/basic/sources.yaml) |
+
+## 协作方式
+
+你是「开发者 + 决策者 + 第一个用户」。AI agent 是协作搭子，**不替你拍板**。
+
+风格 prompt 不能漂 —— 都进 git，可回滚可对比。

aether_mkt-0.1.1/aether/__init__.py

@@ -0,0 +1,12 @@
+"""aether · 内容分发 v0.1.
+
+PyPI package: ``aether-mkt``   (the hyphenated form is reserved on PyPI)
+CLI command:  ``aether``       (cleaner to type)
+
+Internal modules live under the ``aether`` Python package (Python
+identifiers can't have hyphens), so ``import aether.cli`` works after
+``pip install aether-mkt``.
+"""
+from __future__ import annotations
+
+__version__ = "0.1.0"