墨参 MoShen v0.11.5

本次发布为 v0.11.4 → v0.11.5 的更新。

---

v0.11.5 · 反馈体系与模型预设

新增

• 模型预设：配置模型时可选 DeepSeek、Claude、GPT、Grok、Kimi、通义千问、MiniMax、智谱 GLM、豆包、硅基流动、OpenRouter、本地 Ollama 等主流大模型。可「从预设添加」直接新建，也可对已有 API「套用预设」一键填入名称、Base URL 与常用模型名，只需再补 API Key
• 「本次更新」悬浮窗：每个版本首次启动时展示该版本的更新要点，底部附反馈邮箱，一键复制
• 设置 → 关于与反馈：显示版本号、运行方式、系统与工作区；一键复制诊断信息；打开日志目录；导出诊断包（含日志与工作区结构清单，不含正文内容与 API Key）
• 新版本检查：启动时静默查询最新发布版本，有更新时在侧栏给出一条可关闭的提示（可在「关于与反馈」中关闭）
• GitHub Issue 模板：Bug 反馈与功能建议表单，降低提交门槛

改进

• 新增本 CHANGELOG，并回溯补齐历史版本记录
• README 新增「反馈与支持」章节
• 版本号收敛为单一来源，避免多处硬编码不同步
• 打包配置随包分发 CHANGELOG.md，「本次更新」悬浮窗离线可用

---

反馈与建议

这份版本开始，墨参内置了反馈通道。使用中遇到问题，或希望增加某个功能，欢迎告诉我：

• 邮箱：3191639408@qq.com（最直接，一定看得到）
• 或在 Issues 提交

设置 → 关于与反馈 里可以一键复制诊断信息或导出诊断包（只含版本、系统、日志尾部与工作区文件清单，不含正文内容与 API Key），附在反馈里能帮我更快定位问题。

墨参不会自动上报任何数据。

墨参 MoShen v0.11.4

本次发布合并了 v0.10.3 → v0.11.4 六个版本的更新（此前均未单独发版）。

---

v0.11.1 → v0.11.4 · 全界面 UI 美化升级与修复

界面美化升级（v0.11.1）

• 顶部 Tab 栏：10 个 emoji 图标替换为线条 SVG 图标，栏高 48px，选中态带底部指示条
• 按钮体系重制：主按钮 / 次按钮 / 文字按钮 / 图标按钮四套统一规范，清除全部 emoji 与 «» 字符符号
• 侧边栏收起控件：字符 « » 改为贴边大拉手 + 箭头 SVG（主栏 28×56、二级栏 24×48）
• 写作页 AI 面板：「墨望 AI」采用品牌毛笔 SVG 图标
• 空状态插画：15 处 emoji 替换为 AI 生成的水墨画（书卷毛笔、负剑青年、群山水墨等 11 幅）
• 对话页消息布局：用户消息右对齐（墨色气泡反白字）、AI 消息左对齐（白气泡带边框）
• @ 引用 / 章节范围：改为输入框上方悬浮面板（点面板外或 Esc 关闭）
• 对话输入框：48px 胶囊形，左侧 @ / 附件 / 章节范围三个图标按钮
• 写作页修复：底部工具栏溢出修复（自动换行）；二级目录栏收起后 40px 窄轨适配

修复（v0.11.2 → v0.11.4）

• 设置按钮图标尺寸过大
• 设定页 / 知识库页二级栏统一为 24×48 贴边大拉手
• 空状态水墨画不显示（图片路径改为 /static 绝对路径）
• 空状态在角色页等横向容器内偏左（自适应填满容器，居中显示）

v0.11.0 · @ 任务化 + 星图性能优化

• @ 引用任务化，统一在写作页侧栏执行
• 新增「逻辑检查 / 设定衍生 / 引入剧情 / 节奏复用」任务与章节范围参数
• 后端结构化引用解析
• 星图关系图加载性能优化
• 写作页列宽统一

