CLAUDE.md

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

项目概述

knowknowcc（看懂Claude Code） 是一个 Claude Code 中文知识体系，不是功能手册，而是精心设计的学习体系。

版本: v4.0.0 | 跟踪官方: Claude Code v2.1.156 | 状态: 100% 完成

核心哲学

1. 少即是多 - 精选20%最核心内容，解决80%使用场景
2. 深度胜过广度 - 每个概念都讲透，原理+实践+案例
3. 由浅入深 - Level 1/2/3 三级体系
4. 实战导向 - 真实案例和解决方案
5. Windows优先 - 100%支持，每个功能都有Windows章节

架构

KnowKnowCC/
├── guide/              ← Level 1: 核心掌握 (7个文档，含README)
├── advanced/           ← Level 2: 进阶提升 (30个文档)
│   ├── a-productivity/     生产力提升 (9)
│   ├── b-code-quality/     代码质量 (5)
│   ├── c-integration/      集成扩展 (7)
│   ├── d-skills-development/ Skills开发 (5)
│   └── 其他专题文档 (4)
├── master/             ← Level 3: 专家之道 (20个文档)
│   ├── 01-customization/   定制化 (7)
│   ├── 02-automation/      自动化 (5)
│   ├── 03-advanced-topics/ 高级主题 (5)
│   └── 04-source-analysis/ 源码分析 (2)
├── windows/            ← Windows 专属 (5个文档，含README)
├── reference/          ← 快速参考 (4个文档，含README)
└── reports/            ← 审核报告 (14个文档)

总计: ~90个md文件, ~890,000字

内容创建标准

五维质量标准

文件命名

格式: XX-<descriptive-name>.md

✅ 01-plan-mode.md, 02-session-management.md
❌ feature1.md, PlanMode.md

路径处理

# 文档链接 - 使用相对路径
[快速上手](../guide/01-quickstart.md)  ✅

# Windows路径 - 使用正斜杠
cd "D:/Projects/MyApp"  ✅
cd "D:\\Projects\\MyApp"  ⚠️ 备选
cd "D:\Projects\MyApp"  ❌ 避免单反斜杠

代码块标记

正确标记语言: powershell, bash, typescript, json, markdown

关键配置

• Git远程: https://github.com/chenjh06/KnowKnowCC.git (HTTPS，非SSH)
• 默认分支: main
• 内存文件: C:\Users\cjh\.claude\projects\D--AIWork-claude-code-work-knowknowcc\MEMORY.md

相关文件

AI 协作配置

本节记录此项目继承的全局 AI 配置（~/.claude/CLAUDE.md）

Skills 使用原则

原则: 任务开始前评估 Skill 适用性。流程类(调试/计划)优先于实现类。

MCP 工具选择

搜索

• open-websearch - Bing/DDG/Brave 免费，首选
• web-search-prime - 智谱免费，中文优化
• tavily / exa - 付费深度搜索

抓取

• web-reader-local - 免费 URL 转 Markdown
• context7 - 免费官方库文档
• mcp-deepwiki / zread - GitHub 仓库文档

浏览器

• Playwright - 本地标准浏览器
• stealth-browser - 反检测，Cloudflare/登录态

代码

• serena - IDE 级符号分析
• spec-workflow - 规格驱动开发

工作流程

探索 → 计划 → 实现
  ↓        ↓        ↓
Grep/Glob  Plan    Edit/Write

上下文管理:

• 50% 时提醒 /compact
• 切换任务提醒 /clear

快速参考

联网 → web-access (统一入口)
搜索 → open-websearch → tavily
抓取 → web-reader-local
文档 → context7
GitHub → mcp-deepwiki / zread
浏览器 → Playwright → stealth-browser
重构 → serena
图像 → zai-mcp-server

Web搜索策略

1. open-websearch (90%): 免费，Bing/DDG/Brave，广度探索
2. Exa/Tavily (10%): 付费，深度研究和语义理解

语言: 灵活选择中英文，可并行搜索

最后更新: 2026-05-30 (v4.0.0)