@whispering233/ai-editor-server 0.0.57 → 0.0.59

package/dist/routes/practice.js

@@ -0,0 +1,209 @@
+// 作家文风练习路由（/api/v1/practice/*，2026-10 改版）——13 个端点
+//
+// 契约：`docs/api/120-api-practice.md`（13 个端点的 Req/Res 形状与语义）、
+// `docs/api/error-code.md`（`KIND_MISMATCH` 400 / `VALIDATION_ERROR` 400 / `PRACTICE_NOT_FOUND` 404）；
+// 设计与不变式见 `docs/design/60-practice.md` §2 / §5 / §6。
+//
+// 分工（**库写入唯一入口 = db 包 `queries/practice.ts`，本层不碰表**）：
+// - 请求 schema 单一来源 = shared `types/api.ts`（本层只 parse 请求；**响应 schema 是类型契约，
+//   响应不 `.parse()`**——由本层按文档逐字段拼出）；schema 全 `.strict()` ⇒ 多余字段被拒
+// - **长度上限校验落 shared schema**（db 层有意不校验）：超限 → 400 `VALIDATION_ERROR`
+// - 本层另做两件 db 层不做的校验：① `work_id` 成员校验（shared `resolveWork`）；
+//   ② 不存在 → 404 `PRACTICE_NOT_FOUND`（**文案按资源**：样本「练习样本不存在」、自由练习「自由练习不存在」）
+//
+// 前置守卫（单点函数 `requirePracticeWorkspace`，本组全部端点共用）：
+// ① `kind ≠ "practice"` → 400 `KIND_MISMATCH`（文案与服务端 `requireKind` 同源，见 middleware/kind.ts；
+//    整组中间件 `requireKind("practice")` 另挂在 index.ts，本函数是端点级同口径兜底，不改错误语义）；
+// ② `author_id` 解析不到预置作家 → 400 `VALIDATION_ERROR`「练习工作区未关联预置作家」（存量 / 坏值工作区）。
+import { Hono } from "hono";
+import { createPracticePiece, createPracticeSample, deletePracticePiece, deletePracticeSample, deleteStylePack, getPracticePiece, getPracticeSample, getStylePack, listPracticePieces, listPracticeSamples, updatePracticePieceDraft, updatePracticeSampleDraft, upsertStylePack, } from "@whispering233/ai-editor-db";
+import { resolveAuthor, resolveWork } from "@whispering233/ai-editor-shared";
+import { practiceDraftPutReqSchema, practicePieceCreateReqSchema, practiceSampleCreateReqSchema, practiceStylePackPutReqSchema, } from "@whispering233/ai-editor-shared/schemas";
+import { HttpError, ok } from "../middleware/error.js";
+import { assertWorkspaceKind } from "../middleware/kind.js";
+import { requireCurrentProject } from "../middleware/project.js";
+/** 练习路由（挂载于 /api/v1/practice，index.ts） */
+export const practiceRoutes = new Hono();
+/** 样本不存在（详情 / 保存稿件 / 删除）→ 404 `PRACTICE_NOT_FOUND` */
+function sampleNotFound() {
+    return new HttpError(404, "PRACTICE_NOT_FOUND", "练习样本不存在");
+}
+/** 自由练习篇不存在（详情 / 保存稿件 / 删除）→ 404 `PRACTICE_NOT_FOUND` */
+function pieceNotFound() {
+    return new HttpError(404, "PRACTICE_NOT_FOUND", "自由练习不存在");
+}
+/**
+ * 前置守卫（本组端点共用的**单点**）：当前工作区必须 `kind = "practice"` 且 `author_id` 能解析到
+ * 预置作家（shared `AUTHOR_CATALOG`）；无当前工作区 → 409 `NO_PROJECT_OPEN`（`requireCurrentProject`）。
+ * 返回已解析的作家条目，供素材包端点取预置风格说明（不重复解析）。
+ */
+function requirePracticeWorkspace() {
+    const project = requireCurrentProject();
+    assertWorkspaceKind(project, "practice");
+    const author = resolveAuthor(project.config.author_id);
+    if (author === null) {
+        throw new HttpError(400, "VALIDATION_ERROR", "练习工作区未关联预置作家");
+    }
+    return { project, author };
+}
+/** 请求体解析：空 body / 非法 JSON → null，统一交给 schema 报校验失败（同 names.ts 口径） */
+async function readJson(c) {
+    return c.req.json().catch(() => null);
+}
+/**
+ * 样本详情的 API 投影（详情与新建样本的响应共用同一形状）。
+ * `feedback` 只透传：写入侧唯一入口是提交点评工具，读取侧的坏 JSON 防御解析在 db 层
+ * （**非对象** → null，合法 JSON 对象一律透传）——本层不重复校验、也不做键名转换。
+ */
+function toSampleDetail(row) {
+    return {
+        id: row.id,
+        workId: row.work_id,
+        excerptLabel: row.excerpt_label,
+        text: row.text,
+        draft: row.draft,
+        feedback: row.feedback,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+/** 自由练习详情的 API 投影（详情与新建的响应共用同一形状） */
+function toPieceDetail(row) {
+    return {
+        id: row.id,
+        topic: row.topic,
+        brief: row.brief,
+        topicSource: row.topic_source,
+        draft: row.draft,
+        feedback: row.feedback,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+// ============ 范文样本（五端点） ============
+// GET /api/v1/practice/samples —— 本工作区全部样本（按 updatedAt 倒序；列表不回正文与卡体）
+practiceRoutes.get("/samples", (c) => {
+    const { project } = requirePracticeWorkspace();
+    return c.json(ok({ samples: listPracticeSamples(project.db) }));
+});
+// POST /api/v1/practice/samples —— 新建样本（粘贴或导入文本均走这里）
+practiceRoutes.post("/samples", async (c) => {
+    const { project, author } = requirePracticeWorkspace();
+    const parsed = practiceSampleCreateReqSchema.safeParse(await readJson(c));
+    if (!parsed.success)
+        throw parsed.error; // → 400 VALIDATION_ERROR（含 fields）
+    const workId = parsed.data.work_id ?? null;
+    // work_id 成员校验：给了就必须在预置作品清单内（未知 id 不静默落成「其他」——那会让用户以为选上了）
+    if (workId !== null && resolveWork(author.id, workId) === null) {
+        throw new HttpError(400, "VALIDATION_ERROR", `未知的作品 id: ${workId}（须为预置作品清单内的 id）`);
+    }
+    const row = createPracticeSample(project.db, {
+        workId,
+        excerptLabel: parsed.data.excerpt_label,
+        text: parsed.data.text,
+    });
+    return c.json(ok(toSampleDetail(row)));
+});
+// GET /api/v1/practice/samples/:id —— 样本详情（唯一返回范文全文与点评卡的读端点）
+practiceRoutes.get("/samples/:id", (c) => {
+    const { project } = requirePracticeWorkspace();
+    const row = getPracticeSample(project.db, c.req.param("id"));
+    if (row === null)
+        throw sampleNotFound();
+    return c.json(ok(toSampleDetail(row)));
+});
+// PUT /api/v1/practice/samples/:id —— 保存仿写稿（strict 单字段；唯一的用户写稿入口，后写覆盖）
+practiceRoutes.put("/samples/:id", async (c) => {
+    const { project } = requirePracticeWorkspace();
+    const parsed = practiceDraftPutReqSchema.safeParse(await readJson(c));
+    if (!parsed.success)
+        throw parsed.error;
+    const result = updatePracticeSampleDraft(project.db, c.req.param("id"), parsed.data.draft);
+    if (result === null)
+        throw sampleNotFound();
+    return c.json(ok(result));
+});
+// DELETE /api/v1/practice/samples/:id —— 删除样本（物理删）
+practiceRoutes.delete("/samples/:id", (c) => {
+    const { project } = requirePracticeWorkspace();
+    if (!deletePracticeSample(project.db, c.req.param("id")))
+        throw sampleNotFound();
+    return c.json(ok({ deleted: true }));
+});
+// ============ 作家风格说明素材包（三端点） ============
+//
+// 预置文本 = shared 常量（无端点）；这里读写的是当前工作区作者的**用户覆盖**（单行）。
+/** 生效内容 = 用户覆盖 `??` 预置（无覆盖 → 预置，恒非空） */
+function toStylePack(author, override) {
+    return {
+        authorId: author.id,
+        content: override?.content ?? author.styleNotes,
+        customized: override !== null,
+        updatedAt: override?.updated_at ?? null,
+    };
+}
+// GET /api/v1/practice/style-pack —— 生效内容 + 是否有用户覆盖
+practiceRoutes.get("/style-pack", (c) => {
+    const { project, author } = requirePracticeWorkspace();
+    return c.json(ok(toStylePack(author, getStylePack(project.db, author.id))));
+});
+// PUT /api/v1/practice/style-pack —— 写入用户覆盖（trim 非空；清空请用 DELETE）
+practiceRoutes.put("/style-pack", async (c) => {
+    const { project, author } = requirePracticeWorkspace();
+    const parsed = practiceStylePackPutReqSchema.safeParse(await readJson(c));
+    if (!parsed.success)
+        throw parsed.error;
+    return c.json(ok(toStylePack(author, upsertStylePack(project.db, author.id, parsed.data.content))));
+});
+// DELETE /api/v1/practice/style-pack —— 删除用户覆盖 = 恢复预置（幂等：无覆盖也 200）
+practiceRoutes.delete("/style-pack", (c) => {
+    const { project, author } = requirePracticeWorkspace();
+    deleteStylePack(project.db, author.id);
+    return c.json(ok(toStylePack(author, null)));
+});
+// ============ 自由练习（五端点） ============
+// GET /api/v1/practice/free —— 本工作区全部自由练习篇（按 updatedAt 倒序；列表不回稿件与卡体）
+practiceRoutes.get("/free", (c) => {
+    const { project } = requirePracticeWorkspace();
+    return c.json(ok({ pieces: listPracticePieces(project.db) }));
+});
+// POST /api/v1/practice/free —— 新建自由练习篇（自拟题，或建「待出题」空题行）
+practiceRoutes.post("/free", async (c) => {
+    const { project } = requirePracticeWorkspace();
+    const parsed = practicePieceCreateReqSchema.safeParse(await readJson(c));
+    if (!parsed.success)
+        throw parsed.error; // topic 与 topic_source 的一致性在 schema（superRefine）
+    const row = createPracticePiece(project.db, {
+        topicSource: parsed.data.topic_source,
+        topic: parsed.data.topic,
+        brief: parsed.data.brief,
+    });
+    return c.json(ok(toPieceDetail(row)));
+});
+// GET /api/v1/practice/free/:id —— 自由练习详情（唯一返回稿件全文与点评卡的读端点）
+practiceRoutes.get("/free/:id", (c) => {
+    const { project } = requirePracticeWorkspace();
+    const row = getPracticePiece(project.db, c.req.param("id"));
+    if (row === null)
+        throw pieceNotFound();
+    return c.json(ok(toPieceDetail(row)));
+});
+// PUT /api/v1/practice/free/:id —— 保存自由练习稿（与仿写稿同一口径：strict 单字段、允许空串、后写覆盖）
+practiceRoutes.put("/free/:id", async (c) => {
+    const { project } = requirePracticeWorkspace();
+    const parsed = practiceDraftPutReqSchema.safeParse(await readJson(c));
+    if (!parsed.success)
+        throw parsed.error;
+    const result = updatePracticePieceDraft(project.db, c.req.param("id"), parsed.data.draft);
+    if (result === null)
+        throw pieceNotFound();
+    return c.json(ok(result));
+});
+// DELETE /api/v1/practice/free/:id —— 删除自由练习篇（物理删；不满意的 AI 出题 = 删掉重建）
+practiceRoutes.delete("/free/:id", (c) => {
+    const { project } = requirePracticeWorkspace();
+    if (!deletePracticePiece(project.db, c.req.param("id")))
+        throw pieceNotFound();
+    return c.json(ok({ deleted: true }));
+});
+//# sourceMappingURL=practice.js.map

package/dist/routes/practice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"practice.js","sourceRoot":"","sources":["../../src/routes/practice.ts"],"names":[],"mappings":"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"}

package/dist/routes/project.d.ts

@@ -1,10 +1,9 @@
 import { Hono } from "hono";
+import type { WorkspaceKind } from "@whispering233/ai-editor-shared";
 /** 设置创作根（index.ts startServer 调用；测试隔离用传 null 重置） */
 export declare function setProjectRoot(root: string | null): void;
-/** 读创作根（书架模式：创作根 / `books/<书名>/`；未初始化 → null） */
+/** 读创作根（工作区模式：创作根 / `<kind 目录>/<名字>/`；未初始化 → null） */
 export declare function getProjectRoot(): string | null;
-/** books/ 子目录名（书架模式：创作根/books/<书名>/） */
-export declare const BOOKS_DIR_NAME = "books";
 /**
  * 规范化并校验项目路径（create/open 通用）：
  *
@@ -33,17 +32,25 @@ export declare const projectRoutes: Hono<import("hono/types").BlankEnv, import("
  */
 export declare function isBookNameValid(name: string): boolean;
 /**
- * 按 project_id 在书架 books/ 下定位书目录（唯一 key = project_id）：
- * 遍历 books/ 下各书目录的 project.json 读 id 比对；无匹配返回 null。
+ * 按 project_id 在创作根下定位工作区目录（唯一 key = project_id）：
+ * 遍历**各工作区目录**（`WORKSPACE_KINDS` 全量，不只 books/——练习工作区同在书架列表里）
+ * 下各子目录的 project.json 读 id 比对；无匹配返回 null。
+ * 命中时一并返回**目录位置推出的 kind**（命中路径就是该 kind 目录的直接子目录）——
+ * 覆盖恢复的 kind 归一用它（目录是事实，不读包内 kind）。
  * 损坏的 project.json 抛错向上传播（与 list/open 语义一致：坏数据不静默吞）。
  * 导出供 `/cloud/remote-books`（`localExists`）与 `/cloud/import-book`（同 id 拒重复导入）复用。
  */
-export declare function findBookDirById(root: string, id: string): string | null;
+export declare function findBookDirById(root: string, id: string): {
+    dir: string;
+    kind: WorkspaceKind;
+} | null;
 /**
- * 新书目标目录去重（import 节）：`books/<name>/` 已存在 →
- * `books/<name> (N)/`（N 为最小正整数，从 2 起，避免与去重命名惯例冲突）；
+ * 新工作区目标目录去重（import / 云端导入节）：`<kind 目录>/<name>/` 已存在 →
+ * `<kind 目录>/<name> (N)/`（N 为最小正整数，从 2 起，避免与去重命名惯例冲突）；
  * 返回去重后的目录绝对路径。project.json 内部 name 由调用方同步为去重名
- * （「目录名 = 书名」不变式）。
+ * （「目录名 = 名字」不变式）。
+ *
+ * `kind` 取**包内 project.json** 的值（备份是权威）——目录名一律取 shared `WORKSPACE_DIRS`。
  */
-export declare function uniqueBookDir(root: string, name: string): string;
+export declare function uniqueBookDir(root: string, name: string, kind: WorkspaceKind): string;
 //# sourceMappingURL=project.d.ts.map

package/dist/routes/project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/routes/project.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,IAAI,EAAgB,MAAM,MAAM,CAAC;AAmE1C,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAExD;AAED,iDAAiD;AACjD,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAE9C;AAED,wCAAwC;AACxC,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAkBzD;AAED,yCAAyC;AACzC,eAAO,MAAM,aAAa,4EAAa,CAAC;AA8RxC;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAkBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAevE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAOhE"}
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/routes/project.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,IAAI,EAAgB,MAAM,MAAM,CAAC;AAE1C,OAAO,KAAK,EAAsC,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAuEzG,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAExD;AAED,sDAAsD;AACtD,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAE9C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAkBzD;AAED,yCAAyC;AACzC,eAAO,MAAM,aAAa,4EAAa,CAAC;AAuTxC;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAkBD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAE,GAAG,IAAI,CAiBrG;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,CAOrF"}