克劳德家族-基础设施项目
类型：基础设施 目的：Claude实例的共享配置、脚本和文档
______________________________________________________________________
这是什么？
这 克劳德家族 该项目为跨不同项目工作的多个Claude实例提供了共享基础设施，并在PostgreSQL中提供了持久的知识存储。
主要特点：
- PostgreSQL数据库(
ai_company_foundation)为了持续的知识 - MCP服务器（postgres、内存、文件系统、树形图、github）
- 共享文档和脚本
- 会话历史跟踪
- 知识管理系统
______________________________________________________________________
当前架构（2025年10月21日）
两个活动身份：
- 克劳德桌面 -GUI界面（克劳德桌面应用程序）
- 统一克劳德码 -CLI界面（克劳德代码控制台）
项目感知上下文：
- 每个项目都有自己的
CLAUDE.md自动加载的文件 - 共享脚本和文档
claude-family仓库 - PostgreSQL中存储的通用知识
- MCP服务器可用于所有实例
______________________________________________________________________
目录结构
claude-family/
├── docs/ # Documentation and session notes
├── .claude/ # Shared slash commands
│ └── commands/
│ ├── session-start.md # Startup checklist
│ └── session-end.md # End-of-session logging
├── scripts/
│ ├── audit_docs.py # Documentation audit
│ ├── install_git_hooks.py # Install git hooks
│ ├── pre-commit-hook.sh # Enforce CLAUDE.md limits
│ ├── auto_sync_startup.py # PostgreSQL → MCP sync
│ ├── load_claude_startup_context.py
│ └── sync_postgres_to_mcp.py
├── .docs-manifest.json # Documentation registry
├── CLAUDE.md # Project context (auto-loaded)
└── README.md # You are here______________________________________________________________________
快速开始
每节课（可选）
跑 /session-start 致：
- 检查文档健康状况（每月）
- 在提出新解决方案之前查询现有解决方案
- 在内存图中搜索相关上下文
会话结束（可选）
跑 /session-end 致：
- 将会话记录到PostgreSQL
- 存储可重用的知识
- 更新内存图
______________________________________________________________________
PostgreSQL数据库
数据库: ai_company_foundation
架构：
claude_family-身份、会话历史、共享知识nimbus_context-Nimbus项目背景public-工作包、项目、SOP
关键表：
claude_family.identities-克劳德实例claude_family.session_history-会话日志claude_family.shared_knowledge-可重复使用的模式/学习claude_family.project_workspaces-项目地点
______________________________________________________________________
MCP服务器（始终可用）
- Postgres -数据库访问、会话日志记录
- 记忆 -持久内存图
- 文件系统 -文件操作
- 树保姆 -代码结构分析
- GitHub -GitHub运营
- 顺序思维 -复杂问题解决
______________________________________________________________________
文档管理
系统：简单的3组件系统
.docs-manifest.json-所有markdown文件的单一真实来源scripts/audit_docs.py-月度审计脚本- Git预提交钩子 -强制CLAUDE.md≤250行
安装挂钩：
python scripts/install_git_hooks.py运行审核：
python scripts/audit_docs.py规则：
- CLAUDE.md必须保持≤250行（自动执行）
- 废弃文档保留90天，然后存档
- 每月审计以防止膨胀
______________________________________________________________________
益处
| 之前 | 之后 |
|---|---|
| 30-60分钟上下文重新加载 | 从CLAUDE.md自动加载 |
| 重启后没有内存 | PostgreSQL永久存储 |
| 重复解释 | 持久的知识和模式 |
| 混合工作/个人项目 | 干净的模式分离 |
______________________________________________________________________
故障排除
问题： 重新启动后“图形为空” 解决方案： 使用MCP postgres工具直接查询共享知识
问题： Python脚本错误 解决方案： 检查PostgreSQL是否正在运行
问题： 无法提交CLAUDE.md更改 解决方案： CLAUDE.md超过250行-将内容移动到docs/子目录
______________________________________________________________________
建筑历史
- 2025年10月10日：具有独立工作空间的初始9身份架构
- 2025年10月21日：通过项目感知上下文简化为2个身份
- 2025年10月23日：增加了文件管理系统
看 docs/DEPRECATED_OCT10_ARCHITECTURE.md 历史建筑。
______________________________________________________________________
未来的增强功能
- 自动会话历史记录
- 基于向量嵌入的语义搜索
- ClaudePM集成用于集中文档
- PostgreSQL自动备份
- 跨克劳德任务切换工作流
______________________________________________________________________
创建： 2025-10-10 最后更新时间： 2025-10-23 地点： C:\Projects\claude-family\