功能藏得有点深了，给砚加一个能跟着做的教程功能藏得有点深了，给砚加一个能跟着做的教程菜单和命令越来越多以后，只在更新日

功能藏得有点深了，给砚加一个能跟着做的教程

菜单和命令越来越多以后，只在更新日志里写“新增了什么”已经不太够。比如锁定列、多光标、Markdown 就地编辑，知道名字和真正用过一遍，是两回事。

最近一批开发往这个方向补了功能导览，也继续整理项目栏的辨识度。

先交代版本：项目缩写和自定义标记已经进入 alpha.17；自动读取项目图标、自选图片，以及下面的功能导览，截至这次整理已合入主线，还在 Unreleased。

项目栏位置小，直接放完整名字不现实。单词取前两个字母是个起点，但 Downloads 和 Documents 都会变成 Do。

alpha.17 改成在冲突时取有差异的字母，这个例子会显示 Dw 和 Dc。中文也先取首字，遇到冲突再带上有区别的字。

还可以自己选两字符以内的标记或一个 emoji，再配颜色，按文件夹记在本机。常用项目不必每次悬停读名字。

后面主线又接上了图片：从项目根目录、public、app、src、资源目录里找 favicon、logo 或 icon，也读部分 HTML、布局源码中声明的本地图标。

搜索放在后台，源码只读开头的一段，图片读取也有大小上限。找不到能解码的图片就回退，不为了一个小方块把整个项目扫一遍。自己选过的标记优先，随后是自选图片、项目图标，最后才是缩写。

拖一张图片到项目方块上也能设置图标，砚会留一份副本，原图移走后仍能显示。重置以后，再回到自动识别或缩写。

功能导览借鉴了 JetBrains IDE 的 Learn 面板，入口放在侧边栏顶部、帮助菜单、欢迎页和命令面板。

现在有七组短课：编辑基础、多光标、文件和命令导航、列与终端、Git、Markdown、个性化设置。比如编辑基础会带着做选整行、复制、移动、注释、删除、撤销，多光标则让几处相同的词一起改。

步骤会跟着命令执行或编辑器状态推进，用按键、菜单还是命令面板都可以。提示里的快捷键从当前键位配置拿，改过绑定的人看到的也应该是自己的按法。

这并不是给练习结果做完整语义评分。有些步骤确认的是对应命令运行过，有些检查当前状态。它先帮人把功能实际走一遍。

有示例文件的课程，把材料放在用户配置目录下的 learn 中，不往项目目录塞练习代码。开始课程会准备一份示例，完成进度另行保存，步骤也可以跳过。

但我核对这批实现时，有一点不能省略：Git 课用的是当前项目，设置课也会打开真实配置。它们没有另建一个完全隔离的沙盒。Git 课里暂存、提交仍是实际操作，没有合适的仓库或暂时不想做，就跳过。

终端版遇到只在窗口版支持的步骤，会自动略过。课程下面还放了短提示，一次介绍一个用法，不用先读完一份长手册。

项目栏让人少认错工作区，教程让人少猜一个功能藏在哪里。这一批先做到这里；文章发布时，如果下载页仍是 alpha.17，图标图片和课程入口就还得等下一版。

alpha.17 只包含本文的项目缩写、自定义标记与颜色。项目图片图标和功能导览已合入主线但尚未发布，下面的安装包不包含这两项。

下载地址核对于 2026-10-19。安装包适用于 macOS 13+、Apple Silicon，目前尚未 Apple 公证，首次打开说明见发布页。

实现与设计：core/app/projectlook.go、core/workspace/logo.go、ui/gui/projecticon.go、core/app/guide.go、ui/gui/learn.go。
测试入口：core/workspace/logo_test.go、ui/gui/projecticon_test.go、core/app/guide_test.go、ui/gui/learn_test.go。本轮只核对源码、历史报告与发布信息，没有重跑产品测试或安装包。
以 core/app/guide.go 的课程定义校正 CHANGELOG 中“每课都有独立练习文件”的笼统说法：Git 与设置课程没有练习文件，操作当前仓库或真实配置。