AI 编程 - 开发微信公众号阅读助手工具

帮我编写一份产品需求文档（PRD）。请基于如下构建的内容和PRD的目录结构编写，并提供可以复制或下载的Markdown版本。



**1. 构建的内容**

这是一个用于采集微信公众号历史文章列表并支持下载文章的Web应用项目。



需要包含的功能需求如下：

- 提供一个公众号管理页面，用于录入和编辑公众号的信息
  - 点击新增公众号按钮，弹出公众号信息录入界面
    - 手工录入公众号信息
    - 自动获取公众号信息（通过微信公众平台账号搜索接口https://mp.weixin.qq.com/cgi-bin/searchbiz获取）
      - 输入公众号名称后点搜索时，遇到公众号登录态失效时，弹出微信公众平台（https://mp.weixin.qq.com/）的二维码，扫码登录后，保存登录态下次使用

  - 点击公众号列表对应的采集按钮，可以获取指定公众号的历史文章信息（支持采集单页、采集全部）
    - 采集公众号列表时，遇到公众号登录态失效时，弹出微信公众平台（https://mp.weixin.qq.com/）的二维码，扫码登录后，保存登录态下次使用

- 提供一个公众号文章页面，用于展示公众号历史文章列表
  - 支持筛选
  - 选择文章，可以下载选择的文章（支持单选、全选）
    - 在下载选中文章时，先检查是否有以“公众号名称”命名的文件夹，没有的话先创建文件夹，然后将下载的文章保存在这个文件夹下

- 提供命令行下载指定公众号文章链接（支持以文件方式提供公众号文章链接）



项目结构如下：

```shell
wechat-article-assistant/
├── src/
│   └── wechat_article_assistant/
├── tests/
├── docs/
├── requirements.txt
├── pyproject.toml
├── .env.example
├── README.md
├── .gitignore
└── LICENSE
```



需要使用的技术栈如下：

- 后端框架：Flask (Python 3.12+)
- 前端样式：Tailwind CSS (CDN加载)
- 数据库：SQLite
- ORM：SQLAlchemy
- 配置管理：python-dotenv
- 依赖管理：uv
- 代码格式：Ruff
- 类型检查：mypy
- 测试框架：pytest



数据模型如下：

- 公众号列表（wechat_list）

| 字段中文名称      | 字段英文名称   | 字段类型     | 字段是否为空说明 |
| ----------------- | -------------- | ------------ | ---------------- |
| 序号              | id             | int          | NOT NULL         |
| 公众号唯一标识    | fakeid         | varchar(100) | NULL             |
| 公众号名称        | nickname       | varchar(50)  | NULL             |
| 公众号别名        | alias          | varchar(50)  | NULL             |
| 公众号圆形头像URL | round_head_img | varchar(200) | NULL             |
| 公众号类型        | service_type   | varchar(10)  | NULL             |
| 公众号签名        | signature      | varchar(200) | NULL             |
| 公众号认证状态    | verify_status  | varchar(10)  | NULL             |
| 备注              | memo           | varchar(200) | NULL             |
| 单页起始位置      | begin          | int          | NULL             |
| 单页采集数量      | count          | int          | NULL             |
| 采集状态          | collect_status | varchar(50)  | NULL             |
| 创建时间          | create_time    | timestamp    | NULL             |
| 更新时间          | update_time    | timestamp    | NULL             |

- 公众号文章列表（wechat_article_list）

| 字段中文名称 | 字段英文名称        | 字段类型     | 字段是否可以为空 |
| ------------ | ------------------- | ------------ | ---------------- |
| 序号         | id                  | int          | NOT NULL         |
| 公众号列表ID | wechat_list_id      | int          | NULL             |
| 公众号名称   | nickname            | varchar(50)  | NULL             |
| 文章ID       | article_id          | varchar(50)  | NULL             |
| 文章标题     | article_title       | varchar(50)  | NULL             |
| 文章封面     | article_cover       | varchar(200) | NULL             |
| 文章链接     | article_link        | varchar(200) | NULL             |
| 文章作者     | article_author_name | varchar(20)  | NULL             |
| 文章是否删除 | article_is_deleted  | varchar(10)  | NULL             |
| 文章创建时间 | article_create_time | timestamp    | NULL             |
| 文章更新时间 | article_update_time | timestamp    | NULL             |
| 是否下载     | is_downloaded       | varchar(10)  | NULL             |
| 创建时间     | create_time         | timestamp    | NULL             |
| 更新时间     | update_time         | timestamp    | NULL             |



**2. PRD 目录结构**

- 执行概要（Executive Summary）
- 功能需求（Features）
- 技术架构（Technologies Used）
- 数据模型（Database Schema）
- API 端点（API Endpoints）
- 项目结构（Project Structure）
- 页面设计（UI）
- 非功能性需求



我会使用 AI copilot 来构建这个应用。

如果你有任何需要澄清的问题，可以问我。

如果你有任何需要我补充的信息，可以向我提出。

在公众号管理中，自动获取，出现如下问题，运行日志如下，请解决。对话、修改代码等尽量使用中文。

问题：

- 在启动的浏览器上扫码成功后，启动的浏览器没有关闭，“微信公众平台登录”弹框没有变化
- “微信公众平台登录”弹框的“登录二维码“没有加载成功

日志：

如果你有任何需要澄清的问题，可以问我。

如果你有任何需要我补充的信息，可以向我提出。

flowchart TD
    A[新增公众号] --> B[自动获取]
    B --> C[搜索公众号]
    C --> D{检查ben'di是否存在会话}
    D -->|是| E[复用会话]
    D -->|否| F[启动浏览器]
    E --> G{会话是否有效}
    G -->|是| H[结束]
    G -->|否| F
    F --> I[扫码登录]
    I --> J[保存会话]
    J --> H

请在"文章列表"页面增加"获取最近5次发的文章"的功能，具体需求如下：

- 在"文章列表"页面增加"获取最近5次发的文章"的按钮，按钮放在"下载选中"按钮的左边

- 点击"获取最近5次发的文章"，每次获取所有公众号最近5次发的文章（起始位置为0，采集数量为5）

- 参考"公众号管理"页面中的"单页采集"的实现



"文章列表"页面: article_list.html

"公众号管理"页面: wechat_list.html

请制定实现如下需求的计划，待我确认后再实施。

如果你有任何需要澄清的问题，可以问我。