dsh-typelens
为 DeepSeek Harness 提供自动且有界的类型上下文和编辑诊断
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:fantasyce/dsh-typelens#f77db5e29bdd3d804b6d1a6892fc43bd1639e9bfTypelens 以 dsh-typelens 发布，当前版本为 0.1.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Local-first type context and edit diagnostics for DeepSeek Harness.
TypeLens watches successful DSH file reads and edits. After a read, it appends only the complete type declarations needed to understand the visible code. After an edit, it appends bounded TypeScript diagnostics with new errors first. The original tool result always remains intact, and an analysis failure never turns a successful file operation into a failure.
Version 0.1.2 is acceptance-tested with DSH 0.1.1-rc.2 on macOS arm64. GitHub CI covers Linux with Node.js 22 and 24. TypeScript, TSX, JavaScript, and JSX are supported. Vue and Svelte script blocks use their optional compiler when available and retain a bounded first-instance-script fallback when it is absent. Template semantics are outside the current analysis boundary. Windows is a compatibility target but is not a 0.1.2 release gate.
DSH delegates profile dependency management to pnpm. Confirm that both
commands are available before installing a plugin:
dsh --version
pnpm --version
If pnpm is missing, install it using the
official pnpm installation guide, then run:
dsh plugin --profile web add dsh-typelens
dsh plugin --profile headless add dsh-typelens
The npm package is the canonical install source. Use dsh-typelens@0.1.2 to
pin this release, or use the verified
GitHub release tarball
when an explicit archive URL is required.
Restart the affected DSH profile, then verify the composed row:
dsh --profile web --dump-config
The package bundle inserts a typelens row automatically. In DSH Web, open Settings → TypeLens to inspect health, change automatic behavior and limits, or reset in-memory caches and counters.
Update each profile where TypeLens is installed, then restart that profile so the running Host and client load the new package bytes:
dsh plugin --profile web update dsh-typelens --latest
dsh plugin --profile headless update dsh-typelens --latest
Use dsh --profile web --dump-config after restart to confirm the composed
typelens row. To remain on an approved release, keep the pinned dependency
instead of using --latest.
To remove it:
dsh plugin --profile web remove dsh-typelens
typelens_lookup_type: find a named declaration relevant to a file.typelens_list_types: list bounded declarations relevant to a file.typelens_check: run bounded file and project diagnostics.typelens_explain: inspect effective configuration, health, circuit state, and source-free counters.All returned paths are workspace-relative. Explicit file tools require an active DSH session workspace.
Automatic context is limited to 800 estimated tokens, depth 4, 1.5 seconds, and 2 MiB files. Explicit checks receive 5 seconds. A circuit breaker pauses automatic analysis for 30 seconds after five operational failures in 60 seconds; explicit tools and health remain available. Dependency trees, build output, VCS metadata, coverage, and environment files are denied by default.
See configuration, troubleshooting, and the Chinese guide. The current release gate is recorded in v0.1.2 acceptance.
corepack enable
pnpm install --frozen-lockfile
pnpm verify
pnpm verify type-checks, runs the complete test suite, builds both Host and DSH client artifacts, scans for secrets, audits package contents, and creates the tarball under artifacts/.
TypeLens is one independent part of a small, local-first reliability toolkit:
Each project remains separately installable and keeps its own trust boundary.
TypeLens persists only validated settings under $DSH_HOME/typelens/settings.json with owner-only permissions. Analysis state and counters live in memory. Type context and diagnostics appended to an agent step become part of the next DSH model request, so they follow the privacy policy of your configured model provider. See SECURITY.md for reporting and the full trust boundary.
MIT