跳转至

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 只保留正文概览。