AI-native knowledge base & Evernote/Obsidian alternative with instant sync & native MCP. Free on Cloudflare or self-hosted via Docker.
HTML ai-agentcloudflarecloudflare-d1cloudflare-r2cloudflare-workersdockerelectronevernoteevernote-alternativeknowledge-basemcpnote-takingobsidian-alternativeoffline-firstpersonal-knowledge-basepwaself-hostedsqlitetiptapweb-clipper
feat: add agent tokens and MCP CLI access
tianmafd2250b52df2
diff --git a/apps/api/src/index.ts b/apps/api/src/index.tsindex 4fbdeb4a..bcdfa9f4 100644--- a/apps/api/src/index.ts+++ b/apps/api/src/index.ts@@ -3,14 +3,18 @@ import {docToMarkdown,docToText,emptyDoc,+ ApiTokenCreateSchema,LoginSchema,markdownToDoc,MemoCreateSchema,MemoUpdateSchema,MergeMemosSchema,normalizeTags,+ TagRenameSchema,NotebookCreateSchema,NotebookUpdateSchema,+ type ApiToken,+ type CreatedApiToken,type MemoDetail,type MemoRevision,type MemoSummary,@@ -18,6 +22,7 @@ import {type Resource,type ResourceListItem,type ResourceStorageSummary,+ type TagSummary,type TiptapDoc,} from "@edgeever/shared";import { zValidator } from "@hono/zod-validator";@@ -41,6 +46,7 @@ type AuthContext = {actorId: string | null;username: string;displayName: string | null;+ scopes: string[];sessionId?: string;tokenId?: string;};@@ -116,7 +122,23 @@ type ApiTokenRow = {id: string;name: string;scopes_json: string;+ last_used_at: string | null;expires_at: string | null;+ is_revoked: number;+ created_at: string;+};++type TagSummaryRow = {+ name: string;+ memo_count: number;+ updated_at: string | null;+};++type MemoTagUpdateRow = {+ id: string;+ title: string | null;+ tags_json: string;+ content_text: string;};type ResourceRow = {@@ -161,6 +183,19 @@ const DEFAULT_SESSION_TTL_DAYS = 30;const DEFAULT_R2_BUCKET_NAME = "edgeever-resources";const MAX_IMAGE_UPLOAD_BYTES = 10 * 1024 * 1024;const REVISION_SNAPSHOT_INTERVAL_MS = 5 * 60 * 1000;+const API_TOKEN_BYTES = 32;+const API_TOKEN_PREFIX = "eev";+const ALL_TOKEN_SCOPES = [+ "read:notebooks",+ "write:notebooks",+ "read:memos",+ "write:memos",+ "read:resources",+ "write:resources",+ "read:tags",+ "write:tags",+] as const;+type TokenScope = (typeof ALL_TOKEN_SCOPES)[number];const SUPPORTED_IMAGE_MIME_TYPES = new Set(["image/png","image/jpeg",@@ -181,6 +216,16 @@ app.use(}));+app.use(+ "/mcp",+ cors({+ origin: ["http://127.0.0.1:5173", "http://localhost:5173"],+ allowHeaders: ["Content-Type", "Authorization"],+ allowMethods: ["GET", "POST", "OPTIONS"],+ credentials: true,+ })+);+app.get("/api/health", (c) =>c.json({ok: true,@@ -279,6 +324,7 @@ app.use("/api/v1/*", async (c, next) => {actorId: null,username: "owner",displayName: "Owner",+ scopes: [],});await next();return;@@ -294,7 +340,91 @@ app.use("/api/v1/*", async (c, next) => {await next();});+app.get("/api/v1/api-tokens", async (c) => {+ const userOnly = requireUser(c);++ if (userOnly) {+ return userOnly;+ }++ const rows = await c.env.DB.prepare(+ `SELECT id, name, scopes_json, last_used_at, expires_at, is_revoked, created_at+ FROM api_tokens+ ORDER BY is_revoked ASC, created_at DESC+ LIMIT 200`+ ).all<ApiTokenRow>();++ return c.json({+ apiTokens: rows.results.map(mapApiToken),+ availableScopes: ALL_TOKEN_SCOPES,+ });+});++app.post("/api/v1/api-tokens", zValidator("json", ApiTokenCreateSchema), async (c) => {+ const userOnly = requireUser(c);++ if (userOnly) {+ return userOnly;+ }++ const input = c.req.valid("json");+ const scopes = normalizeTokenScopes(input.scopes);++ if (!scopes) {+ return badRequest(c, "Token scope is not supported.");+ }++ const id = createId("tok");+ const token = `${API_TOKEN_PREFIX}_${randomToken(API_TOKEN_BYTES)}`;+ const now = isoNow();+ const actor = getAuditActor(c);++ await c.env.DB.batch([+ c.env.DB.prepare(+ `INSERT INTO api_tokens (id, name, token_hash, scopes_json, expires_at, created_at)+ VALUES (?, ?, ?, ?, ?, ?)`+ ).bind(id, input.name, await sha256(token), JSON.stringify(scopes), input.expiresAt ?? null, now),+ auditStatement(c.env.DB, actor.actorType, actor.actorId, "api_token.create", "api_token", id, {+ name: input.name,+ scopes,+ expiresAt: input.expiresAt ?? null,+ }),+ ]);++ const row = await getApiTokenRow(c.env.DB, id);++ if (!row) {+ return notFound(c, "API token not found");+ }++ return c.json({ token, apiToken: mapApiToken(row) } satisfies CreatedApiToken, 201);+});++app.delete("/api/v1/api-tokens/:id", async (c) => {+ const userOnly = requireUser(c);++ if (userOnly) {+ return userOnly;+ }++ const id = c.req.param("id");+ const actor = getAuditActor(c);++ await c.env.DB.batch([+ c.env.DB.prepare(`UPDATE api_tokens SET is_revoked = 1 WHERE id = ?`).bind(id),+ auditStatement(c.env.DB, actor.actorType, actor.actorId, "api_token.revoke", "api_token", id, {}),+ ]);++ return c.json({ ok: true });+});+app.get("/api/v1/notebooks", async (c) => {+ const denied = requireScopes(c, "read:notebooks");++ if (denied) {+ return denied;+ }+const rows = await c.env.DB.prepare(`SELECT id, parent_id, name, slug, icon, color, sort_order, created_at, updated_atFROM notebooks@@ -306,6 +436,12 @@ app.get("/api/v1/notebooks", async (c) => {});app.post("/api/v1/notebooks", zValidator("json", NotebookCreateSchema), async (c) => {+ const denied = requireScopes(c, "write:notebooks");++ if (denied) {+ return denied;+ }+const input = c.req.valid("json");const actor = getAuditActor(c);const id = createId("nb");@@ -325,6 +461,12 @@ app.post("/api/v1/notebooks", zValidator("json", NotebookCreateSchema), async (c});app.patch("/api/v1/notebooks/:id", zValidator("json", NotebookUpdateSchema), async (c) => {+ const denied = requireScopes(c, "write:notebooks");++ if (denied) {+ return denied;+ }+const id = c.req.param("id");const input = c.req.valid("json");const actor = getAuditActor(c);@@ -352,9 +494,37 @@ app.patch("/api/v1/notebooks/:id", zValidator("json", NotebookUpdateSchema), asy});app.delete("/api/v1/notebooks/:id", async (c) => {+ const denied = requireScopes(c, "write:notebooks");++ if (denied) {+ return denied;+ }+const id = c.req.param("id");const actor = getAuditActor(c);const now = isoNow();+ const current = await getNotebook(c.env.DB, id);++ if (!current) {+ return notFound(c, "Notebook not found");+ }++ if (id === "nb_inbox") {+ return badRequest(c, "Inbox cannot be deleted.");+ }++ const [childCount, memoCount] = await Promise.all([+ c.env.DB.prepare(`SELECT COUNT(*) AS count FROM notebooks WHERE parent_id = ? AND is_deleted = 0`)+ .bind(id)+ .first<{ count: number }>(),+ c.env.DB.prepare(`SELECT COUNT(*) AS count FROM memos WHERE notebook_id = ? AND is_deleted = 0`)+ .bind(id)+ .first<{ count: number }>(),+ ]);++ if ((childCount?.count ?? 0) > 0 || (memoCount?.count ?? 0) > 0) {+ return conflict(c, "notebook_not_empty", "Move or delete child notebooks and memos before deleting this notebook.");+ }await c.env.DB.prepare(`UPDATE notebooks@@ -368,7 +538,54 @@ app.delete("/api/v1/notebooks/:id", async (c) => {return c.json({ ok: true });});+app.get("/api/v1/tags", async (c) => {+ const denied = requireScopes(c, "read:tags");++ if (denied) {+ return denied;+ }++ return c.json({ tags: await listTagSummaries(c.env.DB) });+});++app.patch("/api/v1/tags/:tag", zValidator("json", TagRenameSchema), async (c) => {+ const denied = requireScopes(c, "write:tags");++ if (denied) {+ return denied;+ }++ const oldTag = decodeTagParam(c.req.param("tag"));+ const input = c.req.valid("json");+ const actor = getAuditActor(c);+ const actorLabel = getActorLabel(c);+ const updated = await updateTagAcrossMemos(c.env.DB, oldTag, input.name, actor, actorLabel);++ return c.json({ ok: true, updated });+});++app.delete("/api/v1/tags/:tag", async (c) => {+ const denied = requireScopes(c, "write:tags");++ if (denied) {+ return denied;+ }++ const tag = decodeTagParam(c.req.param("tag"));+ const actor = getAuditActor(c);+ const actorLabel = getActorLabel(c);+ const updated = await updateTagAcrossMemos(c.env.DB, tag, null, actor, actorLabel);++ return c.json({ ok: true, updated });+});+app.get("/api/v1/memos", async (c) => {+ const denied = requireScopes(c, "read:memos");++ if (denied) {+ return denied;+ }+const notebookId = c.req.query("notebookId");const q = c.req.query("q")?.trim();const includeTrash = c.req.query("trash") === "1";@@ -434,6 +651,12 @@ app.get("/api/v1/memos", async (c) => {});app.post("/api/v1/memos", zValidator("json", MemoCreateSchema), async (c) => {+ const denied = requireScopes(c, "write:memos");++ if (denied) {+ return denied;+ }+const input = c.req.valid("json");const actor = getAuditActor(c);const actorLabel = getActorLabel(c);@@ -471,6 +694,12 @@ app.post("/api/v1/memos", zValidator("json", MemoCreateSchema), async (c) => {});app.get("/api/v1/memos/:id", async (c) => {+ const denied = requireScopes(c, "read:memos");++ if (denied) {+ return denied;+ }+const includeDeleted = c.req.query("includeDeleted") === "1";const memo = await getMemoDetail(c.env.DB, c.req.param("id"), includeDeleted);@@ -482,6 +711,12 @@ app.get("/api/v1/memos/:id", async (c) => {});app.get("/api/v1/memos/:id/revisions", async (c) => {+ const denied = requireScopes(c, "read:memos");++ if (denied) {+ return denied;+ }+const memoId = c.req.param("id");const memo = await getMemoDetail(c.env.DB, memoId);@@ -505,6 +740,12 @@ app.get("/api/v1/memos/:id/revisions", async (c) => {});app.post("/api/v1/memos/:id/revisions/:revisionId/restore", async (c) => {+ const denied = requireScopes(c, "write:memos");++ if (denied) {+ return denied;+ }+const memoId = c.req.param("id");const revisionId = c.req.param("revisionId");const actor = getAuditActor(c);@@ -560,6 +801,12 @@ app.post("/api/v1/memos/:id/revisions/:revisionId/restore", async (c) => {});app.get("/api/v1/resources", async (c) => {+ const denied = requireScopes(c, "read:resources");++ if (denied) {+ return denied;+ }+const limit = clampNumber(Number(c.req.query("limit") ?? 500), 1, 500);const [rows, stats] = await Promise.all([c.env.DB.prepare(@@ -592,6 +839,12 @@ app.get("/api/v1/resources", async (c) => {});app.post("/api/v1/memos/:id/resources", async (c) => {+ const denied = requireScopes(c, "write:resources");++ if (denied) {+ return denied;+ }+const memoId = c.req.param("id");const memo = await getMemoDetail(c.env.DB, memoId);@@ -694,6 +947,12 @@ app.post("/api/v1/memos/:id/resources", async (c) => {});app.get("/api/v1/resources/:id/blob", async (c) => {+ const denied = requireScopes(c, "read:resources");++ if (denied) {+ return denied;+ }+const resource = await getResourceRow(c.env.DB, c.req.param("id"));if (!resource) {@@ -718,6 +977,12 @@ app.get("/api/v1/resources/:id/blob", async (c) => {});app.patch("/api/v1/memos/:id", zValidator("json", MemoUpdateSchema), async (c) => {+ const denied = requireScopes(c, "write:memos");++ if (denied) {+ return denied;+ }+const id = c.req.param("id");const input = c.req.valid("json");const actor = getAuditActor(c);@@ -791,6 +1056,12 @@ app.patch("/api/v1/memos/:id", zValidator("json", MemoUpdateSchema), async (c) =});app.delete("/api/v1/memos/:id", async (c) => {+ const denied = requireScopes(c, "write:memos");++ if (denied) {+ return denied;+ }+const id = c.req.param("id");const actor = getAuditActor(c);const permanent = c.req.query("permanent") === "1";@@ -835,6 +1106,12 @@ app.delete("/api/v1/memos/:id", async (c) => {});app.post("/api/v1/memos/:id/restore", async (c) => {+ const denied = requireScopes(c, "write:memos");++ if (denied) {+ return denied;+ }+const id = c.req.param("id");const actor = getAuditActor(c);const current = await getMemoDetailRow(c.env.DB, id, true);@@ -864,6 +1141,12 @@ app.post("/api/v1/memos/:id/restore", async (c) => {});app.post("/api/v1/memos/merge", zValidator("json", MergeMemosSchema), async (c) => {+ const denied = requireScopes(c, "write:memos");++ if (denied) {+ return denied;+ }+const input = c.req.valid("json");const actor = getAuditActor(c);const actorLabel = getActorLabel(c);@@ -956,15 +1239,90 @@ app.post("/api/v1/memos/merge", zValidator("json", MergeMemosSchema), async (c)return c.json({ memo: await getMemoDetail(c.env.DB, newMemoId) }, 201);});-app.all("/mcp", (c) =>+app.get("/mcp", (c) =>c.json({name: "EdgeEver MCP endpoint",- status: "planned",- message: "Remote MCP will be wired to the same memo and notebook services as the REST API.",+ status: "ready",+ transport: "streamable-http-jsonrpc",+ auth: "Authorization: Bearer <api-token>",restBasePath: "/api/v1",}));+app.post("/mcp", async (c) => {+ let request: JsonRpcRequest;++ try {+ request = (await c.req.json()) as JsonRpcRequest;+ } catch {+ return c.json(jsonRpcError(null, -32700, "Parse error"), 400);+ }++ if (!request || request.jsonrpc !== "2.0" || typeof request.method !== "string") {+ return c.json(jsonRpcError(getJsonRpcId(request), -32600, "Invalid Request"), 400);+ }++ if (request.method === "notifications/initialized" && request.id === undefined) {+ return new Response(null, { status: 204 });+ }++ if (request.method === "initialize") {+ return c.json(+ jsonRpcResult(request.id ?? null, {+ protocolVersion: "2024-11-05",+ capabilities: {+ tools: {},+ },+ serverInfo: {+ name: "edgeever",+ version: "0.1.0",+ },+ })+ );+ }++ const auth = await authenticateRequest(c, true);++ if (!auth) {+ return c.json(jsonRpcError(request.id ?? null, -32001, "Authentication required"), 401);+ }++ c.set("auth", auth);++ if (request.method === "tools/list") {+ return c.json(+ jsonRpcResult(request.id ?? null, {+ tools: MCP_TOOLS,+ })+ );+ }++ if (request.method === "tools/call") {+ const params = asRecord(request.params);+ const name = typeof params.name === "string" ? params.name : "";+ const args = asRecord(params.arguments);++ try {+ const result = await callMcpTool(c, auth, name, args);+ return c.json(+ jsonRpcResult(request.id ?? null, {+ content: [+ {+ type: "text",+ text: JSON.stringify(result, null, 2),+ },+ ],+ })+ );+ } catch (error) {+ const message = error instanceof Error ? error.message : "Tool call failed";+ return c.json(jsonRpcError(request.id ?? null, -32000, message), 400);+ }+ }++ return c.json(jsonRpcError(request.id ?? null, -32601, "Method not found"), 404);+});+app.notFound((c) =>c.json({@@ -979,6 +1337,213 @@ app.notFound((c) =>export default app;+type JsonRpcRequest = {+ jsonrpc?: string;+ id?: string | number | null;+ method?: string;+ params?: unknown;+};++type JsonRpcId = string | number | null;++const MCP_TOOLS = [+ {+ name: "search_memos",+ description: "Search active EdgeEver memos by text, tag, or notebook.",+ inputSchema: {+ type: "object",+ properties: {+ query: { type: "string" },+ notebookId: { type: "string" },+ limit: { type: "number", minimum: 1, maximum: 50 },+ },+ },+ },+ {+ name: "get_memo",+ description: "Read a memo with Markdown content.",+ inputSchema: {+ type: "object",+ required: ["memoId"],+ properties: {+ memoId: { type: "string" },+ },+ },+ },+ {+ name: "create_memo",+ description: "Create a memo in a notebook.",+ inputSchema: {+ type: "object",+ required: ["notebookId"],+ properties: {+ notebookId: { type: "string" },+ title: { type: "string" },+ contentMarkdown: { type: "string" },+ tags: { type: "array", items: { type: "string" } },+ },+ },+ },+ {+ name: "update_memo",+ description: "Update memo title, Markdown, tags, or notebook.",+ inputSchema: {+ type: "object",+ required: ["memoId"],+ properties: {+ memoId: { type: "string" },+ title: { type: "string" },+ contentMarkdown: { type: "string" },+ tags: { type: "array", items: { type: "string" } },+ notebookId: { type: "string" },+ expectedRevision: { type: "number" },+ },+ },+ },+ {+ name: "list_notebooks",+ description: "List active notebooks.",+ inputSchema: {+ type: "object",+ properties: {},+ },+ },+ {+ name: "list_tags",+ description: "List tags and memo counts.",+ inputSchema: {+ type: "object",+ properties: {},+ },+ },+];++const callMcpTool = async (+ c: AppContext,+ auth: AuthContext,+ name: string,+ args: Record<string, unknown>+) => {+ switch (name) {+ case "search_memos": {+ assertScope(auth, "read:memos");+ return {+ memos: await searchMemoSummaries(c.env.DB, {+ query: getOptionalString(args.query),+ notebookId: getOptionalString(args.notebookId),+ limit: clampNumber(Number(args.limit ?? 20), 1, 50),+ }),+ };+ }+ case "get_memo": {+ assertScope(auth, "read:memos");+ const memoId = getRequiredString(args.memoId, "memoId");+ const memo = await getMemoDetail(c.env.DB, memoId);++ if (!memo) {+ throw new Error("Memo not found");+ }++ return { memo };+ }+ case "create_memo": {+ assertScope(auth, "write:memos");+ const notebookId = getRequiredString(args.notebookId, "notebookId");+ const actor = getAuditActor(c);+ const actorLabel = getActorLabel(c);+ const memo = await createMemoRecord(c.env.DB, {+ notebookId,+ title: getOptionalString(args.title) ?? undefined,+ contentMarkdown: getOptionalString(args.contentMarkdown) ?? "",+ tags: getOptionalStringArray(args.tags),+ }, actor, actorLabel);++ return { memo };+ }+ case "update_memo": {+ assertScope(auth, "write:memos");+ const memoId = getRequiredString(args.memoId, "memoId");+ const actor = getAuditActor(c);+ const actorLabel = getActorLabel(c);+ const result = await updateMemoRecord(+ c.env.DB,+ memoId,+ {+ expectedRevision:+ typeof args.expectedRevision === "number" && Number.isInteger(args.expectedRevision)+ ? args.expectedRevision+ : undefined,+ notebookId: getOptionalString(args.notebookId) ?? undefined,+ title: getOptionalString(args.title) ?? undefined,+ contentMarkdown: getOptionalString(args.contentMarkdown) ?? undefined,+ tags: Array.isArray(args.tags) ? getOptionalStringArray(args.tags) : undefined,+ },+ actor,+ actorLabel+ );++ if ("error" in result) {+ throw new Error(result.message);+ }++ return { memo: result.memo };+ }+ case "list_notebooks": {+ assertScope(auth, "read:notebooks");+ return { notebooks: await listNotebooks(c.env.DB) };+ }+ case "list_tags": {+ assertScope(auth, "read:tags");+ return { tags: await listTagSummaries(c.env.DB) };+ }+ default:+ throw new Error(`Unknown tool: ${name}`);+ }+};++const jsonRpcResult = (id: JsonRpcId, result: unknown) => ({+ jsonrpc: "2.0",+ id,+ result,+});++const jsonRpcError = (id: JsonRpcId, code: number, message: string, data?: unknown) => ({+ jsonrpc: "2.0",+ id,+ error: {+ code,+ message,+ ...(data === undefined ? {} : { data }),+ },+});++const getJsonRpcId = (request: unknown): JsonRpcId => {+ if (!request || typeof request !== "object" || !("id" in request)) {+ return null;+ }++ const id = (request as { id?: unknown }).id;+ return typeof id === "string" || typeof id === "number" || id === null ? id : null;+};++const asRecord = (value: unknown): Record<string, unknown> =>+ value && typeof value === "object" && !Array.isArray(value) ? (value as Record<string, unknown>) : {};++const getOptionalString = (value: unknown) => (typeof value === "string" && value.trim() ? value.trim() : null);++const getRequiredString = (value: unknown, name: string) => {+ const parsed = getOptionalString(value);++ if (!parsed) {+ throw new Error(`${name} is required`);+ }++ return parsed;+};++const getOptionalStringArray = (value: unknown) =>+ Array.isArray(value) ? value.filter((item): item is string => typeof item === "string") : [];+const isAuthRequired = async (env: Bindings) => {if (env.EDGE_EVER_AUTH_PASSWORD_HASH?.trim()) {return true;@@ -1096,7 +1661,7 @@ const authenticateBearerToken = async (c: AppContext, touch: boolean): Promise<A}const row = await c.env.DB.prepare(- `SELECT id, name, scopes_json, expires_at+ `SELECT id, name, scopes_json, last_used_at, expires_at, is_revoked, created_atFROM api_tokensWHERE token_hash = ?AND is_revoked = 0@@ -1119,6 +1684,7 @@ const authenticateBearerToken = async (c: AppContext, touch: boolean): Promise<AactorId: row.id,username: row.name,displayName: row.name,+ scopes: parseJsonArray(row.scopes_json),tokenId: row.id,};};@@ -1156,6 +1722,7 @@ const authenticateSession = async (c: AppContext, touch: boolean): Promise<AuthCactorId: row.user_id,username: row.username,displayName: row.display_name,+ scopes: [],sessionId: row.id,};};@@ -1185,6 +1752,57 @@ const getActorLabel = (c: AppContext) => {return auth?.actorId ? `${auth.actorType}:${auth.actorId}` : auth?.username ?? "user";};+const requireUser = (c: AppContext) => {+ const auth = c.get("auth");++ if (auth?.kind === "user") {+ return null;+ }++ return forbidden(c, "Only an interactive user session can manage this resource.");+};++const requireScopes = (c: AppContext, ...scopes: TokenScope[]) => {+ const auth = c.get("auth");++ if (!auth) {+ return unauthorized(c, "Authentication required.");+ }++ if (hasScopes(auth, scopes)) {+ return null;+ }++ return forbidden(c, `Missing required scope: ${scopes.join(", ")}`);+};++const assertScope = (auth: AuthContext, scope: TokenScope) => {+ if (!hasScopes(auth, [scope])) {+ throw new Error(`Missing required scope: ${scope}`);+ }+};++const hasScopes = (auth: AuthContext, scopes: TokenScope[]) => {+ if (auth.kind === "user") {+ return true;+ }++ return scopes.every((scope) => auth.scopes.includes(scope));+};++const normalizeTokenScopes = (scopes: string[]) => {+ const normalized = Array.from(new Set(scopes.map((scope) => scope.trim()).filter(Boolean)));++ if (normalized.some((scope) => !isTokenScope(scope))) {+ return null;+ }++ return normalized as TokenScope[];+};++const isTokenScope = (scope: string): scope is TokenScope =>+ (ALL_TOKEN_SCOPES as readonly string[]).includes(scope);+const getSessionMaxAge = (env: Bindings) => {const days = clampNumber(Number(env.EDGE_EVER_SESSION_TTL_DAYS ?? DEFAULT_SESSION_TTL_DAYS), 1, 90);return days * 24 * 60 * 60;@@ -1365,6 +1983,212 @@ const mapResourceStorageSummary = (row: ResourceStatsRow | null): ResourceStoragattachmentCount: row?.attachment_count ?? 0,});+const mapApiToken = (row: ApiTokenRow): ApiToken => ({+ id: row.id,+ name: row.name,+ scopes: parseJsonArray(row.scopes_json),+ lastUsedAt: row.last_used_at,+ expiresAt: row.expires_at,+ isRevoked: Boolean(row.is_revoked),+ createdAt: row.created_at,+});++const mapTagSummary = (row: TagSummaryRow): TagSummary => ({+ name: row.name,+ memoCount: row.memo_count,+ updatedAt: row.updated_at,+});++const getApiTokenRow = async (db: D1Database, id: string): Promise<ApiTokenRow | null> =>+ db+ .prepare(+ `SELECT id, name, scopes_json, last_used_at, expires_at, is_revoked, created_at+ FROM api_tokens+ WHERE id = ?`+ )+ .bind(id)+ .first<ApiTokenRow>();++const listNotebooks = async (db: D1Database): Promise<Notebook[]> => {+ const rows = await db+ .prepare(+ `SELECT id, parent_id, name, slug, icon, color, sort_order, created_at, updated_at+ FROM notebooks+ WHERE is_deleted = 0+ ORDER BY parent_id IS NOT NULL, sort_order ASC, name ASC`+ )+ .all<NotebookRow>();++ return rows.results.map(mapNotebook);+};++const listTagSummaries = async (db: D1Database): Promise<TagSummary[]> => {+ const rows = await db+ .prepare(+ `SELECT json_each.value AS name,+ COUNT(DISTINCT m.id) AS memo_count,+ MAX(m.updated_at) AS updated_at+ FROM memos m, json_each(m.tags_json)+ WHERE m.is_deleted = 0+ AND trim(json_each.value) <> ''+ GROUP BY json_each.value+ ORDER BY lower(json_each.value) ASC`+ )+ .all<TagSummaryRow>();++ return rows.results+ .filter((row) => typeof row.name === "string" && row.name.trim())+ .map(mapTagSummary);+};++const updateTagAcrossMemos = async (+ db: D1Database,+ oldTag: string,+ nextTag: string | null,+ actor: { actorType: "user" | "agent"; actorId: string | null },+ actorLabel: string+) => {+ const normalizedOld = normalizeTags([oldTag])[0];+ const normalizedNext = nextTag === null ? null : normalizeTags([nextTag])[0];++ if (!normalizedOld || normalizedOld === normalizedNext) {+ return 0;+ }++ const rows = await db+ .prepare(+ `SELECT m.id, m.title, m.tags_json, c.content_text+ FROM memos m+ INNER JOIN memo_contents c ON c.memo_id = m.id+ WHERE m.is_deleted = 0+ AND EXISTS (+ SELECT 1+ FROM json_each(m.tags_json)+ WHERE json_each.value = ?+ )`+ )+ .bind(normalizedOld)+ .all<MemoTagUpdateRow>();++ const now = isoNow();+ const statements: D1PreparedStatement[] = [];+ let updated = 0;++ for (const row of rows.results) {+ const currentTags = parseJsonArray(row.tags_json);++ if (!currentTags.includes(normalizedOld)) {+ continue;+ }++ const nextTags = normalizeTags(+ currentTags.flatMap((tag) => {+ if (tag !== normalizedOld) {+ return [tag];+ }++ return normalizedNext ? [normalizedNext] : [];+ })+ );++ statements.push(+ db+ .prepare(+ `UPDATE memos+ SET tags_json = ?, updated_by = ?, updated_at = ?+ WHERE id = ? AND is_deleted = 0`+ )+ .bind(JSON.stringify(nextTags), actorLabel, now, row.id),+ db.prepare(`DELETE FROM memos_fts WHERE memo_id = ?`).bind(row.id),+ db+ .prepare(+ `INSERT INTO memos_fts (memo_id, title, content_text, tags)+ VALUES (?, ?, ?, ?)`+ )+ .bind(row.id, row.title, row.content_text, nextTags.join(" ")),+ auditStatement(db, actor.actorType, actor.actorId, normalizedNext ? "tag.rename" : "tag.delete", "memo", row.id, {+ from: normalizedOld,+ to: normalizedNext,+ })+ );+ updated += 1;+ }++ if (statements.length > 0) {+ await db.batch(statements);+ }++ return updated;+};++const searchMemoSummaries = async (+ db: D1Database,+ options: { query?: string | null; notebookId?: string | null; limit: number }+): Promise<MemoSummary[]> => {+ const q = options.query?.trim();+ const notebookId = options.notebookId?.trim() || null;+ const limit = clampNumber(options.limit, 1, 100);++ if (q) {+ const ftsQuery = toFtsQuery(q);+ const likeQuery = `%${escapeLike(q)}%`;++ if (ftsQuery) {+ const rows = await db+ .prepare(+ `WITH raw_matches(memo_id, rank) AS (+ SELECT memo_id, bm25(memos_fts)+ FROM memos_fts+ WHERE memos_fts MATCH ?++ UNION ALL++ SELECT m.id, 100.0+ FROM memos m+ INNER JOIN memo_contents c ON c.memo_id = m.id+ WHERE m.title LIKE ? ESCAPE '\\'+ OR c.content_text LIKE ? ESCAPE '\\'+ OR m.tags_json LIKE ? ESCAPE '\\'+ ),+ search_matches AS (+ SELECT memo_id, MIN(rank) AS rank+ FROM raw_matches+ GROUP BY memo_id+ )+ SELECT m.id, m.notebook_id, m.title, m.excerpt, m.tags_json, m.is_pinned,+ m.is_archived, m.is_deleted, m.created_at, m.updated_at, m.deleted_at, c.revision+ FROM search_matches s+ INNER JOIN memos m ON m.id = s.memo_id+ INNER JOIN memo_contents c ON c.memo_id = m.id+ WHERE m.is_deleted = 0+ AND (? IS NULL OR m.notebook_id = ?)+ ORDER BY s.rank ASC, m.is_pinned DESC, m.updated_at DESC+ LIMIT ?`+ )+ .bind(ftsQuery, likeQuery, likeQuery, likeQuery, notebookId, notebookId, limit)+ .all<MemoSummaryRow>();++ return rows.results.map(mapMemoSummary);+ }+ }++ const rows = await db+ .prepare(+ `SELECT m.id, m.notebook_id, m.title, m.excerpt, m.tags_json, m.is_pinned,+ m.is_archived, m.is_deleted, m.created_at, m.updated_at, m.deleted_at, c.revision+ FROM memos m+ INNER JOIN memo_contents c ON c.memo_id = m.id+ WHERE m.is_deleted = 0+ AND (? IS NULL OR m.notebook_id = ?)+ ORDER BY m.is_pinned DESC, m.updated_at DESC+ LIMIT ?`+ )+ .bind(notebookId, notebookId, limit)+ .all<MemoSummaryRow>();++ return rows.results.map(mapMemoSummary);+};+const getNotebook = async (db: D1Database, id: string): Promise<Notebook | null> => {const row = await db.prepare(@@ -1401,6 +2225,134 @@ const getMemoDetail = async (db: D1Database, id: string, includeDeleted = false)return row ? mapMemoDetail(row) : null;};+const createMemoRecord = async (+ db: D1Database,+ input: { notebookId: string; title?: string; contentMarkdown?: string; tags?: string[] },+ actor: { actorType: "user" | "agent"; actorId: string | null },+ actorLabel: string+): Promise<MemoDetail> => {+ const tags = normalizeTags(input.tags);+ const contentMarkdown = input.contentMarkdown ?? "";+ const contentJson = markdownToDoc(contentMarkdown);+ const contentText = docToText(contentJson);+ const title = input.title || deriveTitle(contentText);+ const excerpt = createExcerpt(contentText || title || "");+ const contentHash = await sha256(contentMarkdown + JSON.stringify(contentJson));+ const id = createId("memo");+ const now = isoNow();++ await db.batch([+ db+ .prepare(+ `INSERT INTO memos (+ id, notebook_id, title, excerpt, tags_json, created_by, updated_by, created_at, updated_at+ ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`+ )+ .bind(id, input.notebookId, title, excerpt, JSON.stringify(tags), actorLabel, actorLabel, now, now),+ db+ .prepare(+ `INSERT INTO memo_contents (+ memo_id, content_json, content_markdown, content_text, content_hash, revision, created_at, updated_at+ ) VALUES (?, ?, ?, ?, ?, 0, ?, ?)`+ )+ .bind(id, JSON.stringify(contentJson), contentMarkdown, contentText, contentHash, now, now),+ db+ .prepare(+ `INSERT INTO memos_fts (memo_id, title, content_text, tags)+ VALUES (?, ?, ?, ?)`+ )+ .bind(id, title, contentText, tags.join(" ")),+ auditStatement(db, actor.actorType, actor.actorId, "memo.create", "memo", id, {+ notebookId: input.notebookId,+ }),+ ]);++ const memo = await getMemoDetail(db, id);++ if (!memo) {+ throw new Error("Memo was created but could not be read.");+ }++ return memo;+};++const updateMemoRecord = async (+ db: D1Database,+ id: string,+ input: {+ expectedRevision?: number;+ notebookId?: string;+ title?: string;+ contentMarkdown?: string;+ tags?: string[];+ },+ actor: { actorType: "user" | "agent"; actorId: string | null },+ actorLabel: string+): Promise<{ memo: MemoDetail; error?: never; message?: never } | { error: string; message: string }> => {+ const current = await getMemoDetailRow(db, id);++ if (!current) {+ return { error: "not_found", message: "Memo not found" };+ }++ if (input.expectedRevision !== undefined && input.expectedRevision !== current.revision) {+ return { error: "revision_conflict", message: "Memo was updated elsewhere. Reload before saving." };+ }++ const currentContentJson = parseDoc(current.content_json);+ const contentJson = input.contentMarkdown !== undefined ? markdownToDoc(input.contentMarkdown) : currentContentJson;+ const contentMarkdown =+ input.contentMarkdown !== undefined ? input.contentMarkdown : docToMarkdown(contentJson);+ const contentText = docToText(contentJson);+ const title = input.title ?? current.title ?? deriveTitle(contentText);+ const tags = input.tags === undefined ? parseJsonArray(current.tags_json) : normalizeTags(input.tags);+ const excerpt = createExcerpt(contentText || title || "");+ const notebookId = input.notebookId ?? current.notebook_id;+ const nextRevision = current.revision + 1;+ const contentHash = await sha256(contentMarkdown + JSON.stringify(contentJson));+ const now = isoNow();+ const revisionStatements = (await shouldSnapshotMemoRevision(db, current, title, JSON.stringify(tags), contentHash, now))+ ? [createMemoRevisionStatement(db, current, actorLabel, now)]+ : [];++ await db.batch([+ ...revisionStatements,+ db+ .prepare(+ `UPDATE memos+ SET notebook_id = ?, title = ?, excerpt = ?, tags_json = ?, updated_by = ?, updated_at = ?+ WHERE id = ? AND is_deleted = 0`+ )+ .bind(notebookId, title, excerpt, JSON.stringify(tags), actorLabel, now, id),+ db+ .prepare(+ `UPDATE memo_contents+ SET content_json = ?, content_markdown = ?, content_text = ?, content_hash = ?,+ revision = ?, updated_at = ?+ WHERE memo_id = ?`+ )+ .bind(JSON.stringify(contentJson), contentMarkdown, contentText, contentHash, nextRevision, now, id),+ db.prepare(`DELETE FROM memos_fts WHERE memo_id = ?`).bind(id),+ db+ .prepare(+ `INSERT INTO memos_fts (memo_id, title, content_text, tags)+ VALUES (?, ?, ?, ?)`+ )+ .bind(id, title, contentText, tags.join(" ")),+ auditStatement(db, actor.actorType, actor.actorId, "memo.update", "memo", id, {+ revision: nextRevision,+ }),+ ]);++ const memo = await getMemoDetail(db, id);++ if (!memo) {+ return { error: "not_found", message: "Memo not found after update" };+ }++ return { memo };+};+const getMemoRevisionRow = async (db: D1Database,memoId: string,@@ -1647,6 +2599,14 @@ const contentDispositionInline = (filename: string | null) => {return `inline; filename="${fallback}"; filename*=UTF-8''${encodeURIComponent(filename)}`;};+const decodeTagParam = (value: string) => {+ try {+ return decodeURIComponent(value).trim();+ } catch {+ return value.trim();+ }+};+const notFound = (c: Context, message: string) =>c.json({@@ -1669,6 +2629,17 @@ const badRequest = (c: Context, message: string) =>400);+const conflict = (c: Context, code: string, message: string) =>+ c.json(+ {+ error: {+ code,+ message,+ },+ },+ 409+ );+const unauthorized = (c: Context, message: string) =>c.json({@@ -1679,3 +2650,14 @@ const unauthorized = (c: Context, message: string) =>},401);++const forbidden = (c: Context, message: string) =>+ c.json(+ {+ error: {+ code: "forbidden",+ message,+ },+ },+ 403+ );diff --git a/apps/web/src/app/App.tsx b/apps/web/src/app/App.tsxindex d32e2446..b4e37d15 100644--- a/apps/web/src/app/App.tsx+++ b/apps/web/src/app/App.tsx@@ -1,10 +1,12 @@import {docToMarkdown,+ type ApiToken,type AuthSession,type AuthUser,type MemoDetail,type MemoSummary,type Notebook,+ type TagSummary,type TiptapDoc,} from "@edgeever/shared";import Image from "@tiptap/extension-image";@@ -25,16 +27,19 @@ import {History,ImageIcon,Inbox,+ KeyRound,LayoutList,LockKeyhole,LogOut,Merge,MoreHorizontal,PanelLeft,+ Pencil,Plus,RotateCcw,Save,Search,+ ShieldCheck,Sparkles,Tags,Trash2,@@ -139,6 +144,8 @@ const WorkspaceApp = ({const [multiSelectKeyDown, setMultiSelectKeyDown] = useState(false);const [imageCompressionEnabled, setImageCompressionEnabled] = useState(readImageCompressionPreference);const [assetsOpen, setAssetsOpen] = useState(false);+ const [tagsOpen, setTagsOpen] = useState(false);+ const [settingsOpen, setSettingsOpen] = useState(false);const [search, setSearch] = useState("");const notebooksQuery = useQuery({@@ -221,6 +228,27 @@ const WorkspaceApp = ({},});+ const updateNotebookMutation = useMutation({+ mutationFn: ({ notebookId, name }: { notebookId: string; name: string }) =>+ api.updateNotebook(notebookId, { name }),+ onSuccess: async () => {+ await queryClient.invalidateQueries({ queryKey: ["notebooks"] });+ },+ });++ const deleteNotebookMutation = useMutation({+ mutationFn: api.deleteNotebook,+ onSuccess: async (_data, notebookId) => {+ if (selectedNotebookId === notebookId) {+ setSelectedNotebookId(null);+ setSelectedMemoId(null);+ }++ await queryClient.invalidateQueries({ queryKey: ["notebooks"] });+ await queryClient.invalidateQueries({ queryKey: ["memos"] });+ },+ });+const createMemoMutation = useMutation({mutationFn: api.createMemo,onSuccess: async (data) => {@@ -276,6 +304,29 @@ const WorkspaceApp = ({createNotebookMutation.mutate({ name: name.trim(), parentId: parentId ?? null });};+ const handleRenameNotebook = (notebook: Notebook) => {+ const name = window.prompt("重命名笔记本", notebook.name);++ if (!name?.trim() || name.trim() === notebook.name) {+ return;+ }++ updateNotebookMutation.mutate({ notebookId: notebook.id, name: name.trim() });+ };++ const handleDeleteNotebook = (notebook: Notebook) => {+ if (notebook.slug === "inbox") {+ window.alert("Inbox 不能删除。");+ return;+ }++ if (!window.confirm(`删除笔记本「${notebook.name}」?请先清空其中的笔记和子笔记本。`)) {+ return;+ }++ deleteNotebookMutation.mutate(notebook.id);+ };+const handleCreateMemo = () => {if (!selectedNotebookId || memoView === "trash") {return;@@ -323,12 +374,16 @@ const WorkspaceApp = ({setActivePane("memos");}}onCreateNotebook={handleCreateNotebook}+ onRenameNotebook={handleRenameNotebook}+ onDeleteNotebook={handleDeleteNotebook}onBackToList={() => setActivePane("memos")}onLogout={onLogout}isLoggingOut={isLoggingOut}imageCompressionEnabled={imageCompressionEnabled}onImageCompressionChange={setImageCompressionEnabled}onOpenAssets={() => setAssetsOpen(true)}+ onOpenTags={() => setTagsOpen(true)}+ onOpenSettings={() => setSettingsOpen(true)}onOpenTrash={() => {setMemoView("trash");setSelectedMemoIds(new Set());@@ -399,6 +454,8 @@ const WorkspaceApp = ({</main></div>{assetsOpen ? <AssetsDialog onClose={() => setAssetsOpen(false)} /> : null}+ {tagsOpen ? <TagsDialog onClose={() => setTagsOpen(false)} /> : null}+ {settingsOpen ? <SettingsDialog onClose={() => setSettingsOpen(false)} /> : null}</div>);};@@ -516,12 +573,16 @@ const NotebookPane = ({isLoading,onSelect,onCreateNotebook,+ onRenameNotebook,+ onDeleteNotebook,onBackToList,onLogout,isLoggingOut,imageCompressionEnabled,onImageCompressionChange,onOpenAssets,+ onOpenTags,+ onOpenSettings,onOpenTrash,}: {authRequired: boolean;@@ -531,12 +592,16 @@ const NotebookPane = ({isLoading: boolean;onSelect: (notebookId: string) => void;onCreateNotebook: (parentId?: string | null) => void;+ onRenameNotebook: (notebook: Notebook) => void;+ onDeleteNotebook: (notebook: Notebook) => void;onBackToList: () => void;onLogout: () => void;isLoggingOut: boolean;imageCompressionEnabled: boolean;onImageCompressionChange: (enabled: boolean) => void;onOpenAssets: () => void;+ onOpenTags: () => void;+ onOpenSettings: () => void;onOpenTrash: () => void;}) => {const tree = useMemo(() => buildNotebookTree(notebooks), [notebooks]);@@ -577,6 +642,8 @@ const NotebookPane = ({selectedNotebookId={selectedNotebookId}onSelect={onSelect}onCreateNotebook={onCreateNotebook}+ onRenameNotebook={onRenameNotebook}+ onDeleteNotebook={onDeleteNotebook}/>))}</div>@@ -595,7 +662,7 @@ const NotebookPane = ({/></label><div className={cn("grid gap-2", authRequired ? "grid-cols-5" : "grid-cols-4")}>- <Button size="icon" variant="ghost" title="标签">+ <Button size="icon" variant="ghost" title="标签" onClick={onOpenTags}><Tags className="h-4 w-4" /></Button><Button size="icon" variant="ghost" title="资产" onClick={onOpenAssets}>@@ -604,7 +671,7 @@ const NotebookPane = ({<Button size="icon" variant="ghost" title="回收站" onClick={onOpenTrash}><Trash2 className="h-4 w-4" /></Button>- <Button size="icon" variant="ghost" title="设置">+ <Button size="icon" variant="ghost" title="设置" onClick={onOpenSettings}><MoreHorizontal className="h-4 w-4" /></Button>{authRequired ? (@@ -624,16 +691,21 @@ const NotebookTreeItem = ({selectedNotebookId,onSelect,onCreateNotebook,+ onRenameNotebook,+ onDeleteNotebook,}: {node: NotebookNode;depth: number;selectedNotebookId: string | null;onSelect: (notebookId: string) => void;onCreateNotebook: (parentId?: string | null) => void;+ onRenameNotebook: (notebook: Notebook) => void;+ onDeleteNotebook: (notebook: Notebook) => void;}) => {const [open, setOpen] = useState(true);const hasChildren = node.children.length > 0;const selected = node.id === selectedNotebookId;+ const isInbox = node.slug === "inbox";return (<div>@@ -665,10 +737,38 @@ const NotebookTreeItem = ({selected ? "hover:bg-emerald-200" : "hover:bg-emerald-100")}title="新建子笔记本"- onClick={() => onCreateNotebook(node.id)}+ onClick={(event) => {+ event.stopPropagation();+ onCreateNotebook(node.id);+ }}><Plus className="h-3.5 w-3.5" /></button>+ <button+ className={cn(+ "hidden h-6 w-6 items-center justify-center rounded-md group-hover:flex",+ selected ? "hover:bg-emerald-200" : "hover:bg-emerald-100"+ )}+ title="重命名笔记本"+ onClick={(event) => {+ event.stopPropagation();+ onRenameNotebook(node);+ }}+ >+ <Pencil className="h-3.5 w-3.5" />+ </button>+ {!isInbox ? (+ <button+ className="hidden h-6 w-6 items-center justify-center rounded-md text-rose-600 hover:bg-rose-50 group-hover:flex"+ title="删除笔记本"+ onClick={(event) => {+ event.stopPropagation();+ onDeleteNotebook(node);+ }}+ >+ <Trash2 className="h-3.5 w-3.5" />+ </button>+ ) : null}</div>{hasChildren && open ? (@@ -681,6 +781,8 @@ const NotebookTreeItem = ({selectedNotebookId={selectedNotebookId}onSelect={onSelect}onCreateNotebook={onCreateNotebook}+ onRenameNotebook={onRenameNotebook}+ onDeleteNotebook={onDeleteNotebook}/>))}</div>@@ -1024,6 +1126,287 @@ const AssetsDialog = ({ onClose }: { onClose: () => void }) => {);};+const TagsDialog = ({ onClose }: { onClose: () => void }) => {+ const queryClient = useQueryClient();+ const tagsQuery = useQuery({+ queryKey: ["tags"],+ queryFn: () => api.listTags(),+ });+ const renameMutation = useMutation({+ mutationFn: ({ tag, name }: { tag: string; name: string }) => api.renameTag(tag, name),+ onSuccess: async () => {+ await Promise.all([+ queryClient.invalidateQueries({ queryKey: ["tags"] }),+ queryClient.invalidateQueries({ queryKey: ["memos"] }),+ queryClient.invalidateQueries({ queryKey: ["memo"] }),+ ]);+ },+ });+ const deleteMutation = useMutation({+ mutationFn: api.deleteTag,+ onSuccess: async () => {+ await Promise.all([+ queryClient.invalidateQueries({ queryKey: ["tags"] }),+ queryClient.invalidateQueries({ queryKey: ["memos"] }),+ queryClient.invalidateQueries({ queryKey: ["memo"] }),+ ]);+ },+ });+ const tags = tagsQuery.data?.tags ?? [];++ const handleRename = (tag: TagSummary) => {+ const name = window.prompt("重命名标签", tag.name);++ if (!name?.trim() || name.trim() === tag.name) {+ return;+ }++ renameMutation.mutate({ tag: tag.name, name: name.trim() });+ };++ const handleDelete = (tag: TagSummary) => {+ if (!window.confirm(`从 ${tag.memoCount} 条笔记中移除标签 #${tag.name}?`)) {+ return;+ }++ deleteMutation.mutate(tag.name);+ };++ return (+ <div className="fixed inset-0 z-50 flex items-end bg-slate-950/35 p-0 sm:items-center sm:justify-center sm:p-6">+ <section className="flex max-h-[88dvh] w-full flex-col rounded-t-md bg-white shadow-panel sm:max-w-[680px] sm:rounded-md">+ <header className="flex shrink-0 items-center justify-between gap-3 border-b border-emerald-100 px-4 py-3 sm:px-5">+ <div className="min-w-0">+ <div className="flex items-center gap-2 text-base font-semibold text-slate-950">+ <Tags className="h-4 w-4 text-emerald-700" />+ 标签+ </div>+ <div className="mt-1 truncate text-xs text-slate-500">{tags.length} tags</div>+ </div>+ <Button size="icon" variant="ghost" title="关闭" onClick={onClose}>+ <X className="h-4 w-4" />+ </Button>+ </header>++ <div className="min-h-0 flex-1 overflow-y-auto p-3 sm:p-4">+ {tagsQuery.isLoading ? (+ <div className="px-2 py-8 text-center text-sm text-slate-500">加载中</div>+ ) : tags.length === 0 ? (+ <div className="rounded-md border border-dashed border-slate-300 px-4 py-8 text-center text-sm text-slate-500">+ 暂无标签+ </div>+ ) : (+ <div className="space-y-2">+ {tags.map((tag) => (+ <div+ key={tag.name}+ className="flex min-h-12 items-center gap-3 rounded-md border border-emerald-100 bg-emerald-50/30 px-3 py-2"+ >+ <span className="min-w-0 flex-1">+ <span className="block truncate text-sm font-semibold text-slate-950">#{tag.name}</span>+ <span className="mt-1 block text-xs text-slate-500">+ {tag.memoCount} memos{tag.updatedAt ? ` · ${formatDateTime(tag.updatedAt)}` : ""}+ </span>+ </span>+ <Button size="icon" variant="ghost" title="重命名标签" onClick={() => handleRename(tag)}>+ <Pencil className="h-4 w-4" />+ </Button>+ <Button size="icon" variant="danger" title="删除标签" onClick={() => handleDelete(tag)}>+ <Trash2 className="h-4 w-4" />+ </Button>+ </div>+ ))}+ </div>+ )}+ </div>+ </section>+ </div>+ );+};++const DEFAULT_TOKEN_SCOPES = ["read:notebooks", "read:memos", "read:tags"];++const SettingsDialog = ({ onClose }: { onClose: () => void }) => {+ const queryClient = useQueryClient();+ const [name, setName] = useState("Local Agent");+ const [selectedScopes, setSelectedScopes] = useState<Set<string>>(() => new Set(DEFAULT_TOKEN_SCOPES));+ const [createdToken, setCreatedToken] = useState<{ token: string; apiToken: ApiToken } | null>(null);+ const tokensQuery = useQuery({+ queryKey: ["api-tokens"],+ queryFn: () => api.listApiTokens(),+ });+ const availableScopes = tokensQuery.data?.availableScopes ?? [+ "read:notebooks",+ "write:notebooks",+ "read:memos",+ "write:memos",+ "read:resources",+ "write:resources",+ "read:tags",+ "write:tags",+ ];+ const createMutation = useMutation({+ mutationFn: api.createApiToken,+ onSuccess: async (data) => {+ setCreatedToken(data);+ setName("");+ setSelectedScopes(new Set(DEFAULT_TOKEN_SCOPES));+ await queryClient.invalidateQueries({ queryKey: ["api-tokens"] });+ },+ });+ const revokeMutation = useMutation({+ mutationFn: api.revokeApiToken,+ onSuccess: async () => {+ await queryClient.invalidateQueries({ queryKey: ["api-tokens"] });+ },+ });+ const tokens = tokensQuery.data?.apiTokens ?? [];++ const toggleScope = (scope: string) => {+ setSelectedScopes((current) => {+ const next = new Set(current);++ if (next.has(scope)) {+ next.delete(scope);+ } else {+ next.add(scope);+ }++ return next;+ });+ };++ const handleSubmit = (event: FormEvent<HTMLFormElement>) => {+ event.preventDefault();+ const scopes = Array.from(selectedScopes);++ if (!name.trim() || scopes.length === 0) {+ return;+ }++ createMutation.mutate({ name: name.trim(), scopes });+ };++ return (+ <div className="fixed inset-0 z-50 flex items-end bg-slate-950/35 p-0 sm:items-center sm:justify-center sm:p-6">+ <section className="flex max-h-[92dvh] w-full flex-col rounded-t-md bg-white shadow-panel sm:max-w-[820px] sm:rounded-md">+ <header className="flex shrink-0 items-center justify-between gap-3 border-b border-emerald-100 px-4 py-3 sm:px-5">+ <div className="min-w-0">+ <div className="flex items-center gap-2 text-base font-semibold text-slate-950">+ <KeyRound className="h-4 w-4 text-emerald-700" />+ 设置+ </div>+ <div className="mt-1 truncate text-xs text-slate-500">API Token / MCP / CLI</div>+ </div>+ <Button size="icon" variant="ghost" title="关闭" onClick={onClose}>+ <X className="h-4 w-4" />+ </Button>+ </header>++ <div className="min-h-0 flex-1 overflow-y-auto p-4 sm:p-5">+ {createdToken ? (+ <div className="mb-4 rounded-md border border-emerald-200 bg-emerald-50 px-3 py-3">+ <div className="mb-2 flex items-center gap-2 text-sm font-semibold text-emerald-950">+ <ShieldCheck className="h-4 w-4" />+ Token 已生成+ </div>+ <div className="flex gap-2">+ <input+ className="h-9 min-w-0 flex-1 rounded-md border border-emerald-200 bg-white px-3 font-mono text-xs text-slate-900 outline-none"+ readOnly+ value={createdToken.token}+ />+ <Button+ size="sm"+ variant="solid"+ type="button"+ onClick={() => void navigator.clipboard?.writeText(createdToken.token)}+ >+ 复制+ </Button>+ </div>+ <div className="mt-2 text-xs text-emerald-800">明文 Token 只显示这一次。</div>+ </div>+ ) : null}++ <form className="mb-5 rounded-md border border-emerald-100 bg-emerald-50/30 p-3" onSubmit={handleSubmit}>+ <div className="mb-3 flex flex-col gap-2 sm:flex-row">+ <input+ className="h-9 min-w-0 flex-1 rounded-md border border-emerald-100 bg-white px-3 text-sm outline-none focus:border-emerald-300"+ value={name}+ onChange={(event) => setName(event.target.value)}+ placeholder="Token 名称"+ />+ <Button size="md" variant="solid" type="submit" disabled={createMutation.isPending}>+ <KeyRound className="h-4 w-4" />+ 生成 Token+ </Button>+ </div>+ <div className="grid gap-2 sm:grid-cols-2">+ {availableScopes.map((scope) => (+ <label+ key={scope}+ className="flex min-h-9 items-center gap-2 rounded-md border border-emerald-100 bg-white px-2 text-sm text-slate-700"+ >+ <input+ type="checkbox"+ checked={selectedScopes.has(scope)}+ onChange={() => toggleScope(scope)}+ className="h-4 w-4 shrink-0 rounded border-emerald-300 text-emerald-600"+ />+ <span className="min-w-0 truncate font-mono text-xs">{scope}</span>+ </label>+ ))}+ </div>+ </form>++ <div className="space-y-2">+ {tokensQuery.isLoading ? (+ <div className="px-2 py-8 text-center text-sm text-slate-500">加载中</div>+ ) : tokens.length === 0 ? (+ <div className="rounded-md border border-dashed border-slate-300 px-4 py-8 text-center text-sm text-slate-500">+ 暂无 API Token+ </div>+ ) : (+ tokens.map((token) => (+ <div+ key={token.id}+ className={cn(+ "flex min-h-16 items-center gap-3 rounded-md border px-3 py-2",+ token.isRevoked ? "border-slate-200 bg-slate-50 opacity-70" : "border-emerald-100 bg-white"+ )}+ >+ <span className="min-w-0 flex-1">+ <span className="block truncate text-sm font-semibold text-slate-950">{token.name}</span>+ <span className="mt-1 block truncate text-xs text-slate-500">+ {token.scopes.join(", ") || "no scopes"}+ </span>+ <span className="mt-1 block text-xs text-slate-400">+ {token.lastUsedAt ? `Last used ${formatDateTime(token.lastUsedAt)}` : "Never used"}+ </span>+ </span>+ <Button+ size="sm"+ variant="danger"+ disabled={token.isRevoked || revokeMutation.isPending}+ onClick={() => {+ if (window.confirm(`撤销 Token「${token.name}」?`)) {+ revokeMutation.mutate(token.id);+ }+ }}+ >+ 撤销+ </Button>+ </div>+ ))+ )}+ </div>+ </div>+ </section>+ </div>+ );+};+const formatBytes = (bytes: number) => {if (!Number.isFinite(bytes) || bytes <= 0) {return "0 B";diff --git a/apps/web/src/lib/api.ts b/apps/web/src/lib/api.tsindex 07b5f14a..c4af6638 100644--- a/apps/web/src/lib/api.ts+++ b/apps/web/src/lib/api.ts@@ -1,5 +1,7 @@import type {AuthSession,+ ApiToken,+ CreatedApiToken,MemoDetail,MemoRevision,MemoSummary,@@ -7,6 +9,7 @@ import type {Resource,ResourceListItem,ResourceStorageSummary,+ TagSummary,TiptapDoc,} from "@edgeever/shared";@@ -27,6 +30,15 @@ type ListResourcesResponse = {summary: ResourceStorageSummary;};+type ListTagsResponse = {+ tags: TagSummary[];+};++type ListApiTokensResponse = {+ apiTokens: ApiToken[];+ availableScopes: string[];+};+type MemoResponse = {memo: MemoDetail;};@@ -105,6 +117,43 @@ export const api = {body: JSON.stringify(payload),}),+ updateNotebook: (notebookId: string, payload: { name?: string; parentId?: string | null; sortOrder?: number }) =>+ request<NotebookResponse>(`/api/v1/notebooks/${notebookId}`, {+ method: "PATCH",+ body: JSON.stringify(payload),+ }),++ deleteNotebook: (notebookId: string) =>+ request<{ ok: true }>(`/api/v1/notebooks/${notebookId}`, {+ method: "DELETE",+ }),++ listTags: () => request<ListTagsResponse>("/api/v1/tags"),++ renameTag: (tag: string, name: string) =>+ request<{ ok: true; updated: number }>(`/api/v1/tags/${encodeURIComponent(tag)}`, {+ method: "PATCH",+ body: JSON.stringify({ name }),+ }),++ deleteTag: (tag: string) =>+ request<{ ok: true; updated: number }>(`/api/v1/tags/${encodeURIComponent(tag)}`, {+ method: "DELETE",+ }),++ listApiTokens: () => request<ListApiTokensResponse>("/api/v1/api-tokens"),++ createApiToken: (payload: { name: string; scopes: string[]; expiresAt?: string | null }) =>+ request<CreatedApiToken>("/api/v1/api-tokens", {+ method: "POST",+ body: JSON.stringify(payload),+ }),++ revokeApiToken: (tokenId: string) =>+ request<{ ok: true }>(`/api/v1/api-tokens/${tokenId}`, {+ method: "DELETE",+ }),+listMemos: (params: { notebookId?: string | null; q?: string; trash?: boolean }) => {const search = new URLSearchParams();diff --git a/package.json b/package.jsonindex 467005c7..15822d57 100644--- a/package.json+++ b/package.json@@ -18,6 +18,7 @@"db:migrate:local": "bun scripts/run-wrangler.mjs d1 migrations apply DB --local","db:migrate:remote": "bun scripts/run-wrangler.mjs d1 migrations apply DB --remote","auth:hash": "bun scripts/hash-password.mjs",+ "cli": "bun scripts/edgeever.mjs","deploy": "bun run build && bun run db:migrate:remote && bun scripts/run-wrangler.mjs deploy","deploy:tianma": "EDGE_EVER_INSTANCE=tianma bun run deploy","deploy:demo": "EDGE_EVER_INSTANCE=demo bun run deploy",diff --git a/packages/shared/src/schemas.ts b/packages/shared/src/schemas.tsindex be432be3..d6cf2ac4 100644--- a/packages/shared/src/schemas.ts+++ b/packages/shared/src/schemas.ts@@ -38,9 +38,21 @@ export const LoginSchema = z.object({password: z.string().min(1).max(512),});+export const ApiTokenCreateSchema = z.object({+ name: z.string().trim().min(1).max(80),+ scopes: z.array(z.string().trim().min(1).max(80)).min(1).max(32),+ expiresAt: z.string().datetime().nullable().optional(),+});++export const TagRenameSchema = z.object({+ name: z.string().trim().min(1).max(80),+});+export type NotebookCreateInput = z.infer<typeof NotebookCreateSchema>;export type NotebookUpdateInput = z.infer<typeof NotebookUpdateSchema>;export type MemoCreateInput = z.infer<typeof MemoCreateSchema>;export type MemoUpdateInput = z.infer<typeof MemoUpdateSchema>;export type MergeMemosInput = z.infer<typeof MergeMemosSchema>;export type LoginInput = z.infer<typeof LoginSchema>;+export type ApiTokenCreateInput = z.infer<typeof ApiTokenCreateSchema>;+export type TagRenameInput = z.infer<typeof TagRenameSchema>;diff --git a/packages/shared/src/types.ts b/packages/shared/src/types.tsindex 58e2973c..d0a26f66 100644--- a/packages/shared/src/types.ts+++ b/packages/shared/src/types.ts@@ -80,6 +80,27 @@ export type ResourceStorageSummary = {attachmentCount: number;};+export type ApiToken = {+ id: string;+ name: string;+ scopes: string[];+ lastUsedAt: string | null;+ expiresAt: string | null;+ isRevoked: boolean;+ createdAt: string;+};++export type CreatedApiToken = {+ token: string;+ apiToken: ApiToken;+};++export type TagSummary = {+ name: string;+ memoCount: number;+ updatedAt: string | null;+};+export type AuthUser = {id: string;username: string;diff --git a/scripts/edgeever.mjs b/scripts/edgeever.mjsnew file mode 100644index 00000000..a9d66b65--- /dev/null+++ b/scripts/edgeever.mjs@@ -0,0 +1,172 @@+#!/usr/bin/env bun++import { readFile } from "node:fs/promises";++const baseUrl = (process.env.EDGEEVER_URL || "http://127.0.0.1:8787").replace(/\/+$/, "");+const token = process.env.EDGEEVER_TOKEN;+const [, , command, ...argv] = process.argv;++const usage = `EdgeEver CLI++Usage:+ EDGEEVER_TOKEN=... bun run cli -- notebooks+ EDGEEVER_TOKEN=... bun run cli -- tags+ EDGEEVER_TOKEN=... bun run cli -- search <query>+ EDGEEVER_TOKEN=... bun run cli -- get <memoId>+ EDGEEVER_TOKEN=... bun run cli -- create --notebook <id> [--title <title>] [--body <markdown> | --body-file <path>] [--tags a,b]+ EDGEEVER_TOKEN=... bun run cli -- update <memoId> [--title <title>] [--body <markdown> | --body-file <path>] [--tags a,b] [--notebook <id>]+`;++if (!command || command === "help" || command === "--help" || command === "-h") {+ console.log(usage);+ process.exit(0);+}++if (!token) {+ console.error("EDGEEVER_TOKEN is required.");+ process.exit(1);+}++const main = async () => {+ switch (command) {+ case "notebooks":+ return printJson(await request("/api/v1/notebooks"));+ case "tags":+ return printJson(await request("/api/v1/tags"));+ case "search": {+ const query = argv.join(" ").trim();+ const params = new URLSearchParams();++ if (query) {+ params.set("q", query);+ }++ return printJson(await request(`/api/v1/memos?${params.toString()}`));+ }+ case "get": {+ const memoId = argv[0];+ requireValue(memoId, "memoId");+ return printJson(await request(`/api/v1/memos/${encodeURIComponent(memoId)}`));+ }+ case "create": {+ const options = parseOptions(argv);+ const notebookId = requireValue(options.notebook, "--notebook");+ const body = await readBodyOption(options);+ return printJson(+ await request("/api/v1/memos", {+ method: "POST",+ body: {+ notebookId,+ title: options.title,+ contentMarkdown: body,+ tags: parseTags(options.tags),+ },+ })+ );+ }+ case "update": {+ const memoId = argv[0];+ requireValue(memoId, "memoId");+ const options = parseOptions(argv.slice(1));+ const body = options.body || options["body-file"] ? await readBodyOption(options) : undefined;+ const payload = removeUndefined({+ title: options.title,+ notebookId: options.notebook,+ contentMarkdown: body,+ tags: options.tags === undefined ? undefined : parseTags(options.tags),+ });++ return printJson(+ await request(`/api/v1/memos/${encodeURIComponent(memoId)}`, {+ method: "PATCH",+ body: payload,+ })+ );+ }+ default:+ console.error(`Unknown command: ${command}\n`);+ console.error(usage);+ process.exit(1);+ }+};++const request = async (path, init = {}) => {+ const response = await fetch(`${baseUrl}${path}`, {+ method: init.method || "GET",+ headers: {+ Authorization: `Bearer ${token}`,+ "Content-Type": "application/json",+ },+ body: init.body === undefined ? undefined : JSON.stringify(init.body),+ });++ const body = await response.json().catch(() => null);++ if (!response.ok) {+ const message = body?.error?.message || response.statusText;+ throw new Error(`${response.status} ${message}`);+ }++ return body;+};++const parseOptions = (args) => {+ const options = {};++ for (let index = 0; index < args.length; index += 1) {+ const arg = args[index];++ if (!arg.startsWith("--")) {+ continue;+ }++ const key = arg.slice(2);+ const next = args[index + 1];++ if (!next || next.startsWith("--")) {+ options[key] = "true";+ continue;+ }++ options[key] = next;+ index += 1;+ }++ return options;+};++const readBodyOption = async (options) => {+ if (options["body-file"]) {+ return readFile(options["body-file"], "utf8");+ }++ return options.body || "";+};++const parseTags = (value) =>+ value+ ? value+ .split(/[,,\s]+/)+ .map((tag) => tag.trim().replace(/^#/, ""))+ .filter(Boolean)+ : [];++const removeUndefined = (value) =>+ Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined));++const requireValue = (value, name) => {+ if (!value) {+ throw new Error(`${name} is required.`);+ }++ return value;+};++const printJson = (value) => {+ console.log(JSON.stringify(value, null, 2));+};++main().catch((error) => {+ console.error(error instanceof Error ? error.message : error);+ process.exit(1);+});