dsh-social-trace 0.1.2 → 0.1.13

package/README.md

@@ -1,8 +1,8 @@
 # Social Trace
 
-**把你在微博、雪球关注的博主说过的话，完整留在本地。**
+**通过对话追踪博主动态、查询言论、总结观点、管理监控任务。**
 
-Social Trace 是 DeepSeek Harness 的本地社交动态监控插件。它按博主持续检查新动态，把正文、转发原文和配图归档到本机；有新内容时，可以通过 dsh-im 推送到 QQ / 微信。
+Social Trace 是运行在 DeepSeek Harness 上的**博主言论追踪与分析 Agent**，以插件形式安装。它持续追踪你关注的微博、雪球博主，将动态保存在本地，形成可查询、有来源的言论记录。你可以通过对话检索历史言论、总结观点、创建定时总结任务，也可以添加博主、调整频率、启停监控与历史缓存；配置变更先预览，确认后执行。新动态通知可通过 dsh-im 推送。
 
 [![npm](https://img.shields.io/npm/v/dsh-social-trace.svg)](https://www.npmjs.com/package/dsh-social-trace)
 [![license](https://img.shields.io/npm/l/dsh-social-trace.svg)](LICENSE)
@@ -17,6 +17,7 @@ Social Trace 是 DeepSeek Harness 的本地社交动态监控插件。它按博
 
 | 能力 | 说明 |
 | --- | --- |
+| 对话与任务 | 复用 DSH 默认模型，查询、总结、添加监控、调整频率和管理本地总结任务；变更确认后执行 |
 | 按博主监控 | 微博、雪球；每位博主独立开关、频率和时间段 |
 | 增量检查 | 定时读取新动态；关机/重启后补查期间仍可见的内容 |
 | 历史缓存 | 按日期范围回补旧动态，支持断点续传，不重复抓取 |
@@ -32,25 +33,15 @@ Social Trace 是 DeepSeek Harness 的本地社交动态监控插件。它按博
 1. **添加博主**：粘贴微博/雪球主页链接或数字 UID。
 2. **选择记录方式**：从现在开始，或按日期范围缓存历史消息。
 3. **交给它跑**：按设定频率检查；新内容入库后写 Markdown、下载配图；需要时通过 dsh-im 推送。
+4. **通过对话使用**：查询已保存的言论、总结观点，或提出监控与任务调整要求。
 
 ## 安装
 
 需要 DeepSeek Harness 桌面版、Google Chrome，以及 Node.js 22.19 或以上。
 
-从 npm 安装（也可以在 Harness 的插件管理里直接安装 `dsh-social-trace`）：
+在 DeepSeek Harness 的「设置 → 插件」中安装 `dsh-social-trace@latest`。
 
-```sh
-dsh plugin --profile desktop add dsh-social-trace
-```
-
-也可以从源码安装：
-
-```sh
-git clone https://github.com/chiinsight/dsh-social-trace.git
-cd dsh-social-trace
-npm ci
-dsh plugin --profile desktop add .
-```
+desktop profile 由 Harness 应用管理，CLI 的 `dsh plugin --profile desktop add ...` 会被拒绝；不要用这条命令安装 desktop 插件。开发调试时，请使用独立的非 desktop profile，或通过 Harness 插件管理器安装本地构建。
 
 安装后完全退出并重新打开 Harness，在侧栏打开 Social Trace。
 
@@ -74,6 +65,15 @@ dsh plugin --profile desktop add .
 
 配置入口：大屏的 dsh-im 节点，或「连接与设置」里的消息推送区域。
 
+## 与 Agent 对话
+
+点击侧栏「新建对话」，可以查询本地资料、总结观点、创建定时总结任务，或添加监控、调整频率、启停新动态监控与历史缓存。
+
+- 模型复用 DSH 的默认模型，插件不保存 API Key。
+- 写操作只生成预览，必须在界面确认后才会执行。
+- 聊天记录、总结和引用来源保存在本机资料库。
+- 使用远程模型时，问答涉及到的博文文字会作为上下文发送给该模型；不需要时请缩小提问范围，或改用本地模型。
+
 ## 数据放在哪
 
 默认在 `~/.local/share/dsh-social-trace/`，也可以在设置里改到自己的文件夹。
@@ -94,14 +94,14 @@ dsh plugin --profile desktop add .
 - 已删除、被权限挡住或超出平台可见范围的内容无法补回。
 - 平台要求登录/验证时会暂停采集，处理后继续；不会绕过验证码、轮换账号或使用代理池。
 - 雪球文章只保存标题和原文链接，不保存文章正文。
-- 当前推送的是原文通知；AI 总结和 IM 内问答尚未接入。
+- Chat 可生成带来源的本地总结、创建定时总结任务并控制监控；使用远程模型时，选定文字会交给该模型。当前总结任务按天生成本地报告，自动 IM 总结推送与 IM 内问答尚未接入。
 
 ## 开发
 
 ```sh
 npm ci
-npm test        # 254 项离线测试
-npm run test:ui # 5 项界面测试（需要 Chrome）
+npm test        # 后台与离线测试
+npm run test:ui # 界面测试（需要 Chrome）
 ```
 
 ## 许可