@capyclaw/skills-service 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +30 -2
  2. package/package.json +10 -4
  3. package/server.mjs +166 -0
package/README.md CHANGED
@@ -1,3 +1,31 @@
1
- # Temporary Holding Version
1
+ # dsh-skills-service
2
2
 
3
- 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.
3
+ DSH 独立技能服务(服务解耦标准形态)。把原「`ctx.skills` 进程内注册表」的
4
+ 技能内容(SKILL.md)搬出 dsh 进程,作为独立端口服务:
5
+
6
+ ```
7
+ GET /healthz { ok, service:"dsh-skills", pid, port, providers, skills }
8
+ GET /skills 全量技能清单(聚合各 provider)
9
+ GET /skills/:name 单技能正文(原 provider.get 形状)
10
+ ```
11
+
12
+ ## 技能数据源
13
+
14
+ 自动扫描两类布局(都找 `dsh-ppt-skill-*` 目录里的 `lib/index.mjs`):
15
+
16
+ - dev 树:`../plugin/dsh-ppt-skill-*`
17
+ - 套件安装态:本目录同级(`node_modules/dsh-ppt-skill-*`)
18
+
19
+ 可用 `--providers <dir>[[;|,]dir…]` 显式指定。
20
+
21
+ ## 由谁拉起
22
+
23
+ `dsh-service-broker` 按清单以独立进程拉起(套件捆绑布局的清单见
24
+ dsh-ppt-suite 包根 `services.json`,端口 39321)。dsh 侧经 broker 的
25
+ skills 瘦客户端(`ctx.skills` 兼容形状)访问本服务。
26
+
27
+ ## 独立运行
28
+
29
+ ```bash
30
+ node server.mjs [--port 39321] [--providers dir1,dir2]
31
+ ```
package/package.json CHANGED
@@ -1,6 +1,12 @@
1
1
  {
2
2
  "name": "@capyclaw/skills-service",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.1.0",
4
+ "description": "DSH 独立技能服务:聚合 dsh-ppt-skill-* 的 SKILL.md 内容,HTTP 面暴露(GET /healthz、/skills、/skills/:name)。服务解耦标准形态:技能内容不再进程内注册,dsh 侧经 broker 的 skills 瘦客户端访问。",
5
+ "type": "module",
6
+ "main": "./server.mjs",
7
+ "files": [
8
+ "server.mjs",
9
+ "README.md"
10
+ ],
11
+ "license": "MIT"
12
+ }
package/server.mjs ADDED
@@ -0,0 +1,166 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * dsh-skills-service:独立技能服务(服务解耦标准形态)。
4
+ *
5
+ * 职责:把原「ctx.skills 进程内注册表」的技能内容(SKILL.md)搬出 dsh
6
+ * 进程,作为独立端口服务对外提供:
7
+ * GET /healthz { ok, service, pid, port, providers, skills }
8
+ * GET /skills 全量技能清单(汇总各 provider)
9
+ * GET /skills/:name 单技能正文(原 provider.get 形状)
10
+ *
11
+ * dsh 侧经 dsh-service-broker 的 skills 瘦客户端(ctx.skills)访问本服务。
12
+ * 技能数据源 = 各 dsh-ppt-skill-* 插件目录(不搬内容,按目录聚合)。
13
+ *
14
+ * 由 dsh-service-broker 按清单拉起:
15
+ * { "id": "dsh-skills",
16
+ * "cmd": ["node", "<本目录>/server.mjs", "--port", "${PORT}"],
17
+ * "ports": { "main": 39321 },
18
+ * "url": "http://127.0.0.1:${PORT}" }
19
+ */
20
+ import http from 'node:http'
21
+ import fs from 'node:fs'
22
+ import path from 'node:path'
23
+ import { fileURLToPath, pathToFileURL } from 'node:url'
24
+
25
+ const HERE = path.dirname(fileURLToPath(import.meta.url))
26
+ const DEFAULT_PORT = 39321
27
+
28
+ function arg(name, dflt) {
29
+ const i = process.argv.indexOf(name)
30
+ return i >= 0 && process.argv[i + 1] ? process.argv[i + 1] : dflt
31
+ }
32
+
33
+ function loopback(method, url) {
34
+ return new Promise((resolve, reject) => {
35
+ const req = http.request(url, { method }, (res) => {
36
+ let text = ''
37
+ res.on('data', (c) => { text += c })
38
+ res.on('end', () => resolve({ status: res.statusCode, text }))
39
+ })
40
+ req.setTimeout(1200, () => { req.destroy(new Error('timeout')) })
41
+ req.once('error', reject)
42
+ req.end()
43
+ })
44
+ }
45
+
46
+ /** 收集技能 provider:目录列表,每个须含 lib/index.mjs(导出 createProvider)。 */
47
+ async function loadProviders(dirs) {
48
+ const providers = []
49
+ const seen = new Set()
50
+ for (const dir of dirs) {
51
+ const key = path.resolve(dir).toLowerCase()
52
+ if (seen.has(key)) continue
53
+ seen.add(key)
54
+ const entry = path.join(dir, 'lib', 'index.mjs')
55
+ if (!fs.existsSync(entry)) continue
56
+ try {
57
+ const mod = await import(pathToFileURL(entry).href)
58
+ if (typeof mod.createProvider !== 'function') continue
59
+ const provider = mod.createProvider({})
60
+ const skills = await provider.list()
61
+ providers.push({ dir, provider, skills })
62
+ console.log(`[dsh-skills] provider ${path.basename(dir)}: ${skills.map((s) => s.name).join(', ') || '(空)'}`)
63
+ } catch (err) {
64
+ console.warn(`[dsh-skills] 跳过 ${path.basename(dir)}: ${err.message}`)
65
+ }
66
+ }
67
+ return providers
68
+ }
69
+
70
+ /** 候选技能目录:dev 树(../plugin/dsh-ppt-skill-*)+ 安装态(本目录同级
71
+ * node_modules 里的 dsh-ppt-skill-*,套件捆绑布局)。 */
72
+ function defaultProviderDirs() {
73
+ const roots = [path.resolve(HERE, '..', 'plugin'), path.resolve(HERE, '..')]
74
+ const dirs = []
75
+ for (const root of roots) {
76
+ let entries = []
77
+ try { entries = fs.readdirSync(root, { withFileTypes: true }) } catch { continue }
78
+ for (const e of entries) {
79
+ if (e.isDirectory() && e.name.startsWith('dsh-ppt-skill-')) dirs.push(path.join(root, e.name))
80
+ }
81
+ }
82
+ return dirs
83
+ }
84
+
85
+ async function main() {
86
+ const port = Number(arg('--port', process.env.PORT || DEFAULT_PORT)) || DEFAULT_PORT
87
+ const providersArg = arg('--providers', '')
88
+ const dirs = providersArg
89
+ ? providersArg.split(path.delimiter === ';' ? ';' : ',').map((s) => s.trim()).filter(Boolean)
90
+ : defaultProviderDirs()
91
+
92
+ // 复用优先:端口上已是本服务(healthz 自报 dsh-skills)→ 直接退出 0,
93
+ // 让中间件按「已有健康实例」收编,不双开。
94
+ try {
95
+ const probe = await loopback('GET', `http://127.0.0.1:${port}/healthz`)
96
+ if (probe.status === 200 && probe.text.includes('"dsh-skills"')) {
97
+ console.log(`[dsh-skills] 端口 ${port} 已有本服务实例,复用退出`)
98
+ process.exit(0)
99
+ }
100
+ } catch { /* 没有实例,正常监听 */ }
101
+
102
+ const providers = await loadProviders(dirs)
103
+ const byName = new Map()
104
+ for (const { provider, skills } of providers) {
105
+ for (const skill of skills) byName.set(skill.name, { provider, skill })
106
+ }
107
+
108
+ const server = http.createServer(async (req, res) => {
109
+ const send = (code, obj) => {
110
+ const body = JSON.stringify(obj)
111
+ res.writeHead(code, { 'content-type': 'application/json; charset=utf-8', 'content-length': Buffer.byteLength(body) })
112
+ res.end(body)
113
+ }
114
+ try {
115
+ const url = new URL(req.url, 'http://127.0.0.1')
116
+ if (url.pathname === '/healthz') {
117
+ return send(200, {
118
+ ok: true,
119
+ service: 'dsh-skills',
120
+ pid: process.pid,
121
+ port: server.address()?.port || port,
122
+ providers: providers.length,
123
+ skills: byName.size,
124
+ uptimeSec: Math.round(process.uptime()),
125
+ })
126
+ }
127
+ if (url.pathname === '/skills' && req.method === 'GET') {
128
+ return send(200, { ok: true, skills: [...byName.values()].map(({ skill }) => skill) })
129
+ }
130
+ const hit = /^\/skills\/([^/]+)$/.exec(url.pathname)
131
+ if (hit && req.method === 'GET') {
132
+ const entry = byName.get(decodeURIComponent(hit[1]))
133
+ if (!entry) return send(404, { ok: false, error: `未知 skill ${decodeURIComponent(hit[1])}` })
134
+ return send(200, await entry.provider.get({ name: entry.skill.name }))
135
+ }
136
+ send(404, { ok: false, error: `未知端点 ${req.method} ${url.pathname}` })
137
+ } catch (err) {
138
+ send(500, { ok: false, error: err.message })
139
+ }
140
+ })
141
+
142
+ await new Promise((resolve, reject) => {
143
+ server.once('error', reject)
144
+ server.listen(port, '127.0.0.1', resolve)
145
+ })
146
+ const actual = server.address().port
147
+ console.log(`[dsh-skills] 就绪 http://127.0.0.1:${actual}/skills(${providers.length} 个 provider,${byName.size} 个技能)`)
148
+
149
+ let stopping = false
150
+ const shutdown = async () => {
151
+ if (stopping) return
152
+ stopping = true
153
+ console.log('[dsh-skills] 停机中…')
154
+ await new Promise((r) => {
155
+ try { server.closeAll(); server.close(() => r()) } catch { r() }
156
+ })
157
+ process.exit(0)
158
+ }
159
+ process.on('SIGINT', shutdown)
160
+ process.on('SIGTERM', shutdown)
161
+ }
162
+
163
+ main().catch((err) => {
164
+ console.error('[dsh-skills] 启动失败:', err.message)
165
+ process.exit(1)
166
+ })