v0.10.3 · 墨望 AI 面板 + @ 引用

• 写作页右侧新增「墨望 AI」面板
• AI 对话支持 @ 引用设定 / 灵感 / 双爆点条目
• 灵感「合理插入」功能

墨参 MoShen v0.10.2

本次发布合并了 v0.8.4 → v0.10.2 五个版本的更新（此前均未单独发版）。

---

v0.10.2 · 项目工作区支持浏览文件夹 + 设定页内容 Markdown 预览与「添加到角色页」上移 + 写作页底栏按钮重构

• 项目工作区支持浏览文件夹
• 设定页内容 Markdown 预览
• 「添加到角色页」按钮上移
• 写作页底栏按钮重构

v0.10.1 · 定位由「小说写作助手」改为「个人写作 Agent」

• 品牌定位由「小说写作助手」改为「个人写作 Agent」

v0.10.0 · 角色页（分阶段）+ 写作页条目标蓝/实时提取 + 写作页 UI 改版

1. 新增一级页面「角色页」：角色 = 档案 + 阶段节点 + 事件连线 + AI 观察收件箱。阶段图对齐大纲页体验（拖拽摆位、手动增删阶段与连线、连线上标注「从这一阶段到下一阶段经历的事件」），支持「AI 分阶段解析」（粗略/标准/细致只控制切分粒度、不预设阶段数量，只喂提到该角色的章节以省 token）。
2. 写作页实时标蓝：用 CSS Custom Highlight API 做非侵入式高亮（不改动 contenteditable 的 DOM，因此不打断光标与输入法），词表 = 角色页条目的名称+别名（长词优先）；点击/右键命中处弹出实时信息卡（档案 + 成长阶段 + 待处理观察数），可跳转角色页。
3. 保存后自动提取（一次调用同时产出两类，省一半 token）：伏笔写入伏笔库（新埋新增、回收标记），条目观察排进角色页「AI 观察」收件箱（采纳后才升级为阶段/别名，绝不改动设定页；疑似新角色只提示、不自动建档）。设置内两个开关（自动伏笔检测 / 实时更新条目），同章内容未变化时跳过。
4. 设定页-人物条目新增「🎭 添加到角色」按钮（重复点只补充别名，不重复建档）。
5. 写作页 UI 改版：卷/章合并为章节头卡片、新增状态栏（实时字数 · 保存状态 · 自动同步状态）、底部按钮按主次分组。
6. 修复写作页字数不实时：原 computed 读 DOM 的 innerText 不是响应式依赖，改为 @input 驱动；并改用 textContent 避免长章节每次输入触发重排。

v0.9.0 · AI 编辑审稿 + 肖像风格一致性 + 页边栏收起 + 设定页筛选

1. 写作页新增「AI 审查」：单章/全书两种范围，结合设定树 + 星图人物档案 + 大纲，审查设定一致性、人物 OOC、逻辑因果、叙事节奏、文风与伏笔；报告落盘 reports/ 并写入知识库，可一键「标记为已审稿」。新增 POST /api/writing/{project_id}/review（STRUCTURE_ANALYST 角色）。
2. 肖像风格一致性（设置内开关）：新增「出品风格档案」——一次识别本书题材（玄幻/仙侠/机甲科幻…），映射到规范英文画风并追加固定一致性尾巴，同书所有肖像共用同一套画风与光影；星图分析页可查看/手动微调，未识别时生图会自动识别一次。新增 analysis/style_profile.py 与 /api/relations/{id}/style[/analyze]，偏好存 image_prefs。
3. 页边栏收起：一级侧栏 + 写作目录 + 设定目录 + 知识库 + 灵感页侧栏均可收起为 40px 窄轨（保留展开按钮），状态本地记忆。
4. 设定页新增筛选：类别 chips（全部/世界观/人物/…）+ 标题关键词搜索，显示「命中 / 总数」，可一键清除。

