@social-data/social-neuron-subscription 1.0.0-beta.0

package/bin/cli.js

@@ -0,0 +1,213 @@
+#!/usr/bin/env node
+"use strict";
+
+// ⚠️ 本文件由 backend/app/cli_spec/gen.py 生成,请勿手改;要改改 gen.py 的 _CLI_JS 后重跑 gen。
+//
+// 能力 CLI —— 通用薄运行时(纯 JS,零依赖):一能力一命令、一包、一配置文件,互不影响。
+//   <cmd> <action> [--flags]                       调用一条命令
+//   <cmd> [-h] / <cmd> <action> -h                 帮助
+//   <cmd> bind --api-url <url> --token <token>     写 ~/.social-neuron/<key>_config.json
+//   <cmd> bind --logout                            删除该配置文件
+//   <cmd> skills install [dir]                     覆盖写入 SKILL.md
+// 能力 key / 命令名全部来自同包 manifest.json(见 CAPABILITY / COMMAND);换能力只改 manifest。
+
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+
+const MANIFEST = require(path.join(__dirname, "..", "manifest.json"));
+const VERSION = require(path.join(__dirname, "..", "package.json")).version;
+const CAPABILITY = MANIFEST.capability;                                 // ← 能力 key(来自 manifest)
+const COMMAND = MANIFEST.command || ("social-neuron-" + CAPABILITY);    // ← 命令名(来自 manifest)
+
+const EXIT = { auth_error: 3, validation: 2, config: 2, network: 4, outdated: 2 };
+
+// 配置:一能力一文件 ~/.social-neuron/<key>_config.json,扁平 {api_url, token}(不区分环境)。
+function configPath() {
+  const dir = process.env.NEURON_CONFIG_DIR || path.join(os.homedir(), ".social-neuron");
+  return path.join(dir, CAPABILITY + "_config.json");
+}
+function resolveConfig() {
+  let api = process.env.NEURON_API_BASE_URL || "";
+  let token = process.env.NEURON_TOKEN || "";
+  try {
+    const cfg = JSON.parse(fs.readFileSync(configPath(), "utf8"));
+    api = api || cfg.api_url || "";
+    token = token || cfg.token || "";
+  } catch (_e) { /* 无配置文件:仅用 env */ }
+  return { api: api.replace(/\/+$/, ""), token };
+}
+
+function emit(env) {
+  process.stdout.write(JSON.stringify(env) + "\n");
+  process.exit(env.ok ? 0 : (EXIT[env.error && env.error.type] ?? 1));
+}
+function fail(type, code, message, extra) {
+  emit({ ok: false, error: { type, code, message, ...(extra || {}) } });
+}
+
+// 网关统一 {code,msg,data}(code=0 成功)→ 归一化 {ok,data|error}。
+function forgeType(code) {
+  const s = String(code);
+  if (s.startsWith("401") || s.startsWith("403")) return "auth_error";
+  if (s.startsWith("426")) return "outdated";
+  if (s.startsWith("422") || s.startsWith("400")) return "validation";
+  return "api_error";
+}
+function normalize(body) {
+  if (body && typeof body.ok === "boolean") return body;
+  if (body && Object.prototype.hasOwnProperty.call(body, "code")) {
+    if (body.code === 0) return { ok: true, data: body.data };
+    const type = forgeType(body.code);
+    let message = body.msg || "";
+    if (type === "outdated") message += "(升级后请重新加载 SKILL.md 与 manifest 再调用)";
+    return { ok: false, error: { type, code: body.code, message } };
+  }
+  return { ok: false, error: { type: "api_error", code: "UNKNOWN", message: JSON.stringify(body).slice(0, 200) } };
+}
+
+function findCmd(action) { return MANIFEST.tools.find((t) => t.action === action); }
+function _flag(a, name) { const i = a.indexOf(name); return i >= 0 ? a[i + 1] : undefined; }
+
+// bind:只写本能力自己的配置文件(原子写 + 0600);--logout 删该文件。互不影响其它能力。
+function doBind(a) {
+  const cfgPath = configPath();
+  if (a.includes("--logout")) {
+    try { fs.unlinkSync(cfgPath); process.stderr.write("[" + COMMAND + "] 已清除配置 " + cfgPath + "\n"); }
+    catch (_e) { process.stderr.write("[" + COMMAND + "] 无配置可清除\n"); }
+    return;
+  }
+  const api = _flag(a, "--api-url");
+  const token = _flag(a, "--token");
+  if (!api || !token) {
+    return fail("validation", "BIND_ARGS", "bind 需要 --api-url 与 --token", {
+      usage: { example: COMMAND + " bind --api-url http://host/api/v2 --token <token>" },
+    });
+  }
+  const cfg = { api_url: api.replace(/\/+$/, ""), token };
+  fs.mkdirSync(path.dirname(cfgPath), { recursive: true });
+  const tmp = cfgPath + ".tmp";
+  fs.writeFileSync(tmp, JSON.stringify(cfg, null, 2), { mode: 0o600 });
+  fs.renameSync(tmp, cfgPath); // 原子替换
+  process.stderr.write("[" + COMMAND + "] 已绑定 → " + cfg.api_url + "  (" + cfgPath + ")\n");
+  printWelcome();
+}
+
+function skillsDir() { return process.env.OPENCLAW_SKILLS_DIR || path.join(os.homedir(), ".openclaw", "skills"); }
+function printWelcome() {
+  const w = (s) => process.stderr.write(s + "\n");
+  const skill = MANIFEST.skill;
+  const dir = skillsDir();
+  w("");
+  w("──────────────────────────────────────────────");
+  w("  " + COMMAND + " v" + VERSION + " · 已就绪(能力:" + CAPABILITY + ")");
+  w("  命令:");
+  for (const t of MANIFEST.tools) w("      " + COMMAND + " " + t.action + "  —  " + t.summary);
+  if (skill) { w(""); w("  Agent 需加载 SKILL.md:"); w("      " + path.join(dir, skill.slug, "SKILL.md")); }
+  w("");
+  w("  下一步:" + COMMAND + " <action> -h 查看入参;" + COMMAND + " skills install 重写技能文件");
+  w("──────────────────────────────────────────────");
+}
+
+function usageOf(cmd) {
+  const line = (f) => "  " + f.flag + "  " + f.type + (f.required ? "  required" : "  optional") + "  " + (f.desc || "");
+  const req = cmd.flags.filter((f) => f.required), opt = cmd.flags.filter((f) => !f.required);
+  return {
+    command: COMMAND + " " + cmd.action,
+    required: req.map((f) => ({ flag: f.flag, type: f.type, desc: f.desc })),
+    optional: opt.map((f) => ({ flag: f.flag, type: f.type, desc: f.desc })),
+    example: (COMMAND + " " + cmd.action + " " + req.map((f) => f.flag + " <v>").join(" ")).trim(),
+    _text: [COMMAND + " " + cmd.action + " — " + cmd.summary, "Inputs:", ...cmd.flags.map(line)].join("\n"),
+  };
+}
+function printHelp(action) {
+  const w = (s) => process.stderr.write(s + "\n");
+  if (action) {
+    const c = findCmd(action);
+    if (!c) return fail("validation", "UNKNOWN_COMMAND", "未知命令 " + action);
+    const u = usageOf(c); w(u._text); w(""); w("示例:" + u.example); return process.exit(0);
+  }
+  w(COMMAND + " v" + VERSION + " — Social Neuron 能力 CLI(能力:" + CAPABILITY + ";供 AI agent 调用)");
+  w("");
+  w("用法:" + COMMAND + " <action> [--flags]");
+  w("  标量 --flag v;数组 --flag a,b;对象 --flag '<json>';写/删/触发加 -y");
+  w("");
+  w("命令:");
+  for (const c of MANIFEST.tools) w("  " + COMMAND + " " + c.action + "  —  " + c.summary);
+  w("");
+  w("其它:");
+  w("  " + COMMAND + " <action> -h                       查看某命令完整入参/出参");
+  w("  " + COMMAND + " bind --api-url <url> --token <t>  绑定网关+令牌(写 " + configPath() + ")");
+  w("  " + COMMAND + " bind --logout                     删除本能力配置");
+  w("  " + COMMAND + " skills install [dir]              覆盖写入 SKILL.md 到 ~/.openclaw/skills");
+  w("  " + COMMAND + " --version");
+  w("");
+  w("鉴权/网关:env NEURON_API_BASE_URL / NEURON_TOKEN 覆盖配置;令牌走头 X-Social-Neuron-CLI-Key。");
+  process.exit(0);
+}
+
+function parseArgs(cmd, argv) {
+  const byFlag = Object.fromEntries(cmd.flags.map((f) => [f.flag, f]));
+  const args = {};
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "-y") continue;
+    if (!a.startsWith("--")) continue;
+    const f = byFlag[a];
+    if (!f) return { err: fail("validation", "UNKNOWN_FLAG", "未知参数 " + a) };
+    const raw = argv[++i];
+    if (raw === undefined) return { err: fail("validation", "MISSING_VALUE", a + " 缺少取值") };
+    let val = raw;
+    if (f.type.startsWith("list")) val = raw.split(",").map((s) => s.trim()).filter(Boolean);
+    else if (f.type.startsWith("object")) { try { val = JSON.parse(raw); } catch { return { err: fail("validation", "BAD_JSON", a + " 需为合法 JSON") }; } }
+    else if (f.type === "integer") val = Number(raw);
+    args[f.field] = val;
+  }
+  return { args };
+}
+
+async function main() {
+  const argv = process.argv.slice(2);
+  if (argv.length === 0 || argv[0] === "--help" || argv[0] === "-h") return printHelp();
+  if (argv[0] === "--version" || argv[0] === "-V") { process.stdout.write(VERSION + "\n"); return; }
+  if (argv[0] === "bind") return doBind(argv.slice(1));
+  if (argv[0] === "skills" && argv[1] === "install") { require(path.join(__dirname, "install-skills.js")).installTo(argv[2]); return; }
+
+  const [action, ...rest] = argv;
+  if (rest.includes("--help") || rest.includes("-h")) return printHelp(action);
+
+  const cmd = findCmd(action);
+  if (!cmd) return fail("validation", "UNKNOWN_COMMAND", "未知命令 " + action);
+
+  const parsed = parseArgs(cmd, rest);
+  if (parsed.err) return;
+  const { args } = parsed;
+  const missing = cmd.flags.filter((f) => f.required && args[f.field] === undefined).map((f) => f.flag);
+  if (missing.length) return fail("validation", "INVALID_ARGS", "缺少必填参数:" + missing.join(" "), { usage: usageOf(cmd) });
+
+  const { api, token } = resolveConfig();
+  if (!api) return fail("config", "CONFIG", "未配置网关地址(" + COMMAND + " bind 或 env NEURON_API_BASE_URL)");
+  if (!token) return fail("auth_error", "AUTH_MISSING", "未配置 token(" + COMMAND + " bind 或 env NEURON_TOKEN)");
+
+  try {
+    // 直达能力级出口 /{key}/{op};body 即该 op 的入参对象(send=args)。
+    const res = await fetch(api + cmd.transport.path, {
+      method: cmd.transport.method,
+      headers: {
+        "X-Social-Neuron-CLI-Key": token,
+        "Content-Type": "application/json",
+        "X-Caller": "ai-agent",
+        "X-Neuron-CLI-Version": VERSION,
+        "X-Neuron-Manifest-Rev": String(MANIFEST.revision),
+      },
+      body: JSON.stringify(args),
+      signal: AbortSignal.timeout(30000),
+    });
+    const text = await res.text();
+    let body;
+    try { body = JSON.parse(text); } catch { return fail("api_error", "HTTP_" + res.status, text.slice(0, 200)); }
+    emit(normalize(body));
+  } catch (e) { fail("network", "NETWORK", "连接网关失败: " + e.message); }
+}
+
+main();

