Render Markdown lists and edit note contents and tags in place
wiki CI and deployment / verify-and-deploy (push) Successful in 22m1s

This commit is contained in:
2026-10-26 14:26:34 +08:00
parent 9a183aeeea
commit b0a60ea498
18 changed files with 1169 additions and 24 deletions
+28
View File
@@ -0,0 +1,28 @@
# 笔记详情编辑与 Markdown 修复
本阶段修复列表显示,详情底栏改为复制网页链接、复制纯文本链接、编辑。编辑支持标题、描述、Markdown 正文和 #标签;保存后同步预览和 AI 纯文本。代码中的 Wiki 文档同样可编辑,保存内容存入数据库,媒体与唯一地址保留。
## 逐文件说明
- `apps/wiki/package.json`:固定引入 react-markdown、remark-gfm,并将新的渲染测试加入测试命令。
- `apps/wiki/pnpm-lock.yaml`:锁定 Markdown 渲染依赖及传递依赖,支持 CI 冻结安装。
- `apps/wiki/db/005_note_editing.sql`:新增代码文档编辑记录与标签关联表,为数据库笔记新增手动编辑标记,保证内容可持久保存。
- `apps/wiki/src/components/NoteMarkdown.tsx`:新增标准 Markdown 渲染,支持嵌套列表、编号、任务清单、表格、代码块;保留轻量链接样式,图片引用显示为链接,不执行原始 HTML。
- `apps/wiki/src/components/NoteEditor.tsx`:新增详情内编辑表单,支持读取最新内容、修改标题/描述/正文、#标签、预览、取消、保存与失败提示。
- `apps/wiki/src/components/ExploreDetail.tsx`:接入标准渲染和编辑表单;移除原文件入口,提供两种复制链接;调整编辑中的方向键、焦点循环和遮罩交互。
- `apps/wiki/src/components/TagInput.tsx`:通知父表单标签创建状态,避免标签请求尚未结束就保存笔记。
- `apps/wiki/src/lib/note-edits.ts`:新增读取代码文档修改、内容版本校验和事务保存;共享文本采用新资源引用,不改动其他笔记使用的文本。
- `apps/wiki/src/lib/explore.ts`:详情与列表合并已保存的代码文档修改,提供可编辑正文和版本标识,保留自动生成的媒体资源链接。
- `apps/wiki/src/lib/library.ts`:支持在同一事务连接中读取笔记和标签;保留清空正文后仍存在的文字笔记。
- `apps/wiki/src/lib/publish-learning-series.ts`:后续部署发布内容时保留用户手动编辑过的笔记,避免覆盖正文和标签。
- `apps/wiki/src/pages/api/notes/[id].ts`:新增读取、保存笔记接口,校验来源、字段长度和并发版本;旧版本写入返回 409。
- `apps/wiki/src/pages/api/wiki-index.ts`:AI 索引采用编辑后的标题。
- `apps/wiki/src/pages/explore/[id].tsx`:详情背景使用最新预览,网页与纯文本读取同一份已保存内容。
- `apps/wiki/src/styles/globals.css`:恢复列表标记、缩进和嵌套层级,增加表格、引用、代码、编辑表单和预览样式。
- `apps/wiki/tests/note-markdown.test.tsx`:新增列表、编号、任务清单、表格、代码、链接与 HTML 安全渲染测试。
- `apps/wiki/tests/integration.test.ts`:新增代码文档与媒体笔记保存、#标签关联、并发冲突、共享文本保护、手动内容发布保护及两个复制入口的验证。
- `docs/note-editor-stage.md`:本阶段逐文件说明与验证记录。
## 验证
本地 TypeScript 检查及 22 项单元测试通过;完整构建、数据库迁移、在线编辑与媒体保留测试由 Wiki CI 执行。仅 Wiki 项目及其依赖发生变化,Studio、Python 不需要重建。