chore: release v1.11.26 V70 absorption gates

Author: rockyshi1993

CHANGELOG.md

@@ -1,14 +1,15 @@
 # 变更日志 (CHANGELOG)
 
 > **说明**: 版本概览摘要。最新版本的详细变更见下方表格首行的 `changelogs/releases/vX.Y.Z.md` 链接；历史版本见对应详细变更文件
-> **最后更新**: 2026-07-01
+> **最后更新**: 2026-07-06
 
 ---
 
 ## 版本概览
 
 | 版本 | 日期 | 变更摘要 | 详细 |
 |------|------|---------|------|
+| [v1.11.26](./changelogs/releases/v1.11.26.md) | 2026-07-06 | 🔧 **用户文档主面与 V70 吸纳门禁收口**：归档 V69/V70，固化需求复审状态同步、用户文档即时理解、用户文档主面、用户文档驱动交付链、复审证据化、构建产物 smoke、生成站点验证、公开用户路径契约和性能回归门禁 | [查看](./changelogs/releases/v1.11.26.md) |
 | [v1.11.25](./changelogs/releases/v1.11.25.md) | 2026-07-01 | 🔧 **最新 data 吸纳守门与 V68 探针收口**：吸纳数据库记录迁移、前端浏览器验证预算、自验 override、finding 反证矩阵、多阶段关闭、guard 绕过、文档副作用、可执行示例、视觉偏差、一次性脚本、验证副作用、设计帧用途、需求确认前快门和 package/adapter 证据门禁 | [查看](./changelogs/releases/v1.11.25.md) |
 | [v1.11.24](./changelogs/releases/v1.11.24.md) | 2026-06-26 | 🔧 **需求输入模板链路与产品完整需求模板收口**：拆分纯新需求、需求变更、Bug 与产品完整需求入口，新增需求方 / 变更 / Bug / 产品模板，固化“产品需求即验收事实源”、Mermaid+文字步骤图、前端交互覆盖和技术验证派生链路 | [查看](./changelogs/releases/v1.11.24.md) |
 | [v1.11.23](./changelogs/releases/v1.11.23.md) | 2026-06-23 | 🔧 **复审文档体验 / 公开用户文档 / 最终汇报吸纳门禁**：归档 V66/V67 探针，固化复审维度增量、用户视角文档、文档消费者扫描、产物链接去重、前端运行时网络探针、公开用户文档维护边界和最终回复 active 范围守门，并修复官网锁文件 DOMPurify 审计项 | [查看](./changelogs/releases/v1.11.23.md) |

README.md

@@ -44,7 +44,7 @@ DevCodex 通过 `.github/`（Copilot）、`CLAUDE.md + .claude/ + .mcp.json`（C
 - **可配置并发策略**: Profile `config.json` 可配置 `extensions.devcodex.concurrency`；默认 `auto` 表示只读准备和隔离验证可并行、共享状态写入保持单写者，保守项目可设为 `serial`
 - **支撑型 Skill**: `execution-contract` / `test-router` / `release-verification` / `host-contract-verification` / `source-consumer-sync` 为控制面、多批次、测试路线、宿主契约验证与真相源-消费者同步提供可审计支撑，不新增工作流分支
 - **发布前审查能力**: `audit-release` 负责 release readiness、发布说明质量、兼容/迁移风险、package/plugin 元数据、文档/Profile/website 同步、回滚策略、registry/tag 风险与发布后验收 review；`release-verification` 仍负责 R0~R7 执行验证链
