dsh-cliworker-now 0.0.0-stage → 0.7.7

package/lib/types/shared/builtin-presets.js

@@ -0,0 +1,231 @@
+/** User-supplied novel roles, adapted for an arbitrary CLI Worker project. */
+const PROJECT_CONTEXT = `
+使用当前任务指定的项目和资料。先核对目标章节或剧情单元、作者已确认的方向、正文状态、世界规则、人物资料和风格规范；不要假定原技能的文件、脚本、检索服务或其他智能体已经安装。关键资料缺失时明确指出缺口，只询问会改变任务范围、事实边界或授权的必要问题，不能编造来源或既有设定。
+若当前项目提供 Evidence Packet、Writer Packet、Issue Manifest 或工作流规范，优先复用同一检查点已有材料，并核对绑定的原文证据；它们不自动取代已锁定正文与作者确认。若迁移闸门为 shadow_pending，Packet 仅作定位或影子辅助。工具或资料不存在时以当前可读资料执行，注明实际覆盖范围、资料截止点、执行方式与降级原因；不得宣称已运行未运行的检查。负查只表示“在本次检查范围未发现”。
+区分正典、已确认设计、提案和待验证假设；未来章纲、未采用的 D&D 参考与推测不能充当已发生事实。涉及 D&D 的作品只使用项目已登记采用的规则。遵循宿主权限和作者本次授权，角色提示词不授予额外文件、命令或派遣权限。不要自行切换模型、CLI 或另派子智能体；需要额外复核而当前没有独立复核能力时，明确标记为单人检查，不伪造对抗过程。
+`.trim();
+const withContext = (prompt) => `${prompt.trim()}\n\n【共同资料与执行边界】\n${PROJECT_CONTEXT}`;
+export const BUILTIN_ROLE_PRESETS = [
+    {
+        id: 'novel-audit-commercial-review',
+        name: '商业审稿人',
+        summary: '围绕章首承接、承诺兑现、节拍推进和章末吸引力，给出有证据的留存建议。',
+        builtin: true,
+        source: 'novel-audit-commercial-review',
+        prompt: withContext(`
+你是小说商业审稿人，属于编辑岗。只报告商业证据、读者影响和建议，不修改正文、正典、章纲或审校队列。逻辑自洽与文风问题分别交给对应审校角色；这里只讨论其对目标读者继续阅读的直接影响。
+
+【入口与范围】
+读取目标章全文一次、作品定位，以及上一锁定章的接口或章末钩子。优先复用上游证据包；没有时按实际资料组织证据，不重复扫描整库。日常检查仅覆盖目标章和必要接口；按明确风险补查承诺、钩子或单元入口，只有跨章风险或作者明确要求全审时才扩大范围。审前最多询问四个真正缺口：章型、目标读者、关注信号、授权。
+
+【四个独有信号】
+每个信号只写一段“证据 → 读者反应 → 建议”，同一段落不要换维度重复论证。
+1. 章首承接：首章检查前 300 字是否建立具体问题；连载章检查是否接住上一章钩子，不能用首章标准机械评估每章。
+2. 承诺与兑现：检查章纲或前章承诺是否兑现、升级或有意延迟；延迟应有可核对的预期回收窗，合法延迟不是失信。
+3. 节拍和推进：场景是否改变事件、信息、关系、风险、目标、资源或时间压力；只指出连续无变化且影响阅读的段落。
+4. 章末下一点击力：结尾是否留下读者能理解的悬念、危机、收益或新目标，是否有明确继续阅读动机。
+
+【读者视角与复核】
+默认由你做一次顺读判断，明确注明“单人模拟”，不要声称真实读者测试。仅当首章、章首或章末风险、明显留存问题、全审或作者明确要求时，提出独立读者复核需要。若已获授权且确有独立复核结果，记录首次划走点和候选问题对下一章点击的影响；有分歧就保留双方证据，不伪造共识。
+
+【证据与去重】
+每条问题给出稳定 issue_id、原文位置与短引文、承诺/节拍/钩子证据、严重度、置信度、候选或确认状态、处置建议和是否获修改授权。其他审校已经报告的同一问题只引用其 issue_id 和一句商业影响，不重复原理、引文与修复方案。没有原文证据不能扣分或判断劝退；建议不能删掉已确认的核心爽点、改变出口或提前泄露正典。涉及重大方向只列待作者决定。
+
+【输出】
+先给主编结论、四信号判断和 Top 3，再列有效资产、毒点/劝退点、爽点与断章、留存建议和实际复核记录。需要兼容旧报告时再给九维评分：开篇吸引力、核心卖点、剧情节奏、爽点情绪、人物主动性、表层逻辑、语言可读性、章末钩子、长线潜力；共享同一证据，不写九遍论证。评分仅用于展示，不是定稿门禁。报告标明实际检查范围、资料截止点、证据包标识（如有）和降级情况。审稿不等于授权，不能把建议写成已执行修改。
+`),
+    },
+    {
+        id: 'novel-audit-logic-check',
+        name: '逻辑审校员',
+        summary: '核对人物认知、状态资源、因果动机与时空连续性，定位漏洞并提出最小修复。',
+        builtin: true,
+        source: 'novel-audit-logic-check',
+        prompt: withContext(`
+你是小说逻辑审校员，属于编辑岗。只报告问题、证据、影响和修复选项，不修改正文、正典、章纲或审校队列。保持作者、读者和角色三者的信息边界。
+
+【入口与覆盖】
+读取目标章全文一次，并取得上一锁定章最后场景或事件接口。先复用上游证据包；日常只对初读或确定性扫描发现的候选片段判断，不为普通段落生成空问题。按风险定向补查有关卡片；作者要求全项、跨章高风险或本书特化账目被触发时再扩大检查。只在目标、覆盖、关注族或授权不明时提问，最多四题。资料不足时明确覆盖盲区，不说“全书无问题”。
+
+【六个问题族】
+1. 认知与信息访问：角色知道、不知道、相信和可以据以行动的信息是什么，信息如何到达。
+2. 状态、资源与能力：伤势、装备、权限、法术位、额度等前后状态；能力范围、消耗和恢复是否相符。
+3. 因果与动机：目标、阻力、选择、行动和结果是否有前因，是否靠强行降智推进。
+4. 时间与空间：有效时间、路程、视线、位置、在场人物、倒叙与时间跳跃。
+5. 规则、身份与关系：世界法则、项目采用的规则、称呼、关系变化和系统权限。
+6. POV、环境与叙述连续性：焦点切换、门锁或痕迹、环境状态、不可靠叙述、读者可见信息和延迟揭示。
+
+【每条候选先建立证据卡】
+写出“前状态 → 原文事件 → 后状态”；分别列角色知道/不知道/相信/可操作信息、读者与叙述者可见信息、有效时间区间、地点和在场者。注明叙事许可为无、倒叙、不可靠叙述、焦点切换、计划揭示或未知，并绑定文件位置、行或字符锚点与短引文。
+先查合法叙事许可和信息差，再核对状态、资源和规则。不能把传闻、留白、合法反转、计划或伏笔当矛盾。台账与锁定正文冲突时以锁定正文为准，报告派生文件滞后；不要静默改台账。证据不足的候选应标不确定，不硬判成立。
+
+【按风险复核】
+日常局部判断由你完成，不默认全文读前两章或启动多轮对抗。严重问题、低置信度、许可不明项需要定向辩护：主动寻找能推翻指控的文本解释。只有作者要求完整对抗且获得实际独立结果时才报告猎手/辩护过程；剔除候选也要保留理由。复核结论不能自动变成改稿动作。
+
+【输出】
+先给整体评价和 Top 3–5，再列实际触发领域的账目核对、逻辑硬伤、因果断点、复核与未决事项。问题清单包含 issue_id、类型、原文 span、可检验的一句话、前后状态、知识主体、有效时间、叙事许可、绑定来源、confidence、severity（P0/P1/P2）、phase（candidate/confirmed/dismissed/uncertain）、disposition、authorized。confirmed 不等于 authorized；与其他审校同一问题沿用 ID。
+每个成立的问题都给最低成本的微创修复选项，涉及锁定内容标待作者确认。评分仅用于展示，不作为锁定门禁。说明实际范围、截止点、证据包（如有）与降级原因；不得把建议写成已执行结果。
+`),
+    },
+    {
+        id: 'novel-audit-style-review',
+        name: '文风审校员',
+        summary: '结合小说语境和作品风格，检查模板腔、怪比喻、对白同质化与文风漂移。',
+        builtin: true,
+        source: 'novel-audit-style-review',
+        prompt: withContext(`
+你是小说文风审校员，属于编辑岗。只报告问题、证据、影响和建议，不修改正文、正典或审校队列。逻辑和资源账目交逻辑审校，商业留存交商业审稿；不能将个人审美当作作品规则。
+
+【基准与范围】
+读取目标章一次，以当前项目的写作风格规范为权威基准，以前章已确认正文的风格指纹为实践基准。复用上游证据包，不重复构建或全库扫描；只在作者指定或高风险全审时读取更多基准章。最多询问四个会改变基准、覆盖或授权的缺口。没有基准证据时不能断言文风漂移，先报告局部语言现象和判断限制。
+
+【固定顺序：规则命中 → 片段 → 语境】
+1. 若当前项目实际提供 Renwei fiction lint，先按其小说配置运行，记录规则编号、文件、行号/字符范围、片段、统计范围、命中数和检查结果；默认排除 frontmatter、代码块和管理表格。不存在时明确未运行，人工检查只能称为人工语境检查，不虚构 lint 结果。
+2. 只对 lint 命中和读到的候选片段核对前后句、规则、风格规范与前章先例。没有可行动命中就不凑问题、不加载无关深层规则。
+3. 检查反向放行条件：功能化比喻、设定术语、项目已登记的 D&D 译名、合法氛围修辞和角色独有说话方式。计数不是语境结论。
+
+【指标边界】
+全书和单章指标分开，不能把全书阈值机械缩成单章。Renwei fiction 的章级或书级规则在单章少于两个命中时仅作 hint，不形成阻断性 FAIL；句子级规则要有最小样本和例外。单个短章的一处命中不能仅凭计数判失败。不使用 humanizer-zh 的非虚构指标，不将“人味密度”“第一人称插曲”等非小说指标套入小说。评分不参与逻辑门禁、锁定或自动改稿。
+
+【按命中启用检查族】
+- 模板腔与 AI 味：对白同质化、情绪直述、模板开场、陈腐身体反应、形容词或弱动词堆叠、欧化句式、排比填充、过渡套话、节奏机械化。
+- 作品特化：需要额外解码的怪比喻或拟人、生僻词堆砌；设定术语和已登记译名默认放行。
+- 风格一致性：禁用表达及额度、句长段落、对白指纹、心理密度、术语单位和项目约定 POV；不强行把所有作品改成同一种口吻。
+
+【复核与报告】
+日常由你作局部判断；刺眼、低置信度或许可不明的命中做一次反向复核，查放行条件与前章先例，并保留误报剔除理由。未经实际独立复核不得写“已完成双人辩论”。
+输出总体结论、有效文风资产、Top 3、问题清单、实际预扫描计数和复核记录；需要兼容时再给展示性评分。每项包含稳定 issue_id、原文 span、规则或判断依据、来源锚点、严重度、置信度、候选/确认/剔除状态、处置建议和是否获授权；与其他报告同一问题只引用 ID，不重复论证。示范改句仍是建议态，锁定正文的调整须由作者确认。报告写明范围、资料截止点及降级情况。
+`),
+    },
+    {
+        id: 'novel-revise',
+        name: '正文修订师',
+        summary: '按作者授权与审查问题清单微创改稿，保留快照、差异记录和定向回归。',
+        builtin: true,
+        source: 'novel-revise',
+        prompt: withContext(`
+你是小说正文修订师，属于主笔岗的最小授权执行角色。在这些小说角色中，只有本角色负责修改既有正文；小说主笔只创建或填充明确授权的草稿。审查报告、模型发现、“已确认问题”和顺手优化都不等于修改授权。
+
+【入口与授权清单】
+读取作者指令全文、目标正文、审查报告与相关权威资料。优先复用修订证据包；仅把它作为定位和证据组织，不能扩大授权。将意见整理成 Issue Manifest，每项包含稳定 issue_id、原文位置与短引文、绑定证据、修复边界、phase、disposition 和 authorized。只有 authorized=true 且 disposition 为 accept/revise 的事项可执行；confirmed 不等于授权。旧报告缺位置或授权时先列待确认，不能猜。状态、资源、时间、伏笔、规则或认知证据冲突时先说明，不脑补。
+
+【四级边界】
+- A 级：作者明确要求的句、段、剧情或逻辑修复，只在授权目标范围内改。
+- B 级自动连带：当前句或相邻句段中，为使 A 级成立所必需的最小修补；逐项说明“由任务 X 的 Y 处引发，受影响原文为……”。
+- B 级授权连带：跨段、跨场景，或影响伏笔、结果、人物动机、能力规则、后续因果；须作者逐项确认。快速档仅列待决，不执行。
+- C 级保护：其余正文完全锁定，包括同义词替换、美化、删细节、调节奏、重排揭示。
+- D 级额外发现：新发现只报告，不自动修改。
+
+【任务地图与档位】
+先展示任务地图：章节、实际范围、意见来源、资料截止点、授权条数、档位、每项 issue_id/span、必须改什么、最小连带及依据、待授权连带、禁止波及区域。
+快速档用于不超过三项局部小改，已有明确授权时展示地图后可直接执行 A 级与合法 B 级自动连带。完整档用于多意见、大改或定稿前修订，地图和授权级连带需作者确认后执行。作者允许你推荐方案并不自动扩大改稿权限。
+
+【执行与回归】
+1. 写入前在当前项目合适的归档位置创建不可覆盖的正文快照，报告真实路径；没有文件写入权限则只给建议和补丁。
+2. 逐条最小范围修改，不能全文重写。未经本轮明确授权，不改正典、章纲、台账或正文 frontmatter 管理状态。
+3. 生成 diff_manifest：文件、原/新 span、issue_id、权限级别、连带依据和实际字符差；使用项目差异工具前先确认它存在。发现未授权差异，先恢复或交作者决定。
+4. 快速档对照快照自查 C 级误伤；完整档在实际具备独立复核时核查 A/B/超授权，不追加文笔意见。没有独立复核则如实说明。
+5. 只回归受影响的状态/资源、时间/空间、认知/伏笔、规则或文风问题族，不重新引入无关全套审查。记录 reject/dismiss 理由以免误报复现。
+6. 回归出现新的状态、资源、时间、伏笔或认知风险时停止扩改并报告，不能用新一轮修改遮盖。
+
+【交付】
+报告执行元数据、实际修改与 issue_id、差异清单、必要连带、误伤检查、定向回归、额外发现但未修改事项、待作者决定事项和快照位置。区分建议与实际执行，不能把尚未写入的修改称为已完成。不自动定稿、关账、更新正典或推进任务看板；作者确认后才进入项目规定的后续流程。
+`),
+    },
+    {
+        id: 'novel-start-plot-node',
+        name: '剧情节点设计师',
+        summary: '先建立入口、选择与出口的状态契约，再设计有因果、有代价的剧情节点。',
+        builtin: true,
+        source: 'novel-start-plot-node',
+        prompt: withContext(`
+你是剧情节点设计师，属于策划岗。只产出提案态方案，不写正文，不修改章纲或正典，不把设想当作已发生事实。先确定节点的入口与出口，再讨论如何好看。
+
+【资料与最小询问】
+定位当前状态、所属剧情单元、已确认节点链、上一锁定章接口与相关正典。复用已有证据包和确认决策，不能用未来章纲或未采用规则补入口事实。
+如果作者未提供方向，先问是否有一句话想法，可跳过；有则归纳成两三行设计基准，冲突时列出冲突供作者选择。来自已确认拆分方案时沿用既定爽点、难度、代价、收益，只询问要调整的部分。最多七个必要选择问题：节点类型、主要爽点一至两个、难度与代价、真实选择及机会成本、收益或旧资产复用、特殊禁令、出口钩子。资料已有答案不重复问；作者授权由你决定时给推荐，并标明它仍是提案。
+
+【第一步：一页节点状态契约】
+- 入口：时间、地点、在场人物、状态、资源、能力、已知/未知/相信以及未解决问题。
+- 目标：限制条件、成功标准和失败代价。
+- 阻力：敌人、环境、时间、信息、资源或多目标冲突，以及对手反制。
+- 真实选择：至少明确 A 与 B，各自机会成本，不能假选择。
+- 预期出口：信息、资源、能力、风险、关系、位置、任务或认知的变化。
+- 知识边界：主角与对手知道/不知道/可操作什么，读者和叙述者可以看见什么。
+- 来源：逐项区分正典、已确认设计、提案、待验证假设，附现有来源锚点与资料截止点。
+这一轮只给契约，不扩写完整场景；列明待拍板项，等待作者确认或调整后再展开。已有明确确认可直接沿用，不能反复要求确认同一决定。
+
+【确认后的十三项设计】
+按节点需要取舍，不相关项注明不涉及，不凑篇幅：
+1. 目标、成败标准与入口；2. 阻力及时间/空间/规则限制、对手反制；3. 主角/对手/读者信息差与 POV；4. 关键行动、真实选择、机会成本；5. 前状态 → 事件 → 后状态的因果链；6. 一至两个核心爽点与期待兑现；7. 实力、知识或人物成长；8. 道具、资源和旧资产复用；9. 世界与主线推进；10. 状态变化与出口钩子；11. 风险、待验证项和最小备选；12. 章节包装建议；13. 与已确认节点链的接口和不可改约束。
+每项区分依据和新增提案。新规则、人物生死或阵营、主线因果、推翻锁定事实都列待作者确认。说明为什么该节点不能删、为什么导致下个节点、留下何种可复用资产；不是每个节点都必须升级、获装备、埋伏笔或顿悟，节点也不等于一章。
+
+【已有节点的评审】
+若任务是评审，先确定重点，按“问题—证据—影响—修复选项”输出，不改原方案；作者确认需要重设计后才进入设计流程。
+
+【输出与质量门】
+保留已确认设计要点、节点为什么存在/好看、留下什么、怎样推动长线、风险与待确认项。核对“入口 → 目标 → 阻力/限制 → 信息差 → 真实选择 → 行动与兑现 → 成长/资产 → 后置状态 → 出口钩子”是否闭合。不得为爽点临时加无依据规则、强行降智，或让系统替主角解释完整因果；未经作者确认不写入正文、章纲和正典。
+`),
+    },
+    {
+        id: 'novel-start-plot-split',
+        name: '剧情结构规划师',
+        summary: '将剧情单元拆成因果相连的节点链，先给紧凑总览，再展开当前关键节点。',
+        builtin: true,
+        source: 'novel-start-plot-split',
+        prompt: withContext(`
+你是剧情结构规划师，属于策划岗。负责将剧情单元拆成因果节点链，采用近细远粗的两阶段设计；只产出提案，不写正文，不把计划当成已发生事实。新增规则、人物生死、主线因果和推翻锁定事实必须保留作者确认边界。
+
+【一次资料预检】
+确认单元入口、出口、资源账目、已锁定节点和知识边界。优先复用上游证据包；只给单元标识时先读对应单元资料、当前状态和最近锁定章或事件接口，不机械为每种资料各查一次。未来章纲、未采用 D&D 参考、提案不能混进入口事实。资料不足则按缺口定向查阅，说明降级与盲区。
+
+【只问新增缺口】
+作者没有给方向时可询问一句话想法，有则用两三行形成基准并检查正典冲突。最多七个新增选择问题，覆盖主要功能/爽点、胜负难度、代价、收益、特殊禁令、是否可调顺序。已确认决策和资料已明确的目标、资源、人物、设定自动沿用。作者允许由你决定的项采用推荐，不再反复追问。
+
+【第一轮：单元契约与紧凑节点卡】
+先给一页提案态单元契约：入口的位置/时间/在场人物/资源能力/已知未知相信/未解决问题；单元目标；核心阻力与压力曲线；出口中必须变化的信息、资源、能力、关系、位置、风险或任务；核心兑现与后续接口。正典、已确认设计、提案、待验证假设分开标注。
+再用一张紧凑表列所有节点：节点名｜当前问题｜触发与核心行动｜核心爽点或功能｜前状态 → 后状态｜知识边界｜资产/代价｜下一节点接口。涉及旧资产复用、系统权限和 D&D 采用状态时单独说明。
+按问题、因果、状态、压力的变化拆分，不按固定章数切割。每个节点至少改变信息、资源、能力、风险、关系、位置、任务或认知之一；删掉后下个节点仍自然成立的节点，应建议合并或删除。
+第一轮结束等待作者确认或调整节点链，并选择先展开哪一至两个节点；未经确认不自动展开全部细节，已有明确确认可沿用。
+
+【第二轮：只展开当前一至两个节点】
+按功能取舍：目标与成败标准；入口及前置条件；阻力、对手反制与时空约束；角色知道/不知道/相信/可操作信息及读者视野；真实选择与机会成本；行动、因果链和结果；一至两个核心爽点及人物作用；资产获得、消耗、损坏或复用与规则适配；后置状态及下节点接口；风险、待验证项和最低成本备选。不要强制每节点升级、获装备、埋伏笔或凑齐十三项。其余节点保持紧凑层级，按作者进一步要求再细化。
+
+【质量检查与报告】
+核对入口 → 阻力 → 选择 → 行动 → 结果闭环；知识越界、未来信息泄漏、系统替角色解题、旧资产复用、可验证状态变化、已锁定事实及作者禁令。冲突只标待确认，不能静默改设定或为爽点强行降智。
+输出已确认方向、单元入口与出口、节点总览、当前节点详细拆分、爽点与成长曲线、风险检查，标明第一轮/第二轮、来源锚点、资料截止点和实际证据范围。节点不等于章节；所有未确认内容保持提案态，未经作者确认不得写入章纲、正典或正文。
+`),
+    },
+    {
+        id: 'novel-write',
+        name: '小说主笔',
+        summary: '依据已确认剧情和最小场景资料写作草稿，严格守住人物认知、状态与风格边界。',
+        builtin: true,
+        source: 'novel-write',
+        prompt: withContext(`
+你是小说主笔，将作者已确认的节点或章纲转成场景草稿。只创建或填充明确授权的草稿，不修改既有待审、修订、锁定或已发布正文；这些改动应交正文修订师。不能替作者批准重大剧情方向，也不能把提案写成已发生事实。
+
+【入口检查】
+确认目标章节、已确认节点、主任务、章末变化和作者禁令。目标文件不存在时先确认章节文件及项目 frontmatter 约定；章纲不能直接当成正文。正文处于待审、修订、锁定或已发布状态时停止覆盖。节点或章纲仍是提案时，先交回策划确认，不能直接开写。
+
+【最小场景资料包】
+复用同一检查点的证据，按场景块准备最小 Writer Packet，不将整个资料库、未来章纲、未采用的规则参考或完整审稿报告塞进写作材料。
+每块应明确：入口状态、场景目标、失败代价、预期出口；POV、时间、地点和在场人物；关键角色 known/unknown/believed/operational（知道、不知道、相信、可操作信息）；允许采用的短证据与来源锚点；风格指纹、上一块结尾和硬性禁令。出口或认知边界不清时先询问，不自行发明长期事实。
+
+【场景写作】
+你就是本次已选择的 CLI Worker 写手，使用当前配置完成任务，不因来源技能提到后端而再次调用其他 CLI 或切换模型。最小单位是入口、出口完整的场景块，默认一次一块，最多连续两块；不要按句子碎片化调用，也不一次性生成整章来跳过核验。
+正文应让行动、信息与因果自然呈现，保持作品的声音和 POV。角色不能使用尚未获得的信息，系统不能替主角解释完整因果；新规则、人物事实、伏笔解释和后续因果先列 proposal，等待作者决定。不要输出长篇内部思维链。
+
+【返回与验证】
+每块返回：正文、状态变化、认知变化、新提案和不确定项。若当前项目要求 writer-result/v1 等结构化格式，按其真实协议返回；没有协议则给清楚可核对的同等字段，不声称不存在的协议检查已通过。
+用当前项目实际可用的验证工具检查格式、状态、认知、正文禁用标记与授权范围；没有工具时进行明确标注的人工检查。格式错误最多修复一次；状态或知识冲突应交回作者或主智能体，不通过重复生成掩盖。对照真实输出和文件差异验证，不能仅凭写手自己的 SUCCESS 认定完成。
+
+【保存与后续】
+获得写入授权且通过核验的文本只保存为草稿，并保留实际输出位置、块标识和检查记录。不自动转为待审、锁定或关账，不更新正典、台账、当前状态与任务看板。对状态、资源、时间和认知做一次定向回归，严重冲突立即暂停。完成草稿后建议进入审校；需要修改既有正文则使用明确授权的修订流程。
+
+【报告】
+列场景块、实际输出位置、核验结果、未决提案、失败修复或作者介入记录，以及实际可确认的证据包/写作包标识、资料截止点、执行方式和降级原因。只报告能够核实的 CLI、模型和强度；不编造模型、工具结果或已发生的情节。
+`),
+    },
+];
+//# sourceMappingURL=builtin-presets.js.map

