# right-068/analyze-historic-place-vitality architecture

> Architecture diagram of the GitHub repository right-068/analyze-historic-place-vitality, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/right-068/analyze-historic-place-vitality
- Repository: https://github.com/right-068/analyze-historic-place-vitality

## Overview

该仓库是面向历史文化街区等地点的公开网络活力研究 Skill，当前主版本位于根目录 scripts。主流程从研究者确定地点并生成检索计划开始，经公开网页检索、Worker 输出治理和证据审计，进入七维分析、复核与评分，最后生成 DOCX/XLSX 和机器可读审计结果。图中主要阶段依据 README 能力描述，模块职责依据脚本名称；未检查相关脚本源码，因此只表达文档所述的数据流程，不推断函数调用或未证实的模块连线。

Main entry points: [`scripts/dimension_evidence.py`](https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/dimension_evidence.py) (逐维证据), [`scripts/quantify_text_semantics.py`](https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/quantify_text_semantics.py) (语义量化), [`scripts/merge_worker_outputs.py`](https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/merge_worker_outputs.py) (结果归并), [`scripts/audit_evidence.py`](https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/audit_evidence.py) (证据审计)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_research["检索与调度"]
  node_query_plan["检索计划"]
  node_swarm_plan["Worker 计划"]
  node_worker_contract["Worker 合同<br/>[worker_contract.py]"]
  node_worker_validation["Worker 校验"]
  node_worker_merge["结果归并"]
  node_run_state[("运行状态")]
end

subgraph group_evidence["证据治理"]
  node_evidence_audit["证据审计<br/>[audit_evidence.py]"]
  node_swarm_provenance["来源链审计"]
  node_review_coding["复核编码"]
  node_review_resolution["复核处置"]
end

subgraph group_analysis["评价分析"]
  node_dimension_evidence["逐维证据"]
  node_dimension_framework["七维框架"]
  node_formal_scoring["正式评分<br/>[formal_scoring.py]"]
  node_score_calculation["评分计算"]
  node_semantic_analysis["语义量化"]
  node_protocol_calibration["协议校准"]
end

subgraph group_delivery["交付验收"]
  node_docx_report["DOCX 报告"]
  node_research_workbook["证据工作簿"]
  node_semantic_workbook["规则工作簿"]
  node_deliverable_validation["交付验收"]
end

node_researcher(("研究者"))
node_public_web(("公开网页"))

node_researcher -->|"提供地点"| node_query_plan
node_query_plan -->|"指导检索"| node_public_web
node_researcher -->|"配置研究"| node_swarm_plan
node_swarm_plan -->|"约束输出"| node_worker_contract
node_public_web -->|"检索材料"| node_worker_validation
node_worker_contract -->|"校验合同"| node_worker_validation
node_worker_validation -->|"验证输出"| node_worker_merge
node_worker_merge -->|"提交证据"| node_evidence_audit
node_worker_merge -->|"提交来源链"| node_swarm_provenance
node_evidence_audit -->|"审计证据"| node_dimension_evidence
node_dimension_framework -->|"界定维度"| node_dimension_evidence
node_dimension_evidence -->|"待复核项"| node_review_coding
node_review_coding -->|"提交复核"| node_review_resolution
node_review_resolution -->|"确认评分资格"| node_formal_scoring
node_formal_scoring -->|"正式评分输入"| node_score_calculation
node_protocol_calibration -->|"提供锁定规则"| node_semantic_analysis
node_dimension_evidence -->|"公众感知证据"| node_semantic_analysis
node_score_calculation -->|"评分结果"| node_docx_report
node_semantic_analysis -->|"语义结果"| node_docx_report
node_evidence_audit -->|"证据台账"| node_research_workbook
node_semantic_analysis -->|"量化规则"| node_semantic_workbook
node_docx_report -->|"验收报告"| node_deliverable_validation
node_research_workbook -->|"验收工作簿"| node_deliverable_validation
node_semantic_workbook -->|"验收规则簿"| node_deliverable_validation
node_run_state -->|"恢复调度"| node_swarm_plan

