用户有即将过期或暂时闲置的 Coding Token,却缺少值得做、范围清楚、可以验收的任务。
- 输入额度规模、到期时间、技术栈、目标和可投入时间;
- 可选提供公开 GitHub 仓库 URL;
- 先由确定性模板生成任务骨架;
- AI 在受限仓库摘要上补充 S/M/L 任务;
- 导出完整计划、GitHub Issue 草稿或 Provider-neutral Coding Agent 执行包。
当前 /token-forge/ Alpha 页面代码已开放完整的
本地模板、受限公开仓库摘要、显式 AI 增强、确定性质量评分、本地编辑和三种导出。仓库或
AI 失败不阻断模板与导出;真实 AI 流量已通过 Preview 与 Production smoke 验收。
Token Forge 现为仓库唯一产品开发主线。公开仓库接入、生产 AI 成本边界、计划质量、 本地编辑、Coding Agent 执行包、首次使用、CI 安全门禁、可靠性基准、最小化 Analytics 和博客 CTA 已经完成;导航、SEO 与上线验证继续按 优先路线图 推进。其他 Lab 在路线图出口评审前保持 功能冻结。
输入与计划都必须先通过版本化 Schema。任务依赖还必须位于同一计划、无自引用、无环;预计 Token 和工时总和不得超过输入预算。
P1-002 模板模式 根据 Token 额度和可投入工时选择合同加固、完整功能切片或离线 MVP。它不分析自然语言、不读取仓库、不调用 AI;相同输入会产生相同计划,并作为未来 AI 超时、限流或无效输出时的降级路径。
较大目标会拆成有依赖关系的 S/M 阶段,而不是生成一个边界模糊的 L 任务。三个合成输入 fixture 覆盖小、中、大场景。
P1-003 摘要适配器 只接受规范的公开 GitHub URL,不使用 GitHub Token。它通过固定 API Origin 读取仓库元数据、一次目录树和最多 8 个安全文本文件;单文件、总字节、目录树、响应、超时和重试都有硬上限。
秘密样式路径、生成目录、二进制、过大文件和疑似秘密内容会被跳过。摘要返回覆盖计数、截断 状态和未知项,文件正文明确标记为不可信数据。P1-007 页面只保留固定技术标签和计数,不展示 路径或正文;元数据、目录树、限流或网络失败时直接保留 P1-002 模板结果。
代码负责输入验证、仓库读取上限、任务 Schema、去重基础和安全规则;AI 负责语义拆分、优先级解释和 Prompt 草拟。
P1-004 AI 任务拆分 已实现
token-forge.plan-v1 的 Provider-neutral 核心。Web 只能发送操作专属的最小结构化
数据,不能指定 Provider、模型、系统提示词或密钥。AI 只接收目标、预算约束和可选的最多
4 个无路径脱敏片段;操作输入不超过 20 KiB。
模型输出必须重新通过 Token Forge v1 合同、预算/工时、生产写操作、仓库原文回显和相似 任务去重规则。Secret 输入、超时、不可用或无效输出都会整体丢弃,并返回 P1-002 模板计划。 P1-008 已把核心接到固定 OpenAI-compatible Provider、服务端 HTTP API 和显式页面入口。
P4-004 AI 流量与成本策略 已增加匿名用户、 Token Forge 与全站三层日 Token/微美元预算、60 秒滑动限流、并发预留和熔断状态机。它 的生产配置按固定主模型与顺序回退模型的最坏情况预留 48,000 Token;主模型直接成功按 24,000 Token 结算,一旦调用回退模型、失败或预留超时则保守保留 48,000 Token。 Provider 报告的 usage 仅供页面观察,不参与本地额度结算。快照不含目标、Prompt、仓库 URL、路径或正文。SQLite Durable Object 提供原子持久化,真实货币预算由自建上游网关 负责。Preview 与 Production 真实调用已经验收。
Preview 为真实 Provider 验收把三层每日 Token 与成本占位预算扩大到 Production 的 100 倍,但每日请求数、分钟限流、并发、单请求预留与熔断保持生产值。Production 的预算倍率 仍固定为 1,Preview 配置不会随自动部署进入正式环境。
P1-009 质量层 在计划通过 v1 合同后,使用六项固定规则 检查标题产物、范围边界、验收深度、可验证性、Prompt 可执行性和预算集中度。80 分以下的 任务,以及同时独占超过 70% Token 与工时的任务,明确标为需人工修改,不会被隐藏或自动 丢弃。
排序只在依赖已经满足的任务之间按质量分进行,同分保留原顺序。每项任务都显示规则编号、 得分解释和排序原因;页面与三种导出共用同一份依赖安全顺序。仓库摘要只决定证据提示, 不参与打分,也不会触发新的网络或模型调用。
P1-010 本地编辑器 允许用户在模板或 AI 结果上 编辑任务字段、锁定、删除、相邻移动、调整预算、显式按质量排序或恢复生成基线。任务 ID 和依赖保持只读;锁定任务不能修改、删除或移动,存在锁定任务时自动排序不可用。
每次应用都会重新通过 Input / Plan v1、依赖先行、预算、质量与三种导出。PII 继续脱敏, Secret 失败关闭;编辑状态只存在于当前标签页,不写存储、不发网络,也不产生新的 AI 调用或 Token 成本。
P1-005 导出核心 只接收通过 v1 合同的结构化计划,生成 固定安全文件名的完整 Markdown 和逐任务 GitHub Issue 草稿。邮箱、IP、域名、序列号、 WWN 和文件路径会脱敏;Secret、未知字段、无效计划和超大产物失败关闭。
计划里的用户可见 Agent Prompt 会导出,AI Gateway 的隐藏服务端指令、Provider 元数据、 仓库 URL 和仓库上下文不属于导出输入。Issue 草稿只供复制和下载,不会调用 GitHub API 或 自动写入仓库。
P1-011 执行包 把最终计划一一映射为依赖安全阶段, 为每个阶段给出允许/禁止上下文、Prompt、非目标、验收协议、交接模板和失败恢复。它要求 接收工具从实际工作区发现并记录仓库原生命令,不猜测文件路径、命令或外部系统。
执行包使用独立 v1 Schema 和固定 token-forge-agent-package.md 文件名,可复制或下载给
任意接受普通 Markdown 的 Coding Agent。生成完全本地,不绑定模型,不自动修改仓库,
不增加 AI 调用或 Token 成本。
P1-006/P1-007 页面 把模板输入、受限公开仓库证据和三种 导出接成浏览器内工作台。首页卡片链接到正式路由,结果区回到相关文章和 GitHub 源码。
P1-012 首次体验 增加 6K/24K/40K 三档一键模板样例、 三步引导、空/错/降级恢复和四段结果导航。24K 样例只读当前公开仓库,失败仍保留模板; 其他两档完全本地。所有样例无需登录和 AI。
P1-013 基准与可靠性矩阵 使用 31 个完整计划场景、 15 个技术画像、8 份跨栈合成仓库快照和 35 个失败注入,持续验证 Schema、DAG、预算、 质量、降级、五类隐私 sink 与三种导出。机器报告由基准测试重新计算并防止过期。
真实 Chromium 关键路径覆盖 6K 本地生成与下载、GitHub 限流、AI 限流和 320px 键盘/
reduced-motion;浏览器测试已进入根目录统一 npm run validate,不访问真实仓库或模型。
最小事件只允许打开、运行、导出、文章和 GitHub 点击的固定枚举,以及 Lab ID、版本和粗 粒度设备类别。P4-003 已接入同源最小接收器,Worker 只保存 31 天的按日聚合计数,不保存 原始事件、单次时间戳、访客/会话 ID、来源、User-Agent、网络标识或任何正文。统计失败 不影响 Lab 主流程。
P4-005 博客 CTA 使用 v1 合同生成文章中段和文末两种 Markdown 片段。链接固定指向正式 Lab、源码和离线模板说明,不带查询参数、用户输入或 脚本;片段本身不调用 AI、网络、Analytics 或存储。外部博客文章的实际插入保留为独立 内容提交,博客导航入口属于 P4-006。
P4-007 SEO 与发现合同 为 Labs 首页和 Token Forge 输出 同源 canonical、Open Graph、Twitter、JSON-LD 和独立 1200×630 分享图,并由 Astro 构建生成 sitemap。404、API 和尚未上线的 Proposed 路由不会进入 sitemap;元数据不读取 表单、来源参数、运行结果或 Analytics。
只读取公开仓库;不得要求 GitHub 私有 Token。导出不包含原始文件正文或隐藏系统 Prompt。Analytics 不记录仓库 URL 和表单内容。
模板核心不读取仓库;P1-007 页面可选调用 P1-003 适配器读取有界公开样本,并立即投影为 固定技术标签、计数和安全未知项。P1-004 只把进一步压缩和脱敏后的最小上下文交给注入的 Adapter;P1-005 只接收验证后的计划并在本地生成脱敏文本。各阶段都不记录日志、不持久化 输入。Analytics 不得接收仓库 URL、文件路径、正文或覆盖计数。
无需仓库、无需 AI 的样例可以完成一次任务生成;AI 失败时保留模板结果;验证后的计划可以 生成完整计划、Issue 草稿和 Coding Agent 执行包。Alpha 页面已接入模板、公开仓库证据、 受控 AI 路径、质量评分、本地编辑与三种导出;真实 Preview 和 Production 调用已经验收。
MVP 验收只代表基础内核成立,不代表当前战略完成。是否达到“特别完善”必须以优先路线图的 完整闭环、计划质量、隐私成本、产品体验和至少 14 天上线证据五类门槛共同判断。