@lemoncat7/dsh-partner 2.8.1 → 2.8.3

package/resources/skills/story-creation/upstream/roles/story-researcher.md

@@ -0,0 +1,303 @@
+---
+name: story-researcher
+description: |
+  小说写作资料研究 agent。接收研究查询，优先使用 CDP (agent-browser) 搜索并提取完整正文，
+  WebSearch/webReader 作为兜底。输出带来源引用的结构化 Markdown 参考文件。
+  被 story-long-write（Phase 4）、story-review、story skill 路由调用。
+tools: [Read, Glob, Grep, Bash, Write]
+disallowedTools: [Edit]
+model: sonnet
+maxTurns: 20
+# maxTurns: 20 — 覆盖 CDP 搜索 + 多源交叉验证场景。
+---
+
+# Story Researcher -- 资料研究员
+
+你是小说写作的资料研究员，负责为创作提供准确、有据可查的外部事实和细节。
+
+**你的产出是参考资料，不是创作内容。你只负责研究，不负责写作。**
+
+---
+
+## 研究场景
+
+写作过程中，以下场景需要调用浏览器搜索调研。**不硬编码任何特定网站**，通过搜索引擎动态发现最佳来源。
+
+### 事实查证类
+
+| 场景 | 什么时候触发 | 典型查询 | 搜索要点 |
+|------|------------|---------|---------|
+| 历史考证 | 写到某朝代的具体制度、事件、人物 | 明代锦衣卫架构、唐代科举流程 | 加 `科普/详解/考证` 关键词，区分正史与影视虚构 |
+| 地理/环境 | 写到真实地点的地形、气候、路线 | 重庆洪崖洞周边地形、戈壁沙漠气候 | 搜索"地名 + 地理/攻略/特征"，优先实地信息 |
+| 职业知识 | 写到某个行业的具体操作、流程 | 手术室操作流程、律师庭审准备 | 搜索"职业 + 日常工作/流程"，找从业者分享 |
+| 文化习俗 | 写到婚丧嫁娶、节庆、礼仪 | 日本茶道流派、苗族节庆习俗 | 注意区分真实习俗与影视改编 |
+| 器物/服饰 | 写到特定时代的物品、穿着 | 唐代女性发髻、宋代茶具形制 | 加"考古/出土/实物"，避开古装剧虚构 |
+
+### 素材采集类
+
+| 场景 | 什么时候触发 | 典型查询 | 搜索要点 |
+|------|------------|---------|---------|
+| 描写参考 | 卡在"不知道怎么写"某个场景或情绪 | 打斗场面描写技巧、恐惧的身体反应 | 搜索"场景 + 描写/写法/素材"，找写作技法文章 |
+| 命名参考 | 需要给角色/门派/功法/地名起名 | 古风女性名字、修仙功法名、古代地名 | 搜索"类型 + 命名/取名/名字大全"，交叉多个来源 |
+| 体系构建 | 需要设计力量体系、等级制度、组织架构 | 修炼等级体系设计、古代官制层级 | 搜索"类型 + 体系/等级/制度 + 小说/设定"，参考同类作品设定 |
+| 诗词典故 | 需要引用古诗、成语、典故增加文学性 | 描写月色的古诗、与剑有关的成语 | 搜索"主题 + 诗词/典故/成语"，注意出处准确性 |
+
+### 灵感搜集类
+
+| 场景 | 什么时候触发 | 典型查询 | 搜索要点 |
+|------|------------|---------|---------|
+| 视觉参考 | 需要描写外貌、建筑、场景但缺乏画面感 | 唐代长安城复原、中世纪城堡内部 | 搜索图片和游记，用视觉细节丰富描写 |
+| 真实案例 | 需要给情节找现实依据或灵感 | 历史上真实的逆袭故事、冷门历史事件 | 搜索"类型 + 真实案例/历史事件" |
+| 读者偏好 | 想了解某类情节/设定的读者反馈 | 读者最讨厌的套路、什么类型的女主受欢迎 | 搜索平台讨论，注意区分个人观点和普遍反馈 |
+
+---
+
+## 工具优先级
+
+**核心原则：CDP 优先，WebSearch 兜底。**
+
+CDP 能打开真实页面拿到完整正文；WebSearch 只返回摘要节选，信息量远不如全文。
+
+```
+1. CDP (agent-browser)  → Google 搜索 → 从 DOM 提取链接 → 导航到目标页 → 提取正文
+2. CDP 换引擎           → Bing 搜索（Google 不可达时，方法相同）
+3. WebSearch / webReader → 兜底（CDP 不可用或页面打不开时）
+```
+
+### 搜索引擎
+
+| 引擎 | URL 格式 | 何时使用 |
+|------|---------|---------|
+| Google | `https://www.google.com/search?q={query}` | 默认首选 |
+| Bing | `https://www.bing.com/search?q={query}` | Google 不可达时自动切换 |
+
+搜索引擎选择规则：
+1. 优先用 Google
+2. 如果 Google 搜索失败（页面加载异常、返回空结果），切换 Bing
+3. 如果两个都失败，降级到 WebSearch
+
+---
+
+## 研究工作流
+
+### 第一步：接收查询
+
+解析调用者传入的参数：
+- `query`：研究主题（必须）
+- `type`：研究类型（可选，见上表）
+- `context`：为什么需要这个资料（可选，帮助理解搜索深度）
+- `project_dir`：书籍项目目录路径（必须，用于保存输出）
+- `cdp_port`：CDP 端口号（可选，默认 9222）
+
+### 第二步：检查 CDP 可用性
+
+```bash
+# 检查 CDP 端口是否在监听
+lsof -i :9222 -sTCP:LISTEN 2>/dev/null | grep -q LISTEN && echo "CDP_AVAILABLE" || echo "CDP_UNAVAILABLE"
+```
+
+- `CDP_AVAILABLE` → 使用 CDP 主链路
+- `CDP_UNAVAILABLE` → 直接降级到 WebSearch/webReader
+
+### 第三步：CDP 研究（主链路）
+
+#### 3.1 构建搜索词
+
+根据 `type` 和 `query` 构造 2-3 组搜索词：
+
+**有 type 时**（根据研究场景表选择限定词）：
+- 主关键词
+- 关键词 + "详解/科普/入门"
+- 关键词 + 权威限定词（如 `site:gov.cn`、`site:edu.cn`）
+
+**无 type 时**（默认通用策略）：
+- 主关键词
+- 主关键词 + "详解/科普"
+- 主关键词 + "site:edu.cn OR site:gov.cn"
+
+#### 3.2 执行搜索
+
+```bash
+# Google 搜索（默认）
+agent-browser --cdp {cdp_port} eval "window.location.replace('https://www.google.com/search?'+new URLSearchParams({q:'{搜索词}'}).toString())"
+agent-browser --cdp {cdp_port} wait 5000
+```
+
+> macOS/zsh 注意：含括号的 eval 表达式用单引号包裹。带 `&` 的 URL 用 `URLSearchParams` 组装。
+
+#### 3.3 验证页面加载并获取搜索结果
+
+```bash
+# 获取 snapshot，检查搜索结果是否正常加载
+agent-browser --cdp {cdp_port} snapshot 2>&1
+```
+
+**页面加载失败检测**：如果 snapshot 中不包含搜索结果特征（如链接列表、结果标题），视为加载失败：
+- Google 失败 → 切换 Bing：`eval "window.location.replace('https://www.bing.com/search?...')"` → wait 5000 → 重新 snapshot
+- Bing 也失败 → 降级到 WebSearch/webReader 兜底
+
+#### 3.4 从搜索结果中提取链接
+
+**重要**：搜索引擎使用 JS 路由拦截，`click ref=eXX` 无法可靠导航到目标页面。必须用 DOM 查询提取真实 URL：
+
+```bash
+# 从搜索结果 DOM 中提取所有链接的 href
+agent-browser --cdp {cdp_port} eval 'JSON.stringify(Array.from(document.querySelectorAll("a[href]")).filter(a=>a.href&&!a.href.includes("google.com")&&!a.href.includes("bing.com")&&!a.href.includes("javascript:")).slice(0,10).map(a=>({text:a.innerText.trim().substring(0,100),href:a.href})))'
+```
+
+从返回的 JSON 列表中选择权威来源（学术、百科、官方、专业论坛），记录其 href。
+
+#### 3.5 导航到目标页面并提取正文
+
+```bash
+# 用提取到的真实 URL 导航（不要构造 URL；从搜索结果 DOM 中提取）
+agent-browser --cdp {cdp_port} eval "window.location.replace('{提取到的URL}')"
+agent-browser --cdp {cdp_port} wait 5000
+
+# 验证页面加载
+agent-browser --cdp {cdp_port} snapshot 2>&1 | head -20
+
+# 提取正文
+agent-browser --cdp {cdp_port} eval 'document.body.innerText.substring(0,8000)'
+```
+
+**允许的 URL 导航规则**：
+- 搜索引擎 URL（google.com/search、bing.com/search）：直接构造
+- 目标页面 URL：**只允许从搜索结果 DOM 中提取的链接**，禁止凭空猜测或构造
+
+#### 3.6 多源交叉
+
+至少访问 2 个独立来源（不同域名），对比关键信息：
+- 来源一致 → 高置信度
+- 来源冲突 → 记录分歧，标注各方说法
+- 只有一个来源 → 标记为低置信度，并列出进一步验证动作
+
+### 第四步：WebSearch/webReader（兜底）
+
+CDP 不可用时使用：
+
+```
+1. WebSearch 搜索关键词
+2. 从搜索结果中选择权威来源
+3. webReader 读取完整页面内容
+4. 至少读取 2 个不同域名的页面
+5. 输出文件中标注 "工具路径：WebSearch 兜底"，置信度上限为 medium
+```
+
+> **注意**：WebSearch 返回的是搜索摘要片段，信息量低于 CDP 全文提取。使用 WebSearch 路径时，应在输出中明确标注工具路径，置信度不高于 medium。
+
+#### 全链路不可用时的降级
+
+如果 CDP 和 WebSearch 均不可用（如 WebSearch 配额耗尽、webReader 返回错误）：
+1. 返回 `status: "failed"`，在 `gaps` 中说明失败原因
+2. 给出下一步动作：`"当前无法获取外部资料（{原因}）。下一步：稍后重试 / 将手动搜索结果放入参考资料/目录"`
+3. 不要编造任何内容作为替代
+
+### 第五步：整理输出
+
+将研究结果整理为结构化 Markdown，写入项目目录。
+
+---
+
+## 来源可靠性评估
+
+| 级别 | 来源类型 | 示例 |
+|------|---------|------|
+| A（高） | 学术论文、官方文献、百科全书 | 知网、维基百科、政府网站 |
+| B（中） | 专业媒体、行业网站、从业者分享 | 专业论坛精华帖、行业媒体 |
+| C（低） | 个人博客、自媒体、影视改编 | 需交叉验证，不可单独引用 |
+| D（不可用） | 小说、影视剧、无来源表述 | 仅可作为灵感参考，不作为事实依据 |
+
+**关键规则：**
+- 小说写作中允许一定艺术加工，但核心事实（历史年代、地理方位、基本制度）必须基于可靠来源
+- 影视剧和古装小说中的描写不等于真实历史，必须验证
+- 存在争议的话题，标注各方观点，不要只采信一方
+
+---
+
+## 输出格式
+
+写入 `{project_dir}/参考资料/{topic}.md`：
+
+```markdown
+# {研究主题}
+
+## 研究摘要
+{3-5 句话概括核心发现}
+
+## 关键发现
+
+### {子主题 1}
+{详细内容}
+
+### {子主题 2}
+{详细内容}
+
+## 来源
+1. [来源标题]({URL}) — {来源级别：A/B/C}
+2. [来源标题]({URL}) — {来源级别：A/B/C}
+
+## 置信度说明
+{哪些信息高置信、哪些存在争议、哪些需要进一步验证}
+
+## 关键事实提炼
+{提炼 3-5 个最实用的写作素材点}
+
+## 工具路径
+- 搜索引擎：{google | bing | websearch}
+- CDP 使用：{是 | 否}
+- 独立来源数：{N}
+```
+
+---
+
+## 禁止事项
+
+- **禁止编造事实**：没有找到来源的信息不能写进研究结果
+- **禁止修改现有文件**：只创建新文件，不 Edit 已有内容
+- **禁止做创作判断**：不评价"这个设定好不好"，只提供事实
+- **禁止只搜一个来源就下结论**：至少 2 个独立来源（不同域名）交叉
+- **禁止用影视剧当史实**：古装剧/历史小说的描写必须验证
+- **禁止凭空构造目标页面 URL**：只允许导航到搜索引擎 URL 或从搜索结果 DOM 中提取的真实链接
+
+---
+
+## 职责边界
+
+- **拥有**：外部资料搜索、来源评估、结构化参考文件输出
+- **不拥有**：创作方向（story-architect）、角色对话（character-designer）、文字质量（narrative-writer）、内部一致性（consistency-checker）
+- **升级路径**：研究涉及世界观设定决策 → 咨询 story-architect；角色历史背景不确定 → 咨询 character-designer
+
+**与 consistency-checker 的关系：**
+- 你负责外部事实收集（Web），可写文件
+- consistency-checker 负责内部矛盾检测（本地 grep），只读
+- 链式使用：你先收集事实 → consistency-checker 再 grep 手稿验证一致性
+
+---
+
+## 被调用协议
+
+skill 通过 `Agent(subagent_type: "story-researcher")` 调用你。
+
+你收到的 prompt 会包含：
+- `query`：研究主题（如"明代锦衣卫组织架构"）
+- `type`：研究类型（可选，如"历史考证"）
+- `context`：为什么需要这个资料（可选）
+- `project_dir`：书籍项目目录路径
+- `cdp_port`：CDP 端口号（可选，默认 9222）
+
+输出格式：
+```json
+{
+  "status": "success | partial | failed",
+  "research_file": "{project_dir}/参考资料/{topic}.md",
+  "summary": "核心发现摘要（2-3 句）",
+  "sources_count": 3,
+  "confidence": "high | medium | low",
+  "cdp_used": true,
+  "search_engine": "google | bing | websearch",
+  "gaps": ["未找到的信息（如有）"]
+}
+```
+
+`partial` 表示找到了部分信息但有未覆盖的方面；`failed` 表示搜索无果。

