peterfei (laufei)

IfAI v0.3.0 - Multimodal Intelligence 发布

peterfei — Fri, 16 Jan 2026 09:48:21 +0800

IfAI v0.3.0 - Multimodal Intelligence 发布说明

发布日期: 2026-01-14 版本代号: Multimodal Intelligence 核心主题: 从"文本"到"多模态"的感知升级

🎯 版本概述

v0.3.0 实现了从纯文本交互到多模态感知的重大飞跃。AI 不再只能理解代码，现在可以直接"看到"图片、理解视觉内容，同时具备强大的代码分析和重构能力。

五大核心升级:

文本对话 → 多模态对话: 支持拖拽图片直接对话，AI 可理解视觉内容
单一调度 → 混合调度: 本地 LLM + 远程 API 灵活切换
基础补全 → 智能导航: Go to Definition / Find References 支持 35+ 主流语言
手动重构 → AI 重构: 自动检测代码异味并生成重构方案
新手友好 → 零门槛: 新手引导 Tour 系统，5 分钟上手

✨ 核心功能

1️⃣ 多模态 Vision LLM (Multimodal Understanding)

突破: AI 现在可以直接"看"到图片并理解视觉内容。

功能	描述
图片拖拽上传	直接拖拽图片到聊天区域，自动转为 base64
截图快捷上传	系统截图后直接粘贴 (Cmd+V) 到编辑器
视觉内容理解	AI 分析图片中的 UI、代码、架构图
多图片附件	支持一次对话上传多张图片
自动清理机制	发送后自动清除图片附件，保持界面整洁

技术实现:

Base64 编码处理图片数据
自动检测 Vision API 模型 (Claude 3.5 Sonnet / GPT-4V)
Token 计数自适应图片大小
支持 PNG、JPG、JPEG、GIF、WebP 格式

测试覆盖: MM-UI-01 ~ MM-UI-05 (5 个测试全通过)

2️⃣ 本地/远程混合调度 (Hybrid LLM Scheduling)

突破: 不再依赖单一 API，灵活调度本地和远程模型。

功能	描述
Ollama 本地模型	支持 llama3、qwen2.5 等本地部署模型
远程 API 支持	Anthropic Claude, OpenAI GPT-4
智能路由	根据任务类型自动选择最适合的模型
降级保护	远程 API 失败时自动降级到本地模型
成本优化	简单任务用本地模型，复杂任务用云端

配置示例:

{
  "llm": {
    "provider": "anthropic",
    "model": "claude-3-5-sonnet-20241022",
    "fallback": {
      "provider": "ollama",
      "model": "llama3.1"
    }
  }
}

测试覆盖: MM-UI-01, MM-UI-03 (真实 AI 验证通过)

突破: 支持 35+ 主流语言的符号级导航。

功能	描述
Go to Definition	跳转到函数/变量/类的定义位置
Find References	查找符号在项目中的所有引用
跨语言支持	TypeScript、Rust、Python、Go、Java、C++、Ruby、PHP 等
LSP 集成	基于 Language Server Protocol 标准实现
项目范围索引	自动索引当前工作区所有文件

快捷键:

F12 / Cmd+Click: 跳转到定义
Shift+F12 / Right-click: 查找所有引用

支持的语言 (35+): JavaScript, TypeScript, Python, Rust, Go, Java, C, C++, C#, PHP, Ruby, Swift, Kotlin, Dart, Lua, Scala, Groovy, PowerShell, Shell, YAML, JSON, Markdown, HTML, CSS, Vue, Svelte, etc.

测试覆盖: DEF-01 ~ DEF-05 (5 个测试全通过), REF-01 ~ REF-04 (4 个测试全通过)

4️⃣ AI 代码重构 (AI-Powered Refactoring)

突破: AI 自动检测代码异味并生成重构方案。

功能	描述
代码异味检测	自动识别长函数、重复代码、复杂条件等问题
结构化重构	一键将复杂代码拆分为清晰的函数/类结构
智能建议	AI 分析代码上下文，生成符合最佳实践的重构方案
预览模式	Diff 视图预览重构变更，Accept/Reject 控制
Undo 支持	完整的撤销支持，不满意可随时回退

检测的代码问题:

长函数 (Long Function)
重复代码 (Code Duplication)
复杂条件 (Complex Conditionals)
魔法数字 (Magic Numbers)
不一致的命名 (Inconsistent Naming)

测试覆盖: REF-001, REF-002 (代码分析重构相关测试)

5️⃣ 新手引导 Tour (Interactive Onboarding)

突破: 零门槛上手，5 分钟快速掌握核心功能。

功能	描述
首次启动引导	新用户首次启动自动播放 Tour
分步教程	分步骤介绍聊天、多模态、行内编辑等核心功能
高亮提示	自动高亮相关 UI 元素，配合文字说明
跳过/重播	支持跳过 Tour，通过帮助菜单重新播放
进度记忆	记录用户完成状态，避免重复打扰

引导内容:

欢迎页面介绍
聊天功能演示
多模态图片上传
行内编辑 (Cmd+K)
快捷键说明
帮助与文档入口

测试覆盖: TOUR-E2E-01 ~ TOUR-E2E-04 (4 个测试全通过)

6️⃣ UI 加载反馈 (Loading Feedback)

突破: 实时加载动画，告别"空白等待"焦虑。

功能	描述
聊天加载动画	"IFAI 正在思考..." + 旋转 Spinner
行内编辑加载	"IFAI 正在处理..." + 输入框禁用保护
Pulse 动画	平滑的脉冲动画，视觉反馈清晰
状态管理	Zustand 全局状态统一管理加载状态
自动清理	AI 响应完成后自动清除加载状态

测试覆盖: MM-UI-01 ~ MM-UI-05, IE-LOAD-01 ~ IE-LOAD-04 (9 个测试全通过)

7️⃣ 多工作区支持 (Multi-Workspace Support)

突破: 同时管理多个项目，无缝切换上下文。

功能	描述
多目录索引	同时索引多个工作区目录
智能路径解析	自动处理跨文件引用路径
项目切换	快速切换不同项目的上下文
符号跨项目查找	在多个项目中查找符号定义和引用

8️⃣ Tauri 外链支持 (External Links)

突破: 桌面应用原生打开外部链接。

功能	描述
Shell API 集成	使用 Tauri Shell API 打开系统浏览器
降级保护	API 失败时降级到 window.open()
帮助菜单链接	文档、GitHub、Issues 等外部链接
关于页面链接	Wiki、Repository、Discussions

测试覆盖: ABOUT-01 ~ ABOUT-05 (5 个测试全通过)

🛠 技术改进

多模态处理

Base64 编码优化: 高效的图片编码处理，内存占用优化
Token 计数自适应: 根据图片分辨率自动估算 token 消耗
Vision API 检测: 自动识别支持视觉的 LLM 模型

编辑器增强

符号索引系统: 基于 tree-sitter 的多语言符号解析
LSP 客户端集成: 标准化 Language Server Protocol 支持
跨工作区路径解析: 智能处理多项目符号引用

UI/UX 优化

Zustand 全局状态管理: 统一的加载状态管理
Tauri Shell API: 原生外部链接打开支持
加载反馈动画: Pulse + Spinner 组合动画

测试覆盖

36/36 E2E 测试全部通过
真实 AI 验证: 包含真实 API 调用的端到端测试
多模态测试: 5/5 测试通过
代码分析测试: 9/9 测试通过
帮助页面测试: 5/5 测试通过

📊 性能表现

指标	v0.2.9	v0.3.0	改进
E2E 通过率	100% (23/23)	100% (36/36)	+56% 测试数
符号索引速度	~1s	~0.5s	50% 提升
多模态响应延迟	N/A	~2s	新增功能
图片上传处理	N/A	<100ms	新增功能

🐛 Bug 修复

Issue	描述	修复方式
MM-001	多模态图片 token 计数异常	修正 Base64 编码后的 token 计算公式
MM-002	多模态图片不能识别	添加 Vision API 模型检测逻辑
EDT-001	行内编辑后无加载反馈	添加 isProcessing 状态和动画
LNK-001	Tauri 应用外链点击无反应	使用 Shell API 替代 window.open()

🔄 升级指南

从 v0.2.9 升级

更新依赖:

npm install
cd src-tauri && cargo update

配置文件更新: 如需使用多模态功能，确保配置支持 Vision API 模型（如 Claude 3.5 Sonnet）
重新构建:
```
npm run tauri build
```
首次启动: v0.3.0 首次启动会自动播放新手引导 Tour

📝 已知问题

图片大小限制: 单张图片建议不超过 5MB，过大可能导致 token 溢出
本地模型多模态: Ollama 本地模型暂不支持 Vision，多模态功能需使用远程 API
跨语言符号查找: 部分语言的 LSP 支持有限，符号查找可能不完整

🚀 下版本预告 (v0.3.1)

v0.3.1 将继续优化多模态和代码分析体验：

视频理解支持: 支持短视频帧分析
代码补全增强: 基于多模态的 UI 代码智能补全
符号搜索改进: 模糊匹配和驼峰拆分搜索
更多 LSP 语言: 扩展到 50+ 语言支持

🙏 致谢

感谢所有参与 v0.3.0 测试和反馈的用户，特别是：

多模态功能测试的贡献者
代码分析功能的反馈者
Bug 报告和功能建议的用户
社区的持续支持

下载: https://github.com/peterfei/ifai/releases/tag/v0.3.0

完整文档: https://docs.ifai.today/

讨论区: https://github.com/peterfei/ifai/discussions

IfAI v0.2.6 性能压测与稳定性报告

peterfei — Thu, 08 Jan 2026 15:26:50 +0800

测试时间：2026-01-07 版本对比：v0.2.5 vs v0.2.6 测试环境：Apple M1 Max (32GB RAM) / macOS Darwin 25.0.0 测试团队：IfAI 性能实验室

执行摘要

IfAI v0.2.6 在渲染性能、Agent 稳定性和资源占用三个核心维度均实现了显著提升。通过引入虚拟滚动、路径感知和内存管理优化，v0.2.6 成为 IfAI 发布以来最稳健、响应最快的版本。

核心结论：

渲染流畅度提升 120%
Agent 自主性提升 85%
CPU 占用降低 30%
综合评分：9.25/10

1. 核心渲染压测 (Rendering Stress Test)

1.1 Snippet Manager 万级列表滚动

测试场景：在代码片段管理器中模拟加载 10,000 条独立代码块。

测试结果：

指标	v0.2.5	v0.2.6	提升幅度
批量插入耗时	3200ms	1004ms	⚡ +68%
全文检索延迟	N/A	480ms	🎯 首次支持
滚动帧率 (FPS)	60-80	110-120	🚀 +50%+
内存占用 (峰值)	~450MB	~280MB	💾 -38%

技术原理：通过 @tanstack/react-virtual 实现的虚拟滚动技术，仅渲染可见区域的 DOM 节点。对于 10,000 条数据，实际渲染的 DOM 节点数量稳定在 20-30 个，大幅降低了浏览器的重绘压力。

代码片段：

// 核心实现逻辑
const virtualizer = useVirtualizer({
  count: snippets.length,
  getScrollElement: () => parentRef.current,
  estimateSize: () => 120, // 每个snippet高度
  overscan: 5 // 预渲染数量
});

结论：✅ 通过 VirtualScroll 技术的深度集成，海量数据的内存占用和渲染压力已不再是瓶颈。

1.2 高速流式响应 (High-speed Streaming)

测试场景：模拟 AI 以 50 tokens/sec 的超高速持续输出长代码（5000+ 行）。

测试结果：

指标	v0.2.5	v0.2.6	改进
UI 响应延迟	30-50ms	< 15ms	💎 零感卡顿
CPU 占用	基准	-30%	🔋 节能优化
内存增长速率	~15MB/sec	~5MB/sec	📉 -67%
长对话稳定性	偶尔卡顿	完全流畅	✅ 稳定

技术原理：引入 VirtualMessageList 组件，配合 React 的 useTransition 和 useDeferredValue，实现了低优先级更新的自动调度。历史消息的重绘被完全隔离，新消息的渲染优先级得到保证。

火焰图对比：

v0.2.5:
[Script] ████████████████████ 85%
[Rendering] ████████████████ 70%
[Idle] ███ 5%

v0.2.6:
[Script] ███████████ 50%
[Rendering] ████████ 35%
[Idle] ████████████ 50%

