obsidian-icon-assignerlisted

# Obsidian 图标自动分配器 ## 快速开始 ### 1. 安装依赖 确保Python 3.7+环境，无额外依赖包 ### 2. 运行技能 ```bash cd /path/to/vault python ${CLAUDE_PLUGIN_ROOT}/skills/obsidian-icon-assigner/scripts/assign_icons.py --vault-path . ``` ### 3. 检查结果 1. 查看控制台输出统计 2. 重启Obsidian查看图标分配 3. 检查`.obsidian/plugins/iconic/data.json`更新 ## 使用模式 ### 模式1：新知识库初始化 ```bash # 为所有文件分配图标和颜色 python ${CLAUDE_PLUGIN_ROOT}/skills/obsidian-icon-assigner/scripts/assign_icons.py --vault-path /path/to/vault ``` ### 模式2：增量更新（推荐） ```bash # 只处理未设置图标的文件 python ${CLAUDE_PLUGIN_ROOT}/skills/obsidian-icon-assigner/scripts/assign_icons.py --vault-path /path/to/vault --skip-existing ``` ### 模式3：试运行分析 ```bash # 预览分配结果，不实际修改 python ${CLAUDE_PLUGIN_ROOT}/skills/obsidian-icon-assigner/scripts/assign_icons.py --vault-path /path/to/vault --dry-run ``` ### 模式4：强制重新分配 ```bash # 覆盖所有现有图标 python ${CLAUDE_PLUGIN_ROOT}/skills/obsidian-icon-assigner/scripts/assign_icons.py --vault-path /path/to/vault --force ``` ### 模式5：查看图标库 ```bash # 列出所有可用图标 python ${CLAUDE_PLUGIN_ROOT}/skills/obsidian-icon-assigner/scripts/assign_icons.py --list-icons ``` ## 核心特性 ### 🔍 智能颜色继承 - 已有颜色的目录保留原配置 - 新子目录继承最近父目录的颜色 - 没有可继承父目录颜色时，才使用哈希生成HSL颜色 - 同一目录下文件颜色统一 ### 🎯 图标唯一性 - 文件名语义匹配优先（关键词→相关图标），无匹配时哈希全量分配 - 关键词匹配的图标被占用时自动从同类别找替代 - 目录与文件、文件与文件之间图标全局不重复（图标池耗尽时使用最少使用回退） ### 🔄 非破坏性更新 - 尊重用户手动设置的图标（默认） - 支持增量处理 - 自动备份配置文件 ### 🧠 确定性分�� - 同一文件路径永远获得相同的图标+颜色 - 基于SHA256哈希的确定性映射 - 分配结果可重复验证 ## 参数说明 ```bash # 完整参数列表 python ${CLAUDE_PLUGIN_ROOT}/skills/obsidian-icon-assigner/s