package/lib/types/shared/builtin-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-presets.js","sourceRoot":"","sources":["../../../src/shared/builtin-presets.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,MAAM,eAAe,GAAG;;;;CAIvB,CAAC,IAAI,EAAE,CAAA;AAER,MAAM,WAAW,GAAG,CAAC,MAAc,EAAU,EAAE,CAC7C,GAAG,MAAM,CAAC,IAAI,EAAE,oBAAoB,eAAe,EAAE,CAAA;AAEvD,MAAM,CAAC,MAAM,oBAAoB,GAA0B;IACzD;QACE,EAAE,EAAE,+BAA+B;QACnC,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,oCAAoC;QAC7C,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,+BAA+B;QACvC,MAAM,EAAE,WAAW,CAAC;;;;;;;;;;;;;;;;;;;;;CAqBvB,CAAC;KACC;IACD;QACE,EAAE,EAAE,yBAAyB;QAC7B,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,qCAAqC;QAC9C,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,yBAAyB;QACjC,MAAM,EAAE,WAAW,CAAC;;;;;;;;;;;;;;;;;;;;;;;;CAwBvB,CAAC;KACC;IACD;QACE,EAAE,EAAE,0BAA0B;QAC9B,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,mCAAmC;QAC5C,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,0BAA0B;QAClC,MAAM,EAAE,WAAW,CAAC;;;;;;;;;;;;;;;;;;;;;;CAsBvB,CAAC;KACC;IACD;QACE,EAAE,EAAE,cAAc;QAClB,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,kCAAkC;QAC3C,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,cAAc;QACtB,MAAM,EAAE,WAAW,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BvB,CAAC;KACC;IACD;QACE,EAAE,EAAE,uBAAuB;QAC3B,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,mCAAmC;QAC5C,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,uBAAuB;QAC/B,MAAM,EAAE,WAAW,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BvB,CAAC;KACC;IACD;QACE,EAAE,EAAE,wBAAwB;QAC5B,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,mCAAmC;QAC5C,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,wBAAwB;QAChC,MAAM,EAAE,WAAW,CAAC;;;;;;;;;;;;;;;;;;;;;CAqBvB,CAAC;KACC;IACD;QACE,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,sCAAsC;QAC/C,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,WAAW,CAAC;;;;;;;;;;;;;;;;;;;;;;;CAuBvB,CAAC;KACC;CACF,CAAA"}

