reader-workspace

Typocket

Typocket 是 DSH 中的个人文档工具，方便你阅读 Agent 的工作成果，继续编辑 Markdown，并将有用的资料整理为本机抽屉。PDF 和 HTML 页面也可一起预览。插件安装包包含完整网页和本机服务。启用插件后自动启动，无需另装 Typocket、Node.js 或运行终端命令。

安装

1. 从 Preview 发布页下载 dsh-reader-workspace-0.2.0-preview.5.tgz，在 DSH NEXT 的「插件 → 添加插件」选择这个文件。
2. 在右侧栏「开始」页点击「Typocket」。首次使用会自动创建本机数据目录。
3. 在 DSH 文件区打开 Markdown，可用 Typocket 预览；在 Typocket 顶栏点外部打开图标，可在浏览器打开当前页面。

社区市场审核通过后，才可在市场中搜索安装。审核状态以市场页面为准。

本机数据

macOS 默认抽屉目录是 ~/Library/Application Support/Reader/知识库。它不在插件安装目录中，更新或卸载插件不会删除文档。本机服务只监听回环地址，并会保存首次分配的端口供重启复用。

如果本机 127.0.0.1:8090 已有旧 Typocket，插件会先接入它，以保留此前的抽屉体验；旧服务离线时会提示离线，避免切换到另一份空库。迁移旧目录前请先备份。需要沿用原目录的高级用户可在启动 DSH 前设置 DSH_READER_DATA_DIR，插件不会自行移动旧数据。在插件详情中可手动连接另一台 Typocket；远程地址需使用 HTTPS。

工作区 Markdown 与 Agent

工作区 Markdown 预览只读。相对链接继续打开工作区文件，相对图片从当前工作区读取；预览不会移动原文件。想保留时在预览页直接「收进抽屉」，生成抽屉中的独立副本；不收录就不保留浏览记录。访客分享采用只读快照，手动更新才替换快照；这不是多人协作编辑。

阅读器与 Markdown 预览安装后即可用。Agent 查找和写入抽屉是可选高级功能：在 Typocket 的「管理抽屉 → Agent 访问」生成限范围令牌，再给 DSH 启动环境设置 READER_URL、READER_TOKEN 并重启。未配置令牌时，不注册会失败的 Agent 工具。令牌不要写进仓库。

本目录还保留 MCP stdio 适配器：node scripts/reader.mjs --stdio。它同样需要用户单独授权令牌。

支持范围与已知问题

• 0.2.0-preview.5 是 DSH 桌面端的 Preview 版本，安装包已在 macOS、Windows 和 Linux 的自动检查中完成构建与运行测试。macOS 另使用 DSH NEXT 2.0.16-next（内含 DSH 0.2.0-rc.1）的官方安装链验收了自动启动和阅读器入口；Windows 和 Linux 的原生 DSH 桌面安装与交互仍待验收。iOS 不作为 DSH 插件平台。
• Agent 工具仍需单独授权；客户端连接地址不会自动配置 Agent 令牌。
• 临时访客链接依赖 cloudflared 与网络；真实外部设备的端到端连通性尚未完成验收。
• 工作区文件与抽屉副本独立，不提供双向同步或多人协作。
• 同库双消费者与重启已通过实际服务测试；两个原生 DSH 桌面窗口的人工验收仍未完成。

源代码采用 MIT License。随包鸿蒙黑体由 Huawei Device Co., Ltd. 授权，使用与再分发须遵守独立字体许可。许可原文在安装包的 runtime/dist/fonts/HarmonyOS-Sans-LICENSE.txt，也可在源码仓库查看。其他第三方资产见许可清单。