yueqian-ai
106 lines
6.2 KiB
Markdown
106 lines
6.2 KiB
Markdown
# 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/`），执行深度研究时会用到。
|