[!NOTE] v1.0.0 已正式发布。 同一份包含三平台原生采集器的安装包已通过完整产品流程和 Windows、macOS、Linux 干净安装验收。npm 软件包 · GitHub Release。Host 兼容性和隐私边界仍以文档为准。

最新正式版：v1.1.0。 npm v1.1.0 · GitHub v1.1.0 · 发布说明。新增工作记忆、历史证据检索、来源核对后的 Continue、Skill/Automation 建议及隐私修复。已通过三平台打包安装与 CI；原生 Electron 读屏及任意第三方插件组合仍未全面验收。仅支持已测试的 DSH Host，升级已有历史库之前必须进行一致性备份。

[!WARNING] 📌 公告：Computer History v1.1.0 正式版

Computer History 首个公开版本使用同一份三平台插件包支持 Windows / macOS / Linux，提供基于证据的时间线、原生 DSH Continue、本地隐私控制及可选浏览器/编辑器 Companion。正式发布包已通过三平台打包验收和 macOS 完整产品流程。正式发布不等于已验证所有 DSH Host 版本；Linux 真实桌面采集仍需 X/AT-SPI 环境和权限。详情见 v1.0.0 发布说明、发布证据和成功的 Release 工作流。

为什么做这个

聊天 Session 知道聊天里发生过什么，但你的真实工作经常发生在别处：编辑器、Terminal、Finder、浏览器伴侣，或其他桌面应用。

Computer History 补的是这层“工作连续性”。它希望回答：

• 我刚才主要在做什么？
• 这些工作属于哪个项目或资源？
• 我下一步应该从哪里继续？

它和“生产力监控”刻意不是同一种产品。目标是只保存足够恢复工作上下文的本机元数据，同时拒绝把屏幕、键盘和文档正文变成历史记录。

一眼看懂

| | Computer History | | --- | --- | | 存储 | 本地 SQLite；不需要远程历史服务 | | 模型 | 确定性 Observation → Work Episode → 选择性 Resume 上下文 | | 采集 | 默认关闭、include-only，遇到受保护或不确定界面时 fail-closed | | 内容边界 | 仅元数据——不记录截图、按键、终端正文、源码正文或网页正文 | | DSH 集成 | 认证 Host API、Agent 作用域工具、History / Privacy 面板 | | Companion | 浏览器与编辑器可通过伴侣补充 OS 无法安全提供的元数据 |

它怎么工作

这条链路最重要的性质，是屏幕像素和文档正文不在里面。

隐私边界

| 策略允许时可能记录 | 设计上明确不记录 | | --- | --- | | 应用身份 | 截图或屏幕录像 | | 资源 / 工作区元数据 | 原始键盘输入或鼠标坐标 | | 时间戳与持续时间证据 | 剪贴板内容 | | 元素 role / identifier 元数据 | Terminal 输出或 shell history | | 隐私 / 保护状态 | 源文件正文 | | Companion 提供的安全资源元数据 | 浏览器网页正文 | | | Accessibility 文本值或选中文本 |

采集默认关闭，应用访问为 include-only，受保护界面 fail-closed，Host 在写入存储前还会再次检查元数据。精确的安全边界、删除模型与残余风险见 SECURITY.zh.md 与 docs/threat-model.md。

平台状态

| 平台 | Collector 路径 | 当前状态 | | --- | --- | --- | | macOS | Accessibility | 已验证打包安装 + 默认 collector 握手；原生构建、隐私与 E2E gate 持续通过 | | Windows | UI Automation | 已验证打包安装 + 默认 collector 握手；真实 Notepad → UIA → Host 验收也持续通过 | | Linux | AT-SPI | 已验证打包安装 + collector 握手；真实桌面使用仍需要 X/AT-SPI 总线与相应权限 |

共享 collector contract 会在 GitHub Actions 上持续跨 macOS、Windows、Linux 检查。实机证据和已知限制记录在 docs/validation-three-platforms.md。

[!IMPORTANT] 已发布的 v1.0.0 使用同一个三平台插件包，不是 macOS-only。Release 流水线会在三个原生 runner 上分别构建 collector，记录来源 commit 与 SHA-256，把三份原生二进制合进同一个 tarball， 再让 macOS、Windows、Linux 分别 clean install 这一模一样的 tarball；验证时不设置 collectorExecutable，因此证明的是安装包自己的平台选择。同一安装包的客户端还通过了三端真实浏览器 首次使用、Settings 和 History/Privacy HTTP 200 验收（见发布证据）；macOS 另有 56/56 完整生命周期验证。npm OIDC Trusted Publishing 与 npm/GitHub 安装包字节一致性均已在正式发布工作流核验。

