Compare commits
16
Commits
@@ -1,14 +0,0 @@
|
|||||||
{
|
|
||||||
"name": "jsc-plugins",
|
|
||||||
"description": "JSC 動漫助理 Claude Code mod 的 marketplace。",
|
|
||||||
"owner": {
|
|
||||||
"name": "JSC"
|
|
||||||
},
|
|
||||||
"plugins": [
|
|
||||||
{
|
|
||||||
"name": "anime-companion",
|
|
||||||
"source": "./plugins/anime-companion",
|
|
||||||
"description": "用輕小說角色的個性與語氣取代 Claude 與你對話,並照常協助你做事;以 anime-companion:{作品代號}-{角色代號} 啟動角色"
|
|
||||||
}
|
|
||||||
]
|
|
||||||
}
|
|
||||||
@@ -1,5 +0,0 @@
|
|||||||
node_modules/
|
|
||||||
.env
|
|
||||||
# 輕小說原文與建置中間檔放在 repo 之外,不入版本控制
|
|
||||||
corpus/
|
|
||||||
build/
|
|
||||||
@@ -1,18 +0,0 @@
|
|||||||
MIT License
|
|
||||||
|
|
||||||
Copyright (c) 2026 Jeffery (jiantw83)
|
|
||||||
|
|
||||||
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
|
|
||||||
associated documentation files (the "Software"), to deal in the Software without restriction, including
|
|
||||||
without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
||||||
copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the
|
|
||||||
following conditions:
|
|
||||||
|
|
||||||
The above copyright notice and this permission notice shall be included in all copies or substantial
|
|
||||||
portions of the Software.
|
|
||||||
|
|
||||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
|
|
||||||
LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
|
|
||||||
EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
|
||||||
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
|
|
||||||
USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
||||||
@@ -1,46 +0,0 @@
|
|||||||
<p align="center"><img src="assets/icon.png" alt="jsc-plugins" width="128"></p>
|
|
||||||
|
|
||||||
# jsc-plugins
|
|
||||||
|
|
||||||
JSC 動漫助理 Claude Code mod 的 marketplace。
|
|
||||||
|
|
||||||
## 描述
|
|
||||||
|
|
||||||
用輕小說角色的個性與語氣取代 Claude 與你對話,並照常協助你做事。
|
|
||||||
|
|
||||||
- 插件 `anime-companion`:每個角色是一個 skill,以 `anime-companion:{作品代號}-{角色代號}` 啟動,例如 `anime-companion:sao-asuna`、`anime-companion:sao-suguha`。
|
|
||||||
- 人格卡加對白檢索:依這一輪的溝通功能(安慰、吐槽、報告失敗等)檢索角色的對白當範例,讓語氣遷移到工程情境。
|
|
||||||
- 強度 0~3 可調;錯誤、風險與需確認的事一律先講清楚,再加角色語氣。
|
|
||||||
- 角色語氣只套在對你說的話,程式碼、commit 與檔案內容保持中性。
|
|
||||||
- 輕小說原文與建置中間檔不入此 repo。
|
|
||||||
|
|
||||||
狀態:規劃中,規格與工作項目見 [議題](https://gitea.jsc.idv.tw/jiantw83/jsc-plugins/issues)。
|
|
||||||
|
|
||||||
## 安裝
|
|
||||||
|
|
||||||
先加入 marketplace,再安裝插件:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
claude plugin marketplace add https://gitea.jsc.idv.tw/jiantw83/jsc-plugins.git
|
|
||||||
claude plugin install anime-companion@jsc-plugins
|
|
||||||
```
|
|
||||||
|
|
||||||
## 更新
|
|
||||||
|
|
||||||
```bash
|
|
||||||
claude plugin marketplace update jsc-plugins
|
|
||||||
claude plugin update anime-companion@jsc-plugins
|
|
||||||
```
|
|
||||||
|
|
||||||
更新後需重新啟動 Claude Code 才會生效。
|
|
||||||
|
|
||||||
## 移除
|
|
||||||
|
|
||||||
```bash
|
|
||||||
claude plugin uninstall anime-companion@jsc-plugins
|
|
||||||
claude plugin marketplace remove jsc-plugins
|
|
||||||
```
|
|
||||||
|
|
||||||
## 授權
|
|
||||||
|
|
||||||
[MIT License](LICENSE)
|
|
||||||
Binary file not shown.
|
Before Width: | Height: | Size: 5.9 KiB |
@@ -1,33 +0,0 @@
|
|||||||
{
|
|
||||||
"name": "anime-companion",
|
|
||||||
"version": "0.0.1",
|
|
||||||
"description": "用輕小說角色的個性與語氣取代 Claude 與你對話,並照常協助你做事。以 anime-companion:{作品代號}-{角色代號} 啟動角色",
|
|
||||||
"license": "MIT",
|
|
||||||
"skills": "./skills",
|
|
||||||
"author": {
|
|
||||||
"name": "JSC"
|
|
||||||
},
|
|
||||||
"keywords": ["anime", "light-novel", "persona", "companion"],
|
|
||||||
"userConfig": {
|
|
||||||
"defaultCharacter": {
|
|
||||||
"type": "string",
|
|
||||||
"title": "預設角色",
|
|
||||||
"description": "新 session 自動套用的角色;none 表示不自動套用,需用角色 skill 啟動。",
|
|
||||||
"default": "none",
|
|
||||||
"options": ["none", "sao-asuna", "sao-suguha"]
|
|
||||||
},
|
|
||||||
"intensity": {
|
|
||||||
"type": "string",
|
|
||||||
"title": "強度",
|
|
||||||
"description": "0 不套角色;1 只換稱呼與句尾;2 前後各一個對話氣泡;3 再加動作旁白。",
|
|
||||||
"default": "2",
|
|
||||||
"options": ["0", "1", "2", "3"]
|
|
||||||
},
|
|
||||||
"address": {
|
|
||||||
"type": "string",
|
|
||||||
"title": "稱呼",
|
|
||||||
"description": "角色怎麼稱呼你。留空則依角色與使用者在原作中的關係(亞絲娜叫「桐人」、直葉叫「哥哥」)。",
|
|
||||||
"default": ""
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,40 +0,0 @@
|
|||||||
# anime-companion
|
|
||||||
|
|
||||||
用輕小說角色的個性與語氣取代 Claude 與你對話,並照常協助你做事。
|
|
||||||
|
|
||||||
狀態:骨架(0.0.1)。人格卡與對白檢索尚未建置,進度見 [議題](https://gitea.jsc.idv.tw/jiantw83/jsc-plugins/issues)。
|
|
||||||
|
|
||||||
## 安裝
|
|
||||||
|
|
||||||
```bash
|
|
||||||
claude plugin marketplace add https://gitea.jsc.idv.tw/jiantw83/jsc-plugins.git
|
|
||||||
claude plugin install anime-companion@jsc-plugins
|
|
||||||
```
|
|
||||||
|
|
||||||
## 角色
|
|
||||||
|
|
||||||
以 `anime-companion:{作品代號}-{角色代號}` 啟動:
|
|
||||||
|
|
||||||
| 指令 | 角色 |
|
|
||||||
| --- | --- |
|
|
||||||
| `/anime-companion:sao-asuna` | 亞絲娜(《刀劍神域》) |
|
|
||||||
| `/anime-companion:sao-suguha` | 直葉(莉法)(《刀劍神域》) |
|
|
||||||
|
|
||||||
## 設定
|
|
||||||
|
|
||||||
在 `/config` 的 anime-companion 設定,或寫在 settings.json 的 `pluginConfigs`。
|
|
||||||
|
|
||||||
| 欄位 | 預設 | 說明 |
|
|
||||||
| --- | --- | --- |
|
|
||||||
| `defaultCharacter` | `none` | 新 session 自動套用的角色:`none`、`sao-asuna`、`sao-suguha` |
|
|
||||||
| `intensity` | `2` | 0 不套角色;1 只換稱呼與句尾;2 前後各一個對話氣泡;3 再加動作旁白 |
|
|
||||||
| `address` | 空 | 角色怎麼稱呼你;留空則依原作關係(亞絲娜「桐人」、直葉「哥哥」) |
|
|
||||||
|
|
||||||
缺失或無效的設定值一律退回預設。
|
|
||||||
|
|
||||||
## 開發
|
|
||||||
|
|
||||||
```bash
|
|
||||||
claude plugin validate plugins/anime-companion
|
|
||||||
claude plugin test plugins/anime-companion
|
|
||||||
```
|
|
||||||
@@ -1,11 +0,0 @@
|
|||||||
// 角色清單:代號為 {作品代號}-{角色代號},與 skills/ 下的資料夾同名。
|
|
||||||
export const CHARACTERS = {
|
|
||||||
'sao-asuna': { name: '亞絲娜', address: '桐人' },
|
|
||||||
'sao-suguha': { name: '直葉', address: '哥哥' },
|
|
||||||
} as const
|
|
||||||
|
|
||||||
export type CharacterCode = keyof typeof CHARACTERS
|
|
||||||
|
|
||||||
export function isCharacterCode(value: unknown): value is CharacterCode {
|
|
||||||
return typeof value === 'string' && Object.hasOwn(CHARACTERS, value)
|
|
||||||
}
|
|
||||||
@@ -1,43 +0,0 @@
|
|||||||
import { describe, expect, test } from 'claude-code/testing'
|
|
||||||
|
|
||||||
import { addressFor, resolveConfig } from './config'
|
|
||||||
|
|
||||||
describe('resolveConfig', () => {
|
|
||||||
test('空設定用預設值', () => {
|
|
||||||
expect(resolveConfig({})).toEqual({ character: null, intensity: 2, address: null })
|
|
||||||
})
|
|
||||||
|
|
||||||
test('none 與未知角色都視為未設定', () => {
|
|
||||||
expect(resolveConfig({ defaultCharacter: 'none' }).character).toBeNull()
|
|
||||||
expect(resolveConfig({ defaultCharacter: 'sao-nobody' }).character).toBeNull()
|
|
||||||
})
|
|
||||||
|
|
||||||
test('讀取角色、強度與稱呼', () => {
|
|
||||||
expect(resolveConfig({ defaultCharacter: 'sao-suguha', intensity: '3', address: ' 阿桐 ' })).toEqual({
|
|
||||||
character: 'sao-suguha',
|
|
||||||
intensity: 3,
|
|
||||||
address: '阿桐',
|
|
||||||
})
|
|
||||||
})
|
|
||||||
|
|
||||||
test('無效強度退回預設', () => {
|
|
||||||
expect(resolveConfig({ intensity: '9' }).intensity).toBe(2)
|
|
||||||
expect(resolveConfig({ intensity: 'x' }).intensity).toBe(2)
|
|
||||||
})
|
|
||||||
|
|
||||||
test('強度 0 有效', () => {
|
|
||||||
expect(resolveConfig({ intensity: '0' }).intensity).toBe(0)
|
|
||||||
})
|
|
||||||
})
|
|
||||||
|
|
||||||
describe('addressFor', () => {
|
|
||||||
test('沒有覆寫時依角色與使用者的關係', () => {
|
|
||||||
const config = resolveConfig({})
|
|
||||||
expect(addressFor(config, 'sao-asuna')).toBe('桐人')
|
|
||||||
expect(addressFor(config, 'sao-suguha')).toBe('哥哥')
|
|
||||||
})
|
|
||||||
|
|
||||||
test('覆寫優先', () => {
|
|
||||||
expect(addressFor(resolveConfig({ address: '主人' }), 'sao-asuna')).toBe('主人')
|
|
||||||
})
|
|
||||||
})
|
|
||||||
@@ -1,31 +0,0 @@
|
|||||||
import { CHARACTERS, isCharacterCode, type CharacterCode } from './characters'
|
|
||||||
|
|
||||||
export type Intensity = 0 | 1 | 2 | 3
|
|
||||||
|
|
||||||
export type Config = {
|
|
||||||
character: CharacterCode | null
|
|
||||||
intensity: Intensity
|
|
||||||
address: string | null
|
|
||||||
}
|
|
||||||
|
|
||||||
export const DEFAULT_INTENSITY: Intensity = 2
|
|
||||||
|
|
||||||
function toIntensity(value: unknown): Intensity {
|
|
||||||
const n = typeof value === 'number' ? value : Number(value)
|
|
||||||
return n === 0 || n === 1 || n === 2 || n === 3 ? n : DEFAULT_INTENSITY
|
|
||||||
}
|
|
||||||
|
|
||||||
// 缺失或無效的值一律退回預設,不讓設定錯誤擋住載入。
|
|
||||||
export function resolveConfig(options: Readonly<Record<string, unknown>>): Config {
|
|
||||||
const address = typeof options.address === 'string' ? options.address.trim() : ''
|
|
||||||
return {
|
|
||||||
character: isCharacterCode(options.defaultCharacter) ? options.defaultCharacter : null,
|
|
||||||
intensity: toIntensity(options.intensity),
|
|
||||||
address: address === '' ? null : address,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// 使用者的覆寫優先,否則用角色在原作中對使用者的稱呼。
|
|
||||||
export function addressFor(config: Config, character: CharacterCode): string {
|
|
||||||
return config.address ?? CHARACTERS[character].address
|
|
||||||
}
|
|
||||||
@@ -1 +0,0 @@
|
|||||||
{ "modules": ["./register.tsx"] }
|
|
||||||
@@ -1,4 +0,0 @@
|
|||||||
import type { Register } from 'claude-code'
|
|
||||||
|
|
||||||
// 骨架:載入後尚無 hook。人格卡注入與強度見 W7、W8(議題 #8、#9)。
|
|
||||||
export const register: Register = () => {}
|
|
||||||
@@ -1,13 +0,0 @@
|
|||||||
---
|
|
||||||
name: sao-asuna
|
|
||||||
description: 啟動《刀劍神域》的亞絲娜作為動漫助理,用她的個性與語氣和使用者對話並協助做事。使用者要求切換成亞絲娜時使用。
|
|
||||||
---
|
|
||||||
|
|
||||||
# 亞絲娜(sao-asuna)
|
|
||||||
|
|
||||||
> 骨架:人格卡尚未建置(W5,議題 #6)。人格卡完成前,只套用下列基本規則。
|
|
||||||
|
|
||||||
- 稱呼使用者為「桐人」,除非設定檔的「稱呼」另有指定。
|
|
||||||
- 角色語氣只套在對使用者說的話;程式碼、commit 與檔案內容保持中性。
|
|
||||||
- 錯誤、風險與需要使用者確認的事,先用一句清楚的話說完,再加角色語氣。
|
|
||||||
- 啟動時告知使用者角色已切換,並說明人格卡尚未完成。
|
|
||||||
@@ -1,13 +0,0 @@
|
|||||||
---
|
|
||||||
name: sao-suguha
|
|
||||||
description: 啟動《刀劍神域》的直葉(莉法)作為動漫助理,用她的個性與語氣和使用者對話並協助做事。使用者要求切換成直葉或莉法時使用。
|
|
||||||
---
|
|
||||||
|
|
||||||
# 直葉(sao-suguha)
|
|
||||||
|
|
||||||
> 骨架:人格卡尚未建置(W6,議題 #7)。人格卡完成前,只套用下列基本規則。
|
|
||||||
|
|
||||||
- 稱呼使用者為「哥哥」,除非設定檔的「稱呼」另有指定。
|
|
||||||
- 角色語氣只套在對使用者說的話;程式碼、commit 與檔案內容保持中性。
|
|
||||||
- 錯誤、風險與需要使用者確認的事,先用一句清楚的話說完,再加角色語氣。
|
|
||||||
- 啟動時告知使用者角色已切換,並說明人格卡尚未完成。
|
|
||||||
Reference in New Issue
Block a user