参赛项目名称
叙镜 StoryLens｜小说结构与读者旅程可视化分析工具
团队 / 作者
个人开发者：@fanjack510-ctrl
我做了什么
StoryLens（叙镜）是一款面向小说作者、网文创作者和写作学习者的本地优先 AI 拆书与可视化分析工具。
很多创作者在拆解优秀小说时，只能凭阅读感觉判断一章写得好不好，却很难准确看清：章节由哪些场景构成、情节如何推进、读者的注意力在哪里发生变化，以及节奏、张力和情绪是如何被逐步建立起来的。
StoryLens 将这一过程变成了一条可以检查和追溯的分析流程：
- 导入小说章节文本；
- 自动识别场景边界，并允许作者人工审阅和修正；
- 使用阿里云百炼通义千问分析场景作用、剧情推进和读者体验；
- 将阅读张力、情绪变化、节奏速度等结果转化为可视化读者旅程；
- 每个判断都可以回到对应的原文证据，而不是只输出笼统结论；
- 支持 PNG、JSON 和 Markdown 等格式导出，方便继续拆解、学习和复盘。
项目采用本地优先架构，小说文本、分析结果和任务数据主要保存在用户本机。用户使用自己的阿里云百炼 API Key，不需要把私人稿件上传到 StoryLens 自建服务器。
我希望通过 StoryLens，把过去依赖经验和感觉的小说拆解过程，转化为一种更加直观、结构化、可复核的写作学习方式。
使用的工具
- OpenWork / 百炼 CLI：未使用 OpenWork；StoryLens 通过阿里云百炼 API 直接接入通义千问模型
- 百炼能力 / 模型：通义千问长文本理解、结构化信息提取与文本分析；Provider 为
aliyun_qwen_plus，默认模型为 qwen3.7-plus - Skill 名称：暂无独立发布的 Skill，目前采用应用内多阶段分析工作流和结构化输出约束
- 其他：
- Cursor、OpenAI Codex：需求拆解、代码实现、调试与工程验收
- React、Vite、Tauri：Windows 桌面客户端
- Python、FastAPI：本地分析服务
- SQLite：书籍、章节、任务和分析结果持久化
- PyInstaller：本地分析服务打包
- GitHub：源码管理、版本治理和问题追踪
效果展示
StoryLens 当前可以完成“章节导入—场景边界审阅—场景分析—读者旅程—证据查看—结果导出”的完整流程。
主要效果包括：
- 将一章小说自动拆分为多个可审阅场景；
- 展示不同场景承担的叙事作用；
- 通过曲线观察剧情推进、阅读张力、情绪变化与节奏速度；
- 点击分析节点可查看对应的原文依据；
- 支持任务中断恢复和历史分析结果查看；
- 支持 PNG、JSON、Markdown 等格式导出。
演示视频
请在这里补充一段 60—90 秒的操作演示视频：
[演示视频链接]
界面截图
建议依次插入以下截图：
- 书籍与章节导入界面；
- 场景边界审阅界面；
- 综合读者旅程曲线；
- 单项张力或节奏曲线；
- Inspector / Evidence 原文证据界面。
项目链接
踩坑记录
1. 大模型输出并不天然稳定
长文本分析过程中，模型可能出现结构化结果缺字段、格式不一致或输出被截断的问题。项目因此没有直接把模型回答展示给用户，而是增加了结构校验、阶段化分析、错误反馈和任务恢复机制。
2. 场景边界不能完全交给模型决定
小说中的场景切换并不总是由时间、地点变化决定，还可能来自视角、任务或冲突目标的变化。为避免模型一次判断直接影响全部后续分析，StoryLens 增加了“自动识别—人工审阅—确认后分析”的流程。
3. 可视化结论必须能够回到原文
仅给出一个分数或一条曲线，很容易产生“看起来很专业，但无法验证”的问题。因此每个关键节点都尽量保留原文证据、场景位置和解释信息，让创作者能够判断结论是否合理。
4. 桌面应用比网页 Demo 更复杂
StoryLens 同时包含桌面前端、本地 API、SQLite 数据库、模型调用和 Windows 安装包。开发过程中需要额外处理资源路径、进程启动、任务恢复、本地数据安全以及开发环境与安装环境不一致等问题。
参赛项目名称
叙镜 StoryLens｜小说结构与读者旅程可视化分析工具
团队 / 作者
个人开发者：@fanjack510-ctrl
我做了什么
StoryLens（叙镜）是一款面向小说作者、网文创作者和写作学习者的本地优先 AI 拆书与可视化分析工具。
很多创作者在拆解优秀小说时，只能凭阅读感觉判断一章写得好不好，却很难准确看清：章节由哪些场景构成、情节如何推进、读者的注意力在哪里发生变化，以及节奏、张力和情绪是如何被逐步建立起来的。
StoryLens 将这一过程变成了一条可以检查和追溯的分析流程：
项目采用本地优先架构，小说文本、分析结果和任务数据主要保存在用户本机。用户使用自己的阿里云百炼 API Key，不需要把私人稿件上传到 StoryLens 自建服务器。
我希望通过 StoryLens，把过去依赖经验和感觉的小说拆解过程，转化为一种更加直观、结构化、可复核的写作学习方式。
使用的工具
aliyun_qwen_plus，默认模型为qwen3.7-plus效果展示
StoryLens 当前可以完成“章节导入—场景边界审阅—场景分析—读者旅程—证据查看—结果导出”的完整流程。
主要效果包括：
演示视频
请在这里补充一段 60—90 秒的操作演示视频：
[演示视频链接]
界面截图
建议依次插入以下截图：
项目链接
踩坑记录
1. 大模型输出并不天然稳定
长文本分析过程中，模型可能出现结构化结果缺字段、格式不一致或输出被截断的问题。项目因此没有直接把模型回答展示给用户，而是增加了结构校验、阶段化分析、错误反馈和任务恢复机制。
2. 场景边界不能完全交给模型决定
小说中的场景切换并不总是由时间、地点变化决定，还可能来自视角、任务或冲突目标的变化。为避免模型一次判断直接影响全部后续分析，StoryLens 增加了“自动识别—人工审阅—确认后分析”的流程。
3. 可视化结论必须能够回到原文
仅给出一个分数或一条曲线，很容易产生“看起来很专业，但无法验证”的问题。因此每个关键节点都尽量保留原文证据、场景位置和解释信息，让创作者能够判断结论是否合理。
4. 桌面应用比网页 Demo 更复杂
StoryLens 同时包含桌面前端、本地 API、SQLite 数据库、模型调用和 Windows 安装包。开发过程中需要额外处理资源路径、进程启动、任务恢复、本地数据安全以及开发环境与安装环境不一致等问题。