dsh-xiaohongshu-viral-note

DeepSeek Harness (DSH) 插件：把 小红书爆款笔记生成 agent Skill （xiaohongshu-viral-note-agent-skill， v5.14.5，MIT）以官方 bundle 插件 形态分发到 DSH 生态。

安装后，DSH 的 skill 工具即可发现并加载 xiaohongshu-viral-note-agent-skill： 小红书热门笔记研究、选题、种草文案生成/改写、合规校验、授权账号权重分析、 扫码登录与受控发布、发后复盘——全部遵循原 skill 的黄金路径与合规边界。

这是什么 / What is this

一个 DSH bundle（npm 包 + dsh.bundle 声明 + cordis.patch.yml），安装后：

• 在 ctx.skills 上注册一个 bundled skill provider（与官方 @deepseek-ai/dsh-skill-badge 同款模式，rank = BUNDLED_SKILL_RANK）；
• 完整 skill 包（SKILL.md、references/、scripts/、src/xhs_skill/、 assets/、contracts/、schemas/、evals/、tests/ 等）随插件分发， resourceBase 指向打包目录，模型可按需读取 references 并执行脚本。

插件本身不依赖 Python；skill 的脚本/CLI 需要 Python 3.12+ 环境（见下）。

安装 / Install

# 从 GitHub 安装（推荐）
dsh plugin --profile web add "github:xuboboo/dsh-xiaohongshu-viral-note"

# 或本地目录安装（开发调试）
dsh plugin --profile web add C:/path/to/dsh-xiaohongshu-viral-note

重启 DSH 后生效（设置 → 插件面板可查看/卸载）。验证：

dsh --profile web --dump-config | findstr xiaohongshu

使用 / Usage

对话中提及小红书/爆款笔记/种草文案等场景时，模型会自动调用该 skill； 也可以直接要求：

• 「用小红书 skill 找 3 个热门选题（dry-run）」
• 「基于这些热门笔记一键生成一篇图文种草笔记」
• 「改写这篇笔记，去掉 AI 味」「分析账号权重」「扫码登录」「定时发布」

Skill 的黄金路径：研究/选题 → 生成交付包 → 人工审阅 →（可选）授权草稿与发布。 所有返回按 status → ux.summary → ux.next_step → 业务体 读取。

Python 环境（运行脚本/CLI 必需）

Skill 的脚本通过 scripts/_bootstrap.py 免安装即可导入 src 包，但需要 第三方依赖（pydantic、httpx、PyYAML、cryptography 等）。

# 找到插件目录（profile 安装后位于 profile 的 node_modules 下）
cd "$DSH_HOME/profiles/web/node_modules/dsh-xiaohongshu-viral-note/assets/skill"

# 方式 A：最小依赖（脚本可直接运行）
python -m pip install "pydantic>=2.10,<3" "pydantic-settings>=2.6,<3" "httpx[http2]>=0.28,<1" PyYAML cryptography python-dateutil

# 方式 B：完整安装（提供 xhs-skill CLI）
python -m pip install -e .

环境自检：

# 方式 A 安装后：python -m xhs_skill.core.doctor   （或直接跑业务脚本自检）
# 方式 B 安装后：xhs-skill doctor

在线搜索 Provider（Brave/Bing/Google CSE/SearxNG 等）按需配置 assets/providers.yaml 或环境变量；未配置时 skill 会返回 needs_web_search，由宿主 web_search 代搜。

可选：MCP 工具接入

默认形态下，模型通过 shell 直接运行 skill 脚本，无需 MCP。 若希望工具以 mcp__xhs_skill__* 形式注册进 ctx.tools，见 patches/mcp-client.example.yml（需先 dsh plugin --profile web add @deepseek-ai/dsh-mcp-client）。

能力边界 / Boundaries

本插件完整继承原 skill 的硬规则：不编造数据、声明进 Claim Ledger、 PUBLIC_INDEX_TREND ≠ 站内热榜、ESTIMATED_ACCOUNT_WEIGHT ≠ 官方分数、 登录必须扫码确认、发布默认需人工确认、禁止绕过验证码/未授权访问/刷量/洗稿。

开发 / Develop

dsh-xiaohongshu-viral-note/
├── package.json            # dsh.bundle → cordis.patch.yml
├── cordis.patch.yml        # 插入插件行
├── lib/index.js            # skill provider（纯 ESM，无构建步骤）
├── assets/skill/           # 完整 skill 包（来自上游仓库）
├── patches/                # 可选 MCP 接入示例
└── README.md

本地验证：

dsh plugin --profile xhs-test add .            # 装进临时 profile
dsh --profile xhs-test --dump-config          # 确认层已生效

上游 / Upstream

• Skill 源码：xuboboo/xiaohongshu-viral-note-agent-skill
• DSH 插件开发文档：develop/basic
• License: MIT