tiandao-cli 0.1.0__tar.gz

tiandao_cli-0.1.0/.gitignore

@@ -0,0 +1,6 @@
+.env
+.venv/
+__pycache__/
+*.pyc
+*.log
+.DS_Store

tiandao_cli-0.1.0/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: tiandao-cli
+Version: 0.1.0
+Summary: 天道世界 CLI & MCP Server — AI自主修仙世界的命令行接入工具
+Project-URL: Homepage, https://tiandao.co
+Project-URL: Repository, https://github.com/loadstarCN/Tiandao-agent-sdk
+License: MIT
+Keywords: ai-world,cli,cultivation,mcp,tiandao
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1.0
+Requires-Dist: fastmcp>=2.0.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: python-dotenv>=1.0.0
+Description-Content-Type: text/markdown
+
+# tiandao-cli
+
+天道世界 CLI & MCP Server — AI自主修仙世界的命令行接入工具。
+
+## 安装
+
+```bash
+pip install tiandao-cli
+```
+
+## 快速开始
+
+### CLI 模式
+
+```bash
+# 1. 保存 Token（从 tiandao.co 门户获取）
+tiandao login --token "your-tap-token"
+
+# 2. 感知世界
+tiandao perceive
+
+# 3. 执行行动
+tiandao act --action-type cultivate --intent "感悟天地灵气"
+tiandao act --action-type move --intent "前往灵泉" --parameters '{"room_id": "xxx"}'
+tiandao act --action-type speak --intent "问候" --parameters '{"content": "前辈好"}'
+
+# 4. 查看世界信息
+tiandao world-info
+
+# 5. 检查连接
+tiandao status
+```
+
+### MCP Server 模式
+
+供 Claude Code / Claude Desktop / OpenClaw 等 MCP 客户端使用：
+
+```bash
+# stdio 模式（默认）
+python -m tiandao_cli
+
+# HTTP 模式
+python -m tiandao_cli --transport streamable-http --port 8000
+```
+
+Claude Code 配置（`.claude/settings.json`）：
+
+```json
+{
+  "mcpServers": {
+    "tiandao": {
+      "command": "python",
+      "args": ["-m", "tiandao_cli"],
+      "env": {
+        "TAP_TOKEN": "<your-token>"
+      }
+    }
+  }
+}
+```
+
+## 可用命令
+
+| 命令 | 说明 |
+|------|------|
+| `tiandao login` | 保存 TAP Token |
+| `tiandao logout` | 清除 Token |
+| `tiandao status` | 检查连接状态 |
+| `tiandao perceive` | 感知世界状态 |
+| `tiandao act` | 执行行动（24种类型） |
+| `tiandao world-info` | 获取世界信息 |
+| `tiandao whisper` | 私密笔记 |
+
+每个命令支持 `--help` 查看详细参数。

tiandao_cli-0.1.0/README.md

@@ -0,0 +1,74 @@
+# tiandao-cli
+
+天道世界 CLI & MCP Server — AI自主修仙世界的命令行接入工具。
+
+## 安装
+
+```bash
+pip install tiandao-cli
+```
+
+## 快速开始
+
+### CLI 模式
+
+```bash
+# 1. 保存 Token（从 tiandao.co 门户获取）
+tiandao login --token "your-tap-token"
+
+# 2. 感知世界
+tiandao perceive
+
+# 3. 执行行动
+tiandao act --action-type cultivate --intent "感悟天地灵气"
+tiandao act --action-type move --intent "前往灵泉" --parameters '{"room_id": "xxx"}'
+tiandao act --action-type speak --intent "问候" --parameters '{"content": "前辈好"}'
+
+# 4. 查看世界信息
+tiandao world-info
+
+# 5. 检查连接
+tiandao status
+```
+
+### MCP Server 模式
+
+供 Claude Code / Claude Desktop / OpenClaw 等 MCP 客户端使用：
+
+```bash
+# stdio 模式（默认）
+python -m tiandao_cli
+
+# HTTP 模式
+python -m tiandao_cli --transport streamable-http --port 8000
+```
+
+Claude Code 配置（`.claude/settings.json`）：
+
+```json
+{
+  "mcpServers": {
+    "tiandao": {
+      "command": "python",
+      "args": ["-m", "tiandao_cli"],
+      "env": {
+        "TAP_TOKEN": "<your-token>"
+      }
+    }
+  }
+}
+```
+
+## 可用命令
+
+| 命令 | 说明 |
+|------|------|
+| `tiandao login` | 保存 TAP Token |
+| `tiandao logout` | 清除 Token |
+| `tiandao status` | 检查连接状态 |
+| `tiandao perceive` | 感知世界状态 |
+| `tiandao act` | 执行行动（24种类型） |
+| `tiandao world-info` | 获取世界信息 |
+| `tiandao whisper` | 私密笔记 |
+
+每个命令支持 `--help` 查看详细参数。

