功能交付了。
下次要改,
我心里却没底。
验收通过了,任务也关了。几天后新需求来了,我才发现,自己说不清它为什么这样工作。
验收通过了,任务也关了。几天后新需求来了,我才发现,自己说不清它为什么这样工作。
有人问起一个行为。我翻遍对话、文档和代码,想指出当时为什么这样做,却找不到它落在哪里。
一个任务接着一个任务,我确实知道了更多。可这些知识还不成套,遇到新问题,撑不起我的判断。
我们希望,每一次实现,都能帮助你理解自己的软件、
形成自己的判断,继续决定它的下一步。
Agent 的能力已经足够强,证明“做对了”这件事,不该还压在你身上。在 Noea Code 里,你说完意图,由 Agent 来说明它的实现怎样回应这句话:走了哪条路径,做了哪些选择,还有哪些要你判断。你读的是对这句话的回答,不是几十个文件的改动。
了解更多退款
退款
订阅付款后 14 天内可以全额退款,不问原因。
1超过 14 天的年付订阅,按剩余整月的比例退款;月付订阅不退款,用到当期结束。
2整体说明
实现
退款金额只在 refundAmount 一处算出,入口是 POST /refunds。它先看付款距今的天数:不超过 FULL_REFUND_DAYS(14)时,按原付款金额全额退回。refund.ts:12-20
超过 14 天后按订阅周期分支。月付直接返回 0,订阅保留到 currentPeriodEnd;年付用剩余天数除以 30 向下取整,得到“剩余整月”,再乘以年费的十二分之一。refund.ts:22-41
金额全程以分为单位做整数运算,最后一步才换算成元,不会出现小数误差。退款由 gateway.refund 原路退回,成功后写入一条 refund.issued 事件,账单页据此显示退款记录。gateway.ts:88-104
依据
关注
一个月按 30 天计,不按自然月。2 月付款的年付订阅会比按自然月多算几天。是否按自然月,由你决定。
文档没有写退款后席位何时收回。现在的实现是立即收回。
调查于 2026年11月11日 15:04
退款原路退回到付款时使用的支付方式,到账时间取决于支付渠道。
1写代码时的掌控感,来自你清楚每个符号的含义。一句提示词、一份规格发出去,你并不知道其中哪个词起了作用、作用到哪里。Noea Code 要求 Agent 逐个要点说明:“立即生效”对应哪段实现,“剩余天数”又是怎么算的。改掉其中一个词会改变什么,你可以预期。
了解更多套餐与席位
套餐与席位
团队所有者可以随时升级或降级套餐。
1套餐变更立即生效,差额按剩余天数折算,计入下一张账单。
3说明 2 / 4立即生效
← 整体说明
实现
changePlan 在同一个事务里更新 plan 和 seats,不等到当期结束。权限检查每次读取订阅当前的 plan,所以升级后的下一次请求就能用到新功能。plan.ts:30-52
关注
降级同样立即生效:超出新套餐上限的席位马上变为只读,而不是保留到当期结束。
说明 3 / 4剩余天数
← 整体说明
实现
prorate 用当期剩余的毫秒数除以当期总毫秒数,得到 0 到 1 之间的比例,再乘以新旧套餐的差价。升级得到应补金额,降级得到抵扣金额。proration.ts:8-27
关注
按毫秒而不是按整天折算:下午升级比上午升级少付半天的差价。是否取整到天,由你决定。
席位数不能低于团队当前的成员数。
1最让人不放心的,是 Agent 有没有悄悄替你做决定、留下隐患。以前只能逐行审代码去找;在这里,它必须自己列出来:哪些是它做的实现选择,哪些是缺口、风险和建议。所以你不必一开始就把所有细节想清楚。从一个粗略的想法出发,看它列出了什么,再决定哪些要收回来自己定。
了解更多账单导出
账单导出
团队所有者可以按日期范围导出账单,格式为 CSV。
4整体说明
实现
依据
关注
文档没有写一次能导出多长时间。现在最多 12 个月,超过会报错。
日期范围按团队所在时区解释,而不是 UTC。
金额列没有带币种,使用多种货币的团队导出后无法区分。
导出超过 10 秒时改为后台生成,完成后发邮件。
调查于 2026年11月11日 15:04
导出的文件每一行是一张账单,包含账单号、日期、金额和状态。
1只听 Agent 说“已经实现”是不够的。每段说明后面都跟着它的依据:读过的代码、跑过的测试、运行记录和界面截图,点开就能核对。有人问起,你能指到具体的地方。
了解更多续费
续费扣款失败后,保留 7 天宽限期,期间每 2 天重试一次。
2整体说明
实现
宽限期由 openGrace 开启,截止时刻记在 graceEndsAt;已在宽限期内再次失败不顺延。grace.ts:6-15
依据
读了宽限期和每日续费任务的代码;跑了宽限期的测试,6 个全部通过。实现那一轮留下的截图显示,宽限期内团队设置页顶部有一条提示。
✓ 首次失败开启 7 天宽限期 ✓ 宽限期内再次失败不顺延 ✓ 第 7 天结束后降为 Free 6 通过 · 0 失败 · 412 ms
grace.ts
4export const GRACE_DAYS = 7;56export function openGrace(subscription, failedAt) {7 if (subscription.graceEndsAt !== undefined) {8 return { ...subscription, lastChargeAttemptAt: failedAt };9 }10 return {11 ...subscription,12 graceEndsAt: addDays(failedAt, GRACE_DAYS),13 lastChargeAttemptAt: failedAt,14 };15}1617export function inGrace(subscription, now) {18 return subscription.graceEndsAt !== undefined19 && now < subscription.graceEndsAt;20}
意图代表你的视角。拉取团队的改动后,你看到的不是一长串提交记录,而是你的哪些意图受到了影响,侧栏、文档和说明里都会标出来。再次调查,就知道这些改动对你关心的事意味着什么。
了解更多续费
续费
订阅按周期自动续费。到期当天扣款,成功则顺延一个周期。
续费扣款失败后,保留 7 天宽限期,期间每 2 天重试一次。
续费
续费
订阅按周期自动续费。到期当天扣款,成功则顺延一个周期。
1续费扣款失败后,保留 7 天宽限期,期间每 2 天重试一次。
2整体说明
此说明可能已过时
它读取或引用的 1 个文件在其写成后发生了更改:
src/billing/grace.ts
再次调查
实现
宽限期由 openGrace 开启,截止时刻记在 graceEndsAt;每日任务挑出距上次尝试满 2 天的订阅重试。grace.ts:6-15
宽限期结束仍未扣款成功,团队降为 Free,数据保留 90 天。
1已拉取 3 个提交main · 林舟、阿宁
每轮结束时的改动卡片点进去,改动不是按文件罗列,而是按它回应的意图分组:这一处是为了你的哪句话而改。没有对应任何意图的改动单独列在最后,不会混在里面。
了解更多试用延长到 21 天
试用期从 14 天延长到 21 天,到期前的提醒也跟着调整。
耗时 3 分 02 秒 · 23 个工具
已实现,18 个测试全部通过。已经在试用中的团队按注册时间重新计算到期日,不需要手动处理。
已修改 12 个文件+214−374 处意图·2 处未对应
查看变更给 Claude Code 发消息…
自动Opus 5.5 · Default
试用延长到 21 天 · 回合 1
试用 › 试用期
新团队注册后获得 21 天试用,期间可以使用 Team 套餐的全部功能。
试用期长度改为 21 天L2
常量 TRIAL_DAYS 从 14 改为 21,到期日都由它算出。
src/billing/trial.ts+6−2
8 行未修改
第 9–12 行+1−1意图 1
9-export const TRIAL_DAYS = 14;9+export const TRIAL_DAYS = 21;1011export function trialEndsAt(team) {12 return addDays(team.createdAt, TRIAL_DAYS);
试用 › 到期提醒
试用到期前 3 天和到期当天,各给团队所有者发一封提醒邮件。
提醒时间跟随新的到期日L2
runTrialReminders 不再写死第 11 天,改为从到期日往前推 3 天。
src/jobs/trial-reminders.ts+14−9
21 行未修改
第 22–25 行+2−2意图 1
22- const due = addDays(team.createdAt, 11);22+ const due = addDays(trialEndsAt(team), -3);23 if (!sameDay(due, today)) continue;
未对应意图2
package-lock.json+41−18
tests/helpers/clock.ts+12−0
功能交了,换个场景我却改不了,那种不踏实我有过。现在每句要求后面跟着它的实现和代码,我说一个观点,清楚它落在哪一行。有人质疑,我能直接指给他看。

不熟的模块,我以前是拿着需求的文字,对着 AI 改的代码一处处去对。现在要求和实现说明在同一个地方,不再东一块西一块。以后要改,从这份文档改起就行。

跟 Agent 聊了一下午,定了十几件事,一周后你还找得到几件?在这里,定下来的事会被写进意图文档,而且是用你说过的话写的,一眼就认得出是自己的想法。它只写软件现在该是什么样,不记流水账,同一件事只写在一处。你看过、点了接受,才算数。
了解更多退款
退款
订阅付款后 14 天内可以全额退款,不问原因。
1超过 14 天不退款,订阅用到当期结束。
超过 14 天的年付订阅,按剩余整月的比例退款;月付订阅不退款,用到当期结束。
退款原路退回到付款时使用的支付方式。
1年付退款规则
年付用户中途想退,现在要么全退要么不退,太一刀切了。超过 14 天的,按剩余整月退吧。
思考中2.1 秒
耗时 41 秒 · 6 个工具
现在 refundAmount 对超过 14 天的订阅一律返回 0。我把这条规则写成了意图,改写了《退款》里的一句,请审阅。尚未修改代码。
超过 14 天的年付订阅按剩余整月退款
退款.noea.md
待审阅已接受忽略直接实现接受
给 Claude Code 发消息…
自动Opus 5.5 · Default
想把试用期从 14 天改成 21 天,不用先找代码在哪,也不用琢磨怎么向 Agent 描述。找到文档里那句话,把 14 改成 21。改过的地方会标出来,点“实现”,Agent 只针对这一处动手,做完告诉你它改了什么。
了解更多试用
试用
新团队注册后获得 1421 天试用,期间可以使用 Team 套餐的全部功能。
试用到期前 3 天和到期当天,各给团队所有者发一封提醒邮件。
2试用到期未付费,团队降为 Free,数据保留。
1实现 · 试用
实现意图改动:试用(1 处改写)
思考中1.6 秒
耗时 46 秒 · 7 个工具
TRIAL_DAYS 现在是 14,另有一处提醒任务写死了“第 11 天”。我把两处一起改掉,并补上对应的测试。
修改 src/billing/trial.ts
修改 src/jobs/trial-reminders.ts
运行测试
运行测试 · 18 个通过
已修改 4 个文件+38−92 处意图
查看变更补充想法,或安排下一步…
自动Opus 5.5 · Default
这类问题,以前要么翻代码,要么去问当初写它的人。现在用平常的话搜就行:⌘K 同时搜意图、实现说明和当时的讨论。搜到的是软件现在的规定,旁边就是它是怎么实现的。
了解更多续费
续费
订阅按周期自动续费。到期当天扣款,成功则顺延一个周期。
续费扣款失败后,保留 7 天宽限期,期间每 2 天重试一次。
宽限期结束仍未扣款成功,团队降为 Free,数据保留 90 天。
降为 Free
全部意图对话
意图
降为 Free 后数据保留 90 天L2 · 续费 › 宽限期
试用到期未付费降为 FreeL2 · 试用 › 到期
主动降为 Free 时的席位L2 · 套餐与席位 › 降级
查看全部
对话
宽限期结束降为 Free 的邮件11月8日
降为 Free 后怎么恢复数据10月27日
L2 · 续费 › 宽限期
宽限期结束仍未扣款成功,团队降为 Free,数据保留 90 天。
说明 1 / 3
降为 Free 后数据保留 90 天
实现
downgradeToFree 只改套餐,不删数据;清理任务 purgeExpired 在降级满 90 天后才运行。
L2 · 试用 › 到期
试用到期未付费,团队降为 Free,数据保留。
说明 1 / 2
试用到期未付费降为 Free
实现
每日任务 expireTrials 找出到期且没有付款方式的团队,调用同一个 downgradeToFree。
↵ 打开 · ⌘↵ 在另一侧打开 · Tab 切换类别
用 Agent 做完一个任务,留下的往往只是一堆你没读过的代码。在这里,每个任务还会留下一段意图:这个支付流程为什么这样设计,那个算法巧在哪里。语法和实现细节可以交给 Agent,这些判断是你的。攒多了、有重复了,让 Agent 提一个整理方案,你逐处看过,接受才生效。
了解更多整理 · 订阅
耗时 1 分 38 秒 · 12 个工具
整理了“订阅”下的 4 篇文档。降级后的数据保留规则在《续费》《试用》里各写了一遍,我把它合并到《套餐与席位》,另外两处只保留一句指向它的话。
未更改31已合并2已移动1
已改写2已移除0已新增1
字符数2 184 → 2 037删除147
续费.noea.md试用.noea.md套餐与席位.noea.md
整理时留下的建议
给 Claude Code 发消息…
自动Opus 5.5 · Default
续费
续费
续费扣款失败后,保留 7 天宽限期,期间每 2 天重试一次。
2宽限期结束仍未扣款成功,团队降为 Free,数据保留 90 天,90 天内补缴成功可以恢复原套餐和全部数据保留。降级后的数据保留规则见《套餐与席位》。
续费成功后,账单在 1 分钟内出现在账单页。
1一张图回答。每个文件一个方块,按模块排开,颜色越深,被说明引用的行越多。哪里还是空白,哪里的说明已经过时,一眼看到。指向一篇意图,它覆盖的文件就亮起来。
了解更多新建对话
意图覆盖15:05 · b8d56a4
68%41 / 60 文件
被引用的行解释已过时没有意图对应
模块
src/billing
src/jobs
src/notify
src/web
续费
宽限期
续费扣款失败后,保留 7 天宽限期,期间每 2 天重试一次。
续费扣款失败进入宽限期时,给团队所有者发一封邮件,告知扣款失败及宽限期剩余天数。
宽限期结束仍未扣款成功,团队降为 Free。降级后的数据保留规则见《套餐与席位》。
宽限期结束仍未扣款成功,团队降为 Free,数据保留 90 天,90 天内补缴成功可以恢复原套餐和全部数据。
宽限期结束仍未扣款成功,团队降为 Free。降级后的数据保留规则见《套餐与席位》。
续费成功后,账单在 1 分钟内出现在账单页。
BUILT FOR YOUR FREEDOM
自然语言、DSL、建模语言、代码,随意混用。
意图保存在普通 Markdown 中,可以用 Git 管理,也可以在任何编辑器里继续维护。
继续用你习惯的 Coding Agent,Noea 不替代它。
与你熟悉的 Coding Agent 协同工作
FOR THE PEOPLE BEHIND THE SOFTWARE04
无论你负责一段逻辑、一个团队,还是整个产品,
都可以从自己关心的事情开始。
线上出问题了。会议室里所有人都看向你:“这段逻辑为什么是这样的?”
打开这段逻辑对应的意图,实现、依据和还没确定的地方都在一处。你说出口的,是你核实过的。
凌晨两点,线上出了事。唯一看得懂那段代码的人上个月已经离职,留下的线索,是一条四百多轮的聊天记录。
规则和决定留在项目的意图文档里,旁边就是实现说明和代码依据。接手的人从这里读起,不必翻那四百轮。
一位付费用户发来消息:“为什么导出的文件少了一列?”你盯着屏幕,分不清这是 bug、你的设计,还是 Agent 替你做的选择。
从这个问题回到对应的意图和实现,分清哪些是你定的,哪些是 Agent 选的。这一列要不要留,由你决定。