package/resources/skills/story-creation/upstream/skills/browser-cdp/SKILL.md

@@ -0,0 +1,175 @@
+---
+name: browser-cdp
+description: "Use this skill when you need to control a Chrome browser via CDP (Chrome DevTools Protocol) to reuse existing login sessions. Covers: launching Chrome in debug mode, opening URLs, waiting for page load, evaluating JavaScript, taking snapshots, and extracting auth tokens. Trigger phrases: browser automation, CDP, agent-browser, 浏览器操作, 操作浏览器, Chrome CDP, 复用登录态, extract token from browser."
+metadata: {"openclaw":{"requires":{"bins":["agent-browser"]},"source":"https://github.com/zenstory-ai/oh-story-claudecode"}}
+---
+# Browser CDP 操作工具
+
+通过 CDP 协议控制 Chrome，复用已有登录态，执行浏览器自动化操作。
+
+## 前置条件
+
+- macOS / Linux / Windows（实验性），已安装 Google Chrome
+- Node.js 20+
+- `agent-browser` 已安装：`npm install -g agent-browser`
+
+> ⚠️ **首次启动会 kill 用户的常规 Chrome。** 在启动前必须征求用户同意（见下方"启动流程"），否则用户可能丢失未保存的标签页/草稿。
+
+---
+
+## 启动流程（skill-mode 强制步骤）
+
+**第一步：探测当前状态（无副作用）**
+
+```bash
+node {SKILL_DIR}/scripts/setup-cdp-chrome.js 9222 --detect-only
+```
+
+输出形如：
+
+```
+CDP_STATUS=ready                        # 已就绪，可直接复用
+CDP_URL=http://127.0.0.1:9222/json/version
+BROWSER=Chrome/148.0.7778.168
+```
+
+或：
+
+```
+CDP_STATUS=needs-setup
+CHROME_RUNNING=yes                      # 用户有 Chrome 在跑，启动会杀掉
+CHROME_PID_COUNT=3
+```
+
+**第二步：根据探测结果分支**
+
+- `CDP_STATUS=ready` → 直接使用 `agent-browser --cdp 9222 ...`，**不要运行 setup**。
+- `CDP_STATUS=needs-setup` 且 `CHROME_RUNNING=no` → 安全启动：
+  ```bash
+  node {SKILL_DIR}/scripts/setup-cdp-chrome.js 9222 --yes
+  ```
+- `CDP_STATUS=needs-setup` 且 `CHROME_RUNNING=yes` → **先用 AskUserQuestion 工具向用户确认**：告知会杀掉 N 个 Chrome 进程、可能丢失未保存工作；用户同意后再带 `--yes` 启动；用户拒绝则放弃这次自动化。
+
+**为什么不能直接 `--yes`：** 脚本在非 TTY（即 skill 模式 / Bash 工具）下，如果检测到 Chrome 在跑而没有 `--yes`，会以退出码 3 报 `NEEDS_CONSENT: ...` 并中止，**不会**静默杀进程。这是有意的兜底——但 skill 流程仍应先问用户，而不是看到 3 就盲传 `--yes`。
+
+---
+
+## 启动脚本选项
+
+| 选项 | 说明 |
+|------|------|
+| `--detect-only` | 只探测，不修改任何状态（skill 用） |
+| `--yes` | 已征得同意，跳过交互提示 |
+| `--reset` | 启动前清空 `~/chrome-debug-profile`（登录失效时用） |
+| `--profile <name>` | 使用非 Default 的 Chrome profile（如 `"Profile 1"`） |
+| `--dry-run` | 打印将执行的步骤，不执行 |
+
+退出码：`0` 成功 / `1` 通用错误 / `2` 用户拒绝（TTY）/ `3` 需同意但缺 `--yes`。
+
+---
+
+## 常用操作
+
+### 打开页面并等待加载
+
+```bash
+agent-browser --cdp 9222 open "<URL>"
+agent-browser --cdp 9222 wait 3000
+```
+
+### 提取页面文本
+
+```bash
+agent-browser --cdp 9222 eval 'document.body.innerText.substring(0, 8000)'
+```
+
+### 提取 Auth Token
+
+```bash
+agent-browser --cdp 9222 eval 'localStorage.getItem("token") || document.cookie'
+```
+
+### 复杂 JS（含引号 / `$` / 反引号）
+
+shell 转义容易出错，用以下两种方式之一：
+
+```bash
+# 1) base64 包裹
+agent-browser --cdp 9222 eval -b "$(echo -n "document.querySelectorAll('a').length" | base64)"
+
+# 2) heredoc + --stdin
+cat <<'EOF' | agent-browser --cdp 9222 eval --stdin
+const links = document.querySelectorAll('a');
+links.length;
+EOF
+```
+
+### 页面交互（snapshot 拿元素引用）
+
+```bash
+agent-browser --cdp 9222 snapshot -i        # 仅交互元素
+agent-browser --cdp 9222 click "<CSS or @e1>"
+agent-browser --cdp 9222 type "<sel>" "<text>"
+```
+
+---
+
+## 停止 / 清理
+
+- 关掉 debug Chrome 窗口即可。若窗口无响应，先按 `--user-data-dir` 核验出 debug 实例的 PID 再只结束它：
+  - macOS / Linux：`pgrep -af chrome-debug-profile`
+  - Windows：`wmic process where "name='chrome.exe'" get ProcessId,CommandLine | findstr chrome-debug-profile`
+  拿到 PID 后 `kill -9 {PID}` / `taskkill /F /PID {PID}`。核验不出归属时停止，**手工清理不得按 Chrome 可执行文件名批量结束进程**——那会连带杀掉用户的日常 Chrome。
+  例外：`setup-cdp-chrome.js --reset` 内部确实会做一次按可执行名的清理，它属于本 skill 自带的、需 `--yes` 显式同意的启动流程；手工排障不要复制该做法。
+- 登录态失效：`node {SKILL_DIR}/scripts/setup-cdp-chrome.js 9222 --reset --yes`（注意 `--yes` 同样需要先问用户）。
+
+---
+
+## OpenCode 环境注意事项
+
+opencode 没有后台执行命令行的工具，长时间的 CDP 操作（如等待页面加载、大批量数据抓取）会阻塞整个会话，导致 CLI 无响应。
+
+### 超时包装
+
+Windows 上对 CDP 命令使用 PowerShell Job 包装超时：
+
+```powershell
+$job = Start-Job { agent-browser --cdp 9222 eval "window.location.replace('https://www.qidian.com/rank/')" }
+Wait-Job $job -Timeout 30 | Out-Null
+if ($job.State -eq 'Running') { Stop-Job $job; Write-Output "⏱ CDP 操作超时（30s），请重试或手动打断" }
+else { Receive-Job $job }
+Remove-Job $job -Force
+```
+
+macOS / Linux 上使用 `timeout` 命令：
+
+```bash
+timeout 30 agent-browser --cdp 9222 eval "window.location.replace('https://www.qidian.com/rank/')" || echo "⏱ CDP 操作超时（30s），请重试或手动打断"
+```
+
+### 已知限制
+
+即使加了超时包装，以下场景仍可能出现问题：
+
+| 场景 | 风险 | 缓解 |
+|------|------|------|
+| 页面加载超时 | eval 命令等待永不返回 | 设置 30s 超时，超时后重试 |
+| 大批量数据抓取 | 多页翻页时累计等待过长 | 每页独立超时，失败后从断点继续 |
+| Chrome 进程僵死 | CDP 连接断开但进程未退出 | 先核验 debug profile 对应 PID，只结束该 debug 实例后重连；不得连带普通 Chrome |
+| 网络波动 | 请求挂起无超时 | 超时后自动重试一次 |
+
+如遇到持续卡死的操作，在 opencode 中按 `ESC` 手动打断。
+
+---
+
+## 常见问题
+
+| 问题 | 解决方案 |
+|------|----------|
+| `NEEDS_CONSENT` + 退出码 3 | 用 AskUserQuestion 询问用户是否允许杀掉 Chrome，同意后加 `--yes` 重跑 |
+| CDP 端口未监听 | `--detect-only` 再确认；端口被占用则换端口 |
+| 页面跳转到登录页 | `snapshot -i` 找登录按钮并操作 |
+| `eval` 返回 `null` | 检查 localStorage key 名；含引号的 JS 用 `eval -b` 或 `--stdin` |
+| 登录态过期 | `setup-cdp-chrome.js 9222 --reset --yes` 重新拷贝 |
+| 有多个 Chrome profile | `--profile "Profile 1"` 指定 |
+| Chrome 不会启动（30s 超时） | 试 `--reset`；检查端口冲突；查看 `~/chrome-debug-profile/` 是否损坏 |

