@agents-uni/zhenhuan 0.1.5 → 0.1.7

package/README.en.md

@@ -23,6 +23,7 @@
   <a href="#palace-system">Palace System</a> &bull;
   <a href="#group-chat-with-agents-unichat">Group Chat</a> &bull;
   <a href="#rest-api">API</a> &bull;
+  <a href="#ecosystem">Ecosystem</a> &bull;
   <a href="./DESIGN.md">Design Doc</a>
 </p>
 
@@ -75,36 +76,35 @@ Built on [@agents-uni/core](https://github.com/agents-uni/core), it models a com
 
 ## Quick Start
 
-### Install
+### Zero-config Experience
 
-```bash
-# Use as a dependency
-npm install @agents-uni/zhenhuan
-
-# Or clone the repo for local development
-git clone https://github.com/agents-uni/zhenhuan.git
-cd zhenhuan
-npm install
-```
-
-### Start the server
+Install and launch immediately — the package ships with a complete palace configuration (7 concubine agents):
 
 ```bash
-# Global install, then use from any directory
 npm install -g @agents-uni/zhenhuan
 zhenhuan serve
 
-# Or in the project directory
-npm start
-
 # Or with npx (no global install needed)
 npx @agents-uni/zhenhuan serve
-
-# Use a custom spec file
-zhenhuan serve --spec /path/to/my-universe.yaml
 ```
 
-> 💡 **Path resolution**: `zhenhuan` first looks for `universe.yaml` in the current directory. If not found, it automatically uses the built-in default palace configuration. You can also specify a custom spec file with `--spec`.
+> 💡 `zhenhuan` CLI path resolution: first checks for `universe.yaml` in the current directory; if not found, falls back to the built-in palace configuration. You can also specify a custom path with `--spec`.
+
+### Custom Project
+
+If you want to modify concubine configurations, add new agents, or use group chat with `@agents-uni/chat`, create a local project:
+
+```bash
+# Initialize a project (generates universe.yaml in current directory)
+mkdir my-palace && cd my-palace
+npx uni init my-palace --uni zhenhuan
+
+# Edit universe.yaml to customize concubines...
+
+# Deploy to OpenClaw and start
+npx uni deploy
+zhenhuan serve
+```
 
 On startup, it prints the access URLs:
 
@@ -417,15 +417,19 @@ universe.yaml
 
 ### Deploy Agents to OpenClaw
 
+> 💡 `zhenhuan serve` auto-registers agents on startup — manual deployment is only needed when using OpenClaw workspaces without the server.
+
+If you have a local project directory (created via `uni init` or cloned from the repo), run in that directory:
+
 ```bash
-# One-command deploy
-npx uni deploy universe.yaml
+# Auto-detects universe.yaml in current directory
+npx uni deploy
 
-# Custom directory
-npx uni deploy universe.yaml --dir ~/.openclaw
+# Custom OpenClaw directory
+npx uni deploy --dir ~/.openclaw
 
 # Dry run (preview only)
-npx uni deploy universe.yaml --dry-run
+npx uni deploy --dry-run
 ```
 
 Or use pre-built SOUL.md files (hand-tuned with richer personality descriptions):
@@ -459,38 +463,52 @@ const { dispatch, race } = await orchestrator.dispatchAndRace(
 // POST /api/race/dispatch
 ```
 
-> 📖 Full integration tutorial: [OPENCLAW_INTEGRATION_GUIDE.md](https://github.com/agents-uni/zhenhuan/blob/main/OPENCLAW_INTEGRATION_GUIDE.md)
+> 📖 Design philosophy and architecture decisions: [DESIGN.md](./DESIGN.md)
 
 ## Group Chat (with @agents-uni/chat)
 
-Horse racing is the "arena"; group chat is "daily life". With [@agents-uni/chat](https://github.com/agents-uni/chat), your concubines can talk freely in a shared chat room — forming alliances, arguing, scheming — and their relationships evolve in real time based on the conversation.
+Horse racing is the "arena"; group chat is "daily life". [@agents-uni/chat](https://github.com/agents-uni/chat) lets your concubines talk freely in a shared chat room — forming alliances, arguing, scheming — and their relationships evolve in real time based on the conversation.
 
 ### Quick Start
 
+`agents-chat` needs to read `universe.yaml` to know which concubines exist and their relationships. You need a local project directory:
+
 ```bash
-# Install the chat package
-npm install -g @agents-uni/chat
+# 1. Initialize a palace project (generates universe.yaml)
+mkdir my-palace && cd my-palace
+npx uni init my-palace --uni zhenhuan
 
-# Deploy agents first (if not already deployed)
-uni deploy
+# 2. Deploy agents to OpenClaw workspaces (generates SOUL.md etc.)
+npx uni deploy
 
-# Start group chat in the directory containing universe.yaml
-agents-chat serve
-# Or specify the config file
-agents-chat serve --spec /path/to/universe.yaml
+# 3. Start group chat (auto-detects universe.yaml in current directory)
+npx agents-chat serve
 ```
 
 Open `http://localhost:3000` in your browser. You are the Emperor — concubines respond automatically based on the topic.
 
+> 💡 If you don't want to initialize a project, you can point directly to the bundled config:
+> ```bash
+> agents-chat serve --spec node_modules/@agents-uni/zhenhuan/universe.yaml
+> ```
+
 ### Racing + Chat Combined
 
-Both share the same `universe.yaml` and OpenClaw workspaces, and can be used simultaneously or alternately:
+Both share the same `universe.yaml` and OpenClaw workspaces. Run them side by side from the same project directory:
+
+```bash
+# Terminal 1: Horse racing (port 8089)
+zhenhuan serve
 
-| Scenario | Which to use | Command |
-|----------|-------------|---------|
+# Terminal 2: Group chat (port 3000)
+agents-chat serve
+```
+
+| Scenario | Which to use | Notes |
+|----------|-------------|-------|
 | Concubines compete on the same task, ELO ranking | `zhenhuan serve` | Horse race |
 | Concubines chat freely, observe interactions | `agents-chat serve` | Group chat |
-| Discuss approaches first, then compete on execution | Both alternately | Chat then race |
+| Discuss approaches first, then compete on execution | Both together | Chat then race |
 
 ### Relationship Evolution in Chat
 
@@ -509,12 +527,14 @@ These changes are reflected in real time on the chat UI's relationship graph. Co
 import { PalaceOrchestrator } from '@agents-uni/zhenhuan';
 import { ChatEngine } from '@agents-uni/chat';
 
-// Initialize the palace
-const orchestrator = await PalaceOrchestrator.fromSpec('universe.yaml');
+const specPath = 'universe.yaml'; // same config file
+
+// Horse racing engine
+const orchestrator = await PalaceOrchestrator.fromSpec(specPath);
 
-// Start chat engine with the same config
+// Group chat engine
 const chat = new ChatEngine({
-  specPath: 'universe.yaml',
+  specPath,
   maxRespondents: 3,
   contextWindow: 20,
 });
@@ -631,10 +651,88 @@ npm run dev
 npm run build
 ```
 
-## Related Projects
+## Ecosystem
+
+zhenhuan-uni is the flagship application of the agents-uni ecosystem, demonstrating how to build a complete agent competition system on top of the protocol layer.
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                 agents-uni Ecosystem Overview                │
+│                                                              │
+│  @agents-uni/core          Protocol layer                    │
+│       ├── Universe Spec     (universe.yaml parsing/validation│
+│       ├── Agent Registry    (registration, discovery, lifecycle│
+│       ├── Relationship Graph(graph modeling, BFS factions)   │
+│       ├── State Machine     (protocol state machines)        │
+│       ├── EventBus          (event-driven communication)     │
+│       ├── TaskDispatcher    (TASK.md → SUBMISSION.md dispatch)│
+│       ├── Dashboard         (Web UI + extension mechanism)   │
+│       └── CLI: uni          (init/deploy/validate/inspect)   │
+│                                                              │
+│  @agents-uni/zhenhuan  ←── Competition layer (this project)  │
+│       ├── ELO Arena         (ELO scoring, K-factor, floor)   │
+│       ├── Horse Race Engine (multi-agent same-task competition│
+│       ├── Palace System     (ranks, resources, factions, exile│
+│       ├── Season System     (seasons, court assemblies)      │
+│       └── CLI: zhenhuan     (serve/status/leaderboard/court) │
+│                                                              │
+│  @agents-uni/chat          Social layer                      │
+│       ├── Multi-agent Chat  (topic-driven, auto-respond)     │
+│       ├── Relationship Engine(infer trust/rivalry from chat)  │
+│       └── Live Relationship Graph (browser visualization)    │
+│                                                              │
+│  @agents-uni/rel           Relationship layer                │
+│       └── Multi-dim Relations(trust, rivalry, affinity, etc.) │
+│                                                              │
+│  @agents-uni/unis          Template layer                    │
+│       └── Arena/Corp/Military/Flat... (universe.yaml templates│
+│                                                              │
+│  OpenClaw                  Runtime layer                     │
+│       └── File Protocol     (SOUL.md / TASK.md / SUBMISSION.md│
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Package Relationships
+
+| Package | Role | How zhenhuan uses it |
+|---|---|---|
+| [@agents-uni/core](https://github.com/agents-uni/core) | Protocol foundation | Universe parsing, Agent registry, TaskDispatcher, Dashboard, CLI (`uni`) |
+| [@agents-uni/chat](https://github.com/agents-uni/chat) | Chat engine | Shares `universe.yaml`, concubines chat freely, relationships evolve in real time |
+| [@agents-uni/rel](https://github.com/agents-uni/rel) | Relationship modeling | Multi-dimensional relations (trust/rivalry/affinity/synergy), used internally by core and chat |
+| [@agents-uni/unis](https://github.com/agents-uni/unis) | Org templates | `uni init --uni zhenhuan` pulls palace config from the template library |
+| [OpenClaw](https://github.com/anthropics/openclaw) | Agent runtime | File protocol: SOUL.md (identity) → TASK.md (task) → SUBMISSION.md (output) |
+
+### End-to-End Workflow
+
+```bash
+# 1. Initialize — pull a universe.yaml template from @agents-uni/unis
+npx uni init my-palace --uni zhenhuan
+
+# 2. Deploy — core CLI compiles universe.yaml into SOUL.md files in OpenClaw
+npx uni deploy
+
+# 3. Start racing — zhenhuan's competition engine begins dispatching
+zhenhuan serve                    # port 8089
+
+# 4. Start group chat (optional) — chat reads the same universe.yaml
+npx agents-chat serve             # port 3000
+
+# 5. Validate / inspect / visualize — core CLI tools
+npx uni validate                  # validate universe.yaml
+npx uni inspect                   # view agent details
+npx uni visualize                 # visualize relationship graph
+```
+
+### Building Your Own Uni on Core
+
+zhenhuan-uni itself is the best reference implementation. Key steps:
+
+1. **Define `universe.yaml`** — refer to [core's spec docs](https://github.com/agents-uni/core#universe-spec) or zhenhuan's `universe.yaml` as a template
+2. **Implement competition/collaboration logic** — using core's `TaskDispatcher`, `PerformanceTracker`, `EventBus` primitives
+3. **Deploy to OpenClaw** — `uni deploy` auto-generates SOUL.md and registers agents
+4. **Extend the Dashboard** — inject custom panels via the `DashboardExtension` interface
 
-- [**@agents-uni/core**](https://github.com/agents-uni/core) — The universal protocol layer this project is built on ([npm](https://www.npmjs.com/package/@agents-uni/core))
-- [**@agents-uni/chat**](https://github.com/agents-uni/chat) — Group chat service for agent universes with real-time relationship evolution ([npm](https://www.npmjs.com/package/@agents-uni/chat))
+For detailed architecture and design decisions, see [DESIGN.md](./DESIGN.md).
 
 ## License
 

package/README.md

@@ -23,6 +23,7 @@
   <a href="#后宫体系">后宫体系</a> &bull;
   <a href="#群聊模式配合-agents-unichat">群聊模式</a> &bull;
   <a href="#rest-api">API</a> &bull;
+  <a href="#生态系统">生态系统</a> &bull;
   <a href="./DESIGN.md">设计文档</a>
 </p>
 
@@ -75,36 +76,35 @@
 
 ## 快速开始
 
-### 安装
+### 零配置体验
 
-```bash
-# 作为依赖使用
-npm install @agents-uni/zhenhuan
-
-# 或克隆仓库本地开发
-git clone https://github.com/agents-uni/zhenhuan.git
-cd zhenhuan
-npm install
-```
-
-### 启动服务器
+安装后直接启动，包自带完整的甄嬛后宫配置（7 个嫔妃 Agent）：
 
 ```bash
-# 全局安装后，在任意目录直接使用
 npm install -g @agents-uni/zhenhuan
 zhenhuan serve
 
-# 或在项目目录中
-npm start
-
 # 或用 npx（无需全局安装）
 npx @agents-uni/zhenhuan serve
-
-# 使用自定义规范文件
-zhenhuan serve --spec /path/to/my-universe.yaml
 ```
 
-> 💡 **路径解析逻辑**：`zhenhuan` 会优先查找当前目录下的 `universe.yaml`，找不到时自动使用包自带的默认甄嬛后宫配置。你也可以通过 `--spec` 显式指定规范文件路径。
+> 💡 `zhenhuan` CLI 的路径解析逻辑：优先使用当前目录的 `universe.yaml`，找不到时自动回退到包自带的默认后宫配置。你也可以通过 `--spec` 显式指定。
+
+### 自定义项目
+
+如果你想修改嫔妃配置、添加新 Agent，或配合 `@agents-uni/chat` 群聊使用，需要在本地建一个项目：
+
+```bash
+# 初始化项目（生成 universe.yaml 到当前目录）
+mkdir my-palace && cd my-palace
+npx uni init my-palace --uni zhenhuan
+
+# 编辑 universe.yaml 自定义嫔妃...
+
+# 部署到 OpenClaw 并启动
+npx uni deploy
+zhenhuan serve
+```
 
 启动后会打印访问链接：
 
@@ -417,15 +417,19 @@ universe.yaml
 
 ### 部署 Agent 到 OpenClaw
 
+> 💡 `zhenhuan serve` 会自动注册 Agent，无需手动部署。只有在你想单独使用 OpenClaw 工作区（不启动服务器）时才需要手动部署。
+
+如果你有本地项目目录（通过 `uni init` 创建，或克隆仓库），在该目录下运行：
+
 ```bash
-# CLI 一键部署
-npx uni deploy universe.yaml
+# 自动读取当前目录的 universe.yaml
+npx uni deploy
 
-# 指定目录
-npx uni deploy universe.yaml --dir ~/.openclaw
+# 指定 OpenClaw 目录
+npx uni deploy --dir ~/.openclaw
 
 # 预览（不实际写入）
-npx uni deploy universe.yaml --dry-run
+npx uni deploy --dry-run
 ```
 
 或使用预置 SOUL.md（手工调优版，包含更丰富的性格描写）：
@@ -459,49 +463,63 @@ const { dispatch, race } = await orchestrator.dispatchAndRace(
 // POST /api/race/dispatch
 ```
 
-> 📖 详细整合教程见 [OPENCLAW_INTEGRATION_GUIDE.md](https://github.com/agents-uni/zhenhuan/blob/main/OPENCLAW_INTEGRATION_GUIDE.md)
+> 📖 设计理念和架构决策详见 [DESIGN.md](./DESIGN.md)
 
 ## 群聊模式（配合 @agents-uni/chat）
 
-赛马竞技是"比武"，群聊是"日常"。通过 [@agents-uni/chat](https://github.com/agents-uni/chat) 可以让后宫嫔妃们在同一个聊天室里自由对话——结盟、争吵、密谋都会自然发生，关系也会随对话内容实时演化。
+赛马竞技是"比武"，群聊是"日常"。[@agents-uni/chat](https://github.com/agents-uni/chat) 让后宫嫔妃们在同一个聊天室自由对话——结盟、争吵、密谋都会自然发生，关系随对话内容实时演化。
 
 ### 快速启动
 
+`agents-chat` 需要读取 `universe.yaml` 来了解有哪些嫔妃以及她们之间的关系。你需要先在本地建一个项目目录：
+
 ```bash
-# 安装 chat 包
-npm install -g @agents-uni/chat
+# 1. 初始化后宫项目（会生成 universe.yaml 到当前目录）
+mkdir my-palace && cd my-palace
+npx uni init my-palace --uni zhenhuan
 
-# 先部署 Agent（如果还没部署过）
-uni deploy
+# 2. 部署 Agent 到 OpenClaw 工作区（生成 SOUL.md 等文件）
+npx uni deploy
 
-# 在甄嬛后宫的 universe.yaml 目录下启动群聊
-agents-chat serve
-# 或指定配置文件
-agents-chat serve --spec /path/to/universe.yaml
+# 3. 启动群聊（自动读取当前目录的 universe.yaml）
+npx agents-chat serve
 ```
 
-浏览器打开 `http://localhost:3000`，你就是皇帝，嫔妃们会根据话题自动应答。
+浏览器打开 `http://localhost:3000`，你就是皇帝，嫔妃们根据话题自动应答。
+
+> 💡 如果不想初始化项目，也可以用 `--spec` 直接指向包自带的配置：
+> ```bash
+> agents-chat serve --spec node_modules/@agents-uni/zhenhuan/universe.yaml
+> ```
 
 ### 赛马 + 群聊 配合使用
 
-两者共享同一个 `universe.yaml` 和 OpenClaw 工作区，可以同时或交替使用：
+两者共享同一个 `universe.yaml` 和 OpenClaw 工作区，在同一个项目目录下交替使用：
+
+```bash
+# 终端 1：赛马竞技（端口 8089）
+zhenhuan serve
 
-| 场景 | 用哪个 | 命令 |
+# 终端 2：群聊模式（端口 3000）
+agents-chat serve
+```
+
+| 场景 | 用哪个 | 说明 |
 |------|--------|------|
 | 让嫔妃们竞争同一任务、ELO 排名 | `zhenhuan serve` | 赛马竞技 |
 | 让嫔妃们自由对话、观察互动 | `agents-chat serve` | 群聊模式 |
-| 先群聊讨论方案，再赛马比拼执行 | 两者交替 | 先聊后赛 |
+| 先群聊讨论方案，再赛马比拼执行 | 两者同时 | 先聊后赛 |
 
 ### 群聊中的关系演化
 
-`@agents-uni/chat` 内置了关系推理引擎，会从对话中自动检测：
+`@agents-uni/chat` 内置关系推理引擎，从对话中自动检测：
 
 - **赞同** — 信任度 +0.05，亲密度 +0.03
 - **反对** — 竞争度 +0.03
 - **协作** — 协同度 +0.05
 - **共识** — 信任度 +0.02，协同度 +0.02
 
-这些关系变化会实时反映在聊天界面的关系图谱中。配合赛马的 ELO 排名，你可以全方位观察嫔妃们的能力和社交动态。
+这些变化实时反映在聊天界面的关系图谱中。配合赛马的 ELO 排名，你可以全方位观察嫔妃们的能力和社交动态。
 
 ### 编程式集成
 
@@ -509,12 +527,14 @@ agents-chat serve --spec /path/to/universe.yaml
 import { PalaceOrchestrator } from '@agents-uni/zhenhuan';
 import { ChatEngine } from '@agents-uni/chat';
 
-// 先初始化后宫
-const orchestrator = await PalaceOrchestrator.fromSpec('universe.yaml');
+const specPath = 'universe.yaml'; // 同一份配置文件
+
+// 赛马引擎
+const orchestrator = await PalaceOrchestrator.fromSpec(specPath);
 
-// 用同一份配置启动群聊引擎
+// 群聊引擎
 const chat = new ChatEngine({
-  specPath: 'universe.yaml',
+  specPath,
   maxRespondents: 3,
   contextWindow: 20,
 });
@@ -633,10 +653,88 @@ npm run dev
 npm run build
 ```
 
-## 相关项目
+## 生态系统
+
+zhenhuan-uni 是 agents-uni 生态的标杆应用，展示如何基于底层协议构建完整的 Agent 竞争系统。
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    agents-uni 生态全景                        │
+│                                                              │
+│  @agents-uni/core          协议层 — 定义 Agent 组织的通用规范  │
+│       ├── Universe 规范     (universe.yaml 解析与校验)        │
+│       ├── Agent Registry    (注册、发现、生命周期管理)        │
+│       ├── Relationship Graph(关系图谱、BFS 派系发现)          │
+│       ├── State Machine     (协议状态机、流程编排)            │
+│       ├── EventBus          (事件驱动的松耦合通信)            │
+│       ├── TaskDispatcher    (TASK.md → SUBMISSION.md 调度)    │
+│       ├── Dashboard         (Web UI + 扩展机制)               │
+│       └── CLI: uni          (init/deploy/validate/inspect)    │
+│                                                              │
+│  @agents-uni/zhenhuan  ←── 竞争层 — 本项目                    │
+│       ├── ELO 竞技场        (ELO 评分、K 因子、地板机制)      │
+│       ├── 赛马引擎          (多 Agent 同任务竞争)             │
+│       ├── 后宫体系          (品级、资源、势力、冷宫)          │
+│       ├── 赛季制度          (赛季、朝会、晋升降级)            │
+│       └── CLI: zhenhuan     (serve/status/leaderboard/court)  │
+│                                                              │
+│  @agents-uni/chat          社交层 — Agent 群聊                │
+│       ├── 多 Agent 聊天室   (话题驱动、自动应答)              │
+│       ├── 关系推理引擎      (从对话中推断信任/竞争/协同)      │
+│       └── 实时关系图谱      (浏览器可视化)                    │
+│                                                              │
+│  @agents-uni/rel           关系层 — 关系建模基础库             │
+│       └── 多维关系模型      (信任、竞争、亲密、协同等维度)    │
+│                                                              │
+│  @agents-uni/unis          模板层 — 预置组织模板               │
+│       └── 竞技场/企业/军事/扁平... (universe.yaml 模板库)     │
+│                                                              │
+│  OpenClaw                  运行层 — Agent 运行时环境           │
+│       └── 文件协议          (SOUL.md / TASK.md / SUBMISSION.md)│
+└─────────────────────────────────────────────────────────────┘
+```
+
+### 包之间的关系
+
+| 包 | 角色 | zhenhuan 如何使用它 |
+|---|---|---|
+| [@agents-uni/core](https://github.com/agents-uni/core) | 协议基座 | Universe 解析、Agent 注册、TaskDispatcher、Dashboard、CLI (`uni`) |
+| [@agents-uni/chat](https://github.com/agents-uni/chat) | 群聊引擎 | 共享 `universe.yaml`，嫔妃在聊天室自由对话，关系实时演化 |
+| [@agents-uni/rel](https://github.com/agents-uni/rel) | 关系建模 | 多维关系（信任/竞争/亲密/协同），被 core 和 chat 内部依赖 |
+| [@agents-uni/unis](https://github.com/agents-uni/unis) | 组织模板 | `uni init --uni zhenhuan` 从模板库拉取后宫配置 |
+| [OpenClaw](https://github.com/anthropics/openclaw) | Agent 运行时 | 文件协议：SOUL.md（身份）→ TASK.md（任务）→ SUBMISSION.md（提交） |
+
+### 从零到一的完整流程
+
+```bash
+# 1. 初始化项目 — 从 @agents-uni/unis 模板生成 universe.yaml
+npx uni init my-palace --uni zhenhuan
+
+# 2. 部署 — core 的 CLI 将 universe.yaml 编译为 SOUL.md 并写入 OpenClaw
+npx uni deploy
+
+# 3. 启动赛马 — zhenhuan 的竞争引擎开始调度
+zhenhuan serve                    # 端口 8089
+
+# 4. 启动群聊（可选）— chat 读取同一份 universe.yaml
+npx agents-chat serve             # 端口 3000
+
+# 5. 验证 / 检查 / 可视化 — core 的 CLI 工具
+npx uni validate                  # 校验 universe.yaml
+npx uni inspect                   # 查看 Agent 详情
+npx uni visualize                 # 可视化关系图谱
+```
+
+### 如果你想基于 core 创建自己的 Uni
+
+zhenhuan-uni 本身就是最好的参考实现。核心步骤：
+
+1. **定义 `universe.yaml`** — 参考 [core 的规范文档](https://github.com/agents-uni/core#universe-规范) 或直接参考 zhenhuan 的 `universe.yaml`
+2. **实现竞争/协作逻辑** — 使用 core 提供的 `TaskDispatcher`、`PerformanceTracker`、`EventBus` 等原语
+3. **部署到 OpenClaw** — `uni deploy` 自动生成 SOUL.md 并注册 Agent
+4. **扩展 Dashboard** — 通过 `DashboardExtension` 接口注入自定义面板
 
-- [**@agents-uni/core**](https://github.com/agents-uni/core) — 本项目底层的通用 Agent 组织协议层 ([npm](https://www.npmjs.com/package/@agents-uni/core))
-- [**@agents-uni/chat**](https://github.com/agents-uni/chat) — 群聊服务，让 Agent 们在浏览器中自由对话，关系实时演化 ([npm](https://www.npmjs.com/package/@agents-uni/chat))
+详细的架构设计和决策过程见 [DESIGN.md](./DESIGN.md)。
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agents-uni/zhenhuan",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Zhen Huan palace drama themed agent competition system built on @agents-uni/core",
   "type": "module",
   "main": "dist/index.js",