v0.8.4 · 修复启动空白闪现，写作页文本框/章节删除/保存并新建下一章

1. 启动遮罩移到 #app 之外（不再被 v-cloak 的 display:none 隐藏），从首个绘制帧起即覆盖整屏；改为连续两帧后再淡出，避免首帧被跳过而露出空白图层；新增 10s 兜底淡出防止黑屏。
2. 写作页正文编辑区 max-width 760→1020px、内边距加大，写作空间更宽敞。
3. 左侧目录章节项新增悬停删除按钮，支持删除单章（后端 DELETE 接口已存在）。
4. 底部新增「保存并新建下一章」按钮，保存当前章后自动在本卷新建并打开下一章。
5. 修复缩进按钮因固定 34px 宽度导致「缩进」二字换行一上一下的问题，改为自适应宽度单行显示。

---

下载与升级

• 安装包：墨参 MoShen-Setup-0.10.2.exe（Windows x64）
• 免安装绿色版：release/win-unpacked/ 打包后同步覆盖到桌面目录即可，升级无需迁移数据

兼容性

• 工作区与项目数据格式未变更，直接覆盖升级即可
• 新增的角色页数据为增量结构，不影响原有设定/伏笔/星图数据

墨参 MoShen v0.8.3

本次发布合并了 v0.8.1 → v0.8.3 三个版本的更新（v0.8.1、v0.8.2 此前未单独发版）。

---

v0.8.3 · 知识库正文改为 Markdown 渲染

知识库详情页此前是纯文本输出，条目正文里的 #、**、--- 会原样显示成一堆符号，阅读体验很差。

• 详情正文接入 Markdown 渲染（改用与灵感页、文件报告一致的渲染通道），标题、加粗、引用、列表、代码块按排版呈现
• 渲染器补齐此前缺失的语法：--- / *** / ___ 分隔线，以及 AI 报告里常见的管道表格（含 :--- 左/中/右对齐）
• 修正列表项之间残留多余间隙的问题
• 统一换行处理（CRLF → LF、去掉首尾空白），存量条目开头不再多出一个空行
• 补全知识库正文的排版样式；对话气泡与灵感页同步补上表格、分隔线样式，避免出现无边框的裸表格

渲染是展示层修复，存量知识条目无需重新生成，打开即正常。

v0.8.2 · 拆文分析结果可追溯 + 对话可点选选项

拆文分析

• 报告现在会同步写入知识库（来源标记为「拆文分析」、类型「参考资料」），可在知识库页直接检索，不再只躺在 reports/ 目录里找不到
• 分析完成后弹出入库提示，并在文件详情里常驻显示报告的完整落盘路径（可选中复制）
• 知识库列表补充来源与类型的中文标签（世界观 / 人物 / 剧情 / 文风 / 参考资料等）

对话选项

• 新增「可点选选项」：让墨参给几个方向/方案时，会渲染成按钮，点一下即把该方案作为你的回复发出，继续对话
• 提示词补充对应契约，并明确与「待确认提案」「直接写入」的使用边界

关键修复

• 对话消息此前以普通对象直接改属性，绕过了 Vue 的响应式代理，导致提案卡片不出现、流式文字不实时更新、"忽略"点了没反应。现已改为响应式对象
• 修正 SSE 事件解析中事件名未随空行复位的问题

v0.8.1 · 星图分析等待层可收起 / 暂停 / 继续 / 停止

• 收起：等待层右上角新增「收起」按钮，收起后任务与进度订阅都不中断，页面完全可交互；右下角留一个常驻胶囊（任务名 + 计数 + 细进度条），点击展开。失败/中断时自动展开
• 暂停/继续：批次之间新增等待闸门。模型调用一旦发出无法打断，因此暂停语义为「当前批次跑完就停」，界面分别显示「正在完成当前批次…」与「已暂停」
• 停止：新增取消接口，直接取消后台任务。分析结果只在全部批次跑完后才落盘，停止不会写坏已有星图数据；因已发起的调用费用不退，前端会先弹确认
• 修复：asyncio.Event 默认未置位，若直接用作暂停闸门会让星图分析卡在第一个批次前无法开始；已新增覆盖该场景的测试
• 顺带清理了 main.py / index.html 中的 UTF-8 BOM