click node_query_plan "https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/build_query_plan.py"
click node_swarm_plan "https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/build_swarm_plan.py"
click node_worker_contract "https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/worker_contract.py"
click node_worker_validation "https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/validate_worker_output.py"
click node_worker_merge "https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/merge_worker_outputs.py"
click node_run_state "https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/manage_run_state.py"
click node_evidence_audit "https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/audit_evidence.py"
click node_swarm_provenance "https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/audit_swarm_provenance.py"
click node_review_coding "https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/apply_review_coding.py"
click node_review_resolution "https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/review_resolution.py"
click node_dimension_evidence "https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/dimension_evidence.py"
click node_dimension_framework "https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/dimension_framework.py"
click node_formal_scoring "https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/formal_scoring.py"
click node_score_calculation "https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/calculate_scores.py"
click node_semantic_analysis "https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/quantify_text_semantics.py"
click node_protocol_calibration "https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/calibrate_evaluation_protocol.py"
click node_docx_report "https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/build_docx_report.py"
click node_research_workbook "https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/build_research_workbook.py"
click node_semantic_workbook "https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/build_semantic_rules_workbook.py"
click node_deliverable_validation "https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/validate_deliverables.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_query_plan,node_swarm_plan,node_worker_contract,node_worker_validation,node_worker_merge,node_run_state toneBlue
class node_evidence_audit,node_swarm_provenance,node_review_coding,node_review_resolution toneAmber
class node_dimension_evidence,node_dimension_framework,node_formal_scoring,node_score_calculation,node_semantic_analysis,node_protocol_calibration toneMint
class node_docx_report,node_research_workbook,node_semantic_workbook,node_deliverable_validation toneRose
class node_researcher,node_public_web toneIndigo
```

## Components

### 检索与调度

- [检索计划](https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/build_query_plan.py): `scripts/build_query_plan.py`
- [Worker 计划](https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/build_swarm_plan.py): `scripts/build_swarm_plan.py`
- [Worker 合同](https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/worker_contract.py): `scripts/worker_contract.py`
- [Worker 校验](https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/validate_worker_output.py): `scripts/validate_worker_output.py`
- [结果归并](https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/merge_worker_outputs.py): `scripts/merge_worker_outputs.py`
- [运行状态](https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/manage_run_state.py): `scripts/manage_run_state.py`

### 证据治理

- [证据审计](https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/audit_evidence.py): `scripts/audit_evidence.py`
- [来源链审计](https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/audit_swarm_provenance.py): `scripts/audit_swarm_provenance.py`
- [复核编码](https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/apply_review_coding.py): `scripts/apply_review_coding.py`
- [复核处置](https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/review_resolution.py): `scripts/review_resolution.py`

### 评价分析

- [逐维证据](https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/dimension_evidence.py): `scripts/dimension_evidence.py`
- [七维框架](https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/dimension_framework.py): `scripts/dimension_framework.py`
- [正式评分](https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/formal_scoring.py): `scripts/formal_scoring.py`
- [评分计算](https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/calculate_scores.py): `scripts/calculate_scores.py`
- [语义量化](https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/quantify_text_semantics.py): `scripts/quantify_text_semantics.py`
- [协议校准](https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/calibrate_evaluation_protocol.py): `scripts/calibrate_evaluation_protocol.py`

### 交付验收

- [DOCX 报告](https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/build_docx_report.py): `scripts/build_docx_report.py`
- [证据工作簿](https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/build_research_workbook.py): `scripts/build_research_workbook.py`
- [规则工作簿](https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/build_semantic_rules_workbook.py): `scripts/build_semantic_rules_workbook.py`
- [交付验收](https://github.com/right-068/analyze-historic-place-vitality/blob/main/scripts/validate_deliverables.py): `scripts/validate_deliverables.py`

### Other components

- **研究者**
- **公开网页**

## Connections

- 研究者 → 检索计划: 提供地点
- 检索计划 → 公开网页: 指导检索
- 研究者 → Worker 计划: 配置研究
- Worker 计划 → Worker 合同: 约束输出
- 公开网页 → Worker 校验: 检索材料
- Worker 合同 → Worker 校验: 校验合同
- Worker 校验 → 结果归并: 验证输出
- 结果归并 → 证据审计: 提交证据
- 结果归并 → 来源链审计: 提交来源链
- 证据审计 → 逐维证据: 审计证据
- 七维框架 → 逐维证据: 界定维度
- 逐维证据 → 复核编码: 待复核项
- 复核编码 → 复核处置: 提交复核
- 复核处置 → 正式评分: 确认评分资格
- 正式评分 → 评分计算: 正式评分输入
- 协议校准 → 语义量化: 提供锁定规则
- 逐维证据 → 语义量化: 公众感知证据
- 评分计算 → DOCX 报告: 评分结果
- 语义量化 → DOCX 报告: 语义结果
- 证据审计 → 证据工作簿: 证据台账
- 语义量化 → 规则工作簿: 量化规则
- DOCX 报告 → 交付验收: 验收报告
- 证据工作簿 → 交付验收: 验收工作簿
- 规则工作簿 → 交付验收: 验收规则簿
- 运行状态 → Worker 计划: 恢复调度