@yep-ai/cli 0.0.0-stage → 1.0.1

package/README.md

@@ -1,3 +1,92 @@
-# Temporary Holding Version
+# @yep-ai/cli · Yep Marketplace CLI
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`@yep-ai/cli` 提供统一的 `yep` 命令，支持市场操作、Git 内容版本和设备节点。需要 Node.js 22+。
+
+## 安装与使用
+
+```sh
+npx --yes @yep-ai/cli@latest --help
+```
+
+通过 npx 直接运行 npm 最新版，无需全局安装：
+
+```sh
+npx --yes @yep-ai/cli@latest --help
+npx --yes @yep-ai/cli@latest device start --server https://yep.nihao.cool
+```
+
+本包包含完整实现。`yep-cli` 是计划中的同版本入口包，当前尚未发布本项目版本，请使用 `@yep-ai/cli`。
+
+## 开发与本地安装
+
+仓库根目录执行：
+
+```sh
+npm install
+npm run yep -- --help
+npm run pack:cli
+npm install --prefix ./tmp/yep-install ./dist/cli/scoped/yep-ai-cli-1.0.1.tgz ./dist/cli/unscoped/yep-cli-1.0.1.tgz
+./tmp/yep-install/node_modules/.bin/yep --version
+```
+
+完整实现包为 `scoped/yep-ai-cli-1.0.1.tgz`，入口包为 `unscoped/yep-cli-1.0.1.tgz`。本地验证时可一起指定两份文件，无需从 npm 下载实现包。输出的 `manifest.json` 记录包名、版本、依赖和 SHA-256。
+
+## 市场与 Git 内容版本
+
+```sh
+npx --yes @yep-ai/cli@latest login --registry https://yep.nihao.cool
+npx --yes @yep-ai/cli@latest whoami
+npx --yes @yep-ai/cli@latest search assistant
+npx --yes @yep-ai/cli@latest info @creator/demo
+npx --yes @yep-ai/cli@latest client set codex,claude
+npx --yes @yep-ai/cli@latest install @creator/demo --client codex
+npx --yes @yep-ai/cli@latest list
+npx --yes @yep-ai/cli@latest list --remote
+npx --yes @yep-ai/cli@latest list --mine
+npx --yes @yep-ai/cli@latest uninstall @creator/demo --client codex
+npx --yes @yep-ai/cli@latest publish ./my-skill
+npx --yes @yep-ai/cli@latest history @creator/demo
+npx --yes @yep-ai/cli@latest diff @creator/demo --base published
+npx --yes @yep-ai/cli@latest publish ./my-agent --kind agent
+npx --yes @yep-ai/cli@latest submit @creator/demo --kind agent
+npx --yes @yep-ai/cli@latest withdraw @creator/demo --kind agent
+```
+
+默认资源类型为 `skill`，也支持 `--kind agent|plugin`。Skill 私有保存后从网页申请共享审核；Agent/Plugin 的发布会提交审核。审核通过才进入公开市场。`history` 和 `diff` 访问服务端保留的真实 Git 版本。
+
+支持的客户端：Codex、Claude、Qoder、Kiro、VS Code、universal 和当前项目；`--target` 显式指定目录。`--local` 可使用源码仓库自带的本地 registry，该选项不访问默认线上市场。安装包继续接受 `cpm.json` 技能清单，并读取历史安装回执。不会执行安装包里的脚本。
+
+## 设备节点
+
+```sh
+npx --yes @yep-ai/cli@latest device login --server https://yep.nihao.cool
+npx --yes @yep-ai/cli@latest device start "/path/to/documents" --server https://yep.nihao.cool
+npx --yes @yep-ai/cli@latest device status
+npx --yes @yep-ai/cli@latest device logout
+```
+
+设备通过 HTTPS 配对和 WSS 出站连接；网页批准设备后，还需在某场咨询中选择目录和权限。目录不会整体上传。最多指定 5 个目录；指定目录时仅提供受限内置命令。不指定目录时，命令拥有当前系统用户的 shell 权限，可访问其他文件和网络。进程退出后节点离线，不安装后台服务。设备授权最长 24 小时，可以从网页或 CLI 撤销。
+
+节点上线后，可在「设备节点」点击「打开终端」，直接选择启动目录并发送命令，无需创建咨询。终端实时展示标准输出、错误输出和退出码，可以停止命令、清屏和重连。`cd 子目录`、`cd ..` 与 `cd` 可切换工作目录；每条命令独立执行，shell 变量不会跨命令保留。CLI 终端不提供交互式输入，`vim`、`top`、口令提示等需要真实终端的程序请使用 SSH 网页终端。单条命令最长运行 30 秒、输出最多 64 KiB；关闭终端、撤销授权或断线会停止正在执行的命令。
+
+指定启动目录时仅支持 `pwd`、`ls` / `dir`、`echo`、`cat` / `type`、`head`、`tail`、`grep` / `findstr`、`wc -l` 与终端内的 `cd`，不能使用管道、重定向或外部程序。已有旧版节点若提示不支持终端，请停止旧进程，将原启动命令中的 `yep` 替换为 `npx --yes @yep-ai/cli@latest`，保留原目录参数与 `--server` 地址。
+
+`--server` 只接受 HTTPS 源站（回环开发地址允许 HTTP），显式指定后记住该源站；令牌按源站隔离。市场登录不等于设备授权。
+
+## 配置
+
+默认市场地址：`https://yep.nihao.cool`。
+
+| 配置 | 用途 |
+| --- | --- |
+| `YEP_REGISTRY_URL` | 市场 API 源站 |
+| `YEP_TOKEN` | 市场 Bearer token |
+| `YEP_USERNAME` / `YEP_PASSWORD` | 非交互市场登录 |
+| `YEP_CLIENT` | 默认安装客户端 |
+| `YEP_CONFIG_DIR` | 配置根目录，默认 `~/.config/yep` |
+| `YEP_HOME` | 覆盖默认 home，配置位于其 `.config/yep` 下 |
+| `YEP_DEVICE_CONFIG_DIR` | 单独覆盖设备凭据目录 |
+
+市场凭据保存为 `~/.config/yep/config.json`；设备身份和各源站的授权保存在 `~/.config/yep/devices/`。目录权限 `0700`、凭据文件 `0600`；Windows 使用当前用户专属 ACL。市场和设备令牌分别管理。域名改变后需要在新源站重新登录、配对，不会把旧源站令牌发送到新地址。
+
+执行 `npx --yes @yep-ai/cli@latest --help` 或 `npx --yes @yep-ai/cli@latest device --help` 查看全部选项。