---

下载与升级

• 安装包：MoShen-Setup-0.8.3.exe（Windows x64）
• 免安装绿色版：release/win-unpacked/ 打包后同步覆盖到桌面目录即可，升级无需迁移数据

兼容性

• 工作区与项目数据格式未变更，直接覆盖升级即可
• 知识库新增的 source: analysis 类型条目为增量数据，不影响原有条目

墨参 MoShen v0.8.0

启动与等待：整套「笔墨化剑」加载动画

这个版本把墨参所有"等待感"场景重做了一遍：启动页换成品牌动画，长流程任务第一次有了真实进度条。

新增：动画 1「笔墨化剑」

• 以「笔、墨、纸」为母题：一笔落墨、墨尽化剑、横斩留痕，一轮 2.9s 无缝循环
• 由美术交付的 6 张素材（笔尖 / 墨晕墨点 / 飞白笔刷 / 剑气辉光 / 深浅两版签名帧）拆分为
  「墨迹层 + 剑光层」合成，定格帧与美术稿完全一致
• 双主题：深色启动页用品牌紫墨，浅色主界面用深墨蓝墨迹 + 朱砂剑光。同一套素材换色，
  而不是导出两份动画
• 主体占画布约 85% 宽度，缩到 120px 仍能分辨「弧」与「横斩」两条线
• 系统开启「减少动效」时停在定格签名帧做缓慢呼吸，不播放运动；动画资源加载失败回退原有圆环；
  低性能设备连续丢帧会自动切定格帧；窗口最小化时暂停且恢复后不重置进度

新增：动画 2「进度条」

• 名称居左、计数居右同排显示（等宽数字，数字变化时标签行不会跳动）
• 六种状态：不确定 / 进行中 / 等待响应 / 完成 / 失败 / 中断
• 等待响应：超过 20s 没有新进度时，填充头部改为呼吸闪烁，名称后追加
  「（等待模型响应…）」。单次模型调用最长可静默数分钟，此前用户会以为程序卡死
• 完成时填充到 100% 并有一次自左向右的高光扫过；失败停在当前比例并给出「重试 / 关闭」，
  不自动消失；总量未知时切为不确定态亮带横穿

新增：全局等待层

• 所有长流程任务共用同一层：动画 1 居中（略高于几何中心），动画 2 落在底部安全区
• 可展开「详情」查看原始日志 —— token 消耗、保护条目数、跳过文件清单等原有信息都保留，
  只是不再占据主视觉

改动：启动页

• 启动页由内联文档改为真实文件，以便加载外部动画资源；错误兜底页配色与动画 1 深色主题统一
• 主界面首帧就绪后有一层 0.28s 淡出遮罩，掩盖原先从启动页到主界面的硬切换
• 加载过快时不再直接进主界面：后端通常 1s 左右就绪，而一轮动画 2.9s，
  现在会等当前这一轮播完再切，保证用户总能看到从「落笔」到「消散」的完整一轮动画

改动：进度上报（后端）

• 新增统一进度事件契约 GET /api/tasks/{task_id}/progress（SSE），并补齐周期性心跳帧
• 已接入真实进度的任务：星图分析（按批次）、蒸馏学习（按章节）、肖像批量生成（按张数）
• 单步任务（拆文分析、伏笔检测、回收检测、知识搜索）按 0/1 → 1/1 上报；
  总量未知的任务走不确定态，不会假装有进度

修复

• 星图分析的完成判定此前依赖字符串全等比较（msg === '分析完成'），后端文案一改，进度条就会
  永远停在进行中；改为按结构化状态字段判定
