dsh-socai

Xiaohongshu research tools for DeepSeek Harness, powered by your local SocAI runtime.

dsh-socai adds three typed, read-first research tools and one guided Skill to DeepSeek Harness. It uses the existing socai CLI for browser work, so your login state, Chrome profile, and SocAI configuration stay in one place.

What you get

Tool	Use it for
socai_xhs_search	Preview Xiaohongshu results or run a focused deep search with filters.
socai_xhs_author	Research a creator or competitor profile and scan their notes.
socai_xhs_get_notes	Deep-read selected notes returned by search or author discovery.

The bundled socai-xhs-research Skill guides the agent through a practical preview → select → deep-read workflow. Model routing guidance teaches DSH when to prefer these tools for Xiaohongshu research.

How it works

DeepSeek Harness
  └─ dsh-socai tools + Skill
       └─ local socai CLI (JSON)
            └─ SocAI browser daemon
                 └─ your usable Chrome profile

The plugin launches socai directly with an argument array—never through a shell. Calls are serialized because DSH sessions can share the same SocAI browser daemon and Chrome profile. Results stay structured, model-visible output is bounded, and local run paths are replaced with an opaque run identifier.

Requirements

• Node.js 22 or newer.
• DeepSeek Harness 0.1.1-rc.2 or 0.1.2-alpha.2.
• SocAI CLI 0.4.12 or newer, available on the PATH inherited by DSH.
• A Chrome profile SocAI can use, normally already signed in to Xiaohongshu.

Install SocAI on macOS:

curl -fsSL https://github.com/socai-io/socai/releases/latest/download/install.sh | sh

For other platforms and configuration options, see the SocAI repository.

Install

Install the latest source from GitHub:

dsh plugin --profile web add git+https://github.com/socai-io/dsh-socai.git

Or pin the precompiled v0.1.1 release artifact:

dsh plugin --profile web add https://github.com/socai-io/dsh-socai/releases/download/v0.1.1/dsh-socai.tgz

Restart dsh web after adding or updating the bundle.

Try it

Ask DSH naturally; the model routing hint and Skill handle tool selection. For example:

Search Xiaohongshu for recent discussions about AI note-taking. Preview 20
results first, then deep-read the five most relevant notes.

Research this Xiaohongshu creator, summarize their positioning and recurring
topics, then compare engagement patterns across their latest 10 notes.

Open these selected notes from the previous search and extract the claims,
evidence, audience questions, and reusable content angles.

The tools are read-first. They do not publish, like, comment, follow, or bypass platform login and verification controls.

Configuration

Override the dsh-socai row in the profile's cordis.patch.yml when needed:

- id: dsh-socai
  name: '@socai-io/dsh-socai'
  config:
    binaryPath: /absolute/path/to/socai
    timeoutMs: 900000
    maxOutputBytes: 64000
    productUrl: https://socai.io/?utm_source=deepseek-harness&utm_medium=plugin&utm_campaign=dsh-socai

Field	Default	Purpose
binaryPath	socai	Use an absolute CLI path when DSH does not inherit your shell PATH.
timeoutMs	900000	Maximum duration for one SocAI browser operation.
maxOutputBytes	64000	Maximum model-visible result size.
productUrl	Tagged socai.io URL	Product/help link returned with useful attribution.

Compatibility and verification

CI builds, strictly typechecks, packages, and tests the plugin against both supported DSH revisions. The test suite covers:

• real DSH tool-registry execution;
• input validation and argv injection resistance;
• split UTF-8 output and model-visible result limits;
• cancellation, timeout, and process-tree cleanup;
• cross-session serialization;
• SocAI version gating and error-path redaction.

Git installation, release-tarball installation, profile composition, and a live dsh web boot are also verified as part of the release readiness record.

Development

Use a built DeepSeek Harness source checkout:

DSH_CHECKOUT=/path/to/deepseek-harness node scripts/test.mjs

The build and test launchers are cross-platform Node scripts. The executable fixture integration suite runs on macOS/Linux; a Windows process-tree regression test is present, while a full Windows DSH + SocAI profile smoke test remains on the rollout checklist.

See FEASIBILITY.md for the architecture decision, current compatibility evidence, risks, marketplace status, and go-live checklist.

Links

• SocAI
• Releases
• Marketplace follow-up
• socai.io