0 Fork 0

Files

T

qing 1e34348d6c docs: 整理文档模块——归位散落文件、修复双扩展名、补全 INDEX 索引

- 移动 docs/ 根目录散落文件到 reports/（auth_service_plan、aibox_file_network_cli_refactor、blackbird_promo_full）
- 修复 blackbird_research_report.md.md 双扩展名 → blackbird_research_report.md
- INDEX.md 补全缺失条目：dnfs2/fsys/libsqlite3/libth 安全审计，blackbird_research_report、aibox_open_dev_plan 等报告，dnfs2/fsys/libmsg/libtry README
- 更新目录树结构（security 25 篇、reviews 3 篇、reports 8 篇）
- 修正模块描述（BotOps、lci 说明更准确）
- 收录此前未跟踪的 actpred_CODE_AUDIT_20260808.md

2026-08-08 15:55:21 +00:00

9.1 KiB

Raw Blame History

micro_servers 文档索引

所有项目文档的统一入口。

目录结构

docs/
├── INDEX.md                              # 本文件（文档总索引）
├── security/                             # 安全审计与加固（25 篇）
├── reviews/                              # 代码审查日志（3 篇）
└── reports/                              # 分析报告与开发规划（8 篇）

一、项目总览

文档	路径	说明
项目 README	../README.md	架构总览、服务说明、安装运行指南

二、安全文档 (`security/`)

全局审计与加固

文档	说明
DEPLOY_SECURITY_AUDIT_20260801.md	部署配置安全审计（docker-compose、systemd、防火墙、TLS 等）
DEPS_SECURITY_AUDIT_20260801.md	依赖安全审计（第三方库版本、已知漏洞、许可证）
SECURITY_HARDENING_PLAN_20260803.md	安全加固计划（内网通信安全加固开发计划）

各模块安全审计报告

模块	文档	审计范围
waf	waf_SECURITY_AUDIT_20260801.md	Go WAF 网关（TLS、coraza、反向代理）
gateway	gateway_SECURITY_AUDIT_20260801.md	C++20 应用网关（鉴权、Token、反向代理）初版
gateway	gateway_SECURITY_AUDIT_20260807.md	C++20 应用网关复审版（P0全部修复，进程退出bug修复）
core	core_SECURITY_AUDIT_20260801.md	C++20 进程托管服务（PMC/Nidus）
db	db_SECURITY_AUDIT_20260801.md	Python 数据库服务（pymsg、SQLAlchemy、日志收集）
db2	db2_SECURITY_AUDIT_20260806.md	C++20 数据库 RPC 服务（db 的 C++ 重实现，SQLite C API）
pymsg	pymsg_SECURITY_AUDIT_20260801.md	Python RPC 基础库（长度前缀帧、MsgClient/Server）
dnfs	dnfs_SECURITY_AUDIT_20260801.md	Python 树状菜单服务
dnfs2	dnfs2_SECURITY_AUDIT_20260808.md	C++20 树状菜单服务（dnfs 重实现）
static	static_SECURITY_AUDIT_20260801.md	Python 前端托管/文件服务
fsys	fsys_SECURITY_AUDIT_20260808.md	Python 文件系统服务
ai_review	ai_review_SECURITY_AUDIT_20260801.md	Python AI 内容审核（DeepSeek + RAG）
smtp	smtp_SECURITY_AUDIT_20260801.md	Python 邮件服务（验证码发送/校验）
captcha	captcha_SECURITY_AUDIT_20260801.md	Python 验证码服务
confs	confs_SECURITY_AUDIT_20260801.md	Python 统一配置服务
libmsg	libmsg_SECURITY_AUDIT_20260806.md	C++ RPC 基础库（pymsg 协议帧、MsgClient/Server、RpcClient/Server）
libhttp	libhttp_SECURITY_AUDIT_20260803.md	C++ HTTP/WebSocket 库（请求/响应/WS/静态文件）
libsqlite3	libsqlite3_SECURITY_AUDIT_20260806.md	C++ SQLite3 封装（Header-only）
libth	libth_SECURITY_AUDIT_20260804.md	C++ 线程库（Thread、Cv_wait、Fsm）
aibox	aibox_SECURITY_AUDIT_20260801.md	Python AI 智能体系统（WebSocket）
BotOps	BotOps_SECURITY_AUDIT_20260801.md	BotOps 运维控制面板

三、代码审查 (`reviews/`)