package/bin/clients.js

@@ -0,0 +1,77 @@
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { createInterface } from "node:readline/promises";
+
+const aliases = {
+  "claude-code": "claude", cluade: "claude", "codex-cli": "codex", chatgpt: "codex",
+  "github-copilot": "vscode", "kiro-cli": "kiro", qorder: "qoder", agents: "universal"
+};
+
+export function installClientDefinitions() {
+  const home = homedir();
+  const codexHome = process.env.CODEX_HOME?.trim() || join(home, ".codex");
+  const claudeHome = process.env.CLAUDE_CONFIG_DIR?.trim() || join(home, ".claude");
+  return {
+    codex: { label: "Codex / ChatGPT", root: resolve(codexHome, "skills"), detect: [codexHome, "/etc/codex"] },
+    claude: { label: "Claude Code", root: resolve(claudeHome, "skills"), detect: [claudeHome] },
+    qoder: { label: "Qoder", root: join(home, ".qoder", "skills"), detect: [join(home, ".qoder")] },
+    kiro: { label: "Kiro CLI", root: join(home, ".kiro", "skills"), detect: [join(home, ".kiro")] },
+    vscode: { label: "VS Code / Copilot", root: join(home, ".copilot", "skills"), detect: [join(home, ".copilot")] },
+    universal: { label: "Universal agents", root: join(home, ".config", "agents", "skills"), detect: [join(home, ".config", "agents")] },
+    project: { label: "Project agents", root: join(process.cwd(), ".agents", "skills"), detect: [] }
+  };
+}
+
+export function normalizeClients(value, definitions = installClientDefinitions()) {
+  const clients = String(value).split(",").map((item) => item.trim().toLowerCase()).map((item) => aliases[item] ?? item);
+  if (clients.some((client) => !client)) throw new Error("--client requires at least one client; remove empty selections");
+  for (const client of clients) {
+    if (!Object.hasOwn(definitions, client) && !["auto", "all"].includes(client)) {
+      throw new Error(`Unknown client: ${client}. Supported clients: auto, all, ${Object.keys(definitions).join(", ")}`);
+    }
+  }
+  return [...new Set(clients)];
+}
+
+export function resolveClients(value, definitions = installClientDefinitions()) {
+  const detected = Object.keys(definitions).filter((client) => definitions[client].detect.some((path) => existsSync(path)));
+  return [...new Set(normalizeClients(value, definitions).flatMap((client) => {
+    if (client === "all") return Object.keys(definitions);
+    if (client === "auto") return detected.length ? detected : ["project"];
+    return [client];
+  }))];
+}
+
+export async function promptClients({ input = process.stdin, output = process.stdout, definitions = installClientDefinitions() } = {}) {
+  const clients = Object.keys(definitions);
+  output.write("Choose clients (comma-separated numbers or names; 'all' selects every client):\n");
+  clients.forEach((client, index) => {
+    const definition = definitions[client];
+    const detected = definition.detect.some((path) => existsSync(path)) ? " [detected]" : "";
+    output.write(`  ${index + 1}. ${definition.label} (${client})${detected}\n     ${definition.root}\n`);
+  });
+  const prompt = createInterface({ input, output, terminal: Boolean(input.isTTY && output.isTTY) });
+  const abort = new AbortController();
+  const cancel = () => abort.abort();
+  prompt.on("SIGINT", cancel);
+  prompt.on("close", cancel);
+  try {
+    while (true) {
+      const answer = (await prompt.question("Clients: ", { signal: abort.signal })).trim();
+      if (["q", "quit", "cancel"].includes(answer.toLowerCase())) throw new Error("Client selection cancelled");
+      const values = answer.split(/[\s,]+/).map((item) => /^\d+$/.test(item) ? clients[Number(item) - 1] ?? item : item);
+      try {
+        return resolveClients(values.join(","), definitions);
+      } catch (error) {
+        output.write(`${error.message}\n`);
+      }
+    }
+  } catch (error) {
+    if (abort.signal.aborted) throw new Error("Client selection cancelled");
+    throw error;
+  } finally {
+    prompt.off("close", cancel);
+    prompt.close();
+  }
+}