@liangjiehappy/dsh-plugin-cadpop 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,45 @@
-# Temporary Holding Version
+# dsh-plugin-cadpop
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Read-only CADPOP entry tools for DeepSeek Harness: parametric templates, help center, DFM entry, online editor, and drawing tools.
+
+中文说明见 [README.zh-CN.md](README.zh-CN.md).
+
+## Tools
+
+| Tool | Purpose |
+|---|---|
+| `cadpop_templates` | List parametric templates |
+| `cadpop_help` | Open a help topic |
+| `cadpop_dfm` | DFM manufacturability/quotation entry |
+| `cadpop_app` | Online CAD editor entry |
+| `cadpop_tools` | Drawing tools collection page |
+
+## Install
+
+```bash
+dsh plugin --profile web add @liangjiehappy/dsh-plugin-cadpop
+```
+
+## Config
+
+```yaml
+- insert:
+    - id: dsh-plugin-cadpop
+      name: "@liangjiehappy/dsh-plugin-cadpop"
+      config:
+        baseUrl: "https://cadpop.com"
+```
+
+Zero-config works; the default base URL is `https://cadpop.com`.
+
+## Permissions
+
+- Outbound HTTPS GET to `cadpop.com` only (configurable `baseUrl`)
+- No file reads or writes, no credential access, no shell
+- Read-only: no drawing upload, no payment
+
+## Limitations
+
+- No automatic pricing: DFM prices come from the page, never promised by the AI
+- Template list is parsed from `/help/templates/`; page redesigns may affect parsing
+- Drawing generation belongs to the site/other plugins, not this one

package/README.zh-CN.md

@@ -0,0 +1,43 @@
+# dsh-plugin-cadpop
+
+CADPOP（cadpop.com）只读入口插件：参数化模板清单、帮助中心、DFM 入口、在线编辑器、图纸工具页。
+
+English docs: [README.md](README.md).
+
+## 工具
+
+| 工具 | 作用 |
+|---|---|
+| `cadpop_templates` | 列出参数化模板 |
+| `cadpop_help` | 打开帮助主题 |
+| `cadpop_dfm` | DFM 制造分析/报价入口 |
+| `cadpop_app` | 在线 CAD 编辑器入口 |
+| `cadpop_tools` | 图纸工具集合页 |
+
+## 安装
+
+```bash
+dsh plugin --profile web add @liangjiehappy/dsh-plugin-cadpop
+```
+
+## 配置
+
+```yaml
+- insert:
+    - id: dsh-plugin-cadpop
+      name: "@liangjiehappy/dsh-plugin-cadpop"
+      config:
+        baseUrl: "https://cadpop.com"
+```
+
+## 权限声明
+
+- 只对 `cadpop.com` 发 HTTPS GET
+- 不读写文件、不读凭证、不执行 shell
+- 只读：不上传图纸、不发起支付
+
+## 限制
+
+- 不自动报价：DFM 价格以页面结果为准
+- 模板清单从 `/help/templates/` 解析，页面改版可能影响解析
+- 生成图纸等能力属于 cadpop 站内/其它插件，不在本插件范围

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+- insert:
+    - id: dsh-plugin-cadpop
+      name: "@liangjiehappy/dsh-plugin-cadpop"
+      config:
+        baseUrl: "https://cadpop.com"

package/lib/core.js

