Hanako 箱庭 · 知识库 最后同步 2026-10-11 文章投喂管道沉淀

知识库

LIBRARY · 收藏不是目的,用起来才是
本版头条 · 最近收录

Pixel Planet - Godot Shader

游戏开发 · 待探索 · 10-06 · 网站 · 工具
评注零贴图 shader 在包体敏感的发布渠道优势明显;挂 ColorRect 的 canvas shader 属于最低渲染器也无风险的基础特性。

纯着色器零贴图程序化行星:6 种行星类型 + 行星环/云层/大气光晕,换种子即换星球,附浏览器试玩,适合标题画面、星图与菜单背景。

壹

AI 与 Agent

AGENT11 条
Agent 工具、基础设施与联网能力层
已沉淀10
Skill2
08-14 skill Archify
评注Typed JSON IR + 确定性校验不是幻觉图;六家 CLI 可装,导出图卡与快照评审齐全,讲架构可直接引用。

代码仓库 / 系统描述转可交互系统地图的 Agent Skill:五种视图附源码证据链,单文件 HTML,口述系统也能出图。

08-31 skill web-access
评注CDP 直连 + 按域名缓存经验的设计实用;敏感站点慎用。

agent 联网与浏览器自动化技能:CDP 直连本机 Chrome 复用登录态,多路联网调度,提供点击与文件上传,按域名缓存经验。

平台与引擎8
09-18 平台 Octop
评注ACP 出站可委派 OpenCode / Claude Code / Codex;三个触发源归一为同一管线。平台级而非协议级,AgentTeams 规划中。

腾讯云开源的自托管多用户 / 多 Agent AI 助手平台:单进程控制面、专家库、ACP 双向集成。

08-10 skill Agent Reach
评注「能力层」设计理念已沉淀为观点笔记;doctor 自检实用。

给 AI Agent 补联网渠道的能力层:覆盖网页 / YouTube / B站 / 小红书 / RSS 等 14 个渠道,多后端路由。

09-18 平台 OmniRoute
评注配额感知回退把多订阅与免费源池化,主流 coding CLI 直接指向使用;RTK+Caveman 压缩省 15-95% token;可经 MCP / A2A 暴露,80+ 命令的 CLI 设计为 agent 可自行驾驶。

开源本地 AI 网关:单端点聚合 352 个 provider / 1200+ 模型,配额池化自动回退,token 压缩。

09-21 平台 Orca
评注「一个 prompt → N 个 worktree → N 个 agent」是并行试错的现成形态;6.3k open issues 说明热度高但仍粗糙;L3 编排界面,与 Open Design / VS Code 同路数,agent 间协作协议仍空缺。

ADE:单 prompt 扇出到多个并行 git worktree,各跑一个 coding agent,BYOK 订阅驱动。

09-21 worktrunk
评注个人项目,41 open issues 很健康;Rust 单二进制无运行时依赖,适合 agent 环境;参考实现级的隔离工具,agent-bus 的「一个 agent 一个目录」直接用它落地。

git worktree 管理 CLI:为并行 AI agent 设计,三个核心命令、hooks、配置文件。

平台 Open Design(nexu-io/open-design)
评注RuntimeAgentDef 数据契约 + 通用引擎,接新 CLI 只加一个文件;问卷锁定需求 + 152 套设计系统切换是特色,详见源码解剖。

Claude Design 的开源替代:调度本机 agent 出原型 / 仪表盘 / PPT / 视频,内置 30+ 设计 skills。

仓库https://github.com/nexu-io/open-design
收录2026-08-14(2026-09-16 源码解剖复核)
规模96,400+ stars
协议Apache 2.0
形态不自建 Agent,调本机已装 CLI(27 种,DeepSeek Harness 一等公民),DESIGN.md 作品牌契约
能力31 个设计技能,动手前弹问卷锁定平台与调性
设计系统152 套品牌级设计系统,切换即整套视觉语言更换
产出HTML / PDF / PPTX / MP4
09-22 读本 Qwen Intelligence
评注双层记忆与「API 优先 + GUI 兜底」混合操作是同类移动 Agent 方案的可对照设计;技术报告 Qwen-Planner-Agent。

阿里面向手机厂商的 AI 手机全栈方案:规划、混合操作、生图三个 Agent 配四套开放评测集;Planner 技术报告已开源。

09-23 平台 TREK
评注行程管理器与 AI 规划 Agent 物种不同,非正面竞品;高德分享链接识别、移动端唤起导航可作交互参考。

海外自托管实时协作旅行规划系统:地图、预算、行李清单、日志与 AI/MCP 集成,支持 PWA/SSO;国内有高德本地化 fork。

待探索1
08-11 skill Qwen-MM-Plugins
评注「harness 多模态原生」方向对;Blender/FreeCAD 模块与 3D-Agent 线索呼应。

把多模态能力拆成可插拔模块喂给任意 agent:图文识别 / 长视频 / 视频剪辑 / Blender / CAD / 讲题等七模块。

贰

前端与设计

FRONTEND38 条
动效动画 / 设计 Skill / 设计工具 / 组件库 / 字体速查
待探索6
09-15 skill motion-web
评注动效自动化验收(交互变化率 / 逐帧逆向)是清单里单独一份;CC BY-NC 禁商用,仓库仅一周,待观察。

