dsh-xiaohongshu-viral-note

Readme

# dsh-xiaohongshu-viral-note

> DeepSeek Harness (DSH) 插件：把 **小红书爆款笔记生成 agent Skill**
> （[xiaohongshu-viral-note-agent-skill](https://github.com/xuboboo/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

```sh
# 从 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 后生效（设置 → 插件面板可查看/卸载）。验证：

```sh
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 等）。

```sh
# 找到插件目录（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 .
```

环境自检：

```sh
# 方式 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](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
```

本地验证：

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

## 上游 / Upstream

- Skill 源码：[xuboboo/xiaohongshu-viral-note-agent-skill](https://github.com/xuboboo/xiaohongshu-viral-note-agent-skill)
- DSH 插件开发文档：[develop/basic](https://deepseek-harness.github.io/deepseek-harness/develop/basic/)
- License: MIT