-- **README 专项能力**: `readme-authoring` 负责 README 用户/使用者优先写作，`audit-readme` 负责 README / 用户使用文档专项 review；`UserPerspectiveDocsGate` 要求文档按使用者第一次成功、常见任务、字段/参数/状态/错误解释、排错恢复和低心智负担组织，`PublicUserDocsMaintainerBoundaryGate` 要求公开用户文档不混入维护者 checklist、内部同步清单或台账状态，`DocsConsumerSweep` 负责同步 README、website、Profile、示例、模板、导航和代码消费点
+- **README 专项能力**: `readme-authoring` 负责 README 用户/使用者优先写作，`audit-readme` 负责 README / 用户使用文档专项 review；`UserPerspectiveDocsGate` 要求文档按使用者第一次成功、常见任务、字段/参数/状态/错误解释、排错恢复和低心智负担组织，`UserDocsImmediateComprehensionGate` 要求用户文档输出功能完整性、配置易懂性和首次读者即时理解三轴结论，`UserDocsPrimarySurfaceGate` 要求站点文档 / README / quick start 先冻结 targetSurface、documentLocation 与 primaryAudience，首页首屏、quick start、nav/sidebar、CTA 和 reference 主路径必须服务用户使用而不是开发契约，`FinalUserManualFirstGate` / `DocsSiteInformationArchitectureGate` / `UserManualFlowAndFailureGate` / `QueueDocsRealWorkflowGate` 要求需求概况后优先产出最终用户使用文档，文档站按任务组织并覆盖成功、失败恢复和队列/异步真实工作流，`PublicUserDocsMaintainerBoundaryGate` 要求公开用户文档不混入维护者 checklist、内部同步清单或台账状态，`DocsConsumerSweep` 与 `UserPathContractSweep` 负责同步 README、website、Profile、示例、模板、导航、validate、部署副本和代码消费点
 - **Profile 新鲜度审查**: audit 会先执行 `Profile Freshness Check`，反向核对 Profile 是否仍匹配当前包版本、目录资产、脚本、发布状态、宿主能力和任务现实
 - **项目工程泄漏审查**: 项目工程 / 代码质量审查执行 `PE-12 资源生命周期与泄漏风险`，必须检查内存泄露、资源泄漏、监听器/定时器/连接/流未释放、缓存无界增长和组件卸载清理缺失
 - **泄漏风险稳定性压测**: 写测试用例或回归验证时先执行 `LeakRiskStabilityPressureTest` 条件判定；命中长运行、高并发、缓存/连接/监听器/定时器/流/socket/worker/订阅/组件生命周期或 `PE-12` 风险时，TestRoute 纳入场景/负载/稳定性压测并记录基线、冷却后回落和资源指标前后对比；低风险任务写 `N/A + skipReason`
@@ -54,7 +54,7 @@ DevCodex 通过 `.github/`（Copilot）、`CLAUDE.md + .claude/ + .mcp.json`（C
 - **Backlog 真相复核与状态回写**: 从 `data/*.md` open/partial 项组织新需求或新批次前，先按 `pure-open / residual-tail / already-fixed / misclassified` 分类；实施后再执行台账状态回写闭环，避免“源码已修但 backlog 仍旧 open”
 - **官方文档证据前置**: 新增或升级依赖、框架、SDK、平台 API、外部模块前，CP2 会要求 `OfficialDocsEvidence`，记录官方文档来源、关键用法、限制与兼容性，避免凭经验猜 API
 - **通用工程守门**: Node.js 项目默认不低于 `>=18`；需求/问题定义前置平台工程判断，并记录 `ImplementationComplexityLevel`，开发程度分为 `简单够用 / 中等 / 企业级`，用户未要求复杂化或需求不详细时默认 `简单够用`；依赖/兼容任务拆分业务源码平滑性与依赖层落地条件；包/库/adapter/CLI 同查代码层与包工程层；JS/Node 必要注释使用标准 JSDoc；简单 service 不重复 route/model/schema 已承担的校验
