# note-webui **Repository Path**: mpskystart/note-webui ## Basic Information - **Project Name**: note-webui - **Description**: markdown web前端项目 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-30 - **Last Updated**: 2026-10-30 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 墨记 note-webui 在线笔记的 PC 前端。前台只展示已发布内容,后台负责写作、Markdown 导入和发布。 当前接口是浏览器本地模拟,报文按 `code` / `message` / `data` 组织。后期把 `src/api/request.js` 换成真实 HTTP 即可,页面继续调用 `src/api` 里的函数。 ## 启动 ```bash cd F:\workspace\note-webui npm install npm run dev ``` 浏览器打开 `http://localhost:5173`。 本地演示账号:`admin` / `admin123`。该口令只用于本机演示,不要用于生产。 ## 功能 - 前台:分类筛选、搜索、笔记详情。富文本按 HTML 展示,Markdown 渲染后展示。 - 后台:新建、编辑、保存草稿、发布、撤回、删除。 - 编辑方式:富文本工具栏,或 Markdown 分栏预览。 - 一键导入:笔记管理里选择 `.md`、`.markdown`、`.txt`,生成草稿。只导入一篇时会打开编辑页。编辑页也可以把文件导入当前正文。 - 示例文件:后台「下载示例文件」,或直接访问 `/sample-note.md`。 - 「恢复示例数据」会覆盖当前浏览器里的笔记。 ## 目录 ```text src/api 页面调用的接口,request.js 是以后替换真实请求的位置 src/api/mock 本地模拟与示例数据 src/views/portal 前台 src/views/admin 后台 src/components 编辑器和展示组件 ``` ## 后期对接 笔记 id 使用字符串。时间为 ISO-8601,例如 `2026-10-18T08:30:00.000Z`。列表为空时返回 `[]`。 | 方法 | 路径 | 说明 | | --- | --- | --- | | POST | /api/auth/login | 登录 | | POST | /api/auth/logout | 退出 | | GET | /api/portal/categories | 前台分类 | | GET | /api/portal/notes | 已发布笔记 | | GET | /api/portal/notes/:id | 详情,阅读数加一 | | GET | /api/admin/notes | 后台列表 | | POST | /api/admin/notes | 新建 | | PUT | /api/admin/notes/:id | 更新 | | DELETE | /api/admin/notes/:id | 删除 | | POST | /api/admin/notes/:id/publish | 发布 | | POST | /api/admin/notes/:id/unpublish | 撤回 | | POST | /api/admin/notes/import | 导入 Markdown | | GET | /api/admin/categories | 分类列表 | | POST | /api/admin/categories | 新增分类 | | PUT | /api/admin/categories/:id | 修改分类 | | DELETE | /api/admin/categories/:id | 删除分类 |