提示：AI 结果必须带引用；若证据不足会提示“未找到可靠证据”。

    下载 Markdown

    提示词资产化系统可执行开发计划（v1.2：AI 辅助解析）

    计划版本：v1.2
    计划日期：2026-02-17
    适用仓库：/Users/Zhuanz/work-space/pe-list（研发） + /Users/Zhuanz/work-space/hot-docs（文档）
    对应方案：/Users/Zhuanz/work-space/hot-docs/content/docs/reference/prompt-asset-system-v1.2-ai-assisted-parsing-solution.md

    1. 执行约束（强制）

    1. 同一时刻仅允许 1 个任务处于“进行中”。
    2. 每个任务必须按固定顺序闭环：
      • 更新跟踪器状态
      • 执行测试并记录结果
      • 提交代码
    3. 未记录“测试结果 + 提交哈希”的任务，不得切换下一任务。
    4. 所有存储访问必须走 cloud-data-proxy，禁止直连数据库。
    5. 前端遵循事件驱动，非必要不使用 useEffect。

    2. 版本目标（v1.2）

    1. 交付 AI 辅助解析闭环：资产 -> 建议稿 -> 人工确认 -> 应用模板。
    2. 支持三种接入方式：Gemini Key、GPT Key、GPT 登录授权。
    3. 具备凭证安全、调用审计、成本统计、失败降级能力。
    4. 与 v1.1 工作台能力兼容，不破坏原有手工流程。

    3. 里程碑（M7）

    里程碑 日期窗口 目标
    M7-W1 2026-02-18 ~ 2026-02-20 数据模型、凭证与 Provider 基础能力
    M7-W2 2026-02-21 ~ 2026-02-24 AI 解析任务编排、结果应用与降级
    M7-W3 2026-02-25 ~ 2026-02-27 前端交互、联调与回归测试
    M7-W4 2026-02-28 ~ 2026-03-01 发布门禁、灰度上线与验收

    4. 可执行任务清单（严格按序）

    ID 任务 优先级 前置 交付物 测试门禁 提交信息模板
    V12-T00 文档基线冻结 P0 无 v1.2 方案/计划/跟踪器文档 文档检查通过 docs(V12-T00): freeze v1.2 ai parse baseline
    V12-T01 DDL 设计与迁移脚本 P0 T00 prompt_ai_credentials/prompt_ai_parse_jobs/prompt_ai_provider_accounts 表与索引 go test ./... feat(V12-T01): add v1.2 ai ddl migration
    V12-T02 配置模型扩展 P0 T01 Provider 配置、加密密钥、超时/重试/限额配置 go test ./... feat(V12-T02): add ai provider runtime config
    V12-T03 凭证加密与掩码工具 P0 T02 凭证加密器、掩码器、主密钥加载 go test ./... feat(V12-T03): add credential crypto utilities
    V12-T04 凭证仓储（Proxy） P0 T03 凭证 CRUD（仅密文入库、掩码出参） go test ./... feat(V12-T04): add ai credential repository
    V12-T05 凭证 API（validate/create/list/delete） P0 T04 POST/GET/DELETE /api/v1/ai/credentials + validate go test ./... feat(V12-T05): add credential management apis
    V12-T06 Provider 适配层骨架 P0 T02 ProviderAdapter 接口、统一错误模型 go test ./... feat(V12-T06): add ai provider adapter interface
    V12-T07 Gemini 适配实现 P0 T06 Gemini 请求封装、返回标准化 go test ./... feat(V12-T07): implement gemini provider adapter
    V12-T08 GPT Key 适配实现 P0 T06 GPT 请求封装、返回标准化 go test ./... feat(V12-T08): implement gpt byok adapter
    V12-T09 GPT 登录授权链路 P1 T06 OAuth start/callback、授权令牌存储与刷新占位 go test ./... feat(V12-T09): implement gpt login authorization flow
    V12-T10 AI 解析任务编排服务 P0 T07,T08 parse-preview 异步任务、job_id 生命周期 go test ./... feat(V12-T10): add ai parse job orchestration
    V12-T11 解析结果 Schema 校验与修复重试 P0 T10 JSON Schema 校验、一次修复重试、失败归因 go test ./... feat(V12-T11): add ai parse schema validation
    V12-T12 结果应用到工作台 P0 T10,T11 POST /api/v1/ai/jobs/{job_id}/apply（写 blocks/variables/examples） go test ./... feat(V12-T12): apply ai parse result to workspace
    V12-T13 降级策略与规则解析兜底 P1 T10 Provider 失败降级到 v1.1 规则 decompose go test ./... feat(V12-T13): add fallback decompose strategy
    V12-T14 审计、指标与成本统计 P0 T05,T10 调用审计、token/cost 统计、失败链路写入 go test ./... feat(V12-T14): add ai observability and cost metrics
    V12-T15 前端凭证管理页面 P0 T05 Provider 选择、凭证校验、掩码列表、删除 cd frontend && pnpm test feat(V12-T15): add ai credential settings ui
    V12-T16 前端解析预览与任务状态 P0 T10,T11 触发解析、轮询状态、展示 warnings/confidence cd frontend && pnpm test feat(V12-T16): add ai parse preview ui
    V12-T17 前端结果对比与应用工作台 P0 T12,T16 diff 视图、人工编辑、应用到模板 cd frontend && pnpm test feat(V12-T17): add ai result apply workflow
    V12-T18 联调与自动化测试补齐 P0 T13~T17 后端/前端成功与失败路径测试、授权链路测试 go test ./... && cd frontend && pnpm test test(V12-T18): add v1.2 ai integration coverage
    V12-T19 发布门禁与上线验收 P0 T18 runbook/checklist/灰度回滚脚本与实测记录 ./scripts/release-gate.sh chore(V12-T19): release gate for v1.2 ai parse

    5. 关键任务细化（重点实现说明）

    5.1 V12-T09 GPT 登录授权

    1. 授权发起接口下发 state 与回调地址。
    2. 回调接口校验 state，交换访问令牌。
    3. 令牌密文存储，不返回前端明文。
    4. 令牌过期时提供刷新逻辑（可先做占位并记录 TODO）。

    5.2 V12-T10 ~ T12 解析编排与应用

    1. 解析任务异步执行，避免阻塞主请求。
    2. 统一结构输出：blocks/variables/examples/warnings/confidence。
    3. 应用动作必须显式触发，默认不自动覆盖现有模板。
    4. 应用后写审计事件，关联 job_id。

    5.3 V12-T14 成本治理

    1. 记录 token_in/token_out/cost_usd/provider/model。
    2. 提供日维度聚合查询（后续可接看板）。
    3. 超预算策略：拒绝调用或降级低成本模型。

    6. 单任务执行 SOP

    1. 开发当前任务最小可交付改动。
    2. 更新跟踪器状态与证据字段。
    3. 运行任务测试门禁并记录结果。
    4. 提交当前任务代码（仅包含相关变更）。
    5. 进入下一任务。

    7. 完成定义（DoD）

    1. 功能 DoD：三种接入方式可用，解析建议可应用。
    2. 安全 DoD：无明文密钥落库、落日志、落前端。
    3. 质量 DoD：核心路径测试通过，失败链路可追踪。
    4. 架构 DoD：新增读写全部通过 cloud-data-proxy。
    5. 交付 DoD：跟踪器、测试记录、提交哈希一致。

    8. 风险与预案

    风险 描述 预案
    R12-01 GPT 登录授权对接周期不确定 BYOK 双通道先上线，授权通道灰度发布
    R12-02 模型输出不稳定导致结构错误 Schema 校验 + 修复重试 + 人工确认
    R12-03 密钥泄漏风险 字段加密、日志脱敏、最小权限、审计追踪
    R12-04 调用成本超预算 限额、默认低成本模型、超额告警
    R12-05 任务并行破坏闭环 严格执行单任务 SOP 与跟踪器门禁

    9. 当前启动任务

    当前执行任务：V12-T00 文档基线冻结。
    完成标志：v1.2 方案、开发计划、状态跟踪器三份文档已落盘并可直接执行。