其实是第二个 AI 项目。但前一个项目因没有经验搞得太乱现在被卡在一半不想继续。新的项目从需求分析开始每一次功能更新/完成都会复盘一下。本次想法是给自己开发一个多功能工具箱GitHub仓库。1 前言在日常使用 AI、浏览网页和处理学习、文字创作的过程中经常会遇到一些零散的小需求。有些需求只在特定情境下偶尔出现有些则会重复发生。虽然尝试寻找现有工具但经常遇到以下问题工具分散需要每次重新搜索强制注册或登录完整功能需要付费产品功能过重超出实际需要操作方式不符合个人习惯部分工具需要上传文件令我对内容隐私有所顾虑。随着 AI 辅助开发工具变得更加容易使用我开始思考与其每次花时间寻找并适应别人的工具不如逐步建立一个自己的工具集合。每个工具只解决一个明确问题保持独立、轻量并尽量在本地完成处理。2 产品用户工具箱现阶段首先服务于我本人的真实需求因此功能优先级、交互方式和技术选择都会以个人使用体验为核心。当某些工具逐渐稳定并且我确认它们也具有更普遍的使用价值后会考虑公开部分工具让其他用户体验并根据反馈继续调整。项目因此采取以下发展顺序个人需求驱动 → 自用验证 → 完善核心体验 → 选择性开放 → 根据反馈继续迭代3 需求分析3.1 核心需求通过统一入口集中管理不同的小工具每个工具只处理一种明确任务工具之间保持相对独立优先支持不登录即可使用在不依赖服务端的情况下尽可能在浏览器前端完成处理新增工具时不需要大规模修改现有工具页面结构和视觉语言保持基本统一保证个人可以长期阅读和维护代码。3.2 非功能需求轻量性不引入当前不需要的框架和依赖隐私性适合前端处理的内容尽量不发送至后端可维护性统一技术栈和目录规范可扩展性新增工具时沿用明确结构可测试性核心算法和页面行为能够自动验证易用性尽量减少技术术语和额外学习成本响应式桌面和窄屏设备均能基本使用。3.3 第一阶段范围工具箱首页工具统一注册明确路由通用工具页布局404 页面至少一个完整可用的工具基础测试和构建流程。3.4 当前不做第一阶段暂不包括用户账户云端同步后端数据库跨设备历史记录在线协作AI API插件系统第三方开发者接入复杂权限管理。3.5 验收标准工具箱第一阶段达到以下条件即认为基础架构可用首页能够展示已注册工具每个工具具有独立路由不存在的网址能够进入 404 页面新工具可以按固定目录结构加入公共布局不依赖任何具体工具第一个工具能够完成完整的输入、处理和结果展示流程type-check、lint、test和build能够通过不需要用户登录或连接后端不引入当前阶段不必要的框架。4 技术展选择本项目采用以下前端技术Vue 3TypeScriptViteVue RouterComposition APIscript setup langts同时使用VitestESLintPrettiernpmGit / GitHub在此前的 AI 辅助技术选型中React 经常被作为默认方案推荐。但这次我没有直接采用默认建议而是根据项目规模、工具组织方式和个人维护成本选择了 Vue 3。工具箱当前规模较小每个工具之间相对独立。Vue 的单文件组件、模板语法和渐进式组织方式适合快速开发一个个独立的小型工具页面。对我当前的学习基础和项目规模而言其代码结构更容易阅读和维护。5 AI 协作方式本项目采用 ChatGPT 5.6 与 Codex 分工协作的开发方式ChatGPT用于讨论需求、梳理产品逻辑、分析技术方案并编写分阶段 PromptCodex负责读取实际仓库、修改代码、补充测试并执行验证我负责确认真实需求、提供测试文本、检查页面体验以及决定是否接受每一轮实现。为了减少 Codex 在长期开发过程中出现技术风格漂移在项目根目录加入了AGENTS.md用于记录持续生效的仓库规则包括使用 Vue 3 和 TypeScript仅使用 Composition API组件采用script setup langts禁止混入 Vue 2 或 Options API不得未经要求增加框架和依赖不进行无关的大规模重构。AGENTS.md提供仓库级长期约束。此外每次开始新的 Codex 对话时都会提供一段稳定上下文用于再次强调当前任务必须遵守的技术边界这是一个 Vue 3 TypeScript Vite 项目。仅使用 Composition API 和script setup langts禁止 Vue 2、Options API 和未经要求添加框架或依赖。
其实是第二个 AI 项目。但前一个项目因没有经验搞得太乱现在被卡在一半不想继续。新的项目从需求分析开始每一次功能更新/完成都会复盘一下。本次想法是给自己开发一个多功能工具箱GitHub仓库。1 前言在日常使用 AI、浏览网页和处理学习、文字创作的过程中经常会遇到一些零散的小需求。有些需求只在特定情境下偶尔出现有些则会重复发生。虽然尝试寻找现有工具但经常遇到以下问题工具分散需要每次重新搜索强制注册或登录完整功能需要付费产品功能过重超出实际需要操作方式不符合个人习惯部分工具需要上传文件令我对内容隐私有所顾虑。随着 AI 辅助开发工具变得更加容易使用我开始思考与其每次花时间寻找并适应别人的工具不如逐步建立一个自己的工具集合。每个工具只解决一个明确问题保持独立、轻量并尽量在本地完成处理。2 产品用户工具箱现阶段首先服务于我本人的真实需求因此功能优先级、交互方式和技术选择都会以个人使用体验为核心。当某些工具逐渐稳定并且我确认它们也具有更普遍的使用价值后会考虑公开部分工具让其他用户体验并根据反馈继续调整。项目因此采取以下发展顺序个人需求驱动 → 自用验证 → 完善核心体验 → 选择性开放 → 根据反馈继续迭代3 需求分析3.1 核心需求通过统一入口集中管理不同的小工具每个工具只处理一种明确任务工具之间保持相对独立优先支持不登录即可使用在不依赖服务端的情况下尽可能在浏览器前端完成处理新增工具时不需要大规模修改现有工具页面结构和视觉语言保持基本统一保证个人可以长期阅读和维护代码。3.2 非功能需求轻量性不引入当前不需要的框架和依赖隐私性适合前端处理的内容尽量不发送至后端可维护性统一技术栈和目录规范可扩展性新增工具时沿用明确结构可测试性核心算法和页面行为能够自动验证易用性尽量减少技术术语和额外学习成本响应式桌面和窄屏设备均能基本使用。3.3 第一阶段范围工具箱首页工具统一注册明确路由通用工具页布局404 页面至少一个完整可用的工具基础测试和构建流程。3.4 当前不做第一阶段暂不包括用户账户云端同步后端数据库跨设备历史记录在线协作AI API插件系统第三方开发者接入复杂权限管理。3.5 验收标准工具箱第一阶段达到以下条件即认为基础架构可用首页能够展示已注册工具每个工具具有独立路由不存在的网址能够进入 404 页面新工具可以按固定目录结构加入公共布局不依赖任何具体工具第一个工具能够完成完整的输入、处理和结果展示流程type-check、lint、test和build能够通过不需要用户登录或连接后端不引入当前阶段不必要的框架。4 技术展选择本项目采用以下前端技术Vue 3TypeScriptViteVue RouterComposition APIscript setup langts同时使用VitestESLintPrettiernpmGit / GitHub在此前的 AI 辅助技术选型中React 经常被作为默认方案推荐。但这次我没有直接采用默认建议而是根据项目规模、工具组织方式和个人维护成本选择了 Vue 3。工具箱当前规模较小每个工具之间相对独立。Vue 的单文件组件、模板语法和渐进式组织方式适合快速开发一个个独立的小型工具页面。对我当前的学习基础和项目规模而言其代码结构更容易阅读和维护。5 AI 协作方式本项目采用 ChatGPT 5.6 与 Codex 分工协作的开发方式ChatGPT用于讨论需求、梳理产品逻辑、分析技术方案并编写分阶段 PromptCodex负责读取实际仓库、修改代码、补充测试并执行验证我负责确认真实需求、提供测试文本、检查页面体验以及决定是否接受每一轮实现。为了减少 Codex 在长期开发过程中出现技术风格漂移在项目根目录加入了AGENTS.md用于记录持续生效的仓库规则包括使用 Vue 3 和 TypeScript仅使用 Composition API组件采用script setup langts禁止混入 Vue 2 或 Options API不得未经要求增加框架和依赖不进行无关的大规模重构。AGENTS.md提供仓库级长期约束。此外每次开始新的 Codex 对话时都会提供一段稳定上下文用于再次强调当前任务必须遵守的技术边界这是一个 Vue 3 TypeScript Vite 项目。仅使用 Composition API 和script setup langts禁止 Vue 2、Options API 和未经要求添加框架或依赖。
