从原型到产品功能逻辑数据结构状态流转错误处理技术约束交付标准功能实现描述要“操作”状态❌用户可以管理笔记✅用户可对自己创建的笔记执行新建、编辑、归档、删除操作删除后先进入回收站7 天内可恢复超过 7 天永久删除已归档笔记默认不出现在首页列表但可通过筛选查看产品开发提示词推荐 | 根据 AI 优化的内容人工重新编写核心考察是否写清楚了产品目标与用户是谁是否列出了页面清单和页面关系是否描述了每个页面的布局结构是否写清楚了关键组件与其状态是否写清楚了关键交互流程是否补充了空状态、加载状态、错误状态是否定义了核心数据对象和字段(可选)是否写清楚了关键业务规则是否给出了技术栈和交付要求(可选)提示词里是否仍有“简洁点”“高级点”“优化一下”这类模糊表达让 AI 辅助修改参见 https://www.kimi.com/share/19dc3348-49d2-8d38-8000-0000f11b2fc6终稿提示词你是一位精通 Electron React/Vue 技术栈的资深桌面端开发工程师。请根据以下产品需求开发一款名为「碎片成稿」的桌面客户端应用。需求已经过澄清请严格按描述实现不要自行删减功能。 ## 1. 产品概述 - 产品名称碎片成稿 - 产品类型AI 驱动的灵感捕获与内容创作助手桌面客户端应用 - 目标用户内容创作者、自媒体写手、产品经理、研究者、知识工作者等需要持续输出内容的人群 - 核心价值主张降低从灵感到成文的 friction让碎片信息自动发酵为可发布的内容 - 产品形态仅桌面端Windows / macOS主应用窗口为可调整大小的自由窗口最小尺寸 800×600支持自适应布局 ## 2. 页面清单与信息架构 应用包含以下页面/模块层级与导航关系如下 | 页面/模块 | 层级 | 承担任务 | 入口 | 出口 | |---|---|---|---|---| | 快捷输入浮窗 | L0全局覆盖层 | 最小化输入入口支持文字/链接/图片快速投递 | 全局快捷键默认 Cmd/Ctrl Shift I用户可配置 | 提交后自动关闭或跳转至主应用或失焦自动隐藏 | | 主应用 - 碎片库 | L1核心页面 | 展示所有已萃取的信息碎片支持筛选、搜索、批量操作 | Dock/任务栏图标点击快捷浮窗进入应用 | 进入写作台、设置页 | | 主应用 - 写作台 | L1核心页面 | 基于勾选碎片进行选题分析或文章撰写 | 碎片库开始写作按钮每日提醒通知点击 | 返回碎片库 | | 主应用 - 选题看板 | L1核心页面 | 展示 AI 推荐的今日/本周可写选题及关联碎片 | 每日推送通知碎片库顶部 Tab 切换 | 进入写作台忽略选题 | | 碎片详情页/抽屉 | L2详情层 | 查看单条碎片的原始输入、萃取结果、AI 标签、关联选题 | 碎片库点击单条卡片 | 返回碎片库 | | 设置页 | L2配置层 | 配置快捷键、大模型 API、提醒时间、分类偏好、导出格式 | 主应用菜单设置 | 返回应用保存设置 | | 每日提醒通知 | L0系统通知层 | 推送今日选题建议引导用户进入应用 | 系统定时推送 | 点击跳转选题看板或写作台关闭通知| 导航方式 - 快捷浮窗 → 独立浮层无导航栏提交即走 - 主应用内 → 左侧边栏 Tab 切换碎片库 / 选题看板 / 写作台 右侧内容区 - 详情/设置 → 右侧抽屉或独立页面覆盖 ## 3. 各页面布局结构 ### 3.1 快捷输入浮窗 - 尺寸固定 480×320 像素 - 头部产品 Logo 产品名碎片成稿 关闭按钮× - 内容区 - 多行文本输入框placeholder 为随便写点什么... - 自动识别粘贴内容若粘贴 URL下方展开链接预览卡片显示标题域名favicon若粘贴图片显示图片缩略图支持点击预览显示文件大小提示 - 操作区 - 标签快捷选择如 #待读 #想法用户可点击添加 - 提交按钮 打开主应用 → 跳转入口 - 动效唤起时 scale 0.95→1 opacity 0→1持续 200ms ease-out关闭时反向 ### 3.2 主应用 - 碎片库 - 顶部导航栏Logo 碎片库 / 选题看板 / 写作台 Tab 切换 搜索框 设置按钮 - 筛选标签栏全部 / 文章 / 想法 / 待读 / 图片 时间排序下拉 - 左侧边栏分类树技术 / 产品 / 生活 / ...支持用户自定义分类 - 内容区卡片列表每张卡片展示 - 原始输入摘要链接显示 URL图片显示缩略图 - 萃取内容摘要 - AI 自动标签 - 日期如 04-25 - 左侧勾选框点击后卡片边框高亮 - 底部批量操作栏当选中 ≥1 条时浮现显示已选 N 条 AI 选题分析 / AI 直接成文 / 删除 按钮 - 图片在碎片库中以缩略图形式呈现鼠标悬浮可放大预览 ### 3.3 主应用 - 选题看板 - 顶部导航与碎片库一致选题看板为激活状态 - 内容区分两区块 - 今日推荐基于最近碎片分析生成的选题卡片列表每张卡片显示 - 选题标题如《AI 工具如何改变个人知识管理》 - 关联碎片数量及标题预览 - 操作按钮查看碎片 / 开始写作 / 暂时忽略 - 历史选题 / 已忽略折叠或次级列表展示 - 选题忽略交互卡片向左滑出 80% 透明度降低释放后滑出出现撤销按钮3 秒内可撤销 ### 3.4 主应用 - 写作台 - 两栏布局 - 左侧素材栏显示已勾选碎片列表横幅占比1/4 - 每个素材提供两个可选项“仅萃取内容”或“完整内容” - 根据用户勾选项为写作大模型提供上下文 - 中间主区域横幅占比3/4 - 上方输入框为写作要求追加到已有 AI 写作提示词 - 操作选项预设风格下拉菜单干货教程|资讯解读|工具分享 撰写按钮 - 显示/编辑器区域可编辑文本框支持 Markdown 格式渲染 - 底部操作栏重新生成 / 导出 Markdown / 复制全文 - AI 生成文字时显示流式打字机效果逐字输出光标闪烁可随时停止生成 ### 3.5 碎片详情页/抽屉 - 从右侧滑出的抽屉面板宽度约 600px 或占主窗口 50% - 展示内容 - 原始输入区完整文字 / 链接原文 / 图片原图 - 萃取结果区结构化摘要、标签、分类 - AI 标签与分类可编辑 - 关联选题列表 - 操作按钮重新萃取 / 编辑 / 删除 ### 3.6 设置页抽屉或独立页面 - 从右侧滑出或独立页面覆盖 - 配置项分组 - 大模型配置API Key 输入框、模型名输入框、Base URL 自定义 - 图片理解模型配置同大模型配置勾选“图片理解”时可填写 - 快捷键自定义唤起浮窗快捷键输入框检测系统冲突并提示该快捷键已被系统占用请更换 - 提醒时间每日推送时间选择器、免打扰时段设置 ## 4. 关键交互流程 ### 4.1 灵感捕获流程 1. 用户按下全局快捷键 → 屏幕中央弹出快捷输入浮窗scale 0.95→1 opacity 0→1200ms ease-out 2. 用户输入文字、粘贴链接或图片 3. 自动识别粘贴内容URL 展开链接预览卡片标题域名favicon图片显示缩略图文件大小 4. 用户点击提交 - 按钮变为加载态Spinner浮窗关闭 - 右上角 toast 提示已保存正在萃取... - 碎片状态设为 pending保存至本地 SQLite 5. 后台异步处理 - 文本调用大模型 API 萃取输出固定 JSON 格式 {summary, tags, category, key_points} - 链接提取提取网页全文若遇反爬/JS 渲染失败/超时 10 秒则标记 failed但在前端仍显示原始链接并附带明显的 ⚠️ icon 提示全文提取受限 - 图片若用户配置了支持图像理解的大模型先调用图像理解模型理解图片内容再将描述一并送入大模型萃取未配置图像理解大模型则仅保存图片不提取图片信息作为萃取对象 6. 萃取完成后 - 碎片状态更新为 extracted - 系统通知气泡1 条新碎片已萃取完成点击可查看详情 - 萃取结束后用户可编辑信息标签、分类、摘要也可选择重新萃取 - 触发实时归类基于大模型分析非纯关键词对新碎片进行聚类更新选题看板 ### 4.2 碎片库浏览与批量操作 1. 用户点击 Dock/任务栏图标进入主应用默认展示碎片库 2. 加载状态骨架屏 → 卡片 stagger 渐显每项延迟 50ms 3. 空状态展示引导插画 文案还没有灵感碎片按 ⌘⇧I 开始记录 快捷唤起按钮 4. 用户点击卡片左侧勾选框 → 卡片边框高亮底部浮现批量操作栏 5. 用户点击AI 选题分析或AI 直接成文 → 进入写作台左侧加载已勾选碎片右侧显示流式生成内容 6. 批量操作限制最多一次勾选 10 条碎片生成文章时按时间顺序排列素材 ### 4.3 选题发现与处理 1. 系统实时分析每当新碎片萃取完成基于大模型聚类分析碎片关联性 2. 聚类结果中碎片数 ≥3 且置信度 0.7 时生成选题建议状态为 suggested 3. 每日 19:00 系统推送通知若当日无新碎片则不推送点击跳转选题看板 4. 用户在选题看板可 - 点击查看碎片 → 侧栏展示关联碎片 - 点击开始写作 → 携带关联碎片进入写作台 - 点击暂时忽略 → 卡片向左滑出3 秒内显示撤销按钮 - 点击今日不再提醒 → 当日停止推送 ### 4.4 写作与导出流程 1. 用户进入写作台左侧素材栏显示已勾选碎片列表 2. 对每条碎片用户可选择内容粒度 - 勾选仅萃取内容 → 仅将该碎片的 AI 摘要/关键信息作为上下文传入写作大模型 - 勾选完整内容 → 将该碎片的原始全文作为上下文传入写作大模型 3. 用户在主区域上方输入框中填写写作要求该内容将追加至已有 AI 写作提示词末尾 4. 用户从预设风格下拉菜单中选择目标风格 - 干货教程对应结构清晰、步骤化表达适合操作指引类内容的写作提示词 - 资讯解读对应客观陈述 分析视角适合行业动态类内容的写作提示词 - 工具分享对应场景化描述 使用体验适合产品推荐类内容的写作提示词 5. 点击撰写按钮系统将左侧所选碎片内容按用户粒度选择、写作要求、预设风格提示词合并后发送至写作大模型 6. 编辑器区域以流式打字机效果逐字输出生成内容用户可随时点击停止生成中断输出 7. 生成完成后用户可在可编辑文本框中直接修改内容编辑器支持 Markdown 格式实时渲染 8. 如需重新生成点击重新生成按钮保持当前参数配置重新发起请求可在重新生成前修改写作要求或切换风格 9. 点击导出 Markdown → 弹出保存对话框将当前编辑器内容生成 .md 文件并保存至用户指定路径 10. 点击复制全文 → 将编辑器中完整 Markdown 内容写入系统剪贴板 ## 5. 空状态、加载状态、错误状态 ### 5.1 空状态 - 碎片库为空展示插画 文案还没有灵感碎片按 ⌘⇧I 开始记录 立即记录按钮 - 选题看板为空文案暂无推荐选题多记录一些灵感AI 会帮你发现写作方向 快捷跳转碎片库按钮 - 写作台无素材文案请从碎片库勾选素材或直接进入自由写作模式 - 搜索结果为空文案未找到匹配碎片尝试更换关键词 ### 5.2 加载状态 - 碎片库加载骨架屏灰色占位块→ 卡片 stagger 渐显每项延迟 50ms - 快捷浮窗提交提交按钮变为 Spinner禁用再次点击 - AI 萃取中碎片卡片显示 pending 状态顶部进度条或脉冲动画 - AI 生成中写作台编辑器显示流式输出底部显示AI 正在思考... 停止按钮 - 链接预览加载显示小型 Skeleton加载失败时显示无法获取预览 ### 5.3 错误状态 - 链接提取失败 / API 超时碎片卡片显示红色角标hover 显示失败原因如链接抓取超时或API 请求失败提供重试萃取按钮 - OCR 未配置时遇到图片图片正常保存并显示缩略图但萃取内容仅显示图片已保存配置 OCR 后可提取文字信息附带设置入口 - 大模型 API 未配置用户首次提交时 toast 提示请先配置大模型 API否则仅保存原始输入点击跳转设置页 - 快捷键冲突设置页中检测冲突输入框边框变红下方文案提示该快捷键已被系统占用请更换 - 存储/读写错误toast 提示本地存储异常请检查磁盘权限或剩余空间 ## 6. 关键业务规则 ### 6.1 数据存储规则 - 数据完全本地存储使用 SQLite 或 LevelDB不设存储上限 - 图片素材存储在本地文件系统建议路径应用数据目录 /fragments/images/数据库中仅保存文件路径 - 无云端同步机制单设备使用 ### 6.2 萃取规则 - 大模型输出必须为固定 JSON 格式{summary: string, tags: string[], category: string, key_points: string[]} - 链接处理提取网页全文超时 30 秒则标记 failed前端显示原始链接 ⚠️ icon 提示全文提取受限 - 图片处理先图片理解若配置再萃取未配置图片理解则跳过文字提取仅保存图片 - 未配置大模型 API 时仅保存原始输入萃取功能不可用toast 引导用户配置 ### 6.3 归类与选题规则 - 聚类基于大模型分析非纯关键词匹配实时执行新碎片萃取完成后立即触发归类 - 生成选题条件聚类结果中碎片数 ≥3 且置信度 0.7 - 分类体系支持用户自定义AI 归类时参考用户预设分类 ### 6.4 提醒规则 - 每日 19:00 推送选题通知若当日无新碎片则不推送 - 用户可设置免打扰时段支持今日不再提醒 ### 6.5 写作规则 - 最多一次勾选 10 条碎片进入写作台 - 生成文章时按碎片时间顺序排列素材 - 仅支持导出 Markdown 格式 ### 6.6 权限与约束 - 图片单张大小限制 10MB超出时提示图片过大请压缩后重新上传 - 全局快捷键需检测系统冲突冲突时阻止保存并提示用户更换 ## 7. 技术约束与交付要求 - 技术栈Electron跨平台桌面端 React SQLite本地存储 大模型 API - 响应式主应用窗口最小 800×600支持自适应快捷浮窗固定 480×320 - 文件结构按功能模块划分 /src/main主进程、/src/renderer渲染层、/src/workers后台萃取任务 - 组件复用碎片卡片、选题卡片、AI 生成加载态、Toast 通知等抽离为通用组件 - 真实接口接入大模型 APIOpenAI / Claude / DeepSeek / Ollama 等 网页抓取服务 ## 8. 其他要求 1. 大模型相关 API 使用 OpenAI SDK 规范 2. 图像理解大模型请求示例如下import asyncio import os from volcenginesdkarkruntime import AsyncArk client AsyncArk( base_urlhttps://ark.cn-beijing.volces.com/api/v3, api_keyos.getenv(ARK_API_KEY) ) async def main(): local_path /Users/doc/ark_demo_img_1.png response await client.responses.create( modeldoubao-seed-2-0-lite-260215, input[ {role: user, content: [ { type: input_image, image_url: ffile://{local_path} }, { type: input_text, text: Which model series supports image input? } ]}, ] ) print(response) if __name__ __main__: asyncio.run(main())3. 将所有大模型相关功能设计的提示词统一管理以方便我集中修改优化。 4. 整体 UI 视觉参考路径下spacex中的设计规范 请按以上需求完整实现「碎片成稿」桌面应用确保所有页面、交互、状态、业务规则均被覆盖。如遇到需求冲突或技术不可行点请列出具体问题并给出替代方案不要擅自删减功能。