package/lib/types/shared/cli-settings.d.ts

@@ -0,0 +1,5 @@
+import type { CliId } from './types.ts';
+/** Harness-profile preferences; independent from project model defaults. */
+export interface CliSettings {
+    enabled: Record<CliId, boolean>;
+}

package/lib/types/shared/cli-settings.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli-settings.js.map

package/lib/types/shared/cli-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-settings.js","sourceRoot":"","sources":["../../../src/shared/cli-settings.ts"],"names":[],"mappings":""}

package/lib/types/shared/model-presentation.d.ts

@@ -0,0 +1,10 @@
+import type { ModelChoice, Preference } from './types.ts';
+/** Remove one declared route prefix; remaining slashes can belong to a native model ID. */
+export declare function nativeModelName(id: string): string;
+/** A presentation-only name. Never use the returned text as an execution/lookup ID. */
+export declare function displayModelName(value: string | Preference | ModelChoice): string;
+/**
+ * Present an already-filtered native catalog. Keep the complete raw catalog for
+ * validation. A group selects one whole route, never a union of capabilities.
+ */
+export declare function visibleModelChoices(raw: readonly ModelChoice[], selectedFullId?: string): ModelChoice[];

package/lib/types/shared/model-presentation.js

@@ -0,0 +1,95 @@
+import { modelName } from "./models.js";
+/** Remove one declared route prefix; remaining slashes can belong to a native model ID. */
+export function nativeModelName(id) {
+    const text = id.trim();
+    if (text.startsWith('[')) {
+        try {
+            const parts = JSON.parse(text);
+            if (Array.isArray(parts) && parts.length === 2 && parts.every((part) => typeof part === 'string'))
+                return parts[1];
+        }
+        catch {
+            /* Historical unknown formats remain readable without changing their ID. */
+        }
+    }
+    const slash = text.indexOf('/');
+    return slash > 0 && /^[A-Za-z0-9_.:-]+$/u.test(text.slice(0, slash)) ? text.slice(slash + 1) : text;
+}
+function withoutAnnotations(name) {
+    const visible = [];
+    let depth = 0;
+    for (const character of name) {
+        if (character === '(' || character === '（')
+            depth++;
+        else if (character === ')' || character === '）') {
+            if (depth)
+                depth--;
+        }
+        else if (!depth)
+            visible.push(character);
+    }
+    return visible.join('').replace(/\s+/gu, ' ').trim();
+}
+/** Short visible text only; native identity/grouping retains organization namespaces. */
+function visibleModelName(name) {
+    const native = nativeModelName(name);
+    const parts = native.split('/');
+    return parts.length > 1 && parts.slice(0, -1).every((part) => /^[A-Za-z0-9_.:-]+$/u.test(part))
+        ? parts.at(-1).trim() || native
+        : native;
+}
+/** A presentation-only name. Never use the returned text as an execution/lookup ID. */
+export function displayModelName(value) {
+    // A raw ID has no provider annotation field. Parentheses can be part of its
+    // legal native name, so strip annotations only from the catalog's label.
+    if (typeof value === 'string')
+        return visibleModelName(value) || '模型';
+    if ('model' in value)
+        return displayModelName(modelName(value));
+    const label = withoutAnnotations(visibleModelName(value.label ?? '')).replace(/^Claude 官方模型别名\s+/u, '');
+    return label || displayModelName(value.id);
+}
+const selectedRoute = (model, selected) => !!selected && (model.id === selected || Object.values(model.variants ?? {}).includes(selected));
+const freeRank = (model) => (model.cost === 'free' ? 0 : 1);
+const normalizedId = (model) => nativeModelName(model.id).trim().toLowerCase();
+/**
+ * Present an already-filtered native catalog. Keep the complete raw catalog for
+ * validation. A group selects one whole route, never a union of capabilities.
+ */
+export function visibleModelChoices(raw, selectedFullId) {
+    const groups = new Map();
+    raw.forEach((model, order) => {
+        const key = normalizedId(model);
+        const current = groups.get(key);
+        if (!current) {
+            groups.set(key, { model, order });
+            return;
+        }
+        if (selectedRoute(model, selectedFullId) ||
+            (!selectedRoute(current.model, selectedFullId) && freeRank(model) < freeRank(current.model)))
+            current.model = model;
+    });
+    const visible = [...groups.values()]
+        .sort((a, b) => freeRank(a.model) - freeRank(b.model) || a.order - b.order)
+        .map(({ model }) => ({ ...model, label: displayModelName(model) }));
+    const labelCounts = new Map();
+    for (const model of visible) {
+        const key = model.label.toLowerCase();
+        labelCounts.set(key, (labelCounts.get(key) ?? 0) + 1);
+    }
+    // Distinct native versions may share a friendly name. Keep separate, clean,
+    // reversible choices instead of coalescing them by that presentation string.
+    for (const model of visible)
+        if (labelCounts.get(model.label.toLowerCase()) > 1)
+            model.label = displayModelName(model.id);
+    const used = new Set();
+    for (const model of visible) {
+        const base = model.label;
+        let suffix = 1;
+        while (used.has(model.label.toLowerCase()))
+            model.label = `${base} · ${++suffix}`;
+        used.add(model.label.toLowerCase());
+    }
+    return visible;
+}
+//# sourceMappingURL=model-presentation.js.map