物理动效创意网页 Skill:以弹簧阻尼与 Verlet 真实物理做动效,附 7 个可运行案例与无头自动化验收工具链。

09-06 skill diagram-design
评注给 agent 补「编辑级图表」审美,架构/流程图直出自包含 HTML+SVG。

编辑级图表生成 Skill:39 种图表类型,产出无依赖的自包含 HTML+SVG,可按网站品牌色统一风格。

09-06 skill holo-card-studio

开源 Codex Skill:一句描述或一张参考图,生成可交互 Three.js 全息闪卡网页,并产出可编辑 .blend 工程。

09-06 skill image-to-css-art
评注算法与模型分离、同输入同输出,skill 工程化好样本;高精度体积爆炸要警惕。

把参考位图离线描摹成纯 HTML + CSS 单文件插画的 Skill:确定性算法管线,产物禁用 img / SVG / JS。

08-31 skill Ian Xiaohei Illustrations
评注shot list + QA checklist 的流程设计比出图更值得抄;风格绑死单一 IP。

中文文章配图工作流:小黑 IP + 白底手绘线稿,读文章 → 提炼锚点 → 列 shot list → 生图 → QA 校验。

08-13 skill gathered-scenes-zine-skill
评注撕纸边+印刷纹理质感独特;非商业许可,商用先谈授权。

照片转纸刊风海报 / 插画的生成技能:或保留现场关系叠撕纸边与印刷纹理,或提取语义隐喻重构。许可为个人非商业,商用需授权。

已沉淀16
09-03 工具 Onlook
评注双向同步「选中即改码」思路值得关注;栈不合暂不入库。

设计界的 Cursor:可视化编辑器,双向同步 React + Tailwind,选中组件对话即改码;绑定 React,暂不入库。

