feat: 新增文档Tab(📚文档)——开源项目式文档体系(VERSIONS.md运营者版本变更+INDEX.md目录树+docs.json spec),让知微通过文档理解系统变化
This commit is contained in:
@@ -0,0 +1,51 @@
|
||||
{
|
||||
"module": "docs",
|
||||
"version": "1.0",
|
||||
"purpose": "MoFin 文档体系入口。开源项目式帮助文档:README 封面 + 完整目录 + 版本变更说明。让研发者和运营者(知微)都能通过文档了解系统全貌和最新变化。",
|
||||
|
||||
"human_help": {
|
||||
"title": "📚 文档中心 — 系统帮助与版本变更",
|
||||
"description": [
|
||||
"MoFin 文档体系采用开源项目标准组织:README 封面导航 + 完整目录树 + 大版本变更说明。",
|
||||
"研发者(小小莫/知微)通过文档理解系统各模块;运营者(知微)通过版本变更说明掌握每次大改动的内容和影响。",
|
||||
"所有文档存放在 docs/ 目录,按主题分类。"
|
||||
],
|
||||
"usage": [
|
||||
"打开 Dashboard 的「📚 文档」Tab,浏览文档目录",
|
||||
"左侧目录树选择文档,右侧查看内容",
|
||||
"「版本变更」页签查看每个大版本的改动说明(v1.0 初始架构、v2.0 JSON→DB、v3.0 策略体系、v4.0 自成长、v5.0 纯DB、v6.0 Cron 架构重构)",
|
||||
"「版本变更」让知微知道每次大改动做了什么、影响什么"
|
||||
],
|
||||
"troubleshooting": [
|
||||
"文档加载失败 → 检查 docs/ 目录权限和 md 文件存在性",
|
||||
"版本变更空白 → 检查 docs/CHANGELOG-VERSIONS.md 是否存在",
|
||||
"找不到某文档 → 查看 INDEX.md 完整目录"
|
||||
]
|
||||
},
|
||||
|
||||
"ai_spec": {
|
||||
"apis": [
|
||||
{"method": "GET", "path": "/api/docs/index", "returns": "{ok, index:[{path, title, category}]} — 文档目录树"},
|
||||
{"method": "GET", "path": "/api/docs/versions", "returns": "{ok, versions:[{version, date, title, summary}]} — 版本变更列表"},
|
||||
{"method": "GET", "path": "/api/docs/read?path=<path>", "returns": "{ok, content} — 读取指定文档内容(markdown)"}
|
||||
],
|
||||
"constraints": [
|
||||
"所有文档必须放在 docs/ 目录,不允许散落",
|
||||
"每个大版本必须写入 CHANGELOG-VERSIONS.md",
|
||||
"README.md 是入口封面,必须保持最新导航",
|
||||
"INDEX.md 是完整目录树,必须反映实际文档结构"
|
||||
],
|
||||
"dependencies": [
|
||||
"docs/ 目录(文档源)",
|
||||
"CHANGELOG-VERSIONS.md(版本变更源)",
|
||||
"INDEX.md(目录树源)"
|
||||
],
|
||||
"file_layout": {
|
||||
"docs/README.md": "文档中心封面(导航入口)",
|
||||
"docs/INDEX.md": "完整文档目录树(按主题分类)",
|
||||
"docs/CHANGELOG-VERSIONS.md": "大版本变更说明(v1.0/v2.0/.../v6.0)",
|
||||
"docs/GUIDE.md": "系统全貌指南(给研发者的详细说明)",
|
||||
"docs/<topic>/*.md": "按主题组织的文档"
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user