docs: 同步当前工程实现与验证基线
This commit is contained in:
@@ -4,6 +4,8 @@
|
||||
> 文档性质:开发需求基线,不是最终视觉规范或产品宣传文档。
|
||||
> 依据:`第一阶段分工表.md`、`AI笔记软件技术栈说明-团队版-v2.2.md`、`后端接口契约-开发版.md`。
|
||||
|
||||
> 实现状态:更新至 2026-08-30。全部已注册业务路由均已有真实页面;Markdown 写作/源码模式、Search、Chat、智能体执行轨迹、扩展管理、设置、Provider 预设、模型发现和开发阶段加密凭据输入均已落地。当前仍以 Web Mock Workspace 代替 Tauri 文件系统。
|
||||
|
||||
## 1. 第一阶段目标
|
||||
|
||||
桌面端需要形成一条可以完整演示的本地知识工作流:
|
||||
@@ -34,7 +36,7 @@
|
||||
| --- | --- |
|
||||
| 框架 | Vue 3、Composition API、TypeScript、Vite |
|
||||
| 状态管理 | Pinia,只保存跨组件或跨页面状态 |
|
||||
| UI 基础 | Reka UI / Headless Components |
|
||||
| UI 基础 | 当前为项目公共组件、CSS Design Token 与 Element Plus 图标;复杂无障碍 Headless 组件后续按需引入 Reka UI |
|
||||
| 编辑器 | Milkdown 为默认编辑模式,CodeMirror 6 为源码模式 |
|
||||
| 桌面容器 | Tauri 2;文件、密钥、Sidecar 和系统能力通过 Rust Command |
|
||||
| 本地 AI API | FastAPI;普通请求使用 HTTP JSON,流式数据使用 SSE |
|
||||
@@ -611,18 +613,22 @@ Settings 使用分区导航,不把全部配置堆在一个表单中。
|
||||
- 测试连接并显示耗时;
|
||||
- 根据 Capability 标记是否支持 Chat、Tool Calling、Vision、Streaming 等。
|
||||
|
||||
API Key 输入后立即交给 Rust Stronghold,前端仅保存 `credential_id`。页面回显只能显示“已配置/未配置”,不得回显完整密钥。
|
||||
当前 Web 联调阶段,API Key 通过 Credential API 交给 FastAPI,由 Fernet 加密保存;前端仅在提交期间持有明文,Provider 和 Store 只保留 `credential_id`。页面只能回显“已配置/未配置”,不得回显完整密钥。Tauri 集成后由 Stronghold 替换后端开发存储实现,接口边界保持不变。
|
||||
|
||||
接口:
|
||||
|
||||
```text
|
||||
GET /api/providers
|
||||
GET /api/providers/presets
|
||||
POST /api/providers
|
||||
GET /api/providers/{provider_id}
|
||||
PATCH /api/providers/{provider_id}
|
||||
DELETE /api/providers/{provider_id}
|
||||
GET /api/providers/{provider_id}/models
|
||||
POST /api/providers/test
|
||||
GET /api/credentials/{credential_id}
|
||||
PUT /api/credentials/{credential_id}
|
||||
DELETE /api/credentials/{credential_id}
|
||||
```
|
||||
|
||||
### 14.4 Index 与 Models
|
||||
|
||||
Reference in New Issue
Block a user