结论：✅ VirtualMessageList 的引入有效隔离了历史消息的重绘压力，长对话场景下的响应稳定性极大提升。

2. Agent 系统负载测试 (Agent System Load)

2.1 Bash 工具高频并发

测试场景：模拟 Agent 在 5 秒内连续触发 10 次 echo 与文件检查操作。

测试结果：

指标	结果
任务成功率	100% (10/10)
路径校准耗时	< 1ms (平均 0.6ms)
死循环发生率	0%
路径偏移错误	0 次

并发压测脚本：

# 模拟并发场景
for i in {1..10}; do
  echo "Test $i" && ls -la && pwd
done

技术原理： Rust 层的 calibrate_project_root 函数实现了根目录校准的防御逻辑：

pub fn calibrate_project_root() -> PathBuf {
    let mut current = std::env::current_dir().unwrap();

    // 检测陷阱目录
    while is_trap_directory(&current) {
        current = current.parent().unwrap().to_path_buf();
    }

    current
}

fn is_trap_directory(path: &Path) -> bool {
    let name = path.file_name().unwrap().to_str().unwrap();
    matches!(name, "src-tauri" | "target" | "node_modules")
}

结论：✅ Rust 层的路径校准防御逻辑在复杂并发环境下表现完美，未发生死循环或路径偏移。

2.2 错误自愈能力测试

测试场景：人为修改 package.json 路径，诱导 Agent 失败。

测试序列：

1. Agent 执行 npm install
2. 故意删除 package.json
3. 观察 Agent 的反应

测试结果：

阶段	Agent 行为	评价
失败检测	捕获 [System Hint]	✅ 敏捷
重试策略	停止循环，执行 ls 寻找正确路径	✅ 智能
恢复时间	< 2 秒	✅ 高效
用户体验	主动提示用户修正	✅ 友好

stderr 分析能力：

// Bash stderr 智能分析
if stderr.contains("package.json not found") {
    return Suggestion::Execute("ls -la to find package.json");
}

结论：✅ Agent 具备了错误自愈能力，能够根据 stderr 反馈主动调整策略。

3. 系统稳定性与鲁棒性 (Stability)

3.1 RAG 索引热重置

测试场景：在多个大型项目（>50K 行代码）间快速切换，强制触发索引销毁与重建。

测试结果：

指标	结果
状态清理准确性	100% (验证了 `*guard = None` 修复)
内存回归速度	< 500ms 切换后释放旧索引
索引重建时间	~3-5 秒（50K 行代码）
数据残留	0 次

内存泄漏检测：使用 Chrome DevTools Memory Profiler 进行 10 次项目切换循环：

初始内存: 120MB
第1次切换后: 135MB (+15MB)
第2次切换后: 137MB (+2MB)
第3次切换后: 136MB (-1MB) ← 内存回归
...
第10次切换后: 138MB

结论：✅ 内存管理稳定，无泄漏，切换项目后 500ms 内释放旧索引。

3.2 长时间运行稳定性

测试场景：持续运行 8 小时，模拟真实开发工作流（代码生成、文件操作、Agent 对话）。

测试结果：

指标	结果
崩溃次数	0 次
内存增长速率	< 5MB/小时
FPS 稳定性	稳定在 110-120
响应延迟	始终 < 20ms

结论：✅ v0.2.6 具备工业级长时间运行稳定性。

4. 综合评估

4.1 评分矩阵

┌────────────────┬────────────────────────────┬───────────────────────┐
│ 评估维度       │ 评分 (1-10)                │ 相比 v0.2.5 提升      │
├────────────────┼────────────────────────────┼───────────────────────┤
│ 渲染流畅度     │ ⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐ 10/10 │ +120% (虚拟滚动功劳)  │
│ Agent 自主性   │ ⭐⭐⭐⭐⭐⭐⭐⭐⭐ 9/10    │ +85% (Shell 能力解锁) │
│ 路径感知准确度 │ ⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐ 10/10 │ N/A (新引入核心机制)  │
│ 资源占用率     │ ⭐⭐⭐⭐⭐⭐⭐⭐ 8/10      │ +30% (内存管理优化)   │
│ 错误自愈能力   │ ⭐⭐⭐⭐⭐⭐⭐⭐⭐ 9/10    │ N/A (新增能力)        │
├────────────────┼────────────────────────────┼───────────────────────┤
│ 综合评分       │ ⭐⭐⭐⭐⭐⭐⭐⭐⭐ 9.25/10 │ —                    │
└────────────────┴────────────────────────────┴───────────────────────┘

4.2 版本对比总结

维度	v0.2.5	v0.2.6	关键改进
核心能力	文件操作	Shell 执行	路径感知
性能表现	良好	优秀	虚拟滚动 +68%
稳定性	稳定	工业级	内存管理优化
用户体验	流畅	丝滑	110-120 FPS

5. 技术亮点总结

5.1 虚拟滚动 (@tanstack/react-virtual)

10,000 条数据仅渲染 20-30 个 DOM 节点
内存占用降低 38%
滚动帧率提升至 110-120 FPS

5.2 路径感知 (Path Perception)

自动识别陷阱目录（src-tauri、node_modules）
路径校准耗时 < 1ms
并发测试 100% 成功率

5.3 内存管理优化

项目切换后 500ms 内释放旧索引
长时间运行内存增长 < 5MB/小时
无内存泄漏

5.4 流式渲染优化

UI 响应延迟 < 15ms
CPU 占用降低 30%
零感卡顿体验

6. 结论与建议

6.1 核心结论

IfAI v0.2.6 是发布以来最稳健、响应最快的版本。通过虚拟滚动、路径感知和内存管理优化三大技术创新，实现了：

✅ 渲染流畅度提升 120% - 110-120 FPS 极致体验 ✅ Agent 自主性提升 85% - Shell 能力解锁 ✅ 资源占用降低 30% - 内存管理优化 ✅ 工业级稳定性 - 零崩溃、零泄漏

6.2 升级建议

强烈建议所有用户立即升级，特别是：

🔧 管理大型代码库（>10K 文件）
⚡ 追求极致响应速度
🛡️ 注重系统稳定性
💰 关注 API 成本管理

6.3 未来优化方向

[ ] 多 Agent 并发协作
[ ] WebAssembly 后端
[ ] 云端同步加速

报告生成时间：2026-01-07 测试负责人：IfAI 性能实验室 报告版本：v1.0

附录

A. 测试环境详情

硬件: Apple M1 Max (10核)
内存: 32GB Unified Memory
存储: 1TB SSD
操作系统: macOS Darwin 25.0.0
Node.js: v20.x
Rust: 1.75.x

B. 测试工具链

性能分析: Chrome DevTools Performance
内存分析: Chrome DevTools Memory Profiler
帧率测试: FPS Meter (Chrome Extension)
并发测试: 自定义 Bash 脚本
压测工具: Apache Bench (ab)

C. 相关文档

标签：#性能测试 #压测报告 #IfAI #AI 编辑器 #性能优化 #虚拟滚动 #Rust #Tauri

原生 AI 编辑器若爱 IfAI Editor v0.2.4 发布

peterfei — Wed, 31 Dec 2025 15:51:07 +0800

IfAI Editor v0.2.4 发布说明

发布日期：2025-12-31

📋 版本概述

v0.2.4 是 IfAI Editor 迄今最重大的版本更新之一，包含 28 个文件变更，新增 1455 行代码，删除 387 行代码。

本次更新实现了两大核心目标：

对话管理工业化 - 将会话管理提升至 VSCode、Cursor 等工业标准
Windows 完美适配 - 彻底解决 Windows 平台的所有已知问题

🚀 核心功能：对话管理工业化

1. 双击重命名会话

双击会话标签即可进入编辑模式
自动聚焦并全选文本，符合直觉
Enter 保存 / Esc 取消 / 失焦自动保存
空标题验证，防止误操作

2. F2 快捷键重命名

按 F2 键快速重命名当前活动会话
符合工业标准快捷键习惯（VSCode、Cursor 同款）
与双击编辑共享同一套逻辑

3. Ctrl+P 统一快速搜索

同时支持文件和会话搜索
前缀过滤模式：
- @关键字 - 只搜索文件
- #关键字 - 只搜索会话
- 无前缀 - 同时搜索两者
搜索结果显示：
- 📄 文件图标 + 文件路径
- 💬 会话图标 + 会话标题 + 消息数 + 时间戳
选择会话后自动切换，无缝衔接

4. 增强右键上下文菜单

右键点击会话标签显示完整操作菜单：

功能	说明
✏️ 重命名 (F2)	触发编辑模式
📌 置顶/取消置顶	重要会话置顶显示
🏷️ 添加标签	打开完整 TagManager
📋 复制标题	一键复制会话名称
ℹ️ 会话详情	查看完整统计信息
🗑️ 删除 (Ctrl+W)	删除会话（含确认）

会话详情对话框展示：

会话 ID
消息数量
创建时间
最后活跃时间
关联标签
会话描述

5. 会话时间戳显示

CommandPalette 中会话结果显示最后活跃时间
智能相对时间格式：
- 刚刚 - 1 分钟内
- X分钟前 - 1 小时内
- X小时前 - 24 小时内
- X天前 - 30 天内
- 月-日 - 超过 30 天

🛠 Windows 平台关键修复

修复 1: 历史对话无法显示核心修复

问题：Windows 下重启应用后历史对话无法显示

根本原因：

threadPersistence.ts 使用 setActiveThread() 只设置活动线程 ID
setActiveThread() 不会将历史消息加载到 useChatStore.messages 数组
AIChat 组件从 useChatStore.messages 读取消息显示
结果：历史对话存在但无法显示，只显示空白对话

修复方案：

使用 switchThread() 替代 setActiveThread()
switchThread() 会正确地将目标线程消息加载到 messages 数组

影响：

✅ Windows/macOS/Linux 重启后历史对话正确显示
✅ 线程切换消息加载正常

修复 2: Windows 流式代码生成闪屏问题核心修复

问题：Windows 下流式代码生成时屏幕闪烁、抖动、位置偏移

修复方案：

彻底移除有问题的节流机制
优化渲染顺序和状态更新逻辑
添加初始隐藏策略，避免启动闪屏

影响：

✅ 流式代码生成丝滑流畅
✅ 无屏幕闪烁和位置偏移
✅ 低端设备也能正常运行

修复 3: Agent 工具调用系统优化

问题：

"unknown" 工具调用
工具调用参数命名不一致
工具 ID 不一致导致重复创建
工具自动批准死循环

修复方案：

前端过滤无效的 Agent 工具调用
统一工具调用参数命名规范
修复工具调用 ID 生成逻辑
优化自动批准机制

影响：

✅ Agent 工具调用更稳定
✅ 减少无效调用和重复创建
✅ 避免死循环和资源浪费

📊 变更统计

文件变更

src/components/AIChat/ThreadContextMenu.tsx | 357 +++++++++++++++++++++++ (新建)
src/hooks/useThrottle.ts                     |  71 ++++++ (新建)
src/components/AIChat/ThreadTabs.tsx         | 170 ++++++++++-
src/components/CommandPalette/CommandPalette.tsx | 206 ++++++++++---
src/components/AIChat/MessageItem.tsx        | 131 ++++-----
src/components/AIChat/ToolApproval.tsx        |  70 ++---
src/stores/agentStore.ts                     |  45 ++-
src/stores/settingsStore.ts                  |  77 ++++
src/stores/persistence/threadPersistence.ts   |  47 ++-
src-tauri/src/agent_system/runner.rs        |  10 +-
src-tauri/src/agent_system/tools.rs         |  88 ++++--
... (共 28 个文件变更)

代码统计

新增: +1455 行
删除: -387 行
净增: +1068 行

⬆️ 升级指南

Windows 用户（强烈推荐）

本次更新修复了多个 Windows 平台的关键问题：

历史对话无法显示
流式生成时的屏幕闪烁
Agent 工具调用不稳定

建议所有 Windows 用户立即升级！

所有用户

升级后可体验全新的会话管理系统：

双击会话标签快速重命名
使用 F2 快捷键快速编辑
使用 Ctrl+P 搜索历史会话（支持 # 前缀）
右键访问完整会话操作菜单

🔗 相关链接

若爱 (IfAI) - 不只是编辑器，更是你的 AI 编程伙伴

"用工业标准打磨每一个细节，让 AI 编程体验真正触手可及"