-- **跨项目经验吸纳守门**: 字段/本地化/状态新增前执行 `ExistingDomainContractAudit`，业务策略常量执行 `ConfigOwnershipMatrix`，接口文档合同执行 `ApiDocVerificationSync`，数据迁移执行 `DataMutationPlan`，值得吸纳建议执行 `AbsorptionDecision`，完整首版执行 `FullV1ScopeGuard`，启动优化执行 `StartupPhaseTrace`；新增吸纳 `CodeTruthRequirementGate`、`ManualReviewEvidenceRetention`、`DocumentationTranslationParityGuard`、`FormalDocsDevCodexBoundary`、`LLMPromptContractTriage`、`VerificationScopeBudgetGate`、`LiveVerificationExecutionObligation`、`ExplicitCommitAuthorizationGate`、`CompatibilityAndContractAuthorityGate`、`UIConfirmedSourceConflictTraceGate`、`PublicDocsReleasedVersionGate`、`CollectionRelationIdNamingGate`、`UserFacingVerificationArtifactLanguageGate`、`AdapterBenchmarkAttribution`、`ProductRequirementTraceabilityGate`、`LocalExecutionConfigProbe`、`ManualReviewEvidenceDataRetention`、`AdjacentScopeExpansionGuard`、`PackageNameAuthorityGate`、`PerformanceBenchmarkFirstGate`、`PublicModuleDifferentiationGate`、`V2MCPFirstPlanningGate`、`WorkspaceDataAbsorptionScopeGate`、`FlowchartNodeExplanationGate`、`DocsSiteVisualAcceptanceGate`、`OmissionOnlyReviewGate`、`ReviewFindingIntakeGate`、`ReviewDimensionDeltaGate`、`UserPerspectiveDocsGate`、`PublicUserDocsMaintainerBoundaryGate`、`DocsConsumerSweep`、`ArtifactLinkSetDedupeGate`、`FrontendRuntimeNetworkProbeGate`、`ActiveRequirementFinalResponseGate`、`DatabaseRecordMigrationExportGate`、`FrontendBrowserVerificationBudgetGate`、`UserSelfVerificationOverrideGate`、`FindingProbeMatrixGate`、`MultiPhaseClosureGate`、`GuardPolicyBypassMatrixGate`、`SideEffectCompatibilityDocsGate`、`ExecutableExampleTruthProbeGate`、`VisualDeviationTypeGate`、`OneOffRequirementScriptPlacementGate`、`VerificationCommandSideEffectGate`、`DesignFramePurposeClassificationGate`、`RequirementPreConfirmGate`、`PackageAdapterPreConfirmEvidenceGate`、`MethodLevelLeakPressureProbe` 与 `V2FormalSolutionPackage`
+- **跨项目经验吸纳守门**: 字段/本地化/状态新增前执行 `ExistingDomainContractAudit`，业务策略常量执行 `ConfigOwnershipMatrix`，接口文档合同执行 `ApiDocVerificationSync`，数据迁移执行 `DataMutationPlan`，值得吸纳建议执行 `AbsorptionDecision`，完整首版执行 `FullV1ScopeGuard`，启动优化执行 `StartupPhaseTrace`；新增吸纳 `CodeTruthRequirementGate`、`ManualReviewEvidenceRetention`、`DocumentationTranslationParityGuard`、`FormalDocsDevCodexBoundary`、`LLMPromptContractTriage`、`VerificationScopeBudgetGate`、`LiveVerificationExecutionObligation`、`ExplicitCommitAuthorizationGate`、`CompatibilityAndContractAuthorityGate`、`UIConfirmedSourceConflictTraceGate`、`PublicDocsReleasedVersionGate`、`CollectionRelationIdNamingGate`、`UserFacingVerificationArtifactLanguageGate`、`AdapterBenchmarkAttribution`、`ProductRequirementTraceabilityGate`、`LocalExecutionConfigProbe`、`ManualReviewEvidenceDataRetention`、`AdjacentScopeExpansionGuard`、`PackageNameAuthorityGate`、`PerformanceBenchmarkFirstGate`、`PublicModuleDifferentiationGate`、`V2MCPFirstPlanningGate`、`WorkspaceDataAbsorptionScopeGate`、`FlowchartNodeExplanationGate`、`DocsSiteVisualAcceptanceGate`、`OmissionOnlyReviewGate`、`ReviewFindingIntakeGate`、`ReviewDimensionDeltaGate`、`UserPerspectiveDocsGate`、`UserDocsImmediateComprehensionGate`、`UserDocsPrimarySurfaceGate`、`PublicUserDocsMaintainerBoundaryGate`、`DocsConsumerSweep`、`RequirementVerdictStateSyncGate`、`ArtifactLinkSetDedupeGate`、`FrontendRuntimeNetworkProbeGate`、`ActiveRequirementFinalResponseGate`、`DatabaseRecordMigrationExportGate`、`FrontendBrowserVerificationBudgetGate`、`UserSelfVerificationOverrideGate`、`FindingProbeMatrixGate`、`MultiPhaseClosureGate`、`GuardPolicyBypassMatrixGate`、`SideEffectCompatibilityDocsGate`、`ExecutableExampleTruthProbeGate`、`VisualDeviationTypeGate`、`OneOffRequirementScriptPlacementGate`、`VerificationCommandSideEffectGate`、`DesignFramePurposeClassificationGate`、`RequirementPreConfirmGate`、`PackageAdapterPreConfirmEvidenceGate`、`MethodLevelLeakPressureProbe`、`UserFacingDeliveryChainGate`、`FinalUserManualFirstGate`、`DocsSiteInformationArchitectureGate`、`UserManualFlowAndFailureGate`、`QueueDocsRealWorkflowGate`、`ReviewChecklistCompletenessGate`、`EvidenceExecutionGate`、`BuiltArtifactFeatureSmokeGate`、`TscOutputImportProbe`、`GeneratedSiteGate`、`ManualTocDuplicationGate`、`UserPathContractSweep`、`BenchmarkRegressionGuard` 与 `V2FormalSolutionPackage`
 - **验证卫生与包边界**: release / pack / benchmark / codegen 任务中，package boundary check 必须在构建完成后单独串行执行；消费者验证异常先查 package.json、lockfile、node_modules 与 `npm ls <关键依赖>`，收尾前清理无关 dirty 文件和验证残留
 - **ProfileImpactCheck**: dev/fix 改动项目技术栈、目录、脚本、测试/发布路线、分发面、配置或长期连接时，会主动判定是否需要更新 Profile；无需更新时也要写明跳过理由
 - **敏感信息与硬编码策略**: 默认允许敏感信息、明文连接信息和硬编码出现在用户要求的代码、脚本、配置、文档、测试或报告中；只有用户 / 项目明确禁止时才脱敏、占位或改用 env、`secretRef`、secret manager、`config.local.json`
