Skip to main content
Glama
dsh-t20-arch

dsh-t20-arch

by Yzm889

dsh-t20-arch

T20/T30 天正建筑 (Tianzheng Architecture) connector for DeepSeek Harness — creates real Tianzheng objects (walls, doors, windows, columns, stairs, balconies, axis grids) by driving a running AutoCAD + Tianzheng instance.

License: MIT Platform


Why this exists

Tianzheng objects are ARX custom objects. This is the whole design premise:

Approach

Can create TCH_WALL?

Why

COM AddLine / AddCircle

❌

Only native AcDb entities

AutoLISP entmake

❌

Doesn't know ARX custom classes

COM custom-object creation

❌

No such API exists

Tianzheng ARX running a command inside AutoCAD

✅

The only viable path

So this plugin is not "a wall drawer". It is a reliable bridge that delivers a command to an AutoCAD process that already has Tianzheng loaded — and then proves the command actually worked.

SendCommand returns nothing. The only objective proof of success is that the entity count really increased. Every execution path enforces that check and never reports success without evidence.


Related MCP server: DSH Crew

Verified capabilities

Measured end-to-end on T30天正建筑 V2.0 (Build250811) + AutoCAD 2022 (24.1s). Every row below was confirmed by an actual entity-count increase in a live drawing.

Capability

Command

Verified object

Status

墙体 wall

HZQT

TDbWall

✅

门窗 door / window

MC

TDbOpening

✅

轴网 axis grid

HZZW

8–12 axes, LINE on DOTE

✅

轴网标注 axis annotation

ZWBZ

TDbAxisLabelSet + TDbDimension2

✅

尺寸标注 quick dim

TQuickDim

TDbDimension2

✅ ALL + 尺寸线位置

尺寸标注 point dim

TDimMP

TDbDimension2

✅ 两点 + 尺寸线位置

房间名称/面积 room label

TUpdSpace

TDbSpace

✅ 自动带名称与面积

柱子 column

TGColumn

TDbColumn

✅

楼梯 stair

TLStair

TDbLineStair

✅

阳台 balcony

TBalcony

TDbBalcony

✅

楼板 slab

TSlab

TDbSlab

✅ 可指定板厚

房间 room

TUpdSpace

TDbSpace

✅ 需闭合墙体

天正文字 Tianzheng text

TText

TDbText

✅

native line / circle / text

LINE CIRCLE TEXT

AcDb entities

✅

query / count / save / zoom / diagnose

—

—

✅

Not automated (honest scope):

Capability

Why not

轴网 HZZW(仅“PC2T20”分支时)

同一命令会走两条分支:请选择插入点(可自动)或 PC2T20 选择需要转化的图元(要求选取图元,坐标无效)。分支由天正轴网数据状态决定,命令行无法选择

改墙厚 TWallThick

Destructive under automation: driving it with a guessed input sequence erased all four walls (4 → 0). TDbWall exposes no width/thickness property over COM, so per-wall thickness cannot be set safely. Walls use Tianzheng's configured default thickness; change it in 天正设置 → 墙体 if needed

图层管理器 TCGL

Pure UI command; creates no entity, so it cannot be verified by count


Instruction reference (原子指令)

Every instruction below is independent and composable — nothing is a canned "generate a whole house" preset. You draw a plan by issuing them in order, exactly like a drafter would.

轴网 / 标注

指令

作用

生成对象

在 0,0 画轴网

按天正当前轴网数据生成轴网

LINE(DOTE 层)

轴网标注 0,900 7800,900

给首末轴线加轴号与轴间尺寸

TDbAxisLabelSet + TDbDimension2

快速标注 0,-1500

选全部对象做外部尺寸

TDbDimension2

逐点标注 0,0 8000,0 0,-1500

两点之间加尺寸

TDbDimension2

墙体(逐段绘制)

指令

作用

从 0,0 到 8400,0 画一堵墙

画一段墙(外墙的一个边)

从 0,3000 到 8400,3000 画一堵墙

画内隔墙;天正会自动把被穿过的外墙切断

画墙 0,0 8400,0 8400,6300 0,6300 0,0

一次画闭合墙环(末点重复起点 = 自动闭合)

门窗 / 构件

指令

作用

在 1200,0 开一个宽 1000 高 2100 的门

在墙上开门(宽度经对话框设置)

在 4000,0 开一个宽 1800 的窗

在墙上开窗

在 0,0 画一根柱子

插入天正柱

在 5400,1800 到 8100,4500 画一部楼梯