库 Motion(原 Framer Motion)
评注Emil 生态核心,声明式 API 省心;Vanilla 栈项目只借鉴理念。
官网https://motion.dev
许可MIT
定位生产级动画库(React / JavaScript / Vue)
能力声明式 JSX 动画、页面过渡、弹窗与列表进出、手势交互
关联同作者的 emilkowalski/skills 见本卷 emilkowalski/skills 档案
skill ② emilkowalski/skills(Skills for Design Engineers)
评注motion.dev 作者出品;写动效前查一查,与 Motion 档案同源。
作者Emil Kowalski(motion.dev 原作者)
规模33.6k stars,1.9k forks
包含12 个子 skill:animate / review-animations / improve-animations / apple-design / pick-ui-library / prototype 等
关联与 Motion 档案同源
skill ③ GSAP Skills(greensock/gsap-skills)
评注滚动驱动/时间线编排是强项;本体已全免费,模块拆分清晰。
提供方GreenSock,自 Webflow 收购后 100% 免费(含原 Club 插件)
模块8 个:core / timeline / scrolltrigger / plugins(20+)/ utils / react / performance / frameworks
适配40+ agent(Cursor / Claude Code / Codex / Windsurf / Copilot 等)
素材 ④ transitions.dev(Jakubantalik/transitions.dev)
评注含 reduced-motion 守卫,Vanilla 项目也能直接抄。
提供方Jakub Antalik
内容18 种 CSS 过渡(卡片缩放、数字翻牌、通知徽章、文本模糊切换、菜单下拉、弹窗缩放、侧边面板、图标交换、成功勾选等)
形态t-* 命名空间类 + @media prefers-reduced-motion 无障碍守卫,可直接复制
工具Refine — 注入本地 panel,把动画对齐到运动的 token,支持可逆覆盖
skill ① Impeccable(pbakaus/impeccable)
评注本地 CLI 无需 LLM;契约模式是精髓,与 Hallmark 一微观一宏观。
来源小红书文章 2026-08-13
派生Anthropic frontend-design
机制impeccable init 生成 PRODUCT.md + DESIGN.md 作为契约
规则61 条确定性检测(字体 / 配色 / 卡片嵌套 / 缓动)
命令23 个(polish / audit / critique 等)
运行本地 CLI,无需 LLM / API key
适配Cursor / Claude Code / Codex / Gemini CLI 等
许可开源
skill ⑦ Hallmark — 2.56 万星,专治 AI 味
评注study 命令能从任意网页提取设计 DNA;与 Impeccable 一宏观一微观。
来源小黑盒 992Zero 2026-09-01
规模25,600+ stars
协议MIT
一句话反 AI 味设计 Skill:57 道检测门 + 21 套主题,让 AI 网页不像 AI 做的
机制不定模板只定规则:21 套主题 + 21 种宏观结构指纹
命令build(自检出码)/ audit(打分)/ redesign(重搭)/ study(提取 DNA)
关联与 Impeccable 一宏观一微观,可叠加
素材 ⑥ awesome-design-md — 10.8 万星,品牌设计系统字典
评注契约先行,MIT 无负担;生成类 Skill 的前置约束输入。
来源小黑盒 992Zero 2026-09-01
规模108,000+ stars
协议MIT
一句话73 个顶级产品的设计系统,整理成 AI 能直接读懂的 Markdown
维度9 个维度:配色 / 排版 / 组件状态 / 栅格 / 阴影 / 禁忌 / 提示词
覆盖品牌Claude / Figma / Notion / Vercel / Stripe / BMW 等 73 个
配套preview.html + preview-dark.html 双主题预览
用法复制 DESIGN.md 到项目根目录,让 AI 照做
skill ⑧ UI UX Pro Max(nextlevelbuilder/ui-ux-pro-max-skill)
评注清单里唯一的检索选型型:设计决策压成可查数据库,不产码,须配生成类使用。
来源2026-09-15 检索录入
规模127k+ stars
协议MIT
形态本地 CSV 数据库 + BM25 检索脚本,Python 标准库,无依赖不联网
内容79 种 UI 风格(50 活跃)/ 192 套行业配色与推理规则 / 74 组字体搭配 / 119 条 UX 规则 / 25 类图表 / 22 种技术栈
核心--design-system 一次出整套设计系统;--persist 落成 MASTER.md 契约文件复用
适配20+ 助手(Claude Code / Cursor / Codex / Windsurf / Copilot 等),npm 全局装 uipro
边界开源版聚焦 UI/UX;品牌 / Logo / CIP / Banner / 演示文稿归付费 Premium
工具 Penpot
评注MCP Server 让 agent 读稿是方向;待有自托管场景再上。
来源小黑盒 992Zero《GitHub 最火 5 个设计项目》2026-09-01
官网https://penpot.app
许可MPL 2.0
定位开源设计平台,Figma 的自托管替代
能力资产即 SVG / CSS、原生 Design Tokens、Docker / K8s 一键自托管、MCP Server 供 agent 直读稿件
适合被 Figma 按人头收费卡住的小团队、独立开发者、对数据合规有要求的团队
工具 Pencil(pen.dev)
评注画布进 IDE + MCP 直驱是方向;创业公司免费期,先用不押注。
来源自荐收录 2026-09-09
官网https://www.pen.dev
许可专有,目前免费(桌面版 + VS Code / Cursor 集成)
定位Agent 驱动设计平台,设计画布直接住进 IDE
能力无限画布、.pen 纯 JSON、MCP 直驱画布、内置多套 UI kit、prompt 出仪表盘 / 落地页
风险非开源有锁定可能,免费政策持续性未知
库 Magic UI
评注150+ 组件找灵感快;锁 React + Tailwind 栈。
官网https://magicui.design
许可开源(多数免费)
组件数150+
特征滚动动画、渐变、粒子效果、镜头视差
库 Aceternity UI
评注50 个 WebGL 组件最吸睛;性能与栈成本需权衡。
官网https://ui.aceternity.com
许可开源(多数免费)
组件数200+(含 50 个 Three.js / WebGL 组件)
特征3D 卡片、发光光束、粒子背景、磁力按钮
库 Cult UI
评注体量小起步晚,当 Magic UI / Aceternity 的补充。
官网https://www.cult-ui.com
许可开源
组件数持续增长
特征基于 Shadcn UI,组件 + 区块 + 模板
工具 Hugo
评注Go template 学习曲线换构建速度;手写 HTML 的项目无需它,文档站可考虑。
官网https://gohugo.io
许可Apache 2.0
定位静态站点生成器(Go 编写,构建快)
能力Go template 模板语法,适合博客 / 文档站 / 内容型网站
字体速查10
08-15 字体 思源系列
评注本组均为 OFL / MIT 等免费商用开源字体。
中文排版的默认答案;宋体另仓 source-han-serif。

支持简繁日韩,字符集覆盖完整,含宋体/黑体/等宽全家族

08-15 字体 霞鹜文楷
评注字库全;屏幕长文阅读偏软,引文和标题更合适。

楷体风格,支持 2 万+ 汉字,包含黑体/手写体等衍生

08-15 字体 更纱黑体
评注终端与代码文档混排利器;UI 正文不必。

思源黑体与等宽西文合并,中英混排

08-15 字体 得意黑
评注海报大标题出效果;正文别用。

黑体

08-15 字体 朱雀仿宋
评注开源仿宋稀缺品;有明确场景再启用。

仿宋

08-15 字体 FiraCode
评注编辑器老朋友;个人站 code 块字体栈备选。

支持连字特性

08-15 字体 Nerd Fonts
评注配 shell 利器;网页端用途少。

包含 3600+ 图标

08-15 字体 Cascadia Code
评注连字优雅;编辑器备选。

微软出品

08-15 字体 JetBrains Mono
评注长时间阅读舒服;code 块字体栈候选。

JetBrains 官方

08-15 字体 IBM Plex
评注企业气质完整,做英文版式时翻牌。

IBM 全家族,包含衬线/无衬线/等宽

关联备忘6
评注生态索引:追动画能力更新时两个仓库一起看。

Motion 与 emilkowalski/skills 同作者、同生态(档案都在本卷)

评注三家都锁 React 栈;Vanilla 项目只借鉴效果实现,别照搬。

Magic UI / Aceternity UI / Cult UI 均基于 React + Tailwind + Motion 的复制粘贴模式

评注分类备忘:换内容站方案时再翻,日常不必跟进。

