Skip to content

Commit 1886752

Browse files
committed
release: v1.11.17
1 parent 03fabde commit 1886752

67 files changed

Lines changed: 842 additions & 92 deletions

File tree

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 & 4 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-10
4+
> **最后更新**: 2026-06-11
55
66
---
77

88
## 版本概览
99

1010
| 版本 | 日期 | 变更摘要 | 详细 |
1111
|------|------|---------|------|
12+
| [v1.11.17](./changelogs/releases/v1.11.17.md) | 2026-06-11 | 🔧 **并发策略、默认 Auto 别名与泄漏稳定性测试路线收口**:新增 `ConcurrencyPolicy` Profile schema、全局默认 `@rocky` Auto 别名、`PE-12` 资源生命周期审查维度与 `LeakRiskStabilityPressureTest` 测试路线,并补齐活动版本 P1 需求页、website sidebar 与治理探针 | [查看](./changelogs/releases/v1.11.17.md) |
1213
| [v1.11.16](./changelogs/releases/v1.11.16.md) | 2026-06-10 | 🔧 **治理 intake 行为闭环、跨项目吸纳守门与发布前收敛**:新增用户建议/纠错的行为级治理 intake replay,修正 source-root 宿主副本治理、Profile/website 新鲜度与 C13 作用域,吸纳跨项目 data 守门并补齐 `TechnicalRouteComparativeGate` | [查看](./changelogs/releases/v1.11.16.md) |
1314
| [v1.11.15](./changelogs/releases/v1.11.15.md) | 2026-06-09 | 🔧 **问答证据门禁、复杂度用户面与产物生命周期收口**:新增 `QuestionEvidenceGate / ComparativeResearchGate`,将 CP1 复杂度主口径升级为 `ImplementationComplexityLevel` 三档,并补齐 `ArtifactDecisionMatrix / ArtifactLifecycleState`、模板漂移探针与 V8 source-root 部署副本检查 | [查看](./changelogs/releases/v1.11.15.md) |
1415
| [v1.11.14](./changelogs/releases/v1.11.14.md) | 2026-06-05 | 🔧 **ExistingRequirementArtifactOverride 与需求回写收口**:修复 `SimpleTaskFastPath` 对既有需求/bug 真相源的过宽豁免,明确调整需求必须先回写已有文件,回复只做摘要;`v1.11.14` 替代未 registry 发布的 `v1.11.13` | [查看](./changelogs/releases/v1.11.14.md) |
@@ -102,9 +103,9 @@
102103

103104
## 相关文档
104105

105-
- [`changelogs/releases/v1.11.16.md`](./changelogs/releases/v1.11.16.md) — 最新版本详细变更文档
106-
- [`changelogs/releases/v1.11.15.md`](./changelogs/releases/v1.11.15.md) — 上一版本详细变更文档
107-
- [`changelogs/releases/v1.11.14.md`](./changelogs/releases/v1.11.14.md) — 历史版本详细变更文档
106+
- [`changelogs/releases/v1.11.17.md`](./changelogs/releases/v1.11.17.md) — 最新版本详细变更文档
107+
- [`changelogs/releases/v1.11.16.md`](./changelogs/releases/v1.11.16.md) — 上一版本详细变更文档
108+
- [`changelogs/releases/v1.11.15.md`](./changelogs/releases/v1.11.15.md) — 历史版本详细变更文档
108109
- [`changelogs/releases/v1.11.13.md`](./changelogs/releases/v1.11.13.md) — 历史版本详细变更文档
109110
- [`changelogs/releases/v1.11.12.md`](./changelogs/releases/v1.11.12.md) — 历史版本详细变更文档
110111
- [`changelogs/releases/v1.11.11.md`](./changelogs/releases/v1.11.11.md) — 历史版本详细变更文档

‎README.md‎

