blackbird/dnfs

DNFS — 树状网络文件系统

Dendrachy Network File-System，基于父子关系（pid）组织的树状节点服务。

监听 127.0.0.1:8006，提供节点的增删改查，支持文件以 Base64 编码形式存储在节点 content 中。

架构

客户端 (static/dnfs.html)
    │
    ▼
  dnfs :8006 (Flask + Waitress)
    │
    ├──► db :8005        数据持久化（SQL-over-HTTP）
    └──► ai_review :8007 内容审核（仅 add_note 时调用）

dnfs 不再直连数据库，所有数据操作通过 HTTP 调用 db 服务（http://127.0.0.1:8005/execute）完成。新增节点前会调用 ai_review 服务（http://127.0.0.1:8007/review）进行内容审核，审核不通过则拒绝写入。

接口文档

所有接口均为 POST，Content-Type 为 application/json。

---

POST /get_notes

获取指定父节点下的子节点列表。

Request

字段	类型	必填	说明
pid	int	否	父节点 id，0 表示根节点，缺省默认 0

curl -X POST http://localhost:8006/get_notes \
  -H 'Content-Type: application/json' \
  -d '{"pid": 0}'

Response 200

直接返回节点数组：

[
  {"id": 1, "pid": 0, "title": "根节点", "content": "hello"},
  {"id": 2, "pid": 0, "title": "另一个", "content": "world"}
]

字段	类型	说明
id	int	节点唯一标识
pid	int	父节点 id
title	str	节点标题
content	str	节点内容（可能含 Base64 文件数据）

空目录返回 []。

---

POST /add_note

添加新节点。流程：校验参数 → 校验父节点存在 → AI 内容审核 → 写入数据库。

Request

字段	类型	必填	说明
pid	int	是	父节点 id，0 为根节点，非 0 时校验父节点是否存在
title	str	是	节点标题，不可为空
content	str	是	节点内容，不可为空（可含 Base64 文件数据）

curl -X POST http://localhost:8006/add_note \
  -H 'Content-Type: application/json' \
  -d '{"pid": 0, "title": "新节点", "content": "节点内容"}'

Response 200 — 成功

{"success": true}

Response 400 — 失败

场景	响应体
缺少必填字段	{"error": "Pid, title and content are required"}
父节点不存在（pid≠0）	{"error": "the new node need a parent"}
AI 内容审核不通过	{"error": "review failed"}
数据库写入失败	{"success": false}

---

POST /delete_note

删除指定节点。存在子节点时拒绝删除（保护树结构完整性）。

Request

字段	类型	必填	说明
id	int	是	要删除的节点 id

curl -X POST http://localhost:8006/delete_note \
  -H 'Content-Type: application/json' \
  -d '{"id": 1}'

Response 200 — 成功

{"success": true}

Response 400 — 失败

场景	响应体
缺少 id 字段	{"error": "Note ID is required"}
存在子节点	{"error": "this node has a child"}
数据库删除失败	{"success": false}

---

POST /update_note

更新节点的标题、内容和父节点（可用于迁移节点到其他位置）。

Request

字段	类型	必填	说明
id	int	是	要更新的节点 id
pid	int	是	新的父节点 id（迁移时改变此值）
title	str	是	新标题，不可为空
content	str	是	新内容，不可为空

curl -X POST http://localhost:8006/update_note \
  -H 'Content-Type: application/json' \
  -d '{"id": 1, "pid": 2, "title": "新标题", "content": "新内容"}'

Response 200 — 成功

{"success": true}

Response 400 — 失败

场景	响应体
缺少必填字段	{"error": "Invalid param"}
数据库更新失败	{"success": false}

---

前端

三文件架构：

templates/index.html   页面结构（Font Awesome 图标）
static/css/style.css   样式
static/js/script.js    交互逻辑

功能：节点树浏览、新增/编辑/删除节点、文件 Base64 上传与下载、节点迁移（移动到其他父节点下）。

注：首页路由 @app.route('/') 当前已注释，前端页面实际由 static 服务的 dnfs.html 承载。

依赖

flask
flask-cors
waitress
nuitka        # 可选，编译为独立二进制

运行时需要 db（:8005）和 ai_review（:8007）服务已启动。

运行

bash _set.sh   # 创建 venv + 安装依赖
bash _run.sh   # 启动服务

已知问题

• delete_note 中子节点检查逻辑有误：查询条件为 where id = note_id（查节点自身），应为 where pid = note_id（查子节点），导致任何节点都无法删除。
• review_content 返回值类型不一致：正常返回 bool，HTTPError 时返回 dict。