333 lines
10 KiB
Go
333 lines
10 KiB
Go
package tools
|
||
|
||
import (
|
||
"context"
|
||
"encoding/json"
|
||
"fmt"
|
||
"strings"
|
||
|
||
"github.com/voocel/agentcore/schema"
|
||
"github.com/voocel/ainovel-cli/domain"
|
||
"github.com/voocel/ainovel-cli/state"
|
||
)
|
||
|
||
// References 嵌入的参考资料。
|
||
type References struct {
|
||
// V0
|
||
ChapterGuide string
|
||
HookTechniques string
|
||
QualityChecklist string
|
||
OutlineTemplate string
|
||
CharacterTemplate string
|
||
ChapterTemplate string
|
||
// V1
|
||
Consistency string
|
||
ContentExpansion string
|
||
DialogueWriting string
|
||
// V2
|
||
StyleReference string // 风格补充参考（可为空）
|
||
}
|
||
|
||
// ContextTool 组装当前章节所需上下文。
|
||
type ContextTool struct {
|
||
store *state.Store
|
||
refs References
|
||
style string
|
||
}
|
||
|
||
func NewContextTool(store *state.Store, refs References, style string) *ContextTool {
|
||
return &ContextTool{store: store, refs: refs, style: style}
|
||
}
|
||
|
||
func (t *ContextTool) Name() string { return "novel_context" }
|
||
func (t *ContextTool) Description() string {
|
||
return "获取小说创作上下文，包括基础设定、状态数据、前情摘要和写作参考资料"
|
||
}
|
||
func (t *ContextTool) Label() string { return "加载上下文" }
|
||
|
||
func (t *ContextTool) Schema() map[string]any {
|
||
return schema.Object(
|
||
schema.Property("chapter", schema.Int("章节号。不传则返回基础设定和模板（供 Architect 使用）")),
|
||
)
|
||
}
|
||
|
||
func (t *ContextTool) Execute(_ context.Context, args json.RawMessage) (json.RawMessage, error) {
|
||
var a struct {
|
||
Chapter int `json:"chapter"`
|
||
}
|
||
if err := json.Unmarshal(args, &a); err != nil {
|
||
return nil, fmt.Errorf("invalid args: %w", err)
|
||
}
|
||
|
||
result := make(map[string]any)
|
||
|
||
// 加载基础设定
|
||
if premise, err := t.store.LoadPremise(); err == nil && premise != "" {
|
||
result["premise"] = premise
|
||
}
|
||
if outline, err := t.store.LoadOutline(); err == nil && outline != nil {
|
||
result["outline"] = outline
|
||
}
|
||
if rules, err := t.store.LoadWorldRules(); err == nil && len(rules) > 0 {
|
||
result["world_rules"] = rules
|
||
}
|
||
|
||
if a.Chapter > 0 {
|
||
// 根据总章节数计算上下文策略
|
||
profile := domain.NewContextProfile(0)
|
||
progress, _ := t.store.LoadProgress()
|
||
if progress != nil && progress.TotalChapters > 0 {
|
||
profile = domain.NewContextProfile(progress.TotalChapters)
|
||
}
|
||
// Layered 以 Progress 的显式标志为准，而非章节数推断
|
||
if progress == nil || !progress.Layered {
|
||
profile.Layered = false
|
||
}
|
||
|
||
// 角色加载：Layered 模式优先用快照，回退到原始设定
|
||
if profile.Layered {
|
||
t.loadLayeredCharacters(result, a.Chapter)
|
||
} else {
|
||
t.loadFilteredCharacters(result, a.Chapter)
|
||
}
|
||
|
||
// Writer/Editor 模式：加载章节相关上下文
|
||
if entry, err := t.store.GetChapterOutline(a.Chapter); err == nil {
|
||
result["current_chapter_outline"] = entry
|
||
}
|
||
|
||
// 摘要加载：分层 vs 扁平
|
||
if profile.Layered {
|
||
t.loadLayeredSummaries(result, a.Chapter, profile.SummaryWindow)
|
||
} else if profile.FullContext {
|
||
if summaries, err := t.store.LoadAllSummaries(a.Chapter); err == nil && len(summaries) > 0 {
|
||
result["recent_summaries"] = summaries
|
||
}
|
||
} else {
|
||
if summaries, err := t.store.LoadRecentSummaries(a.Chapter, profile.SummaryWindow); err == nil && len(summaries) > 0 {
|
||
result["recent_summaries"] = summaries
|
||
}
|
||
}
|
||
|
||
// 时间线：Layered 用窗口，其他按策略
|
||
if profile.FullContext {
|
||
if timeline, err := t.store.LoadTimeline(); err == nil && len(timeline) > 0 {
|
||
result["timeline"] = timeline
|
||
}
|
||
} else {
|
||
if timeline, err := t.store.LoadRecentTimeline(a.Chapter, profile.TimelineWindow); err == nil && len(timeline) > 0 {
|
||
result["timeline"] = timeline
|
||
}
|
||
}
|
||
// foreshadow：短篇全量，否则只取未回收条目
|
||
if profile.FullContext {
|
||
if foreshadow, err := t.store.LoadForeshadowLedger(); err == nil && len(foreshadow) > 0 {
|
||
result["foreshadow_ledger"] = foreshadow
|
||
}
|
||
} else {
|
||
if foreshadow, err := t.store.LoadActiveForeshadow(); err == nil && len(foreshadow) > 0 {
|
||
result["foreshadow_ledger"] = foreshadow
|
||
}
|
||
}
|
||
// relationships：保持全量（pair-key 去重，数据量天然可控）
|
||
if relationships, err := t.store.LoadRelationships(); err == nil && len(relationships) > 0 {
|
||
result["relationship_state"] = relationships
|
||
}
|
||
|
||
// Layered 模式：注入当前卷弧位置 + 弧目标/卷主题
|
||
if profile.Layered && progress != nil {
|
||
pos := map[string]any{
|
||
"volume": progress.CurrentVolume,
|
||
"arc": progress.CurrentArc,
|
||
}
|
||
if volumes, err := t.store.LoadLayeredOutline(); err == nil {
|
||
for _, v := range volumes {
|
||
if v.Index == progress.CurrentVolume {
|
||
pos["volume_title"] = v.Title
|
||
pos["volume_theme"] = v.Theme
|
||
for _, arc := range v.Arcs {
|
||
if arc.Index == progress.CurrentArc {
|
||
pos["arc_title"] = arc.Title
|
||
pos["arc_goal"] = arc.Goal
|
||
break
|
||
}
|
||
}
|
||
break
|
||
}
|
||
}
|
||
}
|
||
result["position"] = pos
|
||
}
|
||
|
||
// 加载场景级恢复状态 + 节奏追踪
|
||
if progress != nil {
|
||
checkpoint := map[string]any{
|
||
"in_progress_chapter": progress.InProgressChapter,
|
||
"completed_scenes": progress.CompletedScenes,
|
||
}
|
||
if len(progress.StrandHistory) > 0 {
|
||
checkpoint["strand_history"] = progress.StrandHistory
|
||
}
|
||
if len(progress.HookHistory) > 0 {
|
||
checkpoint["hook_history"] = progress.HookHistory
|
||
}
|
||
result["checkpoint"] = checkpoint
|
||
}
|
||
// 加载已有的章节规划（支持场景恢复跳过已完成场景）
|
||
if plan, err := t.store.LoadChapterPlan(a.Chapter); err == nil && plan != nil {
|
||
result["chapter_plan"] = plan
|
||
}
|
||
|
||
// 写作参考资料分阶段加载
|
||
result["references"] = t.writerReferences(a.Chapter)
|
||
} else {
|
||
// Architect 模式：全量角色 + 模板
|
||
if chars, err := t.store.LoadCharacters(); err == nil && chars != nil {
|
||
result["characters"] = chars
|
||
}
|
||
// Architect 模式下也加载分层大纲（弧级规划需要看全貌）
|
||
if layered, err := t.store.LoadLayeredOutline(); err == nil && len(layered) > 0 {
|
||
result["layered_outline"] = layered
|
||
}
|
||
// 加载已有的弧摘要（弧级规划时需要参考前续弧的内容）
|
||
if volSummaries, err := t.store.LoadAllVolumeSummaries(); err == nil && len(volSummaries) > 0 {
|
||
result["volume_summaries"] = volSummaries
|
||
}
|
||
result["references"] = t.architectReferences()
|
||
}
|
||
|
||
return json.Marshal(result)
|
||
}
|
||
|
||
// loadFilteredCharacters 按 Tier 和场景出场过滤角色。
|
||
// core/important 始终返回；secondary/decorative 只在当前章节大纲提及时返回。
|
||
func (t *ContextTool) loadFilteredCharacters(result map[string]any, chapter int) {
|
||
chars, err := t.store.LoadCharacters()
|
||
if err != nil || len(chars) == 0 {
|
||
return
|
||
}
|
||
|
||
// 获取当前章节大纲的场景描述，用于匹配次要角色
|
||
entry, err := t.store.GetChapterOutline(chapter)
|
||
if err != nil {
|
||
result["characters"] = chars
|
||
return
|
||
}
|
||
sceneText := strings.Join(entry.Scenes, " ") + " " + entry.CoreEvent + " " + entry.Title
|
||
|
||
var filtered []domain.Character
|
||
for _, c := range chars {
|
||
switch c.Tier {
|
||
case "secondary", "decorative":
|
||
if strings.Contains(sceneText, c.Name) {
|
||
filtered = append(filtered, c)
|
||
}
|
||
default: // core, important, 或未设置
|
||
filtered = append(filtered, c)
|
||
}
|
||
}
|
||
result["characters"] = filtered
|
||
}
|
||
|
||
// loadLayeredSummaries 分层摘要加载：卷摘要 + 当前卷弧摘要 + 弧内章摘要。
|
||
func (t *ContextTool) loadLayeredSummaries(result map[string]any, chapter, summaryWindow int) {
|
||
vol, arc, err := t.store.LocateChapter(chapter)
|
||
if err != nil {
|
||
// 回退到扁平模式
|
||
if summaries, err := t.store.LoadRecentSummaries(chapter, summaryWindow); err == nil && len(summaries) > 0 {
|
||
result["recent_summaries"] = summaries
|
||
}
|
||
return
|
||
}
|
||
|
||
// 1. 已完成卷的卷摘要
|
||
if volSummaries, err := t.store.LoadAllVolumeSummaries(); err == nil && len(volSummaries) > 0 {
|
||
result["volume_summaries"] = volSummaries
|
||
}
|
||
|
||
// 2. 当前卷内已完成弧的弧摘要（不含当前弧）
|
||
if arcSummaries, err := t.store.LoadArcSummaries(vol); err == nil && len(arcSummaries) > 0 {
|
||
var prior []domain.ArcSummary
|
||
for _, s := range arcSummaries {
|
||
if s.Arc < arc {
|
||
prior = append(prior, s)
|
||
}
|
||
}
|
||
if len(prior) > 0 {
|
||
result["arc_summaries"] = prior
|
||
}
|
||
}
|
||
|
||
// 3. 当前弧内最近 N 章的章摘要
|
||
if summaries, err := t.store.LoadRecentSummaries(chapter, summaryWindow); err == nil && len(summaries) > 0 {
|
||
result["recent_summaries"] = summaries
|
||
}
|
||
}
|
||
|
||
// loadLayeredCharacters Layered 模式下的角色加载：优先用最近快照，回退到原始设定 + Tier 过滤。
|
||
func (t *ContextTool) loadLayeredCharacters(result map[string]any, chapter int) {
|
||
snapshots, err := t.store.LoadLatestSnapshots()
|
||
if err == nil && len(snapshots) > 0 {
|
||
result["character_snapshots"] = snapshots
|
||
// 同时保留原始设定中的 core/important 角色（快照可能不含新登场角色）
|
||
t.loadFilteredCharacters(result, chapter)
|
||
return
|
||
}
|
||
// 无快照时回退到原始设定
|
||
t.loadFilteredCharacters(result, chapter)
|
||
}
|
||
|
||
// writerReferences 返回写作参考资料。章节 1 返回全量，后续章节裁剪掉不再需要的模板。
|
||
func (t *ContextTool) writerReferences(chapter int) map[string]string {
|
||
refs := map[string]string{}
|
||
add := func(k, v string) {
|
||
if v != "" {
|
||
refs[k] = v
|
||
}
|
||
}
|
||
// 始终加载的核心参考
|
||
add("chapter_guide", t.refs.ChapterGuide)
|
||
add("hook_techniques", t.refs.HookTechniques)
|
||
add("quality_checklist", t.refs.QualityChecklist)
|
||
add("consistency", t.refs.Consistency)
|
||
add("dialogue_writing", t.refs.DialogueWriting)
|
||
add("style_reference", t.refs.StyleReference)
|
||
|
||
// 仅首章加载的补充参考（后续章节不再需要）
|
||
if chapter <= 1 {
|
||
add("chapter_template", t.refs.ChapterTemplate)
|
||
add("content_expansion", t.refs.ContentExpansion)
|
||
}
|
||
return refs
|
||
}
|
||
|
||
func (t *ContextTool) architectReferences() map[string]string {
|
||
refs := map[string]string{}
|
||
add := func(k, v string) {
|
||
if v != "" {
|
||
refs[k] = v
|
||
}
|
||
}
|
||
add("outline_template", t.refs.OutlineTemplate)
|
||
add("character_template", t.refs.CharacterTemplate)
|
||
return refs
|
||
}
|
||
|
||
// ContextSummary 返回当前状态的简要摘要（供日志使用）。
|
||
func (t *ContextTool) ContextSummary() string {
|
||
var parts []string
|
||
if p, _ := t.store.LoadPremise(); p != "" {
|
||
parts = append(parts, "premise:ok")
|
||
}
|
||
if o, _ := t.store.LoadOutline(); o != nil {
|
||
parts = append(parts, fmt.Sprintf("outline:%d chapters", len(o)))
|
||
}
|
||
if c, _ := t.store.LoadCharacters(); c != nil {
|
||
parts = append(parts, fmt.Sprintf("characters:%d", len(c)))
|
||
}
|
||
if len(parts) == 0 {
|
||
return "empty"
|
||
}
|
||
return strings.Join(parts, ", ")
|
||
}
|