chenxin
42513d13c6
- 产品层：产品宪章与永久禁域、产品定义、完整 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
135 lines
5.1 KiB
Markdown
135 lines
5.1 KiB
Markdown
# 社区、协作与市场架构
|
||
|
||
## 1. 领域边界
|
||
|
||
```mermaid
|
||
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. 内容治理
|
||
|
||
```mermaid
|
||
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. 支付、退款与账务
|
||
|
||
```mermaid
|
||
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 只保存引用、状态和必要的脱敏信息。
|