84 lines
2.6 KiB
Markdown
84 lines
2.6 KiB
Markdown
---
|
|
gsd_state_version: 1.0
|
|
milestone: v1.2
|
|
milestone_name: Zhihu Crawler
|
|
status: planning
|
|
stopped_at: Defining requirements
|
|
last_updated: "2026-03-17T10:00:00.000Z"
|
|
last_activity: 2026-03-17 — Milestone v1.2 started
|
|
progress:
|
|
total_phases: 0
|
|
completed_phases: 0
|
|
total_plans: 0
|
|
completed_plans: 0
|
|
percent: 0
|
|
---
|
|
|
|
# Project State
|
|
|
|
## Project Reference
|
|
|
|
See: .planning/PROJECT.md (updated 2026-03-17)
|
|
|
|
**Core value:** 可靠、可维护的处理管道 - 每个步骤独立、可验证、可恢复
|
|
**Current focus:** v1.2 Zhihu Crawler — 需求定义中
|
|
|
|
## Current Position
|
|
|
|
Phase: Not started (defining requirements)
|
|
Plan: —
|
|
Status: Defining requirements
|
|
Last activity: 2026-03-17 — Milestone v1.2 started
|
|
|
|
Progress: [░░░░░░░░░░] 0% (v1.2 milestone)
|
|
|
|
## Performance Metrics
|
|
|
|
**Velocity:**
|
|
- Total plans completed: 0 (v1.2)
|
|
- Average duration: —
|
|
- Total execution time: —
|
|
|
|
## Accumulated Context
|
|
|
|
### Decisions
|
|
|
|
Key decisions from v1.0 (preserved):
|
|
- 管道模型 — BaseProcessor + Pipeline 架构
|
|
- 步骤级状态 — WorkflowStateManager
|
|
- Schema 验证 — Pydantic v2
|
|
- 顺序执行 — 简单性和可调试性
|
|
- CLI subparsers — 可扩展命令结构
|
|
|
|
v1.1 decisions:
|
|
- 中间目录统一到 `~/work/intermediate/analysis/`
|
|
- 归档只保留 md 文件，不归档 json 文件
|
|
- 最终目录按平台分组，不再按时间创建子目录
|
|
- [Phase 05]: Archive step is always last in pipeline, only md files archived
|
|
- [Phase 05]: Duplicate detection uses glob pattern *_{content_id}_analysis.md with user overwrite confirmation
|
|
- [Phase 05]: Mock _ask_overwrite in tests to avoid stdin blocking
|
|
- [Phase 05]: Patch get_settings at kb_pipeline.processors.base module level for tests
|
|
- [Phase 06]: Rename kb-workflow to kb_workflow for Python package compatibility
|
|
- [Phase 06]: Standard imports from kb_workflow.metadata instead of sys.path manipulation
|
|
- [Phase 06-code-consolidation]: Use absolute imports (kb_workflow.pipeline.xxx) for all pipeline modules
|
|
- [Phase 06-03]: External dependencies (kb-deep-analyzer) use lazy sys.path manipulation inside methods, not at module top-level
|
|
- [Phase 06-03]: Pipeline class exported at package level for cleaner imports
|
|
|
|
v1.2 decisions:
|
|
- 知乎登录策略：二维码扫码 + 手动 Cookie 降级
|
|
- 参考 MediaCrawler 实现，自实现而非直接依赖
|
|
- 使用 playwright 作为浏览器自动化框架
|
|
- 整合进现有 Pipeline 架构
|
|
|
|
### Blockers/Concerns
|
|
|
|
None.
|
|
|
|
## Session Continuity
|
|
|
|
Last session: 2026-03-17T10:00:00.000Z
|
|
Stopped at: Defining requirements
|
|
Resume file: None
|
|
|
|
**Next step:** Define requirements → Create roadmap
|