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,=2.6,=0.28, 在线搜索 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](https://github.com/xuboboo/dsh-xiaohongshu-viral-note/blob/a10ed9ceb6a25653f7ce58c5fecd08a636e06baa/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