@cloud411716/fancy-webnovel 2.2.0 → 3.0.3

package/README.md

@@ -0,0 +1,65 @@
+# fancy-webnovel
+
+DeepSeek Harness（DSH）网文创作插件组合包。它把工作区初始化、扫榜、选题、拆书、故事构建、素材库和抖音图文采集注册成 `/fancy-*` 命令。
+
+## 环境
+
+- Node.js >= 18
+- DSH `>=0.1.5-rc.2 <0.2.0 || >=0.2.2-rc.3 <0.3.0`
+- 需要图形桌面时（首次抖音登录、番茄 OCR 截图）要能打开 Chrome
+
+## 安装
+
+```bash
+dsh plugin --profile web add @cloud411716/fancy-webnovel
+```
+
+安装后确认：
+
+```bash
+dsh --profile web --dump-config
+```
+
+应能看到 `# == @cloud411716/fancy-webnovel` 这一层。
+
+如果 pnpm 报：
+
+```text
+ERR_PNPM_IGNORED_BUILDS  Ignored build scripts: tesseract.js@7.0.0
+```
+
+编辑 profile 的 `pnpm-workspace.yaml`：
+
+```yaml
+allowBuilds:
+  tesseract.js: true
+```
+
+然后重新执行安装。`tesseract.js` 的 postinstall 只是 OpenCollective 提示；不允许构建时 OCR 模式不可用，但插件其余功能不受影响。
+
+## 依赖解析
+
+依赖声明在 `dependencies` / `peerDependencies` 中。用 `dsh plugin add` 从 npm 安装时，
+第三方依赖会进入 profile 的 `node_modules`，而不是插件包目录；Node 的向上查找会从
+插件包解析到这些依赖。插件自带的 `node_modules` 只用于本地 checkout 和测试，不是运行前提。
+
+需要与宿主共享实例的 DSH 包使用 `peerDependencies`（并保留 `devDependencies` 供本地测试），
+不会被插件重复安装。
+
+## 主要命令
+
+```text
+/fancy-bootstrap
+/fancy-scan
+/fancy-topic
+/fancy-analyze
+/fancy-import
+/fancy-export
+/fancy-project
+/fancy-db
+/fancy-material
+/fancy-douyin
+/fancy-build
+```
+
+具体用法见各命令的 `/fancy-* help` 和 `docs/`。

package/client.js

@@ -32,8 +32,9 @@
  * 2) 注册一个自己的 conversation-node Definition（kind = "fancy-notice"），
  *    匹配 command/run + command/done，只对 fancy-* 命令产出节点。
  *    它的 kind 不是 "command" → 聊天区被点亮 → 结果可见。
- *    节点本身**不渲染任何内容**（display:none）：结果由 DSH 原生的命令卡片
- *    （GenericCommandCard）渲染，本来就完整，不需要我们再画一遍。
+ *    完成结果在 command/done 的位置渲染成展开的绿/红边框卡片：
+ *    原生命令卡默认收成一行、需要点击展开，这里直接把多行内容铺开，
+ *    让阶段完成/失败和 help/query 等结果都一眼可见。
  *
  * 3) 空白会话里聊天区不挂载 → chat target 永远不会自动激活 →
  *    conversationPhase（dsh-client-ui-conversation/lib/client.js:14011）
