- 新版设计各域 SoT 按本轮实现同步:总体架构、模块设计、接口契约、数据模型、功能规格、文件设计与决策记录。 - 接口契约生成物重新导出(openapi 与前端客户端随契约一致)。 - 实现回顾与专项检查台账保留历史结论;本轮收尾发现另见 .agents.local 下的收尾报告与审查处置。
24 KiB
24 KiB
目标系统完整功能清单
版本:2026-09-08。状态:目标目录草案,供确认范围;不表示当前实现状态,也不是首轮开发承诺。
目标形态:个人自用,以 agent-example 为业务与数据主体,采用 StoryForge 的小说交互与视觉风格,吸收其他项目中适合的能力。覆盖从研究选题到完本交付、反馈和跨书复用的全过程。
沿用已确认的 F01–F20 和原有 117 个功能编号,补充 12 个针对本方案展开的目标项,共 20 个功能域、129 个目标功能项。基础定义和比较口径见 小说创作共性功能清单(原路径 ../../../../../docs/业务需求/小说创作共性功能清单.md,已随旧实现退出,见固定基线)。新版模块归属、数据模型、元数据及增改删方案以新版 agent-example 完整架构为入口;上一版增改删清单保留历史比较依据。
目标范围
- 完整目标:F01–F20 全部纳入,包括定稿、连载反馈、可审计运行、经验验证与完整恢复;实施顺序另定。
- 交互与权威:页面采用 StoryForge 风格;正式内容由 agent-example 管理。人工保存、AI 候选采纳、事实确认、偏好确认和方法启用分别处理。
- 可选扩展:节点式规划与短篇创作列于目录末尾,复用相同数据和治理。
完整功能目录
F01 创作目标与作品管理
- F01.01 作品定位:记录作者想写什么、题材、受众、阅读体验、主题、作品规模与约束,允许保留尚未决定的部分。
- F01.02 作品档案:管理多部作品、系列与卷章组织,区分筹备、写作、暂停、完本和修订状态。新建正常作品不需要修改程序或登记样本常量。
- F01.03 创作计划:设置阶段目标、写作节奏和任务优先级;作者能够调整计划。
- F01.04 真实进度:根据已确认规划、正式章节、待审候选和未解决问题展示进度,区分生成字数与采纳字数。
F02 扫榜、选题、素材研究与拆书
- F02.01 灵感收集:保存片段、感受、人物念头、对白、场景、意象和问题,允许碎片先于结构存在。
- F02.02 资料导入:导入参考书、旧稿、笔记和外部资料,保留原文、来源、位置和使用范围。
- F02.03 素材整理:分章、标记、去重、关联、搜索与引用,区分原文摘录、作者笔记和模型推断。清理广告、乱码等噪声时保留原始来源和清理记录。
- F02.04 资料研究:围绕历史、职业、地域、科技等创作问题查证;冲突来源和不确定内容保持可见。
- F02.05 作品拆解:从参考文本反向提取结构、人物关系、节奏、叙事手法和正反案例,保留证据后进入待审材料。覆盖章纲、场景、阶段结构与范式,原书事实和跨书写法分别处理。
- F02.06 榜单数据获取:支持按平台、榜种、题材导入榜单或按需采集,兼容人工整理数据;来源不可用或数据不完整时明确记录,不以模型旧知识冒充当前榜单。
- F02.07 榜单观察快照:记录平台、榜种、采集时间、排名、样本字段、来源页面和数据质量,保留历次观察以供回查。
- F02.08 样本比较与选题:比较同榜和跨时期样本的题材、开篇卖点、篇幅与表现;区分个例和趋势候选,结合作者兴趣与素材条件形成选题建议,不承诺市场结果。
- F02.09 选书交接:将选中的榜单样本或参考作品转入资料、拆书或构思流程,保留从选题理由到参考书及分析任务的来源关系。
- F02.10 拆书任务控制:选择整书、章段和分析目标;查看分章与窗口进度,暂停、取消、续跑及重试失败部分。
- F02.11 原文与分析对照:并排查看原文、章段结构和分析结论;从卡片或判断跳回原文,检查引文与位置是否符合指定版本。
- F02.12 分析版本管理:保存、比较和选用不同拆书结果;区分处理中、部分完成、待复核、已选用和历史版本,分析完成不自动成为本书设定或有效写法。
F03 渐进式构思与方案比较
- F03.01 从局部开始:支持从一个人、一段关系、一个场面或一种表达欲望开始,不要求先填完设定表。
- F03.02 逐步发展:素材、联系、暂定中心与局部结构可以往返推进、暂停和重组。交互承接收集素材、发展联系、试探中心、组织结构、比较分歧、整理交付六个子阶段,不要求每次完整走完。
- F03.03 局部比较:围绕真实分歧给少量可比较方案,说明它们改变了什么、保留了什么及可能后果。
- F03.04 决策记忆:区分作者原话、已接受方向、模型设想、被放弃方案和未决问题,减少重复讨论。重新打开后能够继续先前讨论。
- F03.05 正式交接:作者选择方向后,再形成待确认的作品规划;探索笔记与正式设定有清楚边界。保存探索稿不触发正式设定入库,也不使其自动进入正文事实上下文。
F04 世界设定与规则管理
- F04.01 世界资料:组织时代、地理、组织、制度、文化、职业、技术或力量体系等作品需要的设定。按作品题材呈现相关字段,支持力量、修炼、职业或技术发展等需要持续追踪的体系。
- F04.02 规则与代价:记录能力边界、资源限制、行动代价、例外及其适用条件。
- F04.03 实体关联:把地点、组织、物品、事件和人物关联起来,减少同名异物、别名混乱与孤立设定。
- F04.04 设定修订:修改设定时,展示受影响的规划、正文和状态,保留作者裁决与版本。
- F04.05 设定使用追踪:知道某项设定在哪里首次出现、如何被使用、是否闲置以及是否需要收口。
F05 人物、关系、成长与叙事视角
- F05.01 人物建构:组织欲望、目标、动机、恐惧、信念、矛盾、能力和行动选择。
- F05.02 关系发展:维护亲疏、信任、利益、冲突和关系变化,关联引发变化的事件。支持关系图谱与按章节查看。
- F05.03 人物弧线:连接人物在不同阶段的目标、压力、选择、代价和变化,支持群像及多线叙事。
- F05.04 人物声音:区分口癖、语域、称谓、表达策略和说话习惯,避免不同人物共享同一种声音。
- F05.05 视角设计:管理叙述者、焦点人物、叙述距离和信息可见范围,支持视角切换与不可靠叙述。
F06 故事结构与分层规划
- F06.01 全书结构:组织主要矛盾、主线、支线、主题推进、转折、高潮和结局方向。
- F06.02 多层规划:支持全书、大纲、卷纲、章纲、场景之间的细化与回溯,上层意图能够传递到下层。通过树、卡片与正文关联呈现同一套规划。
- F06.03 章节任务:写清本章目标、必须发生与不能提前发生的内容、参与实体和预期变化。
- F06.04 场景设计:安排视角、时间地点、行动目标、阻力、因果、信息释放和场景落点。
- F06.05 节奏安排:检查冲突、铺垫、日常、解释、行动、情绪和兑现的分布,并允许按题材调整。
- F06.06 规划调整:能拆章、合章、调整顺序、重组支线,提示依赖影响,同时给正文创作保留余地。
- F06.07 滚动细化:保持全书方向和已确认规划,优先细化近期章节;依据已采纳正文与事实提出后续调整候选,由作者决定是否采用。
F07 情节承诺与长篇连续性
- F07.01 截至某章的事实:能够查看某一章节之前已经确认的事实与状态,未来计划单独保留。
- F07.02 人物动态状态:追踪位置、伤势、物品、能力、关系阶段以及人物获知信息的时间。
- F07.03 时间与因果:区分故事发生顺序和文本叙述顺序,检查旅行、年龄、事件前置条件等连续性。
- F07.04 伏笔与承诺:登记伏笔、悬念、读者期待、章末钩子及其铺设、推进、兑现、延期或取消。
- F07.05 章后状态增量:从采纳后的正文抽取事件、实体、关系及状态变化,形成待审增量;只有被接受的增量才进入正式事实。
- F07.06 连续性纠错:发现矛盾时指出冲突两端的原文与版本,支持改正文、改计划或由作者确认设定修订。
F08 写前准备与可控上下文
- F08.01 本次写作准备:组合作者本轮意图、已确认细纲、相关事实、参与人物、活跃伏笔和近期正文。
- F08.02 历史证据检索:按人物、事件、时间和问题找到过去的原文片段,不只返回滚动摘要。
- F08.03 写法与样例选取:选择适合当前题材、场景和任务的方法及样例;支持在规划期确认本作采用的方法和版本,写作期按绑定消费,升级或改用其他方法由作者决定。
- F08.04 优先级与预算:重要约束受到保护;材料过多时能说明哪些被选择、裁剪或省略。工作台展示必读来源和材料取舍,实际执行仍遵守任务合同。
- F08.05 时间与状态边界:候选、未确认知识和未来信息不能悄悄混入当前章的正式事实。预组装、工具探索与回放均执行本次任务的作品、来源和时间约束。
- F08.06 上下文留档:保存实际输入的来源、版本和组合结果,作者能够检查 AI 当时看到了什么。可回查实际读到的原文、事实、范式、研究资料与作者偏好。
- F08.07 混合检索:结合专名、关键词、全文、语义向量及结构化筛选查找材料;显示命中依据、来源版本和索引状态,支持重建失效索引。
F09 正文生产与人机共创
- F09.01 多粒度写作:支持新写、续写、场景扩写、指定选段重写、压缩和表达润色,明确各自范围。
- F09.02 创作空间:允许写手在授权范围内提出新事件和细节,并作为候选交给作者判断。
- F09.03 写作协作:作者可手写、批注、补充指令、锁定片段、比较候选及采用部分结果。
- F09.04 流式与中断:可查看生成进度,随时停止;保留有价值的部分输出,并明确其未完成状态。
- F09.05 分阶段生成:支持准备、写作、检查、返修之间的交接,批量写章也遵守作品和章节依赖。
- F09.06 范围保护:选段任务保护范围外正文;事实新增、表达修改和结构改写具有不同的授权含义。
- F09.07 稿件保存与编辑保真:支持人工保存与自动保存,显示保存中、已保存、失败及未提交缓冲;断网、快速切章或刷新时保护编辑内容,保持中文输入、段落与选区往返一致。
F10 多层审稿与问题管理
- F10.01 基础有效性:检查截断、空内容、格式损坏、占位符、模型自指和任务输出不完整等问题。
- F10.02 连续性审查:检查人物状态、时间、因果、世界规则、视角及知识边界。
- F10.03 创作质量审读:评议人物选择、冲突推进、情绪、节奏、信息增量、重复和场景功能。
- F10.04 具名问题单:每个问题关联原文、原因、影响范围、严重程度和可选修法,允许保留分歧。
- F10.05 返修追踪:记录问题被修复、保留、否决、延期或转人工的状态,复审绑定实际修订版本。问题与裁决持久保存,刷新后可继续处理,旧版本结论明确失效。
- F10.06 检查边界:确定性检查与语义审读分别呈现,低置信判断保留不确定性;调用失败有独立状态。
F11 去 AI 味、声音保护与受控修订
- F11.01 建立声音基线:从作者认可的样张与正文中整理本作叙述声音、人物声音、正样例和保护片段。支持从定稿和人工修改对中选样,学习结果经确认后启用。
- F11.02 写前预防:按场景选择已确认的写法约束与样例,减少套话、解释腔、机械节奏和人物同声。
- F11.03 精确诊断:定位具体片段中的空泛表达、模板结构、无功能重复、库存微动作、过度解释等问题。
- F11.04 功能判断:每个命中结合语境进入“修、留、问”,保护口癖、悬念、节奏、修辞和场内文本的功能。
- F11.05 最小编辑:优先删除无功能冗余、压缩或局部改写;结构问题可以提出范围明确的改写方案。
- F11.06 改后保真:核对事实、人物声音、视角、因果、场景落点、伏笔和未授权区域,语义不确定项明示待复核。
- F11.07 停止与回退:允许零修改、原文胜出和回退;限制循环次数,避免为了内部评分持续改坏文本。
- F11.08 案例回流:把误杀、有效修改、作者拒绝、边界案例及修订事故保存为可追溯证据。
F12 全书打磨、定稿与交付
- F12.01 全书回看:按完整作品检查主支线、人物弧线、主题推进、前后呼应、未兑现承诺和遗留设定。
- F12.02 跨章修订:支持定位、批量处理和复核跨章重复、称谓漂移、风格变化及结构问题。
- F12.03 文字校对:统一专名、称谓、数字、标点、格式和目录,保留有意设置的例外。
- F12.04 定稿版本:区分工作稿、作者定稿和已交付版本,保留各版本之间的更改记录。
- F12.05 文稿输出:按需要导出 TXT、Markdown、DOCX、EPUB 等格式,并能检查章节顺序、内容完整性和排版结果。
- F12.06 交付材料:从已确认内容形成书名候选、梗概、简介、人物表等配套材料,经作者定版后使用。
F13 连载节奏与读者反馈
- F13.01 连载计划:管理待写、待审、存稿、待发布和已发布章节,以及更新时间与章节依赖。
- F13.02 发布版本对应:记录某次交付使用的正文版本,后续修订可以追到受影响的已发布内容。
- F13.03 反馈归集:导入或手工记录读者、编辑和试读者反馈,关联具体章节、版本和问题。
- F13.04 反馈辨析:区分事实错误、阅读困惑、个体偏好和题材预期,与作者意图一起判断。
- F13.05 调整与复盘:把被作者接受的反馈转成修订任务或后续创作假设,观察调整后的效果。
F14 作者决策权与版本管理
- F14.01 候选与正式内容分离:模型输出先作为可审阅候选,正式内容有清楚的确认入口。界面区分本地审查认可、保存人工正文与正式采纳,以实际写入结果显示状态。
- F14.02 多种决策动作:作者可以查看、修改、部分采纳、丢弃、重试或暂缓,并看到动作后果。
- F14.03 分别确认:正文、规划、抽取事实、声音档案、经验方法和规则有各自的确认范围。
- F14.04 版本与差异:保存分支、快照、差异、决策和撤销路径,保护人工改动。
- F14.05 陈旧结果隔离:正文或规划变动后,旧检查、摘要、候选和审批不能继续套用到新版本。
- F14.06 修改影响追踪:设定修订或章节重排时,找出受影响的事实、索引、规划、审稿与下游章节。
F15 可审计的运行与内容来源
- F15.01 输入记录:保留作者指令、任务范围、事实快照、实际上下文和使用的材料版本。
- F15.02 执行记录:记录模型、提示词或 Skill 版本、可见工具调用、参数、耗时、用量和错误状态。
- F15.03 产物记录:保存生成候选、检查结果、修订差异、作者决策与正式写入结果之间的关联。
- F15.04 内容追源:审稿问题、事实变化、经验卡和规则建议都能定位到相应原文或反馈事件。
- F15.05 审计视图:按作品、章节、一次任务或一个问题查询过程,解释选择、省略、修改与拒绝的可观察依据。
- F15.06 可重查与回放:能够读取当时输入和产物、重新检查确定性步骤,并区分同一输入的新模型输出。
F16 可靠执行、失败恢复与成本控制
- F16.01 任务状态:明确区分进行中、待审、失败、取消、部分完成、降级、陈旧和已采纳。
- F16.02 暂停与恢复:长任务可暂停、取消、从检查点恢复,重启后能够辨认已经完成的步骤。关闭页面后任务与候选仍可读取,恢复不会静默重发模型调用。
- F16.03 重试与重复保护:重试不会重复写正文、事实或反馈;并发任务不会覆盖彼此或覆盖人工修改。
- F16.04 正式内容保护:失败不会留下半套正式结果;正文与已经批准的关联变更有一致的提交边界。章后派生失败单独展示并恢复,未确认事实不能自动转正。
- F16.05 派生数据重建:摘要、检索索引和视图失效时可单独重建,不必重新生成或篡改正式正文。
- F16.06 预算与停止条件:控制用量、费用、时间、修订轮数和并发;模型切换与降级行为有记录。
F17 知识资产沉淀与跨作品复用
- F17.01 分类沉淀:分别保存本书事实、写作方法、质量案例、作者偏好和运行证据,避免语义混用。
- F17.02 证据化知识卡:每条方法或经验带原文依据、适用条件、例外、反例、效果记录和版本。支持场景桥段、套路、技法、节奏、情绪和战斗等范式分类。
- F17.03 双向采集:既能从参考书和旧稿反向整理,也能从创作中的接受、拒绝、返修和失败事件增量采集。
- F17.04 确认与整理:候选知识经过复核、去重、冲突处理和确认后成为可复用资产。
- F17.05 实际消费:写前准备、审稿和修订能够按当前任务取用知识,并记录取用了什么及结果如何。方法升级不静默改变旧作品采用的版本。
- F17.06 作用域与淘汰:区分当前章节、作品、题材与跨作品经验;错误或过期资产能修订、停用与撤回影响。
F18 作者偏好适应与经验改进
- F18.01 反馈成对保留:保存原稿、修改稿、采纳或拒绝决定、作者说明和任务背景。
- F18.02 偏好作用域:区分作者长期偏好、本作品声音、角色特征和本次临时要求,允许作者查看、修正或关闭。
- F18.03 改进提案:从重复问题和有效案例提出写法、规则、检索、上下文、提示词或 Skill 的改进候选。
- F18.04 验证后启用:候选通过对应样例和评测,再由作者确认或在明确授权范围内启用。方法启用落实到具体范式、规则、Skill 或工具,并可查询实际消费;作者明确确认的偏好按偏好规则生效。
- F18.05 版本与退役:记录改变了什么、为什么改变、在哪些语境有效;退化后能够回滚,模型升级后重新检查。
- F18.06 长期效果观察:追踪重复错误、返修次数、人工修改时间、采纳情况和质量偏好,验证改进是否持续有用。
- F18.07 偏好捕获与确认:作者明确要求长期记住的偏好可确认生效;反复修改或文本分析推断的偏好先待确认;一次性要求和小说事实不自动写入长期偏好。
- F18.08 偏好冲突与撤回:冲突偏好集中呈现,作者可替换、拒绝或忘记;保留范围、版本、原话与变更记录,被撤回的偏好不再进入后续任务。
F19 效果评测与回归保护
- F19.01 分层评价:分别评价规则判断、修订保真、文学阅读体验和系统运行可靠性。
- F19.02 正反与边界样例:保留应该修改、不应该修改、需要判断及容易被改坏的样例。
- F19.03 成对比较:在同剧情、事实和任务条件下比较原稿、不同候选或编辑版本,允许原文胜出和无差异。
- F19.04 固定条件对照:记录模型、版本、输入与预算,区分方法改进、模型变化及成本增加带来的差异。实际运行隔离的测试样例并保存逐例结果,不以人工填报汇总代替执行。
- F19.05 变更回归:规则、提示词、Skill、上下文或模型变动时,复查已知正常案例、失败案例及恢复路径。
- F19.06 有用的结果指标:观察事实冲突、误杀、返工、人审时间、采纳质量及每个可接受章节的总成本。
- F19.07 评测隔离:评测输入遵守时间边界,目标章答案不进入生成输入;评测候选、评分和派生知识保持评测属性,不能直接进入正式正文或成为生效经验。
F20 工作台、数据自主与扩展能力
- F20.01 创作工作台:方便查看正文、规划、设定、候选、问题、下一步任务及处理进度,支持日常阅读和手工编辑。沿用 StoryForge 的暖纸张视觉、字体、控件和分栏,提供章节树、正文、资料与 AI 对话区。
- F20.02 检索与导航:从人物、章节、事件或问题定位相关资料和原文,支持跨材料跳转。
- F20.03 完整数据带走:能导出正文、规划、事实、方法、声音档案、反馈与审计,保留必要的关系和来源。
- F20.04 备份与恢复:备份包含可恢复的实际内容,恢复后能核对作品与知识资产的完整性。恢复核对包含参考原文以及知识、决策和来源关系;缓存和派生索引可重建。
- F20.05 模型与宿主替换:模型、运行宿主和界面可替换,正式内容与长期知识具有独立生命周期。替换遵守角色、权限与预算合同,CLI 与图形界面可访问同一业务。
- F20.06 能力扩展:允许按任务组合或替换工具、Skill 与工作流,明确输入、输出、修改范围和失败行为。规划、写手、抽取、检测、裁判按角色协作,编排和模型调用统一留痕。
- F20.07 数据与调用控制:作者能管理作品、资料及外部调用设置;凭据与作品导出、普通审计内容分别保存。
可选扩展
| 编号 | 能力 | 目标边界 |
|---|---|---|
| X01 | 节点式规划视图 | 使用同一作品、规划、依赖和候选数据,通过节点图组织关系、查看步骤与发起任务;与树形规划对应,不增加独立写入或运行权威 |
| X02 | 短篇创作流程 | 同样覆盖构思、规划、正文、审稿、去味、定稿与经验沉淀,采用较轻的篇幅和结构流程 |
完整目标包含小说需要的人物、世界、力量体系、时间线与状态。跑团、AI 小镇、独立游戏/陪聊、漫画剧本生产、社区交易、多租户计费与平台经营不在本目录范围;此范围不要求删除原项目中的相关代码。
全周期衔接
研究选题 → 素材与拆书 → 渐进构思 → 设定与人物 → 分层规划 → 方法选用与写前准备 → 正文候选 → 审稿与受控修订 → 作者采纳 → 章后状态 → 全书收口与交付 → 反馈与方法验证 → 下一章或下一部作品。
作者可从任意已有材料进入适合的阶段,并可往返;全周期目录不构成必须逐页填完的向导。跨阶段交接只校验当前操作所需的确认、来源、版本与范围。
元数据支撑说明
原有 129 项功能编号保持稳定。类型、字段、作品扩展、投影与结构升级属于这些功能的共用支撑,完整定义见元数据与结构演进,以 M01—M08 独立列出验收要求。新增类型和字段必须贯通编辑、抽取、校验、读取、检索、导出与恢复。