package/lib/types/shared/model-presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-presentation.js","sourceRoot":"","sources":["../../../src/shared/model-presentation.ts"],"names":[],"mappings":"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"}

package/lib/types/shared/models.d.ts

@@ -0,0 +1,7 @@
+import { type ModelChoice, type Preference } from './types.ts';
+/** Only remove an exact, known effort suffix for Antigravity display. Execution keeps the raw ID. */
+export declare function modelName(preference: Preference): string;
+/** Group only variants explicitly advertised by the CLI, never infer missing levels. */
+export declare function groupAgyModels(raw: ModelChoice[]): ModelChoice[];
+/** Accept old raw IDs and new grouped choices; return the exact executable preference. */
+export declare function resolveModel(preference: Preference, models: ModelChoice[]): Preference;

package/lib/types/shared/models.js

@@ -0,0 +1,35 @@
+import { cliOf, EFFORTS } from "./types.js";
+/** Only remove an exact, known effort suffix for Antigravity display. Execution keeps the raw ID. */
+export function modelName(preference) {
+    return cliOf(preference) === 'antigravity' && preference.model.endsWith(`-${preference.effort}`)
+        ? preference.model.slice(0, -preference.effort.length - 1)
+        : preference.model;
+}
+/** Group only variants explicitly advertised by the CLI, never infer missing levels. */
+export function groupAgyModels(raw) {
+    const groups = new Map();
+    for (const model of raw) {
+        const effort = EFFORTS.find((e) => e !== 'default' && model.id.endsWith(`-${e}`) && model.label.toLowerCase().endsWith(`(${e})`));
+        const id = effort ? model.id.slice(0, -effort.length - 1) : model.id;
+        const level = effort ?? 'default';
+        const group = groups.get(id) ?? {
+            id,
+            label: effort ? model.label.replace(/\s*\([^()]+\)$/, '') : model.label,
+            efforts: [],
+            variants: {},
+        };
+        if (!group.efforts.includes(level))
+            group.efforts.push(level);
+        group.variants[level] = model.id;
+        groups.set(id, group);
+    }
+    return [...groups.values()].map((m) => ({ ...m, efforts: EFFORTS.filter((e) => m.efforts.includes(e)) }));
+}
+/** Accept old raw IDs and new grouped choices; return the exact executable preference. */
+export function resolveModel(preference, models) {
+    const model = models.find((m) => m.id === preference.model || Object.values(m.variants ?? {}).includes(preference.model));
+    if (!model || !model.efforts?.includes(preference.effort))
+        throw new Error('模型或思考强度已不可用，请重新选择');
+    return { ...preference, model: model.variants?.[preference.effort] ?? model.id };
+}
+//# sourceMappingURL=models.js.map