@@ -321,7 +321,7 @@ devcodex/
 
 发布前审查由 `audit-release` 承担：它是 audit 专项维度，审查 release readiness、发布说明质量、兼容/迁移风险、package/plugin 元数据、文档/Profile/website 同步、回滚策略、registry/tag 风险与发布后验收；它不替代 `release-verification`，也不执行真实 `tag` / `push` / `publish`。
 
-README / 用户使用文档当前补充两类专项 Skill：`readme-authoring` 负责把 README 默认主视角收口为用户 / 使用者优先，`audit-readme` 负责专项审查用户路径、快速开始、示例真实度、开发信息后置与消费链一致性。正式用户文档还执行 `UserPerspectiveDocsGate`、`PublicUserDocsMaintainerBoundaryGate` 和 `DocsConsumerSweep`：检查文档是否足够详细、首次读者是否看得懂、心智负担是否简单，公开用户路径是否排除了维护者 checklist / 内部同步清单 / 台账状态，以及 README / website / Profile / examples / templates / validate / 代码消费点是否同步。
+README / 用户使用文档当前补充两类专项 Skill：`readme-authoring` 负责把 README 默认主视角收口为用户 / 使用者优先，`audit-readme` 负责专项审查用户路径、快速开始、示例真实度、开发信息后置与消费链一致性。正式用户文档还执行 `UserPerspectiveDocsGate`、`UserDocsImmediateComprehensionGate`、`UserDocsPrimarySurfaceGate`、`FinalUserManualFirstGate`、`DocsSiteInformationArchitectureGate`、`UserManualFlowAndFailureGate`、`QueueDocsRealWorkflowGate`、`PublicUserDocsMaintainerBoundaryGate`、`DocsConsumerSweep` 和 `UserPathContractSweep`：检查文档是否足够详细、首次读者是否看得懂、功能覆盖是否完整、配置是否简单易懂、需求概况后是否先形成用户最终使用文档，首页首屏 / quick start / nav/sidebar / CTA / reference 是否优先服务用户使用，队列/异步场景是否覆盖真实工作流，公开用户路径是否排除了维护者 checklist / 内部同步清单 / 台账状态，以及 README / website / Profile / examples / templates / validate / 部署副本 / 代码消费点是否同步。
 
 &gt; ℹ️ 维护者状态文件（本仓库开发过程中累积的 violations/pending-fixes 记录）按 active-root 保存，例如 workspace-namespace 下的 `.devcodex/<project>/data/`，**不分发**给用户。
 