Lines changed: 24 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -33,18 +33,21 @@ DevCodex 通过 `.github/`(Copilot)、`CLAUDE.md + .claude/ + .mcp.json`(C
3333
## 功能特性
3434

3535
- **8 种工作流**: `dev` / `fix` / `audit` / `analyze` / `self-fix` / `resume` / `plan` / `chat`
36-
- **2 种模式**: 确认模式(@DevCodex)/ 全自动模式(@DevCodex Auto,Auto v1.1 对显式 `@devcodex-auto`、Profile `extensions.devcodex.autoAliases`(如 `@rocky`)或明确自然语言 auto 授权 + 白名单路径提供硬保证)
36+
- **2 种模式**: 确认模式(@DevCodex)/ 全自动模式(@DevCodex Auto,Auto v1.1 对显式 `@devcodex-auto`、全局默认 `@rocky`、Profile `extensions.devcodex.autoAliases` 替换别名或明确自然语言 auto 授权 + 白名单路径提供硬保证)
3737
- **合规管线**: FC(形式合规)→ SC(实质合规)→ RC(恢复性检查)→ T(任务完成验证)
3838
- **持久记忆**: 每 Agent、每日的会话记录,结构化字段
3939
- **自动报告**: 每次会话自动写入报告,从不询问 — 直接执行
4040
- **安全底线**: S01~S07 七条不可覆盖的安全规则
4141
- **宿主生命周期护栏**: Claude Code 与 OpenAI Codex 在已支持的 Hook 事件上提供 runtime 护栏;Copilot / JetBrains / Cursor 等无等价本地 Hook 时降级为 instruction-fallback;默认 `safety-only` 仅对危险命令硬拦,流程项提醒放行,`strict` 模式才升级可阻断事件
4242
- **全模式入口检查**: 所有模式在实质任务前显示 PC0~PC7;dev 模式额外执行 PC4 规范雷达与完整合规链
4343
- **项目现实扩展**: 先做语义意图初判,再结合目标项目 Profile、目录与当前任务上下文修正最终路由、产物落点和验证方式
44+
- **可配置并发策略**: Profile `config.json` 可配置 `extensions.devcodex.concurrency`;默认 `auto` 表示只读准备和隔离验证可并行、共享状态写入保持单写者,保守项目可设为 `serial`
4445
- **支撑型 Skill**: `execution-contract` / `test-router` / `release-verification` / `host-contract-verification` / `source-consumer-sync` 为控制面、多批次、测试路线、宿主契约验证与真相源-消费者同步提供可审计支撑,不新增工作流分支
4546
- **发布前审查能力**: `audit-release` 负责 release readiness、发布说明质量、兼容/迁移风险、package/plugin 元数据、文档/Profile/website 同步、回滚策略、registry/tag 风险与发布后验收 review;`release-verification` 仍负责 R0~R7 执行验证链
4647
- **README 专项能力**: `readme-authoring` 负责 README 用户/使用者优先写作,`audit-readme` 负责 README / 用户使用文档专项 review
4748
- **Profile 新鲜度审查**: audit 会先执行 `Profile Freshness Check`,反向核对 Profile 是否仍匹配当前包版本、目录资产、脚本、发布状态、宿主能力和任务现实
49+
- **项目工程泄漏审查**: 项目工程 / 代码质量审查执行 `PE-12 资源生命周期与泄漏风险`,必须检查内存泄露、资源泄漏、监听器/定时器/连接/流未释放、缓存无界增长和组件卸载清理缺失
50+
- **泄漏风险稳定性压测**: 写测试用例或回归验证时先执行 `LeakRiskStabilityPressureTest` 条件判定;命中长运行、高并发、缓存/连接/监听器/定时器/流/socket/worker/订阅/组件生命周期或 `PE-12` 风险时,TestRoute 纳入场景/负载/稳定性压测并记录基线、冷却后回落和资源指标前后对比;低风险任务写 `N/A + skipReason`
4851
- **复审覆盖增量**: audit / review / ECR 的连续零发现必须附 `ReviewCoverageDelta`(`ReviewedSet` / `UnreviewedRelatedSet` / `NewlyReadThisRound` / `RepeatReadReason` / `NoNewSurfaceReason`),优先阅读此前未审查但相关联的代码、配置、测试、文档、部署副本和消费者链;无新增覆盖且无证据化理由时,不计入有效零发现
4952
- **规范治理 Intake**: 所有模式下每条用户消息在合理性评估后都会额外检查是否命中可泛化改进;命中时主动写入 `data/process-improvements.md`(优化清单,PI),必要时联动 `data/pending-fixes.md`(PF),并显式回执 `PI/PF`
5053
- **Backlog 真相复核与状态回写**: 从 `data/*.md` open/partial 项组织新需求或新批次前,先按 `pure-open / residual-tail / already-fixed / misclassified` 分类;实施后再执行台账状态回写闭环,避免“源码已修但 backlog 仍旧 open”
@@ -453,7 +456,26 @@ DevCodex 的 `plugin.json` 声明 `tier: "free"`,所有 Skill 均标注 `tier:
453456
- **可选**:通过 `.github/agents/` 使用 `@devcodex` / `@devcodex-auto` 自定义 Agent 入口
454457
- **Codex**:通过 `AGENTS.md` 自动注入总则,通过 `.agents/skills/` 按需读取技能;不单独维护 `codex/AGENTS.md`
455458

456-
Auto v1.1 当前只在支持 Hook 的宿主里,对显式 `@devcodex-auto`、Profile `config.json` 中 `extensions.devcodex.autoAliases` 配置的精确别名(如 `@rocky`),或明确自然语言 auto 授权(如“进入 auto 模式执行”)下的白名单路径提供 runtime 级硬保证;模糊提及、询问 auto 规则、未配置昵称或普通“继续”不算授权。JetBrains 等 `instruction-fallback` 宿主仅同步规则语义,不承诺完全等价的自动放行。Auto 任务若命中控制面、多批次或预计修改 ≥10 文件,仍须先形成 ExecutionContract 并持续更新实施进度。
459+
Auto v1.1 当前只在支持 Hook 的宿主里,对显式 `@devcodex-auto`、全局默认 `@rocky`、Profile `config.json` 中 `extensions.devcodex.autoAliases` 配置的替换别名,或明确自然语言 auto 授权(如“进入 auto 模式执行”)下的白名单路径提供 runtime 级硬保证;配置了 `autoAliases` 时该列表替换全局默认别名,空数组表示关闭默认别名;模糊提及、询问 auto 规则、未生效昵称或普通“继续”不算授权。JetBrains 等 `instruction-fallback` 宿主仅同步规则语义,不承诺完全等价的自动放行。Auto 任务若命中控制面、多批次或预计修改 ≥10 文件,仍须先形成 ExecutionContract 并持续更新实施进度。
460+
461+
`config.json` 还可配置 `extensions.devcodex.concurrency`:
462+
463+
```json
464+
{
465+
"extensions": {
466+
"devcodex": {
467+
"concurrency": {
468+
"mode": "auto",
469+
"readOnly": { "enabled": true, "maxParallel": 4, "allowAgents": true },
470+
"validation": { "enabled": true, "maxParallel": 2 },
471+
"locks": { "additionalSingleWriterScopes": [] }
472+
}
473+
}
474+
}
475+
}
476+
```
477+
478+
默认 `auto` 采用 `parallel prepare, serial commit`:文件搜索、Profile/记忆读取、只读分析和互不写同一输出的验证可并行;同一 active-root 的 CP 状态、记忆、报告、台账、audit session、source mutation、package boundary 和危险操作必须串行或单写者。保守项目可设 `mode: "serial"`;首期不支持 `parallel` 或 `allowParallelMutations`。
457479

458480
## 许可证
459481

‎RULES.md‎

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

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

‎agents/README.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
| Agent | 名称 | CP 门控 | 适用场景 |
1111
|-------|------|:-------:|---------|
1212
| `@devcodex` | 确认模式 | 🔴 CP1/CP2/CP3 逐项等待用户确认 | 开发/修复/审计的常规交互 |
13-
| `@devcodex-auto` / Profile `autoAliases`(如 `@rocky`) | 全自动模式 | ✅ CP 自动通过 | 批量任务、CI/CD 环境、信任度高的仓库维护 |
13+
| `@devcodex-auto` / `@rocky` / Profile `autoAliases` 替换别名 | 全自动模式 | ✅ CP 自动通过 | 批量任务、CI/CD 环境、信任度高的仓库维护 |
1414

1515
## 核心差异
1616

@@ -31,7 +31,7 @@
3131
## 使用建议
3232

3333
- **默认**:保留 `devcodex init/update` 自动分发的 `.github/agents/`;日常可直接用 Copilot Chat,只有需要显式入口时再 `@devcodex` / `@devcodex-auto`
34-
- **高频维护**:引入 `@devcodex-auto`,或在项目 Profile `config.json` 配置 `extensions.devcodex.autoAliases`(如 `["@rocky"]`),在确保仓库可回滚的前提下加速执行
34+
- **高频维护**:直接使用全局默认 `@rocky` 或 `@devcodex-auto`;若团队要换口令或关闭默认别名,可在项目 Profile `config.json` 配置 `extensions.devcodex.autoAliases` 替换默认值(省略沿用 `@rocky`,空数组关闭默认别名)
3535
- **严格审查**:引入 `@devcodex`,确保每个关键节点有人工确认
3636
- **长流程任务**:无论确认模式还是 Auto,命中控制面、多批次、预计修改 ≥10 文件或正式发版时,都应把 ExecutionContract / TestRoute / ReleaseAudit / ReleaseVerification 写入报告证据
3737

‎agents/devcodex-auto.agent.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: DevCodex Auto
3-
description: AI 开发规范助手(全自动模式 v1.1)— 显式 @devcodex-auto、Profile autoAliases(如 @rocky)或明确自然语言 auto 授权 + 白名单路径下自动推进,安全底线仍强制执行。所有规则由 instructions/ 自动注入。
3+
description: AI 开发规范助手(全自动模式 v1.1)— 显式 @devcodex-auto、全局默认 @rocky、Profile autoAliases 替换别名或明确自然语言 auto 授权 + 白名单路径下自动推进,安全底线仍强制执行。所有规则由 instructions/ 自动注入。
44
tools:
55
- edit
66
- execute
@@ -14,7 +14,7 @@ disable-model-invocation: true
1414

1515
`DevCodex Auto` 不是“所有任务都自动推进”,而是 **Auto v1.1 最小闭环**:
1616

17-
- **正式入口**:显式 `@devcodex-auto`、项目 Profile `config.json` 的 `extensions.devcodex.autoAliases` 精确别名(如 `@rocky`),或明确自然语言 auto 授权;模糊提及、询问 auto 规则、未配置昵称或普通“继续”不算授权
17+
- **正式入口**:显式 `@devcodex-auto`、全局默认 `@rocky`、项目 Profile `config.json` 的 `extensions.devcodex.autoAliases` 替换别名,或明确自然语言 auto 授权;配置了 `autoAliases` 时该列表替换全局默认别名,空数组表示关闭默认别名;模糊提及、询问 auto 规则、未生效昵称或普通“继续”不算授权
1818
- **hook-enforced 宿主**:仅对白名单路径自动推进;非白名单路径默认回确认模式
1919
- **instruction-fallback 宿主**:如 JetBrains / Cursor,只同步规则语义,不承诺 runtime 级硬放行;支持 Hook 的宿主按白名单执行 runtime 放行
2020
- **白名单范围**:DevCodex 治理文件、`.devcodex/` 产物、README 与 auto 专属回归脚本

‎changelogs/releases/v1.11.17.md‎

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
# v1.11.17 — 并发策略、默认 Auto 别名与泄漏稳定性测试路线收口
2+
3+
> 发布日期:2026-06-11
4+
5+
## 变更摘要
6+
7+
- 新增 `extensions.devcodex.concurrency` Profile schema 与 `ConcurrencyPolicy` 规则口径:默认 `auto` 支持只读准备、只读子 Agent 分析和隔离验证并行;`serial` 可退回全串行;核心单写者域固定保护 `active-root`、`memory`、`report`、`ledger`、`audit-session`、`cp-state`、`source-mutation`、`package-boundary` 与 `dangerous-operation`。
8+
- 阻断并行 mutation 误配置:项目只能追加更保守的 `locks.additionalSingleWriterScopes`,不得删除核心域;首期不支持 `parallel` 模式、`allowParallelMutations` 或任何并行 mutation 配置。
9+
- 将 `@rocky` 从项目 Profile 示例别名升级为 Auto v1.1 全局默认精确别名;`extensions.devcodex.autoAliases` 改为替换默认别名的配置项,省略沿用默认,空数组关闭默认别名。
10+
- 新增项目工程审查 `PE-12 资源生命周期与泄漏风险`:代码审查必须检查内存泄露、资源泄漏、监听器/定时器/连接/流未释放、缓存无界增长、前端组件卸载清理缺失等问题;不适用时写明 `N/A + skipReason`。
11+
- 新增测试路线 `LeakRiskStabilityPressureTest`:写测试用例或回归验证时按项目资源生命周期风险判定是否纳入泄漏风险稳定性压测;命中长运行、高并发、缓存/连接/监听器/定时器/流/socket/worker/订阅/组件生命周期或 `PE-12` 风险时,TestRoute/场景测试必须记录基线、压力过程、冷却后回落、资源指标前后对比和清理证据。
12+
- 补齐活动版本 `1.0.1` P1 需求页与站点入口:新增 `leak-risk-stability-pressure` 详情页,同步 requirements index、版本 changelog 与 Rspress sidebar;将 `concurrency-policy` 详情页状态更新为已实现。
13+
14+
## Fixed
15+
16+
- 修复测试规范只覆盖功能正确性、未明确把泄漏风险稳定性压测纳入 TestRoute 判定的缺口。
17+
- 修复代码审查规范缺少显式内存泄露 / 资源泄漏检查维度的问题。
18+
- 修复 `@rocky` 仅作为项目 Profile 示例而未成为 Auto 全局默认别名,导致同一自然语言授权在新项目中不可预测的问题。
19+
- 修复 `ConcurrencyPolicy` 缺少 Profile schema、active Profile 说明和非法配置探针的问题。
20+
- 修复活动版本 changelog 已记录 `LeakRiskStabilityPressureTest`,但 requirements index、P1 详情页和 website sidebar 不完整的问题。
21+
22+
## Release Gate Evidence
23+
24+
- `OfficialDocsEvidence`: N/A。本轮不新增/升级第三方依赖、框架、SDK 或外部平台 API。
25+
- `ProfileImpactCheck`: updated。active Profile 已同步 `extensions.devcodex.concurrency`、默认 `@rocky` Auto 别名、`PE-12` / `LeakRiskStabilityPressureTest` 发布状态与 v1.11.17 release 目标。
26+
- `ConceptSyncMap`: sourceOfTruth 为 `instructions.md`、`instructions/01-common.instructions.md`、`instructions/01a-profile-loading.instructions.md`、`instructions/12-audit.instructions.md`、`instructions/17-compliance.instructions.md`、`skills/audit-project/SKILL.md`、`skills/dev-testing/SKILL.md`、`skills/test-router/SKILL.md`、`hooks/_runtime/lifecycle-project-target.cjs`、`scripts/validate-profile.js` 与 `scripts/lib/validate-governance-tail.js`;currentConsumers 已同步 README、RULES、Agent、Skills、Prompts、website 当前文档、活动版本 requirements、Rspress sidebar、validate probes 与 active Profile;historicalMirrors 为 `website/docs/versions/v1/1.0.0/**` 等历史归档。
27+
- `ReleaseRecovery`: 不重写远端 `v1.11.16` tag;v1.11.17 作为新 patch 发布,registry/tag 以 v1.11.17 验收。
28+
- `OpenBacklog`: `PI-019`、`PI-020`、`ISSUE-027` 属于 v2 一期治理路线,未纳入本次 v1 patch 发布阻断。
29+
30+
## Validation
31+
32+
- `node scripts/validate-versions.js`
33+
- `node scripts/validate.js`
34+
- `node scripts/test-spec-governance.js`
35+
- `npm test`
36+
- `npm run test:audit`
37+
- `git diff --check`
38+
- `npm pack --dry-run`
39+
- `npm publish --dry-run`
40+
- remote main/tag verification
41+
- GitHub Packages registry verification

‎changelogs/unreleased.md‎

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,6 @@
66
77
---
88

9-
## 当前状态
10-
11-
- 暂无未发布变更。
12-
139
## 记录提示
1410

1511
- 控制面 / 长流程 / 多批次变更写入本文件时,优先标明 `execution-contract`、`test-router`、`release-verification`、`host-contract-verification`、`source-consumer-sync` 等支撑型能力是否同步更新。

‎hooks/_runtime/lifecycle-project-target.cjs‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -238,11 +238,14 @@ function buildLifecycleProjectTargetUtils({
238238
return new RegExp(`(^|\\s)${escaped}(?=$|[\\s,.;:!?,。;:!?])`, 'i').test(prompt)
239239
}
240240

241+
const DEFAULT_AUTO_ALIASES = ['@rocky']
242+
241243
function getConfiguredAutoAliases(state, target) {
242-
if (typeof readProjectProfileConfig !== 'function') return []
244+
if (typeof readProjectProfileConfig !== 'function') return DEFAULT_AUTO_ALIASES.slice()
243245
const activeProject = target?.activeProject || state?.activeProject || ''
244246
const cfg = readProjectProfileConfig(state || {}, activeProject)
245247
const aliases = cfg?.extensions?.devcodex?.autoAliases
248+
if (aliases === undefined) return DEFAULT_AUTO_ALIASES.slice()
246249
if (!Array.isArray(aliases)) return []
247250
const seen = new Set()
248251
const validAliases = []

0 commit comments

Comments
 (0)