docs: 文档清理与重构 — 统一为 3 个核心文档

- 删除 5 个过时/残留文档(project_plan/agent_prompt/optimization_plan/report_db_design/deploy/README)
- 新建 docs/architecture.md(项目架构:11 包职责+数据模型+配置+产物)
- 重写 docs/user-guide.md(CLI 全量+增量/断点续跑+MCP+FAQ)
- 重写 README.md(精简入口+文档索引)
- 更新 continuation.md(追加本次记录)
- 更新 .gitignore(排除 data/* 运行产物)
This commit is contained in:
2026-08-22 17:10:39 +08:00
commit 65ead54b4f
101 changed files with 21093 additions and 0 deletions
+24
View File
@@ -0,0 +1,24 @@
[Unit]
Description=A 股 Deep Research 定时调度
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
User=pi
Group=pi
WorkingDirectory=/home/pi/cc-projects/news
ExecStart=/home/pi/cc-projects/news/.venv/bin/python -m scripts.run_scheduler
Restart=always
RestartSec=30
# 日志
StandardOutput=append:/home/pi/cc-projects/news/logs/scheduler-stdout.log
StandardError=append:/home/pi/cc-projects/news/logs/scheduler-stderr.log
# 环境变量
Environment="PATH=/home/pi/cc-projects/news/.venv/bin:/usr/local/bin:/usr/bin:/bin"
Environment="TZ=Asia/Shanghai"
[Install]
WantedBy=multi-user.target
+41
View File
@@ -0,0 +1,41 @@
# A 股 Deep Research 定时调度 (crontab)
# 替代 APScheduler 守护进程,更简单可靠
#
# 安装: crontab deploy/crontab.example
# 查看: crontab -l
# 编辑: crontab -e
# 清空: crontab -r
#
# 日志: logs/scheduler-cron.log
SHELL=/bin/zsh
PATH=/usr/local/bin:/usr/bin:/bin
TZ=Asia/Shanghai
# 注意: 所有命令的 --date 使用 "" (cron 运行时自动取当天)
# ============================================================
# 每日 4 次定时任务
# ============================================================
# 07:00 — 首次抓取 + 日报
0 7 * * * cd /Users/summer/Downloads/cc-projects/news && uv run a-share pipeline --once --report --steps crawler,extractor,dedup,llm,embedding,qdrant >> logs/scheduler-cron.log 2>&1
# 12:00 — 午间补充抓取(不含日报)
0 12 * * * cd /Users/summer/Downloads/cc-projects/news && uv run a-share pipeline --once --steps crawler,extractor,dedup,llm,embedding,qdrant >> logs/scheduler-cron.log 2>&1
# 18:00 — 收盘后抓取(不含日报)
0 18 * * * cd /Users/summer/Downloads/cc-projects/news && uv run a-share pipeline --once --steps crawler,extractor,dedup,llm,embedding,qdrant >> logs/scheduler-cron.log 2>&1
# 22:00 — 晚间抓取(不含日报)
0 22 * * * cd /Users/summer/Downloads/cc-projects/news && uv run a-share pipeline --once --steps crawler,extractor,dedup,llm,embedding,qdrant >> logs/scheduler-cron.log 2>&1
# ============================================================
# cninfo 公告管道(每日 06:30,日报前)
# ============================================================
# 30 6 * * * cd /Users/summer/Downloads/cc-projects/news && uv run a-share pipeline --cninfo-once >> logs/scheduler-cron.log 2>&1
# ============================================================
# 个股日报(每日 07:30,日报之后)
# ============================================================
# 30 7 * * * cd /Users/summer/Downloads/cc-projects/news && uv run a-share stock-report >> logs/scheduler-cron.log 2>&1