Open CoDesign 版本演进与核心架构解读：从 v0.1.0 一次生成到 v0.2.0 本地设计智能体（附 Changelog 全览）

人工智能AI 应用桌面应用【免费下载链接】open-codesignOpen-source Claude Design alternative. One-click import your Claude Code / Codex API key. Prompt → prototype / slides / PDF. Multi-model (Claude, GPT, Gemini, Kimi, GLM, Ollama). BYOK, local-first, MIT.项目地址https://gitcode.com/gh_mirrors/op/open-codesign点击查看免费下载本文以 Open CoDesign 仓库根目录 CHANGELOG.md 为骨架结合packages/core、packages/providers、packages/shared与apps/desktop等源码系统梳理该项目从 v0.1.0 首次公开发布到 v0.2.0「Agentic Design」的完整版本演进。读完本文你将掌握项目每一版本的交付能力与修复要点、v0.2.0 的 workspace 化会话架构与工具链调用关系、多 Provider / BYOK / 密钥存储的实现原理以及各版本对应的安装命令与打包分发现状。一、项目定位与版本总览Open CoDesign 是一款 MIT 协议开源的 Claude Design 替代品把一段 Prompt 变成可交互的原型、幻灯片或 PDF 资产全程在本机运行支持 Claude、GPT、Gemini、DeepSeek、Kimi、GLM、Ollama 以及任意 OpenAI 兼容端点BYOKBring Your Own Key并且可以一键导入 Claude Code / Codex 的既有 API 配置。README 明确其定位是local-first、BYOK、多模型、Electron 桌面应用。Changelog 记录的发布节奏如下版本日期定位v0.1.02026-04-18首次公开发布Electron 桌面应用 多平台安装包v0.1.12026-04-21维护版本修复 JSX 预览、引入上下文裁剪、提示词质量v0.1.22026-04-21首个补丁版本打包管道端到端打通v0.1.32026-04-21快速跟进补丁Provider 可靠性 发布管道打磨v0.1.42026-04-23AI 图像生成、ChatGPT 订阅登录、三方中继可靠性v0.2.02026-05-09Agentic Designworkspace 会话、权限化工具、持久化设计系统版本号遵循 Semantic Versioning 等各子包独立的变更记录与根目录主 Changelog 互补。二、v0.1.0首次公开发布与功能全景v0.1.0 是项目的第一个公开版本交付了完整可用的桌面端 MVP。安装包为 macOSDMG、WindowsEXE、LinuxAppImage安装器在 v0.1 阶段未签名官方计划在 v0.5 落地代码签名与可选自动更新。2.1 统一 Provider 模型与动态模型选择器统一 Provider 模型Anthropic、OpenAI、Gemini、DeepSeek、OpenRouter、SiliconFlow、本地 Ollama 以及任意 OpenAI 兼容中继在 Settings 中切换无硬编码白名单。动态模型选择器每个 Provider 在连接时拉取真实模型目录/models而非写死模型列表。Keyless Provider支持 IP 白名单代理企业网关、本地 Ollama以空 API Key 运行。在源码层面packages/providers/src/index.ts明确写道应用代码必须经由本包调用绝不直接 import Provider SDK见 packages/providers/src/index.ts。GenerateOptions中wire字段允许为 DeepSeek、Ollama、LiteLLM、Azure 等自定义端点构造合成 PiModel使其即使不在 pi-ai 的注册表中也能路由到正确的适配器allowKeyless则为 OpenAI 兼容的无 Key 网关提供本地占位 Keypackages/providers/src/index.ts#L33-L59。2.2 Claude Code / Codex 配置一键导入Changelog 描述一键导入读取~/.codex/config.toml与~/.claude/settings.json拉入其中的全部 Provider、模型与密钥。仓库中对应实现位于 apps/desktop/src/main/imports/claude-code-config.ts 与 apps/desktop/src/main/imports/codex-config.ts且各自配有同目录下的*.test.ts测试如 claude-code-config.test.ts保证解析行为可回归验证。2.3 Prompt → HTML / JSX 的本地渲染Prompt 产出 HTML 或 JSX/React 组件在沙箱 iframe 中渲染内置 React 18 Babel完全在本机完成无云端代理。v0.1.1 修复了损坏的 React UMD 厂商包导致 JSX 预览不可用的问题详见下文说明该渲染链路是运行时正确性的关键路径。2.4 设计技能模块与演示 Prompts十二个内置设计技能模块幻灯片、仪表盘、落地页、SVG 图表、玻璃拟态、编辑排版、Hero、定价、页脚、聊天 UI、数据表格、日历Agent 按 brief 自动挑选匹配技能。对应实现位于 packages/core/src/design-skills/index.ts。十五个开箱即用的演示 Prompts宇宙动画、有机加载器、落地页、案例研究、仪表盘、演示幻灯片、邮件、移动端 App、定价页、博客文章、活动日历、聊天界面、作品集画廊、收据/发票、设置面板全部本地化为英文与简体中文。演示输入数据在 packages/templates/src/demo-inputs.ts。Anti-AI-slop 设计技能每次生成都会注入一个反 AI 味设计技能相关提示词内容见 packages/core/src/prompts/sections/anti-slop-digest.md。2.5 交互式编辑回路评论、滑杆与实时面板内联评论 → AI 补丁回路点击预览中任意元素留言模型只重写该区域基于稳定的data-codesign-id做str_replace。该机制在 packages/shared/src/source-edits.ts 有类型与工具定义渲染端实现见 packages/runtime/src/source-edit-instrumentation.ts。AI 生成可调滑杆模型输出值得微调的参数颜色、间距、字体拖动即可精修而无需重新提词。滑杆持久化逻辑见 apps/desktop/src/renderer/src/preview/tweak-persistence.ts。实时 Agent 面板模型编辑文件时流式渲染工具调用。瞬时设计切换预览 iframe 池将最近五个设计热存于内存Hub ↔ Workspace 切换零延迟。Phone / Tablet / Desktop 预览框真正的响应式画布切换UI 组件见 apps/desktop/src/renderer/src/components/PhoneFrame.tsx。Files 面板导出前检查多文件产物HTML、CSS、JS见 FilesPanel.tsx。连接诊断面板一键测试任意 Provider 并给出可操作错误。2.6 五种导出格式与本地优先存储五种导出格式HTML内联 CSS、PDF经用户本地 Chrome 的 puppeteer-core、PPTXpptxgenjs、ZIP 资源包、Markdown全部懒加载。导出实现位于 packages/exporters/src/html.ts、pdf.ts、pptx.ts、zip.ts、markdown.ts。本地优先存储SQLitebetter-sqlite3存设计历史与快照TOML 配置经 ElectronsafeStorage加密不使用 electron-store blob路径符合 XDG 规范。零强制遥测、零云账号、零 API 代理。安装体积 ≤ 80 MBmacOS 与 Windows 安装器CI 强制。2.7 技术底座Changelog 的 Technical foundation 一节明确了技术栈pnpm workspace Turborepo Biome TypeScriptstrict: true、verbatimModuleSyntax: trueElectron React 19 Vite 6 Tailwind v4mariozechner/pi-ai作为多 Provider 抽象Vitest 单元测试约 700 个测试、横跨 11 个包Playwright 做 E2E基于 esbuild-wasm import maps 的沙箱 iframe 渲染器从仓库结构看monorepo 由packages/core智能体内核、packages/providersProvider 封装、packages/shared跨端类型与工具、packages/runtimeiframe 运行时、packages/exporters导出、packages/i18n多语言、packages/templates演示模板、packages/uiUI 组件以及apps/desktop桌面壳组成。三、v0.1.1维护版本——运行时正确性、上下文裁剪与打包管道v0.1.1 是 post-v0.1.0 维护版本无破坏性变更聚焦运行时正确性、发布管道打磨与提示词质量。Highlights 与源码佐证JSX 预览解锁替换损坏的 React UMD 厂商包React/JSX 产物可稳定渲染提交 4536297。上下文裁剪Context pruning编排期间按体积裁剪 tool-call 输入与 tool-result 载荷并提供 artifact-wrapper 覆盖提交 b692ec7、b614196长会话不再撑爆 Prompt。核心实现即 packages/core/src/context-prune.tsagent 运行时通过buildTransformContext接入见 packages/core/src/agent.ts#L64。交互深度强制提示词要求每种产物类型都达到 craft-surplus 最低标准真实交互、真实状态而非线框。Codex 导入支持无 Key Provider导入流程正确拉入无 API Key 的 IP 白名单代理提交 1cdf006。发布管道CI 加入 workspace 构建 bundler 冒烟测试4cc21df签名就绪前禁用 electron-builder 自动更新元数据16be6cc补齐全部 i18n 菜单键29a3f97。Homebrew / winget / Scoop 打包清单脚手架d342eae。四、v0.1.2 与 v0.1.3发布管道补丁v0.1.2首个补丁版本发布管道端到端打通——Homebrew Cask、winget、Scoop 打包清单脚手架完成每个 Release 附带SHA256SUMS.txt与 CycloneDX SBOM。仓库内对应打包清单见 packaging/homebrew/Casks/open-codesign.rb、packaging/scoop/bucket/open-codesign.jsonwinget 清单位于 packaging/winget/manifests/o/OpenCoworkAI/OpenCoDesign/含 0.1.2、0.1.3、0.2.0、0.2.2 多版本。v0.1.3Homebrew Cask 与 winget 打包清单改为确定性追踪发布资产README 补充 macOS Sequoia 15 下 Gatekeeper 的未签名安装器手动安装流程。五、v0.1.4AI 图像生成、ChatGPT 订阅登录与中继可靠性v0.1.4 是功能与可靠性并重的一版AI 图像生成、ChatGPT 订阅登录、CLIProxyAPI 一键导入以及大量三方 API 中继兼容性修复无破坏性变更。5.1 AI 图像生成Agent 可在设计过程中内联生成位图资产Hero、产品图、插图、Logo。默认关闭需在 Settings 中显式开启图像模型走 OpenAI 的 gpt-image-2 或任意 OpenRouter 图像模型。对应工具实现为 packages/core/src/tools/generate-image-asset.ts其参数 SchemaTypeBox包含prompt图像描述必填purposehero | product | poster | background | illustration | logo | otherfilenameHint输出文件名提示可选aspectRatio1:1 | 16:9 | 9:16 | 4:3 | 3:4可选alt无障碍替代文本可选返回结果包含path、dataUrl、mimeType、model、provider、revisedPrompt测试见 generate-image-asset.test.ts。图像生成的设置项在 apps/desktop/src/main/image-generation-settings.ts。5.2 ChatGPT Plus / Codex 订阅登录一次点击 OAuth 登录即可使用 Codex 模型无需 API Key。OAuth 实现位于 packages/providers/src/codex/oauth.ts 与 packages/providers/src/codex/oauth-server.tsToken 持久化在 packages/providers/src/codex/token-store.tsv0.1.4 修复了该 Token 存储的 JSON 解析错误包装与原子写入问题。5.3 CLIProxyAPI 一键导入启动时自动检测运行中的 CLIProxyAPI 实例手动配置时提供预设 智能模型自动发现。5.4 中继与 Provider 兼容性修复清单Changelog 详细列出了这一轮的修复均对应 issue 编号可归纳为四类类别修复内容Gemini 兼容经三方中继访问 Gemini 时带models/前缀的 Key 现在可用修复 #175OpenAI-responses 网关不再以 instructions are required 拒绝请求#134协议不匹配无/v1/messages的网关返回明确的协议不匹配错误#158reasoningtrue只发给已知的 OpenAI 推理模型#183SSE 截断三方中继 SSEresponse事件名截断时给出诊断提示#167、#180无/models的自定义 OpenAI 兼容端点仍可测试#179首轮生成对瞬时上游错误重试#125这些修复的底层实现可以追溯到 packages/providers/src/retry.tswithBackoff重试、packages/providers/src/gemini-compat.tsnormalizeGeminiModelId与 packages/providers/src/errors.ts错误分类。5.5 桌面端与诊断修复生成超时保留原始原因而非坍缩为 Request was aborted#169。Settings 活动模型卡片不再在模型不在拉取列表时误显示#136。ChatGPT OAuth 登录可在流程中途取消#172。Add 菜单 tooltip 行为与标签恢复#156。生成失败桥接到diagnose()假设给出针对性的修复建议#130。截图附件现在能正确送达 ChatGPT Codex#157。Codex 导入前 Ollama 被隐藏直到手动添加#170。macOS arm64 与 Intel x64 两个 DMG 都携带正确的原生模块#176。新增项巴西葡萄牙语pt-BRlocale、CLIProxyAPI 预设 自动检测横幅、自定义 Provider 模态框中的逐行模型选择器 自动发现、诊断面板对中继 SSE 截断与缺失 Messages API 网关注入可操作提示。安装命令v0.1.4winget install OpenCoworkAI.OpenCoDesign # Windows brew install --cask opencoworkai/tap/open-codesign # macOS六、v0.2.0Agentic Design 大版本——从一次生成器到本地设计智能体v0.2.0 是 Changelog 的核心版本将 Open CoDesign 从一次性生成器转变为本地设计智能体具备 workspace 支撑的会话、权限化工具使用和持久的 design-system 文件。6.1 Workspace-backed 设计会话每个设计拥有一个真实的 workspace 文件夹生成源码、资源、导出物、AGENTS.md、DESIGN.md都以文件形式存储取代原先封闭的应用状态。这意味着设计可以被文件系统直接查看、版本管理、复用。DESIGN.md作为持久化设计系统文件其格式解析与校验由 packages/shared/src/design-md.ts 实现支持 YAML frontmatter Markdown body顶层允许version、name、description、colors、typography、rounded、spacing、components等键正文段落按 Overview、Colors、Typography、Layout、Elevation Depth、Shapes、Components、Dos and Donts 的既定顺序解析并兼容 Brand Style、Layout Spacing 等别名段落。6.2 Agent 循环与工具骨架v0.2.0 的运行时把生成请求路由到 pi primitives 与 Open CoDesign 设计工具集包括ask、scaffold、skill、preview、gen_image、tweaks、todos、done。核心入口是 packages/core/src/agent.ts其头部注释明确了设计意图Routes agenerate()-shaped request throughmariozechner/pi-agent-corewith the v0.2 design tool setset_title、set_todos、str_replace_based_edit_tool、done、generate_image_asset、skill、scaffold、preview、tweaks、ask并通过onEvent流式推送turn_start/message_update/turn_end生命周期事件驱动渲染端的聊天/预览 UI。同一文件还记录了 pi-agent-core 的关键怪癖Agent不接受顶层model/systemPrompt/tools构造参数需放options.initialStateagent.run()不存在须调用agent.prompt(userMessage)后从agent.state.messages读取最终消息与 usage流式增量事件是message_update下的assistantMessageEvent.type text_delta。各工具的实现与参数 SchemaTypeBox 定义见 packages/core/src/tools/工具作用实现文件ask向用户渲染结构化问卷text-options / svg-options / slider / file / freeform 五类问题结束本轮直到答案回来packages/core/src/tools/ask.tsscaffold把用户可见模板树userData/templates/scaffolds/中的预置起始文件复制进当前 workspace模板目录按只补缺失文件策略升级用户编辑保留packages/core/src/tools/scaffold.tsgenerate_image_asset内联生成位图资产见 5.1packages/core/src/tools/generate-image-asset.tsskill/preview/tweaks/todos/done技能选择、预览、微调参数、任务清单、完成校验packages/core/src/tools/ 对应文件text-editor文本编辑str_replace 语义packages/core/src/tools/text-editor.ts以ask为例其头注释说明仅定义线格式执行在渲染端的AskModal /主进程 IPC 桥以用户答案或cancelled标记解析 Agent 的挂起工具调用对应渲染端组件 AskModal.tsx。scaffold则强调所有文件系统路径来自getScaffoldsRoot()不依赖import.meta.url从而在 electron-vite 将 core 打包成单文件后依然可用测试也可用 tmpdir 注入而不触碰用户真实模板目录。6.3 v0.1 数据迁移向 JSONL 会话与 workspace 文件演进v0.1 数据获得迁移覆盖目标形态是 JSONL 会话 workspace 文件并对冲突与缺失 workspace 状态给出更清晰的提示。迁移实现位于 apps/desktop/src/main/migration/v01-to-v02.ts其策略按 docs/plans/2026-04-23-v0.2-agentic-design-loop-design.md 规划为检测 v0.1 的userData/designs.db对designs表中每一行在defaultWorkspaceRoot/slug/下物化一个 workspace并把design_files行写入该 workspace把chat_messages行经appendUserMessage/appendAssistantMessage翻译成 SessionManager 管理的 JSONL把comments行翻译成带锚点的用户消息条目把源数据库改名为designs.db.v0.1.backup避免下次启动重复提示迁移。该脚本是防御式的任何单个设计的失败都被记录并继续循环用户之后可手动重试。迁移测试见 v01-to-v02.test.ts。6.4 ChatGPT / Codex 订阅路径升级ChatGPT Plus / Codex OAuth 迁移到 pi-ai 的openai-codex-responses线上协议携带更广的模型提示并改进认证处理。6.5 Provider 可靠性加固DeepInfra、DeepSeek、Kimi、MiniMax、OpenRouter、relay 网关、推理回退、超时诊断、可上报的 Provider 错误全部获得兼容性加固。错误分类逻辑集中在 packages/providers/src/errors.tsclassifyError推理级别映射见 packages/providers/src/index.tsReasoningLevel直接映射 pi-ai 的reasoning字段Anthropic 适配器翻译为 extended-thinkingOpenAI/Gemini 翻译为各自的 reasoning knoboff是 Open CoDesign 的配置/UI 覆盖项调用 pi-ai 前会被剔除。6.6 安全与隐私加固SVG 消毒Agent 提供的 SVG 选项经消毒处理对应ask工具的 svg-options 问题类型。密钥加密可用时使用 ElectronsafeStorage不可用时回退明文并记录告警。实现见 apps/desktop/src/main/keychain.ts加密值带safe:前缀safeStorage.encryptString结果 Base64 化回退值带plain:前缀解密兼容 encrypted / plain / legacy 三种格式OS 钥匙串不可用且读取加密 Key 时会抛出KEYCHAIN_UNAVAILABLE并提示在 Settings 重新输入。诊断脱敏诊断输出对加密的密钥行做脱敏见 apps/desktop/src/main/diagnostics/redact.ts。私有网络探测需显式 Opt-in。引用 URL 抓取拒绝私有 / link-local 目标。6.7 设计资源与桌面 UX扩充示例、脚手架、技能、品牌引用、导出保真度、本地资产处理与 manifest 元数据。Settings 重新组织评论模式与 tweak 持久化加固tweak-persistence.tsHub 缩略图缓存重新提交前同步生成状态官网与社区面刷新。6.8 安装方式v0.2.0brew install --cask opencoworkai/tap/open-codesign # macOS scoop bucket add opencoworkai https://github.com/OpenCoworkAI/scoop-bucket scoop install opencoworkai/open-codesign # Windows或从 GitHub Releases 直接下载v0.2.0 tag。Homebrew Cask 与 Scoop 在 v0.2.0 已上线winget manifest 已提交至 microsoft/winget-pkgsPR #372310等待 Microsoft 审核。仓库内 winget 清单目录还包含 0.2.2 版本说明后续发布持续跟进。七、版本对照小结与升级建议v0.1.x 用户v0.2.0 提供自动迁移designs.db → workspace JSONL迁移是防御式逐条执行失败项可手动重试建议升级前留意迁移提示。BYOK 用户任一版本都可在 Settings 中配置多 Providerv0.1.4 起增加图像生成需显式开启与 ChatGPT/Codex 订阅登录。从 Claude Code / Codex 迁移一键导入~/.codex/config.toml与~/.claude/settings.jsonv0.1.1 起支持无 Key 的 IP 白名单代理。安全基线密钥优先走 Electron safeStorage 加密诊断默认脱敏私有网络探测需 Opt-in——这些约束自 v0.2.0 起内置无需用户手工配置。完整的逐版本提交明细与贡献者名单见仓库根目录 CHANGELOG.md架构规划文档见 docs/plans/2026-04-23-v0.2-agentic-design-loop-design.md 与 docs/plans/2026-05-05-agent-run-protocol.md快速上手与替代品对比见 README.md 及 website/quickstart.md。赞分享人工智能AI 应用桌面应用【免费下载链接】open-codesignOpen-source Claude Design alternative. One-click import your Claude Code / Codex API key. Prompt → prototype / slides / PDF. Multi-model (Claude, GPT, Gemini, Kimi, GLM, Ollama). BYOK, local-first, MIT.项目地址https://gitcode.com/gh_mirrors/op/open-codesign点击查看免费下载相关推荐X-AnyLabeling 版本演进全览从 v0.1.0 到 v4.0.6 的 CHANGELOG 深度解读X AnyLabeling 版本演进全览从 v0.1.0 到 v4.0.6 的 CHANGELOG 深度解读 X AnyLabeling 是一个轻量、高效、跨人工智能AI 应用数据标注计算机视觉桌面应用多模态从 CHANGELOG 读懂 mamba版本演进、核心架构与关键能力全景解析从 CHANGELOG 读懂 mamba版本演进、核心架构与关键能力全景解析 本技术指南以 mamba 项目根目录 CHANGELOG.md https://包管理器CLI开发工具Apache DolphinScheduler Conditions 条件节点基于上游任务状态的分支调度实战指南Apache DolphinScheduler Conditions 条件节点基于上游任务状态的分支调度实战指南 导读 Conditions 是 Apache人工智能AI 应用桌面应用上一篇从开源贡献到社区治理a-picture-is-worth-a-1000-words项目贡献者晋升路径下一篇Vuls配置文件版本控制钩子开发Python与Shell示例创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考