Zhinet

English | 中文

Zhinet is a community project-management Bundle for DeepSeek Harness (DSH). It stores wishes, designs, plans, workpoints, role responsibilities, execution evidence, and user effect decisions as traceable Host facts, then projects them into a read-only workbench inside each project Session.

This release is a developer preview. Zhinet depends on Session, storage, and Client APIs that are not yet part of a stable DSH release, so installing one npm package is not sufficient. Use the integration patches in this repository and pin the verified baseline below.

Features

• Builds a live project map from confirmed Wish, Design, Plan, and Workpoint relations.
• Shows stage, structural integrity, next action, module leads, and cross-module impacts in the project workbench.
• Stores project-scoped Provider/Model routes for leads, Workers, and Reviewers.
• Runs execution through formal Assignments, Worker results, lead reviews, and user effect decisions.
• Exports and imports zhinet-portable-project v1 artifacts.
• Preserves the original project ID during cross-DSH import and rebinds the project to a target Workspace.
• Rejects an import when the same project ID already exists in the target DSH; it never remaps or clones the project as a new identity.
• Keeps historical Session IDs as provenance only; they do not regain authority in the target DSH.

Verified baseline

• DSH commit: 141eb6fef83422698aef7a981029e843e8161534
• DSH version: 0.1.0-rc.8
• Node.js: ^22.19.0 || >=24.0.0
• Zhinet version: 0.1.0-rc.5

DSH is still in preview. Other commits may require manual patch adaptation. Check these integration points first:

1. Session projectId and agentPreset propagation and persistence.
2. Non-chat conversation.view rendering for project-bound blank Sessions.
3. Storage Domain atomic commit and revision APIs.
4. Preset and Provider/Model routing when a Subagent starts.

Installation

1. Prepare the matching DSH checkout

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

2. Apply the Zhinet integration layer

Run from this repository root:

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

The script runs git apply --check for all four patch groups before it writes anything. It stops before mutation when any patch does not match.

3. Install dependencies and build

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. Install the four role presets

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

If DSH_HOME is unset, pass the actual DSH data directory. The installer refuses to overwrite an existing preset with the same name.

5. Add Zhinet to the Web profile

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

The composed output should contain both dsh-zhinet and zhinet-bundle-host.

Project migration

Export a project from the Zhinet entry in the source DSH. In another DSH that does not contain that project ID, select a target Workspace, review the preflight, and confirm the import.

The import preserves these invariants:

• The project ID does not change.
• The target Workspace must exist and differ from the source binding.
• A same-DSH project-ID conflict prevents all writes.
• All 13 formal fact domains restore through one atomic commit; a failure leaves no partial project.
• Import does not activate historical Sessions or restore their authority.

Do not commit exports containing real project facts to a public repository. This repository contains no author project export.

Repository layout

• packages/bundle/zhinet/: Host, Client, Remote, tests, and Bundle manifest.
• integration/patches/: four DSH patch groups organized by responsibility.
• integration/additions/: two new DSH files that do not exist in the baseline.
• integration/generated/: bootstrap artifacts that break the clean-build Typert Host/Client type cycle.
• presets/: Manager, Lead, Worker, and Reviewer presets.
• scripts/: integration and preset installation helpers.

Distribution status

GitHub Releases include a prebuilt tgz and checksums, but the tgz does not replace the DSH integration patches. This version is not published to npm and does not claim that dsh plugin add dsh-zhinet is a complete standalone installation path.

A normal npm one-command installation can be offered after the required APIs ship in DSH and every package dependency can resolve from the registry.

Verification

The release candidate passed the following checks in a clean checkout of the verified baseline:

• preflight and application of all four patch groups;
• Zhinet Host, Client, Typert Host/Remote build;
• the complete Zhinet package suite: 133 test files and 637 tests, with the final correction rerun independently;
• 17/17 focused portable-project Host and Client tests;
• four-preset installation and overwrite refusal;
• npm tarball extraction, public metadata, sensitive-data, and SHA-256 checks.

License

MIT. This is a community plugin and is not an official DeepSeek Harness release.