feat(terminology): add terminology protocol launcher support

zhensherlock · zhensherlock · commit 9ad98a231a39 · 2026-04-01T00:03:10.000+08:00
diff --git a/.changeset/frank-suns-nail.md b/.changeset/frank-suns-nail.md
@@ -0,0 +1,5 @@
+---
+'protocol-launcher': minor
+---
+
+feat(terminology): add terminology protocol launcher support
diff --git a/apps/docs/.vitepress/config.ts b/apps/docs/.vitepress/config.ts
@@ -95,6 +95,7 @@ export default defineConfig({
     'en/apps/steam.md': 'apps/steam.md',
     'en/apps/tally.md': 'apps/tally.md',
     'en/apps/telegram.md': 'apps/telegram.md',
+    'en/apps/terminology.md': 'apps/terminology.md',
     'en/apps/termius.md': 'apps/termius.md',
     'en/apps/textastic.md': 'apps/textastic.md',
     'en/apps/textmate.md': 'apps/textmate.md',
@@ -237,6 +238,7 @@ export default defineConfig({
           { text: 'Steam', link: '/apps/steam' },
           { text: 'Tally', link: '/apps/tally' },
           { text: 'Telegram', link: '/apps/telegram' },
+          { text: 'Terminology', link: '/apps/terminology' },
           { text: 'Termius', link: '/apps/termius' },
           { text: 'Textastic', link: '/apps/textastic' },
           { text: 'TextMate', link: '/apps/textmate' },
@@ -384,6 +386,7 @@ export default defineConfig({
               { text: 'Steam', link: '/apps/steam' },
               { text: 'Tally', link: '/apps/tally' },
               { text: 'Telegram', link: '/apps/telegram' },
+              { text: 'Terminology', link: '/apps/terminology' },
               { text: 'Termius', link: '/apps/termius' },
               { text: 'Textastic', link: '/apps/textastic' },
               { text: 'TextMate', link: '/apps/textmate' },
diff --git a/apps/docs/.vitepress/constants/terminology.ts b/apps/docs/.vitepress/constants/terminology.ts
@@ -0,0 +1,7 @@
+export const lookupParams = {
+  text: 'automation',
+}
+
+export const searchParams = {
+  q: 'protocol',
+}
diff --git a/apps/docs/en/apps/terminology.md b/apps/docs/en/apps/terminology.md
@@ -0,0 +1,81 @@
+---
+layout: doc
+---
+
+<script setup lang="ts">
+import { ref, computed } from 'vue'
+import VPLink from 'vitepress/dist/client/theme-default/components/VPLink.vue'
+import { open, lookup, search } from 'protocol-launcher/terminology'
+import { SelectInstallationMethod } from '../../.vitepress/components'
+import { lookupParams, searchParams } from '../../.vitepress/constants/terminology'
+
+const currentMethod = ref('On-Demand')
+const importPath = computed(() =>
+  currentMethod.value === 'On-Demand' ? 'protocol-launcher/terminology' : 'protocol-launcher',
+)
+</script>
+
+# Terminology
+
+[Terminology](https://agiletortoise.com/terminology/) is a browser for the English language – part dictionary, part thesaurus, and part research tool. **Protocol Launcher** allows you to generate deep links to look up words and search in Terminology.
+
+## Usage
+
+There are two ways to use this library:
+
+- On-Demand import from subpaths enables tree-shaking and keeps bundles small.
+- Full Import from the root package is convenient but includes all app modules.
+
+Pick On-Demand for production builds; Full Import is fine for quick scripts or demos.
+
+<SelectInstallationMethod v-model="currentMethod" />
+
+### Open App
+
+```ts-vue [{{currentMethod}}]
+import { {{ currentMethod === 'On-Demand' ? 'open' : 'terminology' }} } from '{{ importPath }}'
+
+const url = {{currentMethod === 'On-Demand' ? '' : 'terminology.'}}open()
+```
+
+<div class="flex justify-center">
+  <VPLink :href="open()" target="_self">
+    <Button Text>
+  </VPLink>
+</div>
+
+### Lookup Word
+
+Open directly to a detail look up for a term in Terminology.
+
+```ts-vue [{{currentMethod}}]
+import { {{ currentMethod === 'On-Demand' ? 'lookup' : 'terminology' }} } from '{{ importPath }}'
+
+const url = {{currentMethod === 'On-Demand' ? '' : 'terminology.'}}lookup({
+  text: 'automation',
+})
+```
+
+<div class="flex justify-center">
+  <VPLink :href="lookup(lookupParams)" target="_self">
+    <Button Text>
+  </VPLink>
+</div>
+
+### Search
+
+Open directly to a word search for a string in Terminology.
+
+```ts-vue [{{currentMethod}}]
+import { {{ currentMethod === 'On-Demand' ? 'search' : 'terminology' }} } from '{{ importPath }}'
+
+const url = {{currentMethod === 'On-Demand' ? '' : 'terminology.'}}search({
+  q: 'protocol',
+})
+```
+
+<div class="flex justify-center">
+  <VPLink :href="search(searchParams)" target="_self">
+    <Button Text>
+  </VPLink>
+</div>
diff --git a/apps/docs/en/guide/getting-started.md b/apps/docs/en/guide/getting-started.md
@@ -200,6 +200,7 @@ For detailed usage instructions for each application, please refer to their resp
 - [Steam](../apps/steam.md)
 - [Tally](../apps/tally.md)
 - [Telegram](../apps/telegram.md)
+- [Terminology](../apps/terminology.md)
 - [Termius](../apps/termius.md)
 - [Textastic](../apps/textastic.md)
 - [TextMate](../apps/textmate.md)
diff --git a/apps/docs/en/guide/what-is-it.md b/apps/docs/en/guide/what-is-it.md
@@ -98,6 +98,7 @@ Currently, we support the following applications:
 - [Steam](../apps/steam.md)
 - [Tally](../apps/tally.md)
 - [Telegram](../apps/telegram.md)
+- [Terminology](../apps/terminology.md)
 - [Termius](../apps/termius.md)
 - [Textastic](../apps/textastic.md)
 - [TextMate](../apps/textmate.md)
diff --git a/apps/docs/zh/apps/terminology.md b/apps/docs/zh/apps/terminology.md
@@ -0,0 +1,81 @@
+---
+layout: doc
+---
+
+<script setup lang="ts">
+import { ref, computed } from 'vue'
+import VPLink from 'vitepress/dist/client/theme-default/components/VPLink.vue'
+import { open, lookup, search } from 'protocol-launcher/terminology'
+import { SelectInstallationMethod } from '../../.vitepress/components'
+import { lookupParams, searchParams } from '../../.vitepress/constants/terminology'
+
+const currentMethod = ref('On-Demand')
+const importPath = computed(() =>
+  currentMethod.value === 'On-Demand' ? 'protocol-launcher/terminology' : 'protocol-launcher',
+)
+</script>
+
+# Terminology
+
+[Terminology](https://agiletortoise.com/terminology/) 是一款英语语言浏览器——集词典、同义词词典和研究工具于一体。**Protocol Launcher** 允许您生成深度链接以在 Terminology 中查找单词和搜索。
+
+## 使用方式
+
+有两种使用此库的方式：
+
+- 按需导入（On-Demand）：从子路径导入支持 tree-shaking，保持较小的打包体积。
+- 完整导入（Full Import）：从根包导入更方便，但会包含所有应用模块。
+
+生产构建建议选择按需导入；快速脚本或演示可以使用完整导入。
+
+<SelectInstallationMethod v-model="currentMethod" />
+
+### 打开应用
+
+```ts-vue [{{currentMethod}}]
+import { {{ currentMethod === 'On-Demand' ? 'open' : 'terminology' }} } from '{{ importPath }}'
+
+const url = {{currentMethod === 'On-Demand' ? '' : 'terminology.'}}open()
+```
+
+<div class="flex justify-center">
+  <VPLink :href="open()" target="_self">
+    <Button Text>
+  </VPLink>
+</div>
+
+### 查找单词
+
+直接在 Terminology 中打开某个术语的详细查询页面。
+
+```ts-vue [{{currentMethod}}]
+import { {{ currentMethod === 'On-Demand' ? 'lookup' : 'terminology' }} } from '{{ importPath }}'
+
+const url = {{currentMethod === 'On-Demand' ? '' : 'terminology.'}}lookup({
+  text: 'automation',
+})
+```
+
+<div class="flex justify-center">
+  <VPLink :href="lookup(lookupParams)" target="_self">
+    <Button Text>
+  </VPLink>
+</div>
+
+### 搜索
+
+直接在 Terminology 中打开单词搜索。
+
+```ts-vue [{{currentMethod}}]
+import { {{ currentMethod === 'On-Demand' ? 'search' : 'terminology' }} } from '{{ importPath }}'
+
+const url = {{currentMethod === 'On-Demand' ? '' : 'terminology.'}}search({
+  q: 'protocol',
+})
+```
+
+<div class="flex justify-center">
+  <VPLink :href="search(searchParams)" target="_self">
+    <Button Text>
+  </VPLink>
+</div>
diff --git a/apps/docs/zh/config.ts b/apps/docs/zh/config.ts
@@ -107,6 +107,7 @@ export default defineAdditionalConfig({
           { text: 'Steam', link: '/zh/apps/steam' },
           { text: 'Tally', link: '/zh/apps/tally' },
           { text: 'Telegram', link: '/zh/apps/telegram' },
+          { text: 'Terminology', link: '/zh/apps/terminology' },
           { text: 'Termius', link: '/zh/apps/termius' },
           { text: 'Textastic', link: '/zh/apps/textastic' },
           { text: 'TextMate', link: '/zh/apps/textmate' },
diff --git a/apps/docs/zh/guide/getting-started.md b/apps/docs/zh/guide/getting-started.md
@@ -200,6 +200,7 @@ import { cherryStudio, cursor, githubDesktop } from 'protocol-launcher'
 - [Steam](../apps/steam.md)
 - [Tally](../apps/tally.md)
 - [Telegram](../apps/telegram.md)
+- [Terminology](../apps/terminology.md)
 - [Termius](../apps/termius.md)
 - [Textastic](../apps/textastic.md)
 - [TextMate](../apps/textmate.md)
diff --git a/apps/docs/zh/guide/what-is-it.md b/apps/docs/zh/guide/what-is-it.md
@@ -97,6 +97,7 @@ layout: doc
 - [Steam](../apps/steam.md)
 - [Tally](../apps/tally.md)
 - [Telegram](../apps/telegram.md)
+- [Terminology](../apps/terminology.md)
 - [Termius](../apps/termius.md)
 - [Textastic](../apps/textastic.md)
 - [TextMate](../apps/textmate.md)
diff --git a/packages/protocol-launcher/package.json b/packages/protocol-launcher/package.json
@@ -366,6 +366,10 @@
       "types": "./dist/types/telegram/index.d.ts",
       "import": "./dist/telegram/index.js"
     },
+    "./terminology": {
+      "types": "./dist/types/terminology/index.d.ts",
+      "import": "./dist/terminology/index.js"
+    },
     "./termius": {
       "types": "./dist/types/termius/index.d.ts",
       "import": "./dist/termius/index.js"
diff --git a/packages/protocol-launcher/src/index.ts b/packages/protocol-launcher/src/index.ts
@@ -75,6 +75,7 @@ export * as sourcetree from './sourcetree'
 export * as steam from './steam'
 export * as tally from './tally'
 export * as telegram from './telegram'
+export * as terminology from './terminology'
 export * as termius from './termius'
 export * as textastic from './textastic'
 export * as textmate from './textmate'
diff --git a/packages/protocol-launcher/src/terminology/index.ts b/packages/protocol-launcher/src/terminology/index.ts
@@ -0,0 +1,3 @@
+export { lookup } from './lookup'
+export { open } from './open'
+export { search } from './search'
diff --git a/packages/protocol-launcher/src/terminology/lookup.ts b/packages/protocol-launcher/src/terminology/lookup.ts
@@ -0,0 +1,28 @@
+import { qs } from '@protocol-launcher/shared'
+
+/**
+ * Lookup command payload definition.
+ */
+type Lookup = {
+  /**
+   * Text to look up.
+   */
+  text: string
+}
+
+/**
+ * Open directly to a detail look up for a term in Terminology.
+ *
+ * @param payload Lookup command payload.
+ * @returns Terminology lookup URL.
+ * @example
+ * lookup({ text: 'automation' })
+ * // => 'terminology:///lookup?text=automation'
+ * @link https://agiletortoise.com/terminology/automation
+ */
+export function lookup(payload: Lookup) {
+  const { text } = payload
+  const params = qs({ text })
+
+  return `terminology:///lookup${params}`
+}
diff --git a/packages/protocol-launcher/src/terminology/open.ts b/packages/protocol-launcher/src/terminology/open.ts
@@ -0,0 +1,11 @@
+/**
+ * Open Terminology.
+ *
+ * @returns Terminology open URL.
+ * @example
+ * open()
+ * // => 'terminology://'
+ */
+export function open() {
+  return 'terminology://'
+}
diff --git a/packages/protocol-launcher/src/terminology/search.ts b/packages/protocol-launcher/src/terminology/search.ts
@@ -0,0 +1,28 @@
+import { qs } from '@protocol-launcher/shared'
+
+/**
+ * Search command payload definition.
+ */
+type Search = {
+  /**
+   * Query string to search.
+   */
+  q: string
+}
+
+/**
+ * Open directly to a word search for a string in Terminology.
+ *
+ * @param payload Search command payload.
+ * @returns Terminology search URL.
+ * @example
+ * search({ q: 'protocol' })
+ * // => 'terminology:///search?q=protocol'
+ * @link https://agiletortoise.com/terminology/automation
+ */
+export function search(payload: Search) {
+  const { q } = payload
+  const params = qs({ q })
+
+  return `terminology:///search${params}`
+}
diff --git a/packages/protocol-launcher/tests/terminology.test.ts b/packages/protocol-launcher/tests/terminology.test.ts
@@ -0,0 +1,37 @@
+import { describe, expect, test } from 'vitest'
+import { terminology } from '../src'
+
+describe('terminology', () => {
+  test('open should return a URL', async () => {
+    const url = terminology.open()
+    expect(url).toBe('terminology://')
+  })
+
+  test('lookup should return a URL with text', async () => {
+    const url = terminology.lookup({
+      text: 'automation',
+    })
+    expect(url).toBe('terminology:///lookup?text=automation')
+  })
+
+  test('lookup should return a URL with encoded text', async () => {
+    const url = terminology.lookup({
+      text: 'URL scheme',
+    })
+    expect(url).toBe('terminology:///lookup?text=URL%20scheme')
+  })
+
+  test('search should return a URL with q', async () => {
+    const url = terminology.search({
+      q: 'protocol',
+    })
+    expect(url).toBe('terminology:///search?q=protocol')
+  })
+
+  test('search should return a URL with encoded q', async () => {
+    const url = terminology.search({
+      q: 'deep link',
+    })
+    expect(url).toBe('terminology:///search?q=deep%20link')
+  })
+})

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +'protocol-launcher': minor
 +---
++
 +feat(terminology): add terminology protocol launcher support