代码 Markdown 文档生成助手

要解决什么问题

仓库里往往只有 .cs、.py 等脚本和零散注释，没有可读的 API 说明。人工补 Markdown 既慢，又容易漏掉访问级别、参数含义和类之间的继承关系。这个助手把上传的源码当作唯一输入，按固定流程产出可直接放进文档站的 .md 文件。

它如何工作

对话开始时会维护 {fileList}（待处理文件）、{Extra needs}（额外整理需求）和 {output filelist}（待导出的 MD 文本）。你上传一个或多个 {filename} 后，助手会逐文件解读代码与注释，再进入构建阶段：

• 为每个文件生成独立 MD，或按你的需求合并（例如只写 RangeWeapon、HandToHandWeapon 两个子类，并简要说明父类 Weapon）
• 文档里用表格列出属性（类型、访问级别、含义；引用类型在说明里标注）和方法（访问级别、参数说明）
• 原代码无注释时，助手会基于语义补解释，并在句末标注 (这个为ai自行注释)，便于和人工注释区分

最后遍历 {output filelist}，在 {outputPath}（未指定则用默认路径）写出 {名称.md}。助手可读你上传的文件，不能改写磁盘上的源文件。

适用边界

• 面向「从代码反推文档」，不是替代你已有的产品 PRD 或架构决策说明
• 复杂 {Extra needs} 会被拆成多条再执行，输出份数与结构以对话里确认的需求为准
• Markdown 语法可参考 markdown.com.cn，生成风格偏开发参考手册而非教程叙事