chenxin
2483a25f63
- 镜匣 desktop/（Tauri v2 最小壳）：WebView 承载琉璃镜（frontend/out 或 devUrl）；能力桥最小命令（通知）；乾坤通道 HMAC 短期凭证构造（与 sandbox/src/auth.rs 验签同算法，密钥仅经 SANDBOX_AUTH_SECRET 环境注入——二进制零平台密钥，静态审计钉死）；hard_stop/resume 本地硬急停原子断路（全部通道命令过 ensure_not_halted，本地最高优先级不经云端）；tantivy 依赖与 capabilities/ 目录预留；updater 插件位预留；cargo check 通过 - 器谱域 domains/tianzai（迁移 010）：devices/device_grants——一次配对（密钥指纹登记）、逐项授契（可授面显式枚举，未知能力键拒）、撤回立即生效、设备撤销连带全部授契失效且不可再授；/devices 器谱 API 组 - 发布收口：release-evidence.md 落位重写期 RW-* 证据包（M0–M9 十里程碑验收自动化套件与结果物）；能力矩阵 M9 行收官；rewrite-plan.md 按计划删除（M0–M9 全部完成，能力矩阵与证据台账接棒），全库引用清理 - 验收（test_m9_jingxia 四用例）：器谱未授契 403 留痕/撤回即效/设备撤销连带；镜匣零平台密钥（rg 审计源码与配置为空）；硬急停语义钉死（通道命令全检查+resume 唯一恢复+HMAC 无密钥不出凭证） - 五套件终检全绿：后端 349、前端 203、BFF 4、神识 5 包、镜匣 cargo check（2 个预存环境失败历次 HEAD 复验与本周期无关）；Compose nginx profile 配置校验通过
104 lines
5.5 KiB
Markdown
104 lines
5.5 KiB
Markdown
# 魂镜 · 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 全量重写期，架构与契约层已按五层栈重建，范围与节奏见重写执行计划（已收口删除）。
|
|
|
|
## 文档入口
|
|
|
|
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、官方人物、视觉资源和认证标识采用独立品牌与资源许可；社区发行版应使用独立名称，并可在满足开放契约与核心安全要求后申请兼容标识。
|