智网项目事实图XY1998-debug/dsh-zhinet

智网（Zhinet）

智网是 DeepSeek Harness（DSH）的社区项目管理 Bundle。它把愿望、设计、计划、工作点、角色职责、施工证据和用户效果保存为可追溯的 Host 正式事实，并在项目 Session 中提供只读工作台。

当前版本是开发者预览版。智网依赖尚未进入正式 DSH 的 Session、存储和 Client 接口，因此不能只安装一个 npm 包。请使用仓库附带的集成补丁，并锁定下方验证基线。

能力

- 从已确认的 Wish、Design、Plan 和 Workpoint 关系生成项目活地图。
- 在项目工作台中显示阶段、结构完整性、下一步、负责人和跨模块影响。
- 为模块负责人、Worker 和 Reviewer 保存项目级 Provider/Model 路由。
- 通过正式 Assignment、Worker 结果、负责人复核和用户效果决定完成施工闭环。
- 导出和导入 zhinet-portable-project v1 项目文件。
- 跨 DSH 导入时保留原项目 ID，并把项目绑定到目标 Workspace。
- 同一 DSH 已存在相同项目 ID 时拒绝导入，不把项目复制成新 ID。
- 历史 Session ID 只保留为来源记录，不在目标 DSH 恢复权限。

兼容基线

本版本验证于：

- DSH commit：141eb6fef83422698aef7a981029e843e8161534
- DSH 版本：0.1.0-rc.8
- Node.js：^22.19.0 || >=24.0.0
- 智网版本：0.1.0-rc.5

DSH 仍处于预览阶段。其他 commit 可能需要手工调整补丁，重点检查：

1. Session 的 projectId、agentPreset 传播和持久化。
2. 项目绑定的空白 Session 是否渲染非聊天 conversation.view。
3. Storage Domain 的原子提交和 revision API。
4. Subagent 启动时的 preset 与 Provider/Model 路由。

安装

1. 准备匹配的 DSH checkout

git clone https://github.com/deepseek-ai/DeepSeek-Harness.git
git -C DeepSeek-Harness checkout 141eb6fef83422698aef7a981029e843e8161534

2. 应用智网集成层

在本仓库根目录执行：

.\scripts\apply-to-checkout.ps1 -Checkout C:\path\to\DeepSeek-Harness

脚本会先对四组补丁全部执行 git apply --check。任何补丁不匹配时，脚本在写入前停止。

3. 安装依赖并构建

cd C:\path\to\DeepSeek-Harness
pnpm install
pnpm exec tsc -b packages/typert/generator/tsconfig.json --force
pnpm exec tsc -b packages/bundle/zhinet/tsconfig.host.json --force
pnpm exec tsdown --config packages/bundle/zhinet/tsdown.config.ts
pnpm exec tsc -b packages/bundle/zhinet/tsconfig.client.json --force

4. 安装四个角色 preset

.\scripts\install-presets.ps1 -DshHome "$env:DSH_HOME"

如果未设置 DSH_HOME，将参数换成实际 DSH 数据目录。安装器不会覆盖已有同名 preset。

5. 加入 Web profile

pnpm dsh plugin --profile web add .\packages\bundle\zhinet
pnpm dsh --profile web --dump-config
pnpm dsh web --no-open

--dump-config 应包含 dsh-zhinet 和 zhinet-bundle-host。

项目迁移

在源 DSH 的智网入口导出项目文件。在另一套没有相同项目 ID 的 DSH 中选择目标 Workspace、执行预检并确认导入。

导入具有以下不变量：

- 项目 ID 不变。
- 目标 Workspace 必须存在且与源绑定不同。
- 同一 DSH 的项目 ID 冲突会阻止写入。
- 13 个正式事实域通过一次原子提交恢复；失败不留下半个项目。
- 导入不会自动激活历史 Session，也不会恢复历史 Session 的操作权限。

不要把含真实项目事实的导出文件提交到公开仓库。此仓库不包含作者的个人项目数据。

仓库结构

- packages/bundle/zhinet/：Host、Client、Remote、测试和 Bundle manifest。
- integration/patches/：按职责拆分的四组 DSH 补丁。
- integration/additions/：补丁之外的两个新增 DSH 文件。
- integration/generated/：打破干净构建中 Typert Host/Client 类型循环的自举产物。
- presets/：Manager、Lead、Worker、Reviewer 四个角色 preset。
- scripts/：集成和 preset 安装脚本。

发布与安装状态

GitHub Release 提供预构建 tgz 和校验文件，但 tgz 不能替代 DSH 集成补丁。当前版本尚未发布到 npm，也不承诺 dsh plugin add dsh-zhinet 可以独立完成安装。

当所需接口进入正式 DSH、包依赖可以从注册表解析后，才会提供普通 npm 一键安装路径。

验证

发布候选在干净的兼容基线 checkout 中通过：

- 四组补丁预检和应用。
- Zhinet Host、Client、Typert Host/Remote 构建。
- 智网完整包测试共 133 个测试文件、637 个测试；最终修正项已单独复验通过。
- portable project Host/Client 聚焦测试 17/17。
- 四个 preset 安装和拒绝覆盖检查。
- npm tarball 解包、公开元数据、敏感信息和 SHA-256 检查。

许可证

MIT。本项目是社区插件，不代表 DeepSeek Harness 官方发布。