Toolplane Docs
开发文档、帮助系统和预留接口入口
这里不是一页静态说明,而是当前项目的文档导航中心。所有已实现、 已在代码中、以及计划中的系统入口都应该先在这里留位置,再进入实际开发。
WSL2 主路径
Live构建、预览、部署、D1 迁移与 typegen 现在默认走 Ubuntu / WSL2,Windows 原生仅保留应急回退入口。
Staging 绑定
Live固定当前 staging 的环境变量基线、D1 / R2 / Worker 绑定,以及 local 与 staging 的真实差异。
Staging Smoke
Live固定默认 staging smoke 命令、页面与接口检查清单,以及浏览器补充回归的入口顺序。
Staging Release
Live固定默认 staging 发布顺序、bootstrap / redeploy 分流,以及当前回滚与重新部署规则。
Release Drill
Live记录完整 staging 发布演练、浏览器补充 smoke,以及当前公开可验证的发布证据。
Staging Ops
Live收口日常 staging 发布、bootstrap、redeploy、drill 与回滚后的操作 runbook。
帮助中心
Live面向开发与测试阶段的入口、步骤、模块说明与后续计划。
开发文档中心
Live技术文档、规划文档、帮助说明和预留接口统一查看。
五模块路线图
Live把前端、API、数据库、Cloudflare 部署和组织/权限/计费/市场扩展拆成 5 个 5-10 天模块,锁定后续推进顺序。
模块一验收
Live记录模块一当前已经完成的自动化验收、staging 证据与真实浏览器人工确认结果,避免继续推进时再回到聊天记录里找状态。
模块三验收
Live记录模块三当前已经完成的 D1 默认主路径、query proof、数据库验收快照与明确待补点,作为正式切入模块四前的收口记录。
模块五验收
Live记录模块五框架层当前已经完成的共享 foundation、模块入口注册、staging 证据与下一轮真实实现优先级,避免继续推进时再回到聊天记录里找状态。
Browser Executor
Live把 pickup、failure / retry、selector 诊断、截图证据与真实 Playwright runner 的商业化推进顺序固定成同一份执行计划。
API 合同
Live当前控制平面 endpoint inventory、request/response 类型、统一 envelope 与 workflow / registry 的 store adapter 边界都已经收口到这里。
测试方案
Live集中查看本机测试步骤、通过标准,以及 staging 二级域名的线上测试建议。
组织与权限
In Codeaccount、project、member、role、permission 的说明页和 Team / Projects 关联入口已经进入代码。
计费与点数
In Code订阅、credits、accepted execution、usage 与后续分成结算的关系说明页已经进入代码,并由 Billing / Usage 工作台共同承接。
供给模型
In Code开发者身份、endpoint、service offering 与 Developers 工作台框架已经进入代码。
插件市场
In CodeMarketplace 工作台框架与 listing / review / install 的文档入口已经进入代码。
开发者后台
In CodeDevelopers 工作台入口已进入代码,用来承接 onboarding、endpoint 与 offering 的长期管理壳子。
收益结算
In CodeSettlement 工作台与 settlement ledger / revenue share / payout policy / hold profile 的说明入口已经进入代码。
Module Entry Map
平台扩展模块入口
Day 9 keeps the future developer supply, marketplace, and settlement routes visible from the docs surface as well, so the information architecture is already stable before the first real moderation, install, or payout mutations ship.
Developers
把 developer identity、endpoint、offering、onboarding 这些二级入口提前固定下来,避免后面接审核或 mutation 时再返工导航。
Identity Review
In Code为个人、企业、域名所有者三类 developer identity 预留独立 verification / operator note 入口。
Endpoint Catalog
In Code为 first-party、remote API、self-hosted、domain-mapped endpoint 预留独立目录入口。
Service Offerings
In Code为 service offering、pricing model、install eligibility 与 commercial scope 预留独立目录入口。
Onboarding Queue
In Code为 supplier onboarding、identity readiness、endpoint readiness、payout readiness 预留统一队列入口。
Listings
In Code为 listing catalog、category mapping、pricing summary 与 provider attribution 预留独立目录入口。
Review Queue
In Code为 listing review、supplier exception、activation block 与 moderation 决策预留独立队列入口。
Version History
In Code为 version channel、compatibility summary 与 active release 切换预留独立版本入口。
Install Contracts
In Code为 project-bound install、activation state 与 buyer-side contract 预留独立安装入口。
Settlement
把 settlement ledger、revenue share、release policy、payout batch 这些二级入口先做成独立占位面,避免后面接真实 payout 时再改信息架构。
Settlement Ledger
In Code为 usage-derived settlement ledger、stage progression 与 operator audit 预留独立台账入口。
Revenue Share
In Code为 share profile、gross/net split、launch partner exception 与后续 override 预留独立入口。
Release Policy
In Code为 payout policy、threshold、hold profile、verification gate 与 operator hold 预留独立策略入口。
Payout Batches
In Code为未来 payout batch、callback proof、provider retry 与 release timeline 预留独立批次入口。
帮助与使用
面向当前开发测试阶段,强调怎么进入、怎么测试、怎么理解现在这版产品。
技术文档
面向开发、架构与数据建模,记录真实已实现和下一阶段边界。
WSL2 开发与部署主路径
Live说明为什么 Toolplane 把 Ubuntu / WSL2 设为默认运行链路,以及现在已经固定的 `dev / build / preview / deploy` 命令入口、staging 域名和 Windows fallback 规则。
Staging Migration / Seed 顺序与回滚说明
Live固定 Toolplane 当前默认的 staging 发布顺序、空库 bootstrap 规则,以及代码回退时的 redeploy 路径。
Staging 发布演练记录
Live记录 Toolplane 当前完整 staging 发布演练、浏览器补充 smoke,以及公开可验证的发布证据。
Staging 部署操作文档
Live把日常 staging 发布、bootstrap、redeploy、drill 与回滚后的再验证收口成操作 runbook。
Staging Smoke 路径与接口检查清单
Live固定 Toolplane 当前默认的 staging smoke 命令、接口检查面,以及何时追加浏览器回归。
Staging 环境变量与 Cloudflare 绑定
Live固定 Toolplane 当前 staging 的环境变量基线、D1 / 双 R2 / Worker 绑定,以及 local 与 staging 的真实差异。
五模块推进路线图
Live把后续主线锁定为 5 个 5-10 天模块,每个模块都有目标、交付物、验收标准和进入下一模块的条件。
模块一验收
Live记录模块一已完成的 API、staging、浏览器 smoke 与真实浏览器人工验收证据,作为正式切入模块二的收口记录。
模块三验收
Live记录模块三当前已经完成的 D1 默认主路径、query proof、账本边界与数据库验收快照,作为正式切入模块四的收口记录。
模块五验收
Live记录模块五框架层当前已经完成的共享 foundation、模块入口注册、staging drill 证据与下一轮真实实现优先级,作为正式进入真实组织权限实现期前的收口记录。
开发计划
Live把当前工作锁定在五模块路线图之下,并同步模块五框架层验收、Day 10 收口结果,以及下一轮真实实现优先级。
Autofill MVP
LiveAutofill 是第一条收费主线,但它属于工作流节点,而不是独立产品。
架构包
Live架构边界、Cloudflare 资源划分和控制平面 / 执行平面的责任划分。
数据基础
Live围绕当前 migration 的真实 D1 对象模型,锁定 workflow / registry / ledger / reserved supply 的边界与查询规则。
API 合同
Live当前控制平面 API 已统一到 ok / meta / data / error 返回包装,并把 run lifecycle、failure evidence、endpoint inventory、target detail 与 store adapter 边界一起收口进代码。
Browser Executor 商业化计划
Live把 Toolplane 后续 browser executor 的 pickup、失败、重试、selector 诊断、R2 failure evidence 与真实 runner handoff 固定成可执行的商业化路线图。
Run Terminal Backwrite
Live说明当前模块一新增的 queued-run 终态回写路径:如何把 accepted preview 写成 queued run,再由 control plane 模拟完成并落账。
帮助系统框架
Live说明为什么要把帮助中心、文档中心和预留接口链接一起纳入项目框架。
项目边界与工作台
In Code固定 account、project、membership 的对象层级、查询规则与 Projects 工作台的当前实现边界。
预留接口
现在就把后续重要系统的链接和文档位留出来,避免框架以后再返工。
组织与权限
In Code围绕 account、project、member、role、permission 的权限梯子、Team 工作台与后续执行前校验边界。
计费与点数账本
In Code围绕 subscriptions、credits、accepted execution 扣费、Billing 工作台与后续 settlement / payout 的控制面边界。
开发者供给模型
In Code围绕个人、企业、域名所有者、自托管与域名映射服务的供给侧模型,以及 Developers 工作台的当前实现边界。
插件市场
In Code围绕 MCP / 插件 listing、分类、审核、安装与 Marketplace 工作台的市场边界说明。
开发者后台
In Code围绕开发者身份、endpoint、service offering、审核与后续数据分析的后台框架入口。
结算与提现
In Code围绕 settlement ledger、自动结算阈值、提现账户、打款批次与 Settlement 工作台的文档接口。
当前文档原则
写在项目里
文档必须直接进入仓库与路由,不能只停在聊天记录里。
区分状态
必须明确区分 live、in-code 和 planned,不能把路线图说成已上线。
先留入口
所有关键系统先留链接位,再进入实际开发,避免导航体系后补。