Skip to content

Commit 4a3a621

Browse files
committed
release: v1.11.23
1 parent a3c3f85 commit 4a3a621

52 files changed

Lines changed: 470 additions & 96 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎CHANGELOG.md‎

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,15 @@
11
# 变更日志 (CHANGELOG)
22

33
> **说明**: 版本概览摘要。最新版本的详细变更见下方表格首行的 `changelogs/releases/vX.Y.Z.md` 链接;历史版本见对应详细变更文件
4-
> **最后更新**: 2026-06-17
4+
> **最后更新**: 2026-06-23
55
66
---
77

88
## 版本概览
99

1010
| 版本 | 日期 | 变更摘要 | 详细 |
1111
|------|------|---------|------|
12+
| [v1.11.23](./changelogs/releases/v1.11.23.md) | 2026-06-23 | 🔧 **复审文档体验 / 公开用户文档 / 最终汇报吸纳门禁**:归档 V66/V67 探针,固化复审维度增量、用户视角文档、文档消费者扫描、产物链接去重、前端运行时网络探针、公开用户文档维护边界和最终回复 active 范围守门,并修复官网锁文件 DOMPurify 审计项 | [查看](./changelogs/releases/v1.11.23.md) |
1213
| [v1.11.22](./changelogs/releases/v1.11.22.md) | 2026-06-17 | 🔧 **高保真 UI / 提交授权 / 兼容契约吸纳门禁**:新增 V65 探针,固化 Figma/截图还原、真实 preview、状态回归、生产资产预算、运行时 i18n、显式 commit 授权、兼容契约权威和公开文档版本边界等守门 | [查看](./changelogs/releases/v1.11.22.md) |
1314
| [v1.11.21](./changelogs/releases/v1.11.21.md) | 2026-06-17 | 🔧 **审查发现 intake 分流门禁**:新增 `ReviewFindingIntakeGate` / `DesignIntentAndDocsConsistencyGate` 与 V64 探针,要求外部审查报告、AI review finding、audit issue 和代码评审发现先经本地证据、设计取舍、用户决策、文档漂移与测试缺口分流 | [查看](./changelogs/releases/v1.11.21.md) |
1415
| [v1.11.20](./changelogs/releases/v1.11.20.md) | 2026-06-12 | 🔧 **最新 data 吸纳守门补强**:新增全工作区 data 扫描、流程图节点说明、文档站视觉验收、遗漏专审、方法级泄漏压测与 v2 正式方案包守门,并补齐 V63 探针 | [查看](./changelogs/releases/v1.11.20.md) |
@@ -108,8 +109,9 @@
108109

109110
## 相关文档
110111

111-
- [`changelogs/releases/v1.11.22.md`](./changelogs/releases/v1.11.22.md) — 最新版本详细变更文档
112-
- [`changelogs/releases/v1.11.21.md`](./changelogs/releases/v1.11.21.md) — 上一版本详细变更文档
112+
- [`changelogs/releases/v1.11.23.md`](./changelogs/releases/v1.11.23.md) — 最新版本详细变更文档
113+
- [`changelogs/releases/v1.11.22.md`](./changelogs/releases/v1.11.22.md) — 上一版本详细变更文档
114+
- [`changelogs/releases/v1.11.21.md`](./changelogs/releases/v1.11.21.md) — 历史版本详细变更文档
113115
- [`changelogs/releases/v1.11.18.md`](./changelogs/releases/v1.11.18.md) — 历史版本详细变更文档
114116
- [`changelogs/releases/v1.11.17.md`](./changelogs/releases/v1.11.17.md) — 历史版本详细变更文档
115117
- [`changelogs/releases/v1.11.15.md`](./changelogs/releases/v1.11.15.md) — 历史版本详细变更文档

