Kronecker/NotesAgentic
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 5 Wiki Activity

feat: 添加 OpenNexus 认证 Core 与 Stronghold 基础能力

Browse Source
This commit is contained in:
admin
2026-09-08 12:23:20 +08:00
parent f4aeeef49b
commit 4c79e940d2
59 changed files with 4242 additions and 102 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/README.md
+2 -2
View File
@@ -1,10 +1,10 @@
# NotesAgent 文档索引
# OpenNexus 文档索引
> 第二阶段收尾：标准 Agent/RAG Benchmark 与报告页、函数图预览、三格式快照导出及真实 Provider/MCP 结果见[实现与验收记录](development/第二阶段收尾实现与验收-2026-09-07.md)。当前分支尚未合并，不更改下文历史 main 基线。
本目录集中保存团队开发期间需要长期维护的架构、接口、实现、协作和问题复盘文档。文档按用途分类，避免设计约束、开发记录与故障复盘混放。
当前第三阶段分支已实现 Tauri/Rust 原生 Vault、Sync v1 和签名社区目录的可测试原型；它仍缺少 Sidecar、Stronghold、生产插件隔离、完整同步客户端和发布门禁，不能作为第三阶段发布候选。状态与证据见[第三阶段实施与验收记录](development/第三阶段实施与验收记录.md)。
当前第三阶段分支已实现 Tauri/Rust 原生 Vault、Sync v1 和签名社区目录原型，并开始接入受认证的 Sidecar 与 Stronghold。生产插件隔离、完整同步客户端和发布门禁仍未完成，不能作为发布候选。最新状态见[OpenNexus 生产化实施进度](development/OpenNexus生产化实施进度-2026-09-08.md)，历史证据见[第三阶段实施与验收记录](development/第三阶段实施与验收记录.md)。
仓库入口文档：[项目 README](../README.md)、[前端 README](../frontend/README.md)、[后端 README](../backend/README.md)。
docs/architecture/第三阶段生产化工程规划与验收目标.md
+3 -3
View File
@@ -1,6 +1,6 @@
# 第三阶段五项生产化能力：工程规划与验收目标
日期：2026-09-08。审计基线：`2010778780fa7267557a7302132e63ac533d43ab`，分支 `feat/phase3-completion`。状态：**仅规划，五项均未通过生产验收；本文不交付功能、安装包或运行证据。**
日期：2026-09-08。审计基线：`2010778780fa7267557a7302132e63ac533d43ab`，分支 `feat/phase3-completion`。初始规划提交：`2c4287e`。用户随后授权全量实施，并确定正式名称为 **OpenNexus**。状态：**实施中，五项均未通过完整生产验收**；实际证据见[实施记录](../development/OpenNexus生产化实施进度-2026-09-08.md)。
## 1. 范围、文档优先级与交付口径
@@ -8,7 +8,7 @@
“通过”要求实现、自动化报告、平台实测和恢复演练同时满足。旧记录中的测试数量不继承为本计划证据。五项完成不代表多窗口、全部社区内容能力、OCR/音频质量等第三阶段其他退出项完成。
本次仅允许文档提交。实施期间测试也只使用自动生成的临时 Vault、测试密钥和隔离服务，不读取个人笔记、凭据或生产数据库。
初始规划轮仅允许文档提交；后续实施已获用户授权。实施期间测试只使用自动生成的临时 Vault、测试密钥和隔离服务，不读取个人笔记、凭据或生产数据库。
## 2. 现状审计与差距
@@ -256,7 +256,7 @@ runner输出JUnit、逐ID JSON、耗时/峰值内存、进程树/拒绝访问计
## 14. 非目标与仍需产品确认的事项
明确非目标：本次任务功能实现；移动端、多人共享/CRDT、E2EE与跨设备秘密同步、历史GC、服务跨主机水平扩容、任意远程代码热注入、未通过平台的无沙箱例外；自动下载全部模型/CUDA；替代第三阶段其他UI/内容质量验收。通知推送可后续加入，轮询承担本次正确性与时延门禁。
明确非目标：移动端、多人共享/CRDT、E2EE与跨设备秘密同步、历史GC、服务跨主机水平扩容、任意远程代码热注入、未通过平台的无沙箱例外；自动下载全部模型/CUDA；替代第三阶段其他UI/内容质量验收。通知推送可后续加入，轮询承担本次正确性与时延门禁。
以下在P0由产品/安全/运维共同确认，当前采用表中工程默认值推进设计，不把未答复当批准：
docs/contracts/Host-v1契约.md
+4 -4
View File
@@ -8,8 +8,8 @@
| 命令 | 参数 / 返回 |
| --- | --- |
| `host_capabilities` | protocol=1，workspace/core=true；sync/credentials/extensions=false |
| `core_request` | 仅代理固定的 `http://127.0.0.1:8000/health` 与 `/api/*` JSON 请求；路径、方法和超时由 Host 限制 |
| `host_capabilities` | protocol=1，workspace/credentials=true；core 随进程状态返回；sync/extensions=false |
| `core_request` | 代理认证 Sidecar 的 `/health` 与 `/api/*`；Host 注入会话和代际，支持 JSON 与限额二进制，不接受前端鉴权头 |
| `workspace_choose` | 原生选择，取消返回 null；成功返回 vault_id/path/name |
| `workspace_open` | 只允许重开应用数据目录中已持久化授权的规范化路径 |
| `workspace_recent` | 最近 20 个用户主动选择的 Vault；只保存身份、名称和路径 |
@@ -35,6 +35,6 @@ OS 文件锁配合 Rust Mutex 维持单实例 Vault 写入。Web `serialized_vau
## 前端与发布
Web 模式沿用现有服务。Tauri Workspace Service 调用原生命令；当前预览版通过 Host 连接已在 `127.0.0.1:8000` 启动的 AI Core，连接失败时返回 CORE_UNAVAILABLE。随机端口、临时令牌和自动管理进程仍属于后续 Sidecar 交付。桌面窗口关闭系统装饰，统一由应用标题栏提供拖动、最小化、最大化/还原及关闭；窗口命令只授予本地 `main` WebView。关闭请求先尝试保存，冲突或保存失败时保持窗口。标题栏下的完整应用菜单复用 `editorCommandService`，主题菜单直接调用统一主题 Store；功能页使用 `feature-page`、`feature-header`、`panel` 等主题扩展点，确保自定义主题同时作用于编辑器与应用页面。原生菜单事件和可见“段落”菜单复用 `editor.import-note-properties`；仅在源码模式、已打开笔记且无冲突时启用，转换作为单次编辑器历史事务执行。
Web 模式沿用现有服务。Tauri Workspace Service 调用原生命令；Host 自动启动受认证的 Core，使用随机端口和管道交换会话；Core 不可用时返回稳定错误码。SSE 使用 `core_stream`/`core_stream_cancel`，凭据命令提供状态、解锁、手动锁定、改密及原生导入；细节与未完成项见[生产化实施记录](../development/OpenNexus生产化实施进度-2026-09-08.md)。桌面窗口关闭系统装饰，统一由应用标题栏提供拖动、最小化、最大化/还原及关闭；窗口命令只授予本地 `main` WebView。关闭请求先尝试保存，冲突或保存失败时保持窗口。标题栏下的完整应用菜单复用 `editorCommandService`，主题菜单直接调用统一主题 Store；功能页使用 `feature-page`、`feature-header`、`panel` 等主题扩展点，确保自定义主题同时作用于编辑器与应用页面。原生菜单事件和可见“段落”菜单复用 `editor.import-note-properties`；仅在源码模式、已打开笔记且无冲突时启用，转换作为单次编辑器历史事务执行。
`bundle.active=false`，无自动更新、无签名安装包。开发命令为前端 `pnpm dev` 与 `cargo run --features desktop`；生产 EXE 必须在 `frontend` 目录执行 `pnpm desktop:build`，由 Tauri CLI 先构建并嵌入前端资源。不要用普通 `cargo build --release` 代替该命令，否则 Rust Host 会更新但 WebView 仍可能携带旧资源。需要对应平台 C++ 工具链和 WebView；本次 Windows 已使用系统 `x86_64-pc-windows-gnu` 工具链构建，仍不替代 MSVC 或其他平台验证。
默认 `bundle.active=false`，新增 `tauri.bundle.conf.json` 配置 Core 资源及 NSIS 目标，尚无自动更新或签名安装包。release Host 前必须执行 `uv run --directory backend --group packaging python ../scripts/build-core.py` 生成并嵌入 Core 摘要清单。开发命令为前端 `pnpm dev` 与 `cargo run --features desktop`；生产 EXE 必须在 `frontend` 目录执行 `pnpm desktop:build`，由 Tauri CLI 先构建并嵌入前端资源。不要用普通 `cargo build --release` 代替该命令，否则 Rust Host 会更新但 WebView 仍可能携带旧资源。需要对应平台 C++ 工具链和 WebView；本次 Windows 已使用系统 `x86_64-pc-windows-gnu` 工具链构建，仍不替代 MSVC 或其他平台验证。
docs/development/OpenNexus生产化实施进度-2026-09-08.md
+36
View File
@@ -0,0 +1,36 @@
# OpenNexus 生产化实施进度
工作树：`G:\OSProject\NotesAgent-phase3`，分支：`feat/phase3-completion`。用户已授权实施，正式名称为 OpenNexus。保留旧应用 identifier、内部包名和数据目录约定，避免更名导致旧数据不可见。个人 Vault 的已有改动不属于本次交付。
**状态：实施中，未 done，未通过生产发布门禁。** 本文记录工程进度，不将单元测试或开发机运行替代[生产化计划](../architecture/第三阶段生产化工程规划与验收目标.md)中 A–E 的完整验收。
## 已实现的链路
- Rust 管理 Core 进程组；使用 stdin 引导、随机 loopback 端口、HMAC 握手、独立代际与会话令牌。每个请求先认证，拒绝浏览器 Origin、重复鉴权头及旧代际。Host 关闭时关闭管道并清理进程组，重启具有退避和次数上限。
- 常规 JSON/二进制及 SSE 请求经原生命令进入 Core。SSE 支持游标、跨 UTF-8 分片及取消；每次流累计不超过 64 MiB，最多 16 个并发流。二进制上传暂为 64 MiB，尚未满足原媒体页面 128 MiB 的完整能力。
- Core 可由 PyInstaller 构建为带运行时的 onedir。构建脚本生成 SHA-256 清单；release Host 编译时嵌入清单，启动前验证文件集合与摘要，拒绝链接、额外文件和篡改。新增 NSIS 资源配置，但尚未生成或验证签名安装包。
- Stronghold 采用 Argon2id 口令派生和单文件快照；解锁期间 Store 中仍保存 AEAD 密文。提供状态、解锁、手动锁定、改密和原生选择旧库导入命令，不提供 WebView 通用明文读取命令。
- Fernet 迁移先验证所有条目与冲突，备份密文和封装主密钥，持久化新库后重新打开逐条比较，最后切换所有权标记。旧文件保留，旧 Python 凭据 API 检测标记后拒绝读写。Core 凭据解析经 Host 管道，不在桌面 Core 使用环境变量凭据回退。
- 同步服务按已确认 offset 修复磁盘超前，磁盘不足时拒绝续传；对象上传与校验使用流；下载先验证完整摘要再响应。完成回执支持重复确认且不重复计费。过期上传每分钟清理，CLI 提供独立清理入口；启动入口支持共享 staging 的两个 worker。ready 检查数据库、staging 和对象存储，429 带 Retry-After。
## 已执行的检查
- 后端全量复跑 894 项测试通过，测试数据使用隔离目录。
- 前端现有 91 个文件、495 项测试通过；新增流式通道测试后，针对性 4 个文件、8 项测试通过；前端类型检查和生产构建通过。构建仍有部分既有大分块警告。
- Rust 15 项库测试、Core 清单完整性测试通过；两个真实 Python Core 集成测试通过，其中一个完整执行 HTTP 凭据写入、管道分发和 Stronghold 解析，确认响应与 Core 目录不泄露秘密。
- Rust desktop 全目标 Clippy `-D warnings` 通过；工具链为 Windows GNU 1.98.1，不能作为 MSVC 发布证据。
- 同步服务 23 项隔离 SQLite 测试通过，包含 100 次重复 complete。不是 PostgreSQL/MinIO 双 worker 压测。
## 尚未完成的工程和验收
| 范围 | 尚需完成 |
| --- | --- |
| Sidecar | AI 笔记读写接入当前 Rust Vault；完整路由 DTO 与取消提交确认；恢复诊断、更新事务；128 MiB 媒体传输；签名包、干净 VM 和 20 次冷启动 |
| 凭据 | OS 锁屏联动；备份恢复与用户确认清除旧库；迁移所有边界故障注入；按真实扩展身份绑定域许可 |
| OS 沙箱 | 平台隔离实现、Host broker、资源预算与恶意二进制验证；当前未启用无沙箱第三方进程 |
| Rust 扩展管理 | 签名验证、ZIP 安全边界、持久安装/升级/回滚事务、旧包迁移、撤回与运行时生命周期 |
| 同步客户端 | Rust push/pull、持久 cursor/inbox、附件续传、绑定隔离、冲突保留与解决 UI、默认/可选数据分类 |
| 同步生产服务 | 真 PostgreSQL/MinIO 两 worker 竞争与负载验证；部署、最小权限、备份恢复、指标与运行手册 |
| 发布 | 统一逐 ID 验收 runner；MSVC 签名安装更新包、SBOM/依赖扫描；两台独立设备 E-01–05 |
Core 的独立数据目录目前不等于已授权 Vault。Python 旧笔记写入口在 desktop 模式明确拒绝，不能据此宣称 AI 笔记工作流完成。Host `sync/extensions` 能力仍为 false。缺少实机与签名环境不构成其余普通工程尚未完成的理由。