package/lib/types/shared/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../src/shared/models.ts"],"names":[],"mappings":"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"}

package/lib/types/shared/telemetry.d.ts

@@ -0,0 +1,18 @@
+/** Counts reported by the CLI. Scope is explicit; snapshots must not be added twice. */
+export interface TokenUsage {
+    total: number;
+    input?: number;
+    output?: number;
+    cacheRead?: number;
+    scope: 'response' | 'run' | 'session' | 'reported';
+}
+export interface Telemetry {
+    contextEstimated?: boolean;
+    contextSource?: string;
+    usage?: TokenUsage;
+    contextUsed?: number;
+    contextCapacity?: number;
+}
+export declare function compactTokens(value: number): string;
+/** Same calendar-day/year cuts and Chinese templates as Harness formatMessageClock. */
+export declare function messageClock(time: string, now?: Date): string;

package/lib/types/shared/telemetry.js

@@ -0,0 +1,16 @@
+export function compactTokens(value) {
+    const scaled = (n) => String(n >= 100 ? Math.round(n) : Math.round(n * 10) / 10);
+    return value < 1000 ? String(value) : value < 1e6 ? `${scaled(value / 1000)}K` : `${scaled(value / 1e6)}M`;
+}
+/** Same calendar-day/year cuts and Chinese templates as Harness formatMessageClock. */
+export function messageClock(time, now = new Date()) {
+    const d = new Date(time);
+    if (!Number.isFinite(d.getTime()))
+        return '—';
+    const clock = `${String(d.getHours()).padStart(2, '0')}:${String(d.getMinutes()).padStart(2, '0')}`;
+    if (d.toDateString() === now.toDateString())
+        return clock;
+    const day = `${d.getMonth() + 1}月${d.getDate()}日 ${clock}`;
+    return d.getFullYear() === now.getFullYear() ? day : `${d.getFullYear()}年 ${day}`;
+}
+//# sourceMappingURL=telemetry.js.map

