k2md — knowledge2md 短名入口
这是 knowledge2md 的 alias skill。实际脚本、下载逻辑、清洗规则都维护在 ../knowledge2md/,避免两份实现漂移。
用法
k2md "<url>"
等价于:
python3 ~/.agents/skills/knowledge2md/scripts/knowledge2md.py "<url>"
不归档视频:
k2md "<url>" --skip-videos
低干扰浏览器提取模式:
k2md "<url>" --mode browser --cdp-url http://127.0.0.1:9222
等价于:
python3 ~/.agents/skills/knowledge2md/scripts/knowledge2md.py "<url>" --mode browser --cdp-url http://127.0.0.1:9222
--mode browser 只读取当前浏览器中用户正常可见、已渲染的飞书 docx/wiki 页面内容;图片通过已渲染 DOM 元素截图落到 assets/,失败时写占位符。该模式不调用 lark-cli,不调用 docs/wiki/media 下载接口,并生成 extraction_meta.json 说明提取方式、图片数量、占位符和 warnings。
Agent 操作要求
当用户说 k2md、"把这篇转成 md"、"保存到知识库" 时:
- 先读取并遵循
../knowledge2md/SKILL.md。 - 使用
../knowledge2md/scripts/knowledge2md.py执行转换。 用户明确说“不需要视频”时传--skip-videos,保留正文提示但不下载视频文件。 - 如果用户要求 browser mode / 当前浏览器页面提取,使用
--mode browser,遵守只处理当前可见内容、不绕过访问控制、不主动下载隐藏媒体资源的边界。 - 公众号、新闻稿、社区原文和飞书原始材料默认先保留原文离线版;用户需要整理或解读时,在同目录另建解读版并回链原文。若输入本身已是持续维护的技术解读、论文笔记或论文合集,可在用户要求深化时直接增强原解读,但必须保留来源、版本和证据链。
- 含公式的技术报告/论文解读,必须在解读版标题之后、正文之前放置「符号速查表」,列出全文涉及的数学符号、希腊字母、上下标和算子,每项给出读法(拼音/英文音译)和含义。详见
knowledge2md技能"二次解读的语言与术语规范"第5条。纯无公式的科普/新闻类解读不强制要求。 - 按
knowledge2md的“唯一正文落点”规则分开飞书原文、通用解读和项目事实;双重属性用 README 回链,不复制正文。研究、方法或技术新闻类内容使用“时间 - 方法/框架/主题 - 一个主要提出者或研究组织 - 在什么领域完成什么事”的外层目录名,时间置于最前并使用无连字符紧凑格式:YYMMDD、YYMM或YY。机构或创建者只写最知名者;无法判断时写新闻中第一个出现者。只重命名外层目录,不修改目录内原文文件名、H1或正文内容;不适用字段可省略,日期精度不得猜测。 - 校验本地素材、解读到原文的回链、移动/重命名后的相对链接和残留远程引用。
- 如果修改了
knowledge2md实现,同步三处副本并提交到 GitHub:安装版~/.agents/skills/(源)、Claude 版~/.claude/skills/(rsync,排除.cookie)、仓库镜像~/Desktop/dev-knowledge-base/_skills/(commit + push)。