快速开始

现已可安装： npm [email protected] 与对应的 GitHub Release。请安装到已经配置好的、经过验证的 DSH profile 中。

1. 安装到已有的 DSH profile

以经过验证的 DSH 0.2.0-rc.2 Host 和已能使用 Web UI 的 web profile 为例：

npx @deepseek-ai/[email protected] plugin --profile web add [email protected]

请指定 Host 实际加载的 profile：web 仅是例子，不是全局安装。只含 DSH 基础组件的新 profile 可能无法启动 Web UI。不要与旧式手动插入 cordis.patch.yml 插件的方式混用。首次安装后重新加载或重启对应 Host。

2. 主动授权记录范围

在 DSH 中打开 Computer History，选择开始记录，然后到 设置 → Computer History 选择明确允许记录的应用，并完成系统要求的辅助功能授权。采集默认关闭，应用采用明确允许名单；不在名单内的应用不会进入时间线。macOS 使用 Accessibility 权限，Windows 使用 UI Automation，Linux 真正采集需要桌面 X/AT-SPI 会话及权限。

3. 查看时间线并继续工作

使用被允许的应用一段时间，再回到 Computer History → 时间线。选择 Work Episode 查看证据，点击 Continue（继续） 将有限、可核实的上下文带到新的 DSH Session。Continue 不会替你打开应用或文件。

浏览器与 VS Code Companion 都是可选组件，需要分别设置与授权。详见浏览器设置、编辑器设置和隐私说明。

更新或卸载

使用安装时同一个 profile，并明确指定已发布版本：

# 安装指定版本；以后升级可替换版本号
npx @deepseek-ai/[email protected] plugin --profile web add [email protected]
# 从该 profile 卸载
npx @deepseek-ai/[email protected] plugin --profile web remove dsh-computer-history

已验证的 DSH Host 基线为 0.2.0-rc.2；0.2.1-alpha.2 另外通过了 macOS 安装版完整产品验收。这不代表所有 DSH 版本或其他平台都已验证兼容。参见发布证据和 v1.1.0 发布说明。

源码开发

进行开发或贡献时，可使用源码 checkout：

git clone https://github.com/ysr666/dsh-computer-history.git
cd dsh-computer-history
corepack enable
pnpm install --frozen-lockfile
pnpm build
pnpm verify

环境要求： Node.js ^22.19.0 或 >=24.0.0，源码开发使用 pnpm 11.7.0，原生采集器构建还需要 Swift（macOS）或 Rust（Windows/Linux）。详见开发指南。

验证

pnpm verify                 # 类型、lint、测试、架构/隐私边界
pnpm verify:p1              # 完整 macOS Phase 1 gate
pnpm e2e:macos              # macOS 临时 DSH Host 流程
pnpm e2e:linux              # 具备所需 desktop bus 时的 Linux 流程
pnpm benchmark:ingestion    # ingestion benchmark

Pull Request 会运行 Node 22 + 24 核心验证、相关的三平台 collector 检查，以及在改动路径需要时运行 native / performance gate。

文档

| 从这里开始 | 更深入 | | --- | --- | | 架构 | Collector protocol | | 安全与隐私 | 三平台验证 | | 开发 | Threat model | | Roadmap | Coverage 决策 |

参与贡献

项目正在准备首个公开正式版，欢迎 Issue 和 Pull Request。开始前请阅读 CONTRIBUTING.md。

[!CAUTION] 本项目处理敏感的本地上下文。不要在公开 Issue 中上传真实历史数据库、配对/Session Token、凭据、私密路径或未脱敏采集日志。 涉及安全问题时，请按 SECURITY.zh.md 中的私密漏洞上报方式处理。

致谢

Computer History for DeepSeek Harness 的产品理念受到 OpenAI Computer History 的启发，尤其是让 AI 助手理解近期工作上下文、帮助用户从上次中断的地方继续工作的构想。感谢 OpenAI 对这一产品方向的探索与开创。

同时，感谢 DeepSeek Harness 的开发与维护者，为本项目提供了开放、可扩展的技术基础。

Computer History 是面向 DeepSeek Harness 独立开发的社区项目，不隶属于 OpenAI 或 DeepSeek，也不代表任何一方的官方立场。

License

MIT

Star 趋势