@agents-uni/zhenhuan 0.1.1 → 0.1.2

package/README.en.md

@@ -86,7 +86,7 @@ npm install
 ### Start the server
 
 ```bash
-# Global install, then use directly
+# Global install, then use from any directory
 npm install -g @agents-uni/zhenhuan
 zhenhuan serve
 
@@ -95,8 +95,13 @@ 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`.
+
 On startup, it prints the access URLs:
 
 ```

package/README.md

@@ -86,7 +86,7 @@ npm install
 ### 启动服务器
 
 ```bash
-# 全局安装后直接使用
+# 全局安装后，在任意目录直接使用
 npm install -g @agents-uni/zhenhuan
 zhenhuan serve
 
@@ -95,8 +95,13 @@ npm start
 
 # 或用 npx（无需全局安装）
 npx @agents-uni/zhenhuan serve
+
+# 使用自定义规范文件
+zhenhuan serve --spec /path/to/my-universe.yaml
 ```
 
+> 💡 **路径解析逻辑**：`zhenhuan` 会优先查找当前目录下的 `universe.yaml`，找不到时自动使用包自带的默认甄嬛后宫配置。你也可以通过 `--spec` 显式指定规范文件路径。
+
 启动后会打印访问链接：
 
 ```

package/dist/cli/index.js

@@ -4,8 +4,37 @@
  */
 import { Command } from 'commander';
 import chalk from 'chalk';
+import { resolve, dirname, join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
 import { PalaceOrchestrator } from '../orchestrator/index.js';
 import { startServer } from '../server/index.js';
+/**
+ * 解析 universe.yaml 路径：
+ * 1. 用户显式指定 --spec → 直接用
+ * 2. CWD 下存在 universe.yaml → 用它
+ * 3. fallback 到包自带的 universe.yaml（全局安装场景）
+ */
+function resolveSpec(specOpt) {
+    // 用户显式传了绝对路径或非默认值
+    if (specOpt !== 'universe.yaml') {
+        return resolve(specOpt);
+    }
+    // CWD 下有 universe.yaml，优先使用
+    const cwdSpec = resolve('universe.yaml');
+    if (existsSync(cwdSpec)) {
+        return cwdSpec;
+    }
+    // fallback: 包目录下的 universe.yaml（npm 全局安装场景）
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    const bundledSpec = join(__dirname, '..', '..', 'universe.yaml');
+    if (existsSync(bundledSpec)) {
+        console.log(chalk.gray(`  ℹ 使用内置 universe.yaml (${bundledSpec})`));
+        return bundledSpec;
+    }
+    // 都找不到，返回原始路径（让后续报一个清晰的错误）
+    return cwdSpec;
+}
 const program = new Command();
 program
     .name('zhenhuan')
@@ -18,11 +47,10 @@ program
     .option('-p, --port <port>', '端口号', '8089')
     .option('-s, --spec <path>', '规范文件路径', 'universe.yaml')
     .action(async (opts) => {
+    const specPath = resolveSpec(opts.spec);
     // Auto-register in uni-registry on serve
     try {
-        const { resolve } = await import('node:path');
         const { registerUni, parseSpecFile } = await import('@agents-uni/core');
-        const specPath = resolve(opts.spec);
         const config = parseSpecFile(specPath);
         registerUni(config, specPath);
         console.log(chalk.gray(`  ✓ 已注册到 uni-registry`));
@@ -32,7 +60,7 @@ program
     }
     await startServer({
         port: parseInt(opts.port, 10),
-        specPath: opts.spec,
+        specPath,
     });
 });
 // ─── status ─────────────────────────────────
@@ -41,7 +69,7 @@ program
     .description('查看后宫状态')
     .option('-s, --spec <path>', '规范文件路径', 'universe.yaml')
     .action(async (opts) => {
-    const orchestrator = await PalaceOrchestrator.fromSpec(opts.spec);
+    const orchestrator = await PalaceOrchestrator.fromSpec(resolveSpec(opts.spec));
     const state = orchestrator.getState();
     console.log(chalk.yellow('\n═══ 后宫品级表 ═══\n'));
     // Sort by rank level descending
@@ -76,7 +104,7 @@ program
     .description('查看 ELO 排行榜')
     .option('-s, --spec <path>', '规范文件路径', 'universe.yaml')
     .action(async (opts) => {
-    const orchestrator = await PalaceOrchestrator.fromSpec(opts.spec);
+    const orchestrator = await PalaceOrchestrator.fromSpec(resolveSpec(opts.spec));
     const board = orchestrator.getLeaderboard();
     console.log(chalk.yellow('\n═══ ELO 排行榜 ═══\n'));
     console.log(`  ${chalk.gray('排名')}  ${chalk.gray('ID'.padEnd(16))} ` +
@@ -102,7 +130,7 @@ program
     .description('召开朝会')
     .option('-s, --spec <path>', '规范文件路径', 'universe.yaml')
     .action(async (opts) => {
-    const orchestrator = await PalaceOrchestrator.fromSpec(opts.spec);
+    const orchestrator = await PalaceOrchestrator.fromSpec(resolveSpec(opts.spec));
     console.log(chalk.yellow('\n═══ 朝会开始 ═══\n'));
     await orchestrator.runCourtAssembly();
     const state = orchestrator.getState();
@@ -123,7 +151,7 @@ program
     .option('--openclaw-dir <dir>', 'OpenClaw 目录', '')
     .option('-s, --spec <path>', '规范文件路径', 'universe.yaml')
     .action(async (opts) => {
-    const orchestrator = await PalaceOrchestrator.fromSpec(opts.spec);
+    const orchestrator = await PalaceOrchestrator.fromSpec(resolveSpec(opts.spec));
     const agentDef = {
         id: opts.id,
         name: opts.name,
@@ -175,7 +203,7 @@ program
     .option('-s, --spec <path>', '规范文件路径', 'universe.yaml')
     .option('--agents <ids>', '参赛 Agent ID (逗号分隔，默认全部嫔妃)', '')
     .action(async (opts) => {
-    const orchestrator = await PalaceOrchestrator.fromSpec(opts.spec);
+    const orchestrator = await PalaceOrchestrator.fromSpec(resolveSpec(opts.spec));
     // Determine participants: all agents by default (emperor is the user, not an agent)
     let participants;
     if (opts.agents) {

package/package.json

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