# Vibcoding

**Repository Path**: samhula/vibe-micro-coding

## Basic Information

- **Project Name**: Vibcoding
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-08
- **Last Updated**: 2026-06-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 证券业务 Vibe Coding 微应用工具

## 🚀 你现在该干什么？

用 **opencode（或 Cursor / Claude Code 等 AI IDE）** 打开这个文件夹，然后说话就行。

**一句话速查：**

| 你想做什么 | 对 AI 说 |
|-----------|---------|
| 第一次启动 | **"帮我启动"** |
| 做个对账工具 | **"帮我做个 Excel 对账工具，比对两个文件"** |
| 换个功能 | **"帮我改成 PDF 净值提取工具"** |
| 报错了 | **"报错了"** |
| 数据不对 | **"数据不对，金额列算错了"** |
| 关掉 | **"关掉"** |

**全程就两件事：** 说话 → 用浏览器打开的工具。不需要碰任何文件，不需要双击任何东西。

> **为什么？** 项目里的 `CLAUDE.md` 文件写好了所有指令，AI 打开文件夹时自动读取。

---

### 没有 AI IDE？

```
1. 打开 prompts/user_template.txt     ← 填你的需求
2. 发给 ChatGPT / Claude / 通义千问    ← AI 生成代码
3. 把返回的代码粘贴到 modules/business.py
4. 双击 run.bat                       ← 启动
```

---

## 📖 举个例子

**运营部小张：** 打开 AI IDE → 说 **"帮我做个对账工具，按统一社会信用代码匹配两个 Excel，找出新增、删除、修改的记录"** → 浏览器弹出 → 上传文件 → 出结果。

报错了？再说一句 **"报错了"**，AI 继续修。

---

### 以后每次用

工具做好了，下次打开浏览器直接用（不需要再开 AI IDE）。

---

## ❓ 常见问题

### Q：什么是 AI？我用哪个？
A：ChatGPT、Claude、文心一言、通义千问、DeepSeek 都可以。如果你公司有大模型平台，用公司的。

### Q：我没有 Python 怎么办？
A：联系 IT 安装。下载地址 [python.org](https://www.python.org/downloads/)，安装时勾选 "Add Python to PATH"。

### Q：AI 说"帮我启动"时报错怎么办？
A：把报错告诉 AI，它会自动修。常见原因：
- **Python 没装** → AI 会引导你安装
- **网络限制** → 公司网络需要代理，联系 IT
- **其他错误** → 直接说"报错了"

### Q：AI 生成的代码运行报错怎么办？
A：**有 AI IDE：** 直接把报错告诉它——"报错了"，AI 会自动修。
   **没有 AI IDE：** 把报错截图发给 AI，说"代码报错了，帮我修复"。

### Q：我想用的功能脚手架没有怎么办？
A：联系 IT 在 core/ 里加。加完后所有工具都能用这个新功能。

---

## 📁 目录说明（不用记，了解即可）

| 目录/文件 | 说明 |
|-----------|------|
| `modules/business.py` | AI 自动改，你不用管 |
| `prompts/user_template.txt` | 没有 AI IDE 时填需求用 |
| `app.py` / `core/` / `config.py` | 不要碰 |
| `run.bat` | 没有 AI IDE 时启动用 |

---

## 📋 能力速查（AI 会看，你不用记）

| 你想做什么 | 脚手架已预置 |
|-----------|-------------|
| 上传 Excel/PDF/Word | 直接支持 |
| 读 Excel 数据 | 直接支持 |
| 两个表做比对 | 直接支持 |
| 导出 Excel 结果 | 直接支持 |
| 提取 PDF 文本/表格 | 直接支持 |
| 提取 Word 文本/关键词 | 直接支持 |
| 调用大模型 | 直接支持 |

AI 会优先使用这些预置能力。如果你需要的功能不在上面，AI 也会用标准 Python 库实现。

---

## 给 IT 看的

- 新增能力流程 → 项目根目录的 `AGENTS.md`
- 能力清单 → `capabilities.json`（自动生成）
- 配置 → `config.py`