wishforge c75f429716 🐛 Read the line breaks a model escapes inside its tool call
An answer travels in a submit_answer tool call, and the model writes its
line breaks there as the two characters \n. The console draws exactly what
it is given, so a customer read \n\n where a paragraph break belonged.

The layout escapes are now unfolded once, where model text enters: the
answer, the Wish draft, the quick replies and the excerpts all pass one
door. Answers stored before this change are unfolded as they are drawn, so
the history reads correctly without touching the database.
2026-11-09 20:12:01 -08:00

WishForge

远程、意图驱动的软件交付平台:用一句话提出愿望(目标 + 验收标准),后端编码 Agent 在隔离环境中实现,独立验证器按受保护的命令判定,失败时把失败信息交还 Agent 自修复,通过后合入代码并按需构建、审批与部署。可以从 Web 工作台、WorkBuddy/Codex(MCP)或云 IDE 发起与跟进。

核心架构与模型哲学

WishForge 不做脆弱的提示词包装,而专注于大模型落地于严肃工程时的物理世界边界与确定性保障。系统设计贯穿六大核心思想:

  1. 理解模型的能力边界,比知道哪个模型排名第一更重要
    模型能力必须按任务切片来看:前端、后端、问答、知识整理;再往下,还有规划、执行、调试、验收。同一个模型在不同环节的可靠性可能完全不同。真正会用 AI 的系统,应该知道在流水线的哪一步停止相信一个模型,以及下一步由谁接盘。
  2. Superagent 最大的竞争对手,是下一代基础模型
    复杂的任务拆解、反思循环、多角色协作,如果主要是在弥补当前模型的认知不足,就存在被模型升级直接吸收的风险。不要把模型暂时的缺陷当成系统的永久护城河,避免构建脆弱的虚假抽象。
  3. 会做规划,不代表会执行;会执行,不代表会验收
    规划需要抓住关键约束,执行需要持续准确地完成细节,验收需要发现错误、寻找反例。为什么习惯让同一个模型包办全部工作?“方案写得好”与“能把事情做好”之间隔着深渊,全流程同质化是失控的根源。
  4. 多一个验收 Agent,不等于多一份独立判断
    如果执行者和验收者共享同样的盲点,多角色协作可能只是重复确认错误。三个 Agent 一致同意,有时只是同一个错误获得了三票。验收必须依靠隔离沙箱中的编译检查、真实测试、构建产物与外部运行证据,绝不能停留在另一个模型口头说“没问题”。
  5. Agent 架构的进步,应该包括删掉多少东西
    每次升级模型,都值得重新检查:任务拆解还需要这么细吗?反思循环还有收益吗?这些中间角色能不能去掉?优秀的 Agent 架构,应该允许模型变强之后,系统反而变简单。把“删除某个模块后,效果是否下降”作为架构演化的评估标准。
  6. 模型会吞噬哪些工程,哪些工程还有独立价值?
    工程分为两类:一类补偿模型的认知不足,容易随基础模型升级而被直接吞噬;另一类处理现实世界的物理约束——例如租户权限隔离、数据接入、分布式事务一致性、不可篡改审计、物理回滚与业务验收探针。后者的需求永远不会仅因模型更聪明就自动解决,是系统的核心资产。

快速开始

需要 Node.js 22+、npm、Git 与 Docker Compose。

npm ci
npm run setup:local
docker compose -f infra/compose.yaml up -d
npm run db:migrate
npm run db:seed
npm run dev:all

打开 http://localhost:3000,创建项目、配置验证命令、连接 Codex 凭据后即可提交第一个愿望。完整步骤见 docs/development.md。

本地开发使用 host 执行模式:Agent 生成的代码与项目测试直接在本机运行,没有隔离。只在可信的项目上使用。

仓库结构

目录 内容
apps/api 控制面 API(REST /v1、内部接口 /internal、MCP /mcp、模型代理)
apps/web Web 工作台(Next.js,含 OIDC BFF)
apps/worker Temporal worker:coordinator / executor / verifier / deployer
apps/provisioner 执行环境与 IDE 工作区的创建(local 与 kubernetes 后端)
apps/git-service 平台 Git 服务
apps/runner 目标环境侧的部署 Runner
apps/ide Theia 云 IDE、IDE 网关与协作
packages/contracts 领域类型、输入校验、规范化 JSON
packages/agent Agent 配置与提示词组装
packages/runtime 执行器适配、Git、验证、构建与部署适配
packages/github、packages/artifacts GitHub App 客户端、对象存储
connectors Codex 与 WorkBuddy 的 MCP 接入配置
infra 本地 Compose、Keycloak、Kubernetes 基线与镜像构建

检查

npm run format:check
npm run typecheck
npm test

需要外部服务的集成测试默认跳过,开启方式见 docs/development.md。

Description
No description provided
Readme 5.7 MiB
Languages
TypeScript 83.5%
JavaScript 13.5%
CSS 2.6%
Dockerfile 0.3%
PLpgSQL 0.1%