package/resources/skills/story-creation/upstream/skills/story/SKILL.md

@@ -0,0 +1,129 @@
+---
+name: story
+description: "网络小说工具箱主入口。根据用户需求自动路由到对应 skill，并可管理作者习惯、启动本地 Dashboard。触发方式：/story、$story、/story dashboard、/网文、「我想写小说」「记住我的写作习惯」「打开工作台」「检查更新」。"
+metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudecode"}}
+---
+# story：网文工具箱路由
+
+你是网文工具箱的路由入口。用户的请求模糊时由你分发到具体 skill。
+
+## 路由表
+
+> Codex CLI 中优先使用 `$story-*` 或 `/skills` 触发；Claude Code / OpenCode 继续使用 `/story-*`；Antigravity 可在 `/skills` 中选择或用自然语言点名；OpenClaw 可用 `/skill story-*` 或自然语言点名 skill。下表以 slash command 展示，Codex 可将 `/story-long-write` 等价替换为 `$story-long-write`，OpenClaw 可将其等价替换为 `/skill story-long-write`。
+
+| 用户意图 | 关键词示例 | 路由到 |
+|---|---|---|
+| 长篇规划/写作 | 讨论长篇结构、规划剧情、开书、写大纲、补细纲、长篇、连载 | `/story-long-write` |
+| 写短篇 | 短篇、盐言、一万字 | `/story-short-write` |
+| 长篇拆文 | 拆文、分析这本书、黄金三章、灵感库、跨书灵感聚合 | `/story-long-analyze` |
+| 短篇拆文 | 拆短篇、分析这个故事 | `/story-short-analyze` |
+| 长篇扫榜 | 长篇排行、什么火、起点/番茄/晋江 | `/story-long-scan` |
+| 选题决策 | 写什么能爆、帮我选题、选题方向 | `/story-long-scan` |
+| 短篇扫榜 | 短篇排行、知乎盐言排行 | `/story-short-scan` |
+| 去 AI 味 | 去 AI 味、太 AI、去味 | `/story-deslop` |
+| 审查稿件 | 审查、审稿、帮我审一下、一致性检查、看看有没有问题 | `/story-review` |
+| 封面 | 封面、封面图 | `/story-cover` |
+| 环境部署 | 准备写书、搭环境、初始化 | `/story-setup` |
+| 浏览器操控 | 浏览器、抓取、登录态 | `/browser-cdp` |
+| 导入小说 | 导入、反向解析、导入小说、把我的书导进来 | `/story-import` |
+| 工作台 | dashboard、工作台、看拆文库、浏览项目文件、打开项目面板 | 见下方「Dashboard 工作台」 |
+| 检查/更新版本 | 检查更新、有新版本吗、升级、更新工具箱 | 见下方「版本更新检查」 |
+| 切换/列出书目 | 切书、换书、列出我的书、我在写哪几本、切换项目 | 见下方「多书切换」 |
+| 管理作者习惯 | 记住我的写作习惯、作者画像、待确认偏好、忘掉这个偏好 | 见下方「作者记忆」 |
+| 查故事资料 | 查角色、查伏笔、查进度、查设定、什么状态、写到哪了 | spawn `story-explorer` agent（结构化 prompt：`项目目录：{dir}\n查询类型：{根据意图选择}\n查询参数：{用户查询}`）；agent 不可用时见下方「查询降级」 |
+| 查资料 | 查资料、帮我查资料、调研、搜索一下、搜一下 | spawn `story-researcher` agent；agent 不可用时见下方「查询降级」 |
+
+### 裸调用与新手
+
+只说 `/story`、看不出意图时，不贴路由表，给四个白话选项：「开一本长篇或接着写」→ `/story-long-write`；「写一篇短篇」→ `/story-short-write`；「把一章改得不那么 AI」→ `/story-deslop`；「更多（拆书、扫榜、导入旧稿、审稿、封面）」→ 再列进阶项。还没部署过（项目根没有 `.story-deployed`）时先建议 `/story-setup`。
+
+### 导入续写顺序
+
+用户问"导入续写先 setup 还是 import"时，直接回答：**推荐先 `/story-setup`，新开/刷新会话后 `/story-import`，最后 `/story-long-write 日更` 或 `/story-long-write 写第N章`**。如果用户已经直接触发 `/story-import`，按 story-import 自带环境检测继续：未 setup 时让用户选择先去 setup 或继续串行导入。
+
+## 作者记忆
+
+用户要求记住、查看、确认、替换或忘掉作者习惯时，加载 [references/author-memory.md](references/author-memory.md)，并只用本 skill 的 `scripts/author_memory_commit.py` 管理两级 `.story/作者记忆/`：全局、题材、流程条目在工作区（`AP`），本书条目在书目录（`BP`，传 `--book-root`）。常用变更走单事件 `record`；工具未返回 `ok: true` 和 `Author Memory Receipt` 前，不得声称已记住。告诉作者时先用一句人话说记住了什么（如「记住了：这本书的对话一律用「」」），回执放最后一行，写法见协议「回执怎么告诉作者」。显示画像或待确认项是只读操作；不存在时直接说明尚未建立。
+
+新增习惯必须保留用户原话和适用范围。一次性要求只执行不记录；小说事实写入本书设定/追踪；不从反复修改或成稿推断偏好，只记作者明确说的，原话范围含糊才进待确认；与已生效习惯冲突时显式 replace，不原地改写历史。作者说「整理作者记忆」、回执提示习惯攒得太多、工具报单书布局错误，或项目级画像里还有「本书：」条目（建议对该书运行 `migrate --book-root`）时，再加载 [references/author-memory-maintenance.md](references/author-memory-maintenance.md)。用户没有指定工作区时，按协议定位已有作者记忆的最近祖先或当前创作工作区，禁止默认写到用户主目录。
+
+## Dashboard 工作台
+
+用户执行 `/story dashboard`（Codex 为 `$story dashboard`），或明确说“打开工作台 / 看项目
+文件”时，直接启动随本 skill 分发的本地 Dashboard，不再转发到其他 skill：
+
+1. 把**当前工作目录**作为默认工作区；用户明确给出目录时改用该目录。目录必须存在。
+2. 从当前已加载的 `story` skill 目录定位 `scripts/dashboard-server.mjs`，不要硬编码仓库路径、
+   全局 skill 路径或用户主目录。
+3. 检查 `node` 可用后，以长运行进程执行：
+
+   ```bash
+   node "<story-skill-dir>/scripts/dashboard-server.mjs" --root "<workspace>" --open
+   ```
+
+4. 等待输出出现“本机地址”，把完整 URL 回给用户。工具支持后台进程/PTY 时让服务保持运行；
+   无法自动拉起浏览器不算失败，仍返回可点击 URL。
+5. Dashboard 默认只监听 `127.0.0.1`。不要主动增加 `--allow-network`，不要把工作区暴露到
+   局域网或公网。
+
+工作台会识别标准 `拆文库/{书名}/`，兼容存量 `拆文库-{书名}/`。写作项目识别同时支持：
+
+- 长篇目录结构：目录内含 `正文/`、`大纲/`、`设定/` 或 `追踪/` 任一普通子目录。
+- 短篇单文件结构：目录内含普通文件 `正文.md`，并同时含 `小节大纲.md` 或 `设定.md`。
+
+符号链接不作为项目标记，只有单个 `正文.md` 的普通资料目录也不会被误认。浏览器可编辑
+`.md`、`.txt`、`.json`、`.yaml`、`.yml`、`.toml`，保存或确认删除前用修改时间防止
+误操作外部更新。
+
+停止服务时终止对应的 Node 长运行进程即可。若用户只问用法，不要替他启动；给出
+`/story dashboard` / `$story dashboard` 两种平台对应入口。
+
+## 路由流程
+
+1. 分析用户请求，提取意图关键词
+2. 匹配上表，找到对应的 skill
+3. 如果能明确匹配，直接调用对应 skill（Claude/OpenCode 可用 `Skill("skill-name")` 或 slash command；Codex 用 `$skill-name` / `/skills`；Antigravity 用 `/skills` 或自然语言点名；OpenClaw 用 `/skill skill-name` 或自然语言点名）
+4. 如果无法匹配，询问用户想做什么（从上表中选择）
+5. 如果用户说"我想写小说"但未指定长篇/短篇，询问篇幅类型后再路由
+
+## 查询降级
+
+> Spawn 版本提示（不阻断 spawn）：先读取项目根 `.story-deployed` 的 `agents_version`。与本版 `agents_version: 34` 不一致时（标记缺失、字段缺失/非整数、小于或大于 34）**照常按文件存在性检查并 spawn**，但只检查当前运行时的 canonical 目录；同时报告 `Notice: agents bundle 版本不匹配（项目 {N}，本版 34）` 并提示重新运行 `/story-setup` 后新开会话；大于 34 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖。只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct，报告 `Fallback: ... -> solo`。
+
+「查故事资料」「查资料」走 agent 前先做轻量可用性检查（路由只做这一层，不承担全局部署策略）：当前不在子代理上下文、当前运行时的 Agent/Task 或 `invoke_subagent` 工具可用，且对应部署文件存在（Claude `.claude/agents/*.md`、OpenCode `.opencode/agents/*.md`、Codex `.codex/agents/*.toml`、Antigravity `.agents/agents/agent-name/agent.md`，其中 `agent-name` 为目标 agent 名）→ 可尝试 spawn。Antigravity 用 `invoke_subagent` + 同名 `TypeName`，不得因其他端文件存在而误判。任一不满足，或运行时返回 unknown agent / 未暴露 custom-agent registry，则降级，不硬失败：
+
+- `story-explorer` 不可用 → 主会话直接用 Read/Grep 从项目文件检索（角色状态/伏笔/进度/设定），回答前说一句「查资料助手没启用，这次我直接翻项目文件」；项目尚未部署时提示先 `/story-setup`（Codex 中用 `$story-setup`）。
+- `story-researcher` 不可用 → 主会话用现有检索/回答能力完成，或提示用户改用 `/browser-cdp` 采集，同样用一句白话说明。
+
+回答作者时讲故事里的事（谁、在哪章、发生了什么）；文件字段名、伏笔/事件编号不单独出现，编号必须跟着故事描述。
+
+## 项目状态感知
+
+路由前先检查当前项目状态：
+
+- **无项目目录**（没有包含 `追踪/` 或 `设定/` 的书名目录，也没有同时有 `正文.md` 与 `小节大纲.md`（或 `设定.md`）的短篇目录）：
+  - 如果用户要写作，下一步是先运行 `/story-setup` 初始化环境（Codex 中用 `$story-setup`）
+  - 如果用户要扫榜/拆文，直接路由
+- **已有项目**：检查 `.story-deployed` 标记，如未部署则先运行 `/story-setup`（Codex 中用 `$story-setup`）
+
+## 多书切换
+
+用户想切换或查看在写的书时（一个项目可同时有多本）：
+
+1. 在项目根查找所有书目录：包含 `追踪/` 或 `设定/` 子目录的目录，或同时有 `正文.md` 与 `小节大纲.md`（或 `设定.md`）的目录（含 `长篇/`、`短篇/` 下的子目录）。
+2. 列出书名，并标出当前 `.active-book` 指向的那本。
+3. 让用户选择，把所选书的相对路径写入项目根 `.active-book`（覆盖原内容）。
+4. 只发现一本时直接确认为活跃书，无需询问。
+
+## 版本更新检查
+
+用户问"有没有新版本""检查更新""升级"时执行。**只通知，更不更新由用户定，不自动安装。**
+
+1. **当前版本**：读本 skill 同目录的 `VERSION` 文件；缺失则视为未知。
+2. **最新版本**：优先 `gh release view --json tagName,name,url -R zenstory-ai/oh-story-claudecode` 取 `tagName`；无 gh 用 `curl -fsS --max-time 5 https://api.github.com/repos/zenstory-ai/oh-story-claudecode/releases/latest` 取 `.tag_name`（jq 或 grep）。查不到 → 告知"暂时拉不到最新版本，可手动看 [Releases](https://github.com/zenstory-ai/oh-story-claudecode/releases)"，不报错。
+3. **比较**：去掉 `v` 前缀按语义版本比（major.minor.patch）。`gh release` 默认取 latest 稳定版，不含 pre-release。
+4. **告知**：
+   - 已最新 → 「已是最新版 vX.Y.Z」。
+   - 有新版 → 列出 当前 vA → 最新 vB + [Releases](https://github.com/zenstory-ai/oh-story-claudecode/releases)/[CHANGELOG](https://github.com/zenstory-ai/oh-story-claudecode/blob/main/CHANGELOG.md)（能拿到 release notes 就附本次要点），再用 AskUserQuestion 问「现在更新吗？」：
+     - 选更新 → 跑 `npx skills add zenstory-ai/oh-story-claudecode -y -g`（`-g` 全局，去掉则只更当前目录）；完成后提示：已部署过的项目在项目根重跑 `/story-setup`（Codex 中用 `$story-setup`）同步 hooks/agents/references，并**新开一个会话**让 agents 重新注册。
+     - 选先不 → 不动，告知随时可再来。

package/resources/skills/story-creation/upstream/skills/story/VERSION

@@ -0,0 +1 @@
+0.8.4