0 Fork 0

Files

T

chenxin 42513d13c6 📝 docs: 建立魂镜完整 1.0 设计文档体系

- 产品层：产品宪章与永久禁域、产品定义、完整 1.0 范围与发布门、道家文化语言体系、指标与反指标
- 研究层：参考项目研究（deepseek-harness、pi、MemOS、模型网关）、灵台原生引擎研究（业界原生引擎架构理念与道家文化出处）
- 架构层：系统、Agent 运行时（周天体系）、插件系统、灵台引擎（C++ 双形态）、媒体与设备、社区协作市场、前端富内容渲染、数据、记忆与知识
- 契约层：协议与稳定标识、API 总体约定、Native API、兼容网关、实时与 Webhook、内部端口、统一 ContentBlock 与流式（含分支对话交互态）、灵台 C ABI 与 gRPC Service、API 表面、HTTP 与事件、运行观测
- 决策：ADR-001 至 ADR-023（模块化单体、每 attempt 持久化、候选记忆、OAuth 2.1、灵台引擎、双形态部署、大周天演化、宪章、三界作用域、私箧与保全态、叩心、周天统一等）
- 交付：WP-01 至 WP-15 实施 TODO 与设计阶段交接文档
- 工程：AGENTS.md 工程规则（含 C++/灵台规范）、CLAUDE.md 引用、.gitignore

2026-09-09 21:07:14 +08:00

5.1 KiB

Raw Blame History

社区、协作与市场架构

1. 领域边界

flowchart LR
  ID[Identity] --> COMMUNITY[Community]
  ID --> WORKSPACE[Collaboration]
  COMMUNITY --> CATALOG[Marketplace Catalog]
  WORKSPACE --> CATALOG
  CATALOG --> ORDER[Order]
  ORDER --> PAYMENT[Payment]
  PAYMENT --> LEDGER[Ledger and Settlement]
  COMMUNITY --> MOD[Moderation]
  CATALOG --> MOD
  PLUGIN[Plugin Registry] --> CATALOG
  CHARACTER[Character Releases] --> CATALOG

社区互动、协作权限、商品目录、订单支付和不可变账务分开建模。点赞数、销量、推荐分数不能成为支付账或许可事实源。

2. 社区

2.1 内容与互动

用户主页、关注关系和可见性；
动态、文章、图片、音视频和作品集合；
评论、回复、点赞、收藏、标签和分享；
搜索、话题、推荐流、趋势和通知；
屏蔽、静音、举报、审核、申诉和处置历史。

2.2 角色社区

角色、世界设定、知识库、工作流、Prompt、Live2D、3D、声音和插件都以发布版本进入社区：

草稿与已发布版本分离；
每版保存来源、作者、许可证、兼容版本和变更说明；
Fork 创建谱系边，不冒充原作者或同一角色身份；
下架阻止新分发，但既有许可副本按许可与安全处置规则处理；
角色私密记忆、关系和会话永不随公开角色版本发布。

3. 搜索与推荐

搜索索引是派生数据，可从公开内容和许可元数据重建。
推荐使用显式互动、内容特征和用户可控偏好；私密消息、敏感记忆、精确位置和诊断内容不作为特征。
用户可以查看主要推荐原因、关闭个性化和重置推荐数据。
反指标包括成瘾诱导、付费偏置未披露、未成年人不当内容和小创作者系统性不可见。

4. 内容治理

stateDiagram-v2
  [*] --> draft
  draft --> published
  published --> limited
  published --> removed
  limited --> published
  limited --> removed
  removed --> appealed
  appealed --> published
  appealed --> removed

Policy 覆盖：违法内容、现实人物冒充、声音/肖像许可、成人内容、骚扰、隐私、恶意插件、版权和交易欺诈。自动模型只能产生信号或临时限流，高影响永久处置需要可审阅规则和申诉。

5. 协作空间

Workspace 包含：

owner、admin、editor、reviewer、viewer 等 RBAC；
邀请、移除、权限变更和外部链接；
角色、世界、知识、工作流和资产的版本分支；
评审、评论、批准、合并和活动记录；
协同编辑 presence、乐观并发或 CRDT；
发布权限与市场上架权限分离。

协作者能编辑项目不等于能读取成员私密记忆、个人对话、支付账户或诊断内容。

6. 插件注册与分发

插件发布物包含 Manifest、包摘要、签名、权限、依赖、兼容版本、配置 Schema、隐私说明、源代码/许可证信息和安全扫描结果。

状态：draft → submitted → review → published → suspended/removed。更新产生新不可变版本；安全撤架可阻止安装和执行，但不能静默删除历史 Run 的 PluginSnapshot。

7. 市场商品与许可

商品类型：角色发布版、角色卡、世界设定、知识库、Prompt/工作流、Live2D、3D、声音、媒体包和插件。

每个 Listing 绑定：

seller 与可验证发布版本；
价格、货币、地区、税类和可售状态；
许可证、允许的用途、席位/设备范围、更新政策和退款政策；
审核状态、年龄分级、交付对象摘要和内容哈希。

订单成功创建 entitlement；下载 URL 只是短期交付方式，不是许可本身。

8. 支付、退款与账务

sequenceDiagram
  participant U as Buyer
  participant O as Order Service
  participant P as Payment Provider
  participant W as Webhook Consumer
  participant L as Ledger
  participant E as Entitlement

  U->>O: create order with idempotency key
  O->>P: create payment
  P-->>U: payment confirmation flow
  P-->>W: signed webhook
  W->>W: verify and deduplicate
  W->>L: append payment entries
  L->>E: grant entitlement
  E-->>U: deliver purchased version

金额使用最小货币单位或 Decimal；
Ledger 采用复式或等价不可变分录，修正使用反向分录；
订单、Provider payment、退款、拒付、平台费、创作者应付和税费分别记录；
Webhook 不依赖到达顺序，按 Provider event ID 幂等；
每日自动对账 Provider 报表、订单和 Ledger；
退款更新 entitlement 的后续更新/下载策略，不能删除审计账。

9. 创作者结算

创作者账户记录 KYC/主体状态、地区、结算币种、税务资料引用和 Provider account；
收益先进入 pending，经过退款/拒付准备期后转 available；
SettlementBatch 生成应付、费用、税款和净额；
Provider payout 失败可重试，但同一结算批次不能重复付款；
提供对账单、发票/税务数据导出、结算历史和争议工单。

敏感 KYC 和银行数据优先由支付 Provider 托管；Hunjing 只保存引用、状态和必要的脱敏信息。

5.1 KiB Raw Blame History Unescape Escape