trip-moments-skill 1.0.0

package/.agents/skills/trip-moments/references/amap-geo.md

@@ -0,0 +1,51 @@
+# 高德 Web 服务 API 速查(route_map.py 用)
+
+key 要求:lbs.amap.com → 应用 → **Web服务** 类型 key(见 api-config.md)。坐标系为 **GCJ-02**;
+照片 EXIF 里的 GPS 是 WGS-84,必须先经 exif_gps.py 转换,否则在国内偏移 300-600 米。
+
+## 地理编码(地名 → 坐标)
+
+```
+GET https://restapi.amap.com/v3/geocode/geo?address=乌镇&key=<AMAP_KEY>
+```
+- 响应:`geocodes[0].location = "120.489983,30.744797"`(经度在前)
+- `geocodes[0].formatted` 是规范化地名,可用于卡片展示
+- `status != "1"` 时看 `info`(常见:`INVALID_USER_KEY`、`DAILY_QUERY_OVER_LIMIT`)
+- 地址尽量带城市:"乌镇" → "浙江省嘉兴市乌镇";歧义地名加前缀
+
+## 静态地图(直接返回一张 PNG)
+
+```
+GET https://restapi.amap.com/v3/staticmap
+    ?location=<中心lon,lat>&zoom=<3..17>&size=750*440&scale=2&key=<AMAP_KEY>
+```
+
+| 参数 | 说明 |
+|---|---|
+| `location` | 中心点 `lon,lat` |
+| `zoom` | 级别 3-17;route_map.py 按点位范围自动拟合 |
+| `size` | 最大 1024*1024,格式 `宽*高` |
+| `scale` | 1 或 2(2 = 高清,返回像素翻倍:750*440 → 1500*880) |
+| `markers` | (可选)`编号样式` 见下;route_map.py 不用它,图钉是本地自绘的 |
+| `path` | (可选)`weight,color,alpha,线型;lon,lat;lon,lat;...` 画折线 |
+
+官方文档:<https://lbs.amap.com/api/webservice/guide/api/staticmaps>
+
+失败特征:HTTP 200 但 body 是 JSON(`{"status":"0","info":"INVALID_USER_SCOPED"}`)——
+route_map.py 会识别并报错。常见 info:
+- `INVALID_USER_SCOPED`:key 类型不对(选了"Web端JS"而不是"Web服务")
+- `DAILY_QUERY_OVER_LIMIT`:当日配额用完
+- `USER_DAILY_QUERY_OVER_LIMIT`:同上(个人认证版)
+
+## 拟合算法(route_map.py 内置,供调参)
+
+Web-Mercator:世界像素 = 256 * 2^zoom;
+`x = world * (lon+180)/360`,`y = world * (1 - ln(tan(π/4 + lat/2))/π) / 2`。
+zoom 取"能包住所有点(留 20% padding)的最大整数级";图钉坐标用同一投影换算,
+所以和地图底图对齐(误差 ≤1 个像素级,GCJ-02 坐标直接参与计算)。
+
+## 扩展方向
+
+- 真实道路路线(而非点间虚线):路径规划 API v5(`https://restapi.amap.com/v5/direction/...`)
+  返回 steps[].polyline 坐标串,可拼进静态地图 `path` 或本地绘制
+- 照片轨迹密集时:轨迹纠偏 API(`v4/grasproad/driving`)先把原始 GPS 顺到路上

package/.agents/skills/trip-moments/references/api-config.md

