魂镜 · Hunjing
个人数字生命平台 · Personal Digital Life Platform
魂镜面向愿意长期创建、陪伴和培养专属数字人物的个人深度用户。人物不是一个 Prompt、一张角色卡、某个模型或一次聊天，而是具有连续身份、人格、记忆、关系、世界认知与正式经历时间线的关系型数字主体。
魂镜同时支持三条价值主线：
- 长期关系与共同成长；
- 个性化任务协作；
- 角色与世界创作。
产品原则
- 人物独立于载体：更换模型、界面、形仪或设备不等于更换人物。
- 用户拥有最终数据权：执镜者可查看、纠正、授权、导出、停止和删除。
- 经历必须可追溯：重新生成、分支、记忆、关系和人格变化均版本化留痕。
- 推演不冒充现实：未归真的旁枝、幻境和工具观察不会自动成为人物经历。
- 亲密不扩大权限：关系、浪漫和付费不能绕过司命、安全或第三方权利。
- 常存而非恒思：人物可安静存续，但不会伪造离线期间持续意识与等待。
- 开放但不牺牲边界：核心支持完整自托管，品牌与官方资源单独保护。
六大产品域
| 产品域 | 职责 |
|---|---|
| 镜生 | 人物来源、身份、命台、生命周期、死亡、恢复与迁移 |
| 缘契 | 执镜关系、关系形成、同意与亲密边界 |
| 三界 | 真界、境界、幻境和现实行动边界 |
| 形仪 | 图像、声音、动作、Live2D 与完整外在身份 |
| 灵台 | 人格、记忆、世界认知、目标、计划、安全、能力与任务 |
| 天宰 | 账户、镜域、平台、模型目录、计费、运营与治理 |
核心体验：镜树
魂镜不把对话限制为向下堆叠的消息列表。每棵主题对话是一棵“镜树”：用户可从任意候答继续追问、框选建立引文锚、重新生成并切换候答、继续思考、移栽分支和显式引用其他路径。
只有用户确认“归真”的路径进入人物正式共同经历；未选候答和推演枝保留但不会自动改变记忆、关系或人格。
首版目标
完整 1.0 通过 P0/P1/P2 内部里程碑逐步达到：
- P0：账户与镜域、人物启镜、唯一命台、文字镜树、三级记忆、神识、基础百工与司命、魂籍导出；
- P1：完整形仪、文生图/图生图、Live2D、ASR/TTS、摄像头/屏幕/位置显式通感；
- P2：天工阁受控多 Agent、主动对话、全球地区分级、计费、自托管、SLO、灾备、安全与无障碍收口。
雅集、3D、正式具身生态、家庭镜域、公开人物市场、未成年人专项和持续身份 Agent 社会属于后续。
技术边界
| 服务 | 技术 | 主要职责 |
|---|---|---|
| 灵台 | Python | 人物、镜树、人格、记忆、缘契、三界与认知编排 |
| 神识 | Go | Provider、Endpoint、模型路由、流式、BYOK、配额与成本 |
| 乾坤 | Rust | 沙箱、高风险执行、设备与具身安全 |
| 琉璃镜 | TypeScript / Next.js | 全部 Web 用户界面、Live2D 与浏览器通感 |
神识、百工、司命和灵台遵循：神识通协议，百工掌能力，司命决边界，灵台承结果。
文档事实层级
flowchart LR
A[产品宪章] --> B[全产品主 PRD]
B --> C[领域文档]
C --> D[架构与契约]
D --> E[实现状态]
E --> F[代码与测试]
现有代码是迁移与审计对象，不反向覆盖已确认的产品定义。
文档入口
完整阅读路径见 文档索引。
仓库约定
- 除根目录
CONTEXT.md作为领域共同语言入口外，正式文档统一位于docs/；图表使用 Mermaid。 - 配置文件统一位于
config/，只提交*.example示例。 - 日志统一位于
logs/，数据库文件统一位于db/。 - Docker 与 Compose 文件统一位于
docker/，容器名以hunjing-开头。 - 不提交
.env、密钥、数据库、日志和用户数据。
开放与品牌
魂镜核心采用 Apache License 2.0，目标是让社区能够运行完整的私人数字生命闭环。Hunjing 名称、Logo、官方人物、视觉资源和认证标识采用独立品牌与资源许可；社区发行版应使用独立名称，并可在满足开放契约与核心安全要求后申请兼容标识。