@agents-uni/zhenhuan 0.1.3 → 0.1.5

package/README.en.md

@@ -2,6 +2,9 @@
 [![npm version](https://img.shields.io/npm/v/@agents-uni/zhenhuan.svg)](https://www.npmjs.com/package/@agents-uni/zhenhuan)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
+<p align="center">
+  <img src="assets/logo.png" alt="Agents Uni" width="120" />
+</p>
 <p align="center">
   <h1 align="center">zhenhuan-uni</h1>
   <p align="center">
@@ -18,6 +21,7 @@
   <a href="#quick-start">Quick Start</a> &bull;
   <a href="#competition-mechanics">Competition</a> &bull;
   <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="./DESIGN.md">Design Doc</a>
 </p>
@@ -457,6 +461,71 @@ const { dispatch, race } = await orchestrator.dispatchAndRace(
 
 > 📖 Full integration tutorial: [OPENCLAW_INTEGRATION_GUIDE.md](https://github.com/agents-uni/zhenhuan/blob/main/OPENCLAW_INTEGRATION_GUIDE.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.
+
+### Quick Start
+
+```bash
+# Install the chat package
+npm install -g @agents-uni/chat
+
+# Deploy agents first (if not already deployed)
+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
+```
+
+Open `http://localhost:3000` in your browser. You are the Emperor — concubines respond automatically based on the topic.
+
+### Racing + Chat Combined
+
+Both share the same `universe.yaml` and OpenClaw workspaces, and can be used simultaneously or alternately:
+
+| Scenario | Which to use | Command |
+|----------|-------------|---------|
+| 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 |
+
+### Relationship Evolution in Chat
+
+`@agents-uni/chat` includes a built-in relationship inference engine that detects signals from conversations:
+
+- **Agreement** — trust +0.05, affinity +0.03
+- **Disagreement** — rivalry +0.03
+- **Collaboration** — synergy +0.05
+- **Consensus** — trust +0.02, synergy +0.02
+
+These changes are reflected in real time on the chat UI's relationship graph. Combined with ELO rankings from horse racing, you get a full picture of each concubine's ability and social dynamics.
+
+### Programmatic Integration
+
+```typescript
+import { PalaceOrchestrator } from '@agents-uni/zhenhuan';
+import { ChatEngine } from '@agents-uni/chat';
+
+// Initialize the palace
+const orchestrator = await PalaceOrchestrator.fromSpec('universe.yaml');
+
+// Start chat engine with the same config
+const chat = new ChatEngine({
+  specPath: 'universe.yaml',
+  maxRespondents: 3,
+  contextWindow: 20,
+});
+
+// Chat: let concubines discuss
+const responses = await chat.processMessage('How should we improve palace cuisine?');
+
+// Race: let them compete formally
+const { race } = await orchestrator.dispatchAndRace(task, judge);
+```
+
 ## Dashboard Integration
 
 zhenhuan-uni integrates deeply with the agents-uni-core Dashboard, providing a unified web UI for managing the palace system.
@@ -565,6 +634,7 @@ npm run build
 ## Related Projects
 
 - [**@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))
 
 ## License
 

package/README.md

@@ -2,6 +2,9 @@
 [![npm version](https://img.shields.io/npm/v/@agents-uni/zhenhuan.svg)](https://www.npmjs.com/package/@agents-uni/zhenhuan)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
+<p align="center">
+  <img src="assets/logo.png" alt="Agents Uni" width="120" />
+</p>
 <p align="center">
   <h1 align="center">zhenhuan-uni</h1>
   <p align="center">
@@ -18,6 +21,7 @@
   <a href="#快速开始">快速开始</a> &bull;
   <a href="#竞争机制">竞争机制</a> &bull;
   <a href="#后宫体系">后宫体系</a> &bull;
+  <a href="#群聊模式配合-agents-unichat">群聊模式</a> &bull;
   <a href="#rest-api">API</a> &bull;
   <a href="./DESIGN.md">设计文档</a>
 </p>
@@ -457,6 +461,71 @@ const { dispatch, race } = await orchestrator.dispatchAndRace(
 
 > 📖 详细整合教程见 [OPENCLAW_INTEGRATION_GUIDE.md](https://github.com/agents-uni/zhenhuan/blob/main/OPENCLAW_INTEGRATION_GUIDE.md)
 
+## 群聊模式（配合 @agents-uni/chat）
+
+赛马竞技是"比武"，群聊是"日常"。通过 [@agents-uni/chat](https://github.com/agents-uni/chat) 可以让后宫嫔妃们在同一个聊天室里自由对话——结盟、争吵、密谋都会自然发生，关系也会随对话内容实时演化。
+
+### 快速启动
+
+```bash
+# 安装 chat 包
+npm install -g @agents-uni/chat
+
+# 先部署 Agent（如果还没部署过）
+uni deploy
+
+# 在甄嬛后宫的 universe.yaml 目录下启动群聊
+agents-chat serve
+# 或指定配置文件
+agents-chat serve --spec /path/to/universe.yaml
+```
+
+浏览器打开 `http://localhost:3000`，你就是皇帝，嫔妃们会根据话题自动应答。
+
+### 赛马 + 群聊 配合使用
+
+两者共享同一个 `universe.yaml` 和 OpenClaw 工作区，可以同时或交替使用：
+
+| 场景 | 用哪个 | 命令 |
+|------|--------|------|
+| 让嫔妃们竞争同一任务、ELO 排名 | `zhenhuan serve` | 赛马竞技 |
+| 让嫔妃们自由对话、观察互动 | `agents-chat serve` | 群聊模式 |
+| 先群聊讨论方案，再赛马比拼执行 | 两者交替 | 先聊后赛 |
+
+### 群聊中的关系演化
+
+`@agents-uni/chat` 内置了关系推理引擎，会从对话中自动检测：
+
+- **赞同** — 信任度 +0.05，亲密度 +0.03
+- **反对** — 竞争度 +0.03
+- **协作** — 协同度 +0.05
+- **共识** — 信任度 +0.02，协同度 +0.02
+
+这些关系变化会实时反映在聊天界面的关系图谱中。配合赛马的 ELO 排名，你可以全方位观察嫔妃们的能力和社交动态。
+
+### 编程式集成
+
+```typescript
+import { PalaceOrchestrator } from '@agents-uni/zhenhuan';
+import { ChatEngine } from '@agents-uni/chat';
+
+// 先初始化后宫
+const orchestrator = await PalaceOrchestrator.fromSpec('universe.yaml');
+
+// 用同一份配置启动群聊引擎
+const chat = new ChatEngine({
+  specPath: 'universe.yaml',
+  maxRespondents: 3,
+  contextWindow: 20,
+});
+
+// 群聊：让嫔妃们讨论
+const responses = await chat.processMessage('各位觉得如何提升后宫膳食质量？');
+
+// 赛马：让她们正式比拼
+const { race } = await orchestrator.dispatchAndRace(task, judge);
+```
+
 ## Dashboard 集成
 
 zhenhuan-uni 内置了 agents-uni-core 的 Dashboard，启动服务后直接访问首页即可。
@@ -567,6 +636,7 @@ npm run build
 ## 相关项目
 
 - [**@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))
 
 ## License
 

package/dist/cli/index.js

@@ -7,6 +7,7 @@ import chalk from 'chalk';
 import { resolve, dirname, join } from 'node:path';
 import { existsSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
+import { createRequire } from 'node:module';
 import { PalaceOrchestrator } from '../orchestrator/index.js';
 import { startServer } from '../server/index.js';
 /**
@@ -14,6 +15,7 @@ import { startServer } from '../server/index.js';
  * 1. 用户显式指定 --spec → 直接用
  * 2. CWD 下存在 universe.yaml → 用它
  * 3. fallback 到包自带的 universe.yaml（全局安装场景）
+ * 4. fallback 到 @agents-uni/unis/zhenhuan/universe.yaml（如果安装了）
  */
 function resolveSpec(specOpt) {
     // 用户显式传了绝对路径或非默认值
@@ -32,6 +34,19 @@ function resolveSpec(specOpt) {
         console.log(chalk.gray(`  ℹ 使用内置 universe.yaml (${bundledSpec})`));
         return bundledSpec;
     }
+    // fallback: @agents-uni/unis 中的 zhenhuan 模板
+    try {
+        const require = createRequire(import.meta.url);
+        const unisPkgPath = require.resolve('@agents-uni/unis/package.json');
+        const unisSpec = join(dirname(unisPkgPath), 'zhenhuan', 'universe.yaml');
+        if (existsSync(unisSpec)) {
+            console.log(chalk.gray(`  ℹ 使用 @agents-uni/unis 模板 (${unisSpec})`));
+            return unisSpec;
+        }
+    }
+    catch {
+        // @agents-uni/unis not installed — skip
+    }
     // 都找不到，返回原始路径（让后续报一个清晰的错误）
     return cwdSpec;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agents-uni/zhenhuan",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Zhen Huan palace drama themed agent competition system built on @agents-uni/core",
   "type": "module",
   "main": "dist/index.js",
@@ -26,6 +26,7 @@
   "scripts": {
     "build": "tsc",
     "test": "vitest run",
+    "lint": "tsc --noEmit",
     "dev": "tsx --watch src/cli/index.ts serve",
     "start": "tsx src/cli/index.ts serve",
     "serve": "tsx src/cli/index.ts serve",
@@ -52,12 +53,15 @@
     "url": "https://github.com/agents-uni/zhenhuan/issues"
   },
   "dependencies": {
-    "@agents-uni/core": "^0.2.0",
+    "@agents-uni/core": "^0.3.0",
     "@hono/node-server": "^1.13.0",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "hono": "^4.6.0"
   },
+  "optionalDependencies": {
+    "@agents-uni/unis": "^0.1.0"
+  },
   "devDependencies": {
     "@types/node": "^22.10.0",
     "tsx": "^4.19.2",