init: 导入团队知识库内容

2026-05-14 16:56:48 +08:00
commit acca2041f0
1681 changed files with 285734 additions and 0 deletions
@@ -0,0 +1,105 @@
+# 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/`），执行深度研究时会用到。