3.8 KiB
3.8 KiB
name, description
| name | description |
|---|---|
| learning-map-upload | Upload and persist ITTOView 一图流 learning-map images. Use when the user provides an image path or asks to 上传/传一下/放一下/删除/隐藏 a learning-map image in this project; requires copying into /home/ittoview/src/data/image, choosing a stable numbered Chinese filename, verifying local and /learning-images/ visibility, then committing and pushing the image changes to Git so they are not lost. |
Learning Map Upload
核心原则
一图流图片目录属于 Git 项目，同时被 Docker 运行时挂载：
- Git/宿主机真实目录：
/home/ittoview/src/data/image - 线上静态目录：
https://itto.topwind.top/learning-images/ - 内网静态目录：
http://11.144.144.9:8035/learning-images/ - 页面路径：
https://itto.topwind.top/learning-maps
新增、覆盖或删除图片时，只操作真实目录。新增图片不需要重启 Docker；但因为目录属于 Git 仓库，所有图片变更必须提交并推送，避免后续拉取/重置/部署导致图片丢失。
必须执行的闭环流程
- 读取用户给出的图片路径，必要时用
view_image查看内容。 - 根据图片主题命名，格式为：
NN-主题.png/jpg或NN-主题一图流.png/jpg。 - 复制到
/home/ittoview/src/data/image/，不要复制到其他目录。 - 用
ls -lh确认本地文件真实存在。 - 用
curl https://itto.topwind.top/learning-images/ | grep 'NN-'确认公网线上挂载目录可见。 - 用
git status --short确认图片变更已出现。 - 执行
git add src/data/image ...，提交并推送。 - 用
git status --short确认工作区干净或只剩无关改动。 - 回复用户时必须包含：本地文件、线上可见、Git 提交号。
如果第 5 步失败，不要说已上传成功；如果第 7 步失败，不要说流程完成。要明确说明卡在哪一步。
编号规则
- 默认使用当前最大编号 + 1。
- 如果用户要求覆盖某张图，保持原编号和文件名。
- 如果用户要求删除或隐藏，删除对应文件，也要提交推送。
- 文件名优先使用图片标题中的业务主题，去掉冗余词。
- 尽量保留“找问题”“一图流”“绩效域”“管理”等识别关键词。
- 保留源文件格式；如果源文件是 JPG，可以使用
.jpg。
示例：
变更管理找问题→15-变更管理找问题一图流.png常见分解结构一图流→16-常见分解结构一图流.png项目可行性研究关键文档→25-项目可行性研究关键文档一图流.png
推荐脚本
上传时优先用：
.codex/skills/learning-map-upload/scripts/upload_learning_image.sh <source-image> <target-filename>
脚本只负责复制和线上校验；脚本成功后仍必须 Git 提交推送。
示例：
.codex/skills/learning-map-upload/scripts/upload_learning_image.sh \
/tmp/hapi-blobs/example/image.png \
26-示例主题一图流.png
git add src/data/image/26-示例主题一图流.png
git commit -m "feat: add learning map image"
git push origin main
回复模板
成功时：
已上传、线上确认可见，并已提交推送。
本地文件：
/home/ittoview/src/data/image/NN-主题.png
线上 /learning-images/ 已确认存在：
NN-主题.png
提交：
<commit-sha> <commit-message>
失败时：
流程未完成，卡在：<本地复制 / 线上校验 / Git 提交 / Git 推送>。
已完成：...
失败原因：...
禁止事项
- 不要只复制文件后回复“已放好”。
- 不要跳过公网
/learning-images/校验。 - 不要因为新增图片而重启 Docker。
- 不要把图片放到
dist/、public/、临时目录或非真实映射目录。 - 不要忘记 Git 提交推送；未提交图片等同于未完成。