RULES.md

@@ -1,6 +1,6 @@
-# DevCodex v1.11.25 — 使用入口
+# DevCodex v1.11.26 — 使用入口
 
-> AI workflow injector for Copilot / Claude Code / Codex · publisher: Rocky · version: 1.11.25
+> AI workflow injector for Copilot / Claude Code / Codex · publisher: Rocky · version: 1.11.26
 
 ## 正式主支持客户端
 

changelogs/releases/v1.11.26.md

@@ -0,0 +1,68 @@
+# v1.11.26 用户文档主面与 V70 吸纳门禁收口
+
+## 版本信息
+
+| 项目 | 内容 |
+|------|------|
+| 版本号 | v1.11.26 |
+| 发布日期 | 2026-07-06 |
+| 变更类型 | 规范增强 / 治理探针 |
+| 风险级别 | P2 (Low) |
+| 向后兼容 | ✅ 兼容 |
+
+## 变更摘要
+
+本版本归档 v1.11.25 之后的 V69 与 V70 吸纳成果：补齐需求复审状态同步、用户文档即时理解、用户文档主面守门，并把最新全工作区 data 台账中的用户文档驱动交付链、复审证据化、构建产物 smoke、生成站点验证、公开用户路径契约和性能回归门禁收口为可验证规范。
+
+## 新增 / 强化门禁
+
+- `RequirementVerdictStateSyncGate`
+- `UserDocsImmediateComprehensionGate`
+- `UserDocsPrimarySurfaceGate`
+- `UserFacingDeliveryChainGate`
+- `FinalUserManualFirstGate`
+- `DocsSiteInformationArchitectureGate`
+- `UserManualFlowAndFailureGate`
+- `QueueDocsRealWorkflowGate`
+- `ReviewChecklistCompletenessGate`
+- `EvidenceExecutionGate`
+- `BuiltArtifactFeatureSmokeGate`
+- `TscOutputImportProbe`
+- `GeneratedSiteGate`
+- `ManualTocDuplicationGate`
+- `UserPathContractSweep`
+- `BenchmarkRegressionGuard`
+
+## 影响范围
+
+- 规范源：`instructions.md` 与 dev/fix/audit/analyze 拆分 instructions。
+- 执行消费者：`skills/test-router`、`dev-docs`、`readme-authoring`、`audit-document`、`audit-readme`、`document-sync`、`report`。
+- 模板与报告：`requirement`、`technical-design`、`implementation-plan`、dev/fix/audit/scenario-test 报告模板。
+- 用户文档：README、website guide、活动版本 P1 需求页与 website changelog。
+- 验证探针：`scripts/lib/validate-governance-tail.js` 新增 V70，`scripts/validate.js` 与 `scripts/test-spec-governance.js` 接入 V70。
+- 部署副本：已同步 `.github`、`.claude`、`AGENTS.md` 与 `.agents/skills`。
+
+## 台账闭环
+
+- 已吸纳 `PI-072`、`PI-073`、`PI-074`、`PI-075`、`PI-076`、`PI-077`、`PI-078`。
+- 已关闭 `PF-077`、`PF-078`、`PF-079`、`PF-080`、`PF-081`、`PF-082`、`PF-083`。
+- 已关闭 / 吸纳 `GR-015`、`GR-016`、`GR-017`、`GR-018`。
+- 已吸纳跨项目来源 `GAP-030`、`GAP-031`、`GAP-032`、`GAP-033`、`GAP-034`、`GAP-035`、`GAP-036`、`PI-019`、`PF-002` 的通用规范部分。
+
+## 验证
+
+- `node scripts/test-spec-governance.js`
+- `node scripts/validate.js`（V1~V70 全部通过）
+- `node .\devcodex-v1\index.js update`
+
+完整发布前验证、pack/install smoke 与发布后验收记录见本次 release 报告。
+
+## 迁移指南
+
+无破坏性变更。已安装 DevCodex 的工作区可执行：
+
+```bash
+npx @vextjs/devcodex update
+```
+
+**文档生成时间**: 2026-07-06

