File size: 2,445 Bytes
6972dac
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# 项目约定

项目:图阅 DWG / 3DM 阅读器。
指定远端:https://github.com/delltom2000/dwgreadder.git。

## 用户明确要求:防止私人图纸和信息泄露

- 用户于 2026-11-09 明确要求:DWG 等私有文件不得上传,避免泄密。此要求对后续工作持续有效。
- GitHub 仅同步程序源码、测试和通用项目文档。原始 DWG/DXF/3DM、模型与 CAD 模板/备份、图纸副本、浏览器历史内容、图纸或模型截图/预览、提取的图形数据或文字、实际项目路径、凭据和日志都留在本机,不放进提交、PR、Issue 或公开文档。
- `.local/` 存放本机资料与验收输出,必须保持忽略。测试读取用户图纸时使用忽略的本机配置,不把图纸或其提取结果做成仓库 fixture。
- 上传前运行 `npm run check:upload` 检查暂存内容,并检查 `git diff --cached --stat`。不要用 `git add -f` 绕过忽略规则。
- GitHub 凭据仅通过受限的本机认证流程使用,不把令牌放进 URL、Git 配置、源码或聊天。
- 不改变仓库可见性,不强制推送;已有远端历史必须保留。

## 验证

代码改动按范围运行 `npm test` / `npm run build`;浏览器读取真实图纸的验证资料仅写入 `.local/`。

## 界面与读取方式

- 三栏布局:左侧最近打开的文件,中间图纸/模型,右侧对象目录与相关属性;左右面板均可展开、收起。
- DWG 使用二维拖动平移、滚轮缩放和对象定位。
- 3DM 使用三维旋转、平移、缩放,点击目录部件或模型几何对象自动聚焦,显示相关属性。没有名称时使用类型和序号,不虚构业务部件名称。
- 两种格式都在本机解析,3DM 依赖资源随项目构建,不从外部 CDN 加载,不追踪模型内外部资源链接。

## HF 发布

- 用户于 2026-11-09 授权发布到既有 Space `dellweb3/dwgreader`;当前是公开 Docker Space、cpu-basic,保持配置与可见性,不升级付费硬件。
- 只部署经核对的程序源码与静态运行资源,私有图纸、模型及相关资料的禁传要求同样适用于 HF。
- Docker 构建上下文必须使用 `.dockerignore` 白名单;运行阶段仅含程序静态文件,不提供文件上传接口。
- Space 根 README 使用 `deploy/SPACE_README.md`;项目说明另存为 `PROJECT_README.md`。凭据不进入源文件、镜像或 Space Secrets。