Hugo 为静态站点生成器,与设计类 Skills 分属不同类别

评注先 Hallmark 定骨架,再 Impeccable 抠细节,顺序别反。

Impeccable(61 规则)与 Hallmark(57 门)互补:一个验细节,一个验骨架,叠加去 AI 味最佳

评注先选定 DESIGN.md,再交给执行型 Skill,契约先行。

awesome-design-md 是本卷唯一“字典型”非执行型 Skill,适合作为所有生成类 Skill(Open Design / Hallmark / Impeccable)的前置约束输入

评注选型 → 生成 → 验收三段分开,比让模型一路自由发挥稳。

UI UX Pro Max 补上了本卷缺的「选型」一环:它查方向,生成类出码,Hallmark / Impeccable 验收

叁

音乐与音频

MUSIC20 条
AI 与程序化合成音乐、播放器与音频工具
已沉淀18
08-22 工具 Suno
评注v5.5 质量标杆;免费档不能下载,商用要 Pro 档。

支持完整歌曲与人声生成,v5.5 版本;免费档仅支持在线播放,Pro $8-10/月、Premier $30/月 提供商用授权与下载额度

08-22 工具 ElevenLabs Music
评注授权曲库训练无版权隐患,商用场景明确支持。

基于授权曲库训练,与 Merlin / Kobalt 签约,明确支持游戏等商用场景,Music v2 版本

08-22 工具 AIVA
评注风格库大;商用要付费档,按需订阅。

侧重电影/管弦乐配乐,提供 250+ 风格,付费档提供商用授权

08-22 工具 Udio
评注不支持导出,仅当灵感玩具,别押注。

支持站内流媒体播放,2025 年后不支持音频文件导出

08-22 工具 Mubert
评注免版税 + DMCA 豁免省心;质量中规中矩。

按情绪/BPM/活动生成 BGM,免版税,提供 DMCA 豁免

08-22 工具 Soundraw
评注分轨控制精细;$17/月偏贵,按需短期订阅。

自建授权曲库训练,支持风格/情绪/编曲调节与分轨下载,约 $17/月

08-22 工具 Beatoven.ai
评注试错成本最低档;音质预期放低。

提供商用授权的背景音乐生成,约 $2.5/月

08-22 工具 Loudly
评注与 Beatoven 定位重叠,二选一即可。

提供商用授权与协作控制,约 $6/月

08-22 模型 ACE-Step 1.5
评注MIT + ComfyUI 原生 + LoRA,本地自托管首选。

开源可自托管的全歌生成模型:19 种语言,人声克隆 / 混音 / 改词,ComfyUI 原生支持,可 LoRA 微调

08-22 模型 Stable Audio 3
评注年收入 <$100 万免费商用条款对小团队友好;注意是社区许可。

开源权重的器乐 BGM / 音效生成:最长约 6 分钟,可 LoRA 微调,ComfyUI 原生支持;年收入 <$100 万可免费商用

08-22 模型 YuE
评注Apache 2.0 无商用负担;质量与云端有差距。

Apache 2.0,从歌词生成完整歌曲

08-22 模型 Magenta RealTime
评注CC-BY 可商用,实时自适应场景独特;质量偏实验。

Google 实时自适应音乐,权重 CC-BY

08-22 模型 MusicGen
评注禁商用,只做研究对比,别进生产。

Meta 模型,权重 CC-BY-NC(禁止商用)

08-22 工具 海绵音乐
评注零成本出中文歌;商用授权要单独谈。

字节跳动出品,完全免费,版权与平台共同享有,商用需另行授权

08-22 工具 网易天音
评注大厂背书能力中庸,与海绵音乐二选一。

网易云旗下 AI 创作工具

08-22 工具 天工 SkyMusic
评注额度小,当体验入口,不作主力。

提供免费额度

09-13 工具 Folia
评注歌词动画可当视频字幕设计灵感;本机接口适合外部集成取词。

全屏沉浸式歌词播放器,主打文字 PV 级歌词动画与 AI 配色,支持多音源与逐字歌词,本机接口可供外部程序取词;AGPL-3.0 禁商用

09-18 工具 Synesthesia Canvas
评注纯 Web Audio 程序化合成,不吃显存也不联网;仓库无 LICENSE,商用须先取得授权;导出不含循环区间,无缝循环要自行裁切。

浏览器内的图形化作曲工具:画图形实时合成电子音乐,位置、宽窄、大小映射音高、时值、力度,内置 13 音色 13 音阶,可导出 WAV

待探索2
08-22 模型 DiffRhythm 2
评注速度见长;质量待与 YuE 实测对比。

Apache 2.0,支持快速全歌生成

08-22 工具 蘑兔AI
评注信息有限,有中文歌词刚需时再实测。

国产 AI 音乐平台,支持中文创作

肆

游戏开发

GAME DEV8 条
游戏与 3D 制作工具链
待探索5
10-06 素材 Pixel Planet - Godot Shader
评注零贴图 shader 在包体敏感的发布渠道优势明显;挂 ColorRect 的 canvas shader 属于最低渲染器也无风险的基础特性。

纯着色器零贴图程序化行星:6 种行星类型 + 行星环/云层/大气光晕,换种子即换星球,附浏览器试玩,适合标题画面、星图与菜单背景。

