<p>三平台 README 必须严格遵循各自语法约束：GitHub 用 ## 标题、禁 HTML、Markdown 链接；PyPI 首行纯文本且与 description 一致、禁 emoji/表格；飞书需替换反引号代码块为「代码段」组件并支持 @ 成员。</p>
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要为同一款工具生成适配 GitHub、PyPI、飞书文档三种平台的 README，但发现 DeepSeek 输出内容要么全按 GitHub 格式写死，要么混用标题层级和链接语法，导致复制即报错或渲染异常。
明确各平台 README 的硬性约束
GitHub README 必须以 ## 开头的二级标题分段，禁用任何 HTML 标签，所有链接必须用 [文字](url) 格式；PyPI 页面不支持 GitHub 风格的 emoji 和表格，首行必须是纯文本项目名，且要求 【description 字段必须与 README 首段完全一致】；飞书文档允许嵌入卡片和 @ 成员，但会自动过滤掉反引号包裹的代码块，需改用「代码段」组件标识。
这一步跳过会导致后续所有版本无法通过平台校验——比如 PyPI 上传时因首段含 emoji 直接拒绝解析。
用 JSON 模板固化三平台字段映射
新建一个 readme-template.json 文件，填入以下结构：
{ "platform": "{target_platform}", "project_name": "{tool_name}", "brief_desc": "{one_line_summary}", "install_cmd": "pip install {tool_name}", "usage_example": "from {tool_name} import main; main()", "compatibility": ["Python 3.8+", "Linux/macOS/Windows"], "license": "MIT" }
其中 {target_platform} 是唯一需手动替换的变量，值只能是 github、pypi 或 feishu——填错会导致模板引擎误选渲染规则。
分平台生成具体版本
方法一：GitHub 版本（强依赖 Markdown 语法）
向 DeepSeek 提交提示词：“请严格按 GitHub 官方规范生成 README：首行为项目名（无#），第二行为 brief_desc 纯文本；用 ## 分隔 Installation、Usage、Compatibility、License 四个章节；Installation 章节只写 pip install 命令；Usage 章节必须包含 Python 调用示例代码块，用三个反引号包裹；Compatibility 列表每项前加 - ，不加序号。”
方法二：PyPI 版本（零容忍格式错误）
输入：“生成 PyPI 兼容的 long_description 字段内容：首行必须与 brief_desc 完全相同，不加任何标点或换行；随后空一行；接着写 Installation（仅 pip install 命令，无代码块）；再空一行；写 Usage（用普通缩进代替代码块，函数调用写成 ‘main() 函数接收 dict 参数’ 这类描述性语句）；最后写 Compatibility（用英文逗号分隔，如 ‘Python 3.8+, Linux, macOS, Windows’）。”
方法三：飞书文档版本（需激活协作能力）
第一步：先让 DeepSeek 输出带占位符的初稿：“生成飞书文档风格 README：在 Installation 步骤末尾插入「点击此处下载配置模板」超链接占位符；在 Usage 示例后加一行‘@技术负责人 审核接口参数’；Compatibility 行末加 ? 图标。”
第二步：用飞书多维表格批量替换占位符——将「点击此处下载配置模板」替换成真实飞书云文档链接，系统自动同步更新所有关联页面。