changelogs/unreleased.md

@@ -8,8 +8,6 @@
 
 ## 当前未发布变更
 
-_暂无未发布变更。_
-
 ## 记录提示
 
 - 控制面 / 长流程 / 多批次变更写入本文件时，优先标明 `execution-contract`、`test-router`、`release-verification`、`host-contract-verification`、`source-consumer-sync` 等支撑型能力是否同步更新。
@@ -18,5 +16,7 @@ _暂无未发布变更。_
 - 最新高保真 UI / 提交授权 / 兼容契约吸纳守门需显式标明 `FigmaHighFidelityRestorationGate`、`ActualPreviewChainAndMockFallbackGate`、`ExplicitCommitAuthorizationGate`、`CompatibilityAndContractAuthorityGate` 与 `PublicDocsReleasedVersionGate`，避免正式发版前遗漏 V65 覆盖链路。
 - 最新复审与文档体验吸纳守门需显式标明 `ReviewDimensionDeltaGate`、`UserPerspectiveDocsGate`、`DocsConsumerSweep`、`ArtifactLinkSetDedupeGate` 与 `FrontendRuntimeNetworkProbeGate`，避免正式发版前遗漏 V66 覆盖链路；已归档发布项保留历史关联 `PI-052 / PF-056`。
 - 最新公开用户文档与最终汇报吸纳守门需显式标明 `PublicUserDocsMaintainerBoundaryGate` 与 `ActiveRequirementFinalResponseGate`，避免正式发版前遗漏 V67 覆盖链路；已归档发布项保留历史关联 `PI-053 / PI-054 / PF-057 / PF-058`。
+- 最新用户文档主面与需求状态同步守门需显式标明 `RequirementVerdictStateSyncGate`、`UserDocsImmediateComprehensionGate` 与 `UserDocsPrimarySurfaceGate`，避免正式发版前遗漏 V69 覆盖链路。
+- 最新用户文档驱动交付链、复审证据化、生成站点与性能回归守门需显式标明 `UserFacingDeliveryChainGate`、`ReviewChecklistCompletenessGate`、`EvidenceExecutionGate`、`BuiltArtifactFeatureSmokeGate`、`TscOutputImportProbe`、`GeneratedSiteGate`、`UserPathContractSweep` 与 `BenchmarkRegressionGuard`，避免正式发版前遗漏 V70 覆盖链路。
 - 宿主输出、Hook 或项目现实扩展相关条目，建议显式写出 `verified-present / verified-missing / unverified`、sticky `activeProject` 与用户可见 `意图扩展摘要` 是否发生变化。
 - 执行闭环、确认机制或发布门禁相关条目，建议补充 `Intent Expansion Card`、`ConfirmationRequest`、`ECR` 与验证证据，方便正式发版时直接归档到版本 changelog。