HuangYuChuh/dsh-work

DSH Work

使用 DeepSeek Harness 将项目源材料转化为可审阅的办公交付物。

DSH Work 是一个本地优先的办公智能体工作空间，面向分析师、研究人员、运营团队和顾问。它可将项目文件和研究资料转化为带引用的、可编辑的报告、电子表格和演示文稿，供人员在离开工作空间之前进行检查和批准。

基础阶段： 该仓库目前定义了产品和架构。它尚未提供可安装的桌面应用程序或生产就绪的办公工作流。

flowchart LR
A[Project sources] --> B[Specialist roles]
B --> C[Editable draft]
C --> D[Evidence and change review]
D --> E[Human approval]
E --> F[Exported deliverable]

为什么选择 DSH Work

办公自动化的难点不在于生成一个段落。而在于让从证据到交付物的路径足够可见，以便专业人士能够信任并批准。

DSH Work 使用 DeepSeek Harness 作为可组合的智能体运行时。其配置文件、预设、插件、工作流和子智能体成为业务概念，例如项目、角色、源材料、交付物和审批。

第一个工作流

第一个版本只有一个明确的任务：从源材料到交付物。

1. 从文件夹创建本地项目。
2. 添加 PDF、DOCX、XLSX、PPTX 和网页源材料。
3. 分配研究、分析、写作和审阅角色。
4. 生成可编辑的报告、电子表格或演示文稿草稿。
5. 在导出前审阅证据、引用和文件更改。

电子邮件、日历、即时通讯、Drive、Notion 和企业连接器稍后推出。文档工作流必须首先可靠。

产品必须证明什么

- 保持证据可见。 交付物中的声明应能追溯到源文件、页面、章节、URL、工具结果或明确标注的推断。
- 保持文件可编辑。 有用的结果是可检查和修订的 DOCX、XLSX、PPTX 或 PDF，而不是困在聊天中的 Markdown 回答。
- 保持重要操作可审阅。 导出、发布、发送、覆盖、移动和删除需要明确的审批策略。
- 保持角色有边界。 研究员、分析师、写作者和审阅者应该
拥有各自独立的工具和职责，而不是一个不透明的超级代理。

DSH 如何映射到办公工作

| DeepSeek Harness 原语 | DSH Work 概念 |
| --- | --- |
| 工作区 | 项目、客户文件夹或研究案例 |
| 代理预设 | 研究员、分析师、撰写者或审阅者 |
| 插件 | 文档解析器、引用服务、Office 生成器或连接器 |
| 会话 | 项目内的一个工作线程 |
| 工作流 | 可重复的多角色办公流程 |
| 审批 | 导出、发送、发布、覆盖、移动或删除的权限 |
| 子代理 | 为另一个角色工作的有界专家 |

当前状态

该仓库现在包含一个可复现的 DSH Web Profile，由固定的子模块提供支持。它证明了运行时和浏览器界面可以在本地启动；第一个 Office 工具包现已接入该 profile。引用溯源、审阅用户体验和审批感知导出仍是接下来的产品里程碑。

运行本地 DSH profile

要求：Node.js ^22.19.0（或 >=24.0.0）和 pnpm 11.7.0。

git clone https://github.com/HuangYuChuh/dsh-work.git
cd dsh-work
git submodule update --init --recursive
cd packages/deepseek-harness
pnpm install --ignore-scripts
pnpm run build
cd ../..
cd .dsh/profiles/work
pnpm install --ignore-scripts
cd ../../..
.\scripts\dsh-work.ps1 --dump-config
.\scripts\dsh-work.ps1 --port 3080

该脚本将 DSH_HOME 设置为仓库的 .dsh 目录，并选择已跟踪的 work profile。--dump-config 是一个有用的初步检查：它会在不启动服务器的情况下显示生效的 Cordis 行。Web UI 会打印其实际 URL；--port 0 会让 Windows 选择一个空闲端口。

首次安装使用 --ignore-scripts，因为上游检出中的可选 Git-hook postinstall 与 Git 子模块不兼容。它不会跳过构建或运行时依赖。第二次安装使用 autoInstallPeers: false 解析 Profile 的外部 Office 包，因此它会复用 DSH 检出中当前的 Cordis 和工具注册表，而不是尝试获取旧版 peer 包。

work profile 将 @huiliyi37/dsh-office@0.1.6 安装为外部 DSH 包。它目前暴露 xlsx_、pdf_、pptx_ 和 docx_ 工具；profile 补丁将这四个系列全部显式保留，以便后续产品版本可以在不更改上游包的情况下收窄工具范围。

配置模型访问

在 profile 启动后打开 Settings -> Models。API 密钥提供程序保留其现有的密钥表单。当前原生 OAuth 路径为 openai-codex 提供程序暴露：选择 Authorize，完成提供程序拥有的浏览器流程，然后返回 DSH Work 窗口。浏览器仅接收非机密的进度和状态；pi-ai 拥有 OAuth 协议以及位于 http://localhost:1455/auth/callback 的本地回调。

生成的凭据由 DSH 存储在 .dsh/.credentials.yaml 下，并在需要时由 pi-ai 刷新。它绝不会写入 settings.yaml 或
通过 Models API 返回。退出登录会移除已存储的 OAuth
凭据。OAuth 的可用性因提供商而异；自定义提供商仍然
需要 API 密钥或其自己的适配器集成。

文档

| 文档 | 它回答的问题 |
| --- | --- |
| 架构 | DSH 与办公产品层如何协同配合 |
| 产品定位 | 产品服务于谁，以及它不会变成什么 |
| 生态系统概览 | 我们验证了哪些 DSH 办公项目，以及它们有何不同 |
| SEO 与 GEO 基础 | 公开声明如何保持可发现且符合事实 |
| llms.txt | 简洁的机器可读项目事实 |

面向 DSH 构建者

DSH Work 将作为上游运行时之上的产品层来构建，而不是
替代它。贡献应加强以下四条路径之一：

1. DSH 办公配置文件、预设和插件组合。
2. 安全的 PDF、DOCX、XLSX 和 PPTX 摄取。
3. 结构化、可编辑的交付物生成与预览。
4. 引用、审阅和审批用户体验。

有关当前的贡献边界，请参阅 CONTRIBUTING.md。

项目关系

DSH Work 是一个独立的社区项目。“DeepSeek Harness”和“DSH”
指代上游开源运行时；此处对其的使用并不意味着
DeepSeek 的认可、合作或官方支持。

许可证

本仓库在 MIT 许可证 下提供。