hunjing/README.md

魂镜 · 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 社会属于后续。

技术边界

服务	技术	主要职责
灵台	Python	人物、镜树、人格、记忆、缘契、三界与认知编排
神识	Go	Provider、Endpoint、模型路由、流式、BYOK、配额与成本
乾坤	Rust	沙箱、高风险执行、设备与具身安全
琉璃镜	TypeScript / Next.js	全部 Web 用户界面、Live2D 与浏览器通感

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

文档事实层级

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

现有代码是迁移与审计对象，不反向覆盖已确认的产品定义。

文档入口

1. 产品宪章
2. 全产品主 PRD
3. 产品访谈决策登记
4. 首版范围与里程碑
5. 根领域词汇表
6. 领域上下文
7. 系统架构
8. 契约入口
9. 实现治理

完整阅读路径见 文档索引。

仓库约定

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

开放与品牌

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