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