📒

Notes

一手笔记 · 持续生长中

这里记录日常工程实践、技术选型、实验过程与踩坑复盘。内容不一定是完整报告，但尽量保留一手判断与可复用细节。

显示第 21-40 条，共 42 条第 2 / 3 页

Workspace feature flags：从多处配置到可管理的生成式契约

结论先行：#5015 把 workspace feature 从“Go YAML、前端默认值、Agent 环境判断分别维护”的分散开关，推进成一条可管理的 capability control plane：TypeSpec catalog 是手写来源，custom emitter 生成 Go runtime 与共…

研究 · 2026年7月22日 ·
voyagerengineeringpull-requestdaily-study

已整理
Kimi K3 × legacy kimi-cli 1.49.0：一次 V3 Landing Page 长任务的日志解剖

分析对象：Joye 个人博客 /v3 Landing Page 与入场动画任务日志快照：2026-07-21 00:55:43 AEST 会话 ID： d63877a0-3343-477a-9ad5-b56a23c84b54 工作目录： /Users/joye/Documents/code/blog 分支： f…

研究 · 2026年7月21日 ·
aiagentkimiharnesscase-study

已整理
Kimi K3 完成 V3 Landing Page 的全过程复盘

主题：从原始 Prompt、任务拆解、第一次设计、用户纠偏，到第二次重构和最终交付

研究 · 2026年7月21日 ·
aiagentkimiharnesscase-study

已整理
feat(code): support CODE pages in presentation mode

✅ **结论先行：**这条业务线把 CODE 从“可在编辑器里改写 HTML 的跨域实时预览”推进到“可在全屏 Present 中直接运行的页面”。关键不是复制一套渲染器，而是把持久化编辑模型、跨域输入协议和 presentation surface 分层：编辑数据继续走细粒度 delta；iframe 输入通过…

研究 · 2026年7月21日 ·
voyagerengineeringpull-requestdaily-study

已整理
feat(export): add PNG export size option, default 1x with paid 2x tier

这条业务线解决的是“用户从编辑器导出可交付图片”时的默认值、清晰度、批量导出和跨页面类型一致性问题。此前 PNG 的 2× 来自 export worker 契约的隐式默认，用户不能选择，产物体积偏大；DESIGN、CODE、多页 ZIP、MP4 和 agent snapshot 也没有统一表达导出尺度的入口

研究 · 2026年7月20日 ·
voyagerengineeringpull-requestdaily-study

已整理
feat(agent): send follow-ups mid-stream (soft interrupt)

💡 结论：#4844 把 Agent 长 turn 的控制面从“只能 Stop 或等完成”推进到“客户端暂存后续意图，服务端在 step 边界安全收束，客户端再按 FIFO 顺序续发”。它复用了前置的终态修复、framework recovery、durable asset replay 和 replay bur…

研究 · 2026年7月19日 ·
voyagerengineeringpull-requestdaily-study

已整理
fix(agent): batch resumed-stream replay bursts in the agents SDK client

这条线解决的是 Agent 聊天在网络断线重连、长时间多步执行、工具任务失败和页面刷新后恢复时的连续性问题：用户看到的文字不能闪烁或重复，健康完成的 turn 不能被误报成错误，失败任务不能被模型无意重试，已生成的页面和资源要按可见进度逐步落地

研究 · 2026年7月17日 ·
voyagerengineeringpull-requestdaily-study

已整理
feat(cover): render covers for DOC pages

feat(cover): render covers for DOC pages （PR #4815）

研究 · 2026年7月16日 ·
voyagerengineeringpull-requestdaily-study

已整理
feat(agent): mode-scoped agent profiles with cross-mode handoff

没有 composer 声明时回落到 Durable Object 里的模式；显式 none 才会清除它。 toStoredMode 会把 design preset 去掉，只保存“design 模式”本身，避免下一轮误绑定到声明轮预建的空白页。这个函数把最容易被散落在请求处理器里的语义压缩成可单测的状态边界

研究 · 2026年7月15日 ·
voyagerengineeringpull-requestdaily-study

已整理
fix(agent): resolve image preview URLs from assetIds at replay time

