kexuejin/dsh-zhihu-dashboard

English | 中文

面向 DeepSeek Harness 的知乎面板插件：热榜、关注动态、帖子追踪与应用创意提炼 —— 既能在 DSH 界面里用，也能作为原生工具直接在对话中调用。

基于知乎官方 zhihu-cli（知乎开放平台）。需要免费的知乎开放平台 Access Secret。

功能

面板（界面）

• 热榜 —— 今日热点，带趋势标记（新上榜 / ↑ 上升 / ↓ 下降），通过相邻两次快照对比得出
• 关注动态 —— 我的近期收藏、我的创作（可按最新或点赞最多排序）、我关注的人
• 帖子追踪 —— 可追踪问题（该问题下所有回答）、关键词（同类新内容）、或关注的人（TA 发布的新内容，按作者精确过滤）。新内容标 NEW 并直接在追踪项下方内联展示，免去自己翻找；可选自动简报，把新发现的帖子经知乎直答提炼成应用创意简报；可选系统通知 + 侧边栏未读徽标 —— 后台检查器运行在 DSH 顶层窗口，使用 DSH 期间（无需打开面板）即可收到新内容提醒
• 收藏夹 —— 收藏夹内容直接按收藏夹分组内联展示，支持本地搜索、收藏夹专属排序、新收藏内容 NEW 标记和研究包导出，无需再点进查看
• 未读 —— 聚合所有追踪项新发现的内容（追踪来源/作者/时间/摘要），侧边栏徽标点击即跳转，支持一键全部标记已读
• 智能简报 —— 根据关注对象/数据源自动匹配模板（人物观点、问题进展、话题趋势、开发机会、研究项目、收藏复盘），用当前 DSH provider/model 生成并保存最近简报，全局提醒可点击回到面板
• 机会报告 —— 从热榜/动态缓存、追踪新增、未读、工作台和研究项目聚合候选，按本地规则打机会分；可直接使用当前 DSH provider/model 生成开发机会报告，也可复制 Agent 报告提示兜底
• 数据源设置 —— Access Secret 仍是开放平台主路径；设置页支持知乎扫码登录，host 端持久保存只读会话并可一键清除；若知乎触发网络环境验证，面板会显示共享二维码临时 Cookie 的本地验证页，验证后可继续检查或继承验证 Cookie 重新生成二维码；浏览器 Cookie/profile 读取已从用户入口移除
• 内容工作台 —— 任意内容卡片可加入“稍后读 / 待分析 / 已处理”，在独立工作台 tab 分组复盘；支持创建研究项目、加入项目、复制项目级 Agent 分析提示
• 阅读模式 —— 任意内容卡片可在面板内打开清爽阅读页，展示来源信息、原文入口，并支持一键复制本文 Markdown
• 追踪搜索控制 —— 可配置每个追踪项的检查条数、内容类型和时间窗，最近追踪过的关键词会回填为输入建议
• 本地排序 / 评分 —— 可选择平台默认、新增优先、点赞优先、时间优先，或按偏好关键词加权的本地评分排序
• 导出 / 研究包 —— 当前热榜、动态、收藏夹、未读流、追踪新增可一键复制为 Markdown 或 CSV，方便直接粘给 Agent 分析
• 本地内容过滤 —— 关键词、作者、正则屏蔽规则只存在浏览器本地，作用于热榜、关注动态、收藏夹、未读流和帖子追踪检查；卡片提供快捷屏蔽按钮，设置里保留最近过滤历史并支持一键撤销
• Access Secret 与条数等配置在面板自己的「设置」里（仅存浏览器 localStorage）

对话工具（Agent tools）

工具	作用
zhihu_search	搜索知乎内容（标题/作者/摘要/链接）
zhihu_hot	当前热榜
zhihu_answer	知乎直答（检索增强回答 / 应用创意提炼）
zhihu_global_search	全网搜索，支持时间窗（sinceHours）与实时索引
zhihu_followees	列出当前账号关注的人
zhihu_my_contents	我的创作（可按点赞排序分析最佳内容）
zhihu_favorites	收藏夹列表 / 单个收藏夹内容

安装

dsh plugin --profile web add dsh-zhihu-dashboard

或把它加入 profile 的 cordis.patch.yml bundle 层。重启 dsh web。

前置条件

1. 安装 zhihu-cli skill（dsh skill install zhihu），使 CLI 二进制在 PATH 或标准安装位置 —— 插件会自动探测（cliPath 配置 → ZHIHU_CLI_HOME → PATH → 平台默认）
2. 在 developer.zhihu.com/profile 申请 Access Secret
3. 把 Secret 提供给 CLI：printf '%s' 'zh-…' | zhihu-cli auth set --secret-stdin；或为对话工具设置 ZHIHU_ACCESS_SECRET 环境变量；或在面板里填写（仅浏览器本地）

💡 首次打开面板：未配置 Secret 时会显示三步引导卡片（打开开放平台 → 申请 Access Secret → 粘贴并验证），验证通过后自动加载数据。

工作原理

• 宿主半端（lib/）：在 /zhihu-dashboard 提供路由（与 DSH /api 网关同等的 Host/Origin 信任栅栏），驱动 zhihu-cli，并通过 ctx.tools.register 注册 7 个对话工具
• 客户端半端（src/client/，构建产物 client/client.js）：官方左侧边栏底部新增「知乎面板」按钮（sidebar.footer.action），点击打开右侧抽屉（shell.overlay）嵌入面板 —— 全局共享、不依赖任何第三方侧边栏；同时挂载后台追踪检查器（track-checker.ts，随 DSH 顶层窗口运行），按配置间隔检查追踪项，发现新内容时弹系统通知并更新侧边栏未读徽标

配置

选项	默认	说明
cliPath	自动探测	zhihu-cli 二进制路径
hotLimit	10	热榜条数 (1-30)
feedLimit	10	动态条数 (1-50)
refreshSeconds	0	热榜/动态自动刷新秒数（0=关）

面板专属配置（浏览器 localStorage）：Access Secret、追踪检查间隔、自动简报开关、系统通知开关，以及关键词、作者、正则本地屏蔽规则。

今日额度（热榜/直答）显示在面板顶部，避免悄悄用尽。

额度

知乎开放平台邀测额度（同账号所有 Secret 共享）：热榜 100 次/天、直答 100 次/天、搜索 5,000 次/天。自动简报与问题标题解析各消耗 1 次直答；追踪检查走搜索。

安全

• Access Secret 只存浏览器 localStorage，经同源请求头传给宿主，再以 ZHIHU_ACCESS_SECRET 注入 CLI（不进 argv、插件不写钥匙串）
• 路由沿用 DSH /api 网关的受信 Host/Origin 栅栏
• 无遥测，除知乎开放平台 API 外不做任何外部调用

开发

pnpm install
npx tsdown --config tsdown.config.ts   # 构建 client/client.js
npx tsc -p tsconfig.client.json        # 类型检查客户端源码

License

MIT