dsh-zsxq：DeepSeek Harness 知识星球集成插件

前言¶

DeepSeek Harness 通过插件扩展其能力。本插件为 DeepSeek Harness 提供了接入知识星球（zsxq）的功能。

由于知识星球没有官方开放平台 API，该插件基于其非官方 Web API（api.zsxq.com/v2）实现。它通过 Cookie 认证，将星球的内容获取、搜索及发布能力暴露为 Agent 工具，并提供扫码登录与 Web 设置面板。

安装¶

使用官方命令安装插件：

dsh plugin --profile web add dsh-zsxq

安装后重启 DeepSeek Harness GUI 使其生效。

核心功能¶

插件提供以下工具与面板：

• zsxq_status: 查询登录状态（Cookie 配置/有效期、登录流程进度）。
• zsxq_config: 配置或清除 Cookie。
• zsxq_login: 扫码登录。通过弹出系统 Chrome 窗口进行微信扫码，自动保存 Cookie。
• zsxq_groups: 获取用户加入的星球列表。
• zsxq_topics: 获取星球的主题列表。
• zsxq_topic: 获取主题详情及评论。
• zsxq_search: 在星球内进行站内搜索。
• 写操作（需谨慎）:
  • zsxq_publish: 发布主题。
  • zsxq_comment: 发表评论。
  • zsxq_like: 点赞。
• Web 设置面板: 提供扫码登录、粘贴 Cookie、测试连接、清除登录的图形化操作入口。

典型用法¶

基础的数据获取与发布流程如下：

1. 登录：执行 zsxq_login。系统会弹出 Chrome 窗口，使用微信扫码登录。登录成功后，Cookie 会自动保存。
2. 读取内容：
   • 使用 zsxq_groups 获取星球 ID。
   • 使用 zsxq_topics 携带星球 ID 获取主题列表。
   • 使用 zsxq_topic 携带主题 ID 查看详情及评论。
   • 使用 zsxq_search 携带星球 ID 和关键词进行搜索。
3. 写入内容：
   • 使用 zsxq_publish 发布新主题。
   • 使用 zsxq_comment 回复主题。
   • 使用 zsxq_like 点赞。

技术说明与注意事项¶

• 依赖要求：DeepSeek Harness 版本需 >= 0.1.5-rc.1。
• API 特性：使用非官方 Web API（api.zsxq.com/v2），请求头需包含 Accept: application/json、浏览器 UA、Referer/Origin 以及 Cookie。Web 版接口无需签名。
• 安全性：写操作（发布、评论、点赞）基于逆向接口实现，可能触发知识星球的风控机制，请谨慎使用。
• 凭据存储：登录凭据保存在 ~/.dsh/dsh-zsxq.（权限 0600）。
• 有效期：Cookie 有效期约为 1–3 个月，过期后需重新登录。

生态信息¶

• 项目地址: https://github.com/zhengjy01/dsh-zsxq
• 许可证: MIT