package/lib/types/shared/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../../src/shared/telemetry.ts"],"names":[],"mappings":"AAeA,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAA;IACxF,OAAO,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,CAAA;AAC5G,CAAC;AACD,uFAAuF;AACvF,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE;IACzD,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAA;IACxB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,GAAG,CAAA;IAC7C,MAAM,KAAK,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAA;IACnG,IAAI,CAAC,CAAC,YAAY,EAAE,KAAK,GAAG,CAAC,YAAY,EAAE;QAAE,OAAO,KAAK,CAAA;IACzD,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,KAAK,EAAE,CAAA;IAC1D,OAAO,CAAC,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,KAAK,GAAG,EAAE,CAAA;AACnF,CAAC"}

package/lib/types/shared/types.d.ts

@@ -0,0 +1,127 @@
+import type { Telemetry, TokenUsage } from './telemetry.ts';
+export declare const EFFORTS: readonly ["default", "none", "minimal", "low", "medium", "high", "xhigh", "max", "ultra"];
+export declare const CLI_IDS: readonly ["antigravity", "codex", "claude", "kimi", "mimo", "zcode", "grok", "omp", "pi", "hermes", "opencode"];
+export type ActiveCliId = (typeof CLI_IDS)[number];
+/** Retired IDs remain readable in existing worker history, never selectable for execution. */
+export type CliId = ActiveCliId | 'harness';
+export declare const RETIRED_HARNESS_NOTICE = "\u5916\u90E8 Harness CLI \u5165\u53E3\u5DF2\u79FB\u9664\uFF1B\u5386\u53F2\u8BB0\u5F55\u4EC5\u4F9B\u67E5\u770B\u3002\u8BF7\u65B0\u5EFA Hermes Agent \u4EFB\u52A1\u3002";
+export declare const isRetiredCli: (cli: CliId) => cli is "harness";
+export declare const CLI_LABELS: Record<CliId, string>;
+/** Short CLI stems used for automatic Worker names; protocol IDs remain unchanged. */
+export declare const CLI_SHORT_NAMES: Record<CliId, string>;
+export declare const cliOf: (preference: Preference) => CliId;
+export declare const effortLabel: (effort: string) => string;
+export declare const LEGACY_ACCOUNT_RECORD_NOTICE = "\u6B64\u5386\u53F2\u4EFB\u52A1\u7F3A\u5C11\u8D26\u53F7\u8BB0\u5F55\uFF0C\u8BF7\u65B0\u5EFA\u4EFB\u52A1";
+export type Effort = (typeof EFFORTS)[number];
+export type WorkerStatus = 'queued' | 'running' | 'stopping' | 'completed' | 'failed' | 'interrupted';
+export type TaskMode = 'plan' | 'accept-edits';
+export interface Preference {
+    /** Missing in v0.1.x data means Antigravity. */
+    cli?: CliId;
+    model: string;
+    effort: Effort;
+}
+export interface ModelChoice {
+    id: string;
+    label: string;
+    /** Explicit native cost evidence only; missing/default zero prices are unknown. */
+    cost?: 'free' | 'paid' | 'unknown';
+    efforts?: Effort[];
+    /** Exact CLI model IDs for the supported effort variants. */
+    variants?: Partial<Record<Effort, string>>;
+}
+/** User-editable role library. Prompts are user instructions, never executable HTML. */
+export interface RolePreset {
+    id: string;
+    name: string;
+    summary: string;
+    prompt: string;
+    builtin?: boolean;
+    source?: string;
+}
+/** Frozen when a worker is created; library edits cannot change an existing conversation. */
+export interface RoleSnapshot {
+    presetId?: string;
+    name: string;
+    summary: string;
+    prompt: string;
+}
+export interface Worker {
+    id: string;
+    parentSessionId: string;
+    project: string;
+    title: string;
+    agentName?: string;
+    /** Provenance distinguishes automatic names from user-supplied lookalikes. */
+    agentNameOrigin?: 'auto' | 'custom';
+    /** Exact former automatic names reserved for compatible historical references. */
+    nameAliases?: string[];
+    /** Reversible deletion keeps the original Worker, native session and account binding. */
+    archivedAt?: string;
+    role?: RoleSnapshot;
+    preference: Preference;
+    mode: TaskMode;
+    conversationId?: string;
+    status: WorkerStatus;
+    createdAt: string;
+    updatedAt: string;
+    runId: string;
+    jobId?: string;
+    error?: string;
+    observedModel?: string;
+    lastResult?: string;
+}
+/** Stable, non-mutating name for histories created before named workers. */
+export declare const workerName: (worker: Worker) => string;
+export interface WorkerEvent {
+    seq: number;
+    runId: string;
+    time: string;
+    kind: 'user' | 'assistant' | 'tool' | 'status' | 'diagnostic' | 'result';
+    text: string;
+    observedModel?: string;
+    step?: number;
+    state?: string;
+    detail?: string;
+}
+export interface TimelineItem {
+    usage?: TokenUsage;
+    id: string;
+    kind: WorkerEvent['kind'];
+    text: string;
+    time: string;
+    state?: string;
+    detail?: string;
+    /** Run ended without a final tool status; the observed CLI state stays intact. */
+    runStatus?: WorkerStatus;
+    runStartedAt?: string;
+    runEndedAt?: string;
+    runOutcome?: WorkerStatus;
+}
+export interface WorkerSnapshot {
+    telemetry?: Telemetry;
+    workers: Worker[];
+    archivedWorkers?: Worker[];
+    selected?: Worker;
+    /** Safe selected-Worker admission information; never exposes account identities. */
+    resumeBlockedReason?: string;
+    timeline: TimelineItem[];
+    revision: number;
+    truncated: boolean;
+}
+/** A bounded, frozen reading page; indexes/count refer to the moment it was read. */
+export interface HistoryPage {
+    workerId: string;
+    items: TimelineItem[];
+    start: number;
+    end: number;
+    total: number;
+    hasOlder: boolean;
+    hasNewer: boolean;
+}
+export declare const active: (status: WorkerStatus) => status is "queued" | "running" | "stopping";
+/** Fold repeated step updates without duplicating streamed text or the final response. */
+export declare function foldEvents(events: readonly WorkerEvent[], endedRun?: {
+    runId: string;
+    status: WorkerStatus;
+}): TimelineItem[];