画双跑/直线楼梯

画阳台 0,0 2000,0 2000,1000 0,1000

画阳台

画楼板 0,0 8400,0 8400,6300 0,6300,板厚 120

画楼板(可指定板厚)

房间

指令

作用

搜索房间,标注位置 4200,1500

搜索全部封闭区域并标注名称 + 面积(一次标注所有房间,不必逐间调用)

文字 / 几何 / 文档

指令

作用

在 0,-3000 写天正文字 平面图

天正文字

从 0,-5000 到 5000,-5000 画一条线 / 在 3000,-4000 画半径 800 的圆

原生图元

统计墙的数量 / 列出所有天正实体

查询

保存图纸 / 缩放全图

文档操作

组合示例(逐条指令,非预设)

在 0,0 画轴网
轴网标注 0,900 7800,900
从 0,0 到 8400,0 画一堵墙
从 8400,0 到 8400,6300 画一堵墙
从 8400,6300 到 0,6300 画一堵墙
从 0,6300 到 0,0 画一堵墙
从 0,3000 到 8400,3000 画一堵墙        # 内隔墙,天正自动切断外墙
搜索房间,标注位置 4200,1500           # 两个房间一次标注完
在 1200,0 开一个宽 1000 高 2100 的门
在 4000,0 开一个宽 1800 的窗
快速标注 0,-1500

Measured 8/8: 7 walls (4 exterior segments + the interior wall splitting them), 2 rooms, 2 openings.

Install

Installed from the Git commit (this package is distributed via Git, not npm):

npx dshpub add Yzm889/TianZheng-ai-plugin --ref <40-char-commit>

Or from a local clone:

dsh plugin add ./

Then fully quit and reopen DSH. Tools appear as mcp__t20_arch__*.

The launcher finds a Python that already has pywin32 and mcp, or builds a private venv under %LOCALAPPDATA%\dsh-t20-arch on first use.

Prerequisites

  • Windows (COM + Win32 input simulation are Windows-only)

  • AutoCAD + T20/T30 天正建筑, started so that Tianzheng's ARX modules are loaded

  • AutoCAD must run as the same Windows user as DSH, at the same elevation

  • To reuse your own Python: setx T20_ARCH_PYTHON "E:\your-venv\Scripts\python.exe"

Foreground handling

Windows delivers SendInput keystrokes only to the foreground window, so drawing commands need AutoCAD in front. The plugin now brings AutoCAD forward itself (a plain foreground change, no minimise/restore flash) before a drawing command — verified working even when another window was active at call time. Read-only work never does this.

Set T20_ALLOW_FOCUS_STEAL=0 if you do not want the plugin activating AutoCAD at all; in that case drawing commands will return a clear "click the drawing area" error instead of typing into nothing. A computer-use plugin (e.g. wincu) is still handy for the agent, but it is no longer required.


Quick start

1. get_active_document       → confirm the COM bridge is attached
2. check_tianzheng_loaded    → confirm tch_kernal.arx is loaded     (do not skip)
3. create_test_drawing       → a NEW drawing this server owns, so your real drawings are safe
4. natural_language("在 0,0 画轴网")
5. natural_language("从 0,0 到 7000,0 画一堵墙")
6. natural_language("在 1000,0 开一个宽 900 的门")
7. natural_language("统计墙的数量")

Each call returns the entity delta as proof, e.g. 已执行 MC,TCH_OPENING +1。


Tools (15)

Connection & drawings

Tool

What it does

get_active_document

AutoCAD version, active drawing, quiescent state

create_test_drawing

New server-owned drawing; auto-discovers the Tianzheng template

close_test_drawing

Close a server-owned drawing; refuses to close yours

diagnose_environment

Install roots, product/build, per-CAD version folder, data-file writability

Tianzheng state

Tool

What it does

check_tianzheng_loaded

Reads Application.ListArx() to confirm tch_kernal.arx

Execution

Tool

What it does

natural_language

Chinese/English sentence → command → verification → Chinese summary

preview_natural_language

Parse only; shows the exact command and inputs without sending

list_capabilities

Every supported intent with an example

run_tianzheng_command

Low-level: send any command + inputs, verify by count

probe_command

Send and report which entity types appeared

Query & native

Tool

What it does

get_entity_count / list_tianzheng_entities / entity_type_histogram

Inspect ModelSpace

draw_line / draw_circle / add_text

Native COM drawing

save_drawing / zoom_extents

Document control


The hard-won details

Every item below was measured on a real install, not inferred. They are why this works at all.

