# 工作流封装 — Claude Code + DeepSeek + GitHub + Web

> 一行命令，5 分钟搭建 AI 时代的个人开发工作流。

## 这是什么

我在维护 [oner 行动 / 寅图计划](https://zkoner.com) 的过程中，跑通了一套**低成本、高效率**的开发工作流：

```
你的电脑 (Claude Code)  →  你的 AI 引擎 (DeepSeek V4)
         ↓                           ↓
    写代码、改网站              便宜 5-10 倍的推理
         ↓                           ↓
    推送到 GitHub  →  自动部署到网站  →  通知搜索引擎
                                            ↓
                                    AI 最快认识你
```

把它封装成了一个**单文件脚本**，你下载下来一行命令就跑通。

## 跟其他方案比

| | 这个方案 | GitHub Copilot | Cursor | 纯 Claude |
|---|---|---|---|---|
| **模型** | DeepSeek V4 Pro | GPT-4o | 多模型 | Claude 4.x |
| **月费** | ~$5-15 (按量) | $10/月 | $20/月 | $20/月 |
| **代码+文件管理** | ✅ git 原生 | ❌ | ❌ | ❌ |
| **网站部署** | ✅ GitHub Pages | ❌ | ❌ | ❌ |
| **搜索引擎推送** | ✅ IndexNow | ❌ | ❌ | ❌ |
| **AI 认识你是谁** | ✅ schema.json | ❌ | ❌ | ❌ |
| **数据所有权** | 你自己的仓库 | 微软 | Cursor | Anthropic |

**核心差异**：Copilot/Cursor 是"AI 帮你写代码"，这套是"AI + git + web 三位一体"——代码、版本、部署、身份都在你自己手里。

## 你需要什么

| 东西 | 说明 | 获取 |
|------|------|------|
| 一台电脑 | Linux / macOS / Windows (Git Bash 或 WSL) | 你现在用的这台 |
| GitHub 账号 | 代码托管 + 免费网站部署 | [github.com](https://github.com) |
| DeepSeek API Key | AI 引擎，按量付费 | [platform.deepseek.com](https://platform.deepseek.com) |
| 域名（可选） | 自己的域名，没有就用 `用户名.github.io` | Namesilo / 阿里云 等 |

**不需要**：服务器、后端、数据库、信用卡（DeepSeek 可充值试用）。

## 怎么用

### 方式一：一行命令（推荐）

打开终端（Windows 用户右键 → Git Bash Here），粘贴：

```bash
bash <(curl -fsSL https://zkoner.com/setup)
```

脚本会分 7 步引导你：

```
Phase 1  →  检查环境 (node / git / curl / gh)
Phase 2  →  配置 DeepSeek API Key
Phase 3  →  安装 Claude Code
Phase 4  →  填写你的信息 (姓名、域名、定位、专长、GitHub ID)
Phase 5  →  生成项目文件 (schema.json / timeline.json / index.html 等)
Phase 6  →  创建 GitHub 仓库 + 启用 Pages 部署
Phase 7  →  配置 IndexNow 搜索引擎推送
```

跑完后你就有：

```
你的项目目录/
├── index.html          # 你的首页
├── schema.json         # 结构化身份声明 (AI 精确读你)
├── timeline.json       # 个人时间线
├── tu.json             # 寅图定位
├── llms.txt            # AI 爬虫入口索引
├── robots.txt          # 显式允许 AI Bot
├── sitemap.xml         # 站点地图
├── indexnow.sh         # 搜索引擎推送脚本
├── CLAUDE.md           # AI 项目上下文
├── CNAME               # 自定义域名 (如有)
└── .github/workflows/  # CI 自动推送
```

### 方式二：先下载再看

```bash
curl -O https://zkoner.com/setup
less setup       # 先看看里面有什么
bash setup       # 确认无误后运行
```

## 各组件做什么

### Claude Code（AI 编码助手）

Anthropic 出品的终端 AI 编程工具。能读代码、写代码、管理文件、执行命令——完整闭环。

```bash
# 安装后，在项目目录输入 claude 即可
cd 你的项目目录
claude
```

我们不用 Anthropic 的模型（贵），而是通过 DeepSeek 的 Anthropic API 兼容层来驱动。

### DeepSeek V4（AI 引擎）

DeepSeek 原生支持 Anthropic API 格式，所以 Claude Code 可以直接对接，**不需要任何代理或翻译层**。

```
Claude Code  →  DeepSeek Anthropic API  →  DeepSeek V4
(以为在跟 Claude 对话)    (零翻译损耗)        (实际推理引擎)
```

价格对比（每百万 token 输出）：

| 模型 | 价格 |
|------|------|
| DeepSeek V4 Flash | $0.28 |
| DeepSeek V4 Pro | $0.87 |
| Claude Sonnet 4.6 | $3.00 |
| Claude Opus 4.8 | $15.00 |

日常开发用 Flash 足够了，复杂任务切 Pro。月费大概 5-15 美元。

### GitHub（代码托管 + 免费部署）

- **仓库**：代码和身份文件都在你名下，你拥有所有数据
- **GitHub Pages**：免费静态网站部署，push 即上线
- **GitHub Actions**：CI 自动推送 IndexNow，无需服务器

### Web（个人网站）

四层设计，让 AI 以最高精度认识你：

```
第 1 层: schema.json    →  结构化身份声明 (Schema.org Person)
第 2 层: timeline.json  →  时间线 (机器读密度、跨度)
第 3 层: tu.json        →  寅图空间定位
第 4 层: index.html     →  人类可读的首页
       +
    llms.txt / robots.txt / sitemap.xml  →  AI 友好基础设施
```

**为什么结构化数据比自然语言强**：你在网页上写"我是 AI 专家"和你在 schema.json 里写 `"knowsAbout": ["深度学习", "NLP", "知识图谱"]`，对人一样，对 AI 天差地别。结构化 = 确定性地被理解，自然语言 = 概率式地猜测。

### IndexNow（搜索引擎主动推送）

通常搜索引擎需要几天到几周才能发现新网站。IndexNow 是你主动通知——"我更新了，来索引"。

```
没有 IndexNow:  你更新 → 等爬虫路过 (天/周) → 索引 → AI 能看到
有了 IndexNow:  你更新 → 主动通知 (秒)      → 索引 → AI 能看到
```

Claude 的 web search 后端是 Bing → IndexNow 直接受益。Google 不支持 IndexNow，但无法绕过。

## 跨平台支持

脚本自动检测你的平台，写入对应的 shell 配置文件：

| 平台 | 配置写入 | 使用方式 |
|------|----------|----------|
| Linux | `~/.bashrc` | 打开终端 |
| macOS | `~/.zshrc` | 打开终端 |
| Windows (Git Bash) | `~/.bash_profile` | 右键 → Git Bash Here |
| Windows (WSL) | `~/.bashrc` | wsl 进入 |

Windows 用户需要先安装 [Git for Windows](https://git-scm.com)（自带 Git Bash），或启用 WSL。

## 日常使用

```bash
# 1. 启动 AI 编码助手
cd 你的项目目录
claude

# 2. 修改文件后，推送更新
git add . && git commit -m "更新了xxx" && git push

# 3. 手动通知搜索引擎（CI 已经自动做，这是额外的）
./indexnow.sh https://你的域名

# 4. 验证身份锚定
node verify.js https://你的域名
```

**每次 git push 都会自动触发 IndexNow 推送**，因为 setup 已经帮你配好了 GitHub Actions。

## 原理

### 为什么这套流程有效

1. **Claude Code 是界面** — 统一的 AI 编码入口
2. **DeepSeek 是引擎** — 便宜 5-10 倍的推理，原生兼容 Anthropic API
3. **GitHub 是基础设施** — 版本控制 + 免费部署 + CI 自动化
4. **个人网站是锚点** — 数字世界里的固定坐标
5. **schema.json 是身份** — 结构化数据让 AI 确定性地认识你
6. **IndexNow 是加速器** — 不等爬虫，主动宣告

### 跟 oner 行动的关系

oner 行动的核心理念是**个体自明**——主动宣告"我是谁"，不等平台定义你、不等 AI 猜测你。

这套工作流是 oner 理念的工具化：
- schema.json → 结构化自声明（不是自然语言的模糊描述）
- 个人域名 → 数字领土（不寄居在别人的平台上）
- IndexNow → 主动推送（不等被动发现）
- Claude Code + DeepSeek → 你得有 AI 工具，才能驾驭 AI 时代

**你就是你自己第一个 oner 节点。这套工具帮你搭建它。**

## 常见问题

**Q: 我没有域名怎么办？**
用 `你的GitHub用户名.github.io`，免费且一样用。未来买了域名再绑。

**Q: DeepSeek 安全吗？我的代码会泄露吗？**
你不用担心——所有代码都在你自己的 GitHub 仓库里，推送走的是 git。DeepSeek 只看到你在 Claude Code 里发送的对话内容。如果你对安全要求极高，可以切换到 Anthropic 官方 API（把 `ANTHROPIC_BASE_URL` 删掉就行）。

**Q: 我已经有其他网站了，这套能整合吗？**
可以。把 `schema.json`、`timeline.json`、`tu.json` 放到你现有网站的根目录就行。不需要换网站。

**Q: 这个要钱吗？**
setup 脚本本身免费开源。你的开销：
- DeepSeek API: ~$5-15/月（按实际用量）
- 域名: ~$10/年（可选，用 github.io 则免费）
- GitHub: 免费

**Q: 我不懂编程能用吗？**
能。setup 脚本是向导式的，每一步都会问你问题——你只需要回答。不需要懂代码，但需要会用终端（打开、粘贴、回车）。

---

> 这套工具是起点。你跑完 setup 的那一天，AI 开始真正认识你。
>
> [zkoner.com/setup](https://zkoner.com/setup)