package/bin/install-skills.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+"use strict";
+
+// ⚠️ 本文件由 backend/app/cli_spec/gen.py 生成,请勿手改。
+// postinstall:把包内 SKILL.md 覆盖写到 OpenClaw 技能目录(OPENCLAW_SKILLS_DIR 或 ~/.openclaw/skills)。
+
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+
+function installTo(dir) {
+  const dst = dir || process.env.OPENCLAW_SKILLS_DIR || path.join(os.homedir(), ".openclaw", "skills");
+  const src = path.join(__dirname, "..", "skills");
+  if (!fs.existsSync(src)) { console.error("[neuron] no bundled skills; skip"); return; }
+  const written = [];
+  for (const name of fs.readdirSync(src)) {
+    const from = path.join(src, name);
+    if (!fs.statSync(from).isDirectory()) continue;
+    const to = path.join(dst, name);
+    fs.mkdirSync(to, { recursive: true });
+    for (const f of fs.readdirSync(from)) { fs.copyFileSync(path.join(from, f), path.join(to, f)); written.push(path.join(to, f)); }
+  }
+  console.error("[neuron] skills → " + dst + " (" + written.length + " files)");
+  for (const f of written.filter((p) => p.endsWith(".md"))) console.error("[neuron]   加载:" + f);
+}
+
+module.exports = { installTo };
+
+if (require.main === module) {
+  try { installTo(); } catch (e) { console.error("[neuron] install-skills skipped:", e.message); }
+}