@monoedge/jdu-cli 0.4.0 → 0.6.0

package/dist/cli.js

@@ -2,11 +2,11 @@
 import { EventEmitter } from "node:events";
 import childProcess, { spawn } from "node:child_process";
 import path, { basename, dirname, extname, join, relative, resolve, sep } from "node:path";
-import fs, { chmodSync, createReadStream, existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import fs, { chmodSync, createReadStream, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import process$1 from "node:process";
 import { stripVTControlCharacters } from "node:util";
+import { homedir, hostname, tmpdir } from "node:os";
 import { createHash, randomBytes } from "node:crypto";
-import { homedir, hostname } from "node:os";
 import { createServer } from "node:http";
 import { createInterface } from "node:readline";
 import { readFile, readdir } from "node:fs/promises";
@@ -2965,75 +2965,6 @@ function useColor() {
 }
 new Command();
 //#endregion
-//#region src/blobs.ts
-/** 流式算 hash，避免把大图整份读进内存。 */
-function sha256File(path) {
-	return new Promise((res, rej) => {
-		const h = createHash("sha256");
-		const rs = createReadStream(path);
-		rs.on("error", rej);
-		rs.on("data", (chunk) => h.update(chunk));
-		rs.on("end", () => res(h.digest("hex")));
-	});
-}
-var MIME$1 = Object.freeze({
-	".md": "text/markdown; charset=utf-8",
-	".markdown": "text/markdown; charset=utf-8",
-	".txt": "text/plain; charset=utf-8",
-	".json": "application/json",
-	".js": "text/javascript; charset=utf-8",
-	".mjs": "text/javascript; charset=utf-8",
-	".css": "text/css; charset=utf-8",
-	".html": "text/html; charset=utf-8",
-	".svg": "image/svg+xml",
-	".png": "image/png",
-	".jpg": "image/jpeg",
-	".jpeg": "image/jpeg",
-	".gif": "image/gif",
-	".webp": "image/webp",
-	".avif": "image/avif",
-	".ico": "image/x-icon",
-	".mp4": "video/mp4",
-	".webm": "video/webm",
-	".mov": "video/quicktime",
-	".mp3": "audio/mpeg",
-	".wav": "audio/wav",
-	".pdf": "application/pdf",
-	".zip": "application/zip",
-	".woff2": "font/woff2"
-});
-function guessMime(path) {
-	return MIME$1[extname(path).toLowerCase()] ?? "application/octet-stream";
-}
-/**
-* 增量上传：先用 hash 清单跟 server 协商，只 PUT 缺失的。
-* server 返回体不可解析时按「全都缺」处理 —— 宁可多传也不能漏传导致文档半残。
-*/
-async function syncBlobs(api, entries) {
-	const byHash = /* @__PURE__ */ new Map();
-	for (const e of entries) if (!byHash.has(e.hash)) byHash.set(e.hash, e.path);
-	const hashes = [...byHash.keys()];
-	if (hashes.length === 0) return {
-		total: 0,
-		uploaded: [],
-		reused: 0
-	};
-	const res = await api.postJson("/api/blobs/check", { hashes });
-	const missing = Array.isArray(res?.missing) ? res.missing.filter((h) => typeof h === "string") : hashes;
-	const uploaded = [];
-	for (const hash of missing) {
-		const path = byHash.get(hash);
-		if (path === void 0) continue;
-		await api.putBytes(`/api/blobs/${hash}`, readFileSync(path), guessMime(path));
-		uploaded.push(hash);
-	}
-	return {
-		total: hashes.length,
-		uploaded,
-		reused: hashes.length - uploaded.length
-	};
-}
-//#endregion
 //#region src/errors.ts
 /**
 * 面向用户的可读错误。
@@ -3241,6 +3172,31 @@ function configPath() {
 	const base = xdg && xdg.length > 0 ? xdg : join(homedir(), ".config");
 	return join(base, "jiandu", "config.json");
 }
+/**
+* `~/.config/jiandu/cf.json`：`jdu deploy` / `jdu access` 用的 Cloudflare 账号凭据
+* （OAuth 拿到的 access / refresh token + account id + 邮箱）。与站点凭据分开存，
+* 因为它是「这个 Cloudflare 账号」的钥匙，不属于任何一台简牍实例。
+*/
+function cfConfigPath() {
+	const xdg = process.env.XDG_CONFIG_HOME?.trim();
+	const base = xdg && xdg.length > 0 ? xdg : join(homedir(), ".config");
+	return join(base, "jiandu", "cf.json");
+}
+/** 缺文件返回空对象；解析失败一律当作没有（重新登录即可），不阻塞命令。 */
+function readCfConfig() {
+	try {
+		const parsed = JSON.parse(readFileSync(cfConfigPath(), "utf8"));
+		return parsed !== null && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
+	} catch {
+		return {};
+	}
+}
+function writeCfConfig(next) {
+	const path = cfConfigPath();
+	mkdirSync(dirname(path), { recursive: true });
+	writeFileSync(path, `${JSON.stringify(next, null, 2)}\n`, { mode: 384 });
+	return path;
+}
 function readOidc(raw) {
 	if (raw === null || typeof raw !== "object") return void 0;
 	const obj = raw;
@@ -3272,6 +3228,7 @@ function readStoredConfig() {
 	const out = {};
 	if (typeof obj.server === "string") out.server = obj.server;
 	if (typeof obj.token === "string") out.token = obj.token;
+	if (obj.cfAccess === true) out.cfAccess = true;
 	if (typeof obj.user === "string") out.user = obj.user;
 	if (typeof obj.proxySecret === "string") out.proxySecret = obj.proxySecret;
 	const oidc = readOidc(obj.oidc);
@@ -3283,6 +3240,7 @@ function saveConfig(next) {
 	mkdirSync(dirname(path), { recursive: true });
 	const body = { server: next.server };
 	if (next.token !== void 0) body.token = next.token;
+	if (next.cfAccess === true) body.cfAccess = true;
 	if (next.user !== void 0) body.user = next.user;
 	if (next.proxySecret !== void 0) body.proxySecret = next.proxySecret;
 	if (next.oidc !== void 0) body.oidc = next.oidc;
@@ -3300,16 +3258,36 @@ function loadConfig() {
 	const cfg = {
 		server,
 		token: rawToken && rawToken.length > 0 ? rawToken : void 0,
+		...stored.cfAccess === true ? { cfAccess: true } : {},
 		user: user && user.length > 0 ? user : void 0,
 		proxySecret: proxySecret && proxySecret.length > 0 ? proxySecret : void 0
 	};
 	if (stored.oidc) cfg.oidc = stored.oidc;
 	return cfg;
 }
+/** 未验签地读 JWT 的 exp（只用于本地提前给出「去重新登录」的提示；验签永远在 server 侧）。 */
+function jwtExpiry(token) {
+	const parts = token.split(".");
+	if (parts.length !== 3 || parts[1] === void 0) return null;
+	try {
+		const json = Buffer.from(parts[1].replace(/-/g, "+").replace(/_/g, "/"), "base64").toString("utf8");
+		const payload = JSON.parse(json);
+		const exp = payload !== null && typeof payload === "object" ? payload["exp"] : void 0;
+		return typeof exp === "number" ? exp * 1e3 : null;
+	} catch {
+		return null;
+	}
+}
 /** 运行时配置：没有显式 token 时，用已保存 / 环境变量里的 OIDC 客户端去续期。 */
 async function loadRuntimeConfig() {
 	const cfg = loadConfig();
-	if (cfg.token) return cfg;
+	if (cfg.token) {
+		if (cfg.cfAccess === true) {
+			const exp = jwtExpiry(cfg.token);
+			if (exp !== null && exp <= Date.now()) throw new CliError(`Cloudflare Access 会话已过期（${cfg.server}）`, `重新执行 jdu login --server ${cfg.server}，浏览器里的 Cloudflare 会话还在，点一下就续上`);
+		}
+		return cfg;
+	}
 	const issuer = cfg.oidc?.issuer ?? process.env["JIANDU_OIDC_ISSUER"]?.trim();
 	const clientId = cfg.oidc?.clientId ?? process.env["JIANDU_OIDC_CLIENT_ID"]?.trim();
 	if (!issuer || !clientId) return cfg;
@@ -3325,240 +3303,433 @@ async function loadRuntimeConfig() {
 	return cfg;
 }
 //#endregion
-//#region src/comments.ts
-var QUOTE_MAX = 120;
-function when(ms) {
-	return new Date(ms).toISOString().slice(0, 16).replace("T", " ");
+//#region src/cf-oauth.ts
+/**
+* Cloudflare 账号的 OAuth：`jdu deploy` / `jdu access` 拿一把能配 Access 的 token。
+*
+* 为什么不复用 `wrangler login` 的结果：wrangler 的 OAuth 客户端请求的 scope 里没有 Zero Trust，
+* 实测拿它的 token 打 `POST /accounts/<id>/access/apps` 是 `1010 auth.forbidden`。
+* Cloudflare 自己的 CLI OAuth 客户端（wrangler 包里以 `CLOUDFLARE_CLIENT_ID` 常量存在）
+* 的 scope 集合里有 `access:read` / `access:write`，专门干这件事。
+*
+* 这条路需要人在浏览器里点一次同意（与 `wrangler login` 同类）；想跳过就用
+* `--cf-token` 或 `CLOUDFLARE_API_TOKEN` 给一把带 Access 权限的 API token。
+*
+* 回调固定 `http://localhost:8877/oauth/callback`：OAuth 的 redirect_uri 是精确匹配的，
+* 不能用随机端口。PKCE（S256）保证 code 拿到也用不了。
+*/
+var CF_AUTH_URL = "https://dash.cloudflare.com/oauth2/auth";
+var CF_TOKEN_URL = "https://dash.cloudflare.com/oauth2/token";
+/** Cloudflare CLI（cf）的 OAuth 客户端；`CLOUDFLARE_CLIENT_ID` 可覆盖（测试 / 换客户端）。 */
+var CF_CLIENT_ID_ENV = "CLOUDFLARE_CLIENT_ID";
+var CF_CLIENT_ID_DEFAULT = "cbca97e7-c331-4cdd-8fd8-e25a451b98bf";
+/** OAuth 客户端里登记的回调地址，端口不能换。 */
+var CF_REDIRECT_URL = "http://localhost:8877/oauth/callback";
+var CF_CALLBACK_PORT = 8877;
+/**
+* 申请的 scope：Access 配置（access:read/write）＋ wrangler 部署同样的 Workers 面。
+* 这份 token 会以 `CLOUDFLARE_API_TOKEN` 交给 wrangler deploy，所以 workers 那几项不能少。
+*/
+var CF_SCOPES = [
+	"offline_access",
+	"user:read",
+	"account:read",
+	"access:read",
+	"access:write",
+	"workers:write",
+	"workers_scripts:write",
+	"workers_kv:write",
+	"workers_routes:write",
+	"workers_tail:read",
+	"d1:write",
+	"pages:write",
+	"zone:read"
+];
+function cfClientId(env = process.env) {
+	const fromEnv = env[CF_CLIENT_ID_ENV]?.trim();
+	return fromEnv && fromEnv.length > 0 ? fromEnv : CF_CLIENT_ID_DEFAULT;
 }
-/** owner 是 UUID 且没有显示名时 authorLabel 为空串，退回原始 id 也比空着好认。 */
-function who(c) {
-	return `${c.authorLabel || c.author}${c.authorType === "ai" ? " [ai]" : ""}`;
+/** 浏览器授权码流程：开浏览器 → 本地回调收 code → 换 token。 */
+async function cfOAuthLogin(opts = {}) {
+	const { verifier, challenge } = pkce();
+	const state = randomBytes(16).toString("base64url");
+	const authURL = new URL(CF_AUTH_URL);
+	authURL.search = new URLSearchParams({
+		response_type: "code",
+		client_id: cfClientId(),
+		redirect_uri: CF_REDIRECT_URL,
+		scope: CF_SCOPES.join(" "),
+		state,
+		code_challenge: challenge,
+		code_challenge_method: "S256"
+	}).toString();
+	const tok = await tokenRequest(CF_TOKEN_URL, {
+		grant_type: "authorization_code",
+		code: await new Promise((resolve, reject) => {
+			const finish = (fn) => (value) => {
+				clearTimeout(timer);
+				server.close();
+				fn(value);
+			};
+			const fail = finish((msg) => reject(new CliError(msg, "不想开浏览器就用 --cf-token <token>（Cloudflare API token，需要 Access 权限）")));
+			const handler = callbackHandler(state, finish(resolve));
+			const server = createServer((req, res) => {
+				if (new URL(req.url ?? "/", "http://localhost").pathname !== "/oauth/callback") {
+					res.writeHead(404).end();
+					return;
+				}
+				handler(req, res);
+			});
+			const timer = setTimeout(() => fail("等待 Cloudflare 授权回调超时"), opts.timeoutMs ?? 3e5);
+			server.on("error", (err) => {
+				fail(`监听 ${CF_REDIRECT_URL} 失败（端口 8877 被占用？）：${err.message}`);
+			});
+			server.listen(CF_CALLBACK_PORT, "localhost", () => {
+				process.stderr.write(`在浏览器中授权 Cloudflare 账号：${authURL.toString()}\n`);
+				(opts.open ?? openBrowser)(authURL.toString());
+			});
+		}),
+		redirect_uri: CF_REDIRECT_URL,
+		client_id: cfClientId(),
+		code_verifier: verifier
+	});
+	return {
+		accessToken: tok.access_token,
+		refreshToken: tok.refresh_token,
+		expiry: tok.expiry
+	};
 }
-function indent(text, pad) {
-	return text.split("\n").map((line) => `${pad}${line}`).join("\n");
+/** refresh token 换新 access token；失败返回 null（调用方回落成重新登录）。 */
+async function cfRefresh(refreshToken) {
+	try {
+		const tok = await tokenRequest(CF_TOKEN_URL, {
+			grant_type: "refresh_token",
+			refresh_token: refreshToken,
+			client_id: cfClientId()
+		});
+		return {
+			accessToken: tok.access_token,
+			refreshToken: tok.refresh_token ?? refreshToken,
+			expiry: tok.expiry
+		};
+	} catch {
+		return null;
+	}
 }
+//#endregion
+//#region src/cf-api.ts
 /**
-* 线程列表。stdout 纯文本、一线程一段，给 agent 直接读：
-* 首行 `<threadId>  <blockId>  <open|resolved>  <作者>  <时间>  [v<seq>]`，引文一行 `> …`，正文缩进两格，回复 `↳` 缩进。
+* Cloudflare API 薄封装 + Access（Zero Trust）的幂等配置。`jdu deploy` 与 `jdu access` 共用。
+*
+* 只做两件事：把 `/client/v4` 的信封拆开（`{success, result, errors}` → 抛 CliError 或返回 result），
+* 以及把「建 team / 确保 Cloudflare IdP / upsert 保护 /p 的应用与邮箱策略」写成幂等函数。
+*
+* 凭据优先级：`--cf-token` / `CLOUDFLARE_API_TOKEN` > 本地缓存（~/.config/jiandu/cf.json）> 浏览器 OAuth。
+* 缓存的 access token 过期就用 refresh token 换；换不动就重跑 OAuth。
 */
-async function listComments(api, docId, opts) {
-	const res = await api.getJson(`/api/docs/${encodeURIComponent(docId)}/comments`);
-	const all = Array.isArray(res?.comments) ? res.comments : [];
-	const roots = all.filter((c) => c.parentId === null && (opts.all || !c.resolved));
-	if (roots.length === 0) {
-		process.stdout.write(`${opts.all ? "(无评论)" : "(无未处理评论)"}\n`);
-		return;
+var API = "https://api.cloudflare.com/client/v4";
+function firstError(body) {
+	const err = body.errors?.[0];
+	return {
+		code: err?.code ?? 0,
+		message: err?.message ?? err?.error ?? "未知错误"
+	};
+}
+/** 权限不够（Cloudflare 用 1010/10000/9109 表达）时给一句能干的话，别让人对着裸错误码发愣。 */
+function hintFor(status, code) {
+	if (code === 1010 || code === 9109 || code === 1e4 && status === 403) return "这把 token 没有 Zero Trust（Access）权限：用浏览器登录一次 jdu deploy，或 --cf-token 给一把带「Access: Apps and Policies / Organizations, Identity Providers and Groups」编辑权限的 API token";
+	if (status === 401) return "Cloudflare 凭据已失效：重新执行 jdu deploy（会打开浏览器授权）";
+}
+var CfApi = class {
+	credentials;
+	onTokens;
+	fetchImpl;
+	constructor(opts) {
+		this.credentials = opts.credentials;
+		this.onTokens = opts.onTokens;
+		this.fetchImpl = opts.fetchImpl ?? ((input, init) => fetch(input, init));
+	}
+	get accountId() {
+		return this.credentials.accountId;
+	}
+	get email() {
+		return this.credentials.email;
+	}
+	get tokens() {
+		return this.credentials.tokens;
+	}
+	/** 401 时用 refresh token 续一次再重试；续不动就抛错让人重新登录。 */
+	async request(method, path, body) {
+		let res = await this.send(method, path, body);
+		if (res.status === 401 && this.credentials.tokens.refreshToken) {
+			const refreshed = await cfRefresh(this.credentials.tokens.refreshToken);
+			if (refreshed) {
+				this.credentials.tokens = refreshed;
+				this.onTokens?.(refreshed);
+				res = await this.send(method, path, body);
+			}
+		}
+		const text = await res.text();
+		let parsed = {};
+		try {
+			parsed = JSON.parse(text);
+		} catch {}
+		if (!res.ok || parsed.success === false) {
+			const err = firstError(parsed);
+			const detail = err.message !== "未知错误" ? err.message : text.slice(0, 200);
+			throw new CliError(`Cloudflare API ${method} ${path} 失败（HTTP ${res.status}${err.code ? `，code ${err.code}` : ""}）：${detail}`, hintFor(res.status, err.code));
+		}
+		return parsed.result;
+	}
+	send(method, path, body) {
+		return this.fetchImpl(`${API}${path}`, {
+			method,
+			headers: {
+				authorization: `Bearer ${this.credentials.tokens.accessToken}`,
+				...body === void 0 ? {} : { "content-type": "application/json" }
+			},
+			...body === void 0 ? {} : { body: JSON.stringify(body) }
+		});
 	}
-	const replies = /* @__PURE__ */ new Map();
-	for (const c of all) {
-		if (c.parentId === null) continue;
-		const list = replies.get(c.parentId) ?? [];
-		list.push(c);
-		replies.set(c.parentId, list);
+};
+function isFresh(tokens) {
+	const at = Date.parse(tokens.expiry);
+	return Number.isFinite(at) && at - 6e4 > Date.now();
+}
+/**
+* 拿一份能调 Cloudflare API 的凭据。`--cf-token` / 环境变量优先（CI / 已有 API token 的人），
+* 其次本地缓存（过期先 refresh），最后才开浏览器走 OAuth。
+*
+* 拿到 token 后顺手把 account id / 邮箱补齐（API token 本身不带这两个信息）：
+* 后续所有 API 路径都要 account id，`jdu access` 也就不需要再问。
+*/
+async function resolveCfCredentials(opts) {
+	const env = opts.env ?? process.env;
+	const given = (opts.cfToken ?? env["JIANDU_CF_TOKEN"] ?? env["CLOUDFLARE_API_TOKEN"] ?? "").trim();
+	const stored = readCfConfig();
+	let source = "oauth";
+	let tokens;
+	if (given !== "") {
+		tokens = {
+			accessToken: given,
+			expiry: new Date(Date.now() + 31536e6).toISOString()
+		};
+		source = "flag";
+	} else {
+		const cached = tokensOf(stored);
+		if (cached && isFresh(cached)) {
+			tokens = cached;
+			source = "cache";
+		} else if (cached?.refreshToken) {
+			const refreshed = await cfRefresh(cached.refreshToken);
+			if (refreshed) {
+				tokens = refreshed;
+				source = "cache";
+				writeCfConfig({
+					...stored,
+					...serialize(refreshed)
+				});
+			}
+		}
+	}
+	if (tokens === void 0) {
+		if (opts.allowBrowser === false) throw new CliError("没有可用的 Cloudflare 凭据（本地缓存过期，也没给 --cf-token）", "传 --cf-token <token>（带 Access 权限的 Cloudflare API token），或不带 --json 跑一次让浏览器授权");
+		tokens = await cfOAuthLogin(opts.open ? { open: opts.open } : {});
+		writeCfConfig({
+			...readCfConfig(),
+			...serialize(tokens)
+		});
+	}
+	const credentials = {
+		accountId: stored.accountId ?? "",
+		email: stored.email ?? "",
+		tokens,
+		source
+	};
+	if (credentials.accountId === "" || credentials.email === "") {
+		const identity = await readIdentity(new CfApi({
+			credentials,
+			...opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}
+		}));
+		credentials.accountId = identity.accountId;
+		credentials.email = identity.email;
+		writeCfConfig({
+			...readCfConfig(),
+			accountId: identity.accountId,
+			email: identity.email
+		});
 	}
+	return credentials;
+}
+function tokensOf(stored) {
+	if (typeof stored.accessToken !== "string" || stored.accessToken === "") return null;
+	const tokens = {
+		accessToken: stored.accessToken,
+		expiry: typeof stored.expiry === "string" ? stored.expiry : ""
+	};
+	if (typeof stored.refreshToken === "string" && stored.refreshToken !== "") tokens.refreshToken = stored.refreshToken;
+	return tokens;
+}
+function serialize(tokens) {
+	const out = {
+		accessToken: tokens.accessToken,
+		expiry: tokens.expiry
+	};
+	if (tokens.refreshToken !== void 0) out.refreshToken = tokens.refreshToken;
+	return out;
+}
+/** `GET /user` + `GET /accounts`：只认第一个账号（个人自部署形态就是单人单账号）。 */
+async function readIdentity(api) {
+	const user = await api.request("GET", "/user");
+	const accountId = (await api.request("GET", "/accounts")).find((a) => typeof a.id === "string" && a.id !== "")?.id ?? "";
+	const email = user.email ?? "";
+	if (accountId === "") throw new CliError("读不到 Cloudflare account id", "GET /accounts 返回空");
+	if (email === "") throw new CliError("读不到 Cloudflare 账号邮箱", "GET /user 没有 email");
+	return {
+		accountId,
+		email: email.toLowerCase()
+	};
+}
+/** 应用策略里所有 email 规则（`{email:{email}}`），小写去重、保持原顺序。 */
+function emailsOf(policy) {
 	const out = [];
-	for (const root of roots) {
-		const head = [
-			root.id,
-			root.blockId ?? "-",
-			root.resolved ? "resolved" : "open",
-			who(root),
-			when(root.createdAt)
-		];
-		if (root.versionSeq !== null) head.push(`v${root.versionSeq}`);
-		out.push(head.join("  "));
-		const quote = root.selection?.quote;
-		if (quote) out.push(`  > ${quote.length > QUOTE_MAX ? `${quote.slice(0, QUOTE_MAX)}…` : quote}`);
-		out.push(indent(root.body, "  "));
-		for (const reply of replies.get(root.id) ?? []) {
-			out.push(`  ↳ ${reply.id}  ${who(reply)}  ${when(reply.createdAt)}`);
-			out.push(indent(reply.body, "    "));
-		}
-		out.push("");
+	for (const rule of policy.include ?? []) {
+		if (typeof rule !== "object" || rule === null) continue;
+		const email = rule.email?.email;
+		if (typeof email !== "string") continue;
+		const normalized = email.trim().toLowerCase();
+		if (normalized !== "" && !out.includes(normalized)) out.push(normalized);
 	}
-	process.stdout.write(out.join("\n"));
+	return out;
 }
-async function replyComment(api, threadId, opts) {
-	const res = await api.postJson(`/api/comments/${encodeURIComponent(threadId)}/reply`, {
-		body: opts.message,
-		authorType: opts.ai ? "ai" : "human"
+/** 保留策略里非 email 的规则（人手加的账号成员选择器等），只重写 email 那部分。 */
+function nonEmailRules(policy) {
+	return (policy.include ?? []).filter((rule) => {
+		if (typeof rule !== "object" || rule === null) return true;
+		return !("email" in rule);
 	});
-	process.stdout.write(`replied ${String(res?.parentId ?? threadId)} → ${String(res?.id ?? "")}\n`);
 }
-async function resolveComment(api, threadId, opts) {
-	const res = await api.postJson(`/api/comments/${encodeURIComponent(threadId)}/resolve`, { resolved: !opts.undo });
-	process.stdout.write(`${opts.undo ? "reopened" : "resolved"} ${String(res?.id ?? threadId)}\n`);
+function emailRules(emails) {
+	return emails.map((email) => ({ email: { email } }));
 }
-//#endregion
-//#region src/http.ts
-/** 错误响应体太长会淹没终端，只留头部。 */
-var MAX_DETAIL = 400;
-var ApiClient = class {
-	server;
-	token;
-	/** forward-auth 直连身份：作为 X-Forwarded-User 注入（server 默认 userHeader） */
-	user;
-	/** forward-auth fail-closed 的共享密钥：作为 X-Jiandu-Proxy-Secret 注入 */
-	proxySecret;
-	constructor(cfg) {
-		this.server = cfg.server;
-		this.token = cfg.token;
-		this.user = cfg.user;
-		this.proxySecret = cfg.proxySecret;
+/** 建好的应用认领方式：先按 host 的 `/p` 目标认，认不到再按名字。 */
+function appMatchesHost(app, host) {
+	if ((app.destinations ?? []).map((d) => d.uri ?? "").some((uri) => uri.startsWith(`${host}/p`))) return true;
+	return app.domain === `${host}/p` || app.domain === host;
+}
+async function listApps(api) {
+	return await api.request("GET", `/accounts/${api.accountId}/access/apps`);
+}
+async function findAppForHost(api, host) {
+	return (await listApps(api)).find((app) => appMatchesHost(app, host)) ?? null;
+}
+async function appPolicies(api, appId) {
+	return await api.request("GET", `/accounts/${api.accountId}/access/apps/${appId}/policies`);
+}
+/** 直接改策略的 include（保留其它规则与 decision / name）。 */
+async function setPolicyEmails(api, appId, policy, emails) {
+	await api.request("PUT", `/accounts/${api.accountId}/access/apps/${appId}/policies/${policy.id}`, {
+		name: policy.name ?? "jiandu",
+		decision: policy.decision ?? "allow",
+		include: [...emailRules(emails), ...nonEmailRules(policy)]
+	});
+}
+async function getOrganization(api) {
+	try {
+		return await api.request("GET", `/accounts/${api.accountId}/access/organizations`);
+	} catch {
+		return null;
 	}
-	url(path) {
-		return `${this.server}${path}`;
+}
+/**
+* 账号还没有 Zero Trust team 时建一个。auth_domain 要全局唯一，撞了就换一个后缀重试。
+* 名字里的 account id 前缀足够区分，撞名是极小概率，但撞了不能让整个部署挂在这里。
+*/
+async function ensureOrganization(api, workerName) {
+	const domain = (await getOrganization(api))?.auth_domain;
+	if (typeof domain === "string" && domain !== "") return domain;
+	const base = `${workerName}-${api.accountId.slice(0, 8)}`.replace(/[^a-z0-9-]/gi, "-").toLowerCase();
+	for (const candidate of [base, `${base}-${Date.now().toString(36).slice(-4)}`]) try {
+		const created = await api.request("POST", `/accounts/${api.accountId}/access/organizations`, {
+			name: workerName,
+			auth_domain: candidate
+		});
+		if (typeof created.auth_domain === "string" && created.auth_domain !== "") return created.auth_domain;
+	} catch (err) {
+		const again = await getOrganization(api);
+		if (typeof again?.auth_domain === "string" && again.auth_domain !== "") return again.auth_domain;
+		if (candidate.endsWith("4")) throw err;
 	}
-	async getJson(path) {
-		return this.json("GET", path, void 0, void 0);
+	throw new CliError("建 Zero Trust team 失败", "去 Cloudflare 控制台 Zero Trust 里手建一个 team 再重试");
+}
+/** 登录方式必须是 Cloudflare 账号（决策 8）：没有就建一个，已存在就用它。 */
+async function ensureCloudflareIdp(api) {
+	const hit = (await api.request("GET", `/accounts/${api.accountId}/access/identity_providers`)).find((p) => p.type === "cloudflare");
+	if (hit) return hit.id;
+	return (await api.request("POST", `/accounts/${api.accountId}/access/identity_providers`, {
+		name: "Cloudflare",
+		type: "cloudflare",
+		config: { restrict_to_account_members: false }
+	})).id;
+}
+/**
+* 保护 `/p*` 的应用：没有就建，有就保证部署者邮箱在策略里（其余邮箱保留）。
+* 只挡 /p：公开页（/d、/docs、/official、静态资源）与读 API 都不挂 Access，
+* 写 API 由 Worker 自己验同一份 JWT——理由见 docs/deploy.md「Cloudflare 形态」。
+*/
+async function ensureAccessApp(api, input) {
+	const destinations = [{
+		type: "public",
+		uri: `${input.host}/p`
+	}, {
+		type: "public",
+		uri: `${input.host}/p/*`
+	}];
+	const existing = await findAppForHost(api, input.host);
+	const app = existing ?? await api.request("POST", `/accounts/${api.accountId}/access/apps`, {
+		name: input.name,
+		type: "self_hosted",
+		destinations,
+		session_duration: "24h",
+		allowed_idps: [input.idpId],
+		auto_redirect_to_identity: true,
+		skip_interstitial: true,
+		app_launcher_visible: false
+	});
+	const policies = await appPolicies(api, app.id);
+	const policy = policies.find((p) => (p.decision ?? "allow") === "allow") ?? policies[0];
+	const current = policy ? emailsOf(policy) : [];
+	const wanted = ensureEmailIncluded(current, input.emails);
+	if (policy) {
+		if (wanted.length !== current.length || wanted.some((e, i) => current[i] !== e)) await setPolicyEmails(api, app.id, policy, wanted);
+	} else await api.request("POST", `/accounts/${api.accountId}/access/apps/${app.id}/policies`, {
+		name: input.name,
+		decision: "allow",
+		include: emailRules(wanted)
+	});
+	return {
+		app,
+		emails: wanted,
+		existed: existing !== null
+	};
+}
+/** 合并邮箱：保序去重，且保证部署者邮箱一定在。 */
+function ensureEmailIncluded(current, wanted) {
+	const out = [...current];
+	for (const email of wanted) {
+		const normalized = email.trim().toLowerCase();
+		if (normalized !== "" && !out.includes(normalized)) out.push(normalized);
 	}
-	async postJson(path, body) {
-		return this.json("POST", path, JSON.stringify(body), "application/json");
-	}
-	async putJson(path, body) {
-		return this.json("PUT", path, JSON.stringify(body), "application/json");
-	}
-	async deleteJson(path) {
-		return this.json("DELETE", path, void 0, void 0);
-	}
-	/** 文本路由（`/d/:id.md`）：原样返回正文。 */
-	async getText(path) {
-		return (await this.send("GET", path, void 0, void 0)).text();
-	}
-	/** widget push 走 multipart：boundary 交给 fetch 生成，别自己设 Content-Type。 */
-	async postForm(path, form) {
-		const text = await (await this.send("POST", path, form, void 0)).text();
-		if (text.trim() === "") return void 0;
-		try {
-			return JSON.parse(text);
-		} catch {
-			throw new CliError(`POST ${this.url(path)} 返回的不是合法 JSON：${clip(text)}`);
-		}
-	}
-	/** blob 上传走原始字节，不做任何包装 —— server 直接对 body 校验 sha256。 */
-	async putBytes(path, bytes, contentType) {
-		await this.send("PUT", path, bytes, contentType);
-	}
-	async json(method, path, body, contentType) {
-		const text = await (await this.send(method, path, body, contentType)).text();
-		if (text.trim() === "") return void 0;
-		try {
-			return JSON.parse(text);
-		} catch {
-			throw new CliError(`${method} ${this.url(path)} 返回的不是合法 JSON：${clip(text)}`);
-		}
-	}
-	async send(method, path, body, contentType) {
-		const url = this.url(path);
-		const headers = {};
-		if (this.token !== void 0) headers.Authorization = `Bearer ${this.token}`;
-		if (this.user !== void 0) headers["X-Forwarded-User"] = this.user;
-		if (this.proxySecret !== void 0) headers["X-Jiandu-Proxy-Secret"] = this.proxySecret;
-		if (contentType !== void 0) headers["Content-Type"] = contentType;
-		let res;
-		try {
-			res = await fetch(url, {
-				method,
-				headers,
-				body,
-				redirect: "manual"
-			});
-		} catch (err) {
-			throw new CliError(`请求 ${method} ${url} 失败：${describeNetworkError(err)}`, "确认 server 已启动、地址与端口正确");
-		}
-		if (!res.ok) throw await httpError(method, url, res);
-		return res;
-	}
-};
-function clip(text) {
-	const t = text.trim();
-	return t.length > MAX_DETAIL ? `${t.slice(0, MAX_DETAIL)}…` : t;
-}
-/** fetch 失败时真正的原因藏在 cause 里（ECONNREFUSED / ENOTFOUND / 证书错误…）。 */
-function describeNetworkError(err) {
-	const cause = err?.cause;
-	if (cause instanceof Error) {
-		const code = cause.code;
-		return code ? `${code} ${cause.message}` : cause.message;
-	}
-	return err instanceof Error ? err.message : String(err);
-}
-async function httpError(method, url, res) {
-	let detail = "";
-	try {
-		detail = clip(await res.text());
-	} catch {
-		detail = "";
-	}
-	if (detail.startsWith("{")) try {
-		const obj = JSON.parse(detail);
-		const msg = obj.error ?? obj.message;
-		if (typeof msg === "string" && msg !== "") detail = msg;
-	} catch {}
-	const hint = res.status === 401 || res.status === 403 ? "token 无效或无权访问，执行 jdu login --server <url>；forward-auth 下确认已设 JIANDU_FORWARD_AUTH_USER 与 JIANDU_PROXY_SECRET" : res.status === 302 ? "网关要登录。forward-auth 下先 jdu login；若已登录，网关需接受 Authorization: Bearer" : void 0;
-	const suffix = detail === "" ? "" : `：${detail}`;
-	return new CliError(`${method} ${url} 返回 HTTP ${res.status} ${res.statusText}${suffix}`, hint);
+	return out;
 }
-//#endregion
-//#region src/browser-auth.ts
-/**
-* jdu login 的浏览器授权（#66）：本机起一个 loopback 回调，打开 server 下发的 authorizeUrl，
-* 人在浏览器里用 passkey 会话点一次「授权」，回跳带回一次性 code，再用 PKCE verifier 向 server 换 token。
-*
-* authorizeUrl 与 server 可能不同源（CLI 连 127.0.0.1:18082，浏览器开 https://md.mason.local）——
-* 浏览器去前者，code 换 token 打后者。回调端口随机（server 接受任意 loopback 端口），不和 OIDC 的 8085 抢。
-*/
-async function browserAuthorize(input) {
-	const { verifier, challenge } = pkce();
-	const state = randomBytes(16).toString("base64url");
-	const code = await new Promise((resolve, reject) => {
-		const finish = (fn) => (value) => {
-			clearTimeout(timer);
-			server.close();
-			fn(value);
-		};
-		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") {
-				res.writeHead(404).end();
-				return;
-			}
-			handler(req, res);
-		});
-		const timer = setTimeout(() => fail("等待浏览器授权超时"), input.timeoutMs ?? 18e4);
-		server.on("error", (err) => fail(`监听 loopback 回调失败：${err.message}`));
-		server.listen(0, "127.0.0.1", () => {
-			const port = server.address().port;
-			const url = new URL(input.authorizeUrl);
-			url.search = new URLSearchParams({
-				state,
-				code_challenge: challenge,
-				port: String(port),
-				label: input.label ?? hostname()
-			}).toString();
-			process.stderr.write(`在浏览器中完成授权：${url.toString()}\n`);
-			(input.open ?? openBrowser)(url.toString());
-		});
-	});
-	const res = await fetch(`${input.server}/api/cli/token`, {
-		method: "POST",
-		headers: { "content-type": "application/json" },
-		body: JSON.stringify({
-			code,
-			code_verifier: verifier
-		})
-	});
-	const text = await res.text();
-	if (!res.ok) throw new CliError(`code 换 token 失败（HTTP ${res.status}）：${text.slice(0, 200)}`, "重新执行 jdu login 再试一次");
-	let token;
+/** `GET /accounts/:id/workers/subdomain`：拿不到（账号还没注册 workers.dev 子域）返回 null。 */
+async function workersDevSubdomain(api) {
 	try {
-		token = JSON.parse(text).token;
+		const result = await api.request("GET", `/accounts/${api.accountId}/workers/subdomain`);
+		return typeof result.subdomain === "string" && result.subdomain !== "" ? result.subdomain : null;
 	} catch {
-		token = void 0;
+		return null;
 	}
-	if (typeof token !== "string" || token === "") throw new CliError("server 没有返回 token");
-	return token;
 }
 //#endregion
 //#region src/login.ts
@@ -3596,6 +3767,13 @@ async function probeApiWithBearer(server, token) {
 		redirect: "manual"
 	})).ok;
 }
+/** Cloudflare 形态的凭据是 Access 应用 token：过边缘用 cf-access-token 头，不是 Bearer。 */
+async function probeApiWithAccessToken(server, token) {
+	return (await fetch(`${server}/api/docs`, {
+		headers: { "cf-access-token": token },
+		redirect: "manual"
+	})).ok;
+}
 /**
 * forward-auth / OIDC 分支，外加 --user 直连与 --token 直存。
 * 不是命令入口——入口是 init.ts 的 runLogin，它探完 healthz 才分派到这里。
@@ -3661,153 +3839,887 @@ async function runOidcLogin(opts) {
 	};
 }
 //#endregion
-//#region src/init.ts
+//#region src/access.ts
 /**
-* jdu login：选定站点、拿到凭据、写好本地配置，一条命令把「登录到哪台简牍」定下来。
-*
-* 目标必须显式给出（没有默认站点，官方商用服务尚未上线）：
-*   --local      本机自部署（http://127.0.0.1:8080）
-*   --server <u> 任意自部署地址
+* `jdu access`：改 Cloudflare 形态实例的准入——Access 策略里的邮箱列表。
 *
-* 为 agent 联动而设计：全 flag 驱动、无交互提示、--json 输出机器可读结果，
-* 拿到 next 字段就知道下一步该干什么（要不要 token、去哪拿）。
+* 加人 = 把同事的邮箱写进 Allow 策略，对方用自己的 Cloudflare 账号（同一邮箱）登录；
+* 减人 = 从策略里去掉。jiandu 自己不存成员表，身份与准入只有 Access 这一个真源（决策 5）。
 *
-* 登录方式全听 server 的（healthz.cliAuth，#66），用户不必先知道自己的站点用什么鉴权：
-*   browser  → 开浏览器授权换 token
-*   oidc     → 委托 runOidcLogin 走 SSO（forward-auth）
-*   token    → 把 server 给的 tokenHint 拼进 next，告诉去哪拿
-*   anonymous→ 直接就绪
-* CLI 不按「官方 / 自部署」猜，也不再要求用户在 init / login 之间二选一。
+* 需要一把有 Access 权限的 Cloudflare 凭据：`jdu deploy` 时授权过就直接用缓存，
+* 否则 `--cf-token` / `CLOUDFLARE_API_TOKEN`，再不行会开浏览器授权。
 */
-var LOCAL_SERVER = "http://127.0.0.1:8080";
-function resolveInitTarget(opts) {
-	if (opts.local && opts.server) throw new CliError("--local 与 --server 只能二选一");
-	if (opts.server !== void 0) {
-		const server = opts.server.trim().replace(/\/+$/, "");
-		let parsed;
-		try {
-			parsed = new URL(server);
-		} catch {
-			throw new CliError(`--server 不是合法 URL：${opts.server}`);
-		}
-		if (parsed.protocol !== "http:" && parsed.protocol !== "https:" || /[\s'"`$\\;|&<>(){}*?#\[\]]/.test(server)) throw new CliError(`--server 需要干净的 http/https 地址（不含空白与 shell 元字符）：${opts.server}`);
-		return {
-			target: "custom",
-			server
-		};
+var EMAIL_RE = /^[^@\s]+@[^@\s]+\.[^@\s]+$/;
+function normalizeEmails(emails) {
+	const out = [];
+	for (const raw of emails) {
+		const email = raw.trim().toLowerCase();
+		if (email === "") continue;
+		if (!EMAIL_RE.test(email)) throw new CliError(`不是合法的邮箱：${raw}`, "邮箱要和对方的 Cloudflare 账号一致");
+		if (!out.includes(email)) out.push(email);
 	}
-	if (opts.local) return {
-		target: "local",
-		server: LOCAL_SERVER
+	return out;
+}
+/** 站点地址：显式给的优先，其次本地配置里的那台。 */
+function serverOf(opts) {
+	const server = (opts.server ?? readStoredConfig().server ?? "").trim().replace(/\/+$/, "");
+	if (server === "") throw new CliError("需要知道改哪台实例的 Access 策略", "带 --server <url>，或先 jdu login --server <url>");
+	return server;
+}
+/** 只有 Cloudflare 形态的实例有 Access 策略；其它 provider 说清而不是给个看不懂的 API 错误。 */
+async function ensureCloudflareInstance(server) {
+	const healthz = await fetchHealthz(server);
+	if (healthz.authProvider !== "cloudflare-access") throw new CliError(`${server} 是 ${healthz.authProvider ?? "未知"} 鉴权，没有 Access 邮箱策略`, "Docker / 本机形态的准入用 jdu member invite（passkey）或网关自己的配置");
+}
+async function locate(opts) {
+	const server = serverOf(opts);
+	await ensureCloudflareInstance(server);
+	const host = new URL(server).host;
+	const api = new CfApi({ credentials: await resolveCfCredentials({ ...opts.cfToken ? { cfToken: opts.cfToken } : {} }) });
+	const app = await findAppForHost(api, host);
+	if (!app) throw new CliError(`${host} 上没有找到 jiandu 的 Access 应用`, "确认实例是用 jdu deploy 部出来的（Access 应用由它建），或去 Zero Trust → Access 看一眼");
+	const policies = await api.request("GET", `/accounts/${api.accountId}/access/apps/${app.id}/policies`);
+	const policy = policies.find((p) => (p.decision ?? "allow") === "allow") ?? policies[0];
+	if (!policy) throw new CliError(`${host} 的 Access 应用没有策略`, "去 Zero Trust → Access 里给它加一条 Allow 策略再重试");
+	return {
+		api,
+		appId: app.id,
+		policyId: policy.id,
+		emails: emailsOf(policy)
 	};
-	throw new CliError("jdu login 需要指定站点", "自部署用 --server <url>，本机用 --local");
 }
-async function runLogin(opts) {
-	const { target, server } = resolveInitTarget(opts);
-	const healthz = await (opts.fetchHealthz ?? fetchHealthz)(server);
-	const provider = healthz.authProvider ?? "token";
-	const methods = healthz.cliAuth?.methods ?? fallbackMethods(provider);
-	const base = {
-		target,
-		server,
-		authProvider: provider,
-		authMethods: methods
+async function runAccessList(opts) {
+	const { api, appId, emails } = await locate(opts);
+	return {
+		server: serverOf(opts),
+		accountId: api.accountId,
+		appId,
+		emails
 	};
-	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({
-			server,
-			token: opts.token
-		});
-		return {
-			...base,
-			loggedIn: true,
-			configPath: path,
-			next: null
-		};
+}
+/** 加邮箱：先把现有的读回来，确保对方不在列表里再加（幂等）。 */
+async function runAccessAllow(emails, opts) {
+	const wanted = normalizeEmails(emails);
+	if (wanted.length === 0) throw new CliError("没有要加的邮箱", "jdu access allow <邮箱> [<邮箱>...]");
+	const { api, appId, policyId, emails: current } = await locate(opts);
+	const merged = ensureEmailIncluded(current, wanted);
+	if (merged.length !== current.length || merged.some((e, i) => current[i] !== e)) await putEmails(api, appId, policyId, merged);
+	return {
+		server: serverOf(opts),
+		accountId: api.accountId,
+		appId,
+		emails: merged
+	};
+}
+async function runAccessDeny(emails, opts) {
+	const unwanted = normalizeEmails(emails);
+	if (unwanted.length === 0) throw new CliError("没有要移除的邮箱", "jdu access deny <邮箱> [<邮箱>...]");
+	const { api, appId, policyId, emails: current } = await locate(opts);
+	const kept = current.filter((email) => !unwanted.includes(email));
+	const missing = unwanted.filter((email) => !current.includes(email));
+	if (missing.length > 0) throw new CliError(`这些邮箱本来就不在策略里：${missing.join(", ")}`, "用 jdu access list 看当前名单（大小写不敏感）");
+	await putEmails(api, appId, policyId, kept);
+	return {
+		server: serverOf(opts),
+		accountId: api.accountId,
+		appId,
+		emails: kept
+	};
+}
+/** 重写策略的 include：email 规则用新名单，其它规则（人手加的账号成员选择器等）原样保留。 */
+async function putEmails(api, appId, policyId, emails) {
+	await setPolicyEmails(api, appId, await api.request("GET", `/accounts/${api.accountId}/access/apps/${appId}/policies/${policyId}`), emails);
+}
+//#endregion
+//#region src/blobs.ts
+/** 流式算 hash，避免把大图整份读进内存。 */
+function sha256File(path) {
+	return new Promise((res, rej) => {
+		const h = createHash("sha256");
+		const rs = createReadStream(path);
+		rs.on("error", rej);
+		rs.on("data", (chunk) => h.update(chunk));
+		rs.on("end", () => res(h.digest("hex")));
+	});
+}
+var MIME$1 = Object.freeze({
+	".md": "text/markdown; charset=utf-8",
+	".markdown": "text/markdown; charset=utf-8",
+	".txt": "text/plain; charset=utf-8",
+	".json": "application/json",
+	".js": "text/javascript; charset=utf-8",
+	".mjs": "text/javascript; charset=utf-8",
+	".css": "text/css; charset=utf-8",
+	".html": "text/html; charset=utf-8",
+	".svg": "image/svg+xml",
+	".png": "image/png",
+	".jpg": "image/jpeg",
+	".jpeg": "image/jpeg",
+	".gif": "image/gif",
+	".webp": "image/webp",
+	".avif": "image/avif",
+	".ico": "image/x-icon",
+	".mp4": "video/mp4",
+	".webm": "video/webm",
+	".mov": "video/quicktime",
+	".mp3": "audio/mpeg",
+	".wav": "audio/wav",
+	".pdf": "application/pdf",
+	".zip": "application/zip",
+	".woff2": "font/woff2"
+});
+function guessMime(path) {
+	return MIME$1[extname(path).toLowerCase()] ?? "application/octet-stream";
+}
+/**
+* 增量上传：先用 hash 清单跟 server 协商，只 PUT 缺失的。
+* server 返回体不可解析时按「全都缺」处理 —— 宁可多传也不能漏传导致文档半残。
+*/
+async function syncBlobs(api, entries) {
+	const byHash = /* @__PURE__ */ new Map();
+	for (const e of entries) if (!byHash.has(e.hash)) byHash.set(e.hash, e.path);
+	const hashes = [...byHash.keys()];
+	if (hashes.length === 0) return {
+		total: 0,
+		uploaded: [],
+		reused: 0
+	};
+	const res = await api.postJson("/api/blobs/check", { hashes });
+	const missing = Array.isArray(res?.missing) ? res.missing.filter((h) => typeof h === "string") : hashes;
+	const uploaded = [];
+	for (const hash of missing) {
+		const path = byHash.get(hash);
+		if (path === void 0) continue;
+		await api.putBytes(`/api/blobs/${hash}`, readFileSync(path), guessMime(path));
+		uploaded.push(hash);
+	}
+	return {
+		total: hashes.length,
+		uploaded,
+		reused: hashes.length - uploaded.length
+	};
+}
+//#endregion
+//#region src/comments.ts
+/** 附件一行：`[图片 ×N] /blob/… /blob/…`，给 agent 的是相对路径，拼上 server 地址就能取 */
+function attachmentsLine(c) {
+	const list = c.attachments ?? [];
+	return list.length === 0 ? null : `[图片 ×${list.length}] ${list.map((s) => `/blob/${s}`).join(" ")}`;
+}
+var QUOTE_MAX = 120;
+function when(ms) {
+	return new Date(ms).toISOString().slice(0, 16).replace("T", " ");
+}
+/** owner 是 UUID 且没有显示名时 authorLabel 为空串，退回原始 id 也比空着好认。 */
+function who(c) {
+	return `${c.authorLabel || c.author}${c.authorType === "ai" ? " [ai]" : ""}`;
+}
+function indent(text, pad) {
+	return text.split("\n").map((line) => `${pad}${line}`).join("\n");
+}
+/**
+* 线程列表。stdout 纯文本、一线程一段，给 agent 直接读：
+* 首行 `<threadId>  <blockId>  <open|resolved>  <作者>  <时间>  [v<seq>]`，引文一行 `> …`，正文缩进两格，回复 `↳` 缩进。
+*/
+async function listComments(api, docId, opts) {
+	const res = await api.getJson(`/api/docs/${encodeURIComponent(docId)}/comments`);
+	const all = Array.isArray(res?.comments) ? res.comments : [];
+	const roots = all.filter((c) => c.parentId === null && (opts.all || !c.resolved));
+	if (roots.length === 0) {
+		process.stdout.write(`${opts.all ? "(无评论)" : "(无未处理评论)"}\n`);
+		return;
+	}
+	const replies = /* @__PURE__ */ new Map();
+	for (const c of all) {
+		if (c.parentId === null) continue;
+		const list = replies.get(c.parentId) ?? [];
+		list.push(c);
+		replies.set(c.parentId, list);
+	}
+	const out = [];
+	for (const root of roots) {
+		const head = [
+			root.id,
+			root.blockId ?? "全文",
+			root.resolved ? "resolved" : "open",
+			who(root),
+			when(root.createdAt)
+		];
+		if (root.versionSeq !== null) head.push(`v${root.versionSeq}`);
+		out.push(head.join("  "));
+		const quote = root.selection?.quote;
+		if (quote) out.push(`  > ${quote.length > QUOTE_MAX ? `${quote.slice(0, QUOTE_MAX)}…` : quote}`);
+		if (root.body) out.push(indent(root.body, "  "));
+		const rootPics = attachmentsLine(root);
+		if (rootPics) out.push(`  ${rootPics}`);
+		for (const reply of replies.get(root.id) ?? []) {
+			out.push(`  ↳ ${reply.id}  ${who(reply)}  ${when(reply.createdAt)}`);
+			if (reply.body) out.push(indent(reply.body, "    "));
+			const pics = attachmentsLine(reply);
+			if (pics) out.push(`    ${pics}`);
+		}
+		out.push("");
+	}
+	process.stdout.write(out.join("\n"));
+}
+async function replyComment(api, threadId, opts) {
+	const res = await api.postJson(`/api/comments/${encodeURIComponent(threadId)}/reply`, {
+		body: opts.message,
+		authorType: opts.ai ? "ai" : "human"
+	});
+	process.stdout.write(`replied ${String(res?.parentId ?? threadId)} → ${String(res?.id ?? "")}\n`);
+}
+async function resolveComment(api, threadId, opts) {
+	const res = await api.postJson(`/api/comments/${encodeURIComponent(threadId)}/resolve`, { resolved: !opts.undo });
+	process.stdout.write(`${opts.undo ? "reopened" : "resolved"} ${String(res?.id ?? threadId)}\n`);
+}
+//#endregion
+//#region src/browser-auth.ts
+/**
+* jdu login 的浏览器授权（#66）：本机起一个 loopback 回调，打开 server 下发的 authorizeUrl，
+* 人在浏览器里用 passkey 会话点一次「授权」，回跳带回一次性 code，再用 PKCE verifier 向 server 换 token。
+*
+* authorizeUrl 与 server 可能不同源（CLI 连 127.0.0.1:18082，浏览器开 https://md.mason.local）——
+* 浏览器去前者，code 换 token 打后者。回调端口随机（server 接受任意 loopback 端口），不和 OIDC 的 8085 抢。
+*/
+async function browserAuthorize(input) {
+	const { verifier, challenge } = pkce();
+	const state = randomBytes(16).toString("base64url");
+	const code = await new Promise((resolve, reject) => {
+		const finish = (fn) => (value) => {
+			clearTimeout(timer);
+			server.close();
+			fn(value);
+		};
+		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") {
+				res.writeHead(404).end();
+				return;
+			}
+			handler(req, res);
+		});
+		const timer = setTimeout(() => fail("等待浏览器授权超时"), input.timeoutMs ?? 18e4);
+		server.on("error", (err) => fail(`监听 loopback 回调失败：${err.message}`));
+		server.listen(0, "127.0.0.1", () => {
+			const port = server.address().port;
+			const url = new URL(input.authorizeUrl);
+			url.search = new URLSearchParams({
+				state,
+				code_challenge: challenge,
+				port: String(port),
+				label: input.label ?? hostname()
+			}).toString();
+			process.stderr.write(`在浏览器中完成授权：${url.toString()}\n`);
+			(input.open ?? openBrowser)(url.toString());
+		});
+	});
+	const res = await fetch(`${input.server}/api/cli/token`, {
+		method: "POST",
+		headers: { "content-type": "application/json" },
+		body: JSON.stringify({
+			code,
+			code_verifier: verifier
+		})
+	});
+	const text = await res.text();
+	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;
+	} catch {
+		token = void 0;
+	}
+	if (typeof token !== "string" || token === "") throw new CliError("server 没有返回 token");
+	return token;
+}
+//#endregion
+//#region src/init.ts
+/**
+* jdu login：选定站点、拿到凭据、写好本地配置，一条命令把「登录到哪台简牍」定下来。
+*
+* 目标必须显式给出（没有默认站点，官方商用服务尚未上线）：
+*   --local      本机自部署（http://127.0.0.1:8080）
+*   --server <u> 任意自部署地址
+*
+* 为 agent 联动而设计：全 flag 驱动、无交互提示、--json 输出机器可读结果，
+* 拿到 next 字段就知道下一步该干什么（要不要 token、去哪拿）。
+*
+* 登录方式全听 server 的（healthz.cliAuth，#66），用户不必先知道自己的站点用什么鉴权：
+*   browser  → 开浏览器授权换 token
+*   oidc     → 委托 runOidcLogin 走 SSO（forward-auth）
+*   token    → 把 server 给的 tokenHint 拼进 next，告诉去哪拿
+*   anonymous→ 直接就绪
+* CLI 不按「官方 / 自部署」猜，也不再要求用户在 init / login 之间二选一。
+*/
+var LOCAL_SERVER = "http://127.0.0.1:8080";
+function resolveInitTarget(opts) {
+	if (opts.local && opts.server) throw new CliError("--local 与 --server 只能二选一");
+	if (opts.server !== void 0) {
+		const server = opts.server.trim().replace(/\/+$/, "");
+		let parsed;
+		try {
+			parsed = new URL(server);
+		} catch {
+			throw new CliError(`--server 不是合法 URL：${opts.server}`);
+		}
+		if (parsed.protocol !== "http:" && parsed.protocol !== "https:" || /[\s'"`$\\;|&<>(){}*?#\[\]]/.test(server)) throw new CliError(`--server 需要干净的 http/https 地址（不含空白与 shell 元字符）：${opts.server}`);
+		return {
+			target: "custom",
+			server
+		};
+	}
+	if (opts.local) return {
+		target: "local",
+		server: LOCAL_SERVER
+	};
+	throw new CliError("jdu login 需要指定站点", "自部署用 --server <url>，本机用 --local");
+}
+async function runLogin(opts) {
+	const { target, server } = resolveInitTarget(opts);
+	const healthz = await (opts.fetchHealthz ?? fetchHealthz)(server);
+	const provider = healthz.authProvider ?? "token";
+	const methods = healthz.cliAuth?.methods ?? fallbackMethods(provider);
+	const base = {
+		target,
+		server,
+		authProvider: provider,
+		authMethods: methods
+	};
+	const cfAccess = provider === "cloudflare-access";
+	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 ?? (cfAccess ? probeApiWithAccessToken : probeApiWithBearer))(server, opts.token)) throw new CliError(cfAccess ? "Access 应用 token 校验失败（/api/docs 未放行）" : "token 校验失败（/api/docs 未放行）", cfAccess ? "token 要没过期、且是本实例 Access 应用签的" : "确认 token 正确、且网关放行 Authorization: Bearer");
+		const path = saveConfig({
+			server,
+			token: opts.token,
+			...cfAccess ? { cfAccess: true } : {}
+		});
+		return {
+			...base,
+			loggedIn: true,
+			configPath: path,
+			next: null
+		};
+	}
+	const oidc = healthz.oidc?.issuer && healthz.oidc.clientId ? {
+		issuer: healthz.oidc.issuer,
+		clientId: healthz.oidc.clientId
+	} : void 0;
+	const path = saveConfig(oidc ? {
+		server,
+		oidc
+	} : { server });
+	if (provider === "anonymous") return {
+		...base,
+		loggedIn: true,
+		configPath: path,
+		next: null
+	};
+	const authorizeUrl = healthz.cliAuth?.authorizeUrl;
+	if (opts.browser && methods.includes("browser") && authorizeUrl) {
+		const withToken = saveConfig({
+			server,
+			token: await (opts.authorize ?? browserAuthorize)({
+				server,
+				authorizeUrl
+			}),
+			...cfAccess ? { cfAccess: true } : {}
+		});
+		return {
+			...base,
+			loggedIn: true,
+			configPath: withToken,
+			next: null
+		};
+	}
+	if (cfAccess) return {
+		...base,
+		loggedIn: false,
+		configPath: path,
+		next: `jdu login --server '${server}'（打开浏览器，用 Cloudflare 账号授权；--json / --no-browser 下不会开浏览器）`
+	};
+	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,
+		configPath: path,
+		next
+	};
+}
+/** 老 server 的 healthz 没有 cliAuth：按 provider 推断，与 server 侧 cliAuthOf 的保守档一致。 */
+function fallbackMethods(provider) {
+	if (provider === "anonymous") return [];
+	if (provider === "forward-auth") return ["oidc", "token"];
+	if (provider === "cloudflare-access") return ["browser"];
+	return ["token"];
+}
+//#endregion
+//#region src/deploy.ts
+/**
+* `jdu deploy`：在用户自己的 Cloudflare 账号里起一个 jiandu。
+*
+* 一条命令要做完的事（顺序有依赖，每一步都幂等）：
+*
+*   OAuth 或 --cf-token ──▶ 读 account id / 邮箱
+*   ──▶ 确保 Zero Trust team 与 Cloudflare IdP
+*   ──▶ upsert Access 应用（只挡 /p*）与邮箱策略
+*   ──▶ wrangler deploy（带 JIANDU_AUTH_* / TEAM_DOMAIN / POLICY_AUD 变量）
+*   ──▶ 退避探 /healthz ──▶ 本地 jdu login（浏览器）
+*
+* 为什么不是「点一个 Deploy 按钮」：jiandu 是给 agent 用的，agent 会跑命令不会点按钮。
+* 为什么不自己调 Cloudflare API 传 Worker：Worker 上传、Durable Object migration、静态资源
+* 上传会话是三套协议，wrangler 已经把它们做完了，重写一遍只会多一份要跟着 Cloudflare 演进的代码。
+* 所以 wrangler 只负责「传产物」，Access 与变量由这里直接调 API 配。
+*
+* Access 的权限 wrangler 的 OAuth 客户端没有（实测 POST /access/apps → 1010 auth.forbidden），
+* 而 Cloudflare 自己的 CLI OAuth 客户端有 access:read/write，见 cf-oauth.ts。
+* 拿到的 token 以 CLOUDFLARE_API_TOKEN 交给 wrangler（一把 token 干完两件事）。
+*/
+/** npm 上的部署产物包：worker.js + assets/ + wrangler.json。 */
+var PACKAGE = "@monoedge/jiandu-cf";
+/** wrangler 主版本锁死：它改 flag 我们要跟着改，不能让用户某天突然拿到 v5。 */
+var WRANGLER = "wrangler@4";
+/** healthz 退避探活：#155 的教训——冷启动要种 16 篇官方文档，第一次探活必须允许它慢。 */
+var HEALTH_TIMEOUT_MS = 45e3;
+var HEALTH_INTERVAL_MS = 2e3;
+/** 默认 runner：stdio 继承给用户看（wrangler 的 OAuth 提示、进度条都靠它）。 */
+var spawnRunner = (cmd, args, opts) => new Promise((ok, fail) => {
+	const child = spawn(cmd, args, {
+		stdio: [
+			opts.input === void 0 ? "inherit" : "pipe",
+			"inherit",
+			"inherit"
+		],
+		shell: process.platform === "win32",
+		env: {
+			...process.env,
+			...opts.env
+		}
+	});
+	if (opts.input !== void 0) child.stdin?.end(opts.input);
+	child.on("error", (err) => fail(new CliError(`跑不起来 ${cmd}：${err.message}`, "需要 node 与 npm 在 PATH 里")));
+	child.on("exit", (code) => code === 0 ? ok() : fail(new CliError(`${cmd} ${args[0] ?? ""} 失败（退出码 ${code}）`)));
+});
+/**
+* 取部署产物：`--dist` 指本地目录，否则临时装一份 npm 包。
+* 返回 wrangler 配置的绝对路径 —— wrangler 按**配置文件所在目录**解析 main 与 assets.directory，
+* 所以不需要把产物拷到工作目录，也不需要生成任何脚手架。
+*/
+async function resolveConfig(opts, run) {
+	if (opts.dist !== void 0) {
+		const config = resolve(opts.dist, "wrangler.json");
+		if (!existsSync(config)) throw new CliError(`${config} 不存在`, "--dist 要指向 server/dist-cf 那样的构建产物目录");
+		return {
+			config,
+			cleanup: () => void 0
+		};
+	}
+	const dir = mkdtempSync(join(tmpdir(), "jdu-deploy-"));
+	try {
+		await run("npm", [
+			"install",
+			"--no-audit",
+			"--no-fund",
+			"--prefix",
+			dir,
+			`${PACKAGE}@latest`
+		], {});
+	} catch (err) {
+		rmSync(dir, {
+			recursive: true,
+			force: true
+		});
+		throw err;
+	}
+	const config = join(dir, "node_modules", PACKAGE, "dist", "wrangler.json");
+	if (!existsSync(config)) {
+		rmSync(dir, {
+			recursive: true,
+			force: true
+		});
+		throw new CliError(`${PACKAGE} 里没有 dist/wrangler.json`, "包版本太老或装坏了，重试一次；仍失败请报 issue");
+	}
+	return {
+		config,
+		cleanup: () => rmSync(dir, {
+			recursive: true,
+			force: true
+		})
+	};
+}
+/** wrangler 的结构化输出：NDJSON，deploy 那条带 targets（部署好的地址）。 */
+function urlFromOutput(file) {
+	if (!existsSync(file)) return null;
+	for (const line of readFileSync(file, "utf8").split("\n")) {
+		if (line.trim() === "") continue;
+		try {
+			const entry = JSON.parse(line);
+			if (entry.type !== "deploy" || !Array.isArray(entry.targets)) continue;
+			const target = entry.targets.find((t) => typeof t === "string" && t.startsWith("http"));
+			if (target !== void 0) return target;
+		} catch {}
+	}
+	return null;
+}
+/**
+* 退避探活：冷启动要建表 + 种官方文档，第一次请求可能落在 DO 还没热身完的窗口里（#155）。
+* 返回最后一次看到的 healthz；一直不通返回 null。
+*/
+async function waitHealthy(url, fetchImpl, timeoutMs = HEALTH_TIMEOUT_MS) {
+	const deadline = Date.now() + timeoutMs;
+	for (;;) {
+		try {
+			const res = await fetchImpl(`${url}/healthz`, { headers: { accept: "application/json" } });
+			if (res.ok) {
+				const body = await res.json();
+				if (body.runtime === "cloudflare") return body;
+			}
+		} catch {}
+		if (Date.now() >= deadline) return null;
+		await new Promise((r) => setTimeout(r, HEALTH_INTERVAL_MS));
+	}
+}
+/** 部署命令：产物配置 + 变量 + 输出文件。 */
+function deployArgs(input) {
+	const args = [
+		"--yes",
+		WRANGLER,
+		"deploy",
+		"-c",
+		input.config,
+		"--name",
+		input.name,
+		"--keep-vars"
+	];
+	for (const [key, value] of Object.entries(input.vars ?? {})) args.push("--var", `${key}:${value}`);
+	return args;
+}
+/**
+* 账号还没注册 workers.dev 子域时的兜底：先不带 Access 变量传一次，让 wrangler 引导注册并
+* 打印地址；随后配好 Access 再带变量传第二次（那才是真正生效的那次）。
+*/
+async function warmupDeploy(config, name, env, run) {
+	const outDir = mkdtempSync(join(tmpdir(), "jdu-wrangler-out-"));
+	const outFile = join(outDir, "out.ndjson");
+	try {
+		await run("npx", deployArgs({
+			config,
+			name
+		}), { env: {
+			...env,
+			WRANGLER_OUTPUT_FILE_PATH: outFile
+		} });
+		const url = urlFromOutput(outFile);
+		if (url === null) throw new CliError("部署命令跑完了，但没能从 wrangler 的输出里读到地址", "去 Cloudflare 控制台看这个 Worker 的 workers.dev 地址，再重跑一次 jdu deploy");
+		return url;
+	} finally {
+		rmSync(outDir, {
+			recursive: true,
+			force: true
+		});
+	}
+}
+async function runDeploy(opts) {
+	const run = opts.run ?? spawnRunner;
+	const name = opts.name ?? "jiandu";
+	const empty = {
+		name,
+		url: null,
+		accountId: null,
+		ownerEmail: null,
+		emails: [],
+		accessAppId: null,
+		upgraded: false,
+		loggedIn: false
+	};
+	const { config, cleanup } = await resolveConfig(opts, run);
+	try {
+		if (opts.dryRun) {
+			await run("npx", [
+				"--yes",
+				WRANGLER,
+				"deploy",
+				"--dry-run",
+				"-c",
+				config,
+				"--name",
+				name
+			], {});
+			return empty;
+		}
+		const fetchImpl = opts.fetchImpl ?? fetch;
+		const credentials = await resolveCfCredentials({
+			...opts.cfToken ? { cfToken: opts.cfToken } : {},
+			allowBrowser: opts.json !== true,
+			fetchImpl
+		});
+		const api = new CfApi({
+			credentials,
+			fetchImpl,
+			onTokens: (tokens) => writeCfConfig({
+				...tokens,
+				accountId: credentials.accountId,
+				email: credentials.email
+			})
+		});
+		const identity = {
+			accountId: credentials.accountId,
+			email: credentials.email
+		};
+		const deployEnv = { CLOUDFLARE_API_TOKEN: credentials.tokens.accessToken };
+		const subdomain = await workersDevSubdomain(api);
+		const fromSubdomain = subdomain === null ? null : `${name}.${subdomain}.workers.dev`;
+		const deployed = fromSubdomain === null ? await warmupDeploy(config, name, deployEnv, run) : null;
+		const siteUrl = deployed ?? `https://${fromSubdomain}`;
+		const siteHost = deployed === null ? fromSubdomain : new URL(deployed).host;
+		const authDomain = await ensureOrganization(api, name);
+		const idpId = await ensureCloudflareIdp(api);
+		const { app, emails, existed } = await ensureAccessApp(api, {
+			name,
+			host: siteHost,
+			emails: [identity.email],
+			idpId
+		});
+		const vars = {
+			JIANDU_AUTH_PROVIDER: "cloudflare-access",
+			JIANDU_AUTH_OWNER: identity.accountId,
+			JIANDU_AUTH_OWNER_EMAIL: identity.email,
+			JIANDU_TEAM_DOMAIN: `https://${authDomain}`,
+			JIANDU_POLICY_AUD: app.aud ?? ""
+		};
+		if (app.aud === void 0 || app.aud === "") throw new CliError("Access 应用没有 aud", "去 Cloudflare Zero Trust → Access 里看一眼应用是否建好");
+		if (!siteUrl.startsWith("https://")) throw new CliError(`部署地址不是 https：${siteUrl}`, "Cloudflare 形态必须有 https 才能用 Access");
+		const outDir = mkdtempSync(join(tmpdir(), "jdu-wrangler-out-"));
+		const outFile = join(outDir, "out.ndjson");
+		await run("npx", deployArgs({
+			config,
+			name,
+			vars
+		}), { env: {
+			...deployEnv,
+			WRANGLER_OUTPUT_FILE_PATH: outFile
+		} });
+		rmSync(outDir, {
+			recursive: true,
+			force: true
+		});
+		const health = await waitHealthy(siteUrl, fetchImpl);
+		if (health === null) throw new CliError(`${siteUrl} 起来了但 /healthz 一直不通（等了 ${HEALTH_TIMEOUT_MS / 1e3}s）`, `跑 npx ${WRANGLER} tail --name ${name} 看 Worker 日志；Access 策略已经配好，修完不用重跑 jdu deploy`);
+		if (health.authProvider !== "cloudflare-access") throw new CliError(`${siteUrl} 的 authProvider 是 ${health.authProvider ?? "未知"}，不是 cloudflare-access`, "确认 wrangler 变量写进去了（wrangler deploy 会打印绑定列表）");
+		let loggedIn = false;
+		if (opts.login !== false) loggedIn = (await runLogin({
+			server: siteUrl,
+			browser: true
+		})).loggedIn;
+		return {
+			name,
+			url: siteUrl,
+			accountId: identity.accountId,
+			ownerEmail: identity.email,
+			emails,
+			accessAppId: app.id,
+			upgraded: existed,
+			loggedIn
+		};
+	} finally {
+		cleanup();
+	}
+}
+/** 已存在的应用（升级路径）：只用来报「这次是升级」，邮箱列表由 ensureAccessApp 保证不动。 */
+//#endregion
+//#region src/http.ts
+/** 错误响应体太长会淹没终端，只留头部。 */
+var MAX_DETAIL = 400;
+var ApiClient = class {
+	server;
+	token;
+	/** token 是 Cloudflare Access 应用 token：带上 cf-access-token 头过边缘（见 docs/deploy.md） */
+	cfAccess;
+	/** forward-auth 直连身份：作为 X-Forwarded-User 注入（server 默认 userHeader） */
+	user;
+	/** forward-auth fail-closed 的共享密钥：作为 X-Jiandu-Proxy-Secret 注入 */
+	proxySecret;
+	constructor(cfg) {
+		this.server = cfg.server;
+		this.token = cfg.token;
+		this.cfAccess = cfg.cfAccess === true;
+		this.user = cfg.user;
+		this.proxySecret = cfg.proxySecret;
+	}
+	url(path) {
+		return `${this.server}${path}`;
+	}
+	async getJson(path) {
+		return this.json("GET", path, void 0, void 0);
+	}
+	async postJson(path, body) {
+		return this.json("POST", path, JSON.stringify(body), "application/json");
+	}
+	async putJson(path, body) {
+		return this.json("PUT", path, JSON.stringify(body), "application/json");
+	}
+	async deleteJson(path) {
+		return this.json("DELETE", path, void 0, void 0);
+	}
+	/** 文本路由（`/d/:id.md`）：原样返回正文。 */
+	async getText(path) {
+		return (await this.send("GET", path, void 0, void 0)).text();
+	}
+	/** widget push 走 multipart：boundary 交给 fetch 生成，别自己设 Content-Type。 */
+	async postForm(path, form) {
+		const text = await (await this.send("POST", path, form, void 0)).text();
+		if (text.trim() === "") return void 0;
+		try {
+			return JSON.parse(text);
+		} catch {
+			throw new CliError(`POST ${this.url(path)} 返回的不是合法 JSON：${clip(text)}`);
+		}
+	}
+	/** blob 上传走原始字节，不做任何包装 —— server 直接对 body 校验 sha256。 */
+	async putBytes(path, bytes, contentType) {
+		await this.send("PUT", path, bytes, contentType);
+	}
+	async json(method, path, body, contentType) {
+		const text = await (await this.send(method, path, body, contentType)).text();
+		if (text.trim() === "") return void 0;
+		try {
+			return JSON.parse(text);
+		} catch {
+			throw new CliError(`${method} ${this.url(path)} 返回的不是合法 JSON：${clip(text)}`);
+		}
 	}
-	const oidc = healthz.oidc?.issuer && healthz.oidc.clientId ? {
-		issuer: healthz.oidc.issuer,
-		clientId: healthz.oidc.clientId
-	} : void 0;
-	const path = saveConfig(oidc ? {
-		server,
-		oidc
-	} : { server });
-	if (provider === "anonymous") return {
-		...base,
-		loggedIn: true,
-		configPath: path,
-		next: null
-	};
-	const authorizeUrl = healthz.cliAuth?.authorizeUrl;
-	if (opts.browser && methods.includes("browser") && authorizeUrl) {
-		const withToken = saveConfig({
-			server,
-			token: await (opts.authorize ?? browserAuthorize)({
-				server,
-				authorizeUrl
-			})
-		});
-		return {
-			...base,
-			loggedIn: true,
-			configPath: withToken,
-			next: null
-		};
+	async send(method, path, body, contentType) {
+		const url = this.url(path);
+		const headers = {};
+		if (this.token !== void 0) {
+			if (this.cfAccess) headers["cf-access-token"] = this.token;
+			else headers.Authorization = `Bearer ${this.token}`;
+		}
+		if (this.user !== void 0) headers["X-Forwarded-User"] = this.user;
+		if (this.proxySecret !== void 0) headers["X-Jiandu-Proxy-Secret"] = this.proxySecret;
+		if (contentType !== void 0) headers["Content-Type"] = contentType;
+		let res;
+		try {
+			res = await fetch(url, {
+				method,
+				headers,
+				body,
+				redirect: "manual"
+			});
+		} catch (err) {
+			throw new CliError(`请求 ${method} ${url} 失败：${describeNetworkError(err)}`, "确认 server 已启动、地址与端口正确");
+		}
+		if (!res.ok) throw await httpError(method, url, res);
+		return res;
 	}
-	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
-		};
+};
+function clip(text) {
+	const t = text.trim();
+	return t.length > MAX_DETAIL ? `${t.slice(0, MAX_DETAIL)}…` : t;
+}
+/** fetch 失败时真正的原因藏在 cause 里（ECONNREFUSED / ENOTFOUND / 证书错误…）。 */
+function describeNetworkError(err) {
+	const cause = err?.cause;
+	if (cause instanceof Error) {
+		const code = cause.code;
+		return code ? `${code} ${cause.message}` : cause.message;
 	}
-	const next = methods.includes("browser") ? `jdu login --server '${server}'（不带 --json / --no-browser，打开浏览器授权），或 ${viaToken}` : viaToken;
-	return {
-		...base,
-		loggedIn: false,
-		configPath: path,
-		next
-	};
+	return err instanceof Error ? err.message : String(err);
 }
-/** 老 server 的 healthz 没有 cliAuth：按 provider 推断，与 server 侧 cliAuthOf 的保守档一致。 */
-function fallbackMethods(provider) {
-	if (provider === "anonymous") return [];
-	if (provider === "forward-auth") return ["oidc", "token"];
-	return ["token"];
+async function httpError(method, url, res) {
+	let detail = "";
+	try {
+		detail = clip(await res.text());
+	} catch {
+		detail = "";
+	}
+	if (detail.startsWith("{")) try {
+		const obj = JSON.parse(detail);
+		const msg = obj.error ?? obj.message;
+		if (typeof msg === "string" && msg !== "") detail = msg;
+	} catch {}
+	const hint = res.status === 401 || res.status === 403 ? "token 无效或无权访问，执行 jdu login --server <url>；forward-auth 下确认已设 JIANDU_FORWARD_AUTH_USER 与 JIANDU_PROXY_SECRET" : res.status === 302 ? "网关要登录。Cloudflare 形态下重新执行 jdu login；forward-auth 下先 jdu login，且网关需接受 Authorization: Bearer" : void 0;
+	const suffix = detail === "" ? "" : `：${detail}`;
+	return new CliError(`${method} ${url} 返回 HTTP ${res.status} ${res.statusText}${suffix}`, hint);
 }
 /** 只取链接/图片的目标部分，标签内容可以任意嵌套，不参与匹配。 */
 var MD_DEST_RE = /\]\(([^)]*)\)/g;
 var HTML_ATTR_RE = /\b(?:src|href)\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s"'`=<>]+))/gi;
-/** 抽出一份文本里所有可能的引用目标（未过滤外链，原样返回）。 */
-function extractRefs(text) {
+/** 与 server 的 scanFences 同一条规则（rewrite.ts）：缩进 ≤3、3 个以上反引号或波浪号。 */
+var FENCE_RE = /^([ \t]{0,3})(`{3,}|~{3,})(.*)$/;
+/**
+* 去掉 fenced code block 再找引用：代码块里的 `](./a.png)` 是给人看的例子，不是引用。
+*
+* 这条规则必须与 server 对齐 —— `rewriteReferences` 就是按 `scanFences` 跳过同样的区间。
+* 不一致的后果是双向的：CLI 多收就会上传一堆永远不会被改写的文件，还对着代码里的
+* `steps[i](tx)` 这种写法报「跳过不存在的本地引用」；CLI 少收则会漏传真引用。
+*
+* 明知是重复实现：CLI 是零依赖的单文件发布物，为十几行扫描规则给它加一个 workspace 依赖不值。
+* 规则本身是 CommonMark 定死的，不会漂。
+*/
+function stripFences(text) {
+	const out = [];
+	let open = null;
+	for (const line of text.split("\n")) {
+		const m = FENCE_RE.exec(line);
+		const marker = m?.[2];
+		if (marker !== void 0) {
+			const char = marker[0];
+			const rest = m?.[3] ?? "";
+			if (open === null) {
+				if (!(char === "`" && rest.includes("`"))) {
+					open = {
+						char,
+						len: marker.length
+					};
+					continue;
+				}
+			} else if (char === open.char && marker.length >= open.len && rest.trim() === "") {
+				open = null;
+				continue;
+			}
+		}
+		if (open === null) out.push(line);
+	}
+	return out.join("\n");
+}
+/** 抽出一份文本里所有可能的引用目标（未过滤外链，原样返回）。代码块内的写法不算。 */
+function extractRefs(raw) {
+	const text = stripFences(raw);
 	const out = [];
 	for (const m of text.matchAll(MD_DEST_RE)) {
 		const dest = destinationOf(m[1] ?? "");
@@ -3922,15 +4834,30 @@ function collectReferences(entryPath, maxDepth = 10) {
 //#region src/push.ts
 /** 可见性三档。link 档已废除：定向分享走读者池（jdu share --to）。 */
 var VISIBILITIES = ["private", "public"];
+function asLint(v) {
+	if (v === null || typeof v !== "object") return null;
+	const r = v;
+	if (typeof r["code"] !== "string" || typeof r["message"] !== "string") return null;
+	return {
+		code: r["code"],
+		lang: typeof r["lang"] === "string" ? r["lang"] : "",
+		...typeof r["line"] === "number" ? { line: r["line"] } : {},
+		...typeof r["blockId"] === "string" ? { blockId: r["blockId"] } : {},
+		message: r["message"]
+	};
+}
 function log(line) {
 	process.stderr.write(`${line}\n`);
 }
-/** 没给 --title 时用首个一级标题，再退化到文件名。 */
+/** 没给 --title 时用首个一级标题，其次 frontmatter 的 title / name（SKILL.md 形态，#122），再退化到文件名。 */
 function inferTitle(entryPath) {
 	try {
 		const text = readFileSync(entryPath, "utf8");
 		const m = /^[ \t]{0,3}#[ \t]+(.+?)[ \t]*#*[ \t]*$/m.exec(text);
 		if (m?.[1]) return m[1].trim();
+		const fm = /^---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)/.exec(text)?.[1];
+		const t = fm ? /^(?:title|name)[ \t]*:[ \t]*(.+?)[ \t]*$/m.exec(fm)?.[1] : void 0;
+		if (t) return /^(["']).*\1$/.test(t) ? t.slice(1, -1) : t;
 	} catch {}
 	return basename(entryPath, extname(entryPath));
 }
@@ -3977,13 +4904,19 @@ async function pushDoc(api, entryArg, opts) {
 	const url = typeof res?.url === "string" && res.url !== "" ? res.url : id !== void 0 ? api.url(`/d/${id}`) : void 0;
 	const warnings = Array.isArray(res?.warnings) ? res.warnings.map(String) : [];
 	for (const w of warnings) log(`warn: ${w}`);
+	const lint = Array.isArray(res?.lint) ? res.lint.map(asLint).filter((l) => l !== null) : [];
+	for (const l of lint) {
+		const where = l.line !== void 0 ? ` 第 ${l.line} 行` : l.blockId ? ` ${l.blockId}` : "";
+		log(`lint: ${l.code} ${l.lang}${where} — ${l.message}`);
+	}
 	if (typeof res?.seq === "number") log(`已发布 ${id ?? ""} v${res.seq}`);
 	if (url === void 0) throw new CliError("server 未返回文档 id 或 url，无法给出访问地址");
 	return {
 		id,
 		seq: typeof res?.seq === "number" ? res.seq : void 0,
 		url,
-		warnings
+		warnings,
+		lint
 	};
 }
 //#endregion
@@ -4023,6 +4956,73 @@ function printTable(rows, columns) {
 * 模板原样发出去，怎么填是 agent 的事。agent 侧走 MCP 的 list_templates → read_doc → 按骨架写 → push_doc。
 */
 var TEMPLATE_TAG = "template";
+/**
+* 模板元数据（#115）：写在模板里的一个 HTML 注释，渲染不可见，agent 侧拿它当 MCP prompt 的 name / description：
+*
+*   <!-- jiandu-template
+*   name: weekly
+*   description: 每周五给团队同步进展。触发：周报、weekly
+*   -->
+*
+* 没有这段也能用：name 退回文档 id，description 退回摘要。
+* 文首 YAML frontmatter 里的同名字段也认（k7 起内核不渲染 frontmatter，SKILL.md 可以原样发；#122），注释优先。
+*
+* `arguments:` 声明 prompt 参数（#121）：`week（本周编号，如 2026-W36）; owner?（负责人）`——分号分隔，`?` 表示可选，
+* 括号里是说明。prompts/get 时 `jdu mcp` 把正文里的 `{{week}}` 换成客户端给的值；server 仍不做任何替换。
+*/
+var META_RE = /<!--\s*jiandu-template\s*\r?\n([\s\S]*?)-->[ \t]*\r?\n?/;
+/** 与 render 的 splitFrontmatter 同一条正则；cli 不为这一处引整个渲染包 */
+var FRONTMATTER_RE = /^---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)/;
+/** prompt name 会拼进 `/mcp__jiandu__<name>` 这类客户端命令，只放行安全字符 */
+var NAME_RE$1 = /^[A-Za-z0-9_-]{1,64}$/;
+var ARG_RE = /^([A-Za-z0-9_-]{1,64})(\?)?\s*(?:[（(](.*)[）)])?$/;
+function parseArgs(raw) {
+	return raw.split(/[;；]/).map((s) => s.trim()).filter(Boolean).flatMap((item) => {
+		const m = ARG_RE.exec(item);
+		if (!m?.[1]) return [];
+		const desc = m[3]?.trim();
+		return [{
+			name: m[1],
+			required: m[2] === void 0,
+			...desc ? { description: desc } : {}
+		}];
+	});
+}
+/** 一段 `key: value` 行（注释正文或 frontmatter）→ 填进 meta；先到先得，所以调用顺序就是优先级。 */
+function readFields(block, out) {
+	for (const line of block.split("\n")) {
+		const kv = /^\s*([a-z]+)\s*:\s*(.*?)\s*$/.exec(line);
+		if (!kv?.[2]) continue;
+		const v = /^(["']).*\1$/.test(kv[2]) ? kv[2].slice(1, -1) : kv[2];
+		if (kv[1] === "name" && out.name === void 0 && NAME_RE$1.test(v)) out.name = v;
+		else if (kv[1] === "description" && out.description === void 0) out.description = v;
+		else if (kv[1] === "arguments" && out.arguments.length === 0) out.arguments = parseArgs(v);
+	}
+}
+function parseTemplateMeta(md) {
+	const out = {
+		arguments: [],
+		body: md
+	};
+	const fm = FRONTMATTER_RE.exec(md);
+	if (fm) out.body = md.slice(fm[0].length);
+	const m = META_RE.exec(out.body);
+	if (m) {
+		out.body = out.body.replace(m[0], "");
+		readFields(m[1] ?? "", out);
+	}
+	if (fm) readFields(fm[1] ?? "", out);
+	return out;
+}
+/** `{{name}}` → 值；没给的可选参数替换成空串。只替换声明过的参数，别的 `{{…}}` 原样留着。 */
+function fillTemplate(body, args, values) {
+	let out = body;
+	for (const a of args) {
+		const v = typeof values[a.name] === "string" ? values[a.name] : "";
+		out = out.replace(new RegExp(`\\{\\{\\s*${a.name}\\s*\\}\\}`, "g"), v);
+	}
+	return out;
+}
 var hasTemplateTag = (d) => Array.isArray(d.tags) && d.tags.map(String).includes("template");
 async function listTemplates(api, opts) {
 	const [mine, official] = await Promise.all([api.getJson(`/api/docs${opts.all ? "?all=1" : ""}`), api.getJson("/api/official")]);
@@ -4048,6 +5048,10 @@ async function listTemplates(api, opts) {
 			key: "title",
 			header: "TITLE"
 		},
+		{
+			key: "uses",
+			header: "USES"
+		},
 		{
 			key: "updatedAt",
 			header: "UPDATED"
@@ -4069,6 +5073,7 @@ async function pullTemplate(api, id, opts) {
 * （push 的 tags 字段是整体覆盖语义，不先取回就会把别的标签抹掉）。
 */
 async function pushTemplate(api, file, opts) {
+	if (!parseTemplateMeta(readFileSync(file, "utf8")).name) process.stderr.write("warn: 模板没有 <!-- jiandu-template name/description --> 元数据注释（或 frontmatter）：agent 侧的 prompt 名会退回文档 id、描述退回摘要\n");
 	let tags = [TEMPLATE_TAG];
 	if (opts.id) {
 		const cur = await api.getJson(`/api/docs/${encodeURIComponent(opts.id)}/tags`).catch(() => ({}));
@@ -4089,8 +5094,12 @@ async function pushTemplate(api, file, opts) {
 * 当可读可写的知识库用（#9 A 段）。凭据复用 ~/.config/jiandu/config.json，server 端零改动。
 *
 * ponytail: 不引 @modelcontextprotocol/sdk——它带 express / hono / zod 一整套，而这里只需要
-* initialize / tools/list / tools/call 三个方法的 JSON-RPC 换行分帧。协议有变再换官方 SDK。
+* initialize / tools/* / prompts/* 几个方法的 JSON-RPC 换行分帧。协议有变再换官方 SDK。
 * stdout 是协议信道：本文件之外任何写 stdout 的代码都不能在 mcp 模式下被调到（pushDoc 已改为返回值）。
+*
+* 模板即 prompt（#115）：打了 template 标签的文档同时暴露为 MCP prompts（Claude Code 里是 /mcp__jiandu__<name>），
+* name / description 来自模板里的 `<!-- jiandu-template -->` 注释。语法三层（#116）：常驻 instructions 放最容易错的几条，
+* get_syntax 按需拿这台实例的完整规则（带 widget= 就是某个组件的完整 schema），push_doc 响应的 lint[] 事后指出会降级的 fence。
 */
 var SUPPORTED_PROTOCOLS = [
 	"2025-06-18",
@@ -4099,13 +5108,41 @@ var SUPPORTED_PROTOCOLS = [
 ];
 var SERVER_INFO = {
 	name: "jiandu",
-	version: "0.2.0"
+	version: "0.6.0"
 };
-var INSTRUCTIONS = "jiandu（简牍）是一个 Markdown 知识库。先用 search_docs / list_docs 找到文档 id，read_doc 拿 markdown 原文；改稿后用 push_doc 发布新版本（带 id 才是更新，不带是新建）。文档里的 widget fence（```widget:Name）保留原样。写新文档前先 list_templates 看有没有对应骨架（周报 / 技术方案…），有就 read_doc 取模板按节填，占位注释自己替换掉。";
+/**
+* 常驻开场白（#116 L0）：只放**跨工具**的知识——各个工具自己做什么由它们的 description 讲，
+* 在这里复述一遍等于每轮对话都多付一份 token。留下的是顺序、写作规范，和 fence 那几条最容易错的。
+*/
+var INSTRUCTIONS = "jiandu（简牍）是一个 Markdown 知识库，这些工具都是它 HTTP API 的薄封装。典型顺序：list_docs 找到 id → read_doc 拿原文 → 改稿 → push_doc 发新版本；写新文档前先 list_templates 看有没有现成骨架。写法：标准 markdown + GFM；一级标题就是文档标题，第一段会截成摘要。可交互组件写 ```widget:Name fence、正文是一个 JSON 对象入参：Name 区分大小写、必须是这台实例已注册的，写错不报错、只会静默变成普通代码块；JSON 字符串里的 markdown 要转义（换行 \\n、引号 \\\"）。mermaid / diff / vega-lite 直接写 ```mermaid 这类 fence，正文是 DSL 不是 JSON。用扩展语法前先 get_syntax；push_doc 响应的 lint[] 非空就是有 fence 会降级，按提示改稿重推。已有的 widget fence 保留原样。";
+/** prompts/get 给模型的开场：模板正文前的一段固定说明，不在模板里另起一套「指令字段」。 */
+function promptText(t) {
+	return `下面是文档模板「${t.title}」的骨架。按节填写，删掉所有 <!-- --> 占位注释，第一段写一句话摘要；写完用 push_doc 发布（默认 private，进团队传 team），并把链接给用户。模板里的说明文字不要带进正文。
+
+---
+
+` + t.body;
+}
 function str(v, name) {
 	if (typeof v !== "string" || v.trim() === "") throw new CliError(`${name} 必填且为非空字符串`);
 	return v.trim();
 }
+var SCOPES$1 = [
+	"mine",
+	"official",
+	"shared",
+	"all"
+];
+function asScope(v) {
+	if (typeof v === "string" && SCOPES$1.includes(v)) return v;
+	throw new CliError(`scope 只能是 ${SCOPES$1.join(" / ")}：${String(v)}`);
+}
+function strList(v) {
+	return Array.isArray(v) ? v.map(String).filter((s) => s.trim() !== "") : [];
+}
+function isRecord(v) {
+	return v !== null && typeof v === "object" && !Array.isArray(v);
+}
 function asDoc(raw, scope, server) {
 	if (raw === null || typeof raw !== "object") return null;
 	const d = raw;
@@ -4117,8 +5154,10 @@ function asDoc(raw, scope, server) {
 		visibility: typeof d["visibility"] === "string" ? d["visibility"] : scope === "official" ? "official" : "",
 		tags: Array.isArray(d["tags"]) ? d["tags"].map(String) : [],
 		scope,
+		...typeof d["team"] === "string" || d["team"] === null ? { team: d["team"] } : {},
 		...typeof d["archived"] === "boolean" ? { archived: d["archived"] } : {},
 		...typeof d["updatedAt"] === "number" ? { updatedAt: d["updatedAt"] } : {},
+		...typeof d["uses"] === "number" ? { uses: d["uses"] } : {},
 		url: typeof d["url"] === "string" ? d["url"] : `${server}/d/${d["id"]}`
 	};
 }
@@ -4137,152 +5176,345 @@ function buildTools(api) {
 		const seen = new Set(mine.map((d) => d.id));
 		return [...mine, ...[...official, ...shared].filter((d) => !seen.has(d.id) && seen.add(d.id))];
 	};
-	return [
-		{
-			name: "list_docs",
-			description: "列出文档。scope：mine（我发布的，默认）/ official（官方知识库）/ shared（分享给我的）/ all。返回 id、标题、摘要、可见性、标签、URL。",
-			inputSchema: {
-				type: "object",
-				properties: {
-					scope: {
-						type: "string",
-						enum: [
-							"mine",
-							"official",
-							"shared",
-							"all"
-						],
-						default: "mine"
-					},
-					includeArchived: {
-						type: "boolean",
-						default: false,
-						description: "仅 mine 生效：包含已归档"
+	const loadTemplates = async () => {
+		const [mine, shared, official] = await Promise.all([
+			listOf("mine", false),
+			listOf("shared", false),
+			listOf("official", false)
+		]);
+		const seen = /* @__PURE__ */ new Set();
+		const docs = [
+			...mine,
+			...shared,
+			...official
+		].filter((d) => d.tags.includes("template") && !seen.has(d.id) && seen.add(d.id));
+		const infos = await Promise.all(docs.map(async (d) => {
+			const meta = parseTemplateMeta(await api.getText(`/d/${encodeURIComponent(d.id)}.md`));
+			return {
+				...d,
+				name: meta.name ?? d.id,
+				description: meta.description ?? (d.excerpt || d.title),
+				arguments: meta.arguments,
+				body: meta.body
+			};
+		}));
+		const names = /* @__PURE__ */ new Set();
+		return infos.filter((t) => !names.has(t.name) && names.add(t.name));
+	};
+	return {
+		tools: [
+			{
+				name: "list_docs",
+				description: "列 / 搜文档，返回 id、标题、摘要、可见性、标签、URL。给 query 就按关键词过滤（标题 / 摘要 / 标签，空格分词、全部命中），不给就是纯列表。scope：mine（我发布的）/ official（官方知识库）/ shared（分享给我的 + 我所属团队的）/ all；不传时——搜（有 query）默认 all、列（无 query）默认 mine。没有全文检索，正文搜不到——要读正文用 read_doc。",
+				inputSchema: {
+					type: "object",
+					properties: {
+						query: {
+							type: "string",
+							description: "关键词，空格分词、全部命中；不给就是纯列表"
+						},
+						scope: {
+							type: "string",
+							enum: [...SCOPES$1]
+						},
+						limit: {
+							type: "integer",
+							minimum: 1,
+							maximum: 200,
+							description: "最多几条；不给时搜默认 20 条、纯列表不截断"
+						},
+						includeArchived: {
+							type: "boolean",
+							default: false,
+							description: "仅 mine 生效：包含已归档"
+						}
+					}
+				},
+				run: async (args) => {
+					const terms = (typeof args["query"] === "string" ? args["query"].trim() : "").toLowerCase().split(/\s+/).filter(Boolean);
+					const scope = args["scope"] === void 0 ? terms.length === 0 ? "mine" : "all" : asScope(args["scope"]);
+					const includeArchived = args["includeArchived"] === true;
+					const docs = scope === "all" ? await listAll(includeArchived) : await listOf(scope, includeArchived);
+					if (terms.length === 0) {
+						const cap = Number.isInteger(args["limit"]) ? Math.max(1, Math.min(200, args["limit"])) : docs.length;
+						return JSON.stringify(docs.slice(0, cap), null, 2);
 					}
+					const hits = docs.filter((d) => {
+						const hay = `${d.title}\n${d.excerpt}\n${d.tags.join(" ")}`.toLowerCase();
+						return terms.every((t) => hay.includes(t));
+					});
+					const limit = Number.isInteger(args["limit"]) ? Math.max(1, Math.min(200, args["limit"])) : 20;
+					return JSON.stringify(hits.slice(0, limit), null, 2);
 				}
 			},
-			run: async (args) => {
-				const scope = typeof args["scope"] === "string" ? args["scope"] : "mine";
-				const includeArchived = args["includeArchived"] === true;
-				const docs = scope === "all" ? await listAll(includeArchived) : scope === "mine" || scope === "official" || scope === "shared" ? await listOf(scope, includeArchived) : (() => {
-					throw new CliError(`scope 只能是 mine / official / shared / all：${scope}`);
-				})();
-				return JSON.stringify(docs, null, 2);
-			}
-		},
-		{
-			name: "search_docs",
-			description: "按关键词搜文档（标题 / 摘要 / 标签，空格分词、全部命中）。范围是我能看到的全部文档。没有全文检索——要读正文用 read_doc。",
-			inputSchema: {
-				type: "object",
-				required: ["query"],
-				properties: {
-					query: { type: "string" },
-					limit: {
-						type: "integer",
-						minimum: 1,
-						maximum: 100,
-						default: 20
+			{
+				name: "read_doc",
+				description: "读文档的 markdown 原文（本地引用已改写为 /blob/<hash>）。不传 version 读最新版。",
+				inputSchema: {
+					type: "object",
+					required: ["id"],
+					properties: {
+						id: { type: "string" },
+						version: {
+							type: "integer",
+							minimum: 1,
+							description: "版本号 seq，见 list_versions"
+						}
 					}
+				},
+				run: async (args) => {
+					const id = encodeURIComponent(str(args["id"], "id"));
+					const version = args["version"];
+					if (version !== void 0 && !Number.isInteger(version)) throw new CliError("version 必须是整数");
+					return api.getText(version === void 0 ? `/d/${id}.md` : `/d/${id}/v/${String(version)}.md`);
 				}
 			},
-			run: async (args) => {
-				const terms = str(args["query"], "query").toLowerCase().split(/\s+/).filter(Boolean);
-				const limit = Number.isInteger(args["limit"]) ? Math.max(1, Math.min(100, args["limit"])) : 20;
-				const hits = (await listAll(false)).filter((d) => {
-					const hay = `${d.title}\n${d.excerpt}\n${d.tags.join(" ")}`.toLowerCase();
-					return terms.every((t) => hay.includes(t));
-				});
-				return JSON.stringify(hits.slice(0, limit), null, 2);
-			}
-		},
-		{
-			name: "read_doc",
-			description: "读文档的 markdown 原文（本地引用已改写为 /blob/<hash>）。不传 version 读最新版。",
-			inputSchema: {
-				type: "object",
-				required: ["id"],
-				properties: {
-					id: { type: "string" },
-					version: {
-						type: "integer",
-						minimum: 1,
-						description: "版本号 seq，见 list_versions"
+			{
+				name: "list_templates",
+				description: "列出文档模板（打了 template 标签的文档：我的 + 我所属团队的 + 官方）。每条带 name（同时是 MCP prompt 名）和 description（什么场景用）。写新文档前先看这里；选中后 read_doc 取原文，按骨架填内容、删掉 <!-- --> 占位注释，再 push_doc。server 不做任何变量替换。",
+				inputSchema: {
+					type: "object",
+					properties: {}
+				},
+				run: async () => {
+					const out = (await loadTemplates()).map(({ body: _body, ...rest }) => rest);
+					return JSON.stringify(out, null, 2);
+				}
+			},
+			{
+				name: "get_syntax",
+				description: "取这台实例的写作语法（markdown）：内核语法、widget fence 与多态 CodeBlock（mermaid / diff / vega-lite…）的规则、已注册 widget 的清单与字段摘要。写含 fence / 组件 / 图表的文档前先调一次（不带参数）。要某几个组件的完整入参就带 widget=名字（多个用逗号分隔），拿到 dataSchema（JSON Schema）、sampleData 和可直接粘进文档的 fence 示例；标了 contentMediaType: text/markdown 的字符串字段可以写 markdown。",
+				inputSchema: {
+					type: "object",
+					properties: { widget: {
+						type: "string",
+						description: "组件名，区分大小写；多个用逗号分隔。不给就返回整份语法说明"
+					} }
+				},
+				run: async (args) => {
+					const want = typeof args["widget"] === "string" ? args["widget"].split(",").map((s) => s.trim()).filter(Boolean) : [];
+					if (want.length === 0) return api.getText("/api/syntax");
+					const res = await api.getJson("/api/widgets");
+					const out = [];
+					const active = [];
+					for (const raw of Array.isArray(res?.widgets) ? res.widgets : []) {
+						if (raw === null || typeof raw !== "object") continue;
+						const w = raw;
+						if (w["status"] !== "active" || typeof w["name"] !== "string") continue;
+						active.push(w["name"]);
+						if (!want.includes(w["name"])) continue;
+						out.push({
+							name: w["name"],
+							scope: typeof w["scope"] === "string" ? w["scope"] : "",
+							version: typeof w["version"] === "string" ? w["version"] : "",
+							description: typeof w["description"] === "string" ? w["description"] : null,
+							dataSchema: w["dataSchema"] ?? null,
+							sampleData: w["sampleData"] ?? null,
+							fence: `\`\`\`widget:${w["name"]}\n${JSON.stringify(w["sampleData"] ?? {}, null, 2)}\n\`\`\``
+						});
 					}
+					const missing = want.filter((n) => !out.some((w) => w.name === n));
+					if (missing.length > 0) throw new CliError(`这台实例没有注册：${missing.join(" / ")}。可用的是：${active.join(" / ")}`);
+					return JSON.stringify(out, null, 2);
 				}
 			},
-			run: async (args) => {
-				const id = encodeURIComponent(str(args["id"], "id"));
-				const version = args["version"];
-				if (version !== void 0 && !Number.isInteger(version)) throw new CliError("version 必须是整数");
-				return api.getText(version === void 0 ? `/d/${id}.md` : `/d/${id}/v/${String(version)}.md`);
-			}
-		},
-		{
-			name: "list_templates",
-			description: "列出文档模板（打了 template 标签的文档：官方模板 + 我的）。写新文档前先看这里；选中后 read_doc 取原文，按骨架填内容、删掉 <!-- --> 占位注释，再 push_doc。server 不做任何变量替换。",
-			inputSchema: {
-				type: "object",
-				properties: {}
+			{
+				name: "list_versions",
+				description: "列出文档全部版本（seq、发布时间、源文 hash）。只追加不覆盖，回滚也是新版本。",
+				inputSchema: {
+					type: "object",
+					required: ["id"],
+					properties: { id: { type: "string" } }
+				},
+				run: async (args) => {
+					const res = await api.getJson(`/api/docs/${encodeURIComponent(str(args["id"], "id"))}/versions`);
+					return JSON.stringify(res, null, 2);
+				}
 			},
-			run: async () => {
-				const docs = (await listAll(false)).filter((d) => d.tags.includes(TEMPLATE_TAG));
-				return JSON.stringify(docs, null, 2);
-			}
-		},
-		{
-			name: "list_versions",
-			description: "列出文档全部版本（seq、发布时间、源文 hash）。只追加不覆盖，回滚也是新版本。",
-			inputSchema: {
-				type: "object",
-				required: ["id"],
-				properties: { id: { type: "string" } }
+			{
+				name: "push_doc",
+				description: "发布 markdown。正文二选一：path（本机入口 .md 的绝对路径，会递归收集图片 / 嵌套 md 等本地引用一起上传）或 content（markdown 字串，没有本地引用可收，标题取一级标题、否则传 title）。带 id 是给已有文档发新版本（标题 / 可见性 / 标签 / 团队不传则保持原值）；不带 id 新建，默认 private。响应里的 lint[] 列出会静默降级成普通代码块的 fence（unknown-widget / invalid-json / invalid-data，带行号或 blockId）——发布已成功，但非空就该按提示改稿再 push_doc 一次。",
+				inputSchema: {
+					type: "object",
+					properties: {
+						path: {
+							type: "string",
+							description: "入口 .md 的绝对路径；与 content 二选一"
+						},
+						content: {
+							type: "string",
+							description: "markdown 正文；与 path 二选一"
+						},
+						id: {
+							type: "string",
+							description: "要更新的文档 id"
+						},
+						title: { type: "string" },
+						visibility: {
+							type: "string",
+							enum: [...VISIBILITIES]
+						},
+						tags: {
+							type: "array",
+							items: { type: "string" },
+							description: "整体覆盖标签；不传则不动"
+						},
+						team: {
+							type: "string",
+							description: "进团队的团队 id（需是成员）；空串移出团队；不传则不动"
+						}
+					}
+				},
+				run: async (args) => {
+					const content = typeof args["content"] === "string" ? args["content"] : void 0;
+					const hasPath = typeof args["path"] === "string" && args["path"].trim() !== "";
+					if (content === void 0 === !hasPath) throw new CliError("path 与 content 必须且只能传一个");
+					const tmp = content !== void 0 ? mkdtempSync(join(tmpdir(), "jdu-mcp-")) : null;
+					const path = tmp ? join(tmp, "doc.md") : str(args["path"], "path");
+					if (tmp && content !== void 0) writeFileSync(path, content, "utf8");
+					const tags = Array.isArray(args["tags"]) ? args["tags"].map(String) : void 0;
+					try {
+						const res = await pushDoc(api, path, {
+							id: typeof args["id"] === "string" ? args["id"] : void 0,
+							title: typeof args["title"] === "string" ? args["title"] : void 0,
+							visibility: typeof args["visibility"] === "string" ? args["visibility"] : void 0,
+							tag: tags,
+							team: typeof args["team"] === "string" ? args["team"] : void 0
+						});
+						return JSON.stringify(res, null, 2);
+					} finally {
+						if (tmp) rmSync(tmp, {
+							recursive: true,
+							force: true
+						});
+					}
+				}
 			},
-			run: async (args) => {
-				const res = await api.getJson(`/api/docs/${encodeURIComponent(str(args["id"], "id"))}/versions`);
-				return JSON.stringify(res, null, 2);
-			}
-		},
-		{
-			name: "push_doc",
-			description: "发布本机的 markdown 文件（递归收集图片 / 嵌套 md 等本地引用并上传）。带 id 是给已有文档发新版本（标题 / 可见性 / 标签不传则保持原值）；不带 id 新建，默认 private。path 用绝对路径。",
-			inputSchema: {
-				type: "object",
-				required: ["path"],
-				properties: {
-					path: {
-						type: "string",
-						description: "入口 .md 的绝对路径"
-					},
-					id: {
-						type: "string",
-						description: "要更新的文档 id"
-					},
-					title: { type: "string" },
-					visibility: {
-						type: "string",
-						enum: [...VISIBILITIES]
-					},
-					tags: {
-						type: "array",
-						items: { type: "string" },
-						description: "整体覆盖标签；不传则不动"
+			{
+				name: "share_doc",
+				description: "改文档的访问范围，不用重推正文：visibility（private / public）、team（团队 id；空串移出团队）、addReaders / removeReaders（定向读者的身份串，如邮箱 / 用户名）。私有文档谁能读 = 作者 ∪ 指定读者 ∪ 所选团队成员。",
+				inputSchema: {
+					type: "object",
+					required: ["id"],
+					properties: {
+						id: { type: "string" },
+						visibility: {
+							type: "string",
+							enum: [...VISIBILITIES]
+						},
+						team: {
+							type: "string",
+							description: "团队 id；空串移出团队"
+						},
+						addReaders: {
+							type: "array",
+							items: { type: "string" }
+						},
+						removeReaders: {
+							type: "array",
+							items: { type: "string" }
+						}
 					}
+				},
+				run: async (args) => {
+					const id = encodeURIComponent(str(args["id"], "id"));
+					const access = {};
+					if (typeof args["visibility"] === "string") access["visibility"] = args["visibility"];
+					if (typeof args["team"] === "string") access["team"] = args["team"];
+					const add = strList(args["addReaders"]);
+					const remove = strList(args["removeReaders"]);
+					if (Object.keys(access).length === 0 && add.length === 0 && remove.length === 0) throw new CliError("share_doc 需要 visibility / team / addReaders / removeReaders 之一");
+					const out = { id: args["id"] };
+					if (Object.keys(access).length > 0) Object.assign(out, await api.putJson(`/api/docs/${id}/visibility`, access));
+					if (add.length > 0 || remove.length > 0) Object.assign(out, await api.putJson(`/api/docs/${id}/readers`, {
+						add,
+						remove
+					}));
+					return JSON.stringify(out, null, 2);
 				}
 			},
-			run: async (args) => {
-				const path = str(args["path"], "path");
-				const tags = Array.isArray(args["tags"]) ? args["tags"].map(String) : void 0;
-				const res = await pushDoc(api, path, {
-					id: typeof args["id"] === "string" ? args["id"] : void 0,
-					title: typeof args["title"] === "string" ? args["title"] : void 0,
-					visibility: typeof args["visibility"] === "string" ? args["visibility"] : void 0,
-					tag: tags
-				});
-				return JSON.stringify(res, null, 2);
+			{
+				name: "list_comments",
+				description: "列出文档的评论线程（读者在阅读页划词 / 块把手 / 文末评论区留下的）。默认只列未处理的；每条带 blockId（对应正文哪一块，null = 评论整篇文档）、selection.quote 引文、正文、attachments（图片附件的 sha256，取图 GET /blob/<sha256>）、作者、replies。处理流程：按 blockId 找到段落改稿 → push_doc 新版本 → reply_comment 回一句并 resolved=true 关掉。",
+				inputSchema: {
+					type: "object",
+					required: ["id"],
+					properties: {
+						id: { type: "string" },
+						includeResolved: {
+							type: "boolean",
+							default: false
+						}
+					}
+				},
+				run: async (args) => {
+					const id = encodeURIComponent(str(args["id"], "id"));
+					const res = await api.getJson(`/api/docs/${id}/comments`);
+					const all = (Array.isArray(res?.comments) ? res.comments : []).filter(isRecord);
+					const includeResolved = args["includeResolved"] === true;
+					const threads = all.filter((c) => c["parentId"] === null && (includeResolved || c["resolved"] !== true)).map((root) => ({
+						...root,
+						replies: all.filter((c) => c["parentId"] === root["id"])
+					}));
+					return JSON.stringify(threads, null, 2);
+				}
+			},
+			{
+				name: "reply_comment",
+				description: "回复评论线程并/或改它的处理状态。body 回一句（以 agent 身份发出，authorType=ai，读者页里会标出来）；resolved=true 标记已处理、false 重新打开（仅文档 owner）。改完稿发了新版本后，通常一次调用把两件事一起做掉。",
+				inputSchema: {
+					type: "object",
+					required: ["threadId"],
+					properties: {
+						threadId: { type: "string" },
+						body: {
+							type: "string",
+							description: "回复正文；只想改状态就不传"
+						},
+						resolved: {
+							type: "boolean",
+							description: "true 关掉线程、false 重新打开；不传就只回复不改状态"
+						}
+					}
+				},
+				run: async (args) => {
+					const tid = encodeURIComponent(str(args["threadId"], "threadId"));
+					const body = typeof args["body"] === "string" && args["body"].trim() !== "" ? args["body"].trim() : null;
+					const resolved = typeof args["resolved"] === "boolean" ? args["resolved"] : null;
+					if (body === null && resolved === null) throw new CliError("reply_comment 需要 body（回复）或 resolved（改状态）之一");
+					const out = { threadId: args["threadId"] };
+					if (body !== null) out["reply"] = await api.postJson(`/api/comments/${tid}/reply`, {
+						body,
+						authorType: "ai"
+					});
+					if (resolved !== null) out["resolve"] = await api.postJson(`/api/comments/${tid}/resolve`, { resolved });
+					return JSON.stringify(out, null, 2);
+				}
+			},
+			{
+				name: "archive_doc",
+				description: "归档文档：从列表撤下、读者打开 404（owner 自己仍可读），版本与评论都保留；undo=true 取消归档。这就是「撤回发布」——没有比它更重的删除给 agent 用。",
+				inputSchema: {
+					type: "object",
+					required: ["id"],
+					properties: {
+						id: { type: "string" },
+						undo: {
+							type: "boolean",
+							default: false,
+							description: "取消归档"
+						}
+					}
+				},
+				run: async (args) => {
+					const id = encodeURIComponent(str(args["id"], "id"));
+					const res = await api.postJson(`/api/docs/${id}/archive`, { archived: args["undo"] !== true });
+					return JSON.stringify(res, null, 2);
+				}
 			}
-		}
-	];
+		],
+		loadTemplates
+	};
 }
 function write(msg) {
 	process.stdout.write(`${JSON.stringify(msg)}\n`);
@@ -4298,7 +5530,7 @@ function rpcError(id, code, message) {
 	});
 }
 async function runMcp(api) {
-	const tools = buildTools(api);
+	const { tools, loadTemplates } = buildTools(api);
 	const byName = new Map(tools.map((t) => [t.name, t]));
 	const handle = async (req) => {
 		const { id, method } = req;
@@ -4311,18 +5543,81 @@ async function runMcp(api) {
 		switch (method) {
 			case "initialize": {
 				const asked = typeof params["protocolVersion"] === "string" ? params["protocolVersion"] : "";
+				const protocolVersion = SUPPORTED_PROTOCOLS.includes(asked) ? asked : SUPPORTED_PROTOCOLS[0];
+				let instructions = INSTRUCTIONS;
+				try {
+					const templates = await loadTemplates();
+					if (templates.length > 0) instructions += `可用模板（同名 prompt 可直接用）：${templates.map((t) => `${t.name}——${t.description}`).join("；")}。`;
+				} catch {}
 				write({
 					jsonrpc: "2.0",
 					id,
 					result: {
-						protocolVersion: SUPPORTED_PROTOCOLS.includes(asked) ? asked : SUPPORTED_PROTOCOLS[0],
-						capabilities: { tools: {} },
+						protocolVersion,
+						capabilities: {
+							tools: {},
+							prompts: {}
+						},
 						serverInfo: SERVER_INFO,
-						instructions: INSTRUCTIONS
+						instructions
 					}
 				});
 				return;
 			}
+			case "prompts/list":
+				try {
+					write({
+						jsonrpc: "2.0",
+						id,
+						result: { prompts: (await loadTemplates()).map((t) => ({
+							name: t.name,
+							title: t.title,
+							description: t.description,
+							...t.arguments.length > 0 ? { arguments: t.arguments } : {}
+						})) }
+					});
+				} catch (err) {
+					rpcError(id, -32603, `模板列表取不到：${err instanceof CliError ? err.message : String(err)}`);
+				}
+				return;
+			case "prompts/get": {
+				const name = typeof params["name"] === "string" ? params["name"] : "";
+				try {
+					const t = (await loadTemplates()).find((x) => x.name === name);
+					if (!t) {
+						rpcError(id, -32602, `未知 prompt：${name}`);
+						return;
+					}
+					const given = isRecord(params["arguments"]) ? params["arguments"] : {};
+					const missing = t.arguments.filter((a) => a.required && (typeof given[a.name] !== "string" || given[a.name] === ""));
+					if (missing.length > 0) {
+						rpcError(id, -32602, `缺少必填参数：${missing.map((a) => a.name).join(", ")}`);
+						return;
+					}
+					api.postJson(`/api/docs/${encodeURIComponent(t.id)}/used`, {}).catch(() => void 0);
+					const body = t.arguments.length > 0 ? fillTemplate(t.body, t.arguments, given) : t.body;
+					write({
+						jsonrpc: "2.0",
+						id,
+						result: {
+							description: t.description,
+							messages: [{
+								role: "user",
+								content: {
+									type: "text",
+									text: promptText({
+										...t,
+										body
+									})
+								}
+							}]
+						}
+					});
+				} catch (err) {
+					rpcError(id, -32603, `模板取不到：${err instanceof CliError ? err.message : String(err)}`);
+				}
+				return;
+			}
 			case "ping":
 				write({
 					jsonrpc: "2.0",
@@ -4427,6 +5722,7 @@ async function readWidgetJson(dir) {
 		name,
 		scope,
 		version,
+		...typeof obj.description === "string" && obj.description.trim() !== "" ? { description: obj.description.trim() } : {},
 		dataSchema: obj.dataSchema ?? null,
 		sampleData: obj.sampleData ?? null
 	};
@@ -4521,6 +5817,9 @@ async function pushWidget(api, dirArg) {
 	process.stdout.write(`${meta.scope}/${meta.name}@${meta.version}${src}${where}\n`);
 }
 //#endregion
+//#region ../docs/design-system/tokens.css?raw
+var tokens_default = "/* ============================================================\n   简牍 Jiandu · Design Tokens  (v3 · 2026-09)\n   这是设计系统唯一的取值来源。规则、对比度依据、组件规格见同目录 README.md。\n\n   - 双主题 = 同一套语义 token 换值；结构、间距、字号、圆角逐像素一致。\n   - 主题真源是 <html class=\"dark\">（跨宿主契约：widget、dsh 都读它）；\n     暗色块同时匹配 [data-t=\"dark\"]，供设计画布与局部反色容器使用。\n     组件代码里不要写 .dark / [data-t] / prefers-color-scheme 分支，只走 token。\n   - accent 家族用 oklch 定义（同 L 同 C 只变 hue），注释里是 oklch，值是出码 hex。\n   - 每个文字色都在它实际会落到的最深一档表面（--s-4）上过 WCAG AA 4.5:1。\n     改任何一个值之前先重跑对比度（见 README「校验」）。\n   ============================================================ */\n\n/* ---------- 与主题无关的量纲 ---------- */\n:root {\n  --f-sans: \"Instrument Sans\", -apple-system, BlinkMacSystemFont, \"Segoe UI\",\n    \"PingFang SC\", \"HarmonyOS Sans SC\", \"Noto Sans CJK SC\", \"Microsoft YaHei\", sans-serif;\n  --f-serif: \"Instrument Serif\", \"Iowan Old Style\", Palatino, Georgia, serif;\n  --f-mono: \"JetBrains Mono\", ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, monospace;\n\n  /* 字号阶 · 1.20 主比例，UI 段加密到约 1.07 以保住 13/14/15 三档 */\n  --t-micro: 11px;  --t-cap: 12px;  --t-sm: 13px;   --t-ui: 14px;\n  --t-body: 15px;   --t-lg: 16px;   --t-h5: 18px;   --t-h4: 20px;\n  --t-h3: 24px;     --t-h2: 30px;   --t-h1: 38px;\n  --t-d3: 48px;     --t-d2: 60px;   --t-d1: 76px;\n\n  --lh-tight: 1.05; --lh-head: 1.25; --lh-ui: 1.4; --lh-body: 1.65; --lh-loose: 1.8;\n\n  /* 间距阶 · 4 基准，2/6 只用于图标与描边补偿 */\n  --s1: 2px; --s2: 4px; --s3: 6px;  --s4: 8px;  --s5: 12px; --s6: 16px;\n  --s7: 20px; --s8: 24px; --s9: 32px; --s10: 40px; --s11: 48px;\n  --s12: 64px; --s13: 80px; --s14: 96px; --s15: 128px;\n\n  /* 圆角 · 四档，同心圆角规则：外层 = 内层 + padding */\n  --r-xs: 4px;   --r-sm: 6px;   --r-md: 10px;   --r-lg: 14px;   --r-full: 999px;\n\n  --topbar-h: 56px;\n  --sidebar-w: 264px;\n  --w-content: 1160px;\n  --w-reader: 1600px;\n  --w-prose: clamp(46rem, 60vw, 60rem);\n  --w-marketing: 1200px;\n\n  --dur: 140ms;\n  --ease: cubic-bezier(.32, .72, 0, 1);\n\n  /* 实心按钮顶部那道高光。两套主题同值（它压在 accent / danger 填充上，不压在页面底色上）。 */\n  --gloss: inset 0 1px 0 rgba(255, 255, 255, .14);\n  /* 对话框背后的遮罩。两套主题同值：亮色下也要压暗，不然弹层浮不起来。 */\n  --scrim: rgba(9, 10, 12, .44);\n}\n\n/* ---------- 亮色 ---------- */\n:root, [data-t=\"light\"] {\n  color-scheme: light;\n  --bg: #FBFBFC;\n  --s-1: #FFFFFF;\n  --s-2: #F5F6F8;\n  --s-3: #EDEFF2;\n  --s-4: #E3E6EA;\n  --line: #E4E7EB;\n  --line-strong: #D6DAE0;\n  --line-loud: #C3C9D1;\n  --hairline: transparent;\n\n  --fg: #101317;\n  --fg-muted: #565E68;\n  --fg-subtle: #606871;\n\n  --accent: #057558;\n  --accent-hover: #065E47;\n  --accent-quiet: #E3F7EE;\n  --accent-ring: #B5DFCE;\n  --on-accent: #FFFFFF;\n  --on-danger: #FFFFFF;\n\n  --amber: #825B0C;\n  --amber-quiet: #FAF0E0;\n  --danger: #C02B2F;\n  --danger-hover: #A21921;\n  --danger-quiet: #FFEBE9;\n  --danger-ring: #F4C8C4;\n  --success: #1B763A;\n  --success-quiet: #E6F6E9;\n  --warn: #885716;\n  --warn-quiet: #FAF0E0;\n\n  /* 输入框的内凹。向内凹是「可输入」的信号（按钮向外抬），组件里只引这个 token，\n     不写 .dark 分支 —— 暗色那份在下面的暗色块里换值。 */\n  --inset-field: inset 0 1px 2px rgba(16,19,23,.04);\n  /* 弹层表面：亮色用卡片色 + 控件描边；暗色整体抬一档（见暗色块） */\n  --pop-bg: #FFFFFF;\n  --pop-line: #D6DAE0;\n\n  /* 头像色相散列。**唯一绕开「竹青只表示可交互」的地方**：它区分人，不表达状态。\n     放进 token 而不是留在组件里，是为了让组件代码保持零 hex、零 .dark 分支。 */\n  --av-1-bg: #E3F7EE; --av-1-fg: #045A43;\n  --av-2-bg: #E5EFFC; --av-2-fg: #1B4C8F;\n  --av-3-bg: #FAF0E0; --av-3-fg: #6D4B08;\n  --av-4-bg: #F3E9FB; --av-4-fg: #5A2B8C;\n\n  --sh-1: 0 1px 2px rgba(16,19,23,.06), 0 1px 1px rgba(16,19,23,.04);\n  --sh-2: 0 4px 12px -2px rgba(16,19,23,.08), 0 2px 4px -1px rgba(16,19,23,.05);\n  --sh-3: 0 16px 32px -8px rgba(16,19,23,.14), 0 4px 8px -2px rgba(16,19,23,.06);\n  --press: inset 0 2px 4px rgba(16,19,23,.10);\n\n  --code-key: #A2145E; --code-str: #0A5B45; --code-num: #1F4FA8;\n  --code-com: #7A828C; --code-fn: #6B3FBF;  --code-tag: #0F6B36;\n\n  /* 图表系列色（Chart widget）。六档固定顺序按槽位分配、不循环，顺序本身就是色盲安全机制：\n     相邻两档在 protan / deutan 模拟下 ΔE ≥ 8.5，全部对表面 ≥ 3:1（dataviz 校验器过的，改值先重跑）。\n     刻意不用 --accent：竹青只表示可交互，数据不是控件。第一档蓝、第二档琥珀（与 --amber 同族但抬亮到标记档）。 */\n  --chart-1: #3B6FD4; --chart-2: #A6720C; --chart-3: #1A8F7A;\n  --chart-4: #7C55D9; --chart-5: #D2447F; --chart-6: #5E8C2E;\n}\n\n/* ---------- 暗色 ---------- */\n.dark, [data-t=\"dark\"] {\n  color-scheme: dark;\n  --bg: #090A0C;\n  --s-1: #121519;\n  --s-2: #1A1E23;\n  --s-3: #23282E;\n  --s-4: #2D333A;\n  --line: #242830;\n  --line-strong: #2E333B;\n  --line-loud: #3A4048;\n  /* 暗色里阴影几乎不可见，层次靠这道顶部高光边 */\n  --hairline: rgba(255,255,255,.055);\n\n  --fg: #F5F6F8;\n  --fg-muted: #B4BBC4;\n  --fg-subtle: #939BA5;\n\n  --accent: #48C49C;\n  --accent-hover: #6DD9B3;\n  --accent-quiet: #143B2E;\n  --accent-ring: #256550;\n  --on-accent: #05130F;\n  --on-danger: #200A08;\n\n  --amber: #D6A044;\n  --amber-quiet: #412F13;\n  --danger: #FE7871;\n  --danger-hover: #FF8B83;\n  --danger-quiet: #492826;\n  --danger-ring: #7D4743;\n  --success: #68CA80;\n  --success-quiet: #1F3A25;\n  --warn: #F7AC55;\n  --warn-quiet: #412F13;\n\n  /* 暗色里 .04 的内凹完全看不见，要加深到 .35 才成立 */\n  --inset-field: inset 0 1px 2px rgba(0,0,0,.35);\n  --pop-bg: #1A1E23;\n  --pop-line: #3A4048;\n\n  --av-1-bg: #143B2E; --av-1-fg: #7FDCC0;\n  --av-2-bg: #15294A; --av-2-fg: #9CC3F5;\n  --av-3-bg: #412F13; --av-3-fg: #E0B96F;\n  --av-4-bg: #2E2043; --av-4-fg: #C4A6FF;\n\n  --sh-1: 0 1px 2px rgba(0,0,0,.5);\n  --sh-2: 0 4px 14px -2px rgba(0,0,0,.6), 0 1px 3px rgba(0,0,0,.4);\n  --sh-3: 0 20px 40px -10px rgba(0,0,0,.7), 0 4px 10px rgba(0,0,0,.45);\n  --press: inset 0 2px 4px rgba(0,0,0,.34);\n\n  --code-key: #FF9CB4; --code-str: #7FDCC0; --code-num: #8FBCFF;\n  --code-com: #7C858F; --code-fn: #C4A6FF;  --code-tag: #7EE0A0;\n\n  /* 同六个色相为暗表面重新取档（OKLCH L 0.48–0.67），不是亮色的直接反转 */\n  --chart-1: #5A8BE0; --chart-2: #B8842A; --chart-3: #2FA48C;\n  --chart-4: #9878E8; --chart-5: #D45A8E; --chart-6: #7DA34A;\n}\n\n/* ============================================================\n   旧 token 名的别名（过渡层，下个大版本删）\n\n   现在只剩正文排版（viewer/src/reader.css，自 base.css 原样迁入）还在读它们。\n   official widget 已全部改走 theme.css 的语义 utility（bg-card / text-muted-foreground …），\n   `jdu widget create` 的模板同步换成短名；这里把旧名指向 v3 的新值，reader.css 一行不改就跟着换色板。\n\n   新代码只用短名。改动这一段前先 grep 一遍 `--jiandu-`，确认没人还在读它。\n   ============================================================ */\n:root, [data-t=\"light\"], .dark, [data-t=\"dark\"] {\n  --jiandu-font-sans: var(--f-sans);\n  --jiandu-font-mono: var(--f-mono);\n\n  --jiandu-bg: var(--bg);\n  --jiandu-bg-subtle: var(--s-2);\n  --jiandu-bg-code: var(--s-2);\n  --jiandu-bg-inline-code: var(--s-3);\n  --jiandu-fg: var(--fg);\n  --jiandu-fg-muted: var(--fg-muted);\n  --jiandu-fg-subtle: var(--fg-subtle);\n  --jiandu-border: var(--line-strong);\n  --jiandu-border-muted: var(--line);\n\n  --jiandu-link: var(--accent);\n  --jiandu-link-hover: var(--accent-hover);\n  --jiandu-accent: var(--accent);\n  --jiandu-accent-subtle: var(--accent-quiet);\n  --jiandu-info: var(--accent);\n  --jiandu-info-subtle: var(--accent-quiet);\n  --jiandu-success: var(--success);\n  --jiandu-success-subtle: var(--success-quiet);\n  --jiandu-warning: var(--warn);\n  --jiandu-warning-subtle: var(--warn-quiet);\n  --jiandu-danger: var(--danger);\n  --jiandu-danger-subtle: var(--danger-quiet);\n  --jiandu-selection: var(--accent-quiet);\n\n  --jiandu-skeleton-base: var(--s-2);\n  --jiandu-skeleton-shine: var(--s-3);\n  --jiandu-radius: var(--r-md);\n  --jiandu-radius-sm: var(--r-sm);\n  /* 阅读页正文随视口流体扩展，中文正文保持约 44–58 字/行的可读范围。 */\n  --jiandu-doc-width: var(--w-prose);\n\n  /* 代码高亮：v2 分了 12 档，v3 的 --code-* 只有 6 档，按语义就近合并 */\n  --jiandu-hl-keyword: var(--code-key);\n  --jiandu-hl-entity: var(--code-fn);\n  --jiandu-hl-string: var(--code-str);\n  --jiandu-hl-comment: var(--code-com);\n  --jiandu-hl-constant: var(--code-num);\n  --jiandu-hl-section: var(--code-num);\n  --jiandu-hl-variable: var(--amber);\n  --jiandu-hl-tag: var(--code-tag);\n  --jiandu-hl-addition-fg: var(--success);\n  --jiandu-hl-addition-bg: var(--success-quiet);\n  --jiandu-hl-deletion-fg: var(--danger);\n  --jiandu-hl-deletion-bg: var(--danger-quiet);\n}\n";
+//#endregion
 //#region src/widget-dev.ts
 var ARTIFACTS = [
 	"index.js",
@@ -4563,19 +5862,28 @@ function readMeta(dir, dist) {
 		version: ""
 	};
 }
-/** 线上 base.css 的地址：抓首页 HTML 里的 `/_v/base.<hash>.css`。拿不到返回 null，页面用兜底样式。 */
+/**
+* 线上正文样式表的地址：读 `/_v/manifest.json`（viewer 的产物清单，本来就在那条静态路由下）。
+* 早先是抓首页 HTML 里的 `/_v/base.<hash>.css`，但站点页换成 React 直出后首页只链 app.css，
+* 而 widget 预览要的是**正文**那套排版与 token。清单里按名字取，页面怎么改都不影响。
+* 拿不到返回 null，预览页用内置兜底样式。
+*/
 async function siteBaseCss(server) {
 	if (!server) return null;
 	try {
 		const ctrl = new AbortController();
 		const t = setTimeout(() => ctrl.abort(), 2e3);
-		const html = await (await fetch(`${server}/`, {
+		const res = await fetch(`${server}/_v/manifest.json`, {
 			signal: ctrl.signal,
 			redirect: "follow"
-		})).text();
+		});
 		clearTimeout(t);
-		const m = /\/_v\/base\.[a-f0-9]+\.css/.exec(html);
-		return m ? `${server}${m[0]}` : null;
+		if (!res.ok) return null;
+		const manifest = await res.json();
+		if (typeof manifest !== "object" || manifest === null) return null;
+		const m = manifest;
+		const file = m["reader.css"] ?? m["app.css"];
+		return typeof file === "string" ? `${server}/_v/${file}` : null;
 	} catch {
 		return null;
 	}
@@ -4588,23 +5896,25 @@ function page(meta, baseCss, hasCss, mtime) {
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>${esc(meta.name)} · jdu widget dev</title>
+<style>
+/* 设计系统 tokens（构建期内联的 docs/design-system/tokens.css）：widget 只读 token、不带兜底色，
+   预览页必须自己给一份；连上 server 时线上正文样式表再叠在后面 */
+${tokens_default}
+</style>
 ${baseCss ? `<link rel="stylesheet" href="${esc(baseCss)}">` : ""}
 ${hasCss ? `<link rel="stylesheet" href="/index.css?t=${mtime}">` : ""}
 <style>
-  /* 兜底 token：连不上 jiandu server 时也有亮 / 暗两套 */
-  :root { --jiandu-bg: #fff; --jiandu-bg-subtle: #f6f8fa; --jiandu-fg: #1f2328; --jiandu-fg-muted: #59636e; --jiandu-border: #d0d7de; --jiandu-font-sans: system-ui, sans-serif; --jiandu-font-mono: ui-monospace, monospace; }
-  .dark { --jiandu-bg: #0d1117; --jiandu-bg-subtle: #161b22; --jiandu-fg: #e6edf3; --jiandu-fg-muted: #9198a1; --jiandu-border: #3d444d; }
-  html { background: var(--jiandu-bg); color: var(--jiandu-fg); font-family: var(--jiandu-font-sans); }
+  html { background: var(--bg); color: var(--fg); font-family: var(--f-sans); }
   body { margin: 0; }
-  .dev-bar { display: flex; gap: 1rem; align-items: center; padding: 0.5rem 1rem; border-bottom: 1px solid var(--jiandu-border); font-size: 13px; color: var(--jiandu-fg-muted); }
-  .dev-bar b { color: var(--jiandu-fg); }
-  .dev-bar button { margin-left: auto; padding: 0.25rem 0.6rem; border: 1px solid var(--jiandu-border); border-radius: 6px; background: var(--jiandu-bg-subtle); color: inherit; cursor: pointer; }
+  .dev-bar { display: flex; gap: 1rem; align-items: center; padding: 0.5rem 1rem; border-bottom: 1px solid var(--line); font-size: var(--t-sm); color: var(--fg-muted); }
+  .dev-bar b { color: var(--fg); }
+  .dev-bar button { margin-left: auto; height: 26px; padding: 0 var(--s4); border: 1px solid var(--line-strong); border-radius: var(--r-sm); background: var(--s-1); color: var(--fg); font: 550 var(--t-sm) var(--f-sans); cursor: pointer; }
   .dev-main { max-width: 760px; margin: 0 auto; padding: 1.5rem 1rem; }
-  .dev-stage { min-height: 4rem; padding: 1rem; border: 1px dashed var(--jiandu-border); border-radius: 8px; }
-  details { margin-top: 1.5rem; font-size: 13px; color: var(--jiandu-fg-muted); }
-  textarea { width: 100%; min-height: 8rem; margin-top: 0.5rem; padding: 0.5rem; box-sizing: border-box; border: 1px solid var(--jiandu-border); border-radius: 6px; background: var(--jiandu-bg-subtle); color: var(--jiandu-fg); font: 12px/1.5 var(--jiandu-font-mono); }
-  .dev-err { color: #d1242f; white-space: pre-wrap; font-family: var(--jiandu-font-mono); font-size: 12px; }
-  .dev-degraded { padding: 0.75rem; border-radius: 6px; background: var(--jiandu-bg-subtle); font-family: var(--jiandu-font-mono); font-size: 12px; white-space: pre-wrap; }
+  .dev-stage { min-height: 4rem; padding: 1rem; border: 1px dashed var(--line-strong); border-radius: var(--r-md); }
+  details { margin-top: 1.5rem; font-size: var(--t-sm); color: var(--fg-muted); }
+  textarea { width: 100%; min-height: 8rem; margin-top: 0.5rem; padding: 0.5rem; box-sizing: border-box; border: 1px solid var(--line-strong); border-radius: var(--r-sm); background: var(--s-1); color: var(--fg); font: 12px/1.5 var(--f-mono); }
+  .dev-err { color: var(--danger); white-space: pre-wrap; font-family: var(--f-mono); font-size: 12px; }
+  .dev-degraded { padding: 0.75rem; border-radius: var(--r-sm); background: var(--s-2); font-family: var(--f-mono); font-size: 12px; white-space: pre-wrap; }
 </style>
 </head>
 <body>
@@ -4812,26 +6122,36 @@ export interface Data {
   count?: number;
 }
 `;
-var STYLE_CSS = (c) => `/* 颜色一律走 --jiandu-* token（带兜底值），亮 / 暗主题跟宿主一起变；暗色用 .dark 选择器，不要 prefers-color-scheme */
+var STYLE_CSS = (c) => `/* 颜色、字号、圆角一律走宿主的设计 token（docs/design-system/tokens.css），亮 / 暗主题跟宿主一起变；
+   不写 hex，不写 .dark 分支，不用 prefers-color-scheme。常用的：
+   表面 --bg --s-1 --s-2 --s-3 --s-4 · 描边 --line --line-strong --line-loud · 文字 --fg --fg-muted --fg-subtle
+   强调 --accent --accent-quiet --accent-ring --on-accent · 语义 --success --warn --danger（各配 -quiet）
+   字号 --t-sm(13) --t-ui(14) --t-body(15) · 间距 --s4(8) --s5(12) --s6(16) · 圆角 --r-sm(6) --r-md(10) */
 .w-${c.kebab} {
   display: inline-flex;
   align-items: center;
-  gap: 0.5rem;
-  padding: 0.5rem 0.75rem;
-  border: 1px solid var(--jiandu-border, #d0d7de);
-  border-radius: 8px;
-  background: var(--jiandu-bg-subtle, #f6f8fa);
-  color: var(--jiandu-fg, #1f2328);
-  font: 14px/1.4 var(--jiandu-font-sans, system-ui, sans-serif);
+  gap: var(--s4);
+  padding: var(--s4) var(--s5);
+  border: 1px solid var(--line);
+  border-radius: var(--r-md);
+  background: var(--s-2);
+  color: var(--fg);
+  font: var(--t-ui) / 1.4 var(--f-sans);
 }
 .w-${c.kebab} button {
-  padding: 0 0.5rem;
-  border: 1px solid var(--jiandu-border, #d0d7de);
-  border-radius: 6px;
-  background: var(--jiandu-bg, #fff);
+  height: 26px;
+  padding: 0 var(--s4);
+  border: 1px solid var(--line-strong);
+  border-radius: var(--r-sm);
+  background: var(--s-1);
   color: inherit;
+  font: 550 var(--t-sm) var(--f-sans);
   cursor: pointer;
 }
+.w-${c.kebab} button:hover {
+  background: var(--s-2);
+  border-color: var(--line-loud);
+}
 `;
 var VANILLA_INDEX = (c) => `import type { WidgetContext } from './_base/contract.js';
 import type { Data } from './types.js';
@@ -5144,6 +6464,7 @@ var WIDGET_JSON = (c) => `${JSON.stringify({
 	name: c.name,
 	scope: "personal",
 	version: "1.0.0",
+	description: "一句话说清什么场景用这个组件——agent 靠它决定选不选",
 	dataSchema: {
 		type: "object",
 		required: ["title"],
@@ -5189,7 +6510,7 @@ npm run push         # = build + jdu widget push dist
 |---|---|
 | \`src/types.ts\` | \`Data\` 接口 = fence 里 data 的唯一事实。JSDoc → description，\`@default\` → default；\`npm run build\` 生成 widget.json 的 dataSchema |
 | ${c.template === "vanilla" ? "`src/index.ts`" : c.template === "react" ? "`src/App.tsx`" : "`src/App.ts`"} | 渲染逻辑${c.template === "vanilla" ? "（mount / update / destroy 三个生命周期）" : "（组件收 `data` prop；契约适配在 `src/_base/`，一般不用动）"} |
-| \`src/style.css\` | 样式。颜色走 \`--jiandu-*\` token 带兜底值，暗色用 \`.dark\` 选择器 |
+| \`src/style.css\` | 样式。颜色 / 字号 / 圆角走宿主的设计 token（\`--bg\` \`--fg\` \`--line\` \`--accent\` \`--t-ui\` \`--r-md\` …），不写 hex 与 \`.dark\` 分支；主题真源是 \`<html class="dark">\`，token 会自己换值 |
 | \`widget.json\` | name / scope / version / sampleData；dataSchema 由 build 生成，不用手写 |
 | \`scripts/build.mjs\` | 全内联构建配置${c.runtime ? "；`RUNTIME_PATHS` 是平台版本档 runtime 的 URL" : ""} |
 
@@ -5297,8 +6618,48 @@ async function client() {
 function collectTag(value, previous) {
 	return [...previous ?? [], value];
 }
+var VERSION = "0.6.0";
 var program = new Command();
-program.name("jdu").description("jiandu 命令行").version("0.4.0").showHelpAfterError();
+program.name("jdu").description("jiandu 命令行").version(VERSION).showHelpAfterError();
+program.command("deploy").description("把一台简牍部署到你自己的 Cloudflare 账号（Worker + Durable Object，Free 计划够用）").option("--name <name>", "Worker 名字，决定 workers.dev 的子域名前缀", "jiandu").option("--dist <dir>", "用本地构建的产物代替 npm 包（开发用，指向 server/dist-cf）").option("--cf-token <token>", "带 Access 权限的 Cloudflare API token（不给就走浏览器 OAuth / 本地缓存）").option("--no-login", "部署完不自动 jdu login（之后手动跑一次即可）").option("--dry-run", "只校验配置与产物，不上传、不碰你的账号", false).option("--json", "机器可读输出（agent 联动用）", false).action(async (opts) => {
+	const result = await runDeploy({
+		...opts,
+		login: opts.login && !opts.json
+	});
+	if (opts.json) {
+		process.stdout.write(`${JSON.stringify(result)}\n`);
+		return;
+	}
+	if (opts.dryRun) {
+		process.stdout.write("校验通过：产物与 wrangler 配置都没问题，没有上传任何东西\n");
+		return;
+	}
+	process.stdout.write(`已部署 ${result.url}${result.upgraded ? "（升级：Access 策略与实例数据都没动）" : ""}\n`);
+	process.stdout.write(`\n浏览器打开它，用 Cloudflare 账号（${result.ownerEmail}）登录；公开文档匿名可读。\n`);
+	process.stdout.write(`加人：jdu access allow <邮箱>\n`);
+	if (result.loggedIn) process.stdout.write("\njdu 已经连上它了，可以直接 jdu push\n");
+	else process.stdout.write(`\n下一步：jdu login --server ${result.url}\n`);
+});
+var access = program.command("access").description("Cloudflare 形态的准入（Access 策略里的邮箱列表）");
+access.command("list").description("列出能登录这台实例的邮箱").option("--server <url>", "目标站点（缺省用 jdu login 时定下的那台）").option("--cf-token <token>", "带 Access 权限的 Cloudflare API token").option("--json", "机器可读输出", false).action(async (opts) => {
+	const result = await runAccessList(opts);
+	if (opts.json) {
+		process.stdout.write(`${JSON.stringify(result)}\n`);
+		return;
+	}
+	if (result.emails.length === 0) process.stdout.write(`（${result.server} 的 Access 策略里没有邮箱）\n`);
+	for (const email of result.emails) process.stdout.write(`${email}\n`);
+});
+access.command("allow").argument("<email...>", "要允许登录的邮箱（对方的 Cloudflare 账号邮箱）").description("把邮箱写进 Access 策略：对方用自己的 Cloudflare 账号（同一邮箱）登录").option("--server <url>", "目标站点（缺省用 jdu login 时定下的那台）").option("--cf-token <token>", "带 Access 权限的 Cloudflare API token").option("--json", "机器可读输出", false).action(async (emails, opts) => {
+	const result = await runAccessAllow(emails, opts);
+	if (opts.json) process.stdout.write(`${JSON.stringify(result)}\n`);
+	else process.stdout.write(`已允许：${result.emails.join(", ")}\n`);
+});
+access.command("deny").argument("<email...>", "要移除的邮箱").description("把邮箱从 Access 策略里去掉：对方即刻失去访问（浏览器与 CLI 同时失效）").option("--server <url>", "目标站点（缺省用 jdu login 时定下的那台）").option("--cf-token <token>", "带 Access 权限的 Cloudflare API token").option("--json", "机器可读输出", false).action(async (emails, opts) => {
+	const result = await runAccessDeny(emails, opts);
+	if (opts.json) process.stdout.write(`${JSON.stringify(result)}\n`);
+	else process.stdout.write(`剩余邮箱：${result.emails.join(", ")}\n`);
+});
 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,
@@ -5440,7 +6801,7 @@ template.command("push").argument("<file.md>", "模板文件").description("发
 	const res = await pushTemplate(await client(), file, opts);
 	process.stdout.write(`${res.url}\n`);
 });
-program.command("mcp").description("以 MCP server（stdio）暴露 list_docs / search_docs / read_doc / list_versions / push_doc，给本机 agent 用").action(async () => {
+program.command("mcp").description("以 MCP server（stdio）暴露文档 / 评论 / widget / 语法工具，模板同时暴露为 prompts，给本机 agent 用").action(async () => {
 	await runMcp(await client());
 });
 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) => {
@@ -5493,6 +6854,12 @@ tokenCmd.command("list").description("列出我的 token；CURRENT 是本次请
 		}
 	]);
 });
+tokenCmd.command("create").option("--label <label>", "备注（jdu token list 里辨认用），如 agent / ci", "cli").description("再签一枚 token 给别的机器 / headless agent 用；stdout 只有 token，方便 $(jdu token create --label agent)").action(async (opts) => {
+	const res = await (await client()).postJson("/api/tokens", { label: opts.label });
+	if (typeof res.token !== "string") throw new CliError("server 没有返回 token");
+	process.stderr.write(`id=${String(res.id)} label=${String(res.label)}（明文只显示这一次）\n`);
+	process.stdout.write(`${res.token}\n`);
+});
 tokenCmd.command("rm").argument("<id>", "jdu token list 里的 ID").description("吊销一枚 token（正在使用的那枚不能删）").action(async (id) => {
 	await (await client()).deleteJson(`/api/tokens/${encodeURIComponent(id)}`);
 	process.stdout.write(`revoked ${id}\n`);