• SSE 断线时只关闭连接、不复位任务状态，按钮会永久卡在「分析中…」；现在会进入中断态并提供重试
• 肖像批量生成的逐条进度回调此前被丢弃，等待期间用户看不到任何中间反馈
• 补齐 SSE 心跳帧，前端得以区分「模型在思考」与「连接已断」，「等待响应」态才成立

兼容性

配置与项目数据格式未变，绿色版仍是覆盖式升级，直接覆盖即可。启动页动画会在 2.9s 内被完整播放，
冷启动总时长最多增加约 2.9s（平均约 1.5s）。

墨参 MoShen v0.7.9

安全修复：接口不再下发明文 API Key

GET /api/config 此前会直接返回全部 api_key 明文（默认 API / 各职能 / 生图 / 各渠道）。
任何能访问本机接口的一方（浏览器 devtools、本机其它进程、日志与调试面板）都能直接读到密钥。

本次把这个面收掉，同时保证配置功能不打折。

修复

• 读取掩码：接口返回的 api_key 一律为 ********，明文只在后端进程内流转（chat、生图等内部调用不受影响）
• 保存安全：密钥留空或回传掩码 = 保持不变。只改模型名、温度、Base URL 不会误抹已存密钥
• 显式清除：新增「清除 / 撤销」按钮。留空不再等于删除，删除必须显式声明（clear_keys）—— 既避免误抹，也保留删除能力
• 切换渠道：「切换到某渠道」改为服务端完成密钥复制（POST /api/config/apply-channel），密钥不再经过浏览器
• 已保存的密钥不会回填到设置页输入框，只显示「已设置」状态

设置页行为变化（请注意）

• 密钥输入框默认留空并标记「已设置」；留空保存 = 保持原值
• 要删除密钥：点该字段的「清除」按钮（显示「将清除」），再保存
• 「切换到某渠道」即时生效并落盘（此前需要再点「保存」）

其它

• 新增回归测试目录 backend/tests/（标准库 unittest，11 例，无需额外依赖）

  python -m unittest discover -s backend/tests -t backend -v
  

• 老配置无需迁移；旧版前端即使仍明文回填并原样回传也依然可用（回传的明文会被识别为新密钥）

兼容性

配置格式未变，仍保存在 ~/.moshen/.env。

---

感谢 @anupamme 在 #5 中提出掩码方案 —— 描述里关于「保存往返」的推理很关键，正是它让「无法清除密钥」与「切换渠道静默失效」这两处回归暴露出来。完整实现在 #6。

墨参 MoShen v0.7.0

星图：可以手动维护，且 AI 不会再覆盖你的内容

这个版本主要重做了「星图」的更新机制。

新增：手动维护条目与关系

• 档案库可新增 / 编辑 / 删除条目：名称、别名、分类、权重、简介、档案正文、人物要素
• 关系图可新增 / 编辑 / 删除关系；改名与改分类会自动级联（关系引用、档案、肖像一并迁移）
• 关系图交互：右键节点、右键连线、空白处右键（新建条目 / 刷新数据 / 重新布局 / 重置视角 / 去分析）、
  拖拽节点调整位置、连线模式（点起点 → 点终点）
• 手动维护的内容用金色标出，与 AI 生成内容区分

改进：分析改为「增量更新」

• 以前 AI 每轮输出完整 JSON 整份覆盖，只有手动内容受保护；AI 生成的条目会被整条重写，
  累积的细节可能被改写或丢失
• 现在 AI 只提交「变更补丁」：只写发生变化的字段 / 条目 / 关系，未提及的内容一律原样保留
• 随剧情推进可只更新必要字段（例如角色升官只改 identity），也可显式作废条目（需写明依据）
• 手动创建、手动编辑过的字段、显式锁定的条目都不会被 AI 改写或删除；档案正文 AI 永不写入
• 重新分析前若检测到手动内容，会让你选择「保留手动内容」或「覆盖手动内容」
• 分析完成后逐类型报告：新增 / 更新 / 删除 / 被保护的数量

