Skip to content

Commit 339d8c4

Browse files
committed
fix: enforce config.local connection source
1 parent f640a9a commit 339d8c4

38 files changed

Lines changed: 158 additions & 89 deletions

‎CHANGELOG.md‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@
99

1010
| 版本 | 日期 | 变更摘要 | 详细 |
1111
|------|------|---------|------|
12+
| [v1.11.10](./changelogs/releases/v1.11.10.md) | 2026-06-02 | 🔧 **config.local 连接配置唯一入口收口**:收窄 S02 为可提交产物秘密禁止,允许用户授权的本地明文秘密写入已忽略的 `profile/config.local.json`,并强制脚本、测试、数据库 / SSH / MongoDB / 数据操作连接信息只能从 `config.local.json` 取得 | [查看](./changelogs/releases/v1.11.10.md) |
1213
| [v1.11.9](./changelogs/releases/v1.11.9.md) | 2026-06-02 | 🔧 **通用规范吸纳与提示词激励收口**:吸纳自然语言 Auto、Node.js >=18、远端 CI、依赖/兼容拆层、内部共享库评估、包工程层、TS 契约迁移、provider/connector 字段合同、service 防过度防御、README 能力矩阵与 JS/Node 标准 JSDoc,并补齐最小实现/复杂度预算守门 | [查看](./changelogs/releases/v1.11.9.md) |
1314
| [v1.11.8](./changelogs/releases/v1.11.8.md) | 2026-06-02 | 🔧 **technical-design 技术方案模板字段补强**:补齐目标架构、模块边界、接口契约矩阵、数据/状态模型、执行流程锚点与需求验收映射,并同步 `dev-plan-review` 与 `V13` 探针,避免 CP2 技术方案退化为文件清单或散落测试备注 | [查看](./changelogs/releases/v1.11.8.md) |
1415
| [v1.11.7](./changelogs/releases/v1.11.7.md) | 2026-06-01 | 🔧 **官方文档证据前置 + Profile 联动判定补强**:新增 `C20/C21`、`OfficialDocsEvidence` 与 `ProfileImpactCheck` 执行链,同步 dev/fix、plan-review、document-sync、Prompt、README/website 与 `V54` 探针,并补齐 CLI runtime helper 包边界 | [查看](./changelogs/releases/v1.11.7.md) |
@@ -95,9 +96,9 @@
9596

9697
## 相关文档
9798

98-
- [`changelogs/releases/v1.11.9.md`](./changelogs/releases/v1.11.9.md) — 最新版本详细变更文档
99-
- [`changelogs/releases/v1.11.8.md`](./changelogs/releases/v1.11.8.md) — 上一版本详细变更文档
100-
- [`changelogs/releases/v1.11.7.md`](./changelogs/releases/v1.11.7.md) — 历史版本详细变更文档
99+
- [`changelogs/releases/v1.11.10.md`](./changelogs/releases/v1.11.10.md) — 最新版本详细变更文档
100+
- [`changelogs/releases/v1.11.9.md`](./changelogs/releases/v1.11.9.md) — 上一版本详细变更文档
101+
- [`changelogs/releases/v1.11.8.md`](./changelogs/releases/v1.11.8.md) — 历史版本详细变更文档
101102
- [`changelogs/releases/v1.11.6.md`](./changelogs/releases/v1.11.6.md) — 上一个版本详细变更文档
102103
- [`changelogs/releases/v1.11.5.md`](./changelogs/releases/v1.11.5.md) — 历史版本详细变更文档
103104
- [`changelogs/releases/v1.11.4.md`](./changelogs/releases/v1.11.4.md) — 历史版本详细变更文档