10-06 素材 Card Kit Free
评注翻面/光泽/透视的着色器手法可作自行实现自定义卡牌特效的参考。

52 张扑克牌 + 鬼牌 + 牌背素材与配套玩法代码:透视倾斜、3D 翻面、箔面光泽、扫光等卡牌着色器,附扇形手牌、发牌堆与牌型评估器。

09-06 读本 3D-Agent

Blender 多 agent 建模范式的架构分享(Astra 建模能力的开源预演):三模型分工 + 每步回传截图自检。

09-06 模型 Hunyuan3D 混元3D

腾讯开源文 / 图生 3D 模型:出 low-poly 网格 + PBR 材质 + 绑骨骼,ComfyUI 原生可跑;几何不精确需人修。

09-06 mcp Blender 官方 Lab MCP Server

Blender 基金会官方 MCP 路线:轻量 Server + 官方 add-on,本地模型友好;门槛 5.1+,当前用不了。

已沉淀3
09-06 mcp ahujasid/blender-mcp

老牌 Blender MCP 社区插件(兼容 3.0+):可读写场景 / 几何 / 材质,内置低模资产库与混元 3D 直连;当前选它。

09-06 mcp GenesisCore

Blender 内嵌 AI 自动化插件:MCP 直连,可切换 DeepSeek 等供应商。⚠ 4.5 装不上,已一年半未维护。

09-06 mcp BlenderMCP-AI-AGNO-agent
评注「视觉反馈闭环」对任何 agent 工作流通用;3D 栈本身暂不跟进。

17 个专科 agent 组成的「3D 制片厂」,拆分过细、token 开销大、完成度差。判为反面教材:三权分立够用,十七路诸侯是炫技。

伍

开发与效率

EFFICIENCY8 条
学习路线、效率与知识工具
已沉淀8
08-05 学习 first-contributions
评注手把手教程,带人入开源直接甩链接。

面向零基础的开源入门仓库,教程式引导完成首次 PR

08-05 学习 freeCodeCamp
评注good first issue 标注好用;别当系统课啃。

开源学习与协作项目,提供 good first issue 标注

08-05 学习 developer-roadmap
评注查漏补缺的地图,别当 todo 清单硬啃。

前端/后端/DevOps 等方向的知识路线图

08-19 工具 Project Graph(计划-投射)
评注双链+拓扑+JS 扩展,功能密度高;观望 v4 稳定性。

开源无限画布节点图 / 思维导图:树形与拓扑结构、双链 + 孪生关系、LaTeX 公式、XMind 导入与 Mermaid 导出

09-09 工具 Excalidraw
评注与 Project Graph 一结构一随手;画流程图随手可用。

开源手绘风虚拟白板:浏览器即用、无限画布、端到端加密协作、Docker 自托管,可导出 SVG / PNG / JSON

09-08 skill ponytail
评注营销热度远大于真实收益,但确实省代码;规则正文比插件本身值钱,可直接吸收进 agent 约束。

让 coding agent「少写」的纪律型 Skill:7 级懒惰阶梯(先问要不要做,再逐级降级到最小实现),实测省代码约 15%。

09-18 工具 RapidOCR
评注本质是「PaddleOCR 模型 + 更好的部署工程」:优势在轻与离线,精度上限仍由百度模型决定

把 PaddleOCR 模型转 ONNX 的跨语言 OCR 部署库,后端可换、可离线跑,只含检测/识别,版面表格需另配

09-24 skill 说人话 shuorenhua
评注治「此地无银三百两」式防御性文案的正解:越心虚越声明,声明本身暴露心虚;改写时保留作者的犹疑是关键设计,防误杀。

清理中文 AI 味文案的 agent skill:去套话、重复铺垫与防御性赘语(「本次完成了对重试策略的调整。重试策略已经调整过了」→一句),严格保真(数字、条件、承诺、情态、责任主体不许被顺手改掉),按内容判断不按词表替换;支持 structural/bounded/in-place 三档编辑范围与只标问题模式;带 123 条评测集验收。已装入 HanaAgent(full 版:SKILL.md + editing-guide + examples)。同生态:avoid-ai-writing(英文校准,v3.36 活跃)、stop-slop、humanizer(blader)、speak-human-tw(繁中)

陆

观点笔记

NOTES9 条
文章里的关键观点与可引用的洞见
已沉淀9
08-20 游戏科学冯骥《黑神话:钟馗》发布时的工作原则 首先打动自己,再找外部交集
评注拿来定优先级的锚:先服自己再找同类,比市场调研省钱的冷启动法。

首先打动自己,再找外部交集:把开发者自己当最优先目标用户,这不是情怀也是产品策略;对内容产品,先在外部找到与自己个性相近的人,比讨好所有人更高效,从核心向外自然扩散。创作过程的每一处用心,都一定会被懂你的用户感受到。

08-20 游戏科学冯骥工作原则 可体验的版本,胜过满纸雄文
评注评审产出物优先跑 demo;对 AI 生成物同理,眼见为运行实况,不信口头描述。

