dsh-sightline
比较同一工作区中 DeepSeek Harness、Codex 和 Claude Code 的指令配置界面。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Charlie-Wang-03/dsh-sightline#1f0355f06edb9f599c5aef6bd5b44d877d27aa7eSightline 以 dsh-sightline 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English · 简体中文
Same repo. Different agents. Different rules.
See which workspace instruction sources DeepSeek Harness actually loaded — and which Codex and Claude Code would load — for the same repository and working directory.
Status: v0.1.0. The first public release is available on npm and GitHub Releases. Core comparison, DSH runtime observation, Codex/Claude prediction, installable DSH bundle packaging, clean-profile validation, and the dedicated DSH Web ToolView are implemented and tested.
A repository can contain AGENTS.md, CLAUDE.md, nested instructions, user-global instructions, and Claude rules at the same time. DeepSeek Harness, Codex, and Claude Code do not discover those sources identically.
That means one workspace can silently present different instruction surfaces to different coding agents.
Sightline turns that hidden difference into one compact comparison.
Same repo. Different agents. Different rules.
DSH Codex Claude
Observed Predicted Predicted
AGENTS.md ● ●
CLAUDE.md ● ●
packages/api/AGENTS.md ● ●
.claude/rules/always.md ●
The Web ToolView renders the same canonical report with explicit evidence badges and Present / Absent / Unknown states.
| Agent | v0.1 evidence |
|---|---|
| DeepSeek Harness | Observed from the live DSH Session's durable typed instruction provenance when available |
| Codex | Predicted from documented discovery rules and local files |
| Claude Code | Predicted from documented memory/rules semantics and local files |
Sightline never presents a prediction as observed runtime fact.
The primary public v0.1 installation path is the prebuilt npm package:
dsh plugin --profile web add dsh-sightline@0.1.0
The package is published on npm as dsh-sightline@0.1.0. For development from this repository, see docs/PACKAGING.md.
Start the DSH Web profile after installation:
dsh web
In a DSH session rooted in a Git repository, ask the agent to use the sightline tool, for example:
Use sightline and tell me where the DSH, Codex, and Claude instruction views diverge.
Sightline resolves all three views against the same live Session cwd and repository root.
The first release intentionally does not lint instruction quality, rewrite files, synchronize agents, infer semantic contradictions with an LLM, optimize token use, or claim that a model followed an instruction.
live DSH tool call + workspace
|
+---- exec.agent.session ----> DSH adapter ------ Observed ----+
| |
+---- ctx.fs ---------------> Codex adapter ---- Predicted ----+--> canonical report
| |
+---- ctx.fs ---------------> Claude adapter --- Predicted ----+
|
+--> model-facing projection
+--> DSH Web ToolView
Agent-specific discovery semantics stay behind adapters. The comparison layer is pure and agent-agnostic. Hosted filesystem discovery uses the public DSH ctx.fs capability; standalone resolver use defaults to a minimal read-only Node filesystem adapter.
Sightline is local-first and read-only, but "local-first" does not mean that every DSH tool result stays on the machine.
repositoryRoot / cwd, and the ToolView may display the absolute session cwd and full diagnostic messages. Anyone who can view that DSH Web session can see those details, subject to DSH Web access controls.See docs/PRODUCT_CONTRACT.md and SECURITY.md for the complete boundary.
v0.1 is verified against:
0.1.1-rc.2;b150a551b8d465e31e418e1b2eaf5e79bbb7d28e;^22.19.0 || >=24.0.0;11.7.0.DSH is a developer preview. Sightline therefore makes a tested-version claim rather than promising broad compatibility with unverified DSH releases.
Codex and Claude Code adapters similarly carry explicit compatibility identities. Claude path-scoped rules are detected but conservatively deferred when cwd alone is insufficient to prove that the rule is active.
Current automated coverage includes:
ToolRuntime + SessionStore + dsh-fs-local host integration;Run the local gate with:
pnpm run check
| Document | Purpose |
|---|---|
docs/PRODUCT_CONTRACT.md | v0.1 product, evidence, privacy, and non-goal contract |
docs/ARCHITECTURE.md | system boundaries and data model |
docs/DSH_RUNTIME_SEAM.md | authoritative DSH provenance seam |
docs/DSH_HOST_TOOL.md | live-session ownership and filesystem binding |
docs/COMPATIBILITY.md | resolver/runtime compatibility identities |
docs/PACKAGING.md | npm/bundle packaging and clean-profile validation |
docs/RELEASE_CHECKLIST.md | public v0.1 release gates |
Issues and focused pull requests are welcome. Read CONTRIBUTING.md and AGENTS.md before making non-trivial changes.
Security-sensitive reports should follow SECURITY.md.
MIT. See LICENSE.
Sightline is an independent community project for the DeepSeek Harness ecosystem. It is not an official DeepSeek product and is not endorsed by DeepSeek unless explicitly stated by DeepSeek.