@@ -61,8 +62,13 @@ window.__ModuleLoader__.load({
 			"fancy-analyze",
 			"fancy-import",
 			"fancy-scan",
-			"fancy-story-builder",
-			"fancy-topic"
+			"fancy-build",
+			"fancy-export",
+			"fancy-topic",
+			"fancy-db",
+			"fancy-project",
+			"fancy-material",
+			"fancy-douyin"
 		];
 
 		/** 复刻 dsh-client-ui-chat 的 contextLocation（那边是包内私有函数）。 */
@@ -70,7 +76,12 @@ window.__ModuleLoader__.load({
 			return context.start?.location ?? context.matches[0]?.location ?? { kind: "unresolved" };
 		}
 
-		/** 把 command/run + command/done 折算成一条 fancy 通知。 */
+		/**
+		 * 把 command/run + command/done 折算成一条 fancy 通知。
+		 *
+		 * 所有 fancy-* 命令的完成结果都锚定到 command/done 的位置，
+		 * 用展开的多行卡片显示；DSH 原生命令卡仍保留在命令开始处。
+		 */
 		var noticeDefinition = {
 			kind: NOTICE_KIND,
 			target: "chat",
@@ -83,7 +94,9 @@ window.__ModuleLoader__.load({
 				return {
 					name: match.event.data.name ?? "",
 					args: match.event.data.args ?? null,
-					outcome: null
+					outcome: null,
+					doneSeq: null,
+					doneLocation: null
 				};
 			},
 			update: function (context, match) {
@@ -94,7 +107,9 @@ window.__ModuleLoader__.load({
 					outcome: {
 						kind: match.event.data.kind,
 						text: match.event.data.text ?? ""
-					}
+					},
+					doneSeq: match.event.seq,
+					doneLocation: match.location ?? null
 				};
 			},
 			buildViewNode: function (context) {
@@ -106,8 +121,12 @@ window.__ModuleLoader__.load({
 					kind: NOTICE_KIND,
 					id: context.id,
 					target: "chat",
-					anchorSeq: context.startSeq ?? context.matches[0].event.seq,
-					location: contextLocation(context),
+					// 完成通知锚在 command/done 的位置，才会跟在最后一批 assistant
+					// 消息之后；否则会被几十条逐批消息顶到上面，用户看不到。
+					anchorSeq: state.doneSeq ?? context.startSeq ?? context.matches[0].event.seq,
+					// 用 command/done 的 location，通知才会落在最后一个 turn/step 里；
+					// 沿用命令开始时的 location 会把它重新拽回第一个 turn。
+					location: state.doneLocation ?? contextLocation(context),
 					visibility: "visible",
 					data: state
 				};
@@ -115,16 +134,171 @@ window.__ModuleLoader__.load({
 		};
 
 		/**
-		 * 点亮用的隐形节点。真正的可见内容由 DSH 原生命令卡片渲染，
-		 * 这里只留一个 data 钩子，方便自动化测试断言。
+		 * 所有 fancy-* 命令的结果都渲染成展开的带边框卡片。
+		 *
+		 * 和 DSH 原生命令卡的区别：原生命令卡默认收成一行，要点一下才展开；
+		 * 这里直接用 pre-wrap 保留换行，并把成功/失败用绿/红边框区分。
+		 * 仍然只读 command/run + command/done，不写会话、不唤醒 agent。
 		 */
 		function FancyNoticeNodeView(props) {
 			var data = props?.node?.data ?? {};
-			return react.createElement("div", {
+			var outcome = data.outcome;
+			var known = FANCY_COMMANDS.indexOf(data.name) !== -1;
+			var baseProps = {
 				"data-fancy-notice": data.name ?? "",
-				"data-fancy-notice-kind": data.outcome?.kind ?? "",
-				style: { display: "none" }
-			});
+				"data-fancy-notice-kind": outcome?.kind ?? ""
+			};
+
+			if (outcome === null || outcome === undefined || !known) {
+				return react.createElement("div", {
+					...baseProps,
+					style: { display: "none" }
+				});
+			}
+
+			var failed = outcome.kind === "error";
+			var accent = failed
+				? "var(--dsw-alias-state-error-primary, #d92d20)"
+				: "var(--dsw-alias-state-success-primary, #12b76a)";
+			var background = failed
+				? "rgba(217, 45, 32, 0.08)"
+				: "rgba(18, 183, 106, 0.08)";
+			var args = String(data.args ?? "").trim();
+			var label = (data.name ?? "") + (args === "" ? "" : " " + args);
+
+			return react.createElement("div", {
+				...baseProps,
+				role: "status",
+				"aria-live": "polite",
+				style: {
+					margin: "12px 0",
+					padding: "12px 14px",
+					border: "1px solid " + accent,
+					borderLeftWidth: "4px",
+					borderRadius: "10px",
+					background: background,
+					lineHeight: 1.6,
+					fontSize: "13px",
+					maxHeight: "60vh",
+					overflow: "auto"
+				}
+			},
+			react.createElement("div", {
+				key: "command",
+				style: {
+					marginBottom: "6px",
+					color: "var(--dsw-alias-label-secondary, inherit)",
+					fontSize: "12px",
+					opacity: 0.75
+				}
+			}, label),
+			react.createElement("div", {
+				key: "body",
+				style: {
+					whiteSpace: "pre-wrap",
+					wordBreak: "break-word"
+				}
+			}, outcome.text || (failed ? "命令失败" : "命令完成")));
+		}
+
+		var RUNNING_STYLE_ID = "@cloud411716/fancy-webnovel/running";
+
+		/**
+		 * 执行中提示的动画样式。
+		 *
+		 * 用 CSS 动画而不是 JS 定时器：不触发 React 重渲染，也不会因为
+		 * 命令跑了几十分钟而堆积定时器。原地转圈 + 三点呼吸足够让用户
+		 * 知道任务还在跑。
+		 */
+		function ensureRunningStyle() {
+			if (typeof document === "undefined" || document.head === undefined) return;
+			if (document.querySelector("style[data-plugin-css=" + JSON.stringify(RUNNING_STYLE_ID) + "]") !== null) return;
+			var tag = document.createElement("style");
+			tag.dataset.plugin = "@cloud411716/fancy-webnovel";
+			tag.dataset.pluginCss = RUNNING_STYLE_ID;
+			tag.textContent = [
+				"@keyframes fancy-command-spin{to{transform:rotate(360deg)}}",
+				"@keyframes fancy-command-dot{0%,80%,100%{opacity:.25}40%{opacity:1}}"
+			].join("");
+			document.head.appendChild(tag);
+		}
+
+		/**
+		 * 原生命令卡的替代：命令执行期间显示一条轻量记录；命令完成后返回
+		 * null，把“执行过这个命令”的记录交给 command/done 位置的展开卡片。
+		 *
+		 * 这样不会出现「顶部一张收起卡 + 底部一张展开卡」的重复记录。
+		 * 执行中的转圈和三点是 CSS 动画，原地变化，证明任务没卡死。
+		 */
+		function FancyCommandRecordView(props) {
+			var node = props?.node;
+			if (node === undefined || node === null) return null;
+			if (node.outcome !== null && node.outcome !== undefined) return null;
+			var args = String(node.args ?? "").trim();
+			var label = (node.name ?? "命令") + (args === "" ? "" : " " + args);
+			return react.createElement("div", {
+				"data-fancy-command-running": node.name ?? "",
+				role: "status",
+				"aria-live": "polite",
+				style: {
+					display: "flex",
+					alignItems: "center",
+					gap: "8px",
+					margin: "4px 0",
+					padding: "6px 10px",
+					border: "1px solid var(--dsw-alias-border-l2, rgba(127, 127, 127, 0.25))",
+					borderRadius: "8px",
+					color: "var(--dsw-alias-label-secondary, inherit)",
+					fontSize: "13px",
+					lineHeight: 1.5
+				}
+			},
+			react.createElement("span", {
+				key: "spinner",
+				"data-fancy-command-spinner": "true",
+				"aria-hidden": "true",
+				style: {
+					display: "inline-block",
+					width: "12px",
+					height: "12px",
+					border: "2px solid currentColor",
+					borderTopColor: "transparent",
+					borderRadius: "50%",
+					animation: "fancy-command-spin 0.8s linear infinite",
+					flexShrink: 0
+				}
+			}),
+			react.createElement("span", { key: "label" }, label + " 执行中"),
+			react.createElement("span", {
+				key: "dots",
+				"data-fancy-command-dots": "true",
+				"aria-hidden": "true",
+				style: { display: "inline-flex", gap: "2px" }
+			},
+			react.createElement("span", {
+				key: "dot-0",
+				style: {
+					animation: "fancy-command-dot 1.2s ease-in-out infinite",
+					animationDelay: "0s",
+					opacity: 0.25
+				}
+			}, "."),
+			react.createElement("span", {
+				key: "dot-1",
+				style: {
+					animation: "fancy-command-dot 1.2s ease-in-out infinite",
+					animationDelay: "0.15s",
+					opacity: 0.25
+				}
+			}, "."),
+			react.createElement("span", {
+				key: "dot-2",
+				style: {
+					animation: "fancy-command-dot 1.2s ease-in-out infinite",
+					animationDelay: "0.3s",
+					opacity: 0.25
+				}
+			}, ".")));
 		}
 
 		/**
@@ -132,6 +306,7 @@ window.__ModuleLoader__.load({
 		 * @param ctx - client root context.
 		 */
 		function apply(ctx) {
+			ensureRunningStyle();
 			ctx.uiConversation.events.register(noticeDefinition);
 
 			// 注册我们这个 kind 的渲染器。不注册的话 DSH 会走 JsonBlock 兜底，
@@ -143,6 +318,17 @@ window.__ModuleLoader__.load({
 				}, FancyNoticeNodeView);
 			});
 
+			// 接管 fancy-* 的原生命令卡：执行期间显示一条轻量记录，完成后隐藏，
+			// 避免和 command/done 位置的展开卡片重复。
+			FANCY_COMMANDS.forEach(function (name) {
+				ctx.slots.inject("conversation.chat.commandview", function () {
+					return ctx.slots.register({
+						name: "conversation.chat.commandview",
+						key: name
+					}, FancyCommandRecordView);
+				});
+			});
+
 			/*
 			 * 强制激活当前会话的 chat target。
 			 *

package/cordis.patch.yml

@@ -1,4 +1,8 @@
+# fancy-webnovel plugin entry.
+#
+# DSH also gets native tools (fancy_workspace / fancy_db / fancy_story_*), so
+# the MCP client bridge is optional. To expose the portable MCP server as
+# mcp__fancy__* tools, see docs/mcp-profile.example.yml.
 - insert:
     - id: fancy-webnovel
       name: "@cloud411716/fancy-webnovel"
-      from: "./index.js"

package/docs/douyin-plugin.md

@@ -0,0 +1,118 @@
+# fancy-douyin 抖音图文采集
+
+把记录在案的抖音账号主页下的图文作品，逐篇截图、交给 LLM 提取素材，并写入
+工作区素材库（`source=other`，kind 不受内置列表限制）。
+
+## 命令
+
+```text
+/fancy-douyin add <主页地址>
+/fancy-douyin list
+/fancy-douyin remove <序号|地址>
+/fancy-douyin
+/fancy-douyin help
+```
+
+`add` 只接受账号主页，例如：
+
+```text
+https://www.douyin.com/user/MS4wLjABAAAA...
+```
+
+单篇作品地址、视频地址和短链会被拒绝。
+
+## 无参数运行
+
+```text
+依次扫描账号主页
+→ 收集所有 /note/ 图文作品
+→ 跳过 crawled.json 中已成功入库的作品
+→ 打开作品，下载轮播原图并转成 JPG（避免滚动时截到半张图）
+→ 给 LLM 发送截图路径和素材提取提示词
+→ LLM 写 JSONL
+→ 校验并写入 material_library（source=other）
+→ 记录作品 ID
+→ 继续下一篇
+```
+
+失败的作品不会写入采集记录，下次运行会重试。
+
+## 登录与验证
+
+Chrome 使用工作区内的独立 profile：
+
+```text
+<工作区>/.fancy/douyin/chrome-profile/
+```
+
+cookies 会额外镜像到：
+
+```text
+<工作区>/.fancy/douyin/login-state.json
+```
+
+遇到登录框、滑块、图形验证或短信验证时，插件会弹窗：
+
+```text
+已登陆 / 取消
+```
+
+请在打开的 Chrome 窗口里手动完成登录或验证，然后点「已登陆」。插件不会自动
+绕过验证，也不会保存账号密码。
+
+运行模式：
+
+- 第一次运行、或没有有效登录态时：有头 Chrome，方便手动登录；本次会继续用有头跑完。
+- login-state.json 里有抖音登录 cookie 时：后续运行自动使用无头 Chrome。
+- 无头运行中如果登录态失效：插件会自动关闭无头 Chrome，切换到有头 Chrome
+  让你登录，登录完成后再继续。
+- 每次运行结束都会关闭 Chrome；登录态留在 profile 和 login-state.json 中。
+
+## 数据目录
+
+```text
+<工作区>/.fancy/douyin/
+├── accounts.json        # 账号主页记录
+├── crawled.json         # 已成功入库的作品 ID
+├── login-state.json     # cookies 镜像（0600）
+├── chrome-profile/      # Chrome 登录态
+├── chrome.json          # CDP 端口、profile 与 headed/headless 模式
+└── output/<时间>/       # 截图、note.json、materials.jsonl
+```
+
+浏览器脚本部署在：
+
+```text
+<工作区>/.fancy-tools/fancy-douyin/
+├── start-chrome.cjs
+├── scan-account.cjs
+├── crawl-note.cjs
+├── lib.cjs
+└── package.json
+```
+
+## 素材格式
+
+每篇作品的 LLM 输出写到：
+
+```text
+<作品目录>/materials.jsonl
+```
+
+字段：
+
+```text
+id / kind / name / tags / genres / note / source
+```
+
+`source` 固定为 `other`。`kind` 可以是任意非空字符串；如果内容能归入内置
+material kind，优先使用内置 kind。插件会强制把 source 改成 other，然后运行
+`.fancy-tools/fancy-material/validate.js` 校验，再写入数据库。
+
+## 注意
+
+- 只采集个人研究/已授权账号，不要批量抓取或二次分发受版权保护的图片和文案。
+- 截图不是页面视口截图，而是下载每页轮播原图后再转成 JPEG，所以不会因为
+  滚动、懒加载或页面动画截到残缺图片。
+- 抖音 DOM/类名会变，`scan-account.cjs` 和 `crawl-note.cjs` 的选择器可能需要维护。
+- 每次运行结束会自动关闭 Chrome；登录态保存在 profile 和 login-state.json 中，下次运行自动复用。