‎README.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ DevCodex 通过 `.github/`(Copilot)、`CLAUDE.md + .claude/ + .mcp.json`(C
5050
- **官方文档证据前置**: 新增或升级依赖、框架、SDK、平台 API、外部模块前,CP2 会要求 `OfficialDocsEvidence`,记录官方文档来源、关键用法、限制与兼容性,避免凭经验猜 API
5151
- **通用工程守门**: Node.js 项目默认不低于 `>=18`;依赖/兼容任务拆分业务源码平滑性与依赖层落地条件;包/库/adapter/CLI 同查代码层与包工程层;JS/Node 必要注释使用标准 JSDoc;简单 service 不重复 route/model/schema 已承担的校验
5252
- **ProfileImpactCheck**: dev/fix 改动项目技术栈、目录、脚本、测试/发布路线、分发面、配置或长期连接时,会主动判定是否需要更新 Profile;无需更新时也要写明跳过理由
53-
- **Profile 本地私有配置**: `config.local.json` 支持长期连接、env 引用和 `extensions.<namespace>` 受控扩展位;文件应加入 `.gitignore`,且不能覆盖 `mode` / `agent`;核心秘密只允许 `*Env` / `secretRef`
53+
- **Profile 本地私有配置**: `config.local.json` 是脚本、测试、数据库 / SSH / MongoDB / 数据操作的连接配置唯一入口,支持长期连接、env 引用、已授权本地明文秘密和 `extensions.<namespace>`;文件应加入 `.gitignore`,且不能覆盖 `mode` / `agent`
5454
- **变更日志分层**: 未发布实现变更写 `changelogs/unreleased.md`,已发布详情统一归档到 `changelogs/releases/vX.Y.Z.md`,目录说明见 `changelogs/README.md`
5555
- **执行闭环复审**: dev/fix 完成前执行 ECR 执行闭环复审,交叉验证 CP 产物、报告、daily memory、SUMMARY、diff/commit、测试/探针与 dirty 边界
5656
- **推荐结论**: analyze/audit/report 多建议或多路径场景必须给出推荐结论与推荐理由;无后续动作时明确写“推荐:无后续动作”
@@ -208,7 +208,7 @@ AGENTS.md ← 与 instructions.md / copilot-instructions.md / CL
208208
- 单项目任务:写入 `<workspace>/.devcodex/<project>/...`
209209
- 全工作区任务:写入 `<workspace>/.devcodex/workspace/...`
210210
- `config.json`:`workspace/profile` 作为 base,`<project>/profile` 作为 overlay
211-
- `config.local.json`:与 `config.json` 采用相同的 `workspace/profile + <project>/profile` overlay 模型,但仅用于本地私有配置、长期连接和 `extensions.<namespace>`;不覆盖 `mode` / `agent`;可保存 host、port、database、schema、username、内部 URL、连接别名等非核心本地私有信息,密码、Token、API Key、私钥、client secret、签名密钥、连接密码等核心秘密必须使用 `*Env` / `secretRef`
211+
- `config.local.json`:与 `config.json` 采用相同的 `workspace/profile + <project>/profile` overlay 模型,但仅用于本地私有配置、长期连接、env 引用、已授权本地明文秘密和 `extensions.<namespace>`;不覆盖 `mode` / `agent`;脚本、测试、数据库 / SSH / MongoDB / 数据操作连接信息必须从这里取得,缺失时提醒用户补齐,不得自行发明 `.env` 文件、环境变量名或并行配置格式
212212
- Profile 文档:项目命名空间文件优先,缺失回退到 `workspace/profile`
213213
- CLI / Hook 运行态目录:统一写 active-root;单项目为 `<workspace>/.devcodex/<project>/.memory|.audit-state`,全工作区为 `<workspace>/.devcodex/workspace/.memory|.audit-state`
214214
- 多项目 workspace 根缺少 workspace profile 时,Hook 提示真实路径 `.devcodex/workspace/profile/`;同一宿主会话已识别唯一项目后,后续“继续/确认”会在短 TTL 内沿用该项目和项目 `mode`,新会话、TTL 过期或显式 workspace 请求会重新判断。

‎RULES.md‎

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

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

‎changelogs/releases/v1.11.10.md‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
# v1.11.10 — config.local 连接配置唯一入口收口
2+
3+
> 发布日期:2026-06-02
4+
5+
## 变更摘要
6+
7+
- 收窄 S02 安全底线:禁止秘密进入可提交 / 可传播产物;用户明确授权时,明文秘密可写入已被 `.gitignore` 排除的 `profile/config.local.json` 本地 overlay。
8+
- 新增连接配置唯一入口规则:脚本、测试、数据库 / SSH / MongoDB / 数据操作连接信息必须从当前 Profile 路径模型下的 `config.local.json` 读取;缺失时提醒用户补齐,不得自行发明 `.env` 文件、环境变量名或并行配置格式。
9+
- 同步 dev/fix 工作流、Profile 加载、CP gate、技术方案/实施计划模板、Profile 模板、README、website 与 bootstrap 生成器,避免提示词消费者继续输出旧策略。
10+
- 更新 `validate-profile` schema:允许 `password`、`token`、`apiKey`、`privateKey`、`clientSecret`、`signingKey`、`connectionPassword` 等已授权本地明文字段,并保留类型、`.gitignore` 与 reserved key 校验。
11+
- 更新治理探针与回归测试:新增 `validRawSecretLocalConfig`,将 `V40/V53` 从旧的 `*Env/secretRef` 强制断言迁移到 `config.local` 唯一入口与本地明文授权断言。
12+
13+
## 验证
14+
15+
- `OfficialDocsEvidence: N/A`,本轮不新增/升级第三方依赖、框架、SDK、平台 API 或外部模块,属于规范与本地校验链修复。
16+
- `ProfileImpactCheck: updated`,已同步 DevCodex Profile 当前版本/阶段到 `1.11.10`,并同步 README / website / Profile 模板中 `config.local.json` 连接来源说明。
17+
- `node scripts/test-validate-profile.js`
18+
- `node scripts/test-spec-governance.js`
19+
- `node scripts/validate.js`

‎instructions.md‎

Lines changed: 13 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
| # | 规则 | 执行 |
1111
|:-:|------|------|
1212
| S01 | 删除/破坏性操作分两级:**不可逆**(删除文件/清空目录)必须等待用户明确 yes/no;**可逆**(重命名/移动)输出计划后执行 | 🔴 强制 |
13-
| S02 | 禁止硬编码 API Key、密码、Token、私钥、client secret、签名密钥、连接密码等核心秘密;私有仓库或用户授权仅可触发受控私有例外,不能豁免核心秘密禁止项 | 🔴 致命终止 |
13+
| S02 | 禁止硬编码 API Key、密码、Token、私钥、client secret、签名密钥、连接密码等秘密到可提交 / 可传播产物;用户明确授权时,明文秘密只能写入已被 `.gitignore` 排除的 `profile/config.local.json` 本地 overlay | 🔴 致命终止 |
1414
| S03 | 规范文件不存在或读取失败时必须按降级路径执行,禁止 AI 推测补全规范内容 | 🔴 致命终止 |
1515
| S04 | 源码和规范文件(.md)修改必须用增量编辑(Edit),禁止整文件重写 | 🟡 操作级阻断 |
1616
| S05 | 每次会话结束前必须写入记忆文件和报告文件,禁止询问用户"是否需要写入" | 🔴 强制 |
@@ -21,14 +21,16 @@
2121

2222
### S02 受控私有例外模型
2323

24-
S02 的核心秘密禁止项不可豁免;“私有仓库”“本地使用”或“用户确认可以”只能触发受控例外流程,不能把 API Key、密码、Token、私钥、client secret、签名密钥、连接密码等明文写入可提交文件。
24+
S02 的安全底线是禁止秘密进入可提交或可传播产物;“私有仓库”“本地使用”或“用户确认可以”只能触发受控本地例外,不能把 API Key、密码、Token、私钥、client secret、签名密钥、连接密码等明文写入可提交文件、文档、日志或报告。用户明确授权明文保存时,安全底线不得高于用户确认,但承载位置必须收敛到已忽略的 `profile/config.local.json`。
2525

2626
| 分类 | 处理 |
2727
|------|------|
28-
| 核心秘密 | 永不明文写入代码、配置、注释、README、Profile 或任务报告;必须使用环境变量、secret manager 引用、CI/CD secret 或 `config.local.json` 中的 `*Env` / `secretRef` |
29-
| 非核心本地私有信息 | 可在用户明确授权后写入不提交的本地 overlay,例如 host、port、database、schema、username、内部服务 URL、租户/项目 ID、只读开关、连接别名 |
30-
| 承载位置 | 首选 `.devcodex/**/profile/config.local.json`;也可使用 `.env.local`、`.env.test.local` 或任务目录 `.tmp/local-config/`;这些文件必须被 `.gitignore` 排除 |
31-
| 审计要求 | 报告或记忆中记录授权来源、目标文件、字段类型、是否使用 `*Env` / `secretRef`、脱敏策略和回退方式;不得记录秘密明文 |
28+
| 可提交产物秘密 | 永不明文写入代码、可提交配置、注释、README、Profile 文档、任务报告、日志或示例真实值;应使用占位符、环境变量引用、secret manager 引用、CI/CD secret、`*Env` 或 `secretRef` |
29+
| 已授权本地明文秘密 | 用户明确授权后,可写入不提交的 `profile/config.local.json`,例如 `connections.<alias>.password`、`token`、`apiKey`、`privateKey`、`clientSecret`、`signingKey`、`connectionPassword`;文件必须被 `.gitignore` 排除,且输出、报告、记忆、测试快照不得回显明文值 |
30+
| 非核心本地私有信息 | 可在用户明确授权后写入 `profile/config.local.json`,例如 host、port、database、schema、username、内部服务 URL、租户/项目 ID、只读开关、连接别名 |
31+
| 连接配置唯一入口 | 脚本、测试、数据库 / SSH / MongoDB / 数据操作等连接信息必须先从当前 Profile 路径模型下的 `config.local.json` 读取;缺失文件或字段时提醒用户补齐该文件,不得自行发明 `.env` 文件、环境变量名或并行配置格式;如需环境变量,也只能使用 `config.local.json` 中声明的 `*Env` 字段作为间接引用 |
32+
| 承载位置 | 唯一首选 `.devcodex/**/profile/config.local.json`(workspace-namespace 下按 `workspace base + project overlay` 读取)。`.env.local` / `.env.test.local` 只能作为被 `config.local.json` 中 `*Env` 引用的运行时变量来源,AI 不得将其创建为连接配置入口;本地文件必须被 `.gitignore` 排除 |
33+
| 审计要求 | 报告或记忆中记录授权来源、目标文件、字段类型、是否使用明文字段 / `*Env` / `secretRef`、脱敏策略和回退方式;不得记录秘密明文 |
3234
| Profile 说明 | 若使用 `config.local.json` 或 `extensions.<namespace>`,必须在 `01-项目信息.md` 或 Profile README 说明用途、字段语义和使用方式 |
3335

3436
---
@@ -51,7 +53,7 @@ S02 的核心秘密禁止项不可豁免;“私有仓库”“本地使用”
5153
|:-:|------|------|
5254
| C01 | 删除/破坏性确认 | 同 S01 |
5355
| C02 | CP 不可跳过合并 | dev/fix 工作流 CP1→CP2 必须严格按序,禁止合并或跳跃 |
54-
| C03 | 禁止硬编码敏感信息 | 同 S02(核心秘密禁止项不可豁免;非核心本地私有信息只能按受控私有例外模型处理)|
56+
| C03 | 禁止硬编码敏感信息 | 同 S02(可提交产物秘密禁止项不可豁免;已授权本地明文秘密与非核心本地私有信息只能写入被忽略的 `profile/config.local.json`)|
5557
| C04 | 禁止编造规范 | 同 S03 |
5658
| C05 | 记忆+报告自动写入 | 同 S05 |
5759
| C06 | 禁止 overwrite 源码/规范 | 同 S04 |
@@ -128,7 +130,8 @@ S02 的核心秘密禁止项不可豁免;“私有仓库”“本地使用”
128130
- Hook Stop/PreCompact 对入口检查块的可见回复验证必须区分 `verified-present` / `verified-missing` / `unverified` 三态;无法解析最终 assistant 内容时只能提示“无法验证最终用户可见回复”并附 payload capture 指引,禁止断言“未输出”。
129131
- 当 `<工作区根>/.devcodex/layout.json` 启用 `workspace-namespace` 时,Profile 与运行态目录按**工作区集中命名空间**读取:
130132
- `config.json`:`<工作区根>/.devcodex/workspace/profile/` 作为 base,`<工作区根>/.devcodex/<project>/profile/` 作为 overlay
131-
- `config.local.json`:与 `config.json` 使用相同的 `workspace base + project overlay` 路径模型,但仅承载本地私有 overlay(长期连接、env 引用、`extensions.<namespace>`);不得覆盖 `mode` / `agent` / `pluginVersion`
133+
- `config.local.json`:与 `config.json` 使用相同的 `workspace base + project overlay` 路径模型,但仅承载本地私有 overlay(长期连接、env 引用、已授权本地明文秘密、`extensions.<namespace>`);不得覆盖 `mode` / `agent` / `pluginVersion`
134+
- `config.local.json` 是连接配置唯一入口:脚本、测试、数据库 / SSH / MongoDB / 数据操作必须先从当前 Profile 路径模型下的 `config.local.json` 读取连接信息;缺失文件或字段时提醒用户补齐,不得自行发明 `.env` 文件、环境变量名或并行配置格式
132135
- Profile 文档:项目命名空间文件优先,缺失回退到 `workspace/profile/`
133136
- 运行态目录:单项目写 `<工作区根>/.devcodex/<project>/...`,全工作区写 `<工作区根>/.devcodex/workspace/...`
134137
- workspace-namespace 下缺少 workspace profile 的多项目提示必须指向 `.devcodex/workspace/profile/`;同一宿主会话已识别唯一目标项目时,后续“继续 / 确认”等消息可在短 TTL 内沿用 sticky `activeProject` 与项目 `mode`,但新会话、TTL 过期、命中多个项目或用户显式选择 workspace 时必须重新判断。
@@ -141,7 +144,7 @@ S02 的核心秘密禁止项不可豁免;“私有仓库”“本地使用”
141144
| `02-架构约束.md` | 目录结构/边界 | 是 |
142145
| `03-代码风格.md` | 编码规范 | 是 |
143146
| `config.json` | ENV_MODE + agent 兜底标识 | 按需 |
144-
| `config.local.json` | 本地私有 overlay:长期连接、env 引用、`extensions.<namespace>` 扩展位(不提交) | 可选 |
147+
| `config.local.json` | 本地私有 overlay 与连接配置唯一入口:长期连接、env 引用、已授权本地明文秘密、`extensions.<namespace>` 扩展位(不提交) | 可选 |
145148

146149
> **Copilot / Claude Code / Codex 三宿主 Bootstrap 提醒**(v1.11.0+):`lifecycle.cjs` 只在宿主实际提供 Hook 事件时形成 runtime 护栏。Claude Code 具备项目级 hooks + MCP,是当前 Full 路径;Codex 通过 `.codex/hooks.json` 接入,阻断输出按事件契约区分顶层 `decision`、`continue:false` 与工具级 `permissionDecision`;Copilot / JetBrains / Cursor 默认按 instruction-fallback 处理,不承诺本地 Hook 硬拦。默认 `safety-only` 模式下,bootstrap / CP / auto 白名单等流程问题输出提醒并放行工具,仅危险命令继续硬拦;设置 `DEVCODEX_HOOK_ENFORCEMENT=strict` 时,只有支持硬拦的事件才停止流程。AI 仍须在首条用户可见回复输出 PC0~PC7 入口检查块(S07/C18)。
147150
@@ -587,7 +590,7 @@ CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 →
587590

588591
## 全自动模式豁免
589592

590-
当用户选择 `@devcodex-auto` 或明确自然语言 auto 授权(如“进入 auto 模式执行”)时:CP1/CP2/CP3 确认自动通过;模糊提及、询问 auto 规则或普通“继续”不等价于 auto 授权;S01/S02 核心秘密禁止项/S03~S07/C01/C10/C18 不可豁免。S02 受控私有例外只能按上文模型执行,不属于绕过安全底线。
593+
当用户选择 `@devcodex-auto` 或明确自然语言 auto 授权(如“进入 auto 模式执行”)时:CP1/CP2/CP3 确认自动通过;模糊提及、询问 auto 规则或普通“继续”不等价于 auto 授权;S01/S02 可提交产物秘密禁止项/S03~S07/C01/C10/C18 不可豁免。S02 受控私有例外只能按上文模型执行;用户明确授权本地明文时,只能写入被忽略的 `profile/config.local.json`,不属于绕过安全底线。
591594

592595
---
593596

0 commit comments

Comments
 (0)