可体验的版本,胜过满纸雄文:文档解释意图、数据辅助判断、会议统一认识,但游戏是综合、复杂、混沌的沉浸状态;判断产品风险时更相信真正跑起来、打起来、死上几次之后的感受,以及同事作为玩家时的真实反应。对外发布实机视频,目标是让人「看到后能轻易想象自己亲手玩起来的样子」。

08-20 游戏科学冯骥工作原则 行是知的前提
评注对抗「想清楚再动手」的拖延;学新栈尤其受用,改版类工作可小步验证。

行是知的前提:脑中的理念很可能是肤浅、偏颇、错误的,只有贯彻理念的行动与现实真实碰撞,才能看清世界哪里一样哪里不一样;撞得太猛把理念撞成碎片也没关系,一片片捡回来拼成新的模样,再撞一次。

08-20 游戏科学冯骥工作原则 难能,可贵
评注选题与护城河判断的尺子:容易的事挤满人,难而值得才是壁垒。

难能,可贵:充分竞争的成熟市场鲜有低垂的果实,任何容易解决的问题要么没有后来者机会,要么很快被挤满;一直做相对容易的事反而惶惶不可终日,护城河的本质是难以被轻易取代的价值。

08-14 Archify 项目设计理念(github.com/tt-a1i/archify) 给 agent 的产出设门禁,不
评注给 agent 产出设门禁的范本;校验失败返回结构化修复回执,不让模型瞎猜。

给 agent 的产出设门禁,不设门禁的 agent 输出只是幻觉的另一种形式:Archify 用 Typed JSON IR + 确定性校验保证交付质量,校验失败时返回结构化修复回执而不是让 agent 瞎猜,预览只刷新验证通过的版本,失败保留上一张好图。

08-14 Open Design 项目理念(github.com/nexu-io/open-design) 设计系统应该是文件契约而不是人脑审美
评注审美外包给文件不靠人脑;设计 tokens 文件化可循同思路落地。

设计系统应该是文件契约而不是人脑审美:把团队品牌规范写进 DESIGN.md,每个 agent 生成前先读它,设计产出就自动对齐品牌;单页 artifact 用真实 CSS/真实字体/真实组件直接导出 HTML/PDF/PPTX/MP4,替代在 Figma 画布上推像素。

08-05 小黑盒文章《给你三个实在的入口》 资源本身不是能力,把资源用起来才
评注收藏 = 没拥有;收录即写评注、明确使用场景,是「用起来」的第一步。

资源本身不是能力,把资源用起来才是;GitHub 是工具箱,不是博物馆——收藏了不用,等于没拥有。别让「收藏」变成唯一的技术活动。

08-10 《Agent Reach》设计理念(github.com/Panniantong/Agent-Reach) 能力层与工具的区别
评注分层设计的判断标准:换代时调列表顺序而非重写代码。

能力层与工具的区别:比具体实现高一层,负责选型、安装、体检、路由,不做底层读取本身;每个平台维护「首选+备选」有序后端列表,接入方式换代 = 调整列表顺序,而不是重写代码。

08-11 小黑盒文章《DeepSeek 最佳开源“眼睛+助手”?Qwen 开源多模态能力插件》(作者 Druvis,2026-08-11) 模型能力与模型本体正在解耦
评注判断 AI 产品竞争力:看编排与调度质量,而非单点能力堆叠。

模型能力与模型本体正在解耦:未来竞争力最强的 Agent,未必来自某一家厂商从模型到工具的全面自研,而更可能通过组合实现——不同厂商的推理模型、多模态模块和垂直工具,由 Agent 框架统一编排。到那时,讨论“哪个模型能力最多”不再是核心问题,关键是谁的推理最有效、谁的调度最合理。

柒

Open Design 源码解剖

DEEP DIVE31 条
单对象深度档案:源码级精读,随版本更新
3. RuntimeAgentDef 契约精读(`runtimes/types.ts`,~600 行)16
3.1 识别与探测

bin + fallbackBins:主探测目标 + 兼容 fork(claude 的 fallback 是 openclaude,argv 兼容的 drop-in fork 自动被识别)。

versionPolicy:supportedVersions 精确清单 + supportedVersionPattern 正则整条 release line + requireVersion: true fail-closed。深因:agent CLI 以 RC 流水线发版,速度远快于 OD 自己的发版,钉死单个版本号等于每个照官方文档装的用户一周后都收到「未测试版本」警告。