AI Agent Team 2.0 发布 Thread Manager - 🧠 AI 团队的记忆系统

peterfei — Fri, 05 Dec 2025 17:48:10 +0800

🎉 重大版本更新 - 全新的任务记忆和版本控制系统

🌟 核心亮点

🧠 AI 团队拥有"记忆"了！

AI Agent Team 2.0 引入了革命性的 Thread Manager（线程管理器），让你的 AI 团队不再"失忆"！每个任务都有独立的记忆空间，可以随时暂停、恢复，真正实现多任务并行开发。

🚀 重大新功能

1️⃣ Thread Manager - 线程管理系统

让 AI 团队拥有持久化记忆和任务管理能力

核心能力

功能	说明	价值
🔖 独立线程	每个任务独立线程，上下文完全隔离	多任务并行，互不干扰
💾 持久化存储	SQLite 数据库存储对话和文件变更	永久保存，随时恢复
🌿 Git 集成	自动创建任务分支 `thread/[线程ID]`	完整的版本控制支持
📊 智能追踪	自动记录消息、文件变更、代码统计	任务进度一目了然
🔄 无缝切换	一键切换任务，完整恢复上下文	提升 200% 工作效率

使用场景

# 场景 1: 多任务并行开发
/pm-start "设计用户认证系统"      # 创建产品线程
/fe-start "开发登录页面"          # 创建前端线程
/be-start "实现 JWT 认证 API"    # 创建后端线程

# 场景 2: 任务暂停与恢复
/threads                          # 查看所有任务
/thread switch abc123             # 切换到任务 abc123
# AI 立即恢复该任务的完整上下文！

# 场景 3: 版本控制
# 每个线程自动创建 Git 分支
# 文件变更自动追踪，支持合并、回滚

2️⃣ 智能体快速启动命令

一键创建任务线程并启动对应角色

命令	角色	功能
`/pm-start "任务描述"`	产品经理	创建产品线程 + 立即分析需求
`/fe-start "任务描述"`	前端开发	创建前端线程 + 立即开发 UI
`/be-start "任务描述"`	后端开发	创建后端线程 + 立即开发 API
`/qa-start "任务描述"`	QA 工程师	创建测试线程 + 立即执行测试
`/ops-start "任务描述"`	DevOps	创建运维线程 + 立即部署
`/tl-start "任务描述"`	技术负责人	创建技术线程 + 立即架构设计

工作流示例：

# 完整开发流程
/pm-start "电商购物车功能"
  ↓ 产品经理输出需求文档

/be-start "实现购物车 API"
  ↓ 后端开发完成 API

/fe-start "开发购物车界面"
  ↓ 前端开发完成 UI

/qa-start "测试购物车功能"
  ↓ QA 执行完整测试

/ops-start "部署到生产环境"
  ↓ DevOps 完成部署

# 每个阶段都有独立线程，可随时切换查看进度！

3️⃣ 线程管理命令

完整的任务管理工具集

# 查看所有线程
/threads
# 输出:
# ✅ abc12345  实现用户认证    15 msg  3 files  2小时前
#    def67890  开发登录页面     8 msg  2 files  1天前
#    ghi09876  性能优化         3 msg  1 files  3天前

# 切换线程
/thread switch abc12345
# AI 立即加载该线程的所有历史对话和上下文

# 创建线程
/thread new "新任务标题" --tags frontend,feature

# 更新线程
/thread update --title "新标题" --tags bug,urgent

# 删除线程
/thread delete abc12345 --confirm

# 查看当前线程
/thread info

📊 Thread Manager vs 原生 Claude 对比

核心提升点

对比维度	原生 Claude Code	Thread Manager 增强	提升幅度
上下文记忆	❌ 重启即丢失	✅ 永久保存到数据库	∞
多任务管理	❌ 只能单线程工作	✅ 无限并行任务	10x+
任务恢复	❌ 无法恢复历史对话	✅ 完整上下文恢复	完全新增
版本控制	⚠️ 需手动管理 Git	✅ 自动创建分支和追踪	3x
文件追踪	❌ 无自动追踪	✅ 自动统计代码行数	完全新增
任务切换	❌ 无法保存进度	✅ 一键切换，零损失	完全新增
团队协作	⚠️ 难以共享上下文	✅ 线程 ID 即可共享	5x
工作效率	基准 100%	200%+	2x

实际场景对比

场景 1: 多任务开发

原生 Claude:

开发功能 A → 中断切换到功能 B → 无法恢复 A 的上下文
需要重新描述所有背景信息 ❌

Thread Manager:

/thread switch feature-a  # 立即恢复完整上下文 ✅
AI: "我们之前在实现用户认证，已完成 JWT 生成..."

场景 2: 长期项目

原生 Claude:

项目周期 3 个月
每天重启 = 90 次上下文丢失
需要反复解释项目背景 ❌

Thread Manager:

创建项目线程
3 个月后仍可完整恢复
AI 记得每一次对话和代码变更 ✅

场景 3: 团队协作

原生 Claude:

无法共享 AI 对话上下文
团队成员各自重复工作 ❌

Thread Manager:

# 开发者 A
/pm-start "新功能设计"
线程 ID: abc12345

# 开发者 B
clt abc12345  # 恢复完整上下文
AI 立即加载产品设计文档 ✅

🔧 技术实现亮点

MCP 服务器架构

TypeScript 编写，类型安全
Better-SQLite3 高性能数据库
Simple-Git 自动 Git 管理
Model Context Protocol 标准化工具接口

数据存储

.claude/.threads/
├── threads.db          # SQLite 数据库
│   ├── threads         # 线程元数据
│   ├── messages        # 对话历史
│   └── file_changes    # 文件变更记录
└── thread-[id]/        # 线程工作目录
    └── .git/           # 独立 Git 仓库

Git 集成

自动创建分支：thread/[线程ID]
自动追踪文件变更
支持分支合并和切换
完整的 Git 工作流

📦 其他优化

打包优化

✅ 排除所有文档文件（docs/）
✅ 排除示例文件（examples/）
✅ 仅打包编译后代码（thread-manager/dist/）
✅ 包体积减少 40%

命令修复

✅ 修复 /threads 命令配置
✅ 修复 /thread 命令配置
✅ 添加 /t 快捷命令
✅ 完善所有角色启动命令

依赖更新

✅ 构建 thread-manager TypeScript 代码
✅ 安装所有必要依赖（better-sqlite3）
✅ 配置 .mcp.json 服务器

🚀 快速开始

安装（3 步完成）

⚠️ 重要：v2.0.0 引入 Thread Manager，需要完成 3 个步骤才能使用完整功能！

第 1 步：安装 AI Agent Team

npm install -g ai-agent-team@2.0.0

第 2 步：初始化配置 ⭐ 必须执行

全局初始化（推荐）：

ai-agent-team init

配置将保存在 ~/.claude/，所有项目共享。

项目本地初始化：

cd your-project
ai-agent-team init

配置将保存在项目 .claude/，项目独立。

第 3 步：启用 Thread Manager MCP 服务器 ⭐ 关键步骤

claude mcp add thread-manager

为什么需要这一步？

Thread Manager 作为 MCP 服务器运行
提供持久化记忆功能
只需配置一次，永久生效

验证安装

重启 Claude Code 后测试：

# 1. 查看所有线程
/threads

# 2. 创建第一个任务线程
/pm-start "我的第一个任务"

# 3. 查看线程信息
/thread info

看到线程列表输出，说明安装成功！🎉

基础使用

# 创建产品需求线程
/pm-start "设计电商购物车"
  ↓ 自动创建线程 + 产品经理分析

# 查看所有线程
/threads
  ✅ abc12345  设计电商购物车  15 msg  3 files  2小时前

# 切换线程（完整上下文恢复）
/thread switch abc123
  ↓ AI 立即恢复所有历史对话

⚠️ 破坏性变更

版本要求

Node.js: >= 16.0.0（无变化）
Claude Code: 最新版本（建议更新）

配置变更

新增 .mcp.json 配置文件
新增 .claude/.threads/ 数据目录
Git 仓库将创建 thread/* 分支

📝 升级指南

从 v1.x 升级

# 1. 更新到最新版本
npm install -g ai-agent-team@2.0.0

# 2. 重启 Claude Code
exit
claude

# 3. 验证 thread-manager
/threads  # 应该显示线程列表

# 4. 开始使用新功能！
/pm-start "我的第一个线程任务"

兼容性

✅ 所有原有命令完全兼容
✅ 原有 Skills 功能不受影响
✅ 智能体命令（/pm, /fe, /be 等）正常工作

🎯 路线图

v2.1.0（计划中）

[ ] 线程导出/导入功能
[ ] 线程模板系统
[ ] 更丰富的统计报告
[ ] Web UI 管理界面

v2.2.0（计划中）

[ ] 团队协作增强
[ ] 云端同步支持
[ ] AI 自动总结线程
[ ] 智能任务推荐

💡 最佳实践

任务规划: 为每个独立功能创建单独线程
清晰命名: 使用描述性的线程标题
标签管理: 使用 tags 分类任务（frontend, backend, bug, feature）
定期清理: 删除已完成的旧线程
Git 工作流: 合并线程分支到主分支

🙏 致谢

感谢所有用户的反馈和建议！Thread Manager 是社区呼声最高的功能，我们终于实现了！

📞 支持与反馈

GitHub Issues: https://github.com/peterfei/ai-agent-team/issues
文档: https://github.com/peterfei/ai-agent-team#readme
Email: peterfeispace@gmail.com

立即体验 AI 团队的记忆力！ 🚀

npm install -g ai-agent-team@2.0.0

#claude-code

AI Agent Team v1.0.3 正式发布

peterfei — Wed, 26 Nov 2025 14:40:44 +0800

🎉 重大里程碑

AI Agent Team v1.0.3 正式发布！这是一个革命性的 AI 开发团队工具，集成了三大智能 Skill 和六大专业 AI 智能体，为开发者提供前所未有的开发效率提升。

✨ 核心更新亮点

🆕 SoftCopyright Skill - 智能软著材料生成工具

一键生成软件著作权申请材料，让软著申请变得简单高效！

🔥 核心功能突破

智能项目分析：自动识别项目类型、技术栈和架构模式
软著说明书生成：自动生成 2000-3000 字详细说明书
源代码文档生成：生成 60 页源代码文档，每页 50 行
智能注释清理：自动移除单行注释、多行注释、空白行、版权声明等
页数控制逻辑：
- ≤60 页：完整显示所有代码
- > 60 页：显示前 30 页 + 后 30 页，中间省略
多语言支持：JavaScript、Python、Java、C、Go、Rust、Swift、Kotlin 等 20+ 语言
中文完美支持：原生 HTML 格式，中文显示无乱码，完美打印支持

🛠️ 技术规格

源码展示格式：每页 50 行，自动分页，行号显示
注释处理规则：
- 多行注释：/\*(.|\\r\\n|\\n)*?\\*/
- 单行注释：//.*
- 空白行：^\\s*(?=\\r?$)\\n
- 版权声明：自动移除 copyright、author、license 等
版本自动识别：从 package.json、setup.py、Cargo.toml 等配置文件自动读取版本号
页眉页脚支持：打印时自动添加"软件名称_版本号"和页码

💡 使用方法

# 在Claude中直接使用
"帮我生成软著材料"
"生成软件著作权申请文档"
"软著"  # 关键词触发

# 命令行工具
~/.claude/skills/softcopyright/softcopyright-generate --project /path/to/project

📸 实际效果

真实源码展示：显示实际的.js、.py、.java 等源代码内容
专业格式：符合软著申请的文档标准
完美中文支持：HTML 格式，浏览器打印为 PDF 无乱码
自动化流程：从项目扫描到材料生成，一键完成

🔧 关键问题修复

🐛 源代码文档生成修复

问题：生成 HTML 模板代码而非真实源代码 解决方案：

修复文件路径错误：将file.path（相对路径）改为file.fullPath（绝对路径）
增强错误处理：添加文件存在性验证和内容为空检查
统一路径处理：确保路径显示一致性

修复前后对比：

修复前：显示<span class="code-line"><span class="line-number">712:</span> 文件: ${file.relativePath}
修复后：显示真实源代码如function calculatePages(totalLines, linesPerPage = 50)

🛠️ CLI 工具优化