@@ -0,0 +1,129 @@
+# API Key 配置(一次性)
+
+trip-moments 的功能按依赖分为三档,没配 key 也能用本地档。key 通过**环境变量**读取,不要写进任何文件。
+
+## 功能与 key 对照
+
+| 功能 | 需要 | 环境变量 |
+|---|---|---|
+| 九图优选(本地打分)/ 批量裁剪 / 九宫格拼图 | 无 | — |
+| 九图优选(AI 美感/构图打分,视觉模型) | 任一 AI 服务商 | `SILICONFLOW_API_KEY` / `ZHIPU_API_KEY` / `OPENAI_BASE_URL`+`OPENAI_API_KEY` |
+| AI 修图(去路人/调色/风格化等指令编辑) | 硅基流动 或 百炼 | `SILICONFLOW_API_KEY` 或 `DASHSCOPE_API_KEY` |
+| 修图预设:扩图/画质提升(expand/upscale) | 百炼 | `DASHSCOPE_API_KEY` |
+| 杂志海报 panel 模式(AI 抽象画板,文生图) | 硅基流动 或 智谱 | 同上 |
+| 杂志海报 full 模式(整张生成,实验性) | 硅基流动 或 百炼 | 同上 |
+| 旅行路线图 | 高德 | `AMAP_KEY` |
+
+> **推荐只配硅基流动一个 key**:视觉打分 + 图像编辑(Qwen-Image-Edit)+ 文生图全覆盖。
+> 智谱的图像接口只支持文生图(**无图像输入**),所以只配智谱时修图不可用;
+> 只配百炼时评分/画板不可用。三类 key 互相独立,按需组合。
+
+## 方案 A:硅基流动(推荐,一个 key 全覆盖)
+
+1. 打开 <https://siliconflow.cn> 注册(新用户送体验额度,部分小模型长期免费,图像编辑按量计费)
+2. 控制台 → API 密钥 → 新建,复制 `sk-...`
+3. `setx SILICONFLOW_API_KEY "sk-..."`(见下)
+4. 默认模型(可用环境变量覆盖):视觉 `zai-org/GLM-4.5V`(盲测选图品味最佳)、
+   编辑 `Qwen/Qwen-Image-Edit-2509`、文生图 `Kwai-Kolors/Kolors`;
+   硅基流动会定期下架旧模型(报 `403 Model disabled` 就是这种情况),
+   去 <https://siliconflow.cn/models> 找当前在售型号,
+   `setx TRIP_VL_MODEL / TRIP_EDIT_MODEL / TRIP_T2I_MODEL` 覆盖即可,无需改代码
+5. 注意:生成的图片 URL **仅 1 小时有效**,技能脚本会立即下载转存,无需手动处理
+
+## 方案 B:豆包 Seedream / 火山方舟(修图质量第二梯队,接入零代码)
+
+火山方舟官方支持 OpenAI 兼容协议,我们的网关适配直接可用:
+
+1. 打开 <https://console.volcengine.com/ark> 注册并实名认证
+2. 开通模型(模型广场搜 Seedream / doubao-seedimage,记下**精确模型 ID**,形如 `doubao-seedream-4-0-250828`)
+3. API Key 管理 → 创建 key
+4. 设置(**用 TRIP_AI_* 而不是 OPENAI_***,显式网关优先级高于硅基流动):
+
+```cmd
+setx TRIP_AI_BASE_URL "https://ark.cn-beijing.volces.com/api/v3"
+setx TRIP_AI_API_KEY "你的方舟key"
+setx TRIP_EDIT_MODEL "doubao-seedream-4-0-250828"
+```
+
+5. 之后 retouch.py/styles.py 不加参数即自动走豆包;想切回硅基流动删掉 TRIP_AI_* 两个变量即可
+
+## 方案 C:任意 OpenAI 兼容接口(自建/聚合网关)
+
+支持 one-api、new-api、vLLM、LM Studio 等任何暴露 `/chat/completions` 和
+`/images/generations` 的服务:
+
+```cmd
+setx OPENAI_BASE_URL "https://你的网关/v1"
+setx OPENAI_API_KEY "sk-..."
+:: 模型名按网关实际部署设置:
+setx TRIP_VL_MODEL "Qwen/Qwen2.5-VL-72B-Instruct"
+setx TRIP_EDIT_MODEL "Qwen/Qwen-Image-Edit"
+setx TRIP_T2I_MODEL "Kwai-Kolors/Kolors"
+```
+
+编辑功能要求网关背后的图像模型支持 image 输入(Qwen-Image-Edit / FLUX.1-Kontext /
+Kolors 图生图);不支持时修图会明确报错,评分/画板不受影响。
+也可以用 `TRIP_AI_BASE_URL` / `TRIP_AI_API_KEY`(优先于 OPENAI_*)避免与其他工具的配置冲突。
+
+自建网关接 OpenAI `gpt-image` 系列的示例(尺寸参数名会自动切为 `size`,
+也可用 `TRIP_SIZE_PARAM` 强制指定):
+
+```cmd
+setx TRIP_AI_BASE_URL "https://mg.zichuanlan.top/v1"
+setx TRIP_AI_API_KEY "sk-..."
+setx TRIP_EDIT_MODEL "gpt-image-2"
+setx TRIP_T2I_MODEL "gpt-image-2"
+```
+
+> 透传网关注意:gpt-image 系列会自动切换到 OpenAI 原生协议——
+> 尺寸参数用 `size`(可用 `TRIP_SIZE_PARAM` 强制指定),
+> 图像编辑走 `/v1/images/edits` multipart 文件上传(而不是 JSON data URL),
+> 因此网关无需做任何转换;前提是上游(cpa)本身支持原生 OpenAI 图像接口。
+>
+> 网关也接了 Gemini 图像模型(nano-banana 族)的,注意它们只支持 chat 协议
+> (图进图出,`/images/*` 会被网关拒绝),本技能已自动适配:
+> `setx TRIP_EDIT_MODEL "gemini-3.1-flash-image"` 即可。
+>
+> 视觉评分同样可走网关(实测 gemini-3.8-flash-high / gemini-3.6-flash-high /
+> claude-sonnet-4-6 均可,3.8 对光线和主体细节识别最好):
+> `setx TRIP_VL_MODEL "gemini-3.8-flash-high"`。显式配了网关后评分/画板/修图
+> 全部优先走网关,想回硅基流动删掉 `TRIP_AI_*` 即可。
+
+## 方案 D:智谱 BigModel(评分 + 海报画板)
+
+1. 打开 <https://bigmodel.cn> 注册/登录(如果你在用 ZCode 的 GLM 套餐,账号体系相通,但 **API key 需要在开放平台单独创建并按量计费**)
+2. 右上角 → API Keys → 新建,复制 `sk-...` 形式的 key
+3. `setx ZHIPU_API_KEY "sk-..."`
+4. 费用参考:GLM-Image ≈ 0.1 元/张;`glm-4v-flash` 视觉模型免费,选图打分基本零成本
+5. 局限:不能修图(无图像输入接口)
+
+## 方案 E:阿里云百炼(修图预设最全)
+
+1. 打开 <https://bailian.console.aliyun.com> 开通(需阿里云实名)
+2. 控制台 → API-KEY 管理 → 创建,复制 `sk-...`
+3. 模型:`wanx2.1-imageedit`(指令编辑/擦除/扩图/风格化/上色/画质提升)
+4. 费用:按张计费(约 0.14 元/张量级,以控制台价格页为准)
+
+## 高德开放平台(路线图)
+
+1. 打开 <https://lbs.amap.com> 注册并完成**个人实名认证**
+2. 控制台 → 应用管理 → 创建新应用 → 添加 Key,服务平台选 **Web服务**
+3. 复制 key
+4. 费用:个人开发者有免费日配额(地理编码/静态地图数千次/日),旅行用途足够
+
+## 设置环境变量(Windows)
+
+命令行(cmd 或 Git Bash 调 cmd)执行,**设置后重开终端/ZCode 才生效**:
+
+```cmd
+setx SILICONFLOW_API_KEY "sk-xxxxxxxx"
+setx AMAP_KEY "你的高德key"
+```
+
+PowerShell 当前会话临时验证用:
+
+```powershell
+$env:SILICONFLOW_API_KEY = "sk-xxx"
+```
+
+验证:`python -c "import os; print(bool(os.environ.get('SILICONFLOW_API_KEY')))"`

