去AI味文档工坊
本机起一个只监听 127.0.0.1 的网页：填写文档需求 → 生成草稿 → 去 AI 味润色 → 逐段改写 → 交付成品。
数据只写 HELLOME_SKILL_DATA_DIR。不上传用户文件。
何时使用
- 用户要写周报、客户简报、项目状态、邮件草稿
- 用户抱怨 AI 写出来的东西“一眼假”，需要去 AI 味
- 用户想对某一段文字做局部改写（更短 / 更口语 / 换说法）
- 用户想对比初稿和终稿改了哪些地方
- 被 HelloMe / FDE「启动」唤起时
不要在无关闲聊时主动拉起。
怎么做
- 用户点 HelloMe / FDE「启动」，平台按 metadata 确定性启动。不要猜安装目录，不要写死端口。
- 平台打开 READY URL；不要自开系统浏览器。
- 用户在页面里填：文档类型、语气、主题、关键要点、可选参考文件路径、是否启用去 AI 味、可选写作风格样例。
- 点「生成文档」后，upstream 分两阶段执行：
- 阶段一POST /api/generate：按文档模板调 LLM 生成结构化草稿
- 阶段二POST /api/humanize：本地扫描 AI 写作模式 + 调 LLM 按 Humanizer 规则润色 - 成品区提供三个附加能力：
- 逐段改写：鼠标悬停段落，右侧浮出铅笔按钮，调POST /api/rewrite_segment只重写该段。改写前原文会被记住，可一键撤销。
- 修订对比：调POST /api/diff做本地段落级 + 字符级 diff，用删除线和绿色下划线展示改动。默认显示「最终版」，用户可切换。
- 格式切换：成品标题栏的MD / 纯文本切换，只影响复制和导出，不影响生成和改写。 - 成品可复制或导出（
showSaveFilePicker弹原生另存为，降级为 Blob 下载）。 - 关页停服：最后一个标签离开约 2.5s 后本机服务退出。
输出契约（强制）
- 平台终态打印：SMART_DOC_DELIVER_READY url=http://127.0.0.1:<port>/
- 若有复用：HELLOME_SKILL_REUSED skill=<key>
- 业务进程禁止打印 READY 行
能力与限制
- 本机 HTTP，只绑 127.0.0.1
- 业务数据只写 HELLOME_SKILL_DATA_DIR
- 若用户在页面里填了参考文件路径，只读该文件（不遍历磁盘，路径由用户当次给出）
- 润色和局部改写阶段不改变数字、日期、引用等事实内容
- 局部改写的上下文只截取前后各 200 字，不把整篇文档重复送入模型
- 生命周期由 HelloMe 运行时管理
词元
- HelloMe 下发的多供应商配置（词元 / 百炼 / 火山 / 自定义），词元是其中一家 +
.env回退。优先读{HERMES_HOME}/hellome_skills_llm_config.yml（helperlist_*/resolve/resolve_default），没有再回退 Hermes{HERMES_HOME}/.env的 AGENTSYUN_API_KEY。视觉理解走 text；出图走 image。 - 技能页不采集、不展示 API Key。有设置页时先选账号再选模型，选中对
{account_id, model_id}记在 HELLOME_SKILL_DATA_DIR。 - 未下发 ≠ 报错。设置页按
source=yaml/env/none画状态（§3.8.4）：完全无文件写「使用桌面词元（未下发 HelloMe 账号）」；有文件但当前 kind 没有写「当前能力尚未下发到本机」。仅文本 + 桌面词元允许生成；图/视频 env 禁用 helper 生成。只有 Key 也没有时才提示去 HelloMe 下发或在 Hermes 配词元。不要引导去 OpenAI / 火山控制台贴 Key。 - 有设置页：列表以
list_models为准（现读 YAML，不缓存）；list_providers()空不是失败。无 YAML 才回退词元 GET /models，目录失败只改 hint。无设置页用resolve_default(kind)：该 kind 下优先词元（ciyuan），否则account_id较小者。
注意
- 不得写入技能安装目录（包括 pycache）
- 端口只读 HELLOME_UPSTREAM_PORT（为空就退出）
- 调 LLM 建议优先走 HelloMe 下发配置（回退 Hermes 词元），Key 不得打进包、不得在技能页采集。不抄 helper 也可以
不要做
- 自建起服 / 写死端口 / 自开浏览器 / 只提供 .bat
- 业务进程打印平台就绪标记
- 把用户数据写进安装树
- 把真实 Key 打进包；可执行代码把 openai.com 写成默认基址
- 删除或改写页面里的 presence 脚本
