@monoedge/jdu-cli 0.3.0 → 0.4.0

package/README.md

@@ -6,7 +6,7 @@
 
 ```bash
 npm i -g @monoedge/jdu-cli
-jdu init                   # 默认官方 https://docs.mszhou.com，浏览器里 passkey 点一次授权；自部署加 --server <url>
+jdu login --server <url>    # 指定简牍站点（本机自部署用 --local）；站点支持时打开浏览器点一次授权
 jdu push notes/hello.md --visibility public
 jdu official add <docId>   # 管理员：上架到官方知识库
 ```
@@ -16,7 +16,7 @@ jdu official add <docId>   # 管理员：上架到官方知识库
 登录方式听 server 的 `/healthz`：password 站点注册过 passkey 就打开浏览器授权签 token；没有浏览器的机器（CI、SSH 远端）带 `--token`：
 
 ```bash
-jdu init --server https://docs.example.com --token <token>
+jdu login --server https://docs.example.com --token <token>
 ```
 
 签出去的 token 用 `jdu token list` / `jdu token rm <id>` 管理。

package/dist/cli.js

@@ -3502,7 +3502,7 @@ async function httpError(method, url, res) {
 //#endregion
 //#region src/browser-auth.ts
 /**
-* jdu init 的浏览器授权（#66）：本机起一个 loopback 回调，打开 server 下发的 authorizeUrl，
+* jdu login 的浏览器授权（#66）：本机起一个 loopback 回调，打开 server 下发的 authorizeUrl，
 * 人在浏览器里用 passkey 会话点一次「授权」，回跳带回一次性 code，再用 PKCE verifier 向 server 换 token。
 *
 * authorizeUrl 与 server 可能不同源（CLI 连 127.0.0.1:18082，浏览器开 https://md.mason.local）——
@@ -3517,7 +3517,7 @@ async function browserAuthorize(input) {
 			server.close();
 			fn(value);
 		};
-		const fail = finish((msg) => reject(new CliError(msg, "重新执行 jdu init；不想开浏览器就带 --token")));
+		const fail = finish((msg) => reject(new CliError(msg, "重新执行 jdu login；不想开浏览器就带 --token")));
 		const handler = callbackHandler(state, finish(resolve));
 		const server = createServer((req, res) => {
 			if (new URL(req.url ?? "/", "http://localhost").pathname !== "/callback") {
@@ -3550,7 +3550,7 @@ async function browserAuthorize(input) {
 		})
 	});
 	const text = await res.text();
-	if (!res.ok) throw new CliError(`code 换 token 失败（HTTP ${res.status}）：${text.slice(0, 200)}`, "重新执行 jdu init 再试一次");
+	if (!res.ok) throw new CliError(`code 换 token 失败（HTTP ${res.status}）：${text.slice(0, 200)}`, "重新执行 jdu login 再试一次");
 	let token;
 	try {
 		token = JSON.parse(text).token;
@@ -3596,7 +3596,11 @@ async function probeApiWithBearer(server, token) {
 		redirect: "manual"
 	})).ok;
 }
-async function runLogin(opts) {
+/**
+* forward-auth / OIDC 分支，外加 --user 直连与 --token 直存。
+* 不是命令入口——入口是 init.ts 的 runLogin，它探完 healthz 才分派到这里。
+*/
+async function runOidcLogin(opts) {
 	const server = opts.server.trim().replace(/\/+$/, "");
 	if (server === "") throw new CliError("--server 不能为空");
 	const healthz = await (opts.fetchHealthz ?? fetchHealthz)(server);
@@ -3621,7 +3625,7 @@ async function runLogin(opts) {
 		configPath: saveConfig({ server }),
 		source: "anonymous"
 	};
-	if (provider === "token" || provider === "password") throw new CliError(`这个 server 用 ${provider} 鉴权，CLI 需要 --token`, "jdu init --server <url>（站点支持时打开浏览器授权），或 jdu login --server <url> --token <token>（token 在 server 首启 stdout / data/initial-token.txt）");
+	if (provider === "token" || provider === "password") throw new CliError(`这个 server 用 ${provider} 鉴权，CLI 需要 --token`, "jdu login --server <url> --token <token>（token 在 server 首启 stdout / data/initial-token.txt）");
 	const oidc = resolveOidc({
 		issuer: opts.issuer,
 		clientId: opts.clientId,
@@ -3659,21 +3663,22 @@ async function runLogin(opts) {
 //#endregion
 //#region src/init.ts
 /**
-* jdu init：选定部署目标并写好本地配置，一条命令把「指向哪台简牍」定下来。
+* jdu login：选定站点、拿到凭据、写好本地配置，一条命令把「登录到哪台简牍」定下来。
 *
-* 目标三选一：
-*   （默认）     官方线上服务 https://docs.mszhou.com（OFFICIAL_SERVER）
+* 目标必须显式给出（没有默认站点，官方商用服务尚未上线）：
 *   --local      本机自部署（http://127.0.0.1:8080）
 *   --server <u> 任意自部署地址
 *
 * 为 agent 联动而设计：全 flag 驱动、无交互提示、--json 输出机器可读结果，
 * 拿到 next 字段就知道下一步该干什么（要不要 token、去哪拿）。
 *
-* 登录方式听 server 的（healthz.cliAuth，#66）：声明了 browser 就开浏览器授权换 token；
-* 只有 token 就把 server 给的 tokenHint 拼进 next。CLI 不按「官方 / 自部署」猜。
+* 登录方式全听 server 的（healthz.cliAuth，#66），用户不必先知道自己的站点用什么鉴权：
+*   browser  → 开浏览器授权换 token
+*   oidc     → 委托 runOidcLogin 走 SSO（forward-auth）
+*   token    → 把 server 给的 tokenHint 拼进 next，告诉去哪拿
+*   anonymous→ 直接就绪
+* CLI 不按「官方 / 自部署」猜，也不再要求用户在 init / login 之间二选一。
 */
-/** 官方线上地址。password 鉴权：浏览器 passkey，CLI 走 token，token 向站点管理员申领。 */
-var OFFICIAL_SERVER = "https://docs.mszhou.com";
 var LOCAL_SERVER = "http://127.0.0.1:8080";
 function resolveInitTarget(opts) {
 	if (opts.local && opts.server) throw new CliError("--local 与 --server 只能二选一");
@@ -3695,12 +3700,9 @@ function resolveInitTarget(opts) {
 		target: "local",
 		server: LOCAL_SERVER
 	};
-	return {
-		target: "official",
-		server: OFFICIAL_SERVER
-	};
+	throw new CliError("jdu login 需要指定站点", "自部署用 --server <url>，本机用 --local");
 }
-async function runInit(opts) {
+async function runLogin(opts) {
 	const { target, server } = resolveInitTarget(opts);
 	const healthz = await (opts.fetchHealthz ?? fetchHealthz)(server);
 	const provider = healthz.authProvider ?? "token";
@@ -3711,6 +3713,21 @@ async function runInit(opts) {
 		authProvider: provider,
 		authMethods: methods
 	};
+	if (opts.user !== void 0 && opts.user.trim() !== "") {
+		const r = await runOidcLogin({
+			server,
+			user: opts.user,
+			proxySecret: opts.proxySecret,
+			fetchHealthz: async () => healthz
+		});
+		return {
+			...base,
+			loggedIn: true,
+			configPath: r.configPath,
+			next: null,
+			warning: r.warning
+		};
+	}
 	if (opts.token !== void 0 && opts.token !== "") {
 		if (!await (opts.probe ?? probeApiWithBearer)(server, opts.token)) throw new CliError("token 校验失败（/api/docs 未放行）", "确认 token 正确、且网关放行 Authorization: Bearer");
 		const path = saveConfig({
@@ -3754,8 +3771,25 @@ async function runInit(opts) {
 			next: null
 		};
 	}
-	const viaToken = `jdu init --server '${server}' --token <token>（${healthz.cliAuth?.tokenHint ?? "token 在 server 首启 stdout / data/initial-token.txt"}）`;
-	const next = provider === "forward-auth" ? `jdu login --server '${server}'（浏览器 SSO），或 ${viaToken}` : methods.includes("browser") ? `jdu init --server '${server}'（不带 --json / --no-browser，打开浏览器授权），或 ${viaToken}` : viaToken;
+	const viaToken = `jdu login --server '${server}' --token <token>（${healthz.cliAuth?.tokenHint ?? "token 在 server 首启 stdout / data/initial-token.txt"}）`;
+	if (provider === "forward-auth" && opts.browser) {
+		const r = await runOidcLogin({
+			server,
+			issuer: opts.issuer,
+			clientId: opts.clientId,
+			fetchHealthz: async () => healthz,
+			oidcLogin: opts.oidcLogin,
+			probe: opts.probe
+		});
+		return {
+			...base,
+			loggedIn: true,
+			configPath: r.configPath,
+			next: null,
+			warning: r.warning
+		};
+	}
+	const next = methods.includes("browser") ? `jdu login --server '${server}'（不带 --json / --no-browser，打开浏览器授权），或 ${viaToken}` : viaToken;
 	return {
 		...base,
 		loggedIn: false,
@@ -3937,6 +3971,7 @@ async function pushDoc(api, entryArg, opts) {
 	if (opts.id !== void 0 && opts.id !== "") body.id = opts.id;
 	if (opts.tag !== void 0) body.tags = opts.tag.flatMap((t) => t.split(",")).map((t) => t.trim()).filter((t) => t.length > 0);
 	if (opts.official === true) body.official = true;
+	if (opts.team !== void 0) body.team = opts.team;
 	const res = await api.postJson("/api/docs", body);
 	const id = typeof res?.id === "string" ? res.id : opts.id;
 	const url = typeof res?.url === "string" && res.url !== "" ? res.url : id !== void 0 ? api.url(`/d/${id}`) : void 0;
@@ -4066,7 +4101,7 @@ var SERVER_INFO = {
 	name: "jiandu",
 	version: "0.2.0"
 };
-var INSTRUCTIONS = "jiandu（简牍）是一个 Markdown 知识库。先用 search_docs / list_docs 找到文档 id，read_doc 拿 markdown 原文；改稿后用 push_doc 发布新版本（带 id 才是更新，不带是新建）。文档里的 widget fence（```widget_component:Name）保留原样。写新文档前先 list_templates 看有没有对应骨架（周报 / 技术方案…），有就 read_doc 取模板按节填，占位注释自己替换掉。";
+var INSTRUCTIONS = "jiandu（简牍）是一个 Markdown 知识库。先用 search_docs / list_docs 找到文档 id，read_doc 拿 markdown 原文；改稿后用 push_doc 发布新版本（带 id 才是更新，不带是新建）。文档里的 widget fence（```widget:Name）保留原样。写新文档前先 list_templates 看有没有对应骨架（周报 / 技术方案…），有就 read_doc 取模板按节填，占位注释自己替换掉。";
 function str(v, name) {
 	if (typeof v !== "string" || v.trim() === "") throw new CliError(`${name} 必填且为非空字符串`);
 	return v.trim();
@@ -4590,11 +4625,11 @@ $('dark').addEventListener('click', () => { document.documentElement.classList.t
 
 // 与 viewer loader 同一条链路：import → new → mount(el, ctx)；抛错就按线上的降级形态显示原始 fence
 let meta = {}, inst = null, W = null, data = {};
-const ctx = (d) => ({ data: d, loading: false, blockId: 'b0-dev00000', source: JSON.stringify(d, null, 2), language: 'widget_component:' + (meta.name ?? '') });
+const ctx = (d) => ({ data: d, loading: false, blockId: 'b0-dev00000', source: JSON.stringify(d, null, 2), language: 'widget:' + (meta.name ?? '') });
 function degrade(reason) {
   const pre = document.createElement('pre');
   pre.className = 'dev-degraded';
-  pre.textContent = '[降级为代码块] ' + reason + '\\n\\n\`\`\`widget_component:' + (meta.name ?? '') + '\\n' + JSON.stringify(data, null, 2) + '\\n\`\`\`';
+  pre.textContent = '[降级为代码块] ' + reason + '\\n\\n\`\`\`widget:' + (meta.name ?? '') + '\\n' + JSON.stringify(data, null, 2) + '\\n\`\`\`';
   island.replaceChildren(pre);
   status.textContent = '挂载失败';
 }
@@ -4732,7 +4767,7 @@ export interface WidgetContext<D = unknown> {
   blockId: string;
   /** 原始 fence 正文 */
   source: string;
-  /** 原始代码块语言标识，如 \`widget_component:StarRating\` */
+  /** 原始代码块语言标识，如 \`widget:StarRating\` */
   language: string;
   /**
    * 嵌套 markdown：dataSchema 里标了 \`contentMediaType: "text/markdown"\` 的字符串字段，宿主渲成已 sanitize 的 HTML
@@ -4761,7 +4796,7 @@ export interface WidgetClass<D = unknown> {
 var TYPES_TS = (c) => `// fence 里的 data 长什么样，这里是唯一事实：\`npm run build\` 会把 Data 生成为 widget.json 的 dataSchema
 // （字段上的 JSDoc → description，@default → default）。文档里的 data 不合法时平台会把 fence 降级成代码块。
 //
-//   \`\`\`widget_component:${c.name}
+//   \`\`\`widget:${c.name}
 //   { "title": "你好，简牍", "count": 3 }
 //   \`\`\`
 //
@@ -5143,7 +5178,7 @@ npm run push         # = build + jdu widget push dist
 然后在任何一篇文档里：
 
 \`\`\`\`markdown
-\`\`\`widget_component:${c.name}
+\`\`\`widget:${c.name}
 { "title": "你好，简牍", "count": 3 }
 \`\`\`
 \`\`\`\`
@@ -5198,7 +5233,7 @@ async function fetchRuntime(api) {
 	try {
 		client = await api();
 	} catch (err) {
-		throw new CliError(`shared 档要从 server 取 runtime 地址，但 CLI 未配置：${err instanceof Error ? err.message : String(err)}`, "先 jdu init / login，或改用 --runtime custom（自带 react 全内联，不需要 server）");
+		throw new CliError(`shared 档要从 server 取 runtime 地址，但 CLI 未配置：${err instanceof Error ? err.message : String(err)}`, "先 jdu login，或改用 --runtime custom（自带 react 全内联，不需要 server）");
 	}
 	const res = await client.getJson("/api/runtimes");
 	const name = typeof res?.default === "string" ? res.default : null;
@@ -5263,9 +5298,9 @@ function collectTag(value, previous) {
 	return [...previous ?? [], value];
 }
 var program = new Command();
-program.name("jdu").description("jiandu 命令行").version("0.3.0").showHelpAfterError();
-program.command("init").description("选定部署目标并初始化本地配置（默认官方线上；自部署 / 本机需显式指定）").option("--local", "目标是本机自部署（http://127.0.0.1:8080）").option("--server <url>", "目标是指定的自部署地址").option("--token <token>", "一并完成 token 登录（server 首启 stdout / data/initial-token.txt）").option("--no-browser", "站点支持浏览器授权时也不打开浏览器，只给 token 指引").option("--json", "机器可读输出（agent 联动用；不会打开浏览器）", false).action(async (opts) => {
-	const result = await runInit({
+program.name("jdu").description("jiandu 命令行").version("0.4.0").showHelpAfterError();
+program.command("login").description("登录到一台简牍：定站点、拿凭据、写本地配置（必须指定 --server 或 --local）").option("--local", "目标是本机自部署（http://127.0.0.1:8080）").option("--server <url>", "目标简牍站点地址").option("--token <token>", "直接用 token 登录（无浏览器的机器；token 在 server 首启 stdout / data/initial-token.txt）").option("--user <owner>", "forward-auth：以指定 owner 直连，跳过 SSO（请求注入 X-Forwarded-User 头）").option("--proxy-secret <secret>", "forward-auth：网关共享密钥（X-Jiandu-Proxy-Secret 头）").option("--issuer <url>", "OIDC issuer（缺省读 healthz.oidc 或 JIANDU_OIDC_ISSUER）").option("--client-id <id>", "OIDC client id（缺省读 healthz.oidc 或 JIANDU_OIDC_CLIENT_ID）").option("--no-browser", "站点支持浏览器授权时也不打开浏览器，只给 token 指引").option("--json", "机器可读输出（agent 联动用；不会打开浏览器）", false).action(async (opts) => {
+	const result = await runLogin({
 		...opts,
 		browser: opts.browser && !opts.json
 	});
@@ -5276,24 +5311,9 @@ program.command("init").description("选定部署目标并初始化本地配置
 	process.stdout.write(`目标 ${result.target} · ${result.server}（auth: ${result.authProvider}）\n`);
 	process.stdout.write(`配置已写入 ${result.configPath}\n`);
 	process.stdout.write(result.loggedIn ? "凭据就绪，可以直接 jdu push。\n" : `下一步：${result.next ?? ""}\n`);
-});
-program.command("login").description("登录到 jiandu server（forward-auth 默认打开浏览器走 SSO；--user 则直连注入身份头）").requiredOption("--server <url>", "jiandu server 地址").option("--token <token>", "直接保存访问 token（token provider / 跳过浏览器）").option("--user <owner>", "forward-auth：以指定 owner 直连（请求注入 X-Forwarded-User 头，跳过 SSO）").option("--proxy-secret <secret>", "forward-auth：网关共享密钥（请求注入 X-Jiandu-Proxy-Secret 头）").option("--issuer <url>", "OIDC issuer（缺省读 healthz.oidc 或 JIANDU_OIDC_ISSUER）").option("--client-id <id>", "OIDC client id（缺省读 healthz.oidc 或 JIANDU_OIDC_CLIENT_ID）").action(async (opts) => {
-	const result = await runLogin({
-		server: opts.server,
-		token: opts.token,
-		user: opts.user,
-		proxySecret: opts.proxySecret,
-		issuer: opts.issuer,
-		clientId: opts.clientId
-	});
-	process.stdout.write(`${result.configPath}\n`);
-	if (result.source === "anonymous") process.stderr.write("这个 server 是匿名模式，无需登录。\n");
-	if (result.source === "forward-auth") process.stderr.write("已保存 forward-auth 直连身份（X-Forwarded-User）。\n");
-	if (result.source === "oidc-cache") process.stderr.write("已复用本机 SSO credential。\n");
-	if (result.source === "oidc-browser") process.stderr.write("SSO 登录成功。\n");
 	if (result.warning) process.stderr.write(`jdu: ${result.warning}\n`);
 });
-program.command("push").argument("<entry.md>", "入口 markdown 文件").description("递归收集本地引用、增量上传并发布一个新版本").option("--title <title>", "文档标题，默认取首个一级标题").option("--visibility <v>", `${VISIBILITIES.join(" | ")}（新文档默认 private；更新已有文档时不传则保持原值）`).option("--id <docId>", "复用已有文档 id（发布新版本）").option("--tag <name>", "打标签，可重复；不传则保持原有标签", collectTag, void 0).option("--official", "上架到官方知识库（需管理员；同时公开）").action(async (entry, opts) => {
+program.command("push").argument("<entry.md>", "入口 markdown 文件").description("递归收集本地引用、增量上传并发布一个新版本").option("--title <title>", "文档标题，默认取首个一级标题").option("--visibility <v>", `${VISIBILITIES.join(" | ")}（新文档默认 private；更新已有文档时不传则保持原值）`).option("--id <docId>", "复用已有文档 id（发布新版本）").option("--tag <name>", "打标签，可重复；不传则保持原有标签", collectTag, void 0).option("--official", "上架到官方知识库（需管理员；同时公开）").option("--team <teamId>", "进团队（需是该团队成员；传空串移出团队；不传则保持原值）").action(async (entry, opts) => {
 	const res = await pushDoc(await client(), entry, opts);
 	process.stdout.write(`${res.url}\n`);
 });
@@ -5423,7 +5443,7 @@ template.command("push").argument("<file.md>", "模板文件").description("发
 program.command("mcp").description("以 MCP server（stdio）暴露 list_docs / search_docs / read_doc / list_versions / push_doc，给本机 agent 用").action(async () => {
 	await runMcp(await client());
 });
-program.command("share").argument("<docId>").description("改可见性，或管理读者池（定向分享，可撤销）").option("--visibility <v>", VISIBILITIES.join(" | ")).option("--to <reader>", "加入读者池（身份串，如邮箱 / forward-auth 的 owner），可重复", collectTag, void 0).option("--revoke <reader>", "从读者池移除，立刻失效，可重复", collectTag, void 0).option("--readers", "列出当前读者池", false).action(async (docId, opts) => {
+program.command("share").argument("<docId>").description("改可见性 / 进出团队，或管理读者池（定向分享，可撤销）").option("--visibility <v>", VISIBILITIES.join(" | ")).option("--team <teamId>", "进团队（需是该团队成员）").option("--no-team", "移出团队").option("--to <reader>", "加入读者池（身份串，如邮箱 / forward-auth 的 owner），可重复", collectTag, void 0).option("--revoke <reader>", "从读者池移除，立刻失效，可重复", collectTag, void 0).option("--readers", "列出当前读者池", false).action(async (docId, opts) => {
 	const api = await client();
 	const url = `/api/docs/${encodeURIComponent(docId)}`;
 	if (opts.readers) {
@@ -5441,9 +5461,12 @@ program.command("share").argument("<docId>").description("改可见性，或管
 		process.stdout.write(`${readers.length > 0 ? readers.join("\n") : "(读者池为空)"}\n`);
 		return;
 	}
-	if (opts.visibility === void 0) throw new CliError("share 需要 --visibility / --to / --revoke / --readers 之一");
-	const res = await api.putJson(`${url}/visibility`, { visibility: opts.visibility });
-	process.stdout.write(`可见性 ${String(res.visibility)}\n`);
+	const payload = {};
+	if (opts.visibility !== void 0) payload.visibility = opts.visibility;
+	if (opts.team !== void 0) payload.team = opts.team === false ? "" : opts.team;
+	if (Object.keys(payload).length === 0) throw new CliError("share 需要 --visibility / --team / --no-team / --to / --revoke / --readers 之一");
+	const res = await api.putJson(`${url}/visibility`, payload);
+	process.stdout.write(`可见性 ${String(res.visibility)}${res.team ? `，团队 ${String(res.team)}` : ""}\n`);
 });
 var tokenCmd = program.command("token").description("CLI token（首启那枚与浏览器授权签发的）");
 tokenCmd.command("list").description("列出我的 token；CURRENT 是本次请求用的那枚").action(async () => {
@@ -5474,6 +5497,92 @@ tokenCmd.command("rm").argument("<id>", "jdu token list 里的 ID").description(
 	await (await client()).deleteJson(`/api/tokens/${encodeURIComponent(id)}`);
 	process.stdout.write(`revoked ${id}\n`);
 });
+var teamCmd = program.command("team").description("团队：共享阅读与评论的空间（实例管理员建团队，团队管理员按用户名加人；文档进团队用 push/share --team）");
+teamCmd.command("list").description("我所属的团队（实例管理员：全部团队）").action(async () => {
+	printTable(asRows(await (await client()).getJson("/api/teams"), "teams"), [
+		{
+			key: "id",
+			header: "ID"
+		},
+		{
+			key: "name",
+			header: "NAME"
+		},
+		{
+			key: "role",
+			header: "ROLE"
+		},
+		{
+			key: "members",
+			header: "MEMBERS"
+		},
+		{
+			key: "docs",
+			header: "DOCS"
+		}
+	]);
+});
+teamCmd.command("create").argument("<name>", "团队名").description("新建团队（实例管理员）；你自动成为团队管理员，stdout 是团队 id").action(async (name) => {
+	const res = await (await client()).postJson("/api/teams", { name });
+	process.stdout.write(`${res.id}\n`);
+	process.stderr.write(`团队「${res.name}」已创建：jdu team add ${res.id} <用户名> 加人\n`);
+});
+teamCmd.command("add").argument("<team>", "团队 id").argument("<user>", "成员用户名").option("--admin", "设为团队管理员（可加人 / 踢人 / 改名）").description("把成员加进团队；对已在团队的人 = 改角色").action(async (team, user, opts) => {
+	await (await client()).postJson(`/api/teams/${encodeURIComponent(team)}/members`, {
+		owner: user,
+		role: opts.admin ? "admin" : "member"
+	});
+	process.stdout.write(`added ${user} → ${team}${opts.admin ? " (admin)" : ""}\n`);
+});
+teamCmd.command("rm").argument("<team>", "团队 id").argument("<user>", "成员用户名").description("把成员移出团队（团队管理员）").action(async (team, user) => {
+	await (await client()).postJson(`/api/teams/${encodeURIComponent(team)}/members/remove`, { owner: user });
+	process.stdout.write(`removed ${user} ← ${team}\n`);
+});
+teamCmd.command("leave").argument("<team>", "团队 id").description("自己退出团队").action(async (team) => {
+	await (await client()).postJson(`/api/teams/${encodeURIComponent(team)}/members/remove`, {});
+	process.stdout.write(`left ${team}\n`);
+});
+var memberCmd = program.command("member").description("成员（password 鉴权，管理员专用）：准入只有邀请，被邀请者用链接自己绑 passkey");
+memberCmd.command("list").description("成员名单：pending = 已邀请未绑定，bound = 已绑定 passkey").action(async () => {
+	printTable(asRows(await (await client()).getJson("/api/members"), "members"), [
+		{
+			key: "owner",
+			header: "OWNER"
+		},
+		{
+			key: "status",
+			header: "STATUS"
+		},
+		{
+			key: "invitedAt",
+			header: "INVITED"
+		},
+		{
+			key: "boundAt",
+			header: "BOUND"
+		},
+		{
+			key: "tokens",
+			header: "TOKENS"
+		},
+		{
+			key: "docs",
+			header: "DOCS"
+		}
+	]);
+});
+memberCmd.command("invite").argument("<name>", "用户名：小写字母 / 数字开头，可含 . _ -，≤30 位").option("--reset", "已绑定的成员重置 passkey（清掉凭据，所有设备与会话即刻失效）").description("签一张 7 天有效的一次性邀请链接，自己交给对方；对方打开后绑定 passkey 即成为成员").action(async (name, opts) => {
+	const res = await (await client()).postJson("/api/members/invite", {
+		owner: name,
+		reset: opts.reset === true
+	});
+	process.stdout.write(`${res.url}\n`);
+	process.stderr.write(`邀请 ${res.owner}，${new Date(res.expiresAt).toLocaleString()} 前有效；链接只显示这一次\n`);
+});
+memberCmd.command("rm").argument("<name>", "用户名").description("移除成员：删 passkey 与其全部 token；文档 / 评论 / 标签不动，同名重邀即接回").action(async (name) => {
+	await (await client()).postJson("/api/members/remove", { owner: name });
+	process.stdout.write(`removed ${name}\n`);
+});
 var officialCmd = program.command("official").description("官方知识库上架");
 officialCmd.command("list").description("列出已上架的官方文档").action(async () => {
 	printTable(asRows(await (await client()).getJson("/api/official"), "docs"), [{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monoedge/jdu-cli",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "jdu — 把 Markdown 发布到简牍服务",
   "type": "module",
   "license": "MIT",