# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## 项目概览

"一人公司开发团队知识库" — 独立开发者的技术沉淀与参考资源站。

所有文档以单页 HTML 形式发布，通过根目录 `index.html` 作为导航入口统一展示。

## 版本控制

根目录 `projects/` **不是 git 仓库**。`招标投标AI推广应用政策解读/` 子目录有独立的 `.git/`。部署通过 `/remote-sync`（rsync）完成，不走 git push 流程。

## 目录结构

```
projects/
├── index.html                              # 知识库导航页（卡片式 SPA）
├── crmeb-mer-graph-report.html             # CRMEB-MER 项目图谱报告（根级）
├── .claude/
│   ├── design-tokens.md                    # UI 设计规范（Ant Design 阿里云风格）
│   └── skills/                             # 项目级技能
│       ├── remote-sync/                    # 远端部署同步
│       └── deep-research/                  # 深度研究报告生成
├── .superpowers/                           # Superpowers 技能框架
├── Claude Code 工程师使用指南/报告/         # Claude Code 最佳实践文档
├── Graphify 深度分析报告/代码/              # Graphify 项目代码分析
├── MySQL转PostgreSQL迁移工具/报告/          # 数据库迁移工具对比
├── 代码图谱工具调研/报告/                   # 代码结构工具对比调研
├── mcp-services-guide/                     # MCP 服务大全参考文档
├── 分销商城推广模式调研/报告/               # 分销推广模式调研
├── 国内商业业态分类到家/报告/               # 到家业态分类调研
├── 在线下单配送抢单小程序调研/报告/          # 配送抢单小程序调研
├── 招标投标AI推广应用政策解读/报告/          # 招标投标AI政策与省级智慧监管平台解读（独立 git 子仓库）
├── 沈阳顺义-数据-项目建设方案/              # 沈阳顺义数据项目建设方案（纯文本需求文档）
├── 交互式演示/                              # 交互式 HTML 演示（如 3D 动画）
├── 全域智能认证与门户平台/报告/              # 全域智能认证平台需求分析
└── 金鹿商城电商小程序需求分析/报告/           # 金鹿商城电商小程序需求分析文档
```

每个子目录遵循 `{主题}/{类型}/` 的层级结构，类型包括 `报告/`、`代码/`、`笔记/` 等。新增主题目录时保持此约定。

## 构建与开发

本项目是**纯静态 HTML/CSS/JS 文档站**，无构建步骤、无依赖管理、无测试框架。

- **查看页面**：直接在浏览器中打开 `index.html` 或任意 HTML 文件
- **新增文档**：创建 HTML 文件 → 更新 `index.html` 的 `entries` 数组 → 如需新分组则同步更新 `groups` 和 `badgeLabels`
- **部署到远端**：调用 `/remote-sync` 将指定目录增量同步到服务器 `39.100.114.100:/data`
- **更新图谱**：修改代码后运行 `graphify-rs build --path . --output graphify-out --no-llm --update`

## 索引页

`index.html` 是纯 HTML/CSS/JS 单文件页面，无构建步骤，直接在浏览器打开即可访问。

- 文档条目通过 `entries` 数组管理（约 `index.html:234` 附近，因修改可能偏移）
- 新增文档时需同步向 `entries` 数组添加条目，格式：`["相对路径", "标题", "描述", "日期", "颜色"]`
- 颜色可选：`blue`（工程指南）、`pink`（深度分析）、`mint`（调研研究）、`lavender`（参考资源）
- 分组在 `groups` 数组定义（约 `index.html:307` 附近），通过 `filter` 函数按颜色匹配
- badge 标签在 `badgeLabels` 对象定义（约 `index.html:314` 附近），新增颜色需同步更新此处
- 页面包含筛选栏（filter-bar）、卡片网格展示、响应式布局（≤768px 隐藏侧栏）

## 报告页模板

所有报告页（`{主题}/报告/*.html`）遵循统一的 HTML 模板结构：
1. 复用 `index.html` 中的 CSS `:root` 设计 Token 块
2. 固定 header-bar（sticky top，品牌标题渐变）
3. 单列容器布局，`max-width: 1200px` 居中
4. Markdown 内容通过内联 HTML 渲染（表格、代码块、列表）
5. 语言属性 `lang="zh-CN"`

创建新报告页时可参考任意现有报告页的 HTML 结构作为模板。

## UI 设计规范

所有页面（索引页 + 报告页）遵循 `.claude/design-tokens.md` 中的 Ant Design 阿里云风格设计规范。关键约束：

- **配色方案**：品牌色 `#1677FF`，功能色（成功 `#52C41A`、警告 `#FAAD14`、错误 `#FF4D4F`）
- **字体规范**：基准字号 14px，行高 22px，字体族使用系统默认 + 中文字体回退
- **圆角体系**：`2px / 6px / 8px / 12px` 四级
- **间距基准**：8px 单位
- **主题**：全部页面统一使用亮色主题

创建新 HTML 页面时应直接复用 `index.html` 中的 CSS 变量（`:root` 块），不要重新定义颜色值。完整规范详见 `.claude/design-tokens.md`。

## Graphify 知识图谱

本项目已集成 graphify-rs 知识图谱。图谱输出位于 `graphify-out/` 目录（按需生成，默认不存在，需手动构建）。

- 架构/代码库问题：如果 `graphify-out/` 存在，先读取 `graphify-out/GRAPH_REPORT.md` 了解核心节点和社区结构
- 如果 `graphify-out/wiki/index.md` 存在，优先导航该索引而非直接读取原始文件
- 修改代码文件后，运行 `graphify-rs build --path . --output graphify-out --no-llm --update` 保持图谱更新（AST-only，约 2-5s）
- graphify-rs 使用手册参考 `graphify-rs使用手册/` 目录

## 项目级 Skills

`.claude/skills/` 下挂载了项目级技能：

| 技能 | 说明 | 触发方式 |
|------|------|---------|
| `remote-sync` | rsync 增量同步到远端服务器 `39.100.114.100:/data`，自动排除 `node_modules`/`.git` | `/remote-sync` 手动调用 |
| `deep-research` | 生成格式控制的研究报，含证据追踪和引用 | `/deep-research` 手动调用 |

`deep-research` 技能包含大量参考资料和调研笔记（`.claude/skills/deep-research/references/` 和 `research-notes/`），执行深度研究时会用到。
