即墨开展平台业务培训 推进教师管理数字化
2026-06-15
2026-06-18 0

v3.1.2 带来了 /docs-check 自动检测和迁移旧文档结构,但有个问题一直被忽略:项目里的图片文件全是盲区。
icon.svg、logo.png、设计稿、架构图、测试截图……这些图片散落在项目各处,/docs-check 只扫 .md 文件,图片全部被跳过。更离谱的是,icon.svg 和 favicon.ico 被一视同仁地排除——可 icon 是设计资产啊!
v3.2.0 来解决这个问题。
复制代码️ 图片归类支持 │ icon/logo 归 design/ │ ️ 关键词规则升级
代码变更:+231 行 / -53 行,5 个文件

之前只扫 .md,现在扫描范围扩展到:
复制代码# 文档
**/*.md# 图片(新增!)
**/*.png
**/*.jpg
**/*.jpeg
**/*.gif
**/*.webp
**/*.svg
归类示例:
复制代码mapping = {
# 文档
"README.md": "other/",
"docs/PRD.md": "requirements/",
"docs/architecture.md": "technical/", # 图片(新增!)
"docs/architecture-diagram.png": "technical/",
"docs/ui-mockup.png": "design/",
"docs/figma-export.jpg": "design/",
"docs/test-screenshot.png": "testing/",
"docs/flowchart.svg": "design/",
"icon.svg": "design/", # UI 图标归 design/
"logo.svg": "design/", # 项目 logo 归 design/
}

旧版行为: icon.svg 和 favicon.ico 一样被排除
新版行为: 只有 favicon.* 被排除,icon.* / logo.* 归类到 design/
| 文件 | 旧版 | v3.2.0 |
|---|---|---|
favicon.ico | 排除(工程资源) | 排除(工程资源) |
favicon.png | 排除 | 排除 |
icon.svg | 排除 | → design/ |
logo.svg | 排除 | → design/ |
icon-home.png | 排除 | → design/ |
nav-icon.svg | 排除 | → design/ |

新增关键词,图片和文档通用:
| 关键词 | 归类到 |
|---|---|
icon、logo、图标 | design/ |
flowchart、流程图、diagram | design/ |
screenshot、截图 | testing/ |
architecture、er-diagram、schema | technical/ |
bug、问题 | testing/ |
| 无明确关键词的图片 | design/(默认) |
screenshot/bug → testing/architecture/er-diagram → technical/flowchart/mockup → design/| 指令 | 说明 |
|---|---|
/docs <描述> | 智能助手,自动识别意图 |
/docs-scan | 全量扫描(文档 + 图片),生成完整文档 |
/docs-update | 增量更新,只更新变更部分 |
/docs-check | 检测文档结构 + 自动迁移 + 图片归类 |
/docs-prepare <任务> | 开发前准备,输出开发方案 |
/docs-archive | 归档模式,更新文档 |
复制代码# 一行命令升级
/plugin uninstall code-documents-auto@code-documents-auto-skill &&
rm -rf ~/.claude/plugins/cache/code-documents-auto-skill &&
/plugin install code-documents-auto@code-documents-auto-skill
然后在已有项目中跑一次:
复制代码/docs-check # 自动迁移 + 图片归类
/docs-check,项目里散落的图片会被自动归类screenshot 关键词自动归 testing/GitHub 仓库:github.com/Leo-skye-ta…
如果这个项目对你有帮助,请给个 Star ⭐
从 v3.1.2 到 v3.2.0 的完整变更日志:github.com/Leo-skye-ta…