27 lines
1.0 KiB
Markdown
27 lines
1.0 KiB
Markdown
# DSH 中文工作台
|
||
|
||
React 19 + TypeScript + Vite；普通 CSS 响应式布局，没有运行时演示数据。
|
||
|
||
## 开发与验证
|
||
|
||
使用 Node.js 22+：
|
||
|
||
~~~bash
|
||
npm ci
|
||
npm run dev
|
||
npm test
|
||
npm run build
|
||
~~~
|
||
|
||
开发服务只监听 127.0.0.1:5173，/api 和 /dsh 代理至 127.0.0.1:8088。生产产物为 dist/，由后端同源提供；不能直接通过 file:// 使用。
|
||
|
||
## API 与安全
|
||
|
||
- 根目录 API.md 是接口契约；API 客户端集中在 src/api.ts，可注入 fetch 进行独立单元测试。
|
||
- HttpOnly Cookie 登录；CSRF token 仅留在内存，刷新通过 /api/me 重新获取。密码、token 不写入 localStorage。
|
||
- 操作失败保留错误，不模拟成功；删除、重启、构建等操作二次确认。
|
||
- 备份恢复和升级等待后端契约，当前明确显示不可用说明，不发送猜测接口。
|
||
- 单元测试里的 fetch 替身仅用于测试，不打包进生产页面。
|
||
|
||
当前后端仍在实现部分端点，页面会真实显示其 HTTP 错误。请不要把前端入口存在等同于后端能力已交付。
|