修复

• 条目名含 :、* 等字符时，档案能生成却读不到（404）
• AI 改写已有条目后，条目档案 Markdown 不刷新的问题

其他

• 重新分析不再有"清空重来"路径，历史积累不会因一次误操作丢失
• 无条目的关系图待机画面重做

墨参 MoShen v0.6.12

墨参 MoShen v0.6.12 · Windows 安装版

本版本为 0.6.12 的 Windows 安装包发行版，功能与 0.6.12 源码一致。

安全加固

• 新增 Host 头校验：服务端仅接受 Host 为 127.0.0.1 / localhost / ::1 的请求，其余一律返回 400。
• 背景：v0.6.11 已移除会反射任意来源的 CORS 中间件，跨站读取通道随之关闭；但服务端此前未校验 Host，理论上仍存在 DNS rebinding 通道 —— 恶意域名重新解析到 127.0.0.1 后，浏览器会把请求视为同源，无需 CORS 即可读取响应。本次一并封堵。
• 该改动不影响前端行为，本地使用体验与以往完全一致。

安装

• 安装程序：MoShen-Setup-0.6.12.exe（x64 / NSIS）
• 安装时可自选安装目录，支持创建桌面快捷方式

校验

• SHA256: E90E49ECED4002EB8F41D5ED548CF5C0507CF2608C1FA32DC7ED5F14EFD358CB

墨参 MoShen v0.6.11

墨参 MoShen v0.6.11 · Windows 安装版

本版本为 0.6.11 的 Windows 安装包发行版，功能与 0.6.11 源码一致。

安全修复

• 移除后端 CORS 中间件：此前 allow_origins=["*"] 与 allow_credentials=True 的组合会使服务端反射任意来源，导致任意网页可通过跨域请求读取 /api/config 并窃取其中保存的 API Key。现已封堵；前端由本服务同源提供，不再需要 CORS。
• 收窄本地服务监听地址，开发与桌面入口均仅绑定 127.0.0.1。
• 修复上传与知识库读取的路径穿越（越界读写）问题。
• 升级 python-multipart 至 0.0.32，覆盖多个已知漏洞。

安装

• 安装程序：MoShen-Setup-0.6.11.exe（x64 / NSIS）
• 安装时可自选安装目录，支持创建桌面快捷方式

校验

• SHA256: 12115DFBD056764B0A575C47095A0747123D82EC4D24BD722F8EB8A41839FD6C

墨参 MoShen v0.5.4

墨参 MoShen v0.5.4 · Windows 安装版

本版本为 0.5.4 的 Windows 安装包发行版，功能与 0.5.4 源码一致，重点提供可直接双击安装的单文件安装程序。

新增

• Windows 单文件安装程序：墨参 MoShen-Setup-0.5.4.exe（x64 / NSIS）
• 安装时可自选安装目录，默认 %LOCALAPPDATA%\Programs\墨参 MoShen
• 自动创建桌面与开始菜单快捷方式
• 安装完成页可勾选「立即运行」

改进

• 修复后端启动时弹出黑色命令行窗口的问题
• 安装包体积优化：裁剪 Electron 多语言包（仅保留简体中文/英文）+ 最高压缩，安装包约 86 MB
• 系统「程序和功能」中显示中文名称「墨参 MoShen」

安装与卸载

• 免管理员权限（用户级安装，不触发 UAC）
• 卸载后保留 %USERPROFILE%.moshen 下的作品与配置数据
• 目标机器无需预装 Python 或 Node

校验

• 文件：墨参 MoShen-Setup-0.5.4.exe
• 大小：86.4 MB
• SHA256：CD3554CF079FD6A48977B56CF61BDD3810E2AA242535303AB098EF1F1F834A0B

已知说明

• 本安装包未做代码签名，首次运行可能被 Windows SmartScreen 拦截，请点「更多信息 → 仍要运行」
• 系统要求：Windows 10 / 11 x64