前言¶
在 DeepSeek Harness 里做前端或界面相关工作时，常见做法是临时打开设计站、截图或另开笔记工具，设计参考、术语和自评笔记分散在不同窗口。Obsidian 上的「乔木 UI 学习」把图库、词典、测验和 Markdown 笔记收在一套界面里；本插件是同一内容的 DeepSeek Harness 迁移版，把浏览、练习和笔记保存接到 Harness 的插件容器与本地数据目录，便于和智能体工作流同屏使用。
下面介绍插件定位、已核实功能、安装方式与使用注意点。事实以 GitHub 仓库 README 与 package.json 为准。
这是什么¶
乔木 UI 学习（npm 包名 qiaomu-ui-learn-dsh，当前版本 0.1.2）由维护者 joeseesun 发布，MIT 许可。它在 DeepSeek Harness 0.2.1-rc.3 上运行，界面与 CSS 沿用 Obsidian 版乔木 UI 学习；迁移部分主要是宿主容器、文件保存、快捷操作以及与 Home 的联动接口。
插件在 Harness 侧边栏以「乔木 UI 学习」入口打开，用于浏览设计参考、查 UI 词典与风格图鉴、做审美测验，并把点评与笔记写成 Markdown。
社区目录页：https://www.skillhub.cn/plugins/joeseesun/qiaomu-ui-learn-dsh。SkillHub 为社区插件目录，与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，安装与数据来源以仓库说明为准。
核心功能¶
以下能力均来自仓库 README 与发布说明，未单独实机验收的部分会在后文注明。
设计参考图库¶
- 13,561 条设计参考、184 个分类。
- 支持搜索、收藏夹、最近浏览、点评筛选和卡片密度调节。
- 保留原版设计灯箱；可复制图片、Markdown、提示词；可读取参考页面 HTML 源码（公开参考目录、15 秒超时、2 MB 响应上限）。
- 图库缩略图与参考预览按需从 Kombai 加载。
UI 词典与风格图鉴¶
- 106 个交互标本，含双语解释、识别特征、关联风格、代码与实现提示词。
- 词典、风格与交互标本随插件包提供，不依赖 Obsidian。
审美测验¶
- 组件、风格或混合练习；键盘作答；掌握状态与复习记录。
笔记与导出¶
- 五星评价、标签、评论。
- 逐条或批量导出 Markdown；笔记浏览、光标插入、未保存草稿恢复。
- 笔记写入限制在所配置目录内，带版本校验；冲突时保留现有文件。
数据迁移与备份¶
- 可导入 Obsidian 的
data.json或本插件备份；覆盖前可下载现有记录备份。
Harness 集成¶
- 5 个 Harness 原生快捷操作，可在宿主快捷键设置中绑定。
- 安装支持 v1 provider 的 乔木 Home 后，提供最近设计卡片、浏览入口和全局设计搜索；未安装 Home 时插件可独立工作。Home 联动需要带
qiaomuHomev1 服务的版本；Home 0.2.1 的旧发布包尚无此接口。
安装与启用¶
环境要求：DeepSeek Harness 0.2.1-rc.3（package.json 中 engines.dsh 与此一致）。插件 0.1.2 为针对该 RC 的兼容更新，验证范围见仓库 docs/RC3-COMPATIBILITY.md。
方式一：本地 bundle（插件管理界面）¶
- 从 Releases 下载
.tgz与SHA256SUMS，核对摘要。 - 在 Harness 插件管理 中安装该本地 bundle。
- 按宿主提示重载，从侧边栏打开「乔木 UI 学习」。
项目交付预构建 Release 包，不需要 npm 账号或 Obsidian。
方式二：CLI 安装到指定 profile¶
将下面命令中的路径与 profile 换成你自己的值：
dsh plugin --profile YOUR_PROFILE add /absolute/path/qiaomu-ui-learn-dsh-0.1.2.tgz
YOUR_PROFILE 替换为自己的 profile。macOS App 自带 CLI 位于：
/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh
数据目录与配置¶
默认学习记录路径：
${DSH_HOME:-~/.dsh}/qiaomu/qiaomu-ui-learn-dsh/state.json
Markdown 笔记位于同目录下的 notes/。宿主支持通过绝对路径配置 dataDir、notesRoot。
- 现有 Obsidian 数据不会被自动修改；迁移时在设置中手动选择 JSON。
- 不同 profile 若共用同一
DSH_HOME，默认共享该插件数据；需要隔离时可配置dataDir。
典型用法¶
安装并重载后，从侧边栏进入「乔木 UI 学习」，可按 README 描述的路径使用：
- 浏览图库：按分类或搜索查看设计参考，使用收藏夹与最近浏览；需要时在卡片上写点评、打星、加标签。
- 查词典 / 风格：打开交互标本详情，对照识别特征与实现提示词；必要时复制 Markdown 或提示词到当前工作文档。
- 做测验：选择组件、风格或混合模式，用键盘作答，根据掌握状态复习。
- 写笔记：在插件内编辑 Markdown，利用光标插入与草稿恢复；确认后导出或保留在
notes/。 - 从 Obsidian 迁数据：在设置中选择 Obsidian
data.json或本插件备份；覆盖前先下载现有记录备份。
若已安装符合要求的乔木 Home，可在 Home 侧使用最近设计卡片与全局设计搜索；无 Home 时不影响插件单独使用。
适用场景与注意¶
适合谁：需要在 Harness 同屏查阅大量 UI 设计参考、系统学习 UI 术语与风格、并用 Markdown 沉淀点评的前端或产品设计相关开发者。
权限与安全：插件以当前 DSH 进程权限读写本地 state.json 与笔记目录，并按配置访问网络加载 Kombai 缩略图与预览。安装前应阅读仓库源码、THIRD_PARTY_NOTICES.md 与 MIT 许可证，确认数据路径与网络行为可接受。
验收范围：仓库说明 macOS Harness 的亮色、深色与 720px 窗口已验证；其他操作系统尚未实机验收。开发侧有 18 项自动检查（含 106 详情中英挂载、样式、测验与 Home 协议等），真实 Harness 验收范围见 docs/ADAPTATION.md。
来源说明：设计目录及缩略图来自 Kombai Gallery；UI 学习内容经 joeseesun/learnui 整理，原英文内容来自 namethatui.com。插件保留原仓库源码、作者署名与数据归属说明。
结尾¶
乔木 UI 学习 DSH 版把 Obsidian 上同一套图库、词典、测验与笔记能力接到 DeepSeek Harness 0.2.1-rc.3，适合把 UI 学习与 Agent 工作流放在同一宿主里完成。安装以 Release 的 .tgz 与官方文档中的 CLI 命令为准，不要凭插件名自行拼接未在 README 出现的安装 URL。