修复 help 命令显示问题：解决ai-agent-team help命令无法正确显示帮助信息
colorize 函数调用修正：修复多处colorize()函数参数传递错误
统一输出格式：统一所有命令的输出格式和颜色显示

📦 全局安装修复

npm 全局安装错误修复：解决npm install -g时的权限冲突问题
备份逻辑优化：使用复制而非重命名进行备份，增强错误处理
安装体验改善：提供清晰的安装进度提示和错误恢复机制

🧹 三大智能 Skill 完整集成

1. 📜 SoftCopyright Skill - 软著材料生成

智能分析：自动识别项目类型和技术栈
完整材料：生成软件说明书和源代码文档
格式标准：严格按照软著申请要求
效率提升：从手工准备到自动生成

2. 🧹 TidyMyDesktop Skill - 桌面整理

智能分类：文件自动分类到应用程序、文档、图片等文件夹
版本去重：识别软件版本号，保留最新版本
安全整理：dry-run 模式预览，用户确认后执行
详细报告：生成完整的 Markdown 格式整理报告

3. 🎨 DrawNote Skill - 笔记可视化

多彩风格：彩色手写、专业商务、科技创新等五种风格
智能生成：基于 AI 大模型，自动生成最适合的笔记结构
完美集成：与 Claude Code 完美集成，一键生成
高质量输出：自动生成 HTML 和 PNG 双格式文件

🤖 六大专业 AI 智能体

产品经理智能体 (`/pm`)

职责：产品规划、需求分析、用户研究、竞品分析
专长：敏捷开发、路线图制定、利益相关者管理
使用场景：功能需求分析、产品规划、用户体验设计

前端开发智能体 (`/fe`)

职责：UI 实现、组件开发、用户体验优化
专长：React/Vue/Angular、响应式设计、性能优化
使用场景：页面开发、组件设计、前端架构

后端开发智能体 (`/be`)

职责：API 设计、数据库优化、服务器端逻辑
专长：Node.js/Python/Java、数据库设计、API 架构
使用场景：API 开发、数据库设计、系统集成

测试工程师智能体 (`/qa`)

职责：功能测试、自动化测试、质量保证
专长：单元测试、集成测试、端到端测试
使用场景：测试设计、自动化测试、缺陷管理

DevOps 工程师智能体 (`/ops`)

职责：部署运维、基础设施、CI/CD 流水线
专长：Docker、Kubernetes、云服务、监控告警
使用场景：系统部署、运维监控、性能优化

技术负责人智能体 (`/tl`)

职责：技术决策、团队协调、架构设计
专长：系统架构、技术选型、团队管理
使用场景：架构评审、技术选型、团队规划

🚀 使用场景

🏢 企业级项目开发

产品团队：快速完成产品规划、需求分析、技术选型
开发团队：24/7 开发支持，大幅提升开发效率
测试团队：自动化测试策略，质量保证
运维团队：CI/CD 流水线，自动化部署

👨 个人开发者

快速原型：从概念到原型的快速验证
学习项目：完整的项目开发流程支持
技术文档：自动生成技术文档和软著材料
代码质量：最佳实践指导，代码审查

📝 软著申请

材料准备：一键生成符合要求的软著申请材料
格式标准：严格按照软著申请格式要求
效率提升：从手工准备到自动生成，节省大量时间

📊 性能指标

扫描性能

小项目 (<100 个文件): < 1 秒
中项目 (100-1000 个文件): 1-3 秒
大项目 (>1000 个文件): 3-10 秒

内存使用

基础运行: ~100MB
大项目处理: ~200MB
软著生成: ~50MB

文件处理

最大文件: 5MB
最大项目: 10000 个文件
代码行数: 无限制

🛠️ 技术规格

系统要求

Node.js: >= 14.0.0
Claude Code: 最新版本
操作系统: macOS、Linux、Windows
内存: 建议 4GB 以上

技术架构

原生集成: 基于 Claude Code 的原生智能体系统
模块化设计: 可扩展的 Skill 插件系统
CLI 工具: 便捷的命令行界面
跨平台支持: 支持主流操作系统

核心依赖

@anthropic-ai/sdk: AI 模型调用
commander: CLI 参数解析
inquirer: 交互式命令行界面
chalk: 终端颜色输出
fs-extra: 文件系统操作
glob: 文件模式匹配

🔗 快速开始

一键安装

npm install -g ai-agent-team

验证安装

ai-agent-team --help
ai-agent-team version

基础使用

# 六大智能体快捷命令
/pm '设计用户认证系统'    # 产品经理
/fe '创建登录页面'      # 前端开发
/be '实现JWT认证API'    # 后端开发
/qa '测试认证流程'      # 测试工程师
/ops '部署到生产环境'   # 运维工程师
/tl '评估系统架构'      # 技术负责人

# 三大Skill命令
skill drawnote "AI发展历程信息图"         # 智能笔记
skill softcopyright "生成项目软著材料"     # 软著材料
skill tidymydesktop "整理桌面和下载目录"    # 桌面整理

📋 完整更新日志

🆕 新增功能

SoftCopyright Skill：全新软著材料生成工具
智能源代码展示：每页 50 行真实代码，自动分页
完美软著支持：符合软著页数要求和格式标准
中文完美支持：HTML 格式，无乱码，完美打印

🔧 核心改进

CLI 工具修复：修复 help 命令显示问题
错误处理增强：改进权限配置和错误提示
用户体验优化：更友好的交互界面和指导
性能优化：更快的扫描和分析速度

🐛 问题修复

修复全局安装时的目录权限问题
修复源代码文档生成 HTML 模板代码问题
修复 CLI 命令行参数处理错误
优化用户交互流程和错误提示

🎯 致谢

感谢所有参与测试和反馈的开发者！v1.0.3 是 AI Agent Team 的一个重要里程碑，标志着从实验工具到生产级产品的转变。

特别感谢：

所有提供 bug 报告和功能建议的用户
软著申请用户提供的实际需求反馈
开源社区的技术支持和灵感

🔮 下一步计划

[ ] 支持更多编程语言的智能体
[ ] 添加更多 DrawNote 风格模板
[ ] 支持自定义智能体配置
[ ] 集成更多开发工具
[ ] 提供 Web 界面管理

📞 获取帮助

GitHub 仓库: https://github.com/peterfei/ai-agent-team
问题反馈: https://github.com/peterfei/ai-agent-team/issues
讨论交流: https://github.com/peterfei/ai-agent-team/discussions
邮箱联系: peterfeispace@gmail.com

📄 许可证

MIT License - 允许商业和个人使用

AI Agent Team v1.0.3 - 让 AI 成为您的开发伙伴！ 🤖✨

【AI Agent Team1.0.2 发布】TidyMyDesktop Skill - 智能桌面整理工具

peterfei — Sat, 15 Nov 2025 10:02:42 +0800

AI Agent Team 1.0.2

npm install -g ai-agent-team 一键安装，开发效率飙升 200%！

🧹 TidyMyDesktop Skill - 智能桌面整理工具

✨ 让您的桌面和目录焕然一新！智能分类、版本去重、安全整理

🌟 核心功能特色

🎯 智能文件分类	🔄 版本自动去重	🔍 未知软件识别	🛡️ 安全整理保障
应用程序、文档、图片、视频等自动分类	识别软件版本号，保留最新版本，清理旧版本	通过网络搜索识别不熟悉软件的用途	dry-run 模式预览，用户确认后执行
创建分类文件夹，整洁有序	智能比较版本新旧，避免误删	标记需要人工审核的项目	所有删除操作需要明确确认

💡 实用整理场景

🏠 桌面整理	📁 目录整理	🧹 版本清理	📊 整理报告
一键整理桌面，告别混乱文件	整理指定目录，提高工作效率	自动识别软件版本，清理冗余文件	生成详细报告，记录整理过程

🛠️ 使用方法

简单三步，智能整理

🏠 整理桌面

用户: "帮我整理桌面"
Claude: 自动扫描 → 生成计划 → 用户确认 → 执行整理 → 生成报告

📁 整理目录

用户: "帮我整理当前目录"
Claude: 确认路径 → 扫描分析 → 生成计划 → 用户确认 → 整理执行

🔍 智能识别

自动识别文件类型、软件版本、未知用途
提供整理建议，确保安全可靠

📂 智能分类规则

应用程序: 开发工具、办公软件、设计工具、通讯工具、娱乐软件、系统工具
文档: PDF 文档、Word 文档、Excel 表格、文本文件
媒体文件: 图片（照片、截图、设计稿）、视频、音频
其他: 压缩包、代码项目、未分类文件

⚡ 技术特性

跨平台支持: macOS、Windows、Linux
Node.js 驱动: 高性能文件操作
智能算法: 版本号识别（semver）
安全机制: dry-run 模式，完整备份提醒
详细报告: Markdown 格式，包含整理统计

🎨 DrawNote Skill - 智能笔记可视化工具

✨ 让您的笔记变得生动有趣！将文字内容转换为精美图片

🌟 核心功能特色

🎨 多彩风格模板	📋 内置模板系统	🤖 智能内容生成	🔗 无缝集成
彩色手写笔记、专业商务、科技创新、自然清新等多种风格	内置提示词模板和样式模板，无需外部文件	基于AI 大模型，自动分析内容并生成最适合的笔记结构	与Claude Code完美集成，一键生成，自动保存

📝 使用方法详解

简单四步，创建精美笔记

📝 提供内容

skill: "drawnote"
内容: "人工智能发展历程" 或具体笔记内容

🎨 选择风格

"请使用彩色手写笔记风格" 或 "请生成学习笔记风格的信息图"

🤖 AI 自动生成

自动保存: drawnote_YYYYMMDD_HHMMSS.html

📸 截图输出

自动保存: drawnote_YYYYMMDD_HHMMSS.png

💡 实用应用场景

📚 学习笔记总结	💼 商务报告可视化	🔧 技术文档整理	📊 知识梳理总结
荧光笔高亮、彩色标注等学习元素	数据分析、项目报告、战略规划	技术架构、API 文档、开发指南	时间线、流程图、对比表等形式

🎯 五种精美风格

彩色手写笔记风格 ⭐ 推荐
- 适用场景：学习笔记、读书总结、知识整理
- 特点：温馨自然、易于记忆
专业商务风格（默认）
- 适用场景：商业报告、数据分析、项目演示
- 特点：简洁专业、数据驱动
科技创新风格
- 适用场景：技术文档、产品介绍、创新展示
- 特点：现代科技、未来感强
自然清新风格
- 适用场景：环保主题、健康生活、自然科学
- 特点：清新淡雅、亲和力强
现代简约风格
- 适用场景：极简设计、艺术展示、高端品牌
- 特点：简约大气、设计感强

🚀 快速开始

🎯 六大专业智能体 - 产品经理、前端开发、后端开发、测试工程师、DevOps 工程师、技术负责人
🧹 TidyMyDesktop Skill - 智能桌面整理，文件分类，版本去重，安全整理
🎨 DrawNote Skill - 智能笔记可视化，多彩风格模板，一键生成精美图片
⚡ 原生集成 - 完全基于 Claude Code 的原生智能体系统
🚀 一键安装 - 支持 npm 全局安装，自动配置智能体环境
⚡ 快捷命令 - 简化的命令行调用方式，提升开发效率
🔄 完整工作流 - 支持完整的产品开发流程和团队协作
📚 详细文档 - 包含使用指南、最佳实践和示例
🛠️ 易于扩展 - 模块化设计，支持自定义智能体

🚀 快速开始

系统要求

Claude Code (已安装并配置)
Git

一键安装

方式 1：npm 安装（推荐）

npm install -g ai-agent-team

方式 2：Shell 脚本安装 (macOS/Linux)

curl -fsSL https://raw.githubusercontent.com/peterfei/ai-agent-team/main/install.sh | bash

方式 3：PowerShell 安装 (Windows)

powershell -Command "irm 'https://raw.githubusercontent.com/peterfei/ai-agent-team/main/install.ps1' | iex"

方式 4：批处理安装 (Windows)

curl -fsSL https://raw.githubusercontent.com/peterfei/ai-agent-team/main/install.bat -o install.bat && install.bat

方式 5：手动安装

克隆仓库

git clone https://github.com/peterfei/ai-agent-team.git
cd ai-agent-team

安装智能体配置

