Type Help Notes App

一个为 Type Help 页游设计的本地笔记工具：

• 记录卷宗与线索
• 串联卷宗提及关系
• 从人物与时空维度快速回查

本工具独立于游戏文件运行，不会修改游戏本体。

快速开始

1. 打开目录 type-help-notes-app
2. 双击 index.html
3. 建议与游戏页面并排使用

核心规则

卷宗标题标准化

卷宗标题建议格式：时间-地点-人物1-人物2-...，例如：

• 03-LI-1-4-5-6-7-8-9
• 01-QU-1-11

保存时会自动标准化：

• 时间补零：3 -> 03
• 地点大写：li -> LI
• 人物编号去重并排序
• 全局唯一（忽略大小写）

自动保存

当前版本大多数编辑为自动保存：

• 卷宗标题、备注
• 线索描述、已处理状态、提及列表
• 人物名字、备注（失焦时保存）
• 人物关系图增删关系

功能总览

1) 工作台

左侧是卷宗列表，右侧是卷宗详情。

卷宗列表

• 仅显示 标题 + 未处理/总线索数
• 颜色语义：有未处理线索为红色，全部处理完为绿色
• 支持筛选：
  • 标题/备注关键词
  • 时间
  • 地点
  • 人物编号（支持逗号分隔多个，表示“同时出现”）
  • 仅看有未处理线索

卷宗详情

• 基础信息：标题、备注（自动保存）
• 线索区：
  • + 新增线索
  • 每条线索可折叠
  • [x]/[ ] 直接切换已处理状态
  • - 删除线索
  • 提及 支持添加多个卷宗标题
• 被提及区：自动显示“哪些卷宗提及了当前卷宗”

跳转行为

• 提及目标若已存在卷宗：可直接点击跳转
• 目标未创建：先显示普通文本，未来创建后自动可跳转

2) 时空视图

人物 x 时间矩阵

• 行：人物
• 列：时间
• 单元格显示该人物在该时间出现的地点
• 点击地点可跳转卷宗

卷宗提及图（有向图）

• 节点：卷宗标题
• 边：A -> B 表示 A 的线索提及了 B
• 未创建卷宗：灰色虚线节点
• 已创建卷宗：可点击跳转

布局与交互：

• 节点按时间尽量从左到右排列（动态布局）
• 悬停节点时，高亮其一跳子图（入边+出边），其余淡化
• 节点、线条、箭头、文字已放大以提升可读性

3) 人物视图

两列布局：

• 左列：人物关系图（上）+ 人物列表（下）
• 右列：人物详情

人物关系图

• 支持“连线模式”：从起点拖到终点创建关系
• 支持删除关系
• 双向关系会分离显示以减少重叠
• 悬停节点高亮相关子图，其余淡化

人物详情

• 显示：ID、名字、备注、时间线、被指向关系、出现卷宗
• 支持删除人物（双重确认）

删除人物会级联：

• 删除该人物相关关系
• 从相关卷宗标题中移除该人物编号并重算标题
• 同步更新线索中的提及标题映射
• 若会造成标题冲突则拦截并提示

数据与安全

导出 JSON

• 导出当前完整快照
• 建议每次大改前后各导出一次

导入 JSON

• 导入会覆盖当前本地数据
• 建议导入前先导出备份

重置/清空

• 顶栏红色 重置/清空 按钮
• 双重确认后清空所有本地数据（不可恢复）

新手指南（精简版）

1. 先在工作台用 + 建立卷宗，优先保证标题规范。
2. 每个卷宗只先记最关键线索，不追求一次写全。
3. 线索有可操作价值再标 [ ]，处理后改 [x]。
4. 发现卷宗之间关联时，在“提及”里补目标标题。
5. 每轮推理后切到时空视图检查：
   • 是否出现新的时间/人物分布
   • 提及图是否出现新的关键链路
6. 关系明确后再进人物视图补关系，避免过早建太多噪音关系。
7. 每次阶段结束导出 JSON 备份。

常见提醒：

• 标题被改写通常是标准化正常生效。
• 提及无法点击通常是目标卷宗尚未创建。
• 删除失败常见原因是会引发卷宗标题冲突。

TODO（未来可扩展）

以下是后续可做但当前未实现/未完成的方向：

• 关系图节点手动拖拽与位置持久化
• 图视图筛选（按时间段、人物组、关键词）
• 卷宗/人物标签体系与标签过滤
• 批量操作（批量改状态、批量删除/合并）
• 撤销/重做（Undo/Redo）
• 更强的导入校验与冲突修复向导
• 快捷键体系（新建、搜索、跳转）
• 只读分享模式（导出静态快照）
• 自动测试与版本迁移脚本

---