sinan-captcha
这是 sinan-captcha 的正式项目文档源。AI 软件工厂在项目仓库内直接维护这些文档,docs-stratego 通过 Git 子模块或等价的仓级挂载方式聚合展示,但不反向改写源文档。
适用范围
- 根
docs/index.md的 front matter 是目录树、页面路径和访问级别的唯一事实源。 - Markdown 页面、OpenAPI 契约和 MCP tools 快照统一作为正式页面资产维护。
- 契约文件必须放在真实文档目录下,并与所在目录的
index.md配套。
维护规则
- 只有根
docs/index.md声明全站mkdocs.nav、页面路径和页面权限。 - 子目录
index.md只作为正文首页和资源权限锚点,不再承担导航声明职责。 - 页面、图片和附件跟随所属目录维护;资源文件放在当前目录或当前目录的
assets/下,assets/不承载 Markdown 页面或契约文件。 - 仓内链接统一使用相对路径,不写机器绝对路径。
- 新增、删除或移动 Markdown 页面或契约文件后,同步刷新根
docs/index.md的目录树;子目录index.md只保留正文概览。