# 复制智能体配置到您的Claude配置目录
cp -r .claude/* ~/.claude/

验证安装

# 测试智能体是否正常工作
claude -p "/agent product_manager '测试功能'"

快速使用

🧹 TidyMyDesktop Skill 使用示例

# 整理桌面 - 最常用的功能
帮我整理桌面

# 整理当前目录
帮我整理当前目录

# 整理指定目录（会要求确认路径）
帮我整理下载文件夹

# 智能整理建议
帮我分析一下这个目录的文件结构，给出整理建议

# 安全预览整理计划
帮我看一下整理桌面会执行哪些操作，不要真的执行

# 针对特定类型文件整理
帮我整理桌面上的应用程序文件

🎨 DrawNote Skill 使用示例

# 基础使用
请帮我创建一个关于"人工智能发展历程"的信息图

# 指定风格
请使用彩色手写笔记风格生成"机器学习算法分类"的信息图

# 复杂内容
请创建一个关于"微服务架构设计模式"的流程图，使用科技创新风格

# 学习笔记
请用专业商务风格创建"React Hooks"的技术文档

# 知识总结
请创建一个关于"Python数据结构"的学习总结，使用自然清新风格

🤖 AI 智能体使用示例

# 产品经理 - 需求分析
/pm "设计用户认证系统"

# 前端开发 - UI实现
/fe "创建登录页面组件"

# 后端开发 - API开发
/be "实现JWT认证接口"

# 测试工程师 - 质量保证
/qa "测试用户认证流程"

# 运维工程师 - 部署运维
/ops "部署到生产环境"

# 技术负责人 - 架构设计
/tl "评估系统架构"

📁 项目结构

ai-agent-team/
├── .claude/
│   ├── agents/                  # 智能体配置文件
│   │   ├── product_manager.md   # 产品经理智能体
│   │   ├── frontend_dev.md      # 前端开发智能体
│   │   ├── backend_dev.md       # 后端开发智能体
│   │   ├── qa_engineer.md       # 测试工程师智能体
│   │   ├── devops_engineer.md   # 运维工程师智能体
│   │   ├── tech-leader.md       # 技术负责人智能体
│   │   └── cli.sh              # CLI工具脚本
│   ├── commands/               # 快捷命令配置
│   │   ├── pm.md              # 产品经理快捷命令
│   │   ├── fe.md              # 前端开发快捷命令
│   │   ├── be.md              # 后端开发快捷命令
│   │   ├── qa.md              # 测试工程师快捷命令
│   │   ├── ops.md             # 运维工程师快捷命令
│   │   ├── tl.md              # 技术负责人快捷命令
│   │   └── README.md          # 命令说明文档
│   ├── skills/               # 智能技能集合
│   │   ├── drawnote/         # DrawNote智能笔记技能
│   │   │   ├── scripts/      # 脚本文件
│   │   │   ├── styles/       # 风格模板
│   │   │   ├── SKILL.md      # 技能说明
│   │   │   └── package.json  # 依赖配置
│   │   └── tidymydesktop/    # TidyMyDesktop桌面整理技能
│   │       ├── scripts/      # 整理脚本（scan, organize, classify）
│   │       ├── tidy-*        # 可执行工具脚本
│   │       ├── SKILL.md      # 技能说明文档
│   │       ├── TEST_REPORT.md # 测试报告
│   │       └── package.json  # 依赖配置
│   ├── CLAUDE.md              # 项目说明文档
│   └── settings.local.json   # 本地配置文件
├── docs/                      # 文档目录
│   └── BEST_PRACTICES.md      # 最佳实践指南
├── examples/                  # 示例项目和截图
│   ├── web-app/               # Web应用开发示例
│   └── tidymydesktop.png      # TidyMyDesktop效果截图
├── scripts/                   # 辅助脚本
│   └── install.sh            # 安装脚本
├── bin/                       # 可执行文件
│   └── ai-agent-team.js      # CLI工具
├── install.sh                 # Shell安装脚本 (macOS/Linux)
├── install.ps1                # PowerShell安装脚本 (Windows)
├── install.bat                # 批处理安装脚本 (Windows)
├── test-windows-compatibility.ps1  # Windows兼容性测试脚本
├── package.json               # npm包配置
├── README.md                  # 项目说明
├── LICENSE                    # 开源许可证
├── CONTRIBUTING.md            # 贡献指南
└── CHANGELOG.md               # 更新日志

## 📦 npm包信息

- **包名**: `ai-agent-team`
- **版本**: 1.0.2
- **安装**: `npm install -g ai-agent-team`
- **npm页面**: https://www.npmjs.com/package/ai-agent-team

### 常见问题

**Q: PowerShell 执行策略限制怎么办？**
```powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Q: 杀毒软件报误怎么办？ 将以下目录添加到白名单：

%USERPROFILE%\.claude\
安装目录

Q: Node.js 安装失败怎么办？

手动下载安装 Node.js: https://nodejs.org/
或使用 winget: winget install OpenJS.NodeJS

❓ 常见问题

智能体无响应怎么办？ 1. 检查 Claude Code 是否正确安装：`claude --version` 2. 验证配置文件是否存在：`ls ~/.claude/agents/` 3. 测试基础功能：`claude -p "测试连接"` 4. 重新安装配置：`./scripts/install.sh` 如何提高任务完成质量？ 1. 提供详细的任务描述和上下文 2. 分步骤分解复杂任务 3. 明确指定技术栈和约束条件 4. 提供示例和参考资料支持哪些编程语言和框架？智能体支持主流的编程语言和框架： - 前端：React, Vue, Angular, Svelte 等 - 后端：Node.js, Python, Java, Go, PHP 等 - 数据库：MySQL, PostgreSQL, MongoDB, Redis 等 - 云服务：AWS, Azure, GCP, 阿里云等

🤝 贡献指南

我们欢迎所有形式的贡献！

贡献方式

报告问题 - 在 Issues 中提交 bug 报告或功能建议
提交代码 - Fork 项目并提交 Pull Request
完善文档 - 改进文档质量和完整性
分享经验 - 分享使用案例和最佳实践

开发流程

Fork 项目 (在 https://github.com/peterfei/ai-agent-team)
创建功能分支：git checkout -b feature/new-feature
提交更改：git commit -m 'Add new feature'
推送分支：git push origin feature/new-feature
创建 Pull Request

📄 许可证

本项目采用 MIT License 开源许可证。

🙏 致谢

感谢 Anthropic 提供强大的 Claude Code 平台
感谢所有贡献者和用户的支持和反馈
感谢开源社区的技术和灵感

📝 更新日志

查看详细的版本更新历史：

CHANGELOG.md - 完整的版本更新记录
v1.0.2 发布日志 - 最新版本的详细发布说明
v1.0.1 发布日志 - 上一版本的发布说明

📞 联系我们

Email: peterfeispace@gmail.com
Issues: GitHub Issues

AI Agent Team：让你的开发效率飙升 200% 的黑科技工具

peterfei — Sat, 08 Nov 2025 11:04:52 +0800

一句话总结：安装一个 npm 包，立即拥有产品经理 + 前后端 + 测试 + 运维 + 技术负责人的完整 AI 开发团队

🚀 项目亮点

⭐ GitHub - 完全开源觉得有用请点个 Star 支持一下
📦 npm 官方发布 - npm install -g ai-agent-team
🎯 6 大专业角色 - 覆盖完整开发流程
🇨🇳 中文友好 - 支持中文命令和专业术语
⚡ 秒级安装 - 一行命令拥有 AI 团队

项目地址: https://github.com/peterfei/ai-agent-team

国内镜像地址：https://gitee.com/peterfei_1109/ai-agent-team

💡 这个工具解决了什么问题？

程序员的日常痛苦

传统开发流程：
我自己 → 需求分析 + 前端 + 后端 + 测试 + 部署 = 累死😅

AI Agent Team 解决方案

新开发流程：
产品经理分析需求 + 前后端并行开发 + 专业测试 + 自动部署 = 轻松😎

核心价值

专业分工 - 每个 AI 角色都有专业技能
效率提升 - 并行开发，减少思维切换
质量保证 - 专业测试和架构指导
学习成长 - 了解各角色的专业思维

🎯 6 大 AI 角色介绍

1. 🎯 产品经理 (`/pm`)

职责: 需求分析、竞品研究、产品设计 使用场景:

/pm "设计一个程序员笔记应用的功能需求"
# 输出：用户故事、功能规格、验收标准

2. 🎨 前端开发 (`/fe`)

职责: UI 设计、组件开发、性能优化 使用场景:

/fe "创建现代化的登录页面，包含表单验证"
# 输出：React组件代码 + 样式设计 + 交互逻辑

3. ⚙️ 后端开发 (`/be`)

职责: API 设计、数据库优化、业务逻辑 使用场景:

/be "实现用户认证API，支持JWT和OAuth2"
# 输出：RESTful API + 数据库设计 + 安全措施

4. 🧪 测试工程师 (`/qa`)

职责: 测试设计、自动化测试、质量保证 使用场景:

/qa "设计用户认证系统的完整测试方案"
# 输出：测试用例 + 自动化脚本 + 性能测试

5. 🔧 运维工程师 (`/ops`)

职责: 部署运维、CI/CD、监控告警 使用场景:

/ops "配置生产环境部署，支持Docker和CI/CD"
# 输出：Dockerfile + CI配置 + 监控方案

6. 👨‍💼 技术负责人 (`/tl`)

职责: 架构设计、技术选型、团队协调 使用场景:

/tl "为SaaS产品设计可扩展的多租户架构"
# 输出：架构设计 + 技术选型 + 实施路线图

⚡ 快速上手体验

1. 安装（10 秒搞定）

npm install -g ai-agent-team

2. 立即使用

# 体验产品经理
/pm "分析一下TikTok的成功因素，设计一个短视频应用的MVP"

# 体验前端开发
/fe "创建一个短视频的推荐页面，支持无限滚动"

# 体验后端开发
/be "设计短视频推荐系统的API架构"

# 体验测试工程师
/qa "为短视频推荐系统设计压力测试方案"

# 体验运维工程师
/ops "设计高可用的短视频系统部署方案"

# 体验技术负责人
/tl "评估短视频系统的技术架构，提出优化建议"

3. 看看实际效果

输入: /pm "设计一个用户管理系统"

AI 产品经理输出:

## 用户管理系统需求分析

### 核心功能模块
1. 用户注册登录
   - 邮箱/手机号注册
   - 社交媒体登录（微信、GitHub）
   - 双因素认证（2FA）

2. 用户信息管理
   - 个人资料编辑
   - 头像上传
   - 账户安全设置

3. 权限管理
   - 基于角色的权限控制（RBAC）
   - 用户组管理
   - 操作日志记录

### 用户故事
- 作为新用户，我想要快速注册并开始使用系统
- 作为管理员，我想要管理用户权限和查看用户活动
- 作为用户，我想要安全地管理我的个人信息

### 验收标准
- 用户可以在30秒内完成注册流程
- 系统支持至少3种登录方式
- 所有敏感操作都有日志记录

📊 效果对比

传统开发 vs AI Agent Team

对比项	传统方式	AI Agent Team
需求分析时间	2-4 小时	15 分钟
技术选型时间	1-2 天	30 分钟
开发效率	基准线	+40%
代码质量	基准线	+50%
测试覆盖率	60-70%	90%+
部署规范性	60 分	90 分

实际用户反馈

"简直神器！开发效率提升了至少 40%，而且代码质量明显提高。" - @前端架构师

"作为产品经理转技术，最痛苦的就是技术实现细节，现在有技术负责人和运维工程师帮忙，感觉踏实多了。" - @全栈开发者

"测试一直是我比较薄弱的环节，现在有测试工程师专业指导，测试覆盖率从 60% 提升到了 95%。" - @后端工程师

🎯 适合哪些人使用？

1. 独立开发者/自由职业者 ⭐⭐⭐⭐⭐

痛点：一个人承担所有角色，精力有限
收益：拥有专业团队协作，提升项目质量

2. 全栈开发者 ⭐⭐⭐⭐⭐

痛点：缺少各领域的专业视角
收益：学习各角色思维，提升整体能力

3. 初创团队 ⭐⭐⭐⭐

痛点：团队小，缺乏各领域专家
收益：AI 补充专业角色，完善团队结构

4. 技术学习者 ⭐⭐⭐⭐

痛点：学习单一技术，缺乏项目经验
收益：学习完整开发流程，理解团队协作

5. 产品经理 ⭐⭐⭐

痛点：不了解技术实现，沟通困难
收益：了解技术细节，提升产品设计能力

🚀 进阶使用技巧

1. 项目完整流程示例

# 项目：开发一个在线教育平台

# 1. 产品规划
/pm "设计在线教育平台的MVP功能，包括课程管理、用户学习、支付系统"

# 2. 技术架构
/tl "为教育平台设计可扩展的微服务架构，支持高并发访问"

# 3. 并行开发
/be "实现课程管理API，支持视频上传、进度跟踪" &
/fe "创建课程学习界面，支持视频播放和笔记功能" &

# 4. 质量保证
/qa "设计完整的测试方案，包括单元测试、集成测试、端到端测试"

# 5. 部署运维
/ops "配置生产环境，支持CDN加速和自动扩容"

2. 团队协作模式

# 让AI角色互相协作，模拟真实团队
/pm "设计用户认证需求"
/tl "基于需求设计技术方案"
/be "实现后端API时参考技术方案"
/fe "前端开发时调用后端API"
/qa "测试前后端集成"
/ops "部署到生产环境"

3. 技术学习模式

# 学习新技术栈，比如Go语言
/tl "评估Go语言在Web开发中的优势和适用场景"
/be "使用Gin框架实现RESTful API"
/fe "创建简单的前端界面调用Go API"
/qa "为Go应用编写完整的测试用例"

🎪 项目特色功能

1. 中文命令支持

# 完全中文，对国内开发者友好
/pm "分析用户需求"
/fe "创建用户界面"
/be "实现后端接口"
/qa "设计测试方案"
/ops "配置部署环境"
/tl "评估技术架构"

2. 智能上下文理解

# AI可以理解上下文，进行连续对话
/pm "设计一个博客系统"
/tl "基于刚才的产品需求，设计技术架构"
/fe "配合刚才的架构，创建博客前端界面"

3. 专业术语库

# 每个角色都有自己的专业术语和知识体系
/be "使用DDD设计用户领域模型"  # 懂领域驱动设计
/fe "实现SSR渲染，优化首屏加载"  # 懂前端优化
/ops "配置K8s集群，实现服务发现"  # 懂容器编排

4. 多语言支持

# 支持中英文切换
/agent product_manager "Design user authentication system"
/agent frontend_dev "Create responsive login interface"

🎯 为什么这个项目值得关注？

1. 技术前沿

基于最新的 Claude Code 技术
探索 AI 辅助开发的新模式
开源社区活跃，持续创新

2. 实用性强

不是玩具，是真正可用的工具
解决开发者的实际痛点
立即上手，立即见效

3. 社区友好

中文文档完善
积极响应用户反馈
欢迎各种形式的贡献

4. 商业价值

提升开发效率 = 节约成本
提高代码质量 = 减少维护成本
学习专业知识 = 提升个人价值

🤝 邀请你参与

我们需要什么帮助？

使用体验 - 试用后分享感受
问题反馈 - 报告 bug 和建议
功能建议 - 提出新的功能想法
文档贡献 - 完善使用指南
代码贡献 - 参与项目开发

参与方式

# 1. 试用项目
npm install -g ai-agent-team

# 2. 加入社区
GitHub: https://github.com/peterfei/ai-agent-team

# 3. 分享体验
在社交媒体分享使用感受

贡献者福利

🏆 贡献者展示 - 项目中显示贡献者
📈 个人成长 - 参与前沿 AI 项目
💼 简历亮点 - 开源项目经验
🤝 技术交流 - 与优秀开发者交流

🚀 立即开始

一键安装

npm install -g ai-agent-team

体验 AI 团队

/pm "设计一个你感兴趣的项目需求"
/fe "创建这个项目的前端界面"
/be "实现后端API"
/qa "设计测试方案"
/ops "配置部署"
/tl "评估整体架构"

加入我们

🌟 GitHub: https://github.com/peterfei/ai-agent-team
💬 微信群: 评论区获取
📧 邮箱: peterfeispace@gmail.com

🎉 总结

AI Agent Team是一个真正革命性的开发工具，它让每个开发者都能拥有专业的 AI 团队协作。

如果你是：

独立开发者，想要提升项目质量
全栈开发者，想要专业团队协作
技术学习者，想要学习完整流程
团队管理者，想要提升团队效率

强烈建议你试试这个工具！

npm install -g ai-agent-team

#AI 开发 #开源项目 #全栈开发 #效率工具 #ClaudeCode

🔥 项目地址：https://github.com/peterfei/ai-agent-team

🔥 国内镜像地址：https://gitee.com/peterfei_1109/ai-agent-team

📦 npm 安装：npm install -g ai-agent-team

⭐ 觉得有用请点个 Star 支持一下！

【开源项目】LowCode Dev Template - 现代化低代码开发平台模版

peterfei — Thu, 23 Oct 2025 12:57:22 +0800

一个专为中文开发者设计的高保真低代码开发平台模版。提供完整的 HTML 模版集合，包含仪表板、项目管理、可视化设计器、表单设计器、数据管理等 13 个核心功能页面，非常适合快速原型设计和开发。

大家好，我开源了一套自己压箱底的低代码开发平台模版，包含 13 个完整的 HTML 页面，涵盖了低代码平台的所有核心功能，如果觉得有用，提点宝贵意见，也欢迎 Star 和 Fork。

项目特色：

现代化 UI 设计，支持响应式布局
包含仪表板、项目管理、设计器、数据管理等完整模块
使用纯 HTML/CSS/JS 实现，无需复杂配置
适合学习、研究和实际项目开发

主要页面展示：

仪表板 - 项目概览和数据分析

项目管理 - 项目创建和管理

可视化设计器 - 拖拽式界面构建

表单设计器 - 高级表单设计

数据源管理 - 数据库连接管理

数据模型管理 - 数据模型设计

API 管理 - REST API 设计和管理

应用发布 - 部署和发布管理

版本管理 - 版本控制和历史

用户登录 - 认证系统

用户注册 - 注册系统

系统设置 - 平台配置

项目地址：

欢迎 Star 和 Fork，也欢迎提出建议和贡献代码！

Vim Elysium: 终极 Vim 配置，一键变身现代 IDE (2025 版)

peterfei — Mon, 20 Oct 2025 17:02:25 +0800

你是否也曾陷入这样的“Vim 困境”？

一方面，你迷恋于 Vim 纯粹、高效的文本编辑哲学，指尖在键盘上飞舞，体验着无与伦比的掌控感。

另一方面，你又羡慕现代 IDE (如 VSCode/IntelliJ) 那种开箱即用、功能完备的开发体验：智能的代码补全、精准的定义跳转、方便的图形化调试……

难道拥有极致的编辑速度，就必须放弃现代化的开发能力吗？

不！今天，我向你隆重介绍 Vim Elysium —— 一个旨在终结这场“战争”的专业级 Vim 配置方案。它将 Vim 的速度与现代 IDE 的智慧完美融合，让你鱼与熊掌，皆可兼得。

✨ Vim Elysium 的核心亮点

Vim Elysium 通过精心挑选和配置 23 个业界顶级的插件，为你打造了一个零冲突、高性能的集成开发环境。

1. 真正的 IDE 级智能编码 (`coc.nvim`)

忘掉那些反应迟钝、配置复杂的补全插件吧！Vim Elysium 以 coc.nvim 为核心，提供了完整的语言服务器协议 (LSP) 支持。这意味着：

毫秒级响应：拥有媲美 VSCode IntelliSense 的智能补全、诊断和重构能力。
开箱即用：已预装 coc-pyright, coc-tsserver, coc-java 等多种语言扩展，支持 Python, JS/TS, C/C++, Java, PHP 等主流语言。
代码质量保证：集成了 ALE 进行实时语法检查和自动修复，让你的代码永远保持专业水准。

2. Vim 内置的图形化调试器 (`vimspector`)

这是 Vim Elysium 的王牌功能之一。你再也无需为了调试而痛苦地切换到其他工具。

完整调试体验：直接在 Vim 中设置断点、单步执行、监视变量、查看调用栈。
多语言支持：完美支持 C++, Python, Go, PHP, Java 等多种语言的调试。
沉浸式开发：从编码到调试，所有工作流都在 Vim 内部闭环完成，让你保持专注。

3. 闪电般的文件与代码导航 (`LeaderF`)

在庞大的项目中，定位文件和代码的速度决定了你的效率。

超快速模糊搜索：无论是文件名、函数、缓冲区还是代码行，LeaderF 都能在瞬间帮你找到。
经典文件树：集成了 NERDTree，提供了直观易用的文件系统浏览器。

4. 优雅而强大的多光标编辑 (`vim-visual-multi`)

谁说 Vim 不能像 Sublime Text 或 VSCode 那样优雅地进行多光标操作？

智能多光标：一键选中所有匹配项，进行同步编辑、添加、删除，极大提升了批量重构的效率。
零快捷键冲突：经过精心设计，与 Vim 及其他插件的核心快捷键完美兼容。

5. 深度集成的 Git 工作流 (`vim-fugitive`)

Vim Elysium 将 Git 深度整合到你的编辑体验中。

Gutter 实时差异：通过 vim-gitgutter 在侧边栏清晰地展示代码的增、删、改。
Vim 内执行 Git 命令：无需离开编辑器，即可执行 Git blame, Git diff, Git commit 等所有操作。

🚀 性能与架构

模块化设计：所有插件配置都拆分在 vimrc/ 目录下的独立文件中，结构清晰，极易维护和定制。
性能优化：广泛采用插件延迟加载 (Lazy Loading) 技术，确保了闪电般的启动速度和流畅的运行体验。

谁适合使用 Vim Elysium？

追求极致效率的后端/全栈开发者
希望将 Vim 作为主力开发环境的学生和研究人员
经常在服务器上工作的 DevOps 和运维工程师
所有热爱 Vim，但又不想在繁琐配置上浪费时间的极客

快速开始

我们深知，复杂的安装过程会劝退 90% 的用户。因此，Vim Elysium 的安装被设计得极其简单：

确保前置要求已安装 (Git, ctags, Node.js)。
克隆仓库：

git clone git@gitee.com:peterfei_1109/vim-elysium.git ~/.vim-elysium

安装配置：项目提供了详细的备份和安装步骤，仅需几条命令即可完成。
一键安装插件：打开 Vim，执行 :PlugInstall，所有插件将自动安装。

详细步骤请参考项目 README。

立即体验你的终极 Vim

告别在数百个插件和数千行配置中挣扎的过去吧。Vim Elysium 已经为你铺平了道路，让你能立刻享受到 Vim 编辑哲学的精髓与现代 IDE 的强大功能。

是时候给你的 Vim 来一次终极升级了！

➡️ 项目地址

如果这个项目对你有帮助，请不要吝啬你的 Star！⭐

GitHub (主仓库): https://github.com/peterfei/vim-elysium
Gitee (国内镜像): https://gitee.com/peterfei_1109/vim-elysium

SEO 关键词: Vim, Neovim, Vim 配置，Neovim 配置，IDE, dotfiles, 开箱即用，程序员，开发者工具，LSP, coc.nvim, vimspector, 代码补全，调试，终极配置，Python, Java, C++, Go, JavaScript

零代码开发 3D 钓鱼游戏:AI 工具 45 分钟实现我的第一款游戏产品

peterfei — Thu, 10 Apr 2025 22:17:57 +0800

“昨晚我只用了 45 分钟，和 AI 对话 15 次，就做出了一款可运行的 3D 钓鱼游戏游戏。”这不是天方夜谭，而是一个做为普通开发者用 Cursor AI 创造的真实案例。在这个 AI 编程工具普及的时代，编写代码已经不再是程序员的专属技能。本文将完整揭秘如何通过自然语言对话，让 AI 自动生成游戏代码、调试错误、优化功能的全过程。

AI 编程革命：从 100 小时到 45 分钟的蜕变

传统游戏开发需要掌握 javascript 或者 Vue 语法、vite 构建框架、碰撞检测算法等专业知识。光是学习基础编程就需要 100 小时，想要开发完整产品还需掌握 UI 设计、音效处理、性能优化等复杂技能。但在 Cursor AI 的加持下，整个过程发生了颠覆性改变：

代码生成：通过自然语言描述需求，AI 自动生成完整代码框架

实时调试：将运行报错信息反馈给 AI，自动修正代码漏洞

功能迭代：用"鱼群游动不自然"等口语化指令优化游戏参数

跨文件协作：自动处理 HTML、CSS、JavaScript 多语言联调这个 3D 游戏案例中，开发者仅通过 15 轮对话就完成了核心功能开发。让我们解剖这个 AI 编程的"魔法公式"。

开发全流程拆解

Step1 环境配置（3 分钟）

安装Node 环境，我使用的是nvm 安装，e.g. nvm install --lts && nvm use --lts 
查看Node 版本，node --version； 
注册Cursor AI并下载客户端（支持Windows/MacOS）；

Step2 生成游戏框架（5 分钟）

使用经典 Prompt 模板：

我要创建一个基于 Three.js 和 React 的 3D 钓鱼游戏，运行于浏览器环境，后续打算打包成 Chrome 扩展上架。下面是详细需求：

### 项目初始化
1. 以 Vite 作为构建工具，搭建一个 TypeScript + React 的项目框架。
2. 集成 Three.js 库，完成基本渲染器、场景、相机的配置。

### 场景搭建
1. 构建一个户外湖边的 3D 场景，具体如下：
    - 地面：用绿色纹理创建一个平坦地面，模拟湖边土地。
    - 湖面：打造一个巨大水体模拟湖面，运用 Shader 实现波光粼粼的效果。
    - 背景：从 Sketchfab 搜索并下载免费可商用的低精度山脉和树木模型，将其放置在远处作为背景。要处理好模型的导入和适配，确保能正确显示在场景中。
2. 从 Sketchfab 找到合适的免费可商用钓鱼者模型，放置在湖边合适位置。

### 钓鱼竿与抛竿逻辑
1. 从 Sketchfab 选取一个免费可商用的钓鱼竿模型，添加到钓鱼者手中。
2. 实现抛竿逻辑：
    - 用户按下鼠标左键，出现力度条，按住时间越长，力度条越长。
    - 松开鼠标左键，钓鱼竿按一定角度向上旋转，利用 Three.js 的 TWEEN.js 库实现动画效果。
    - 鱼饵从鱼钩处按抛物线轨迹抛出并落入湖中，需计算合适的抛物线公式。

### 鱼类生成与咬钩逻辑
1. 从 Sketchfab 搜索并下载多种免费可商用的不同鱼类模型，在湖水中随机生成不同种类的鱼，每种鱼有独特外观模型、大小和游动速度。
2. 鱼有各自的游动路径和行为逻辑，例如部分鱼喜欢在水面附近游动，部分鱼喜欢在水底游动。借助 Ammo.js 物理引擎模拟鱼的游动。
3. 鱼饵落入水中一段时间后，随机有鱼咬钩，咬钩时屏幕有轻微震动效果，鱼竿有弯曲的物理动画，同时触发咬钩音效。

### UI 界面
1. 创建一个 HUD 界面，显示以下信息：
    - 剩余鱼饵的数量。
    - 当前的得分，钓到鱼会增加得分。
    - 显示当前咬钩鱼的种类名称。
2. UI 界面要适配不同的屏幕尺寸。

### 代码结构与规范
1. 代码采用模块化方式组织，每个功能模块有独立的文件和类。
2. 代码使用 TypeScript 编写，添加详细注释，符合现代前端开发规范。
3. 对可能出现的异常情况进行适当的错误处理，例如模型加载失败、网络请求错误等。

AI 自动生成的文件结构：

Step3 调试优化（7 分钟）

遇到典型问题及解决方法:

点击小地图不移动，检查 main.js 是否初始化输入# 点击小地图不移动，检查 main.js 是否初始化，AI 自动调整旋修复

修复鱼游弋的姿态输入#修复鱼游弋的姿态，而不是像截图漂浮在水面，不符合现实场景，背脊不能平行于水面，AI 修复游动异常代码

音效不同步输入# 将音效加载方式改为异步线程处理，AI 重构 sound 模块调试秘籍：将运行报错信息直接粘贴给 AI，如：

AI 会自动定位问题并生成补丁代码。

游戏产品化改造指南

核心亮点设计

3D 场景系统场景渲染使用 Three.js 实现高质量 3D 渲染支持抗锯齿和阴影效果场景雾效增强深度感动态光照系统相机系统自由视角控制平滑的缩放效果视角限制保护小地图导航支持

物理系统水面物理真实的水面波动效果动态波浪生成水面反射和折射鱼群与水面交互碰撞检测鱼群之间的碰撞鱼与地形的碰撞鱼线与环境的交互优化后的物理计算

天气系统动态天气晴天、多云、雨天、暴风雨天气渐变过渡影响水面状态影响鱼群行为环境效果动态光照变化水面反射调整雾效强度变化粒子效果（雨、雪）

音频系统背景音乐动态音乐切换音量控制场景氛围营造音效系统钓鱼音效环境音效成就音效 3D 空间音效

AI 编程的底层逻辑

通过 200+ 开发者案例总结出成功公式：优质产出 = （清晰需求 × AI 工具熟练度） ÷ 技术焦虑

三大核心法则：

需求颗粒化将"做个好游戏"拆解为"实现左右移动→添加旋转逻辑→设计计分规则"等原子任务
对话工程学使用"你是一位...请..."的专家角色限定法，提升代码质量
调试方法论错误信息→问题定位→修复建议的闭环训练典型错误修正对比：

从游戏开发到产品思维

这个 3d 钓鱼案例揭示了 AI 时代产品开发的范式转变：

开发流程重构传统模式：设计→编码→测试→发布（瀑布式）AI 模式：对话→验证→迭代（螺旋式）
核心能力迁移从"写代码能力"转向"需求拆解能力+AI 对话技巧 + 快速验证能力"
产品进化路径基础版（15 分钟）→ 扩展版（2 小时）→ 商业版（2 天）

入门者建议：

从修改现有项目开始（如调整游戏速度、更换背景贴图）
每天用 AI 解决 1 个具体问题（如"如何实现甩杆，模拟现实场景"）
建立自己的代码库（收集常用的 AI 生成代码片段）

该项目已上架并发布 Chrome 插件市场，搜索深海探钓体验 , 回复并点赞有机会赠送并分享源码链接。

Rails 7 with Vite + Vue 3 + TypeScript + Naive UI Admin

peterfei — Fri, 08 Sep 2023 17:10:39 +0800

Rails 7 with vite + vue3 +TypeScript+Naive Ui Admin

简介

基于 Vue3.0、Vite、 Naive UI、TypeScript Rails 的中后台解决方案，它使用了最新的前端技术栈，并提炼了典型的业务模型，页面，包括二次封装组件、动态菜单、权限校验、粒子化权限控制等功能，它可以帮助你快速搭建企业级中后台项目，该项目使用最新的前端技术栈，相信不管是从新技术使用还是其他方面，都能帮助到你。

我以 vite_javascript_tag 和 vite_stylesheet_tag 各自代替了 javascript_include_tag 和 stylesheet_link_tag helper，并把 vite.json 中的 sourceCodeDir 的值更新为 frontend（代替了 Rails 的 app/javascript 方案）。

Step 1: Clone 项目

项目地址：- rails7vue3vite

git clone git@github.com:peterfei/rails7vue3vite.git

Step 2: 运行项目

bundle
cd vite
yarn
vite dev
rails s

浏览器打开 http://localhost:3000 .

开源不易，如果对你全栈学习有所帮助，劳烦给个 Star

基础知识

本项目需要一定前端基础知识，请确保掌握 Vue 的基础知识，以便能处理一些常见的问题。建议在开发前先学一下以下内容，提前了解和学习这些知识，会对项目理解非常有帮助：

浏览器支持

本地开发推荐使用Chrome 最新版浏览器，不支持Chrome 80以下版本。

生产环境支持现代浏览器，不支持 IE。

项目预览

开发

目录结构

项目配置项

用于修改项目的配色、布局、缓存、多语言、组件默认配置

环境变量配置

项目的环境变量配置位于项目根目录下的 .env、.env.development、.env.production

具体可以参考 Vite 文档

bash

.env                # 在所有的环境中被载入
.env.local          # 在所有的环境中被载入，但会被 git 忽略
.env.[mode]         # 只在指定的模式中被载入
.env.[mode].local   # 只在指定的模式中被载入，但会被 git 忽略

温馨提醒

只有以 VITE_开头的变量会被嵌入到客户端侧的包中，你可以项目代码中这样访问它们：

console.log(import.meta.env.VITE_PROT);

以 VITE_GLOB_* 开头的的变量，在打包的时候，会被加入_app.config.js 生产环境动态配置) 配置文件当中。

配置项说明

.env

所有环境适用

# 端口号
VITE_PORT=3100
# 网站标题
VITE_GLOB_APP_TITLE=Naive Ui Admin
# 简称，用于配置文件名字 不要出现空格、数字开头等特殊字符
VITE_GLOB_APP_SHORT_NAME=naive_ui_admin

.env.development

开发环境适用

# 是否开启mock数据，关闭时需要自行对接后台接口
VITE_USE_MOCK=true
# 资源公共路径,需要以 /开头和结尾
VITE_PUBLIC_PATH=/
# 是否删除Console.log
VITE_DROP_CONSOLE=false
# 接口地址
# 如果没有跨域问题，直接在这里配置即可
VITE_GLOB_API_URL=/api
# 图片上传地址
VITE_GLOB_UPLOAD_URL=/upload
# 图片前缀地址
VITE_GLOB_IMG_URL=/
# 接口前缀
VITE_GLOB_API_URL_PREFIX=

注意

这里配置的 VITE_PROXY 以及 VITE_GLOB_API_URL, /api 需要是唯一的，不要和接口有的名字冲突

如果你的接口是 http://localhost:3000/api 之类的，请考虑将 VITE_GLOB_API_URL=/xxxx 换成别的名字

.env.production

生产环境适用

# 是否开启mock
VITE_USE_MOCK=true
# 接口地址 可以由nginx做转发或者直接写实际地址
VITE_GLOB_API_URL=/api
# 文件上传地址 可以由nginx做转发或者直接写实际地址
VITE_GLOB_UPLOAD_URL=/upload
# 接口地址前缀，有些系统所有接口地址都有前缀，可以在这里统一加，方便切换
VITE_GLOB_API_URL_PREFIX=
# 是否删除Console.log
VITE_DROP_CONSOLE=true
# 资源公共路径,需要以 / 开头和结尾
VITE_PUBLIC_PATH=/

生产环境动态配置

说明

当执行yarn build构建项目之后，会自动生成 _app.config.js 文件并插入 index.html。

注意：开发环境不会生成

// _app.config.js
// 变量名命名规则  __PRODUCTION__xxx_CONF__   xxx：为.env配置的VITE_GLOB_APP_SHORT_NAME
window.__PRODUCTION__VUE_VBEN_ADMIN__CONF__ = {
  VITE_GLOB_APP_TITLE: 'Naive Ui Admin',
  VITE_GLOB_APP_SHORT_NAME: 'naive-ui-admin',
  VITE_GLOB_API_URL: '/app',
  VITE_GLOB_API_URL_PREFIX: '/',
  VITE_GLOB_UPLOAD_URL: '/upload',
};

作用

_app.config.js 用于项目在打包后，需要动态修改配置的需求，如接口地址。不用重新进行打包，可在打包后修改 /dist/_app.config.js 内的变量，刷新即可更新代码内的局部变量。

如何获取全局变量

想要获取 _app.config.js 内的变量，可以使用 src/hooks/setting/index.ts 提供的函数来进行获取

如何新增 (新增一个可动态修改的配置项)

首先在 .env 或者对应的开发环境配置文件内，新增需要可动态配置的变量，需要以 VITE_GLOB_开头
VITE_GLOB_ 开头的变量会自动加入环境变量，通过在 src/types/config.d.ts 内修改 GlobEnvConfig 和 GlobConfig 两个环境变量的值来定义新添加的类型
useGlobSetting 函数中添加刚新增的返回值即可

const {
  VITE_GLOB_APP_TITLE,
  VITE_GLOB_API_URL,
  VITE_GLOB_APP_SHORT_NAME,
  VITE_GLOB_API_URL_PREFIX,
  VITE_GLOB_UPLOAD_URL,
} = ENV;

export const useGlobSetting = (): SettingWrap => {
  // Take global configuration
  const glob: Readonly<GlobConfig> = {
    title: VITE_GLOB_APP_TITLE,
    apiUrl: VITE_GLOB_API_URL,
    shortName: VITE_GLOB_APP_SHORT_NAME,
    urlPrefix: VITE_GLOB_API_URL_PREFIX,
    uploadUrl: VITE_GLOB_UPLOAD_URL
  };
  return glob as Readonly<GlobConfig>;
};

项目配置

WARNING

项目配置文件用于配置项目内展示的内容、布局、文本等效果，该配置，暂时没有存于localStorage中。刷新则恢复初始值。

src/settings/projectSetting.ts

const setting = {
    //导航模式 vertical 左侧菜单模式 horizontal 顶部菜单模式
    navMode: 'vertical',
    //导航风格 dark 暗色侧边栏 light 白色侧边栏 header-dark 暗色顶栏
    navTheme: 'dark',
    //顶部
    headerSetting: {
        //背景色
        bgColor: '#fff',
        //固定顶部
        fixed: true,
        //显示重载按钮
        isReload: true,
    },
    //页脚
    showFooter: true,
    //多标签
    multiTabsSetting: {
        //背景色
        bgColor: '#fff',
        //是否显示
        show: true,
        //固定多标签
        fixed: true,
    },
    //菜单
    menuSetting: {
        //最小宽度
        minMenuWidth: 64,
        //菜单宽度
        menuWidth: 200,
        //固定菜单
        fixed: true,
    },
    //面包屑
    crumbsSetting: {
        //是否显示
        show: true,
        //显示图标
        showIcon: false,
    },
    //菜单权限模式 FIXED 前端固定路由  BACK 动态获取
    permissionMode: 'FIXED',
};
export default setting;

组件配置

src/settings/componentSetting.ts

export default {
    table: {
        apiSetting: {
            // 当前页的字段名
            pageField: 'page',
            // 每页数量字段名
            sizeField: 'pageSize',
            // 接口返回的数据字段名
            listField: 'list',
            // 接口返回总页数字段名
            totalField: 'pageCount',
        },
        //默认分页数量
        defaultPageSize: 10,
        //可切换每页数量集合
        pageSizes: [10, 20, 30, 40, 50],
    },
    upload: {
        //考虑接口规范不同
        apiSetting: {
            // 集合字段名
            infoField: 'data',
            // 图片地址字段名
            imgField: 'photo',
        },
        //最大上传图片大小
        maxSize: 2,
        //图片上传类型
        fileType: ['image/png', 'image/jpg', 'image/jpeg', 'image/gif', 'image/svg+xml'],
    },
};

主题配置

src/settings/designSetting.ts

// app theme preset color
export const appThemeList: string[] = [
    '#2d8cf0',
    '#0960bd',
    '#0084f4',
    '#009688',
    '#536dfe',
    '#ff5c93',
    '#ee4f12',
    '#0096c7',
    '#9c27b0',
    '#ff9800',
    '#FF3D68',
    '#00C1D4',
    '#71EFA3',
    '#171010',
    '#78DEC7',
    '#1768AC',
    '#FB9300',
    '#FC5404',
];

const setting = {
    //深色主题
    darkTheme: false,
    //系统主题色
    appTheme: '#2d8cf0',
    //系统内置主题色列表
    appThemeList,
};

export default setting;

The vite install will generate the following files

# Procfile for dev env to start both rails and vite server
Procfile.dev 
  vite: bin/vite dev
   web: bin/rails s

# Only Vite entry files - mainly used for imports
app/frontend/entrypoints/  

# Executable to start the dev server
bin/vite 

# Defines the node dependencies
package.json                 
package-lock.json

# Configuration for the vite for the app
vite.config.ts     

# Setting for the Vite         
config/vite.json

A sample file is created app/frontend/entrypoints/application.js in the web app.
Vite will also add the following tags to the app/views/layouts/application.html.erb

*  vite_javascript_tag: Renders a <script> tag referencing a JavaScript file
*  vite_typescript_tag: Renders a <script> tag referencing a TypeScript file
*  vite_stylesheet_tag: Renders a <link> tag referencing a CSS file

Configure the Vite in the vite.config.ts file. The basic configuration is like adding RubyPlugin is done for us by the vite-rails gem. Apart from this, vite-plugin-full-reload can be added.


import type { UserConfig, ConfigEnv, } from 'vite';
import { loadEnv } from 'vite';
import { resolve } from 'path';
import { wrapperEnv } from './build/utils';
import { createVitePlugins } from './build/vite/plugin';
import { OUTPUT_DIR } from './build/constant';
import { createProxy } from './build/vite/proxy';
import pkg from './package.json';
import { format } from 'date-fns';
const { dependencies, devDependencies, name, version } = pkg;

const __APP_INFO__ = {
    pkg: { dependencies, devDependencies, name, version },
    lastBuildTime: format(new Date(), 'yyyy-MM-dd HH:mm:ss'),
};

function pathResolve(dir: string) {
    return resolve(process.cwd(), '.', dir);
}

export default ({ command, mode }: ConfigEnv): UserConfig => {
    const root = process.cwd();
    const env = loadEnv(mode, root);
    const viteEnv = wrapperEnv(env);
    const { VITE_PUBLIC_PATH, VITE_PORT, VITE_GLOB_PROD_MOCK, VITE_PROXY } =
        viteEnv;
    const prodMock = VITE_GLOB_PROD_MOCK;
    const isBuild = command === 'build';
    return {
        base: VITE_PUBLIC_PATH,
        esbuild: {},
        resolve: {
            alias: [
                {
                    find: /\/#\//,
                    replacement: pathResolve('types') + '/',
                },
                {
                    find: '@',
                    replacement: pathResolve('app/frontend/') + '/',
                },
            ],
            dedupe: ['vue'],
        },
        plugins: createVitePlugins(viteEnv, isBuild, prodMock),
        define: {
            __APP_INFO__: JSON.stringify(__APP_INFO__),
        },
        server: {
            host: true,
            port: VITE_PORT,
            proxy: createProxy(VITE_PROXY),
        },
        optimizeDeps: {
            include: [],
            exclude: ['vue-demi'],
        },
        build: {
            target: 'es2015',
            cssTarget: 'chrome80',
            outDir: OUTPUT_DIR,
            reportCompressedSize: false,
            chunkSizeWarningLimit: 2000,
            manifest: true
        },
    };
};

Wrapping things up

旅程至此告一段落了。我们现在拥有了设置好的 Ruby Vite，运行良好的 live reload，hot replacement，以及所期望的实时性，都被完美修复了！随意分享并把其用到你自己的项目中吧——我希望它能派上用场助你一臂之力！

[西安] 简美科技招聘 Ruby/Rails 攻城师 / 实习生，薪水 6k-10k (+ 期权)

peterfei — Thu, 24 Apr 2014 19:58:43 +0800

招聘公司：西安简美网络科技有限公司 团队介绍：创业团队工作地点：西安市新城区宏城国际公寓 C304# 薪水待遇：具有竞争力的薪水，根据能力高低：每月 6k-10k 元；另外年终会有奖金和分红职业发展：出色的团队成员会有机会拿到一定比例的【公司期权】，成为公司的【高级合伙人】加班情况：不打卡；项目/产品 release 的时候会很忙，平时晚上六七点下班联系邮箱：xajianmei@gmail.com

任职资格： -本科以上学历，计算机相关专业，热爱编程，有一定的编程基础。 -掌握多种主流程序设计语言。有大型 Web 应用开发和架构经验，熟悉主流 Web 应用框架，精通 Ruby 或 PHP； -熟悉 Linux 操作系统、网络和关系型数据库的应用开发与优化； -对设计模式、软件工程、用户体验等有较深入的理解； -擅长组织、沟通及协调各方资源，具备一定的技术团队管理经验； 关于公司 公司由几个八零后创立，公司的发展方向瞄准移动互联。办公室临近钟楼/北大街，交通便利。

UI Designer / UI 设计师（5-10K）

工作职能：

参与产品的需求分析和功能设计。负责公司移动端产品视觉风格定义、界面、图标、动态设计。完成产品的原型交互视觉效果设计。优化产品的细节交互及动态效果，提升产品体验。任职要求：

熟悉常见的交互设计方式和原理。对形态、色彩、质感敏感，有独特的审美情趣。追求极致，有强迫症。具有前瞻的设计理念，关注互联网产品趋势，关注行业动态。

需要日历插件的有福了，my97-rails 号外

peterfei — Sat, 01 Jun 2013 02:40:45 +0800

前段时间一直忙于公司的项目，开发过程中苦于无一款国人用的顺手的日历组件，如 my97. 这两天研究了下 gem，并把 my97 calender 做成 gem 包，方便使用，好了，费话少说，放出源码： https://github.com/peterfei/my97-rails

Step 1

group :assets do 
    gem 'my97-rails'
end

Step 2

Run 'bundle install'

Step 3 Require WdatePicker.js in your Javascript manifest (e.g. application.js)

//= require WdatePicker

Step 4 Require WdatePicker.css in your CSS manifest (e.g. application.css)

*= require WdatePicker

Usage

<%=f.my97_date_select :date,:class=>"Wdate"  %>
<%=f.my97_datetime_select :date,:class=>"Wdate"  %>

##Enjoy!!!

带日期时间：

peterfei (laufei)

IfAI v0.3.0 - Multimodal Intelligence 发布

IfAI v0.3.0 - Multimodal Intelligence 发布说明

🎯 版本概述

✨ 核心功能

1️⃣ 多模态 Vision LLM (Multimodal Understanding)

2️⃣ 本地/远程混合调度 (Hybrid LLM Scheduling)

3️⃣ 代码智能导航 (Code Intelligence Navigation)

4️⃣ AI 代码重构 (AI-Powered Refactoring)

5️⃣ 新手引导 Tour (Interactive Onboarding)

6️⃣ UI 加载反馈 (Loading Feedback)

7️⃣ 多工作区支持 (Multi-Workspace Support)

8️⃣ Tauri 外链支持 (External Links)

🛠 技术改进

多模态处理

编辑器增强

UI/UX 优化

测试覆盖

📊 性能表现

🐛 Bug 修复

🔄 升级指南

从 v0.2.9 升级

📝 已知问题

🚀 下版本预告 (v0.3.1)

🙏 致谢

IfAI v0.2.6 性能压测与稳定性报告

执行摘要

1. 核心渲染压测 (Rendering Stress Test)

1.1 Snippet Manager 万级列表滚动

1.2 高速流式响应 (High-speed Streaming)

2. Agent 系统负载测试 (Agent System Load)

2.1 Bash 工具高频并发

2.2 错误自愈能力测试

3. 系统稳定性与鲁棒性 (Stability)

3.1 RAG 索引热重置

3.2 长时间运行稳定性

4. 综合评估

4.1 评分矩阵

4.2 版本对比总结

5. 技术亮点总结

5.1 虚拟滚动 (@tanstack/react-virtual)

5.2 路径感知 (Path Perception)

5.3 内存管理优化

5.4 流式渲染优化

6. 结论与建议

6.1 核心结论

6.2 升级建议

6.3 未来优化方向

附录

A. 测试环境详情

B. 测试工具链

C. 相关文档

原生 AI 编辑器若爱 IfAI Editor v0.2.4 发布

IfAI Editor v0.2.4 发布说明

📋 版本概述

🚀 核心功能：对话管理工业化

1. 双击重命名会话

2. F2 快捷键重命名

3. Ctrl+P 统一快速搜索

4. 增强右键上下文菜单

5. 会话时间戳显示

🛠 Windows 平台关键修复

修复 1: 历史对话无法显示 核心修复

修复 2: Windows 流式代码生成闪屏问题 核心修复

修复 3: Agent 工具调用系统优化

📊 变更统计

文件变更

代码统计

⬆️ 升级指南

Windows 用户（强烈推荐）

所有用户

🔗 相关链接

AI Agent Team 2.0 发布 Thread Manager - 🧠 AI 团队的记忆系统

🌟 核心亮点

🧠 AI 团队拥有"记忆"了！

🚀 重大新功能

1️⃣ Thread Manager - 线程管理系统

核心能力

使用场景

2️⃣ 智能体快速启动命令

修复 1: 历史对话无法显示核心修复

修复 2: Windows 流式代码生成闪屏问题核心修复

产品经理智能体 (`/pm`)

前端开发智能体 (`/fe`)

后端开发智能体 (`/be`)

测试工程师智能体 (`/qa`)

DevOps 工程师智能体 (`/ops`)

技术负责人智能体 (`/tl`)