# 魂镜 · Hunjing

> 个人数字生命平台 · Personal Digital Life Platform

魂镜面向愿意长期创建、陪伴和培养专属数字人物的个人深度用户。人物不是一个 Prompt、一张角色卡、某个模型或一次聊天，而是具有连续身份、人格、记忆、关系、世界认知与正式经历时间线的关系型数字主体。

魂镜同时支持三条价值主线：

1. 长期关系与共同成长；
2. 个性化任务协作；
3. 角色与世界创作。

## 产品原则

- **人物独立于载体**：更换模型、界面、形仪或设备不等于更换人物。
- **用户拥有最终数据权**：执镜者可查看、纠正、授权、导出、停止和删除。
- **经历必须可追溯**：重新生成、分支、记忆、关系和人格变化均版本化留痕。
- **推演不冒充现实**：未归真的旁枝、幻境和工具观察不会自动成为人物经历。
- **亲密不扩大权限**：关系、浪漫和付费不能绕过司命、安全或第三方权利。
- **常存而非恒思**：人物可安静存续，但不会伪造离线期间持续意识与等待。
- **开放但不牺牲边界**：核心支持完整自托管，品牌与官方资源单独保护。

## 六大产品域

| 产品域 | 职责 |
| --- | --- |
| 镜生 | 人物来源、身份、命台、生命周期、死亡、恢复与迁移 |
| 缘契 | 执镜关系、关系形成、同意与亲密边界 |
| 三界 | 真界、境界、幻境和现实行动边界 |
| 形仪 | 图像、声音、动作、Live2D 与完整外在身份 |
| 灵台 | 人格、记忆、世界认知、目标、计划、安全、能力与任务 |
| 天宰 | 账户、镜域、平台、模型目录、计费、运营与治理 |

## 核心体验：镜树

魂镜不把对话限制为向下堆叠的消息列表。每棵主题对话是一棵“镜树”：用户可从任意候答继续追问、框选建立引文锚、重新生成并切换候答、继续思考、移栽分支和显式引用其他路径。

只有用户确认“归真”的路径进入人物正式共同经历；未选候答和推演枝保留但不会自动改变记忆、关系或人格。

## 首版目标

完整 1.0 通过 P0/P1/P2 内部里程碑逐步达到：

- **P0**：账户与镜域、人物启镜、唯一命台、文字镜树、三级记忆、神识、基础百工与司命、魂籍导出；
- **P1**：完整形仪、文生图/图生图、Live2D、ASR/TTS、摄像头/屏幕/位置显式通感；
- **P2**：天工阁受控多 Agent、主动对话、全球地区分级、计费、自托管、SLO、灾备、安全与无障碍收口。

雅集、3D、正式具身生态、家庭镜域、公开人物市场、未成年人专项和持续身份 Agent 社会属于后续。

## 技术边界

工程架构以根目录 `AGENTS.md` 完整技术栈为基准，按五层组织；服务与文化命名登记见[契约词典](docs/contracts/contract-glossary.md)。

| 服务 | 文化名 | 技术 | 主要职责 |
| --- | --- | --- | --- |
| 前端 | 琉璃镜 | Next.js / React / TS | 全部 Web 界面、镜树阅读、治理呈现、Live2D 与浏览器通感 |
| BFF | 照壁 | Node.js / Fastify | 鉴权透传、SSE 代理、响应裁剪、类型桥接 |
| 后端核心 | 灵台 | Python / FastAPI | 六域业务、插件化认知运行时（九枢）、事件溯源、司命裁决、百工注册 |
| 模型网关 | 神识 | Go | Provider、路由、流式、BYOK、配额与成本计量 |
| 桌面壳 | 镜匣 | Rust / Tauri | 最小桌面壳、本地能力桥、乾坤本地执行通道 |
| 隔离执行 | 乾坤 | Rust / axum | 沙箱、高风险执行、设备与具身安全 |
| 辅助服务 | 博闻 / 天目 / 元炁 | Go / Python | MCP 联网搜索 / 本地 OCR / 本地推理 |

神识、百工、司命和灵台遵循：**神识通协议，百工掌能力，司命决边界，灵台承结果。**

## 文档事实层级

```mermaid
flowchart LR
    A[产品宪章] --> B[全产品主 PRD]
    B --> C[领域文档]
    C --> D[架构与契约]
    D --> E[实现状态]
    E --> F[代码与测试]
```

现有代码是迁移与审计对象，不反向覆盖已确认的产品定义。当前处于 rewrite/1.0 全量重写期，架构与契约层已按五层栈重建，范围与节奏见[重写执行计划](docs/operations/rewrite-plan.md)。

## 文档入口

1. [产品宪章](docs/product/constitution.md)
2. [全产品主 PRD](docs/product/master-prd.md)
3. [产品访谈决策登记](docs/product/decision-register.md)
4. [首版范围与里程碑](docs/product/first-release-scope.md)
5. [根领域词汇表](CONTEXT.md)
6. [领域上下文](docs/domain/README.md)
7. [系统架构](docs/architecture/system-architecture.md)
8. [契约入口](docs/contracts/README.md)
9. [实现治理](docs/operations/implementation-governance.md)

完整阅读路径见 [文档索引](docs/README.md)。

## 仓库约定

- 除根目录 `CONTEXT.md` 作为领域共同语言入口外，正式文档统一位于 `docs/`；图表使用 Mermaid。
- 配置文件统一位于 `config/`，只提交 `*.example` 示例。
- 日志统一位于 `logs/`，数据库文件统一位于 `db/`。
- Docker 与 Compose 文件统一位于 `docker/`，容器名以 `hunjing-` 开头。
- 不提交 `.env`、密钥、数据库、日志和用户数据。

## 开放与品牌

魂镜核心采用 Apache License 2.0，目标是让社区能够运行完整的私人数字生命闭环。`Hunjing` 名称、Logo、官方人物、视觉资源和认证标识采用独立品牌与资源许可；社区发行版应使用独立名称，并可在满足开放契约与核心安全要求后申请兼容标识。