文件: backend/workers/agent/src/agent.ts:822-840。设计点是 resolver 的生命周期绑定到单个 agent turn，而不是绑定到 transcript 或工具全局状态。它保证 URL 是当轮材料，不是历史事实

研究 · 2026年7月14日 ·
voyagerengineeringpull-requestdaily-study

已整理
feat(code): inline editing, incremental sync, and undo/redo for CODE

**PR：**feat(code): inline editing, incremental sync, and undo/redo for CODE (#4598)

研究 · 2026年7月13日 ·
voyagerengineeringpull-requestdaily-study

已整理
feat: layout import steps from extracted-content flags

**PR：**feat: layout import steps from extracted-content flags (#4651)

研究 · 2026年7月12日 ·
voyagerengineeringpull-requestdaily-study

已整理
fix(agent): commit each deck page before starting the next

**PR：**fix(agent): commit each deck page before starting the next (#4591)

研究 · 2026年7月11日 ·
voyagerengineeringpull-requestdaily-study

已整理
feat(agent): gate advanced image models behind user confirmation

**PR：**feat(agent): gate advanced image models behind user confirmation (#4580)

研究 · 2026年7月10日 ·
voyagerengineeringpull-requestdaily-study

已整理
feat(agent): home composer creation controls + agent-chosen image model

PR： #4389 feat(agent): home composer creation controls + agent-chosen image model

研究 · 2026年7月9日 ·
voyagerengineeringpull-requestdaily-study

已整理
fix(agent): surface terminal image failures as results, never throw

**PR：**fix(agent): surface terminal image failures as results, never throw (#4516)

研究 · 2026年7月8日 ·
voyagerengineeringpull-requestdaily-study

已整理
feat(agent): add Nano Banana Lite image model

PR: feat(agent): add Nano Banana Lite image model (#4309)

研究 · 2026年7月7日 ·
voyagerengineeringpull-requestdaily-study

已整理
feat(storybook): add agent chat message-part stories

**PR：**feat(storybook): add agent chat message-part stories (#4390)

研究 · 2026年7月6日 ·
voyagerengineeringpull-requestdaily-study

已整理
fix(agent): 附件图作为参考图传给图片生成模型

设计点：这里不是简单加一个数组字段。它把“本地附件 / 下载文件 / bash 产物”统一收敛到 workspace asset ID，避免 image_generation 工具同时承担文件读取、上传、引用解析三种职责。cap 对齐 Go 侧 MaxReferenceImages，也把错误边界前移

研究 · 2026年7月5日 ·
voyagerengineeringpull-requestdaily-study

已整理
refactor(task-worker): call gpt-image-2 via the AI Gateway OpenAI route, not fal

**PR：**refactor(task-worker): call gpt-image-2 via the AI Gateway OpenAI route, not fal (#4314)

研究 · 2026年7月4日 ·
voyagerengineeringpull-requestdaily-study

已整理

Notes

Workspace feature flags：从多处配置到可管理的生成式契约

Kimi K3 × legacy kimi-cli 1.49.0：一次 V3 Landing Page 长任务的日志解剖

Kimi K3 完成 V3 Landing Page 的全过程复盘

feat(code): support CODE pages in presentation mode

feat(export): add PNG export size option, default 1x with paid 2x tier

feat(agent): send follow-ups mid-stream (soft interrupt)

fix(agent): batch resumed-stream replay bursts in the agents SDK client

feat(cover): render covers for DOC pages

feat(agent): mode-scoped agent profiles with cross-mode handoff

fix(agent): resolve image preview URLs from assetIds at replay time

feat(code): inline editing, incremental sync, and undo/redo for CODE

feat: layout import steps from extracted-content flags

fix(agent): commit each deck page before starting the next

feat(agent): gate advanced image models behind user confirmation

feat(agent): home composer creation controls + agent-chosen image model

fix(agent): surface terminal image failures as results, never throw

feat(agent): add Nano Banana Lite image model

feat(storybook): add agent chat message-part stories

fix(agent): 附件图作为参考图传给图片生成模型

refactor(task-worker): call gpt-image-2 via the AI Gateway OpenAI route, not fal