Introduction

DeepSeek Harness extends its capabilities through plugins. This plugin provides DeepSeek Harness with access to Knowledge Planet (zsxq).

Since Knowledge Planet does not have an official open platform API, this plugin is implemented based on its unofficial Web API (api.zsxq.com/v2). It uses Cookie authentication, exposes content retrieval, search, and publishing capabilities as Agent tools, and provides QR code login and a Web settings panel.

Installation

Use the official command to install the plugin:

dsh plugin --profile web add dsh-zsxq

Restart DeepSeek Harness GUI after installation to activate it.

Core Features

The plugin provides the following tools and panels:

  • zsxq_status: Query login status (Cookie configuration/expiration, login process progress).
  • zsxq_config: Configure or clear Cookie.
  • zsxq_login: QR code login. It opens a system Chrome window for WeChat QR code scanning and automatically saves the Cookie.
  • zsxq_groups: Get the list of groups the user has joined.
  • zsxq_topics: Get the list of topics in a group.
  • zsxq_topic: Get topic details and comments.
  • zsxq_search: Search within a group.
  • Write operations (use with caution):
    • zsxq_publish: Publish a topic.
    • zsxq_comment: Post a comment.
    • zsxq_like: Add a like.
  • Web settings panel: Provides a graphical interface for QR code login, pasting Cookie, testing connection, and clearing login.

Typical Usage

The basic data retrieval and publishing workflow is as follows:

  1. Login: Run zsxq_login. The system opens a Chrome window; scan the WeChat QR code to log in. After successful login, the Cookie is saved automatically.
  2. Read content:
    • Use zsxq_groups to get group IDs.
    • Use zsxq_topics with a group ID to get the topic list.
    • Use zsxq_topic with a topic ID to view details and comments.
    • Use zsxq_search with a group ID and keywords to search.
  3. Write content:
    • Use zsxq_publish to publish a new topic.
    • Use zsxq_comment to reply to a topic.
    • Use zsxq_like to add a like.

Technical Notes and Caveats

  • Dependency requirement: DeepSeek Harness version must be >= 0.1.5-rc.1.
  • API characteristics: Uses the unofficial Web API (api.zsxq.com/v2). Request headers must include Accept: application/json, a browser UA, Referer/Origin, and Cookie. Web endpoints do not require signing.
  • Security: Write operations (publish, comment, like) are based on reverse-engineered endpoints and may trigger Knowledge Planet risk control mechanisms; use with caution.
  • Credential storage: Login credentials are stored in ~/.dsh/dsh-zsxq. (permissions 0600).
  • Expiration: Cookie validity is approximately 1–3 months; re-login is required after expiration.

Ecosystem Info

  • Project URL: https://github.com/zhengjy01/dsh-zsxq
  • License: MIT