stylechart

stylechart

用一句日常的话描述一种情绪，stylechart 就会告诉你它对应哪些视觉风格。其背后是一部双层词典：一侧是感受词，另一侧是视觉风格，两者之间由关联串联。输入一句口语化的话，返回最匹配的风格，以及促成匹配的感受词，让你知道某种风格为何入选，而不只是看到它的名称。

stylechart 是已公开文档的 feeling-search REST API（v2）的直接客户端，该 API 托管在 https://xiximm.cloud。词典和匹配逻辑都在服务端运行；此软件包会验证参数、调用免费端点，并返回 JSON。

五个工具：

• word_analyze — 输入一句话（最多 500 个字符），返回最匹配的视觉风格及其对应的感受词。可选参数 words（1–12）和 styles（1–30）用于限制返回的数量。若措辞不在词典中，则返回空词列表；这是预期结果，并非错误。
• word_lookup — 查询一个感受词的完整信息：定义、近义词，以及它对应的风格。
• word_list — 一次性返回整个词典。指定 query 后，将在本地筛选词典：筛选文本中包含查询内容的词，以及名称或 ID 中包含查询内容的风格，并同时报告筛选结果数和总数。
• style_get — 按 ID 查询一种风格（例如 synthwave）：定义、父风格、成员词及参考图片。
• word_status — 仅返回词典覆盖情况：词典响应中的 {ok, counts} 部分，用于确认数据是最新的，无需下载完整表格。

仅使用免费端点

此重构版本只调用文档中列出的免费端点（POST /v2/analyze、GET /v2/links、GET /v2/dictionary、GET /v2/styles/<id>）。不支持付费云端路径：没有任何支付机制，也不支持购买配额令牌（绝不会发送 X-FS-Quota 标头），并且绝不会调用计量计费的图片端点。如果上游对 /v2/analyze 的响应为 HTTP 402，stylechart 会将其报告为错误并指出付费路径，而不会进行支付。

配置

• FEELING_API_BASE — API 基础 URL。默认为 https://xiximm.cloud。无需也不接受 API 密钥。

CLI

每个工具都是一个子命令，接受一个 JSON 参数字符串（word_status 不接受参数，word_list 的参数可选）：

npx @reneturcios/stylechart word_analyze '{"text":"rainy neon streets at night","styles":5}'
npx @reneturcios/stylechart word_lookup '{"word":"melancholy"}'
npx @reneturcios/stylechart word_list '{"query":"neon"}'
npx @reneturcios/stylechart word_list
npx @reneturcios/stylechart style_get '{"id":"synthwave"}'
npx @reneturcios/stylechart word_status
npx @reneturcios/stylechart --version

输出为工具的结果 JSON。退出代码：成功时为 0，运行时错误（包括验证失败或上游错误）时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/stylechart mcp

MCP 客户端配置：

{
  "mcpServers": {
    "stylechart": {
      "command": "npx",
      "args": ["-y", "@reneturcios/stylechart", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/stylechart
docker run --rm ghcr.io/cloudcorprecords/stylechart word_status

开发

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source

许可证

MIT — 版权所有 (c) 2026 Rene Turcios