githezhihao/deepseek-harness-norma

Norma Harness

Norma Harness 是“小云”的专业强大模式：一个基于 DeepSeek Harness 的 macOS 桌面智能体工作台，把完整的编码 Agent、项目文件树、模型切换和本地会话放进独立 App 窗口。

Norma Harness 是基于 DeepSeek Harness 构建的 macOS 桌面发行版。它将现有 dsh web 运行时作为仅监听 loopback 的 sidecar 启动，并在隔离的 Electron 窗口中呈现 Harness Web 客户端。Desktop App 与 CLI、Web UI 和 TUI 共享 ~/.dsh 中的会话、设置、凭据、provider、模型、Skill、MCP Server 和 agent preset。

Norma 增加了什么

- 使用 Norma Harness 名称和图标的 macOS Electron App，负责窗口状态和本地 sidecar 生命周期。
- 侧栏项目文件树，支持目录按需加载和参考 VS Code 的彩色文件徽标。
- 原生文件选择、在 Finder 中显示、系统通知、外部链接和受限的 preload IPC bridge。
- 完整保留 DeepSeek Harness 的 Agent、会话、工具、模型、Skill、MCP、权限和插件架构。

Desktop App 目前是面向 macOS 的源码开发版，尚未包含公开签名、公证、自动更新或跨平台安装包。

运行

安装 Node.js ^22.19 或 >=24、Corepack，以及仓库锁定的 pnpm 版本：

git clone https://github.com/githezhihao/deepseek-harness-norma.git
cd deepseek-harness-norma
corepack pnpm install
corepack pnpm build
corepack pnpm --filter @deepseek-ai/dsh-desktop dev

需要独立 DevTools 窗口时，将 dev 换成 dev:tools。原有 Harness Web 入口仍可通过 corepack pnpm dsh web 启动。

凭据与隐私

本仓库不包含 API key 或用户配置。Norma 通过 DeepSeek Harness credentials service 和 ~/.dsh 读取已有凭据及模型 provider；不要提交 .env、凭据、会话日志或导出的 provider 设置。sidecar 只绑定 127.0.0.1，Renderer 不能直接访问 Node.js 文件系统。

Desktop 进程目前默认将 DSH_PERMISSION_MODE 设置为 danger-full-access，这允许工具修改本机用户可访问的任意路径。不需要完整本地权限时，请在启动前显式设置更安全的模式。

项目状态

Norma 跟随快速迭代的 DeepSeek Harness 开发者预览版本，可能出现破坏兼容性的变更。Norma 修改与上游源码放在同一工程中，以便在保留 Desktop App 和 UI 定制的同时合并上游更新。

独立的项目文件树源码也已发布在 githezhihao/norma-project-explorer。

开发

请阅读 SPEC.html、Desktop App README、上游开发指南和架构文档。Agent 遵循 AGENTS.md。

上游与许可证

DeepSeek Harness 由 DeepSeek AI 开发，并由 Cordis 驱动。Norma Harness 保留上游 MIT 许可证；第三方依赖及其许可证见 THIRD_PARTY_NOTICES.md。