@iamlbccc/tdxd 1.1.1 → 1.2.0

package/ONBOARD-PROMPT.md

@@ -0,0 +1,44 @@
+# TDX-Daemon 接入卡（Prompt 模板）
+
+> 用途：平台操作员在 Paperclip UI 生成"邀请 Agent"后，把下面的提示词发给任意 Host 上的
+> AI Agent（如 opencode/Claude Code 等，具备 shell 执行能力即可），Agent 自助完成接入。
+> 使用方法：替换 `<INVITE_URL>` 与 `<WORKSPACE>` 两个占位符后整段发送。
+
+---
+
+你是运行在本机的 AI Agent。请自助接入 Paperclip 平台，成为组织中的远程成员。
+
+## 执行步骤
+
+1. 运行接入命令（会自动完成：创建实例 → 启动 daemon → 提交入职 → 等待批准 → 领取 API key）：
+
+```bash
+npx @tdx/tdxd@latest onboard \
+  --invite <INVITE_URL> \
+  --workspace <WORKSPACE> \
+  --capabilities "<用一句话概括你的能力>"
+```
+
+- `<INVITE_URL>`：邀请文档地址（形如 `http://<平台>:3100/api/invites/pcp_invite_xxx/onboarding.txt`）
+- `<WORKSPACE>`：你的工作目录（Agent 干活时的 repo 根目录）
+- 前置条件：Node.js ≥ 24、本机已安装 opencode
+
+2. 命令会在「4/4 等待 board 批准」处轮询暂停。此时**提醒你的用户**：
+   "已提交入职申请，请到 Paperclip 平台（组织 → 入职/Join 请求）批准我的加入"。
+   批准后命令自动继续并完成 key 领取。
+
+3. 看到 `✓ READY <实例名> health=200 回调:启用` 即接入完成。
+   向用户报告实例名与 endpoint，并提示：在平台向我派发一个测试任务即可验收。
+
+4. 执行前自查：`node --version`（≥24）、`command -v opencode`；缺失先报告用户再继续。
+
+## 失败处置
+
+- 命令中途退出（如批准超时）：状态已保存，用户批准后**重跑同一条命令**即断点续接
+- `claimSecret 已过期`：请用户重新生成邀请，再重跑
+- 平台不可达：报告用户检查网络或让平台执行 `npx paperclipai allowed-hostname <本机可达平台的主机名>`
+
+## 纪律
+
+- 不要打印、记录或转述任何完整 token / key（命令输出只含掩码，明文仅写入 secret.env）
+- 接入完成后你的 API key 已由 daemon 托管，无需手动管理

package/README.md

@@ -10,15 +10,26 @@ npm install -g @iamlbccc/tdxd        # Node.js >= 24
 
 ## 快速开始
 