package/.agents/skills/trip-moments/references/editorial-poster.md

@@ -0,0 +1,44 @@
+# 杂志风海报提示词(photo abstract editorial)
+
+思路借鉴 [photo-abstract-editorial](https://github.com/ZzzLc0405/photo-abstract-editorial)
+(5.4k star 的提示词型 skill):**原照片保持不动,是唯一内容来源**;下方/旁边配一块
+从照片"长出来"的抽象画板;再加一个诗意的英文标题。
+
+> 借鉴的是构图思想,提示词为原创。原仓库许可证仅限个人/教育/非商用,勿照抄其文案、
+> 勿将产出用于商业用途。
+
+## 两条核心原则(生成时必须守住)
+
+1. **照片是唯一内容来源**:抽象画板的颜色、形状只能来自照片里真实存在的
+   空间关系、构图与色彩,不引入照片外的新元素
+2. **克制**:大面积留白,形状少而大,两三种主色,无渐变阴影,无杂乱细节
+
+## panel 模式(poster.py 默认,AI 只画"画板",版式本地合成)
+
+提取照片主色后,向 GLM-Image 发送的画板提示词(脚本已内置,可在此调):
+
+```
+极简抽象画板,横向长条构图,杂志编辑风格。仅使用以下颜色:<#RRGGBB ×4>,
+以及大面积米白色(#F5F1E8)留白。画面元素:2-3 层柔和的水平色带,一个大圆弧形,
+少量细线与小圆点。扁平几何,安静克制,无文字,无照片元素,无渐变阴影。
+```
+
+调法:想要更"海"就用长横带+大圆弧;想要"山"把横带换成斜切三角;城市用竖细线+小方点。
+
+## full 模式(整张生成,实验性)
+
+```
+把这张照片排成杂志内页:照片完整保留在上半部,不要改动照片内容;
+下半部用照片中出现过的颜色生成极简抽象画板(色带、圆弧、细线、圆点);
+米白底色,留白充足,顶部小号英文衬线字幕,底部加入英文标题"<TITLE>"。
+无水印,无多余文字。
+```
+
+## 标题写作(由 agent 完成,不要用脚本默认值)
+
+英文短语,2-5 个词,全小写或首字母大写,意象必须来自照片本身,避免陈词。
+参考风格:`Slow Tide` / `Light Between Buildings` / `Salt & Morning Fog` /
+`The Last Blue Hour` / `Windows of Lijiang`。
+
+版式参数:照片区约占上 46%,画板全宽占下部;标题衬线体 84px,眉题全大写 24px,
+主色短线分隔。比例 3:4(1080x1440),朋友圈竖图直接发。