tdxd

TDX-Daemon — Paperclip TDX-Adapter 的远端守护进程：以「会话即进程」驱动 ACP Agent（opencode），提供会话续接、人在环权限审批、usage 计量回填；随包附带跨平台实例管理器 tdxd-ctl。

安装

npm install -g @iamlbccc/tdxd        # Node.js >= 24

快速开始

方式一：邀请制自助接入（推荐，AI 执行）

平台 UI 生成邀请 → 把 ONBOARD-PROMPT.md 的接入卡发给 Host 上的 AI Agent，一条命令完成：

npx @tdx/tdxd@latest onboard --invite <INVITE_URL> --workspace .
# init → start → join → 等批准(轮询) → claim key 自动回填 → READY

方式二：手工分步（人执行）

# 1. 初始化（纯 flags，skills 默认装配：paperclip 心跳 + converting-plans 分派）
tdxd-ctl init my-agent --workspace ~/workspaces/my-agent

# 2. 启动并自检（health=200 即就绪）
tdxd-ctl start my-agent && tdxd-ctl status my-agent

# 3. 平台 UI hire（TDX-Adapter），粘贴 init 打印的 endpoint/token
# 4. 铸 agent key 回填：tdxd-ctl key my-agent --set pcp_xxx && tdxd-ctl restart my-agent

实例布局（agent-first，每 Agent 一套内聚目录）：

$TDXD_HOME（默认 ~/.tdx）/agents/<name>/
├── config.json     # 端口/workspace/权限白名单/模型价目
├── secret.env      # 共享 token + 平台回调 key（600）
├── log/tdxd.log
└── run/pid

命令

tdxd-ctl init <name>        交互式脚手架（--yes 可脚本化）
tdxd-ctl list               实例一览
tdxd-ctl start|stop|restart|status  [name|all]

运行前提

• Node.js >= 24；目标 Agent 的 ACP 运行时（如 opencode）
• 一台可达的 Paperclip 平台（TDX-Adapter 热装）

License

MIT