@ypingcn/dsh-web-search-insights 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ypingcn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,50 @@
-# Temporary Holding Version
+# dsh-web-search-insights
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+DeepSeek Harness（DSH）插件：把 Agent 的 `web_search` 使用情况做成「可审计的日志 + 可回看的引用统计」。
+
+- **审计日志**：每次 `web_search` 的关键词与结果网址 + 标题写入 JSONL，失败调用可选记录错误码；
+- **会话统计**：`webSearchInsights` 投影产出本轮/本会话的引用来源、返回来源，以及被 `web_fetch` 抓取过的页面；
+- **界面**：每条回答末尾的引用入口、右侧栏「搜索记录」面板（本轮/本会话、按已引用/未引用/已抓取筛选、按域名分组），以及会话顶部的「快速搜索」视图。
+
+## 效果展示
+
+ - 每条回答末尾的引用入口：来源图标 + 本轮/会话引用数 + 查看按钮
+![每条回答末尾的引用入口：来源图标 + 本轮/会话引用数 + 查看按钮](docs/screenshots/citation-entry.png)
+
+ - 按已引用筛选后的来源列表
+![按已引用筛选后的来源列表](docs/screenshots/search-panel-filter.png)
+
+ - 快速搜索视图与结果列表
+![快速搜索视图与结果列表](docs/screenshots/quick-search.png)
+
+## 依赖要求
+
+- DSH `>=0.2.1-rc.2 <0.3.0`；
+- Node.js `^22.19.0 || >=24.0.0`；
+- 快速搜索依赖宿主提供同源 HTTP 路由（web profile 自带）。
+
+## 安装
+
+### 方式 A：从 npm 安装（推荐）
+
+```bash
+dsh plugin --profile web add @ypingcn/dsh-web-search-insights
+```
+
+### 方式 B：从 GitHub 安装
+
+```bash
+dsh plugin --profile web add github:ypingcn/dsh-web-search-insights
+```
+
+### 方式 C：本地 link 安装（开发调试）
+
+```bash
+dsh plugin --profile web add link:/path/to/dsh-web-search-insights
+```
+
+## 配置项
+
+插件管理页打开「搜索溯源」后，详情页里会直接出现配置表单。
+
+![插件管理页「搜索溯源」详情页里的配置表单](docs/screenshots/plugin-config.png)

package/cordis.patch.yml

@@ -0,0 +1,16 @@
+# Bundle patch layer for dsh-web-search-insights.
+#
+# This file only matters when the package is installed as a bundle
+# (`dsh plugin add` / plugin manager). It inserts the package's main entry as a
+# plain Cordis plugin row; the row id is `web-search-insights`.
+#
+# Per-profile overrides belong in the profile's own cordis.patch.yml and target
+# the same row id, e.g.
+#
+#   - id: web-search-insights
+#     name: "@ypingcn/dsh-web-search-insights"
+#     config:
+#       directory: ~/.dsh/logs
+- insert:
+    - id: web-search-insights
+      name: "@ypingcn/dsh-web-search-insights"