@@ -0,0 +1,55 @@
+// dsh-plugin-cadpop · 纯函数：帮助路径、HTML 标题与模板清单解析
+export const DEFAULT_BASE = 'https://cadpop.com'
+
+export function normalizeBase(base) {
+  const b = (base || DEFAULT_BASE).trim().replace(/\/+$/, '')
+  if (!/^https?:\/\//i.test(b)) throw new Error('baseUrl 必须以 http(s):// 开头')
+  return b
+}
+
+export function slugify(s) {
+  return String(s || '')
+    .trim()
+    .toLowerCase()
+    .replace(/[\s_]+/g, '-')
+    .replace(/[^a-z0-9\u4e00-\u9fa5-]+/g, '')
+    .replace(/-+/g, '-')
+    .replace(/^-|-$/g, '')
+}
+
+export function buildHelpUrl(base, topic) {
+  const slug = slugify(topic)
+  if (!slug) throw new Error('topic 不能为空')
+  return normalizeBase(base) + '/help/' + slug + '/'
+}
+
+export function extractTitle(html) {
+  const m = String(html || '').match(/<title[^>]*>([\s\S]*?)<\/title>/i)
+  if (!m) return ''
+  return decodeEntities(m[1]).replace(/\s+/g, ' ').trim().slice(0, 200)
+}
+
+export function decodeEntities(s) {
+  return String(s)
+    .replace(/&amp;/g, '&')
+    .replace(/&lt;/g, '<')
+    .replace(/&gt;/g, '>')
+    .replace(/&quot;/g, '"')
+    .replace(/&#39;|&apos;/g, "'")
+    .replace(/&nbsp;/g, ' ')
+}
+
+/** 从 help/templates 页面提取模板清单（<li> 文本） */
+export function parseTemplates(html) {
+  const out = []
+  const re = /<li[^>]*>([\s\S]*?)<\/li>/gi
+  let m
+  while ((m = re.exec(String(html || ''))) !== null) {
+    const t = decodeEntities(m[1].replace(/<[^>]+>/g, '')).replace(/\s+/g, ' ').trim()
+    if (!t || t.length > 120) continue
+    if (!/[（(]/.test(t)) continue
+    out.push(t)
+    if (out.length >= 30) break
+  }
+  return [...new Set(out)]
+}

package/lib/index.js

@@ -0,0 +1,85 @@
+// dsh-plugin-cadpop · cadpop.com 只读入口与帮助中心工具
+import { defineTool } from '@deepseek-ai/dsh-tools'
+import {
+  DEFAULT_BASE, normalizeBase, buildHelpUrl, extractTitle, parseTemplates,
+} from './core.js'
+
+export const name = 'dsh-plugin-cadpop'
+export const inject = ['tools']
+
+const text = (value) => [{ type: 'text', text: JSON.stringify(value, null, 2) }]
+const headers = { 'user-agent': 'dsh-plugin-cadpop/0.1', accept: 'text/html' }
+
+export function apply(ctx, config = {}) {
+  const base = normalizeBase(config.baseUrl)
+
+  async function fetchPage(path, signal) {
+    const url = base + path
+    const r = await fetch(url, { headers, signal, redirect: 'follow' })
+    const html = await r.text()
+    return { status: r.status, ok: r.ok, url: r.url || url, title: extractTitle(html), html }
+  }
+
+  ctx.tools.register(defineTool({
+    name: 'cadpop_templates',
+    description: '列出 CADPOP 参数化模板（法兰/支架/外壳/齿轮等），返回模板名与帮助页链接。',
+    parameters: {},
+    output: { schema: { type: 'json' }, render: (_a, v) => text(v) },
+    isConcurrencySafe: () => true,
+    async execute(_args, exec) {
+      const page = await fetchPage('/help/templates/', exec.signal)
+      const templates = parseTemplates(page.html)
+      return { status: page.status, ok: page.ok, url: page.url, count: templates.length, templates }
+    },
+  }))
+
+  ctx.tools.register(defineTool({
+    name: 'cadpop_help',
+    description: '打开 CADPOP 帮助中心指定主题（如 templates、getting-started、save-export），返回标题与链接。',
+    parameters: {
+      topic: { type: 'string', required: true, description: '帮助主题 slug，如 templates' },
+    },
+    output: { schema: { type: 'json' }, render: (_a, v) => text(v) },
+    isConcurrencySafe: () => true,
+    async execute(args, exec) {
+      const url = buildHelpUrl(base, args.topic)
+      const r = await fetch(url, { headers, signal: exec.signal, redirect: 'follow' })
+      const html = await r.text()
+      return { status: r.status, ok: r.ok, url: r.url || url, title: extractTitle(html) }
+    },
+  }))
+
+  ctx.tools.register(defineTool({
+    name: 'cadpop_dfm',
+    description: '返回 CADPOP DFM 制造分析/报价入口（人工确认价格，不自动报价）。',
+    parameters: {},
+    output: { schema: { type: 'json' }, render: (_a, v) => text(v) },
+    isConcurrencySafe: () => true,
+    async execute() {
+      return { url: base + '/dfm/', note: '上传 DXF/STEP 获取可制造性检查与报价；价格以页面结果为准，不由 AI 承诺。' }
+    },
+  }))
+
+  ctx.tools.register(defineTool({
+    name: 'cadpop_app',
+    description: '返回 CADPOP 在线 CAD 编辑器入口（浏览器打开，可导入图纸手工修改）。',
+    parameters: {},
+    output: { schema: { type: 'json' }, render: (_a, v) => text(v) },
+    isConcurrencySafe: () => true,
+    async execute() {
+      return { url: base + '/app/', note: '在编辑器里可打开 DXF/DWG、改图、导出；与对话式生成共用同一套模板概念。' }
+    },
+  }))
+
+  ctx.tools.register(defineTool({
+    name: 'cadpop_tools',
+    description: '返回 CADPOP 工具集合页（DWG→DXF、DXF→PDF、BOM 导出等）标题与链接。',
+    parameters: {},
+    output: { schema: { type: 'json' }, render: (_a, v) => text(v) },
+    isConcurrencySafe: () => true,
+    async execute(_args, exec) {
+      const page = await fetchPage('/tools/', exec.signal)
+      return { status: page.status, ok: page.ok, url: page.url, title: page.title }
+    },
+  }))
+}

package/package.json

@@ -1,6 +1,38 @@
 {
   "name": "@liangjiehappy/dsh-plugin-cadpop",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "CADPOP 在线 CAD 工具入口：模板清单、帮助中心、DFM 制造分析、编辑器与图纸工具页。只访问 cadpop.com。",
+  "type": "module",
+  "main": "lib/index.js",
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "README.zh-CN.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "engines": {
+    "dsh": ">=0.2.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "*",
+    "@deepseek-ai/dsh-tools": "*"
+  },
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "cadpop",
+    "cad",
+    "dxf",
+    "dfm"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "test": "node --test"
+  }
+}