Skip to content

feat(litman): add litman plugin - #174

Open
wqx1999 wants to merge 1 commit into
zai-org:mainfrom
wqx1999:feat/litman
Open

wqx1999 wants to merge 1 commit into
zai-org:mainfrom
wqx1999:feat/litman

Conversation

@wqx1999

@wqx1999 wqx1999 commented Nov 5, 2026 •

Copy link
Copy Markdown

Plugin type (required) / 插件类型(必填)

  • UI Plugin / 是 UI 插件 — provides MCP Apps interactive pages / 提供 MCP Apps 交互页面
  • Standard plugin / 普通插件(非 UI) — does not provide MCP Apps interactive pages / 不提供 MCP Apps 交互页面
  • Not applicable / 不适用 — repository-only changes; no plugin content changed / 仅仓库级改动,不涉及插件内容

Affected plugin name(s) / 涉及的插件名称:litman (Standard plugin / 普通插件)

What / 改动内容

Adds external_plugins/litman, a skill-only plugin for litman, an open-source local literature manager (GitHub, AGPL-3.0) driven by the lit command. I am the author of litman.

  • One skill, litman-setup. The agent runs lit --version. If litman is missing, it asks the user, and only after a clear yes runs the official one-line installer from get.litman.dev (PowerShell on Windows, curl … | sh on macOS / Linux). It then runs lit install-skill --agent zcode, which copies litman's own skills to ~/.agents/skills, and tells the user that ZCode loads them in a new session (lit agent zcode opens the library as a workspace).
  • The plugin only installs and connects litman. Everything else comes from the installed litman, so the plugin does not need an update when litman changes.
  • No hooks, MCP servers, UI, credentials or bundled third-party code. Both READMEs list the network access, commands and file writes.
  • The same plugin is also available as a self-hosted marketplace: https://github.com/wqx1999/zcode-litman

新增 external_plugins/litman:litman 的纯 skill 插件。litman 是开源的本地文献管理工具(GitHub,AGPL-3.0),通过 lit 命令操作;我是 litman 的作者。

  • 只有一个 skill litman-setup:agent 先跑 lit --version;没装 litman 就先问用户,用户明确同意后才运行 get.litman.dev 的官方一行安装命令,再运行 lit install-skill --agent zcode,把 litman 自己的 skill 复制到 ~/.agents/skills,并告诉用户新会话里才会加载(lit agent zcode 可把文献库作为工作区打开)。
  • 插件只负责安装和接入,其余都由装好的 litman 提供,litman 升级时插件不用跟着更新。
  • 没有 Hook、MCP、界面、凭据或第三方代码;网络访问、命令执行和文件写入在中英文 README 里都已写明。

Testing / 测试

ZCode 3.16.3 on Windows, plugin installed from a local copy of this directory (Plugin Market → Add):

  • The market lists litman with the zh-CN description; typing /litman shows $litman-setup (source: plugin).
  • litman already installed: the agent checks, reports it is installed, and does not reinstall.
  • litman uninstalled and its skills removed: the agent invokes litman:setup, asks through the question prompt, and installs only after the user picks "install". In Autonomous mode the installer runs without a prompt; in "Confirm before changes" mode the installer command shows the permission prompt, and after "Allow once" the install succeeds. The skills are copied, and a new session loads them.
  • lit agent zcode run by the agent inside ZCode opens the library as a new task.

Checks / 检查:python3 scripts/validate.py → OK (53 plugins); git diff --check clean; build_dist.py builds this plugin's plugin.zip. On a checkout without pnpm build, build_dist.py stops at excalidraw (same on main), so the full build is left to CI. Python tests under tests/: the only failures are in test_mimosa_plugin.py, which fail the same way on main.

Self-check / 自查清单

  • Plugin name is unique kebab-case; new external plugin directory is external_plugins/<name>/; existing fixes retain ownership / 插件名唯一且 kebab-case,外部新增插件位于 external_plugins/<name>/,已有插件修复保留原归属
  • Usage category is set independently of publisher ownership / 用途分类 category 已填写,与维护归属分开 (productivity)
  • Plugin type and affected names are declared above / 已在上方声明插件类型与涉及的插件名称
  • version bumped in BOTH plugin.json and marketplace.json (artifacts are immutable) / plugin.json 与 marketplace.json 两处版本号已同步升级(制品不可变) (new plugin, 0.1.0 in both / 新插件,两处均为 0.1.0)
  • README.md (EN) and README_CN.md (中文) both updated and equivalent / 中英文 README 均已更新且语义一致
  • description_i18n has both en and zh-CN / description_i18n 包含 en 与 zh-CN
  • No secrets, machine-specific paths, or private dependencies / 不含密钥、机器专属路径或私有依赖
  • Model/API/network dependencies documented / 模型、API、网络依赖已写明
  • python3 scripts/validate.py and python3 scripts/build_dist.py pass locally / 本地校验与构建均通过 (see Checks above / 见上方「检查」)

🤖 Generated with Claude Code

https://claude.ai/code/session_01BsBCXm7NYUzJW4bBwavgsJ

litman (https://litman.dev) is an open-source local literature manager
driven by the `lit` command. This skill-only plugin gets it installed and
connected to ZCode; everything else stays in litman.

- One skill, `litman-setup`: checks for litman, asks the user before
  installing, runs the official one-line installer, then
  `lit install-skill --agent zcode`.
- No hooks, MCP servers, UI or credentials. README in English and Chinese,
  with network access, commands and file writes listed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BsBCXm7NYUzJW4bBwavgsJ

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant