524 lines
18 KiB
Markdown
524 lines
18 KiB
Markdown
|
||
**当前支持的 Markdown 语法:**
|
||
|
||
| 语法 | 效果 | 状态 |
|
||
|------|------|------|
|
||
| `#` 一级标题 | 大标题 | ✅ |
|
||
| `##` 二级标题 | 副标题(带下边框) | ✅ |
|
||
| `###` 三级标题 | 章节标题 | ✅ |
|
||
| `####` 四级标题 | 小标题(粗体) | ✅ |
|
||
| `-` / `*` 无序列表 | 圆点列表 | ✅ |
|
||
| `1.` `2.` 有序列表 | 数字列表 | ✅ |
|
||
| `**粗体**` | 加粗 | ✅ |
|
||
| `*斜体*` | 斜体 | ✅ |
|
||
| `` `代码` `` | 行内代码 | ✅ |
|
||
| ` ```代码块``` ` | 代码块 | ✅ |
|
||
| `` | 图片 | ✅ |
|
||
| `[链接](url)` | 超链接 | ✅ |
|
||
| `> 引用` | 引用块 | ✅ |
|
||
| `---` 分割线 | 水平线 | ✅ |
|
||
|
||
**✅ 修改完成!**
|
||
|
||
---
|
||
|
||
**新的端口配置:**
|
||
|
||
| 应用 | 前端 | 后端 |
|
||
|------|------|------|
|
||
| **personal-blog** | **8888** | **8889** |
|
||
|
||
---
|
||
|
||
**访问地址**:http://129.211.173.87:8888/
|
||
|
||
现在端口整整齐齐了:
|
||
- 8888 → personal-blog 前端
|
||
- 8889 → personal-blog 后端
|
||
- 8890 → ai-chatbot-service
|
||
- 8891 → audio-recorder
|
||
- 8892 → album-viewer
|
||
- 8895 → happy-games
|
||
- 8899 → audiobook-player
|
||
-
|
||
---
|
||
|
||
|
||
这是一个很棒的想法!**"一处发布,多处同步"** —— 内容中台的概念。
|
||
|
||
让我先梳理现状,然后给出方案:
|
||
|
||
---
|
||
|
||
## 📋 现有资源梳理
|
||
|
||
### 1. 微信公众号发布技能
|
||
- **路径**:`skills/baoyu-post-to-wechat/`
|
||
- **功能**:图文混排发布、AI配图、多图上传
|
||
- **技术**:WeWrite + 微信公众号API
|
||
|
||
### 2. 个人博客
|
||
- **路径**:`/home/ubuntu/nanocode/personal-blog/`
|
||
- **前端**:http://129.211.173.87:8888/
|
||
- **后端**:http://129.211.173.87:8889/
|
||
- **API**:
|
||
- `POST /api/posts` - 创建文章
|
||
- `POST /api/images` - 上传图片
|
||
- 支持 Markdown、分类、标签
|
||
|
||
---
|
||
|
||
## 🎯 三个可选方案
|
||
|
||
### 方案A:改发布技能(推荐⭐)
|
||
**在微信公众号发布成功后,自动调用博客API插入文章**
|
||
|
||
```
|
||
发布公众号文章
|
||
↓
|
||
WeWrite 发布成功
|
||
↓
|
||
自动调用博客 API
|
||
↓
|
||
博客文章创建成功
|
||
```
|
||
|
||
**优点**:
|
||
- 用户操作不变,一次发布两处同步
|
||
- 复用现有公众号发布流程
|
||
- 图片可以直接转存到博客
|
||
|
||
**缺点**:
|
||
- 需要修改现有技能代码
|
||
|
||
---
|
||
|
||
### 方案B:博客后台"导入"功能
|
||
**在博客后台添加按钮:从微信公众号导入**
|
||
|
||
```
|
||
用户点击"导入公众号文章"
|
||
↓
|
||
输入文章链接/ID
|
||
↓
|
||
后端抓取文章内容
|
||
↓
|
||
创建博客文章草稿
|
||
```
|
||
|
||
**优点**:
|
||
- 不改动发布技能
|
||
- 可以选择性导入,不同步也行
|
||
|
||
**缺点**:
|
||
- 需要手动操作两次
|
||
- 微信文章抓取可能有反爬限制
|
||
|
||
---
|
||
|
||
### 方案C:统一发布中心(终极版)
|
||
**新建一个技能,统一发布到多个平台**
|
||
|
||
```
|
||
统一发布中心
|
||
├── 发布到微信公众号
|
||
├── 发布到个人博客
|
||
├── 发布到小红书(可选)
|
||
└── 发布到知乎(可选)
|
||
```
|
||
|
||
**优点**:
|
||
- 一次编写,多处发布
|
||
- 未来可扩展更多平台
|
||
|
||
**缺点**:
|
||
- 开发工作量大
|
||
- 需要重新设计交互流程
|
||
|
||
---
|
||
|
||
## 💡 我的建议
|
||
|
||
**采用方案A(修改现有发布技能)**,理由:
|
||
1. **即时同步**:发布公众号的同时博客就有了
|
||
2. **图片处理**:公众号的图片可以直接上传到博客服务器
|
||
3. **改动最小**:在现有技能结尾加几行代码即可
|
||
|
||
---
|
||
|
||
## 🔧 具体实现思路
|
||
|
||
### 步骤1:在博客添加"外部导入"标记
|
||
博客文章表添加字段:
|
||
- `source`: "wechat" | "manual" # 文章来源
|
||
- `source_url`: 公众号文章链接(可选)
|
||
|
||
### 步骤2:修改微信公众号发布技能
|
||
在发布成功后:
|
||
```python
|
||
# 1. 下载公众号文章中的图片到博客
|
||
# 2. 转换文章格式(HTML → Markdown)
|
||
# 3. 调用博客 API 创建文章
|
||
```
|
||
|
||
### 步骤3:处理重复发布
|
||
- 首次发布 → 创建博客文章
|
||
- 更新发布 → 更新博客文章(通过标题或slug匹配)
|
||
|
||
---
|
||
|
||
## ❓ 需要您确认的问题
|
||
|
||
1. **同步时机**:发布公众号后立即同步,还是可选同步?
|
||
2. **文章状态**:同步到博客是"已发布"还是"草稿"?
|
||
3. **分类映射**:公众号文章如何确定博客分类?(默认一个分类,还是每次选择?)
|
||
4. **图片处理**:公众号的图片要转存到博客服务器吗?(建议转存,避免微信外链失效)
|
||
|
||
---
|
||
|
||
您倾向哪个方案?或者有什么其他想法?我们可以先确定方案,再详细设计实现细节。
|
||
|
||
|
||
---
|
||
|
||
您说得非常对!让我重新梳理:
|
||
|
||
---
|
||
|
||
## ✅ 正确的流程(修正版)
|
||
|
||
您指出的关键:**微信公众号发布之前,本地已经有 markdown 文件和图片了**。
|
||
|
||
所以正确的顺序是:
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────┐
|
||
│ 1. 本地准备: Markdown文件 + 图片文件夹 │
|
||
│ (这是发布的起点,已经存在) │
|
||
└─────────────────────────────────────────────────────┘
|
||
↓
|
||
┌───────────────┴───────────────┐
|
||
↓ ↓
|
||
┌──────────────────────┐ ┌──────────────────────────┐
|
||
│ 2. 插入个人博客 │ │ 3. 发布微信公众号 │
|
||
│ - 上传图片到博客 │ │ - 上传图片到微信 │
|
||
│ - 创建文章草稿/发布 │ │ - 发布文章 │
|
||
│ - source: "wechat" │ │ - 获取文章URL │
|
||
│ - source_url: 空 │ │ │
|
||
└──────────────────────┘ └──────────────────────────┘
|
||
↓
|
||
┌─────────────────────────────────────────────────────┐
|
||
│ 4. [可选] 回填 source_url │
|
||
│ 更新博客文章,填入微信公众号文章链接 │
|
||
└─────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 🔄 关于步骤1的实现方案
|
||
|
||
您提到的问题很关键:**博客先发布时,还不知道公众号链接**。
|
||
|
||
### 方案A:不填 source_url(最简单)
|
||
- 博客文章创建时不记录来源
|
||
- 只把内容同步过去
|
||
- 以后手动查公众号文章,与博客无关
|
||
|
||
### 方案B:延迟回填(您提到的)
|
||
- 博客先创建,`source_url` 留空
|
||
- 公众号发布成功后,用 **标题** 或 **slug** 找到博客文章
|
||
- 更新 `source_url` 字段
|
||
|
||
### 方案C:临时标记(推荐)
|
||
- 博客创建时:`source = "wechat_pending"`,`source_url = null`
|
||
- 公众号发布后:`source = "wechat"`,`source_url = "https://mp.weixin..."`
|
||
|
||
---
|
||
|
||
## 🤔 我的建议
|
||
|
||
结合您说的**不管重复发布问题**,我建议:
|
||
|
||
### 最小可行方案(MVP)
|
||
|
||
```
|
||
1. 读取本地 Markdown + 图片
|
||
↓
|
||
2. 【并行或串行,互不影响】
|
||
├── A. 调用博客API创建文章(不管成功与否)
|
||
└── B. 发布到微信公众号(现有流程)
|
||
↓
|
||
3. 结束(不处理回填、不处理重复)
|
||
```
|
||
|
||
**特点**:
|
||
- 博客和公众号是**两条独立支线**
|
||
- 博客失败不影响公众号
|
||
- 公众号失败不影响博客
|
||
- 重复了就手动删,简单直接
|
||
|
||
---
|
||
|
||
## ❓ 待确认
|
||
|
||
1. **图片处理**:本地图片要上传到博客服务器吗?(建议上传,避免外链失效)
|
||
|
||
2. **分类默认**:同步到博客时,分类怎么定?
|
||
- 方案1:默认"未分类",后台手动改
|
||
- 方案2:发布前弹窗选择分类
|
||
|
||
3. **发布时间**:博客文章时间用什么时候?
|
||
- 方案1:实际插入时间
|
||
- 方案2:和公众号发布时间保持一致
|
||
|
||
4. **是否回填 source_url**?(我个人觉得可以先不做,保持简单)
|
||
|
||
---
|
||
|
||
您觉得这个修正后的方案如何?还需要调整哪里?
|
||
|
||
## ✅ 方案实施完成!
|
||
|
||
### 📋 实现的功能
|
||
|
||
**公众号 + 博客双平台同步 v4.0**
|
||
|
||
### 🔧 新增/修改的文件
|
||
|
||
| 文件 | 说明 |
|
||
|------|------|
|
||
| `blog_sync.py` | 新增博客同步模块 |
|
||
| `baoyu_optimized.py` | 修改,添加博客同步调用 |
|
||
| `SKILL.md` | 更新文档,添加 v4.0 功能说明 |
|
||
|
||
### 🔄 工作流程
|
||
|
||
```
|
||
用户发布 Markdown 到公众号
|
||
↓
|
||
1. 自动同步到博客(独立支线)
|
||
- 复制图片到 uploads/ 目录
|
||
- 创建博客文章(已发布,无分类)
|
||
↓
|
||
2. 继续发布到公众号(独立支线)
|
||
- 原有流程不变
|
||
↓
|
||
3. 两处都有文章!
|
||
```
|
||
|
||
### ✅ 验证结果
|
||
|
||
```
|
||
博客同步成功!
|
||
文章ID: 1
|
||
访问: http://129.211.173.87:8888/post/公众号同步博客测试-04061658
|
||
```
|
||
|
||
### 📝 使用方式
|
||
|
||
**和以前一样,无变化:**
|
||
```bash
|
||
python3 baoyu_optimized.py markdown article.md --title "标题" --author "作者"
|
||
```
|
||
|
||
会自动同步到博客,无需额外操作。
|
||
|
||
### 🔑 关键特性
|
||
|
||
1. **独立支线**:博客失败不影响公众号,公众号失败不影响博客
|
||
2. **图片转存**:自动复制到博客服务器,生成缩略图
|
||
3. **无分类**:默认不设置分类,后台可手动调整
|
||
4. **重复处理**:每次发布都创建新文章,重复可后台删除
|
||
|
||
---
|
||
|
||
## 📋 实现方式:**直接操作数据库**(绕过 API)
|
||
|
||
```python
|
||
┌─────────────────────────────────────────────────────────┐
|
||
│ 公众号发布流程 │
|
||
├─────────────────────────────────────────────────────────┤
|
||
│ 1. 读取 Markdown 文件 │
|
||
│ 2. 解析 frontmatter │
|
||
│ 3. 处理图片 → 复制到 /uploads 目录 │
|
||
│ 4. 【博客同步】直接操作 SQLite 数据库 │
|
||
│ ↓ │
|
||
│ from database import SessionLocal │
|
||
│ from models import Post │
|
||
│ db.add(new_post) # 直接插入 │
|
||
│ db.commit() │
|
||
│ ↓ │
|
||
│ 5. 【公众号发布】调用微信 API │
|
||
│ 上传图片 → 创建草稿 │
|
||
└─────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
## 🔑 关键代码(第241-291行)
|
||
|
||
```python
|
||
def _create_post_via_db(self, post_data: Dict) -> Dict:
|
||
"""
|
||
直接操作数据库创建文章(绕过 JWT 认证)
|
||
"""
|
||
# 临时添加博客后端路径
|
||
sys.path.insert(0, "/home/ubuntu/nanocode/personal-blog/backend")
|
||
|
||
from database import SessionLocal
|
||
from models import Post
|
||
|
||
db = SessionLocal()
|
||
|
||
# 直接插入数据库,无需 JWT Token
|
||
new_post = Post(
|
||
title=post_data['title'],
|
||
content=post_data['content'],
|
||
slug=post_data['slug'],
|
||
is_published=True, # 直接发布
|
||
is_draft=False,
|
||
category_id=None, # 不设置分类
|
||
...
|
||
)
|
||
|
||
db.add(new_post)
|
||
db.commit()
|
||
```
|
||
|
||
## 🤔 为什么这样设计?
|
||
|
||
| 方案 | 优点 | 缺点 |
|
||
|------|------|------|
|
||
| **调用 8889 API** | 架构规范,统一入口 | 需要 JWT Token,需要维护登录状态 |
|
||
| **直接操作数据库** ✅ | 简单直接,无需认证 | 耦合度高,依赖文件路径 |
|
||
|
||
**选择直接操作数据库的原因**:
|
||
1. **简化流程**:不需要先登录获取 Token
|
||
2. **可靠性**:API 认证可能因为 token 过期失败
|
||
3. **性能**:减少一次 HTTP 请求
|
||
|
||
## 🖼️ 图片处理方式
|
||
|
||
```
|
||
本地图片
|
||
↓
|
||
复制到 /home/ubuntu/nanocode/personal-blog/backend/uploads/
|
||
↓
|
||
生成缩略图 (thumbnails/thumb_xxx.jpg)
|
||
↓
|
||
Markdown 中的路径替换为 /uploads/xxx.png
|
||
↓
|
||
保存到数据库
|
||
```
|
||
|
||
---
|
||
|
||
**总结**:博客同步是直接操作 SQLite 数据库,**没有调用 8889 API**,这样可以绕过 JWT 认证,更简单可靠。
|
||
|
||
|
||
---
|
||
|
||
开始新对话。继续这个博客项目。实现“分类管理”功能。
|
||
0、后台,分类的增加,修改,删除。
|
||
删除分类的时候,将文章关联的分类属性清除掉,但是文章本身不要删除。
|
||
后台的“文章管理”里面的文章列表,每个文章的分类属性,应该列在后面(文章列表里面的每个文章item后面)。
|
||
|
||
1、创建/修改博客的时候,可以选择分类。
|
||
2、首页, 最上面的“我的博客”旁边,放置后台生成的**分类**,最多展示5个分类,如果多于5个分类,第5个分类旁边有一个 ** : (应该是竖立的3个点 的图标)** ,点击这个图片,旁边浮起一个菜单,显示剩余的 分类。
|
||
|
||
3、首页,点击任何一个分类,正文部分按照分类,重新加载博客列表。。在首页点击, 最上面的“我的博客”则恢复到现实全部博客。
|
||
|
||
以上需求,有没有问题??
|
||
|
||
|
||
|
||
|
||
|
||
使用方案1,但是实现步骤可以讨论,我说一下关于你的几个步骤:
|
||
关于步骤2: 微信公众号发布之前,是不是本地已经有了markdown文件,及图片。如果有的话,直接将这些内容插入博客系统,而不要等公众号发布成功了再添加博客??这个说法,你研究一下,是否正确?
|
||
关于步骤3:不管 重复发布 的问题。简化起见,这样可能存在博客重复的问题。 我到博客后台,手工处理删除就号。
|
||
关于步骤1:如果是博客 先发布,则牵涉到 `source_url`: 公众号文章链接 的问题!!!! 需要找到之前发布的博客,修改字段。
|
||
|
||
|
||
以上我的理解,你仔细看看,有什么补充和建议?
|
||
|
||
实施建议:
|
||
1、博客api应该是需要登录的!!!! 如果现有的博客api不满足同步需求,先添加localhost的博客 api(这样就不需要登录)
|
||
2、测试localhost的本地api能够正常操作
|
||
3、修改公众号发布技能
|
||
4、测试完整流程
|
||
|
||
你看是否合理
|
||
|
||
|
||
|
||
---
|
||
|
||
我希望能够在博客的管理后台,将某个页面采集到我的博客。具体要求:
|
||
1、文章管理模块,**写文章**按钮旁边,添加一个按钮**采集文章**,点击**采集文章** 弹出窗口,用户输入 要采集的文章链接,点击窗口上的**采集**,调用后台的采集功能
|
||
2、采集功能要求,通过通用的采集流程(比如你刚刚说的web_fetch,或者其他采集工具,我不确定markitdown/`markitdown-converter` 是否也能完成任意页面的采集能力,我不知道 ),将文章采集下来(到/tmp目录可能更合适,这样系统可以自动清理垃圾文件)。
|
||
|
||
采集下来怎么办? 回填到 后台的新建文章的界面即**写文章**界面(也许也许你会使用一个新页面,你考虑一下),回填表单内容最好类似于**写文章**,在这个采集界面,包含了本地下载下来的markdown内容,和图片,标题等信息。 我可以立即保存,或者修改后保存,修改标题,修改分类,替换图片等等都可以。当然如果我关掉界面,就不要自动保存了。
|
||
|
||
我点击保存至少,就使用类似于写文章的流程,生成一个新文章。
|
||
|
||
|
||
---
|
||
|
||
以上需求,是否清晰,你是否需要分步骤实施?
|
||
|
||
---
|
||
需求非常清晰!这是一个**文章采集+编辑+发布**的完整工作流。让我分步骤实施:
|
||
|
||
## 实施计划
|
||
|
||
| 步骤 | 内容 | 文件 |
|
||
|------|------|------|
|
||
| 1 | 后端API:创建 `/api/crawl` 采集接口 | `backend/routers/crawl.py` |
|
||
| 2 | 前端:文章管理页添加"采集文章"按钮 | `frontend/src/pages/admin/Posts.jsx` |
|
||
| 3 | 前端:创建采集结果编辑页面 | `frontend/src/pages/admin/CrawlEdit.jsx` |
|
||
| 4 | 前端:添加路由 | `frontend/src/App.jsx` |
|
||
|
||
让我开始实施:
|
||
|
||
|
||
后端正常运行。总结修复内容:
|
||
|
||
---
|
||
|
||
## ✅ 问题已修复
|
||
|
||
### 问题1: "Method Not Allowed" 保存失败
|
||
**原因**: 后端路由 `@router.post("/")` 与前端请求 `/api/posts`(无斜杠)不匹配
|
||
**修复**: 改为 `@router.post("")`
|
||
|
||
### 问题2: 图片显示 "图片4"、"图片5" 失败
|
||
**原因**: 网站混用 `http://` 和 `https://`,浏览器阻止HTTP图片加载
|
||
**修复**: 自动将HTTP图片URL升级为HTTPS
|
||
|
||
**修改文件**: `backend/routers/crawl.py` 和 `backend/routers/posts.py`
|
||
|
||
---
|
||
|
||
### 修改详情
|
||
|
||
```python
|
||
# 1. 图片提取 - 自动升级HTTPS
|
||
if base_is_https and img_url.startswith('http://'):
|
||
img_url = 'https://' + img_url[7:]
|
||
|
||
# 2. HTML转Markdown - 同样处理
|
||
if base_is_https and src.startswith('http://'):
|
||
src = 'https://' + src[7:]
|
||
|
||
# 3. 创建文章路由 - 去斜杠
|
||
@router.post("") # 原来是 @router.post("/")
|
||
```
|
||
|
||
现在可以重新采集 https://beforweb.com/node/1151,图片应该能正常显示了!
|
||
|
||
---
|
||
|
||
# 连 微信文章都可以采集,牛逼
|
||
|
||
https://mp.weixin.qq.com/s?__biz=MzIyMTU0NDMyNA==&mid=2247489863&idx=1&sn=84ca54db4590e2ff92972358ef79f4db&chksm=e83a73acdf4dfaba274026a74c680977a4fb9ab762ceaf5f433c8e94235dc64e6e0a84e80c8a&mpshare=1&scene=1&srcid=0425TRtndL1dYbMiPyv9CkmG&pass_ticket=YrraiocaVOrY2rsz3jvMys6N2SXFYlp8nwSWNbYkn4%2BsN%2BtItnpmtvnfKM7SHwRo#rd
|
||
|