tdsh-emoji 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+All notable changes to **tdsh-emoji** are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/lang/zh-CN/).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-09-25
+
+### Added
+
+- 首个版本：向 dsh 系统提示词注入「情绪 → 标准 emoji」白名单规则，emoji 贴合
+  对应情绪的句子/短句之后。
+- 三种模式 `off` / `auto` / `frequent`，默认 `auto`；单条回复上限 `maxPerTurn`
+  （1–10，默认 3）。
+- 放置位置 `inline`（贴合句子，默认）/ `end`（回复结尾）。
+- 与 dsh-kaomoji 共存：规则禁止 emoji 与颜文字出现在同一句/同一行，两者会自动
+  分散到不同句子；设置卡片同在「设置 → 通用设置」。
+- 设置卡片通过同源路由 `POST /tdsh-emoji-settings` 读写 `~/.dsh/tdsh-emoji.json`，
+  Tailscale/局域网/SSH 转发都能保存，保存即生效。
+- 零第三方运行时依赖；内置 `node:test` 单测。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tdsh-emoji contributors
+
+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.

package/README.en.md

@@ -0,0 +1,84 @@
+# Tdsh-emoji
+
+> Add standard Unicode emoji to [DeepSeek Harness](https://github.com/deepseek-ai) (dsh) replies, designed to coexist with dsh-kaomoji.
+
+[![npm](https://img.shields.io/npm/v/tdsh-emoji.svg)](https://www.npmjs.com/package/tdsh-emoji)
+[![license](https://img.shields.io/github/license/TianJie52009/Tdsh-emoji.svg)](./LICENSE)
+
+> 🤖 **Pure Codex generation** — the code and docs in this repository were
+> generated entirely by OpenAI Codex and have not been human-reviewed.
+
+`Tdsh-emoji` injects a “mood → emoji” whitelist into the system prompt, so the
+model puts a standard emoji **right after the sentence or short phrase whose
+mood it matches**. The library only uses emoji that ship with iOS, Windows and
+Android; no skin-tone modifiers, no exotic sequences.
+
+## Features
+
+- **Inline placement** — after the matching sentence (default), or at the end of the reply (`end`).
+- **Up to 10 per reply** — `maxPerTurn` 1–10, default 3; `frequent` spreads them across sentences.
+- **Coexists with dsh-kaomoji** — both place decorations after sentences, so this plugin also forbids emoji and kaomoji in the **same sentence or line**; the model picks different sentences. Both settings cards live next to each other under Settings → General.
+- **Visual settings card** — mode, placement, limit and extra guidance; saved live, no restart.
+- **Remote-friendly** — the settings route is same-origin, so Tailscale/LAN/SSH-tunnel pages can save.
+- **No third-party runtime dependencies** — dsh's `systemPrompt` service and Node built-ins only.
+
+## How it works
+
+1. Registers the prompt section `tdsh-emoji:guidance` (order `177`; dsh-kaomoji uses `176`).
+2. Each assembly contributes mode/placement rules, the per-reply cap, the emoji whitelist, and the “never share a sentence with a kaomoji” rule.
+3. The settings card uses `POST /tdsh-emoji-settings` to read/write `~/.dsh/tdsh-emoji.json`; the Host updates the prompt section immediately.
+
+## Install
+
+```powershell
+cd "$env:USERPROFILE\.dsh\profiles\web"
+
+# npm (recommended)
+dsh plugin --profile web add tdsh-emoji
+
+# or straight from GitHub
+dsh plugin --profile web add github:TianJie52009/Tdsh-emoji
+```
+
+Restart the Web Host; the “Emoji (tdsh-emoji)” card appears under Settings → General, right next to the dsh-kaomoji card.
+
+## Configuration
+
+Defaults: `mode: auto`, `placement: inline`, `maxPerTurn: 3`. Deployment defaults can be overridden in the profile’s `cordis.patch.yml`:
+
+```yaml
+- id: tdsh-emoji
+  config:
+    mode: frequent     # off | auto | frequent
+    placement: inline  # inline | end
+    maxPerTurn: 5      # 1-10
+    customPrompt: "Keep it professional; prefer encourage/thanks emoji"
+```
+
+| Key | Type | Default | Description |
+| --- | --- | --- | --- |
+| `mode` | `'off' \| 'auto' \| 'frequent'` | `'auto'` | `off` disables; `auto` decorates conversational replies; `frequent` decorates every conversational reply (code-only/formal excluded) |
+| `placement` | `'inline' \| 'end'` | `'inline'` | After the matching sentence, or at the reply end |
+| `maxPerTurn` | `number` (1–10) | `3` | Emoji cap per reply; `frequent` spreads them across sentences |
+| `customPrompt` | `string` | `''` | Extra style/scene guidance |
+| `settingsFile` | `string` | `~/.dsh/tdsh-emoji.json` | (advanced) user-settings path |
+
+## Coexistence with dsh-kaomoji
+
+| Plugin | Inserts | Position | Conflict handling |
+| --- | --- | --- | --- |
+| dsh-kaomoji | Japanese kaomoji `(´∀｀)` | after the matching sentence | emoji side forbids sharing a sentence/line |
+| Tdsh-emoji | Standard emoji 😊 | after the matching sentence | `Never place an emoji in the same sentence or line as a kaomoji` |
+
+Both cards live under Settings → General (order 30 / 31).
+
+## Development
+
+```powershell
+npm test   # node:test (guidance rules + settings route + client loading)
+npm pack   # verify the publish payload
+```
+
+## License
+
+[MIT](./LICENSE)

package/README.md

@@ -0,0 +1,94 @@
+# Tdsh-emoji
+
+> 给 [DeepSeek Harness](https://github.com/deepseek-ai)（dsh）的回复自动添加标准 emoji，并且能和 dsh-kaomoji 共存。
+
+[![npm](https://img.shields.io/npm/v/tdsh-emoji.svg)](https://www.npmjs.com/package/tdsh-emoji)
+[![license](https://img.shields.io/github/license/TianJie52009/Tdsh-emoji.svg)](./LICENSE)
+
+> 🤖 **纯 Codex 生成**：本仓库的代码与文档均由 OpenAI Codex 自动生成，未经人工逐行审查。使用前请自行阅读并测试。
+
+`Tdsh-emoji` 在模型生成前向系统提示词注入一段「情绪 → emoji」白名单规则，让模型在**贴合情绪的句子或短句之后**放一个标准 Unicode 表情。词库只收 iOS / Windows / Android 普遍内置的表情，不用肤色修饰、组合序列和新版本 emoji，老设备也能正常显示。
+
+## 特性
+
+- **贴合句子**：emoji 放在最贴合情绪的句子/短句之后（`inline`，默认），或统一放回复结尾（`end`）。
+- **单条上限 10 个**：`maxPerTurn` 范围 1–10，默认 3；`frequent` 模式下会按数量分散到不同句子。
+- **与 dsh-kaomoji 共存**：两个插件都是“贴合句子”的插法，所以本插件额外规定 **emoji 与颜文字不得出现在同一句/同一行**，模型会把它们分到不同句子；两张设置卡片同在「设置 → 通用设置」且相邻排列。
+- **可视化配置卡片**：模式（关闭 / 智能 / 高频）、放置位置、每条上限、附加提示词，保存即生效，无需重启。
+- **远程可改**：设置走同源路由，Tailscale、局域网、SSH 端口转发打开页面都能保存。
+- **零第三方运行时依赖**：只用 dsh 自带的 `systemPrompt` 与 Node 标准库。
+
+## 工作原理
+
+1. 启动时注册系统提示词段 `tdsh-emoji:guidance`（order `177`，dsh-kaomoji 是 `176`）。
+2. 每次组装提示词时注入：模式与位置规则、每条上限、emoji 白名单、以及“不得与颜文字同句”的共存规则。
+3. 设置卡片通过同源路由 `POST /tdsh-emoji-settings` 读写 `~/.dsh/tdsh-emoji.json`；Host 写入后立即更新提示词段，下一次回复生效。
+
+## 安装
+
+```powershell
+cd "$env:USERPROFILE\.dsh\profiles\web"
+
+# npm（推荐）
+dsh plugin --profile web add tdsh-emoji
+
+# 或 GitHub 直装
+dsh plugin --profile web add github:TianJie52009/Tdsh-emoji
+```
+
+装完重启 Web Host，在「设置 → 通用设置」中会看到「Emoji（tdsh-emoji）」卡片，就排在「颜文字（dsh-kaomoji）」旁边。
+
+## 配置
+
+默认 `mode: auto`、`placement: inline`、`maxPerTurn: 3`。也可以在 profile 的 `cordis.patch.yml` 里覆盖部署默认值：
+
+```yaml
+- id: tdsh-emoji
+  config:
+    mode: frequent     # off | auto | frequent
+    placement: inline  # inline | end
+    maxPerTurn: 5      # 1-10
+    customPrompt: "正式场景克制一点，优先用「鼓励 / 感谢」类 emoji"
+```
+
+| 配置项 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| `mode` | `'off' \| 'auto' \| 'frequent'` | `'auto'` | `off` 关闭；`auto` 对话式回复基本都会带；`frequent` 每条对话回复都带（纯代码/正式交付除外） |
+| `placement` | `'inline' \| 'end'` | `'inline'` | 贴合情绪的句子之后，或回复结尾 |
+| `maxPerTurn` | `number`（1–10） | `3` | 单条回复 emoji 上限；`frequent` 会按数量分散到不同句子 |
+| `customPrompt` | `string` | `''` | 附加风格/场景说明，不能改变模式、白名单或上限 |
+| `settingsFile` | `string` | `~/.dsh/tdsh-emoji.json` | （进阶）用户设置持久化路径 |
+
+## 与 dsh-kaomoji 共存
+
+| 插件 | 插入内容 | 位置 | 冲突处理 |
+| --- | --- | --- | --- |
+| dsh-kaomoji | 日式颜文字 `(´∀｀)` | 贴合情绪的句子之后 | 互不干扰：emoji 一侧明确禁止与颜文字同句/同行 |
+| Tdsh-emoji | 标准 emoji 😊 | 贴合情绪的句子之后 | `Never place an emoji in the same sentence or line as a kaomoji` |
+
+两张设置卡片都在「设置 → 通用设置」（order 30 / 31），可以挨着调。
+
+## 开发
+
+```powershell
+npm test   # node:test 单测（提示词规则 + 设置路由 + client 加载）
+npm pack   # 验证发布内容
+```
+
+```text
+Tdsh-emoji/
+├── lib/
+│   ├── index.js       # Host：config、规则生成、提示词段、设置路由
+│   ├── client.js      # Web：设置 → 通用设置 卡片
+│   └── index.d.ts
+├── data/catalog.json  # 情绪 -> emoji 白名单
+├── test/
+├── cordis.patch.yml
+├── package.json
+├── README.md / README.en.md
+└── CHANGELOG.md
+```
+
+## License
+
+[MIT](./LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,15 @@
+# tdsh-emoji bundle layer：把 Emoji 插件挂载进 profile。
+#
+# 与 dsh-kaomoji 可共存：两个插件各注入自己的装饰规则，位置都贴合影情绪
+# 句子，但规则要求「emoji 与颜文字不得出现在同一句/同一行」，模型会把它们
+# 分散到不同句子。设置卡片同在「设置 → 通用设置」，id 相邻排列。
+#
+# 想改默认行为，在自己的 profile cordis.patch.yml 里用同一个 id 覆盖 config：
+#   - id: tdsh-emoji
+#     config:
+#       mode: frequent    # off | auto | frequent
+#       placement: inline # inline | end
+#       maxPerTurn: 5     # 1-10
+- insert:
+    - id: tdsh-emoji
+      name: tdsh-emoji

package/data/catalog.json

@@ -0,0 +1,70 @@
+{
+  "schemaVersion": 1,
+  "name": "tdsh-emoji-core@1",
+  "source": {
+    "name": "Standard Unicode emoji",
+    "note": "精选各平台（iOS / Windows / Android）普遍内置的标准 Unicode 表情，避免肤色修饰、组合序列和新版本表情，保证在旧设备上也能正常显示。"
+  },
+  "categories": [
+    {
+      "id": "happy",
+      "labels": { "zh": "开心/高兴", "en": "happy" },
+      "examples": ["😀", "😄", "😊", "🌟", "✨"]
+    },
+    {
+      "id": "love",
+      "labels": { "zh": "喜欢/心动", "en": "love" },
+      "examples": ["😍", "😘", "❤️", "💕", "💖"]
+    },
+    {
+      "id": "sad",
+      "labels": { "zh": "难过/低落", "en": "sad" },
+      "examples": ["😢", "😔", "😞", "💧"]
+    },
+    {
+      "id": "cry",
+      "labels": { "zh": "大哭/泪目", "en": "cry" },
+      "examples": ["😭", "😿", "💦"]
+    },
+    {
+      "id": "angry",
+      "labels": { "zh": "生气/不满", "en": "angry" },
+      "examples": ["😠", "😡", "💢", "👿"]
+    },
+    {
+      "id": "surprised",
+      "labels": { "zh": "惊讶/震惊", "en": "surprised" },
+      "examples": ["😮", "😲", "😱", "❗"]
+    },
+    {
+      "id": "confused",
+      "labels": { "zh": "困惑/困扰", "en": "confused" },
+      "examples": ["😕", "🤔", "😅", "🤷"]
+    },
+    {
+      "id": "shy",
+      "labels": { "zh": "害羞/不好意思", "en": "shy" },
+      "examples": ["😳", "🙈", "☺️", "😊"]
+    },
+    {
+      "id": "playful",
+      "labels": { "zh": "俏皮/卖萌", "en": "playful" },
+      "examples": ["😜", "😝", "😉", "🤪"]
+    },
+    {
+      "id": "encourage",
+      "labels": { "zh": "鼓励/加油", "en": "encourage" },
+      "examples": ["💪", "👍", "🙌", "✊", "🔥"]
+    },
+    {
+      "id": "thanks",
+      "labels": { "zh": "感谢", "en": "thanks" },
+      "examples": ["🙏", "💖", "🎀", "😊"]
+    },
+    {
+      "id": "sorry",
+      "labels": { "zh": "道歉", "en": "sorry" },
+      "examples": ["🙇", "😔", "🙏", "💧"]
+    }
+  ]
+}