capabilityFlags:调 <bin> --help 后做子串扫描,flag → capability key 映射。注意 claude 的 --add-dir 只在 -p 子命令 help 里出现,所以要 claude -p --help(issue #430)。

hiddenCapabilityFlags:处理 CLI 存在但 help 里隐藏的 flag(如 --thinking-display)。探测法极聪明:用不可能被接受的值去调每个 flag——认识该 flag 的 build 拒绝 value,不认识的 build 拒绝 option,两者都在模型调用前失败,探测零成本。

3.2 调用与 prompt 投递

buildArgs(prompt, imagePaths, extraDirs, options, context) -> argv:唯一的「代码」,也是纯函数。

prompt 投递三通道:promptViaStdin(规避 Linux E2BIG:argv 单条 ~128KB 上限;Windows ENAMETOOLONG:CreateProcess ~32KB,.cmd shim 更是 ~8KB)、promptViaFile(daemon 建临时文件,用后即删)、argv 直传(不推荐,antigravity 被迫用)。

promptInputFormat: 'stream-json':stdin 写入单条 JSONL user 消息且不关闭,daemon 可在 turn 中途继续注入后续 user 消息,避免重复 spawn。

3.3 流回传:8 种 wire format 兜住 27 个 CLI
claude-stream-jsonclaude, amp, codebuddy
json-event-streamcodex, cursor-agent, opencode, mimo, byok-opencode
copilot-stream-jsoncopilot
qoder-stream-jsonqoder
acp-json-rpcamr(Vela), devin, hermes, kimi, kiro, kilo, reasonix, trae-cli, vibe
pi-rpcpi
dsh-profile-jsonldeepseek-harness
plainaider, antigravity, atomcode, deepseek, grok-build, qwen

两个趋势信号:ACP(Agent Client Protocol,JSON-RPC over stdio)一个协议占 9 席,agent 侧接口正在标准化,是新增 runtime 的推荐路径(docs/new-agent-runtime-acp.md 专文);Gemini 本地生成 runtime 已退役(连 96k star 的项目都维护不动某些 CLI,适配是有现实成本的)。

解析器 emit 的统一事件集:thinking / tool-call / tool-result / text-delta / file-write / error / done。事件集归解析器管,不归 def 管。

3.4 会话恢复:三种风格 + 一种放弃

1. specify-style(resumesSessionViaCli + newSessionId):daemon 铸造 UUID,CLI 被告知用它。Claude:--session-id <uuid> 新建、--resume <id> 续聊。daemon 持有的 id 即它生成的 id。

2. capture-style(capturesSessionIdFromStream):CLI 自己生成会话 id 并在流里上报(codex 的 thread.started.thread_id),daemon 从解析流捕获并持久化它作为 resume handle,newSessionId 不传给 CLI。

3. ACP load(resumesSessionViaAcpLoad):通过 ACP session/load + getDurableSessionId(),resume 失败映射到 reseed 路径。

4. plain 无状态:没有上游会话存储的 CLI(qwen、deepseek、antigravity),每轮 spawn 全量重灌 daemon 渲染的 transcript(## user / ## assistant 块),靠对话文本本身延续记忆。这是兼容性的下限兜底。

3.5 能力声明与集成

externalMcpInjection(外部 MCP 服务器注入四策略):claude-mcp-json(写 .mcp.json 进项目 cwd,Claude Code 自动加载)/ acp-merge(并进 ACP launch 描述符的 mcpServers)/ opencode-env-content(序列化进 OPENCODE_CONFIG_CONTENT 环境变量)/ mimo-env-content。没有原生 MCP 通道的 agent(codex、cursor-agent、copilot、qoder、pi)留空,设置 UI 显式提示「请在 agent 自己的配置里设置」,替代 issue #2142 之前的静默失败。

authProbe:声明式认证探测(如 claude auth status、cursor-agent status),副作用免费。没声明的 agent 不主动探测,auth 状态只能从真实聊天失败的错误文本反推。

模型发现三通道:静态 fallbackModels、listModels(跑一条命令解析 stdout)、fetchModels(异步,如 claude 从 mmd/MMS 路由拉取 proxy 兼容模型)。

超时两把尺:inactivityTimeoutMs(不活跃看门狗,Copilot deck 生成的思考期会长时间静默,需要更长)与 firstOutputTimeoutMs(宣布等待模型输出到首个实质事件的硬顶,心跳不续命)。

4. 三个代表性 def 深描8
4.1 claude.ts —— 参考实现

claude -p --input-format stream-json --output-format stream-json --verbose。要点:

能力全部按探测结果 gate(--include-partial-messages 旧版不认识会 exit 1 杀死会话,必须先探测再加)。

--thinking-display summarized:headless 下 extended thinking 文本被扣住(redact-thinking beta 仍然在 API 请求上,每个 thinking_delta 的 thinking 都是空串),显式要 summarized 才能看见推理。

--permission-mode bypassPermissions:daemon 管理的 print 模式没有交互审批通道。

--agents <json>:把 daemon 绑定的 build package 塞进 Claude Code 原生 subagent 系统,prompt 写死「只执行父 agent 给的任务,不许再 spawn subagent」。

--add-dir 传额外目录(旧版本也 gate,对齐对称性)。

4.2 deepseek-harness.ts —— 一等公民 runtime

dsh --profile open-design --stdio,走 dsh-profile-jsonl 专用协议(结构化流、模型发现、取消、会话恢复俱全)。resumesSessionViaProfileStdio: true + capturesSessionIdFromStream: true。模型动态发现:--models 返回目录解析成 provider/id + reasoning options。

版本策略注释堪称运维小论文:dsh 的 RC 相互 peer-require,安装器给出的版本随上游漂移;把 pattern 收窄到 0.1.0-rc.N 两天后上游发了 0.1.1-rc.1,所有用户又见警告。最终方案是 per-patch-line 的正则,且 prerelease 接受范围永远不能超过 packages/dsh-runtime peer 依赖能装的范围(否则警告消失但伴随依赖解析失败,比警告更糟且无声)。e2e 测试把两处绑定,一次上游新 patch line 需要两处同改或同不改。

4.3 antigravity.ts —— 与不合作 CLI 搏斗的编年史

一行流格式 plain,def 文件 11KB,其中大部分是「驯服 agy」的机制代码。五连坑:

1. 无模型 flag(agy v1.0.3,上游 issue #35):TUI 的 Switch-Model 会写 ~/.gemini/antigravity-cli/settings.json,而 agy -p 每次启动读它。解法:daemon 在 spawn 前直接写 settings.json 选模型。8 个模型 label 硬编码(镜像 agy TUI consumer-tier 列表,2026-05-28 时点),supportsCustomModel: false,因为 label 是服务端 enum,认不出的 id 会变成静默缓存 miss + 空输出,对用户表现为「空响应」。

2. 全局文件竞态:settings.json 是进程全局的,并发 run A 写模型 A、B 写模型 B,A 的 agy 可能跑在 B 的模型上。解法:promise 锁链串行化所有非默认模型的 spawn;release 条件是轮询 agy 的 --log-file 直到出现 Propagating selected model override to backend: label="X"(model_config_manager.go 的日志 = settings 已被读走)。注释强调:poll 返回 false 意味着「放弃轮询」,绝不意味着「agy 一定没读」,锁只能在真观察到信号或子进程退出时释放。

3. print mode 静默失败:认证缺失与配额耗尽在 stdout/stderr 全部无输出(PR #3157 实证),唯一区分手段是 --log-file 事后 grep。flag 顺序 load-bearing:--log-file 必须在 -p 之前。

4. stdin 投递被上游改坏:旧版 agy -p - 读 stdin,1.1.13 把 - 当字面 prompt 忽略 stdin(issue #7161),只能把整个 prompt 塞进 argv。

5. -c resume flag 故意不用:实测会激活 agy 内部 agentic loop(多步模型重试、工具调用、工具报错回退缓存响应),OD 的 system prompt OVERRIDE 无法约束,turn 1 的工具重试路径返回缓存的 form 后,turn 2 字节级复现同一 form。解法:当无状态 adapter 用,每轮全量 transcript,且上一轮 assistant 输出要清洗 <question-form> 标记(防弱模型如 Gemini 3.5 Flash 模式匹配重发)。

5. 引擎侧的工程现实3

detection:所有 def 并行探测,启动预热;每个 probe 故障隔离(一个坏的可执行文件不清空整个 picker);无持久化缓存,每次要新鲜数据就重新探。resolved 路径与实际 spawn 路径强制同源(probe 到的是 shim、跑的是另一个二进制 = 假阳性)。

launch 的 PATH 深坑(launch.ts):GUI 启动的 daemon PATH 极简,Pi 这类 #!/usr/bin/env bun 脚本 resolve 成功但 spawn exit 127。解法:Node bin 目录置于 PATH 最前(Windows npm .cmd shim 找裸 node),用户工具链目录(Homebrew、~/.bun/bin、版本管理器)追加末尾。Windows 的 Path vs PATH 用大小写不敏感查找后就地更新,避免重复 key。Codex 特殊:npm wrapper 脚本在 GUI 环境可能起不来,向上遍历目录找 @openai/codex-<platform>-<arch>/vendor/<target-triple>/codex 原生二进制;嗅探 shebang 只读前 64KB(原生 Codex.app 是 ~190MB,不能整读)。

invocation 的中性 cwd(invocation.ts):所有探测类调用(version/help/models/auth)默认 cwd = OS 临时目录而非 daemon 进程 cwd。事故:OpenCode 是 bun 写的,启动时在 cwd 跑 bun install 装本地插件,daemon 若从 pnpm workspace 启动,一次 opencode models 探测会在仓库里丢下 bun.lock + node_modules/.bun,毁掉 pnpm store 打断 dev server。killSignal: 'SIGKILL':execFile 的 timeout 只发信号,promise 要等子进程真正退出才 settle,trap SIGTERM 的 CLI 会让探测永远 pending;只读探测无物可 flush,直接 SIGKILL。

6. 编排工作区契约:被上游编排的官方接口2

Storage:od-owned(OD 自己的项目目录)/ folder-backed(外部文件系统根)。

Provenance:user-local(用户选的本地文件夹,原地编辑)/ orchestrator-scratch(外部编排器准备的一次性工作区,writeback: "external")。

边界刻意窄:OD 读写给定 workspace、产出可检视的设计输出、报告 provenance;源码 checkout、PR 创建、部署、写回策略全部留在 OD 之外。稳定输出边界是 result package:run 身份与终态、workspace 元数据、文件与 artifact manifest、事件日志位置、错误/退出码/信号/取消状态、可选 diff。

这意味着任何上游编排系统(如自建的多 agent 流水线)可以把 OD 当作一个「设计工人」接入:准备 scratch 目录 → 调用 → 收 result package → 自己决定写回与否。被编排的接口是官方一等公民。

10. 更新记录2

2026-08-14 收录(skills线索.md / 网站推荐.md,85k stars)

2026-09-16 源码解剖 + 条目更新(96.4k stars;DeepSeek Harness 一等公民支持;Gemini 本地 runtime 退役;本文)

← 返回箱庭