147 lines
6.6 KiB
Markdown
147 lines
6.6 KiB
Markdown
|
# AICodex Prompt Audit 源基线
|
|||
|
|
|
|||
|
|
## 1. 基线状态
|
|||
|
|
|
|||
|
|
本文件记录用于本 change 功能对照的源仓库状态。参考工作区仍可继续变化，但本 change 已通过第 6 节登记的只读 patch bundle 固定实施基线；后续实现只以该冻结包和本 change specs 为依据。
|
|||
|
|
|
|||
|
|
| 字段 | 值 |
|
|||
|
|
| --- | --- |
|
|||
|
|
| 源仓库 | `/Users/mt/code/mt-ai/aicodex/aicodex-api` |
|
|||
|
|
| 采集时间 | `2026-07-16 20:21:19 CST (+0800)` |
|
|||
|
|
| 分支 | `yjb` |
|
|||
|
|
| HEAD | `7a50378851a80650cb0c086260b23abeb3469e6b` |
|
|||
|
|
| 工作区 | dirty |
|
|||
|
|
| 已跟踪差异 | 38 files changed, 1306 insertions(+), 227 deletions(-) |
|
|||
|
|
| 未跟踪范围 | Prompt Guard 实现/测试 6 个文件，加 1 个 OpenSpec change 目录 |
|
|||
|
|
| 冻结状态 | **已用只读 patch bundle 冻结并在 detached worktree 恢复验证** |
|
|||
|
|
|
|||
|
|
当前 HEAD 只代表已提交历史，不能单独代表要迁移的完整功能。同步 fail-closed Guard、出站安全校验、WebSocket/路由顺序测试以及相应 OpenSpec 当前存在于未提交或未跟踪状态。因此，本 change 的临时功能参考是“上述 HEAD + 采集时磁盘工作区”，最终行为权威仍是本 change 的 specs。
|
|||
|
|
|
|||
|
|
## 2. 与迁移直接相关的已跟踪修改
|
|||
|
|
|
|||
|
|
### 后端入口与启动接线
|
|||
|
|
|
|||
|
|
- `ai-gateway/cmd/aicodex/main.go`
|
|||
|
|
- `ai-gateway/internal/controller/prompt_audit.go`
|
|||
|
|
- `ai-gateway/internal/router/relay-router.go`
|
|||
|
|
- `ai-gateway/internal/router/video-router.go`
|
|||
|
|
- `ai-gateway/internal/relay/ws_responses.go`
|
|||
|
|
- `ai-gateway/internal/gatewayadapter/transport/anthropic.go`
|
|||
|
|
- `ai-gateway/internal/gatewayadapter/transport/gemini.go`
|
|||
|
|
- `ai-gateway/internal/gatewayadapter/transport/jimeng.go`
|
|||
|
|
- `ai-gateway/internal/gatewayadapter/transport/kling.go`
|
|||
|
|
- `ai-gateway/internal/gatewayadapter/transport/midjourney.go`
|
|||
|
|
- `ai-gateway/internal/gatewayadapter/transport/openai.go`
|
|||
|
|
- `ai-gateway/internal/gatewayadapter/transport/suno.go`
|
|||
|
|
- `ai-gateway/internal/gatewayadapter/transport/task.go`
|
|||
|
|
|
|||
|
|
### Prompt Audit 核心
|
|||
|
|
|
|||
|
|
- `ai-gateway/internal/service/promptaudit/client.go`
|
|||
|
|
- `ai-gateway/internal/service/promptaudit/config.go`
|
|||
|
|
- `ai-gateway/internal/service/promptaudit/enqueue.go`
|
|||
|
|
- `ai-gateway/internal/service/promptaudit/openai_client.go`
|
|||
|
|
- `ai-gateway/internal/service/promptaudit/probe.go`
|
|||
|
|
- `ai-gateway/internal/service/promptaudit/qwen3guard.go`
|
|||
|
|
- `ai-gateway/internal/service/promptaudit/runtime.go`
|
|||
|
|
- `ai-gateway/internal/service/promptaudit/runtime_coverage_test.go`
|
|||
|
|
- `ai-gateway/internal/service/promptaudit/types.go`
|
|||
|
|
- `ai-gateway/internal/service/promptaudit/worker.go`
|
|||
|
|
- 同目录的 config、diagnostics、probe 测试
|
|||
|
|
|
|||
|
|
### 协议、错误和回归测试
|
|||
|
|
|
|||
|
|
- `ai-gateway/internal/types/error.go`
|
|||
|
|
- `ai-gateway/internal/gatewayadapter/transport/user_concurrency_order_test.go`
|
|||
|
|
|
|||
|
|
### 控制台和类型
|
|||
|
|
|
|||
|
|
- `webui/src/api/promptAudit.test.ts`
|
|||
|
|
- `webui/src/features/prompt-audit/PromptAuditPage.tsx`
|
|||
|
|
- `webui/src/features/prompt-audit/PromptAuditPage.test.tsx`
|
|||
|
|
- `webui/src/features/prompt-audit/promptAuditViewModel.ts`
|
|||
|
|
- `webui/src/features/prompt-audit/promptAuditViewModel.test.ts`
|
|||
|
|
- `webui/src/types/promptAudit.ts`
|
|||
|
|
|
|||
|
|
### 运行说明
|
|||
|
|
|
|||
|
|
- `deploy/.env.example`
|
|||
|
|
- `docs/constraints/41-ai-readable-logging.md`
|
|||
|
|
- `docs/workflows/02-local-dev.md`
|
|||
|
|
|
|||
|
|
## 3. 必须纳入冻结基线的未跟踪文件
|
|||
|
|
|
|||
|
|
以下文件不在 HEAD 中，但属于“完整功能必须要有”的关键证据：
|
|||
|
|
|
|||
|
|
- `ai-gateway/internal/gatewaycore/prompt_guard.go`
|
|||
|
|
- `ai-gateway/internal/service/promptaudit/outbound_security.go`
|
|||
|
|
- `ai-gateway/internal/service/promptaudit/synchronous_guard.go`
|
|||
|
|
- `ai-gateway/internal/service/promptaudit/synchronous_guard_test.go`
|
|||
|
|
- `ai-gateway/internal/relay/ws_responses_prompt_guard_order_test.go`
|
|||
|
|
- `ai-gateway/internal/router/prompt_guard_order_test.go`
|
|||
|
|
- `openspec/changes/add-prompt-audit-synchronous-blocking/`
|
|||
|
|
|
|||
|
|
不得只执行 `git diff HEAD` 后就声称已冻结，因为普通 diff 不包含这些未跟踪文件。
|
|||
|
|
|
|||
|
|
## 4. 功能对照优先级
|
|||
|
|
|
|||
|
|
遇到源实现、源测试和本 change 描述不一致时，按以下顺序决策：
|
|||
|
|
|
|||
|
|
1. 本 change 的三个 delta specs：目标行为契约。
|
|||
|
|
2. 本 change 的 `design.md` 和 `implementation-guide.md`：目标架构与落地约束。
|
|||
|
|
3. 冻结后的源测试及源 OpenSpec：功能完整性参考。
|
|||
|
|
4. 冻结后的源实现：算法、边界和交互参考。
|
|||
|
|
5. 当前已提交 HEAD：历史参考。
|
|||
|
|
|
|||
|
|
目标项目不得复制源仓库的 Ent、Caddy/gatewaycore、React 或全局 option 依赖；只迁移可以被规格和测试证明的行为。
|
|||
|
|
|
|||
|
|
## 5. 实施前冻结步骤
|
|||
|
|
|
|||
|
|
在源仓库所有者确认工作区内容属于迁移基线后，选择一种方式：
|
|||
|
|
|
|||
|
|
### 方案 A：专用 commit/tag（推荐）
|
|||
|
|
|
|||
|
|
1. 在源仓库专用分支提交与 Prompt Audit/Guard 有关的已跟踪和未跟踪文件。
|
|||
|
|
2. 运行源模块及路由/WS 顺序测试。
|
|||
|
|
3. 创建不可移动 tag，或记录完整 commit SHA。
|
|||
|
|
4. 把最终标识和测试结果回写本文件。
|
|||
|
|
|
|||
|
|
### 方案 B：只读 patch 包
|
|||
|
|
|
|||
|
|
1. 生成 tracked diff。
|
|||
|
|
2. 使用能够包含未跟踪文件的归档或补丁流程补齐第 3 节文件。
|
|||
|
|
3. 生成文件清单和 SHA-256；在干净临时目录中恢复并运行测试。
|
|||
|
|
4. 把 patch 路径、清单路径和校验和回写本文件。
|
|||
|
|
|
|||
|
|
禁止把包含真实 API Key、Redis payload、`.env` 私密值或运行日志中的完整 Prompt 放入基线包。
|
|||
|
|
|
|||
|
|
## 6. 最终冻结登记
|
|||
|
|
|
|||
|
|
| 字段 | 待填写值 |
|
|||
|
|
| --- | --- |
|
|||
|
|
| 冻结方式 | 只读 tracked patch + untracked tar archive |
|
|||
|
|
| 冻结 commit/tag | base commit `7a50378851a80650cb0c086260b23abeb3469e6b`（detached restore） |
|
|||
|
|
| patch/archive 绝对路径 | `/Users/mt/code/mt-ai/sub2api/sub2api-mt/openspec/changes/add-openai-compatible-prompt-audit/source-freeze/` |
|
|||
|
|
| manifest SHA-256 | `badab312bf6af4d2c77857a9400381f4da4fbf45722d9f4a6df23bc7005273b6` |
|
|||
|
|
| tracked patch SHA-256 | `f751a13cce3f3a73cd60cae3aececcef6e1e76dcec8c551a7a4747f032234d2b` |
|
|||
|
|
| untracked archive SHA-256 | `1536e2781703b7620e26f2d08b249431fa5846ad9e32b2e8b0d547c3fa3b3632` |
|
|||
|
|
| 冻结人/复核人 | Codex；由恢复后的文件清单、`git diff --check` 和测试命令复核 |
|
|||
|
|
| 冻结时间 | `2026-07-16 20:21:19 CST (+0800)` |
|
|||
|
|
| 源测试结果 | 恢复副本中 Prompt Audit 核心、router、relay、gateway transport 目标测试全部通过，详见 `source-freeze/MANIFEST.md` |
|
|||
|
|
|
|||
|
|
## 7. 复核命令
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd /Users/mt/code/mt-ai/aicodex/aicodex-api
|
|||
|
|
git branch --show-current
|
|||
|
|
git rev-parse HEAD
|
|||
|
|
git status --short
|
|||
|
|
git diff --stat
|
|||
|
|
git diff --name-only
|
|||
|
|
git ls-files --others --exclude-standard
|
|||
|
|
cd ai-gateway
|
|||
|
|
go test ./internal/service/promptaudit
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
本提案编写时上述模块测试已在当前 dirty 磁盘状态通过；冻结后必须再次执行，并记录最终 commit/patch 校验和、执行目录和完整输出。
|