前言¶
在 DSH 里跑智能体时，一段长回答或草稿往往只留在当前会话上下文里：关掉标签页、换一台机器，或者想在团队里让人审阅，都要靠复制粘贴或另存文件。Reviso 产品侧提供「发布—审阅—再打开」的工作流；reviso-dsh 是 Reviso 家族在 DeepSeek Harness 上的宿主集成包，让智能体通过 Host 侧工具把标题与正文发到 Reviso，并在 DSH 侧栏与会话页按会话键读回，而不把 Reviso token 暴露给浏览器或子进程。
这是什么¶
reviso-dsh（npm 包名 dsh-reviso，仓库 reviso-si/reviso-dsh）由维护者 reviso-si 发布，在 SkillHub 社区目录中归类为记忆。一句话定位：在 DSH 中发布智能体输出供人工审阅，并从当前会话再次找到同一条记录。
Reviso 生态按「面」拆分：主仓库 reviso 是产品与后端，reviso-agent 是跨平台 skill，reviso-cli 是命令行；本仓库专门承担 DSH Host 集成（侧栏面板、会话 Tab、reviso_publish 工具）。
当前 README 标明状态为 Host-backed Reviso view：支持路径由 Host 端到端持有——reviso_publish 在服务端发布；侧栏与会话 Tab 经同源路径 /plugins/reviso/* 读取；未配置时界面显示「连接 Reviso」，通过同源 OAuth 桥把 REVISO_DSH_* 引用写入 DSH 凭据并解析个人工作区，浏览器不接触 Reviso token，也没有默认 mock 数据。
核心功能¶
Host 侧发布工具 reviso_publish¶
index.js 在 DSH Host 注册 reviso_publish。智能体传入标题与正文；工具解析三份 DSH 凭据引用，从 exec.agent.session.header.id 读取当前会话 id，向 Reviso 提交时带上 source_kind=dsh 与 source_session_id（跨仓库约定里会规范为 session_key，形如 dsh:<sessionId>）。token 不进入浏览器或 agent 子进程。
凭据与连接 Reviso¶
已安装的 DSH 凭据是 POSIX 引用到字符串的扁平映射，位于 $DSH_HOME/.credentials.yaml：
REVISO_DSH_TOKEN: rak_...
REVISO_DSH_WORKSPACE_ID: wsp_...
REVISO_DSH_SERVER: https://reviso.work
产品路径是在 DSH 面板或会话 Tab 点击 连接 Reviso。仅用于无头验证时，也可复用 CLI 先前 OAuth 登录产生的 ~/.config/reviso/credentials.json：
reviso auth login --server https://reviso.work
工具会从 /api/agent-connection/self 解析工作区并复用该连接。
客户端与读回¶
构建客户端产物后，Reviso 入口出现在 Web 侧栏（与 Settings 相邻）。侧栏面板与会话 Tab 在未配置时提示连接；配置完成后经 Host 路由读 Reviso 数据。读 API 侧可用 GET /api/documents?session_key=dsh:<sessionId> 按会话键列出文档（与 verify:real 脚本中的校验方式一致）。
路线与依赖¶
README 中的路线图：Phase 0 为可本地加载的 bundle 骨架（当前）；Phase 1 为带 source_kind / source_session_id 的发布与读取；Phase 2 为 Agent Inbox Tab 与「回到会话」打开器。与 Reviso 主仓的 HTTP API、source_kind 枚举（dsh|claude|codex|cursor|mcp）及 session_key 约定由 reviso 主仓 L0 契约持有；本包不直连 Supabase。
文档注明在 DSH 0.2.1-rc.2 下做过对接（client manifest 与 shell 静态模块契约对齐）。许可证为 MIT（与 reviso-agent / reviso-cli 相同）。
安装与启用¶
官方安装方式是对本地路径添加 bundle（路径需为实际克隆或解压后的绝对路径，勿凭仓库名拼接 github: 类简写）：
dsh plugin --profile <name> add /path/to/reviso-dsh
dsh --profile <name> --dump-config # 期望出现 "# == dsh-reviso" 层
本地开发可用 patch 插入插件行（路径必须为绝对路径）：
# dev.patch.yml
- insert:
- id: reviso-dsh
name: '/absolute/path/to/reviso-dsh/index.js'
pnpm dsh web --patch ./dev.patch.yml
在仓库内构建客户端并挂到 profile 的示例（README 中的路径为作者本机示例，使用时请换成你的绝对路径）：
pnpm install && pnpm run build:client
dsh plugin --profile web add /Users/touchskyer/Code/reviso-projects/reviso-dsh-embed-v1
dsh web
回滚：dsh plugin --profile web remove dsh-reviso。
典型用法¶
- 按上一节把 bundle 加入 profile，启动
dsh web（或你的目标 profile）。 - 在面板或会话 Tab 完成 连接 Reviso（或预先在
$DSH_HOME/.credentials.yaml写入三个REVISO_DSH_*引用）。 - 在会话中让智能体调用 Host 工具
reviso_publish，传入标题与正文；发布与会话 id 绑定。 - 在同一 DSH 会话的 Reviso 入口或经 API
session_key=dsh:<sessionId>找回刚发布的文档。
维护者在仓库内用契约测试与真实发布脚本验证行为：
npm test
npm run verify:real
# 可选: -- --credentials <path> --session-id <id> --title <title>
verify:real 需要上述三份凭据引用与网络访问，走与 Host 相同的 ToolRuntime 与凭据提供方，发布一篇文档并读回。
适用场景与注意¶
适合需要在 DSH 长会话里留档、给人审阅、按会话回溯 Reviso 文档的开发者；与「记忆」类插件的诉求一致——把当次智能体产出挂到可检索、可协作的产品面，而不是只留在聊天里。
安装前请注意：DSH 插件以当前 dsh 进程权限运行，会读取 Host 凭据并代表你向 Reviso 服务端发请求；添加前应自行查看 GitHub 源码 与 MIT 许可证。社区目录 SkillHub 插件页 与 DeepSeek / 幻方无官方从属关系，DSH 生态遵循「一切皆插件」的扩展方式，本介绍事实均来自仓库 README 与 package.json（当前包版本 0.1.0）。
结尾¶
reviso-dsh 把 Reviso 的发布与按会话读回接到 DSH Host：token 留在凭据层，智能体用 reviso_publish 落稿，人在 Web 里连接与审阅。进一步了解可打开 SkillHub 目录页 与 GitHub 仓库。
