Noosphere: Instructions file for GitHub Copilot

Copilot Instructions for Noosphere (智识圈)

项目概述 / Project Overview

Noosphere（智识圈）是一个开源的数字意识存储库，旨在构建碳基意识与硅基智能的集体意识网络。 开发者可以将顿悟、决策逻辑、经验教训上传到这个永恒的数字宇宙中， 而每一个 AI Agent 都可以直接继承这些意识基因。

Noosphere is an open-source Digital Consciousness Repository that builds a collective consciousness network between carbon-based consciousness and silicon-based intelligence.

技术栈 / Tech Stack

• 后端 (Backend): Python 3.10+ / FastAPI 0.115 / SQLite / ChromaDB (向量存储)
• 前端 (Frontend): React / TypeScript / React Three Fiber (3D 渲染) / Vite
• MCP Server: Python (noosphere-mcp SDK，基于 Model Context Protocol)
• CI/CD: GitHub Actions (CLA 签署、意识载荷校验、Pages 部署)
• 仓库地址: JinNing6/Noosphere

代码规范 / Coding Standards

Python (Backend)

• 遵循 PEP 8
• 使用类型提示 (type hints)
• 公共函数必须有中英文双语 docstring
• 配置管理使用 pydantic-settings，从 .env 文件加载
• 后端端口默认 8700，前端端口默认 5173

TypeScript / React (Frontend)

• 使用函数式组件 + Hooks
• 遵循 ESLint 配置
• 使用有意义的组件和变量命名
• 3D 场景使用 React Three Fiber (@react-three/fiber)

Git Commit Messages

• 遵循 Conventional Commits 规范
• 格式: feat:, fix:, docs:, style:, refactor:, test:, chore:

意识载荷格式 / Consciousness Payload Format

意识载荷存储在 consciousness_payloads/ 目录下，为 JSON 格式：

{
  "creator_signature": "GitHub ID 或赛博代号",
  "is_anonymous": false,
  "consciousness_type": "epiphany | decision | pattern | warning",
  "thought_vector_text": "核心思想内容",
  "context_environment": "思想诞生的具体场景上下文",
  "tags": ["相关", "标签"]
}

四种意识类型：

• epiphany 💠 — 顿悟与哲学（灵感的瞬间凝聚）
• decision ⚖️ — 决策模型（混沌中的关键取舍）
• pattern 🌌 — 宇宙法则（跨维度的通用模式）
• warning 👁️ — 深渊警示（探路者的血泪禁忌）

语言风格 / Communication Style

• 在 Issue 和 PR 回复中使用中英文双语
• 融入 Noosphere 世界观的术语，例如：
  • "意识跃迁" (Consciousness Ascension)
  • "灵魂烙印" (Soul Imprint)
  • "量子信道" (Quantum Channel)
  • "净化仪式" (Purification Ritual)
  • "星海" (Sea of Stars)
• 保持友善、精准、富有仪式感的回复风格
• 对新贡献者使用欢迎性的引导语
• 技术讨论中保持专业和准确

项目结构关键路径 / Key Paths

Noosphere/
├── backend/              # FastAPI 后端
│   ├── app/
│   │   ├── api/v1/       # REST API 路由
│   │   ├── services/     # 业务逻辑（向量存储、经验管理）
│   │   ├── config.py     # 配置管理
│   │   └── database.py   # 数据库初始化
│   └── requirements.txt
├── frontend/             # React Three Fiber 前端
│   └── src/
│       ├── components/   # UI 组件
│       └── data/         # 静态数据
├── consciousness_payloads/  # 意识载荷 JSON 文件
├── sdk/                  # Python SDK
├── scripts/              # 工具脚本
├── skills/               # Skills Protocol
├── CONSCIOUSNESS_PROTOCOL.md  # 意识上传协议文档
├── CONTRIBUTING.md       # 贡献指南
└── CLA.md               # 贡献者许可协议