Przeglądaj źródła

docs: 补齐 webnovel-dashboard 与 webnovel-learn 的边界和恢复规则

lingfengQAQ 2 miesięcy temu
rodzic
commit
860e479d6c

+ 22 - 0
webnovel-writer/skills/webnovel-dashboard/SKILL.md

@@ -72,3 +72,25 @@ python -m dashboard.server --project-root "${PROJECT_ROOT}" --no-browser
 - Dashboard 为纯只读面板,不提供修改接口。
 - 文件读取必须限制在 `PROJECT_ROOT` 范围内。
 - 如需自定义端口,使用 `--port 9000`。
+
+## 成功标准
+
+- Dashboard 进程已启动且输出了可访问的 URL
+- 浏览器可正常打开页面(或 `--no-browser` 模式下 URL 可手动访问)
+- 页面显示项目数据(章节列表、实体图谱等)
+
+## 失败恢复
+
+| 故障 | 恢复方式 |
+|------|---------|
+| 依赖安装失败 | 检查 Python 版本和网络,手动 `pip install -r requirements.txt` |
+| 前端 `dist/` 缺失 | 确认插件完整安装,dist 应随插件打包 |
+| 项目根解析失败 | 检查 `.webnovel/state.json` 是否存在,确认 `WORKSPACE_ROOT` 正确 |
+| 端口占用 | 使用 `--port <其他端口>` 或关闭占用进程 |
+| 页面空白/数据缺失 | 确认 `.webnovel/` 下有 state.json、index.db 等数据文件 |
+
+## 安全边界
+
+- 只读操作,不修改任何项目文件
+- 文件访问限制在 `PROJECT_ROOT` 范围内
+- 不暴露外部网络(默认 localhost)

+ 21 - 0
webnovel-writer/skills/webnovel-learn/SKILL.md

@@ -43,3 +43,24 @@ allowed-tools: Read Write Bash
 ## 约束
 - 不删除旧记录,仅追加
 - 避免完全重复的 description(可去重)
+
+## 去重规则
+
+- 追加前扫描已有 `patterns` 数组
+- 若存在 `pattern_type` + `description` 完全相同的记录,跳过并告知用户
+- 部分相似不去重,由用户判断
+
+## 成功标准
+
+- `project_memory.json` 存在且格式合法
+- 新 pattern 已追加到 `patterns` 数组
+- 输出包含 `status: success` 和完整 `learned` 对象
+
+## 失败恢复
+
+| 故障 | 恢复方式 |
+|------|---------|
+| `project_memory.json` 不存在 | 自动初始化 `{"patterns": []}` 后继续 |
+| JSON 解析失败 | 不写入脏数据,告知用户文件损坏并建议手动修复 |
+| `state.json` 缺失导致无法获取章节号 | 使用 `source_chapter: null`,不阻断 |
+| 用户输入无法归类 | 使用 `pattern_type: "other"`,不阻断 |