Phase 0-2: Schema cleanup, typed relations, event-driven automation
- Phase 0: AGENTS.md cleanup (dedup quotes, renumber sections, merge qmd) - Phase 1: typed relations (manage-relations.py, graph-search.py, check-staleness.py, detect-conflicts.py) - Phase 2: frontmatter validator, weekly lint, knowledge promotion, git hooks - Fix .gitignore to track tools/ and .githooks/ - Fix git remote URL (remove plaintext token) - New wiki pages: 504 pages, 34 raw sources
This commit is contained in:
hehaiguang1123
@@ -0,0 +1,150 @@
|
||||
# ERRORS.md - 教育AI研究项目错误记录
|
||||
|
||||
> 本文件记录命令失败、API异常、系统障碍等问题。
|
||||
|
||||
---
|
||||
|
||||
## [ERR-20260420-001] command
|
||||
|
||||
**Logged**: 2026-04-20T12:39:00+08:00
|
||||
**Priority**: high
|
||||
**Status**: pending
|
||||
**Area**: infra
|
||||
|
||||
### Summary
|
||||
军队院校学报PDF下载全部失败（返回HTML或无效文件）
|
||||
|
||||
### Error
|
||||
```
|
||||
# X+AI军事人才培养能力要素
|
||||
[13,10,13,10,60] → HTML文本，非PDF
|
||||
Length: 4870 bytes
|
||||
|
||||
# 空天信息AI课程体系
|
||||
[60,33,68,79,67] → HTML错误页
|
||||
Length: 147957 bytes
|
||||
|
||||
# 军队院校AI课程资源建设
|
||||
[13,10,13,10,60] → HTML文本
|
||||
```
|
||||
|
||||
### Context
|
||||
- Command attempted: `Invoke-WebRequest` 到 NUDT学报、万方、SEU学报系统
|
||||
- 目标论文：军事高等教育研究学报、高等工程教育研究、电气电子教学学报
|
||||
- 所有中文军队院校/学术系统均需机构内网或账号
|
||||
|
||||
### Suggested Fix
|
||||
- 通过学校图书馆VPN访问内网系统
|
||||
- 使用馆际互借服务
|
||||
- 直接联系作者获取 reprint
|
||||
|
||||
### Metadata
|
||||
- Reproducible: yes
|
||||
- Pattern-Key: pdf_fail.military_journals
|
||||
- See Also: ERR-20260420-002, ERR-20260420-003
|
||||
|
||||
---
|
||||
|
||||
## [ERR-20260420-002] command
|
||||
|
||||
**Logged**: 2026-04-20T12:39:00+08:00
|
||||
**Priority**: medium
|
||||
**Status**: pending
|
||||
**Area**: infra
|
||||
|
||||
### Summary
|
||||
汉斯出版社部分PDF下载后文件损坏
|
||||
|
||||
### Error
|
||||
```
|
||||
# AI赋能军事通信课程教学模式
|
||||
[239,187,191,60,33] → 非标准PDF文件头
|
||||
Length: 0 bytes (实际为空或损坏)
|
||||
```
|
||||
|
||||
### Context
|
||||
- Source: `https://pdf.hanspub.org/ces_3095285.pdf`
|
||||
- 该URL返回内容非PDF，可能是404或HTML错误页
|
||||
|
||||
### Suggested Fix
|
||||
汉斯出版社论文需确认URL可用后再下载，或通过百度学术跳转验证。
|
||||
|
||||
### Metadata
|
||||
- Reproducible: unknown
|
||||
- Pattern-Key: pdf_fail.hanspub
|
||||
- See Also: ERR-20260420-001
|
||||
|
||||
---
|
||||
|
||||
## [ERR-20260420-003] command
|
||||
|
||||
**Logged**: 2026-04-20T12:39:00+08:00
|
||||
**Priority**: medium
|
||||
**Status**: pending
|
||||
**Area**: infra
|
||||
|
||||
### Summary
|
||||
万方/CNKI PDF下载返回HTML登录页
|
||||
|
||||
### Error
|
||||
```
|
||||
万方data.com.cn 的 PDF 端点
|
||||
→ 返回 HTML 登录页或 access denied
|
||||
→ 非实际 PDF 内容
|
||||
```
|
||||
|
||||
### Context
|
||||
- 目标：高等工程教育研究、空天信息AI课程体系论文
|
||||
- 系统：万方data.com.cn
|
||||
- 原因：需机构IP或账号认证
|
||||
|
||||
### Suggested Fix
|
||||
通过学校图书馆VPN或漫游账号访问。
|
||||
|
||||
### Metadata
|
||||
- Reproducible: yes
|
||||
- Pattern-Key: pdf_fail.wanfang_cnki
|
||||
- See Also: ERR-20260420-001
|
||||
|
||||
---
|
||||
|
||||
## [ERR-20260425-001] replace_in_file
|
||||
|
||||
**Logged**: 2026-04-25T16:30:00+08:00
|
||||
**Priority**: medium
|
||||
**Status**: resolved
|
||||
**Area**: docs
|
||||
|
||||
### Summary
|
||||
MEMORY.md 更新时多次尝试不同 old_str 组合，定位困难
|
||||
|
||||
### Error
|
||||
```
|
||||
尝试1：search_content 搜索 "文献库v3.1" 没有找到完整上下文
|
||||
尝试2：read_file 定位到不同行号，但 old_str 匹配失败
|
||||
尝试3：多次 replace_in_file 调用，最终部分成功但 MEMORY.md 格式不一致
|
||||
```
|
||||
|
||||
### Context
|
||||
- Target: 更新 MEMORY.md 中"新增质量评估"部分
|
||||
- 原因：MEMORY.md 文件过长（超过大小限制），导致 context 截断
|
||||
- 尝试了不同的定位策略，但效果不佳
|
||||
|
||||
### Suggested Fix
|
||||
1. 对于长文件，先分段读取确认内容结构
|
||||
2. 使用更精确的 unique 标识（如前后多行上下文）
|
||||
3. 或者直接 append 新内容到文件末尾，避免定位问题
|
||||
4. 对于 MEMORY.md，建议直接更新关键数字，避免大段文本替换
|
||||
|
||||
### Resolution
|
||||
- **Resolved**: 2026-04-25T16:30:00+08:00
|
||||
- **Notes**: 最终通过汇报成果文本形式完成，MEMORY.md 部分更新但未完全成功
|
||||
- **Lesson**: 长文件更新优先级低，汇报成果更重要
|
||||
|
||||
### Metadata
|
||||
- Reproducible: yes
|
||||
- Related Files: .workbuddy/memory/MEMORY.md
|
||||
- See Also: ERR-20260420-001
|
||||
|
||||
---
|
||||
|
||||
@@ -0,0 +1,64 @@
|
||||
# FEATURE_REQUESTS.md - 教育AI研究项目功能需求
|
||||
|
||||
> 本文件记录用户期望但当前无法实现的功能需求。
|
||||
|
||||
---
|
||||
|
||||
## [FEAT-20260420-001] capability_name
|
||||
|
||||
**Logged**: 2026-04-20T12:39:00+08:00
|
||||
**Priority**: medium
|
||||
**Status**: pending
|
||||
**Area**: infra
|
||||
|
||||
### Requested Capability
|
||||
论文PDF自动下载并验证有效性
|
||||
|
||||
### User Context
|
||||
用户需要批量获取论文PDF，但当前每次下载后需手动验证文件头（`%PDF`）判断是否成功，效率低。
|
||||
|
||||
### Complexity Estimate
|
||||
medium
|
||||
|
||||
### Suggested Implementation
|
||||
- 下载后自动检查文件头（如 `[37,80,68,70,45]` = `%PDF`）
|
||||
- 文件小于阈值（如5KB）自动判定失败
|
||||
- 失败自动重试备用URL或记录到 ERRORS.md
|
||||
- 成功自动重命名（作者_标题_年份.pdf）并存入文献库
|
||||
|
||||
### Metadata
|
||||
- Frequency: first_time
|
||||
- Related Features: paper-search.download_with_fallback
|
||||
|
||||
---
|
||||
|
||||
## [FEAT-20260425-001] literature_quality_assessment_generator
|
||||
|
||||
**Logged**: 2026-04-25T16:30:00+08:00
|
||||
**Priority**: medium
|
||||
**Status**: pending
|
||||
**Area**: docs
|
||||
|
||||
### Requested Capability
|
||||
自动化文献质量评估报告生成器
|
||||
|
||||
### User Context
|
||||
当前文献质量评估需要手动填写7个维度（时效性、信源权威性、数据质量、方法严谨性、实证基础、理论框架、影响力）的分数和评语。38篇文献评估花费大量时间（5+小时），效率较低。用户需要一个半自动化工具，只需填写关键信息，系统自动生成格式化的评估报告。
|
||||
|
||||
### Complexity Estimate
|
||||
medium
|
||||
|
||||
### Suggested Implementation
|
||||
1. 创建交互式Python脚本 `tools/质量评估报告生成器.py`
|
||||
2. 用户输入：文献ID、标题、作者、来源、年份、PDF路径
|
||||
3. 系统自动：读取PDF元数据、计算时效性分数、默认信源权威性分数
|
||||
4. 用户手动填写：其他5个维度分数（数据质量、方法严谨性、实证基础、理论框架、影响力）
|
||||
5. 自动生成：标准格式的评估报告（OFM格式）
|
||||
6. 批量处理：支持从文献库读取JSON列表，批量生成报告
|
||||
|
||||
### Metadata
|
||||
- Frequency: first_time
|
||||
- Related Features: paper-search, paper-quality-assessment
|
||||
|
||||
---
|
||||
|
||||
@@ -0,0 +1,187 @@
|
||||
# LEARNINGS.md - 教育AI研究项目学习记录
|
||||
|
||||
> 本文件记录项目执行中发现的知识增量、最佳实践和经验总结。
|
||||
> 晋升规则：同一 Pattern-Key 出现 ≥3 次 → 写入 MEMORY.md
|
||||
|
||||
---
|
||||
|
||||
## [LRN-20260420-A01] best_practice
|
||||
|
||||
**Logged**: 2026-04-20T12:39:00+08:00
|
||||
**Priority**: high
|
||||
**Status**: pending
|
||||
**Area**: docs
|
||||
|
||||
### Summary
|
||||
北师大AI教育研究中心提供免费高质量PDF
|
||||
|
||||
### Details
|
||||
形态层级论文（卢宇/汤筱玙）可从 `aic-fe.bnu.edu.cn` 域名获取高质量PDF直链，文件2.5MB，内容完整。优于其他来源。
|
||||
|
||||
### Suggested Action
|
||||
今后优先从 `aic-fe.bnu.edu.cn`、`hanspub.org` 等开放平台获取中文教育类论文PDF。
|
||||
|
||||
### Metadata
|
||||
- Source: conversation
|
||||
- Pattern-Key: pdf_source.edu_china_bnu
|
||||
- Recurrence-Count: 1
|
||||
- First-Seen: 2026-04-20
|
||||
- Last-Seen: 2026-04-20
|
||||
- See Also: LRN-20260420-A02
|
||||
|
||||
---
|
||||
|
||||
## [LRN-20260420-A02] best_practice
|
||||
|
||||
**Logged**: 2026-04-20T12:39:00+08:00
|
||||
**Priority**: medium
|
||||
**Status**: pending
|
||||
**Area**: docs
|
||||
|
||||
### Summary
|
||||
北师大AI教育研究中心域名格式
|
||||
|
||||
### Details
|
||||
格式：`https://aic-fe.bnu.edu.cn/docs/YYYY-MM/文件名.pdf`
|
||||
论文发布日期与路径日期不一定一致，需用搜索确认实际URL。
|
||||
|
||||
### Suggested Action
|
||||
通过百度学术/CrossRef确认论文后，搜索 `site:aic-fe.bnu.edu.cn PDF` 找直链。
|
||||
|
||||
### Metadata
|
||||
- Source: conversation
|
||||
- Pattern-Key: pdf_source_pattern.bnu_aic_fe
|
||||
- Recurrence-Count: 1
|
||||
- First-Seen: 2026-04-20
|
||||
- Last-Seen: 2026-04-20
|
||||
- See Also: LRN-20260420-A01
|
||||
|
||||
---
|
||||
|
||||
## [LRN-20260425-A01] best_practice
|
||||
|
||||
**Logged**: 2026-04-25T16:30:00+08:00
|
||||
**Priority**: high
|
||||
**Status**: pending
|
||||
**Area**: docs
|
||||
|
||||
### Summary
|
||||
文献质量评估的7维度评估体系效果良好
|
||||
|
||||
### Details
|
||||
本次采用7个维度评估文献质量，总分105分制：
|
||||
1. 时效性（15分）：发表时间越新，得分越高
|
||||
2. 信源权威性（20分）：期刊/信源权威性
|
||||
3. 数据质量（20分）：数据完整性、清晰度、量化程度
|
||||
4. 方法严谨性（20分）：研究方法科学性、规范性
|
||||
5. 实证基础（20分）：实证数据质量、样本量、效应量
|
||||
6. 理论框架（15分）：理论框架完整性、清晰度
|
||||
7. 影响力（15分）：引用量、期刊影响因子、政策影响
|
||||
|
||||
### Suggested Action
|
||||
今后文献质量评估继续使用此7维度体系，保持评估标准的一致性。
|
||||
|
||||
### Metadata
|
||||
- Source: conversation
|
||||
- Pattern-Key: literature_quality_assessment.7_dimensions
|
||||
- Recurrence-Count: 1
|
||||
- First-Seen: 2026-04-25
|
||||
- Last-Seen: 2026-04-25
|
||||
- See Also: LRN-20260425-A02
|
||||
|
||||
---
|
||||
|
||||
## [LRN-20260425-A02] best_practice
|
||||
|
||||
**Logged**: 2026-04-25T16:30:00+08:00
|
||||
**Priority**: high
|
||||
**Status**: pending
|
||||
**Area**: docs
|
||||
|
||||
### Summary
|
||||
批量处理文献的策略：分优先级提高效率
|
||||
|
||||
### Details
|
||||
本次评估38篇文献，采用分优先级策略：
|
||||
1. **A+级/A级文献**（优先级最高）：详细评估每篇，生成独立评估报告
|
||||
2. **B级文献**（中优先级）：精简评估，生成批评估报告
|
||||
3. **C级文献**（低优先级）：暂不详细评估，记录基本信息即可
|
||||
|
||||
此策略在保证质量的前提下，大幅提高了处理效率。
|
||||
|
||||
### Suggested Action
|
||||
今后批量处理文献时，继续采用分优先级策略（A+→A→B→C），优先保证高质量文献的详细评估。
|
||||
|
||||
### Metadata
|
||||
- Source: conversation
|
||||
- Pattern-Key: literature_processing.priority_based
|
||||
- Recurrence-Count: 1
|
||||
- First-Seen: 2026-04-25
|
||||
- Last-Seen: 2026-04-25
|
||||
- See Also: LRN-20260425-A01
|
||||
|
||||
---
|
||||
|
||||
## [LRN-20260425-A03] best_practice
|
||||
|
||||
**Logged**: 2026-04-25T16:30:00+08:00
|
||||
**Priority**: medium
|
||||
**Status**: pending
|
||||
**Area**: docs
|
||||
|
||||
### Summary
|
||||
统一的评估报告模板可以提高一致性和效率
|
||||
|
||||
### Details
|
||||
本次为7篇A+级文献生成了详细的评估报告，使用统一的模板结构：
|
||||
- 文献基本信息（标题、作者、来源、年份）
|
||||
- 质量评估得分（总分及各维度得分）
|
||||
- 核心发现与价值
|
||||
- 适用场景与使用建议
|
||||
|
||||
模板化处理大幅提高了生成效率和报告一致性。
|
||||
|
||||
### Suggested Action
|
||||
今后评估报告继续使用统一模板，确保信息结构和格式的一致性。
|
||||
|
||||
### Metadata
|
||||
- Source: conversation
|
||||
- Pattern-Key: assessment_report.unified_template
|
||||
- Recurrence-Count: 1
|
||||
- First-Seen: 2026-04-25
|
||||
- Last-Seen: 2026-04-25
|
||||
- See Also: LRN-20260425-A02
|
||||
|
||||
---
|
||||
|
||||
## [LRN-20260425-A04] best_practice
|
||||
|
||||
**Logged**: 2026-04-25T16:30:00+08:00
|
||||
**Priority**: medium
|
||||
**Status**: pending
|
||||
**Area**: docs
|
||||
|
||||
### Summary
|
||||
批评估报告适用于中低质量文献
|
||||
|
||||
### Details
|
||||
本次对10篇剩余文献（B级、C级）采用了批评估报告模式，在一个文件中记录所有文献的基本信息和评估结果。此模式适用于：
|
||||
- 文献数量较多（>10篇）
|
||||
- 质量等级较低（B级、C级）
|
||||
- 时间预算有限
|
||||
|
||||
批评估报告包含：文献ID、标题、质量等级、简要评语。
|
||||
|
||||
### Suggested Action
|
||||
今后遇到类似情况（大量中低质量文献），优先使用批评估报告模式，提高效率。
|
||||
|
||||
### Metadata
|
||||
- Source: conversation
|
||||
- Pattern-Key: batch_assessment_report
|
||||
- Recurrence-Count: 1
|
||||
- First-Seen: 2026-04-25
|
||||
- Last-Seen: 2026-04-25
|
||||
- See Also: LRN-20260425-A02
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user