前言¶
在 DeepSeek Harness（DSH）里一边写 Agent、一边盯社区动态，常见做法是开浏览器切 tab，或用脚本直连 V2EX。前者和开发环境割裂，后者容易把 Token 写进配置或日志，还未必能在侧边栏和 Agent Tools 里复用同一套能力。社区维护的 oday0311/dsh-v2ex-client（npm 包名 v2ex-dsh-client）把 V2EX 做成 DSH 插件：侧边栏登录后读最新、热门、分区和节点，Agent 侧走同一套只读工具；兴趣学习与推荐在明确授权后才读本地历史，不把 PAT 放进插件设置或模型上下文。
这是什么¶
v2ex-dsh-client 面向 DSH >=0.2.1-rc.5 <0.3.0，提供只读的 V2EX 浏览与发现。维护者为 oday0311，源码在 GitHub，当前发布版本为 0.1.0，许可证 MIT。插件通过 Host 路由与侧边栏 UI 拉取官方 HTTPS 上的公开内容与会员身份；对 V2EX 的请求一律 GET，不能发帖、回复、感谢、收藏等写操作。
环境与依赖¶
安装前确认：
- Node.js 22 或更新版本（
package.json中engines.node为>=22）。 - DSH 版本落在
>=0.2.1-rc.5 <0.3.0。 - 在 V2EX 账号设置中创建的 Personal Access Token（PAT），用于侧边栏登录。
正常运行不需要在环境变量或插件配置里写 Token；仅维护者的可选冒烟测试使用保留变量 V2EX_TEST_TOKEN，日常 Host 与发布门禁不使用它。
核心功能¶
只读浏览¶
支持 Latest、Hot、公开分区 tab（如 Tech、Creative、Play、Apple、Jobs、Deals、City、Q&A、Hot、All、R2、VXNA）以及 Nodes 目录下的节点话题与分页回复。内容经校验、限大小并带缓存；不可达时展示上次有效缓存。AI 摘要需用户显式触发，并说明覆盖的话题与回复页范围；未配置模型时仍可普通浏览。
登录与凭据¶
在 DSH 侧边栏打开 V2EX 项，粘贴 PAT。Host 校验通过后写入 DSH 凭据服务，不写入插件 settings、内容存储、浏览器 storage、模型 prompt、Tool 返回或日志。换 Token 前会校验新凭据；登出可选清除本地 profile 与推荐数据。
Agent Tools¶
与侧边栏能力边界一致：面向模型的工具均为只读。V2EX 正文视为不可信输入，仅将有界的规范化数据交给当前 DSH 模型，模型 tools 关闭，结构化输出再校验。
兴趣学习与隐私¶
历史学习默认关闭，仅在 Interest 中明确授权后开启。从有界用户文本中学习，排除 system、assistant、tool、附件及凭据形态内容；不存原始历史，只持久化可编辑的结构化 profile。可查看/编辑标签、偏好节点、排除项，暂停学习、手动重学、撤销授权或清空 profile。兴趣、设置、推荐、已读与反馈按校验后的 V2EX 账号隔离。
刷新、限流与提醒¶
后台刷新仅在 DSH Host 运行期间执行；默认约 30 分钟、最新 feed、偏好节点最多两页。交互读优先，接近 V2EX 报告限流时后台会退让。Settings 可调刷新间隔、关注节点、每源页数、AI 候选预算、通知阈值及带 IANA 时区的 quiet hours。提醒只投递给合适的顶层 DSH Agent，不是系统通知，DSH 退出后不保证送达。
安装与启用¶
从 npm 安装到指定 profile，按提示重启 DSH：
dsh plugin --profile <name> add v2ex-dsh-client
将 <name> 换成你的 DSH profile 名称。可检查包是否装上：
dsh plugin --profile <name> list v2ex-dsh-client --depth 0
包亦见于 npm。本地开发需先 pnpm install 与 pnpm build，再用绝对路径安装 checkout（Host 入口 v2ex-dsh-client，浏览器入口 v2ex-dsh-client/client）。
重启后在侧边栏打开 V2EX，用 PAT 登录即可开始浏览。
典型用法¶
- 日常刷帖：侧边栏选 Latest、Hot 或某分区 / 节点，点开话题与回复分页。
- 摘要：在支持 AI 的 DSH 环境中对当前话题或回复页执行显式摘要动作；以源帖为准核对输出。
- 个性化发现：在 Interest 授权学习后编辑标签与节点偏好；在 Settings 里设刷新与 quiet hours，由 Agent 接收未读提醒（需有可用顶层 Agent）。
- Agent 会话：通过插件提供的只读 Tool 查询话题与节点信息，勿期望任何写回 V2EX 的能力。
适用场景与注意¶
适合需要在 DSH 工作区内读 V2EX、并偶尔让模型帮忙归纳线索的开发者。插件以当前 DSH 进程权限运行，安装前宜浏览 仓库源码 与 MIT 许可证。社区目录 SkillHub 插件页 与 GitHub 无 DeepSeek / 幻方官方从属关系，属社区「一切皆插件」生态中的独立条目。
故障排查可参考 README：登录被拒则换新 PAT 并去掉首尾空白；限流则等重置时间；兴趣学习不可用需安装 DSH history-query 服务后再授权；错账号则登出并勾选清除个人数据后重登。
结尾¶
v2ex-dsh-client 把 V2EX 收窄为可审计的只读通道：PAT 走凭据服务，对站点的变更能力是硬性禁止的。若你已经在用 DSH 0.2.x 并希望减少切窗口成本，可按上述命令装入 profile 后从侧边栏登录试用。更多说明见 GitHub README 与中文 README_ZH.md。
