Merge dev into main

# Conflicts:
#	README.md
#	docs/README.md

Author: zhaoolee

.github/workflows/main.yml

@@ -5,6 +5,7 @@ on:
   push:
     branches:    
       - main
+      - dev
 jobs:
   push:
       runs-on: ${{ matrix.operating-system }}
@@ -24,12 +25,32 @@ jobs:
         run: pip3 install --user pipenv
       - name: Install dependecies
         run:  pipenv --python python3 && pipenv install
+      - name: Start GARSS Studio RSSHub proxy
+        env:
+          ACCESS_CODE: banana
+          SCHEDULER_ENABLED: "false"
+        run: docker compose -f garss-studio/docker-compose.yml up --build -d
+      - name: Wait for GARSS Studio
+        run: |
+          for i in {1..60}; do
+            if curl -fsS http://127.0.0.1:25173/api/health; then
+              exit 0
+            fi
+            sleep 2
+          done
+          docker compose -f garss-studio/docker-compose.yml logs
+          exit 1
       - name: Build
         env:
             USER: ${{ secrets.USER }}
             PASSWORD: ${{ secrets.PASSWORD }}
             HOST: ${{ secrets.HOST }}
+            GARSS_STUDIO_BASE_URL: http://127.0.0.1:25173
+            GARSS_STUDIO_ACCESS_CODE: banana
         run: pipenv run build
+      - name: Stop GARSS Studio RSSHub proxy
+        if: always()
+        run: docker compose -f garss-studio/docker-compose.yml down
       - name: Commit and push if changed   # 更新README.md
         run: |
           git diff

.gitignore

@@ -1,4 +1,9 @@
 secret.json
 local_secret.json
 .DS_Store
-./README.md
+./README.md
+garss-studio/.playwright-cli
+.playwright-cli
+__pycache__/
+*.pyc
+garss-studio/.tmp-chrome-mcp-client.mjs

AGENTS.md

@@ -0,0 +1,65 @@
+# AGENTS
+
+本仓库当前主要维护的交互项目是 `garss-studio/`。
+
+## 工作入口
+
+- 如果任务和 RSS 阅读器、订阅源管理、Docker 部署、`EditREADME.md` 自动导入有关，优先进入 `garss-studio/`
+- 进入后先看：
+  - `garss-studio/AGENTS.md`
+  - `garss-studio/PROJECT_MEMORY.md`
+  - `garss-studio/README.md`
+
+## 当前全局约定
+
+- 不要把后端或 RSSHub 直接暴露到宿主机，外部入口应保持单端口
+- `EditREADME.md` 是规范化的数据源，不要用大模型人工提取替代脚本解析
+- 如果要同步 `EditREADME.md`，优先使用 `garss-studio/scripts/sync-editreadme.mjs`
+
+## garss-studio 启动方式
+
+开发环境：
+
+```bash
+cd garss-studio
+cp .env.example .env
+docker compose -f docker-compose.dev.yml up --build
+```
+
+开发环境默认只暴露单端口入口：
+
+```text
+http://127.0.0.1:25173/reader?pw=banana
+```
+
+开发 compose 默认 `SCHEDULER_ENABLED=false`，避免启动时自动全量拉取；如需验证自动调度：
+
+```bash
+SCHEDULER_ENABLED=true docker compose -f docker-compose.dev.yml up --build
+```
+
+生产环境：
+
+```bash
+cd garss-studio
+cp .env.example .env
+docker compose up --build -d
+```
+
+生产环境入口同样是：
+
+```text
+http://127.0.0.1:25173/reader?pw=banana
+```
+
+停止命令：
+
+```bash
+docker compose -f docker-compose.dev.yml down
+docker compose down
+```
+
+## 文档分工
+
+- `PROJECT_MEMORY.md`：记录长期产品决策和上下文
+- `AGENTS.md`：记录后续 agent 的工作入口、约束和推荐动作

EditREADME.md

@@ -0,0 +1,15 @@
+# Project Memory
+
+当前仓库里持续演进的交互项目是 `garss-studio/`。
+
+如果后续对话涉及 RSS 阅读器、订阅源管理、Docker 单端口部署、`EditREADME.md` 自动导入，请优先查看：
+
+- `garss-studio/README.md`
+- `garss-studio/PROJECT_MEMORY.md`
+
+当前已经固化的关键约定：
+
+- GARSS Studio 通过 Docker 只暴露一个端口：`25173`
+- 订阅源支持两种输入：RSSHub 路径和完整 RSS URL
+- `EditREADME.md` 的分类表格可通过 `garss-studio/scripts/sync-editreadme.mjs` 自动导入
+- 管理页按“左侧分类，右侧订阅源”布局显示