maintain | 2026-08-07 机制固化(frontmatter 字段审计强制 + 月度回顾归档提醒)+ 18 页补 last_updated
This commit is contained in:
@@ -69,6 +69,28 @@ foreach ($page in $pages) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
$text = [IO.File]::ReadAllText($page.FullName)
|
$text = [IO.File]::ReadAllText($page.FullName)
|
||||||
|
|
||||||
|
# frontmatter 必填字段(schema 第 3 节:title/type/last_updated/tags/confidence;
|
||||||
|
# 导航页整体豁免(走导航 frontmatter 约定),raw_sources 另对 query 页豁免)
|
||||||
|
$fmMatch = [regex]::Match($text, '(?s)^---\r?\n(.*?)\r?\n---')
|
||||||
|
if ($fmMatch.Success) {
|
||||||
|
$fmText = $fmMatch.Groups[1].Value
|
||||||
|
$isNavPage = $page.Name -in @('INDEX.md', 'Glossary.md', 'sources.md', '期货研究资料目录.md', '期货资料来源与证据边界.md')
|
||||||
|
if (-not $isNavPage) {
|
||||||
|
foreach ($field in @('title', 'type', 'last_updated', 'tags', 'confidence')) {
|
||||||
|
if (-not [regex]::IsMatch($fmText, "(?m)^$field\s*:")) {
|
||||||
|
Add-Warning "missing frontmatter field '$field' in $($page.FullName)"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
$isQueryPage = [regex]::IsMatch($fmText, '(?m)^type:\s*query')
|
||||||
|
if (-not $isQueryPage -and -not $isNavPage) {
|
||||||
|
if (-not [regex]::IsMatch($fmText, '(?m)^raw_sources\s*:')) {
|
||||||
|
Add-Warning "missing raw_sources field in $($page.FullName)"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
foreach ($match in [regex]::Matches($text, '\[\[([^\]|#]+)(?:#[^\]|]+)?(?:\|[^\]]+)?\]\]')) {
|
foreach ($match in [regex]::Matches($text, '\[\[([^\]|#]+)(?:#[^\]|]+)?(?:\|[^\]]+)?\]\]')) {
|
||||||
$target = $match.Groups[1].Value.Trim()
|
$target = $match.Groups[1].Value.Trim()
|
||||||
if (-not $byBaseName.ContainsKey($target)) {
|
if (-not $byBaseName.ContainsKey($target)) {
|
||||||
@@ -137,6 +159,13 @@ if (Test-Path -LiteralPath $State -PathType Leaf) {
|
|||||||
Add-Error "compile-results.tsv does not exist: $State"
|
Add-Error "compile-results.tsv does not exist: $State"
|
||||||
}
|
}
|
||||||
|
|
||||||
|
# 月度回顾页积累提醒(schema 第 7 节时序内容约定:满 3 页应归档最早为历史层)
|
||||||
|
$reviewPages = @($pages | Where-Object { $_.BaseName -match '20\d{2}年\d{1,2}月市场回顾$' })
|
||||||
|
if ($reviewPages.Count -ge 3) {
|
||||||
|
$reviewNames = ($reviewPages | Sort-Object Name | ForEach-Object { $_.BaseName }) -join '、'
|
||||||
|
Add-Warning "月度回顾页已积累 $($reviewPages.Count) 页($reviewNames);按 schema 时序内容约定应归档最早页面为历史层(status: historical)并由季度/年度综述承接"
|
||||||
|
}
|
||||||
|
|
||||||
$allTextFiles = @(Get-ChildItem -LiteralPath $Root -Recurse -File -Include '*.md', '*.tsv', '*.log' -ErrorAction SilentlyContinue)
|
$allTextFiles = @(Get-ChildItem -LiteralPath $Root -Recurse -File -Include '*.md', '*.tsv', '*.log' -ErrorAction SilentlyContinue)
|
||||||
$deletedSourceRefs = @()
|
$deletedSourceRefs = @()
|
||||||
foreach ($file in $allTextFiles) {
|
foreach ($file in $allTextFiles) {
|
||||||
|
|||||||
@@ -169,13 +169,14 @@ pwsh -File .\tools\wiki-audit.ps1
|
|||||||
|
|
||||||
必须确认:
|
必须确认:
|
||||||
|
|
||||||
- frontmatter 完整;
|
- frontmatter 完整(必填字段 `title`/`type`/`last_updated`/`tags`/`confidence`,导航页整体豁免;`raw_sources` 对导航页与 `type: query` 页豁免,缺字段报 WARNING);
|
||||||
- Wiki 内部链接无断链;
|
- Wiki 内部链接无断链;
|
||||||
- 图片路径存在;
|
- 图片路径存在;
|
||||||
- INDEX 覆盖全部内容页;
|
- INDEX 覆盖全部内容页;
|
||||||
- `raw_sources` 路径存在;
|
- `raw_sources` 路径存在;
|
||||||
- `compile-results.tsv` 可解析、无重复来源行和占位哈希;
|
- `compile-results.tsv` 可解析、无重复来源行和占位哈希;
|
||||||
- 用户主动删除的来源没有活动派生引用;
|
- 用户主动删除的来源没有活动派生引用;
|
||||||
|
- 月度回顾页(`20xx年N月市场回顾` 命名)积累满 3 页时审计输出归档 WARNING(按第 7 节时序内容约定归档最早页面为历史层);
|
||||||
- `git diff --check` 通过。
|
- `git diff --check` 通过。
|
||||||
|
|
||||||
超长页面检查默认以 200 行为阈值;经人工确认确实需要保留完整结构的页面,可通过 `tools/wiki-audit.ps1` 的 `$LongPageAllowlist` 白名单豁免。当前白名单包含:`Glossary.md`、`INDEX.md`(唯一总入口与阅读地图,需完整列出全部内容页,2026-08-07 加入)、`concepts/Harness-Engineering-Complete-Guide.md`、`concepts/Meta-Harness.md`、`practices/OpenAI-Codex-Harness-Engineering.md` 和 `queries/What-is-Harness-Engineering-in-Simple-Terms.md`。白名单只抑制超长页面警告,不豁免 frontmatter、链接、图片、来源路径或编译状态检查。
|
超长页面检查默认以 200 行为阈值;经人工确认确实需要保留完整结构的页面,可通过 `tools/wiki-audit.ps1` 的 `$LongPageAllowlist` 白名单豁免。当前白名单包含:`Glossary.md`、`INDEX.md`(唯一总入口与阅读地图,需完整列出全部内容页,2026-08-07 加入)、`concepts/Harness-Engineering-Complete-Guide.md`、`concepts/Meta-Harness.md`、`practices/OpenAI-Codex-Harness-Engineering.md` 和 `queries/What-is-Harness-Engineering-in-Simple-Terms.md`。白名单只抑制超长页面警告,不豁免 frontmatter、链接、图片、来源路径或编译状态检查。
|
||||||
|
|||||||
@@ -416,3 +416,10 @@
|
|||||||
- D 第二批:62 个 contested 页面逐页信号核验——全部为 A 类(标注完整:均有版本/年份/时点/核验声明,页面定位明确证据边界),B 类(需补标注)0、C 类(可疑)0,维持不变。累计 20 low_confidence + 62 contested 全部核验完成,无页面需升级/降级。
|
- D 第二批:62 个 contested 页面逐页信号核验——全部为 A 类(标注完整:均有版本/年份/时点/核验声明,页面定位明确证据边界),B 类(需补标注)0、C 类(可疑)0,维持不变。累计 20 low_confidence + 62 contested 全部核验完成,无页面需升级/降级。
|
||||||
- 顺带修复 frontmatter 合规:23 处。利弗莫尔交易纪律 type=practices→practice;22 个 llm-wiki 初始批次页面补 type(14 concept / 8 practice / 1 query)与 confidence: medium;paddleocr-ocr工具链 sources 键改名 raw_sources 并补 last_updated(初插位置破坏 YAML 结构,已修复并全库 PyYAML 校验通过)。
|
- 顺带修复 frontmatter 合规:23 处。利弗莫尔交易纪律 type=practices→practice;22 个 llm-wiki 初始批次页面补 type(14 concept / 8 practice / 1 query)与 confidence: medium;paddleocr-ocr工具链 sources 键改名 raw_sources 并补 last_updated(初插位置破坏 YAML 结构,已修复并全库 PyYAML 校验通过)。
|
||||||
- 验证:wiki-audit.ps1 normal + strict 双绿(0 ERROR / 0 WARNING);reflect missing_role=0 保持;97 页 frontmatter 全部 YAML 可解析。
|
- 验证:wiki-audit.ps1 normal + strict 双绿(0 ERROR / 0 WARNING);reflect missing_role=0 保持;97 页 frontmatter 全部 YAML 可解析。
|
||||||
|
|
||||||
|
## [2026-08-07] maintain | 机制固化:frontmatter 字段强制 + 月度回顾归档提醒
|
||||||
|
|
||||||
|
- wiki-audit.ps1 新增两条硬检查:(1) 非导航页 frontmatter 必填 title/type/last_updated/tags/confidence(导航页整体豁免,raw_sources 另对 type:query 页豁免),缺失报 WARNING;(2) 命名匹配 20xx年N月市场回顾 的页面满 3 页时输出归档 WARNING(按 schema 第 7 节时序内容约定)。
|
||||||
|
- 新检查首跑暴露 27 条 WARNING:3 个导航页被误查(已改豁免)+18 页缺 last_updated(已批量补 2026-08-07),修复后 normal+strict 双绿。
|
||||||
|
- 临时探针验证(mini wiki):3 个回顾页触发归档提醒且列出名称、缺字段页精确报 2 条缺失、无回顾页误报、normal exit 0 / strict exit 1——行为全部正确。
|
||||||
|
- WIKI-SCHEMA.md 第 8 节检查清单同步更新;wiki-compilation-verification 技能已固化两条仓库约定。
|
||||||
|
|||||||
@@ -1,5 +1,6 @@
|
|||||||
---
|
---
|
||||||
title: "商品市场金融化与库存套利"
|
title: "商品市场金融化与库存套利"
|
||||||
|
last_updated: 2026-08-07
|
||||||
source: "raw/期货/00-整体相关/交易的世界-第三章至结论.md"
|
source: "raw/期货/00-整体相关/交易的世界-第三章至结论.md"
|
||||||
created: 2026-08-02
|
created: 2026-08-02
|
||||||
updated: 2026-08-02
|
updated: 2026-08-02
|
||||||
|
|||||||
@@ -1,5 +1,6 @@
|
|||||||
---
|
---
|
||||||
title: "商品超级周期与交易商资产化"
|
title: "商品超级周期与交易商资产化"
|
||||||
|
last_updated: 2026-08-07
|
||||||
source: "raw/期货/00-整体相关/交易的世界-第三章至结论.md"
|
source: "raw/期货/00-整体相关/交易的世界-第三章至结论.md"
|
||||||
created: 2026-08-02
|
created: 2026-08-02
|
||||||
updated: 2026-08-02
|
updated: 2026-08-02
|
||||||
|
|||||||
@@ -1,5 +1,6 @@
|
|||||||
---
|
---
|
||||||
title: "大宗商品交易商与石油市场权力"
|
title: "大宗商品交易商与石油市场权力"
|
||||||
|
last_updated: 2026-08-07
|
||||||
source: "raw/期货/00-整体相关/交易的世界-第二章-石油教父.md"
|
source: "raw/期货/00-整体相关/交易的世界-第二章-石油教父.md"
|
||||||
created: 2026-08-02
|
created: 2026-08-02
|
||||||
updated: 2026-08-02
|
updated: 2026-08-02
|
||||||
|
|||||||
@@ -1,5 +1,6 @@
|
|||||||
---
|
---
|
||||||
title: "股票市场周期与大势判断:作者体系及验证边界"
|
title: "股票市场周期与大势判断:作者体系及验证边界"
|
||||||
|
last_updated: 2026-08-07
|
||||||
source: "胡斐,《股票投资要义》,经济管理出版社,2015 年 6 月第 1 版"
|
source: "胡斐,《股票投资要义》,经济管理出版社,2015 年 6 月第 1 版"
|
||||||
created: 2026-08-02
|
created: 2026-08-02
|
||||||
updated: 2026-08-02
|
updated: 2026-08-02
|
||||||
|
|||||||
@@ -1,5 +1,6 @@
|
|||||||
---
|
---
|
||||||
title: "铸造铝合金与 ADC12 产业链、废铝成本及需求"
|
title: "铸造铝合金与 ADC12 产业链、废铝成本及需求"
|
||||||
|
last_updated: 2026-08-07
|
||||||
source: "铝行业研讨学习(周彦希)"
|
source: "铝行业研讨学习(周彦希)"
|
||||||
created: 2026-08-03
|
created: 2026-08-03
|
||||||
updated: 2026-08-03
|
updated: 2026-08-03
|
||||||
|
|||||||
@@ -1,5 +1,6 @@
|
|||||||
---
|
---
|
||||||
title: "阿布量化(ABuQuant)框架架构"
|
title: "阿布量化(ABuQuant)框架架构"
|
||||||
|
last_updated: 2026-08-07
|
||||||
source: "https://github.com/bbfamily/abu (commit d602d847677e4c2b77b0a122df30816ea68b5710)"
|
source: "https://github.com/bbfamily/abu (commit d602d847677e4c2b77b0a122df30816ea68b5710)"
|
||||||
created: 2026-08-07
|
created: 2026-08-07
|
||||||
updated: 2026-08-07
|
updated: 2026-08-07
|
||||||
|
|||||||
@@ -1,5 +1,6 @@
|
|||||||
---
|
---
|
||||||
title: "大宗商品交易政治风险与合规"
|
title: "大宗商品交易政治风险与合规"
|
||||||
|
last_updated: 2026-08-07
|
||||||
source: "raw/期货/00-整体相关/交易的世界-第三章至结论.md"
|
source: "raw/期货/00-整体相关/交易的世界-第三章至结论.md"
|
||||||
created: 2026-08-02
|
created: 2026-08-02
|
||||||
updated: 2026-08-02
|
updated: 2026-08-02
|
||||||
|
|||||||
@@ -1,5 +1,6 @@
|
|||||||
---
|
---
|
||||||
title: "技术分析形态与突破确认"
|
title: "技术分析形态与突破确认"
|
||||||
|
last_updated: 2026-08-07
|
||||||
source: "技术分析图教学材料"
|
source: "技术分析图教学材料"
|
||||||
created: 2026-08-02
|
created: 2026-08-02
|
||||||
updated: 2026-08-02
|
updated: 2026-08-02
|
||||||
|
|||||||
@@ -1,5 +1,6 @@
|
|||||||
---
|
---
|
||||||
title: "期货基本分析逻辑"
|
title: "期货基本分析逻辑"
|
||||||
|
last_updated: 2026-08-07
|
||||||
source: "raw/期货/01-基本分析逻辑/期货基本分析逻辑.md"
|
source: "raw/期货/01-基本分析逻辑/期货基本分析逻辑.md"
|
||||||
created: 2026-08-02
|
created: 2026-08-02
|
||||||
updated: 2026-08-02
|
updated: 2026-08-02
|
||||||
|
|||||||
@@ -1,5 +1,6 @@
|
|||||||
---
|
---
|
||||||
title: "期货量化回测与位移路程比"
|
title: "期货量化回测与位移路程比"
|
||||||
|
last_updated: 2026-08-07
|
||||||
source: "https://github.com/bbfamily/abu (commit d602d847677e4c2b77b0a122df30816ea68b5710)"
|
source: "https://github.com/bbfamily/abu (commit d602d847677e4c2b77b0a122df30816ea68b5710)"
|
||||||
created: 2026-08-07
|
created: 2026-08-07
|
||||||
updated: 2026-08-07
|
updated: 2026-08-07
|
||||||
|
|||||||
@@ -1,5 +1,6 @@
|
|||||||
---
|
---
|
||||||
title: "股票交易系统与技术分析:趋势、MACD和买卖点"
|
title: "股票交易系统与技术分析:趋势、MACD和买卖点"
|
||||||
|
last_updated: 2026-08-07
|
||||||
source: "胡斐,《股票投资要义》,经济管理出版社,2015 年 6 月第 1 版"
|
source: "胡斐,《股票投资要义》,经济管理出版社,2015 年 6 月第 1 版"
|
||||||
created: 2026-08-02
|
created: 2026-08-02
|
||||||
updated: 2026-08-02
|
updated: 2026-08-02
|
||||||
|
|||||||
@@ -1,5 +1,6 @@
|
|||||||
---
|
---
|
||||||
title: "股票交易纪律与资金管理:从作者经验到可检验流程"
|
title: "股票交易纪律与资金管理:从作者经验到可检验流程"
|
||||||
|
last_updated: 2026-08-07
|
||||||
source: "胡斐,《股票投资要义》,经济管理出版社,2015 年 6 月第 1 版"
|
source: "胡斐,《股票投资要义》,经济管理出版社,2015 年 6 月第 1 版"
|
||||||
created: 2026-08-02
|
created: 2026-08-02
|
||||||
updated: 2026-08-02
|
updated: 2026-08-02
|
||||||
|
|||||||
@@ -1,5 +1,6 @@
|
|||||||
---
|
---
|
||||||
title: "股票基本面与筹码选股:作者框架和可观测指标"
|
title: "股票基本面与筹码选股:作者框架和可观测指标"
|
||||||
|
last_updated: 2026-08-07
|
||||||
source: "胡斐,《股票投资要义》,经济管理出版社,2015 年 6 月第 1 版"
|
source: "胡斐,《股票投资要义》,经济管理出版社,2015 年 6 月第 1 版"
|
||||||
created: 2026-08-02
|
created: 2026-08-02
|
||||||
updated: 2026-08-02
|
updated: 2026-08-02
|
||||||
|
|||||||
@@ -1,5 +1,6 @@
|
|||||||
---
|
---
|
||||||
title: "《股票投资要义》:周期、筹码与交易纪律"
|
title: "《股票投资要义》:周期、筹码与交易纪律"
|
||||||
|
last_updated: 2026-08-07
|
||||||
source: "胡斐,《股票投资要义》,经济管理出版社,2015 年 6 月第 1 版"
|
source: "胡斐,《股票投资要义》,经济管理出版社,2015 年 6 月第 1 版"
|
||||||
created: 2026-08-02
|
created: 2026-08-02
|
||||||
updated: 2026-08-02
|
updated: 2026-08-02
|
||||||
|
|||||||
@@ -1,5 +1,6 @@
|
|||||||
---
|
---
|
||||||
title: "阿布量化策略开发与回测"
|
title: "阿布量化策略开发与回测"
|
||||||
|
last_updated: 2026-08-07
|
||||||
source: "https://github.com/bbfamily/abu (commit d602d847677e4c2b77b0a122df30816ea68b5710)"
|
source: "https://github.com/bbfamily/abu (commit d602d847677e4c2b77b0a122df30816ea68b5710)"
|
||||||
created: 2026-08-07
|
created: 2026-08-07
|
||||||
updated: 2026-08-07
|
updated: 2026-08-07
|
||||||
|
|||||||
@@ -1,5 +1,6 @@
|
|||||||
---
|
---
|
||||||
title: "用通俗易懂的方式理解 Harness 工程"
|
title: "用通俗易懂的方式理解 Harness 工程"
|
||||||
|
last_updated: 2026-08-07
|
||||||
type: query
|
type: query
|
||||||
confidence: medium
|
confidence: medium
|
||||||
source: "WikiLLM Q&A"
|
source: "WikiLLM Q&A"
|
||||||
|
|||||||
@@ -1,5 +1,6 @@
|
|||||||
---
|
---
|
||||||
title: "期货研究资料目录"
|
title: "期货研究资料目录"
|
||||||
|
last_updated: 2026-08-07
|
||||||
source: "raw/期货/README.md"
|
source: "raw/期货/README.md"
|
||||||
created: 2026-08-02
|
created: 2026-08-02
|
||||||
updated: 2026-08-02
|
updated: 2026-08-02
|
||||||
|
|||||||
@@ -1,5 +1,6 @@
|
|||||||
---
|
---
|
||||||
title: "期货资料来源与证据边界"
|
title: "期货资料来源与证据边界"
|
||||||
|
last_updated: 2026-08-07
|
||||||
source: "期货研究资料目录迁移与来源登记"
|
source: "期货研究资料目录迁移与来源登记"
|
||||||
created: 2026-08-02
|
created: 2026-08-02
|
||||||
updated: 2026-08-02
|
updated: 2026-08-02
|
||||||
|
|||||||
Reference in New Issue
Block a user