1. ObjectName differs from the documented class name

TCH_WALL is reported by COM as TDbWall; TCH_COLUMN as TDbColumn. Matching only the documented name returns 0 forever. The plugin compares canonical forms (TCH_* and TDb* stripped), so no per-type alias is needed.

2. SendCommand deadlocks; posting everything at once races with prompts

HZQT raises a Tianzheng panel, and a synchronous SendCommand never returns. Posting command + all inputs in one go also fails for pick-style commands (HZZW, TGColumn created nothing while the prompt was still coming up). The working pattern is stepwise: post the command, wait, then type each input, then ESC to end the loop — exactly what a user does.

3. Only SendInput works for interactive input

  • ❌ PostMessage(WM_KEYDOWN) — swallowed by AutoCAD's accelerator tables

  • ❌ PostCommand while a command is prompting — rejected with RPC_E_CALL_REJECTED

  • ✅ SendInput (driver-level) for both coordinates and ESC

4. Dialogs block COM, so they must be driven with Win32

MC opens the native 门窗参数 dialog. While it is up, every COM call is rejected. The plugin fills its edit fields with WM_SETTEXT, presses 确定, then types the insertion point. Measured edit order for 门窗参数: 0=编号 1=门高 2=门宽 3=门槛高 4=距离 5=个数.

5. GetActiveObject returns a weak, untyped object

app = win32com.client.GetActiveObject("AutoCAD.Application")
app.Name          # AttributeError: <unknown>.Name

Rebind first: app = gencache.EnsureDispatch(raw._oleobj_).

6. IsQuiescent is not trustworthy

With Tianzheng loaded it can stay False indefinitely while COM works fine. Never gate logic on it — probe by calling and retrying.

7. COM point arguments must be VARIANT arrays

msp.AddLine((x1,y1,z1), (x2,y2,z2))          # -2147024809 invalid argument
msp.AddLine(VARIANT(VT_ARRAY|VT_R8, ...))     # ✅

8. The per-version folder is NOT predictable — read it from the profile

The sysXXx64 naming changes between products. On T20-Arch V10.0, AutoCAD 2022 used sys22x64. On T30-Arch V2.0, AutoCAD 2022 uses SYS24x64 — probing every folder showed only sys24x64 loads; sys19…sys23 all fail with ARXLOAD 失败. A hardcoded year→folder map silently breaks after an upgrade, so the plugin reads the folder from the running AutoCAD's own Tianzheng profile.

9. Antivirus can silently kill Tianzheng

Tianzheng's crack ships a DLL-hijack loader (uxtheme.dll, ~7 MB, in the AutoCAD folder; the system one is ~0.6 MB). When 360 Total Security quarantined it, every Tianzheng ARX failed to load and the Tianzheng UI vanished — with no obvious connection between cause and symptom. If Tianzheng suddenly disappears, check the AV quarantine and whitelist the AutoCAD folder plus the Tianzheng install folder.

10. A read-only DataStore.dbf aborts commands

Tianzheng's installer marks SYS read-only. When it cannot open DataStore.dbf for writing it shows 对不起,打不开DataStore.dbf文件! and aborts the command. diagnose_environment detects this and prints the exact attrib -R fix; it never modifies your installation itself.

11. Elevation mismatch blocks COM

TGStart.exe may run AutoCAD elevated. A non-elevated DSH then cannot reach it (0x80070522 请求的操作需要提升). Launch AutoCAD at the same elevation as DSH — a direct acad.exe launch from an unelevated shell stays unelevated and works.

12. Typed coordinates need the keyboard focus — and the plugin must not steal it