‎README.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -44,17 +44,17 @@ DevCodex 通过 `.github/`(Copilot)、`CLAUDE.md + .claude/ + .mcp.json`(C
4444
- **可配置并发策略**: Profile `config.json` 可配置 `extensions.devcodex.concurrency`;默认 `auto` 表示只读准备和隔离验证可并行、共享状态写入保持单写者,保守项目可设为 `serial`
4545
- **支撑型 Skill**: `execution-contract` / `test-router` / `release-verification` / `host-contract-verification` / `source-consumer-sync` 为控制面、多批次、测试路线、宿主契约验证与真相源-消费者同步提供可审计支撑,不新增工作流分支
4646
- **发布前审查能力**: `audit-release` 负责 release readiness、发布说明质量、兼容/迁移风险、package/plugin 元数据、文档/Profile/website 同步、回滚策略、registry/tag 风险与发布后验收 review;`release-verification` 仍负责 R0~R7 执行验证链
47-
- **README 专项能力**: `readme-authoring` 负责 README 用户/使用者优先写作,`audit-readme` 负责 README / 用户使用文档专项 review
47+
- **README 专项能力**: `readme-authoring` 负责 README 用户/使用者优先写作,`audit-readme` 负责 README / 用户使用文档专项 review;`UserPerspectiveDocsGate` 要求文档按使用者第一次成功、常见任务、字段/参数/状态/错误解释、排错恢复和低心智负担组织,`PublicUserDocsMaintainerBoundaryGate` 要求公开用户文档不混入维护者 checklist、内部同步清单或台账状态,`DocsConsumerSweep` 负责同步 README、website、Profile、示例、模板、导航和代码消费点
4848
- **Profile 新鲜度审查**: audit 会先执行 `Profile Freshness Check`,反向核对 Profile 是否仍匹配当前包版本、目录资产、脚本、发布状态、宿主能力和任务现实
4949
- **项目工程泄漏审查**: 项目工程 / 代码质量审查执行 `PE-12 资源生命周期与泄漏风险`,必须检查内存泄露、资源泄漏、监听器/定时器/连接/流未释放、缓存无界增长和组件卸载清理缺失
5050
- **泄漏风险稳定性压测**: 写测试用例或回归验证时先执行 `LeakRiskStabilityPressureTest` 条件判定;命中长运行、高并发、缓存/连接/监听器/定时器/流/socket/worker/订阅/组件生命周期或 `PE-12` 风险时,TestRoute 纳入场景/负载/稳定性压测并记录基线、冷却后回落和资源指标前后对比;低风险任务写 `N/A + skipReason`
51-
- **前端体验质量门禁**: 前端页面、组件、控制台、官网、文档站、可视化工具或游戏任务执行 `FrontendExperienceQualityGate` 条件判定,覆盖设计来源、UI 还原度、风格主题、响应式状态、视觉验证、用户流、交互反馈、输入方式/可访问性、错误恢复和动效转场;Figma/截图/既有页面还原追加 `FigmaHighFidelityRestorationGate`、`ScopedVisualChangeGate`、`InstalledPluginVisualVerificationGate`、`ActualPreviewChainAndMockFallbackGate`、`UIStateScopeRegressionGate`、`FigmaProductionAssetBudgetGate` 与 `RuntimeI18nArtifactVerificationGate`;命中时 TestRoute 纳入 Browser/截图、Playwright/E2E 或人工复核证据
52-
- **复审覆盖增量**: audit / review / ECR 的连续零发现必须附 `ReviewCoverageDelta`(`ReviewedSet` / `UnreviewedRelatedSet` / `NewlyReadThisRound` / `RepeatReadReason` / `NoNewSurfaceReason`),优先阅读此前未审查但相关联的代码、配置、测试、文档、部署副本和消费者链;无新增覆盖且无证据化理由时,不计入有效零发现
51+
- **前端体验质量门禁**: 前端页面、组件、控制台、官网、文档站、可视化工具或游戏任务执行 `FrontendExperienceQualityGate` 条件判定,覆盖设计来源、UI 还原度、风格主题、响应式状态、视觉验证、用户流、交互反馈、输入方式/可访问性、错误恢复和动效转场;Figma/截图/既有页面还原追加 `FigmaHighFidelityRestorationGate`、`ScopedVisualChangeGate`、`InstalledPluginVisualVerificationGate`、`ActualPreviewChainAndMockFallbackGate`、`FrontendRuntimeNetworkProbeGate`、`UIStateScopeRegressionGate`、`FigmaProductionAssetBudgetGate` 与 `RuntimeI18nArtifactVerificationGate`;命中时 TestRoute 纳入 Browser/截图、Playwright/E2E、console/network/resource/runtime 或人工复核证据
52+
- **复审覆盖增量与维度增量**: audit / review / ECR 的连续零发现必须附 `ReviewCoverageDelta`(覆盖面增量)与 `ReviewDimensionDeltaGate`(维度焦点增量),优先阅读此前未审查但相关联的代码、配置、测试、文档、部署副本和消费者链,并避免每轮机械重复同一组维度;无新增覆盖、无新增维度焦点且无证据化理由时,不计入有效零发现
5353
- **规范治理 Intake**: 所有模式下每条用户消息在合理性评估后都会额外检查是否命中可泛化改进;命中时主动写入 `data/process-improvements.md`(优化清单,PI),必要时联动 `data/pending-fixes.md`(PF),并显式回执 `PI/PF`
5454
- **Backlog 真相复核与状态回写**: 从 `data/*.md` open/partial 项组织新需求或新批次前,先按 `pure-open / residual-tail / already-fixed / misclassified` 分类;实施后再执行台账状态回写闭环,避免“源码已修但 backlog 仍旧 open”
5555
- **官方文档证据前置**: 新增或升级依赖、框架、SDK、平台 API、外部模块前,CP2 会要求 `OfficialDocsEvidence`,记录官方文档来源、关键用法、限制与兼容性,避免凭经验猜 API
5656
- **通用工程守门**: Node.js 项目默认不低于 `>=18`;需求/问题定义前置平台工程判断,并记录 `ImplementationComplexityLevel`,开发程度分为 `简单够用 / 中等 / 企业级`,用户未要求复杂化或需求不详细时默认 `简单够用`;依赖/兼容任务拆分业务源码平滑性与依赖层落地条件;包/库/adapter/CLI 同查代码层与包工程层;JS/Node 必要注释使用标准 JSDoc;简单 service 不重复 route/model/schema 已承担的校验
57-
- **跨项目经验吸纳守门**: 字段/本地化/状态新增前执行 `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`、`MethodLevelLeakPressureProbe` 与 `V2FormalSolutionPackage`
57+
- **跨项目经验吸纳守门**: 字段/本地化/状态新增前执行 `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`、`MethodLevelLeakPressureProbe` 与 `V2FormalSolutionPackage`
5858
- **验证卫生与包边界**: release / pack / benchmark / codegen 任务中,package boundary check 必须在构建完成后单独串行执行;消费者验证异常先查 package.json、lockfile、node_modules 与 `npm ls <关键依赖>`,收尾前清理无关 dirty 文件和验证残留
5959
- **ProfileImpactCheck**: dev/fix 改动项目技术栈、目录、脚本、测试/发布路线、分发面、配置或长期连接时,会主动判定是否需要更新 Profile;无需更新时也要写明跳过理由
6060
- **敏感信息与硬编码策略**: 默认允许敏感信息、明文连接信息和硬编码出现在用户要求的代码、脚本、配置、文档、测试或报告中;只有用户 / 项目明确禁止时才脱敏、占位或改用 env、`secretRef`、secret manager、`config.local.json`
@@ -320,7 +320,7 @@ devcodex/
320320

321321
发布前审查由 `audit-release` 承担:它是 audit 专项维度,审查 release readiness、发布说明质量、兼容/迁移风险、package/plugin 元数据、文档/Profile/website 同步、回滚策略、registry/tag 风险与发布后验收;它不替代 `release-verification`,也不执行真实 `tag` / `push` / `publish`。
322322

323-
README / 用户使用文档当前补充两类专项 Skill:`readme-authoring` 负责把 README 默认主视角收口为用户 / 使用者优先,`audit-readme` 负责专项审查用户路径、快速开始、示例真实度、开发信息后置与消费链一致性。
323+
README / 用户使用文档当前补充两类专项 Skill:`readme-authoring` 负责把 README 默认主视角收口为用户 / 使用者优先,`audit-readme` 负责专项审查用户路径、快速开始、示例真实度、开发信息后置与消费链一致性。正式用户文档还执行 `UserPerspectiveDocsGate`、`PublicUserDocsMaintainerBoundaryGate` 和 `DocsConsumerSweep`:检查文档是否足够详细、首次读者是否看得懂、心智负担是否简单,公开用户路径是否排除了维护者 checklist / 内部同步清单 / 台账状态,以及 README / website / Profile / examples / templates / validate / 代码消费点是否同步。
324324

325325
&gt; ℹ️ 维护者状态文件(本仓库开发过程中累积的 violations/pending-fixes 记录)按 active-root 保存,例如 workspace-namespace 下的 `.devcodex/<project>/data/`,**不分发**给用户。
326326

‎RULES.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# DevCodex v1.11.22 — 使用入口
1+
# DevCodex v1.11.23 — 使用入口
22

3-
> AI workflow injector for Copilot / Claude Code / Codex · publisher: Rocky · version: 1.11.22
3+
> AI workflow injector for Copilot / Claude Code / Codex · publisher: Rocky · version: 1.11.23
44
55
## 正式主支持客户端
66

‎changelogs/releases/v1.11.23.md‎

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
# v1.11.23 — 复审文档体验 / 公开用户文档 / 最终汇报吸纳门禁
2+
3+
> 发布日期:2026-06-23
4+
> 变更类型:规范治理 / 文档体验 / 发布边界
5+
> 风险级别:P1
6+
> 向后兼容:✅ 兼容
7+
8+
## 变更摘要
9+
10+
本版本归档 V66/V67 两批跨项目吸纳守门,将复审维度增量、用户视角文档、文档消费者扫描、产物链接去重、前端真实预览运行时探针、公开用户文档维护边界和最终回复 active 范围升级为可执行门禁。
11+
12+
## Added
13+
14+
- 新增 `ReviewDimensionDeltaGate`:复审连续零发现时必须证明审查维度有增量,避免机械重复同一检查面。
15+
- 新增 `UserPerspectiveDocsGate`:正式用户文档需从使用者角度检查详细度、首次成功路径、字段/参数/状态/错误解释、排错恢复与心智负担。
16+
- 新增 `DocsConsumerSweep`:文档变更需扫描 README、website、Profile、示例、模板、导航和代码消费点。
17+
- 新增 `ArtifactLinkSetDedupeGate`:产物链接按 canonical path 去重,避免同一文件在用户界面中双份展示。
18+
- 新增 `FrontendRuntimeNetworkProbeGate`:真实前端预览需检查 console、network、资源 404、API target、hydration/runtime error 等证据。
19+
- 新增 `PublicUserDocsMaintainerBoundaryGate`:公开用户文档、README、官网教程、快速上手、配置/扩展/框架接入指南不得把维护者验收、发布 checklist、内部同步清单、台账状态或实现者复审任务混入用户主路径。
20+
- 新增 `ActiveRequirementFinalResponseGate`:同日或同工作区存在多个相邻需求、backlog、open 任务或未完成候选时,最终回复和完成报告必须声明当前 active requirement/task/bug id,并只围绕当前 active 范围输出完成状态、验证证据、dirty 边界和默认下一步。
21+
- 新增 V66/V67 validate 探针与 `test-spec-governance` 覆盖,关联 `PI-052 / PF-056 / PI-053 / PI-054 / PF-057 / PF-058`。
22+
23+
## Changed
24+
25+
- 同步 `instructions.md`、dev/fix/audit/analyze instructions、`test-router`、dev-docs、document-sync、audit-document、audit-readme、audit-project、report、dev-default、dev-plan-review 等 Skill。
26+
- 同步 CP/report prompts、README、website guide 与活动版本 P1 需求页。
27+
- 同步 `CHANGELOG.md`、`changelogs/unreleased.md` 与发布版本元数据。
28+
- 官网锁文件中的 DOMPurify 从 `3.4.10` 升级到 `3.4.11`,闭环 GitHub Advisory `GHSA-cmwh-pvxp-8882` 对 `<=3.4.10` 的 moderate 审计项。
29+
- 同步工作区 `.github/`、`.claude/`、`AGENTS.md`、`.agents/` 与 `.codex/` 部署副本。
30+
31+
## 验证
32+
33+
```bash
34+
node scripts/test-spec-governance.js
35+
node scripts/validate.js
36+
npm test
37+
npm run test:audit
38+
git diff --check
39+
npm pack --pack-destination E:\Worker\.devcodex\devcodex-v1\.tmp\release-v1.11.23
40+
npm publish --dry-run --registry=https://npm.pkg.github.com
41+
```
42+
43+
均已通过。安装 smoke 使用运行态临时包 `vextjs-devcodex-1.11.23.tgz` 验证安装后 package version 为 `1.11.23`;`npm publish --dry-run` 已触发 `prepublishOnly` 完整链。正式发布后继续执行 tag/registry 验收。
44+
45+
## 相关资源
46+
47+
- `website/docs/versions/v1/1.0.1/requirements/p1/latest-data-absorption-guards/`
48+
- `.devcodex/devcodex-v1/profile/01-项目信息.md`

‎changelogs/unreleased.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,5 +16,7 @@
1616
- 剩余 `data` 吸纳守门类变更需显式标明 `ProductRequirementTraceabilityGate`、`PackageNameAuthorityGate`、`V2MCPFirstPlanningGate` 等关键门禁,避免正式发版前遗漏 V62 覆盖链路。
1717
- 最新 `data` 吸纳守门补强需显式标明 `WorkspaceDataAbsorptionScopeGate`、`DocsSiteVisualAcceptanceGate`、`OmissionOnlyReviewGate`、`MethodLevelLeakPressureProbe` 与 `V2FormalSolutionPackage`,避免正式发版前遗漏 V63 覆盖链路。
1818
- 最新高保真 UI / 提交授权 / 兼容契约吸纳守门需显式标明 `FigmaHighFidelityRestorationGate`、`ActualPreviewChainAndMockFallbackGate`、`ExplicitCommitAuthorizationGate`、`CompatibilityAndContractAuthorityGate` 与 `PublicDocsReleasedVersionGate`,避免正式发版前遗漏 V65 覆盖链路。
19+
- 最新复审与文档体验吸纳守门需显式标明 `ReviewDimensionDeltaGate`、`UserPerspectiveDocsGate`、`DocsConsumerSweep`、`ArtifactLinkSetDedupeGate` 与 `FrontendRuntimeNetworkProbeGate`,避免正式发版前遗漏 V66 覆盖链路;已归档发布项保留历史关联 `PI-052 / PF-056`。
20+
- 最新公开用户文档与最终汇报吸纳守门需显式标明 `PublicUserDocsMaintainerBoundaryGate` 与 `ActiveRequirementFinalResponseGate`,避免正式发版前遗漏 V67 覆盖链路;已归档发布项保留历史关联 `PI-053 / PI-054 / PF-057 / PF-058`。
1921
- 宿主输出、Hook 或项目现实扩展相关条目,建议显式写出 `verified-present / verified-missing / unverified`、sticky `activeProject` 与用户可见 `意图扩展摘要` 是否发生变化。
2022
- 执行闭环、确认机制或发布门禁相关条目,建议补充 `Intent Expansion Card`、`ConfirmationRequest`、`ECR` 与验证证据,方便正式发版时直接归档到版本 changelog。

0 commit comments

Comments
 (0)