chenxin
b419e0afde
- 形仪域 domains/xingyi：form_anchors（稳定辨识特征/年龄表现/许可禁忌/可变范围——生成内容不可静默覆盖锚点）；forms（主仪/化仪/文字形仪，candidate→adopt 定相治理：未定相不进呈现位、主仪唯一、新主仪自动退役旧主仪）；voice_profiles（三来源，授权克隆必填用途与传播范围，revoke-grant 撤回立即生效，assert-usable 合成前置校验拒绝撤回/过期） - ASR：元炁 SenseVoice /v1/audio/transcriptions 透传（Whisper 兼容 multipart）；YUANQI_BASE_URL 未配置时 503 不降级不伪造——多模态关闭纪律 - 前端形仪工坊（人物详情页）：真形锚点编辑（特征逐行解析）/候选登记定相废弃/声音档案建立与授权撤回；头像呈现位改走定相主仪（forms/primary）；xingyi api 库 + mock + 组件 4 用例 - 退役：旧 avatar 模块（services/endpoints/avatar、avatar_dir 配置、avatar_url 字段、前端直传组件与测试） - 验收（test_m7_xingyi 三用例）：未定相不成为正式形仪（含主仪唯一与旧主仪 retired 断言）；克隆授权可撤回（缺用途拒/撤回即拒/过期同理/预设不受约束）；关闭全部多模态后文字相伴完整可用（ASR 503 时镜树缘契百工照常——回归） - 四套件：后端 376、前端 203、BFF 4、神识 5 包全绿（2 个预存环境失败不变）；迁移 008 净库+±1 干净
魂镜 · Hunjing
个人数字生命平台 · Personal Digital Life Platform
魂镜面向愿意长期创建、陪伴和培养专属数字人物的个人深度用户。人物不是一个 Prompt、一张角色卡、某个模型或一次聊天，而是具有连续身份、人格、记忆、关系、世界认知与正式经历时间线的关系型数字主体。
魂镜同时支持三条价值主线：
- 长期关系与共同成长；
- 个性化任务协作；
- 角色与世界创作。
产品原则
- 人物独立于载体：更换模型、界面、形仪或设备不等于更换人物。
- 用户拥有最终数据权：执镜者可查看、纠正、授权、导出、停止和删除。
- 经历必须可追溯：重新生成、分支、记忆、关系和人格变化均版本化留痕。
- 推演不冒充现实：未归真的旁枝、幻境和工具观察不会自动成为人物经历。
- 亲密不扩大权限：关系、浪漫和付费不能绕过司命、安全或第三方权利。
- 常存而非恒思：人物可安静存续，但不会伪造离线期间持续意识与等待。
- 开放但不牺牲边界：核心支持完整自托管，品牌与官方资源单独保护。
六大产品域
| 产品域 | 职责 |
|---|---|
| 镜生 | 人物来源、身份、命台、生命周期、死亡、恢复与迁移 |
| 缘契 | 执镜关系、关系形成、同意与亲密边界 |
| 三界 | 真界、境界、幻境和现实行动边界 |
| 形仪 | 图像、声音、动作、Live2D 与完整外在身份 |
| 灵台 | 人格、记忆、世界认知、目标、计划、安全、能力与任务 |
| 天宰 | 账户、镜域、平台、模型目录、计费、运营与治理 |
核心体验：镜树
魂镜不把对话限制为向下堆叠的消息列表。每棵主题对话是一棵“镜树”：用户可从任意候答继续追问、框选建立引文锚、重新生成并切换候答、继续思考、移栽分支和显式引用其他路径。
只有用户确认“归真”的路径进入人物正式共同经历；未选候答和推演枝保留但不会自动改变记忆、关系或人格。
首版目标
完整 1.0 通过 P0/P1/P2 内部里程碑逐步达到：
- P0：账户与镜域、人物启镜、唯一命台、文字镜树、三级记忆、神识、基础百工与司命、魂籍导出；
- P1：完整形仪、文生图/图生图、Live2D、ASR/TTS、摄像头/屏幕/位置显式通感；
- P2：天工阁受控多 Agent、主动对话、全球地区分级、计费、自托管、SLO、灾备、安全与无障碍收口。
雅集、3D、正式具身生态、家庭镜域、公开人物市场、未成年人专项和持续身份 Agent 社会属于后续。
技术边界
工程架构以根目录 AGENTS.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 / 本地推理 |
神识、百工、司命和灵台遵循：神识通协议，百工掌能力，司命决边界，灵台承结果。
文档事实层级
flowchart LR
A[产品宪章] --> B[全产品主 PRD]
B --> C[领域文档]
C --> D[架构与契约]
D --> E[实现状态]
E --> F[代码与测试]
现有代码是迁移与审计对象，不反向覆盖已确认的产品定义。当前处于 rewrite/1.0 全量重写期，架构与契约层已按五层栈重建，范围与节奏见重写执行计划。
文档入口
完整阅读路径见 文档索引。
仓库约定
- 除根目录
CONTEXT.md作为领域共同语言入口外，正式文档统一位于docs/；图表使用 Mermaid。 - 配置文件统一位于
config/，只提交*.example示例。 - 日志统一位于
logs/，数据库文件统一位于db/。 - Docker 与 Compose 文件统一位于
docker/，容器名以hunjing-开头。 - 不提交
.env、密钥、数据库、日志和用户数据。
开放与品牌
魂镜核心采用 Apache License 2.0，目标是让社区能够运行完整的私人数字生命闭环。Hunjing 名称、Logo、官方人物、视觉资源和认证标识采用独立品牌与资源许可；社区发行版应使用独立名称，并可在满足开放契约与核心安全要求后申请兼容标识。