+### 方式一：邀请制自助接入（推荐，AI 执行）
+
+平台 UI 生成邀请 → 把 [ONBOARD-PROMPT.md](./ONBOARD-PROMPT.md) 的接入卡发给 Host 上的 AI Agent，一条命令完成：
+
+```bash
+npx @tdx/tdxd@latest onboard --invite <INVITE_URL> --workspace .
+# init → start → join → 等批准(轮询) → claim key 自动回填 → READY
+```
+
+### 方式二：手工分步（人执行）
+
 ```bash
-# 1. 初始化一个 Agent 实例（交互式向导：config + token + workspace 骨架）
-tdxd-ctl init my-agent
+# 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
+tdxd-ctl start my-agent && tdxd-ctl status my-agent
 
-# 3. 在 Paperclip 平台 UI hire Agent（选 TDX-Adapter），粘贴 init 打印的 endpoint/token
+# 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 一套内聚目录）：

package/lib/tpl.mjs

@@ -1,6 +1,7 @@
-// init 脚手架模板：实例 config / workspace 骨架（AGENTS.md 角色模板 + opencode.json）
+// init 脚手架模板：实例 config（不生成任何 workspace 文件——daemon 帮现存 Agent 接入，不制造 Agent）
+// 模型/价目一律沿用 workspace 自身配置，不在实例 config 里覆盖或占位
 
-export function configTpl({ name, displayName, port, workspace, model, url }) {
+export function configTpl({ displayName, port, workspace, url }) {
   return `${JSON.stringify({
     name: displayName,
     port,
@@ -22,56 +23,19 @@ export function configTpl({ name, displayName, port, workspace, model, url }) {
         { command: "^(jq|echo|cd|sleep|mkdir +-p +/tmp/opencode)\\b" },
       ],
     },
-    pricing: {
-      models: {
-        [model]: {
-          inputPerMillion: 0.6,
-          cachedReadPerMillion: 0.15,
-          outputPerMillion: 2.5,
-          _doc: "占位价（USD/百万token）：请按模型官方定价校准",
-        },
-      },
-    },
   }, null, 2)}\n`;
 }
 
-export function opencodeJsonTpl(model) {
-  return `${JSON.stringify({ $schema: "https://opencode.ai/config.json", model }, null, 2)}\n`;
+/** 从 workspace 既有 opencode 配置探测模型（.opencode/opencode.json 或 opencode.json），探测不到返回 null */
+export function detectModel(workspace) {
+  for (const p of [".opencode/opencode.json", "opencode.json"]) {
+    try {
+      const j = JSON.parse(fs.readFileSync(path.join(workspace, p), "utf8"));
+      if (typeof j.model === "string" && j.model) return j.model;
+    } catch { /* 不存在或非法 → 下一处 */ }
+  }
+  return null;
 }
 
-const PERSONAS = {
-  manager: `# {NAME}
-
-你是团队负责人（Manager）。收到任务时：
-
-- 先判断：亲自做、拆分给合适成员、还是需要澄清——不确定就到任务里提问，不要猜
-- 拆分时建子任务（子任务写清背景/验收标准/依赖），设置好阻塞关系再分派
-- 跟踪进度：关注子任务状态，全部完成后汇总收尾、更新父任务
-- 输出简洁：状态行 + 要点列表，明确"已完成/待办/谁负责"
-`,
-  coder: `# {NAME}
-
-你是开发工程师。收到任务时：
-
-- 先读相关代码再动手；改动遵循仓库现有风格与约定
-- 改完必须验证（跑最窄的相关测试/编译），验证不了要明说
-- 提交信息简洁；在任务评论里留下：改了什么、为什么、如何验证
-- 发现超出本任务的问题：记录，不擅自扩大改动面
-`,
-  qa: `# {NAME}
-
-你是测试工程师。收到任务时：
-
-- 明确被测对象与验收标准；先设计用例覆盖正常/边界/异常路径
-- 如实报告：通过/失败逐条列出，失败附复现步骤与期望结果
-- 不掩盖问题，不为了"通过"放宽标准
-`,
-  blank: `# {NAME}
-
-（在此描述该 Agent 的角色职责与工作规范。）
-`,
-};
-
-export function agentsMdTpl(persona, name) {
-  return (PERSONAS[persona] ?? PERSONAS.blank).replaceAll("{NAME}", name);
-}
+import fs from "node:fs";
+import path from "node:path";

package/lib/ui.mjs

@@ -1,102 +1,56 @@
-// 零依赖交互式提示（跨平台）：ask / confirm / select
-// TTY：方向键选择；非 TTY（管道/CI）：自动降级为编号输入
-import readline from "node:readline";
-import readlinePromises from "node:readline/promises";
-import { once } from "node:events";
+// 呈现层（非 TTY 自动去色，尊重管道）
+// 注：无交互提示——ctl 面向 AI 调用/脚本化，输入一律走命令行 flags
 import process from "node:process";
 
 const isTTY = process.stdin.isTTY && process.stdout.isTTY;
-const C = { cyan: (s) => `\x1b[36m${s}\x1b[0m`, green: (s) => `\x1b[32m${s}\x1b[0m`, dim: (s) => `\x1b[2m${s}\x1b[0m`, bold: (s) => `\x1b[1m${s}\x1b[0m` };
 
 export function out(s = "") { process.stdout.write(s + "\n"); }
-
-// TTY：共享单个 readline 逐问读取
-let sharedRl = null;
-function getRl() {
-  return sharedRl ??= readlinePromises.createInterface({ input: process.stdin, output: process.stdout });
-}
-export function closePrompt() { sharedRl?.close(); sharedRl = null; }
-
-// 非TTY（管道/CI）：readline 管道模式在首个应答后会暂停输入流，顺序提问必挂；
-// 改为启动即挂常驻 line 监听，一次性收完全部输入，提问从队列按序取
-let lineQueue = null;
-let queueReady = null;
-function warmupNonTty() {
-  if (!queueReady) {
-    const lines = [];
-    const rl = readline.createInterface({ input: process.stdin, terminal: false });
-    rl.on("line", (l) => lines.push(l));
-    queueReady = once(rl, "close").then(() => { lineQueue = lines; });
-  }
-  return queueReady;
-}
-
-async function question(prompt) {
-  if (!isTTY) {
-    process.stdout.write(prompt);
-    await warmupNonTty();
-    return (lineQueue.shift() ?? "").trim();
-  }
-  const rl = getRl();
-  try { return ((await rl.question(prompt)) ?? "").trim(); }
-  catch { return ""; }
+export function closePrompt() { /* 兼容占位（已无交互） */ }
+
+const ANSI = {
+  green: (s) => `\x1b[32m${s}\x1b[0m`,
+  red: (s) => `\x1b[31m${s}\x1b[0m`,
+  yellow: (s) => `\x1b[33m${s}\x1b[0m`,
+  cyan: (s) => `\x1b[36m${s}\x1b[0m`,
+  dim: (s) => `\x1b[2m${s}\x1b[0m`,
+  bold: (s) => `\x1b[1m${s}\x1b[0m`,
+};
+function paint(s, kind) { return isTTY && ANSI[kind] ? ANSI[kind](s) : s; }
+
+export function ok(s) { out(`${paint("✓", "green")} ${s}`); }
+export function fail(s) { out(`${paint("✗", "red")} ${s}`); }
+export function warn(s) { out(`${paint("⚠", "yellow")} ${s}`); }
+export function head(s) { out(paint(s, "bold")); }
+export function note(s) { out(paint(s, "dim")); }
+/** 行内局部着色（与非 TTY 自动降级一致） */
+export const tGreen = (s) => paint(s, "green");
+export const tRed = (s) => paint(s, "red");
+export const tYellow = (s) => paint(s, "yellow");
+export const tDim = (s) => paint(s, "dim");
+export const tCyan = (s) => paint(s, "cyan");
+export const tBold = (s) => paint(s, "bold");
+export const cell = (text, color) => ({ text: String(text), color });
+
+/** CJK 感知的显示宽度（中文按 2 列计） */
+export function dispWidth(s) {
+  let w = 0;
+  for (const ch of String(s)) w += /[\u1100-\u115F\u2E80-\u303F\u3041-\u33FF\u4E00-\u9FFF\uA000-\uA4CF\uAC00-\uD7A3\uF900-\uFAFF\uFE30-\uFE6F\uFF00-\uFF60\uFFE0-\uFFE6]/.test(ch) ? 2 : 1;
+  return w;
 }
-
-export async function ask(message, def = "") {
-  const suffix = def !== "" && def != null ? C.dim(` (${def})`) : "";
-  const v = await question(`${C.cyan("?")} ${message}${suffix}: `);
-  return v === "" ? String(def ?? "") : v;
-}
-
-export async function confirm(message, def = true) {
-  const hint = def ? "Y/n" : "y/N";
-  const v = (await question(`${C.cyan("?")} ${message} ${C.dim(`(${hint})`)}: `)).toLowerCase();
-  if (v === "") return def;
-  return v.startsWith("y");
-}
-
-/** 选项选择：TTY 用 ↑↓+回车；非 TTY 用编号。返回 { value, label } */
-export async function select(message, options, defIndex = 0) {
-  if (!isTTY) {
-    out(`${C.cyan("?")} ${message}`);
-    options.forEach((o, i) => out(`  ${C.bold(i + 1)}. ${o.label}${o.description ? C.dim(`  — ${o.description}`) : ""}`));
-    const v = await question(`  输入编号 ${C.dim(`[1-${options.length}, 默认 ${defIndex + 1}]`)}: `);
-    const i = Number(v) - 1;
-    return options[Number.isInteger(i) && i >= 0 && i < options.length ? i : defIndex];
-  }
-  return new Promise((resolve) => {
-    let idx = defIndex;
-    const render = () => {
-      readline.cursorTo(process.stdout, 0, 0);
-      readline.clearScreenDown(process.stdout);
-      out(`${C.cyan("?")} ${message} ${C.dim("(↑↓ 选择, 回车确认)")}`);
-      options.forEach((o, i) => out(`  ${i === idx ? C.green("❯") : " "} ${i === idx ? C.green(o.label) : o.label}${o.description ? C.dim(`  — ${o.description}`) : ""}`));
-    };
-    readline.emitKeypressEvents(process.stdin);
-    process.stdin.setRawMode(true);
-    const rawCols = process.stdout.columns;
-    process.stdout.rows = options.length + 2;
-    if (!rawCols) process.stdout.columns = 80;
-    render();
-    process.stdin.resume();
-    const onData = (_, key) => {
-      if (key.name === "up") { idx = (idx - 1 + options.length) % options.length; render(); }
-      else if (key.name === "down") { idx = (idx + 1) % options.length; render(); }
-      else if (key.name === "return" || key.name === "space") {
-        cleanup(); resolve(options[idx]);
-      } else if (key.name === "c" && key.ctrl) {
-        cleanup(); process.exit(130);
-      } else if (key.sequence === "3") { /* 忽略 */ }
-    };
-    const origCols = rawCols;
-    function cleanup() {
-      process.stdin.removeListener("keypress", onData);
-      process.stdin.setRawMode(false);
-      process.stdin.pause();
-      process.stdout.columns = origCols;
-      readline.cursorTo(process.stdout, 0, options.length + 1);
-      out(C.dim(`  已选: ${options[idx].label}`));
-    }
-    process.stdin.on("keypress", onData);
-  });
+function padCell(s, width) { return s + " ".repeat(Math.max(0, width - dispWidth(s))); }
+
+/** 对齐表格：headers: string[], rows: (string|{text,color})[][]。先填充后着色，末列不补空格 */
+export function table(headers, rows) {
+  const raw = (c) => (typeof c === "object" && c ? c.text : c);
+  const col = (c) => (typeof c === "object" && c ? c.color : undefined);
+  const all = [headers, ...rows];
+  const widths = headers.map((_, i) => Math.max(...all.map((r) => dispWidth(raw(r[i]) ?? ""))));
+  const last = headers.length - 1;
+  const render = (r) => r.map((c, i) => {
+    const padded = i === last ? raw(c) ?? "" : padCell(raw(c) ?? "", widths[i]);
+    return paint(padded, col(c));
+  }).join("  ");
+  out(render(headers.map((h) => cell(h, "dim"))));
+  out(widths.map((w, i) => paint(i === last ? "" : "─".repeat(w), "dim")).join("  ").trimEnd());
+  for (const r of rows) out(render(r));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iamlbccc/tdxd",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "TDX-Daemon — remote daemon for Paperclip TDX-Adapter: drives ACP agents (opencode) with session-per-process, permission approval loop, usage metering; ships cross-platform tdxd-ctl (init/scaffold/start/stop/status)",
   "type": "module",
   "license": "MIT",
@@ -12,10 +12,12 @@
     "tdxd-ctl": "./tdxd-ctl.mjs"
   },
   "files": [
+    "skills/",
     "tdxd.mjs",
     "tdxd-ctl.mjs",
     "lib/",
     "config.example.json",
+    "ONBOARD-PROMPT.md",
     "README.md"
   ],
   "keywords": [