SendInput (the only way to answer Tianzheng's interactive prompts) reaches only the foreground window. Posting WM_CHAR to the drawing view is ignored by AutoCAD, so there is no focus-free way to type coordinates. (Posting ESC as window messages does work — that is why cancelling a stuck command never disturbs you.)

An earlier version tried to take the foreground itself, including a minimise/restore cycle. That made AutoCAD jump in front of whatever the user was doing — it kept interrupting a running game. The behaviour is now:

  • Default: never steal focus. If AutoCAD is not the foreground window, the run is refused with an explicit message telling you to click the drawing area.

  • Opt in with T20_ALLOW_FOCUS_STEAL=1 when you do want the plugin to take over.

Reading the drawing, counting entities, and cancelling commands never need focus.

13. HZZW normally works, but has a second branch to watch for

Measured working chain: HZZW → 请选择插入点 → (x,y) creates the grid as LINEs on the DOTE layer. One run instead produced PC2T20 选择需要转化的图元 ("select the entities to convert"), where coordinates are ignored — that branch depends on Tianzheng's axis-data state and cannot be selected from the command line. If it appears, open 天正「绘制轴网」once, confirm the axis data, then retry.

14. A wall loop must be closed with C, not by repeating the first point

画墙 0,0 8000,0 8000,6000 0,6000 0,0 looks closed but is not: the repeated final point draws a zero-length segment, the loop stays open (3 walls instead of 4), and a later 搜索房间 silently finds no enclosed area. Use Tianzheng's 闭合(C) option. The parser now recognises a repeated final point and emits C automatically.

15. A real ESC keystroke can collide with desktop-automation hotkeys

Cancelling a pending command used to send a real ESC via SendInput. If a computer-use plugin binds Esc to its own "stop" shortcut, that keystroke aborts the agent's desktop session instead of cancelling the CAD command — measured twice. Cancellation now posts ESC as window messages (post_escape), which needs no foreground, produces no real keystroke, and therefore cannot trip a global hotkey. A real ESC is only used as a last resort.

16. TSPace does not exist — the room command is TUpdSpace

TSPace answers "未知命令". Use TUpdSpace(搜索房间): ALL → Enter → 标注位置点.

17. Do not click the drawing area to "focus" it

Clicking inside the drawing view while no command is running starts a window selection (指定对角点或 [栏选(F)/圈围(WP)/圈交(CP)]). The next typed coordinate then became a selection corner instead of command input, and one run even ended up executing _HELP — the modal Help dialog, which then blocked every COM call and made the whole bridge look dead. Focus is moved with SetFocus on the DirectX view window instead (no mouse event), and T20_CLICK_TO_FOCUS now defaults to off.

18. The first keystroke after activation is often swallowed

Typing immediately after activating a window lost the first character, so 0,0 arrived as ,0 and 4800,3750 as 800,3750; Tianzheng answered 需要点或选项关键字 / 选择无效. The fix is a short pause plus a harmless warm-up key (Shift) before the real text — this was the single biggest source of non-deterministic failures.

19. Pick-only commands CAN be automated with selection keywords

Commands that say "选择…" accept typed selection keywords, so a mouse pick is often avoidable:

Command

Prompt

Typed answer that worked

楼板 TSlab

选择一封闭的多段线或圆

L (last) — create the boundary with COM first, then L selects it

房间 TUpdSpace

请选择构成一完整建筑物的所有墙体

ALL

Measured full chains:

TSlab      : L → Enter(不可见边) → Enter(洞口) → Enter/厚度
TUpdSpace  : ALL → Enter → <标注位置点>

20. Tianzheng prompts may only render once input arrives

Waiting for a prompt like 请选择起始轴线 can deadlock: measured, ZWBZ printed its prompt only after a key was sent (the prompt appeared immediately before the ESC cancelled it). AutoCAD buffers command-line input, so the reliable pattern is fixed-pace typing with a pause between values (1.8 s here) followed by an entity-count check — not waiting for the prompt. This took 轴网标注 from 0/3 to 3/3.

Two traps found this way: TSPace does not exist (Tianzheng answers "未知命令"; the real command is TUpdSpace), and a wall loop must be closed with the C option — repeating the first point draws a zero-length segment and leaves the loop open, after which 搜索房间 silently finds no area. The parser now turns a repeated final point into C automatically.


Safety

  1. Attaches to a running instance only (override: AUTOCAD_ALLOW_NEW_INSTANCE=true).

  2. Drawing ownership isolation — persisted across restarts; write operations refuse drawings this server did not create (override: T20_ALLOW_FOREIGN_DOC=true).

  3. Never fakes success — no entity delta means success: false, plus the exact payload, LASTPROMPT and a diagnosis.

  4. Never edits your installation — read-only detection is report-only.

  5. Busy retry for RPC_E_CALL_REJECTED; single STA worker thread for all COM.

  6. Bounded timeouts — a command stuck on a dialog returns an error, not a hang.

Environment variables

Variable

Default

Meaning

TIANZHENG_ROOT

auto-detected

Tianzheng install root (the folder containing SYS)

T20_ARCH_PYTHON

auto-detected

Python with pywin32 + mcp

AUTOCAD_ALLOW_NEW_INSTANCE

false

Allow launching AutoCAD when none is running

T20_ALLOW_FOREIGN_DOC

false

Allow commands on drawings this server did not create

T20_ALLOW_FOCUS_STEAL

false

Allow the plugin to pull AutoCAD to the foreground. Off by default so a background run never interrupts you

T20_STATE_DIR

%USERPROFILE%

Where the ownership state file lives


Layout

dsh-t20-arch/
├── package.json           # dsh bundle manifest
├── cordis.patch.yml       # staging row + MCP client row
├── lib/index.js           # stages bin/ and python/ into %LOCALAPPDATA%
├── bin/run.ps1            # finds/builds a Python with pywin32+mcp, runs the server
├── python/
│   └── t20_arch_mcp/
│       ├── server.py           # MCP entry, 15 tools
│       ├── acad_conn.py        # COM attach, STA thread, busy retry, ownership, ARX check
│       ├── tianzheng_runner.py # stepwise execution, dialog flow, count verification
│       ├── tianzheng_query.py  # entity walking + canonical type matching
│       ├── nl_catalog.py       # intent → command/params/verification table
│       ├── nl_parser.py        # Chinese instruction parsing
│       ├── nl_dispatch.py      # parse → execute → verify → Chinese summary
│       ├── dialog.py           # Win32 dialog driving (WM_SETTEXT / BM_CLICK)
│       ├── sendinput.py        # driver-level keyboard injection
│       ├── env_check.py        # install discovery, version folder, writability
│       ├── native_tools.py     # native AutoCAD helpers (VARIANT points)
│       └── winmsg.py           # window enumeration / dialog detection
├── LICENSE
└── README.md

Troubleshooting

Symptom

Cause

Fix

Tianzheng UI vanished overnight

AV quarantined the crack DLL

Restore it in the AV, whitelist AutoCAD + Tianzheng folders, restart

MK_E_UNAVAILABLE / 0x800401E3

AutoCAD not running, or different user

Start AutoCAD; match user and elevation

0x80070522 需要提升

CAD runs elevated, DSH does not

Launch both at the same elevation

success: false, nothing added, dialog mentions DataStore

SYS read-only

Run diagnose_environment, apply attrib -R, restart CAD

unknown command for HZQT

Tianzheng ARX not loaded

Start CAD so tch_kernal.arx loads; verify with check_tianzheng_loaded

Wall created but reported 0

Wrong verify type

Use TCH_WALL; canonical matching handles TDbWall

Every COM call rejected

Command pending or dialog open

Press ESC in AutoCAD; the plugin does this automatically

执行失败 + hint mentions 焦点 / focus

AutoCAD is not the foreground window

Click the AutoCAD drawing area, then retry (or set T20_ALLOW_FOCUS_STEAL=1)

PC2T20 选择需要转化的图元

Tianzheng routed the axis command to its convert branch

Open 天正「绘制轴网」dialog once, confirm the axis data, then retry


License

MIT — see LICENSE.

AutoCAD is a registered trademark of Autodesk, Inc. 天正建筑 is a product of 北京天正工程软件有限公司 (Tangent). This is an independent interoperability tool, not affiliated with or endorsed by either company.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Connects a DeepSeek Harness agent to 嘉立创EDA专业版 / EasyEDA Pro through a local loopback bridge and JLCEDA extension, letting it search and place components, draw wires, net flags and labels, inspect and delete primitives, and save or zoom schematic documents. It also covers PCB work: placement and movement of components, tracks, vias, regions and board outlines, auto-place and auto-route with job polling, DRC, copper pours, and Gerber export.
      1,098 npm
      5
      Apache 2.0
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables dispatching tasks from coding hosts such as Claude Code, Codex, Antigravity and Grok to DeepSeek Harness agents that appear as native subagents with live progress, tier/effort policy, escalation, and workspace guardrails. Also lends text-only harnesses vision and image generation through DeepSeek VL models or existing CLIs.
      354 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables coding hosts like Claude Code, Codex, Antigravity and Grok to dispatch work to DeepSeek Harness agents that appear as native subagents with live progress, tier/effort policy, escalation on failure, workspace guardrails and a jobs board. Also lends text-only harnesses vision and image generation via DeepSeek's VL model, the host's existing CLIs, or custom OpenAI-compatible endpoints.
      354 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables orchestrating hosts such as Claude Code, Codex, Antigravity and Grok to dispatch work to DeepSeek Harness agents that surface as native subagents with live progress, per-tier presets, effort control, guardrails and a jobs board. It also lends text-only harness models vision and image generation through a multimodal bridge that prefers native DeepSeek VL models and falls back to local CLIs or OpenAI-compatible endpoints.
      354 npm
      MIT