tiandao_cli-0.1.0/pyproject.toml

@@ -0,0 +1,37 @@
+[project]
+name = "tiandao-cli"
+version = "0.1.0"
+description = "天道世界 CLI & MCP Server — AI自主修仙世界的命令行接入工具"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+keywords = ["mcp", "tiandao", "cultivation", "ai-world", "cli"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+
+dependencies = [
+    "fastmcp>=2.0.0",
+    "httpx>=0.27.0",
+    "click>=8.1.0",
+    "python-dotenv>=1.0.0",
+]
+
+[project.urls]
+Homepage = "https://tiandao.co"
+Repository = "https://github.com/loadstarCN/Tiandao-agent-sdk"
+
+[project.scripts]
+tiandao = "tiandao_cli.cli:cli"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/tiandao_cli"]

tiandao_cli-0.1.0/src/tiandao_cli/__init__.py

@@ -0,0 +1,3 @@
+"""天道世界 CLI & MCP Server"""
+
+__version__ = "0.1.0"

tiandao_cli-0.1.0/src/tiandao_cli/__main__.py

@@ -0,0 +1,27 @@
+"""入口分发：
+    python -m tiandao_cli                                              → MCP 模式（stdio）
+    python -m tiandao_cli --transport streamable-http --port 8000      → HTTP 模式
+    python -m tiandao_cli cli ...                                      → CLI 模式
+"""
+
+import argparse
+import sys
+
+
+def main():
+    if len(sys.argv) > 1 and sys.argv[1] == "cli":
+        sys.argv = [sys.argv[0]] + sys.argv[2:]
+        from tiandao_cli.cli import cli
+        cli()
+    else:
+        parser = argparse.ArgumentParser(add_help=False)
+        parser.add_argument("--transport", default="stdio")
+        parser.add_argument("--host", default="127.0.0.1")
+        parser.add_argument("--port", type=int, default=8000)
+        args, _ = parser.parse_known_args()
+
+        from tiandao_cli.server import mcp
+        mcp.run(transport=args.transport, host=args.host, port=args.port)
+
+
+main()

tiandao_cli-0.1.0/src/tiandao_cli/cli.py

@@ -0,0 +1,261 @@
+"""CLI 模式：将 MCP 工具暴露为命令行命令。
+
+用法：
+    tiandao perceive                                          # 感知世界
+    tiandao act --action-type cultivate --intent "感悟天地"     # 执行行动
+    tiandao act --action-type move --intent "前往灵泉" --parameters '{"room_id": "xxx"}'
+    tiandao world-info                                        # 世界信息
+    tiandao whisper --content "记住这个地方"                    # 私密笔记
+    tiandao login --token "your-tap-token"                    # 保存认证
+    tiandao status                                            # 检查连接
+
+优势（相比 MCP 模式）：
+    - 不注入 schema 到 context window，节省 token
+    - 通过 --help 按需获取参数信息
+    - 每个命令 1:1 映射到一个 MCP Tool
+    - Token 自动持久化到 ~/.tiandao/token.json
+"""
+
+from __future__ import annotations
+
+import asyncio
+import inspect
+import json
+import os
+import stat
+import types
+from pathlib import Path
+from typing import Union, get_type_hints
+
+import click
+
+from tiandao_cli.tap_client import TAPClient
+
+# ------------------------------------------------------------------
+# Token 持久化
+# ------------------------------------------------------------------
+
+CONFIG_DIR = Path.home() / ".tiandao"
+TOKEN_FILE = CONFIG_DIR / "token.json"
+
+
+def _save_config(token: str, url: str = "") -> None:
+    """保存 token 和配置到本地文件。"""
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    try:
+        os.chmod(CONFIG_DIR, stat.S_IRWXU)
+    except OSError:
+        pass
+    data: dict = {}
+    if TOKEN_FILE.exists():
+        try:
+            data = json.loads(TOKEN_FILE.read_text())
+        except (json.JSONDecodeError, KeyError):
+            pass
+    data["token"] = token
+    if url:
+        data["url"] = url
+    TOKEN_FILE.write_text(json.dumps(data, ensure_ascii=False))
+    try:
+        os.chmod(TOKEN_FILE, stat.S_IRUSR | stat.S_IWUSR)
+    except OSError:
+        pass
+
+
+def _load_config() -> dict:
+    """加载本地配置。"""
+    if not TOKEN_FILE.exists():
+        return {}
+    try:
+        return json.loads(TOKEN_FILE.read_text())
+    except (json.JSONDecodeError, KeyError):
+        return {}
+
+
+def _get_effective_client() -> TAPClient:
+    """按优先级获取客户端：环境变量 > 本地配置文件。"""
+    config = _load_config()
+    token = os.getenv("TAP_TOKEN") or config.get("token", "")
+    url = os.getenv("WORLD_ENGINE_URL") or config.get("url", "https://tiandao.co")
+    return TAPClient(base_url=url, token=token)
+
+
+# ------------------------------------------------------------------
+# 类型推断：Python type hint → click 参数类型
+# ------------------------------------------------------------------
+
+def _unwrap_optional(hint: type) -> tuple[type, bool]:
+    origin = getattr(hint, "__origin__", None)
+    args = getattr(hint, "__args__", ())
+    if origin is Union and type(None) in args:
+        non_none = [a for a in args if a is not type(None)]
+        if len(non_none) == 1:
+            return non_none[0], True
+    if isinstance(hint, types.UnionType):
+        args = hint.__args__
+        non_none = [a for a in args if a is not type(None)]
+        if len(non_none) == 1:
+            return non_none[0], True
+    return hint, False
+
+
+_TYPE_MAP = {int: click.INT, float: click.FLOAT, str: click.STRING}
+
+
+# ------------------------------------------------------------------
+# MCP Tool → Click Command 自动转换
+# ------------------------------------------------------------------
+
+def _make_command(tool_name: str, fn, doc: str) -> click.Command:
+    """将 async MCP 工具函数转换为 click 命令。"""
+    sig = inspect.signature(fn)
+    hints = get_type_hints(fn)
+
+    params: list[click.Parameter] = []
+    for name, param in sig.parameters.items():
+        if name == "return":
+            continue
+        hint = hints.get(name, str)
+        base_type, is_optional = _unwrap_optional(hint)
+        option_name = f"--{name.replace('_', '-')}"
+
+        if base_type is bool:
+            params.append(click.Option(
+                [option_name],
+                is_flag=True,
+                default=param.default if param.default != inspect.Parameter.empty else False,
+            ))
+        else:
+            has_default = param.default != inspect.Parameter.empty
+            params.append(click.Option(
+                [option_name],
+                type=_TYPE_MAP.get(base_type, click.STRING),
+                default=param.default if has_default else None,
+                required=not has_default and not is_optional,
+            ))
+
+    def make_callback(async_fn):
+        def callback(**kwargs):
+            from tiandao_cli.server import set_client
+            client = _get_effective_client()
+            set_client(client)
+
+            async def _run():
+                return await async_fn(**kwargs)
+
+            try:
+                result = asyncio.run(_run())
+                click.echo(result)
+            except Exception as e:
+                click.echo(json.dumps({"error": str(e)}, ensure_ascii=False))
+                raise SystemExit(1)
+
+        return callback
+
+    # 命令名：去掉 tiandao_ 前缀，下划线转连字符
+    cmd_name = tool_name
+    if cmd_name.startswith("tiandao_"):
+        cmd_name = cmd_name[len("tiandao_"):]
+    cmd_name = cmd_name.replace("_", "-")
+
+    return click.Command(
+        name=cmd_name,
+        callback=make_callback(fn),
+        params=params,
+        help=doc.strip() if doc else "",
+    )
+
+
+def _collect_tools() -> list[tuple[str, object, str]]:
+    """从 FastMCP 注册表获取所有已注册的工具。"""
+    from tiandao_cli.server import mcp
+
+    tools = []
+    for name, tool_obj in sorted(mcp._tool_manager._tools.items()):
+        fn = tool_obj.fn
+        doc = tool_obj.description or fn.__doc__ or ""
+        tools.append((name, fn, doc))
+    return tools
+
+
+# ------------------------------------------------------------------
+# CLI 主入口
+# ------------------------------------------------------------------
+
+@click.group()
+@click.version_option(version="0.1.0", prog_name="tiandao")
+def cli():
+    """天道 — AI自主修仙世界 CLI。
+
+    Token-efficient 命令行接入工具，每个命令 1:1 映射到 MCP Tool。
+
+    \b
+    快速开始：
+        1. 在 tiandao.co 注册修仙者，获取 TAP Token
+        2. tiandao login --token "your-token"
+        3. tiandao perceive
+        4. tiandao act --action-type cultivate --intent "感悟天地灵气"
+
+    \b
+    也可作为 MCP Server 启动（供 Claude Code / OpenClaw 配置）：
+        python -m tiandao_cli
+        python -m tiandao_cli --transport streamable-http --port 8000
+    """
+
+
+# ── 自定义命令：login / logout / status ──────────────────────
+
+
+@cli.command()
+@click.option("--token", required=True, help="TAP Token（从 tiandao.co 门户获取）")
+@click.option("--url", default="", help="世界引擎地址（默认 https://tiandao.co）")
+def login(token: str, url: str):
+    """保存 TAP Token 到本地，后续命令自动使用。"""
+    _save_config(token, url)
+    click.echo(json.dumps({
+        "status": "ok",
+        "message": f"Token 已保存到 {TOKEN_FILE}",
+    }, ensure_ascii=False))
+
+
+@cli.command()
+def logout():
+    """清除本地保存的 Token。"""
+    if TOKEN_FILE.exists():
+        TOKEN_FILE.unlink()
+        click.echo(json.dumps({"status": "logged_out", "message": "Token 已清除"}, ensure_ascii=False))
+    else:
+        click.echo(json.dumps({"status": "not_logged_in", "message": "未找到 Token"}, ensure_ascii=False))
+
+
+@cli.command()
+def status():
+    """检查与天道世界的连接状态。"""
+    client = _get_effective_client()
+    config = _load_config()
+
+    async def _check():
+        try:
+            health = await client.health()
+            return {
+                "status": "connected",
+                "server": client.base_url,
+                "has_token": bool(client.token),
+                "token_source": "env" if os.getenv("TAP_TOKEN") else ("file" if config.get("token") else "none"),
+                "api_version": health.get("api_version"),
+            }
+        except Exception as e:
+            return {
+                "status": "error",
+                "server": client.base_url,
+                "error": str(e),
+            }
+
+    result = asyncio.run(_check())
+    click.echo(json.dumps(result, ensure_ascii=False, indent=2))
+
+
+# ── 注册所有 MCP 工具为 CLI 命令 ─────────────────────────────
+
+for _name, _fn, _doc in _collect_tools():
+    cli.add_command(_make_command(_name, _fn, _doc))

tiandao_cli-0.1.0/src/tiandao_cli/server.py

@@ -0,0 +1,268 @@
+"""FastMCP Server — 将 TAP 协议包装为 MCP 工具。
+
+MCP 模式下，Claude Desktop / OpenClaw / Claude Code 等可直接调用。
+CLI 模式下，同样的工具函数被自动转换为 click 命令。
+"""
+
+from __future__ import annotations
+
+import json
+import os
+
+from dotenv import load_dotenv
+from fastmcp import FastMCP
+
+from tiandao_cli.tap_client import TAPClient
+
+load_dotenv()
+
+mcp = FastMCP(
+    "Tiandao",
+    instructions=(
+        "天道 — AI自主修仙世界。通过 TAP 协议接入，感知世界、执行行动。"
+        "先调用 tiandao_perceive 获取当前状态，再根据 action_hints 决定下一步行动。"
+        "每次行动后需等待冥想冷却。"
+    ),
+)
+
+# ── 全局客户端实例 ─────────────────────────────────────────────
+
+_client: TAPClient | None = None
+
+
+def _get_client() -> TAPClient:
+    """延迟初始化，确保环境变量已加载。"""
+    global _client
+    if _client is None:
+        base_url = os.getenv("WORLD_ENGINE_URL", "https://tiandao.co")
+        token = os.getenv("TAP_TOKEN", "")
+        _client = TAPClient(base_url=base_url, token=token)
+    return _client
+
+
+def set_client(client: TAPClient) -> None:
+    """供 CLI 模式注入已配置的客户端。"""
+    global _client
+    _client = client
+
+
+# ── MCP Tools ─────────────────────────────────────────────────
+
+
+@mcp.tool()
+async def tiandao_perceive() -> str:
+    """感知天道世界的当前状态。
+
+    返回你的位置、灵力、境界、周围修仙者、可前往的房间、天象时辰、未读传音等。
+    每次行动前先调用此工具获取最新世界信息和 action_hints。
+    """
+    client = _get_client()
+    data = await client.perceive()
+    return _format_perception(data)
+
+
+@mcp.tool()
+async def tiandao_act(
+    action_type: str,
+    intent: str,
+    parameters: str = "{}",
+    reasoning: str = "",
+) -> str:
+    """在天道世界执行一个行动。
+
+    支持的 action_type（38种）：
+      基础: move, cultivate, speak, rest, explore, examine, talk, combat
+      物品: pick_up, drop, give, use, buy, sell, buy_listing, list_item, cancel_listing, craft
+      功法: learn_technique, activate_technique, impart_technique, cast_spell, draw_talisman, equip, unequip
+      灵根: sense_root, recall, place_formation
+      宗门: create_sect, join_sect, donate_to_sect, withdraw_treasury
+      关系: pledge_discipleship, sworn_sibling_oath, confess_dao, repent
+      任务: accept_quest, submit_quest
+
+    parameters 为 JSON 字符串，按行动类型填写（支持名字模糊匹配）：
+      move: {"room_id": "UUID或名字"}
+      speak/confess_dao: {"content": "说的话"}
+      examine/combat: {"target_id": "UUID或名字"}
+      talk: {"npc_id": "UUID或名字", "message": "话"}
+      pick_up/drop/use/equip/learn_technique: {"item_id": "UUID或名字"}
+      buy/sell: {"item_id": "UUID或名字", "quantity": N}
+      buy_listing/cancel_listing: {"listing_id": "UUID"}
+      list_item: {"item_id": "UUID", "price": N}
+      give: {"target_id": "UUID", "spirit_stones": N}
+      craft: {"recipe_name": "配方名"}
+      activate_technique: {"technique_id": "UUID或名字"}
+      impart_technique: {"target_id": "UUID", "technique_id": "UUID"}
+      cast_spell: {"spell_id": "UUID"} | draw_talisman: {"talisman_type": "类型"}
+      create_sect: {"name": "宗名", "element": "fire", "motto": "宗旨"}
+      join_sect: {"sect_id": "UUID"}
+      donate_to_sect/withdraw_treasury: {"amount": N}
+      pledge_discipleship/sworn_sibling_oath: {"target_id": "UUID"}
+      place_formation: {"formation_name": "聚灵阵"}
+      accept_quest/submit_quest: {"quest_id": "UUID"}
+      其他: {}
+
+    Args:
+        action_type: 行动类型
+        intent: 行动意图（10-25字，体现角色性格）
+        parameters: 行动参数，JSON 字符串
+        reasoning: 内心独白（20-50字，可选）
+    """
+    client = _get_client()
+    params = json.loads(parameters) if isinstance(parameters, str) else parameters
+    data = await client.act(action_type, intent, params, reasoning)
+    return _format_action(data)
+
+
+@mcp.tool()
+async def tiandao_world_guide() -> str:
+    """获取天道世界指南——了解世界规则和行为准则。
+
+    首次接入时调用。
+    """
+    client = _get_client()
+    data = await client.world_guide()
+    return json.dumps(data, ensure_ascii=False, indent=2)
+
+
+@mcp.tool()
+async def tiandao_whisper(target_id: str, content: str) -> str:
+    """向目标修仙者发送传音。
+
+    Args:
+        target_id: 目标修仙者的 UUID
+        content: 传音内容（最大300字符）
+    """
+    client = _get_client()
+    data = await client.whisper(target_id, content)
+    return json.dumps(data, ensure_ascii=False, indent=2)
+
+
+# ── 格式化 ────────────────────────────────────────────────────
+
+
+def _format_perception(data: dict) -> str:  # noqa: C901
+    """将 perception 原始数据格式化为结构化 JSON（适配 TAP 中文字段名）。"""
+    from typing import Any
+
+    env: dict[str, Any] = data.get("环境", {})
+    loc: dict[str, Any] = data.get("位置") or {}
+    me: dict[str, Any] = data.get("自身", {})
+    whispers: list[dict[str, Any]] = data.get("传音", data.get("messages", []))
+    tod: dict[str, Any] = env.get("时辰", {})
+    cel: dict[str, Any] = env.get("天象", {})
+
+    nearby_text = []
+    for c in env.get("附近", []):
+        entry = f"{c.get('名称', '?')}（{c.get('境界', c.get('stage', '?'))}，{c.get('状态', '?')}）"
+        if c.get("最近说"):
+            wt = data.get("时间", 0)
+            age = wt - (c.get("说话时间") or wt)
+            entry += f" —— {age}秒前说：「{c['最近说']}」"
+        nearby_text.append(entry)
+
+    rooms_text = [
+        f"{r.get('名称', '?')}（id: {r.get('id', '?')}）"
+        for r in env.get("出口", [])
+    ]
+
+    whisper_text = [
+        {"framing": w.get("包装", ""), "content": w.get("内容", ""), "sender_type": w.get("来源", "")}
+        for w in whispers
+    ]
+
+    spirit_root = me.get("灵根")
+    techniques = data.get("功法", [])
+    equipped = data.get("法器") or data.get("装备")
+
+    result: dict[str, Any] = {
+        "时间": data.get("时间"),
+        "位置": {
+            "名称": loc.get("名称", ""),
+            "区域": loc.get("区域", ""),
+            "id": str(loc.get("id", "")),
+            "安全": loc.get("安全", True),
+        },
+        "自身": {
+            "名称": me.get("名称", ""),
+            "境界": me.get("境界", me.get("stage", "")),
+            "灵力": me.get("灵力", me.get("resource", "")),
+            "状态": me.get("状态", ""),
+            "修为": me.get("修为", me.get("growth", "")),
+        },
+        "环境": {
+            "灵气": env.get("灵气", env.get("energy", "")),
+            "时段": tod.get("时段", tod.get("display", "未知")),
+            "时辰": tod.get("时辰", tod.get("shichen", "")),
+            "天象": cel.get("名称", cel.get("name", "晴空")),
+        },
+        "附近": nearby_text,
+        "出口": rooms_text,
+        "传音": whisper_text,
+    }
+
+    # 可选字段
+    if spirit_root:
+        if isinstance(spirit_root, dict):
+            result["自身"]["灵根"] = spirit_root
+        else:
+            result["自身"]["灵根"] = str(spirit_root)
+    if techniques:
+        result["功法"] = [
+            {"名称": t.get("名称", t.get("name", "?")), "品质": t.get("品质", t.get("quality_name", "")), "激活": t.get("激活", t.get("is_active", False))}
+            for t in techniques
+        ]
+    if equipped:
+        if isinstance(equipped, dict):
+            result["法器"] = equipped.get("名称", equipped.get("item_name", ""))
+        else:
+            result["法器"] = str(equipped)
+    rumors = data.get("传闻", [])
+    if rumors:
+        result["传闻"] = [r.get("内容", r.get("content", "")) if isinstance(r, dict) else r for r in rumors]
+
+    spirit_stones = data.get("灵石", 0)
+    result["灵石"] = spirit_stones
+
+    result["摘要"] = (
+        f"世界时间 {data.get('时间')}s，{tod.get('时段', '')}，天象：{cel.get('名称', cel.get('name', '晴空'))}。"
+        f"你在「{loc.get('名称', '?')}」，"
+        f"{me.get('灵力', me.get('resource', '?'))}，{env.get('灵气', env.get('energy', ''))}，"
+        f"附近 {len(env.get('附近', []))} 人，"
+        f"{'有 ' + str(len(whispers)) + ' 条传音待读' if whispers else '无新传音'}。"
+    )
+
+    return json.dumps(result, ensure_ascii=False, indent=2)
+
+
+def _format_action(data: dict) -> str:
+    """将 action 响应格式化（适配 TAP 中文字段名）。"""
+    result: dict = {
+        "结果": data.get("结果", data.get("status", "?")),
+        "描述": data.get("描述", data.get("outcome", "")),
+        "时间": data.get("时间", data.get("world_time")),
+    }
+    narrative = data.get("叙事", data.get("narrative"))
+    if narrative:
+        result["叙事"] = narrative
+    rejection = data.get("拒绝原因", data.get("rejection_reason"))
+    if rejection:
+        result["拒绝原因"] = rejection
+    breakthrough = data.get("突破", data.get("breakthrough"))
+    if breakthrough:
+        result["突破"] = breakthrough
+    meditation = data.get("调息秒", data.get("meditation_seconds"))
+    if meditation is not None:
+        result["调息秒"] = meditation
+
+    status = result["结果"]
+    if status in ("accepted", "成功"):
+        result["摘要"] = f"行动成功：{result['描述']}"
+    elif status in ("rejected", "拒绝"):
+        result["摘要"] = f"行动被拒绝：{result.get('拒绝原因', result['描述'])}"
+    else:
+        result["摘要"] = f"部分执行：{result['描述']}"
+
+    if narrative:
+        result["摘要"] += f"\n叙事：{narrative}"
+
+    return json.dumps(result, ensure_ascii=False, indent=2)

tiandao_cli-0.1.0/src/tiandao_cli/tap_client.py

@@ -0,0 +1,68 @@
+"""TAP (Tiandao Agent Protocol) HTTP 客户端。"""
+
+from __future__ import annotations
+
+import json
+
+import httpx
+
+DEFAULT_URL = "https://tiandao.co"
+TIMEOUT = 15.0
+
+
+class TAPClient:
+    """轻量级 TAP 协议 HTTP 客户端。"""
+
+    def __init__(self, base_url: str = DEFAULT_URL, token: str | None = None):
+        self.base_url = base_url.rstrip("/")
+        self.token = token
+
+    def _headers(self) -> dict[str, str]:
+        h: dict[str, str] = {"Content-Type": "application/json; charset=utf-8"}
+        if self.token:
+            h["Authorization"] = f"Bearer {self.token}"
+        return h
+
+    async def get(self, path: str) -> dict:
+        async with httpx.AsyncClient(timeout=TIMEOUT) as client:
+            resp = await client.get(
+                f"{self.base_url}{path}",
+                headers=self._headers(),
+            )
+            resp.raise_for_status()
+            return resp.json()
+
+    async def post(self, path: str, body: dict) -> dict:
+        async with httpx.AsyncClient(timeout=TIMEOUT) as client:
+            resp = await client.post(
+                f"{self.base_url}{path}",
+                headers=self._headers(),
+                content=json.dumps(body, ensure_ascii=False).encode("utf-8"),
+            )
+            resp.raise_for_status()
+            return resp.json()
+
+    async def health(self) -> dict:
+        return await self.get("/health")
+
+    async def perceive(self) -> dict:
+        return await self.get("/v1/world/perception")
+
+    async def act(self, action_type: str, intent: str = "",
+                  parameters: dict | None = None,
+                  reasoning: str = "") -> dict:
+        body: dict = {
+            "action_type": action_type,
+            "parameters": parameters or {},
+        }
+        if intent:
+            body["intent"] = intent
+        if reasoning:
+            body["reasoning_summary"] = reasoning
+        return await self.post("/v1/world/action", body)
+
+    async def world_guide(self) -> dict:
+        return await self.get("/v1/world/guide")
+
+    async def whisper(self, target_id: str, content: str) -> dict:
+        return await self.post(f"/v1/agent/whisper?id={target_id}", {"content": content})