@cloud411716/fancy-webnovel 1.0.46 → 3.0.0

package/client.js

@@ -0,0 +1,369 @@
+/**
+ * fancy-webnovel 浏览器半边。
+ *
+ * 目标：新会话里执行 /fancy-* 时，
+ *   1) **看得见**初始化成功/失败的结果；
+ *   2) **LLM 完全不被触发**（不发 provider 请求、零额度、零噪音）；
+ *   3) **会话日志保持干净**（插件一条都不写），agent 之后照常能跑。
+ *
+ * ── 为什么必须放在浏览器半边 ──────────────────────────────────────────────
+ * DSH 的聊天区有一个硬门槛（dsh-client-ui-chat/lib/client.js:5385）：
+ *
+ *     isActive: (snapshot) => snapshot.order.some((key) => snapshot.nodes.get(key)?.kind !== "command")
+ *
+ * 只有 kind !== "command" 的节点才会点亮聊天区。而命令结果在 DSH 里**就是**
+ * 一个 kind === "command" 的 flow 节点（dsh-client-ui-chat/lib/client.js:5514），
+ * 所以「插件不碰会话」= 聊天区永远不亮 = 用户什么都看不到。这就是「彻底本地」
+ * 方案让人眼前一空的真正原因，不是渲染坏了，是**门就没开**。
+ *
+ * 而宿主侧点亮只有一条路：在会话里写一条 user/message 占住 surface 节点 0。
+ * DSH 规定 surface 第一个节点必须是 agent 的 system/message（protected first
+ * surface head），插件一占，agent 之后一跑整个会话就读不回来 —— 磁盘上已经
+ * 有 160 个这样的坏会话。所以宿主侧的路是死的。
+ *
+ * ── 浏览器半边怎么开这扇门 ────────────────────────────────────────────────
+ * 1) package.json 声明 dsh.client + exports["./client"]
+ *    → dsh-client-modules/lib/index.js:479 扫 host Loader entries 找 dsh.client
+ *    → dsh-client-modules/lib/index.js:630-636 要求 platform === "web" 且有
+ *      exports["./client"]；扫到的包进 window.__DSH_BOOT__，浏览器加载它的 client bundle。
+ *    这是 DSH 自带的「双面包」机制（官方示范：dsh-client-ui-goal 的 host 半边
+ *    就是空的 `function apply() {}`），**不需要改 harness 一行代码**。
+ *
+ * 2) 注册一个自己的 conversation-node Definition（kind = "fancy-notice"），
+ *    匹配 command/run + command/done，只对 fancy-* 命令产出节点。
+ *    它的 kind 不是 "command" → 聊天区被点亮 → 结果可见。
+ *    完成结果在 command/done 的位置渲染成展开的绿/红边框卡片：
+ *    原生命令卡默认收成一行、需要点击展开，这里直接把多行内容铺开，
+ *    让阶段完成/失败和 help/query 等结果都一眼可见。
+ *
+ * 3) 空白会话里聊天区不挂载 → chat target 永远不会自动激活 →
+ *    conversationPhase（dsh-client-ui-conversation/lib/client.js:14011）
+ *    恒为 "blank" → 死循环。所以这里主动订阅当前会话的 chat target，
+ *    强制 assembler 激活它（dsh-client-ui-conversation/lib/client.js:794）。
+ *
+ * ── 铁律 ──────────────────────────────────────────────────────────────────
+ * 浏览器半边**只读**会话事件，一个字都不往会话里写。
+ * 会话的写入权仍然只有宿主插件，插件也仍然只写命令自己的结果（command/done）。
+ */
+window.__ModuleLoader__.load({
+	id: "@cloud411716/fancy-webnovel",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+
+		var react = require("react");
+
+		/** 我们自己的 conversation-node kind（非 "command"，专用于点亮聊天区）。 */
+		var NOTICE_KIND = "fancy-notice";
+		/** 只对这些命令产出节点，别人的命令一概不碰。 */
+		var FANCY_COMMANDS = [
+			"fancy-bootstrap",
+			"fancy-analyze",
+			"fancy-import",
+			"fancy-scan",
+			"fancy-build",
+			"fancy-export",
+			"fancy-topic",
+			"fancy-db",
+			"fancy-project",
+			"fancy-material",
+			"fancy-douyin"
+		];
+
+		/** 复刻 dsh-client-ui-chat 的 contextLocation（那边是包内私有函数）。 */
+		function contextLocation(context) {
+			return context.start?.location ?? context.matches[0]?.location ?? { kind: "unresolved" };
+		}
+
+		/**
+		 * 把 command/run + command/done 折算成一条 fancy 通知。
+		 *
+		 * 所有 fancy-* 命令的完成结果都锚定到 command/done 的位置，
+		 * 用展开的多行卡片显示；DSH 原生命令卡仍保留在命令开始处。
+		 */
+		var noticeDefinition = {
+			kind: NOTICE_KIND,
+			target: "chat",
+			match: function (event) {
+				if (event.type === "command/run") return { id: String(event.data.commandId), role: "start" };
+				if (event.type === "command/done") return { id: String(event.data.commandId), role: "update" };
+				return null;
+			},
+			start: function (_context, match) {
+				return {
+					name: match.event.data.name ?? "",
+					args: match.event.data.args ?? null,
+					outcome: null,
+					doneSeq: null,
+					doneLocation: null
+				};
+			},
+			update: function (context, match) {
+				if (match.event.type !== "command/done") return context.state;
+				return {
+					name: context.state?.name ?? "",
+					args: context.state?.args ?? null,
+					outcome: {
+						kind: match.event.data.kind,
+						text: match.event.data.text ?? ""
+					},
+					doneSeq: match.event.seq,
+					doneLocation: match.location ?? null
+				};
+			},
+			buildViewNode: function (context) {
+				var state = context.state;
+				if (state === undefined) return null;
+				if (FANCY_COMMANDS.indexOf(state.name) === -1) return null;
+				return {
+					key: context.key,
+					kind: NOTICE_KIND,
+					id: context.id,
+					target: "chat",
+					// 完成通知锚在 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
+				};
+			}
+		};
+
+		/**
+		 * 所有 fancy-* 命令的结果都渲染成展开的带边框卡片。
+		 *
+		 * 和 DSH 原生命令卡的区别：原生命令卡默认收成一行，要点一下才展开；
+		 * 这里直接用 pre-wrap 保留换行，并把成功/失败用绿/红边框区分。
+		 * 仍然只读 command/run + command/done，不写会话、不唤醒 agent。
+		 */
+		function FancyNoticeNodeView(props) {
+			var data = props?.node?.data ?? {};
+			var outcome = data.outcome;
+			var known = FANCY_COMMANDS.indexOf(data.name) !== -1;
+			var baseProps = {
+				"data-fancy-notice": data.name ?? "",
+				"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
+				}
+			}, ".")));
+		}
+
+		/**
+		 * 客户端插件体。
+		 * @param ctx - client root context.
+		 */
+		function apply(ctx) {
+			ensureRunningStyle();
+			ctx.uiConversation.events.register(noticeDefinition);
+
+			// 注册我们这个 kind 的渲染器。不注册的话 DSH 会走 JsonBlock 兜底，
+			// 聊天区里会冒出一行「未知 surface 事件：fancy-notice」。
+			ctx.slots.inject("conversation.chat.node", function () {
+				return ctx.slots.register({
+					name: "conversation.chat.node",
+					key: NOTICE_KIND
+				}, 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。
+			 *
+			 * 空白会话里聊天区不挂载 → chat target 不会被激活 →
+			 * conversation.activeTargets 为空 → conversationPhase 恒为 "blank" →
+			 * ConversationSession 直接 return null → 聊天区永远不出现。
+			 * 这里订阅一次 chat target，逼 assembler 把它激活
+			 * （dsh-client-ui-conversation/lib/index.js:794 activateTarget）。
+			 */
+			var disposeCurrent = null;
+			ctx.effect(function () {
+				var sessions = ctx.sessions;
+				return sessions.list.subscribe(function () {
+					var current = sessions.list.getSnapshot().current;
+					if (typeof current !== "string" || current.length === 0) return;
+					if (disposeCurrent !== null) {
+						try {
+							disposeCurrent();
+						} catch {}
+						disposeCurrent = null;
+					}
+					try {
+						var binding = ctx.uiConversation.binding(current);
+						if (binding === undefined) return;
+						disposeCurrent = binding.target("chat").subscribe(function () {});
+					} catch (error) {
+						disposeCurrent = null;
+						ctx.logger.warn("fancy-webnovel: chat target activation failed: %s", String(error));
+					}
+				});
+			});
+		}
+
+		exports.apply = apply;
+		exports.inject = ["uiConversation", "sessions", "slots"];
+		return module.exports;
+	}
+});

package/cordis.patch.yml

@@ -1,17 +1,8 @@
-# @cloud411716/fancy-webnovel — DSH Cordis Plugin Patch
+# fancy-webnovel plugin entry.
 #
-# IMPORTANT: This plugin creates project directories at user-specified paths
-# (which may be OUTSIDE the DSH workspace). Therefore it REQUIRES
-# `danger-full-access` sandbox mode. Add this to your profile's patch, e.g.:
-#
-#   - insert:
-#       - id: sandbox-policy
-#         config:
-#           mode: danger-full-access
-#
-# All other services used (commands, userQuestions, timer, events, session)
-# are part of dsh-base and available in every DSH UI (tui, web, desktop).
-
+# 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"

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 中，下次运行自动复用。