文档	说明
core_CODE_REVIEW_LOG_20260730.md	Core 模块代码审查日志（2026-07-30，自动化审查）
DEPLOY_DEFECT_AUDIT_20260806.md	部署缺陷审查（2026-08-06，首次原生部署实录，含修复记录）
actpred_CODE_AUDIT_20260808.md	actpred 模块代码审计（2026-08-08，PyTorch 动作预测，16 项发现）

四、分析报告与开发规划 (`reports/`)

文档	说明
blackbird_research_report.md	blackbird 项目研究报告（安全架构分析、改进建议、里程碑规划）
core_service_registry_dev_doc.md	Core 模块注册中心功能扩展开发文档（服务注册/发现/健康守护/自动重启）
auth_service_plan.md	权限系统独立化计划书（认证授权从 gateway 拆分为独立服务）
aibox_open_dev_plan.md	aibox 开放版开发计划（命令注入漏洞修复、安全沙箱方案）
aibox_file_network_cli_refactor.md	aibox 文件/网络操作命令行化重构计划
blackbird_promo_full.md	blackbird 项目完整版宣传文案
bot4cj_analysis_20260525_00.md	bot4cj 机器人模块分析报告（Markdown）
bot4cj_analysis_20260525_00.html	bot4cj 机器人模块分析报告（HTML）

五、各模块 README（保留在原目录）

各模块根目录的 README.md 保留在原位，方便 GitHub 直接浏览：

核心服务

模块	路径	说明
core	../core/README.md	进程托管服务（PMC/Nidus）
waf	../waf/README.md	WAF 网关（Go, coraza）
gateway	../gateway/README.md	应用层网关（C++20）
db	../db/README.md	通用数据库服务（pymsg）
db2	../db2/README.md	C++20 数据库 RPC 服务（db 重实现）
confs	../confs/README.md	统一配置服务
static	../static/README.md	前端托管服务
dnfs	../dnfs/README.md	树状网络文件系统
dnfs2	../dnfs2/README.md	C++20 树状菜单服务（dnfs 重实现）
ai_review	../ai_review/README.md	AI 内容审核
captcha	../captcha/README.md	验证码服务
smtp	../smtp/README.md	邮件服务
redirect80	../redirect80/README.md	HTTP 重定向服务

共享库

库	路径	说明
pymsg	../pymsg/README.md	Python RPC 基础库
libhttp	../libhttp/README.md	C++ HTTP/WebSocket 库
libcrypt	../libcrypt/README.md	C++ 加密库
libth	../libth/README.md	C++ 线程库
libsqlite3	../libsqlite3/README.md	C++ SQLite3 封装
libmsg	../libmsg/README.md	C++ RPC 基础库（pymsg 协议 C++ 实现）
libtry	../libtry/	嵌入式脚本解释器

其他模块

模块	路径	说明
aibox	../aibox/README.md	AI 智能体系统
bot4cj	../bot4cj/README.md	机器人硬件脚本解析器（仓颉）
BotOps	../BotOps/README.md	aibox 智能体 TUI 前端（Textual）
actpred	../actpred/README.md	动作预测神经网络（PyTorch）
lci	../lci/README.md	嵌入式帧缓冲图形界面
fsys	../fsys/README.md	文件系统服务
tests	../tests/blackbox/README.md	黑盒测试套件

Robot 文档 (README.robot.md)

模块	路径
pymsg	../pymsg/README.robot.md
libhttp	../libhttp/README.robot.md
libtry	../libtry/README.robot.md
aibox	../aibox/README.robot.md
bot4cj	../bot4cj/README.robot.md

六、aibox 技能与任务文档

aibox 模块的技能提示词和任务模板属于运行时数据，保留在原目录：

类型	路径
技能格式说明	../aibox/SKILLS_FORMAT.md
技能目录	../aibox/skills/
任务目录	../aibox/tasks/

9.1 KiB Raw Blame History Unescape Escape

micro_servers 文档索引

目录结构

一、项目总览

二、安全文档 (security/)

全局审计与加固

各模块安全审计报告

三、代码审查 (reviews/)

四、分析报告与开发规划 (reports/)

五、各模块 README（保留在原目录）

核心服务

共享库

其他模块

Robot 文档 (README.robot.md)

六、aibox 技能与任务文档

9.1 KiB

Raw Blame History

二、安全文档 (`security/`)

三、代码审查 (`reviews/`)

四、分析报告与开发规划 (`reports/`)