Skip to content

Latest commit

 

History

History
122 lines (94 loc) · 8.28 KB

token-forge-roadmap.md

File metadata and controls

122 lines (94 loc) · 8.28 KB

Token 任务炼金炉优先路线图

战略

从 2026-07-25 起,Token 任务炼金炉是 Margrop Labs 唯一的产品开发主线。2026-07-28 仓库所有者批准 AI 面试工作台为 Token Forge Beta 出口后的第二优先级,但在 Token Forge 达到本文件的完成门槛前只保留 Proposed 合同,不实现功能。AI 故障侦探保留维护; SMART / RMA 报告机暂停并退出后续产品开发序列。

以下事项可以打断主线:

  1. 生产故障、数据泄露或高危依赖漏洞;
  2. 阻塞 Token Forge 发布的公共平台能力;
  3. 仓库所有者明确改变优先级。

许可证选择仍由仓库所有者决定。与 Token Forge 无关的重构、设计升级、AI 能力和增长实验 均不能借公共平台名义插队。

当前差距

Token Forge 已有版本化输入/计划合同、确定性模板、公开 GitHub 仓库摘要适配器、 Provider-neutral AI 规划核心、Markdown / GitHub Issue 导出核心和可用的 Alpha 页面。

当前页面已接通“输入 → 本地模板/AI 增强 → 导出”路径和可选的公开仓库覆盖证据;仓库或 AI 失败不会阻断模板。P1-008 已提供固定 OpenAI-compatible Adapter、HMAC 匿名限流、 SQLite Durable Object 原子状态与页面 AI 入口,并已通过 Preview 真实链路验收;Provider usage 不再作为本地额度账本的可信输入,Production Secrets、部署与 smoke 已完成。 P1-009 已增加六项确定性质量评分、需人工修改标记和依赖安全的可解释排序。P1-010 已 接通当前标签页内的编辑、锁定、删除、依赖安全移动、预算调整、显式质量排序和恢复基线, 每次应用都会重建质量与导出。P1-011 已把最终计划转换为 Provider-neutral、依赖安全、 可逐阶段验收和交接的 Coding Agent 执行包。P1-012 已增加 6K/24K/40K 三档一键模板 样例、受限公开仓库示例、三步引导、错误恢复和移动端结果导航。P0-008 已固定工具链和 Actions,并把依赖、Secret、Schema/fixture 与 Production 手动发布边界接入统一质量门。 P1-013 已增加 31 个完整计划场景、8 份跨技术栈快照、35 个故障注入、五类隐私 sink 和 真实 Chromium 关键路径,并用机器报告持续验证 100% 合同、质量与降级结果。P4-003 已 接入只保存 31 天日期、事件和粗设备类别计数的最小化 Analytics。P4-005 已冻结博客 CTA 合同;P4-006 按仓库所有者决定暂缓。P4-007 已补齐首页与 Token Forge 的 canonical、 Open Graph、Twitter、JSON-LD、同源分享图和 sitemap。因此可直接执行的主流程、首次体验、 可靠性基准与站内发现合同已经走通。P4-008 按仓库所有者要求跳过,随后执行的 P1-014 出口 评审已明确判定 NO-GO:真实观察证据缺失,完整产品闭环尚未达到 Beta 出口。

执行顺序

以下顺序是唯一默认顺序。每次仍只实现一个 TODO ID,并通过独立 PR 交付。

顺序 TODO 目标 解锁结果
1 P1-007 页面接入公开仓库摘要 计划可引用受限、可见的仓库覆盖证据
2 P4-004 AI 预算、限流和熔断 生产 AI 调用具备硬成本边界
3 P1-008 接通生产 AI 规划路径 AI 可增强计划,失败仍保留模板结果
4 P1-009 任务质量评分与可解释排序 模糊、低价值或不合预算的任务可被识别
5 P1-010 本地编辑、锁定与重新规划 用户能控制计划而不是被动接受输出
6 P1-011 生成 Coding Agent 执行包 任务可直接交给 Agent 分阶段执行
7 P1-012 完善引导、样例和移动端体验 新用户无需阅读文档即可完成闭环
8 P0-008 补齐 CI 与安全检查 发布链路具备依赖、Secret 与合同门禁
9 P1-013 建立端到端基准与可靠性矩阵 用可重复数据验证质量和降级路径
10 P4-003 接入最小化 Analytics 可观察打开、运行和导出,不采集正文
11 P4-005 生成 Token Forge 博客 CTA 博客文章获得统一产品入口
12 P4-006 博客导航突出 Token Forge 建立稳定自然流量入口
13 P4-007 完善首页与 Token Forge SEO 搜索和分享页面具备完整元数据
14 P4-008 复盘真实漏斗与失败原因(按要求跳过) 暂不形成真实观察证据
15 P1-014 Token Forge Beta 出口评审(NO-GO) 记录缺口,暂不解锁 AI 面试工作台 P5

