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 模板结构：

复用 index.html 中的 CSS :root 设计 Token 块
固定 header-bar（sticky top，品牌标题渐变）
单列容器布局，max-width: 1200px 居中
Markdown 内容通过内联 HTML 渲染（表格、代码块、列表）
语言属性 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/），执行深度研究时会用到。

6.2 KiB Raw Permalink Blame History Unescape Escape