P1-008 必须依赖 P4-004,不能先上线无预算边界的真实模型调用。P4-003 只能在核心产品闭环稳定 后接入,避免为了收集数据提前扩大隐私面。

P1-007、P4-004、P1-008、P1-009、P1-010、P1-011、P1-012、P0-008、P1-013、 P4-003、P4-005 与 P4-007 已完成;Production smoke 已通过。P4-006 暂缓,P4-008 按仓库 所有者要求跳过;P1-014 已完成评审但结论为 NO-GO。P5 继续阻塞,除非仓库所有者明确批准 绕过真实观察证据的风险例外。

“特别完善”的完成门槛

只有同时满足以下五类门槛,Token Forge 才视为达到当前战略要求:

1. 完整用户闭环

  • 无需登录、无需 AI 的合成样例始终可用;
  • 可选公开 GitHub 仓库可以产生覆盖报告,并明确显示已读取、已忽略和未知项;
  • 用户可以在模板或 AI 计划上锁定、删除、排序、调整预算并重新验证;
  • 每个任务包含目标、范围、非目标、依赖、验收、测试、风险和 Agent Prompt;
  • 可以导出完整计划、逐任务 Issue 草稿和与具体 Provider 无关的 Coding Agent 执行包。

2. 计划质量

  • Schema、依赖图、Token 总额和工时预算的确定性验证通过率为 100%;
  • 至少 30 个合成基准场景覆盖不同 Token 档位、技术栈、仓库规模和失败路径;
  • 基准中至少 90% 的计划不含无法验收的空泛任务,剩余任务必须被质量规则标为需人工修改;
  • 每个排序和降级结果都能指向明确规则、预算或仓库覆盖证据。

3. 隐私、成本与可靠性

  • 仓库 URL、路径、文件正文、表单目标和计划正文不进入 URL、Analytics 或服务日志;
  • AI 只接收版本化 allowlist 投影,Secret 与疑似 Secret 失败关闭;
  • 单次、单日和单用户预算、超时、重试、限流和熔断均有硬上限;
  • 网络、GitHub、AI、Schema 或导出失败时,页面保留可用模板结果和明确恢复路径;
  • CI、端到端测试、Production smoke test 和回滚说明全部通过。

4. 产品体验

  • 首次用户不阅读仓库文档也能在 3 分钟内完成样例生成和一次导出;
  • 320px 手机宽度、键盘操作、reduced motion 和错误恢复路径通过检查;
  • 页面清楚区分模板结果、仓库证据、AI 增强、未知项和用户修改;
  • 不存在不可运行的按钮、伪造的分析结果或依赖真实凭据的演示。

5. 上线证据

  • 连续观察至少 14 天;
  • 在最小事件口径下累计至少 50 次有效运行和 10 次导出;
  • 没有确认的敏感正文采集事件、P0/P1 未解决缺陷或失控 AI 成本;
  • 完成 P4-008 复盘,并确认是否解锁 AI 面试工作台 P5。

真实使用量不足时继续改善 Token Forge 的入口、样例和核心价值,不以开发新 Lab 代替验证。

冻结规则

  • P2 已完成的 MVP 保留维护,不新增案例、AI 能力或分享功能;
  • P3-004 至 P3-006 暂停并退出默认开发序列,不继续健康分类、AI 解释或 RMA 导出;
  • P5-000 只记录已批准的产品、隐私和复用边界;P5-001 之后阻塞于 P1-014;
  • P1-014 通过后默认只解锁 P5,P2/P3 仍需仓库所有者再次明确批准;
  • 共用组件只有在 Token Forge 当前任务确实需要时才允许扩展;
  • 安全修复可以立即处理,但必须保持边界清晰,并在完成后返回上述执行顺序。